From c04c19a6f1bccd920f9297920623f27de529359f Mon Sep 17 00:00:00 2001 From: Wayne Lin Date: Wed, 17 Jun 2020 16:30:11 +0800 Subject: [PATCH 1/4] Support Nuvoton NuMaker-IOT-M487 and NuMaker-PFM-M487 boards. --- bsp/nuvoton/README.md | 7 + bsp/nuvoton/libraries/Kconfig | 2 + .../m480/CMSIS/Include/arm_common_tables.h | 136 + .../m480/CMSIS/Include/arm_const_structs.h | 79 + .../libraries/m480/CMSIS/Include/arm_math.h | 7154 +++++++++++++ .../m480/CMSIS/Include/cmsis_armcc.h | 734 ++ .../m480/CMSIS/Include/cmsis_armcc_V6.h | 1800 ++++ .../libraries/m480/CMSIS/Include/cmsis_gcc.h | 1373 +++ .../libraries/m480/CMSIS/Include/core_cm0.h | 798 ++ .../m480/CMSIS/Include/core_cm0plus.h | 914 ++ .../libraries/m480/CMSIS/Include/core_cm3.h | 1763 +++ .../libraries/m480/CMSIS/Include/core_cm4.h | 1937 ++++ .../libraries/m480/CMSIS/Include/core_cm7.h | 2512 +++++ .../m480/CMSIS/Include/core_cmFunc.h | 87 + .../m480/CMSIS/Include/core_cmInstr.h | 87 + .../m480/CMSIS/Include/core_cmSimd.h | 96 + .../libraries/m480/CMSIS/Include/core_sc000.h | 926 ++ .../libraries/m480/CMSIS/Include/core_sc300.h | 1745 +++ bsp/nuvoton/libraries/m480/CMSIS/SConscript | 16 + .../m480/Device/Nuvoton/M480/Include/M480.h | 713 ++ .../Device/Nuvoton/M480/Include/NuMicro.h | 17 + .../Device/Nuvoton/M480/Include/acmp_reg.h | 240 + .../Device/Nuvoton/M480/Include/bpwm_reg.h | 1835 ++++ .../Device/Nuvoton/M480/Include/can_reg.h | 759 ++ .../Device/Nuvoton/M480/Include/ccap_reg.h | 496 + .../Device/Nuvoton/M480/Include/clk_reg.h | 1691 +++ .../Device/Nuvoton/M480/Include/crc_reg.h | 150 + .../Device/Nuvoton/M480/Include/crypto_reg.h | 2219 ++++ .../Device/Nuvoton/M480/Include/dac_reg.h | 210 + .../Device/Nuvoton/M480/Include/eadc_reg.h | 1714 +++ .../Device/Nuvoton/M480/Include/ebi_reg.h | 429 + .../Device/Nuvoton/M480/Include/ecap_reg.h | 390 + .../Device/Nuvoton/M480/Include/emac_reg.h | 2063 ++++ .../Device/Nuvoton/M480/Include/epwm_reg.h | 4023 +++++++ .../Device/Nuvoton/M480/Include/fmc_reg.h | 688 ++ .../Device/Nuvoton/M480/Include/gpio_reg.h | 936 ++ .../Device/Nuvoton/M480/Include/hsotg_reg.h | 398 + .../Device/Nuvoton/M480/Include/hsusbd_reg.h | 1381 +++ .../Device/Nuvoton/M480/Include/hsusbh_reg.h | 653 ++ .../Device/Nuvoton/M480/Include/i2c_reg.h | 725 ++ .../Device/Nuvoton/M480/Include/i2s_reg.h | 707 ++ .../Device/Nuvoton/M480/Include/opa_reg.h | 268 + .../Device/Nuvoton/M480/Include/otg_reg.h | 399 + .../Device/Nuvoton/M480/Include/pdma_reg.h | 886 ++ .../Device/Nuvoton/M480/Include/qei_reg.h | 315 + .../Device/Nuvoton/M480/Include/qspi_reg.h | 592 + .../Device/Nuvoton/M480/Include/rtc_reg.h | 1274 +++ .../m480/Device/Nuvoton/M480/Include/sc_reg.h | 1019 ++ .../Device/Nuvoton/M480/Include/sdh_reg.h | 541 + .../Device/Nuvoton/M480/Include/spi_reg.h | 800 ++ .../Device/Nuvoton/M480/Include/spim_reg.h | 557 + .../Device/Nuvoton/M480/Include/sys_reg.h | 3662 +++++++ .../Device/Nuvoton/M480/Include/system_M480.h | 76 + .../Device/Nuvoton/M480/Include/timer_reg.h | 1094 ++ .../Device/Nuvoton/M480/Include/trng_reg.h | 138 + .../Device/Nuvoton/M480/Include/uart_reg.h | 1273 +++ .../Device/Nuvoton/M480/Include/ui2c_reg.h | 583 + .../Device/Nuvoton/M480/Include/usbd_reg.h | 649 ++ .../Device/Nuvoton/M480/Include/usbh_reg.h | 797 ++ .../Device/Nuvoton/M480/Include/uspi_reg.h | 677 ++ .../Device/Nuvoton/M480/Include/uuart_reg.h | 679 ++ .../Device/Nuvoton/M480/Include/wdt_reg.h | 183 + .../Device/Nuvoton/M480/Include/wwdt_reg.h | 149 + .../Nuvoton/M480/Source/ARM/startup_M480.s | 514 + .../Nuvoton/M480/Source/GCC/startup_M480.S | 375 + .../Nuvoton/M480/Source/IAR/startup_M480.s | 451 + .../Device/Nuvoton/M480/Source/system_M480.c | 110 + bsp/nuvoton/libraries/m480/Device/SConscript | 25 + bsp/nuvoton/libraries/m480/README.md | 49 + bsp/nuvoton/libraries/m480/SConscript | 15 + .../libraries/m480/StdDriver/SConscript | 26 + .../libraries/m480/StdDriver/inc/nu_acmp.h | 415 + .../libraries/m480/StdDriver/inc/nu_bpwm.h | 361 + .../libraries/m480/StdDriver/inc/nu_can.h | 192 + .../libraries/m480/StdDriver/inc/nu_ccap.h | 167 + .../libraries/m480/StdDriver/inc/nu_clk.h | 714 ++ .../libraries/m480/StdDriver/inc/nu_crc.h | 113 + .../libraries/m480/StdDriver/inc/nu_crypto.h | 378 + .../libraries/m480/StdDriver/inc/nu_dac.h | 269 + .../libraries/m480/StdDriver/inc/nu_eadc.h | 616 ++ .../libraries/m480/StdDriver/inc/nu_ebi.h | 352 + .../libraries/m480/StdDriver/inc/nu_ecap.h | 458 + .../libraries/m480/StdDriver/inc/nu_emac.h | 357 + .../libraries/m480/StdDriver/inc/nu_epwm.h | 623 ++ .../libraries/m480/StdDriver/inc/nu_fmc.h | 302 + .../libraries/m480/StdDriver/inc/nu_gpio.h | 497 + .../libraries/m480/StdDriver/inc/nu_hsotg.h | 268 + .../libraries/m480/StdDriver/inc/nu_hsusbd.h | 382 + .../libraries/m480/StdDriver/inc/nu_i2c.h | 502 + .../libraries/m480/StdDriver/inc/nu_i2s.h | 353 + .../libraries/m480/StdDriver/inc/nu_opa.h | 209 + .../libraries/m480/StdDriver/inc/nu_otg.h | 268 + .../libraries/m480/StdDriver/inc/nu_pdma.h | 391 + .../libraries/m480/StdDriver/inc/nu_qei.h | 390 + .../libraries/m480/StdDriver/inc/nu_qspi.h | 357 + .../libraries/m480/StdDriver/inc/nu_rtc.h | 342 + .../libraries/m480/StdDriver/inc/nu_sc.h | 268 + .../libraries/m480/StdDriver/inc/nu_scuart.h | 267 + .../libraries/m480/StdDriver/inc/nu_sdh.h | 203 + .../libraries/m480/StdDriver/inc/nu_spi.h | 584 + .../libraries/m480/StdDriver/inc/nu_spim.h | 634 ++ .../libraries/m480/StdDriver/inc/nu_sys.h | 1636 +++ .../libraries/m480/StdDriver/inc/nu_timer.h | 523 + .../m480/StdDriver/inc/nu_timer_pwm.h | 746 ++ .../libraries/m480/StdDriver/inc/nu_trng.h | 86 + .../libraries/m480/StdDriver/inc/nu_uart.h | 507 + .../libraries/m480/StdDriver/inc/nu_usbd.h | 693 ++ .../m480/StdDriver/inc/nu_usci_i2c.h | 332 + .../m480/StdDriver/inc/nu_usci_spi.h | 411 + .../m480/StdDriver/inc/nu_usci_uart.h | 471 + .../libraries/m480/StdDriver/inc/nu_wdt.h | 216 + .../libraries/m480/StdDriver/inc/nu_wwdt.h | 152 + .../m480/StdDriver/lib/libStdDriver.ewd | 3285 ++++++ .../m480/StdDriver/lib/libStdDriver.ewp | 2197 ++++ .../m480/StdDriver/lib/libStdDriver.eww | 10 + .../m480/StdDriver/lib/libStdDriver.uvprojx | 587 + .../m480/StdDriver/lib/libStdDriver_4.uvproj | 591 + .../m480/StdDriver/lib/libstddriver_gcc.a | Bin 0 -> 204826 bytes .../m480/StdDriver/lib/libstddriver_iar.a | Bin 0 -> 411394 bytes .../m480/StdDriver/lib/libstddriver_keil.lib | Bin 0 -> 31630036 bytes .../m480/StdDriver/lib/libstddriver_keil4.lib | Bin 0 -> 30771672 bytes .../m480/StdDriver/lib/nutool_clkcfg.h | 26 + .../libraries/m480/StdDriver/src/nu_acmp.c | 75 + .../libraries/m480/StdDriver/src/nu_bpwm.c | 745 ++ .../libraries/m480/StdDriver/src/nu_can.c | 1292 +++ .../libraries/m480/StdDriver/src/nu_ccap.c | 296 + .../libraries/m480/StdDriver/src/nu_clk.c | 1353 +++ .../libraries/m480/StdDriver/src/nu_crc.c | 95 + .../libraries/m480/StdDriver/src/nu_crypto.c | 1995 ++++ .../libraries/m480/StdDriver/src/nu_dac.c | 90 + .../libraries/m480/StdDriver/src/nu_eadc.c | 143 + .../libraries/m480/StdDriver/src/nu_ebi.c | 195 + .../libraries/m480/StdDriver/src/nu_ecap.c | 118 + .../libraries/m480/StdDriver/src/nu_emac.c | 1178 ++ .../libraries/m480/StdDriver/src/nu_epwm.c | 1465 +++ .../libraries/m480/StdDriver/src/nu_fmc.c | 1041 ++ .../libraries/m480/StdDriver/src/nu_gpio.c | 153 + .../libraries/m480/StdDriver/src/nu_hsusbd.c | 725 ++ .../libraries/m480/StdDriver/src/nu_i2c.c | 1486 +++ .../libraries/m480/StdDriver/src/nu_i2s.c | 250 + .../libraries/m480/StdDriver/src/nu_pdma.c | 487 + .../libraries/m480/StdDriver/src/nu_qei.c | 144 + .../libraries/m480/StdDriver/src/nu_qspi.c | 856 ++ .../libraries/m480/StdDriver/src/nu_rtc.c | 1095 ++ .../libraries/m480/StdDriver/src/nu_sc.c | 400 + .../libraries/m480/StdDriver/src/nu_scuart.c | 242 + .../libraries/m480/StdDriver/src/nu_sdh.c | 1275 +++ .../libraries/m480/StdDriver/src/nu_spi.c | 1443 +++ .../libraries/m480/StdDriver/src/nu_spim.c | 1308 +++ .../libraries/m480/StdDriver/src/nu_sys.c | 284 + .../libraries/m480/StdDriver/src/nu_timer.c | 353 + .../m480/StdDriver/src/nu_timer_pwm.c | 443 + .../libraries/m480/StdDriver/src/nu_trng.c | 172 + .../libraries/m480/StdDriver/src/nu_uart.c | 656 ++ .../libraries/m480/StdDriver/src/nu_usbd.c | 745 ++ .../m480/StdDriver/src/nu_usci_i2c.c | 1679 +++ .../m480/StdDriver/src/nu_usci_spi.c | 664 ++ .../m480/StdDriver/src/nu_usci_uart.c | 702 ++ .../libraries/m480/StdDriver/src/nu_wdt.c | 69 + .../libraries/m480/StdDriver/src/nu_wwdt.c | 69 + .../libraries/m480/USBHostLib/SConscript | 12 + .../libraries/m480/USBHostLib/inc/config.h | 114 + .../libraries/m480/USBHostLib/inc/ehci.h | 281 + .../libraries/m480/USBHostLib/inc/hub.h | 139 + .../libraries/m480/USBHostLib/inc/ohci.h | 148 + .../libraries/m480/USBHostLib/inc/usb.h | 486 + .../libraries/m480/USBHostLib/inc/usbh_lib.h | 186 + .../libraries/m480/USBHostLib/src/ehci.c | 1306 +++ .../libraries/m480/USBHostLib/src/ehci_iso.c | 916 ++ .../libraries/m480/USBHostLib/src/mem_alloc.c | 503 + .../libraries/m480/USBHostLib/src/ohci.c | 1292 +++ .../libraries/m480/USBHostLib/src/usb_core.c | 299 + bsp/nuvoton/libraries/m480/rtt_port/Kconfig | 931 ++ .../libraries/m480/rtt_port/SConscript | 11 + .../libraries/m480/rtt_port/drv_bpwm.c | 228 + .../m480/rtt_port/drv_bpwm_capture.c | 333 + bsp/nuvoton/libraries/m480/rtt_port/drv_can.c | 564 + bsp/nuvoton/libraries/m480/rtt_port/drv_clk.c | 323 + bsp/nuvoton/libraries/m480/rtt_port/drv_crc.c | 134 + bsp/nuvoton/libraries/m480/rtt_port/drv_crc.h | 21 + .../libraries/m480/rtt_port/drv_crypto.c | 841 ++ .../libraries/m480/rtt_port/drv_eadc.c | 162 + bsp/nuvoton/libraries/m480/rtt_port/drv_ebi.c | 38 + bsp/nuvoton/libraries/m480/rtt_port/drv_ebi.h | 48 + .../libraries/m480/rtt_port/drv_ecap.c | 451 + .../libraries/m480/rtt_port/drv_emac.c | 515 + .../libraries/m480/rtt_port/drv_epwm.c | 268 + .../m480/rtt_port/drv_epwm_capture.c | 509 + bsp/nuvoton/libraries/m480/rtt_port/drv_fmc.c | 322 + bsp/nuvoton/libraries/m480/rtt_port/drv_fmc.h | 24 + .../libraries/m480/rtt_port/drv_gpio.c | 392 + .../libraries/m480/rtt_port/drv_gpio.h | 34 + .../libraries/m480/rtt_port/drv_hsotg.c | 125 + .../libraries/m480/rtt_port/drv_hsusbd.c | 974 ++ bsp/nuvoton/libraries/m480/rtt_port/drv_i2c.c | 393 + bsp/nuvoton/libraries/m480/rtt_port/drv_i2s.c | 578 + bsp/nuvoton/libraries/m480/rtt_port/drv_i2s.h | 95 + .../libraries/m480/rtt_port/drv_pdma.c | 858 ++ .../libraries/m480/rtt_port/drv_pdma.h | 61 + bsp/nuvoton/libraries/m480/rtt_port/drv_qei.c | 305 + bsp/nuvoton/libraries/m480/rtt_port/drv_qei.h | 30 + .../libraries/m480/rtt_port/drv_qspi.c | 407 + .../libraries/m480/rtt_port/drv_qspi.h | 20 + bsp/nuvoton/libraries/m480/rtt_port/drv_rtc.c | 366 + .../libraries/m480/rtt_port/drv_scuart.c | 381 + bsp/nuvoton/libraries/m480/rtt_port/drv_sdh.c | 629 ++ .../libraries/m480/rtt_port/drv_softi2c.c | 254 + bsp/nuvoton/libraries/m480/rtt_port/drv_spi.c | 669 ++ bsp/nuvoton/libraries/m480/rtt_port/drv_spi.h | 45 + .../libraries/m480/rtt_port/drv_spii2s.c | 647 ++ .../libraries/m480/rtt_port/drv_timer.c | 325 + .../m480/rtt_port/drv_timer_capture.c | 322 + .../libraries/m480/rtt_port/drv_tpwm.c | 235 + .../libraries/m480/rtt_port/drv_trng.c | 82 + .../libraries/m480/rtt_port/drv_trng.h | 21 + .../libraries/m480/rtt_port/drv_uart.c | 833 ++ .../libraries/m480/rtt_port/drv_uart.h | 20 + .../libraries/m480/rtt_port/drv_ui2c.c | 381 + .../libraries/m480/rtt_port/drv_usbd.c | 537 + .../libraries/m480/rtt_port/drv_usbhost.c | 814 ++ .../libraries/m480/rtt_port/drv_uspi.c | 622 ++ .../libraries/m480/rtt_port/drv_uuart.c | 606 ++ bsp/nuvoton/libraries/m480/rtt_port/drv_wdt.c | 479 + .../nu_packages/AudioCodec/SConscript | 14 + .../nu_packages/AudioCodec/acodec_nau88l25.c | 482 + .../nu_packages/AudioCodec/acodec_nau88l25.h | 1096 ++ .../nu_packages/AudioCodec/audio_test.c | 82 + .../libraries/nu_packages/BMX055/SConscript | 16 + .../BMX055/libraries/BMA2x2_driver/README.md | 59 + .../BMX055/libraries/BMA2x2_driver/bma2x2.c | 9499 +++++++++++++++++ .../BMX055/libraries/BMA2x2_driver/bma2x2.h | 5855 ++++++++++ .../libraries/BMA2x2_driver/bma2x2_support.c | 512 + .../BMX055/libraries/BMG160_driver/README.md | 64 + .../BMX055/libraries/BMG160_driver/bmg160.c | 7014 ++++++++++++ .../BMX055/libraries/BMG160_driver/bmg160.h | 4710 ++++++++ .../libraries/BMG160_driver/bmg160_support.c | 435 + .../BMX055/libraries/BMM050_driver/README.md | 67 + .../BMX055/libraries/BMM050_driver/bmm050.c | 2745 +++++ .../BMX055/libraries/BMM050_driver/bmm050.h | 1827 ++++ .../libraries/BMM050_driver/bmm050_support.c | 443 + .../nu_packages/BMX055/sensor_bmx055.c | 656 ++ .../nu_packages/BMX055/sensor_bmx055.h | 23 + .../libraries/nu_packages/Demo/SConscript | 12 + .../nu_packages/Demo/usbd_hid_dance_mouse.c | 114 + .../libraries/nu_packages/ILI9341/SConscript | 22 + .../nu_packages/ILI9341/ili9341_ebi.c | 97 + .../nu_packages/ILI9341/ili9341_spi.c | 195 + .../nu_packages/ILI9341/lcd_ili9341.c | 364 + .../nu_packages/ILI9341/lcd_ili9341.h | 48 + bsp/nuvoton/libraries/nu_packages/Kconfig | 52 + .../libraries/nu_packages/MAX31875/SConscript | 14 + .../nu_packages/MAX31875/libraries/max31875.h | 117 + .../MAX31875/libraries/max31875_c.c | 193 + .../MAX31875/libraries/max31875_c.h | 70 + .../nu_packages/MAX31875/sensor_max31875.c | 163 + .../nu_packages/MAX31875/sensor_max31875.h | 21 + .../libraries/nu_packages/NuUtils/SConscript | 9 + .../nu_packages/NuUtils/inc/nu_bitutil.h | 213 + .../nu_packages/NuUtils/inc/nu_miscutil.h | 39 + bsp/nuvoton/libraries/nu_packages/SConscript | 15 + bsp/nuvoton/numaker-iot-m487/.config | 745 ++ bsp/nuvoton/numaker-iot-m487/Kconfig | 29 + .../numaker-iot-m487/Nu_Link_Driver.ini | 1019 ++ bsp/nuvoton/numaker-iot-m487/README.md | 79 + bsp/nuvoton/numaker-iot-m487/SConscript | 14 + bsp/nuvoton/numaker-iot-m487/SConstruct | 59 + .../numaker-iot-m487/applications/SConscript | 11 + .../numaker-iot-m487/applications/main.c | 36 + .../numaker-iot-m487/applications/mnt.c | 143 + bsp/nuvoton/numaker-iot-m487/board/Kconfig | 133 + .../board/NuClockConfig/nutool_clkcfg.h | 26 + .../board/NuClockConfig/nutool_modclkcfg.c | 1153 ++ .../board/NuClockConfig/nutool_modclkcfg.cfg | 33 + .../board/NuClockConfig/nutool_modclkcfg.h | 139 + .../board/NuPinConfig/nutool_pincfg.c | 521 + .../board/NuPinConfig/nutool_pincfg.cfg | 214 + .../board/NuPinConfig/nutool_pincfg.h | 73 + bsp/nuvoton/numaker-iot-m487/board/SConscript | 20 + bsp/nuvoton/numaker-iot-m487/board/board.c | 114 + bsp/nuvoton/numaker-iot-m487/board/board.h | 23 + .../numaker-iot-m487/board/board_dev.c | 251 + bsp/nuvoton/numaker-iot-m487/board/fal_cfg.h | 42 + .../linking_scripts/m480_flash.icf | 28 + .../linking_scripts/m480_flash.sct | 15 + .../linking_scripts/m480_link.ld | 161 + bsp/nuvoton/numaker-iot-m487/rtconfig.py | 132 + bsp/nuvoton/numaker-iot-m487/template.ewd | 1485 +++ bsp/nuvoton/numaker-iot-m487/template.ewp | 1039 ++ bsp/nuvoton/numaker-iot-m487/template.eww | 10 + bsp/nuvoton/numaker-iot-m487/template.uvproj | 400 + bsp/nuvoton/numaker-iot-m487/template.uvprojx | 401 + bsp/nuvoton/numaker-pfm-m487/.config | 743 ++ bsp/nuvoton/numaker-pfm-m487/Kconfig | 29 + .../numaker-pfm-m487/Nu_Link_Driver.ini | 870 ++ bsp/nuvoton/numaker-pfm-m487/README.md | 76 + bsp/nuvoton/numaker-pfm-m487/SConscript | 14 + bsp/nuvoton/numaker-pfm-m487/SConstruct | 59 + .../numaker-pfm-m487/applications/SConscript | 11 + .../numaker-pfm-m487/applications/main.c | 19 + .../numaker-pfm-m487/applications/mnt.c | 143 + bsp/nuvoton/numaker-pfm-m487/board/Kconfig | 165 + .../board/NuClockConfig/nutool_clkcfg.h | 26 + .../board/NuClockConfig/nutool_modclkcfg.c | 1153 ++ .../board/NuClockConfig/nutool_modclkcfg.cfg | 33 + .../board/NuClockConfig/nutool_modclkcfg.h | 139 + .../board/NuPinConfig/nutool_pincfg.c | 510 + .../board/NuPinConfig/nutool_pincfg.cfg | 198 + .../board/NuPinConfig/nutool_pincfg.h | 73 + bsp/nuvoton/numaker-pfm-m487/board/SConscript | 20 + bsp/nuvoton/numaker-pfm-m487/board/board.c | 114 + bsp/nuvoton/numaker-pfm-m487/board/board.h | 25 + .../numaker-pfm-m487/board/board_dev.c | 292 + bsp/nuvoton/numaker-pfm-m487/board/fal_cfg.h | 42 + .../linking_scripts/m480_flash.icf | 28 + .../linking_scripts/m480_flash.sct | 15 + .../linking_scripts/m480_link.ld | 161 + bsp/nuvoton/numaker-pfm-m487/rtconfig.py | 132 + bsp/nuvoton/numaker-pfm-m487/template.ewd | 1485 +++ bsp/nuvoton/numaker-pfm-m487/template.ewp | 1039 ++ bsp/nuvoton/numaker-pfm-m487/template.eww | 10 + bsp/nuvoton/numaker-pfm-m487/template.uvproj | 400 + bsp/nuvoton/numaker-pfm-m487/template.uvprojx | 401 + 322 files changed, 190536 insertions(+) create mode 100644 bsp/nuvoton/README.md create mode 100644 bsp/nuvoton/libraries/Kconfig create mode 100644 bsp/nuvoton/libraries/m480/CMSIS/Include/arm_common_tables.h create mode 100644 bsp/nuvoton/libraries/m480/CMSIS/Include/arm_const_structs.h create mode 100644 bsp/nuvoton/libraries/m480/CMSIS/Include/arm_math.h create mode 100644 bsp/nuvoton/libraries/m480/CMSIS/Include/cmsis_armcc.h create mode 100644 bsp/nuvoton/libraries/m480/CMSIS/Include/cmsis_armcc_V6.h create mode 100644 bsp/nuvoton/libraries/m480/CMSIS/Include/cmsis_gcc.h create mode 100644 bsp/nuvoton/libraries/m480/CMSIS/Include/core_cm0.h create mode 100644 bsp/nuvoton/libraries/m480/CMSIS/Include/core_cm0plus.h create mode 100644 bsp/nuvoton/libraries/m480/CMSIS/Include/core_cm3.h create mode 100644 bsp/nuvoton/libraries/m480/CMSIS/Include/core_cm4.h create mode 100644 bsp/nuvoton/libraries/m480/CMSIS/Include/core_cm7.h create mode 100644 bsp/nuvoton/libraries/m480/CMSIS/Include/core_cmFunc.h create mode 100644 bsp/nuvoton/libraries/m480/CMSIS/Include/core_cmInstr.h create mode 100644 bsp/nuvoton/libraries/m480/CMSIS/Include/core_cmSimd.h create mode 100644 bsp/nuvoton/libraries/m480/CMSIS/Include/core_sc000.h create mode 100644 bsp/nuvoton/libraries/m480/CMSIS/Include/core_sc300.h create mode 100644 bsp/nuvoton/libraries/m480/CMSIS/SConscript create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/M480.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/NuMicro.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/acmp_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/bpwm_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/can_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/ccap_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/clk_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/crc_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/crypto_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/dac_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/eadc_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/ebi_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/ecap_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/emac_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/epwm_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/fmc_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/gpio_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/hsotg_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/hsusbd_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/hsusbh_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/i2c_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/i2s_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/opa_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/otg_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/pdma_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/qei_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/qspi_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/rtc_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/sc_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/sdh_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/spi_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/spim_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/sys_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/system_M480.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/timer_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/trng_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/uart_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/ui2c_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/usbd_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/usbh_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/uspi_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/uuart_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/wdt_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/wwdt_reg.h create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Source/ARM/startup_M480.s create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Source/GCC/startup_M480.S create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Source/IAR/startup_M480.s create mode 100644 bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Source/system_M480.c create mode 100644 bsp/nuvoton/libraries/m480/Device/SConscript create mode 100644 bsp/nuvoton/libraries/m480/README.md create mode 100644 bsp/nuvoton/libraries/m480/SConscript create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/SConscript create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_acmp.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_bpwm.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_can.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_ccap.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_clk.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_crc.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_crypto.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_dac.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_eadc.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_ebi.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_ecap.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_emac.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_epwm.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_fmc.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_gpio.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_hsotg.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_hsusbd.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_i2c.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_i2s.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_opa.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_otg.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_pdma.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_qei.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_qspi.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_rtc.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_sc.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_scuart.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_sdh.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_spi.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_spim.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_sys.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_timer.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_timer_pwm.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_trng.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_uart.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_usbd.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_usci_i2c.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_usci_spi.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_usci_uart.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_wdt.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/inc/nu_wwdt.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/lib/libStdDriver.ewd create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/lib/libStdDriver.ewp create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/lib/libStdDriver.eww create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/lib/libStdDriver.uvprojx create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/lib/libStdDriver_4.uvproj create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/lib/libstddriver_gcc.a create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/lib/libstddriver_iar.a create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/lib/libstddriver_keil.lib create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/lib/libstddriver_keil4.lib create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/lib/nutool_clkcfg.h create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_acmp.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_bpwm.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_can.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_ccap.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_clk.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_crc.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_crypto.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_dac.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_eadc.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_ebi.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_ecap.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_emac.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_epwm.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_fmc.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_gpio.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_hsusbd.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_i2c.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_i2s.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_pdma.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_qei.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_qspi.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_rtc.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_sc.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_scuart.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_sdh.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_spi.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_spim.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_sys.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_timer.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_timer_pwm.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_trng.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_uart.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_usbd.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_usci_i2c.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_usci_spi.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_usci_uart.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_wdt.c create mode 100644 bsp/nuvoton/libraries/m480/StdDriver/src/nu_wwdt.c create mode 100644 bsp/nuvoton/libraries/m480/USBHostLib/SConscript create mode 100644 bsp/nuvoton/libraries/m480/USBHostLib/inc/config.h create mode 100644 bsp/nuvoton/libraries/m480/USBHostLib/inc/ehci.h create mode 100644 bsp/nuvoton/libraries/m480/USBHostLib/inc/hub.h create mode 100644 bsp/nuvoton/libraries/m480/USBHostLib/inc/ohci.h create mode 100644 bsp/nuvoton/libraries/m480/USBHostLib/inc/usb.h create mode 100644 bsp/nuvoton/libraries/m480/USBHostLib/inc/usbh_lib.h create mode 100644 bsp/nuvoton/libraries/m480/USBHostLib/src/ehci.c create mode 100644 bsp/nuvoton/libraries/m480/USBHostLib/src/ehci_iso.c create mode 100644 bsp/nuvoton/libraries/m480/USBHostLib/src/mem_alloc.c create mode 100644 bsp/nuvoton/libraries/m480/USBHostLib/src/ohci.c create mode 100644 bsp/nuvoton/libraries/m480/USBHostLib/src/usb_core.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/Kconfig create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/SConscript create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_bpwm.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_bpwm_capture.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_can.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_clk.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_crc.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_crc.h create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_crypto.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_eadc.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_ebi.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_ebi.h create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_ecap.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_emac.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_epwm.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_epwm_capture.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_fmc.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_fmc.h create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_gpio.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_gpio.h create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_hsotg.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_hsusbd.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_i2c.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_i2s.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_i2s.h create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_pdma.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_pdma.h create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_qei.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_qei.h create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_qspi.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_qspi.h create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_rtc.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_scuart.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_sdh.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_softi2c.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_spi.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_spi.h create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_spii2s.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_timer.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_timer_capture.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_tpwm.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_trng.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_trng.h create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_uart.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_uart.h create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_ui2c.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_usbd.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_usbhost.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_uspi.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_uuart.c create mode 100644 bsp/nuvoton/libraries/m480/rtt_port/drv_wdt.c create mode 100644 bsp/nuvoton/libraries/nu_packages/AudioCodec/SConscript create mode 100644 bsp/nuvoton/libraries/nu_packages/AudioCodec/acodec_nau88l25.c create mode 100644 bsp/nuvoton/libraries/nu_packages/AudioCodec/acodec_nau88l25.h create mode 100644 bsp/nuvoton/libraries/nu_packages/AudioCodec/audio_test.c create mode 100644 bsp/nuvoton/libraries/nu_packages/BMX055/SConscript create mode 100644 bsp/nuvoton/libraries/nu_packages/BMX055/libraries/BMA2x2_driver/README.md create mode 100644 bsp/nuvoton/libraries/nu_packages/BMX055/libraries/BMA2x2_driver/bma2x2.c create mode 100644 bsp/nuvoton/libraries/nu_packages/BMX055/libraries/BMA2x2_driver/bma2x2.h create mode 100644 bsp/nuvoton/libraries/nu_packages/BMX055/libraries/BMA2x2_driver/bma2x2_support.c create mode 100644 bsp/nuvoton/libraries/nu_packages/BMX055/libraries/BMG160_driver/README.md create mode 100644 bsp/nuvoton/libraries/nu_packages/BMX055/libraries/BMG160_driver/bmg160.c create mode 100644 bsp/nuvoton/libraries/nu_packages/BMX055/libraries/BMG160_driver/bmg160.h create mode 100644 bsp/nuvoton/libraries/nu_packages/BMX055/libraries/BMG160_driver/bmg160_support.c create mode 100644 bsp/nuvoton/libraries/nu_packages/BMX055/libraries/BMM050_driver/README.md create mode 100644 bsp/nuvoton/libraries/nu_packages/BMX055/libraries/BMM050_driver/bmm050.c create mode 100644 bsp/nuvoton/libraries/nu_packages/BMX055/libraries/BMM050_driver/bmm050.h create mode 100644 bsp/nuvoton/libraries/nu_packages/BMX055/libraries/BMM050_driver/bmm050_support.c create mode 100644 bsp/nuvoton/libraries/nu_packages/BMX055/sensor_bmx055.c create mode 100644 bsp/nuvoton/libraries/nu_packages/BMX055/sensor_bmx055.h create mode 100644 bsp/nuvoton/libraries/nu_packages/Demo/SConscript create mode 100644 bsp/nuvoton/libraries/nu_packages/Demo/usbd_hid_dance_mouse.c create mode 100644 bsp/nuvoton/libraries/nu_packages/ILI9341/SConscript create mode 100644 bsp/nuvoton/libraries/nu_packages/ILI9341/ili9341_ebi.c create mode 100644 bsp/nuvoton/libraries/nu_packages/ILI9341/ili9341_spi.c create mode 100644 bsp/nuvoton/libraries/nu_packages/ILI9341/lcd_ili9341.c create mode 100644 bsp/nuvoton/libraries/nu_packages/ILI9341/lcd_ili9341.h create mode 100644 bsp/nuvoton/libraries/nu_packages/Kconfig create mode 100644 bsp/nuvoton/libraries/nu_packages/MAX31875/SConscript create mode 100644 bsp/nuvoton/libraries/nu_packages/MAX31875/libraries/max31875.h create mode 100644 bsp/nuvoton/libraries/nu_packages/MAX31875/libraries/max31875_c.c create mode 100644 bsp/nuvoton/libraries/nu_packages/MAX31875/libraries/max31875_c.h create mode 100644 bsp/nuvoton/libraries/nu_packages/MAX31875/sensor_max31875.c create mode 100644 bsp/nuvoton/libraries/nu_packages/MAX31875/sensor_max31875.h create mode 100644 bsp/nuvoton/libraries/nu_packages/NuUtils/SConscript create mode 100644 bsp/nuvoton/libraries/nu_packages/NuUtils/inc/nu_bitutil.h create mode 100644 bsp/nuvoton/libraries/nu_packages/NuUtils/inc/nu_miscutil.h create mode 100644 bsp/nuvoton/libraries/nu_packages/SConscript create mode 100644 bsp/nuvoton/numaker-iot-m487/.config create mode 100644 bsp/nuvoton/numaker-iot-m487/Kconfig create mode 100644 bsp/nuvoton/numaker-iot-m487/Nu_Link_Driver.ini create mode 100644 bsp/nuvoton/numaker-iot-m487/README.md create mode 100644 bsp/nuvoton/numaker-iot-m487/SConscript create mode 100644 bsp/nuvoton/numaker-iot-m487/SConstruct create mode 100644 bsp/nuvoton/numaker-iot-m487/applications/SConscript create mode 100644 bsp/nuvoton/numaker-iot-m487/applications/main.c create mode 100644 bsp/nuvoton/numaker-iot-m487/applications/mnt.c create mode 100644 bsp/nuvoton/numaker-iot-m487/board/Kconfig create mode 100644 bsp/nuvoton/numaker-iot-m487/board/NuClockConfig/nutool_clkcfg.h create mode 100644 bsp/nuvoton/numaker-iot-m487/board/NuClockConfig/nutool_modclkcfg.c create mode 100644 bsp/nuvoton/numaker-iot-m487/board/NuClockConfig/nutool_modclkcfg.cfg create mode 100644 bsp/nuvoton/numaker-iot-m487/board/NuClockConfig/nutool_modclkcfg.h create mode 100644 bsp/nuvoton/numaker-iot-m487/board/NuPinConfig/nutool_pincfg.c create mode 100644 bsp/nuvoton/numaker-iot-m487/board/NuPinConfig/nutool_pincfg.cfg create mode 100644 bsp/nuvoton/numaker-iot-m487/board/NuPinConfig/nutool_pincfg.h create mode 100644 bsp/nuvoton/numaker-iot-m487/board/SConscript create mode 100644 bsp/nuvoton/numaker-iot-m487/board/board.c create mode 100644 bsp/nuvoton/numaker-iot-m487/board/board.h create mode 100644 bsp/nuvoton/numaker-iot-m487/board/board_dev.c create mode 100644 bsp/nuvoton/numaker-iot-m487/board/fal_cfg.h create mode 100644 bsp/nuvoton/numaker-iot-m487/linking_scripts/m480_flash.icf create mode 100644 bsp/nuvoton/numaker-iot-m487/linking_scripts/m480_flash.sct create mode 100644 bsp/nuvoton/numaker-iot-m487/linking_scripts/m480_link.ld create mode 100644 bsp/nuvoton/numaker-iot-m487/rtconfig.py create mode 100644 bsp/nuvoton/numaker-iot-m487/template.ewd create mode 100644 bsp/nuvoton/numaker-iot-m487/template.ewp create mode 100644 bsp/nuvoton/numaker-iot-m487/template.eww create mode 100644 bsp/nuvoton/numaker-iot-m487/template.uvproj create mode 100644 bsp/nuvoton/numaker-iot-m487/template.uvprojx create mode 100644 bsp/nuvoton/numaker-pfm-m487/.config create mode 100644 bsp/nuvoton/numaker-pfm-m487/Kconfig create mode 100644 bsp/nuvoton/numaker-pfm-m487/Nu_Link_Driver.ini create mode 100644 bsp/nuvoton/numaker-pfm-m487/README.md create mode 100644 bsp/nuvoton/numaker-pfm-m487/SConscript create mode 100644 bsp/nuvoton/numaker-pfm-m487/SConstruct create mode 100644 bsp/nuvoton/numaker-pfm-m487/applications/SConscript create mode 100644 bsp/nuvoton/numaker-pfm-m487/applications/main.c create mode 100644 bsp/nuvoton/numaker-pfm-m487/applications/mnt.c create mode 100644 bsp/nuvoton/numaker-pfm-m487/board/Kconfig create mode 100644 bsp/nuvoton/numaker-pfm-m487/board/NuClockConfig/nutool_clkcfg.h create mode 100644 bsp/nuvoton/numaker-pfm-m487/board/NuClockConfig/nutool_modclkcfg.c create mode 100644 bsp/nuvoton/numaker-pfm-m487/board/NuClockConfig/nutool_modclkcfg.cfg create mode 100644 bsp/nuvoton/numaker-pfm-m487/board/NuClockConfig/nutool_modclkcfg.h create mode 100644 bsp/nuvoton/numaker-pfm-m487/board/NuPinConfig/nutool_pincfg.c create mode 100644 bsp/nuvoton/numaker-pfm-m487/board/NuPinConfig/nutool_pincfg.cfg create mode 100644 bsp/nuvoton/numaker-pfm-m487/board/NuPinConfig/nutool_pincfg.h create mode 100644 bsp/nuvoton/numaker-pfm-m487/board/SConscript create mode 100644 bsp/nuvoton/numaker-pfm-m487/board/board.c create mode 100644 bsp/nuvoton/numaker-pfm-m487/board/board.h create mode 100644 bsp/nuvoton/numaker-pfm-m487/board/board_dev.c create mode 100644 bsp/nuvoton/numaker-pfm-m487/board/fal_cfg.h create mode 100644 bsp/nuvoton/numaker-pfm-m487/linking_scripts/m480_flash.icf create mode 100644 bsp/nuvoton/numaker-pfm-m487/linking_scripts/m480_flash.sct create mode 100644 bsp/nuvoton/numaker-pfm-m487/linking_scripts/m480_link.ld create mode 100644 bsp/nuvoton/numaker-pfm-m487/rtconfig.py create mode 100644 bsp/nuvoton/numaker-pfm-m487/template.ewd create mode 100644 bsp/nuvoton/numaker-pfm-m487/template.ewp create mode 100644 bsp/nuvoton/numaker-pfm-m487/template.eww create mode 100644 bsp/nuvoton/numaker-pfm-m487/template.uvproj create mode 100644 bsp/nuvoton/numaker-pfm-m487/template.uvprojx diff --git a/bsp/nuvoton/README.md b/bsp/nuvoton/README.md new file mode 100644 index 00000000000..f4dc8222235 --- /dev/null +++ b/bsp/nuvoton/README.md @@ -0,0 +1,7 @@ +# Nuvoton BSP descriptions +Current supported BSP shown in below table: + +| **BSP folder** | **Board name** | +|:------------------------- |:-------------------------- | +| [numaker-iot-m487](numaker-iot-m487) | Nuvoton NuMaker-IoT-m487 | +| [numaker-pfm-m487](numaker-pfm-m487) | Nuvoton NuMaker-PFM-m487 | diff --git a/bsp/nuvoton/libraries/Kconfig b/bsp/nuvoton/libraries/Kconfig new file mode 100644 index 00000000000..5c406628837 --- /dev/null +++ b/bsp/nuvoton/libraries/Kconfig @@ -0,0 +1,2 @@ +config SOC_FAMILY_NUMICRO + bool diff --git a/bsp/nuvoton/libraries/m480/CMSIS/Include/arm_common_tables.h b/bsp/nuvoton/libraries/m480/CMSIS/Include/arm_common_tables.h new file mode 100644 index 00000000000..8742a569915 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/CMSIS/Include/arm_common_tables.h @@ -0,0 +1,136 @@ +/* ---------------------------------------------------------------------- +* Copyright (C) 2010-2014 ARM Limited. All rights reserved. +* +* $Date: 19. October 2015 +* $Revision: V.1.4.5 a +* +* Project: CMSIS DSP Library +* Title: arm_common_tables.h +* +* Description: This file has extern declaration for common tables like Bitreverse, reciprocal etc which are used across different functions +* +* Target Processor: Cortex-M4/Cortex-M3 +* +* Redistribution and use in source and binary forms, with or without +* modification, are permitted provided that the following conditions +* are met: +* - Redistributions of source code must retain the above copyright +* notice, this list of conditions and the following disclaimer. +* - Redistributions in binary form must reproduce the above copyright +* notice, this list of conditions and the following disclaimer in +* the documentation and/or other materials provided with the +* distribution. +* - Neither the name of ARM LIMITED nor the names of its contributors +* may be used to endorse or promote products derived from this +* software without specific prior written permission. +* +* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS +* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE +* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, +* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, +* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; +* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER +* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN +* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +* POSSIBILITY OF SUCH DAMAGE. +* -------------------------------------------------------------------- */ + +#ifndef _ARM_COMMON_TABLES_H +#define _ARM_COMMON_TABLES_H + +#include "arm_math.h" + +extern const uint16_t armBitRevTable[1024]; +extern const q15_t armRecipTableQ15[64]; +extern const q31_t armRecipTableQ31[64]; +/* extern const q31_t realCoefAQ31[1024]; */ +/* extern const q31_t realCoefBQ31[1024]; */ +extern const float32_t twiddleCoef_16[32]; +extern const float32_t twiddleCoef_32[64]; +extern const float32_t twiddleCoef_64[128]; +extern const float32_t twiddleCoef_128[256]; +extern const float32_t twiddleCoef_256[512]; +extern const float32_t twiddleCoef_512[1024]; +extern const float32_t twiddleCoef_1024[2048]; +extern const float32_t twiddleCoef_2048[4096]; +extern const float32_t twiddleCoef_4096[8192]; +#define twiddleCoef twiddleCoef_4096 +extern const q31_t twiddleCoef_16_q31[24]; +extern const q31_t twiddleCoef_32_q31[48]; +extern const q31_t twiddleCoef_64_q31[96]; +extern const q31_t twiddleCoef_128_q31[192]; +extern const q31_t twiddleCoef_256_q31[384]; +extern const q31_t twiddleCoef_512_q31[768]; +extern const q31_t twiddleCoef_1024_q31[1536]; +extern const q31_t twiddleCoef_2048_q31[3072]; +extern const q31_t twiddleCoef_4096_q31[6144]; +extern const q15_t twiddleCoef_16_q15[24]; +extern const q15_t twiddleCoef_32_q15[48]; +extern const q15_t twiddleCoef_64_q15[96]; +extern const q15_t twiddleCoef_128_q15[192]; +extern const q15_t twiddleCoef_256_q15[384]; +extern const q15_t twiddleCoef_512_q15[768]; +extern const q15_t twiddleCoef_1024_q15[1536]; +extern const q15_t twiddleCoef_2048_q15[3072]; +extern const q15_t twiddleCoef_4096_q15[6144]; +extern const float32_t twiddleCoef_rfft_32[32]; +extern const float32_t twiddleCoef_rfft_64[64]; +extern const float32_t twiddleCoef_rfft_128[128]; +extern const float32_t twiddleCoef_rfft_256[256]; +extern const float32_t twiddleCoef_rfft_512[512]; +extern const float32_t twiddleCoef_rfft_1024[1024]; +extern const float32_t twiddleCoef_rfft_2048[2048]; +extern const float32_t twiddleCoef_rfft_4096[4096]; + + +/* floating-point bit reversal tables */ +#define ARMBITREVINDEXTABLE__16_TABLE_LENGTH ((uint16_t)20 ) +#define ARMBITREVINDEXTABLE__32_TABLE_LENGTH ((uint16_t)48 ) +#define ARMBITREVINDEXTABLE__64_TABLE_LENGTH ((uint16_t)56 ) +#define ARMBITREVINDEXTABLE_128_TABLE_LENGTH ((uint16_t)208 ) +#define ARMBITREVINDEXTABLE_256_TABLE_LENGTH ((uint16_t)440 ) +#define ARMBITREVINDEXTABLE_512_TABLE_LENGTH ((uint16_t)448 ) +#define ARMBITREVINDEXTABLE1024_TABLE_LENGTH ((uint16_t)1800) +#define ARMBITREVINDEXTABLE2048_TABLE_LENGTH ((uint16_t)3808) +#define ARMBITREVINDEXTABLE4096_TABLE_LENGTH ((uint16_t)4032) + +extern const uint16_t armBitRevIndexTable16[ARMBITREVINDEXTABLE__16_TABLE_LENGTH]; +extern const uint16_t armBitRevIndexTable32[ARMBITREVINDEXTABLE__32_TABLE_LENGTH]; +extern const uint16_t armBitRevIndexTable64[ARMBITREVINDEXTABLE__64_TABLE_LENGTH]; +extern const uint16_t armBitRevIndexTable128[ARMBITREVINDEXTABLE_128_TABLE_LENGTH]; +extern const uint16_t armBitRevIndexTable256[ARMBITREVINDEXTABLE_256_TABLE_LENGTH]; +extern const uint16_t armBitRevIndexTable512[ARMBITREVINDEXTABLE_512_TABLE_LENGTH]; +extern const uint16_t armBitRevIndexTable1024[ARMBITREVINDEXTABLE1024_TABLE_LENGTH]; +extern const uint16_t armBitRevIndexTable2048[ARMBITREVINDEXTABLE2048_TABLE_LENGTH]; +extern const uint16_t armBitRevIndexTable4096[ARMBITREVINDEXTABLE4096_TABLE_LENGTH]; + +/* fixed-point bit reversal tables */ +#define ARMBITREVINDEXTABLE_FIXED___16_TABLE_LENGTH ((uint16_t)12 ) +#define ARMBITREVINDEXTABLE_FIXED___32_TABLE_LENGTH ((uint16_t)24 ) +#define ARMBITREVINDEXTABLE_FIXED___64_TABLE_LENGTH ((uint16_t)56 ) +#define ARMBITREVINDEXTABLE_FIXED__128_TABLE_LENGTH ((uint16_t)112 ) +#define ARMBITREVINDEXTABLE_FIXED__256_TABLE_LENGTH ((uint16_t)240 ) +#define ARMBITREVINDEXTABLE_FIXED__512_TABLE_LENGTH ((uint16_t)480 ) +#define ARMBITREVINDEXTABLE_FIXED_1024_TABLE_LENGTH ((uint16_t)992 ) +#define ARMBITREVINDEXTABLE_FIXED_2048_TABLE_LENGTH ((uint16_t)1984) +#define ARMBITREVINDEXTABLE_FIXED_4096_TABLE_LENGTH ((uint16_t)4032) + +extern const uint16_t armBitRevIndexTable_fixed_16[ARMBITREVINDEXTABLE_FIXED___16_TABLE_LENGTH]; +extern const uint16_t armBitRevIndexTable_fixed_32[ARMBITREVINDEXTABLE_FIXED___32_TABLE_LENGTH]; +extern const uint16_t armBitRevIndexTable_fixed_64[ARMBITREVINDEXTABLE_FIXED___64_TABLE_LENGTH]; +extern const uint16_t armBitRevIndexTable_fixed_128[ARMBITREVINDEXTABLE_FIXED__128_TABLE_LENGTH]; +extern const uint16_t armBitRevIndexTable_fixed_256[ARMBITREVINDEXTABLE_FIXED__256_TABLE_LENGTH]; +extern const uint16_t armBitRevIndexTable_fixed_512[ARMBITREVINDEXTABLE_FIXED__512_TABLE_LENGTH]; +extern const uint16_t armBitRevIndexTable_fixed_1024[ARMBITREVINDEXTABLE_FIXED_1024_TABLE_LENGTH]; +extern const uint16_t armBitRevIndexTable_fixed_2048[ARMBITREVINDEXTABLE_FIXED_2048_TABLE_LENGTH]; +extern const uint16_t armBitRevIndexTable_fixed_4096[ARMBITREVINDEXTABLE_FIXED_4096_TABLE_LENGTH]; + +/* Tables for Fast Math Sine and Cosine */ +extern const float32_t sinTable_f32[FAST_MATH_TABLE_SIZE + 1]; +extern const q31_t sinTable_q31[FAST_MATH_TABLE_SIZE + 1]; +extern const q15_t sinTable_q15[FAST_MATH_TABLE_SIZE + 1]; + +#endif /* ARM_COMMON_TABLES_H */ diff --git a/bsp/nuvoton/libraries/m480/CMSIS/Include/arm_const_structs.h b/bsp/nuvoton/libraries/m480/CMSIS/Include/arm_const_structs.h new file mode 100644 index 00000000000..726d06eb692 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/CMSIS/Include/arm_const_structs.h @@ -0,0 +1,79 @@ +/* ---------------------------------------------------------------------- +* Copyright (C) 2010-2014 ARM Limited. All rights reserved. +* +* $Date: 19. March 2015 +* $Revision: V.1.4.5 +* +* Project: CMSIS DSP Library +* Title: arm_const_structs.h +* +* Description: This file has constant structs that are initialized for +* user convenience. For example, some can be given as +* arguments to the arm_cfft_f32() function. +* +* Target Processor: Cortex-M4/Cortex-M3 +* +* Redistribution and use in source and binary forms, with or without +* modification, are permitted provided that the following conditions +* are met: +* - Redistributions of source code must retain the above copyright +* notice, this list of conditions and the following disclaimer. +* - Redistributions in binary form must reproduce the above copyright +* notice, this list of conditions and the following disclaimer in +* the documentation and/or other materials provided with the +* distribution. +* - Neither the name of ARM LIMITED nor the names of its contributors +* may be used to endorse or promote products derived from this +* software without specific prior written permission. +* +* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS +* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE +* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, +* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, +* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; +* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER +* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN +* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +* POSSIBILITY OF SUCH DAMAGE. +* -------------------------------------------------------------------- */ + +#ifndef _ARM_CONST_STRUCTS_H +#define _ARM_CONST_STRUCTS_H + +#include "arm_math.h" +#include "arm_common_tables.h" + + extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len16; + extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len32; + extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len64; + extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len128; + extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len256; + extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len512; + extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len1024; + extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len2048; + extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len4096; + + extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len16; + extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len32; + extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len64; + extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len128; + extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len256; + extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len512; + extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len1024; + extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len2048; + extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len4096; + + extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len16; + extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len32; + extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len64; + extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len128; + extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len256; + extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len512; + extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len1024; + extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len2048; + extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len4096; + +#endif diff --git a/bsp/nuvoton/libraries/m480/CMSIS/Include/arm_math.h b/bsp/nuvoton/libraries/m480/CMSIS/Include/arm_math.h new file mode 100644 index 00000000000..d33f8a9b3b5 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/CMSIS/Include/arm_math.h @@ -0,0 +1,7154 @@ +/* ---------------------------------------------------------------------- +* Copyright (C) 2010-2015 ARM Limited. All rights reserved. +* +* $Date: 20. October 2015 +* $Revision: V1.4.5 b +* +* Project: CMSIS DSP Library +* Title: arm_math.h +* +* Description: Public header file for CMSIS DSP Library +* +* Target Processor: Cortex-M7/Cortex-M4/Cortex-M3/Cortex-M0 +* +* Redistribution and use in source and binary forms, with or without +* modification, are permitted provided that the following conditions +* are met: +* - Redistributions of source code must retain the above copyright +* notice, this list of conditions and the following disclaimer. +* - Redistributions in binary form must reproduce the above copyright +* notice, this list of conditions and the following disclaimer in +* the documentation and/or other materials provided with the +* distribution. +* - Neither the name of ARM LIMITED nor the names of its contributors +* may be used to endorse or promote products derived from this +* software without specific prior written permission. +* +* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS +* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE +* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, +* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, +* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; +* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER +* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN +* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +* POSSIBILITY OF SUCH DAMAGE. + * -------------------------------------------------------------------- */ + +/** + \mainpage CMSIS DSP Software Library + * + * Introduction + * ------------ + * + * This user manual describes the CMSIS DSP software library, + * a suite of common signal processing functions for use on Cortex-M processor based devices. + * + * The library is divided into a number of functions each covering a specific category: + * - Basic math functions + * - Fast math functions + * - Complex math functions + * - Filters + * - Matrix functions + * - Transforms + * - Motor control functions + * - Statistical functions + * - Support functions + * - Interpolation functions + * + * The library has separate functions for operating on 8-bit integers, 16-bit integers, + * 32-bit integer and 32-bit floating-point values. + * + * Using the Library + * ------------ + * + * The library installer contains prebuilt versions of the libraries in the Lib folder. + * - arm_cortexM7lfdp_math.lib (Little endian and Double Precision Floating Point Unit on Cortex-M7) + * - arm_cortexM7bfdp_math.lib (Big endian and Double Precision Floating Point Unit on Cortex-M7) + * - arm_cortexM7lfsp_math.lib (Little endian and Single Precision Floating Point Unit on Cortex-M7) + * - arm_cortexM7bfsp_math.lib (Big endian and Single Precision Floating Point Unit on Cortex-M7) + * - arm_cortexM7l_math.lib (Little endian on Cortex-M7) + * - arm_cortexM7b_math.lib (Big endian on Cortex-M7) + * - arm_cortexM4lf_math.lib (Little endian and Floating Point Unit on Cortex-M4) + * - arm_cortexM4bf_math.lib (Big endian and Floating Point Unit on Cortex-M4) + * - arm_cortexM4l_math.lib (Little endian on Cortex-M4) + * - arm_cortexM4b_math.lib (Big endian on Cortex-M4) + * - arm_cortexM3l_math.lib (Little endian on Cortex-M3) + * - arm_cortexM3b_math.lib (Big endian on Cortex-M3) + * - arm_cortexM0l_math.lib (Little endian on Cortex-M0 / CortexM0+) + * - arm_cortexM0b_math.lib (Big endian on Cortex-M0 / CortexM0+) + * + * The library functions are declared in the public file arm_math.h which is placed in the Include folder. + * Simply include this file and link the appropriate library in the application and begin calling the library functions. The Library supports single + * public header file arm_math.h for Cortex-M7/M4/M3/M0/M0+ with little endian and big endian. Same header file will be used for floating point unit(FPU) variants. + * Define the appropriate pre processor MACRO ARM_MATH_CM7 or ARM_MATH_CM4 or ARM_MATH_CM3 or + * ARM_MATH_CM0 or ARM_MATH_CM0PLUS depending on the target processor in the application. + * + * Examples + * -------- + * + * The library ships with a number of examples which demonstrate how to use the library functions. + * + * Toolchain Support + * ------------ + * + * The library has been developed and tested with MDK-ARM version 5.14.0.0 + * The library is being tested in GCC and IAR toolchains and updates on this activity will be made available shortly. + * + * Building the Library + * ------------ + * + * The library installer contains a project file to re build libraries on MDK-ARM Tool chain in the CMSIS\\DSP_Lib\\Source\\ARM folder. + * - arm_cortexM_math.uvprojx + * + * + * The libraries can be built by opening the arm_cortexM_math.uvprojx project in MDK-ARM, selecting a specific target, and defining the optional pre processor MACROs detailed above. + * + * Pre-processor Macros + * ------------ + * + * Each library project have differant pre-processor macros. + * + * - UNALIGNED_SUPPORT_DISABLE: + * + * Define macro UNALIGNED_SUPPORT_DISABLE, If the silicon does not support unaligned memory access + * + * - ARM_MATH_BIG_ENDIAN: + * + * Define macro ARM_MATH_BIG_ENDIAN to build the library for big endian targets. By default library builds for little endian targets. + * + * - ARM_MATH_MATRIX_CHECK: + * + * Define macro ARM_MATH_MATRIX_CHECK for checking on the input and output sizes of matrices + * + * - ARM_MATH_ROUNDING: + * + * Define macro ARM_MATH_ROUNDING for rounding on support functions + * + * - ARM_MATH_CMx: + * + * Define macro ARM_MATH_CM4 for building the library on Cortex-M4 target, ARM_MATH_CM3 for building library on Cortex-M3 target + * and ARM_MATH_CM0 for building library on Cortex-M0 target, ARM_MATH_CM0PLUS for building library on Cortex-M0+ target, and + * ARM_MATH_CM7 for building the library on cortex-M7. + * + * - __FPU_PRESENT: + * + * Initialize macro __FPU_PRESENT = 1 when building on FPU supported Targets. Enable this macro for M4bf and M4lf libraries + * + *
+ * CMSIS-DSP in ARM::CMSIS Pack + * ----------------------------- + * + * The following files relevant to CMSIS-DSP are present in the ARM::CMSIS Pack directories: + * |File/Folder |Content | + * |------------------------------|------------------------------------------------------------------------| + * |\b CMSIS\\Documentation\\DSP | This documentation | + * |\b CMSIS\\DSP_Lib | Software license agreement (license.txt) | + * |\b CMSIS\\DSP_Lib\\Examples | Example projects demonstrating the usage of the library functions | + * |\b CMSIS\\DSP_Lib\\Source | Source files for rebuilding the library | + * + *
+ * Revision History of CMSIS-DSP + * ------------ + * Please refer to \ref ChangeLog_pg. + * + * Copyright Notice + * ------------ + * + * Copyright (C) 2010-2015 ARM Limited. All rights reserved. + */ + + +/** + * @defgroup groupMath Basic Math Functions + */ + +/** + * @defgroup groupFastMath Fast Math Functions + * This set of functions provides a fast approximation to sine, cosine, and square root. + * As compared to most of the other functions in the CMSIS math library, the fast math functions + * operate on individual values and not arrays. + * There are separate functions for Q15, Q31, and floating-point data. + * + */ + +/** + * @defgroup groupCmplxMath Complex Math Functions + * This set of functions operates on complex data vectors. + * The data in the complex arrays is stored in an interleaved fashion + * (real, imag, real, imag, ...). + * In the API functions, the number of samples in a complex array refers + * to the number of complex values; the array contains twice this number of + * real values. + */ + +/** + * @defgroup groupFilters Filtering Functions + */ + +/** + * @defgroup groupMatrix Matrix Functions + * + * This set of functions provides basic matrix math operations. + * The functions operate on matrix data structures. For example, + * the type + * definition for the floating-point matrix structure is shown + * below: + *
+ *     typedef struct
+ *     {
+ *       uint16_t numRows;     // number of rows of the matrix.
+ *       uint16_t numCols;     // number of columns of the matrix.
+ *       float32_t *pData;     // points to the data of the matrix.
+ *     } arm_matrix_instance_f32;
+ * 
+ * There are similar definitions for Q15 and Q31 data types. + * + * The structure specifies the size of the matrix and then points to + * an array of data. The array is of size numRows X numCols + * and the values are arranged in row order. That is, the + * matrix element (i, j) is stored at: + *
+ *     pData[i*numCols + j]
+ * 
+ * + * \par Init Functions + * There is an associated initialization function for each type of matrix + * data structure. + * The initialization function sets the values of the internal structure fields. + * Refer to the function arm_mat_init_f32(), arm_mat_init_q31() + * and arm_mat_init_q15() for floating-point, Q31 and Q15 types, respectively. + * + * \par + * Use of the initialization function is optional. However, if initialization function is used + * then the instance structure cannot be placed into a const data section. + * To place the instance structure in a const data + * section, manually initialize the data structure. For example: + *
+ * arm_matrix_instance_f32 S = {nRows, nColumns, pData};
+ * arm_matrix_instance_q31 S = {nRows, nColumns, pData};
+ * arm_matrix_instance_q15 S = {nRows, nColumns, pData};
+ * 
+ * where nRows specifies the number of rows, nColumns + * specifies the number of columns, and pData points to the + * data array. + * + * \par Size Checking + * By default all of the matrix functions perform size checking on the input and + * output matrices. For example, the matrix addition function verifies that the + * two input matrices and the output matrix all have the same number of rows and + * columns. If the size check fails the functions return: + *
+ *     ARM_MATH_SIZE_MISMATCH
+ * 
+ * Otherwise the functions return + *
+ *     ARM_MATH_SUCCESS
+ * 
+ * There is some overhead associated with this matrix size checking. + * The matrix size checking is enabled via the \#define + *
+ *     ARM_MATH_MATRIX_CHECK
+ * 
+ * within the library project settings. By default this macro is defined + * and size checking is enabled. By changing the project settings and + * undefining this macro size checking is eliminated and the functions + * run a bit faster. With size checking disabled the functions always + * return ARM_MATH_SUCCESS. + */ + +/** + * @defgroup groupTransforms Transform Functions + */ + +/** + * @defgroup groupController Controller Functions + */ + +/** + * @defgroup groupStats Statistics Functions + */ +/** + * @defgroup groupSupport Support Functions + */ + +/** + * @defgroup groupInterpolation Interpolation Functions + * These functions perform 1- and 2-dimensional interpolation of data. + * Linear interpolation is used for 1-dimensional data and + * bilinear interpolation is used for 2-dimensional data. + */ + +/** + * @defgroup groupExamples Examples + */ +#ifndef _ARM_MATH_H +#define _ARM_MATH_H + +/* ignore some GCC warnings */ +#if defined ( __GNUC__ ) +#pragma GCC diagnostic push +#pragma GCC diagnostic ignored "-Wsign-conversion" +#pragma GCC diagnostic ignored "-Wconversion" +#pragma GCC diagnostic ignored "-Wunused-parameter" +#endif + +#define __CMSIS_GENERIC /* disable NVIC and Systick functions */ + +#if defined(ARM_MATH_CM7) + #include "core_cm7.h" +#elif defined (ARM_MATH_CM4) + #include "core_cm4.h" +#elif defined (ARM_MATH_CM3) + #include "core_cm3.h" +#elif defined (ARM_MATH_CM0) + #include "core_cm0.h" + #define ARM_MATH_CM0_FAMILY +#elif defined (ARM_MATH_CM0PLUS) + #include "core_cm0plus.h" + #define ARM_MATH_CM0_FAMILY +#else + #error "Define according the used Cortex core ARM_MATH_CM7, ARM_MATH_CM4, ARM_MATH_CM3, ARM_MATH_CM0PLUS or ARM_MATH_CM0" +#endif + +#undef __CMSIS_GENERIC /* enable NVIC and Systick functions */ +#include "string.h" +#include "math.h" +#ifdef __cplusplus +extern "C" +{ +#endif + + + /** + * @brief Macros required for reciprocal calculation in Normalized LMS + */ + +#define DELTA_Q31 (0x100) +#define DELTA_Q15 0x5 +#define INDEX_MASK 0x0000003F +#ifndef PI +#define PI 3.14159265358979f +#endif + + /** + * @brief Macros required for SINE and COSINE Fast math approximations + */ + +#define FAST_MATH_TABLE_SIZE 512 +#define FAST_MATH_Q31_SHIFT (32 - 10) +#define FAST_MATH_Q15_SHIFT (16 - 10) +#define CONTROLLER_Q31_SHIFT (32 - 9) +#define TABLE_SIZE 256 +#define TABLE_SPACING_Q31 0x400000 +#define TABLE_SPACING_Q15 0x80 + + /** + * @brief Macros required for SINE and COSINE Controller functions + */ + /* 1.31(q31) Fixed value of 2/360 */ + /* -1 to +1 is divided into 360 values so total spacing is (2/360) */ +#define INPUT_SPACING 0xB60B61 + + /** + * @brief Macro for Unaligned Support + */ +#ifndef UNALIGNED_SUPPORT_DISABLE + #define ALIGN4 +#else + #if defined (__GNUC__) + #define ALIGN4 __attribute__((aligned(4))) + #else + #define ALIGN4 __align(4) + #endif +#endif /* #ifndef UNALIGNED_SUPPORT_DISABLE */ + + /** + * @brief Error status returned by some functions in the library. + */ + + typedef enum + { + ARM_MATH_SUCCESS = 0, /**< No error */ + ARM_MATH_ARGUMENT_ERROR = -1, /**< One or more arguments are incorrect */ + ARM_MATH_LENGTH_ERROR = -2, /**< Length of data buffer is incorrect */ + ARM_MATH_SIZE_MISMATCH = -3, /**< Size of matrices is not compatible with the operation. */ + ARM_MATH_NANINF = -4, /**< Not-a-number (NaN) or infinity is generated */ + ARM_MATH_SINGULAR = -5, /**< Generated by matrix inversion if the input matrix is singular and cannot be inverted. */ + ARM_MATH_TEST_FAILURE = -6 /**< Test Failed */ + } arm_status; + + /** + * @brief 8-bit fractional data type in 1.7 format. + */ + typedef int8_t q7_t; + + /** + * @brief 16-bit fractional data type in 1.15 format. + */ + typedef int16_t q15_t; + + /** + * @brief 32-bit fractional data type in 1.31 format. + */ + typedef int32_t q31_t; + + /** + * @brief 64-bit fractional data type in 1.63 format. + */ + typedef int64_t q63_t; + + /** + * @brief 32-bit floating-point type definition. + */ + typedef float float32_t; + + /** + * @brief 64-bit floating-point type definition. + */ + typedef double float64_t; + + /** + * @brief definition to read/write two 16 bit values. + */ +#if defined __CC_ARM + #define __SIMD32_TYPE int32_t __packed + #define CMSIS_UNUSED __attribute__((unused)) + +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #define __SIMD32_TYPE int32_t + #define CMSIS_UNUSED __attribute__((unused)) + +#elif defined __GNUC__ + #define __SIMD32_TYPE int32_t + #define CMSIS_UNUSED __attribute__((unused)) + +#elif defined __ICCARM__ + #define __SIMD32_TYPE int32_t __packed + #define CMSIS_UNUSED + +#elif defined __CSMC__ + #define __SIMD32_TYPE int32_t + #define CMSIS_UNUSED + +#elif defined __TASKING__ + #define __SIMD32_TYPE __unaligned int32_t + #define CMSIS_UNUSED + +#else + #error Unknown compiler +#endif + +#define __SIMD32(addr) (*(__SIMD32_TYPE **) & (addr)) +#define __SIMD32_CONST(addr) ((__SIMD32_TYPE *)(addr)) +#define _SIMD32_OFFSET(addr) (*(__SIMD32_TYPE *) (addr)) +#define __SIMD64(addr) (*(int64_t **) & (addr)) + +#if defined (ARM_MATH_CM3) || defined (ARM_MATH_CM0_FAMILY) + /** + * @brief definition to pack two 16 bit values. + */ +#define __PKHBT(ARG1, ARG2, ARG3) ( (((int32_t)(ARG1) << 0) & (int32_t)0x0000FFFF) | \ + (((int32_t)(ARG2) << ARG3) & (int32_t)0xFFFF0000) ) +#define __PKHTB(ARG1, ARG2, ARG3) ( (((int32_t)(ARG1) << 0) & (int32_t)0xFFFF0000) | \ + (((int32_t)(ARG2) >> ARG3) & (int32_t)0x0000FFFF) ) + +#endif + + + /** + * @brief definition to pack four 8 bit values. + */ +#ifndef ARM_MATH_BIG_ENDIAN + +#define __PACKq7(v0,v1,v2,v3) ( (((int32_t)(v0) << 0) & (int32_t)0x000000FF) | \ + (((int32_t)(v1) << 8) & (int32_t)0x0000FF00) | \ + (((int32_t)(v2) << 16) & (int32_t)0x00FF0000) | \ + (((int32_t)(v3) << 24) & (int32_t)0xFF000000) ) +#else + +#define __PACKq7(v0,v1,v2,v3) ( (((int32_t)(v3) << 0) & (int32_t)0x000000FF) | \ + (((int32_t)(v2) << 8) & (int32_t)0x0000FF00) | \ + (((int32_t)(v1) << 16) & (int32_t)0x00FF0000) | \ + (((int32_t)(v0) << 24) & (int32_t)0xFF000000) ) + +#endif + + + /** + * @brief Clips Q63 to Q31 values. + */ + static __INLINE q31_t clip_q63_to_q31( + q63_t x) + { + return ((q31_t) (x >> 32) != ((q31_t) x >> 31)) ? + ((0x7FFFFFFF ^ ((q31_t) (x >> 63)))) : (q31_t) x; + } + + /** + * @brief Clips Q63 to Q15 values. + */ + static __INLINE q15_t clip_q63_to_q15( + q63_t x) + { + return ((q31_t) (x >> 32) != ((q31_t) x >> 31)) ? + ((0x7FFF ^ ((q15_t) (x >> 63)))) : (q15_t) (x >> 15); + } + + /** + * @brief Clips Q31 to Q7 values. + */ + static __INLINE q7_t clip_q31_to_q7( + q31_t x) + { + return ((q31_t) (x >> 24) != ((q31_t) x >> 23)) ? + ((0x7F ^ ((q7_t) (x >> 31)))) : (q7_t) x; + } + + /** + * @brief Clips Q31 to Q15 values. + */ + static __INLINE q15_t clip_q31_to_q15( + q31_t x) + { + return ((q31_t) (x >> 16) != ((q31_t) x >> 15)) ? + ((0x7FFF ^ ((q15_t) (x >> 31)))) : (q15_t) x; + } + + /** + * @brief Multiplies 32 X 64 and returns 32 bit result in 2.30 format. + */ + + static __INLINE q63_t mult32x64( + q63_t x, + q31_t y) + { + return ((((q63_t) (x & 0x00000000FFFFFFFF) * y) >> 32) + + (((q63_t) (x >> 32) * y))); + } + +/* + #if defined (ARM_MATH_CM0_FAMILY) && defined ( __CC_ARM ) + #define __CLZ __clz + #endif + */ +/* note: function can be removed when all toolchain support __CLZ for Cortex-M0 */ +#if defined (ARM_MATH_CM0_FAMILY) && ((defined (__ICCARM__)) ) + static __INLINE uint32_t __CLZ( + q31_t data); + + static __INLINE uint32_t __CLZ( + q31_t data) + { + uint32_t count = 0; + uint32_t mask = 0x80000000; + + while((data & mask) == 0) + { + count += 1u; + mask = mask >> 1u; + } + + return (count); + } +#endif + + /** + * @brief Function to Calculates 1/in (reciprocal) value of Q31 Data type. + */ + + static __INLINE uint32_t arm_recip_q31( + q31_t in, + q31_t * dst, + q31_t * pRecipTable) + { + q31_t out; + uint32_t tempVal; + uint32_t index, i; + uint32_t signBits; + + if(in > 0) + { + signBits = ((uint32_t) (__CLZ( in) - 1)); + } + else + { + signBits = ((uint32_t) (__CLZ(-in) - 1)); + } + + /* Convert input sample to 1.31 format */ + in = (in << signBits); + + /* calculation of index for initial approximated Val */ + index = (uint32_t)(in >> 24); + index = (index & INDEX_MASK); + + /* 1.31 with exp 1 */ + out = pRecipTable[index]; + + /* calculation of reciprocal value */ + /* running approximation for two iterations */ + for (i = 0u; i < 2u; i++) + { + tempVal = (uint32_t) (((q63_t) in * out) >> 31); + tempVal = 0x7FFFFFFFu - tempVal; + /* 1.31 with exp 1 */ + /* out = (q31_t) (((q63_t) out * tempVal) >> 30); */ + out = clip_q63_to_q31(((q63_t) out * tempVal) >> 30); + } + + /* write output */ + *dst = out; + + /* return num of signbits of out = 1/in value */ + return (signBits + 1u); + } + + + /** + * @brief Function to Calculates 1/in (reciprocal) value of Q15 Data type. + */ + static __INLINE uint32_t arm_recip_q15( + q15_t in, + q15_t * dst, + q15_t * pRecipTable) + { + q15_t out = 0; + uint32_t tempVal = 0; + uint32_t index = 0, i = 0; + uint32_t signBits = 0; + + if(in > 0) + { + signBits = ((uint32_t)(__CLZ( in) - 17)); + } + else + { + signBits = ((uint32_t)(__CLZ(-in) - 17)); + } + + /* Convert input sample to 1.15 format */ + in = (in << signBits); + + /* calculation of index for initial approximated Val */ + index = (uint32_t)(in >> 8); + index = (index & INDEX_MASK); + + /* 1.15 with exp 1 */ + out = pRecipTable[index]; + + /* calculation of reciprocal value */ + /* running approximation for two iterations */ + for (i = 0u; i < 2u; i++) + { + tempVal = (uint32_t) (((q31_t) in * out) >> 15); + tempVal = 0x7FFFu - tempVal; + /* 1.15 with exp 1 */ + out = (q15_t) (((q31_t) out * tempVal) >> 14); + /* out = clip_q31_to_q15(((q31_t) out * tempVal) >> 14); */ + } + + /* write output */ + *dst = out; + + /* return num of signbits of out = 1/in value */ + return (signBits + 1); + } + + + /* + * @brief C custom defined intrinisic function for only M0 processors + */ +#if defined(ARM_MATH_CM0_FAMILY) + static __INLINE q31_t __SSAT( + q31_t x, + uint32_t y) + { + int32_t posMax, negMin; + uint32_t i; + + posMax = 1; + for (i = 0; i < (y - 1); i++) + { + posMax = posMax * 2; + } + + if(x > 0) + { + posMax = (posMax - 1); + + if(x > posMax) + { + x = posMax; + } + } + else + { + negMin = -posMax; + + if(x < negMin) + { + x = negMin; + } + } + return (x); + } +#endif /* end of ARM_MATH_CM0_FAMILY */ + + + /* + * @brief C custom defined intrinsic function for M3 and M0 processors + */ +#if defined (ARM_MATH_CM3) || defined (ARM_MATH_CM0_FAMILY) + + /* + * @brief C custom defined QADD8 for M3 and M0 processors + */ + static __INLINE uint32_t __QADD8( + uint32_t x, + uint32_t y) + { + q31_t r, s, t, u; + + r = __SSAT(((((q31_t)x << 24) >> 24) + (((q31_t)y << 24) >> 24)), 8) & (int32_t)0x000000FF; + s = __SSAT(((((q31_t)x << 16) >> 24) + (((q31_t)y << 16) >> 24)), 8) & (int32_t)0x000000FF; + t = __SSAT(((((q31_t)x << 8) >> 24) + (((q31_t)y << 8) >> 24)), 8) & (int32_t)0x000000FF; + u = __SSAT(((((q31_t)x ) >> 24) + (((q31_t)y ) >> 24)), 8) & (int32_t)0x000000FF; + + return ((uint32_t)((u << 24) | (t << 16) | (s << 8) | (r ))); + } + + + /* + * @brief C custom defined QSUB8 for M3 and M0 processors + */ + static __INLINE uint32_t __QSUB8( + uint32_t x, + uint32_t y) + { + q31_t r, s, t, u; + + r = __SSAT(((((q31_t)x << 24) >> 24) - (((q31_t)y << 24) >> 24)), 8) & (int32_t)0x000000FF; + s = __SSAT(((((q31_t)x << 16) >> 24) - (((q31_t)y << 16) >> 24)), 8) & (int32_t)0x000000FF; + t = __SSAT(((((q31_t)x << 8) >> 24) - (((q31_t)y << 8) >> 24)), 8) & (int32_t)0x000000FF; + u = __SSAT(((((q31_t)x ) >> 24) - (((q31_t)y ) >> 24)), 8) & (int32_t)0x000000FF; + + return ((uint32_t)((u << 24) | (t << 16) | (s << 8) | (r ))); + } + + + /* + * @brief C custom defined QADD16 for M3 and M0 processors + */ + static __INLINE uint32_t __QADD16( + uint32_t x, + uint32_t y) + { +/* q31_t r, s; without initialisation 'arm_offset_q15 test' fails but 'intrinsic' tests pass! for armCC */ + q31_t r = 0, s = 0; + + r = __SSAT(((((q31_t)x << 16) >> 16) + (((q31_t)y << 16) >> 16)), 16) & (int32_t)0x0000FFFF; + s = __SSAT(((((q31_t)x ) >> 16) + (((q31_t)y ) >> 16)), 16) & (int32_t)0x0000FFFF; + + return ((uint32_t)((s << 16) | (r ))); + } + + + /* + * @brief C custom defined SHADD16 for M3 and M0 processors + */ + static __INLINE uint32_t __SHADD16( + uint32_t x, + uint32_t y) + { + q31_t r, s; + + r = (((((q31_t)x << 16) >> 16) + (((q31_t)y << 16) >> 16)) >> 1) & (int32_t)0x0000FFFF; + s = (((((q31_t)x ) >> 16) + (((q31_t)y ) >> 16)) >> 1) & (int32_t)0x0000FFFF; + + return ((uint32_t)((s << 16) | (r ))); + } + + + /* + * @brief C custom defined QSUB16 for M3 and M0 processors + */ + static __INLINE uint32_t __QSUB16( + uint32_t x, + uint32_t y) + { + q31_t r, s; + + r = __SSAT(((((q31_t)x << 16) >> 16) - (((q31_t)y << 16) >> 16)), 16) & (int32_t)0x0000FFFF; + s = __SSAT(((((q31_t)x ) >> 16) - (((q31_t)y ) >> 16)), 16) & (int32_t)0x0000FFFF; + + return ((uint32_t)((s << 16) | (r ))); + } + + + /* + * @brief C custom defined SHSUB16 for M3 and M0 processors + */ + static __INLINE uint32_t __SHSUB16( + uint32_t x, + uint32_t y) + { + q31_t r, s; + + r = (((((q31_t)x << 16) >> 16) - (((q31_t)y << 16) >> 16)) >> 1) & (int32_t)0x0000FFFF; + s = (((((q31_t)x ) >> 16) - (((q31_t)y ) >> 16)) >> 1) & (int32_t)0x0000FFFF; + + return ((uint32_t)((s << 16) | (r ))); + } + + + /* + * @brief C custom defined QASX for M3 and M0 processors + */ + static __INLINE uint32_t __QASX( + uint32_t x, + uint32_t y) + { + q31_t r, s; + + r = __SSAT(((((q31_t)x << 16) >> 16) - (((q31_t)y ) >> 16)), 16) & (int32_t)0x0000FFFF; + s = __SSAT(((((q31_t)x ) >> 16) + (((q31_t)y << 16) >> 16)), 16) & (int32_t)0x0000FFFF; + + return ((uint32_t)((s << 16) | (r ))); + } + + + /* + * @brief C custom defined SHASX for M3 and M0 processors + */ + static __INLINE uint32_t __SHASX( + uint32_t x, + uint32_t y) + { + q31_t r, s; + + r = (((((q31_t)x << 16) >> 16) - (((q31_t)y ) >> 16)) >> 1) & (int32_t)0x0000FFFF; + s = (((((q31_t)x ) >> 16) + (((q31_t)y << 16) >> 16)) >> 1) & (int32_t)0x0000FFFF; + + return ((uint32_t)((s << 16) | (r ))); + } + + + /* + * @brief C custom defined QSAX for M3 and M0 processors + */ + static __INLINE uint32_t __QSAX( + uint32_t x, + uint32_t y) + { + q31_t r, s; + + r = __SSAT(((((q31_t)x << 16) >> 16) + (((q31_t)y ) >> 16)), 16) & (int32_t)0x0000FFFF; + s = __SSAT(((((q31_t)x ) >> 16) - (((q31_t)y << 16) >> 16)), 16) & (int32_t)0x0000FFFF; + + return ((uint32_t)((s << 16) | (r ))); + } + + + /* + * @brief C custom defined SHSAX for M3 and M0 processors + */ + static __INLINE uint32_t __SHSAX( + uint32_t x, + uint32_t y) + { + q31_t r, s; + + r = (((((q31_t)x << 16) >> 16) + (((q31_t)y ) >> 16)) >> 1) & (int32_t)0x0000FFFF; + s = (((((q31_t)x ) >> 16) - (((q31_t)y << 16) >> 16)) >> 1) & (int32_t)0x0000FFFF; + + return ((uint32_t)((s << 16) | (r ))); + } + + + /* + * @brief C custom defined SMUSDX for M3 and M0 processors + */ + static __INLINE uint32_t __SMUSDX( + uint32_t x, + uint32_t y) + { + return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y ) >> 16)) - + ((((q31_t)x ) >> 16) * (((q31_t)y << 16) >> 16)) )); + } + + /* + * @brief C custom defined SMUADX for M3 and M0 processors + */ + static __INLINE uint32_t __SMUADX( + uint32_t x, + uint32_t y) + { + return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y ) >> 16)) + + ((((q31_t)x ) >> 16) * (((q31_t)y << 16) >> 16)) )); + } + + + /* + * @brief C custom defined QADD for M3 and M0 processors + */ + static __INLINE int32_t __QADD( + int32_t x, + int32_t y) + { + return ((int32_t)(clip_q63_to_q31((q63_t)x + (q31_t)y))); + } + + + /* + * @brief C custom defined QSUB for M3 and M0 processors + */ + static __INLINE int32_t __QSUB( + int32_t x, + int32_t y) + { + return ((int32_t)(clip_q63_to_q31((q63_t)x - (q31_t)y))); + } + + + /* + * @brief C custom defined SMLAD for M3 and M0 processors + */ + static __INLINE uint32_t __SMLAD( + uint32_t x, + uint32_t y, + uint32_t sum) + { + return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y << 16) >> 16)) + + ((((q31_t)x ) >> 16) * (((q31_t)y ) >> 16)) + + ( ((q31_t)sum ) ) )); + } + + + /* + * @brief C custom defined SMLADX for M3 and M0 processors + */ + static __INLINE uint32_t __SMLADX( + uint32_t x, + uint32_t y, + uint32_t sum) + { + return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y ) >> 16)) + + ((((q31_t)x ) >> 16) * (((q31_t)y << 16) >> 16)) + + ( ((q31_t)sum ) ) )); + } + + + /* + * @brief C custom defined SMLSDX for M3 and M0 processors + */ + static __INLINE uint32_t __SMLSDX( + uint32_t x, + uint32_t y, + uint32_t sum) + { + return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y ) >> 16)) - + ((((q31_t)x ) >> 16) * (((q31_t)y << 16) >> 16)) + + ( ((q31_t)sum ) ) )); + } + + + /* + * @brief C custom defined SMLALD for M3 and M0 processors + */ + static __INLINE uint64_t __SMLALD( + uint32_t x, + uint32_t y, + uint64_t sum) + { +/* return (sum + ((q15_t) (x >> 16) * (q15_t) (y >> 16)) + ((q15_t) x * (q15_t) y)); */ + return ((uint64_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y << 16) >> 16)) + + ((((q31_t)x ) >> 16) * (((q31_t)y ) >> 16)) + + ( ((q63_t)sum ) ) )); + } + + + /* + * @brief C custom defined SMLALDX for M3 and M0 processors + */ + static __INLINE uint64_t __SMLALDX( + uint32_t x, + uint32_t y, + uint64_t sum) + { +/* return (sum + ((q15_t) (x >> 16) * (q15_t) y)) + ((q15_t) x * (q15_t) (y >> 16)); */ + return ((uint64_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y ) >> 16)) + + ((((q31_t)x ) >> 16) * (((q31_t)y << 16) >> 16)) + + ( ((q63_t)sum ) ) )); + } + + + /* + * @brief C custom defined SMUAD for M3 and M0 processors + */ + static __INLINE uint32_t __SMUAD( + uint32_t x, + uint32_t y) + { + return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y << 16) >> 16)) + + ((((q31_t)x ) >> 16) * (((q31_t)y ) >> 16)) )); + } + + + /* + * @brief C custom defined SMUSD for M3 and M0 processors + */ + static __INLINE uint32_t __SMUSD( + uint32_t x, + uint32_t y) + { + return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y << 16) >> 16)) - + ((((q31_t)x ) >> 16) * (((q31_t)y ) >> 16)) )); + } + + + /* + * @brief C custom defined SXTB16 for M3 and M0 processors + */ + static __INLINE uint32_t __SXTB16( + uint32_t x) + { + return ((uint32_t)(((((q31_t)x << 24) >> 24) & (q31_t)0x0000FFFF) | + ((((q31_t)x << 8) >> 8) & (q31_t)0xFFFF0000) )); + } + +#endif /* defined (ARM_MATH_CM3) || defined (ARM_MATH_CM0_FAMILY) */ + + + /** + * @brief Instance structure for the Q7 FIR filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of filter coefficients in the filter. */ + q7_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + q7_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + } arm_fir_instance_q7; + + /** + * @brief Instance structure for the Q15 FIR filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of filter coefficients in the filter. */ + q15_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + } arm_fir_instance_q15; + + /** + * @brief Instance structure for the Q31 FIR filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of filter coefficients in the filter. */ + q31_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + } arm_fir_instance_q31; + + /** + * @brief Instance structure for the floating-point FIR filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of filter coefficients in the filter. */ + float32_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + } arm_fir_instance_f32; + + + /** + * @brief Processing function for the Q7 FIR filter. + * @param[in] S points to an instance of the Q7 FIR filter structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_fir_q7( + const arm_fir_instance_q7 * S, + q7_t * pSrc, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q7 FIR filter. + * @param[in,out] S points to an instance of the Q7 FIR structure. + * @param[in] numTaps Number of filter coefficients in the filter. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] blockSize number of samples that are processed. + */ + void arm_fir_init_q7( + arm_fir_instance_q7 * S, + uint16_t numTaps, + q7_t * pCoeffs, + q7_t * pState, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q15 FIR filter. + * @param[in] S points to an instance of the Q15 FIR structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_fir_q15( + const arm_fir_instance_q15 * S, + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Processing function for the fast Q15 FIR filter for Cortex-M3 and Cortex-M4. + * @param[in] S points to an instance of the Q15 FIR filter structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_fir_fast_q15( + const arm_fir_instance_q15 * S, + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q15 FIR filter. + * @param[in,out] S points to an instance of the Q15 FIR filter structure. + * @param[in] numTaps Number of filter coefficients in the filter. Must be even and greater than or equal to 4. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] blockSize number of samples that are processed at a time. + * @return The function returns ARM_MATH_SUCCESS if initialization was successful or ARM_MATH_ARGUMENT_ERROR if + * numTaps is not a supported value. + */ + arm_status arm_fir_init_q15( + arm_fir_instance_q15 * S, + uint16_t numTaps, + q15_t * pCoeffs, + q15_t * pState, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q31 FIR filter. + * @param[in] S points to an instance of the Q31 FIR filter structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_fir_q31( + const arm_fir_instance_q31 * S, + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Processing function for the fast Q31 FIR filter for Cortex-M3 and Cortex-M4. + * @param[in] S points to an instance of the Q31 FIR structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_fir_fast_q31( + const arm_fir_instance_q31 * S, + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q31 FIR filter. + * @param[in,out] S points to an instance of the Q31 FIR structure. + * @param[in] numTaps Number of filter coefficients in the filter. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] blockSize number of samples that are processed at a time. + */ + void arm_fir_init_q31( + arm_fir_instance_q31 * S, + uint16_t numTaps, + q31_t * pCoeffs, + q31_t * pState, + uint32_t blockSize); + + + /** + * @brief Processing function for the floating-point FIR filter. + * @param[in] S points to an instance of the floating-point FIR structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_fir_f32( + const arm_fir_instance_f32 * S, + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the floating-point FIR filter. + * @param[in,out] S points to an instance of the floating-point FIR filter structure. + * @param[in] numTaps Number of filter coefficients in the filter. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] blockSize number of samples that are processed at a time. + */ + void arm_fir_init_f32( + arm_fir_instance_f32 * S, + uint16_t numTaps, + float32_t * pCoeffs, + float32_t * pState, + uint32_t blockSize); + + + /** + * @brief Instance structure for the Q15 Biquad cascade filter. + */ + typedef struct + { + int8_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + q15_t *pState; /**< Points to the array of state coefficients. The array is of length 4*numStages. */ + q15_t *pCoeffs; /**< Points to the array of coefficients. The array is of length 5*numStages. */ + int8_t postShift; /**< Additional shift, in bits, applied to each output sample. */ + } arm_biquad_casd_df1_inst_q15; + + /** + * @brief Instance structure for the Q31 Biquad cascade filter. + */ + typedef struct + { + uint32_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + q31_t *pState; /**< Points to the array of state coefficients. The array is of length 4*numStages. */ + q31_t *pCoeffs; /**< Points to the array of coefficients. The array is of length 5*numStages. */ + uint8_t postShift; /**< Additional shift, in bits, applied to each output sample. */ + } arm_biquad_casd_df1_inst_q31; + + /** + * @brief Instance structure for the floating-point Biquad cascade filter. + */ + typedef struct + { + uint32_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + float32_t *pState; /**< Points to the array of state coefficients. The array is of length 4*numStages. */ + float32_t *pCoeffs; /**< Points to the array of coefficients. The array is of length 5*numStages. */ + } arm_biquad_casd_df1_inst_f32; + + + /** + * @brief Processing function for the Q15 Biquad cascade filter. + * @param[in] S points to an instance of the Q15 Biquad cascade structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_biquad_cascade_df1_q15( + const arm_biquad_casd_df1_inst_q15 * S, + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q15 Biquad cascade filter. + * @param[in,out] S points to an instance of the Q15 Biquad cascade structure. + * @param[in] numStages number of 2nd order stages in the filter. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] postShift Shift to be applied to the output. Varies according to the coefficients format + */ + void arm_biquad_cascade_df1_init_q15( + arm_biquad_casd_df1_inst_q15 * S, + uint8_t numStages, + q15_t * pCoeffs, + q15_t * pState, + int8_t postShift); + + + /** + * @brief Fast but less precise processing function for the Q15 Biquad cascade filter for Cortex-M3 and Cortex-M4. + * @param[in] S points to an instance of the Q15 Biquad cascade structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_biquad_cascade_df1_fast_q15( + const arm_biquad_casd_df1_inst_q15 * S, + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q31 Biquad cascade filter + * @param[in] S points to an instance of the Q31 Biquad cascade structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_biquad_cascade_df1_q31( + const arm_biquad_casd_df1_inst_q31 * S, + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Fast but less precise processing function for the Q31 Biquad cascade filter for Cortex-M3 and Cortex-M4. + * @param[in] S points to an instance of the Q31 Biquad cascade structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_biquad_cascade_df1_fast_q31( + const arm_biquad_casd_df1_inst_q31 * S, + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q31 Biquad cascade filter. + * @param[in,out] S points to an instance of the Q31 Biquad cascade structure. + * @param[in] numStages number of 2nd order stages in the filter. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] postShift Shift to be applied to the output. Varies according to the coefficients format + */ + void arm_biquad_cascade_df1_init_q31( + arm_biquad_casd_df1_inst_q31 * S, + uint8_t numStages, + q31_t * pCoeffs, + q31_t * pState, + int8_t postShift); + + + /** + * @brief Processing function for the floating-point Biquad cascade filter. + * @param[in] S points to an instance of the floating-point Biquad cascade structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_biquad_cascade_df1_f32( + const arm_biquad_casd_df1_inst_f32 * S, + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the floating-point Biquad cascade filter. + * @param[in,out] S points to an instance of the floating-point Biquad cascade structure. + * @param[in] numStages number of 2nd order stages in the filter. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + */ + void arm_biquad_cascade_df1_init_f32( + arm_biquad_casd_df1_inst_f32 * S, + uint8_t numStages, + float32_t * pCoeffs, + float32_t * pState); + + + /** + * @brief Instance structure for the floating-point matrix structure. + */ + typedef struct + { + uint16_t numRows; /**< number of rows of the matrix. */ + uint16_t numCols; /**< number of columns of the matrix. */ + float32_t *pData; /**< points to the data of the matrix. */ + } arm_matrix_instance_f32; + + + /** + * @brief Instance structure for the floating-point matrix structure. + */ + typedef struct + { + uint16_t numRows; /**< number of rows of the matrix. */ + uint16_t numCols; /**< number of columns of the matrix. */ + float64_t *pData; /**< points to the data of the matrix. */ + } arm_matrix_instance_f64; + + /** + * @brief Instance structure for the Q15 matrix structure. + */ + typedef struct + { + uint16_t numRows; /**< number of rows of the matrix. */ + uint16_t numCols; /**< number of columns of the matrix. */ + q15_t *pData; /**< points to the data of the matrix. */ + } arm_matrix_instance_q15; + + /** + * @brief Instance structure for the Q31 matrix structure. + */ + typedef struct + { + uint16_t numRows; /**< number of rows of the matrix. */ + uint16_t numCols; /**< number of columns of the matrix. */ + q31_t *pData; /**< points to the data of the matrix. */ + } arm_matrix_instance_q31; + + + /** + * @brief Floating-point matrix addition. + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_add_f32( + const arm_matrix_instance_f32 * pSrcA, + const arm_matrix_instance_f32 * pSrcB, + arm_matrix_instance_f32 * pDst); + + + /** + * @brief Q15 matrix addition. + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_add_q15( + const arm_matrix_instance_q15 * pSrcA, + const arm_matrix_instance_q15 * pSrcB, + arm_matrix_instance_q15 * pDst); + + + /** + * @brief Q31 matrix addition. + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_add_q31( + const arm_matrix_instance_q31 * pSrcA, + const arm_matrix_instance_q31 * pSrcB, + arm_matrix_instance_q31 * pDst); + + + /** + * @brief Floating-point, complex, matrix multiplication. + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_cmplx_mult_f32( + const arm_matrix_instance_f32 * pSrcA, + const arm_matrix_instance_f32 * pSrcB, + arm_matrix_instance_f32 * pDst); + + + /** + * @brief Q15, complex, matrix multiplication. + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_cmplx_mult_q15( + const arm_matrix_instance_q15 * pSrcA, + const arm_matrix_instance_q15 * pSrcB, + arm_matrix_instance_q15 * pDst, + q15_t * pScratch); + + + /** + * @brief Q31, complex, matrix multiplication. + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_cmplx_mult_q31( + const arm_matrix_instance_q31 * pSrcA, + const arm_matrix_instance_q31 * pSrcB, + arm_matrix_instance_q31 * pDst); + + + /** + * @brief Floating-point matrix transpose. + * @param[in] pSrc points to the input matrix + * @param[out] pDst points to the output matrix + * @return The function returns either ARM_MATH_SIZE_MISMATCH + * or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_trans_f32( + const arm_matrix_instance_f32 * pSrc, + arm_matrix_instance_f32 * pDst); + + + /** + * @brief Q15 matrix transpose. + * @param[in] pSrc points to the input matrix + * @param[out] pDst points to the output matrix + * @return The function returns either ARM_MATH_SIZE_MISMATCH + * or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_trans_q15( + const arm_matrix_instance_q15 * pSrc, + arm_matrix_instance_q15 * pDst); + + + /** + * @brief Q31 matrix transpose. + * @param[in] pSrc points to the input matrix + * @param[out] pDst points to the output matrix + * @return The function returns either ARM_MATH_SIZE_MISMATCH + * or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_trans_q31( + const arm_matrix_instance_q31 * pSrc, + arm_matrix_instance_q31 * pDst); + + + /** + * @brief Floating-point matrix multiplication + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_mult_f32( + const arm_matrix_instance_f32 * pSrcA, + const arm_matrix_instance_f32 * pSrcB, + arm_matrix_instance_f32 * pDst); + + + /** + * @brief Q15 matrix multiplication + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @param[in] pState points to the array for storing intermediate results + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_mult_q15( + const arm_matrix_instance_q15 * pSrcA, + const arm_matrix_instance_q15 * pSrcB, + arm_matrix_instance_q15 * pDst, + q15_t * pState); + + + /** + * @brief Q15 matrix multiplication (fast variant) for Cortex-M3 and Cortex-M4 + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @param[in] pState points to the array for storing intermediate results + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_mult_fast_q15( + const arm_matrix_instance_q15 * pSrcA, + const arm_matrix_instance_q15 * pSrcB, + arm_matrix_instance_q15 * pDst, + q15_t * pState); + + + /** + * @brief Q31 matrix multiplication + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_mult_q31( + const arm_matrix_instance_q31 * pSrcA, + const arm_matrix_instance_q31 * pSrcB, + arm_matrix_instance_q31 * pDst); + + + /** + * @brief Q31 matrix multiplication (fast variant) for Cortex-M3 and Cortex-M4 + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_mult_fast_q31( + const arm_matrix_instance_q31 * pSrcA, + const arm_matrix_instance_q31 * pSrcB, + arm_matrix_instance_q31 * pDst); + + + /** + * @brief Floating-point matrix subtraction + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_sub_f32( + const arm_matrix_instance_f32 * pSrcA, + const arm_matrix_instance_f32 * pSrcB, + arm_matrix_instance_f32 * pDst); + + + /** + * @brief Q15 matrix subtraction + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_sub_q15( + const arm_matrix_instance_q15 * pSrcA, + const arm_matrix_instance_q15 * pSrcB, + arm_matrix_instance_q15 * pDst); + + + /** + * @brief Q31 matrix subtraction + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_sub_q31( + const arm_matrix_instance_q31 * pSrcA, + const arm_matrix_instance_q31 * pSrcB, + arm_matrix_instance_q31 * pDst); + + + /** + * @brief Floating-point matrix scaling. + * @param[in] pSrc points to the input matrix + * @param[in] scale scale factor + * @param[out] pDst points to the output matrix + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_scale_f32( + const arm_matrix_instance_f32 * pSrc, + float32_t scale, + arm_matrix_instance_f32 * pDst); + + + /** + * @brief Q15 matrix scaling. + * @param[in] pSrc points to input matrix + * @param[in] scaleFract fractional portion of the scale factor + * @param[in] shift number of bits to shift the result by + * @param[out] pDst points to output matrix + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_scale_q15( + const arm_matrix_instance_q15 * pSrc, + q15_t scaleFract, + int32_t shift, + arm_matrix_instance_q15 * pDst); + + + /** + * @brief Q31 matrix scaling. + * @param[in] pSrc points to input matrix + * @param[in] scaleFract fractional portion of the scale factor + * @param[in] shift number of bits to shift the result by + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_scale_q31( + const arm_matrix_instance_q31 * pSrc, + q31_t scaleFract, + int32_t shift, + arm_matrix_instance_q31 * pDst); + + + /** + * @brief Q31 matrix initialization. + * @param[in,out] S points to an instance of the floating-point matrix structure. + * @param[in] nRows number of rows in the matrix. + * @param[in] nColumns number of columns in the matrix. + * @param[in] pData points to the matrix data array. + */ + void arm_mat_init_q31( + arm_matrix_instance_q31 * S, + uint16_t nRows, + uint16_t nColumns, + q31_t * pData); + + + /** + * @brief Q15 matrix initialization. + * @param[in,out] S points to an instance of the floating-point matrix structure. + * @param[in] nRows number of rows in the matrix. + * @param[in] nColumns number of columns in the matrix. + * @param[in] pData points to the matrix data array. + */ + void arm_mat_init_q15( + arm_matrix_instance_q15 * S, + uint16_t nRows, + uint16_t nColumns, + q15_t * pData); + + + /** + * @brief Floating-point matrix initialization. + * @param[in,out] S points to an instance of the floating-point matrix structure. + * @param[in] nRows number of rows in the matrix. + * @param[in] nColumns number of columns in the matrix. + * @param[in] pData points to the matrix data array. + */ + void arm_mat_init_f32( + arm_matrix_instance_f32 * S, + uint16_t nRows, + uint16_t nColumns, + float32_t * pData); + + + + /** + * @brief Instance structure for the Q15 PID Control. + */ + typedef struct + { + q15_t A0; /**< The derived gain, A0 = Kp + Ki + Kd . */ +#ifdef ARM_MATH_CM0_FAMILY + q15_t A1; + q15_t A2; +#else + q31_t A1; /**< The derived gain A1 = -Kp - 2Kd | Kd.*/ +#endif + q15_t state[3]; /**< The state array of length 3. */ + q15_t Kp; /**< The proportional gain. */ + q15_t Ki; /**< The integral gain. */ + q15_t Kd; /**< The derivative gain. */ + } arm_pid_instance_q15; + + /** + * @brief Instance structure for the Q31 PID Control. + */ + typedef struct + { + q31_t A0; /**< The derived gain, A0 = Kp + Ki + Kd . */ + q31_t A1; /**< The derived gain, A1 = -Kp - 2Kd. */ + q31_t A2; /**< The derived gain, A2 = Kd . */ + q31_t state[3]; /**< The state array of length 3. */ + q31_t Kp; /**< The proportional gain. */ + q31_t Ki; /**< The integral gain. */ + q31_t Kd; /**< The derivative gain. */ + } arm_pid_instance_q31; + + /** + * @brief Instance structure for the floating-point PID Control. + */ + typedef struct + { + float32_t A0; /**< The derived gain, A0 = Kp + Ki + Kd . */ + float32_t A1; /**< The derived gain, A1 = -Kp - 2Kd. */ + float32_t A2; /**< The derived gain, A2 = Kd . */ + float32_t state[3]; /**< The state array of length 3. */ + float32_t Kp; /**< The proportional gain. */ + float32_t Ki; /**< The integral gain. */ + float32_t Kd; /**< The derivative gain. */ + } arm_pid_instance_f32; + + + + /** + * @brief Initialization function for the floating-point PID Control. + * @param[in,out] S points to an instance of the PID structure. + * @param[in] resetStateFlag flag to reset the state. 0 = no change in state 1 = reset the state. + */ + void arm_pid_init_f32( + arm_pid_instance_f32 * S, + int32_t resetStateFlag); + + + /** + * @brief Reset function for the floating-point PID Control. + * @param[in,out] S is an instance of the floating-point PID Control structure + */ + void arm_pid_reset_f32( + arm_pid_instance_f32 * S); + + + /** + * @brief Initialization function for the Q31 PID Control. + * @param[in,out] S points to an instance of the Q15 PID structure. + * @param[in] resetStateFlag flag to reset the state. 0 = no change in state 1 = reset the state. + */ + void arm_pid_init_q31( + arm_pid_instance_q31 * S, + int32_t resetStateFlag); + + + /** + * @brief Reset function for the Q31 PID Control. + * @param[in,out] S points to an instance of the Q31 PID Control structure + */ + + void arm_pid_reset_q31( + arm_pid_instance_q31 * S); + + + /** + * @brief Initialization function for the Q15 PID Control. + * @param[in,out] S points to an instance of the Q15 PID structure. + * @param[in] resetStateFlag flag to reset the state. 0 = no change in state 1 = reset the state. + */ + void arm_pid_init_q15( + arm_pid_instance_q15 * S, + int32_t resetStateFlag); + + + /** + * @brief Reset function for the Q15 PID Control. + * @param[in,out] S points to an instance of the q15 PID Control structure + */ + void arm_pid_reset_q15( + arm_pid_instance_q15 * S); + + + /** + * @brief Instance structure for the floating-point Linear Interpolate function. + */ + typedef struct + { + uint32_t nValues; /**< nValues */ + float32_t x1; /**< x1 */ + float32_t xSpacing; /**< xSpacing */ + float32_t *pYData; /**< pointer to the table of Y values */ + } arm_linear_interp_instance_f32; + + /** + * @brief Instance structure for the floating-point bilinear interpolation function. + */ + typedef struct + { + uint16_t numRows; /**< number of rows in the data table. */ + uint16_t numCols; /**< number of columns in the data table. */ + float32_t *pData; /**< points to the data table. */ + } arm_bilinear_interp_instance_f32; + + /** + * @brief Instance structure for the Q31 bilinear interpolation function. + */ + typedef struct + { + uint16_t numRows; /**< number of rows in the data table. */ + uint16_t numCols; /**< number of columns in the data table. */ + q31_t *pData; /**< points to the data table. */ + } arm_bilinear_interp_instance_q31; + + /** + * @brief Instance structure for the Q15 bilinear interpolation function. + */ + typedef struct + { + uint16_t numRows; /**< number of rows in the data table. */ + uint16_t numCols; /**< number of columns in the data table. */ + q15_t *pData; /**< points to the data table. */ + } arm_bilinear_interp_instance_q15; + + /** + * @brief Instance structure for the Q15 bilinear interpolation function. + */ + typedef struct + { + uint16_t numRows; /**< number of rows in the data table. */ + uint16_t numCols; /**< number of columns in the data table. */ + q7_t *pData; /**< points to the data table. */ + } arm_bilinear_interp_instance_q7; + + + /** + * @brief Q7 vector multiplication. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_mult_q7( + q7_t * pSrcA, + q7_t * pSrcB, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Q15 vector multiplication. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_mult_q15( + q15_t * pSrcA, + q15_t * pSrcB, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Q31 vector multiplication. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_mult_q31( + q31_t * pSrcA, + q31_t * pSrcB, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Floating-point vector multiplication. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_mult_f32( + float32_t * pSrcA, + float32_t * pSrcB, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Instance structure for the Q15 CFFT/CIFFT function. + */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ + uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ + q15_t *pTwiddle; /**< points to the Sin twiddle factor table. */ + uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ + } arm_cfft_radix2_instance_q15; + +/* Deprecated */ + arm_status arm_cfft_radix2_init_q15( + arm_cfft_radix2_instance_q15 * S, + uint16_t fftLen, + uint8_t ifftFlag, + uint8_t bitReverseFlag); + +/* Deprecated */ + void arm_cfft_radix2_q15( + const arm_cfft_radix2_instance_q15 * S, + q15_t * pSrc); + + + /** + * @brief Instance structure for the Q15 CFFT/CIFFT function. + */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ + uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ + q15_t *pTwiddle; /**< points to the twiddle factor table. */ + uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ + } arm_cfft_radix4_instance_q15; + +/* Deprecated */ + arm_status arm_cfft_radix4_init_q15( + arm_cfft_radix4_instance_q15 * S, + uint16_t fftLen, + uint8_t ifftFlag, + uint8_t bitReverseFlag); + +/* Deprecated */ + void arm_cfft_radix4_q15( + const arm_cfft_radix4_instance_q15 * S, + q15_t * pSrc); + + /** + * @brief Instance structure for the Radix-2 Q31 CFFT/CIFFT function. + */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ + uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ + q31_t *pTwiddle; /**< points to the Twiddle factor table. */ + uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ + } arm_cfft_radix2_instance_q31; + +/* Deprecated */ + arm_status arm_cfft_radix2_init_q31( + arm_cfft_radix2_instance_q31 * S, + uint16_t fftLen, + uint8_t ifftFlag, + uint8_t bitReverseFlag); + +/* Deprecated */ + void arm_cfft_radix2_q31( + const arm_cfft_radix2_instance_q31 * S, + q31_t * pSrc); + + /** + * @brief Instance structure for the Q31 CFFT/CIFFT function. + */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ + uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ + q31_t *pTwiddle; /**< points to the twiddle factor table. */ + uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ + } arm_cfft_radix4_instance_q31; + +/* Deprecated */ + void arm_cfft_radix4_q31( + const arm_cfft_radix4_instance_q31 * S, + q31_t * pSrc); + +/* Deprecated */ + arm_status arm_cfft_radix4_init_q31( + arm_cfft_radix4_instance_q31 * S, + uint16_t fftLen, + uint8_t ifftFlag, + uint8_t bitReverseFlag); + + /** + * @brief Instance structure for the floating-point CFFT/CIFFT function. + */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ + uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ + float32_t *pTwiddle; /**< points to the Twiddle factor table. */ + uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ + float32_t onebyfftLen; /**< value of 1/fftLen. */ + } arm_cfft_radix2_instance_f32; + +/* Deprecated */ + arm_status arm_cfft_radix2_init_f32( + arm_cfft_radix2_instance_f32 * S, + uint16_t fftLen, + uint8_t ifftFlag, + uint8_t bitReverseFlag); + +/* Deprecated */ + void arm_cfft_radix2_f32( + const arm_cfft_radix2_instance_f32 * S, + float32_t * pSrc); + + /** + * @brief Instance structure for the floating-point CFFT/CIFFT function. + */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ + uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ + float32_t *pTwiddle; /**< points to the Twiddle factor table. */ + uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ + float32_t onebyfftLen; /**< value of 1/fftLen. */ + } arm_cfft_radix4_instance_f32; + +/* Deprecated */ + arm_status arm_cfft_radix4_init_f32( + arm_cfft_radix4_instance_f32 * S, + uint16_t fftLen, + uint8_t ifftFlag, + uint8_t bitReverseFlag); + +/* Deprecated */ + void arm_cfft_radix4_f32( + const arm_cfft_radix4_instance_f32 * S, + float32_t * pSrc); + + /** + * @brief Instance structure for the fixed-point CFFT/CIFFT function. + */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + const q15_t *pTwiddle; /**< points to the Twiddle factor table. */ + const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t bitRevLength; /**< bit reversal table length. */ + } arm_cfft_instance_q15; + +void arm_cfft_q15( + const arm_cfft_instance_q15 * S, + q15_t * p1, + uint8_t ifftFlag, + uint8_t bitReverseFlag); + + /** + * @brief Instance structure for the fixed-point CFFT/CIFFT function. + */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + const q31_t *pTwiddle; /**< points to the Twiddle factor table. */ + const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t bitRevLength; /**< bit reversal table length. */ + } arm_cfft_instance_q31; + +void arm_cfft_q31( + const arm_cfft_instance_q31 * S, + q31_t * p1, + uint8_t ifftFlag, + uint8_t bitReverseFlag); + + /** + * @brief Instance structure for the floating-point CFFT/CIFFT function. + */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + const float32_t *pTwiddle; /**< points to the Twiddle factor table. */ + const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t bitRevLength; /**< bit reversal table length. */ + } arm_cfft_instance_f32; + + void arm_cfft_f32( + const arm_cfft_instance_f32 * S, + float32_t * p1, + uint8_t ifftFlag, + uint8_t bitReverseFlag); + + /** + * @brief Instance structure for the Q15 RFFT/RIFFT function. + */ + typedef struct + { + uint32_t fftLenReal; /**< length of the real FFT. */ + uint8_t ifftFlagR; /**< flag that selects forward (ifftFlagR=0) or inverse (ifftFlagR=1) transform. */ + uint8_t bitReverseFlagR; /**< flag that enables (bitReverseFlagR=1) or disables (bitReverseFlagR=0) bit reversal of output. */ + uint32_t twidCoefRModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + q15_t *pTwiddleAReal; /**< points to the real twiddle factor table. */ + q15_t *pTwiddleBReal; /**< points to the imag twiddle factor table. */ + const arm_cfft_instance_q15 *pCfft; /**< points to the complex FFT instance. */ + } arm_rfft_instance_q15; + + arm_status arm_rfft_init_q15( + arm_rfft_instance_q15 * S, + uint32_t fftLenReal, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + + void arm_rfft_q15( + const arm_rfft_instance_q15 * S, + q15_t * pSrc, + q15_t * pDst); + + /** + * @brief Instance structure for the Q31 RFFT/RIFFT function. + */ + typedef struct + { + uint32_t fftLenReal; /**< length of the real FFT. */ + uint8_t ifftFlagR; /**< flag that selects forward (ifftFlagR=0) or inverse (ifftFlagR=1) transform. */ + uint8_t bitReverseFlagR; /**< flag that enables (bitReverseFlagR=1) or disables (bitReverseFlagR=0) bit reversal of output. */ + uint32_t twidCoefRModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + q31_t *pTwiddleAReal; /**< points to the real twiddle factor table. */ + q31_t *pTwiddleBReal; /**< points to the imag twiddle factor table. */ + const arm_cfft_instance_q31 *pCfft; /**< points to the complex FFT instance. */ + } arm_rfft_instance_q31; + + arm_status arm_rfft_init_q31( + arm_rfft_instance_q31 * S, + uint32_t fftLenReal, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + + void arm_rfft_q31( + const arm_rfft_instance_q31 * S, + q31_t * pSrc, + q31_t * pDst); + + /** + * @brief Instance structure for the floating-point RFFT/RIFFT function. + */ + typedef struct + { + uint32_t fftLenReal; /**< length of the real FFT. */ + uint16_t fftLenBy2; /**< length of the complex FFT. */ + uint8_t ifftFlagR; /**< flag that selects forward (ifftFlagR=0) or inverse (ifftFlagR=1) transform. */ + uint8_t bitReverseFlagR; /**< flag that enables (bitReverseFlagR=1) or disables (bitReverseFlagR=0) bit reversal of output. */ + uint32_t twidCoefRModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + float32_t *pTwiddleAReal; /**< points to the real twiddle factor table. */ + float32_t *pTwiddleBReal; /**< points to the imag twiddle factor table. */ + arm_cfft_radix4_instance_f32 *pCfft; /**< points to the complex FFT instance. */ + } arm_rfft_instance_f32; + + arm_status arm_rfft_init_f32( + arm_rfft_instance_f32 * S, + arm_cfft_radix4_instance_f32 * S_CFFT, + uint32_t fftLenReal, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + + void arm_rfft_f32( + const arm_rfft_instance_f32 * S, + float32_t * pSrc, + float32_t * pDst); + + /** + * @brief Instance structure for the floating-point RFFT/RIFFT function. + */ +typedef struct + { + arm_cfft_instance_f32 Sint; /**< Internal CFFT structure. */ + uint16_t fftLenRFFT; /**< length of the real sequence */ + float32_t * pTwiddleRFFT; /**< Twiddle factors real stage */ + } arm_rfft_fast_instance_f32 ; + +arm_status arm_rfft_fast_init_f32 ( + arm_rfft_fast_instance_f32 * S, + uint16_t fftLen); + +void arm_rfft_fast_f32( + arm_rfft_fast_instance_f32 * S, + float32_t * p, float32_t * pOut, + uint8_t ifftFlag); + + /** + * @brief Instance structure for the floating-point DCT4/IDCT4 function. + */ + typedef struct + { + uint16_t N; /**< length of the DCT4. */ + uint16_t Nby2; /**< half of the length of the DCT4. */ + float32_t normalize; /**< normalizing factor. */ + float32_t *pTwiddle; /**< points to the twiddle factor table. */ + float32_t *pCosFactor; /**< points to the cosFactor table. */ + arm_rfft_instance_f32 *pRfft; /**< points to the real FFT instance. */ + arm_cfft_radix4_instance_f32 *pCfft; /**< points to the complex FFT instance. */ + } arm_dct4_instance_f32; + + + /** + * @brief Initialization function for the floating-point DCT4/IDCT4. + * @param[in,out] S points to an instance of floating-point DCT4/IDCT4 structure. + * @param[in] S_RFFT points to an instance of floating-point RFFT/RIFFT structure. + * @param[in] S_CFFT points to an instance of floating-point CFFT/CIFFT structure. + * @param[in] N length of the DCT4. + * @param[in] Nby2 half of the length of the DCT4. + * @param[in] normalize normalizing factor. + * @return arm_status function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_ARGUMENT_ERROR if fftLenReal is not a supported transform length. + */ + arm_status arm_dct4_init_f32( + arm_dct4_instance_f32 * S, + arm_rfft_instance_f32 * S_RFFT, + arm_cfft_radix4_instance_f32 * S_CFFT, + uint16_t N, + uint16_t Nby2, + float32_t normalize); + + + /** + * @brief Processing function for the floating-point DCT4/IDCT4. + * @param[in] S points to an instance of the floating-point DCT4/IDCT4 structure. + * @param[in] pState points to state buffer. + * @param[in,out] pInlineBuffer points to the in-place input and output buffer. + */ + void arm_dct4_f32( + const arm_dct4_instance_f32 * S, + float32_t * pState, + float32_t * pInlineBuffer); + + + /** + * @brief Instance structure for the Q31 DCT4/IDCT4 function. + */ + typedef struct + { + uint16_t N; /**< length of the DCT4. */ + uint16_t Nby2; /**< half of the length of the DCT4. */ + q31_t normalize; /**< normalizing factor. */ + q31_t *pTwiddle; /**< points to the twiddle factor table. */ + q31_t *pCosFactor; /**< points to the cosFactor table. */ + arm_rfft_instance_q31 *pRfft; /**< points to the real FFT instance. */ + arm_cfft_radix4_instance_q31 *pCfft; /**< points to the complex FFT instance. */ + } arm_dct4_instance_q31; + + + /** + * @brief Initialization function for the Q31 DCT4/IDCT4. + * @param[in,out] S points to an instance of Q31 DCT4/IDCT4 structure. + * @param[in] S_RFFT points to an instance of Q31 RFFT/RIFFT structure + * @param[in] S_CFFT points to an instance of Q31 CFFT/CIFFT structure + * @param[in] N length of the DCT4. + * @param[in] Nby2 half of the length of the DCT4. + * @param[in] normalize normalizing factor. + * @return arm_status function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_ARGUMENT_ERROR if N is not a supported transform length. + */ + arm_status arm_dct4_init_q31( + arm_dct4_instance_q31 * S, + arm_rfft_instance_q31 * S_RFFT, + arm_cfft_radix4_instance_q31 * S_CFFT, + uint16_t N, + uint16_t Nby2, + q31_t normalize); + + + /** + * @brief Processing function for the Q31 DCT4/IDCT4. + * @param[in] S points to an instance of the Q31 DCT4 structure. + * @param[in] pState points to state buffer. + * @param[in,out] pInlineBuffer points to the in-place input and output buffer. + */ + void arm_dct4_q31( + const arm_dct4_instance_q31 * S, + q31_t * pState, + q31_t * pInlineBuffer); + + + /** + * @brief Instance structure for the Q15 DCT4/IDCT4 function. + */ + typedef struct + { + uint16_t N; /**< length of the DCT4. */ + uint16_t Nby2; /**< half of the length of the DCT4. */ + q15_t normalize; /**< normalizing factor. */ + q15_t *pTwiddle; /**< points to the twiddle factor table. */ + q15_t *pCosFactor; /**< points to the cosFactor table. */ + arm_rfft_instance_q15 *pRfft; /**< points to the real FFT instance. */ + arm_cfft_radix4_instance_q15 *pCfft; /**< points to the complex FFT instance. */ + } arm_dct4_instance_q15; + + + /** + * @brief Initialization function for the Q15 DCT4/IDCT4. + * @param[in,out] S points to an instance of Q15 DCT4/IDCT4 structure. + * @param[in] S_RFFT points to an instance of Q15 RFFT/RIFFT structure. + * @param[in] S_CFFT points to an instance of Q15 CFFT/CIFFT structure. + * @param[in] N length of the DCT4. + * @param[in] Nby2 half of the length of the DCT4. + * @param[in] normalize normalizing factor. + * @return arm_status function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_ARGUMENT_ERROR if N is not a supported transform length. + */ + arm_status arm_dct4_init_q15( + arm_dct4_instance_q15 * S, + arm_rfft_instance_q15 * S_RFFT, + arm_cfft_radix4_instance_q15 * S_CFFT, + uint16_t N, + uint16_t Nby2, + q15_t normalize); + + + /** + * @brief Processing function for the Q15 DCT4/IDCT4. + * @param[in] S points to an instance of the Q15 DCT4 structure. + * @param[in] pState points to state buffer. + * @param[in,out] pInlineBuffer points to the in-place input and output buffer. + */ + void arm_dct4_q15( + const arm_dct4_instance_q15 * S, + q15_t * pState, + q15_t * pInlineBuffer); + + + /** + * @brief Floating-point vector addition. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_add_f32( + float32_t * pSrcA, + float32_t * pSrcB, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Q7 vector addition. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_add_q7( + q7_t * pSrcA, + q7_t * pSrcB, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Q15 vector addition. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_add_q15( + q15_t * pSrcA, + q15_t * pSrcB, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Q31 vector addition. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_add_q31( + q31_t * pSrcA, + q31_t * pSrcB, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Floating-point vector subtraction. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_sub_f32( + float32_t * pSrcA, + float32_t * pSrcB, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Q7 vector subtraction. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_sub_q7( + q7_t * pSrcA, + q7_t * pSrcB, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Q15 vector subtraction. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_sub_q15( + q15_t * pSrcA, + q15_t * pSrcB, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Q31 vector subtraction. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_sub_q31( + q31_t * pSrcA, + q31_t * pSrcB, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Multiplies a floating-point vector by a scalar. + * @param[in] pSrc points to the input vector + * @param[in] scale scale factor to be applied + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_scale_f32( + float32_t * pSrc, + float32_t scale, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Multiplies a Q7 vector by a scalar. + * @param[in] pSrc points to the input vector + * @param[in] scaleFract fractional portion of the scale value + * @param[in] shift number of bits to shift the result by + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_scale_q7( + q7_t * pSrc, + q7_t scaleFract, + int8_t shift, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Multiplies a Q15 vector by a scalar. + * @param[in] pSrc points to the input vector + * @param[in] scaleFract fractional portion of the scale value + * @param[in] shift number of bits to shift the result by + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_scale_q15( + q15_t * pSrc, + q15_t scaleFract, + int8_t shift, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Multiplies a Q31 vector by a scalar. + * @param[in] pSrc points to the input vector + * @param[in] scaleFract fractional portion of the scale value + * @param[in] shift number of bits to shift the result by + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_scale_q31( + q31_t * pSrc, + q31_t scaleFract, + int8_t shift, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Q7 vector absolute value. + * @param[in] pSrc points to the input buffer + * @param[out] pDst points to the output buffer + * @param[in] blockSize number of samples in each vector + */ + void arm_abs_q7( + q7_t * pSrc, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Floating-point vector absolute value. + * @param[in] pSrc points to the input buffer + * @param[out] pDst points to the output buffer + * @param[in] blockSize number of samples in each vector + */ + void arm_abs_f32( + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Q15 vector absolute value. + * @param[in] pSrc points to the input buffer + * @param[out] pDst points to the output buffer + * @param[in] blockSize number of samples in each vector + */ + void arm_abs_q15( + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Q31 vector absolute value. + * @param[in] pSrc points to the input buffer + * @param[out] pDst points to the output buffer + * @param[in] blockSize number of samples in each vector + */ + void arm_abs_q31( + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Dot product of floating-point vectors. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[in] blockSize number of samples in each vector + * @param[out] result output result returned here + */ + void arm_dot_prod_f32( + float32_t * pSrcA, + float32_t * pSrcB, + uint32_t blockSize, + float32_t * result); + + + /** + * @brief Dot product of Q7 vectors. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[in] blockSize number of samples in each vector + * @param[out] result output result returned here + */ + void arm_dot_prod_q7( + q7_t * pSrcA, + q7_t * pSrcB, + uint32_t blockSize, + q31_t * result); + + + /** + * @brief Dot product of Q15 vectors. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[in] blockSize number of samples in each vector + * @param[out] result output result returned here + */ + void arm_dot_prod_q15( + q15_t * pSrcA, + q15_t * pSrcB, + uint32_t blockSize, + q63_t * result); + + + /** + * @brief Dot product of Q31 vectors. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[in] blockSize number of samples in each vector + * @param[out] result output result returned here + */ + void arm_dot_prod_q31( + q31_t * pSrcA, + q31_t * pSrcB, + uint32_t blockSize, + q63_t * result); + + + /** + * @brief Shifts the elements of a Q7 vector a specified number of bits. + * @param[in] pSrc points to the input vector + * @param[in] shiftBits number of bits to shift. A positive value shifts left; a negative value shifts right. + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_shift_q7( + q7_t * pSrc, + int8_t shiftBits, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Shifts the elements of a Q15 vector a specified number of bits. + * @param[in] pSrc points to the input vector + * @param[in] shiftBits number of bits to shift. A positive value shifts left; a negative value shifts right. + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_shift_q15( + q15_t * pSrc, + int8_t shiftBits, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Shifts the elements of a Q31 vector a specified number of bits. + * @param[in] pSrc points to the input vector + * @param[in] shiftBits number of bits to shift. A positive value shifts left; a negative value shifts right. + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_shift_q31( + q31_t * pSrc, + int8_t shiftBits, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Adds a constant offset to a floating-point vector. + * @param[in] pSrc points to the input vector + * @param[in] offset is the offset to be added + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_offset_f32( + float32_t * pSrc, + float32_t offset, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Adds a constant offset to a Q7 vector. + * @param[in] pSrc points to the input vector + * @param[in] offset is the offset to be added + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_offset_q7( + q7_t * pSrc, + q7_t offset, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Adds a constant offset to a Q15 vector. + * @param[in] pSrc points to the input vector + * @param[in] offset is the offset to be added + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_offset_q15( + q15_t * pSrc, + q15_t offset, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Adds a constant offset to a Q31 vector. + * @param[in] pSrc points to the input vector + * @param[in] offset is the offset to be added + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_offset_q31( + q31_t * pSrc, + q31_t offset, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Negates the elements of a floating-point vector. + * @param[in] pSrc points to the input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_negate_f32( + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Negates the elements of a Q7 vector. + * @param[in] pSrc points to the input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_negate_q7( + q7_t * pSrc, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Negates the elements of a Q15 vector. + * @param[in] pSrc points to the input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_negate_q15( + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Negates the elements of a Q31 vector. + * @param[in] pSrc points to the input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_negate_q31( + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Copies the elements of a floating-point vector. + * @param[in] pSrc input pointer + * @param[out] pDst output pointer + * @param[in] blockSize number of samples to process + */ + void arm_copy_f32( + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Copies the elements of a Q7 vector. + * @param[in] pSrc input pointer + * @param[out] pDst output pointer + * @param[in] blockSize number of samples to process + */ + void arm_copy_q7( + q7_t * pSrc, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Copies the elements of a Q15 vector. + * @param[in] pSrc input pointer + * @param[out] pDst output pointer + * @param[in] blockSize number of samples to process + */ + void arm_copy_q15( + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Copies the elements of a Q31 vector. + * @param[in] pSrc input pointer + * @param[out] pDst output pointer + * @param[in] blockSize number of samples to process + */ + void arm_copy_q31( + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Fills a constant value into a floating-point vector. + * @param[in] value input value to be filled + * @param[out] pDst output pointer + * @param[in] blockSize number of samples to process + */ + void arm_fill_f32( + float32_t value, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Fills a constant value into a Q7 vector. + * @param[in] value input value to be filled + * @param[out] pDst output pointer + * @param[in] blockSize number of samples to process + */ + void arm_fill_q7( + q7_t value, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Fills a constant value into a Q15 vector. + * @param[in] value input value to be filled + * @param[out] pDst output pointer + * @param[in] blockSize number of samples to process + */ + void arm_fill_q15( + q15_t value, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Fills a constant value into a Q31 vector. + * @param[in] value input value to be filled + * @param[out] pDst output pointer + * @param[in] blockSize number of samples to process + */ + void arm_fill_q31( + q31_t value, + q31_t * pDst, + uint32_t blockSize); + + +/** + * @brief Convolution of floating-point sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the location where the output result is written. Length srcALen+srcBLen-1. + */ + void arm_conv_f32( + float32_t * pSrcA, + uint32_t srcALen, + float32_t * pSrcB, + uint32_t srcBLen, + float32_t * pDst); + + + /** + * @brief Convolution of Q15 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length srcALen+srcBLen-1. + * @param[in] pScratch1 points to scratch buffer of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. + * @param[in] pScratch2 points to scratch buffer of size min(srcALen, srcBLen). + */ + void arm_conv_opt_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + q15_t * pScratch1, + q15_t * pScratch2); + + +/** + * @brief Convolution of Q15 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the location where the output result is written. Length srcALen+srcBLen-1. + */ + void arm_conv_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst); + + + /** + * @brief Convolution of Q15 sequences (fast version) for Cortex-M3 and Cortex-M4 + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length srcALen+srcBLen-1. + */ + void arm_conv_fast_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst); + + + /** + * @brief Convolution of Q15 sequences (fast version) for Cortex-M3 and Cortex-M4 + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length srcALen+srcBLen-1. + * @param[in] pScratch1 points to scratch buffer of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. + * @param[in] pScratch2 points to scratch buffer of size min(srcALen, srcBLen). + */ + void arm_conv_fast_opt_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + q15_t * pScratch1, + q15_t * pScratch2); + + + /** + * @brief Convolution of Q31 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length srcALen+srcBLen-1. + */ + void arm_conv_q31( + q31_t * pSrcA, + uint32_t srcALen, + q31_t * pSrcB, + uint32_t srcBLen, + q31_t * pDst); + + + /** + * @brief Convolution of Q31 sequences (fast version) for Cortex-M3 and Cortex-M4 + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length srcALen+srcBLen-1. + */ + void arm_conv_fast_q31( + q31_t * pSrcA, + uint32_t srcALen, + q31_t * pSrcB, + uint32_t srcBLen, + q31_t * pDst); + + + /** + * @brief Convolution of Q7 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length srcALen+srcBLen-1. + * @param[in] pScratch1 points to scratch buffer(of type q15_t) of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. + * @param[in] pScratch2 points to scratch buffer (of type q15_t) of size min(srcALen, srcBLen). + */ + void arm_conv_opt_q7( + q7_t * pSrcA, + uint32_t srcALen, + q7_t * pSrcB, + uint32_t srcBLen, + q7_t * pDst, + q15_t * pScratch1, + q15_t * pScratch2); + + + /** + * @brief Convolution of Q7 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length srcALen+srcBLen-1. + */ + void arm_conv_q7( + q7_t * pSrcA, + uint32_t srcALen, + q7_t * pSrcB, + uint32_t srcBLen, + q7_t * pDst); + + + /** + * @brief Partial convolution of floating-point sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data + * @param[in] firstIndex is the first output sample to start with. + * @param[in] numPoints is the number of output points to be computed. + * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. + */ + arm_status arm_conv_partial_f32( + float32_t * pSrcA, + uint32_t srcALen, + float32_t * pSrcB, + uint32_t srcBLen, + float32_t * pDst, + uint32_t firstIndex, + uint32_t numPoints); + + + /** + * @brief Partial convolution of Q15 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data + * @param[in] firstIndex is the first output sample to start with. + * @param[in] numPoints is the number of output points to be computed. + * @param[in] pScratch1 points to scratch buffer of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. + * @param[in] pScratch2 points to scratch buffer of size min(srcALen, srcBLen). + * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. + */ + arm_status arm_conv_partial_opt_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + uint32_t firstIndex, + uint32_t numPoints, + q15_t * pScratch1, + q15_t * pScratch2); + + + /** + * @brief Partial convolution of Q15 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data + * @param[in] firstIndex is the first output sample to start with. + * @param[in] numPoints is the number of output points to be computed. + * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. + */ + arm_status arm_conv_partial_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + uint32_t firstIndex, + uint32_t numPoints); + + + /** + * @brief Partial convolution of Q15 sequences (fast version) for Cortex-M3 and Cortex-M4 + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data + * @param[in] firstIndex is the first output sample to start with. + * @param[in] numPoints is the number of output points to be computed. + * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. + */ + arm_status arm_conv_partial_fast_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + uint32_t firstIndex, + uint32_t numPoints); + + + /** + * @brief Partial convolution of Q15 sequences (fast version) for Cortex-M3 and Cortex-M4 + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data + * @param[in] firstIndex is the first output sample to start with. + * @param[in] numPoints is the number of output points to be computed. + * @param[in] pScratch1 points to scratch buffer of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. + * @param[in] pScratch2 points to scratch buffer of size min(srcALen, srcBLen). + * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. + */ + arm_status arm_conv_partial_fast_opt_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + uint32_t firstIndex, + uint32_t numPoints, + q15_t * pScratch1, + q15_t * pScratch2); + + + /** + * @brief Partial convolution of Q31 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data + * @param[in] firstIndex is the first output sample to start with. + * @param[in] numPoints is the number of output points to be computed. + * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. + */ + arm_status arm_conv_partial_q31( + q31_t * pSrcA, + uint32_t srcALen, + q31_t * pSrcB, + uint32_t srcBLen, + q31_t * pDst, + uint32_t firstIndex, + uint32_t numPoints); + + + /** + * @brief Partial convolution of Q31 sequences (fast version) for Cortex-M3 and Cortex-M4 + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data + * @param[in] firstIndex is the first output sample to start with. + * @param[in] numPoints is the number of output points to be computed. + * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. + */ + arm_status arm_conv_partial_fast_q31( + q31_t * pSrcA, + uint32_t srcALen, + q31_t * pSrcB, + uint32_t srcBLen, + q31_t * pDst, + uint32_t firstIndex, + uint32_t numPoints); + + + /** + * @brief Partial convolution of Q7 sequences + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data + * @param[in] firstIndex is the first output sample to start with. + * @param[in] numPoints is the number of output points to be computed. + * @param[in] pScratch1 points to scratch buffer(of type q15_t) of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. + * @param[in] pScratch2 points to scratch buffer (of type q15_t) of size min(srcALen, srcBLen). + * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. + */ + arm_status arm_conv_partial_opt_q7( + q7_t * pSrcA, + uint32_t srcALen, + q7_t * pSrcB, + uint32_t srcBLen, + q7_t * pDst, + uint32_t firstIndex, + uint32_t numPoints, + q15_t * pScratch1, + q15_t * pScratch2); + + +/** + * @brief Partial convolution of Q7 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data + * @param[in] firstIndex is the first output sample to start with. + * @param[in] numPoints is the number of output points to be computed. + * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. + */ + arm_status arm_conv_partial_q7( + q7_t * pSrcA, + uint32_t srcALen, + q7_t * pSrcB, + uint32_t srcBLen, + q7_t * pDst, + uint32_t firstIndex, + uint32_t numPoints); + + + /** + * @brief Instance structure for the Q15 FIR decimator. + */ + typedef struct + { + uint8_t M; /**< decimation factor. */ + uint16_t numTaps; /**< number of coefficients in the filter. */ + q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + q15_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + } arm_fir_decimate_instance_q15; + + /** + * @brief Instance structure for the Q31 FIR decimator. + */ + typedef struct + { + uint8_t M; /**< decimation factor. */ + uint16_t numTaps; /**< number of coefficients in the filter. */ + q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + q31_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + } arm_fir_decimate_instance_q31; + + /** + * @brief Instance structure for the floating-point FIR decimator. + */ + typedef struct + { + uint8_t M; /**< decimation factor. */ + uint16_t numTaps; /**< number of coefficients in the filter. */ + float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + float32_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + } arm_fir_decimate_instance_f32; + + + /** + * @brief Processing function for the floating-point FIR decimator. + * @param[in] S points to an instance of the floating-point FIR decimator structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_decimate_f32( + const arm_fir_decimate_instance_f32 * S, + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the floating-point FIR decimator. + * @param[in,out] S points to an instance of the floating-point FIR decimator structure. + * @param[in] numTaps number of coefficients in the filter. + * @param[in] M decimation factor. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] blockSize number of input samples to process per call. + * @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if + * blockSize is not a multiple of M. + */ + arm_status arm_fir_decimate_init_f32( + arm_fir_decimate_instance_f32 * S, + uint16_t numTaps, + uint8_t M, + float32_t * pCoeffs, + float32_t * pState, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q15 FIR decimator. + * @param[in] S points to an instance of the Q15 FIR decimator structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_decimate_q15( + const arm_fir_decimate_instance_q15 * S, + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q15 FIR decimator (fast variant) for Cortex-M3 and Cortex-M4. + * @param[in] S points to an instance of the Q15 FIR decimator structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_decimate_fast_q15( + const arm_fir_decimate_instance_q15 * S, + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q15 FIR decimator. + * @param[in,out] S points to an instance of the Q15 FIR decimator structure. + * @param[in] numTaps number of coefficients in the filter. + * @param[in] M decimation factor. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] blockSize number of input samples to process per call. + * @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if + * blockSize is not a multiple of M. + */ + arm_status arm_fir_decimate_init_q15( + arm_fir_decimate_instance_q15 * S, + uint16_t numTaps, + uint8_t M, + q15_t * pCoeffs, + q15_t * pState, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q31 FIR decimator. + * @param[in] S points to an instance of the Q31 FIR decimator structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_decimate_q31( + const arm_fir_decimate_instance_q31 * S, + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + /** + * @brief Processing function for the Q31 FIR decimator (fast variant) for Cortex-M3 and Cortex-M4. + * @param[in] S points to an instance of the Q31 FIR decimator structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_decimate_fast_q31( + arm_fir_decimate_instance_q31 * S, + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q31 FIR decimator. + * @param[in,out] S points to an instance of the Q31 FIR decimator structure. + * @param[in] numTaps number of coefficients in the filter. + * @param[in] M decimation factor. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] blockSize number of input samples to process per call. + * @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if + * blockSize is not a multiple of M. + */ + arm_status arm_fir_decimate_init_q31( + arm_fir_decimate_instance_q31 * S, + uint16_t numTaps, + uint8_t M, + q31_t * pCoeffs, + q31_t * pState, + uint32_t blockSize); + + + /** + * @brief Instance structure for the Q15 FIR interpolator. + */ + typedef struct + { + uint8_t L; /**< upsample factor. */ + uint16_t phaseLength; /**< length of each polyphase filter component. */ + q15_t *pCoeffs; /**< points to the coefficient array. The array is of length L*phaseLength. */ + q15_t *pState; /**< points to the state variable array. The array is of length blockSize+phaseLength-1. */ + } arm_fir_interpolate_instance_q15; + + /** + * @brief Instance structure for the Q31 FIR interpolator. + */ + typedef struct + { + uint8_t L; /**< upsample factor. */ + uint16_t phaseLength; /**< length of each polyphase filter component. */ + q31_t *pCoeffs; /**< points to the coefficient array. The array is of length L*phaseLength. */ + q31_t *pState; /**< points to the state variable array. The array is of length blockSize+phaseLength-1. */ + } arm_fir_interpolate_instance_q31; + + /** + * @brief Instance structure for the floating-point FIR interpolator. + */ + typedef struct + { + uint8_t L; /**< upsample factor. */ + uint16_t phaseLength; /**< length of each polyphase filter component. */ + float32_t *pCoeffs; /**< points to the coefficient array. The array is of length L*phaseLength. */ + float32_t *pState; /**< points to the state variable array. The array is of length phaseLength+numTaps-1. */ + } arm_fir_interpolate_instance_f32; + + + /** + * @brief Processing function for the Q15 FIR interpolator. + * @param[in] S points to an instance of the Q15 FIR interpolator structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_interpolate_q15( + const arm_fir_interpolate_instance_q15 * S, + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q15 FIR interpolator. + * @param[in,out] S points to an instance of the Q15 FIR interpolator structure. + * @param[in] L upsample factor. + * @param[in] numTaps number of filter coefficients in the filter. + * @param[in] pCoeffs points to the filter coefficient buffer. + * @param[in] pState points to the state buffer. + * @param[in] blockSize number of input samples to process per call. + * @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if + * the filter length numTaps is not a multiple of the interpolation factor L. + */ + arm_status arm_fir_interpolate_init_q15( + arm_fir_interpolate_instance_q15 * S, + uint8_t L, + uint16_t numTaps, + q15_t * pCoeffs, + q15_t * pState, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q31 FIR interpolator. + * @param[in] S points to an instance of the Q15 FIR interpolator structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_interpolate_q31( + const arm_fir_interpolate_instance_q31 * S, + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q31 FIR interpolator. + * @param[in,out] S points to an instance of the Q31 FIR interpolator structure. + * @param[in] L upsample factor. + * @param[in] numTaps number of filter coefficients in the filter. + * @param[in] pCoeffs points to the filter coefficient buffer. + * @param[in] pState points to the state buffer. + * @param[in] blockSize number of input samples to process per call. + * @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if + * the filter length numTaps is not a multiple of the interpolation factor L. + */ + arm_status arm_fir_interpolate_init_q31( + arm_fir_interpolate_instance_q31 * S, + uint8_t L, + uint16_t numTaps, + q31_t * pCoeffs, + q31_t * pState, + uint32_t blockSize); + + + /** + * @brief Processing function for the floating-point FIR interpolator. + * @param[in] S points to an instance of the floating-point FIR interpolator structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_interpolate_f32( + const arm_fir_interpolate_instance_f32 * S, + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the floating-point FIR interpolator. + * @param[in,out] S points to an instance of the floating-point FIR interpolator structure. + * @param[in] L upsample factor. + * @param[in] numTaps number of filter coefficients in the filter. + * @param[in] pCoeffs points to the filter coefficient buffer. + * @param[in] pState points to the state buffer. + * @param[in] blockSize number of input samples to process per call. + * @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if + * the filter length numTaps is not a multiple of the interpolation factor L. + */ + arm_status arm_fir_interpolate_init_f32( + arm_fir_interpolate_instance_f32 * S, + uint8_t L, + uint16_t numTaps, + float32_t * pCoeffs, + float32_t * pState, + uint32_t blockSize); + + + /** + * @brief Instance structure for the high precision Q31 Biquad cascade filter. + */ + typedef struct + { + uint8_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + q63_t *pState; /**< points to the array of state coefficients. The array is of length 4*numStages. */ + q31_t *pCoeffs; /**< points to the array of coefficients. The array is of length 5*numStages. */ + uint8_t postShift; /**< additional shift, in bits, applied to each output sample. */ + } arm_biquad_cas_df1_32x64_ins_q31; + + + /** + * @param[in] S points to an instance of the high precision Q31 Biquad cascade filter structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] blockSize number of samples to process. + */ + void arm_biquad_cas_df1_32x64_q31( + const arm_biquad_cas_df1_32x64_ins_q31 * S, + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @param[in,out] S points to an instance of the high precision Q31 Biquad cascade filter structure. + * @param[in] numStages number of 2nd order stages in the filter. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] postShift shift to be applied to the output. Varies according to the coefficients format + */ + void arm_biquad_cas_df1_32x64_init_q31( + arm_biquad_cas_df1_32x64_ins_q31 * S, + uint8_t numStages, + q31_t * pCoeffs, + q63_t * pState, + uint8_t postShift); + + + /** + * @brief Instance structure for the floating-point transposed direct form II Biquad cascade filter. + */ + typedef struct + { + uint8_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + float32_t *pState; /**< points to the array of state coefficients. The array is of length 2*numStages. */ + float32_t *pCoeffs; /**< points to the array of coefficients. The array is of length 5*numStages. */ + } arm_biquad_cascade_df2T_instance_f32; + + /** + * @brief Instance structure for the floating-point transposed direct form II Biquad cascade filter. + */ + typedef struct + { + uint8_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + float32_t *pState; /**< points to the array of state coefficients. The array is of length 4*numStages. */ + float32_t *pCoeffs; /**< points to the array of coefficients. The array is of length 5*numStages. */ + } arm_biquad_cascade_stereo_df2T_instance_f32; + + /** + * @brief Instance structure for the floating-point transposed direct form II Biquad cascade filter. + */ + typedef struct + { + uint8_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + float64_t *pState; /**< points to the array of state coefficients. The array is of length 2*numStages. */ + float64_t *pCoeffs; /**< points to the array of coefficients. The array is of length 5*numStages. */ + } arm_biquad_cascade_df2T_instance_f64; + + + /** + * @brief Processing function for the floating-point transposed direct form II Biquad cascade filter. + * @param[in] S points to an instance of the filter data structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] blockSize number of samples to process. + */ + void arm_biquad_cascade_df2T_f32( + const arm_biquad_cascade_df2T_instance_f32 * S, + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Processing function for the floating-point transposed direct form II Biquad cascade filter. 2 channels + * @param[in] S points to an instance of the filter data structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] blockSize number of samples to process. + */ + void arm_biquad_cascade_stereo_df2T_f32( + const arm_biquad_cascade_stereo_df2T_instance_f32 * S, + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Processing function for the floating-point transposed direct form II Biquad cascade filter. + * @param[in] S points to an instance of the filter data structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] blockSize number of samples to process. + */ + void arm_biquad_cascade_df2T_f64( + const arm_biquad_cascade_df2T_instance_f64 * S, + float64_t * pSrc, + float64_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the floating-point transposed direct form II Biquad cascade filter. + * @param[in,out] S points to an instance of the filter data structure. + * @param[in] numStages number of 2nd order stages in the filter. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + */ + void arm_biquad_cascade_df2T_init_f32( + arm_biquad_cascade_df2T_instance_f32 * S, + uint8_t numStages, + float32_t * pCoeffs, + float32_t * pState); + + + /** + * @brief Initialization function for the floating-point transposed direct form II Biquad cascade filter. + * @param[in,out] S points to an instance of the filter data structure. + * @param[in] numStages number of 2nd order stages in the filter. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + */ + void arm_biquad_cascade_stereo_df2T_init_f32( + arm_biquad_cascade_stereo_df2T_instance_f32 * S, + uint8_t numStages, + float32_t * pCoeffs, + float32_t * pState); + + + /** + * @brief Initialization function for the floating-point transposed direct form II Biquad cascade filter. + * @param[in,out] S points to an instance of the filter data structure. + * @param[in] numStages number of 2nd order stages in the filter. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + */ + void arm_biquad_cascade_df2T_init_f64( + arm_biquad_cascade_df2T_instance_f64 * S, + uint8_t numStages, + float64_t * pCoeffs, + float64_t * pState); + + + /** + * @brief Instance structure for the Q15 FIR lattice filter. + */ + typedef struct + { + uint16_t numStages; /**< number of filter stages. */ + q15_t *pState; /**< points to the state variable array. The array is of length numStages. */ + q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numStages. */ + } arm_fir_lattice_instance_q15; + + /** + * @brief Instance structure for the Q31 FIR lattice filter. + */ + typedef struct + { + uint16_t numStages; /**< number of filter stages. */ + q31_t *pState; /**< points to the state variable array. The array is of length numStages. */ + q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numStages. */ + } arm_fir_lattice_instance_q31; + + /** + * @brief Instance structure for the floating-point FIR lattice filter. + */ + typedef struct + { + uint16_t numStages; /**< number of filter stages. */ + float32_t *pState; /**< points to the state variable array. The array is of length numStages. */ + float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numStages. */ + } arm_fir_lattice_instance_f32; + + + /** + * @brief Initialization function for the Q15 FIR lattice filter. + * @param[in] S points to an instance of the Q15 FIR lattice structure. + * @param[in] numStages number of filter stages. + * @param[in] pCoeffs points to the coefficient buffer. The array is of length numStages. + * @param[in] pState points to the state buffer. The array is of length numStages. + */ + void arm_fir_lattice_init_q15( + arm_fir_lattice_instance_q15 * S, + uint16_t numStages, + q15_t * pCoeffs, + q15_t * pState); + + + /** + * @brief Processing function for the Q15 FIR lattice filter. + * @param[in] S points to an instance of the Q15 FIR lattice structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_fir_lattice_q15( + const arm_fir_lattice_instance_q15 * S, + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q31 FIR lattice filter. + * @param[in] S points to an instance of the Q31 FIR lattice structure. + * @param[in] numStages number of filter stages. + * @param[in] pCoeffs points to the coefficient buffer. The array is of length numStages. + * @param[in] pState points to the state buffer. The array is of length numStages. + */ + void arm_fir_lattice_init_q31( + arm_fir_lattice_instance_q31 * S, + uint16_t numStages, + q31_t * pCoeffs, + q31_t * pState); + + + /** + * @brief Processing function for the Q31 FIR lattice filter. + * @param[in] S points to an instance of the Q31 FIR lattice structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] blockSize number of samples to process. + */ + void arm_fir_lattice_q31( + const arm_fir_lattice_instance_q31 * S, + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + +/** + * @brief Initialization function for the floating-point FIR lattice filter. + * @param[in] S points to an instance of the floating-point FIR lattice structure. + * @param[in] numStages number of filter stages. + * @param[in] pCoeffs points to the coefficient buffer. The array is of length numStages. + * @param[in] pState points to the state buffer. The array is of length numStages. + */ + void arm_fir_lattice_init_f32( + arm_fir_lattice_instance_f32 * S, + uint16_t numStages, + float32_t * pCoeffs, + float32_t * pState); + + + /** + * @brief Processing function for the floating-point FIR lattice filter. + * @param[in] S points to an instance of the floating-point FIR lattice structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] blockSize number of samples to process. + */ + void arm_fir_lattice_f32( + const arm_fir_lattice_instance_f32 * S, + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Instance structure for the Q15 IIR lattice filter. + */ + typedef struct + { + uint16_t numStages; /**< number of stages in the filter. */ + q15_t *pState; /**< points to the state variable array. The array is of length numStages+blockSize. */ + q15_t *pkCoeffs; /**< points to the reflection coefficient array. The array is of length numStages. */ + q15_t *pvCoeffs; /**< points to the ladder coefficient array. The array is of length numStages+1. */ + } arm_iir_lattice_instance_q15; + + /** + * @brief Instance structure for the Q31 IIR lattice filter. + */ + typedef struct + { + uint16_t numStages; /**< number of stages in the filter. */ + q31_t *pState; /**< points to the state variable array. The array is of length numStages+blockSize. */ + q31_t *pkCoeffs; /**< points to the reflection coefficient array. The array is of length numStages. */ + q31_t *pvCoeffs; /**< points to the ladder coefficient array. The array is of length numStages+1. */ + } arm_iir_lattice_instance_q31; + + /** + * @brief Instance structure for the floating-point IIR lattice filter. + */ + typedef struct + { + uint16_t numStages; /**< number of stages in the filter. */ + float32_t *pState; /**< points to the state variable array. The array is of length numStages+blockSize. */ + float32_t *pkCoeffs; /**< points to the reflection coefficient array. The array is of length numStages. */ + float32_t *pvCoeffs; /**< points to the ladder coefficient array. The array is of length numStages+1. */ + } arm_iir_lattice_instance_f32; + + + /** + * @brief Processing function for the floating-point IIR lattice filter. + * @param[in] S points to an instance of the floating-point IIR lattice structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_iir_lattice_f32( + const arm_iir_lattice_instance_f32 * S, + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the floating-point IIR lattice filter. + * @param[in] S points to an instance of the floating-point IIR lattice structure. + * @param[in] numStages number of stages in the filter. + * @param[in] pkCoeffs points to the reflection coefficient buffer. The array is of length numStages. + * @param[in] pvCoeffs points to the ladder coefficient buffer. The array is of length numStages+1. + * @param[in] pState points to the state buffer. The array is of length numStages+blockSize-1. + * @param[in] blockSize number of samples to process. + */ + void arm_iir_lattice_init_f32( + arm_iir_lattice_instance_f32 * S, + uint16_t numStages, + float32_t * pkCoeffs, + float32_t * pvCoeffs, + float32_t * pState, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q31 IIR lattice filter. + * @param[in] S points to an instance of the Q31 IIR lattice structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_iir_lattice_q31( + const arm_iir_lattice_instance_q31 * S, + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q31 IIR lattice filter. + * @param[in] S points to an instance of the Q31 IIR lattice structure. + * @param[in] numStages number of stages in the filter. + * @param[in] pkCoeffs points to the reflection coefficient buffer. The array is of length numStages. + * @param[in] pvCoeffs points to the ladder coefficient buffer. The array is of length numStages+1. + * @param[in] pState points to the state buffer. The array is of length numStages+blockSize. + * @param[in] blockSize number of samples to process. + */ + void arm_iir_lattice_init_q31( + arm_iir_lattice_instance_q31 * S, + uint16_t numStages, + q31_t * pkCoeffs, + q31_t * pvCoeffs, + q31_t * pState, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q15 IIR lattice filter. + * @param[in] S points to an instance of the Q15 IIR lattice structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_iir_lattice_q15( + const arm_iir_lattice_instance_q15 * S, + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + +/** + * @brief Initialization function for the Q15 IIR lattice filter. + * @param[in] S points to an instance of the fixed-point Q15 IIR lattice structure. + * @param[in] numStages number of stages in the filter. + * @param[in] pkCoeffs points to reflection coefficient buffer. The array is of length numStages. + * @param[in] pvCoeffs points to ladder coefficient buffer. The array is of length numStages+1. + * @param[in] pState points to state buffer. The array is of length numStages+blockSize. + * @param[in] blockSize number of samples to process per call. + */ + void arm_iir_lattice_init_q15( + arm_iir_lattice_instance_q15 * S, + uint16_t numStages, + q15_t * pkCoeffs, + q15_t * pvCoeffs, + q15_t * pState, + uint32_t blockSize); + + + /** + * @brief Instance structure for the floating-point LMS filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + float32_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + float32_t mu; /**< step size that controls filter coefficient updates. */ + } arm_lms_instance_f32; + + + /** + * @brief Processing function for floating-point LMS filter. + * @param[in] S points to an instance of the floating-point LMS filter structure. + * @param[in] pSrc points to the block of input data. + * @param[in] pRef points to the block of reference data. + * @param[out] pOut points to the block of output data. + * @param[out] pErr points to the block of error data. + * @param[in] blockSize number of samples to process. + */ + void arm_lms_f32( + const arm_lms_instance_f32 * S, + float32_t * pSrc, + float32_t * pRef, + float32_t * pOut, + float32_t * pErr, + uint32_t blockSize); + + + /** + * @brief Initialization function for floating-point LMS filter. + * @param[in] S points to an instance of the floating-point LMS filter structure. + * @param[in] numTaps number of filter coefficients. + * @param[in] pCoeffs points to the coefficient buffer. + * @param[in] pState points to state buffer. + * @param[in] mu step size that controls filter coefficient updates. + * @param[in] blockSize number of samples to process. + */ + void arm_lms_init_f32( + arm_lms_instance_f32 * S, + uint16_t numTaps, + float32_t * pCoeffs, + float32_t * pState, + float32_t mu, + uint32_t blockSize); + + + /** + * @brief Instance structure for the Q15 LMS filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + q15_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + q15_t mu; /**< step size that controls filter coefficient updates. */ + uint32_t postShift; /**< bit shift applied to coefficients. */ + } arm_lms_instance_q15; + + + /** + * @brief Initialization function for the Q15 LMS filter. + * @param[in] S points to an instance of the Q15 LMS filter structure. + * @param[in] numTaps number of filter coefficients. + * @param[in] pCoeffs points to the coefficient buffer. + * @param[in] pState points to the state buffer. + * @param[in] mu step size that controls filter coefficient updates. + * @param[in] blockSize number of samples to process. + * @param[in] postShift bit shift applied to coefficients. + */ + void arm_lms_init_q15( + arm_lms_instance_q15 * S, + uint16_t numTaps, + q15_t * pCoeffs, + q15_t * pState, + q15_t mu, + uint32_t blockSize, + uint32_t postShift); + + + /** + * @brief Processing function for Q15 LMS filter. + * @param[in] S points to an instance of the Q15 LMS filter structure. + * @param[in] pSrc points to the block of input data. + * @param[in] pRef points to the block of reference data. + * @param[out] pOut points to the block of output data. + * @param[out] pErr points to the block of error data. + * @param[in] blockSize number of samples to process. + */ + void arm_lms_q15( + const arm_lms_instance_q15 * S, + q15_t * pSrc, + q15_t * pRef, + q15_t * pOut, + q15_t * pErr, + uint32_t blockSize); + + + /** + * @brief Instance structure for the Q31 LMS filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + q31_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + q31_t mu; /**< step size that controls filter coefficient updates. */ + uint32_t postShift; /**< bit shift applied to coefficients. */ + } arm_lms_instance_q31; + + + /** + * @brief Processing function for Q31 LMS filter. + * @param[in] S points to an instance of the Q15 LMS filter structure. + * @param[in] pSrc points to the block of input data. + * @param[in] pRef points to the block of reference data. + * @param[out] pOut points to the block of output data. + * @param[out] pErr points to the block of error data. + * @param[in] blockSize number of samples to process. + */ + void arm_lms_q31( + const arm_lms_instance_q31 * S, + q31_t * pSrc, + q31_t * pRef, + q31_t * pOut, + q31_t * pErr, + uint32_t blockSize); + + + /** + * @brief Initialization function for Q31 LMS filter. + * @param[in] S points to an instance of the Q31 LMS filter structure. + * @param[in] numTaps number of filter coefficients. + * @param[in] pCoeffs points to coefficient buffer. + * @param[in] pState points to state buffer. + * @param[in] mu step size that controls filter coefficient updates. + * @param[in] blockSize number of samples to process. + * @param[in] postShift bit shift applied to coefficients. + */ + void arm_lms_init_q31( + arm_lms_instance_q31 * S, + uint16_t numTaps, + q31_t * pCoeffs, + q31_t * pState, + q31_t mu, + uint32_t blockSize, + uint32_t postShift); + + + /** + * @brief Instance structure for the floating-point normalized LMS filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + float32_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + float32_t mu; /**< step size that control filter coefficient updates. */ + float32_t energy; /**< saves previous frame energy. */ + float32_t x0; /**< saves previous input sample. */ + } arm_lms_norm_instance_f32; + + + /** + * @brief Processing function for floating-point normalized LMS filter. + * @param[in] S points to an instance of the floating-point normalized LMS filter structure. + * @param[in] pSrc points to the block of input data. + * @param[in] pRef points to the block of reference data. + * @param[out] pOut points to the block of output data. + * @param[out] pErr points to the block of error data. + * @param[in] blockSize number of samples to process. + */ + void arm_lms_norm_f32( + arm_lms_norm_instance_f32 * S, + float32_t * pSrc, + float32_t * pRef, + float32_t * pOut, + float32_t * pErr, + uint32_t blockSize); + + + /** + * @brief Initialization function for floating-point normalized LMS filter. + * @param[in] S points to an instance of the floating-point LMS filter structure. + * @param[in] numTaps number of filter coefficients. + * @param[in] pCoeffs points to coefficient buffer. + * @param[in] pState points to state buffer. + * @param[in] mu step size that controls filter coefficient updates. + * @param[in] blockSize number of samples to process. + */ + void arm_lms_norm_init_f32( + arm_lms_norm_instance_f32 * S, + uint16_t numTaps, + float32_t * pCoeffs, + float32_t * pState, + float32_t mu, + uint32_t blockSize); + + + /** + * @brief Instance structure for the Q31 normalized LMS filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + q31_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + q31_t mu; /**< step size that controls filter coefficient updates. */ + uint8_t postShift; /**< bit shift applied to coefficients. */ + q31_t *recipTable; /**< points to the reciprocal initial value table. */ + q31_t energy; /**< saves previous frame energy. */ + q31_t x0; /**< saves previous input sample. */ + } arm_lms_norm_instance_q31; + + + /** + * @brief Processing function for Q31 normalized LMS filter. + * @param[in] S points to an instance of the Q31 normalized LMS filter structure. + * @param[in] pSrc points to the block of input data. + * @param[in] pRef points to the block of reference data. + * @param[out] pOut points to the block of output data. + * @param[out] pErr points to the block of error data. + * @param[in] blockSize number of samples to process. + */ + void arm_lms_norm_q31( + arm_lms_norm_instance_q31 * S, + q31_t * pSrc, + q31_t * pRef, + q31_t * pOut, + q31_t * pErr, + uint32_t blockSize); + + + /** + * @brief Initialization function for Q31 normalized LMS filter. + * @param[in] S points to an instance of the Q31 normalized LMS filter structure. + * @param[in] numTaps number of filter coefficients. + * @param[in] pCoeffs points to coefficient buffer. + * @param[in] pState points to state buffer. + * @param[in] mu step size that controls filter coefficient updates. + * @param[in] blockSize number of samples to process. + * @param[in] postShift bit shift applied to coefficients. + */ + void arm_lms_norm_init_q31( + arm_lms_norm_instance_q31 * S, + uint16_t numTaps, + q31_t * pCoeffs, + q31_t * pState, + q31_t mu, + uint32_t blockSize, + uint8_t postShift); + + + /** + * @brief Instance structure for the Q15 normalized LMS filter. + */ + typedef struct + { + uint16_t numTaps; /**< Number of coefficients in the filter. */ + q15_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + q15_t mu; /**< step size that controls filter coefficient updates. */ + uint8_t postShift; /**< bit shift applied to coefficients. */ + q15_t *recipTable; /**< Points to the reciprocal initial value table. */ + q15_t energy; /**< saves previous frame energy. */ + q15_t x0; /**< saves previous input sample. */ + } arm_lms_norm_instance_q15; + + + /** + * @brief Processing function for Q15 normalized LMS filter. + * @param[in] S points to an instance of the Q15 normalized LMS filter structure. + * @param[in] pSrc points to the block of input data. + * @param[in] pRef points to the block of reference data. + * @param[out] pOut points to the block of output data. + * @param[out] pErr points to the block of error data. + * @param[in] blockSize number of samples to process. + */ + void arm_lms_norm_q15( + arm_lms_norm_instance_q15 * S, + q15_t * pSrc, + q15_t * pRef, + q15_t * pOut, + q15_t * pErr, + uint32_t blockSize); + + + /** + * @brief Initialization function for Q15 normalized LMS filter. + * @param[in] S points to an instance of the Q15 normalized LMS filter structure. + * @param[in] numTaps number of filter coefficients. + * @param[in] pCoeffs points to coefficient buffer. + * @param[in] pState points to state buffer. + * @param[in] mu step size that controls filter coefficient updates. + * @param[in] blockSize number of samples to process. + * @param[in] postShift bit shift applied to coefficients. + */ + void arm_lms_norm_init_q15( + arm_lms_norm_instance_q15 * S, + uint16_t numTaps, + q15_t * pCoeffs, + q15_t * pState, + q15_t mu, + uint32_t blockSize, + uint8_t postShift); + + + /** + * @brief Correlation of floating-point sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. + */ + void arm_correlate_f32( + float32_t * pSrcA, + uint32_t srcALen, + float32_t * pSrcB, + uint32_t srcBLen, + float32_t * pDst); + + + /** + * @brief Correlation of Q15 sequences + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. + * @param[in] pScratch points to scratch buffer of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. + */ + void arm_correlate_opt_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + q15_t * pScratch); + + + /** + * @brief Correlation of Q15 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. + */ + + void arm_correlate_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst); + + + /** + * @brief Correlation of Q15 sequences (fast version) for Cortex-M3 and Cortex-M4. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. + */ + + void arm_correlate_fast_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst); + + + /** + * @brief Correlation of Q15 sequences (fast version) for Cortex-M3 and Cortex-M4. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. + * @param[in] pScratch points to scratch buffer of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. + */ + void arm_correlate_fast_opt_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + q15_t * pScratch); + + + /** + * @brief Correlation of Q31 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. + */ + void arm_correlate_q31( + q31_t * pSrcA, + uint32_t srcALen, + q31_t * pSrcB, + uint32_t srcBLen, + q31_t * pDst); + + + /** + * @brief Correlation of Q31 sequences (fast version) for Cortex-M3 and Cortex-M4 + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. + */ + void arm_correlate_fast_q31( + q31_t * pSrcA, + uint32_t srcALen, + q31_t * pSrcB, + uint32_t srcBLen, + q31_t * pDst); + + + /** + * @brief Correlation of Q7 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. + * @param[in] pScratch1 points to scratch buffer(of type q15_t) of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. + * @param[in] pScratch2 points to scratch buffer (of type q15_t) of size min(srcALen, srcBLen). + */ + void arm_correlate_opt_q7( + q7_t * pSrcA, + uint32_t srcALen, + q7_t * pSrcB, + uint32_t srcBLen, + q7_t * pDst, + q15_t * pScratch1, + q15_t * pScratch2); + + + /** + * @brief Correlation of Q7 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. + */ + void arm_correlate_q7( + q7_t * pSrcA, + uint32_t srcALen, + q7_t * pSrcB, + uint32_t srcBLen, + q7_t * pDst); + + + /** + * @brief Instance structure for the floating-point sparse FIR filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + uint16_t stateIndex; /**< state buffer index. Points to the oldest sample in the state buffer. */ + float32_t *pState; /**< points to the state buffer array. The array is of length maxDelay+blockSize-1. */ + float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + uint16_t maxDelay; /**< maximum offset specified by the pTapDelay array. */ + int32_t *pTapDelay; /**< points to the array of delay values. The array is of length numTaps. */ + } arm_fir_sparse_instance_f32; + + /** + * @brief Instance structure for the Q31 sparse FIR filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + uint16_t stateIndex; /**< state buffer index. Points to the oldest sample in the state buffer. */ + q31_t *pState; /**< points to the state buffer array. The array is of length maxDelay+blockSize-1. */ + q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + uint16_t maxDelay; /**< maximum offset specified by the pTapDelay array. */ + int32_t *pTapDelay; /**< points to the array of delay values. The array is of length numTaps. */ + } arm_fir_sparse_instance_q31; + + /** + * @brief Instance structure for the Q15 sparse FIR filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + uint16_t stateIndex; /**< state buffer index. Points to the oldest sample in the state buffer. */ + q15_t *pState; /**< points to the state buffer array. The array is of length maxDelay+blockSize-1. */ + q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + uint16_t maxDelay; /**< maximum offset specified by the pTapDelay array. */ + int32_t *pTapDelay; /**< points to the array of delay values. The array is of length numTaps. */ + } arm_fir_sparse_instance_q15; + + /** + * @brief Instance structure for the Q7 sparse FIR filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + uint16_t stateIndex; /**< state buffer index. Points to the oldest sample in the state buffer. */ + q7_t *pState; /**< points to the state buffer array. The array is of length maxDelay+blockSize-1. */ + q7_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + uint16_t maxDelay; /**< maximum offset specified by the pTapDelay array. */ + int32_t *pTapDelay; /**< points to the array of delay values. The array is of length numTaps. */ + } arm_fir_sparse_instance_q7; + + + /** + * @brief Processing function for the floating-point sparse FIR filter. + * @param[in] S points to an instance of the floating-point sparse FIR structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] pScratchIn points to a temporary buffer of size blockSize. + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_sparse_f32( + arm_fir_sparse_instance_f32 * S, + float32_t * pSrc, + float32_t * pDst, + float32_t * pScratchIn, + uint32_t blockSize); + + + /** + * @brief Initialization function for the floating-point sparse FIR filter. + * @param[in,out] S points to an instance of the floating-point sparse FIR structure. + * @param[in] numTaps number of nonzero coefficients in the filter. + * @param[in] pCoeffs points to the array of filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] pTapDelay points to the array of offset times. + * @param[in] maxDelay maximum offset time supported. + * @param[in] blockSize number of samples that will be processed per block. + */ + void arm_fir_sparse_init_f32( + arm_fir_sparse_instance_f32 * S, + uint16_t numTaps, + float32_t * pCoeffs, + float32_t * pState, + int32_t * pTapDelay, + uint16_t maxDelay, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q31 sparse FIR filter. + * @param[in] S points to an instance of the Q31 sparse FIR structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] pScratchIn points to a temporary buffer of size blockSize. + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_sparse_q31( + arm_fir_sparse_instance_q31 * S, + q31_t * pSrc, + q31_t * pDst, + q31_t * pScratchIn, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q31 sparse FIR filter. + * @param[in,out] S points to an instance of the Q31 sparse FIR structure. + * @param[in] numTaps number of nonzero coefficients in the filter. + * @param[in] pCoeffs points to the array of filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] pTapDelay points to the array of offset times. + * @param[in] maxDelay maximum offset time supported. + * @param[in] blockSize number of samples that will be processed per block. + */ + void arm_fir_sparse_init_q31( + arm_fir_sparse_instance_q31 * S, + uint16_t numTaps, + q31_t * pCoeffs, + q31_t * pState, + int32_t * pTapDelay, + uint16_t maxDelay, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q15 sparse FIR filter. + * @param[in] S points to an instance of the Q15 sparse FIR structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] pScratchIn points to a temporary buffer of size blockSize. + * @param[in] pScratchOut points to a temporary buffer of size blockSize. + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_sparse_q15( + arm_fir_sparse_instance_q15 * S, + q15_t * pSrc, + q15_t * pDst, + q15_t * pScratchIn, + q31_t * pScratchOut, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q15 sparse FIR filter. + * @param[in,out] S points to an instance of the Q15 sparse FIR structure. + * @param[in] numTaps number of nonzero coefficients in the filter. + * @param[in] pCoeffs points to the array of filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] pTapDelay points to the array of offset times. + * @param[in] maxDelay maximum offset time supported. + * @param[in] blockSize number of samples that will be processed per block. + */ + void arm_fir_sparse_init_q15( + arm_fir_sparse_instance_q15 * S, + uint16_t numTaps, + q15_t * pCoeffs, + q15_t * pState, + int32_t * pTapDelay, + uint16_t maxDelay, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q7 sparse FIR filter. + * @param[in] S points to an instance of the Q7 sparse FIR structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] pScratchIn points to a temporary buffer of size blockSize. + * @param[in] pScratchOut points to a temporary buffer of size blockSize. + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_sparse_q7( + arm_fir_sparse_instance_q7 * S, + q7_t * pSrc, + q7_t * pDst, + q7_t * pScratchIn, + q31_t * pScratchOut, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q7 sparse FIR filter. + * @param[in,out] S points to an instance of the Q7 sparse FIR structure. + * @param[in] numTaps number of nonzero coefficients in the filter. + * @param[in] pCoeffs points to the array of filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] pTapDelay points to the array of offset times. + * @param[in] maxDelay maximum offset time supported. + * @param[in] blockSize number of samples that will be processed per block. + */ + void arm_fir_sparse_init_q7( + arm_fir_sparse_instance_q7 * S, + uint16_t numTaps, + q7_t * pCoeffs, + q7_t * pState, + int32_t * pTapDelay, + uint16_t maxDelay, + uint32_t blockSize); + + + /** + * @brief Floating-point sin_cos function. + * @param[in] theta input value in degrees + * @param[out] pSinVal points to the processed sine output. + * @param[out] pCosVal points to the processed cos output. + */ + void arm_sin_cos_f32( + float32_t theta, + float32_t * pSinVal, + float32_t * pCosVal); + + + /** + * @brief Q31 sin_cos function. + * @param[in] theta scaled input value in degrees + * @param[out] pSinVal points to the processed sine output. + * @param[out] pCosVal points to the processed cosine output. + */ + void arm_sin_cos_q31( + q31_t theta, + q31_t * pSinVal, + q31_t * pCosVal); + + + /** + * @brief Floating-point complex conjugate. + * @param[in] pSrc points to the input vector + * @param[out] pDst points to the output vector + * @param[in] numSamples number of complex samples in each vector + */ + void arm_cmplx_conj_f32( + float32_t * pSrc, + float32_t * pDst, + uint32_t numSamples); + + /** + * @brief Q31 complex conjugate. + * @param[in] pSrc points to the input vector + * @param[out] pDst points to the output vector + * @param[in] numSamples number of complex samples in each vector + */ + void arm_cmplx_conj_q31( + q31_t * pSrc, + q31_t * pDst, + uint32_t numSamples); + + + /** + * @brief Q15 complex conjugate. + * @param[in] pSrc points to the input vector + * @param[out] pDst points to the output vector + * @param[in] numSamples number of complex samples in each vector + */ + void arm_cmplx_conj_q15( + q15_t * pSrc, + q15_t * pDst, + uint32_t numSamples); + + + /** + * @brief Floating-point complex magnitude squared + * @param[in] pSrc points to the complex input vector + * @param[out] pDst points to the real output vector + * @param[in] numSamples number of complex samples in the input vector + */ + void arm_cmplx_mag_squared_f32( + float32_t * pSrc, + float32_t * pDst, + uint32_t numSamples); + + + /** + * @brief Q31 complex magnitude squared + * @param[in] pSrc points to the complex input vector + * @param[out] pDst points to the real output vector + * @param[in] numSamples number of complex samples in the input vector + */ + void arm_cmplx_mag_squared_q31( + q31_t * pSrc, + q31_t * pDst, + uint32_t numSamples); + + + /** + * @brief Q15 complex magnitude squared + * @param[in] pSrc points to the complex input vector + * @param[out] pDst points to the real output vector + * @param[in] numSamples number of complex samples in the input vector + */ + void arm_cmplx_mag_squared_q15( + q15_t * pSrc, + q15_t * pDst, + uint32_t numSamples); + + + /** + * @ingroup groupController + */ + + /** + * @defgroup PID PID Motor Control + * + * A Proportional Integral Derivative (PID) controller is a generic feedback control + * loop mechanism widely used in industrial control systems. + * A PID controller is the most commonly used type of feedback controller. + * + * This set of functions implements (PID) controllers + * for Q15, Q31, and floating-point data types. The functions operate on a single sample + * of data and each call to the function returns a single processed value. + * S points to an instance of the PID control data structure. in + * is the input sample value. The functions return the output value. + * + * \par Algorithm: + *
+   *    y[n] = y[n-1] + A0 * x[n] + A1 * x[n-1] + A2 * x[n-2]
+   *    A0 = Kp + Ki + Kd
+   *    A1 = (-Kp ) - (2 * Kd )
+   *    A2 = Kd  
+ * + * \par + * where \c Kp is proportional constant, \c Ki is Integral constant and \c Kd is Derivative constant + * + * \par + * \image html PID.gif "Proportional Integral Derivative Controller" + * + * \par + * The PID controller calculates an "error" value as the difference between + * the measured output and the reference input. + * The controller attempts to minimize the error by adjusting the process control inputs. + * The proportional value determines the reaction to the current error, + * the integral value determines the reaction based on the sum of recent errors, + * and the derivative value determines the reaction based on the rate at which the error has been changing. + * + * \par Instance Structure + * The Gains A0, A1, A2 and state variables for a PID controller are stored together in an instance data structure. + * A separate instance structure must be defined for each PID Controller. + * There are separate instance structure declarations for each of the 3 supported data types. + * + * \par Reset Functions + * There is also an associated reset function for each data type which clears the state array. + * + * \par Initialization Functions + * There is also an associated initialization function for each data type. + * The initialization function performs the following operations: + * - Initializes the Gains A0, A1, A2 from Kp,Ki, Kd gains. + * - Zeros out the values in the state buffer. + * + * \par + * Instance structure cannot be placed into a const data section and it is recommended to use the initialization function. + * + * \par Fixed-Point Behavior + * Care must be taken when using the fixed-point versions of the PID Controller functions. + * In particular, the overflow and saturation behavior of the accumulator used in each function must be considered. + * Refer to the function specific documentation below for usage guidelines. + */ + + /** + * @addtogroup PID + * @{ + */ + + /** + * @brief Process function for the floating-point PID Control. + * @param[in,out] S is an instance of the floating-point PID Control structure + * @param[in] in input sample to process + * @return out processed output sample. + */ + static __INLINE float32_t arm_pid_f32( + arm_pid_instance_f32 * S, + float32_t in) + { + float32_t out; + + /* y[n] = y[n-1] + A0 * x[n] + A1 * x[n-1] + A2 * x[n-2] */ + out = (S->A0 * in) + + (S->A1 * S->state[0]) + (S->A2 * S->state[1]) + (S->state[2]); + + /* Update state */ + S->state[1] = S->state[0]; + S->state[0] = in; + S->state[2] = out; + + /* return to application */ + return (out); + + } + + /** + * @brief Process function for the Q31 PID Control. + * @param[in,out] S points to an instance of the Q31 PID Control structure + * @param[in] in input sample to process + * @return out processed output sample. + * + * Scaling and Overflow Behavior: + * \par + * The function is implemented using an internal 64-bit accumulator. + * The accumulator has a 2.62 format and maintains full precision of the intermediate multiplication results but provides only a single guard bit. + * Thus, if the accumulator result overflows it wraps around rather than clip. + * In order to avoid overflows completely the input signal must be scaled down by 2 bits as there are four additions. + * After all multiply-accumulates are performed, the 2.62 accumulator is truncated to 1.32 format and then saturated to 1.31 format. + */ + static __INLINE q31_t arm_pid_q31( + arm_pid_instance_q31 * S, + q31_t in) + { + q63_t acc; + q31_t out; + + /* acc = A0 * x[n] */ + acc = (q63_t) S->A0 * in; + + /* acc += A1 * x[n-1] */ + acc += (q63_t) S->A1 * S->state[0]; + + /* acc += A2 * x[n-2] */ + acc += (q63_t) S->A2 * S->state[1]; + + /* convert output to 1.31 format to add y[n-1] */ + out = (q31_t) (acc >> 31u); + + /* out += y[n-1] */ + out += S->state[2]; + + /* Update state */ + S->state[1] = S->state[0]; + S->state[0] = in; + S->state[2] = out; + + /* return to application */ + return (out); + } + + + /** + * @brief Process function for the Q15 PID Control. + * @param[in,out] S points to an instance of the Q15 PID Control structure + * @param[in] in input sample to process + * @return out processed output sample. + * + * Scaling and Overflow Behavior: + * \par + * The function is implemented using a 64-bit internal accumulator. + * Both Gains and state variables are represented in 1.15 format and multiplications yield a 2.30 result. + * The 2.30 intermediate results are accumulated in a 64-bit accumulator in 34.30 format. + * There is no risk of internal overflow with this approach and the full precision of intermediate multiplications is preserved. + * After all additions have been performed, the accumulator is truncated to 34.15 format by discarding low 15 bits. + * Lastly, the accumulator is saturated to yield a result in 1.15 format. + */ + static __INLINE q15_t arm_pid_q15( + arm_pid_instance_q15 * S, + q15_t in) + { + q63_t acc; + q15_t out; + +#ifndef ARM_MATH_CM0_FAMILY + __SIMD32_TYPE *vstate; + + /* Implementation of PID controller */ + + /* acc = A0 * x[n] */ + acc = (q31_t) __SMUAD((uint32_t)S->A0, (uint32_t)in); + + /* acc += A1 * x[n-1] + A2 * x[n-2] */ + vstate = __SIMD32_CONST(S->state); + acc = (q63_t)__SMLALD((uint32_t)S->A1, (uint32_t)*vstate, (uint64_t)acc); +#else + /* acc = A0 * x[n] */ + acc = ((q31_t) S->A0) * in; + + /* acc += A1 * x[n-1] + A2 * x[n-2] */ + acc += (q31_t) S->A1 * S->state[0]; + acc += (q31_t) S->A2 * S->state[1]; +#endif + + /* acc += y[n-1] */ + acc += (q31_t) S->state[2] << 15; + + /* saturate the output */ + out = (q15_t) (__SSAT((acc >> 15), 16)); + + /* Update state */ + S->state[1] = S->state[0]; + S->state[0] = in; + S->state[2] = out; + + /* return to application */ + return (out); + } + + /** + * @} end of PID group + */ + + + /** + * @brief Floating-point matrix inverse. + * @param[in] src points to the instance of the input floating-point matrix structure. + * @param[out] dst points to the instance of the output floating-point matrix structure. + * @return The function returns ARM_MATH_SIZE_MISMATCH, if the dimensions do not match. + * If the input matrix is singular (does not have an inverse), then the algorithm terminates and returns error status ARM_MATH_SINGULAR. + */ + arm_status arm_mat_inverse_f32( + const arm_matrix_instance_f32 * src, + arm_matrix_instance_f32 * dst); + + + /** + * @brief Floating-point matrix inverse. + * @param[in] src points to the instance of the input floating-point matrix structure. + * @param[out] dst points to the instance of the output floating-point matrix structure. + * @return The function returns ARM_MATH_SIZE_MISMATCH, if the dimensions do not match. + * If the input matrix is singular (does not have an inverse), then the algorithm terminates and returns error status ARM_MATH_SINGULAR. + */ + arm_status arm_mat_inverse_f64( + const arm_matrix_instance_f64 * src, + arm_matrix_instance_f64 * dst); + + + + /** + * @ingroup groupController + */ + + /** + * @defgroup clarke Vector Clarke Transform + * Forward Clarke transform converts the instantaneous stator phases into a two-coordinate time invariant vector. + * Generally the Clarke transform uses three-phase currents Ia, Ib and Ic to calculate currents + * in the two-phase orthogonal stator axis Ialpha and Ibeta. + * When Ialpha is superposed with Ia as shown in the figure below + * \image html clarke.gif Stator current space vector and its components in (a,b). + * and Ia + Ib + Ic = 0, in this condition Ialpha and Ibeta + * can be calculated using only Ia and Ib. + * + * The function operates on a single sample of data and each call to the function returns the processed output. + * The library provides separate functions for Q31 and floating-point data types. + * \par Algorithm + * \image html clarkeFormula.gif + * where Ia and Ib are the instantaneous stator phases and + * pIalpha and pIbeta are the two coordinates of time invariant vector. + * \par Fixed-Point Behavior + * Care must be taken when using the Q31 version of the Clarke transform. + * In particular, the overflow and saturation behavior of the accumulator used must be considered. + * Refer to the function specific documentation below for usage guidelines. + */ + + /** + * @addtogroup clarke + * @{ + */ + + /** + * + * @brief Floating-point Clarke transform + * @param[in] Ia input three-phase coordinate a + * @param[in] Ib input three-phase coordinate b + * @param[out] pIalpha points to output two-phase orthogonal vector axis alpha + * @param[out] pIbeta points to output two-phase orthogonal vector axis beta + */ + static __INLINE void arm_clarke_f32( + float32_t Ia, + float32_t Ib, + float32_t * pIalpha, + float32_t * pIbeta) + { + /* Calculate pIalpha using the equation, pIalpha = Ia */ + *pIalpha = Ia; + + /* Calculate pIbeta using the equation, pIbeta = (1/sqrt(3)) * Ia + (2/sqrt(3)) * Ib */ + *pIbeta = ((float32_t) 0.57735026919 * Ia + (float32_t) 1.15470053838 * Ib); + } + + + /** + * @brief Clarke transform for Q31 version + * @param[in] Ia input three-phase coordinate a + * @param[in] Ib input three-phase coordinate b + * @param[out] pIalpha points to output two-phase orthogonal vector axis alpha + * @param[out] pIbeta points to output two-phase orthogonal vector axis beta + * + * Scaling and Overflow Behavior: + * \par + * The function is implemented using an internal 32-bit accumulator. + * The accumulator maintains 1.31 format by truncating lower 31 bits of the intermediate multiplication in 2.62 format. + * There is saturation on the addition, hence there is no risk of overflow. + */ + static __INLINE void arm_clarke_q31( + q31_t Ia, + q31_t Ib, + q31_t * pIalpha, + q31_t * pIbeta) + { + q31_t product1, product2; /* Temporary variables used to store intermediate results */ + + /* Calculating pIalpha from Ia by equation pIalpha = Ia */ + *pIalpha = Ia; + + /* Intermediate product is calculated by (1/(sqrt(3)) * Ia) */ + product1 = (q31_t) (((q63_t) Ia * 0x24F34E8B) >> 30); + + /* Intermediate product is calculated by (2/sqrt(3) * Ib) */ + product2 = (q31_t) (((q63_t) Ib * 0x49E69D16) >> 30); + + /* pIbeta is calculated by adding the intermediate products */ + *pIbeta = __QADD(product1, product2); + } + + /** + * @} end of clarke group + */ + + /** + * @brief Converts the elements of the Q7 vector to Q31 vector. + * @param[in] pSrc input pointer + * @param[out] pDst output pointer + * @param[in] blockSize number of samples to process + */ + void arm_q7_to_q31( + q7_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + + /** + * @ingroup groupController + */ + + /** + * @defgroup inv_clarke Vector Inverse Clarke Transform + * Inverse Clarke transform converts the two-coordinate time invariant vector into instantaneous stator phases. + * + * The function operates on a single sample of data and each call to the function returns the processed output. + * The library provides separate functions for Q31 and floating-point data types. + * \par Algorithm + * \image html clarkeInvFormula.gif + * where pIa and pIb are the instantaneous stator phases and + * Ialpha and Ibeta are the two coordinates of time invariant vector. + * \par Fixed-Point Behavior + * Care must be taken when using the Q31 version of the Clarke transform. + * In particular, the overflow and saturation behavior of the accumulator used must be considered. + * Refer to the function specific documentation below for usage guidelines. + */ + + /** + * @addtogroup inv_clarke + * @{ + */ + + /** + * @brief Floating-point Inverse Clarke transform + * @param[in] Ialpha input two-phase orthogonal vector axis alpha + * @param[in] Ibeta input two-phase orthogonal vector axis beta + * @param[out] pIa points to output three-phase coordinate a + * @param[out] pIb points to output three-phase coordinate b + */ + static __INLINE void arm_inv_clarke_f32( + float32_t Ialpha, + float32_t Ibeta, + float32_t * pIa, + float32_t * pIb) + { + /* Calculating pIa from Ialpha by equation pIa = Ialpha */ + *pIa = Ialpha; + + /* Calculating pIb from Ialpha and Ibeta by equation pIb = -(1/2) * Ialpha + (sqrt(3)/2) * Ibeta */ + *pIb = -0.5f * Ialpha + 0.8660254039f * Ibeta; + } + + + /** + * @brief Inverse Clarke transform for Q31 version + * @param[in] Ialpha input two-phase orthogonal vector axis alpha + * @param[in] Ibeta input two-phase orthogonal vector axis beta + * @param[out] pIa points to output three-phase coordinate a + * @param[out] pIb points to output three-phase coordinate b + * + * Scaling and Overflow Behavior: + * \par + * The function is implemented using an internal 32-bit accumulator. + * The accumulator maintains 1.31 format by truncating lower 31 bits of the intermediate multiplication in 2.62 format. + * There is saturation on the subtraction, hence there is no risk of overflow. + */ + static __INLINE void arm_inv_clarke_q31( + q31_t Ialpha, + q31_t Ibeta, + q31_t * pIa, + q31_t * pIb) + { + q31_t product1, product2; /* Temporary variables used to store intermediate results */ + + /* Calculating pIa from Ialpha by equation pIa = Ialpha */ + *pIa = Ialpha; + + /* Intermediate product is calculated by (1/(2*sqrt(3)) * Ia) */ + product1 = (q31_t) (((q63_t) (Ialpha) * (0x40000000)) >> 31); + + /* Intermediate product is calculated by (1/sqrt(3) * pIb) */ + product2 = (q31_t) (((q63_t) (Ibeta) * (0x6ED9EBA1)) >> 31); + + /* pIb is calculated by subtracting the products */ + *pIb = __QSUB(product2, product1); + } + + /** + * @} end of inv_clarke group + */ + + /** + * @brief Converts the elements of the Q7 vector to Q15 vector. + * @param[in] pSrc input pointer + * @param[out] pDst output pointer + * @param[in] blockSize number of samples to process + */ + void arm_q7_to_q15( + q7_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + + /** + * @ingroup groupController + */ + + /** + * @defgroup park Vector Park Transform + * + * Forward Park transform converts the input two-coordinate vector to flux and torque components. + * The Park transform can be used to realize the transformation of the Ialpha and the Ibeta currents + * from the stationary to the moving reference frame and control the spatial relationship between + * the stator vector current and rotor flux vector. + * If we consider the d axis aligned with the rotor flux, the diagram below shows the + * current vector and the relationship from the two reference frames: + * \image html park.gif "Stator current space vector and its component in (a,b) and in the d,q rotating reference frame" + * + * The function operates on a single sample of data and each call to the function returns the processed output. + * The library provides separate functions for Q31 and floating-point data types. + * \par Algorithm + * \image html parkFormula.gif + * where Ialpha and Ibeta are the stator vector components, + * pId and pIq are rotor vector components and cosVal and sinVal are the + * cosine and sine values of theta (rotor flux position). + * \par Fixed-Point Behavior + * Care must be taken when using the Q31 version of the Park transform. + * In particular, the overflow and saturation behavior of the accumulator used must be considered. + * Refer to the function specific documentation below for usage guidelines. + */ + + /** + * @addtogroup park + * @{ + */ + + /** + * @brief Floating-point Park transform + * @param[in] Ialpha input two-phase vector coordinate alpha + * @param[in] Ibeta input two-phase vector coordinate beta + * @param[out] pId points to output rotor reference frame d + * @param[out] pIq points to output rotor reference frame q + * @param[in] sinVal sine value of rotation angle theta + * @param[in] cosVal cosine value of rotation angle theta + * + * The function implements the forward Park transform. + * + */ + static __INLINE void arm_park_f32( + float32_t Ialpha, + float32_t Ibeta, + float32_t * pId, + float32_t * pIq, + float32_t sinVal, + float32_t cosVal) + { + /* Calculate pId using the equation, pId = Ialpha * cosVal + Ibeta * sinVal */ + *pId = Ialpha * cosVal + Ibeta * sinVal; + + /* Calculate pIq using the equation, pIq = - Ialpha * sinVal + Ibeta * cosVal */ + *pIq = -Ialpha * sinVal + Ibeta * cosVal; + } + + + /** + * @brief Park transform for Q31 version + * @param[in] Ialpha input two-phase vector coordinate alpha + * @param[in] Ibeta input two-phase vector coordinate beta + * @param[out] pId points to output rotor reference frame d + * @param[out] pIq points to output rotor reference frame q + * @param[in] sinVal sine value of rotation angle theta + * @param[in] cosVal cosine value of rotation angle theta + * + * Scaling and Overflow Behavior: + * \par + * The function is implemented using an internal 32-bit accumulator. + * The accumulator maintains 1.31 format by truncating lower 31 bits of the intermediate multiplication in 2.62 format. + * There is saturation on the addition and subtraction, hence there is no risk of overflow. + */ + static __INLINE void arm_park_q31( + q31_t Ialpha, + q31_t Ibeta, + q31_t * pId, + q31_t * pIq, + q31_t sinVal, + q31_t cosVal) + { + q31_t product1, product2; /* Temporary variables used to store intermediate results */ + q31_t product3, product4; /* Temporary variables used to store intermediate results */ + + /* Intermediate product is calculated by (Ialpha * cosVal) */ + product1 = (q31_t) (((q63_t) (Ialpha) * (cosVal)) >> 31); + + /* Intermediate product is calculated by (Ibeta * sinVal) */ + product2 = (q31_t) (((q63_t) (Ibeta) * (sinVal)) >> 31); + + + /* Intermediate product is calculated by (Ialpha * sinVal) */ + product3 = (q31_t) (((q63_t) (Ialpha) * (sinVal)) >> 31); + + /* Intermediate product is calculated by (Ibeta * cosVal) */ + product4 = (q31_t) (((q63_t) (Ibeta) * (cosVal)) >> 31); + + /* Calculate pId by adding the two intermediate products 1 and 2 */ + *pId = __QADD(product1, product2); + + /* Calculate pIq by subtracting the two intermediate products 3 from 4 */ + *pIq = __QSUB(product4, product3); + } + + /** + * @} end of park group + */ + + /** + * @brief Converts the elements of the Q7 vector to floating-point vector. + * @param[in] pSrc is input pointer + * @param[out] pDst is output pointer + * @param[in] blockSize is the number of samples to process + */ + void arm_q7_to_float( + q7_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @ingroup groupController + */ + + /** + * @defgroup inv_park Vector Inverse Park transform + * Inverse Park transform converts the input flux and torque components to two-coordinate vector. + * + * The function operates on a single sample of data and each call to the function returns the processed output. + * The library provides separate functions for Q31 and floating-point data types. + * \par Algorithm + * \image html parkInvFormula.gif + * where pIalpha and pIbeta are the stator vector components, + * Id and Iq are rotor vector components and cosVal and sinVal are the + * cosine and sine values of theta (rotor flux position). + * \par Fixed-Point Behavior + * Care must be taken when using the Q31 version of the Park transform. + * In particular, the overflow and saturation behavior of the accumulator used must be considered. + * Refer to the function specific documentation below for usage guidelines. + */ + + /** + * @addtogroup inv_park + * @{ + */ + + /** + * @brief Floating-point Inverse Park transform + * @param[in] Id input coordinate of rotor reference frame d + * @param[in] Iq input coordinate of rotor reference frame q + * @param[out] pIalpha points to output two-phase orthogonal vector axis alpha + * @param[out] pIbeta points to output two-phase orthogonal vector axis beta + * @param[in] sinVal sine value of rotation angle theta + * @param[in] cosVal cosine value of rotation angle theta + */ + static __INLINE void arm_inv_park_f32( + float32_t Id, + float32_t Iq, + float32_t * pIalpha, + float32_t * pIbeta, + float32_t sinVal, + float32_t cosVal) + { + /* Calculate pIalpha using the equation, pIalpha = Id * cosVal - Iq * sinVal */ + *pIalpha = Id * cosVal - Iq * sinVal; + + /* Calculate pIbeta using the equation, pIbeta = Id * sinVal + Iq * cosVal */ + *pIbeta = Id * sinVal + Iq * cosVal; + } + + + /** + * @brief Inverse Park transform for Q31 version + * @param[in] Id input coordinate of rotor reference frame d + * @param[in] Iq input coordinate of rotor reference frame q + * @param[out] pIalpha points to output two-phase orthogonal vector axis alpha + * @param[out] pIbeta points to output two-phase orthogonal vector axis beta + * @param[in] sinVal sine value of rotation angle theta + * @param[in] cosVal cosine value of rotation angle theta + * + * Scaling and Overflow Behavior: + * \par + * The function is implemented using an internal 32-bit accumulator. + * The accumulator maintains 1.31 format by truncating lower 31 bits of the intermediate multiplication in 2.62 format. + * There is saturation on the addition, hence there is no risk of overflow. + */ + static __INLINE void arm_inv_park_q31( + q31_t Id, + q31_t Iq, + q31_t * pIalpha, + q31_t * pIbeta, + q31_t sinVal, + q31_t cosVal) + { + q31_t product1, product2; /* Temporary variables used to store intermediate results */ + q31_t product3, product4; /* Temporary variables used to store intermediate results */ + + /* Intermediate product is calculated by (Id * cosVal) */ + product1 = (q31_t) (((q63_t) (Id) * (cosVal)) >> 31); + + /* Intermediate product is calculated by (Iq * sinVal) */ + product2 = (q31_t) (((q63_t) (Iq) * (sinVal)) >> 31); + + + /* Intermediate product is calculated by (Id * sinVal) */ + product3 = (q31_t) (((q63_t) (Id) * (sinVal)) >> 31); + + /* Intermediate product is calculated by (Iq * cosVal) */ + product4 = (q31_t) (((q63_t) (Iq) * (cosVal)) >> 31); + + /* Calculate pIalpha by using the two intermediate products 1 and 2 */ + *pIalpha = __QSUB(product1, product2); + + /* Calculate pIbeta by using the two intermediate products 3 and 4 */ + *pIbeta = __QADD(product4, product3); + } + + /** + * @} end of Inverse park group + */ + + + /** + * @brief Converts the elements of the Q31 vector to floating-point vector. + * @param[in] pSrc is input pointer + * @param[out] pDst is output pointer + * @param[in] blockSize is the number of samples to process + */ + void arm_q31_to_float( + q31_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + /** + * @ingroup groupInterpolation + */ + + /** + * @defgroup LinearInterpolate Linear Interpolation + * + * Linear interpolation is a method of curve fitting using linear polynomials. + * Linear interpolation works by effectively drawing a straight line between two neighboring samples and returning the appropriate point along that line + * + * \par + * \image html LinearInterp.gif "Linear interpolation" + * + * \par + * A Linear Interpolate function calculates an output value(y), for the input(x) + * using linear interpolation of the input values x0, x1( nearest input values) and the output values y0 and y1(nearest output values) + * + * \par Algorithm: + *
+   *       y = y0 + (x - x0) * ((y1 - y0)/(x1-x0))
+   *       where x0, x1 are nearest values of input x
+   *             y0, y1 are nearest values to output y
+   * 
+ * + * \par + * This set of functions implements Linear interpolation process + * for Q7, Q15, Q31, and floating-point data types. The functions operate on a single + * sample of data and each call to the function returns a single processed value. + * S points to an instance of the Linear Interpolate function data structure. + * x is the input sample value. The functions returns the output value. + * + * \par + * if x is outside of the table boundary, Linear interpolation returns first value of the table + * if x is below input range and returns last value of table if x is above range. + */ + + /** + * @addtogroup LinearInterpolate + * @{ + */ + + /** + * @brief Process function for the floating-point Linear Interpolation Function. + * @param[in,out] S is an instance of the floating-point Linear Interpolation structure + * @param[in] x input sample to process + * @return y processed output sample. + * + */ + static __INLINE float32_t arm_linear_interp_f32( + arm_linear_interp_instance_f32 * S, + float32_t x) + { + float32_t y; + float32_t x0, x1; /* Nearest input values */ + float32_t y0, y1; /* Nearest output values */ + float32_t xSpacing = S->xSpacing; /* spacing between input values */ + int32_t i; /* Index variable */ + float32_t *pYData = S->pYData; /* pointer to output table */ + + /* Calculation of index */ + i = (int32_t) ((x - S->x1) / xSpacing); + + if(i < 0) + { + /* Iniatilize output for below specified range as least output value of table */ + y = pYData[0]; + } + else if((uint32_t)i >= S->nValues) + { + /* Iniatilize output for above specified range as last output value of table */ + y = pYData[S->nValues - 1]; + } + else + { + /* Calculation of nearest input values */ + x0 = S->x1 + i * xSpacing; + x1 = S->x1 + (i + 1) * xSpacing; + + /* Read of nearest output values */ + y0 = pYData[i]; + y1 = pYData[i + 1]; + + /* Calculation of output */ + y = y0 + (x - x0) * ((y1 - y0) / (x1 - x0)); + + } + + /* returns output value */ + return (y); + } + + + /** + * + * @brief Process function for the Q31 Linear Interpolation Function. + * @param[in] pYData pointer to Q31 Linear Interpolation table + * @param[in] x input sample to process + * @param[in] nValues number of table values + * @return y processed output sample. + * + * \par + * Input sample x is in 12.20 format which contains 12 bits for table index and 20 bits for fractional part. + * This function can support maximum of table size 2^12. + * + */ + static __INLINE q31_t arm_linear_interp_q31( + q31_t * pYData, + q31_t x, + uint32_t nValues) + { + q31_t y; /* output */ + q31_t y0, y1; /* Nearest output values */ + q31_t fract; /* fractional part */ + int32_t index; /* Index to read nearest output values */ + + /* Input is in 12.20 format */ + /* 12 bits for the table index */ + /* Index value calculation */ + index = ((x & (q31_t)0xFFF00000) >> 20); + + if(index >= (int32_t)(nValues - 1)) + { + return (pYData[nValues - 1]); + } + else if(index < 0) + { + return (pYData[0]); + } + else + { + /* 20 bits for the fractional part */ + /* shift left by 11 to keep fract in 1.31 format */ + fract = (x & 0x000FFFFF) << 11; + + /* Read two nearest output values from the index in 1.31(q31) format */ + y0 = pYData[index]; + y1 = pYData[index + 1]; + + /* Calculation of y0 * (1-fract) and y is in 2.30 format */ + y = ((q31_t) ((q63_t) y0 * (0x7FFFFFFF - fract) >> 32)); + + /* Calculation of y0 * (1-fract) + y1 *fract and y is in 2.30 format */ + y += ((q31_t) (((q63_t) y1 * fract) >> 32)); + + /* Convert y to 1.31 format */ + return (y << 1u); + } + } + + + /** + * + * @brief Process function for the Q15 Linear Interpolation Function. + * @param[in] pYData pointer to Q15 Linear Interpolation table + * @param[in] x input sample to process + * @param[in] nValues number of table values + * @return y processed output sample. + * + * \par + * Input sample x is in 12.20 format which contains 12 bits for table index and 20 bits for fractional part. + * This function can support maximum of table size 2^12. + * + */ + static __INLINE q15_t arm_linear_interp_q15( + q15_t * pYData, + q31_t x, + uint32_t nValues) + { + q63_t y; /* output */ + q15_t y0, y1; /* Nearest output values */ + q31_t fract; /* fractional part */ + int32_t index; /* Index to read nearest output values */ + + /* Input is in 12.20 format */ + /* 12 bits for the table index */ + /* Index value calculation */ + index = ((x & (int32_t)0xFFF00000) >> 20); + + if(index >= (int32_t)(nValues - 1)) + { + return (pYData[nValues - 1]); + } + else if(index < 0) + { + return (pYData[0]); + } + else + { + /* 20 bits for the fractional part */ + /* fract is in 12.20 format */ + fract = (x & 0x000FFFFF); + + /* Read two nearest output values from the index */ + y0 = pYData[index]; + y1 = pYData[index + 1]; + + /* Calculation of y0 * (1-fract) and y is in 13.35 format */ + y = ((q63_t) y0 * (0xFFFFF - fract)); + + /* Calculation of (y0 * (1-fract) + y1 * fract) and y is in 13.35 format */ + y += ((q63_t) y1 * (fract)); + + /* convert y to 1.15 format */ + return (q15_t) (y >> 20); + } + } + + + /** + * + * @brief Process function for the Q7 Linear Interpolation Function. + * @param[in] pYData pointer to Q7 Linear Interpolation table + * @param[in] x input sample to process + * @param[in] nValues number of table values + * @return y processed output sample. + * + * \par + * Input sample x is in 12.20 format which contains 12 bits for table index and 20 bits for fractional part. + * This function can support maximum of table size 2^12. + */ + static __INLINE q7_t arm_linear_interp_q7( + q7_t * pYData, + q31_t x, + uint32_t nValues) + { + q31_t y; /* output */ + q7_t y0, y1; /* Nearest output values */ + q31_t fract; /* fractional part */ + uint32_t index; /* Index to read nearest output values */ + + /* Input is in 12.20 format */ + /* 12 bits for the table index */ + /* Index value calculation */ + if (x < 0) + { + return (pYData[0]); + } + index = (x >> 20) & 0xfff; + + if(index >= (nValues - 1)) + { + return (pYData[nValues - 1]); + } + else + { + /* 20 bits for the fractional part */ + /* fract is in 12.20 format */ + fract = (x & 0x000FFFFF); + + /* Read two nearest output values from the index and are in 1.7(q7) format */ + y0 = pYData[index]; + y1 = pYData[index + 1]; + + /* Calculation of y0 * (1-fract ) and y is in 13.27(q27) format */ + y = ((y0 * (0xFFFFF - fract))); + + /* Calculation of y1 * fract + y0 * (1-fract) and y is in 13.27(q27) format */ + y += (y1 * fract); + + /* convert y to 1.7(q7) format */ + return (q7_t) (y >> 20); + } + } + + /** + * @} end of LinearInterpolate group + */ + + /** + * @brief Fast approximation to the trigonometric sine function for floating-point data. + * @param[in] x input value in radians. + * @return sin(x). + */ + float32_t arm_sin_f32( + float32_t x); + + + /** + * @brief Fast approximation to the trigonometric sine function for Q31 data. + * @param[in] x Scaled input value in radians. + * @return sin(x). + */ + q31_t arm_sin_q31( + q31_t x); + + + /** + * @brief Fast approximation to the trigonometric sine function for Q15 data. + * @param[in] x Scaled input value in radians. + * @return sin(x). + */ + q15_t arm_sin_q15( + q15_t x); + + + /** + * @brief Fast approximation to the trigonometric cosine function for floating-point data. + * @param[in] x input value in radians. + * @return cos(x). + */ + float32_t arm_cos_f32( + float32_t x); + + + /** + * @brief Fast approximation to the trigonometric cosine function for Q31 data. + * @param[in] x Scaled input value in radians. + * @return cos(x). + */ + q31_t arm_cos_q31( + q31_t x); + + + /** + * @brief Fast approximation to the trigonometric cosine function for Q15 data. + * @param[in] x Scaled input value in radians. + * @return cos(x). + */ + q15_t arm_cos_q15( + q15_t x); + + + /** + * @ingroup groupFastMath + */ + + + /** + * @defgroup SQRT Square Root + * + * Computes the square root of a number. + * There are separate functions for Q15, Q31, and floating-point data types. + * The square root function is computed using the Newton-Raphson algorithm. + * This is an iterative algorithm of the form: + *
+   *      x1 = x0 - f(x0)/f'(x0)
+   * 
+ * where x1 is the current estimate, + * x0 is the previous estimate, and + * f'(x0) is the derivative of f() evaluated at x0. + * For the square root function, the algorithm reduces to: + *
+   *     x0 = in/2                         [initial guess]
+   *     x1 = 1/2 * ( x0 + in / x0)        [each iteration]
+   * 
+ */ + + + /** + * @addtogroup SQRT + * @{ + */ + + /** + * @brief Floating-point square root function. + * @param[in] in input value. + * @param[out] pOut square root of input value. + * @return The function returns ARM_MATH_SUCCESS if input value is positive value or ARM_MATH_ARGUMENT_ERROR if + * in is negative value and returns zero output for negative values. + */ + static __INLINE arm_status arm_sqrt_f32( + float32_t in, + float32_t * pOut) + { + if(in >= 0.0f) + { + +#if (__FPU_USED == 1) && defined ( __CC_ARM ) + *pOut = __sqrtf(in); +#elif (__FPU_USED == 1) && (defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050)) + *pOut = __builtin_sqrtf(in); +#elif (__FPU_USED == 1) && defined(__GNUC__) + *pOut = __builtin_sqrtf(in); +#elif (__FPU_USED == 1) && defined ( __ICCARM__ ) && (__VER__ >= 6040000) + __ASM("VSQRT.F32 %0,%1" : "=t"(*pOut) : "t"(in)); +#else + *pOut = sqrtf(in); +#endif + + return (ARM_MATH_SUCCESS); + } + else + { + *pOut = 0.0f; + return (ARM_MATH_ARGUMENT_ERROR); + } + } + + + /** + * @brief Q31 square root function. + * @param[in] in input value. The range of the input value is [0 +1) or 0x00000000 to 0x7FFFFFFF. + * @param[out] pOut square root of input value. + * @return The function returns ARM_MATH_SUCCESS if input value is positive value or ARM_MATH_ARGUMENT_ERROR if + * in is negative value and returns zero output for negative values. + */ + arm_status arm_sqrt_q31( + q31_t in, + q31_t * pOut); + + + /** + * @brief Q15 square root function. + * @param[in] in input value. The range of the input value is [0 +1) or 0x0000 to 0x7FFF. + * @param[out] pOut square root of input value. + * @return The function returns ARM_MATH_SUCCESS if input value is positive value or ARM_MATH_ARGUMENT_ERROR if + * in is negative value and returns zero output for negative values. + */ + arm_status arm_sqrt_q15( + q15_t in, + q15_t * pOut); + + /** + * @} end of SQRT group + */ + + + /** + * @brief floating-point Circular write function. + */ + static __INLINE void arm_circularWrite_f32( + int32_t * circBuffer, + int32_t L, + uint16_t * writeOffset, + int32_t bufferInc, + const int32_t * src, + int32_t srcInc, + uint32_t blockSize) + { + uint32_t i = 0u; + int32_t wOffset; + + /* Copy the value of Index pointer that points + * to the current location where the input samples to be copied */ + wOffset = *writeOffset; + + /* Loop over the blockSize */ + i = blockSize; + + while(i > 0u) + { + /* copy the input sample to the circular buffer */ + circBuffer[wOffset] = *src; + + /* Update the input pointer */ + src += srcInc; + + /* Circularly update wOffset. Watch out for positive and negative value */ + wOffset += bufferInc; + if(wOffset >= L) + wOffset -= L; + + /* Decrement the loop counter */ + i--; + } + + /* Update the index pointer */ + *writeOffset = (uint16_t)wOffset; + } + + + + /** + * @brief floating-point Circular Read function. + */ + static __INLINE void arm_circularRead_f32( + int32_t * circBuffer, + int32_t L, + int32_t * readOffset, + int32_t bufferInc, + int32_t * dst, + int32_t * dst_base, + int32_t dst_length, + int32_t dstInc, + uint32_t blockSize) + { + uint32_t i = 0u; + int32_t rOffset, dst_end; + + /* Copy the value of Index pointer that points + * to the current location from where the input samples to be read */ + rOffset = *readOffset; + dst_end = (int32_t) (dst_base + dst_length); + + /* Loop over the blockSize */ + i = blockSize; + + while(i > 0u) + { + /* copy the sample from the circular buffer to the destination buffer */ + *dst = circBuffer[rOffset]; + + /* Update the input pointer */ + dst += dstInc; + + if(dst == (int32_t *) dst_end) + { + dst = dst_base; + } + + /* Circularly update rOffset. Watch out for positive and negative value */ + rOffset += bufferInc; + + if(rOffset >= L) + { + rOffset -= L; + } + + /* Decrement the loop counter */ + i--; + } + + /* Update the index pointer */ + *readOffset = rOffset; + } + + + /** + * @brief Q15 Circular write function. + */ + static __INLINE void arm_circularWrite_q15( + q15_t * circBuffer, + int32_t L, + uint16_t * writeOffset, + int32_t bufferInc, + const q15_t * src, + int32_t srcInc, + uint32_t blockSize) + { + uint32_t i = 0u; + int32_t wOffset; + + /* Copy the value of Index pointer that points + * to the current location where the input samples to be copied */ + wOffset = *writeOffset; + + /* Loop over the blockSize */ + i = blockSize; + + while(i > 0u) + { + /* copy the input sample to the circular buffer */ + circBuffer[wOffset] = *src; + + /* Update the input pointer */ + src += srcInc; + + /* Circularly update wOffset. Watch out for positive and negative value */ + wOffset += bufferInc; + if(wOffset >= L) + wOffset -= L; + + /* Decrement the loop counter */ + i--; + } + + /* Update the index pointer */ + *writeOffset = (uint16_t)wOffset; + } + + + /** + * @brief Q15 Circular Read function. + */ + static __INLINE void arm_circularRead_q15( + q15_t * circBuffer, + int32_t L, + int32_t * readOffset, + int32_t bufferInc, + q15_t * dst, + q15_t * dst_base, + int32_t dst_length, + int32_t dstInc, + uint32_t blockSize) + { + uint32_t i = 0; + int32_t rOffset, dst_end; + + /* Copy the value of Index pointer that points + * to the current location from where the input samples to be read */ + rOffset = *readOffset; + + dst_end = (int32_t) (dst_base + dst_length); + + /* Loop over the blockSize */ + i = blockSize; + + while(i > 0u) + { + /* copy the sample from the circular buffer to the destination buffer */ + *dst = circBuffer[rOffset]; + + /* Update the input pointer */ + dst += dstInc; + + if(dst == (q15_t *) dst_end) + { + dst = dst_base; + } + + /* Circularly update wOffset. Watch out for positive and negative value */ + rOffset += bufferInc; + + if(rOffset >= L) + { + rOffset -= L; + } + + /* Decrement the loop counter */ + i--; + } + + /* Update the index pointer */ + *readOffset = rOffset; + } + + + /** + * @brief Q7 Circular write function. + */ + static __INLINE void arm_circularWrite_q7( + q7_t * circBuffer, + int32_t L, + uint16_t * writeOffset, + int32_t bufferInc, + const q7_t * src, + int32_t srcInc, + uint32_t blockSize) + { + uint32_t i = 0u; + int32_t wOffset; + + /* Copy the value of Index pointer that points + * to the current location where the input samples to be copied */ + wOffset = *writeOffset; + + /* Loop over the blockSize */ + i = blockSize; + + while(i > 0u) + { + /* copy the input sample to the circular buffer */ + circBuffer[wOffset] = *src; + + /* Update the input pointer */ + src += srcInc; + + /* Circularly update wOffset. Watch out for positive and negative value */ + wOffset += bufferInc; + if(wOffset >= L) + wOffset -= L; + + /* Decrement the loop counter */ + i--; + } + + /* Update the index pointer */ + *writeOffset = (uint16_t)wOffset; + } + + + /** + * @brief Q7 Circular Read function. + */ + static __INLINE void arm_circularRead_q7( + q7_t * circBuffer, + int32_t L, + int32_t * readOffset, + int32_t bufferInc, + q7_t * dst, + q7_t * dst_base, + int32_t dst_length, + int32_t dstInc, + uint32_t blockSize) + { + uint32_t i = 0; + int32_t rOffset, dst_end; + + /* Copy the value of Index pointer that points + * to the current location from where the input samples to be read */ + rOffset = *readOffset; + + dst_end = (int32_t) (dst_base + dst_length); + + /* Loop over the blockSize */ + i = blockSize; + + while(i > 0u) + { + /* copy the sample from the circular buffer to the destination buffer */ + *dst = circBuffer[rOffset]; + + /* Update the input pointer */ + dst += dstInc; + + if(dst == (q7_t *) dst_end) + { + dst = dst_base; + } + + /* Circularly update rOffset. Watch out for positive and negative value */ + rOffset += bufferInc; + + if(rOffset >= L) + { + rOffset -= L; + } + + /* Decrement the loop counter */ + i--; + } + + /* Update the index pointer */ + *readOffset = rOffset; + } + + + /** + * @brief Sum of the squares of the elements of a Q31 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_power_q31( + q31_t * pSrc, + uint32_t blockSize, + q63_t * pResult); + + + /** + * @brief Sum of the squares of the elements of a floating-point vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_power_f32( + float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult); + + + /** + * @brief Sum of the squares of the elements of a Q15 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_power_q15( + q15_t * pSrc, + uint32_t blockSize, + q63_t * pResult); + + + /** + * @brief Sum of the squares of the elements of a Q7 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_power_q7( + q7_t * pSrc, + uint32_t blockSize, + q31_t * pResult); + + + /** + * @brief Mean value of a Q7 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_mean_q7( + q7_t * pSrc, + uint32_t blockSize, + q7_t * pResult); + + + /** + * @brief Mean value of a Q15 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_mean_q15( + q15_t * pSrc, + uint32_t blockSize, + q15_t * pResult); + + + /** + * @brief Mean value of a Q31 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_mean_q31( + q31_t * pSrc, + uint32_t blockSize, + q31_t * pResult); + + + /** + * @brief Mean value of a floating-point vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_mean_f32( + float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult); + + + /** + * @brief Variance of the elements of a floating-point vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_var_f32( + float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult); + + + /** + * @brief Variance of the elements of a Q31 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_var_q31( + q31_t * pSrc, + uint32_t blockSize, + q31_t * pResult); + + + /** + * @brief Variance of the elements of a Q15 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_var_q15( + q15_t * pSrc, + uint32_t blockSize, + q15_t * pResult); + + + /** + * @brief Root Mean Square of the elements of a floating-point vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_rms_f32( + float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult); + + + /** + * @brief Root Mean Square of the elements of a Q31 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_rms_q31( + q31_t * pSrc, + uint32_t blockSize, + q31_t * pResult); + + + /** + * @brief Root Mean Square of the elements of a Q15 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_rms_q15( + q15_t * pSrc, + uint32_t blockSize, + q15_t * pResult); + + + /** + * @brief Standard deviation of the elements of a floating-point vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_std_f32( + float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult); + + + /** + * @brief Standard deviation of the elements of a Q31 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_std_q31( + q31_t * pSrc, + uint32_t blockSize, + q31_t * pResult); + + + /** + * @brief Standard deviation of the elements of a Q15 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_std_q15( + q15_t * pSrc, + uint32_t blockSize, + q15_t * pResult); + + + /** + * @brief Floating-point complex magnitude + * @param[in] pSrc points to the complex input vector + * @param[out] pDst points to the real output vector + * @param[in] numSamples number of complex samples in the input vector + */ + void arm_cmplx_mag_f32( + float32_t * pSrc, + float32_t * pDst, + uint32_t numSamples); + + + /** + * @brief Q31 complex magnitude + * @param[in] pSrc points to the complex input vector + * @param[out] pDst points to the real output vector + * @param[in] numSamples number of complex samples in the input vector + */ + void arm_cmplx_mag_q31( + q31_t * pSrc, + q31_t * pDst, + uint32_t numSamples); + + + /** + * @brief Q15 complex magnitude + * @param[in] pSrc points to the complex input vector + * @param[out] pDst points to the real output vector + * @param[in] numSamples number of complex samples in the input vector + */ + void arm_cmplx_mag_q15( + q15_t * pSrc, + q15_t * pDst, + uint32_t numSamples); + + + /** + * @brief Q15 complex dot product + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[in] numSamples number of complex samples in each vector + * @param[out] realResult real part of the result returned here + * @param[out] imagResult imaginary part of the result returned here + */ + void arm_cmplx_dot_prod_q15( + q15_t * pSrcA, + q15_t * pSrcB, + uint32_t numSamples, + q31_t * realResult, + q31_t * imagResult); + + + /** + * @brief Q31 complex dot product + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[in] numSamples number of complex samples in each vector + * @param[out] realResult real part of the result returned here + * @param[out] imagResult imaginary part of the result returned here + */ + void arm_cmplx_dot_prod_q31( + q31_t * pSrcA, + q31_t * pSrcB, + uint32_t numSamples, + q63_t * realResult, + q63_t * imagResult); + + + /** + * @brief Floating-point complex dot product + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[in] numSamples number of complex samples in each vector + * @param[out] realResult real part of the result returned here + * @param[out] imagResult imaginary part of the result returned here + */ + void arm_cmplx_dot_prod_f32( + float32_t * pSrcA, + float32_t * pSrcB, + uint32_t numSamples, + float32_t * realResult, + float32_t * imagResult); + + + /** + * @brief Q15 complex-by-real multiplication + * @param[in] pSrcCmplx points to the complex input vector + * @param[in] pSrcReal points to the real input vector + * @param[out] pCmplxDst points to the complex output vector + * @param[in] numSamples number of samples in each vector + */ + void arm_cmplx_mult_real_q15( + q15_t * pSrcCmplx, + q15_t * pSrcReal, + q15_t * pCmplxDst, + uint32_t numSamples); + + + /** + * @brief Q31 complex-by-real multiplication + * @param[in] pSrcCmplx points to the complex input vector + * @param[in] pSrcReal points to the real input vector + * @param[out] pCmplxDst points to the complex output vector + * @param[in] numSamples number of samples in each vector + */ + void arm_cmplx_mult_real_q31( + q31_t * pSrcCmplx, + q31_t * pSrcReal, + q31_t * pCmplxDst, + uint32_t numSamples); + + + /** + * @brief Floating-point complex-by-real multiplication + * @param[in] pSrcCmplx points to the complex input vector + * @param[in] pSrcReal points to the real input vector + * @param[out] pCmplxDst points to the complex output vector + * @param[in] numSamples number of samples in each vector + */ + void arm_cmplx_mult_real_f32( + float32_t * pSrcCmplx, + float32_t * pSrcReal, + float32_t * pCmplxDst, + uint32_t numSamples); + + + /** + * @brief Minimum value of a Q7 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] result is output pointer + * @param[in] index is the array index of the minimum value in the input buffer. + */ + void arm_min_q7( + q7_t * pSrc, + uint32_t blockSize, + q7_t * result, + uint32_t * index); + + + /** + * @brief Minimum value of a Q15 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output pointer + * @param[in] pIndex is the array index of the minimum value in the input buffer. + */ + void arm_min_q15( + q15_t * pSrc, + uint32_t blockSize, + q15_t * pResult, + uint32_t * pIndex); + + + /** + * @brief Minimum value of a Q31 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output pointer + * @param[out] pIndex is the array index of the minimum value in the input buffer. + */ + void arm_min_q31( + q31_t * pSrc, + uint32_t blockSize, + q31_t * pResult, + uint32_t * pIndex); + + + /** + * @brief Minimum value of a floating-point vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output pointer + * @param[out] pIndex is the array index of the minimum value in the input buffer. + */ + void arm_min_f32( + float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult, + uint32_t * pIndex); + + +/** + * @brief Maximum value of a Q7 vector. + * @param[in] pSrc points to the input buffer + * @param[in] blockSize length of the input vector + * @param[out] pResult maximum value returned here + * @param[out] pIndex index of maximum value returned here + */ + void arm_max_q7( + q7_t * pSrc, + uint32_t blockSize, + q7_t * pResult, + uint32_t * pIndex); + + +/** + * @brief Maximum value of a Q15 vector. + * @param[in] pSrc points to the input buffer + * @param[in] blockSize length of the input vector + * @param[out] pResult maximum value returned here + * @param[out] pIndex index of maximum value returned here + */ + void arm_max_q15( + q15_t * pSrc, + uint32_t blockSize, + q15_t * pResult, + uint32_t * pIndex); + + +/** + * @brief Maximum value of a Q31 vector. + * @param[in] pSrc points to the input buffer + * @param[in] blockSize length of the input vector + * @param[out] pResult maximum value returned here + * @param[out] pIndex index of maximum value returned here + */ + void arm_max_q31( + q31_t * pSrc, + uint32_t blockSize, + q31_t * pResult, + uint32_t * pIndex); + + +/** + * @brief Maximum value of a floating-point vector. + * @param[in] pSrc points to the input buffer + * @param[in] blockSize length of the input vector + * @param[out] pResult maximum value returned here + * @param[out] pIndex index of maximum value returned here + */ + void arm_max_f32( + float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult, + uint32_t * pIndex); + + + /** + * @brief Q15 complex-by-complex multiplication + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] numSamples number of complex samples in each vector + */ + void arm_cmplx_mult_cmplx_q15( + q15_t * pSrcA, + q15_t * pSrcB, + q15_t * pDst, + uint32_t numSamples); + + + /** + * @brief Q31 complex-by-complex multiplication + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] numSamples number of complex samples in each vector + */ + void arm_cmplx_mult_cmplx_q31( + q31_t * pSrcA, + q31_t * pSrcB, + q31_t * pDst, + uint32_t numSamples); + + + /** + * @brief Floating-point complex-by-complex multiplication + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] numSamples number of complex samples in each vector + */ + void arm_cmplx_mult_cmplx_f32( + float32_t * pSrcA, + float32_t * pSrcB, + float32_t * pDst, + uint32_t numSamples); + + + /** + * @brief Converts the elements of the floating-point vector to Q31 vector. + * @param[in] pSrc points to the floating-point input vector + * @param[out] pDst points to the Q31 output vector + * @param[in] blockSize length of the input vector + */ + void arm_float_to_q31( + float32_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Converts the elements of the floating-point vector to Q15 vector. + * @param[in] pSrc points to the floating-point input vector + * @param[out] pDst points to the Q15 output vector + * @param[in] blockSize length of the input vector + */ + void arm_float_to_q15( + float32_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Converts the elements of the floating-point vector to Q7 vector. + * @param[in] pSrc points to the floating-point input vector + * @param[out] pDst points to the Q7 output vector + * @param[in] blockSize length of the input vector + */ + void arm_float_to_q7( + float32_t * pSrc, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Converts the elements of the Q31 vector to Q15 vector. + * @param[in] pSrc is input pointer + * @param[out] pDst is output pointer + * @param[in] blockSize is the number of samples to process + */ + void arm_q31_to_q15( + q31_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Converts the elements of the Q31 vector to Q7 vector. + * @param[in] pSrc is input pointer + * @param[out] pDst is output pointer + * @param[in] blockSize is the number of samples to process + */ + void arm_q31_to_q7( + q31_t * pSrc, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Converts the elements of the Q15 vector to floating-point vector. + * @param[in] pSrc is input pointer + * @param[out] pDst is output pointer + * @param[in] blockSize is the number of samples to process + */ + void arm_q15_to_float( + q15_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Converts the elements of the Q15 vector to Q31 vector. + * @param[in] pSrc is input pointer + * @param[out] pDst is output pointer + * @param[in] blockSize is the number of samples to process + */ + void arm_q15_to_q31( + q15_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Converts the elements of the Q15 vector to Q7 vector. + * @param[in] pSrc is input pointer + * @param[out] pDst is output pointer + * @param[in] blockSize is the number of samples to process + */ + void arm_q15_to_q7( + q15_t * pSrc, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @ingroup groupInterpolation + */ + + /** + * @defgroup BilinearInterpolate Bilinear Interpolation + * + * Bilinear interpolation is an extension of linear interpolation applied to a two dimensional grid. + * The underlying function f(x, y) is sampled on a regular grid and the interpolation process + * determines values between the grid points. + * Bilinear interpolation is equivalent to two step linear interpolation, first in the x-dimension and then in the y-dimension. + * Bilinear interpolation is often used in image processing to rescale images. + * The CMSIS DSP library provides bilinear interpolation functions for Q7, Q15, Q31, and floating-point data types. + * + * Algorithm + * \par + * The instance structure used by the bilinear interpolation functions describes a two dimensional data table. + * For floating-point, the instance structure is defined as: + *
+   *   typedef struct
+   *   {
+   *     uint16_t numRows;
+   *     uint16_t numCols;
+   *     float32_t *pData;
+   * } arm_bilinear_interp_instance_f32;
+   * 
+ * + * \par + * where numRows specifies the number of rows in the table; + * numCols specifies the number of columns in the table; + * and pData points to an array of size numRows*numCols values. + * The data table pTable is organized in row order and the supplied data values fall on integer indexes. + * That is, table element (x,y) is located at pTable[x + y*numCols] where x and y are integers. + * + * \par + * Let (x, y) specify the desired interpolation point. Then define: + *
+   *     XF = floor(x)
+   *     YF = floor(y)
+   * 
+ * \par + * The interpolated output point is computed as: + *
+   *  f(x, y) = f(XF, YF) * (1-(x-XF)) * (1-(y-YF))
+   *           + f(XF+1, YF) * (x-XF)*(1-(y-YF))
+   *           + f(XF, YF+1) * (1-(x-XF))*(y-YF)
+   *           + f(XF+1, YF+1) * (x-XF)*(y-YF)
+   * 
+ * Note that the coordinates (x, y) contain integer and fractional components. + * The integer components specify which portion of the table to use while the + * fractional components control the interpolation processor. + * + * \par + * if (x,y) are outside of the table boundary, Bilinear interpolation returns zero output. + */ + + /** + * @addtogroup BilinearInterpolate + * @{ + */ + + + /** + * + * @brief Floating-point bilinear interpolation. + * @param[in,out] S points to an instance of the interpolation structure. + * @param[in] X interpolation coordinate. + * @param[in] Y interpolation coordinate. + * @return out interpolated value. + */ + static __INLINE float32_t arm_bilinear_interp_f32( + const arm_bilinear_interp_instance_f32 * S, + float32_t X, + float32_t Y) + { + float32_t out; + float32_t f00, f01, f10, f11; + float32_t *pData = S->pData; + int32_t xIndex, yIndex, index; + float32_t xdiff, ydiff; + float32_t b1, b2, b3, b4; + + xIndex = (int32_t) X; + yIndex = (int32_t) Y; + + /* Care taken for table outside boundary */ + /* Returns zero output when values are outside table boundary */ + if(xIndex < 0 || xIndex > (S->numRows - 1) || yIndex < 0 || yIndex > (S->numCols - 1)) + { + return (0); + } + + /* Calculation of index for two nearest points in X-direction */ + index = (xIndex - 1) + (yIndex - 1) * S->numCols; + + + /* Read two nearest points in X-direction */ + f00 = pData[index]; + f01 = pData[index + 1]; + + /* Calculation of index for two nearest points in Y-direction */ + index = (xIndex - 1) + (yIndex) * S->numCols; + + + /* Read two nearest points in Y-direction */ + f10 = pData[index]; + f11 = pData[index + 1]; + + /* Calculation of intermediate values */ + b1 = f00; + b2 = f01 - f00; + b3 = f10 - f00; + b4 = f00 - f01 - f10 + f11; + + /* Calculation of fractional part in X */ + xdiff = X - xIndex; + + /* Calculation of fractional part in Y */ + ydiff = Y - yIndex; + + /* Calculation of bi-linear interpolated output */ + out = b1 + b2 * xdiff + b3 * ydiff + b4 * xdiff * ydiff; + + /* return to application */ + return (out); + } + + + /** + * + * @brief Q31 bilinear interpolation. + * @param[in,out] S points to an instance of the interpolation structure. + * @param[in] X interpolation coordinate in 12.20 format. + * @param[in] Y interpolation coordinate in 12.20 format. + * @return out interpolated value. + */ + static __INLINE q31_t arm_bilinear_interp_q31( + arm_bilinear_interp_instance_q31 * S, + q31_t X, + q31_t Y) + { + q31_t out; /* Temporary output */ + q31_t acc = 0; /* output */ + q31_t xfract, yfract; /* X, Y fractional parts */ + q31_t x1, x2, y1, y2; /* Nearest output values */ + int32_t rI, cI; /* Row and column indices */ + q31_t *pYData = S->pData; /* pointer to output table values */ + uint32_t nCols = S->numCols; /* num of rows */ + + /* Input is in 12.20 format */ + /* 12 bits for the table index */ + /* Index value calculation */ + rI = ((X & (q31_t)0xFFF00000) >> 20); + + /* Input is in 12.20 format */ + /* 12 bits for the table index */ + /* Index value calculation */ + cI = ((Y & (q31_t)0xFFF00000) >> 20); + + /* Care taken for table outside boundary */ + /* Returns zero output when values are outside table boundary */ + if(rI < 0 || rI > (S->numRows - 1) || cI < 0 || cI > (S->numCols - 1)) + { + return (0); + } + + /* 20 bits for the fractional part */ + /* shift left xfract by 11 to keep 1.31 format */ + xfract = (X & 0x000FFFFF) << 11u; + + /* Read two nearest output values from the index */ + x1 = pYData[(rI) + (int32_t)nCols * (cI) ]; + x2 = pYData[(rI) + (int32_t)nCols * (cI) + 1]; + + /* 20 bits for the fractional part */ + /* shift left yfract by 11 to keep 1.31 format */ + yfract = (Y & 0x000FFFFF) << 11u; + + /* Read two nearest output values from the index */ + y1 = pYData[(rI) + (int32_t)nCols * (cI + 1) ]; + y2 = pYData[(rI) + (int32_t)nCols * (cI + 1) + 1]; + + /* Calculation of x1 * (1-xfract ) * (1-yfract) and acc is in 3.29(q29) format */ + out = ((q31_t) (((q63_t) x1 * (0x7FFFFFFF - xfract)) >> 32)); + acc = ((q31_t) (((q63_t) out * (0x7FFFFFFF - yfract)) >> 32)); + + /* x2 * (xfract) * (1-yfract) in 3.29(q29) and adding to acc */ + out = ((q31_t) ((q63_t) x2 * (0x7FFFFFFF - yfract) >> 32)); + acc += ((q31_t) ((q63_t) out * (xfract) >> 32)); + + /* y1 * (1 - xfract) * (yfract) in 3.29(q29) and adding to acc */ + out = ((q31_t) ((q63_t) y1 * (0x7FFFFFFF - xfract) >> 32)); + acc += ((q31_t) ((q63_t) out * (yfract) >> 32)); + + /* y2 * (xfract) * (yfract) in 3.29(q29) and adding to acc */ + out = ((q31_t) ((q63_t) y2 * (xfract) >> 32)); + acc += ((q31_t) ((q63_t) out * (yfract) >> 32)); + + /* Convert acc to 1.31(q31) format */ + return ((q31_t)(acc << 2)); + } + + + /** + * @brief Q15 bilinear interpolation. + * @param[in,out] S points to an instance of the interpolation structure. + * @param[in] X interpolation coordinate in 12.20 format. + * @param[in] Y interpolation coordinate in 12.20 format. + * @return out interpolated value. + */ + static __INLINE q15_t arm_bilinear_interp_q15( + arm_bilinear_interp_instance_q15 * S, + q31_t X, + q31_t Y) + { + q63_t acc = 0; /* output */ + q31_t out; /* Temporary output */ + q15_t x1, x2, y1, y2; /* Nearest output values */ + q31_t xfract, yfract; /* X, Y fractional parts */ + int32_t rI, cI; /* Row and column indices */ + q15_t *pYData = S->pData; /* pointer to output table values */ + uint32_t nCols = S->numCols; /* num of rows */ + + /* Input is in 12.20 format */ + /* 12 bits for the table index */ + /* Index value calculation */ + rI = ((X & (q31_t)0xFFF00000) >> 20); + + /* Input is in 12.20 format */ + /* 12 bits for the table index */ + /* Index value calculation */ + cI = ((Y & (q31_t)0xFFF00000) >> 20); + + /* Care taken for table outside boundary */ + /* Returns zero output when values are outside table boundary */ + if(rI < 0 || rI > (S->numRows - 1) || cI < 0 || cI > (S->numCols - 1)) + { + return (0); + } + + /* 20 bits for the fractional part */ + /* xfract should be in 12.20 format */ + xfract = (X & 0x000FFFFF); + + /* Read two nearest output values from the index */ + x1 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI) ]; + x2 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI) + 1]; + + /* 20 bits for the fractional part */ + /* yfract should be in 12.20 format */ + yfract = (Y & 0x000FFFFF); + + /* Read two nearest output values from the index */ + y1 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI + 1) ]; + y2 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI + 1) + 1]; + + /* Calculation of x1 * (1-xfract ) * (1-yfract) and acc is in 13.51 format */ + + /* x1 is in 1.15(q15), xfract in 12.20 format and out is in 13.35 format */ + /* convert 13.35 to 13.31 by right shifting and out is in 1.31 */ + out = (q31_t) (((q63_t) x1 * (0xFFFFF - xfract)) >> 4u); + acc = ((q63_t) out * (0xFFFFF - yfract)); + + /* x2 * (xfract) * (1-yfract) in 1.51 and adding to acc */ + out = (q31_t) (((q63_t) x2 * (0xFFFFF - yfract)) >> 4u); + acc += ((q63_t) out * (xfract)); + + /* y1 * (1 - xfract) * (yfract) in 1.51 and adding to acc */ + out = (q31_t) (((q63_t) y1 * (0xFFFFF - xfract)) >> 4u); + acc += ((q63_t) out * (yfract)); + + /* y2 * (xfract) * (yfract) in 1.51 and adding to acc */ + out = (q31_t) (((q63_t) y2 * (xfract)) >> 4u); + acc += ((q63_t) out * (yfract)); + + /* acc is in 13.51 format and down shift acc by 36 times */ + /* Convert out to 1.15 format */ + return ((q15_t)(acc >> 36)); + } + + + /** + * @brief Q7 bilinear interpolation. + * @param[in,out] S points to an instance of the interpolation structure. + * @param[in] X interpolation coordinate in 12.20 format. + * @param[in] Y interpolation coordinate in 12.20 format. + * @return out interpolated value. + */ + static __INLINE q7_t arm_bilinear_interp_q7( + arm_bilinear_interp_instance_q7 * S, + q31_t X, + q31_t Y) + { + q63_t acc = 0; /* output */ + q31_t out; /* Temporary output */ + q31_t xfract, yfract; /* X, Y fractional parts */ + q7_t x1, x2, y1, y2; /* Nearest output values */ + int32_t rI, cI; /* Row and column indices */ + q7_t *pYData = S->pData; /* pointer to output table values */ + uint32_t nCols = S->numCols; /* num of rows */ + + /* Input is in 12.20 format */ + /* 12 bits for the table index */ + /* Index value calculation */ + rI = ((X & (q31_t)0xFFF00000) >> 20); + + /* Input is in 12.20 format */ + /* 12 bits for the table index */ + /* Index value calculation */ + cI = ((Y & (q31_t)0xFFF00000) >> 20); + + /* Care taken for table outside boundary */ + /* Returns zero output when values are outside table boundary */ + if(rI < 0 || rI > (S->numRows - 1) || cI < 0 || cI > (S->numCols - 1)) + { + return (0); + } + + /* 20 bits for the fractional part */ + /* xfract should be in 12.20 format */ + xfract = (X & (q31_t)0x000FFFFF); + + /* Read two nearest output values from the index */ + x1 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI) ]; + x2 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI) + 1]; + + /* 20 bits for the fractional part */ + /* yfract should be in 12.20 format */ + yfract = (Y & (q31_t)0x000FFFFF); + + /* Read two nearest output values from the index */ + y1 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI + 1) ]; + y2 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI + 1) + 1]; + + /* Calculation of x1 * (1-xfract ) * (1-yfract) and acc is in 16.47 format */ + out = ((x1 * (0xFFFFF - xfract))); + acc = (((q63_t) out * (0xFFFFF - yfract))); + + /* x2 * (xfract) * (1-yfract) in 2.22 and adding to acc */ + out = ((x2 * (0xFFFFF - yfract))); + acc += (((q63_t) out * (xfract))); + + /* y1 * (1 - xfract) * (yfract) in 2.22 and adding to acc */ + out = ((y1 * (0xFFFFF - xfract))); + acc += (((q63_t) out * (yfract))); + + /* y2 * (xfract) * (yfract) in 2.22 and adding to acc */ + out = ((y2 * (yfract))); + acc += (((q63_t) out * (xfract))); + + /* acc in 16.47 format and down shift by 40 to convert to 1.7 format */ + return ((q7_t)(acc >> 40)); + } + + /** + * @} end of BilinearInterpolate group + */ + + +/* SMMLAR */ +#define multAcc_32x32_keep32_R(a, x, y) \ + a = (q31_t) (((((q63_t) a) << 32) + ((q63_t) x * y) + 0x80000000LL ) >> 32) + +/* SMMLSR */ +#define multSub_32x32_keep32_R(a, x, y) \ + a = (q31_t) (((((q63_t) a) << 32) - ((q63_t) x * y) + 0x80000000LL ) >> 32) + +/* SMMULR */ +#define mult_32x32_keep32_R(a, x, y) \ + a = (q31_t) (((q63_t) x * y + 0x80000000LL ) >> 32) + +/* SMMLA */ +#define multAcc_32x32_keep32(a, x, y) \ + a += (q31_t) (((q63_t) x * y) >> 32) + +/* SMMLS */ +#define multSub_32x32_keep32(a, x, y) \ + a -= (q31_t) (((q63_t) x * y) >> 32) + +/* SMMUL */ +#define mult_32x32_keep32(a, x, y) \ + a = (q31_t) (((q63_t) x * y ) >> 32) + + +#if defined ( __CC_ARM ) + /* Enter low optimization region - place directly above function definition */ + #if defined( ARM_MATH_CM4 ) || defined( ARM_MATH_CM7) + #define LOW_OPTIMIZATION_ENTER \ + _Pragma ("push") \ + _Pragma ("O1") + #else + #define LOW_OPTIMIZATION_ENTER + #endif + + /* Exit low optimization region - place directly after end of function definition */ + #if defined( ARM_MATH_CM4 ) || defined( ARM_MATH_CM7) + #define LOW_OPTIMIZATION_EXIT \ + _Pragma ("pop") + #else + #define LOW_OPTIMIZATION_EXIT + #endif + + /* Enter low optimization region - place directly above function definition */ + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER + + /* Exit low optimization region - place directly after end of function definition */ + #define IAR_ONLY_LOW_OPTIMIZATION_EXIT + +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #define LOW_OPTIMIZATION_ENTER + #define LOW_OPTIMIZATION_EXIT + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER + #define IAR_ONLY_LOW_OPTIMIZATION_EXIT + +#elif defined(__GNUC__) + #define LOW_OPTIMIZATION_ENTER __attribute__(( optimize("-O1") )) + #define LOW_OPTIMIZATION_EXIT + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER + #define IAR_ONLY_LOW_OPTIMIZATION_EXIT + +#elif defined(__ICCARM__) + /* Enter low optimization region - place directly above function definition */ + #if defined( ARM_MATH_CM4 ) || defined( ARM_MATH_CM7) + #define LOW_OPTIMIZATION_ENTER \ + _Pragma ("optimize=low") + #else + #define LOW_OPTIMIZATION_ENTER + #endif + + /* Exit low optimization region - place directly after end of function definition */ + #define LOW_OPTIMIZATION_EXIT + + /* Enter low optimization region - place directly above function definition */ + #if defined( ARM_MATH_CM4 ) || defined( ARM_MATH_CM7) + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER \ + _Pragma ("optimize=low") + #else + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER + #endif + + /* Exit low optimization region - place directly after end of function definition */ + #define IAR_ONLY_LOW_OPTIMIZATION_EXIT + +#elif defined(__CSMC__) + #define LOW_OPTIMIZATION_ENTER + #define LOW_OPTIMIZATION_EXIT + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER + #define IAR_ONLY_LOW_OPTIMIZATION_EXIT + +#elif defined(__TASKING__) + #define LOW_OPTIMIZATION_ENTER + #define LOW_OPTIMIZATION_EXIT + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER + #define IAR_ONLY_LOW_OPTIMIZATION_EXIT + +#endif + + +#ifdef __cplusplus +} +#endif + + +#if defined ( __GNUC__ ) +#pragma GCC diagnostic pop +#endif + +#endif /* _ARM_MATH_H */ + +/** + * + * End of file. + */ diff --git a/bsp/nuvoton/libraries/m480/CMSIS/Include/cmsis_armcc.h b/bsp/nuvoton/libraries/m480/CMSIS/Include/cmsis_armcc.h new file mode 100644 index 00000000000..74c49c67def --- /dev/null +++ b/bsp/nuvoton/libraries/m480/CMSIS/Include/cmsis_armcc.h @@ -0,0 +1,734 @@ +/**************************************************************************//** + * @file cmsis_armcc.h + * @brief CMSIS Cortex-M Core Function/Instruction Header File + * @version V4.30 + * @date 20. October 2015 + ******************************************************************************/ +/* Copyright (c) 2009 - 2015 ARM LIMITED + + All rights reserved. + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are met: + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + - Neither the name of ARM nor the names of its contributors may be used + to endorse or promote products derived from this software without + specific prior written permission. + * + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE + LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + ---------------------------------------------------------------------------*/ + + +#ifndef __CMSIS_ARMCC_H +#define __CMSIS_ARMCC_H + + +#if defined(__ARMCC_VERSION) && (__ARMCC_VERSION < 400677) + #error "Please use ARM Compiler Toolchain V4.0.677 or later!" +#endif + +/* ########################### Core Function Access ########################### */ +/** \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_RegAccFunctions CMSIS Core Register Access Functions + @{ + */ + +/* intrinsic void __enable_irq(); */ +/* intrinsic void __disable_irq(); */ + +/** + \brief Get Control Register + \details Returns the content of the Control Register. + \return Control Register value + */ +__STATIC_INLINE uint32_t __get_CONTROL(void) +{ + register uint32_t __regControl __ASM("control"); + return(__regControl); +} + + +/** + \brief Set Control Register + \details Writes the given value to the Control Register. + \param [in] control Control Register value to set + */ +__STATIC_INLINE void __set_CONTROL(uint32_t control) +{ + register uint32_t __regControl __ASM("control"); + __regControl = control; +} + + +/** + \brief Get IPSR Register + \details Returns the content of the IPSR Register. + \return IPSR Register value + */ +__STATIC_INLINE uint32_t __get_IPSR(void) +{ + register uint32_t __regIPSR __ASM("ipsr"); + return(__regIPSR); +} + + +/** + \brief Get APSR Register + \details Returns the content of the APSR Register. + \return APSR Register value + */ +__STATIC_INLINE uint32_t __get_APSR(void) +{ + register uint32_t __regAPSR __ASM("apsr"); + return(__regAPSR); +} + + +/** + \brief Get xPSR Register + \details Returns the content of the xPSR Register. + \return xPSR Register value + */ +__STATIC_INLINE uint32_t __get_xPSR(void) +{ + register uint32_t __regXPSR __ASM("xpsr"); + return(__regXPSR); +} + + +/** + \brief Get Process Stack Pointer + \details Returns the current value of the Process Stack Pointer (PSP). + \return PSP Register value + */ +__STATIC_INLINE uint32_t __get_PSP(void) +{ + register uint32_t __regProcessStackPointer __ASM("psp"); + return(__regProcessStackPointer); +} + + +/** + \brief Set Process Stack Pointer + \details Assigns the given value to the Process Stack Pointer (PSP). + \param [in] topOfProcStack Process Stack Pointer value to set + */ +__STATIC_INLINE void __set_PSP(uint32_t topOfProcStack) +{ + register uint32_t __regProcessStackPointer __ASM("psp"); + __regProcessStackPointer = topOfProcStack; +} + + +/** + \brief Get Main Stack Pointer + \details Returns the current value of the Main Stack Pointer (MSP). + \return MSP Register value + */ +__STATIC_INLINE uint32_t __get_MSP(void) +{ + register uint32_t __regMainStackPointer __ASM("msp"); + return(__regMainStackPointer); +} + + +/** + \brief Set Main Stack Pointer + \details Assigns the given value to the Main Stack Pointer (MSP). + \param [in] topOfMainStack Main Stack Pointer value to set + */ +__STATIC_INLINE void __set_MSP(uint32_t topOfMainStack) +{ + register uint32_t __regMainStackPointer __ASM("msp"); + __regMainStackPointer = topOfMainStack; +} + + +/** + \brief Get Priority Mask + \details Returns the current state of the priority mask bit from the Priority Mask Register. + \return Priority Mask value + */ +__STATIC_INLINE uint32_t __get_PRIMASK(void) +{ + register uint32_t __regPriMask __ASM("primask"); + return(__regPriMask); +} + + +/** + \brief Set Priority Mask + \details Assigns the given value to the Priority Mask Register. + \param [in] priMask Priority Mask + */ +__STATIC_INLINE void __set_PRIMASK(uint32_t priMask) +{ + register uint32_t __regPriMask __ASM("primask"); + __regPriMask = (priMask); +} + + +#if (__CORTEX_M >= 0x03U) || (__CORTEX_SC >= 300U) + +/** + \brief Enable FIQ + \details Enables FIQ interrupts by clearing the F-bit in the CPSR. + Can only be executed in Privileged modes. + */ +#define __enable_fault_irq __enable_fiq + + +/** + \brief Disable FIQ + \details Disables FIQ interrupts by setting the F-bit in the CPSR. + Can only be executed in Privileged modes. + */ +#define __disable_fault_irq __disable_fiq + + +/** + \brief Get Base Priority + \details Returns the current value of the Base Priority register. + \return Base Priority register value + */ +__STATIC_INLINE uint32_t __get_BASEPRI(void) +{ + register uint32_t __regBasePri __ASM("basepri"); + return(__regBasePri); +} + + +/** + \brief Set Base Priority + \details Assigns the given value to the Base Priority register. + \param [in] basePri Base Priority value to set + */ +__STATIC_INLINE void __set_BASEPRI(uint32_t basePri) +{ + register uint32_t __regBasePri __ASM("basepri"); + __regBasePri = (basePri & 0xFFU); +} + + +/** + \brief Set Base Priority with condition + \details Assigns the given value to the Base Priority register only if BASEPRI masking is disabled, + or the new value increases the BASEPRI priority level. + \param [in] basePri Base Priority value to set + */ +__STATIC_INLINE void __set_BASEPRI_MAX(uint32_t basePri) +{ + register uint32_t __regBasePriMax __ASM("basepri_max"); + __regBasePriMax = (basePri & 0xFFU); +} + + +/** + \brief Get Fault Mask + \details Returns the current value of the Fault Mask register. + \return Fault Mask register value + */ +__STATIC_INLINE uint32_t __get_FAULTMASK(void) +{ + register uint32_t __regFaultMask __ASM("faultmask"); + return(__regFaultMask); +} + + +/** + \brief Set Fault Mask + \details Assigns the given value to the Fault Mask register. + \param [in] faultMask Fault Mask value to set + */ +__STATIC_INLINE void __set_FAULTMASK(uint32_t faultMask) +{ + register uint32_t __regFaultMask __ASM("faultmask"); + __regFaultMask = (faultMask & (uint32_t)1); +} + +#endif /* (__CORTEX_M >= 0x03U) || (__CORTEX_SC >= 300U) */ + + +#if (__CORTEX_M == 0x04U) || (__CORTEX_M == 0x07U) + +/** + \brief Get FPSCR + \details Returns the current value of the Floating Point Status/Control register. + \return Floating Point Status/Control register value + */ +__STATIC_INLINE uint32_t __get_FPSCR(void) +{ +#if (__FPU_PRESENT == 1U) && (__FPU_USED == 1U) + register uint32_t __regfpscr __ASM("fpscr"); + return(__regfpscr); +#else + return(0U); +#endif +} + + +/** + \brief Set FPSCR + \details Assigns the given value to the Floating Point Status/Control register. + \param [in] fpscr Floating Point Status/Control value to set + */ +__STATIC_INLINE void __set_FPSCR(uint32_t fpscr) +{ +#if (__FPU_PRESENT == 1U) && (__FPU_USED == 1U) + register uint32_t __regfpscr __ASM("fpscr"); + __regfpscr = (fpscr); +#endif +} + +#endif /* (__CORTEX_M == 0x04U) || (__CORTEX_M == 0x07U) */ + + + +/*@} end of CMSIS_Core_RegAccFunctions */ + + +/* ########################## Core Instruction Access ######################### */ +/** \defgroup CMSIS_Core_InstructionInterface CMSIS Core Instruction Interface + Access to dedicated instructions + @{ +*/ + +/** + \brief No Operation + \details No Operation does nothing. This instruction can be used for code alignment purposes. + */ +#define __NOP __nop + + +/** + \brief Wait For Interrupt + \details Wait For Interrupt is a hint instruction that suspends execution until one of a number of events occurs. + */ +#define __WFI __wfi + + +/** + \brief Wait For Event + \details Wait For Event is a hint instruction that permits the processor to enter + a low-power state until one of a number of events occurs. + */ +#define __WFE __wfe + + +/** + \brief Send Event + \details Send Event is a hint instruction. It causes an event to be signaled to the CPU. + */ +#define __SEV __sev + + +/** + \brief Instruction Synchronization Barrier + \details Instruction Synchronization Barrier flushes the pipeline in the processor, + so that all instructions following the ISB are fetched from cache or memory, + after the instruction has been completed. + */ +#define __ISB() do {\ + __schedule_barrier();\ + __isb(0xF);\ + __schedule_barrier();\ + } while (0U) + +/** + \brief Data Synchronization Barrier + \details Acts as a special kind of Data Memory Barrier. + It completes when all explicit memory accesses before this instruction complete. + */ +#define __DSB() do {\ + __schedule_barrier();\ + __dsb(0xF);\ + __schedule_barrier();\ + } while (0U) + +/** + \brief Data Memory Barrier + \details Ensures the apparent order of the explicit memory operations before + and after the instruction, without ensuring their completion. + */ +#define __DMB() do {\ + __schedule_barrier();\ + __dmb(0xF);\ + __schedule_barrier();\ + } while (0U) + +/** + \brief Reverse byte order (32 bit) + \details Reverses the byte order in integer value. + \param [in] value Value to reverse + \return Reversed value + */ +#define __REV __rev + + +/** + \brief Reverse byte order (16 bit) + \details Reverses the byte order in two unsigned short values. + \param [in] value Value to reverse + \return Reversed value + */ +#ifndef __NO_EMBEDDED_ASM +__attribute__((section(".rev16_text"))) __STATIC_INLINE __ASM uint32_t __REV16(uint32_t value) +{ + rev16 r0, r0 + bx lr +} +#endif + +/** + \brief Reverse byte order in signed short value + \details Reverses the byte order in a signed short value with sign extension to integer. + \param [in] value Value to reverse + \return Reversed value + */ +#ifndef __NO_EMBEDDED_ASM +__attribute__((section(".revsh_text"))) __STATIC_INLINE __ASM int32_t __REVSH(int32_t value) +{ + revsh r0, r0 + bx lr +} +#endif + + +/** + \brief Rotate Right in unsigned value (32 bit) + \details Rotate Right (immediate) provides the value of the contents of a register rotated by a variable number of bits. + \param [in] value Value to rotate + \param [in] value Number of Bits to rotate + \return Rotated value + */ +#define __ROR __ror + + +/** + \brief Breakpoint + \details Causes the processor to enter Debug state. + Debug tools can use this to investigate system state when the instruction at a particular address is reached. + \param [in] value is ignored by the processor. + If required, a debugger can use it to store additional information about the breakpoint. + */ +#define __BKPT(value) __breakpoint(value) + + +/** + \brief Reverse bit order of value + \details Reverses the bit order of the given value. + \param [in] value Value to reverse + \return Reversed value + */ +#if (__CORTEX_M >= 0x03U) || (__CORTEX_SC >= 300U) + #define __RBIT __rbit +#else +__attribute__((always_inline)) __STATIC_INLINE uint32_t __RBIT(uint32_t value) +{ + uint32_t result; + int32_t s = 4 /*sizeof(v)*/ * 8 - 1; /* extra shift needed at end */ + + result = value; /* r will be reversed bits of v; first get LSB of v */ + for (value >>= 1U; value; value >>= 1U) + { + result <<= 1U; + result |= value & 1U; + s--; + } + result <<= s; /* shift when v's highest bits are zero */ + return(result); +} +#endif + + +/** + \brief Count leading zeros + \details Counts the number of leading zeros of a data value. + \param [in] value Value to count the leading zeros + \return number of leading zeros in value + */ +#define __CLZ __clz + + +#if (__CORTEX_M >= 0x03U) || (__CORTEX_SC >= 300U) + +/** + \brief LDR Exclusive (8 bit) + \details Executes a exclusive LDR instruction for 8 bit value. + \param [in] ptr Pointer to data + \return value of type uint8_t at (*ptr) + */ +#if defined(__ARMCC_VERSION) && (__ARMCC_VERSION < 5060020) + #define __LDREXB(ptr) ((uint8_t ) __ldrex(ptr)) +#else + #define __LDREXB(ptr) _Pragma("push") _Pragma("diag_suppress 3731") ((uint8_t ) __ldrex(ptr)) _Pragma("pop") +#endif + + +/** + \brief LDR Exclusive (16 bit) + \details Executes a exclusive LDR instruction for 16 bit values. + \param [in] ptr Pointer to data + \return value of type uint16_t at (*ptr) + */ +#if defined(__ARMCC_VERSION) && (__ARMCC_VERSION < 5060020) + #define __LDREXH(ptr) ((uint16_t) __ldrex(ptr)) +#else + #define __LDREXH(ptr) _Pragma("push") _Pragma("diag_suppress 3731") ((uint16_t) __ldrex(ptr)) _Pragma("pop") +#endif + + +/** + \brief LDR Exclusive (32 bit) + \details Executes a exclusive LDR instruction for 32 bit values. + \param [in] ptr Pointer to data + \return value of type uint32_t at (*ptr) + */ +#if defined(__ARMCC_VERSION) && (__ARMCC_VERSION < 5060020) + #define __LDREXW(ptr) ((uint32_t ) __ldrex(ptr)) +#else + #define __LDREXW(ptr) _Pragma("push") _Pragma("diag_suppress 3731") ((uint32_t ) __ldrex(ptr)) _Pragma("pop") +#endif + + +/** + \brief STR Exclusive (8 bit) + \details Executes a exclusive STR instruction for 8 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + \return 0 Function succeeded + \return 1 Function failed + */ +#if defined(__ARMCC_VERSION) && (__ARMCC_VERSION < 5060020) + #define __STREXB(value, ptr) __strex(value, ptr) +#else + #define __STREXB(value, ptr) _Pragma("push") _Pragma("diag_suppress 3731") __strex(value, ptr) _Pragma("pop") +#endif + + +/** + \brief STR Exclusive (16 bit) + \details Executes a exclusive STR instruction for 16 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + \return 0 Function succeeded + \return 1 Function failed + */ +#if defined(__ARMCC_VERSION) && (__ARMCC_VERSION < 5060020) + #define __STREXH(value, ptr) __strex(value, ptr) +#else + #define __STREXH(value, ptr) _Pragma("push") _Pragma("diag_suppress 3731") __strex(value, ptr) _Pragma("pop") +#endif + + +/** + \brief STR Exclusive (32 bit) + \details Executes a exclusive STR instruction for 32 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + \return 0 Function succeeded + \return 1 Function failed + */ +#if defined(__ARMCC_VERSION) && (__ARMCC_VERSION < 5060020) + #define __STREXW(value, ptr) __strex(value, ptr) +#else + #define __STREXW(value, ptr) _Pragma("push") _Pragma("diag_suppress 3731") __strex(value, ptr) _Pragma("pop") +#endif + + +/** + \brief Remove the exclusive lock + \details Removes the exclusive lock which is created by LDREX. + */ +#define __CLREX __clrex + + +/** + \brief Signed Saturate + \details Saturates a signed value. + \param [in] value Value to be saturated + \param [in] sat Bit position to saturate to (1..32) + \return Saturated value + */ +#define __SSAT __ssat + + +/** + \brief Unsigned Saturate + \details Saturates an unsigned value. + \param [in] value Value to be saturated + \param [in] sat Bit position to saturate to (0..31) + \return Saturated value + */ +#define __USAT __usat + + +/** + \brief Rotate Right with Extend (32 bit) + \details Moves each bit of a bitstring right by one bit. + The carry input is shifted in at the left end of the bitstring. + \param [in] value Value to rotate + \return Rotated value + */ +#ifndef __NO_EMBEDDED_ASM +__attribute__((section(".rrx_text"))) __STATIC_INLINE __ASM uint32_t __RRX(uint32_t value) +{ + rrx r0, r0 + bx lr +} +#endif + + +/** + \brief LDRT Unprivileged (8 bit) + \details Executes a Unprivileged LDRT instruction for 8 bit value. + \param [in] ptr Pointer to data + \return value of type uint8_t at (*ptr) + */ +#define __LDRBT(ptr) ((uint8_t ) __ldrt(ptr)) + + +/** + \brief LDRT Unprivileged (16 bit) + \details Executes a Unprivileged LDRT instruction for 16 bit values. + \param [in] ptr Pointer to data + \return value of type uint16_t at (*ptr) + */ +#define __LDRHT(ptr) ((uint16_t) __ldrt(ptr)) + + +/** + \brief LDRT Unprivileged (32 bit) + \details Executes a Unprivileged LDRT instruction for 32 bit values. + \param [in] ptr Pointer to data + \return value of type uint32_t at (*ptr) + */ +#define __LDRT(ptr) ((uint32_t ) __ldrt(ptr)) + + +/** + \brief STRT Unprivileged (8 bit) + \details Executes a Unprivileged STRT instruction for 8 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + */ +#define __STRBT(value, ptr) __strt(value, ptr) + + +/** + \brief STRT Unprivileged (16 bit) + \details Executes a Unprivileged STRT instruction for 16 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + */ +#define __STRHT(value, ptr) __strt(value, ptr) + + +/** + \brief STRT Unprivileged (32 bit) + \details Executes a Unprivileged STRT instruction for 32 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + */ +#define __STRT(value, ptr) __strt(value, ptr) + +#endif /* (__CORTEX_M >= 0x03U) || (__CORTEX_SC >= 300U) */ + +/*@}*/ /* end of group CMSIS_Core_InstructionInterface */ + + +/* ################### Compiler specific Intrinsics ########################### */ +/** \defgroup CMSIS_SIMD_intrinsics CMSIS SIMD Intrinsics + Access to dedicated SIMD instructions + @{ +*/ + +#if (__CORTEX_M >= 0x04U) /* only for Cortex-M4 and above */ + +#define __SADD8 __sadd8 +#define __QADD8 __qadd8 +#define __SHADD8 __shadd8 +#define __UADD8 __uadd8 +#define __UQADD8 __uqadd8 +#define __UHADD8 __uhadd8 +#define __SSUB8 __ssub8 +#define __QSUB8 __qsub8 +#define __SHSUB8 __shsub8 +#define __USUB8 __usub8 +#define __UQSUB8 __uqsub8 +#define __UHSUB8 __uhsub8 +#define __SADD16 __sadd16 +#define __QADD16 __qadd16 +#define __SHADD16 __shadd16 +#define __UADD16 __uadd16 +#define __UQADD16 __uqadd16 +#define __UHADD16 __uhadd16 +#define __SSUB16 __ssub16 +#define __QSUB16 __qsub16 +#define __SHSUB16 __shsub16 +#define __USUB16 __usub16 +#define __UQSUB16 __uqsub16 +#define __UHSUB16 __uhsub16 +#define __SASX __sasx +#define __QASX __qasx +#define __SHASX __shasx +#define __UASX __uasx +#define __UQASX __uqasx +#define __UHASX __uhasx +#define __SSAX __ssax +#define __QSAX __qsax +#define __SHSAX __shsax +#define __USAX __usax +#define __UQSAX __uqsax +#define __UHSAX __uhsax +#define __USAD8 __usad8 +#define __USADA8 __usada8 +#define __SSAT16 __ssat16 +#define __USAT16 __usat16 +#define __UXTB16 __uxtb16 +#define __UXTAB16 __uxtab16 +#define __SXTB16 __sxtb16 +#define __SXTAB16 __sxtab16 +#define __SMUAD __smuad +#define __SMUADX __smuadx +#define __SMLAD __smlad +#define __SMLADX __smladx +#define __SMLALD __smlald +#define __SMLALDX __smlaldx +#define __SMUSD __smusd +#define __SMUSDX __smusdx +#define __SMLSD __smlsd +#define __SMLSDX __smlsdx +#define __SMLSLD __smlsld +#define __SMLSLDX __smlsldx +#define __SEL __sel +#define __QADD __qadd +#define __QSUB __qsub + +#define __PKHBT(ARG1,ARG2,ARG3) ( ((((uint32_t)(ARG1)) ) & 0x0000FFFFUL) | \ + ((((uint32_t)(ARG2)) << (ARG3)) & 0xFFFF0000UL) ) + +#define __PKHTB(ARG1,ARG2,ARG3) ( ((((uint32_t)(ARG1)) ) & 0xFFFF0000UL) | \ + ((((uint32_t)(ARG2)) >> (ARG3)) & 0x0000FFFFUL) ) + +#define __SMMLA(ARG1,ARG2,ARG3) ( (int32_t)((((int64_t)(ARG1) * (ARG2)) + \ + ((int64_t)(ARG3) << 32U) ) >> 32U)) + +#endif /* (__CORTEX_M >= 0x04) */ +/*@} end of group CMSIS_SIMD_intrinsics */ + + +#endif /* __CMSIS_ARMCC_H */ diff --git a/bsp/nuvoton/libraries/m480/CMSIS/Include/cmsis_armcc_V6.h b/bsp/nuvoton/libraries/m480/CMSIS/Include/cmsis_armcc_V6.h new file mode 100644 index 00000000000..cd13240ce36 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/CMSIS/Include/cmsis_armcc_V6.h @@ -0,0 +1,1800 @@ +/**************************************************************************//** + * @file cmsis_armcc_V6.h + * @brief CMSIS Cortex-M Core Function/Instruction Header File + * @version V4.30 + * @date 20. October 2015 + ******************************************************************************/ +/* Copyright (c) 2009 - 2015 ARM LIMITED + + All rights reserved. + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are met: + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + - Neither the name of ARM nor the names of its contributors may be used + to endorse or promote products derived from this software without + specific prior written permission. + * + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE + LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + ---------------------------------------------------------------------------*/ + + +#ifndef __CMSIS_ARMCC_V6_H +#define __CMSIS_ARMCC_V6_H + + +/* ########################### Core Function Access ########################### */ +/** \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_RegAccFunctions CMSIS Core Register Access Functions + @{ + */ + +/** + \brief Enable IRQ Interrupts + \details Enables IRQ interrupts by clearing the I-bit in the CPSR. + Can only be executed in Privileged modes. + */ +__attribute__((always_inline)) __STATIC_INLINE void __enable_irq(void) +{ + __ASM volatile ("cpsie i" : : : "memory"); +} + + +/** + \brief Disable IRQ Interrupts + \details Disables IRQ interrupts by setting the I-bit in the CPSR. + Can only be executed in Privileged modes. + */ +__attribute__((always_inline)) __STATIC_INLINE void __disable_irq(void) +{ + __ASM volatile ("cpsid i" : : : "memory"); +} + + +/** + \brief Get Control Register + \details Returns the content of the Control Register. + \return Control Register value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __get_CONTROL(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, control" : "=r" (result) ); + return(result); +} + + +#if (__ARM_FEATURE_CMSE == 3U) +/** + \brief Get Control Register (non-secure) + \details Returns the content of the non-secure Control Register when in secure mode. + \return non-secure Control Register value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __TZ_get_CONTROL_NS(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, control_ns" : "=r" (result) ); + return(result); +} +#endif + + +/** + \brief Set Control Register + \details Writes the given value to the Control Register. + \param [in] control Control Register value to set + */ +__attribute__((always_inline)) __STATIC_INLINE void __set_CONTROL(uint32_t control) +{ + __ASM volatile ("MSR control, %0" : : "r" (control) : "memory"); +} + + +#if (__ARM_FEATURE_CMSE == 3U) +/** + \brief Set Control Register (non-secure) + \details Writes the given value to the non-secure Control Register when in secure state. + \param [in] control Control Register value to set + */ +__attribute__((always_inline)) __STATIC_INLINE void __TZ_set_CONTROL_NS(uint32_t control) +{ + __ASM volatile ("MSR control_ns, %0" : : "r" (control) : "memory"); +} +#endif + + +/** + \brief Get IPSR Register + \details Returns the content of the IPSR Register. + \return IPSR Register value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __get_IPSR(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, ipsr" : "=r" (result) ); + return(result); +} + + +#if (__ARM_FEATURE_CMSE == 3U) +/** + \brief Get IPSR Register (non-secure) + \details Returns the content of the non-secure IPSR Register when in secure state. + \return IPSR Register value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __TZ_get_IPSR_NS(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, ipsr_ns" : "=r" (result) ); + return(result); +} +#endif + + +/** + \brief Get APSR Register + \details Returns the content of the APSR Register. + \return APSR Register value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __get_APSR(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, apsr" : "=r" (result) ); + return(result); +} + + +#if (__ARM_FEATURE_CMSE == 3U) +/** + \brief Get APSR Register (non-secure) + \details Returns the content of the non-secure APSR Register when in secure state. + \return APSR Register value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __TZ_get_APSR_NS(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, apsr_ns" : "=r" (result) ); + return(result); +} +#endif + + +/** + \brief Get xPSR Register + \details Returns the content of the xPSR Register. + \return xPSR Register value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __get_xPSR(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, xpsr" : "=r" (result) ); + return(result); +} + + +#if (__ARM_FEATURE_CMSE == 3U) +/** + \brief Get xPSR Register (non-secure) + \details Returns the content of the non-secure xPSR Register when in secure state. + \return xPSR Register value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __TZ_get_xPSR_NS(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, xpsr_ns" : "=r" (result) ); + return(result); +} +#endif + + +/** + \brief Get Process Stack Pointer + \details Returns the current value of the Process Stack Pointer (PSP). + \return PSP Register value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __get_PSP(void) +{ + register uint32_t result; + + __ASM volatile ("MRS %0, psp" : "=r" (result) ); + return(result); +} + + +#if (__ARM_FEATURE_CMSE == 3U) +/** + \brief Get Process Stack Pointer (non-secure) + \details Returns the current value of the non-secure Process Stack Pointer (PSP) when in secure state. + \return PSP Register value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __TZ_get_PSP_NS(void) +{ + register uint32_t result; + + __ASM volatile ("MRS %0, psp_ns" : "=r" (result) ); + return(result); +} +#endif + + +/** + \brief Set Process Stack Pointer + \details Assigns the given value to the Process Stack Pointer (PSP). + \param [in] topOfProcStack Process Stack Pointer value to set + */ +__attribute__((always_inline)) __STATIC_INLINE void __set_PSP(uint32_t topOfProcStack) +{ + __ASM volatile ("MSR psp, %0" : : "r" (topOfProcStack) : "sp"); +} + + +#if (__ARM_FEATURE_CMSE == 3U) +/** + \brief Set Process Stack Pointer (non-secure) + \details Assigns the given value to the non-secure Process Stack Pointer (PSP) when in secure state. + \param [in] topOfProcStack Process Stack Pointer value to set + */ +__attribute__((always_inline)) __STATIC_INLINE void __TZ_set_PSP_NS(uint32_t topOfProcStack) +{ + __ASM volatile ("MSR psp_ns, %0" : : "r" (topOfProcStack) : "sp"); +} +#endif + + +/** + \brief Get Main Stack Pointer + \details Returns the current value of the Main Stack Pointer (MSP). + \return MSP Register value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __get_MSP(void) +{ + register uint32_t result; + + __ASM volatile ("MRS %0, msp" : "=r" (result) ); + return(result); +} + + +#if (__ARM_FEATURE_CMSE == 3U) +/** + \brief Get Main Stack Pointer (non-secure) + \details Returns the current value of the non-secure Main Stack Pointer (MSP) when in secure state. + \return MSP Register value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __TZ_get_MSP_NS(void) +{ + register uint32_t result; + + __ASM volatile ("MRS %0, msp_ns" : "=r" (result) ); + return(result); +} +#endif + + +/** + \brief Set Main Stack Pointer + \details Assigns the given value to the Main Stack Pointer (MSP). + \param [in] topOfMainStack Main Stack Pointer value to set + */ +__attribute__((always_inline)) __STATIC_INLINE void __set_MSP(uint32_t topOfMainStack) +{ + __ASM volatile ("MSR msp, %0" : : "r" (topOfMainStack) : "sp"); +} + + +#if (__ARM_FEATURE_CMSE == 3U) +/** + \brief Set Main Stack Pointer (non-secure) + \details Assigns the given value to the non-secure Main Stack Pointer (MSP) when in secure state. + \param [in] topOfMainStack Main Stack Pointer value to set + */ +__attribute__((always_inline)) __STATIC_INLINE void __TZ_set_MSP_NS(uint32_t topOfMainStack) +{ + __ASM volatile ("MSR msp_ns, %0" : : "r" (topOfMainStack) : "sp"); +} +#endif + + +/** + \brief Get Priority Mask + \details Returns the current state of the priority mask bit from the Priority Mask Register. + \return Priority Mask value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __get_PRIMASK(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, primask" : "=r" (result) ); + return(result); +} + + +#if (__ARM_FEATURE_CMSE == 3U) +/** + \brief Get Priority Mask (non-secure) + \details Returns the current state of the non-secure priority mask bit from the Priority Mask Register when in secure state. + \return Priority Mask value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __TZ_get_PRIMASK_NS(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, primask_ns" : "=r" (result) ); + return(result); +} +#endif + + +/** + \brief Set Priority Mask + \details Assigns the given value to the Priority Mask Register. + \param [in] priMask Priority Mask + */ +__attribute__((always_inline)) __STATIC_INLINE void __set_PRIMASK(uint32_t priMask) +{ + __ASM volatile ("MSR primask, %0" : : "r" (priMask) : "memory"); +} + + +#if (__ARM_FEATURE_CMSE == 3U) +/** + \brief Set Priority Mask (non-secure) + \details Assigns the given value to the non-secure Priority Mask Register when in secure state. + \param [in] priMask Priority Mask + */ +__attribute__((always_inline)) __STATIC_INLINE void __TZ_set_PRIMASK_NS(uint32_t priMask) +{ + __ASM volatile ("MSR primask_ns, %0" : : "r" (priMask) : "memory"); +} +#endif + + +#if ((__ARM_ARCH_7M__ == 1U) || (__ARM_ARCH_7EM__ == 1U) || (__ARM_ARCH_8M__ == 1U)) /* ToDo: ARMCC_V6: check if this is ok for cortex >=3 */ + +/** + \brief Enable FIQ + \details Enables FIQ interrupts by clearing the F-bit in the CPSR. + Can only be executed in Privileged modes. + */ +__attribute__((always_inline)) __STATIC_INLINE void __enable_fault_irq(void) +{ + __ASM volatile ("cpsie f" : : : "memory"); +} + + +/** + \brief Disable FIQ + \details Disables FIQ interrupts by setting the F-bit in the CPSR. + Can only be executed in Privileged modes. + */ +__attribute__((always_inline)) __STATIC_INLINE void __disable_fault_irq(void) +{ + __ASM volatile ("cpsid f" : : : "memory"); +} + + +/** + \brief Get Base Priority + \details Returns the current value of the Base Priority register. + \return Base Priority register value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __get_BASEPRI(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, basepri" : "=r" (result) ); + return(result); +} + + +#if (__ARM_FEATURE_CMSE == 3U) +/** + \brief Get Base Priority (non-secure) + \details Returns the current value of the non-secure Base Priority register when in secure state. + \return Base Priority register value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __TZ_get_BASEPRI_NS(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, basepri_ns" : "=r" (result) ); + return(result); +} +#endif + + +/** + \brief Set Base Priority + \details Assigns the given value to the Base Priority register. + \param [in] basePri Base Priority value to set + */ +__attribute__((always_inline)) __STATIC_INLINE void __set_BASEPRI(uint32_t value) +{ + __ASM volatile ("MSR basepri, %0" : : "r" (value) : "memory"); +} + + +#if (__ARM_FEATURE_CMSE == 3U) +/** + \brief Set Base Priority (non-secure) + \details Assigns the given value to the non-secure Base Priority register when in secure state. + \param [in] basePri Base Priority value to set + */ +__attribute__((always_inline)) __STATIC_INLINE void __TZ_set_BASEPRI_NS(uint32_t value) +{ + __ASM volatile ("MSR basepri_ns, %0" : : "r" (value) : "memory"); +} +#endif + + +/** + \brief Set Base Priority with condition + \details Assigns the given value to the Base Priority register only if BASEPRI masking is disabled, + or the new value increases the BASEPRI priority level. + \param [in] basePri Base Priority value to set + */ +__attribute__((always_inline)) __STATIC_INLINE void __set_BASEPRI_MAX(uint32_t value) +{ + __ASM volatile ("MSR basepri_max, %0" : : "r" (value) : "memory"); +} + + +#if (__ARM_FEATURE_CMSE == 3U) +/** + \brief Set Base Priority with condition (non_secure) + \details Assigns the given value to the non-secure Base Priority register when in secure state only if BASEPRI masking is disabled, + or the new value increases the BASEPRI priority level. + \param [in] basePri Base Priority value to set + */ +__attribute__((always_inline)) __STATIC_INLINE void __TZ_set_BASEPRI_MAX_NS(uint32_t value) +{ + __ASM volatile ("MSR basepri_max_ns, %0" : : "r" (value) : "memory"); +} +#endif + + +/** + \brief Get Fault Mask + \details Returns the current value of the Fault Mask register. + \return Fault Mask register value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __get_FAULTMASK(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, faultmask" : "=r" (result) ); + return(result); +} + + +#if (__ARM_FEATURE_CMSE == 3U) +/** + \brief Get Fault Mask (non-secure) + \details Returns the current value of the non-secure Fault Mask register when in secure state. + \return Fault Mask register value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __TZ_get_FAULTMASK_NS(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, faultmask_ns" : "=r" (result) ); + return(result); +} +#endif + + +/** + \brief Set Fault Mask + \details Assigns the given value to the Fault Mask register. + \param [in] faultMask Fault Mask value to set + */ +__attribute__((always_inline)) __STATIC_INLINE void __set_FAULTMASK(uint32_t faultMask) +{ + __ASM volatile ("MSR faultmask, %0" : : "r" (faultMask) : "memory"); +} + + +#if (__ARM_FEATURE_CMSE == 3U) +/** + \brief Set Fault Mask (non-secure) + \details Assigns the given value to the non-secure Fault Mask register when in secure state. + \param [in] faultMask Fault Mask value to set + */ +__attribute__((always_inline)) __STATIC_INLINE void __TZ_set_FAULTMASK_NS(uint32_t faultMask) +{ + __ASM volatile ("MSR faultmask_ns, %0" : : "r" (faultMask) : "memory"); +} +#endif + + +#endif /* ((__ARM_ARCH_7M__ == 1U) || (__ARM_ARCH_8M__ == 1U)) */ + + +#if (__ARM_ARCH_8M__ == 1U) + +/** + \brief Get Process Stack Pointer Limit + \details Returns the current value of the Process Stack Pointer Limit (PSPLIM). + \return PSPLIM Register value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __get_PSPLIM(void) +{ + register uint32_t result; + + __ASM volatile ("MRS %0, psplim" : "=r" (result) ); + return(result); +} + + +#if (__ARM_FEATURE_CMSE == 3U) && (__ARM_ARCH_PROFILE == 'M') /* ToDo: ARMCC_V6: check predefined macro for mainline */ +/** + \brief Get Process Stack Pointer Limit (non-secure) + \details Returns the current value of the non-secure Process Stack Pointer Limit (PSPLIM) when in secure state. + \return PSPLIM Register value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __TZ_get_PSPLIM_NS(void) +{ + register uint32_t result; + + __ASM volatile ("MRS %0, psplim_ns" : "=r" (result) ); + return(result); +} +#endif + + +/** + \brief Set Process Stack Pointer Limit + \details Assigns the given value to the Process Stack Pointer Limit (PSPLIM). + \param [in] ProcStackPtrLimit Process Stack Pointer Limit value to set + */ +__attribute__((always_inline)) __STATIC_INLINE void __set_PSPLIM(uint32_t ProcStackPtrLimit) +{ + __ASM volatile ("MSR psplim, %0" : : "r" (ProcStackPtrLimit)); +} + + +#if (__ARM_FEATURE_CMSE == 3U) && (__ARM_ARCH_PROFILE == 'M') /* ToDo: ARMCC_V6: check predefined macro for mainline */ +/** + \brief Set Process Stack Pointer (non-secure) + \details Assigns the given value to the non-secure Process Stack Pointer Limit (PSPLIM) when in secure state. + \param [in] ProcStackPtrLimit Process Stack Pointer Limit value to set + */ +__attribute__((always_inline)) __STATIC_INLINE void __TZ_set_PSPLIM_NS(uint32_t ProcStackPtrLimit) +{ + __ASM volatile ("MSR psplim_ns, %0\n" : : "r" (ProcStackPtrLimit)); +} +#endif + + +/** + \brief Get Main Stack Pointer Limit + \details Returns the current value of the Main Stack Pointer Limit (MSPLIM). + \return MSPLIM Register value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __get_MSPLIM(void) +{ + register uint32_t result; + + __ASM volatile ("MRS %0, msplim" : "=r" (result) ); + + return(result); +} + + +#if (__ARM_FEATURE_CMSE == 3U) && (__ARM_ARCH_PROFILE == 'M') /* ToDo: ARMCC_V6: check predefined macro for mainline */ +/** + \brief Get Main Stack Pointer Limit (non-secure) + \details Returns the current value of the non-secure Main Stack Pointer Limit(MSPLIM) when in secure state. + \return MSPLIM Register value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __TZ_get_MSPLIM_NS(void) +{ + register uint32_t result; + + __ASM volatile ("MRS %0, msplim_ns" : "=r" (result) ); + return(result); +} +#endif + + +/** + \brief Set Main Stack Pointer Limit + \details Assigns the given value to the Main Stack Pointer Limit (MSPLIM). + \param [in] MainStackPtrLimit Main Stack Pointer Limit value to set + */ +__attribute__((always_inline)) __STATIC_INLINE void __set_MSPLIM(uint32_t MainStackPtrLimit) +{ + __ASM volatile ("MSR msplim, %0" : : "r" (MainStackPtrLimit)); +} + + +#if (__ARM_FEATURE_CMSE == 3U) && (__ARM_ARCH_PROFILE == 'M') /* ToDo: ARMCC_V6: check predefined macro for mainline */ +/** + \brief Set Main Stack Pointer Limit (non-secure) + \details Assigns the given value to the non-secure Main Stack Pointer Limit (MSPLIM) when in secure state. + \param [in] MainStackPtrLimit Main Stack Pointer value to set + */ +__attribute__((always_inline)) __STATIC_INLINE void __TZ_set_MSPLIM_NS(uint32_t MainStackPtrLimit) +{ + __ASM volatile ("MSR msplim_ns, %0" : : "r" (MainStackPtrLimit)); +} +#endif + +#endif /* (__ARM_ARCH_8M__ == 1U) */ + + +#if ((__ARM_ARCH_7EM__ == 1U) || (__ARM_ARCH_8M__ == 1U)) /* ToDo: ARMCC_V6: check if this is ok for cortex >=4 */ + +/** + \brief Get FPSCR + \details eturns the current value of the Floating Point Status/Control register. + \return Floating Point Status/Control register value + */ +#define __get_FPSCR __builtin_arm_get_fpscr +#if 0 +__attribute__((always_inline)) __STATIC_INLINE uint32_t __get_FPSCR(void) +{ +#if (__FPU_PRESENT == 1U) && (__FPU_USED == 1U) + uint32_t result; + + __ASM volatile (""); /* Empty asm statement works as a scheduling barrier */ + __ASM volatile ("VMRS %0, fpscr" : "=r" (result) ); + __ASM volatile (""); + return(result); +#else + return(0); +#endif +} +#endif + +#if (__ARM_FEATURE_CMSE == 3U) +/** + \brief Get FPSCR (non-secure) + \details Returns the current value of the non-secure Floating Point Status/Control register when in secure state. + \return Floating Point Status/Control register value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __TZ_get_FPSCR_NS(void) +{ +#if (__FPU_PRESENT == 1U) && (__FPU_USED == 1U) + uint32_t result; + + __ASM volatile (""); /* Empty asm statement works as a scheduling barrier */ + __ASM volatile ("VMRS %0, fpscr_ns" : "=r" (result) ); + __ASM volatile (""); + return(result); +#else + return(0); +#endif +} +#endif + + +/** + \brief Set FPSCR + \details Assigns the given value to the Floating Point Status/Control register. + \param [in] fpscr Floating Point Status/Control value to set + */ +#define __set_FPSCR __builtin_arm_set_fpscr +#if 0 +__attribute__((always_inline)) __STATIC_INLINE void __set_FPSCR(uint32_t fpscr) +{ +#if (__FPU_PRESENT == 1U) && (__FPU_USED == 1U) + __ASM volatile (""); /* Empty asm statement works as a scheduling barrier */ + __ASM volatile ("VMSR fpscr, %0" : : "r" (fpscr) : "vfpcc"); + __ASM volatile (""); +#endif +} +#endif + +#if (__ARM_FEATURE_CMSE == 3U) +/** + \brief Set FPSCR (non-secure) + \details Assigns the given value to the non-secure Floating Point Status/Control register when in secure state. + \param [in] fpscr Floating Point Status/Control value to set + */ +__attribute__((always_inline)) __STATIC_INLINE void __TZ_set_FPSCR_NS(uint32_t fpscr) +{ +#if (__FPU_PRESENT == 1U) && (__FPU_USED == 1U) + __ASM volatile (""); /* Empty asm statement works as a scheduling barrier */ + __ASM volatile ("VMSR fpscr_ns, %0" : : "r" (fpscr) : "vfpcc"); + __ASM volatile (""); +#endif +} +#endif + +#endif /* ((__ARM_ARCH_7EM__ == 1U) || (__ARM_ARCH_8M__ == 1U)) */ + + + +/*@} end of CMSIS_Core_RegAccFunctions */ + + +/* ########################## Core Instruction Access ######################### */ +/** \defgroup CMSIS_Core_InstructionInterface CMSIS Core Instruction Interface + Access to dedicated instructions + @{ +*/ + +/* Define macros for porting to both thumb1 and thumb2. + * For thumb1, use low register (r0-r7), specified by constraint "l" + * Otherwise, use general registers, specified by constraint "r" */ +#if defined (__thumb__) && !defined (__thumb2__) +#define __CMSIS_GCC_OUT_REG(r) "=l" (r) +#define __CMSIS_GCC_USE_REG(r) "l" (r) +#else +#define __CMSIS_GCC_OUT_REG(r) "=r" (r) +#define __CMSIS_GCC_USE_REG(r) "r" (r) +#endif + +/** + \brief No Operation + \details No Operation does nothing. This instruction can be used for code alignment purposes. + */ +#define __NOP __builtin_arm_nop + +/** + \brief Wait For Interrupt + \details Wait For Interrupt is a hint instruction that suspends execution until one of a number of events occurs. + */ +#define __WFI __builtin_arm_wfi + + +/** + \brief Wait For Event + \details Wait For Event is a hint instruction that permits the processor to enter + a low-power state until one of a number of events occurs. + */ +#define __WFE __builtin_arm_wfe + + +/** + \brief Send Event + \details Send Event is a hint instruction. It causes an event to be signaled to the CPU. + */ +#define __SEV __builtin_arm_sev + + +/** + \brief Instruction Synchronization Barrier + \details Instruction Synchronization Barrier flushes the pipeline in the processor, + so that all instructions following the ISB are fetched from cache or memory, + after the instruction has been completed. + */ +#define __ISB() __builtin_arm_isb(0xF); + +/** + \brief Data Synchronization Barrier + \details Acts as a special kind of Data Memory Barrier. + It completes when all explicit memory accesses before this instruction complete. + */ +#define __DSB() __builtin_arm_dsb(0xF); + + +/** + \brief Data Memory Barrier + \details Ensures the apparent order of the explicit memory operations before + and after the instruction, without ensuring their completion. + */ +#define __DMB() __builtin_arm_dmb(0xF); + + +/** + \brief Reverse byte order (32 bit) + \details Reverses the byte order in integer value. + \param [in] value Value to reverse + \return Reversed value + */ +#define __REV __builtin_bswap32 + + +/** + \brief Reverse byte order (16 bit) + \details Reverses the byte order in two unsigned short values. + \param [in] value Value to reverse + \return Reversed value + */ +#define __REV16 __builtin_bswap16 /* ToDo: ARMCC_V6: check if __builtin_bswap16 could be used */ +#if 0 +__attribute__((always_inline)) __STATIC_INLINE uint32_t __REV16(uint32_t value) +{ + uint32_t result; + + __ASM volatile ("rev16 %0, %1" : __CMSIS_GCC_OUT_REG (result) : __CMSIS_GCC_USE_REG (value) ); + return(result); +} +#endif + + +/** + \brief Reverse byte order in signed short value + \details Reverses the byte order in a signed short value with sign extension to integer. + \param [in] value Value to reverse + \return Reversed value + */ + /* ToDo: ARMCC_V6: check if __builtin_bswap16 could be used */ +__attribute__((always_inline)) __STATIC_INLINE int32_t __REVSH(int32_t value) +{ + int32_t result; + + __ASM volatile ("revsh %0, %1" : __CMSIS_GCC_OUT_REG (result) : __CMSIS_GCC_USE_REG (value) ); + return(result); +} + + +/** + \brief Rotate Right in unsigned value (32 bit) + \details Rotate Right (immediate) provides the value of the contents of a register rotated by a variable number of bits. + \param [in] op1 Value to rotate + \param [in] op2 Number of Bits to rotate + \return Rotated value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __ROR(uint32_t op1, uint32_t op2) +{ + return (op1 >> op2) | (op1 << (32U - op2)); +} + + +/** + \brief Breakpoint + \details Causes the processor to enter Debug state. + Debug tools can use this to investigate system state when the instruction at a particular address is reached. + \param [in] value is ignored by the processor. + If required, a debugger can use it to store additional information about the breakpoint. + */ +#define __BKPT(value) __ASM volatile ("bkpt "#value) + + +/** + \brief Reverse bit order of value + \details Reverses the bit order of the given value. + \param [in] value Value to reverse + \return Reversed value + */ + /* ToDo: ARMCC_V6: check if __builtin_arm_rbit is supported */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __RBIT(uint32_t value) +{ + uint32_t result; + +#if ((__ARM_ARCH_7M__ == 1U) || (__ARM_ARCH_7EM__ == 1U) || (__ARM_ARCH_8M__ == 1U)) /* ToDo: ARMCC_V6: check if this is ok for cortex >=3 */ + __ASM volatile ("rbit %0, %1" : "=r" (result) : "r" (value) ); +#else + int32_t s = 4 /*sizeof(v)*/ * 8 - 1; /* extra shift needed at end */ + + result = value; /* r will be reversed bits of v; first get LSB of v */ + for (value >>= 1U; value; value >>= 1U) + { + result <<= 1U; + result |= value & 1U; + s--; + } + result <<= s; /* shift when v's highest bits are zero */ +#endif + return(result); +} + + +/** + \brief Count leading zeros + \details Counts the number of leading zeros of a data value. + \param [in] value Value to count the leading zeros + \return number of leading zeros in value + */ +#define __CLZ __builtin_clz + + +#if ((__ARM_ARCH_7M__ == 1U) || (__ARM_ARCH_7EM__ == 1U) || (__ARM_ARCH_8M__ == 1U)) /* ToDo: ARMCC_V6: check if this is ok for cortex >=3 */ + +/** + \brief LDR Exclusive (8 bit) + \details Executes a exclusive LDR instruction for 8 bit value. + \param [in] ptr Pointer to data + \return value of type uint8_t at (*ptr) + */ +#define __LDREXB (uint8_t)__builtin_arm_ldrex + + +/** + \brief LDR Exclusive (16 bit) + \details Executes a exclusive LDR instruction for 16 bit values. + \param [in] ptr Pointer to data + \return value of type uint16_t at (*ptr) + */ +#define __LDREXH (uint16_t)__builtin_arm_ldrex + + +/** + \brief LDR Exclusive (32 bit) + \details Executes a exclusive LDR instruction for 32 bit values. + \param [in] ptr Pointer to data + \return value of type uint32_t at (*ptr) + */ +#define __LDREXW (uint32_t)__builtin_arm_ldrex + + +/** + \brief STR Exclusive (8 bit) + \details Executes a exclusive STR instruction for 8 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + \return 0 Function succeeded + \return 1 Function failed + */ +#define __STREXB (uint32_t)__builtin_arm_strex + + +/** + \brief STR Exclusive (16 bit) + \details Executes a exclusive STR instruction for 16 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + \return 0 Function succeeded + \return 1 Function failed + */ +#define __STREXH (uint32_t)__builtin_arm_strex + + +/** + \brief STR Exclusive (32 bit) + \details Executes a exclusive STR instruction for 32 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + \return 0 Function succeeded + \return 1 Function failed + */ +#define __STREXW (uint32_t)__builtin_arm_strex + + +/** + \brief Remove the exclusive lock + \details Removes the exclusive lock which is created by LDREX. + */ +#define __CLREX __builtin_arm_clrex + + +/** + \brief Signed Saturate + \details Saturates a signed value. + \param [in] value Value to be saturated + \param [in] sat Bit position to saturate to (1..32) + \return Saturated value + */ +/*#define __SSAT __builtin_arm_ssat*/ +#define __SSAT(ARG1,ARG2) \ +({ \ + int32_t __RES, __ARG1 = (ARG1); \ + __ASM ("ssat %0, %1, %2" : "=r" (__RES) : "I" (ARG2), "r" (__ARG1) ); \ + __RES; \ + }) + + +/** + \brief Unsigned Saturate + \details Saturates an unsigned value. + \param [in] value Value to be saturated + \param [in] sat Bit position to saturate to (0..31) + \return Saturated value + */ +#define __USAT __builtin_arm_usat +#if 0 +#define __USAT(ARG1,ARG2) \ +({ \ + uint32_t __RES, __ARG1 = (ARG1); \ + __ASM ("usat %0, %1, %2" : "=r" (__RES) : "I" (ARG2), "r" (__ARG1) ); \ + __RES; \ + }) +#endif + + +/** + \brief Rotate Right with Extend (32 bit) + \details Moves each bit of a bitstring right by one bit. + The carry input is shifted in at the left end of the bitstring. + \param [in] value Value to rotate + \return Rotated value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __RRX(uint32_t value) +{ + uint32_t result; + + __ASM volatile ("rrx %0, %1" : __CMSIS_GCC_OUT_REG (result) : __CMSIS_GCC_USE_REG (value) ); + return(result); +} + + +/** + \brief LDRT Unprivileged (8 bit) + \details Executes a Unprivileged LDRT instruction for 8 bit value. + \param [in] ptr Pointer to data + \return value of type uint8_t at (*ptr) + */ +__attribute__((always_inline)) __STATIC_INLINE uint8_t __LDRBT(volatile uint8_t *ptr) +{ + uint32_t result; + + __ASM volatile ("ldrbt %0, %1" : "=r" (result) : "Q" (*ptr) ); + return ((uint8_t) result); /* Add explicit type cast here */ +} + + +/** + \brief LDRT Unprivileged (16 bit) + \details Executes a Unprivileged LDRT instruction for 16 bit values. + \param [in] ptr Pointer to data + \return value of type uint16_t at (*ptr) + */ +__attribute__((always_inline)) __STATIC_INLINE uint16_t __LDRHT(volatile uint16_t *ptr) +{ + uint32_t result; + + __ASM volatile ("ldrht %0, %1" : "=r" (result) : "Q" (*ptr) ); + return ((uint16_t) result); /* Add explicit type cast here */ +} + + +/** + \brief LDRT Unprivileged (32 bit) + \details Executes a Unprivileged LDRT instruction for 32 bit values. + \param [in] ptr Pointer to data + \return value of type uint32_t at (*ptr) + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __LDRT(volatile uint32_t *ptr) +{ + uint32_t result; + + __ASM volatile ("ldrt %0, %1" : "=r" (result) : "Q" (*ptr) ); + return(result); +} + + +/** + \brief STRT Unprivileged (8 bit) + \details Executes a Unprivileged STRT instruction for 8 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + */ +__attribute__((always_inline)) __STATIC_INLINE void __STRBT(uint8_t value, volatile uint8_t *ptr) +{ + __ASM volatile ("strbt %1, %0" : "=Q" (*ptr) : "r" ((uint32_t)value) ); +} + + +/** + \brief STRT Unprivileged (16 bit) + \details Executes a Unprivileged STRT instruction for 16 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + */ +__attribute__((always_inline)) __STATIC_INLINE void __STRHT(uint16_t value, volatile uint16_t *ptr) +{ + __ASM volatile ("strht %1, %0" : "=Q" (*ptr) : "r" ((uint32_t)value) ); +} + + +/** + \brief STRT Unprivileged (32 bit) + \details Executes a Unprivileged STRT instruction for 32 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + */ +__attribute__((always_inline)) __STATIC_INLINE void __STRT(uint32_t value, volatile uint32_t *ptr) +{ + __ASM volatile ("strt %1, %0" : "=Q" (*ptr) : "r" (value) ); +} + +#endif /* ((__ARM_ARCH_7M__ == 1U) || (__ARM_ARCH_7EM__ == 1U) || (__ARM_ARCH_8M__ == 1U)) */ + + +#if (__ARM_ARCH_8M__ == 1U) + +/** + \brief Load-Acquire (8 bit) + \details Executes a LDAB instruction for 8 bit value. + \param [in] ptr Pointer to data + \return value of type uint8_t at (*ptr) + */ +__attribute__((always_inline)) __STATIC_INLINE uint8_t __LDAB(volatile uint8_t *ptr) +{ + uint32_t result; + + __ASM volatile ("ldab %0, %1" : "=r" (result) : "Q" (*ptr) ); + return ((uint8_t) result); +} + + +/** + \brief Load-Acquire (16 bit) + \details Executes a LDAH instruction for 16 bit values. + \param [in] ptr Pointer to data + \return value of type uint16_t at (*ptr) + */ +__attribute__((always_inline)) __STATIC_INLINE uint16_t __LDAH(volatile uint16_t *ptr) +{ + uint32_t result; + + __ASM volatile ("ldah %0, %1" : "=r" (result) : "Q" (*ptr) ); + return ((uint16_t) result); +} + + +/** + \brief Load-Acquire (32 bit) + \details Executes a LDA instruction for 32 bit values. + \param [in] ptr Pointer to data + \return value of type uint32_t at (*ptr) + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __LDA(volatile uint32_t *ptr) +{ + uint32_t result; + + __ASM volatile ("lda %0, %1" : "=r" (result) : "Q" (*ptr) ); + return(result); +} + + +/** + \brief Store-Release (8 bit) + \details Executes a STLB instruction for 8 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + */ +__attribute__((always_inline)) __STATIC_INLINE void __STLB(uint8_t value, volatile uint8_t *ptr) +{ + __ASM volatile ("stlb %1, %0" : "=Q" (*ptr) : "r" ((uint32_t)value) ); +} + + +/** + \brief Store-Release (16 bit) + \details Executes a STLH instruction for 16 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + */ +__attribute__((always_inline)) __STATIC_INLINE void __STLH(uint16_t value, volatile uint16_t *ptr) +{ + __ASM volatile ("stlh %1, %0" : "=Q" (*ptr) : "r" ((uint32_t)value) ); +} + + +/** + \brief Store-Release (32 bit) + \details Executes a STL instruction for 32 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + */ +__attribute__((always_inline)) __STATIC_INLINE void __STL(uint32_t value, volatile uint32_t *ptr) +{ + __ASM volatile ("stl %1, %0" : "=Q" (*ptr) : "r" ((uint32_t)value) ); +} + + +/** + \brief Load-Acquire Exclusive (8 bit) + \details Executes a LDAB exclusive instruction for 8 bit value. + \param [in] ptr Pointer to data + \return value of type uint8_t at (*ptr) + */ +#define __LDAEXB (uint8_t)__builtin_arm_ldaex + + +/** + \brief Load-Acquire Exclusive (16 bit) + \details Executes a LDAH exclusive instruction for 16 bit values. + \param [in] ptr Pointer to data + \return value of type uint16_t at (*ptr) + */ +#define __LDAEXH (uint16_t)__builtin_arm_ldaex + + +/** + \brief Load-Acquire Exclusive (32 bit) + \details Executes a LDA exclusive instruction for 32 bit values. + \param [in] ptr Pointer to data + \return value of type uint32_t at (*ptr) + */ +#define __LDAEX (uint32_t)__builtin_arm_ldaex + + +/** + \brief Store-Release Exclusive (8 bit) + \details Executes a STLB exclusive instruction for 8 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + \return 0 Function succeeded + \return 1 Function failed + */ +#define __STLEXB (uint32_t)__builtin_arm_stlex + + +/** + \brief Store-Release Exclusive (16 bit) + \details Executes a STLH exclusive instruction for 16 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + \return 0 Function succeeded + \return 1 Function failed + */ +#define __STLEXH (uint32_t)__builtin_arm_stlex + + +/** + \brief Store-Release Exclusive (32 bit) + \details Executes a STL exclusive instruction for 32 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + \return 0 Function succeeded + \return 1 Function failed + */ +#define __STLEX (uint32_t)__builtin_arm_stlex + +#endif /* (__ARM_ARCH_8M__ == 1U) */ + +/*@}*/ /* end of group CMSIS_Core_InstructionInterface */ + + +/* ################### Compiler specific Intrinsics ########################### */ +/** \defgroup CMSIS_SIMD_intrinsics CMSIS SIMD Intrinsics + Access to dedicated SIMD instructions + @{ +*/ + +#if (__ARM_FEATURE_DSP == 1U) /* ToDo: ARMCC_V6: This should be ARCH >= ARMv7-M + SIMD */ + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SADD8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("sadd8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __QADD8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("qadd8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SHADD8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("shadd8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __UADD8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uadd8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __UQADD8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uqadd8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __UHADD8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uhadd8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SSUB8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("ssub8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __QSUB8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("qsub8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SHSUB8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("shsub8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __USUB8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("usub8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __UQSUB8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uqsub8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __UHSUB8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uhsub8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SADD16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("sadd16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __QADD16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("qadd16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SHADD16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("shadd16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __UADD16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uadd16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __UQADD16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uqadd16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __UHADD16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uhadd16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SSUB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("ssub16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __QSUB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("qsub16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SHSUB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("shsub16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __USUB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("usub16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __UQSUB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uqsub16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __UHSUB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uhsub16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SASX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("sasx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __QASX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("qasx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SHASX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("shasx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __UASX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uasx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __UQASX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uqasx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __UHASX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uhasx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SSAX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("ssax %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __QSAX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("qsax %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SHSAX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("shsax %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __USAX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("usax %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __UQSAX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uqsax %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __UHSAX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uhsax %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __USAD8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("usad8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __USADA8(uint32_t op1, uint32_t op2, uint32_t op3) +{ + uint32_t result; + + __ASM volatile ("usada8 %0, %1, %2, %3" : "=r" (result) : "r" (op1), "r" (op2), "r" (op3) ); + return(result); +} + +#define __SSAT16(ARG1,ARG2) \ +({ \ + uint32_t __RES, __ARG1 = (ARG1); \ + __ASM ("ssat16 %0, %1, %2" : "=r" (__RES) : "I" (ARG2), "r" (__ARG1) ); \ + __RES; \ + }) + +#define __USAT16(ARG1,ARG2) \ +({ \ + uint32_t __RES, __ARG1 = (ARG1); \ + __ASM ("usat16 %0, %1, %2" : "=r" (__RES) : "I" (ARG2), "r" (__ARG1) ); \ + __RES; \ + }) + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __UXTB16(uint32_t op1) +{ + uint32_t result; + + __ASM volatile ("uxtb16 %0, %1" : "=r" (result) : "r" (op1)); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __UXTAB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uxtab16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SXTB16(uint32_t op1) +{ + uint32_t result; + + __ASM volatile ("sxtb16 %0, %1" : "=r" (result) : "r" (op1)); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SXTAB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("sxtab16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SMUAD (uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("smuad %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SMUADX (uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("smuadx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SMLAD (uint32_t op1, uint32_t op2, uint32_t op3) +{ + uint32_t result; + + __ASM volatile ("smlad %0, %1, %2, %3" : "=r" (result) : "r" (op1), "r" (op2), "r" (op3) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SMLADX (uint32_t op1, uint32_t op2, uint32_t op3) +{ + uint32_t result; + + __ASM volatile ("smladx %0, %1, %2, %3" : "=r" (result) : "r" (op1), "r" (op2), "r" (op3) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint64_t __SMLALD (uint32_t op1, uint32_t op2, uint64_t acc) +{ + union llreg_u{ + uint32_t w32[2]; + uint64_t w64; + } llr; + llr.w64 = acc; + +#ifndef __ARMEB__ /* Little endian */ + __ASM volatile ("smlald %0, %1, %2, %3" : "=r" (llr.w32[0]), "=r" (llr.w32[1]): "r" (op1), "r" (op2) , "0" (llr.w32[0]), "1" (llr.w32[1]) ); +#else /* Big endian */ + __ASM volatile ("smlald %0, %1, %2, %3" : "=r" (llr.w32[1]), "=r" (llr.w32[0]): "r" (op1), "r" (op2) , "0" (llr.w32[1]), "1" (llr.w32[0]) ); +#endif + + return(llr.w64); +} + +__attribute__((always_inline)) __STATIC_INLINE uint64_t __SMLALDX (uint32_t op1, uint32_t op2, uint64_t acc) +{ + union llreg_u{ + uint32_t w32[2]; + uint64_t w64; + } llr; + llr.w64 = acc; + +#ifndef __ARMEB__ /* Little endian */ + __ASM volatile ("smlaldx %0, %1, %2, %3" : "=r" (llr.w32[0]), "=r" (llr.w32[1]): "r" (op1), "r" (op2) , "0" (llr.w32[0]), "1" (llr.w32[1]) ); +#else /* Big endian */ + __ASM volatile ("smlaldx %0, %1, %2, %3" : "=r" (llr.w32[1]), "=r" (llr.w32[0]): "r" (op1), "r" (op2) , "0" (llr.w32[1]), "1" (llr.w32[0]) ); +#endif + + return(llr.w64); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SMUSD (uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("smusd %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SMUSDX (uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("smusdx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SMLSD (uint32_t op1, uint32_t op2, uint32_t op3) +{ + uint32_t result; + + __ASM volatile ("smlsd %0, %1, %2, %3" : "=r" (result) : "r" (op1), "r" (op2), "r" (op3) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SMLSDX (uint32_t op1, uint32_t op2, uint32_t op3) +{ + uint32_t result; + + __ASM volatile ("smlsdx %0, %1, %2, %3" : "=r" (result) : "r" (op1), "r" (op2), "r" (op3) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE uint64_t __SMLSLD (uint32_t op1, uint32_t op2, uint64_t acc) +{ + union llreg_u{ + uint32_t w32[2]; + uint64_t w64; + } llr; + llr.w64 = acc; + +#ifndef __ARMEB__ /* Little endian */ + __ASM volatile ("smlsld %0, %1, %2, %3" : "=r" (llr.w32[0]), "=r" (llr.w32[1]): "r" (op1), "r" (op2) , "0" (llr.w32[0]), "1" (llr.w32[1]) ); +#else /* Big endian */ + __ASM volatile ("smlsld %0, %1, %2, %3" : "=r" (llr.w32[1]), "=r" (llr.w32[0]): "r" (op1), "r" (op2) , "0" (llr.w32[1]), "1" (llr.w32[0]) ); +#endif + + return(llr.w64); +} + +__attribute__((always_inline)) __STATIC_INLINE uint64_t __SMLSLDX (uint32_t op1, uint32_t op2, uint64_t acc) +{ + union llreg_u{ + uint32_t w32[2]; + uint64_t w64; + } llr; + llr.w64 = acc; + +#ifndef __ARMEB__ /* Little endian */ + __ASM volatile ("smlsldx %0, %1, %2, %3" : "=r" (llr.w32[0]), "=r" (llr.w32[1]): "r" (op1), "r" (op2) , "0" (llr.w32[0]), "1" (llr.w32[1]) ); +#else /* Big endian */ + __ASM volatile ("smlsldx %0, %1, %2, %3" : "=r" (llr.w32[1]), "=r" (llr.w32[0]): "r" (op1), "r" (op2) , "0" (llr.w32[1]), "1" (llr.w32[0]) ); +#endif + + return(llr.w64); +} + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SEL (uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("sel %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE int32_t __QADD( int32_t op1, int32_t op2) +{ + int32_t result; + + __ASM volatile ("qadd %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__((always_inline)) __STATIC_INLINE int32_t __QSUB( int32_t op1, int32_t op2) +{ + int32_t result; + + __ASM volatile ("qsub %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +#define __PKHBT(ARG1,ARG2,ARG3) \ +({ \ + uint32_t __RES, __ARG1 = (ARG1), __ARG2 = (ARG2); \ + __ASM ("pkhbt %0, %1, %2, lsl %3" : "=r" (__RES) : "r" (__ARG1), "r" (__ARG2), "I" (ARG3) ); \ + __RES; \ + }) + +#define __PKHTB(ARG1,ARG2,ARG3) \ +({ \ + uint32_t __RES, __ARG1 = (ARG1), __ARG2 = (ARG2); \ + if (ARG3 == 0) \ + __ASM ("pkhtb %0, %1, %2" : "=r" (__RES) : "r" (__ARG1), "r" (__ARG2) ); \ + else \ + __ASM ("pkhtb %0, %1, %2, asr %3" : "=r" (__RES) : "r" (__ARG1), "r" (__ARG2), "I" (ARG3) ); \ + __RES; \ + }) + +__attribute__((always_inline)) __STATIC_INLINE uint32_t __SMMLA (int32_t op1, int32_t op2, int32_t op3) +{ + int32_t result; + + __ASM volatile ("smmla %0, %1, %2, %3" : "=r" (result): "r" (op1), "r" (op2), "r" (op3) ); + return(result); +} + +#endif /* (__ARM_FEATURE_DSP == 1U) */ +/*@} end of group CMSIS_SIMD_intrinsics */ + + +#endif /* __CMSIS_ARMCC_V6_H */ diff --git a/bsp/nuvoton/libraries/m480/CMSIS/Include/cmsis_gcc.h b/bsp/nuvoton/libraries/m480/CMSIS/Include/cmsis_gcc.h new file mode 100644 index 00000000000..bb89fbba9e4 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/CMSIS/Include/cmsis_gcc.h @@ -0,0 +1,1373 @@ +/**************************************************************************//** + * @file cmsis_gcc.h + * @brief CMSIS Cortex-M Core Function/Instruction Header File + * @version V4.30 + * @date 20. October 2015 + ******************************************************************************/ +/* Copyright (c) 2009 - 2015 ARM LIMITED + + All rights reserved. + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are met: + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + - Neither the name of ARM nor the names of its contributors may be used + to endorse or promote products derived from this software without + specific prior written permission. + * + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE + LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + ---------------------------------------------------------------------------*/ + + +#ifndef __CMSIS_GCC_H +#define __CMSIS_GCC_H + +/* ignore some GCC warnings */ +#if defined ( __GNUC__ ) +#pragma GCC diagnostic push +#pragma GCC diagnostic ignored "-Wsign-conversion" +#pragma GCC diagnostic ignored "-Wconversion" +#pragma GCC diagnostic ignored "-Wunused-parameter" +#endif + + +/* ########################### Core Function Access ########################### */ +/** \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_RegAccFunctions CMSIS Core Register Access Functions + @{ + */ + +/** + \brief Enable IRQ Interrupts + \details Enables IRQ interrupts by clearing the I-bit in the CPSR. + Can only be executed in Privileged modes. + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __enable_irq(void) +{ + __ASM volatile ("cpsie i" : : : "memory"); +} + + +/** + \brief Disable IRQ Interrupts + \details Disables IRQ interrupts by setting the I-bit in the CPSR. + Can only be executed in Privileged modes. + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __disable_irq(void) +{ + __ASM volatile ("cpsid i" : : : "memory"); +} + + +/** + \brief Get Control Register + \details Returns the content of the Control Register. + \return Control Register value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __get_CONTROL(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, control" : "=r" (result) ); + return(result); +} + + +/** + \brief Set Control Register + \details Writes the given value to the Control Register. + \param [in] control Control Register value to set + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __set_CONTROL(uint32_t control) +{ + __ASM volatile ("MSR control, %0" : : "r" (control) : "memory"); +} + + +/** + \brief Get IPSR Register + \details Returns the content of the IPSR Register. + \return IPSR Register value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __get_IPSR(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, ipsr" : "=r" (result) ); + return(result); +} + + +/** + \brief Get APSR Register + \details Returns the content of the APSR Register. + \return APSR Register value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __get_APSR(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, apsr" : "=r" (result) ); + return(result); +} + + +/** + \brief Get xPSR Register + \details Returns the content of the xPSR Register. + + \return xPSR Register value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __get_xPSR(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, xpsr" : "=r" (result) ); + return(result); +} + + +/** + \brief Get Process Stack Pointer + \details Returns the current value of the Process Stack Pointer (PSP). + \return PSP Register value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __get_PSP(void) +{ + register uint32_t result; + + __ASM volatile ("MRS %0, psp\n" : "=r" (result) ); + return(result); +} + + +/** + \brief Set Process Stack Pointer + \details Assigns the given value to the Process Stack Pointer (PSP). + \param [in] topOfProcStack Process Stack Pointer value to set + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __set_PSP(uint32_t topOfProcStack) +{ + __ASM volatile ("MSR psp, %0\n" : : "r" (topOfProcStack) : "sp"); +} + + +/** + \brief Get Main Stack Pointer + \details Returns the current value of the Main Stack Pointer (MSP). + \return MSP Register value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __get_MSP(void) +{ + register uint32_t result; + + __ASM volatile ("MRS %0, msp\n" : "=r" (result) ); + return(result); +} + + +/** + \brief Set Main Stack Pointer + \details Assigns the given value to the Main Stack Pointer (MSP). + + \param [in] topOfMainStack Main Stack Pointer value to set + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __set_MSP(uint32_t topOfMainStack) +{ + __ASM volatile ("MSR msp, %0\n" : : "r" (topOfMainStack) : "sp"); +} + + +/** + \brief Get Priority Mask + \details Returns the current state of the priority mask bit from the Priority Mask Register. + \return Priority Mask value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __get_PRIMASK(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, primask" : "=r" (result) ); + return(result); +} + + +/** + \brief Set Priority Mask + \details Assigns the given value to the Priority Mask Register. + \param [in] priMask Priority Mask + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __set_PRIMASK(uint32_t priMask) +{ + __ASM volatile ("MSR primask, %0" : : "r" (priMask) : "memory"); +} + + +#if (__CORTEX_M >= 0x03U) + +/** + \brief Enable FIQ + \details Enables FIQ interrupts by clearing the F-bit in the CPSR. + Can only be executed in Privileged modes. + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __enable_fault_irq(void) +{ + __ASM volatile ("cpsie f" : : : "memory"); +} + + +/** + \brief Disable FIQ + \details Disables FIQ interrupts by setting the F-bit in the CPSR. + Can only be executed in Privileged modes. + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __disable_fault_irq(void) +{ + __ASM volatile ("cpsid f" : : : "memory"); +} + + +/** + \brief Get Base Priority + \details Returns the current value of the Base Priority register. + \return Base Priority register value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __get_BASEPRI(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, basepri" : "=r" (result) ); + return(result); +} + + +/** + \brief Set Base Priority + \details Assigns the given value to the Base Priority register. + \param [in] basePri Base Priority value to set + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __set_BASEPRI(uint32_t value) +{ + __ASM volatile ("MSR basepri, %0" : : "r" (value) : "memory"); +} + + +/** + \brief Set Base Priority with condition + \details Assigns the given value to the Base Priority register only if BASEPRI masking is disabled, + or the new value increases the BASEPRI priority level. + \param [in] basePri Base Priority value to set + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __set_BASEPRI_MAX(uint32_t value) +{ + __ASM volatile ("MSR basepri_max, %0" : : "r" (value) : "memory"); +} + + +/** + \brief Get Fault Mask + \details Returns the current value of the Fault Mask register. + \return Fault Mask register value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __get_FAULTMASK(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, faultmask" : "=r" (result) ); + return(result); +} + + +/** + \brief Set Fault Mask + \details Assigns the given value to the Fault Mask register. + \param [in] faultMask Fault Mask value to set + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __set_FAULTMASK(uint32_t faultMask) +{ + __ASM volatile ("MSR faultmask, %0" : : "r" (faultMask) : "memory"); +} + +#endif /* (__CORTEX_M >= 0x03U) */ + + +#if (__CORTEX_M == 0x04U) || (__CORTEX_M == 0x07U) + +/** + \brief Get FPSCR + \details Returns the current value of the Floating Point Status/Control register. + \return Floating Point Status/Control register value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __get_FPSCR(void) +{ +#if (__FPU_PRESENT == 1U) && (__FPU_USED == 1U) + uint32_t result; + + /* Empty asm statement works as a scheduling barrier */ + __ASM volatile (""); + __ASM volatile ("VMRS %0, fpscr" : "=r" (result) ); + __ASM volatile (""); + return(result); +#else + return(0); +#endif +} + + +/** + \brief Set FPSCR + \details Assigns the given value to the Floating Point Status/Control register. + \param [in] fpscr Floating Point Status/Control value to set + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __set_FPSCR(uint32_t fpscr) +{ +#if (__FPU_PRESENT == 1U) && (__FPU_USED == 1U) + /* Empty asm statement works as a scheduling barrier */ + __ASM volatile (""); + __ASM volatile ("VMSR fpscr, %0" : : "r" (fpscr) : "vfpcc"); + __ASM volatile (""); +#endif +} + +#endif /* (__CORTEX_M == 0x04U) || (__CORTEX_M == 0x07U) */ + + + +/*@} end of CMSIS_Core_RegAccFunctions */ + + +/* ########################## Core Instruction Access ######################### */ +/** \defgroup CMSIS_Core_InstructionInterface CMSIS Core Instruction Interface + Access to dedicated instructions + @{ +*/ + +/* Define macros for porting to both thumb1 and thumb2. + * For thumb1, use low register (r0-r7), specified by constraint "l" + * Otherwise, use general registers, specified by constraint "r" */ +#if defined (__thumb__) && !defined (__thumb2__) +#define __CMSIS_GCC_OUT_REG(r) "=l" (r) +#define __CMSIS_GCC_USE_REG(r) "l" (r) +#else +#define __CMSIS_GCC_OUT_REG(r) "=r" (r) +#define __CMSIS_GCC_USE_REG(r) "r" (r) +#endif + +/** + \brief No Operation + \details No Operation does nothing. This instruction can be used for code alignment purposes. + */ +__attribute__((always_inline)) __STATIC_INLINE void __NOP(void) +{ + __ASM volatile ("nop"); +} + + +/** + \brief Wait For Interrupt + \details Wait For Interrupt is a hint instruction that suspends execution until one of a number of events occurs. + */ +__attribute__((always_inline)) __STATIC_INLINE void __WFI(void) +{ + __ASM volatile ("wfi"); +} + + +/** + \brief Wait For Event + \details Wait For Event is a hint instruction that permits the processor to enter + a low-power state until one of a number of events occurs. + */ +__attribute__((always_inline)) __STATIC_INLINE void __WFE(void) +{ + __ASM volatile ("wfe"); +} + + +/** + \brief Send Event + \details Send Event is a hint instruction. It causes an event to be signaled to the CPU. + */ +__attribute__((always_inline)) __STATIC_INLINE void __SEV(void) +{ + __ASM volatile ("sev"); +} + + +/** + \brief Instruction Synchronization Barrier + \details Instruction Synchronization Barrier flushes the pipeline in the processor, + so that all instructions following the ISB are fetched from cache or memory, + after the instruction has been completed. + */ +__attribute__((always_inline)) __STATIC_INLINE void __ISB(void) +{ + __ASM volatile ("isb 0xF":::"memory"); +} + + +/** + \brief Data Synchronization Barrier + \details Acts as a special kind of Data Memory Barrier. + It completes when all explicit memory accesses before this instruction complete. + */ +__attribute__((always_inline)) __STATIC_INLINE void __DSB(void) +{ + __ASM volatile ("dsb 0xF":::"memory"); +} + + +/** + \brief Data Memory Barrier + \details Ensures the apparent order of the explicit memory operations before + and after the instruction, without ensuring their completion. + */ +__attribute__((always_inline)) __STATIC_INLINE void __DMB(void) +{ + __ASM volatile ("dmb 0xF":::"memory"); +} + + +/** + \brief Reverse byte order (32 bit) + \details Reverses the byte order in integer value. + \param [in] value Value to reverse + \return Reversed value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __REV(uint32_t value) +{ +#if (__GNUC__ > 4) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 5) + return __builtin_bswap32(value); +#else + uint32_t result; + + __ASM volatile ("rev %0, %1" : __CMSIS_GCC_OUT_REG (result) : __CMSIS_GCC_USE_REG (value) ); + return(result); +#endif +} + + +/** + \brief Reverse byte order (16 bit) + \details Reverses the byte order in two unsigned short values. + \param [in] value Value to reverse + \return Reversed value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __REV16(uint32_t value) +{ + uint32_t result; + + __ASM volatile ("rev16 %0, %1" : __CMSIS_GCC_OUT_REG (result) : __CMSIS_GCC_USE_REG (value) ); + return(result); +} + + +/** + \brief Reverse byte order in signed short value + \details Reverses the byte order in a signed short value with sign extension to integer. + \param [in] value Value to reverse + \return Reversed value + */ +__attribute__((always_inline)) __STATIC_INLINE int32_t __REVSH(int32_t value) +{ +#if (__GNUC__ > 4) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 8) + return (short)__builtin_bswap16(value); +#else + int32_t result; + + __ASM volatile ("revsh %0, %1" : __CMSIS_GCC_OUT_REG (result) : __CMSIS_GCC_USE_REG (value) ); + return(result); +#endif +} + + +/** + \brief Rotate Right in unsigned value (32 bit) + \details Rotate Right (immediate) provides the value of the contents of a register rotated by a variable number of bits. + \param [in] value Value to rotate + \param [in] value Number of Bits to rotate + \return Rotated value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __ROR(uint32_t op1, uint32_t op2) +{ + return (op1 >> op2) | (op1 << (32U - op2)); +} + + +/** + \brief Breakpoint + \details Causes the processor to enter Debug state. + Debug tools can use this to investigate system state when the instruction at a particular address is reached. + \param [in] value is ignored by the processor. + If required, a debugger can use it to store additional information about the breakpoint. + */ +#define __BKPT(value) __ASM volatile ("bkpt "#value) + + +/** + \brief Reverse bit order of value + \details Reverses the bit order of the given value. + \param [in] value Value to reverse + \return Reversed value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __RBIT(uint32_t value) +{ + uint32_t result; + +#if (__CORTEX_M >= 0x03U) || (__CORTEX_SC >= 300U) + __ASM volatile ("rbit %0, %1" : "=r" (result) : "r" (value) ); +#else + int32_t s = 4 /*sizeof(v)*/ * 8 - 1; /* extra shift needed at end */ + + result = value; /* r will be reversed bits of v; first get LSB of v */ + for (value >>= 1U; value; value >>= 1U) + { + result <<= 1U; + result |= value & 1U; + s--; + } + result <<= s; /* shift when v's highest bits are zero */ +#endif + return(result); +} + + +/** + \brief Count leading zeros + \details Counts the number of leading zeros of a data value. + \param [in] value Value to count the leading zeros + \return number of leading zeros in value + */ +#define __CLZ __builtin_clz + + +#if (__CORTEX_M >= 0x03U) || (__CORTEX_SC >= 300U) + +/** + \brief LDR Exclusive (8 bit) + \details Executes a exclusive LDR instruction for 8 bit value. + \param [in] ptr Pointer to data + \return value of type uint8_t at (*ptr) + */ +__attribute__((always_inline)) __STATIC_INLINE uint8_t __LDREXB(volatile uint8_t *addr) +{ + uint32_t result; + +#if (__GNUC__ > 4) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 8) + __ASM volatile ("ldrexb %0, %1" : "=r" (result) : "Q" (*addr) ); +#else + /* Prior to GCC 4.8, "Q" will be expanded to [rx, #0] which is not + accepted by assembler. So has to use following less efficient pattern. + */ + __ASM volatile ("ldrexb %0, [%1]" : "=r" (result) : "r" (addr) : "memory" ); +#endif + return ((uint8_t) result); /* Add explicit type cast here */ +} + + +/** + \brief LDR Exclusive (16 bit) + \details Executes a exclusive LDR instruction for 16 bit values. + \param [in] ptr Pointer to data + \return value of type uint16_t at (*ptr) + */ +__attribute__((always_inline)) __STATIC_INLINE uint16_t __LDREXH(volatile uint16_t *addr) +{ + uint32_t result; + +#if (__GNUC__ > 4) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 8) + __ASM volatile ("ldrexh %0, %1" : "=r" (result) : "Q" (*addr) ); +#else + /* Prior to GCC 4.8, "Q" will be expanded to [rx, #0] which is not + accepted by assembler. So has to use following less efficient pattern. + */ + __ASM volatile ("ldrexh %0, [%1]" : "=r" (result) : "r" (addr) : "memory" ); +#endif + return ((uint16_t) result); /* Add explicit type cast here */ +} + + +/** + \brief LDR Exclusive (32 bit) + \details Executes a exclusive LDR instruction for 32 bit values. + \param [in] ptr Pointer to data + \return value of type uint32_t at (*ptr) + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __LDREXW(volatile uint32_t *addr) +{ + uint32_t result; + + __ASM volatile ("ldrex %0, %1" : "=r" (result) : "Q" (*addr) ); + return(result); +} + + +/** + \brief STR Exclusive (8 bit) + \details Executes a exclusive STR instruction for 8 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + \return 0 Function succeeded + \return 1 Function failed + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __STREXB(uint8_t value, volatile uint8_t *addr) +{ + uint32_t result; + + __ASM volatile ("strexb %0, %2, %1" : "=&r" (result), "=Q" (*addr) : "r" ((uint32_t)value) ); + return(result); +} + + +/** + \brief STR Exclusive (16 bit) + \details Executes a exclusive STR instruction for 16 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + \return 0 Function succeeded + \return 1 Function failed + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __STREXH(uint16_t value, volatile uint16_t *addr) +{ + uint32_t result; + + __ASM volatile ("strexh %0, %2, %1" : "=&r" (result), "=Q" (*addr) : "r" ((uint32_t)value) ); + return(result); +} + + +/** + \brief STR Exclusive (32 bit) + \details Executes a exclusive STR instruction for 32 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + \return 0 Function succeeded + \return 1 Function failed + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __STREXW(uint32_t value, volatile uint32_t *addr) +{ + uint32_t result; + + __ASM volatile ("strex %0, %2, %1" : "=&r" (result), "=Q" (*addr) : "r" (value) ); + return(result); +} + + +/** + \brief Remove the exclusive lock + \details Removes the exclusive lock which is created by LDREX. + */ +__attribute__((always_inline)) __STATIC_INLINE void __CLREX(void) +{ + __ASM volatile ("clrex" ::: "memory"); +} + + +/** + \brief Signed Saturate + \details Saturates a signed value. + \param [in] value Value to be saturated + \param [in] sat Bit position to saturate to (1..32) + \return Saturated value + */ +#define __SSAT(ARG1,ARG2) \ +({ \ + uint32_t __RES, __ARG1 = (ARG1); \ + __ASM ("ssat %0, %1, %2" : "=r" (__RES) : "I" (ARG2), "r" (__ARG1) ); \ + __RES; \ + }) + + +/** + \brief Unsigned Saturate + \details Saturates an unsigned value. + \param [in] value Value to be saturated + \param [in] sat Bit position to saturate to (0..31) + \return Saturated value + */ +#define __USAT(ARG1,ARG2) \ +({ \ + uint32_t __RES, __ARG1 = (ARG1); \ + __ASM ("usat %0, %1, %2" : "=r" (__RES) : "I" (ARG2), "r" (__ARG1) ); \ + __RES; \ + }) + + +/** + \brief Rotate Right with Extend (32 bit) + \details Moves each bit of a bitstring right by one bit. + The carry input is shifted in at the left end of the bitstring. + \param [in] value Value to rotate + \return Rotated value + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __RRX(uint32_t value) +{ + uint32_t result; + + __ASM volatile ("rrx %0, %1" : __CMSIS_GCC_OUT_REG (result) : __CMSIS_GCC_USE_REG (value) ); + return(result); +} + + +/** + \brief LDRT Unprivileged (8 bit) + \details Executes a Unprivileged LDRT instruction for 8 bit value. + \param [in] ptr Pointer to data + \return value of type uint8_t at (*ptr) + */ +__attribute__((always_inline)) __STATIC_INLINE uint8_t __LDRBT(volatile uint8_t *addr) +{ + uint32_t result; + +#if (__GNUC__ > 4) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 8) + __ASM volatile ("ldrbt %0, %1" : "=r" (result) : "Q" (*addr) ); +#else + /* Prior to GCC 4.8, "Q" will be expanded to [rx, #0] which is not + accepted by assembler. So has to use following less efficient pattern. + */ + __ASM volatile ("ldrbt %0, [%1]" : "=r" (result) : "r" (addr) : "memory" ); +#endif + return ((uint8_t) result); /* Add explicit type cast here */ +} + + +/** + \brief LDRT Unprivileged (16 bit) + \details Executes a Unprivileged LDRT instruction for 16 bit values. + \param [in] ptr Pointer to data + \return value of type uint16_t at (*ptr) + */ +__attribute__((always_inline)) __STATIC_INLINE uint16_t __LDRHT(volatile uint16_t *addr) +{ + uint32_t result; + +#if (__GNUC__ > 4) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 8) + __ASM volatile ("ldrht %0, %1" : "=r" (result) : "Q" (*addr) ); +#else + /* Prior to GCC 4.8, "Q" will be expanded to [rx, #0] which is not + accepted by assembler. So has to use following less efficient pattern. + */ + __ASM volatile ("ldrht %0, [%1]" : "=r" (result) : "r" (addr) : "memory" ); +#endif + return ((uint16_t) result); /* Add explicit type cast here */ +} + + +/** + \brief LDRT Unprivileged (32 bit) + \details Executes a Unprivileged LDRT instruction for 32 bit values. + \param [in] ptr Pointer to data + \return value of type uint32_t at (*ptr) + */ +__attribute__((always_inline)) __STATIC_INLINE uint32_t __LDRT(volatile uint32_t *addr) +{ + uint32_t result; + + __ASM volatile ("ldrt %0, %1" : "=r" (result) : "Q" (*addr) ); + return(result); +} + + +/** + \brief STRT Unprivileged (8 bit) + \details Executes a Unprivileged STRT instruction for 8 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + */ +__attribute__((always_inline)) __STATIC_INLINE void __STRBT(uint8_t value, volatile uint8_t *addr) +{ + __ASM volatile ("strbt %1, %0" : "=Q" (*addr) : "r" ((uint32_t)value) ); +} + + +/** + \brief STRT Unprivileged (16 bit) + \details Executes a Unprivileged STRT instruction for 16 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + */ +__attribute__((always_inline)) __STATIC_INLINE void __STRHT(uint16_t value, volatile uint16_t *addr) +{ + __ASM volatile ("strht %1, %0" : "=Q" (*addr) : "r" ((uint32_t)value) ); +} + + +/** + \brief STRT Unprivileged (32 bit) + \details Executes a Unprivileged STRT instruction for 32 bit values. + \param [in] value Value to store + \param [in] ptr Pointer to location + */ +__attribute__((always_inline)) __STATIC_INLINE void __STRT(uint32_t value, volatile uint32_t *addr) +{ + __ASM volatile ("strt %1, %0" : "=Q" (*addr) : "r" (value) ); +} + +#endif /* (__CORTEX_M >= 0x03U) || (__CORTEX_SC >= 300U) */ + +/*@}*/ /* end of group CMSIS_Core_InstructionInterface */ + + +/* ################### Compiler specific Intrinsics ########################### */ +/** \defgroup CMSIS_SIMD_intrinsics CMSIS SIMD Intrinsics + Access to dedicated SIMD instructions + @{ +*/ + +#if (__CORTEX_M >= 0x04U) /* only for Cortex-M4 and above */ + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SADD8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("sadd8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __QADD8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("qadd8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SHADD8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("shadd8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UADD8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uadd8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UQADD8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uqadd8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UHADD8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uhadd8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SSUB8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("ssub8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __QSUB8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("qsub8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SHSUB8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("shsub8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __USUB8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("usub8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UQSUB8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uqsub8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UHSUB8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uhsub8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SADD16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("sadd16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __QADD16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("qadd16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SHADD16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("shadd16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UADD16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uadd16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UQADD16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uqadd16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UHADD16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uhadd16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SSUB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("ssub16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __QSUB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("qsub16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SHSUB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("shsub16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __USUB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("usub16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UQSUB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uqsub16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UHSUB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uhsub16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SASX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("sasx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __QASX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("qasx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SHASX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("shasx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UASX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uasx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UQASX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uqasx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UHASX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uhasx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SSAX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("ssax %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __QSAX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("qsax %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SHSAX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("shsax %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __USAX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("usax %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UQSAX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uqsax %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UHSAX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uhsax %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __USAD8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("usad8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __USADA8(uint32_t op1, uint32_t op2, uint32_t op3) +{ + uint32_t result; + + __ASM volatile ("usada8 %0, %1, %2, %3" : "=r" (result) : "r" (op1), "r" (op2), "r" (op3) ); + return(result); +} + +#define __SSAT16(ARG1,ARG2) \ +({ \ + int32_t __RES, __ARG1 = (ARG1); \ + __ASM ("ssat16 %0, %1, %2" : "=r" (__RES) : "I" (ARG2), "r" (__ARG1) ); \ + __RES; \ + }) + +#define __USAT16(ARG1,ARG2) \ +({ \ + uint32_t __RES, __ARG1 = (ARG1); \ + __ASM ("usat16 %0, %1, %2" : "=r" (__RES) : "I" (ARG2), "r" (__ARG1) ); \ + __RES; \ + }) + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UXTB16(uint32_t op1) +{ + uint32_t result; + + __ASM volatile ("uxtb16 %0, %1" : "=r" (result) : "r" (op1)); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UXTAB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uxtab16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SXTB16(uint32_t op1) +{ + uint32_t result; + + __ASM volatile ("sxtb16 %0, %1" : "=r" (result) : "r" (op1)); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SXTAB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("sxtab16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SMUAD (uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("smuad %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SMUADX (uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("smuadx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SMLAD (uint32_t op1, uint32_t op2, uint32_t op3) +{ + uint32_t result; + + __ASM volatile ("smlad %0, %1, %2, %3" : "=r" (result) : "r" (op1), "r" (op2), "r" (op3) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SMLADX (uint32_t op1, uint32_t op2, uint32_t op3) +{ + uint32_t result; + + __ASM volatile ("smladx %0, %1, %2, %3" : "=r" (result) : "r" (op1), "r" (op2), "r" (op3) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint64_t __SMLALD (uint32_t op1, uint32_t op2, uint64_t acc) +{ + union llreg_u{ + uint32_t w32[2]; + uint64_t w64; + } llr; + llr.w64 = acc; + +#ifndef __ARMEB__ /* Little endian */ + __ASM volatile ("smlald %0, %1, %2, %3" : "=r" (llr.w32[0]), "=r" (llr.w32[1]): "r" (op1), "r" (op2) , "0" (llr.w32[0]), "1" (llr.w32[1]) ); +#else /* Big endian */ + __ASM volatile ("smlald %0, %1, %2, %3" : "=r" (llr.w32[1]), "=r" (llr.w32[0]): "r" (op1), "r" (op2) , "0" (llr.w32[1]), "1" (llr.w32[0]) ); +#endif + + return(llr.w64); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint64_t __SMLALDX (uint32_t op1, uint32_t op2, uint64_t acc) +{ + union llreg_u{ + uint32_t w32[2]; + uint64_t w64; + } llr; + llr.w64 = acc; + +#ifndef __ARMEB__ /* Little endian */ + __ASM volatile ("smlaldx %0, %1, %2, %3" : "=r" (llr.w32[0]), "=r" (llr.w32[1]): "r" (op1), "r" (op2) , "0" (llr.w32[0]), "1" (llr.w32[1]) ); +#else /* Big endian */ + __ASM volatile ("smlaldx %0, %1, %2, %3" : "=r" (llr.w32[1]), "=r" (llr.w32[0]): "r" (op1), "r" (op2) , "0" (llr.w32[1]), "1" (llr.w32[0]) ); +#endif + + return(llr.w64); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SMUSD (uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("smusd %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SMUSDX (uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("smusdx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SMLSD (uint32_t op1, uint32_t op2, uint32_t op3) +{ + uint32_t result; + + __ASM volatile ("smlsd %0, %1, %2, %3" : "=r" (result) : "r" (op1), "r" (op2), "r" (op3) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SMLSDX (uint32_t op1, uint32_t op2, uint32_t op3) +{ + uint32_t result; + + __ASM volatile ("smlsdx %0, %1, %2, %3" : "=r" (result) : "r" (op1), "r" (op2), "r" (op3) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint64_t __SMLSLD (uint32_t op1, uint32_t op2, uint64_t acc) +{ + union llreg_u{ + uint32_t w32[2]; + uint64_t w64; + } llr; + llr.w64 = acc; + +#ifndef __ARMEB__ /* Little endian */ + __ASM volatile ("smlsld %0, %1, %2, %3" : "=r" (llr.w32[0]), "=r" (llr.w32[1]): "r" (op1), "r" (op2) , "0" (llr.w32[0]), "1" (llr.w32[1]) ); +#else /* Big endian */ + __ASM volatile ("smlsld %0, %1, %2, %3" : "=r" (llr.w32[1]), "=r" (llr.w32[0]): "r" (op1), "r" (op2) , "0" (llr.w32[1]), "1" (llr.w32[0]) ); +#endif + + return(llr.w64); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint64_t __SMLSLDX (uint32_t op1, uint32_t op2, uint64_t acc) +{ + union llreg_u{ + uint32_t w32[2]; + uint64_t w64; + } llr; + llr.w64 = acc; + +#ifndef __ARMEB__ /* Little endian */ + __ASM volatile ("smlsldx %0, %1, %2, %3" : "=r" (llr.w32[0]), "=r" (llr.w32[1]): "r" (op1), "r" (op2) , "0" (llr.w32[0]), "1" (llr.w32[1]) ); +#else /* Big endian */ + __ASM volatile ("smlsldx %0, %1, %2, %3" : "=r" (llr.w32[1]), "=r" (llr.w32[0]): "r" (op1), "r" (op2) , "0" (llr.w32[1]), "1" (llr.w32[0]) ); +#endif + + return(llr.w64); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SEL (uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("sel %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE int32_t __QADD( int32_t op1, int32_t op2) +{ + int32_t result; + + __ASM volatile ("qadd %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE int32_t __QSUB( int32_t op1, int32_t op2) +{ + int32_t result; + + __ASM volatile ("qsub %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +#define __PKHBT(ARG1,ARG2,ARG3) \ +({ \ + uint32_t __RES, __ARG1 = (ARG1), __ARG2 = (ARG2); \ + __ASM ("pkhbt %0, %1, %2, lsl %3" : "=r" (__RES) : "r" (__ARG1), "r" (__ARG2), "I" (ARG3) ); \ + __RES; \ + }) + +#define __PKHTB(ARG1,ARG2,ARG3) \ +({ \ + uint32_t __RES, __ARG1 = (ARG1), __ARG2 = (ARG2); \ + if (ARG3 == 0) \ + __ASM ("pkhtb %0, %1, %2" : "=r" (__RES) : "r" (__ARG1), "r" (__ARG2) ); \ + else \ + __ASM ("pkhtb %0, %1, %2, asr %3" : "=r" (__RES) : "r" (__ARG1), "r" (__ARG2), "I" (ARG3) ); \ + __RES; \ + }) + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SMMLA (int32_t op1, int32_t op2, int32_t op3) +{ + int32_t result; + + __ASM volatile ("smmla %0, %1, %2, %3" : "=r" (result): "r" (op1), "r" (op2), "r" (op3) ); + return(result); +} + +#endif /* (__CORTEX_M >= 0x04) */ +/*@} end of group CMSIS_SIMD_intrinsics */ + + +#if defined ( __GNUC__ ) +#pragma GCC diagnostic pop +#endif + +#endif /* __CMSIS_GCC_H */ diff --git a/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cm0.h b/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cm0.h new file mode 100644 index 00000000000..711dad55170 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cm0.h @@ -0,0 +1,798 @@ +/**************************************************************************//** + * @file core_cm0.h + * @brief CMSIS Cortex-M0 Core Peripheral Access Layer Header File + * @version V4.30 + * @date 20. October 2015 + ******************************************************************************/ +/* Copyright (c) 2009 - 2015 ARM LIMITED + + All rights reserved. + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are met: + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + - Neither the name of ARM nor the names of its contributors may be used + to endorse or promote products derived from this software without + specific prior written permission. + * + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE + LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + ---------------------------------------------------------------------------*/ + + +#if defined ( __ICCARM__ ) + #pragma system_include /* treat file as system include file for MISRA check */ +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #pragma clang system_header /* treat file as system include file */ +#endif + +#ifndef __CORE_CM0_H_GENERIC +#define __CORE_CM0_H_GENERIC + +#include + +#ifdef __cplusplus + extern "C" { +#endif + +/** + \page CMSIS_MISRA_Exceptions MISRA-C:2004 Compliance Exceptions + CMSIS violates the following MISRA-C:2004 rules: + + \li Required Rule 8.5, object/function definition in header file.
+ Function definitions in header files are used to allow 'inlining'. + + \li Required Rule 18.4, declaration of union type or object of union type: '{...}'.
+ Unions are used for effective representation of core registers. + + \li Advisory Rule 19.7, Function-like macro defined.
+ Function-like macros are used to allow more efficient code. + */ + + +/******************************************************************************* + * CMSIS definitions + ******************************************************************************/ +/** + \ingroup Cortex_M0 + @{ + */ + +/* CMSIS CM0 definitions */ +#define __CM0_CMSIS_VERSION_MAIN (0x04U) /*!< [31:16] CMSIS HAL main version */ +#define __CM0_CMSIS_VERSION_SUB (0x1EU) /*!< [15:0] CMSIS HAL sub version */ +#define __CM0_CMSIS_VERSION ((__CM0_CMSIS_VERSION_MAIN << 16U) | \ + __CM0_CMSIS_VERSION_SUB ) /*!< CMSIS HAL version number */ + +#define __CORTEX_M (0x00U) /*!< Cortex-M Core */ + + +#if defined ( __CC_ARM ) + #define __ASM __asm /*!< asm keyword for ARM Compiler */ + #define __INLINE __inline /*!< inline keyword for ARM Compiler */ + #define __STATIC_INLINE static __inline + +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #define __ASM __asm /*!< asm keyword for ARM Compiler */ + #define __INLINE __inline /*!< inline keyword for ARM Compiler */ + #define __STATIC_INLINE static __inline + +#elif defined ( __GNUC__ ) + #define __ASM __asm /*!< asm keyword for GNU Compiler */ + #define __INLINE inline /*!< inline keyword for GNU Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __ICCARM__ ) + #define __ASM __asm /*!< asm keyword for IAR Compiler */ + #define __INLINE inline /*!< inline keyword for IAR Compiler. Only available in High optimization mode! */ + #define __STATIC_INLINE static inline + +#elif defined ( __TMS470__ ) + #define __ASM __asm /*!< asm keyword for TI CCS Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __TASKING__ ) + #define __ASM __asm /*!< asm keyword for TASKING Compiler */ + #define __INLINE inline /*!< inline keyword for TASKING Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __CSMC__ ) + #define __packed + #define __ASM _asm /*!< asm keyword for COSMIC Compiler */ + #define __INLINE inline /*!< inline keyword for COSMIC Compiler. Use -pc99 on compile line */ + #define __STATIC_INLINE static inline + +#else + #error Unknown compiler +#endif + +/** __FPU_USED indicates whether an FPU is used or not. + This core does not support an FPU at all +*/ +#define __FPU_USED 0U + +#if defined ( __CC_ARM ) + #if defined __TARGET_FPU_VFP + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #if defined __ARM_PCS_VFP + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __GNUC__ ) + #if defined (__VFP_FP__) && !defined(__SOFTFP__) + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __ICCARM__ ) + #if defined __ARMVFP__ + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __TMS470__ ) + #if defined __TI_VFP_SUPPORT__ + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __TASKING__ ) + #if defined __FPU_VFP__ + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __CSMC__ ) + #if ( __CSMC__ & 0x400U) + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#endif + +#include "core_cmInstr.h" /* Core Instruction Access */ +#include "core_cmFunc.h" /* Core Function Access */ + +#ifdef __cplusplus +} +#endif + +#endif /* __CORE_CM0_H_GENERIC */ + +#ifndef __CMSIS_GENERIC + +#ifndef __CORE_CM0_H_DEPENDANT +#define __CORE_CM0_H_DEPENDANT + +#ifdef __cplusplus + extern "C" { +#endif + +/* check device defines and use defaults */ +#if defined __CHECK_DEVICE_DEFINES + #ifndef __CM0_REV + #define __CM0_REV 0x0000U + #warning "__CM0_REV not defined in device header file; using default!" + #endif + + #ifndef __NVIC_PRIO_BITS + #define __NVIC_PRIO_BITS 2U + #warning "__NVIC_PRIO_BITS not defined in device header file; using default!" + #endif + + #ifndef __Vendor_SysTickConfig + #define __Vendor_SysTickConfig 0U + #warning "__Vendor_SysTickConfig not defined in device header file; using default!" + #endif +#endif + +/* IO definitions (access restrictions to peripheral registers) */ +/** + \defgroup CMSIS_glob_defs CMSIS Global Defines + + IO Type Qualifiers are used + \li to specify the access to peripheral variables. + \li for automatic generation of peripheral register debug information. +*/ +#ifdef __cplusplus + #define __I volatile /*!< Defines 'read only' permissions */ +#else + #define __I volatile const /*!< Defines 'read only' permissions */ +#endif +#define __O volatile /*!< Defines 'write only' permissions */ +#define __IO volatile /*!< Defines 'read / write' permissions */ + +/* following defines should be used for structure members */ +#define __IM volatile const /*! Defines 'read only' structure member permissions */ +#define __OM volatile /*! Defines 'write only' structure member permissions */ +#define __IOM volatile /*! Defines 'read / write' structure member permissions */ + +/*@} end of group Cortex_M0 */ + + + +/******************************************************************************* + * Register Abstraction + Core Register contain: + - Core Register + - Core NVIC Register + - Core SCB Register + - Core SysTick Register + ******************************************************************************/ +/** + \defgroup CMSIS_core_register Defines and Type Definitions + \brief Type definitions and defines for Cortex-M processor based devices. +*/ + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_CORE Status and Control Registers + \brief Core Register type definitions. + @{ + */ + +/** + \brief Union type to access the Application Program Status Register (APSR). + */ +typedef union +{ + struct + { + uint32_t _reserved0:28; /*!< bit: 0..27 Reserved */ + uint32_t V:1; /*!< bit: 28 Overflow condition code flag */ + uint32_t C:1; /*!< bit: 29 Carry condition code flag */ + uint32_t Z:1; /*!< bit: 30 Zero condition code flag */ + uint32_t N:1; /*!< bit: 31 Negative condition code flag */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} APSR_Type; + +/* APSR Register Definitions */ +#define APSR_N_Pos 31U /*!< APSR: N Position */ +#define APSR_N_Msk (1UL << APSR_N_Pos) /*!< APSR: N Mask */ + +#define APSR_Z_Pos 30U /*!< APSR: Z Position */ +#define APSR_Z_Msk (1UL << APSR_Z_Pos) /*!< APSR: Z Mask */ + +#define APSR_C_Pos 29U /*!< APSR: C Position */ +#define APSR_C_Msk (1UL << APSR_C_Pos) /*!< APSR: C Mask */ + +#define APSR_V_Pos 28U /*!< APSR: V Position */ +#define APSR_V_Msk (1UL << APSR_V_Pos) /*!< APSR: V Mask */ + + +/** + \brief Union type to access the Interrupt Program Status Register (IPSR). + */ +typedef union +{ + struct + { + uint32_t ISR:9; /*!< bit: 0.. 8 Exception number */ + uint32_t _reserved0:23; /*!< bit: 9..31 Reserved */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} IPSR_Type; + +/* IPSR Register Definitions */ +#define IPSR_ISR_Pos 0U /*!< IPSR: ISR Position */ +#define IPSR_ISR_Msk (0x1FFUL /*<< IPSR_ISR_Pos*/) /*!< IPSR: ISR Mask */ + + +/** + \brief Union type to access the Special-Purpose Program Status Registers (xPSR). + */ +typedef union +{ + struct + { + uint32_t ISR:9; /*!< bit: 0.. 8 Exception number */ + uint32_t _reserved0:15; /*!< bit: 9..23 Reserved */ + uint32_t T:1; /*!< bit: 24 Thumb bit (read 0) */ + uint32_t _reserved1:3; /*!< bit: 25..27 Reserved */ + uint32_t V:1; /*!< bit: 28 Overflow condition code flag */ + uint32_t C:1; /*!< bit: 29 Carry condition code flag */ + uint32_t Z:1; /*!< bit: 30 Zero condition code flag */ + uint32_t N:1; /*!< bit: 31 Negative condition code flag */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} xPSR_Type; + +/* xPSR Register Definitions */ +#define xPSR_N_Pos 31U /*!< xPSR: N Position */ +#define xPSR_N_Msk (1UL << xPSR_N_Pos) /*!< xPSR: N Mask */ + +#define xPSR_Z_Pos 30U /*!< xPSR: Z Position */ +#define xPSR_Z_Msk (1UL << xPSR_Z_Pos) /*!< xPSR: Z Mask */ + +#define xPSR_C_Pos 29U /*!< xPSR: C Position */ +#define xPSR_C_Msk (1UL << xPSR_C_Pos) /*!< xPSR: C Mask */ + +#define xPSR_V_Pos 28U /*!< xPSR: V Position */ +#define xPSR_V_Msk (1UL << xPSR_V_Pos) /*!< xPSR: V Mask */ + +#define xPSR_T_Pos 24U /*!< xPSR: T Position */ +#define xPSR_T_Msk (1UL << xPSR_T_Pos) /*!< xPSR: T Mask */ + +#define xPSR_ISR_Pos 0U /*!< xPSR: ISR Position */ +#define xPSR_ISR_Msk (0x1FFUL /*<< xPSR_ISR_Pos*/) /*!< xPSR: ISR Mask */ + + +/** + \brief Union type to access the Control Registers (CONTROL). + */ +typedef union +{ + struct + { + uint32_t _reserved0:1; /*!< bit: 0 Reserved */ + uint32_t SPSEL:1; /*!< bit: 1 Stack to be used */ + uint32_t _reserved1:30; /*!< bit: 2..31 Reserved */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} CONTROL_Type; + +/* CONTROL Register Definitions */ +#define CONTROL_SPSEL_Pos 1U /*!< CONTROL: SPSEL Position */ +#define CONTROL_SPSEL_Msk (1UL << CONTROL_SPSEL_Pos) /*!< CONTROL: SPSEL Mask */ + +/*@} end of group CMSIS_CORE */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_NVIC Nested Vectored Interrupt Controller (NVIC) + \brief Type definitions for the NVIC Registers + @{ + */ + +/** + \brief Structure type to access the Nested Vectored Interrupt Controller (NVIC). + */ +typedef struct +{ + __IOM uint32_t ISER[1U]; /*!< Offset: 0x000 (R/W) Interrupt Set Enable Register */ + uint32_t RESERVED0[31U]; + __IOM uint32_t ICER[1U]; /*!< Offset: 0x080 (R/W) Interrupt Clear Enable Register */ + uint32_t RSERVED1[31U]; + __IOM uint32_t ISPR[1U]; /*!< Offset: 0x100 (R/W) Interrupt Set Pending Register */ + uint32_t RESERVED2[31U]; + __IOM uint32_t ICPR[1U]; /*!< Offset: 0x180 (R/W) Interrupt Clear Pending Register */ + uint32_t RESERVED3[31U]; + uint32_t RESERVED4[64U]; + __IOM uint32_t IP[8U]; /*!< Offset: 0x300 (R/W) Interrupt Priority Register */ +} NVIC_Type; + +/*@} end of group CMSIS_NVIC */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_SCB System Control Block (SCB) + \brief Type definitions for the System Control Block Registers + @{ + */ + +/** + \brief Structure type to access the System Control Block (SCB). + */ +typedef struct +{ + __IM uint32_t CPUID; /*!< Offset: 0x000 (R/ ) CPUID Base Register */ + __IOM uint32_t ICSR; /*!< Offset: 0x004 (R/W) Interrupt Control and State Register */ + uint32_t RESERVED0; + __IOM uint32_t AIRCR; /*!< Offset: 0x00C (R/W) Application Interrupt and Reset Control Register */ + __IOM uint32_t SCR; /*!< Offset: 0x010 (R/W) System Control Register */ + __IOM uint32_t CCR; /*!< Offset: 0x014 (R/W) Configuration Control Register */ + uint32_t RESERVED1; + __IOM uint32_t SHP[2U]; /*!< Offset: 0x01C (R/W) System Handlers Priority Registers. [0] is RESERVED */ + __IOM uint32_t SHCSR; /*!< Offset: 0x024 (R/W) System Handler Control and State Register */ +} SCB_Type; + +/* SCB CPUID Register Definitions */ +#define SCB_CPUID_IMPLEMENTER_Pos 24U /*!< SCB CPUID: IMPLEMENTER Position */ +#define SCB_CPUID_IMPLEMENTER_Msk (0xFFUL << SCB_CPUID_IMPLEMENTER_Pos) /*!< SCB CPUID: IMPLEMENTER Mask */ + +#define SCB_CPUID_VARIANT_Pos 20U /*!< SCB CPUID: VARIANT Position */ +#define SCB_CPUID_VARIANT_Msk (0xFUL << SCB_CPUID_VARIANT_Pos) /*!< SCB CPUID: VARIANT Mask */ + +#define SCB_CPUID_ARCHITECTURE_Pos 16U /*!< SCB CPUID: ARCHITECTURE Position */ +#define SCB_CPUID_ARCHITECTURE_Msk (0xFUL << SCB_CPUID_ARCHITECTURE_Pos) /*!< SCB CPUID: ARCHITECTURE Mask */ + +#define SCB_CPUID_PARTNO_Pos 4U /*!< SCB CPUID: PARTNO Position */ +#define SCB_CPUID_PARTNO_Msk (0xFFFUL << SCB_CPUID_PARTNO_Pos) /*!< SCB CPUID: PARTNO Mask */ + +#define SCB_CPUID_REVISION_Pos 0U /*!< SCB CPUID: REVISION Position */ +#define SCB_CPUID_REVISION_Msk (0xFUL /*<< SCB_CPUID_REVISION_Pos*/) /*!< SCB CPUID: REVISION Mask */ + +/* SCB Interrupt Control State Register Definitions */ +#define SCB_ICSR_NMIPENDSET_Pos 31U /*!< SCB ICSR: NMIPENDSET Position */ +#define SCB_ICSR_NMIPENDSET_Msk (1UL << SCB_ICSR_NMIPENDSET_Pos) /*!< SCB ICSR: NMIPENDSET Mask */ + +#define SCB_ICSR_PENDSVSET_Pos 28U /*!< SCB ICSR: PENDSVSET Position */ +#define SCB_ICSR_PENDSVSET_Msk (1UL << SCB_ICSR_PENDSVSET_Pos) /*!< SCB ICSR: PENDSVSET Mask */ + +#define SCB_ICSR_PENDSVCLR_Pos 27U /*!< SCB ICSR: PENDSVCLR Position */ +#define SCB_ICSR_PENDSVCLR_Msk (1UL << SCB_ICSR_PENDSVCLR_Pos) /*!< SCB ICSR: PENDSVCLR Mask */ + +#define SCB_ICSR_PENDSTSET_Pos 26U /*!< SCB ICSR: PENDSTSET Position */ +#define SCB_ICSR_PENDSTSET_Msk (1UL << SCB_ICSR_PENDSTSET_Pos) /*!< SCB ICSR: PENDSTSET Mask */ + +#define SCB_ICSR_PENDSTCLR_Pos 25U /*!< SCB ICSR: PENDSTCLR Position */ +#define SCB_ICSR_PENDSTCLR_Msk (1UL << SCB_ICSR_PENDSTCLR_Pos) /*!< SCB ICSR: PENDSTCLR Mask */ + +#define SCB_ICSR_ISRPREEMPT_Pos 23U /*!< SCB ICSR: ISRPREEMPT Position */ +#define SCB_ICSR_ISRPREEMPT_Msk (1UL << SCB_ICSR_ISRPREEMPT_Pos) /*!< SCB ICSR: ISRPREEMPT Mask */ + +#define SCB_ICSR_ISRPENDING_Pos 22U /*!< SCB ICSR: ISRPENDING Position */ +#define SCB_ICSR_ISRPENDING_Msk (1UL << SCB_ICSR_ISRPENDING_Pos) /*!< SCB ICSR: ISRPENDING Mask */ + +#define SCB_ICSR_VECTPENDING_Pos 12U /*!< SCB ICSR: VECTPENDING Position */ +#define SCB_ICSR_VECTPENDING_Msk (0x1FFUL << SCB_ICSR_VECTPENDING_Pos) /*!< SCB ICSR: VECTPENDING Mask */ + +#define SCB_ICSR_VECTACTIVE_Pos 0U /*!< SCB ICSR: VECTACTIVE Position */ +#define SCB_ICSR_VECTACTIVE_Msk (0x1FFUL /*<< SCB_ICSR_VECTACTIVE_Pos*/) /*!< SCB ICSR: VECTACTIVE Mask */ + +/* SCB Application Interrupt and Reset Control Register Definitions */ +#define SCB_AIRCR_VECTKEY_Pos 16U /*!< SCB AIRCR: VECTKEY Position */ +#define SCB_AIRCR_VECTKEY_Msk (0xFFFFUL << SCB_AIRCR_VECTKEY_Pos) /*!< SCB AIRCR: VECTKEY Mask */ + +#define SCB_AIRCR_VECTKEYSTAT_Pos 16U /*!< SCB AIRCR: VECTKEYSTAT Position */ +#define SCB_AIRCR_VECTKEYSTAT_Msk (0xFFFFUL << SCB_AIRCR_VECTKEYSTAT_Pos) /*!< SCB AIRCR: VECTKEYSTAT Mask */ + +#define SCB_AIRCR_ENDIANESS_Pos 15U /*!< SCB AIRCR: ENDIANESS Position */ +#define SCB_AIRCR_ENDIANESS_Msk (1UL << SCB_AIRCR_ENDIANESS_Pos) /*!< SCB AIRCR: ENDIANESS Mask */ + +#define SCB_AIRCR_SYSRESETREQ_Pos 2U /*!< SCB AIRCR: SYSRESETREQ Position */ +#define SCB_AIRCR_SYSRESETREQ_Msk (1UL << SCB_AIRCR_SYSRESETREQ_Pos) /*!< SCB AIRCR: SYSRESETREQ Mask */ + +#define SCB_AIRCR_VECTCLRACTIVE_Pos 1U /*!< SCB AIRCR: VECTCLRACTIVE Position */ +#define SCB_AIRCR_VECTCLRACTIVE_Msk (1UL << SCB_AIRCR_VECTCLRACTIVE_Pos) /*!< SCB AIRCR: VECTCLRACTIVE Mask */ + +/* SCB System Control Register Definitions */ +#define SCB_SCR_SEVONPEND_Pos 4U /*!< SCB SCR: SEVONPEND Position */ +#define SCB_SCR_SEVONPEND_Msk (1UL << SCB_SCR_SEVONPEND_Pos) /*!< SCB SCR: SEVONPEND Mask */ + +#define SCB_SCR_SLEEPDEEP_Pos 2U /*!< SCB SCR: SLEEPDEEP Position */ +#define SCB_SCR_SLEEPDEEP_Msk (1UL << SCB_SCR_SLEEPDEEP_Pos) /*!< SCB SCR: SLEEPDEEP Mask */ + +#define SCB_SCR_SLEEPONEXIT_Pos 1U /*!< SCB SCR: SLEEPONEXIT Position */ +#define SCB_SCR_SLEEPONEXIT_Msk (1UL << SCB_SCR_SLEEPONEXIT_Pos) /*!< SCB SCR: SLEEPONEXIT Mask */ + +/* SCB Configuration Control Register Definitions */ +#define SCB_CCR_STKALIGN_Pos 9U /*!< SCB CCR: STKALIGN Position */ +#define SCB_CCR_STKALIGN_Msk (1UL << SCB_CCR_STKALIGN_Pos) /*!< SCB CCR: STKALIGN Mask */ + +#define SCB_CCR_UNALIGN_TRP_Pos 3U /*!< SCB CCR: UNALIGN_TRP Position */ +#define SCB_CCR_UNALIGN_TRP_Msk (1UL << SCB_CCR_UNALIGN_TRP_Pos) /*!< SCB CCR: UNALIGN_TRP Mask */ + +/* SCB System Handler Control and State Register Definitions */ +#define SCB_SHCSR_SVCALLPENDED_Pos 15U /*!< SCB SHCSR: SVCALLPENDED Position */ +#define SCB_SHCSR_SVCALLPENDED_Msk (1UL << SCB_SHCSR_SVCALLPENDED_Pos) /*!< SCB SHCSR: SVCALLPENDED Mask */ + +/*@} end of group CMSIS_SCB */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_SysTick System Tick Timer (SysTick) + \brief Type definitions for the System Timer Registers. + @{ + */ + +/** + \brief Structure type to access the System Timer (SysTick). + */ +typedef struct +{ + __IOM uint32_t CTRL; /*!< Offset: 0x000 (R/W) SysTick Control and Status Register */ + __IOM uint32_t LOAD; /*!< Offset: 0x004 (R/W) SysTick Reload Value Register */ + __IOM uint32_t VAL; /*!< Offset: 0x008 (R/W) SysTick Current Value Register */ + __IM uint32_t CALIB; /*!< Offset: 0x00C (R/ ) SysTick Calibration Register */ +} SysTick_Type; + +/* SysTick Control / Status Register Definitions */ +#define SysTick_CTRL_COUNTFLAG_Pos 16U /*!< SysTick CTRL: COUNTFLAG Position */ +#define SysTick_CTRL_COUNTFLAG_Msk (1UL << SysTick_CTRL_COUNTFLAG_Pos) /*!< SysTick CTRL: COUNTFLAG Mask */ + +#define SysTick_CTRL_CLKSOURCE_Pos 2U /*!< SysTick CTRL: CLKSOURCE Position */ +#define SysTick_CTRL_CLKSOURCE_Msk (1UL << SysTick_CTRL_CLKSOURCE_Pos) /*!< SysTick CTRL: CLKSOURCE Mask */ + +#define SysTick_CTRL_TICKINT_Pos 1U /*!< SysTick CTRL: TICKINT Position */ +#define SysTick_CTRL_TICKINT_Msk (1UL << SysTick_CTRL_TICKINT_Pos) /*!< SysTick CTRL: TICKINT Mask */ + +#define SysTick_CTRL_ENABLE_Pos 0U /*!< SysTick CTRL: ENABLE Position */ +#define SysTick_CTRL_ENABLE_Msk (1UL /*<< SysTick_CTRL_ENABLE_Pos*/) /*!< SysTick CTRL: ENABLE Mask */ + +/* SysTick Reload Register Definitions */ +#define SysTick_LOAD_RELOAD_Pos 0U /*!< SysTick LOAD: RELOAD Position */ +#define SysTick_LOAD_RELOAD_Msk (0xFFFFFFUL /*<< SysTick_LOAD_RELOAD_Pos*/) /*!< SysTick LOAD: RELOAD Mask */ + +/* SysTick Current Register Definitions */ +#define SysTick_VAL_CURRENT_Pos 0U /*!< SysTick VAL: CURRENT Position */ +#define SysTick_VAL_CURRENT_Msk (0xFFFFFFUL /*<< SysTick_VAL_CURRENT_Pos*/) /*!< SysTick VAL: CURRENT Mask */ + +/* SysTick Calibration Register Definitions */ +#define SysTick_CALIB_NOREF_Pos 31U /*!< SysTick CALIB: NOREF Position */ +#define SysTick_CALIB_NOREF_Msk (1UL << SysTick_CALIB_NOREF_Pos) /*!< SysTick CALIB: NOREF Mask */ + +#define SysTick_CALIB_SKEW_Pos 30U /*!< SysTick CALIB: SKEW Position */ +#define SysTick_CALIB_SKEW_Msk (1UL << SysTick_CALIB_SKEW_Pos) /*!< SysTick CALIB: SKEW Mask */ + +#define SysTick_CALIB_TENMS_Pos 0U /*!< SysTick CALIB: TENMS Position */ +#define SysTick_CALIB_TENMS_Msk (0xFFFFFFUL /*<< SysTick_CALIB_TENMS_Pos*/) /*!< SysTick CALIB: TENMS Mask */ + +/*@} end of group CMSIS_SysTick */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_CoreDebug Core Debug Registers (CoreDebug) + \brief Cortex-M0 Core Debug Registers (DCB registers, SHCSR, and DFSR) are only accessible over DAP and not via processor. + Therefore they are not covered by the Cortex-M0 header file. + @{ + */ +/*@} end of group CMSIS_CoreDebug */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_core_bitfield Core register bit field macros + \brief Macros for use with bit field definitions (xxx_Pos, xxx_Msk). + @{ + */ + +/** + \brief Mask and shift a bit field value for use in a register bit range. + \param[in] field Name of the register bit field. + \param[in] value Value of the bit field. + \return Masked and shifted value. +*/ +#define _VAL2FLD(field, value) ((value << field ## _Pos) & field ## _Msk) + +/** + \brief Mask and shift a register value to extract a bit filed value. + \param[in] field Name of the register bit field. + \param[in] value Value of register. + \return Masked and shifted bit field value. +*/ +#define _FLD2VAL(field, value) ((value & field ## _Msk) >> field ## _Pos) + +/*@} end of group CMSIS_core_bitfield */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_core_base Core Definitions + \brief Definitions for base addresses, unions, and structures. + @{ + */ + +/* Memory mapping of Cortex-M0 Hardware */ +#define SCS_BASE (0xE000E000UL) /*!< System Control Space Base Address */ +#define SysTick_BASE (SCS_BASE + 0x0010UL) /*!< SysTick Base Address */ +#define NVIC_BASE (SCS_BASE + 0x0100UL) /*!< NVIC Base Address */ +#define SCB_BASE (SCS_BASE + 0x0D00UL) /*!< System Control Block Base Address */ + +#define SCB ((SCB_Type *) SCB_BASE ) /*!< SCB configuration struct */ +#define SysTick ((SysTick_Type *) SysTick_BASE ) /*!< SysTick configuration struct */ +#define NVIC ((NVIC_Type *) NVIC_BASE ) /*!< NVIC configuration struct */ + + +/*@} */ + + + +/******************************************************************************* + * Hardware Abstraction Layer + Core Function Interface contains: + - Core NVIC Functions + - Core SysTick Functions + - Core Register Access Functions + ******************************************************************************/ +/** + \defgroup CMSIS_Core_FunctionInterface Functions and Instructions Reference +*/ + + + +/* ########################## NVIC functions #################################### */ +/** + \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_NVICFunctions NVIC Functions + \brief Functions that manage interrupts and exceptions via the NVIC. + @{ + */ + +/* Interrupt Priorities are WORD accessible only under ARMv6M */ +/* The following MACROS handle generation of the register offset and byte masks */ +#define _BIT_SHIFT(IRQn) ( ((((uint32_t)(int32_t)(IRQn)) ) & 0x03UL) * 8UL) +#define _SHP_IDX(IRQn) ( (((((uint32_t)(int32_t)(IRQn)) & 0x0FUL)-8UL) >> 2UL) ) +#define _IP_IDX(IRQn) ( (((uint32_t)(int32_t)(IRQn)) >> 2UL) ) + + +/** + \brief Enable External Interrupt + \details Enables a device-specific interrupt in the NVIC interrupt controller. + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_EnableIRQ(IRQn_Type IRQn) +{ + NVIC->ISER[0U] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Disable External Interrupt + \details Disables a device-specific interrupt in the NVIC interrupt controller. + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_DisableIRQ(IRQn_Type IRQn) +{ + NVIC->ICER[0U] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Get Pending Interrupt + \details Reads the pending register in the NVIC and returns the pending bit for the specified interrupt. + \param [in] IRQn Interrupt number. + \return 0 Interrupt status is not pending. + \return 1 Interrupt status is pending. + */ +__STATIC_INLINE uint32_t NVIC_GetPendingIRQ(IRQn_Type IRQn) +{ + return((uint32_t)(((NVIC->ISPR[0U] & (1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL))) != 0UL) ? 1UL : 0UL)); +} + + +/** + \brief Set Pending Interrupt + \details Sets the pending bit of an external interrupt. + \param [in] IRQn Interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_SetPendingIRQ(IRQn_Type IRQn) +{ + NVIC->ISPR[0U] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Clear Pending Interrupt + \details Clears the pending bit of an external interrupt. + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_ClearPendingIRQ(IRQn_Type IRQn) +{ + NVIC->ICPR[0U] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Set Interrupt Priority + \details Sets the priority of an interrupt. + \note The priority cannot be set for every core interrupt. + \param [in] IRQn Interrupt number. + \param [in] priority Priority to set. + */ +__STATIC_INLINE void NVIC_SetPriority(IRQn_Type IRQn, uint32_t priority) +{ + if ((int32_t)(IRQn) < 0) + { + SCB->SHP[_SHP_IDX(IRQn)] = ((uint32_t)(SCB->SHP[_SHP_IDX(IRQn)] & ~(0xFFUL << _BIT_SHIFT(IRQn))) | + (((priority << (8U - __NVIC_PRIO_BITS)) & (uint32_t)0xFFUL) << _BIT_SHIFT(IRQn))); + } + else + { + NVIC->IP[_IP_IDX(IRQn)] = ((uint32_t)(NVIC->IP[_IP_IDX(IRQn)] & ~(0xFFUL << _BIT_SHIFT(IRQn))) | + (((priority << (8U - __NVIC_PRIO_BITS)) & (uint32_t)0xFFUL) << _BIT_SHIFT(IRQn))); + } +} + + +/** + \brief Get Interrupt Priority + \details Reads the priority of an interrupt. + The interrupt number can be positive to specify an external (device specific) interrupt, + or negative to specify an internal (core) interrupt. + \param [in] IRQn Interrupt number. + \return Interrupt Priority. + Value is aligned automatically to the implemented priority bits of the microcontroller. + */ +__STATIC_INLINE uint32_t NVIC_GetPriority(IRQn_Type IRQn) +{ + + if ((int32_t)(IRQn) < 0) + { + return((uint32_t)(((SCB->SHP[_SHP_IDX(IRQn)] >> _BIT_SHIFT(IRQn) ) & (uint32_t)0xFFUL) >> (8U - __NVIC_PRIO_BITS))); + } + else + { + return((uint32_t)(((NVIC->IP[ _IP_IDX(IRQn)] >> _BIT_SHIFT(IRQn) ) & (uint32_t)0xFFUL) >> (8U - __NVIC_PRIO_BITS))); + } +} + + +/** + \brief System Reset + \details Initiates a system reset request to reset the MCU. + */ +__STATIC_INLINE void NVIC_SystemReset(void) +{ + __DSB(); /* Ensure all outstanding memory accesses included + buffered write are completed before reset */ + SCB->AIRCR = ((0x5FAUL << SCB_AIRCR_VECTKEY_Pos) | + SCB_AIRCR_SYSRESETREQ_Msk); + __DSB(); /* Ensure completion of memory access */ + + for(;;) /* wait until reset */ + { + __NOP(); + } +} + +/*@} end of CMSIS_Core_NVICFunctions */ + + + +/* ################################## SysTick function ############################################ */ +/** + \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_SysTickFunctions SysTick Functions + \brief Functions that configure the System. + @{ + */ + +#if (__Vendor_SysTickConfig == 0U) + +/** + \brief System Tick Configuration + \details Initializes the System Timer and its interrupt, and starts the System Tick Timer. + Counter is in free running mode to generate periodic interrupts. + \param [in] ticks Number of ticks between two interrupts. + \return 0 Function succeeded. + \return 1 Function failed. + \note When the variable __Vendor_SysTickConfig is set to 1, then the + function SysTick_Config is not included. In this case, the file device.h + must contain a vendor-specific implementation of this function. + */ +__STATIC_INLINE uint32_t SysTick_Config(uint32_t ticks) +{ + if ((ticks - 1UL) > SysTick_LOAD_RELOAD_Msk) + { + return (1UL); /* Reload value impossible */ + } + + SysTick->LOAD = (uint32_t)(ticks - 1UL); /* set reload register */ + NVIC_SetPriority (SysTick_IRQn, (1UL << __NVIC_PRIO_BITS) - 1UL); /* set Priority for Systick Interrupt */ + SysTick->VAL = 0UL; /* Load the SysTick Counter Value */ + SysTick->CTRL = SysTick_CTRL_CLKSOURCE_Msk | + SysTick_CTRL_TICKINT_Msk | + SysTick_CTRL_ENABLE_Msk; /* Enable SysTick IRQ and SysTick Timer */ + return (0UL); /* Function successful */ +} + +#endif + +/*@} end of CMSIS_Core_SysTickFunctions */ + + + + +#ifdef __cplusplus +} +#endif + +#endif /* __CORE_CM0_H_DEPENDANT */ + +#endif /* __CMSIS_GENERIC */ diff --git a/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cm0plus.h b/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cm0plus.h new file mode 100644 index 00000000000..b04aa390532 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cm0plus.h @@ -0,0 +1,914 @@ +/**************************************************************************//** + * @file core_cm0plus.h + * @brief CMSIS Cortex-M0+ Core Peripheral Access Layer Header File + * @version V4.30 + * @date 20. October 2015 + ******************************************************************************/ +/* Copyright (c) 2009 - 2015 ARM LIMITED + + All rights reserved. + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are met: + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + - Neither the name of ARM nor the names of its contributors may be used + to endorse or promote products derived from this software without + specific prior written permission. + * + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE + LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + ---------------------------------------------------------------------------*/ + + +#if defined ( __ICCARM__ ) + #pragma system_include /* treat file as system include file for MISRA check */ +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #pragma clang system_header /* treat file as system include file */ +#endif + +#ifndef __CORE_CM0PLUS_H_GENERIC +#define __CORE_CM0PLUS_H_GENERIC + +#include + +#ifdef __cplusplus + extern "C" { +#endif + +/** + \page CMSIS_MISRA_Exceptions MISRA-C:2004 Compliance Exceptions + CMSIS violates the following MISRA-C:2004 rules: + + \li Required Rule 8.5, object/function definition in header file.
+ Function definitions in header files are used to allow 'inlining'. + + \li Required Rule 18.4, declaration of union type or object of union type: '{...}'.
+ Unions are used for effective representation of core registers. + + \li Advisory Rule 19.7, Function-like macro defined.
+ Function-like macros are used to allow more efficient code. + */ + + +/******************************************************************************* + * CMSIS definitions + ******************************************************************************/ +/** + \ingroup Cortex-M0+ + @{ + */ + +/* CMSIS CM0+ definitions */ +#define __CM0PLUS_CMSIS_VERSION_MAIN (0x04U) /*!< [31:16] CMSIS HAL main version */ +#define __CM0PLUS_CMSIS_VERSION_SUB (0x1EU) /*!< [15:0] CMSIS HAL sub version */ +#define __CM0PLUS_CMSIS_VERSION ((__CM0PLUS_CMSIS_VERSION_MAIN << 16U) | \ + __CM0PLUS_CMSIS_VERSION_SUB ) /*!< CMSIS HAL version number */ + +#define __CORTEX_M (0x00U) /*!< Cortex-M Core */ + + +#if defined ( __CC_ARM ) + #define __ASM __asm /*!< asm keyword for ARM Compiler */ + #define __INLINE __inline /*!< inline keyword for ARM Compiler */ + #define __STATIC_INLINE static __inline + +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #define __ASM __asm /*!< asm keyword for ARM Compiler */ + #define __INLINE __inline /*!< inline keyword for ARM Compiler */ + #define __STATIC_INLINE static __inline + +#elif defined ( __GNUC__ ) + #define __ASM __asm /*!< asm keyword for GNU Compiler */ + #define __INLINE inline /*!< inline keyword for GNU Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __ICCARM__ ) + #define __ASM __asm /*!< asm keyword for IAR Compiler */ + #define __INLINE inline /*!< inline keyword for IAR Compiler. Only available in High optimization mode! */ + #define __STATIC_INLINE static inline + +#elif defined ( __TMS470__ ) + #define __ASM __asm /*!< asm keyword for TI CCS Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __TASKING__ ) + #define __ASM __asm /*!< asm keyword for TASKING Compiler */ + #define __INLINE inline /*!< inline keyword for TASKING Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __CSMC__ ) + #define __packed + #define __ASM _asm /*!< asm keyword for COSMIC Compiler */ + #define __INLINE inline /*!< inline keyword for COSMIC Compiler. Use -pc99 on compile line */ + #define __STATIC_INLINE static inline + +#else + #error Unknown compiler +#endif + +/** __FPU_USED indicates whether an FPU is used or not. + This core does not support an FPU at all +*/ +#define __FPU_USED 0U + +#if defined ( __CC_ARM ) + #if defined __TARGET_FPU_VFP + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #if defined __ARM_PCS_VFP + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __GNUC__ ) + #if defined (__VFP_FP__) && !defined(__SOFTFP__) + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __ICCARM__ ) + #if defined __ARMVFP__ + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __TMS470__ ) + #if defined __TI_VFP_SUPPORT__ + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __TASKING__ ) + #if defined __FPU_VFP__ + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __CSMC__ ) + #if ( __CSMC__ & 0x400U) + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#endif + +#include "core_cmInstr.h" /* Core Instruction Access */ +#include "core_cmFunc.h" /* Core Function Access */ + +#ifdef __cplusplus +} +#endif + +#endif /* __CORE_CM0PLUS_H_GENERIC */ + +#ifndef __CMSIS_GENERIC + +#ifndef __CORE_CM0PLUS_H_DEPENDANT +#define __CORE_CM0PLUS_H_DEPENDANT + +#ifdef __cplusplus + extern "C" { +#endif + +/* check device defines and use defaults */ +#if defined __CHECK_DEVICE_DEFINES + #ifndef __CM0PLUS_REV + #define __CM0PLUS_REV 0x0000U + #warning "__CM0PLUS_REV not defined in device header file; using default!" + #endif + + #ifndef __MPU_PRESENT + #define __MPU_PRESENT 0U + #warning "__MPU_PRESENT not defined in device header file; using default!" + #endif + + #ifndef __VTOR_PRESENT + #define __VTOR_PRESENT 0U + #warning "__VTOR_PRESENT not defined in device header file; using default!" + #endif + + #ifndef __NVIC_PRIO_BITS + #define __NVIC_PRIO_BITS 2U + #warning "__NVIC_PRIO_BITS not defined in device header file; using default!" + #endif + + #ifndef __Vendor_SysTickConfig + #define __Vendor_SysTickConfig 0U + #warning "__Vendor_SysTickConfig not defined in device header file; using default!" + #endif +#endif + +/* IO definitions (access restrictions to peripheral registers) */ +/** + \defgroup CMSIS_glob_defs CMSIS Global Defines + + IO Type Qualifiers are used + \li to specify the access to peripheral variables. + \li for automatic generation of peripheral register debug information. +*/ +#ifdef __cplusplus + #define __I volatile /*!< Defines 'read only' permissions */ +#else + #define __I volatile const /*!< Defines 'read only' permissions */ +#endif +#define __O volatile /*!< Defines 'write only' permissions */ +#define __IO volatile /*!< Defines 'read / write' permissions */ + +/* following defines should be used for structure members */ +#define __IM volatile const /*! Defines 'read only' structure member permissions */ +#define __OM volatile /*! Defines 'write only' structure member permissions */ +#define __IOM volatile /*! Defines 'read / write' structure member permissions */ + +/*@} end of group Cortex-M0+ */ + + + +/******************************************************************************* + * Register Abstraction + Core Register contain: + - Core Register + - Core NVIC Register + - Core SCB Register + - Core SysTick Register + - Core MPU Register + ******************************************************************************/ +/** + \defgroup CMSIS_core_register Defines and Type Definitions + \brief Type definitions and defines for Cortex-M processor based devices. +*/ + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_CORE Status and Control Registers + \brief Core Register type definitions. + @{ + */ + +/** + \brief Union type to access the Application Program Status Register (APSR). + */ +typedef union +{ + struct + { + uint32_t _reserved0:28; /*!< bit: 0..27 Reserved */ + uint32_t V:1; /*!< bit: 28 Overflow condition code flag */ + uint32_t C:1; /*!< bit: 29 Carry condition code flag */ + uint32_t Z:1; /*!< bit: 30 Zero condition code flag */ + uint32_t N:1; /*!< bit: 31 Negative condition code flag */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} APSR_Type; + +/* APSR Register Definitions */ +#define APSR_N_Pos 31U /*!< APSR: N Position */ +#define APSR_N_Msk (1UL << APSR_N_Pos) /*!< APSR: N Mask */ + +#define APSR_Z_Pos 30U /*!< APSR: Z Position */ +#define APSR_Z_Msk (1UL << APSR_Z_Pos) /*!< APSR: Z Mask */ + +#define APSR_C_Pos 29U /*!< APSR: C Position */ +#define APSR_C_Msk (1UL << APSR_C_Pos) /*!< APSR: C Mask */ + +#define APSR_V_Pos 28U /*!< APSR: V Position */ +#define APSR_V_Msk (1UL << APSR_V_Pos) /*!< APSR: V Mask */ + + +/** + \brief Union type to access the Interrupt Program Status Register (IPSR). + */ +typedef union +{ + struct + { + uint32_t ISR:9; /*!< bit: 0.. 8 Exception number */ + uint32_t _reserved0:23; /*!< bit: 9..31 Reserved */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} IPSR_Type; + +/* IPSR Register Definitions */ +#define IPSR_ISR_Pos 0U /*!< IPSR: ISR Position */ +#define IPSR_ISR_Msk (0x1FFUL /*<< IPSR_ISR_Pos*/) /*!< IPSR: ISR Mask */ + + +/** + \brief Union type to access the Special-Purpose Program Status Registers (xPSR). + */ +typedef union +{ + struct + { + uint32_t ISR:9; /*!< bit: 0.. 8 Exception number */ + uint32_t _reserved0:15; /*!< bit: 9..23 Reserved */ + uint32_t T:1; /*!< bit: 24 Thumb bit (read 0) */ + uint32_t _reserved1:3; /*!< bit: 25..27 Reserved */ + uint32_t V:1; /*!< bit: 28 Overflow condition code flag */ + uint32_t C:1; /*!< bit: 29 Carry condition code flag */ + uint32_t Z:1; /*!< bit: 30 Zero condition code flag */ + uint32_t N:1; /*!< bit: 31 Negative condition code flag */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} xPSR_Type; + +/* xPSR Register Definitions */ +#define xPSR_N_Pos 31U /*!< xPSR: N Position */ +#define xPSR_N_Msk (1UL << xPSR_N_Pos) /*!< xPSR: N Mask */ + +#define xPSR_Z_Pos 30U /*!< xPSR: Z Position */ +#define xPSR_Z_Msk (1UL << xPSR_Z_Pos) /*!< xPSR: Z Mask */ + +#define xPSR_C_Pos 29U /*!< xPSR: C Position */ +#define xPSR_C_Msk (1UL << xPSR_C_Pos) /*!< xPSR: C Mask */ + +#define xPSR_V_Pos 28U /*!< xPSR: V Position */ +#define xPSR_V_Msk (1UL << xPSR_V_Pos) /*!< xPSR: V Mask */ + +#define xPSR_T_Pos 24U /*!< xPSR: T Position */ +#define xPSR_T_Msk (1UL << xPSR_T_Pos) /*!< xPSR: T Mask */ + +#define xPSR_ISR_Pos 0U /*!< xPSR: ISR Position */ +#define xPSR_ISR_Msk (0x1FFUL /*<< xPSR_ISR_Pos*/) /*!< xPSR: ISR Mask */ + + +/** + \brief Union type to access the Control Registers (CONTROL). + */ +typedef union +{ + struct + { + uint32_t nPRIV:1; /*!< bit: 0 Execution privilege in Thread mode */ + uint32_t SPSEL:1; /*!< bit: 1 Stack to be used */ + uint32_t _reserved1:30; /*!< bit: 2..31 Reserved */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} CONTROL_Type; + +/* CONTROL Register Definitions */ +#define CONTROL_SPSEL_Pos 1U /*!< CONTROL: SPSEL Position */ +#define CONTROL_SPSEL_Msk (1UL << CONTROL_SPSEL_Pos) /*!< CONTROL: SPSEL Mask */ + +#define CONTROL_nPRIV_Pos 0U /*!< CONTROL: nPRIV Position */ +#define CONTROL_nPRIV_Msk (1UL /*<< CONTROL_nPRIV_Pos*/) /*!< CONTROL: nPRIV Mask */ + +/*@} end of group CMSIS_CORE */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_NVIC Nested Vectored Interrupt Controller (NVIC) + \brief Type definitions for the NVIC Registers + @{ + */ + +/** + \brief Structure type to access the Nested Vectored Interrupt Controller (NVIC). + */ +typedef struct +{ + __IOM uint32_t ISER[1U]; /*!< Offset: 0x000 (R/W) Interrupt Set Enable Register */ + uint32_t RESERVED0[31U]; + __IOM uint32_t ICER[1U]; /*!< Offset: 0x080 (R/W) Interrupt Clear Enable Register */ + uint32_t RSERVED1[31U]; + __IOM uint32_t ISPR[1U]; /*!< Offset: 0x100 (R/W) Interrupt Set Pending Register */ + uint32_t RESERVED2[31U]; + __IOM uint32_t ICPR[1U]; /*!< Offset: 0x180 (R/W) Interrupt Clear Pending Register */ + uint32_t RESERVED3[31U]; + uint32_t RESERVED4[64U]; + __IOM uint32_t IP[8U]; /*!< Offset: 0x300 (R/W) Interrupt Priority Register */ +} NVIC_Type; + +/*@} end of group CMSIS_NVIC */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_SCB System Control Block (SCB) + \brief Type definitions for the System Control Block Registers + @{ + */ + +/** + \brief Structure type to access the System Control Block (SCB). + */ +typedef struct +{ + __IM uint32_t CPUID; /*!< Offset: 0x000 (R/ ) CPUID Base Register */ + __IOM uint32_t ICSR; /*!< Offset: 0x004 (R/W) Interrupt Control and State Register */ +#if (__VTOR_PRESENT == 1U) + __IOM uint32_t VTOR; /*!< Offset: 0x008 (R/W) Vector Table Offset Register */ +#else + uint32_t RESERVED0; +#endif + __IOM uint32_t AIRCR; /*!< Offset: 0x00C (R/W) Application Interrupt and Reset Control Register */ + __IOM uint32_t SCR; /*!< Offset: 0x010 (R/W) System Control Register */ + __IOM uint32_t CCR; /*!< Offset: 0x014 (R/W) Configuration Control Register */ + uint32_t RESERVED1; + __IOM uint32_t SHP[2U]; /*!< Offset: 0x01C (R/W) System Handlers Priority Registers. [0] is RESERVED */ + __IOM uint32_t SHCSR; /*!< Offset: 0x024 (R/W) System Handler Control and State Register */ +} SCB_Type; + +/* SCB CPUID Register Definitions */ +#define SCB_CPUID_IMPLEMENTER_Pos 24U /*!< SCB CPUID: IMPLEMENTER Position */ +#define SCB_CPUID_IMPLEMENTER_Msk (0xFFUL << SCB_CPUID_IMPLEMENTER_Pos) /*!< SCB CPUID: IMPLEMENTER Mask */ + +#define SCB_CPUID_VARIANT_Pos 20U /*!< SCB CPUID: VARIANT Position */ +#define SCB_CPUID_VARIANT_Msk (0xFUL << SCB_CPUID_VARIANT_Pos) /*!< SCB CPUID: VARIANT Mask */ + +#define SCB_CPUID_ARCHITECTURE_Pos 16U /*!< SCB CPUID: ARCHITECTURE Position */ +#define SCB_CPUID_ARCHITECTURE_Msk (0xFUL << SCB_CPUID_ARCHITECTURE_Pos) /*!< SCB CPUID: ARCHITECTURE Mask */ + +#define SCB_CPUID_PARTNO_Pos 4U /*!< SCB CPUID: PARTNO Position */ +#define SCB_CPUID_PARTNO_Msk (0xFFFUL << SCB_CPUID_PARTNO_Pos) /*!< SCB CPUID: PARTNO Mask */ + +#define SCB_CPUID_REVISION_Pos 0U /*!< SCB CPUID: REVISION Position */ +#define SCB_CPUID_REVISION_Msk (0xFUL /*<< SCB_CPUID_REVISION_Pos*/) /*!< SCB CPUID: REVISION Mask */ + +/* SCB Interrupt Control State Register Definitions */ +#define SCB_ICSR_NMIPENDSET_Pos 31U /*!< SCB ICSR: NMIPENDSET Position */ +#define SCB_ICSR_NMIPENDSET_Msk (1UL << SCB_ICSR_NMIPENDSET_Pos) /*!< SCB ICSR: NMIPENDSET Mask */ + +#define SCB_ICSR_PENDSVSET_Pos 28U /*!< SCB ICSR: PENDSVSET Position */ +#define SCB_ICSR_PENDSVSET_Msk (1UL << SCB_ICSR_PENDSVSET_Pos) /*!< SCB ICSR: PENDSVSET Mask */ + +#define SCB_ICSR_PENDSVCLR_Pos 27U /*!< SCB ICSR: PENDSVCLR Position */ +#define SCB_ICSR_PENDSVCLR_Msk (1UL << SCB_ICSR_PENDSVCLR_Pos) /*!< SCB ICSR: PENDSVCLR Mask */ + +#define SCB_ICSR_PENDSTSET_Pos 26U /*!< SCB ICSR: PENDSTSET Position */ +#define SCB_ICSR_PENDSTSET_Msk (1UL << SCB_ICSR_PENDSTSET_Pos) /*!< SCB ICSR: PENDSTSET Mask */ + +#define SCB_ICSR_PENDSTCLR_Pos 25U /*!< SCB ICSR: PENDSTCLR Position */ +#define SCB_ICSR_PENDSTCLR_Msk (1UL << SCB_ICSR_PENDSTCLR_Pos) /*!< SCB ICSR: PENDSTCLR Mask */ + +#define SCB_ICSR_ISRPREEMPT_Pos 23U /*!< SCB ICSR: ISRPREEMPT Position */ +#define SCB_ICSR_ISRPREEMPT_Msk (1UL << SCB_ICSR_ISRPREEMPT_Pos) /*!< SCB ICSR: ISRPREEMPT Mask */ + +#define SCB_ICSR_ISRPENDING_Pos 22U /*!< SCB ICSR: ISRPENDING Position */ +#define SCB_ICSR_ISRPENDING_Msk (1UL << SCB_ICSR_ISRPENDING_Pos) /*!< SCB ICSR: ISRPENDING Mask */ + +#define SCB_ICSR_VECTPENDING_Pos 12U /*!< SCB ICSR: VECTPENDING Position */ +#define SCB_ICSR_VECTPENDING_Msk (0x1FFUL << SCB_ICSR_VECTPENDING_Pos) /*!< SCB ICSR: VECTPENDING Mask */ + +#define SCB_ICSR_VECTACTIVE_Pos 0U /*!< SCB ICSR: VECTACTIVE Position */ +#define SCB_ICSR_VECTACTIVE_Msk (0x1FFUL /*<< SCB_ICSR_VECTACTIVE_Pos*/) /*!< SCB ICSR: VECTACTIVE Mask */ + +#if (__VTOR_PRESENT == 1U) +/* SCB Interrupt Control State Register Definitions */ +#define SCB_VTOR_TBLOFF_Pos 8U /*!< SCB VTOR: TBLOFF Position */ +#define SCB_VTOR_TBLOFF_Msk (0xFFFFFFUL << SCB_VTOR_TBLOFF_Pos) /*!< SCB VTOR: TBLOFF Mask */ +#endif + +/* SCB Application Interrupt and Reset Control Register Definitions */ +#define SCB_AIRCR_VECTKEY_Pos 16U /*!< SCB AIRCR: VECTKEY Position */ +#define SCB_AIRCR_VECTKEY_Msk (0xFFFFUL << SCB_AIRCR_VECTKEY_Pos) /*!< SCB AIRCR: VECTKEY Mask */ + +#define SCB_AIRCR_VECTKEYSTAT_Pos 16U /*!< SCB AIRCR: VECTKEYSTAT Position */ +#define SCB_AIRCR_VECTKEYSTAT_Msk (0xFFFFUL << SCB_AIRCR_VECTKEYSTAT_Pos) /*!< SCB AIRCR: VECTKEYSTAT Mask */ + +#define SCB_AIRCR_ENDIANESS_Pos 15U /*!< SCB AIRCR: ENDIANESS Position */ +#define SCB_AIRCR_ENDIANESS_Msk (1UL << SCB_AIRCR_ENDIANESS_Pos) /*!< SCB AIRCR: ENDIANESS Mask */ + +#define SCB_AIRCR_SYSRESETREQ_Pos 2U /*!< SCB AIRCR: SYSRESETREQ Position */ +#define SCB_AIRCR_SYSRESETREQ_Msk (1UL << SCB_AIRCR_SYSRESETREQ_Pos) /*!< SCB AIRCR: SYSRESETREQ Mask */ + +#define SCB_AIRCR_VECTCLRACTIVE_Pos 1U /*!< SCB AIRCR: VECTCLRACTIVE Position */ +#define SCB_AIRCR_VECTCLRACTIVE_Msk (1UL << SCB_AIRCR_VECTCLRACTIVE_Pos) /*!< SCB AIRCR: VECTCLRACTIVE Mask */ + +/* SCB System Control Register Definitions */ +#define SCB_SCR_SEVONPEND_Pos 4U /*!< SCB SCR: SEVONPEND Position */ +#define SCB_SCR_SEVONPEND_Msk (1UL << SCB_SCR_SEVONPEND_Pos) /*!< SCB SCR: SEVONPEND Mask */ + +#define SCB_SCR_SLEEPDEEP_Pos 2U /*!< SCB SCR: SLEEPDEEP Position */ +#define SCB_SCR_SLEEPDEEP_Msk (1UL << SCB_SCR_SLEEPDEEP_Pos) /*!< SCB SCR: SLEEPDEEP Mask */ + +#define SCB_SCR_SLEEPONEXIT_Pos 1U /*!< SCB SCR: SLEEPONEXIT Position */ +#define SCB_SCR_SLEEPONEXIT_Msk (1UL << SCB_SCR_SLEEPONEXIT_Pos) /*!< SCB SCR: SLEEPONEXIT Mask */ + +/* SCB Configuration Control Register Definitions */ +#define SCB_CCR_STKALIGN_Pos 9U /*!< SCB CCR: STKALIGN Position */ +#define SCB_CCR_STKALIGN_Msk (1UL << SCB_CCR_STKALIGN_Pos) /*!< SCB CCR: STKALIGN Mask */ + +#define SCB_CCR_UNALIGN_TRP_Pos 3U /*!< SCB CCR: UNALIGN_TRP Position */ +#define SCB_CCR_UNALIGN_TRP_Msk (1UL << SCB_CCR_UNALIGN_TRP_Pos) /*!< SCB CCR: UNALIGN_TRP Mask */ + +/* SCB System Handler Control and State Register Definitions */ +#define SCB_SHCSR_SVCALLPENDED_Pos 15U /*!< SCB SHCSR: SVCALLPENDED Position */ +#define SCB_SHCSR_SVCALLPENDED_Msk (1UL << SCB_SHCSR_SVCALLPENDED_Pos) /*!< SCB SHCSR: SVCALLPENDED Mask */ + +/*@} end of group CMSIS_SCB */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_SysTick System Tick Timer (SysTick) + \brief Type definitions for the System Timer Registers. + @{ + */ + +/** + \brief Structure type to access the System Timer (SysTick). + */ +typedef struct +{ + __IOM uint32_t CTRL; /*!< Offset: 0x000 (R/W) SysTick Control and Status Register */ + __IOM uint32_t LOAD; /*!< Offset: 0x004 (R/W) SysTick Reload Value Register */ + __IOM uint32_t VAL; /*!< Offset: 0x008 (R/W) SysTick Current Value Register */ + __IM uint32_t CALIB; /*!< Offset: 0x00C (R/ ) SysTick Calibration Register */ +} SysTick_Type; + +/* SysTick Control / Status Register Definitions */ +#define SysTick_CTRL_COUNTFLAG_Pos 16U /*!< SysTick CTRL: COUNTFLAG Position */ +#define SysTick_CTRL_COUNTFLAG_Msk (1UL << SysTick_CTRL_COUNTFLAG_Pos) /*!< SysTick CTRL: COUNTFLAG Mask */ + +#define SysTick_CTRL_CLKSOURCE_Pos 2U /*!< SysTick CTRL: CLKSOURCE Position */ +#define SysTick_CTRL_CLKSOURCE_Msk (1UL << SysTick_CTRL_CLKSOURCE_Pos) /*!< SysTick CTRL: CLKSOURCE Mask */ + +#define SysTick_CTRL_TICKINT_Pos 1U /*!< SysTick CTRL: TICKINT Position */ +#define SysTick_CTRL_TICKINT_Msk (1UL << SysTick_CTRL_TICKINT_Pos) /*!< SysTick CTRL: TICKINT Mask */ + +#define SysTick_CTRL_ENABLE_Pos 0U /*!< SysTick CTRL: ENABLE Position */ +#define SysTick_CTRL_ENABLE_Msk (1UL /*<< SysTick_CTRL_ENABLE_Pos*/) /*!< SysTick CTRL: ENABLE Mask */ + +/* SysTick Reload Register Definitions */ +#define SysTick_LOAD_RELOAD_Pos 0U /*!< SysTick LOAD: RELOAD Position */ +#define SysTick_LOAD_RELOAD_Msk (0xFFFFFFUL /*<< SysTick_LOAD_RELOAD_Pos*/) /*!< SysTick LOAD: RELOAD Mask */ + +/* SysTick Current Register Definitions */ +#define SysTick_VAL_CURRENT_Pos 0U /*!< SysTick VAL: CURRENT Position */ +#define SysTick_VAL_CURRENT_Msk (0xFFFFFFUL /*<< SysTick_VAL_CURRENT_Pos*/) /*!< SysTick VAL: CURRENT Mask */ + +/* SysTick Calibration Register Definitions */ +#define SysTick_CALIB_NOREF_Pos 31U /*!< SysTick CALIB: NOREF Position */ +#define SysTick_CALIB_NOREF_Msk (1UL << SysTick_CALIB_NOREF_Pos) /*!< SysTick CALIB: NOREF Mask */ + +#define SysTick_CALIB_SKEW_Pos 30U /*!< SysTick CALIB: SKEW Position */ +#define SysTick_CALIB_SKEW_Msk (1UL << SysTick_CALIB_SKEW_Pos) /*!< SysTick CALIB: SKEW Mask */ + +#define SysTick_CALIB_TENMS_Pos 0U /*!< SysTick CALIB: TENMS Position */ +#define SysTick_CALIB_TENMS_Msk (0xFFFFFFUL /*<< SysTick_CALIB_TENMS_Pos*/) /*!< SysTick CALIB: TENMS Mask */ + +/*@} end of group CMSIS_SysTick */ + +#if (__MPU_PRESENT == 1U) +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_MPU Memory Protection Unit (MPU) + \brief Type definitions for the Memory Protection Unit (MPU) + @{ + */ + +/** + \brief Structure type to access the Memory Protection Unit (MPU). + */ +typedef struct +{ + __IM uint32_t TYPE; /*!< Offset: 0x000 (R/ ) MPU Type Register */ + __IOM uint32_t CTRL; /*!< Offset: 0x004 (R/W) MPU Control Register */ + __IOM uint32_t RNR; /*!< Offset: 0x008 (R/W) MPU Region RNRber Register */ + __IOM uint32_t RBAR; /*!< Offset: 0x00C (R/W) MPU Region Base Address Register */ + __IOM uint32_t RASR; /*!< Offset: 0x010 (R/W) MPU Region Attribute and Size Register */ +} MPU_Type; + +/* MPU Type Register Definitions */ +#define MPU_TYPE_IREGION_Pos 16U /*!< MPU TYPE: IREGION Position */ +#define MPU_TYPE_IREGION_Msk (0xFFUL << MPU_TYPE_IREGION_Pos) /*!< MPU TYPE: IREGION Mask */ + +#define MPU_TYPE_DREGION_Pos 8U /*!< MPU TYPE: DREGION Position */ +#define MPU_TYPE_DREGION_Msk (0xFFUL << MPU_TYPE_DREGION_Pos) /*!< MPU TYPE: DREGION Mask */ + +#define MPU_TYPE_SEPARATE_Pos 0U /*!< MPU TYPE: SEPARATE Position */ +#define MPU_TYPE_SEPARATE_Msk (1UL /*<< MPU_TYPE_SEPARATE_Pos*/) /*!< MPU TYPE: SEPARATE Mask */ + +/* MPU Control Register Definitions */ +#define MPU_CTRL_PRIVDEFENA_Pos 2U /*!< MPU CTRL: PRIVDEFENA Position */ +#define MPU_CTRL_PRIVDEFENA_Msk (1UL << MPU_CTRL_PRIVDEFENA_Pos) /*!< MPU CTRL: PRIVDEFENA Mask */ + +#define MPU_CTRL_HFNMIENA_Pos 1U /*!< MPU CTRL: HFNMIENA Position */ +#define MPU_CTRL_HFNMIENA_Msk (1UL << MPU_CTRL_HFNMIENA_Pos) /*!< MPU CTRL: HFNMIENA Mask */ + +#define MPU_CTRL_ENABLE_Pos 0U /*!< MPU CTRL: ENABLE Position */ +#define MPU_CTRL_ENABLE_Msk (1UL /*<< MPU_CTRL_ENABLE_Pos*/) /*!< MPU CTRL: ENABLE Mask */ + +/* MPU Region Number Register Definitions */ +#define MPU_RNR_REGION_Pos 0U /*!< MPU RNR: REGION Position */ +#define MPU_RNR_REGION_Msk (0xFFUL /*<< MPU_RNR_REGION_Pos*/) /*!< MPU RNR: REGION Mask */ + +/* MPU Region Base Address Register Definitions */ +#define MPU_RBAR_ADDR_Pos 8U /*!< MPU RBAR: ADDR Position */ +#define MPU_RBAR_ADDR_Msk (0xFFFFFFUL << MPU_RBAR_ADDR_Pos) /*!< MPU RBAR: ADDR Mask */ + +#define MPU_RBAR_VALID_Pos 4U /*!< MPU RBAR: VALID Position */ +#define MPU_RBAR_VALID_Msk (1UL << MPU_RBAR_VALID_Pos) /*!< MPU RBAR: VALID Mask */ + +#define MPU_RBAR_REGION_Pos 0U /*!< MPU RBAR: REGION Position */ +#define MPU_RBAR_REGION_Msk (0xFUL /*<< MPU_RBAR_REGION_Pos*/) /*!< MPU RBAR: REGION Mask */ + +/* MPU Region Attribute and Size Register Definitions */ +#define MPU_RASR_ATTRS_Pos 16U /*!< MPU RASR: MPU Region Attribute field Position */ +#define MPU_RASR_ATTRS_Msk (0xFFFFUL << MPU_RASR_ATTRS_Pos) /*!< MPU RASR: MPU Region Attribute field Mask */ + +#define MPU_RASR_XN_Pos 28U /*!< MPU RASR: ATTRS.XN Position */ +#define MPU_RASR_XN_Msk (1UL << MPU_RASR_XN_Pos) /*!< MPU RASR: ATTRS.XN Mask */ + +#define MPU_RASR_AP_Pos 24U /*!< MPU RASR: ATTRS.AP Position */ +#define MPU_RASR_AP_Msk (0x7UL << MPU_RASR_AP_Pos) /*!< MPU RASR: ATTRS.AP Mask */ + +#define MPU_RASR_TEX_Pos 19U /*!< MPU RASR: ATTRS.TEX Position */ +#define MPU_RASR_TEX_Msk (0x7UL << MPU_RASR_TEX_Pos) /*!< MPU RASR: ATTRS.TEX Mask */ + +#define MPU_RASR_S_Pos 18U /*!< MPU RASR: ATTRS.S Position */ +#define MPU_RASR_S_Msk (1UL << MPU_RASR_S_Pos) /*!< MPU RASR: ATTRS.S Mask */ + +#define MPU_RASR_C_Pos 17U /*!< MPU RASR: ATTRS.C Position */ +#define MPU_RASR_C_Msk (1UL << MPU_RASR_C_Pos) /*!< MPU RASR: ATTRS.C Mask */ + +#define MPU_RASR_B_Pos 16U /*!< MPU RASR: ATTRS.B Position */ +#define MPU_RASR_B_Msk (1UL << MPU_RASR_B_Pos) /*!< MPU RASR: ATTRS.B Mask */ + +#define MPU_RASR_SRD_Pos 8U /*!< MPU RASR: Sub-Region Disable Position */ +#define MPU_RASR_SRD_Msk (0xFFUL << MPU_RASR_SRD_Pos) /*!< MPU RASR: Sub-Region Disable Mask */ + +#define MPU_RASR_SIZE_Pos 1U /*!< MPU RASR: Region Size Field Position */ +#define MPU_RASR_SIZE_Msk (0x1FUL << MPU_RASR_SIZE_Pos) /*!< MPU RASR: Region Size Field Mask */ + +#define MPU_RASR_ENABLE_Pos 0U /*!< MPU RASR: Region enable bit Position */ +#define MPU_RASR_ENABLE_Msk (1UL /*<< MPU_RASR_ENABLE_Pos*/) /*!< MPU RASR: Region enable bit Disable Mask */ + +/*@} end of group CMSIS_MPU */ +#endif + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_CoreDebug Core Debug Registers (CoreDebug) + \brief Cortex-M0+ Core Debug Registers (DCB registers, SHCSR, and DFSR) are only accessible over DAP and not via processor. + Therefore they are not covered by the Cortex-M0+ header file. + @{ + */ +/*@} end of group CMSIS_CoreDebug */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_core_bitfield Core register bit field macros + \brief Macros for use with bit field definitions (xxx_Pos, xxx_Msk). + @{ + */ + +/** + \brief Mask and shift a bit field value for use in a register bit range. + \param[in] field Name of the register bit field. + \param[in] value Value of the bit field. + \return Masked and shifted value. +*/ +#define _VAL2FLD(field, value) ((value << field ## _Pos) & field ## _Msk) + +/** + \brief Mask and shift a register value to extract a bit filed value. + \param[in] field Name of the register bit field. + \param[in] value Value of register. + \return Masked and shifted bit field value. +*/ +#define _FLD2VAL(field, value) ((value & field ## _Msk) >> field ## _Pos) + +/*@} end of group CMSIS_core_bitfield */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_core_base Core Definitions + \brief Definitions for base addresses, unions, and structures. + @{ + */ + +/* Memory mapping of Cortex-M0+ Hardware */ +#define SCS_BASE (0xE000E000UL) /*!< System Control Space Base Address */ +#define SysTick_BASE (SCS_BASE + 0x0010UL) /*!< SysTick Base Address */ +#define NVIC_BASE (SCS_BASE + 0x0100UL) /*!< NVIC Base Address */ +#define SCB_BASE (SCS_BASE + 0x0D00UL) /*!< System Control Block Base Address */ + +#define SCB ((SCB_Type *) SCB_BASE ) /*!< SCB configuration struct */ +#define SysTick ((SysTick_Type *) SysTick_BASE ) /*!< SysTick configuration struct */ +#define NVIC ((NVIC_Type *) NVIC_BASE ) /*!< NVIC configuration struct */ + +#if (__MPU_PRESENT == 1U) + #define MPU_BASE (SCS_BASE + 0x0D90UL) /*!< Memory Protection Unit */ + #define MPU ((MPU_Type *) MPU_BASE ) /*!< Memory Protection Unit */ +#endif + +/*@} */ + + + +/******************************************************************************* + * Hardware Abstraction Layer + Core Function Interface contains: + - Core NVIC Functions + - Core SysTick Functions + - Core Register Access Functions + ******************************************************************************/ +/** + \defgroup CMSIS_Core_FunctionInterface Functions and Instructions Reference +*/ + + + +/* ########################## NVIC functions #################################### */ +/** + \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_NVICFunctions NVIC Functions + \brief Functions that manage interrupts and exceptions via the NVIC. + @{ + */ + +/* Interrupt Priorities are WORD accessible only under ARMv6M */ +/* The following MACROS handle generation of the register offset and byte masks */ +#define _BIT_SHIFT(IRQn) ( ((((uint32_t)(int32_t)(IRQn)) ) & 0x03UL) * 8UL) +#define _SHP_IDX(IRQn) ( (((((uint32_t)(int32_t)(IRQn)) & 0x0FUL)-8UL) >> 2UL) ) +#define _IP_IDX(IRQn) ( (((uint32_t)(int32_t)(IRQn)) >> 2UL) ) + + +/** + \brief Enable External Interrupt + \details Enables a device-specific interrupt in the NVIC interrupt controller. + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_EnableIRQ(IRQn_Type IRQn) +{ + NVIC->ISER[0U] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Disable External Interrupt + \details Disables a device-specific interrupt in the NVIC interrupt controller. + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_DisableIRQ(IRQn_Type IRQn) +{ + NVIC->ICER[0U] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Get Pending Interrupt + \details Reads the pending register in the NVIC and returns the pending bit for the specified interrupt. + \param [in] IRQn Interrupt number. + \return 0 Interrupt status is not pending. + \return 1 Interrupt status is pending. + */ +__STATIC_INLINE uint32_t NVIC_GetPendingIRQ(IRQn_Type IRQn) +{ + return((uint32_t)(((NVIC->ISPR[0U] & (1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL))) != 0UL) ? 1UL : 0UL)); +} + + +/** + \brief Set Pending Interrupt + \details Sets the pending bit of an external interrupt. + \param [in] IRQn Interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_SetPendingIRQ(IRQn_Type IRQn) +{ + NVIC->ISPR[0U] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Clear Pending Interrupt + \details Clears the pending bit of an external interrupt. + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_ClearPendingIRQ(IRQn_Type IRQn) +{ + NVIC->ICPR[0U] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Set Interrupt Priority + \details Sets the priority of an interrupt. + \note The priority cannot be set for every core interrupt. + \param [in] IRQn Interrupt number. + \param [in] priority Priority to set. + */ +__STATIC_INLINE void NVIC_SetPriority(IRQn_Type IRQn, uint32_t priority) +{ + if ((int32_t)(IRQn) < 0) + { + SCB->SHP[_SHP_IDX(IRQn)] = ((uint32_t)(SCB->SHP[_SHP_IDX(IRQn)] & ~(0xFFUL << _BIT_SHIFT(IRQn))) | + (((priority << (8U - __NVIC_PRIO_BITS)) & (uint32_t)0xFFUL) << _BIT_SHIFT(IRQn))); + } + else + { + NVIC->IP[_IP_IDX(IRQn)] = ((uint32_t)(NVIC->IP[_IP_IDX(IRQn)] & ~(0xFFUL << _BIT_SHIFT(IRQn))) | + (((priority << (8U - __NVIC_PRIO_BITS)) & (uint32_t)0xFFUL) << _BIT_SHIFT(IRQn))); + } +} + + +/** + \brief Get Interrupt Priority + \details Reads the priority of an interrupt. + The interrupt number can be positive to specify an external (device specific) interrupt, + or negative to specify an internal (core) interrupt. + \param [in] IRQn Interrupt number. + \return Interrupt Priority. + Value is aligned automatically to the implemented priority bits of the microcontroller. + */ +__STATIC_INLINE uint32_t NVIC_GetPriority(IRQn_Type IRQn) +{ + + if ((int32_t)(IRQn) < 0) + { + return((uint32_t)(((SCB->SHP[_SHP_IDX(IRQn)] >> _BIT_SHIFT(IRQn) ) & (uint32_t)0xFFUL) >> (8U - __NVIC_PRIO_BITS))); + } + else + { + return((uint32_t)(((NVIC->IP[ _IP_IDX(IRQn)] >> _BIT_SHIFT(IRQn) ) & (uint32_t)0xFFUL) >> (8U - __NVIC_PRIO_BITS))); + } +} + + +/** + \brief System Reset + \details Initiates a system reset request to reset the MCU. + */ +__STATIC_INLINE void NVIC_SystemReset(void) +{ + __DSB(); /* Ensure all outstanding memory accesses included + buffered write are completed before reset */ + SCB->AIRCR = ((0x5FAUL << SCB_AIRCR_VECTKEY_Pos) | + SCB_AIRCR_SYSRESETREQ_Msk); + __DSB(); /* Ensure completion of memory access */ + + for(;;) /* wait until reset */ + { + __NOP(); + } +} + +/*@} end of CMSIS_Core_NVICFunctions */ + + + +/* ################################## SysTick function ############################################ */ +/** + \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_SysTickFunctions SysTick Functions + \brief Functions that configure the System. + @{ + */ + +#if (__Vendor_SysTickConfig == 0U) + +/** + \brief System Tick Configuration + \details Initializes the System Timer and its interrupt, and starts the System Tick Timer. + Counter is in free running mode to generate periodic interrupts. + \param [in] ticks Number of ticks between two interrupts. + \return 0 Function succeeded. + \return 1 Function failed. + \note When the variable __Vendor_SysTickConfig is set to 1, then the + function SysTick_Config is not included. In this case, the file device.h + must contain a vendor-specific implementation of this function. + */ +__STATIC_INLINE uint32_t SysTick_Config(uint32_t ticks) +{ + if ((ticks - 1UL) > SysTick_LOAD_RELOAD_Msk) + { + return (1UL); /* Reload value impossible */ + } + + SysTick->LOAD = (uint32_t)(ticks - 1UL); /* set reload register */ + NVIC_SetPriority (SysTick_IRQn, (1UL << __NVIC_PRIO_BITS) - 1UL); /* set Priority for Systick Interrupt */ + SysTick->VAL = 0UL; /* Load the SysTick Counter Value */ + SysTick->CTRL = SysTick_CTRL_CLKSOURCE_Msk | + SysTick_CTRL_TICKINT_Msk | + SysTick_CTRL_ENABLE_Msk; /* Enable SysTick IRQ and SysTick Timer */ + return (0UL); /* Function successful */ +} + +#endif + +/*@} end of CMSIS_Core_SysTickFunctions */ + + + + +#ifdef __cplusplus +} +#endif + +#endif /* __CORE_CM0PLUS_H_DEPENDANT */ + +#endif /* __CMSIS_GENERIC */ diff --git a/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cm3.h b/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cm3.h new file mode 100644 index 00000000000..b4ac4c7b05a --- /dev/null +++ b/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cm3.h @@ -0,0 +1,1763 @@ +/**************************************************************************//** + * @file core_cm3.h + * @brief CMSIS Cortex-M3 Core Peripheral Access Layer Header File + * @version V4.30 + * @date 20. October 2015 + ******************************************************************************/ +/* Copyright (c) 2009 - 2015 ARM LIMITED + + All rights reserved. + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are met: + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + - Neither the name of ARM nor the names of its contributors may be used + to endorse or promote products derived from this software without + specific prior written permission. + * + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE + LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + ---------------------------------------------------------------------------*/ + + +#if defined ( __ICCARM__ ) + #pragma system_include /* treat file as system include file for MISRA check */ +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #pragma clang system_header /* treat file as system include file */ +#endif + +#ifndef __CORE_CM3_H_GENERIC +#define __CORE_CM3_H_GENERIC + +#include + +#ifdef __cplusplus + extern "C" { +#endif + +/** + \page CMSIS_MISRA_Exceptions MISRA-C:2004 Compliance Exceptions + CMSIS violates the following MISRA-C:2004 rules: + + \li Required Rule 8.5, object/function definition in header file.
+ Function definitions in header files are used to allow 'inlining'. + + \li Required Rule 18.4, declaration of union type or object of union type: '{...}'.
+ Unions are used for effective representation of core registers. + + \li Advisory Rule 19.7, Function-like macro defined.
+ Function-like macros are used to allow more efficient code. + */ + + +/******************************************************************************* + * CMSIS definitions + ******************************************************************************/ +/** + \ingroup Cortex_M3 + @{ + */ + +/* CMSIS CM3 definitions */ +#define __CM3_CMSIS_VERSION_MAIN (0x04U) /*!< [31:16] CMSIS HAL main version */ +#define __CM3_CMSIS_VERSION_SUB (0x1EU) /*!< [15:0] CMSIS HAL sub version */ +#define __CM3_CMSIS_VERSION ((__CM3_CMSIS_VERSION_MAIN << 16U) | \ + __CM3_CMSIS_VERSION_SUB ) /*!< CMSIS HAL version number */ + +#define __CORTEX_M (0x03U) /*!< Cortex-M Core */ + + +#if defined ( __CC_ARM ) + #define __ASM __asm /*!< asm keyword for ARM Compiler */ + #define __INLINE __inline /*!< inline keyword for ARM Compiler */ + #define __STATIC_INLINE static __inline + +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #define __ASM __asm /*!< asm keyword for ARM Compiler */ + #define __INLINE __inline /*!< inline keyword for ARM Compiler */ + #define __STATIC_INLINE static __inline + +#elif defined ( __GNUC__ ) + #define __ASM __asm /*!< asm keyword for GNU Compiler */ + #define __INLINE inline /*!< inline keyword for GNU Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __ICCARM__ ) + #define __ASM __asm /*!< asm keyword for IAR Compiler */ + #define __INLINE inline /*!< inline keyword for IAR Compiler. Only available in High optimization mode! */ + #define __STATIC_INLINE static inline + +#elif defined ( __TMS470__ ) + #define __ASM __asm /*!< asm keyword for TI CCS Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __TASKING__ ) + #define __ASM __asm /*!< asm keyword for TASKING Compiler */ + #define __INLINE inline /*!< inline keyword for TASKING Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __CSMC__ ) + #define __packed + #define __ASM _asm /*!< asm keyword for COSMIC Compiler */ + #define __INLINE inline /*!< inline keyword for COSMIC Compiler. Use -pc99 on compile line */ + #define __STATIC_INLINE static inline + +#else + #error Unknown compiler +#endif + +/** __FPU_USED indicates whether an FPU is used or not. + This core does not support an FPU at all +*/ +#define __FPU_USED 0U + +#if defined ( __CC_ARM ) + #if defined __TARGET_FPU_VFP + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #if defined __ARM_PCS_VFP + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __GNUC__ ) + #if defined (__VFP_FP__) && !defined(__SOFTFP__) + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __ICCARM__ ) + #if defined __ARMVFP__ + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __TMS470__ ) + #if defined __TI_VFP_SUPPORT__ + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __TASKING__ ) + #if defined __FPU_VFP__ + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __CSMC__ ) + #if ( __CSMC__ & 0x400U) + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#endif + +#include "core_cmInstr.h" /* Core Instruction Access */ +#include "core_cmFunc.h" /* Core Function Access */ + +#ifdef __cplusplus +} +#endif + +#endif /* __CORE_CM3_H_GENERIC */ + +#ifndef __CMSIS_GENERIC + +#ifndef __CORE_CM3_H_DEPENDANT +#define __CORE_CM3_H_DEPENDANT + +#ifdef __cplusplus + extern "C" { +#endif + +/* check device defines and use defaults */ +#if defined __CHECK_DEVICE_DEFINES + #ifndef __CM3_REV + #define __CM3_REV 0x0200U + #warning "__CM3_REV not defined in device header file; using default!" + #endif + + #ifndef __MPU_PRESENT + #define __MPU_PRESENT 0U + #warning "__MPU_PRESENT not defined in device header file; using default!" + #endif + + #ifndef __NVIC_PRIO_BITS + #define __NVIC_PRIO_BITS 4U + #warning "__NVIC_PRIO_BITS not defined in device header file; using default!" + #endif + + #ifndef __Vendor_SysTickConfig + #define __Vendor_SysTickConfig 0U + #warning "__Vendor_SysTickConfig not defined in device header file; using default!" + #endif +#endif + +/* IO definitions (access restrictions to peripheral registers) */ +/** + \defgroup CMSIS_glob_defs CMSIS Global Defines + + IO Type Qualifiers are used + \li to specify the access to peripheral variables. + \li for automatic generation of peripheral register debug information. +*/ +#ifdef __cplusplus + #define __I volatile /*!< Defines 'read only' permissions */ +#else + #define __I volatile const /*!< Defines 'read only' permissions */ +#endif +#define __O volatile /*!< Defines 'write only' permissions */ +#define __IO volatile /*!< Defines 'read / write' permissions */ + +/* following defines should be used for structure members */ +#define __IM volatile const /*! Defines 'read only' structure member permissions */ +#define __OM volatile /*! Defines 'write only' structure member permissions */ +#define __IOM volatile /*! Defines 'read / write' structure member permissions */ + +/*@} end of group Cortex_M3 */ + + + +/******************************************************************************* + * Register Abstraction + Core Register contain: + - Core Register + - Core NVIC Register + - Core SCB Register + - Core SysTick Register + - Core Debug Register + - Core MPU Register + ******************************************************************************/ +/** + \defgroup CMSIS_core_register Defines and Type Definitions + \brief Type definitions and defines for Cortex-M processor based devices. +*/ + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_CORE Status and Control Registers + \brief Core Register type definitions. + @{ + */ + +/** + \brief Union type to access the Application Program Status Register (APSR). + */ +typedef union +{ + struct + { + uint32_t _reserved0:27; /*!< bit: 0..26 Reserved */ + uint32_t Q:1; /*!< bit: 27 Saturation condition flag */ + uint32_t V:1; /*!< bit: 28 Overflow condition code flag */ + uint32_t C:1; /*!< bit: 29 Carry condition code flag */ + uint32_t Z:1; /*!< bit: 30 Zero condition code flag */ + uint32_t N:1; /*!< bit: 31 Negative condition code flag */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} APSR_Type; + +/* APSR Register Definitions */ +#define APSR_N_Pos 31U /*!< APSR: N Position */ +#define APSR_N_Msk (1UL << APSR_N_Pos) /*!< APSR: N Mask */ + +#define APSR_Z_Pos 30U /*!< APSR: Z Position */ +#define APSR_Z_Msk (1UL << APSR_Z_Pos) /*!< APSR: Z Mask */ + +#define APSR_C_Pos 29U /*!< APSR: C Position */ +#define APSR_C_Msk (1UL << APSR_C_Pos) /*!< APSR: C Mask */ + +#define APSR_V_Pos 28U /*!< APSR: V Position */ +#define APSR_V_Msk (1UL << APSR_V_Pos) /*!< APSR: V Mask */ + +#define APSR_Q_Pos 27U /*!< APSR: Q Position */ +#define APSR_Q_Msk (1UL << APSR_Q_Pos) /*!< APSR: Q Mask */ + + +/** + \brief Union type to access the Interrupt Program Status Register (IPSR). + */ +typedef union +{ + struct + { + uint32_t ISR:9; /*!< bit: 0.. 8 Exception number */ + uint32_t _reserved0:23; /*!< bit: 9..31 Reserved */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} IPSR_Type; + +/* IPSR Register Definitions */ +#define IPSR_ISR_Pos 0U /*!< IPSR: ISR Position */ +#define IPSR_ISR_Msk (0x1FFUL /*<< IPSR_ISR_Pos*/) /*!< IPSR: ISR Mask */ + + +/** + \brief Union type to access the Special-Purpose Program Status Registers (xPSR). + */ +typedef union +{ + struct + { + uint32_t ISR:9; /*!< bit: 0.. 8 Exception number */ + uint32_t _reserved0:15; /*!< bit: 9..23 Reserved */ + uint32_t T:1; /*!< bit: 24 Thumb bit (read 0) */ + uint32_t IT:2; /*!< bit: 25..26 saved IT state (read 0) */ + uint32_t Q:1; /*!< bit: 27 Saturation condition flag */ + uint32_t V:1; /*!< bit: 28 Overflow condition code flag */ + uint32_t C:1; /*!< bit: 29 Carry condition code flag */ + uint32_t Z:1; /*!< bit: 30 Zero condition code flag */ + uint32_t N:1; /*!< bit: 31 Negative condition code flag */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} xPSR_Type; + +/* xPSR Register Definitions */ +#define xPSR_N_Pos 31U /*!< xPSR: N Position */ +#define xPSR_N_Msk (1UL << xPSR_N_Pos) /*!< xPSR: N Mask */ + +#define xPSR_Z_Pos 30U /*!< xPSR: Z Position */ +#define xPSR_Z_Msk (1UL << xPSR_Z_Pos) /*!< xPSR: Z Mask */ + +#define xPSR_C_Pos 29U /*!< xPSR: C Position */ +#define xPSR_C_Msk (1UL << xPSR_C_Pos) /*!< xPSR: C Mask */ + +#define xPSR_V_Pos 28U /*!< xPSR: V Position */ +#define xPSR_V_Msk (1UL << xPSR_V_Pos) /*!< xPSR: V Mask */ + +#define xPSR_Q_Pos 27U /*!< xPSR: Q Position */ +#define xPSR_Q_Msk (1UL << xPSR_Q_Pos) /*!< xPSR: Q Mask */ + +#define xPSR_IT_Pos 25U /*!< xPSR: IT Position */ +#define xPSR_IT_Msk (3UL << xPSR_IT_Pos) /*!< xPSR: IT Mask */ + +#define xPSR_T_Pos 24U /*!< xPSR: T Position */ +#define xPSR_T_Msk (1UL << xPSR_T_Pos) /*!< xPSR: T Mask */ + +#define xPSR_ISR_Pos 0U /*!< xPSR: ISR Position */ +#define xPSR_ISR_Msk (0x1FFUL /*<< xPSR_ISR_Pos*/) /*!< xPSR: ISR Mask */ + + +/** + \brief Union type to access the Control Registers (CONTROL). + */ +typedef union +{ + struct + { + uint32_t nPRIV:1; /*!< bit: 0 Execution privilege in Thread mode */ + uint32_t SPSEL:1; /*!< bit: 1 Stack to be used */ + uint32_t _reserved1:30; /*!< bit: 2..31 Reserved */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} CONTROL_Type; + +/* CONTROL Register Definitions */ +#define CONTROL_SPSEL_Pos 1U /*!< CONTROL: SPSEL Position */ +#define CONTROL_SPSEL_Msk (1UL << CONTROL_SPSEL_Pos) /*!< CONTROL: SPSEL Mask */ + +#define CONTROL_nPRIV_Pos 0U /*!< CONTROL: nPRIV Position */ +#define CONTROL_nPRIV_Msk (1UL /*<< CONTROL_nPRIV_Pos*/) /*!< CONTROL: nPRIV Mask */ + +/*@} end of group CMSIS_CORE */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_NVIC Nested Vectored Interrupt Controller (NVIC) + \brief Type definitions for the NVIC Registers + @{ + */ + +/** + \brief Structure type to access the Nested Vectored Interrupt Controller (NVIC). + */ +typedef struct +{ + __IOM uint32_t ISER[8U]; /*!< Offset: 0x000 (R/W) Interrupt Set Enable Register */ + uint32_t RESERVED0[24U]; + __IOM uint32_t ICER[8U]; /*!< Offset: 0x080 (R/W) Interrupt Clear Enable Register */ + uint32_t RSERVED1[24U]; + __IOM uint32_t ISPR[8U]; /*!< Offset: 0x100 (R/W) Interrupt Set Pending Register */ + uint32_t RESERVED2[24U]; + __IOM uint32_t ICPR[8U]; /*!< Offset: 0x180 (R/W) Interrupt Clear Pending Register */ + uint32_t RESERVED3[24U]; + __IOM uint32_t IABR[8U]; /*!< Offset: 0x200 (R/W) Interrupt Active bit Register */ + uint32_t RESERVED4[56U]; + __IOM uint8_t IP[240U]; /*!< Offset: 0x300 (R/W) Interrupt Priority Register (8Bit wide) */ + uint32_t RESERVED5[644U]; + __OM uint32_t STIR; /*!< Offset: 0xE00 ( /W) Software Trigger Interrupt Register */ +} NVIC_Type; + +/* Software Triggered Interrupt Register Definitions */ +#define NVIC_STIR_INTID_Pos 0U /*!< STIR: INTLINESNUM Position */ +#define NVIC_STIR_INTID_Msk (0x1FFUL /*<< NVIC_STIR_INTID_Pos*/) /*!< STIR: INTLINESNUM Mask */ + +/*@} end of group CMSIS_NVIC */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_SCB System Control Block (SCB) + \brief Type definitions for the System Control Block Registers + @{ + */ + +/** + \brief Structure type to access the System Control Block (SCB). + */ +typedef struct +{ + __IM uint32_t CPUID; /*!< Offset: 0x000 (R/ ) CPUID Base Register */ + __IOM uint32_t ICSR; /*!< Offset: 0x004 (R/W) Interrupt Control and State Register */ + __IOM uint32_t VTOR; /*!< Offset: 0x008 (R/W) Vector Table Offset Register */ + __IOM uint32_t AIRCR; /*!< Offset: 0x00C (R/W) Application Interrupt and Reset Control Register */ + __IOM uint32_t SCR; /*!< Offset: 0x010 (R/W) System Control Register */ + __IOM uint32_t CCR; /*!< Offset: 0x014 (R/W) Configuration Control Register */ + __IOM uint8_t SHP[12U]; /*!< Offset: 0x018 (R/W) System Handlers Priority Registers (4-7, 8-11, 12-15) */ + __IOM uint32_t SHCSR; /*!< Offset: 0x024 (R/W) System Handler Control and State Register */ + __IOM uint32_t CFSR; /*!< Offset: 0x028 (R/W) Configurable Fault Status Register */ + __IOM uint32_t HFSR; /*!< Offset: 0x02C (R/W) HardFault Status Register */ + __IOM uint32_t DFSR; /*!< Offset: 0x030 (R/W) Debug Fault Status Register */ + __IOM uint32_t MMFAR; /*!< Offset: 0x034 (R/W) MemManage Fault Address Register */ + __IOM uint32_t BFAR; /*!< Offset: 0x038 (R/W) BusFault Address Register */ + __IOM uint32_t AFSR; /*!< Offset: 0x03C (R/W) Auxiliary Fault Status Register */ + __IM uint32_t PFR[2U]; /*!< Offset: 0x040 (R/ ) Processor Feature Register */ + __IM uint32_t DFR; /*!< Offset: 0x048 (R/ ) Debug Feature Register */ + __IM uint32_t ADR; /*!< Offset: 0x04C (R/ ) Auxiliary Feature Register */ + __IM uint32_t MMFR[4U]; /*!< Offset: 0x050 (R/ ) Memory Model Feature Register */ + __IM uint32_t ISAR[5U]; /*!< Offset: 0x060 (R/ ) Instruction Set Attributes Register */ + uint32_t RESERVED0[5U]; + __IOM uint32_t CPACR; /*!< Offset: 0x088 (R/W) Coprocessor Access Control Register */ +} SCB_Type; + +/* SCB CPUID Register Definitions */ +#define SCB_CPUID_IMPLEMENTER_Pos 24U /*!< SCB CPUID: IMPLEMENTER Position */ +#define SCB_CPUID_IMPLEMENTER_Msk (0xFFUL << SCB_CPUID_IMPLEMENTER_Pos) /*!< SCB CPUID: IMPLEMENTER Mask */ + +#define SCB_CPUID_VARIANT_Pos 20U /*!< SCB CPUID: VARIANT Position */ +#define SCB_CPUID_VARIANT_Msk (0xFUL << SCB_CPUID_VARIANT_Pos) /*!< SCB CPUID: VARIANT Mask */ + +#define SCB_CPUID_ARCHITECTURE_Pos 16U /*!< SCB CPUID: ARCHITECTURE Position */ +#define SCB_CPUID_ARCHITECTURE_Msk (0xFUL << SCB_CPUID_ARCHITECTURE_Pos) /*!< SCB CPUID: ARCHITECTURE Mask */ + +#define SCB_CPUID_PARTNO_Pos 4U /*!< SCB CPUID: PARTNO Position */ +#define SCB_CPUID_PARTNO_Msk (0xFFFUL << SCB_CPUID_PARTNO_Pos) /*!< SCB CPUID: PARTNO Mask */ + +#define SCB_CPUID_REVISION_Pos 0U /*!< SCB CPUID: REVISION Position */ +#define SCB_CPUID_REVISION_Msk (0xFUL /*<< SCB_CPUID_REVISION_Pos*/) /*!< SCB CPUID: REVISION Mask */ + +/* SCB Interrupt Control State Register Definitions */ +#define SCB_ICSR_NMIPENDSET_Pos 31U /*!< SCB ICSR: NMIPENDSET Position */ +#define SCB_ICSR_NMIPENDSET_Msk (1UL << SCB_ICSR_NMIPENDSET_Pos) /*!< SCB ICSR: NMIPENDSET Mask */ + +#define SCB_ICSR_PENDSVSET_Pos 28U /*!< SCB ICSR: PENDSVSET Position */ +#define SCB_ICSR_PENDSVSET_Msk (1UL << SCB_ICSR_PENDSVSET_Pos) /*!< SCB ICSR: PENDSVSET Mask */ + +#define SCB_ICSR_PENDSVCLR_Pos 27U /*!< SCB ICSR: PENDSVCLR Position */ +#define SCB_ICSR_PENDSVCLR_Msk (1UL << SCB_ICSR_PENDSVCLR_Pos) /*!< SCB ICSR: PENDSVCLR Mask */ + +#define SCB_ICSR_PENDSTSET_Pos 26U /*!< SCB ICSR: PENDSTSET Position */ +#define SCB_ICSR_PENDSTSET_Msk (1UL << SCB_ICSR_PENDSTSET_Pos) /*!< SCB ICSR: PENDSTSET Mask */ + +#define SCB_ICSR_PENDSTCLR_Pos 25U /*!< SCB ICSR: PENDSTCLR Position */ +#define SCB_ICSR_PENDSTCLR_Msk (1UL << SCB_ICSR_PENDSTCLR_Pos) /*!< SCB ICSR: PENDSTCLR Mask */ + +#define SCB_ICSR_ISRPREEMPT_Pos 23U /*!< SCB ICSR: ISRPREEMPT Position */ +#define SCB_ICSR_ISRPREEMPT_Msk (1UL << SCB_ICSR_ISRPREEMPT_Pos) /*!< SCB ICSR: ISRPREEMPT Mask */ + +#define SCB_ICSR_ISRPENDING_Pos 22U /*!< SCB ICSR: ISRPENDING Position */ +#define SCB_ICSR_ISRPENDING_Msk (1UL << SCB_ICSR_ISRPENDING_Pos) /*!< SCB ICSR: ISRPENDING Mask */ + +#define SCB_ICSR_VECTPENDING_Pos 12U /*!< SCB ICSR: VECTPENDING Position */ +#define SCB_ICSR_VECTPENDING_Msk (0x1FFUL << SCB_ICSR_VECTPENDING_Pos) /*!< SCB ICSR: VECTPENDING Mask */ + +#define SCB_ICSR_RETTOBASE_Pos 11U /*!< SCB ICSR: RETTOBASE Position */ +#define SCB_ICSR_RETTOBASE_Msk (1UL << SCB_ICSR_RETTOBASE_Pos) /*!< SCB ICSR: RETTOBASE Mask */ + +#define SCB_ICSR_VECTACTIVE_Pos 0U /*!< SCB ICSR: VECTACTIVE Position */ +#define SCB_ICSR_VECTACTIVE_Msk (0x1FFUL /*<< SCB_ICSR_VECTACTIVE_Pos*/) /*!< SCB ICSR: VECTACTIVE Mask */ + +/* SCB Vector Table Offset Register Definitions */ +#if (__CM3_REV < 0x0201U) /* core r2p1 */ +#define SCB_VTOR_TBLBASE_Pos 29U /*!< SCB VTOR: TBLBASE Position */ +#define SCB_VTOR_TBLBASE_Msk (1UL << SCB_VTOR_TBLBASE_Pos) /*!< SCB VTOR: TBLBASE Mask */ + +#define SCB_VTOR_TBLOFF_Pos 7U /*!< SCB VTOR: TBLOFF Position */ +#define SCB_VTOR_TBLOFF_Msk (0x3FFFFFUL << SCB_VTOR_TBLOFF_Pos) /*!< SCB VTOR: TBLOFF Mask */ +#else +#define SCB_VTOR_TBLOFF_Pos 7U /*!< SCB VTOR: TBLOFF Position */ +#define SCB_VTOR_TBLOFF_Msk (0x1FFFFFFUL << SCB_VTOR_TBLOFF_Pos) /*!< SCB VTOR: TBLOFF Mask */ +#endif + +/* SCB Application Interrupt and Reset Control Register Definitions */ +#define SCB_AIRCR_VECTKEY_Pos 16U /*!< SCB AIRCR: VECTKEY Position */ +#define SCB_AIRCR_VECTKEY_Msk (0xFFFFUL << SCB_AIRCR_VECTKEY_Pos) /*!< SCB AIRCR: VECTKEY Mask */ + +#define SCB_AIRCR_VECTKEYSTAT_Pos 16U /*!< SCB AIRCR: VECTKEYSTAT Position */ +#define SCB_AIRCR_VECTKEYSTAT_Msk (0xFFFFUL << SCB_AIRCR_VECTKEYSTAT_Pos) /*!< SCB AIRCR: VECTKEYSTAT Mask */ + +#define SCB_AIRCR_ENDIANESS_Pos 15U /*!< SCB AIRCR: ENDIANESS Position */ +#define SCB_AIRCR_ENDIANESS_Msk (1UL << SCB_AIRCR_ENDIANESS_Pos) /*!< SCB AIRCR: ENDIANESS Mask */ + +#define SCB_AIRCR_PRIGROUP_Pos 8U /*!< SCB AIRCR: PRIGROUP Position */ +#define SCB_AIRCR_PRIGROUP_Msk (7UL << SCB_AIRCR_PRIGROUP_Pos) /*!< SCB AIRCR: PRIGROUP Mask */ + +#define SCB_AIRCR_SYSRESETREQ_Pos 2U /*!< SCB AIRCR: SYSRESETREQ Position */ +#define SCB_AIRCR_SYSRESETREQ_Msk (1UL << SCB_AIRCR_SYSRESETREQ_Pos) /*!< SCB AIRCR: SYSRESETREQ Mask */ + +#define SCB_AIRCR_VECTCLRACTIVE_Pos 1U /*!< SCB AIRCR: VECTCLRACTIVE Position */ +#define SCB_AIRCR_VECTCLRACTIVE_Msk (1UL << SCB_AIRCR_VECTCLRACTIVE_Pos) /*!< SCB AIRCR: VECTCLRACTIVE Mask */ + +#define SCB_AIRCR_VECTRESET_Pos 0U /*!< SCB AIRCR: VECTRESET Position */ +#define SCB_AIRCR_VECTRESET_Msk (1UL /*<< SCB_AIRCR_VECTRESET_Pos*/) /*!< SCB AIRCR: VECTRESET Mask */ + +/* SCB System Control Register Definitions */ +#define SCB_SCR_SEVONPEND_Pos 4U /*!< SCB SCR: SEVONPEND Position */ +#define SCB_SCR_SEVONPEND_Msk (1UL << SCB_SCR_SEVONPEND_Pos) /*!< SCB SCR: SEVONPEND Mask */ + +#define SCB_SCR_SLEEPDEEP_Pos 2U /*!< SCB SCR: SLEEPDEEP Position */ +#define SCB_SCR_SLEEPDEEP_Msk (1UL << SCB_SCR_SLEEPDEEP_Pos) /*!< SCB SCR: SLEEPDEEP Mask */ + +#define SCB_SCR_SLEEPONEXIT_Pos 1U /*!< SCB SCR: SLEEPONEXIT Position */ +#define SCB_SCR_SLEEPONEXIT_Msk (1UL << SCB_SCR_SLEEPONEXIT_Pos) /*!< SCB SCR: SLEEPONEXIT Mask */ + +/* SCB Configuration Control Register Definitions */ +#define SCB_CCR_STKALIGN_Pos 9U /*!< SCB CCR: STKALIGN Position */ +#define SCB_CCR_STKALIGN_Msk (1UL << SCB_CCR_STKALIGN_Pos) /*!< SCB CCR: STKALIGN Mask */ + +#define SCB_CCR_BFHFNMIGN_Pos 8U /*!< SCB CCR: BFHFNMIGN Position */ +#define SCB_CCR_BFHFNMIGN_Msk (1UL << SCB_CCR_BFHFNMIGN_Pos) /*!< SCB CCR: BFHFNMIGN Mask */ + +#define SCB_CCR_DIV_0_TRP_Pos 4U /*!< SCB CCR: DIV_0_TRP Position */ +#define SCB_CCR_DIV_0_TRP_Msk (1UL << SCB_CCR_DIV_0_TRP_Pos) /*!< SCB CCR: DIV_0_TRP Mask */ + +#define SCB_CCR_UNALIGN_TRP_Pos 3U /*!< SCB CCR: UNALIGN_TRP Position */ +#define SCB_CCR_UNALIGN_TRP_Msk (1UL << SCB_CCR_UNALIGN_TRP_Pos) /*!< SCB CCR: UNALIGN_TRP Mask */ + +#define SCB_CCR_USERSETMPEND_Pos 1U /*!< SCB CCR: USERSETMPEND Position */ +#define SCB_CCR_USERSETMPEND_Msk (1UL << SCB_CCR_USERSETMPEND_Pos) /*!< SCB CCR: USERSETMPEND Mask */ + +#define SCB_CCR_NONBASETHRDENA_Pos 0U /*!< SCB CCR: NONBASETHRDENA Position */ +#define SCB_CCR_NONBASETHRDENA_Msk (1UL /*<< SCB_CCR_NONBASETHRDENA_Pos*/) /*!< SCB CCR: NONBASETHRDENA Mask */ + +/* SCB System Handler Control and State Register Definitions */ +#define SCB_SHCSR_USGFAULTENA_Pos 18U /*!< SCB SHCSR: USGFAULTENA Position */ +#define SCB_SHCSR_USGFAULTENA_Msk (1UL << SCB_SHCSR_USGFAULTENA_Pos) /*!< SCB SHCSR: USGFAULTENA Mask */ + +#define SCB_SHCSR_BUSFAULTENA_Pos 17U /*!< SCB SHCSR: BUSFAULTENA Position */ +#define SCB_SHCSR_BUSFAULTENA_Msk (1UL << SCB_SHCSR_BUSFAULTENA_Pos) /*!< SCB SHCSR: BUSFAULTENA Mask */ + +#define SCB_SHCSR_MEMFAULTENA_Pos 16U /*!< SCB SHCSR: MEMFAULTENA Position */ +#define SCB_SHCSR_MEMFAULTENA_Msk (1UL << SCB_SHCSR_MEMFAULTENA_Pos) /*!< SCB SHCSR: MEMFAULTENA Mask */ + +#define SCB_SHCSR_SVCALLPENDED_Pos 15U /*!< SCB SHCSR: SVCALLPENDED Position */ +#define SCB_SHCSR_SVCALLPENDED_Msk (1UL << SCB_SHCSR_SVCALLPENDED_Pos) /*!< SCB SHCSR: SVCALLPENDED Mask */ + +#define SCB_SHCSR_BUSFAULTPENDED_Pos 14U /*!< SCB SHCSR: BUSFAULTPENDED Position */ +#define SCB_SHCSR_BUSFAULTPENDED_Msk (1UL << SCB_SHCSR_BUSFAULTPENDED_Pos) /*!< SCB SHCSR: BUSFAULTPENDED Mask */ + +#define SCB_SHCSR_MEMFAULTPENDED_Pos 13U /*!< SCB SHCSR: MEMFAULTPENDED Position */ +#define SCB_SHCSR_MEMFAULTPENDED_Msk (1UL << SCB_SHCSR_MEMFAULTPENDED_Pos) /*!< SCB SHCSR: MEMFAULTPENDED Mask */ + +#define SCB_SHCSR_USGFAULTPENDED_Pos 12U /*!< SCB SHCSR: USGFAULTPENDED Position */ +#define SCB_SHCSR_USGFAULTPENDED_Msk (1UL << SCB_SHCSR_USGFAULTPENDED_Pos) /*!< SCB SHCSR: USGFAULTPENDED Mask */ + +#define SCB_SHCSR_SYSTICKACT_Pos 11U /*!< SCB SHCSR: SYSTICKACT Position */ +#define SCB_SHCSR_SYSTICKACT_Msk (1UL << SCB_SHCSR_SYSTICKACT_Pos) /*!< SCB SHCSR: SYSTICKACT Mask */ + +#define SCB_SHCSR_PENDSVACT_Pos 10U /*!< SCB SHCSR: PENDSVACT Position */ +#define SCB_SHCSR_PENDSVACT_Msk (1UL << SCB_SHCSR_PENDSVACT_Pos) /*!< SCB SHCSR: PENDSVACT Mask */ + +#define SCB_SHCSR_MONITORACT_Pos 8U /*!< SCB SHCSR: MONITORACT Position */ +#define SCB_SHCSR_MONITORACT_Msk (1UL << SCB_SHCSR_MONITORACT_Pos) /*!< SCB SHCSR: MONITORACT Mask */ + +#define SCB_SHCSR_SVCALLACT_Pos 7U /*!< SCB SHCSR: SVCALLACT Position */ +#define SCB_SHCSR_SVCALLACT_Msk (1UL << SCB_SHCSR_SVCALLACT_Pos) /*!< SCB SHCSR: SVCALLACT Mask */ + +#define SCB_SHCSR_USGFAULTACT_Pos 3U /*!< SCB SHCSR: USGFAULTACT Position */ +#define SCB_SHCSR_USGFAULTACT_Msk (1UL << SCB_SHCSR_USGFAULTACT_Pos) /*!< SCB SHCSR: USGFAULTACT Mask */ + +#define SCB_SHCSR_BUSFAULTACT_Pos 1U /*!< SCB SHCSR: BUSFAULTACT Position */ +#define SCB_SHCSR_BUSFAULTACT_Msk (1UL << SCB_SHCSR_BUSFAULTACT_Pos) /*!< SCB SHCSR: BUSFAULTACT Mask */ + +#define SCB_SHCSR_MEMFAULTACT_Pos 0U /*!< SCB SHCSR: MEMFAULTACT Position */ +#define SCB_SHCSR_MEMFAULTACT_Msk (1UL /*<< SCB_SHCSR_MEMFAULTACT_Pos*/) /*!< SCB SHCSR: MEMFAULTACT Mask */ + +/* SCB Configurable Fault Status Register Definitions */ +#define SCB_CFSR_USGFAULTSR_Pos 16U /*!< SCB CFSR: Usage Fault Status Register Position */ +#define SCB_CFSR_USGFAULTSR_Msk (0xFFFFUL << SCB_CFSR_USGFAULTSR_Pos) /*!< SCB CFSR: Usage Fault Status Register Mask */ + +#define SCB_CFSR_BUSFAULTSR_Pos 8U /*!< SCB CFSR: Bus Fault Status Register Position */ +#define SCB_CFSR_BUSFAULTSR_Msk (0xFFUL << SCB_CFSR_BUSFAULTSR_Pos) /*!< SCB CFSR: Bus Fault Status Register Mask */ + +#define SCB_CFSR_MEMFAULTSR_Pos 0U /*!< SCB CFSR: Memory Manage Fault Status Register Position */ +#define SCB_CFSR_MEMFAULTSR_Msk (0xFFUL /*<< SCB_CFSR_MEMFAULTSR_Pos*/) /*!< SCB CFSR: Memory Manage Fault Status Register Mask */ + +/* SCB Hard Fault Status Register Definitions */ +#define SCB_HFSR_DEBUGEVT_Pos 31U /*!< SCB HFSR: DEBUGEVT Position */ +#define SCB_HFSR_DEBUGEVT_Msk (1UL << SCB_HFSR_DEBUGEVT_Pos) /*!< SCB HFSR: DEBUGEVT Mask */ + +#define SCB_HFSR_FORCED_Pos 30U /*!< SCB HFSR: FORCED Position */ +#define SCB_HFSR_FORCED_Msk (1UL << SCB_HFSR_FORCED_Pos) /*!< SCB HFSR: FORCED Mask */ + +#define SCB_HFSR_VECTTBL_Pos 1U /*!< SCB HFSR: VECTTBL Position */ +#define SCB_HFSR_VECTTBL_Msk (1UL << SCB_HFSR_VECTTBL_Pos) /*!< SCB HFSR: VECTTBL Mask */ + +/* SCB Debug Fault Status Register Definitions */ +#define SCB_DFSR_EXTERNAL_Pos 4U /*!< SCB DFSR: EXTERNAL Position */ +#define SCB_DFSR_EXTERNAL_Msk (1UL << SCB_DFSR_EXTERNAL_Pos) /*!< SCB DFSR: EXTERNAL Mask */ + +#define SCB_DFSR_VCATCH_Pos 3U /*!< SCB DFSR: VCATCH Position */ +#define SCB_DFSR_VCATCH_Msk (1UL << SCB_DFSR_VCATCH_Pos) /*!< SCB DFSR: VCATCH Mask */ + +#define SCB_DFSR_DWTTRAP_Pos 2U /*!< SCB DFSR: DWTTRAP Position */ +#define SCB_DFSR_DWTTRAP_Msk (1UL << SCB_DFSR_DWTTRAP_Pos) /*!< SCB DFSR: DWTTRAP Mask */ + +#define SCB_DFSR_BKPT_Pos 1U /*!< SCB DFSR: BKPT Position */ +#define SCB_DFSR_BKPT_Msk (1UL << SCB_DFSR_BKPT_Pos) /*!< SCB DFSR: BKPT Mask */ + +#define SCB_DFSR_HALTED_Pos 0U /*!< SCB DFSR: HALTED Position */ +#define SCB_DFSR_HALTED_Msk (1UL /*<< SCB_DFSR_HALTED_Pos*/) /*!< SCB DFSR: HALTED Mask */ + +/*@} end of group CMSIS_SCB */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_SCnSCB System Controls not in SCB (SCnSCB) + \brief Type definitions for the System Control and ID Register not in the SCB + @{ + */ + +/** + \brief Structure type to access the System Control and ID Register not in the SCB. + */ +typedef struct +{ + uint32_t RESERVED0[1U]; + __IM uint32_t ICTR; /*!< Offset: 0x004 (R/ ) Interrupt Controller Type Register */ +#if ((defined __CM3_REV) && (__CM3_REV >= 0x200U)) + __IOM uint32_t ACTLR; /*!< Offset: 0x008 (R/W) Auxiliary Control Register */ +#else + uint32_t RESERVED1[1U]; +#endif +} SCnSCB_Type; + +/* Interrupt Controller Type Register Definitions */ +#define SCnSCB_ICTR_INTLINESNUM_Pos 0U /*!< ICTR: INTLINESNUM Position */ +#define SCnSCB_ICTR_INTLINESNUM_Msk (0xFUL /*<< SCnSCB_ICTR_INTLINESNUM_Pos*/) /*!< ICTR: INTLINESNUM Mask */ + +/* Auxiliary Control Register Definitions */ + +#define SCnSCB_ACTLR_DISFOLD_Pos 2U /*!< ACTLR: DISFOLD Position */ +#define SCnSCB_ACTLR_DISFOLD_Msk (1UL << SCnSCB_ACTLR_DISFOLD_Pos) /*!< ACTLR: DISFOLD Mask */ + +#define SCnSCB_ACTLR_DISDEFWBUF_Pos 1U /*!< ACTLR: DISDEFWBUF Position */ +#define SCnSCB_ACTLR_DISDEFWBUF_Msk (1UL << SCnSCB_ACTLR_DISDEFWBUF_Pos) /*!< ACTLR: DISDEFWBUF Mask */ + +#define SCnSCB_ACTLR_DISMCYCINT_Pos 0U /*!< ACTLR: DISMCYCINT Position */ +#define SCnSCB_ACTLR_DISMCYCINT_Msk (1UL /*<< SCnSCB_ACTLR_DISMCYCINT_Pos*/) /*!< ACTLR: DISMCYCINT Mask */ + +/*@} end of group CMSIS_SCnotSCB */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_SysTick System Tick Timer (SysTick) + \brief Type definitions for the System Timer Registers. + @{ + */ + +/** + \brief Structure type to access the System Timer (SysTick). + */ +typedef struct +{ + __IOM uint32_t CTRL; /*!< Offset: 0x000 (R/W) SysTick Control and Status Register */ + __IOM uint32_t LOAD; /*!< Offset: 0x004 (R/W) SysTick Reload Value Register */ + __IOM uint32_t VAL; /*!< Offset: 0x008 (R/W) SysTick Current Value Register */ + __IM uint32_t CALIB; /*!< Offset: 0x00C (R/ ) SysTick Calibration Register */ +} SysTick_Type; + +/* SysTick Control / Status Register Definitions */ +#define SysTick_CTRL_COUNTFLAG_Pos 16U /*!< SysTick CTRL: COUNTFLAG Position */ +#define SysTick_CTRL_COUNTFLAG_Msk (1UL << SysTick_CTRL_COUNTFLAG_Pos) /*!< SysTick CTRL: COUNTFLAG Mask */ + +#define SysTick_CTRL_CLKSOURCE_Pos 2U /*!< SysTick CTRL: CLKSOURCE Position */ +#define SysTick_CTRL_CLKSOURCE_Msk (1UL << SysTick_CTRL_CLKSOURCE_Pos) /*!< SysTick CTRL: CLKSOURCE Mask */ + +#define SysTick_CTRL_TICKINT_Pos 1U /*!< SysTick CTRL: TICKINT Position */ +#define SysTick_CTRL_TICKINT_Msk (1UL << SysTick_CTRL_TICKINT_Pos) /*!< SysTick CTRL: TICKINT Mask */ + +#define SysTick_CTRL_ENABLE_Pos 0U /*!< SysTick CTRL: ENABLE Position */ +#define SysTick_CTRL_ENABLE_Msk (1UL /*<< SysTick_CTRL_ENABLE_Pos*/) /*!< SysTick CTRL: ENABLE Mask */ + +/* SysTick Reload Register Definitions */ +#define SysTick_LOAD_RELOAD_Pos 0U /*!< SysTick LOAD: RELOAD Position */ +#define SysTick_LOAD_RELOAD_Msk (0xFFFFFFUL /*<< SysTick_LOAD_RELOAD_Pos*/) /*!< SysTick LOAD: RELOAD Mask */ + +/* SysTick Current Register Definitions */ +#define SysTick_VAL_CURRENT_Pos 0U /*!< SysTick VAL: CURRENT Position */ +#define SysTick_VAL_CURRENT_Msk (0xFFFFFFUL /*<< SysTick_VAL_CURRENT_Pos*/) /*!< SysTick VAL: CURRENT Mask */ + +/* SysTick Calibration Register Definitions */ +#define SysTick_CALIB_NOREF_Pos 31U /*!< SysTick CALIB: NOREF Position */ +#define SysTick_CALIB_NOREF_Msk (1UL << SysTick_CALIB_NOREF_Pos) /*!< SysTick CALIB: NOREF Mask */ + +#define SysTick_CALIB_SKEW_Pos 30U /*!< SysTick CALIB: SKEW Position */ +#define SysTick_CALIB_SKEW_Msk (1UL << SysTick_CALIB_SKEW_Pos) /*!< SysTick CALIB: SKEW Mask */ + +#define SysTick_CALIB_TENMS_Pos 0U /*!< SysTick CALIB: TENMS Position */ +#define SysTick_CALIB_TENMS_Msk (0xFFFFFFUL /*<< SysTick_CALIB_TENMS_Pos*/) /*!< SysTick CALIB: TENMS Mask */ + +/*@} end of group CMSIS_SysTick */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_ITM Instrumentation Trace Macrocell (ITM) + \brief Type definitions for the Instrumentation Trace Macrocell (ITM) + @{ + */ + +/** + \brief Structure type to access the Instrumentation Trace Macrocell Register (ITM). + */ +typedef struct +{ + __OM union + { + __OM uint8_t u8; /*!< Offset: 0x000 ( /W) ITM Stimulus Port 8-bit */ + __OM uint16_t u16; /*!< Offset: 0x000 ( /W) ITM Stimulus Port 16-bit */ + __OM uint32_t u32; /*!< Offset: 0x000 ( /W) ITM Stimulus Port 32-bit */ + } PORT [32U]; /*!< Offset: 0x000 ( /W) ITM Stimulus Port Registers */ + uint32_t RESERVED0[864U]; + __IOM uint32_t TER; /*!< Offset: 0xE00 (R/W) ITM Trace Enable Register */ + uint32_t RESERVED1[15U]; + __IOM uint32_t TPR; /*!< Offset: 0xE40 (R/W) ITM Trace Privilege Register */ + uint32_t RESERVED2[15U]; + __IOM uint32_t TCR; /*!< Offset: 0xE80 (R/W) ITM Trace Control Register */ + uint32_t RESERVED3[29U]; + __OM uint32_t IWR; /*!< Offset: 0xEF8 ( /W) ITM Integration Write Register */ + __IM uint32_t IRR; /*!< Offset: 0xEFC (R/ ) ITM Integration Read Register */ + __IOM uint32_t IMCR; /*!< Offset: 0xF00 (R/W) ITM Integration Mode Control Register */ + uint32_t RESERVED4[43U]; + __OM uint32_t LAR; /*!< Offset: 0xFB0 ( /W) ITM Lock Access Register */ + __IM uint32_t LSR; /*!< Offset: 0xFB4 (R/ ) ITM Lock Status Register */ + uint32_t RESERVED5[6U]; + __IM uint32_t PID4; /*!< Offset: 0xFD0 (R/ ) ITM Peripheral Identification Register #4 */ + __IM uint32_t PID5; /*!< Offset: 0xFD4 (R/ ) ITM Peripheral Identification Register #5 */ + __IM uint32_t PID6; /*!< Offset: 0xFD8 (R/ ) ITM Peripheral Identification Register #6 */ + __IM uint32_t PID7; /*!< Offset: 0xFDC (R/ ) ITM Peripheral Identification Register #7 */ + __IM uint32_t PID0; /*!< Offset: 0xFE0 (R/ ) ITM Peripheral Identification Register #0 */ + __IM uint32_t PID1; /*!< Offset: 0xFE4 (R/ ) ITM Peripheral Identification Register #1 */ + __IM uint32_t PID2; /*!< Offset: 0xFE8 (R/ ) ITM Peripheral Identification Register #2 */ + __IM uint32_t PID3; /*!< Offset: 0xFEC (R/ ) ITM Peripheral Identification Register #3 */ + __IM uint32_t CID0; /*!< Offset: 0xFF0 (R/ ) ITM Component Identification Register #0 */ + __IM uint32_t CID1; /*!< Offset: 0xFF4 (R/ ) ITM Component Identification Register #1 */ + __IM uint32_t CID2; /*!< Offset: 0xFF8 (R/ ) ITM Component Identification Register #2 */ + __IM uint32_t CID3; /*!< Offset: 0xFFC (R/ ) ITM Component Identification Register #3 */ +} ITM_Type; + +/* ITM Trace Privilege Register Definitions */ +#define ITM_TPR_PRIVMASK_Pos 0U /*!< ITM TPR: PRIVMASK Position */ +#define ITM_TPR_PRIVMASK_Msk (0xFUL /*<< ITM_TPR_PRIVMASK_Pos*/) /*!< ITM TPR: PRIVMASK Mask */ + +/* ITM Trace Control Register Definitions */ +#define ITM_TCR_BUSY_Pos 23U /*!< ITM TCR: BUSY Position */ +#define ITM_TCR_BUSY_Msk (1UL << ITM_TCR_BUSY_Pos) /*!< ITM TCR: BUSY Mask */ + +#define ITM_TCR_TraceBusID_Pos 16U /*!< ITM TCR: ATBID Position */ +#define ITM_TCR_TraceBusID_Msk (0x7FUL << ITM_TCR_TraceBusID_Pos) /*!< ITM TCR: ATBID Mask */ + +#define ITM_TCR_GTSFREQ_Pos 10U /*!< ITM TCR: Global timestamp frequency Position */ +#define ITM_TCR_GTSFREQ_Msk (3UL << ITM_TCR_GTSFREQ_Pos) /*!< ITM TCR: Global timestamp frequency Mask */ + +#define ITM_TCR_TSPrescale_Pos 8U /*!< ITM TCR: TSPrescale Position */ +#define ITM_TCR_TSPrescale_Msk (3UL << ITM_TCR_TSPrescale_Pos) /*!< ITM TCR: TSPrescale Mask */ + +#define ITM_TCR_SWOENA_Pos 4U /*!< ITM TCR: SWOENA Position */ +#define ITM_TCR_SWOENA_Msk (1UL << ITM_TCR_SWOENA_Pos) /*!< ITM TCR: SWOENA Mask */ + +#define ITM_TCR_DWTENA_Pos 3U /*!< ITM TCR: DWTENA Position */ +#define ITM_TCR_DWTENA_Msk (1UL << ITM_TCR_DWTENA_Pos) /*!< ITM TCR: DWTENA Mask */ + +#define ITM_TCR_SYNCENA_Pos 2U /*!< ITM TCR: SYNCENA Position */ +#define ITM_TCR_SYNCENA_Msk (1UL << ITM_TCR_SYNCENA_Pos) /*!< ITM TCR: SYNCENA Mask */ + +#define ITM_TCR_TSENA_Pos 1U /*!< ITM TCR: TSENA Position */ +#define ITM_TCR_TSENA_Msk (1UL << ITM_TCR_TSENA_Pos) /*!< ITM TCR: TSENA Mask */ + +#define ITM_TCR_ITMENA_Pos 0U /*!< ITM TCR: ITM Enable bit Position */ +#define ITM_TCR_ITMENA_Msk (1UL /*<< ITM_TCR_ITMENA_Pos*/) /*!< ITM TCR: ITM Enable bit Mask */ + +/* ITM Integration Write Register Definitions */ +#define ITM_IWR_ATVALIDM_Pos 0U /*!< ITM IWR: ATVALIDM Position */ +#define ITM_IWR_ATVALIDM_Msk (1UL /*<< ITM_IWR_ATVALIDM_Pos*/) /*!< ITM IWR: ATVALIDM Mask */ + +/* ITM Integration Read Register Definitions */ +#define ITM_IRR_ATREADYM_Pos 0U /*!< ITM IRR: ATREADYM Position */ +#define ITM_IRR_ATREADYM_Msk (1UL /*<< ITM_IRR_ATREADYM_Pos*/) /*!< ITM IRR: ATREADYM Mask */ + +/* ITM Integration Mode Control Register Definitions */ +#define ITM_IMCR_INTEGRATION_Pos 0U /*!< ITM IMCR: INTEGRATION Position */ +#define ITM_IMCR_INTEGRATION_Msk (1UL /*<< ITM_IMCR_INTEGRATION_Pos*/) /*!< ITM IMCR: INTEGRATION Mask */ + +/* ITM Lock Status Register Definitions */ +#define ITM_LSR_ByteAcc_Pos 2U /*!< ITM LSR: ByteAcc Position */ +#define ITM_LSR_ByteAcc_Msk (1UL << ITM_LSR_ByteAcc_Pos) /*!< ITM LSR: ByteAcc Mask */ + +#define ITM_LSR_Access_Pos 1U /*!< ITM LSR: Access Position */ +#define ITM_LSR_Access_Msk (1UL << ITM_LSR_Access_Pos) /*!< ITM LSR: Access Mask */ + +#define ITM_LSR_Present_Pos 0U /*!< ITM LSR: Present Position */ +#define ITM_LSR_Present_Msk (1UL /*<< ITM_LSR_Present_Pos*/) /*!< ITM LSR: Present Mask */ + +/*@}*/ /* end of group CMSIS_ITM */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_DWT Data Watchpoint and Trace (DWT) + \brief Type definitions for the Data Watchpoint and Trace (DWT) + @{ + */ + +/** + \brief Structure type to access the Data Watchpoint and Trace Register (DWT). + */ +typedef struct +{ + __IOM uint32_t CTRL; /*!< Offset: 0x000 (R/W) Control Register */ + __IOM uint32_t CYCCNT; /*!< Offset: 0x004 (R/W) Cycle Count Register */ + __IOM uint32_t CPICNT; /*!< Offset: 0x008 (R/W) CPI Count Register */ + __IOM uint32_t EXCCNT; /*!< Offset: 0x00C (R/W) Exception Overhead Count Register */ + __IOM uint32_t SLEEPCNT; /*!< Offset: 0x010 (R/W) Sleep Count Register */ + __IOM uint32_t LSUCNT; /*!< Offset: 0x014 (R/W) LSU Count Register */ + __IOM uint32_t FOLDCNT; /*!< Offset: 0x018 (R/W) Folded-instruction Count Register */ + __IM uint32_t PCSR; /*!< Offset: 0x01C (R/ ) Program Counter Sample Register */ + __IOM uint32_t COMP0; /*!< Offset: 0x020 (R/W) Comparator Register 0 */ + __IOM uint32_t MASK0; /*!< Offset: 0x024 (R/W) Mask Register 0 */ + __IOM uint32_t FUNCTION0; /*!< Offset: 0x028 (R/W) Function Register 0 */ + uint32_t RESERVED0[1U]; + __IOM uint32_t COMP1; /*!< Offset: 0x030 (R/W) Comparator Register 1 */ + __IOM uint32_t MASK1; /*!< Offset: 0x034 (R/W) Mask Register 1 */ + __IOM uint32_t FUNCTION1; /*!< Offset: 0x038 (R/W) Function Register 1 */ + uint32_t RESERVED1[1U]; + __IOM uint32_t COMP2; /*!< Offset: 0x040 (R/W) Comparator Register 2 */ + __IOM uint32_t MASK2; /*!< Offset: 0x044 (R/W) Mask Register 2 */ + __IOM uint32_t FUNCTION2; /*!< Offset: 0x048 (R/W) Function Register 2 */ + uint32_t RESERVED2[1U]; + __IOM uint32_t COMP3; /*!< Offset: 0x050 (R/W) Comparator Register 3 */ + __IOM uint32_t MASK3; /*!< Offset: 0x054 (R/W) Mask Register 3 */ + __IOM uint32_t FUNCTION3; /*!< Offset: 0x058 (R/W) Function Register 3 */ +} DWT_Type; + +/* DWT Control Register Definitions */ +#define DWT_CTRL_NUMCOMP_Pos 28U /*!< DWT CTRL: NUMCOMP Position */ +#define DWT_CTRL_NUMCOMP_Msk (0xFUL << DWT_CTRL_NUMCOMP_Pos) /*!< DWT CTRL: NUMCOMP Mask */ + +#define DWT_CTRL_NOTRCPKT_Pos 27U /*!< DWT CTRL: NOTRCPKT Position */ +#define DWT_CTRL_NOTRCPKT_Msk (0x1UL << DWT_CTRL_NOTRCPKT_Pos) /*!< DWT CTRL: NOTRCPKT Mask */ + +#define DWT_CTRL_NOEXTTRIG_Pos 26U /*!< DWT CTRL: NOEXTTRIG Position */ +#define DWT_CTRL_NOEXTTRIG_Msk (0x1UL << DWT_CTRL_NOEXTTRIG_Pos) /*!< DWT CTRL: NOEXTTRIG Mask */ + +#define DWT_CTRL_NOCYCCNT_Pos 25U /*!< DWT CTRL: NOCYCCNT Position */ +#define DWT_CTRL_NOCYCCNT_Msk (0x1UL << DWT_CTRL_NOCYCCNT_Pos) /*!< DWT CTRL: NOCYCCNT Mask */ + +#define DWT_CTRL_NOPRFCNT_Pos 24U /*!< DWT CTRL: NOPRFCNT Position */ +#define DWT_CTRL_NOPRFCNT_Msk (0x1UL << DWT_CTRL_NOPRFCNT_Pos) /*!< DWT CTRL: NOPRFCNT Mask */ + +#define DWT_CTRL_CYCEVTENA_Pos 22U /*!< DWT CTRL: CYCEVTENA Position */ +#define DWT_CTRL_CYCEVTENA_Msk (0x1UL << DWT_CTRL_CYCEVTENA_Pos) /*!< DWT CTRL: CYCEVTENA Mask */ + +#define DWT_CTRL_FOLDEVTENA_Pos 21U /*!< DWT CTRL: FOLDEVTENA Position */ +#define DWT_CTRL_FOLDEVTENA_Msk (0x1UL << DWT_CTRL_FOLDEVTENA_Pos) /*!< DWT CTRL: FOLDEVTENA Mask */ + +#define DWT_CTRL_LSUEVTENA_Pos 20U /*!< DWT CTRL: LSUEVTENA Position */ +#define DWT_CTRL_LSUEVTENA_Msk (0x1UL << DWT_CTRL_LSUEVTENA_Pos) /*!< DWT CTRL: LSUEVTENA Mask */ + +#define DWT_CTRL_SLEEPEVTENA_Pos 19U /*!< DWT CTRL: SLEEPEVTENA Position */ +#define DWT_CTRL_SLEEPEVTENA_Msk (0x1UL << DWT_CTRL_SLEEPEVTENA_Pos) /*!< DWT CTRL: SLEEPEVTENA Mask */ + +#define DWT_CTRL_EXCEVTENA_Pos 18U /*!< DWT CTRL: EXCEVTENA Position */ +#define DWT_CTRL_EXCEVTENA_Msk (0x1UL << DWT_CTRL_EXCEVTENA_Pos) /*!< DWT CTRL: EXCEVTENA Mask */ + +#define DWT_CTRL_CPIEVTENA_Pos 17U /*!< DWT CTRL: CPIEVTENA Position */ +#define DWT_CTRL_CPIEVTENA_Msk (0x1UL << DWT_CTRL_CPIEVTENA_Pos) /*!< DWT CTRL: CPIEVTENA Mask */ + +#define DWT_CTRL_EXCTRCENA_Pos 16U /*!< DWT CTRL: EXCTRCENA Position */ +#define DWT_CTRL_EXCTRCENA_Msk (0x1UL << DWT_CTRL_EXCTRCENA_Pos) /*!< DWT CTRL: EXCTRCENA Mask */ + +#define DWT_CTRL_PCSAMPLENA_Pos 12U /*!< DWT CTRL: PCSAMPLENA Position */ +#define DWT_CTRL_PCSAMPLENA_Msk (0x1UL << DWT_CTRL_PCSAMPLENA_Pos) /*!< DWT CTRL: PCSAMPLENA Mask */ + +#define DWT_CTRL_SYNCTAP_Pos 10U /*!< DWT CTRL: SYNCTAP Position */ +#define DWT_CTRL_SYNCTAP_Msk (0x3UL << DWT_CTRL_SYNCTAP_Pos) /*!< DWT CTRL: SYNCTAP Mask */ + +#define DWT_CTRL_CYCTAP_Pos 9U /*!< DWT CTRL: CYCTAP Position */ +#define DWT_CTRL_CYCTAP_Msk (0x1UL << DWT_CTRL_CYCTAP_Pos) /*!< DWT CTRL: CYCTAP Mask */ + +#define DWT_CTRL_POSTINIT_Pos 5U /*!< DWT CTRL: POSTINIT Position */ +#define DWT_CTRL_POSTINIT_Msk (0xFUL << DWT_CTRL_POSTINIT_Pos) /*!< DWT CTRL: POSTINIT Mask */ + +#define DWT_CTRL_POSTPRESET_Pos 1U /*!< DWT CTRL: POSTPRESET Position */ +#define DWT_CTRL_POSTPRESET_Msk (0xFUL << DWT_CTRL_POSTPRESET_Pos) /*!< DWT CTRL: POSTPRESET Mask */ + +#define DWT_CTRL_CYCCNTENA_Pos 0U /*!< DWT CTRL: CYCCNTENA Position */ +#define DWT_CTRL_CYCCNTENA_Msk (0x1UL /*<< DWT_CTRL_CYCCNTENA_Pos*/) /*!< DWT CTRL: CYCCNTENA Mask */ + +/* DWT CPI Count Register Definitions */ +#define DWT_CPICNT_CPICNT_Pos 0U /*!< DWT CPICNT: CPICNT Position */ +#define DWT_CPICNT_CPICNT_Msk (0xFFUL /*<< DWT_CPICNT_CPICNT_Pos*/) /*!< DWT CPICNT: CPICNT Mask */ + +/* DWT Exception Overhead Count Register Definitions */ +#define DWT_EXCCNT_EXCCNT_Pos 0U /*!< DWT EXCCNT: EXCCNT Position */ +#define DWT_EXCCNT_EXCCNT_Msk (0xFFUL /*<< DWT_EXCCNT_EXCCNT_Pos*/) /*!< DWT EXCCNT: EXCCNT Mask */ + +/* DWT Sleep Count Register Definitions */ +#define DWT_SLEEPCNT_SLEEPCNT_Pos 0U /*!< DWT SLEEPCNT: SLEEPCNT Position */ +#define DWT_SLEEPCNT_SLEEPCNT_Msk (0xFFUL /*<< DWT_SLEEPCNT_SLEEPCNT_Pos*/) /*!< DWT SLEEPCNT: SLEEPCNT Mask */ + +/* DWT LSU Count Register Definitions */ +#define DWT_LSUCNT_LSUCNT_Pos 0U /*!< DWT LSUCNT: LSUCNT Position */ +#define DWT_LSUCNT_LSUCNT_Msk (0xFFUL /*<< DWT_LSUCNT_LSUCNT_Pos*/) /*!< DWT LSUCNT: LSUCNT Mask */ + +/* DWT Folded-instruction Count Register Definitions */ +#define DWT_FOLDCNT_FOLDCNT_Pos 0U /*!< DWT FOLDCNT: FOLDCNT Position */ +#define DWT_FOLDCNT_FOLDCNT_Msk (0xFFUL /*<< DWT_FOLDCNT_FOLDCNT_Pos*/) /*!< DWT FOLDCNT: FOLDCNT Mask */ + +/* DWT Comparator Mask Register Definitions */ +#define DWT_MASK_MASK_Pos 0U /*!< DWT MASK: MASK Position */ +#define DWT_MASK_MASK_Msk (0x1FUL /*<< DWT_MASK_MASK_Pos*/) /*!< DWT MASK: MASK Mask */ + +/* DWT Comparator Function Register Definitions */ +#define DWT_FUNCTION_MATCHED_Pos 24U /*!< DWT FUNCTION: MATCHED Position */ +#define DWT_FUNCTION_MATCHED_Msk (0x1UL << DWT_FUNCTION_MATCHED_Pos) /*!< DWT FUNCTION: MATCHED Mask */ + +#define DWT_FUNCTION_DATAVADDR1_Pos 16U /*!< DWT FUNCTION: DATAVADDR1 Position */ +#define DWT_FUNCTION_DATAVADDR1_Msk (0xFUL << DWT_FUNCTION_DATAVADDR1_Pos) /*!< DWT FUNCTION: DATAVADDR1 Mask */ + +#define DWT_FUNCTION_DATAVADDR0_Pos 12U /*!< DWT FUNCTION: DATAVADDR0 Position */ +#define DWT_FUNCTION_DATAVADDR0_Msk (0xFUL << DWT_FUNCTION_DATAVADDR0_Pos) /*!< DWT FUNCTION: DATAVADDR0 Mask */ + +#define DWT_FUNCTION_DATAVSIZE_Pos 10U /*!< DWT FUNCTION: DATAVSIZE Position */ +#define DWT_FUNCTION_DATAVSIZE_Msk (0x3UL << DWT_FUNCTION_DATAVSIZE_Pos) /*!< DWT FUNCTION: DATAVSIZE Mask */ + +#define DWT_FUNCTION_LNK1ENA_Pos 9U /*!< DWT FUNCTION: LNK1ENA Position */ +#define DWT_FUNCTION_LNK1ENA_Msk (0x1UL << DWT_FUNCTION_LNK1ENA_Pos) /*!< DWT FUNCTION: LNK1ENA Mask */ + +#define DWT_FUNCTION_DATAVMATCH_Pos 8U /*!< DWT FUNCTION: DATAVMATCH Position */ +#define DWT_FUNCTION_DATAVMATCH_Msk (0x1UL << DWT_FUNCTION_DATAVMATCH_Pos) /*!< DWT FUNCTION: DATAVMATCH Mask */ + +#define DWT_FUNCTION_CYCMATCH_Pos 7U /*!< DWT FUNCTION: CYCMATCH Position */ +#define DWT_FUNCTION_CYCMATCH_Msk (0x1UL << DWT_FUNCTION_CYCMATCH_Pos) /*!< DWT FUNCTION: CYCMATCH Mask */ + +#define DWT_FUNCTION_EMITRANGE_Pos 5U /*!< DWT FUNCTION: EMITRANGE Position */ +#define DWT_FUNCTION_EMITRANGE_Msk (0x1UL << DWT_FUNCTION_EMITRANGE_Pos) /*!< DWT FUNCTION: EMITRANGE Mask */ + +#define DWT_FUNCTION_FUNCTION_Pos 0U /*!< DWT FUNCTION: FUNCTION Position */ +#define DWT_FUNCTION_FUNCTION_Msk (0xFUL /*<< DWT_FUNCTION_FUNCTION_Pos*/) /*!< DWT FUNCTION: FUNCTION Mask */ + +/*@}*/ /* end of group CMSIS_DWT */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_TPI Trace Port Interface (TPI) + \brief Type definitions for the Trace Port Interface (TPI) + @{ + */ + +/** + \brief Structure type to access the Trace Port Interface Register (TPI). + */ +typedef struct +{ + __IOM uint32_t SSPSR; /*!< Offset: 0x000 (R/ ) Supported Parallel Port Size Register */ + __IOM uint32_t CSPSR; /*!< Offset: 0x004 (R/W) Current Parallel Port Size Register */ + uint32_t RESERVED0[2U]; + __IOM uint32_t ACPR; /*!< Offset: 0x010 (R/W) Asynchronous Clock Prescaler Register */ + uint32_t RESERVED1[55U]; + __IOM uint32_t SPPR; /*!< Offset: 0x0F0 (R/W) Selected Pin Protocol Register */ + uint32_t RESERVED2[131U]; + __IM uint32_t FFSR; /*!< Offset: 0x300 (R/ ) Formatter and Flush Status Register */ + __IOM uint32_t FFCR; /*!< Offset: 0x304 (R/W) Formatter and Flush Control Register */ + __IM uint32_t FSCR; /*!< Offset: 0x308 (R/ ) Formatter Synchronization Counter Register */ + uint32_t RESERVED3[759U]; + __IM uint32_t TRIGGER; /*!< Offset: 0xEE8 (R/ ) TRIGGER */ + __IM uint32_t FIFO0; /*!< Offset: 0xEEC (R/ ) Integration ETM Data */ + __IM uint32_t ITATBCTR2; /*!< Offset: 0xEF0 (R/ ) ITATBCTR2 */ + uint32_t RESERVED4[1U]; + __IM uint32_t ITATBCTR0; /*!< Offset: 0xEF8 (R/ ) ITATBCTR0 */ + __IM uint32_t FIFO1; /*!< Offset: 0xEFC (R/ ) Integration ITM Data */ + __IOM uint32_t ITCTRL; /*!< Offset: 0xF00 (R/W) Integration Mode Control */ + uint32_t RESERVED5[39U]; + __IOM uint32_t CLAIMSET; /*!< Offset: 0xFA0 (R/W) Claim tag set */ + __IOM uint32_t CLAIMCLR; /*!< Offset: 0xFA4 (R/W) Claim tag clear */ + uint32_t RESERVED7[8U]; + __IM uint32_t DEVID; /*!< Offset: 0xFC8 (R/ ) TPIU_DEVID */ + __IM uint32_t DEVTYPE; /*!< Offset: 0xFCC (R/ ) TPIU_DEVTYPE */ +} TPI_Type; + +/* TPI Asynchronous Clock Prescaler Register Definitions */ +#define TPI_ACPR_PRESCALER_Pos 0U /*!< TPI ACPR: PRESCALER Position */ +#define TPI_ACPR_PRESCALER_Msk (0x1FFFUL /*<< TPI_ACPR_PRESCALER_Pos*/) /*!< TPI ACPR: PRESCALER Mask */ + +/* TPI Selected Pin Protocol Register Definitions */ +#define TPI_SPPR_TXMODE_Pos 0U /*!< TPI SPPR: TXMODE Position */ +#define TPI_SPPR_TXMODE_Msk (0x3UL /*<< TPI_SPPR_TXMODE_Pos*/) /*!< TPI SPPR: TXMODE Mask */ + +/* TPI Formatter and Flush Status Register Definitions */ +#define TPI_FFSR_FtNonStop_Pos 3U /*!< TPI FFSR: FtNonStop Position */ +#define TPI_FFSR_FtNonStop_Msk (0x1UL << TPI_FFSR_FtNonStop_Pos) /*!< TPI FFSR: FtNonStop Mask */ + +#define TPI_FFSR_TCPresent_Pos 2U /*!< TPI FFSR: TCPresent Position */ +#define TPI_FFSR_TCPresent_Msk (0x1UL << TPI_FFSR_TCPresent_Pos) /*!< TPI FFSR: TCPresent Mask */ + +#define TPI_FFSR_FtStopped_Pos 1U /*!< TPI FFSR: FtStopped Position */ +#define TPI_FFSR_FtStopped_Msk (0x1UL << TPI_FFSR_FtStopped_Pos) /*!< TPI FFSR: FtStopped Mask */ + +#define TPI_FFSR_FlInProg_Pos 0U /*!< TPI FFSR: FlInProg Position */ +#define TPI_FFSR_FlInProg_Msk (0x1UL /*<< TPI_FFSR_FlInProg_Pos*/) /*!< TPI FFSR: FlInProg Mask */ + +/* TPI Formatter and Flush Control Register Definitions */ +#define TPI_FFCR_TrigIn_Pos 8U /*!< TPI FFCR: TrigIn Position */ +#define TPI_FFCR_TrigIn_Msk (0x1UL << TPI_FFCR_TrigIn_Pos) /*!< TPI FFCR: TrigIn Mask */ + +#define TPI_FFCR_EnFCont_Pos 1U /*!< TPI FFCR: EnFCont Position */ +#define TPI_FFCR_EnFCont_Msk (0x1UL << TPI_FFCR_EnFCont_Pos) /*!< TPI FFCR: EnFCont Mask */ + +/* TPI TRIGGER Register Definitions */ +#define TPI_TRIGGER_TRIGGER_Pos 0U /*!< TPI TRIGGER: TRIGGER Position */ +#define TPI_TRIGGER_TRIGGER_Msk (0x1UL /*<< TPI_TRIGGER_TRIGGER_Pos*/) /*!< TPI TRIGGER: TRIGGER Mask */ + +/* TPI Integration ETM Data Register Definitions (FIFO0) */ +#define TPI_FIFO0_ITM_ATVALID_Pos 29U /*!< TPI FIFO0: ITM_ATVALID Position */ +#define TPI_FIFO0_ITM_ATVALID_Msk (0x3UL << TPI_FIFO0_ITM_ATVALID_Pos) /*!< TPI FIFO0: ITM_ATVALID Mask */ + +#define TPI_FIFO0_ITM_bytecount_Pos 27U /*!< TPI FIFO0: ITM_bytecount Position */ +#define TPI_FIFO0_ITM_bytecount_Msk (0x3UL << TPI_FIFO0_ITM_bytecount_Pos) /*!< TPI FIFO0: ITM_bytecount Mask */ + +#define TPI_FIFO0_ETM_ATVALID_Pos 26U /*!< TPI FIFO0: ETM_ATVALID Position */ +#define TPI_FIFO0_ETM_ATVALID_Msk (0x3UL << TPI_FIFO0_ETM_ATVALID_Pos) /*!< TPI FIFO0: ETM_ATVALID Mask */ + +#define TPI_FIFO0_ETM_bytecount_Pos 24U /*!< TPI FIFO0: ETM_bytecount Position */ +#define TPI_FIFO0_ETM_bytecount_Msk (0x3UL << TPI_FIFO0_ETM_bytecount_Pos) /*!< TPI FIFO0: ETM_bytecount Mask */ + +#define TPI_FIFO0_ETM2_Pos 16U /*!< TPI FIFO0: ETM2 Position */ +#define TPI_FIFO0_ETM2_Msk (0xFFUL << TPI_FIFO0_ETM2_Pos) /*!< TPI FIFO0: ETM2 Mask */ + +#define TPI_FIFO0_ETM1_Pos 8U /*!< TPI FIFO0: ETM1 Position */ +#define TPI_FIFO0_ETM1_Msk (0xFFUL << TPI_FIFO0_ETM1_Pos) /*!< TPI FIFO0: ETM1 Mask */ + +#define TPI_FIFO0_ETM0_Pos 0U /*!< TPI FIFO0: ETM0 Position */ +#define TPI_FIFO0_ETM0_Msk (0xFFUL /*<< TPI_FIFO0_ETM0_Pos*/) /*!< TPI FIFO0: ETM0 Mask */ + +/* TPI ITATBCTR2 Register Definitions */ +#define TPI_ITATBCTR2_ATREADY_Pos 0U /*!< TPI ITATBCTR2: ATREADY Position */ +#define TPI_ITATBCTR2_ATREADY_Msk (0x1UL /*<< TPI_ITATBCTR2_ATREADY_Pos*/) /*!< TPI ITATBCTR2: ATREADY Mask */ + +/* TPI Integration ITM Data Register Definitions (FIFO1) */ +#define TPI_FIFO1_ITM_ATVALID_Pos 29U /*!< TPI FIFO1: ITM_ATVALID Position */ +#define TPI_FIFO1_ITM_ATVALID_Msk (0x3UL << TPI_FIFO1_ITM_ATVALID_Pos) /*!< TPI FIFO1: ITM_ATVALID Mask */ + +#define TPI_FIFO1_ITM_bytecount_Pos 27U /*!< TPI FIFO1: ITM_bytecount Position */ +#define TPI_FIFO1_ITM_bytecount_Msk (0x3UL << TPI_FIFO1_ITM_bytecount_Pos) /*!< TPI FIFO1: ITM_bytecount Mask */ + +#define TPI_FIFO1_ETM_ATVALID_Pos 26U /*!< TPI FIFO1: ETM_ATVALID Position */ +#define TPI_FIFO1_ETM_ATVALID_Msk (0x3UL << TPI_FIFO1_ETM_ATVALID_Pos) /*!< TPI FIFO1: ETM_ATVALID Mask */ + +#define TPI_FIFO1_ETM_bytecount_Pos 24U /*!< TPI FIFO1: ETM_bytecount Position */ +#define TPI_FIFO1_ETM_bytecount_Msk (0x3UL << TPI_FIFO1_ETM_bytecount_Pos) /*!< TPI FIFO1: ETM_bytecount Mask */ + +#define TPI_FIFO1_ITM2_Pos 16U /*!< TPI FIFO1: ITM2 Position */ +#define TPI_FIFO1_ITM2_Msk (0xFFUL << TPI_FIFO1_ITM2_Pos) /*!< TPI FIFO1: ITM2 Mask */ + +#define TPI_FIFO1_ITM1_Pos 8U /*!< TPI FIFO1: ITM1 Position */ +#define TPI_FIFO1_ITM1_Msk (0xFFUL << TPI_FIFO1_ITM1_Pos) /*!< TPI FIFO1: ITM1 Mask */ + +#define TPI_FIFO1_ITM0_Pos 0U /*!< TPI FIFO1: ITM0 Position */ +#define TPI_FIFO1_ITM0_Msk (0xFFUL /*<< TPI_FIFO1_ITM0_Pos*/) /*!< TPI FIFO1: ITM0 Mask */ + +/* TPI ITATBCTR0 Register Definitions */ +#define TPI_ITATBCTR0_ATREADY_Pos 0U /*!< TPI ITATBCTR0: ATREADY Position */ +#define TPI_ITATBCTR0_ATREADY_Msk (0x1UL /*<< TPI_ITATBCTR0_ATREADY_Pos*/) /*!< TPI ITATBCTR0: ATREADY Mask */ + +/* TPI Integration Mode Control Register Definitions */ +#define TPI_ITCTRL_Mode_Pos 0U /*!< TPI ITCTRL: Mode Position */ +#define TPI_ITCTRL_Mode_Msk (0x1UL /*<< TPI_ITCTRL_Mode_Pos*/) /*!< TPI ITCTRL: Mode Mask */ + +/* TPI DEVID Register Definitions */ +#define TPI_DEVID_NRZVALID_Pos 11U /*!< TPI DEVID: NRZVALID Position */ +#define TPI_DEVID_NRZVALID_Msk (0x1UL << TPI_DEVID_NRZVALID_Pos) /*!< TPI DEVID: NRZVALID Mask */ + +#define TPI_DEVID_MANCVALID_Pos 10U /*!< TPI DEVID: MANCVALID Position */ +#define TPI_DEVID_MANCVALID_Msk (0x1UL << TPI_DEVID_MANCVALID_Pos) /*!< TPI DEVID: MANCVALID Mask */ + +#define TPI_DEVID_PTINVALID_Pos 9U /*!< TPI DEVID: PTINVALID Position */ +#define TPI_DEVID_PTINVALID_Msk (0x1UL << TPI_DEVID_PTINVALID_Pos) /*!< TPI DEVID: PTINVALID Mask */ + +#define TPI_DEVID_MinBufSz_Pos 6U /*!< TPI DEVID: MinBufSz Position */ +#define TPI_DEVID_MinBufSz_Msk (0x7UL << TPI_DEVID_MinBufSz_Pos) /*!< TPI DEVID: MinBufSz Mask */ + +#define TPI_DEVID_AsynClkIn_Pos 5U /*!< TPI DEVID: AsynClkIn Position */ +#define TPI_DEVID_AsynClkIn_Msk (0x1UL << TPI_DEVID_AsynClkIn_Pos) /*!< TPI DEVID: AsynClkIn Mask */ + +#define TPI_DEVID_NrTraceInput_Pos 0U /*!< TPI DEVID: NrTraceInput Position */ +#define TPI_DEVID_NrTraceInput_Msk (0x1FUL /*<< TPI_DEVID_NrTraceInput_Pos*/) /*!< TPI DEVID: NrTraceInput Mask */ + +/* TPI DEVTYPE Register Definitions */ +#define TPI_DEVTYPE_MajorType_Pos 4U /*!< TPI DEVTYPE: MajorType Position */ +#define TPI_DEVTYPE_MajorType_Msk (0xFUL << TPI_DEVTYPE_MajorType_Pos) /*!< TPI DEVTYPE: MajorType Mask */ + +#define TPI_DEVTYPE_SubType_Pos 0U /*!< TPI DEVTYPE: SubType Position */ +#define TPI_DEVTYPE_SubType_Msk (0xFUL /*<< TPI_DEVTYPE_SubType_Pos*/) /*!< TPI DEVTYPE: SubType Mask */ + +/*@}*/ /* end of group CMSIS_TPI */ + + +#if (__MPU_PRESENT == 1U) +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_MPU Memory Protection Unit (MPU) + \brief Type definitions for the Memory Protection Unit (MPU) + @{ + */ + +/** + \brief Structure type to access the Memory Protection Unit (MPU). + */ +typedef struct +{ + __IM uint32_t TYPE; /*!< Offset: 0x000 (R/ ) MPU Type Register */ + __IOM uint32_t CTRL; /*!< Offset: 0x004 (R/W) MPU Control Register */ + __IOM uint32_t RNR; /*!< Offset: 0x008 (R/W) MPU Region RNRber Register */ + __IOM uint32_t RBAR; /*!< Offset: 0x00C (R/W) MPU Region Base Address Register */ + __IOM uint32_t RASR; /*!< Offset: 0x010 (R/W) MPU Region Attribute and Size Register */ + __IOM uint32_t RBAR_A1; /*!< Offset: 0x014 (R/W) MPU Alias 1 Region Base Address Register */ + __IOM uint32_t RASR_A1; /*!< Offset: 0x018 (R/W) MPU Alias 1 Region Attribute and Size Register */ + __IOM uint32_t RBAR_A2; /*!< Offset: 0x01C (R/W) MPU Alias 2 Region Base Address Register */ + __IOM uint32_t RASR_A2; /*!< Offset: 0x020 (R/W) MPU Alias 2 Region Attribute and Size Register */ + __IOM uint32_t RBAR_A3; /*!< Offset: 0x024 (R/W) MPU Alias 3 Region Base Address Register */ + __IOM uint32_t RASR_A3; /*!< Offset: 0x028 (R/W) MPU Alias 3 Region Attribute and Size Register */ +} MPU_Type; + +/* MPU Type Register Definitions */ +#define MPU_TYPE_IREGION_Pos 16U /*!< MPU TYPE: IREGION Position */ +#define MPU_TYPE_IREGION_Msk (0xFFUL << MPU_TYPE_IREGION_Pos) /*!< MPU TYPE: IREGION Mask */ + +#define MPU_TYPE_DREGION_Pos 8U /*!< MPU TYPE: DREGION Position */ +#define MPU_TYPE_DREGION_Msk (0xFFUL << MPU_TYPE_DREGION_Pos) /*!< MPU TYPE: DREGION Mask */ + +#define MPU_TYPE_SEPARATE_Pos 0U /*!< MPU TYPE: SEPARATE Position */ +#define MPU_TYPE_SEPARATE_Msk (1UL /*<< MPU_TYPE_SEPARATE_Pos*/) /*!< MPU TYPE: SEPARATE Mask */ + +/* MPU Control Register Definitions */ +#define MPU_CTRL_PRIVDEFENA_Pos 2U /*!< MPU CTRL: PRIVDEFENA Position */ +#define MPU_CTRL_PRIVDEFENA_Msk (1UL << MPU_CTRL_PRIVDEFENA_Pos) /*!< MPU CTRL: PRIVDEFENA Mask */ + +#define MPU_CTRL_HFNMIENA_Pos 1U /*!< MPU CTRL: HFNMIENA Position */ +#define MPU_CTRL_HFNMIENA_Msk (1UL << MPU_CTRL_HFNMIENA_Pos) /*!< MPU CTRL: HFNMIENA Mask */ + +#define MPU_CTRL_ENABLE_Pos 0U /*!< MPU CTRL: ENABLE Position */ +#define MPU_CTRL_ENABLE_Msk (1UL /*<< MPU_CTRL_ENABLE_Pos*/) /*!< MPU CTRL: ENABLE Mask */ + +/* MPU Region Number Register Definitions */ +#define MPU_RNR_REGION_Pos 0U /*!< MPU RNR: REGION Position */ +#define MPU_RNR_REGION_Msk (0xFFUL /*<< MPU_RNR_REGION_Pos*/) /*!< MPU RNR: REGION Mask */ + +/* MPU Region Base Address Register Definitions */ +#define MPU_RBAR_ADDR_Pos 5U /*!< MPU RBAR: ADDR Position */ +#define MPU_RBAR_ADDR_Msk (0x7FFFFFFUL << MPU_RBAR_ADDR_Pos) /*!< MPU RBAR: ADDR Mask */ + +#define MPU_RBAR_VALID_Pos 4U /*!< MPU RBAR: VALID Position */ +#define MPU_RBAR_VALID_Msk (1UL << MPU_RBAR_VALID_Pos) /*!< MPU RBAR: VALID Mask */ + +#define MPU_RBAR_REGION_Pos 0U /*!< MPU RBAR: REGION Position */ +#define MPU_RBAR_REGION_Msk (0xFUL /*<< MPU_RBAR_REGION_Pos*/) /*!< MPU RBAR: REGION Mask */ + +/* MPU Region Attribute and Size Register Definitions */ +#define MPU_RASR_ATTRS_Pos 16U /*!< MPU RASR: MPU Region Attribute field Position */ +#define MPU_RASR_ATTRS_Msk (0xFFFFUL << MPU_RASR_ATTRS_Pos) /*!< MPU RASR: MPU Region Attribute field Mask */ + +#define MPU_RASR_XN_Pos 28U /*!< MPU RASR: ATTRS.XN Position */ +#define MPU_RASR_XN_Msk (1UL << MPU_RASR_XN_Pos) /*!< MPU RASR: ATTRS.XN Mask */ + +#define MPU_RASR_AP_Pos 24U /*!< MPU RASR: ATTRS.AP Position */ +#define MPU_RASR_AP_Msk (0x7UL << MPU_RASR_AP_Pos) /*!< MPU RASR: ATTRS.AP Mask */ + +#define MPU_RASR_TEX_Pos 19U /*!< MPU RASR: ATTRS.TEX Position */ +#define MPU_RASR_TEX_Msk (0x7UL << MPU_RASR_TEX_Pos) /*!< MPU RASR: ATTRS.TEX Mask */ + +#define MPU_RASR_S_Pos 18U /*!< MPU RASR: ATTRS.S Position */ +#define MPU_RASR_S_Msk (1UL << MPU_RASR_S_Pos) /*!< MPU RASR: ATTRS.S Mask */ + +#define MPU_RASR_C_Pos 17U /*!< MPU RASR: ATTRS.C Position */ +#define MPU_RASR_C_Msk (1UL << MPU_RASR_C_Pos) /*!< MPU RASR: ATTRS.C Mask */ + +#define MPU_RASR_B_Pos 16U /*!< MPU RASR: ATTRS.B Position */ +#define MPU_RASR_B_Msk (1UL << MPU_RASR_B_Pos) /*!< MPU RASR: ATTRS.B Mask */ + +#define MPU_RASR_SRD_Pos 8U /*!< MPU RASR: Sub-Region Disable Position */ +#define MPU_RASR_SRD_Msk (0xFFUL << MPU_RASR_SRD_Pos) /*!< MPU RASR: Sub-Region Disable Mask */ + +#define MPU_RASR_SIZE_Pos 1U /*!< MPU RASR: Region Size Field Position */ +#define MPU_RASR_SIZE_Msk (0x1FUL << MPU_RASR_SIZE_Pos) /*!< MPU RASR: Region Size Field Mask */ + +#define MPU_RASR_ENABLE_Pos 0U /*!< MPU RASR: Region enable bit Position */ +#define MPU_RASR_ENABLE_Msk (1UL /*<< MPU_RASR_ENABLE_Pos*/) /*!< MPU RASR: Region enable bit Disable Mask */ + +/*@} end of group CMSIS_MPU */ +#endif + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_CoreDebug Core Debug Registers (CoreDebug) + \brief Type definitions for the Core Debug Registers + @{ + */ + +/** + \brief Structure type to access the Core Debug Register (CoreDebug). + */ +typedef struct +{ + __IOM uint32_t DHCSR; /*!< Offset: 0x000 (R/W) Debug Halting Control and Status Register */ + __OM uint32_t DCRSR; /*!< Offset: 0x004 ( /W) Debug Core Register Selector Register */ + __IOM uint32_t DCRDR; /*!< Offset: 0x008 (R/W) Debug Core Register Data Register */ + __IOM uint32_t DEMCR; /*!< Offset: 0x00C (R/W) Debug Exception and Monitor Control Register */ +} CoreDebug_Type; + +/* Debug Halting Control and Status Register Definitions */ +#define CoreDebug_DHCSR_DBGKEY_Pos 16U /*!< CoreDebug DHCSR: DBGKEY Position */ +#define CoreDebug_DHCSR_DBGKEY_Msk (0xFFFFUL << CoreDebug_DHCSR_DBGKEY_Pos) /*!< CoreDebug DHCSR: DBGKEY Mask */ + +#define CoreDebug_DHCSR_S_RESET_ST_Pos 25U /*!< CoreDebug DHCSR: S_RESET_ST Position */ +#define CoreDebug_DHCSR_S_RESET_ST_Msk (1UL << CoreDebug_DHCSR_S_RESET_ST_Pos) /*!< CoreDebug DHCSR: S_RESET_ST Mask */ + +#define CoreDebug_DHCSR_S_RETIRE_ST_Pos 24U /*!< CoreDebug DHCSR: S_RETIRE_ST Position */ +#define CoreDebug_DHCSR_S_RETIRE_ST_Msk (1UL << CoreDebug_DHCSR_S_RETIRE_ST_Pos) /*!< CoreDebug DHCSR: S_RETIRE_ST Mask */ + +#define CoreDebug_DHCSR_S_LOCKUP_Pos 19U /*!< CoreDebug DHCSR: S_LOCKUP Position */ +#define CoreDebug_DHCSR_S_LOCKUP_Msk (1UL << CoreDebug_DHCSR_S_LOCKUP_Pos) /*!< CoreDebug DHCSR: S_LOCKUP Mask */ + +#define CoreDebug_DHCSR_S_SLEEP_Pos 18U /*!< CoreDebug DHCSR: S_SLEEP Position */ +#define CoreDebug_DHCSR_S_SLEEP_Msk (1UL << CoreDebug_DHCSR_S_SLEEP_Pos) /*!< CoreDebug DHCSR: S_SLEEP Mask */ + +#define CoreDebug_DHCSR_S_HALT_Pos 17U /*!< CoreDebug DHCSR: S_HALT Position */ +#define CoreDebug_DHCSR_S_HALT_Msk (1UL << CoreDebug_DHCSR_S_HALT_Pos) /*!< CoreDebug DHCSR: S_HALT Mask */ + +#define CoreDebug_DHCSR_S_REGRDY_Pos 16U /*!< CoreDebug DHCSR: S_REGRDY Position */ +#define CoreDebug_DHCSR_S_REGRDY_Msk (1UL << CoreDebug_DHCSR_S_REGRDY_Pos) /*!< CoreDebug DHCSR: S_REGRDY Mask */ + +#define CoreDebug_DHCSR_C_SNAPSTALL_Pos 5U /*!< CoreDebug DHCSR: C_SNAPSTALL Position */ +#define CoreDebug_DHCSR_C_SNAPSTALL_Msk (1UL << CoreDebug_DHCSR_C_SNAPSTALL_Pos) /*!< CoreDebug DHCSR: C_SNAPSTALL Mask */ + +#define CoreDebug_DHCSR_C_MASKINTS_Pos 3U /*!< CoreDebug DHCSR: C_MASKINTS Position */ +#define CoreDebug_DHCSR_C_MASKINTS_Msk (1UL << CoreDebug_DHCSR_C_MASKINTS_Pos) /*!< CoreDebug DHCSR: C_MASKINTS Mask */ + +#define CoreDebug_DHCSR_C_STEP_Pos 2U /*!< CoreDebug DHCSR: C_STEP Position */ +#define CoreDebug_DHCSR_C_STEP_Msk (1UL << CoreDebug_DHCSR_C_STEP_Pos) /*!< CoreDebug DHCSR: C_STEP Mask */ + +#define CoreDebug_DHCSR_C_HALT_Pos 1U /*!< CoreDebug DHCSR: C_HALT Position */ +#define CoreDebug_DHCSR_C_HALT_Msk (1UL << CoreDebug_DHCSR_C_HALT_Pos) /*!< CoreDebug DHCSR: C_HALT Mask */ + +#define CoreDebug_DHCSR_C_DEBUGEN_Pos 0U /*!< CoreDebug DHCSR: C_DEBUGEN Position */ +#define CoreDebug_DHCSR_C_DEBUGEN_Msk (1UL /*<< CoreDebug_DHCSR_C_DEBUGEN_Pos*/) /*!< CoreDebug DHCSR: C_DEBUGEN Mask */ + +/* Debug Core Register Selector Register Definitions */ +#define CoreDebug_DCRSR_REGWnR_Pos 16U /*!< CoreDebug DCRSR: REGWnR Position */ +#define CoreDebug_DCRSR_REGWnR_Msk (1UL << CoreDebug_DCRSR_REGWnR_Pos) /*!< CoreDebug DCRSR: REGWnR Mask */ + +#define CoreDebug_DCRSR_REGSEL_Pos 0U /*!< CoreDebug DCRSR: REGSEL Position */ +#define CoreDebug_DCRSR_REGSEL_Msk (0x1FUL /*<< CoreDebug_DCRSR_REGSEL_Pos*/) /*!< CoreDebug DCRSR: REGSEL Mask */ + +/* Debug Exception and Monitor Control Register Definitions */ +#define CoreDebug_DEMCR_TRCENA_Pos 24U /*!< CoreDebug DEMCR: TRCENA Position */ +#define CoreDebug_DEMCR_TRCENA_Msk (1UL << CoreDebug_DEMCR_TRCENA_Pos) /*!< CoreDebug DEMCR: TRCENA Mask */ + +#define CoreDebug_DEMCR_MON_REQ_Pos 19U /*!< CoreDebug DEMCR: MON_REQ Position */ +#define CoreDebug_DEMCR_MON_REQ_Msk (1UL << CoreDebug_DEMCR_MON_REQ_Pos) /*!< CoreDebug DEMCR: MON_REQ Mask */ + +#define CoreDebug_DEMCR_MON_STEP_Pos 18U /*!< CoreDebug DEMCR: MON_STEP Position */ +#define CoreDebug_DEMCR_MON_STEP_Msk (1UL << CoreDebug_DEMCR_MON_STEP_Pos) /*!< CoreDebug DEMCR: MON_STEP Mask */ + +#define CoreDebug_DEMCR_MON_PEND_Pos 17U /*!< CoreDebug DEMCR: MON_PEND Position */ +#define CoreDebug_DEMCR_MON_PEND_Msk (1UL << CoreDebug_DEMCR_MON_PEND_Pos) /*!< CoreDebug DEMCR: MON_PEND Mask */ + +#define CoreDebug_DEMCR_MON_EN_Pos 16U /*!< CoreDebug DEMCR: MON_EN Position */ +#define CoreDebug_DEMCR_MON_EN_Msk (1UL << CoreDebug_DEMCR_MON_EN_Pos) /*!< CoreDebug DEMCR: MON_EN Mask */ + +#define CoreDebug_DEMCR_VC_HARDERR_Pos 10U /*!< CoreDebug DEMCR: VC_HARDERR Position */ +#define CoreDebug_DEMCR_VC_HARDERR_Msk (1UL << CoreDebug_DEMCR_VC_HARDERR_Pos) /*!< CoreDebug DEMCR: VC_HARDERR Mask */ + +#define CoreDebug_DEMCR_VC_INTERR_Pos 9U /*!< CoreDebug DEMCR: VC_INTERR Position */ +#define CoreDebug_DEMCR_VC_INTERR_Msk (1UL << CoreDebug_DEMCR_VC_INTERR_Pos) /*!< CoreDebug DEMCR: VC_INTERR Mask */ + +#define CoreDebug_DEMCR_VC_BUSERR_Pos 8U /*!< CoreDebug DEMCR: VC_BUSERR Position */ +#define CoreDebug_DEMCR_VC_BUSERR_Msk (1UL << CoreDebug_DEMCR_VC_BUSERR_Pos) /*!< CoreDebug DEMCR: VC_BUSERR Mask */ + +#define CoreDebug_DEMCR_VC_STATERR_Pos 7U /*!< CoreDebug DEMCR: VC_STATERR Position */ +#define CoreDebug_DEMCR_VC_STATERR_Msk (1UL << CoreDebug_DEMCR_VC_STATERR_Pos) /*!< CoreDebug DEMCR: VC_STATERR Mask */ + +#define CoreDebug_DEMCR_VC_CHKERR_Pos 6U /*!< CoreDebug DEMCR: VC_CHKERR Position */ +#define CoreDebug_DEMCR_VC_CHKERR_Msk (1UL << CoreDebug_DEMCR_VC_CHKERR_Pos) /*!< CoreDebug DEMCR: VC_CHKERR Mask */ + +#define CoreDebug_DEMCR_VC_NOCPERR_Pos 5U /*!< CoreDebug DEMCR: VC_NOCPERR Position */ +#define CoreDebug_DEMCR_VC_NOCPERR_Msk (1UL << CoreDebug_DEMCR_VC_NOCPERR_Pos) /*!< CoreDebug DEMCR: VC_NOCPERR Mask */ + +#define CoreDebug_DEMCR_VC_MMERR_Pos 4U /*!< CoreDebug DEMCR: VC_MMERR Position */ +#define CoreDebug_DEMCR_VC_MMERR_Msk (1UL << CoreDebug_DEMCR_VC_MMERR_Pos) /*!< CoreDebug DEMCR: VC_MMERR Mask */ + +#define CoreDebug_DEMCR_VC_CORERESET_Pos 0U /*!< CoreDebug DEMCR: VC_CORERESET Position */ +#define CoreDebug_DEMCR_VC_CORERESET_Msk (1UL /*<< CoreDebug_DEMCR_VC_CORERESET_Pos*/) /*!< CoreDebug DEMCR: VC_CORERESET Mask */ + +/*@} end of group CMSIS_CoreDebug */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_core_bitfield Core register bit field macros + \brief Macros for use with bit field definitions (xxx_Pos, xxx_Msk). + @{ + */ + +/** + \brief Mask and shift a bit field value for use in a register bit range. + \param[in] field Name of the register bit field. + \param[in] value Value of the bit field. + \return Masked and shifted value. +*/ +#define _VAL2FLD(field, value) ((value << field ## _Pos) & field ## _Msk) + +/** + \brief Mask and shift a register value to extract a bit filed value. + \param[in] field Name of the register bit field. + \param[in] value Value of register. + \return Masked and shifted bit field value. +*/ +#define _FLD2VAL(field, value) ((value & field ## _Msk) >> field ## _Pos) + +/*@} end of group CMSIS_core_bitfield */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_core_base Core Definitions + \brief Definitions for base addresses, unions, and structures. + @{ + */ + +/* Memory mapping of Cortex-M3 Hardware */ +#define SCS_BASE (0xE000E000UL) /*!< System Control Space Base Address */ +#define ITM_BASE (0xE0000000UL) /*!< ITM Base Address */ +#define DWT_BASE (0xE0001000UL) /*!< DWT Base Address */ +#define TPI_BASE (0xE0040000UL) /*!< TPI Base Address */ +#define CoreDebug_BASE (0xE000EDF0UL) /*!< Core Debug Base Address */ +#define SysTick_BASE (SCS_BASE + 0x0010UL) /*!< SysTick Base Address */ +#define NVIC_BASE (SCS_BASE + 0x0100UL) /*!< NVIC Base Address */ +#define SCB_BASE (SCS_BASE + 0x0D00UL) /*!< System Control Block Base Address */ + +#define SCnSCB ((SCnSCB_Type *) SCS_BASE ) /*!< System control Register not in SCB */ +#define SCB ((SCB_Type *) SCB_BASE ) /*!< SCB configuration struct */ +#define SysTick ((SysTick_Type *) SysTick_BASE ) /*!< SysTick configuration struct */ +#define NVIC ((NVIC_Type *) NVIC_BASE ) /*!< NVIC configuration struct */ +#define ITM ((ITM_Type *) ITM_BASE ) /*!< ITM configuration struct */ +#define DWT ((DWT_Type *) DWT_BASE ) /*!< DWT configuration struct */ +#define TPI ((TPI_Type *) TPI_BASE ) /*!< TPI configuration struct */ +#define CoreDebug ((CoreDebug_Type *) CoreDebug_BASE) /*!< Core Debug configuration struct */ + +#if (__MPU_PRESENT == 1U) + #define MPU_BASE (SCS_BASE + 0x0D90UL) /*!< Memory Protection Unit */ + #define MPU ((MPU_Type *) MPU_BASE ) /*!< Memory Protection Unit */ +#endif + +/*@} */ + + + +/******************************************************************************* + * Hardware Abstraction Layer + Core Function Interface contains: + - Core NVIC Functions + - Core SysTick Functions + - Core Debug Functions + - Core Register Access Functions + ******************************************************************************/ +/** + \defgroup CMSIS_Core_FunctionInterface Functions and Instructions Reference +*/ + + + +/* ########################## NVIC functions #################################### */ +/** + \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_NVICFunctions NVIC Functions + \brief Functions that manage interrupts and exceptions via the NVIC. + @{ + */ + +/** + \brief Set Priority Grouping + \details Sets the priority grouping field using the required unlock sequence. + The parameter PriorityGroup is assigned to the field SCB->AIRCR [10:8] PRIGROUP field. + Only values from 0..7 are used. + In case of a conflict between priority grouping and available + priority bits (__NVIC_PRIO_BITS), the smallest possible priority group is set. + \param [in] PriorityGroup Priority grouping field. + */ +__STATIC_INLINE void NVIC_SetPriorityGrouping(uint32_t PriorityGroup) +{ + uint32_t reg_value; + uint32_t PriorityGroupTmp = (PriorityGroup & (uint32_t)0x07UL); /* only values 0..7 are used */ + + reg_value = SCB->AIRCR; /* read old register configuration */ + reg_value &= ~((uint32_t)(SCB_AIRCR_VECTKEY_Msk | SCB_AIRCR_PRIGROUP_Msk)); /* clear bits to change */ + reg_value = (reg_value | + ((uint32_t)0x5FAUL << SCB_AIRCR_VECTKEY_Pos) | + (PriorityGroupTmp << 8U) ); /* Insert write key and priorty group */ + SCB->AIRCR = reg_value; +} + + +/** + \brief Get Priority Grouping + \details Reads the priority grouping field from the NVIC Interrupt Controller. + \return Priority grouping field (SCB->AIRCR [10:8] PRIGROUP field). + */ +__STATIC_INLINE uint32_t NVIC_GetPriorityGrouping(void) +{ + return ((uint32_t)((SCB->AIRCR & SCB_AIRCR_PRIGROUP_Msk) >> SCB_AIRCR_PRIGROUP_Pos)); +} + + +/** + \brief Enable External Interrupt + \details Enables a device-specific interrupt in the NVIC interrupt controller. + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_EnableIRQ(IRQn_Type IRQn) +{ + NVIC->ISER[(((uint32_t)(int32_t)IRQn) >> 5UL)] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Disable External Interrupt + \details Disables a device-specific interrupt in the NVIC interrupt controller. + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_DisableIRQ(IRQn_Type IRQn) +{ + NVIC->ICER[(((uint32_t)(int32_t)IRQn) >> 5UL)] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Get Pending Interrupt + \details Reads the pending register in the NVIC and returns the pending bit for the specified interrupt. + \param [in] IRQn Interrupt number. + \return 0 Interrupt status is not pending. + \return 1 Interrupt status is pending. + */ +__STATIC_INLINE uint32_t NVIC_GetPendingIRQ(IRQn_Type IRQn) +{ + return((uint32_t)(((NVIC->ISPR[(((uint32_t)(int32_t)IRQn) >> 5UL)] & (1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL))) != 0UL) ? 1UL : 0UL)); +} + + +/** + \brief Set Pending Interrupt + \details Sets the pending bit of an external interrupt. + \param [in] IRQn Interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_SetPendingIRQ(IRQn_Type IRQn) +{ + NVIC->ISPR[(((uint32_t)(int32_t)IRQn) >> 5UL)] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Clear Pending Interrupt + \details Clears the pending bit of an external interrupt. + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_ClearPendingIRQ(IRQn_Type IRQn) +{ + NVIC->ICPR[(((uint32_t)(int32_t)IRQn) >> 5UL)] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Get Active Interrupt + \details Reads the active register in NVIC and returns the active bit. + \param [in] IRQn Interrupt number. + \return 0 Interrupt status is not active. + \return 1 Interrupt status is active. + */ +__STATIC_INLINE uint32_t NVIC_GetActive(IRQn_Type IRQn) +{ + return((uint32_t)(((NVIC->IABR[(((uint32_t)(int32_t)IRQn) >> 5UL)] & (1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL))) != 0UL) ? 1UL : 0UL)); +} + + +/** + \brief Set Interrupt Priority + \details Sets the priority of an interrupt. + \note The priority cannot be set for every core interrupt. + \param [in] IRQn Interrupt number. + \param [in] priority Priority to set. + */ +__STATIC_INLINE void NVIC_SetPriority(IRQn_Type IRQn, uint32_t priority) +{ + if ((int32_t)(IRQn) < 0) + { + SCB->SHP[(((uint32_t)(int32_t)IRQn) & 0xFUL)-4UL] = (uint8_t)((priority << (8U - __NVIC_PRIO_BITS)) & (uint32_t)0xFFUL); + } + else + { + NVIC->IP[((uint32_t)(int32_t)IRQn)] = (uint8_t)((priority << (8U - __NVIC_PRIO_BITS)) & (uint32_t)0xFFUL); + } +} + + +/** + \brief Get Interrupt Priority + \details Reads the priority of an interrupt. + The interrupt number can be positive to specify an external (device specific) interrupt, + or negative to specify an internal (core) interrupt. + \param [in] IRQn Interrupt number. + \return Interrupt Priority. + Value is aligned automatically to the implemented priority bits of the microcontroller. + */ +__STATIC_INLINE uint32_t NVIC_GetPriority(IRQn_Type IRQn) +{ + + if ((int32_t)(IRQn) < 0) + { + return(((uint32_t)SCB->SHP[(((uint32_t)(int32_t)IRQn) & 0xFUL)-4UL] >> (8U - __NVIC_PRIO_BITS))); + } + else + { + return(((uint32_t)NVIC->IP[((uint32_t)(int32_t)IRQn)] >> (8U - __NVIC_PRIO_BITS))); + } +} + + +/** + \brief Encode Priority + \details Encodes the priority for an interrupt with the given priority group, + preemptive priority value, and subpriority value. + In case of a conflict between priority grouping and available + priority bits (__NVIC_PRIO_BITS), the smallest possible priority group is set. + \param [in] PriorityGroup Used priority group. + \param [in] PreemptPriority Preemptive priority value (starting from 0). + \param [in] SubPriority Subpriority value (starting from 0). + \return Encoded priority. Value can be used in the function \ref NVIC_SetPriority(). + */ +__STATIC_INLINE uint32_t NVIC_EncodePriority (uint32_t PriorityGroup, uint32_t PreemptPriority, uint32_t SubPriority) +{ + uint32_t PriorityGroupTmp = (PriorityGroup & (uint32_t)0x07UL); /* only values 0..7 are used */ + uint32_t PreemptPriorityBits; + uint32_t SubPriorityBits; + + PreemptPriorityBits = ((7UL - PriorityGroupTmp) > (uint32_t)(__NVIC_PRIO_BITS)) ? (uint32_t)(__NVIC_PRIO_BITS) : (uint32_t)(7UL - PriorityGroupTmp); + SubPriorityBits = ((PriorityGroupTmp + (uint32_t)(__NVIC_PRIO_BITS)) < (uint32_t)7UL) ? (uint32_t)0UL : (uint32_t)((PriorityGroupTmp - 7UL) + (uint32_t)(__NVIC_PRIO_BITS)); + + return ( + ((PreemptPriority & (uint32_t)((1UL << (PreemptPriorityBits)) - 1UL)) << SubPriorityBits) | + ((SubPriority & (uint32_t)((1UL << (SubPriorityBits )) - 1UL))) + ); +} + + +/** + \brief Decode Priority + \details Decodes an interrupt priority value with a given priority group to + preemptive priority value and subpriority value. + In case of a conflict between priority grouping and available + priority bits (__NVIC_PRIO_BITS) the smallest possible priority group is set. + \param [in] Priority Priority value, which can be retrieved with the function \ref NVIC_GetPriority(). + \param [in] PriorityGroup Used priority group. + \param [out] pPreemptPriority Preemptive priority value (starting from 0). + \param [out] pSubPriority Subpriority value (starting from 0). + */ +__STATIC_INLINE void NVIC_DecodePriority (uint32_t Priority, uint32_t PriorityGroup, uint32_t* const pPreemptPriority, uint32_t* const pSubPriority) +{ + uint32_t PriorityGroupTmp = (PriorityGroup & (uint32_t)0x07UL); /* only values 0..7 are used */ + uint32_t PreemptPriorityBits; + uint32_t SubPriorityBits; + + PreemptPriorityBits = ((7UL - PriorityGroupTmp) > (uint32_t)(__NVIC_PRIO_BITS)) ? (uint32_t)(__NVIC_PRIO_BITS) : (uint32_t)(7UL - PriorityGroupTmp); + SubPriorityBits = ((PriorityGroupTmp + (uint32_t)(__NVIC_PRIO_BITS)) < (uint32_t)7UL) ? (uint32_t)0UL : (uint32_t)((PriorityGroupTmp - 7UL) + (uint32_t)(__NVIC_PRIO_BITS)); + + *pPreemptPriority = (Priority >> SubPriorityBits) & (uint32_t)((1UL << (PreemptPriorityBits)) - 1UL); + *pSubPriority = (Priority ) & (uint32_t)((1UL << (SubPriorityBits )) - 1UL); +} + + +/** + \brief System Reset + \details Initiates a system reset request to reset the MCU. + */ +__STATIC_INLINE void NVIC_SystemReset(void) +{ + __DSB(); /* Ensure all outstanding memory accesses included + buffered write are completed before reset */ + SCB->AIRCR = (uint32_t)((0x5FAUL << SCB_AIRCR_VECTKEY_Pos) | + (SCB->AIRCR & SCB_AIRCR_PRIGROUP_Msk) | + SCB_AIRCR_SYSRESETREQ_Msk ); /* Keep priority group unchanged */ + __DSB(); /* Ensure completion of memory access */ + + for(;;) /* wait until reset */ + { + __NOP(); + } +} + +/*@} end of CMSIS_Core_NVICFunctions */ + + + +/* ################################## SysTick function ############################################ */ +/** + \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_SysTickFunctions SysTick Functions + \brief Functions that configure the System. + @{ + */ + +#if (__Vendor_SysTickConfig == 0U) + +/** + \brief System Tick Configuration + \details Initializes the System Timer and its interrupt, and starts the System Tick Timer. + Counter is in free running mode to generate periodic interrupts. + \param [in] ticks Number of ticks between two interrupts. + \return 0 Function succeeded. + \return 1 Function failed. + \note When the variable __Vendor_SysTickConfig is set to 1, then the + function SysTick_Config is not included. In this case, the file device.h + must contain a vendor-specific implementation of this function. + */ +__STATIC_INLINE uint32_t SysTick_Config(uint32_t ticks) +{ + if ((ticks - 1UL) > SysTick_LOAD_RELOAD_Msk) + { + return (1UL); /* Reload value impossible */ + } + + SysTick->LOAD = (uint32_t)(ticks - 1UL); /* set reload register */ + NVIC_SetPriority (SysTick_IRQn, (1UL << __NVIC_PRIO_BITS) - 1UL); /* set Priority for Systick Interrupt */ + SysTick->VAL = 0UL; /* Load the SysTick Counter Value */ + SysTick->CTRL = SysTick_CTRL_CLKSOURCE_Msk | + SysTick_CTRL_TICKINT_Msk | + SysTick_CTRL_ENABLE_Msk; /* Enable SysTick IRQ and SysTick Timer */ + return (0UL); /* Function successful */ +} + +#endif + +/*@} end of CMSIS_Core_SysTickFunctions */ + + + +/* ##################################### Debug In/Output function ########################################### */ +/** + \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_core_DebugFunctions ITM Functions + \brief Functions that access the ITM debug interface. + @{ + */ + +extern volatile int32_t ITM_RxBuffer; /*!< External variable to receive characters. */ +#define ITM_RXBUFFER_EMPTY 0x5AA55AA5U /*!< Value identifying \ref ITM_RxBuffer is ready for next character. */ + + +/** + \brief ITM Send Character + \details Transmits a character via the ITM channel 0, and + \li Just returns when no debugger is connected that has booked the output. + \li Is blocking when a debugger is connected, but the previous character sent has not been transmitted. + \param [in] ch Character to transmit. + \returns Character to transmit. + */ +__STATIC_INLINE uint32_t ITM_SendChar (uint32_t ch) +{ + if (((ITM->TCR & ITM_TCR_ITMENA_Msk) != 0UL) && /* ITM enabled */ + ((ITM->TER & 1UL ) != 0UL) ) /* ITM Port #0 enabled */ + { + while (ITM->PORT[0U].u32 == 0UL) + { + __NOP(); + } + ITM->PORT[0U].u8 = (uint8_t)ch; + } + return (ch); +} + + +/** + \brief ITM Receive Character + \details Inputs a character via the external variable \ref ITM_RxBuffer. + \return Received character. + \return -1 No character pending. + */ +__STATIC_INLINE int32_t ITM_ReceiveChar (void) +{ + int32_t ch = -1; /* no character available */ + + if (ITM_RxBuffer != ITM_RXBUFFER_EMPTY) + { + ch = ITM_RxBuffer; + ITM_RxBuffer = ITM_RXBUFFER_EMPTY; /* ready for next character */ + } + + return (ch); +} + + +/** + \brief ITM Check Character + \details Checks whether a character is pending for reading in the variable \ref ITM_RxBuffer. + \return 0 No character available. + \return 1 Character available. + */ +__STATIC_INLINE int32_t ITM_CheckChar (void) +{ + + if (ITM_RxBuffer == ITM_RXBUFFER_EMPTY) + { + return (0); /* no character available */ + } + else + { + return (1); /* character available */ + } +} + +/*@} end of CMSIS_core_DebugFunctions */ + + + + +#ifdef __cplusplus +} +#endif + +#endif /* __CORE_CM3_H_DEPENDANT */ + +#endif /* __CMSIS_GENERIC */ diff --git a/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cm4.h b/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cm4.h new file mode 100644 index 00000000000..dc840ebf222 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cm4.h @@ -0,0 +1,1937 @@ +/**************************************************************************//** + * @file core_cm4.h + * @brief CMSIS Cortex-M4 Core Peripheral Access Layer Header File + * @version V4.30 + * @date 20. October 2015 + ******************************************************************************/ +/* Copyright (c) 2009 - 2015 ARM LIMITED + + All rights reserved. + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are met: + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + - Neither the name of ARM nor the names of its contributors may be used + to endorse or promote products derived from this software without + specific prior written permission. + * + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE + LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + ---------------------------------------------------------------------------*/ + + +#if defined ( __ICCARM__ ) + #pragma system_include /* treat file as system include file for MISRA check */ +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #pragma clang system_header /* treat file as system include file */ +#endif + +#ifndef __CORE_CM4_H_GENERIC +#define __CORE_CM4_H_GENERIC + +#include + +#ifdef __cplusplus + extern "C" { +#endif + +/** + \page CMSIS_MISRA_Exceptions MISRA-C:2004 Compliance Exceptions + CMSIS violates the following MISRA-C:2004 rules: + + \li Required Rule 8.5, object/function definition in header file.
+ Function definitions in header files are used to allow 'inlining'. + + \li Required Rule 18.4, declaration of union type or object of union type: '{...}'.
+ Unions are used for effective representation of core registers. + + \li Advisory Rule 19.7, Function-like macro defined.
+ Function-like macros are used to allow more efficient code. + */ + + +/******************************************************************************* + * CMSIS definitions + ******************************************************************************/ +/** + \ingroup Cortex_M4 + @{ + */ + +/* CMSIS CM4 definitions */ +#define __CM4_CMSIS_VERSION_MAIN (0x04U) /*!< [31:16] CMSIS HAL main version */ +#define __CM4_CMSIS_VERSION_SUB (0x1EU) /*!< [15:0] CMSIS HAL sub version */ +#define __CM4_CMSIS_VERSION ((__CM4_CMSIS_VERSION_MAIN << 16U) | \ + __CM4_CMSIS_VERSION_SUB ) /*!< CMSIS HAL version number */ + +#define __CORTEX_M (0x04U) /*!< Cortex-M Core */ + + +#if defined ( __CC_ARM ) + #define __ASM __asm /*!< asm keyword for ARM Compiler */ + #define __INLINE __inline /*!< inline keyword for ARM Compiler */ + #define __STATIC_INLINE static __inline + +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #define __ASM __asm /*!< asm keyword for ARM Compiler */ + #define __INLINE __inline /*!< inline keyword for ARM Compiler */ + #define __STATIC_INLINE static __inline + +#elif defined ( __GNUC__ ) + #define __ASM __asm /*!< asm keyword for GNU Compiler */ + #define __INLINE inline /*!< inline keyword for GNU Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __ICCARM__ ) + #define __ASM __asm /*!< asm keyword for IAR Compiler */ + #define __INLINE inline /*!< inline keyword for IAR Compiler. Only available in High optimization mode! */ + #define __STATIC_INLINE static inline + +#elif defined ( __TMS470__ ) + #define __ASM __asm /*!< asm keyword for TI CCS Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __TASKING__ ) + #define __ASM __asm /*!< asm keyword for TASKING Compiler */ + #define __INLINE inline /*!< inline keyword for TASKING Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __CSMC__ ) + #define __packed + #define __ASM _asm /*!< asm keyword for COSMIC Compiler */ + #define __INLINE inline /*!< inline keyword for COSMIC Compiler. Use -pc99 on compile line */ + #define __STATIC_INLINE static inline + +#else + #error Unknown compiler +#endif + +/** __FPU_USED indicates whether an FPU is used or not. + For this, __FPU_PRESENT has to be checked prior to making use of FPU specific registers and functions. +*/ +#if defined ( __CC_ARM ) + #if defined __TARGET_FPU_VFP + #if (__FPU_PRESENT == 1U) + #define __FPU_USED 1U + #else + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #define __FPU_USED 0U + #endif + #else + #define __FPU_USED 0U + #endif + +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #if defined __ARM_PCS_VFP + #if (__FPU_PRESENT == 1) + #define __FPU_USED 1U + #else + #warning "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #define __FPU_USED 0U + #endif + #else + #define __FPU_USED 0U + #endif + +#elif defined ( __GNUC__ ) + #if defined (__VFP_FP__) && !defined(__SOFTFP__) + #if (__FPU_PRESENT == 1U) + #define __FPU_USED 1U + #else + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #define __FPU_USED 0U + #endif + #else + #define __FPU_USED 0U + #endif + +#elif defined ( __ICCARM__ ) + #if defined __ARMVFP__ + #if (__FPU_PRESENT == 1U) + #define __FPU_USED 1U + #else + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #define __FPU_USED 0U + #endif + #else + #define __FPU_USED 0U + #endif + +#elif defined ( __TMS470__ ) + #if defined __TI_VFP_SUPPORT__ + #if (__FPU_PRESENT == 1U) + #define __FPU_USED 1U + #else + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #define __FPU_USED 0U + #endif + #else + #define __FPU_USED 0U + #endif + +#elif defined ( __TASKING__ ) + #if defined __FPU_VFP__ + #if (__FPU_PRESENT == 1U) + #define __FPU_USED 1U + #else + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #define __FPU_USED 0U + #endif + #else + #define __FPU_USED 0U + #endif + +#elif defined ( __CSMC__ ) + #if ( __CSMC__ & 0x400U) + #if (__FPU_PRESENT == 1U) + #define __FPU_USED 1U + #else + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #define __FPU_USED 0U + #endif + #else + #define __FPU_USED 0U + #endif + +#endif + +#include "core_cmInstr.h" /* Core Instruction Access */ +#include "core_cmFunc.h" /* Core Function Access */ +#include "core_cmSimd.h" /* Compiler specific SIMD Intrinsics */ + +#ifdef __cplusplus +} +#endif + +#endif /* __CORE_CM4_H_GENERIC */ + +#ifndef __CMSIS_GENERIC + +#ifndef __CORE_CM4_H_DEPENDANT +#define __CORE_CM4_H_DEPENDANT + +#ifdef __cplusplus + extern "C" { +#endif + +/* check device defines and use defaults */ +#if defined __CHECK_DEVICE_DEFINES + #ifndef __CM4_REV + #define __CM4_REV 0x0000U + #warning "__CM4_REV not defined in device header file; using default!" + #endif + + #ifndef __FPU_PRESENT + #define __FPU_PRESENT 0U + #warning "__FPU_PRESENT not defined in device header file; using default!" + #endif + + #ifndef __MPU_PRESENT + #define __MPU_PRESENT 0U + #warning "__MPU_PRESENT not defined in device header file; using default!" + #endif + + #ifndef __NVIC_PRIO_BITS + #define __NVIC_PRIO_BITS 4U + #warning "__NVIC_PRIO_BITS not defined in device header file; using default!" + #endif + + #ifndef __Vendor_SysTickConfig + #define __Vendor_SysTickConfig 0U + #warning "__Vendor_SysTickConfig not defined in device header file; using default!" + #endif +#endif + +/* IO definitions (access restrictions to peripheral registers) */ +/** + \defgroup CMSIS_glob_defs CMSIS Global Defines + + IO Type Qualifiers are used + \li to specify the access to peripheral variables. + \li for automatic generation of peripheral register debug information. +*/ +#ifdef __cplusplus + #define __I volatile /*!< Defines 'read only' permissions */ +#else + #define __I volatile const /*!< Defines 'read only' permissions */ +#endif +#define __O volatile /*!< Defines 'write only' permissions */ +#define __IO volatile /*!< Defines 'read / write' permissions */ + +/* following defines should be used for structure members */ +#define __IM volatile const /*! Defines 'read only' structure member permissions */ +#define __OM volatile /*! Defines 'write only' structure member permissions */ +#define __IOM volatile /*! Defines 'read / write' structure member permissions */ + +/*@} end of group Cortex_M4 */ + + + +/******************************************************************************* + * Register Abstraction + Core Register contain: + - Core Register + - Core NVIC Register + - Core SCB Register + - Core SysTick Register + - Core Debug Register + - Core MPU Register + - Core FPU Register + ******************************************************************************/ +/** + \defgroup CMSIS_core_register Defines and Type Definitions + \brief Type definitions and defines for Cortex-M processor based devices. +*/ + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_CORE Status and Control Registers + \brief Core Register type definitions. + @{ + */ + +/** + \brief Union type to access the Application Program Status Register (APSR). + */ +typedef union +{ + struct + { + uint32_t _reserved0:16; /*!< bit: 0..15 Reserved */ + uint32_t GE:4; /*!< bit: 16..19 Greater than or Equal flags */ + uint32_t _reserved1:7; /*!< bit: 20..26 Reserved */ + uint32_t Q:1; /*!< bit: 27 Saturation condition flag */ + uint32_t V:1; /*!< bit: 28 Overflow condition code flag */ + uint32_t C:1; /*!< bit: 29 Carry condition code flag */ + uint32_t Z:1; /*!< bit: 30 Zero condition code flag */ + uint32_t N:1; /*!< bit: 31 Negative condition code flag */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} APSR_Type; + +/* APSR Register Definitions */ +#define APSR_N_Pos 31U /*!< APSR: N Position */ +#define APSR_N_Msk (1UL << APSR_N_Pos) /*!< APSR: N Mask */ + +#define APSR_Z_Pos 30U /*!< APSR: Z Position */ +#define APSR_Z_Msk (1UL << APSR_Z_Pos) /*!< APSR: Z Mask */ + +#define APSR_C_Pos 29U /*!< APSR: C Position */ +#define APSR_C_Msk (1UL << APSR_C_Pos) /*!< APSR: C Mask */ + +#define APSR_V_Pos 28U /*!< APSR: V Position */ +#define APSR_V_Msk (1UL << APSR_V_Pos) /*!< APSR: V Mask */ + +#define APSR_Q_Pos 27U /*!< APSR: Q Position */ +#define APSR_Q_Msk (1UL << APSR_Q_Pos) /*!< APSR: Q Mask */ + +#define APSR_GE_Pos 16U /*!< APSR: GE Position */ +#define APSR_GE_Msk (0xFUL << APSR_GE_Pos) /*!< APSR: GE Mask */ + + +/** + \brief Union type to access the Interrupt Program Status Register (IPSR). + */ +typedef union +{ + struct + { + uint32_t ISR:9; /*!< bit: 0.. 8 Exception number */ + uint32_t _reserved0:23; /*!< bit: 9..31 Reserved */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} IPSR_Type; + +/* IPSR Register Definitions */ +#define IPSR_ISR_Pos 0U /*!< IPSR: ISR Position */ +#define IPSR_ISR_Msk (0x1FFUL /*<< IPSR_ISR_Pos*/) /*!< IPSR: ISR Mask */ + + +/** + \brief Union type to access the Special-Purpose Program Status Registers (xPSR). + */ +typedef union +{ + struct + { + uint32_t ISR:9; /*!< bit: 0.. 8 Exception number */ + uint32_t _reserved0:7; /*!< bit: 9..15 Reserved */ + uint32_t GE:4; /*!< bit: 16..19 Greater than or Equal flags */ + uint32_t _reserved1:4; /*!< bit: 20..23 Reserved */ + uint32_t T:1; /*!< bit: 24 Thumb bit (read 0) */ + uint32_t IT:2; /*!< bit: 25..26 saved IT state (read 0) */ + uint32_t Q:1; /*!< bit: 27 Saturation condition flag */ + uint32_t V:1; /*!< bit: 28 Overflow condition code flag */ + uint32_t C:1; /*!< bit: 29 Carry condition code flag */ + uint32_t Z:1; /*!< bit: 30 Zero condition code flag */ + uint32_t N:1; /*!< bit: 31 Negative condition code flag */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} xPSR_Type; + +/* xPSR Register Definitions */ +#define xPSR_N_Pos 31U /*!< xPSR: N Position */ +#define xPSR_N_Msk (1UL << xPSR_N_Pos) /*!< xPSR: N Mask */ + +#define xPSR_Z_Pos 30U /*!< xPSR: Z Position */ +#define xPSR_Z_Msk (1UL << xPSR_Z_Pos) /*!< xPSR: Z Mask */ + +#define xPSR_C_Pos 29U /*!< xPSR: C Position */ +#define xPSR_C_Msk (1UL << xPSR_C_Pos) /*!< xPSR: C Mask */ + +#define xPSR_V_Pos 28U /*!< xPSR: V Position */ +#define xPSR_V_Msk (1UL << xPSR_V_Pos) /*!< xPSR: V Mask */ + +#define xPSR_Q_Pos 27U /*!< xPSR: Q Position */ +#define xPSR_Q_Msk (1UL << xPSR_Q_Pos) /*!< xPSR: Q Mask */ + +#define xPSR_IT_Pos 25U /*!< xPSR: IT Position */ +#define xPSR_IT_Msk (3UL << xPSR_IT_Pos) /*!< xPSR: IT Mask */ + +#define xPSR_T_Pos 24U /*!< xPSR: T Position */ +#define xPSR_T_Msk (1UL << xPSR_T_Pos) /*!< xPSR: T Mask */ + +#define xPSR_GE_Pos 16U /*!< xPSR: GE Position */ +#define xPSR_GE_Msk (0xFUL << xPSR_GE_Pos) /*!< xPSR: GE Mask */ + +#define xPSR_ISR_Pos 0U /*!< xPSR: ISR Position */ +#define xPSR_ISR_Msk (0x1FFUL /*<< xPSR_ISR_Pos*/) /*!< xPSR: ISR Mask */ + + +/** + \brief Union type to access the Control Registers (CONTROL). + */ +typedef union +{ + struct + { + uint32_t nPRIV:1; /*!< bit: 0 Execution privilege in Thread mode */ + uint32_t SPSEL:1; /*!< bit: 1 Stack to be used */ + uint32_t FPCA:1; /*!< bit: 2 FP extension active flag */ + uint32_t _reserved0:29; /*!< bit: 3..31 Reserved */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} CONTROL_Type; + +/* CONTROL Register Definitions */ +#define CONTROL_FPCA_Pos 2U /*!< CONTROL: FPCA Position */ +#define CONTROL_FPCA_Msk (1UL << CONTROL_FPCA_Pos) /*!< CONTROL: FPCA Mask */ + +#define CONTROL_SPSEL_Pos 1U /*!< CONTROL: SPSEL Position */ +#define CONTROL_SPSEL_Msk (1UL << CONTROL_SPSEL_Pos) /*!< CONTROL: SPSEL Mask */ + +#define CONTROL_nPRIV_Pos 0U /*!< CONTROL: nPRIV Position */ +#define CONTROL_nPRIV_Msk (1UL /*<< CONTROL_nPRIV_Pos*/) /*!< CONTROL: nPRIV Mask */ + +/*@} end of group CMSIS_CORE */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_NVIC Nested Vectored Interrupt Controller (NVIC) + \brief Type definitions for the NVIC Registers + @{ + */ + +/** + \brief Structure type to access the Nested Vectored Interrupt Controller (NVIC). + */ +typedef struct +{ + __IOM uint32_t ISER[8U]; /*!< Offset: 0x000 (R/W) Interrupt Set Enable Register */ + uint32_t RESERVED0[24U]; + __IOM uint32_t ICER[8U]; /*!< Offset: 0x080 (R/W) Interrupt Clear Enable Register */ + uint32_t RSERVED1[24U]; + __IOM uint32_t ISPR[8U]; /*!< Offset: 0x100 (R/W) Interrupt Set Pending Register */ + uint32_t RESERVED2[24U]; + __IOM uint32_t ICPR[8U]; /*!< Offset: 0x180 (R/W) Interrupt Clear Pending Register */ + uint32_t RESERVED3[24U]; + __IOM uint32_t IABR[8U]; /*!< Offset: 0x200 (R/W) Interrupt Active bit Register */ + uint32_t RESERVED4[56U]; + __IOM uint8_t IP[240U]; /*!< Offset: 0x300 (R/W) Interrupt Priority Register (8Bit wide) */ + uint32_t RESERVED5[644U]; + __OM uint32_t STIR; /*!< Offset: 0xE00 ( /W) Software Trigger Interrupt Register */ +} NVIC_Type; + +/* Software Triggered Interrupt Register Definitions */ +#define NVIC_STIR_INTID_Pos 0U /*!< STIR: INTLINESNUM Position */ +#define NVIC_STIR_INTID_Msk (0x1FFUL /*<< NVIC_STIR_INTID_Pos*/) /*!< STIR: INTLINESNUM Mask */ + +/*@} end of group CMSIS_NVIC */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_SCB System Control Block (SCB) + \brief Type definitions for the System Control Block Registers + @{ + */ + +/** + \brief Structure type to access the System Control Block (SCB). + */ +typedef struct +{ + __IM uint32_t CPUID; /*!< Offset: 0x000 (R/ ) CPUID Base Register */ + __IOM uint32_t ICSR; /*!< Offset: 0x004 (R/W) Interrupt Control and State Register */ + __IOM uint32_t VTOR; /*!< Offset: 0x008 (R/W) Vector Table Offset Register */ + __IOM uint32_t AIRCR; /*!< Offset: 0x00C (R/W) Application Interrupt and Reset Control Register */ + __IOM uint32_t SCR; /*!< Offset: 0x010 (R/W) System Control Register */ + __IOM uint32_t CCR; /*!< Offset: 0x014 (R/W) Configuration Control Register */ + __IOM uint8_t SHP[12U]; /*!< Offset: 0x018 (R/W) System Handlers Priority Registers (4-7, 8-11, 12-15) */ + __IOM uint32_t SHCSR; /*!< Offset: 0x024 (R/W) System Handler Control and State Register */ + __IOM uint32_t CFSR; /*!< Offset: 0x028 (R/W) Configurable Fault Status Register */ + __IOM uint32_t HFSR; /*!< Offset: 0x02C (R/W) HardFault Status Register */ + __IOM uint32_t DFSR; /*!< Offset: 0x030 (R/W) Debug Fault Status Register */ + __IOM uint32_t MMFAR; /*!< Offset: 0x034 (R/W) MemManage Fault Address Register */ + __IOM uint32_t BFAR; /*!< Offset: 0x038 (R/W) BusFault Address Register */ + __IOM uint32_t AFSR; /*!< Offset: 0x03C (R/W) Auxiliary Fault Status Register */ + __IM uint32_t PFR[2U]; /*!< Offset: 0x040 (R/ ) Processor Feature Register */ + __IM uint32_t DFR; /*!< Offset: 0x048 (R/ ) Debug Feature Register */ + __IM uint32_t ADR; /*!< Offset: 0x04C (R/ ) Auxiliary Feature Register */ + __IM uint32_t MMFR[4U]; /*!< Offset: 0x050 (R/ ) Memory Model Feature Register */ + __IM uint32_t ISAR[5U]; /*!< Offset: 0x060 (R/ ) Instruction Set Attributes Register */ + uint32_t RESERVED0[5U]; + __IOM uint32_t CPACR; /*!< Offset: 0x088 (R/W) Coprocessor Access Control Register */ +} SCB_Type; + +/* SCB CPUID Register Definitions */ +#define SCB_CPUID_IMPLEMENTER_Pos 24U /*!< SCB CPUID: IMPLEMENTER Position */ +#define SCB_CPUID_IMPLEMENTER_Msk (0xFFUL << SCB_CPUID_IMPLEMENTER_Pos) /*!< SCB CPUID: IMPLEMENTER Mask */ + +#define SCB_CPUID_VARIANT_Pos 20U /*!< SCB CPUID: VARIANT Position */ +#define SCB_CPUID_VARIANT_Msk (0xFUL << SCB_CPUID_VARIANT_Pos) /*!< SCB CPUID: VARIANT Mask */ + +#define SCB_CPUID_ARCHITECTURE_Pos 16U /*!< SCB CPUID: ARCHITECTURE Position */ +#define SCB_CPUID_ARCHITECTURE_Msk (0xFUL << SCB_CPUID_ARCHITECTURE_Pos) /*!< SCB CPUID: ARCHITECTURE Mask */ + +#define SCB_CPUID_PARTNO_Pos 4U /*!< SCB CPUID: PARTNO Position */ +#define SCB_CPUID_PARTNO_Msk (0xFFFUL << SCB_CPUID_PARTNO_Pos) /*!< SCB CPUID: PARTNO Mask */ + +#define SCB_CPUID_REVISION_Pos 0U /*!< SCB CPUID: REVISION Position */ +#define SCB_CPUID_REVISION_Msk (0xFUL /*<< SCB_CPUID_REVISION_Pos*/) /*!< SCB CPUID: REVISION Mask */ + +/* SCB Interrupt Control State Register Definitions */ +#define SCB_ICSR_NMIPENDSET_Pos 31U /*!< SCB ICSR: NMIPENDSET Position */ +#define SCB_ICSR_NMIPENDSET_Msk (1UL << SCB_ICSR_NMIPENDSET_Pos) /*!< SCB ICSR: NMIPENDSET Mask */ + +#define SCB_ICSR_PENDSVSET_Pos 28U /*!< SCB ICSR: PENDSVSET Position */ +#define SCB_ICSR_PENDSVSET_Msk (1UL << SCB_ICSR_PENDSVSET_Pos) /*!< SCB ICSR: PENDSVSET Mask */ + +#define SCB_ICSR_PENDSVCLR_Pos 27U /*!< SCB ICSR: PENDSVCLR Position */ +#define SCB_ICSR_PENDSVCLR_Msk (1UL << SCB_ICSR_PENDSVCLR_Pos) /*!< SCB ICSR: PENDSVCLR Mask */ + +#define SCB_ICSR_PENDSTSET_Pos 26U /*!< SCB ICSR: PENDSTSET Position */ +#define SCB_ICSR_PENDSTSET_Msk (1UL << SCB_ICSR_PENDSTSET_Pos) /*!< SCB ICSR: PENDSTSET Mask */ + +#define SCB_ICSR_PENDSTCLR_Pos 25U /*!< SCB ICSR: PENDSTCLR Position */ +#define SCB_ICSR_PENDSTCLR_Msk (1UL << SCB_ICSR_PENDSTCLR_Pos) /*!< SCB ICSR: PENDSTCLR Mask */ + +#define SCB_ICSR_ISRPREEMPT_Pos 23U /*!< SCB ICSR: ISRPREEMPT Position */ +#define SCB_ICSR_ISRPREEMPT_Msk (1UL << SCB_ICSR_ISRPREEMPT_Pos) /*!< SCB ICSR: ISRPREEMPT Mask */ + +#define SCB_ICSR_ISRPENDING_Pos 22U /*!< SCB ICSR: ISRPENDING Position */ +#define SCB_ICSR_ISRPENDING_Msk (1UL << SCB_ICSR_ISRPENDING_Pos) /*!< SCB ICSR: ISRPENDING Mask */ + +#define SCB_ICSR_VECTPENDING_Pos 12U /*!< SCB ICSR: VECTPENDING Position */ +#define SCB_ICSR_VECTPENDING_Msk (0x1FFUL << SCB_ICSR_VECTPENDING_Pos) /*!< SCB ICSR: VECTPENDING Mask */ + +#define SCB_ICSR_RETTOBASE_Pos 11U /*!< SCB ICSR: RETTOBASE Position */ +#define SCB_ICSR_RETTOBASE_Msk (1UL << SCB_ICSR_RETTOBASE_Pos) /*!< SCB ICSR: RETTOBASE Mask */ + +#define SCB_ICSR_VECTACTIVE_Pos 0U /*!< SCB ICSR: VECTACTIVE Position */ +#define SCB_ICSR_VECTACTIVE_Msk (0x1FFUL /*<< SCB_ICSR_VECTACTIVE_Pos*/) /*!< SCB ICSR: VECTACTIVE Mask */ + +/* SCB Vector Table Offset Register Definitions */ +#define SCB_VTOR_TBLOFF_Pos 7U /*!< SCB VTOR: TBLOFF Position */ +#define SCB_VTOR_TBLOFF_Msk (0x1FFFFFFUL << SCB_VTOR_TBLOFF_Pos) /*!< SCB VTOR: TBLOFF Mask */ + +/* SCB Application Interrupt and Reset Control Register Definitions */ +#define SCB_AIRCR_VECTKEY_Pos 16U /*!< SCB AIRCR: VECTKEY Position */ +#define SCB_AIRCR_VECTKEY_Msk (0xFFFFUL << SCB_AIRCR_VECTKEY_Pos) /*!< SCB AIRCR: VECTKEY Mask */ + +#define SCB_AIRCR_VECTKEYSTAT_Pos 16U /*!< SCB AIRCR: VECTKEYSTAT Position */ +#define SCB_AIRCR_VECTKEYSTAT_Msk (0xFFFFUL << SCB_AIRCR_VECTKEYSTAT_Pos) /*!< SCB AIRCR: VECTKEYSTAT Mask */ + +#define SCB_AIRCR_ENDIANESS_Pos 15U /*!< SCB AIRCR: ENDIANESS Position */ +#define SCB_AIRCR_ENDIANESS_Msk (1UL << SCB_AIRCR_ENDIANESS_Pos) /*!< SCB AIRCR: ENDIANESS Mask */ + +#define SCB_AIRCR_PRIGROUP_Pos 8U /*!< SCB AIRCR: PRIGROUP Position */ +#define SCB_AIRCR_PRIGROUP_Msk (7UL << SCB_AIRCR_PRIGROUP_Pos) /*!< SCB AIRCR: PRIGROUP Mask */ + +#define SCB_AIRCR_SYSRESETREQ_Pos 2U /*!< SCB AIRCR: SYSRESETREQ Position */ +#define SCB_AIRCR_SYSRESETREQ_Msk (1UL << SCB_AIRCR_SYSRESETREQ_Pos) /*!< SCB AIRCR: SYSRESETREQ Mask */ + +#define SCB_AIRCR_VECTCLRACTIVE_Pos 1U /*!< SCB AIRCR: VECTCLRACTIVE Position */ +#define SCB_AIRCR_VECTCLRACTIVE_Msk (1UL << SCB_AIRCR_VECTCLRACTIVE_Pos) /*!< SCB AIRCR: VECTCLRACTIVE Mask */ + +#define SCB_AIRCR_VECTRESET_Pos 0U /*!< SCB AIRCR: VECTRESET Position */ +#define SCB_AIRCR_VECTRESET_Msk (1UL /*<< SCB_AIRCR_VECTRESET_Pos*/) /*!< SCB AIRCR: VECTRESET Mask */ + +/* SCB System Control Register Definitions */ +#define SCB_SCR_SEVONPEND_Pos 4U /*!< SCB SCR: SEVONPEND Position */ +#define SCB_SCR_SEVONPEND_Msk (1UL << SCB_SCR_SEVONPEND_Pos) /*!< SCB SCR: SEVONPEND Mask */ + +#define SCB_SCR_SLEEPDEEP_Pos 2U /*!< SCB SCR: SLEEPDEEP Position */ +#define SCB_SCR_SLEEPDEEP_Msk (1UL << SCB_SCR_SLEEPDEEP_Pos) /*!< SCB SCR: SLEEPDEEP Mask */ + +#define SCB_SCR_SLEEPONEXIT_Pos 1U /*!< SCB SCR: SLEEPONEXIT Position */ +#define SCB_SCR_SLEEPONEXIT_Msk (1UL << SCB_SCR_SLEEPONEXIT_Pos) /*!< SCB SCR: SLEEPONEXIT Mask */ + +/* SCB Configuration Control Register Definitions */ +#define SCB_CCR_STKALIGN_Pos 9U /*!< SCB CCR: STKALIGN Position */ +#define SCB_CCR_STKALIGN_Msk (1UL << SCB_CCR_STKALIGN_Pos) /*!< SCB CCR: STKALIGN Mask */ + +#define SCB_CCR_BFHFNMIGN_Pos 8U /*!< SCB CCR: BFHFNMIGN Position */ +#define SCB_CCR_BFHFNMIGN_Msk (1UL << SCB_CCR_BFHFNMIGN_Pos) /*!< SCB CCR: BFHFNMIGN Mask */ + +#define SCB_CCR_DIV_0_TRP_Pos 4U /*!< SCB CCR: DIV_0_TRP Position */ +#define SCB_CCR_DIV_0_TRP_Msk (1UL << SCB_CCR_DIV_0_TRP_Pos) /*!< SCB CCR: DIV_0_TRP Mask */ + +#define SCB_CCR_UNALIGN_TRP_Pos 3U /*!< SCB CCR: UNALIGN_TRP Position */ +#define SCB_CCR_UNALIGN_TRP_Msk (1UL << SCB_CCR_UNALIGN_TRP_Pos) /*!< SCB CCR: UNALIGN_TRP Mask */ + +#define SCB_CCR_USERSETMPEND_Pos 1U /*!< SCB CCR: USERSETMPEND Position */ +#define SCB_CCR_USERSETMPEND_Msk (1UL << SCB_CCR_USERSETMPEND_Pos) /*!< SCB CCR: USERSETMPEND Mask */ + +#define SCB_CCR_NONBASETHRDENA_Pos 0U /*!< SCB CCR: NONBASETHRDENA Position */ +#define SCB_CCR_NONBASETHRDENA_Msk (1UL /*<< SCB_CCR_NONBASETHRDENA_Pos*/) /*!< SCB CCR: NONBASETHRDENA Mask */ + +/* SCB System Handler Control and State Register Definitions */ +#define SCB_SHCSR_USGFAULTENA_Pos 18U /*!< SCB SHCSR: USGFAULTENA Position */ +#define SCB_SHCSR_USGFAULTENA_Msk (1UL << SCB_SHCSR_USGFAULTENA_Pos) /*!< SCB SHCSR: USGFAULTENA Mask */ + +#define SCB_SHCSR_BUSFAULTENA_Pos 17U /*!< SCB SHCSR: BUSFAULTENA Position */ +#define SCB_SHCSR_BUSFAULTENA_Msk (1UL << SCB_SHCSR_BUSFAULTENA_Pos) /*!< SCB SHCSR: BUSFAULTENA Mask */ + +#define SCB_SHCSR_MEMFAULTENA_Pos 16U /*!< SCB SHCSR: MEMFAULTENA Position */ +#define SCB_SHCSR_MEMFAULTENA_Msk (1UL << SCB_SHCSR_MEMFAULTENA_Pos) /*!< SCB SHCSR: MEMFAULTENA Mask */ + +#define SCB_SHCSR_SVCALLPENDED_Pos 15U /*!< SCB SHCSR: SVCALLPENDED Position */ +#define SCB_SHCSR_SVCALLPENDED_Msk (1UL << SCB_SHCSR_SVCALLPENDED_Pos) /*!< SCB SHCSR: SVCALLPENDED Mask */ + +#define SCB_SHCSR_BUSFAULTPENDED_Pos 14U /*!< SCB SHCSR: BUSFAULTPENDED Position */ +#define SCB_SHCSR_BUSFAULTPENDED_Msk (1UL << SCB_SHCSR_BUSFAULTPENDED_Pos) /*!< SCB SHCSR: BUSFAULTPENDED Mask */ + +#define SCB_SHCSR_MEMFAULTPENDED_Pos 13U /*!< SCB SHCSR: MEMFAULTPENDED Position */ +#define SCB_SHCSR_MEMFAULTPENDED_Msk (1UL << SCB_SHCSR_MEMFAULTPENDED_Pos) /*!< SCB SHCSR: MEMFAULTPENDED Mask */ + +#define SCB_SHCSR_USGFAULTPENDED_Pos 12U /*!< SCB SHCSR: USGFAULTPENDED Position */ +#define SCB_SHCSR_USGFAULTPENDED_Msk (1UL << SCB_SHCSR_USGFAULTPENDED_Pos) /*!< SCB SHCSR: USGFAULTPENDED Mask */ + +#define SCB_SHCSR_SYSTICKACT_Pos 11U /*!< SCB SHCSR: SYSTICKACT Position */ +#define SCB_SHCSR_SYSTICKACT_Msk (1UL << SCB_SHCSR_SYSTICKACT_Pos) /*!< SCB SHCSR: SYSTICKACT Mask */ + +#define SCB_SHCSR_PENDSVACT_Pos 10U /*!< SCB SHCSR: PENDSVACT Position */ +#define SCB_SHCSR_PENDSVACT_Msk (1UL << SCB_SHCSR_PENDSVACT_Pos) /*!< SCB SHCSR: PENDSVACT Mask */ + +#define SCB_SHCSR_MONITORACT_Pos 8U /*!< SCB SHCSR: MONITORACT Position */ +#define SCB_SHCSR_MONITORACT_Msk (1UL << SCB_SHCSR_MONITORACT_Pos) /*!< SCB SHCSR: MONITORACT Mask */ + +#define SCB_SHCSR_SVCALLACT_Pos 7U /*!< SCB SHCSR: SVCALLACT Position */ +#define SCB_SHCSR_SVCALLACT_Msk (1UL << SCB_SHCSR_SVCALLACT_Pos) /*!< SCB SHCSR: SVCALLACT Mask */ + +#define SCB_SHCSR_USGFAULTACT_Pos 3U /*!< SCB SHCSR: USGFAULTACT Position */ +#define SCB_SHCSR_USGFAULTACT_Msk (1UL << SCB_SHCSR_USGFAULTACT_Pos) /*!< SCB SHCSR: USGFAULTACT Mask */ + +#define SCB_SHCSR_BUSFAULTACT_Pos 1U /*!< SCB SHCSR: BUSFAULTACT Position */ +#define SCB_SHCSR_BUSFAULTACT_Msk (1UL << SCB_SHCSR_BUSFAULTACT_Pos) /*!< SCB SHCSR: BUSFAULTACT Mask */ + +#define SCB_SHCSR_MEMFAULTACT_Pos 0U /*!< SCB SHCSR: MEMFAULTACT Position */ +#define SCB_SHCSR_MEMFAULTACT_Msk (1UL /*<< SCB_SHCSR_MEMFAULTACT_Pos*/) /*!< SCB SHCSR: MEMFAULTACT Mask */ + +/* SCB Configurable Fault Status Register Definitions */ +#define SCB_CFSR_USGFAULTSR_Pos 16U /*!< SCB CFSR: Usage Fault Status Register Position */ +#define SCB_CFSR_USGFAULTSR_Msk (0xFFFFUL << SCB_CFSR_USGFAULTSR_Pos) /*!< SCB CFSR: Usage Fault Status Register Mask */ + +#define SCB_CFSR_BUSFAULTSR_Pos 8U /*!< SCB CFSR: Bus Fault Status Register Position */ +#define SCB_CFSR_BUSFAULTSR_Msk (0xFFUL << SCB_CFSR_BUSFAULTSR_Pos) /*!< SCB CFSR: Bus Fault Status Register Mask */ + +#define SCB_CFSR_MEMFAULTSR_Pos 0U /*!< SCB CFSR: Memory Manage Fault Status Register Position */ +#define SCB_CFSR_MEMFAULTSR_Msk (0xFFUL /*<< SCB_CFSR_MEMFAULTSR_Pos*/) /*!< SCB CFSR: Memory Manage Fault Status Register Mask */ + +/* SCB Hard Fault Status Register Definitions */ +#define SCB_HFSR_DEBUGEVT_Pos 31U /*!< SCB HFSR: DEBUGEVT Position */ +#define SCB_HFSR_DEBUGEVT_Msk (1UL << SCB_HFSR_DEBUGEVT_Pos) /*!< SCB HFSR: DEBUGEVT Mask */ + +#define SCB_HFSR_FORCED_Pos 30U /*!< SCB HFSR: FORCED Position */ +#define SCB_HFSR_FORCED_Msk (1UL << SCB_HFSR_FORCED_Pos) /*!< SCB HFSR: FORCED Mask */ + +#define SCB_HFSR_VECTTBL_Pos 1U /*!< SCB HFSR: VECTTBL Position */ +#define SCB_HFSR_VECTTBL_Msk (1UL << SCB_HFSR_VECTTBL_Pos) /*!< SCB HFSR: VECTTBL Mask */ + +/* SCB Debug Fault Status Register Definitions */ +#define SCB_DFSR_EXTERNAL_Pos 4U /*!< SCB DFSR: EXTERNAL Position */ +#define SCB_DFSR_EXTERNAL_Msk (1UL << SCB_DFSR_EXTERNAL_Pos) /*!< SCB DFSR: EXTERNAL Mask */ + +#define SCB_DFSR_VCATCH_Pos 3U /*!< SCB DFSR: VCATCH Position */ +#define SCB_DFSR_VCATCH_Msk (1UL << SCB_DFSR_VCATCH_Pos) /*!< SCB DFSR: VCATCH Mask */ + +#define SCB_DFSR_DWTTRAP_Pos 2U /*!< SCB DFSR: DWTTRAP Position */ +#define SCB_DFSR_DWTTRAP_Msk (1UL << SCB_DFSR_DWTTRAP_Pos) /*!< SCB DFSR: DWTTRAP Mask */ + +#define SCB_DFSR_BKPT_Pos 1U /*!< SCB DFSR: BKPT Position */ +#define SCB_DFSR_BKPT_Msk (1UL << SCB_DFSR_BKPT_Pos) /*!< SCB DFSR: BKPT Mask */ + +#define SCB_DFSR_HALTED_Pos 0U /*!< SCB DFSR: HALTED Position */ +#define SCB_DFSR_HALTED_Msk (1UL /*<< SCB_DFSR_HALTED_Pos*/) /*!< SCB DFSR: HALTED Mask */ + +/*@} end of group CMSIS_SCB */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_SCnSCB System Controls not in SCB (SCnSCB) + \brief Type definitions for the System Control and ID Register not in the SCB + @{ + */ + +/** + \brief Structure type to access the System Control and ID Register not in the SCB. + */ +typedef struct +{ + uint32_t RESERVED0[1U]; + __IM uint32_t ICTR; /*!< Offset: 0x004 (R/ ) Interrupt Controller Type Register */ + __IOM uint32_t ACTLR; /*!< Offset: 0x008 (R/W) Auxiliary Control Register */ +} SCnSCB_Type; + +/* Interrupt Controller Type Register Definitions */ +#define SCnSCB_ICTR_INTLINESNUM_Pos 0U /*!< ICTR: INTLINESNUM Position */ +#define SCnSCB_ICTR_INTLINESNUM_Msk (0xFUL /*<< SCnSCB_ICTR_INTLINESNUM_Pos*/) /*!< ICTR: INTLINESNUM Mask */ + +/* Auxiliary Control Register Definitions */ +#define SCnSCB_ACTLR_DISOOFP_Pos 9U /*!< ACTLR: DISOOFP Position */ +#define SCnSCB_ACTLR_DISOOFP_Msk (1UL << SCnSCB_ACTLR_DISOOFP_Pos) /*!< ACTLR: DISOOFP Mask */ + +#define SCnSCB_ACTLR_DISFPCA_Pos 8U /*!< ACTLR: DISFPCA Position */ +#define SCnSCB_ACTLR_DISFPCA_Msk (1UL << SCnSCB_ACTLR_DISFPCA_Pos) /*!< ACTLR: DISFPCA Mask */ + +#define SCnSCB_ACTLR_DISFOLD_Pos 2U /*!< ACTLR: DISFOLD Position */ +#define SCnSCB_ACTLR_DISFOLD_Msk (1UL << SCnSCB_ACTLR_DISFOLD_Pos) /*!< ACTLR: DISFOLD Mask */ + +#define SCnSCB_ACTLR_DISDEFWBUF_Pos 1U /*!< ACTLR: DISDEFWBUF Position */ +#define SCnSCB_ACTLR_DISDEFWBUF_Msk (1UL << SCnSCB_ACTLR_DISDEFWBUF_Pos) /*!< ACTLR: DISDEFWBUF Mask */ + +#define SCnSCB_ACTLR_DISMCYCINT_Pos 0U /*!< ACTLR: DISMCYCINT Position */ +#define SCnSCB_ACTLR_DISMCYCINT_Msk (1UL /*<< SCnSCB_ACTLR_DISMCYCINT_Pos*/) /*!< ACTLR: DISMCYCINT Mask */ + +/*@} end of group CMSIS_SCnotSCB */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_SysTick System Tick Timer (SysTick) + \brief Type definitions for the System Timer Registers. + @{ + */ + +/** + \brief Structure type to access the System Timer (SysTick). + */ +typedef struct +{ + __IOM uint32_t CTRL; /*!< Offset: 0x000 (R/W) SysTick Control and Status Register */ + __IOM uint32_t LOAD; /*!< Offset: 0x004 (R/W) SysTick Reload Value Register */ + __IOM uint32_t VAL; /*!< Offset: 0x008 (R/W) SysTick Current Value Register */ + __IM uint32_t CALIB; /*!< Offset: 0x00C (R/ ) SysTick Calibration Register */ +} SysTick_Type; + +/* SysTick Control / Status Register Definitions */ +#define SysTick_CTRL_COUNTFLAG_Pos 16U /*!< SysTick CTRL: COUNTFLAG Position */ +#define SysTick_CTRL_COUNTFLAG_Msk (1UL << SysTick_CTRL_COUNTFLAG_Pos) /*!< SysTick CTRL: COUNTFLAG Mask */ + +#define SysTick_CTRL_CLKSOURCE_Pos 2U /*!< SysTick CTRL: CLKSOURCE Position */ +#define SysTick_CTRL_CLKSOURCE_Msk (1UL << SysTick_CTRL_CLKSOURCE_Pos) /*!< SysTick CTRL: CLKSOURCE Mask */ + +#define SysTick_CTRL_TICKINT_Pos 1U /*!< SysTick CTRL: TICKINT Position */ +#define SysTick_CTRL_TICKINT_Msk (1UL << SysTick_CTRL_TICKINT_Pos) /*!< SysTick CTRL: TICKINT Mask */ + +#define SysTick_CTRL_ENABLE_Pos 0U /*!< SysTick CTRL: ENABLE Position */ +#define SysTick_CTRL_ENABLE_Msk (1UL /*<< SysTick_CTRL_ENABLE_Pos*/) /*!< SysTick CTRL: ENABLE Mask */ + +/* SysTick Reload Register Definitions */ +#define SysTick_LOAD_RELOAD_Pos 0U /*!< SysTick LOAD: RELOAD Position */ +#define SysTick_LOAD_RELOAD_Msk (0xFFFFFFUL /*<< SysTick_LOAD_RELOAD_Pos*/) /*!< SysTick LOAD: RELOAD Mask */ + +/* SysTick Current Register Definitions */ +#define SysTick_VAL_CURRENT_Pos 0U /*!< SysTick VAL: CURRENT Position */ +#define SysTick_VAL_CURRENT_Msk (0xFFFFFFUL /*<< SysTick_VAL_CURRENT_Pos*/) /*!< SysTick VAL: CURRENT Mask */ + +/* SysTick Calibration Register Definitions */ +#define SysTick_CALIB_NOREF_Pos 31U /*!< SysTick CALIB: NOREF Position */ +#define SysTick_CALIB_NOREF_Msk (1UL << SysTick_CALIB_NOREF_Pos) /*!< SysTick CALIB: NOREF Mask */ + +#define SysTick_CALIB_SKEW_Pos 30U /*!< SysTick CALIB: SKEW Position */ +#define SysTick_CALIB_SKEW_Msk (1UL << SysTick_CALIB_SKEW_Pos) /*!< SysTick CALIB: SKEW Mask */ + +#define SysTick_CALIB_TENMS_Pos 0U /*!< SysTick CALIB: TENMS Position */ +#define SysTick_CALIB_TENMS_Msk (0xFFFFFFUL /*<< SysTick_CALIB_TENMS_Pos*/) /*!< SysTick CALIB: TENMS Mask */ + +/*@} end of group CMSIS_SysTick */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_ITM Instrumentation Trace Macrocell (ITM) + \brief Type definitions for the Instrumentation Trace Macrocell (ITM) + @{ + */ + +/** + \brief Structure type to access the Instrumentation Trace Macrocell Register (ITM). + */ +typedef struct +{ + __OM union + { + __OM uint8_t u8; /*!< Offset: 0x000 ( /W) ITM Stimulus Port 8-bit */ + __OM uint16_t u16; /*!< Offset: 0x000 ( /W) ITM Stimulus Port 16-bit */ + __OM uint32_t u32; /*!< Offset: 0x000 ( /W) ITM Stimulus Port 32-bit */ + } PORT [32U]; /*!< Offset: 0x000 ( /W) ITM Stimulus Port Registers */ + uint32_t RESERVED0[864U]; + __IOM uint32_t TER; /*!< Offset: 0xE00 (R/W) ITM Trace Enable Register */ + uint32_t RESERVED1[15U]; + __IOM uint32_t TPR; /*!< Offset: 0xE40 (R/W) ITM Trace Privilege Register */ + uint32_t RESERVED2[15U]; + __IOM uint32_t TCR; /*!< Offset: 0xE80 (R/W) ITM Trace Control Register */ + uint32_t RESERVED3[29U]; + __OM uint32_t IWR; /*!< Offset: 0xEF8 ( /W) ITM Integration Write Register */ + __IM uint32_t IRR; /*!< Offset: 0xEFC (R/ ) ITM Integration Read Register */ + __IOM uint32_t IMCR; /*!< Offset: 0xF00 (R/W) ITM Integration Mode Control Register */ + uint32_t RESERVED4[43U]; + __OM uint32_t LAR; /*!< Offset: 0xFB0 ( /W) ITM Lock Access Register */ + __IM uint32_t LSR; /*!< Offset: 0xFB4 (R/ ) ITM Lock Status Register */ + uint32_t RESERVED5[6U]; + __IM uint32_t PID4; /*!< Offset: 0xFD0 (R/ ) ITM Peripheral Identification Register #4 */ + __IM uint32_t PID5; /*!< Offset: 0xFD4 (R/ ) ITM Peripheral Identification Register #5 */ + __IM uint32_t PID6; /*!< Offset: 0xFD8 (R/ ) ITM Peripheral Identification Register #6 */ + __IM uint32_t PID7; /*!< Offset: 0xFDC (R/ ) ITM Peripheral Identification Register #7 */ + __IM uint32_t PID0; /*!< Offset: 0xFE0 (R/ ) ITM Peripheral Identification Register #0 */ + __IM uint32_t PID1; /*!< Offset: 0xFE4 (R/ ) ITM Peripheral Identification Register #1 */ + __IM uint32_t PID2; /*!< Offset: 0xFE8 (R/ ) ITM Peripheral Identification Register #2 */ + __IM uint32_t PID3; /*!< Offset: 0xFEC (R/ ) ITM Peripheral Identification Register #3 */ + __IM uint32_t CID0; /*!< Offset: 0xFF0 (R/ ) ITM Component Identification Register #0 */ + __IM uint32_t CID1; /*!< Offset: 0xFF4 (R/ ) ITM Component Identification Register #1 */ + __IM uint32_t CID2; /*!< Offset: 0xFF8 (R/ ) ITM Component Identification Register #2 */ + __IM uint32_t CID3; /*!< Offset: 0xFFC (R/ ) ITM Component Identification Register #3 */ +} ITM_Type; + +/* ITM Trace Privilege Register Definitions */ +#define ITM_TPR_PRIVMASK_Pos 0U /*!< ITM TPR: PRIVMASK Position */ +#define ITM_TPR_PRIVMASK_Msk (0xFUL /*<< ITM_TPR_PRIVMASK_Pos*/) /*!< ITM TPR: PRIVMASK Mask */ + +/* ITM Trace Control Register Definitions */ +#define ITM_TCR_BUSY_Pos 23U /*!< ITM TCR: BUSY Position */ +#define ITM_TCR_BUSY_Msk (1UL << ITM_TCR_BUSY_Pos) /*!< ITM TCR: BUSY Mask */ + +#define ITM_TCR_TraceBusID_Pos 16U /*!< ITM TCR: ATBID Position */ +#define ITM_TCR_TraceBusID_Msk (0x7FUL << ITM_TCR_TraceBusID_Pos) /*!< ITM TCR: ATBID Mask */ + +#define ITM_TCR_GTSFREQ_Pos 10U /*!< ITM TCR: Global timestamp frequency Position */ +#define ITM_TCR_GTSFREQ_Msk (3UL << ITM_TCR_GTSFREQ_Pos) /*!< ITM TCR: Global timestamp frequency Mask */ + +#define ITM_TCR_TSPrescale_Pos 8U /*!< ITM TCR: TSPrescale Position */ +#define ITM_TCR_TSPrescale_Msk (3UL << ITM_TCR_TSPrescale_Pos) /*!< ITM TCR: TSPrescale Mask */ + +#define ITM_TCR_SWOENA_Pos 4U /*!< ITM TCR: SWOENA Position */ +#define ITM_TCR_SWOENA_Msk (1UL << ITM_TCR_SWOENA_Pos) /*!< ITM TCR: SWOENA Mask */ + +#define ITM_TCR_DWTENA_Pos 3U /*!< ITM TCR: DWTENA Position */ +#define ITM_TCR_DWTENA_Msk (1UL << ITM_TCR_DWTENA_Pos) /*!< ITM TCR: DWTENA Mask */ + +#define ITM_TCR_SYNCENA_Pos 2U /*!< ITM TCR: SYNCENA Position */ +#define ITM_TCR_SYNCENA_Msk (1UL << ITM_TCR_SYNCENA_Pos) /*!< ITM TCR: SYNCENA Mask */ + +#define ITM_TCR_TSENA_Pos 1U /*!< ITM TCR: TSENA Position */ +#define ITM_TCR_TSENA_Msk (1UL << ITM_TCR_TSENA_Pos) /*!< ITM TCR: TSENA Mask */ + +#define ITM_TCR_ITMENA_Pos 0U /*!< ITM TCR: ITM Enable bit Position */ +#define ITM_TCR_ITMENA_Msk (1UL /*<< ITM_TCR_ITMENA_Pos*/) /*!< ITM TCR: ITM Enable bit Mask */ + +/* ITM Integration Write Register Definitions */ +#define ITM_IWR_ATVALIDM_Pos 0U /*!< ITM IWR: ATVALIDM Position */ +#define ITM_IWR_ATVALIDM_Msk (1UL /*<< ITM_IWR_ATVALIDM_Pos*/) /*!< ITM IWR: ATVALIDM Mask */ + +/* ITM Integration Read Register Definitions */ +#define ITM_IRR_ATREADYM_Pos 0U /*!< ITM IRR: ATREADYM Position */ +#define ITM_IRR_ATREADYM_Msk (1UL /*<< ITM_IRR_ATREADYM_Pos*/) /*!< ITM IRR: ATREADYM Mask */ + +/* ITM Integration Mode Control Register Definitions */ +#define ITM_IMCR_INTEGRATION_Pos 0U /*!< ITM IMCR: INTEGRATION Position */ +#define ITM_IMCR_INTEGRATION_Msk (1UL /*<< ITM_IMCR_INTEGRATION_Pos*/) /*!< ITM IMCR: INTEGRATION Mask */ + +/* ITM Lock Status Register Definitions */ +#define ITM_LSR_ByteAcc_Pos 2U /*!< ITM LSR: ByteAcc Position */ +#define ITM_LSR_ByteAcc_Msk (1UL << ITM_LSR_ByteAcc_Pos) /*!< ITM LSR: ByteAcc Mask */ + +#define ITM_LSR_Access_Pos 1U /*!< ITM LSR: Access Position */ +#define ITM_LSR_Access_Msk (1UL << ITM_LSR_Access_Pos) /*!< ITM LSR: Access Mask */ + +#define ITM_LSR_Present_Pos 0U /*!< ITM LSR: Present Position */ +#define ITM_LSR_Present_Msk (1UL /*<< ITM_LSR_Present_Pos*/) /*!< ITM LSR: Present Mask */ + +/*@}*/ /* end of group CMSIS_ITM */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_DWT Data Watchpoint and Trace (DWT) + \brief Type definitions for the Data Watchpoint and Trace (DWT) + @{ + */ + +/** + \brief Structure type to access the Data Watchpoint and Trace Register (DWT). + */ +typedef struct +{ + __IOM uint32_t CTRL; /*!< Offset: 0x000 (R/W) Control Register */ + __IOM uint32_t CYCCNT; /*!< Offset: 0x004 (R/W) Cycle Count Register */ + __IOM uint32_t CPICNT; /*!< Offset: 0x008 (R/W) CPI Count Register */ + __IOM uint32_t EXCCNT; /*!< Offset: 0x00C (R/W) Exception Overhead Count Register */ + __IOM uint32_t SLEEPCNT; /*!< Offset: 0x010 (R/W) Sleep Count Register */ + __IOM uint32_t LSUCNT; /*!< Offset: 0x014 (R/W) LSU Count Register */ + __IOM uint32_t FOLDCNT; /*!< Offset: 0x018 (R/W) Folded-instruction Count Register */ + __IM uint32_t PCSR; /*!< Offset: 0x01C (R/ ) Program Counter Sample Register */ + __IOM uint32_t COMP0; /*!< Offset: 0x020 (R/W) Comparator Register 0 */ + __IOM uint32_t MASK0; /*!< Offset: 0x024 (R/W) Mask Register 0 */ + __IOM uint32_t FUNCTION0; /*!< Offset: 0x028 (R/W) Function Register 0 */ + uint32_t RESERVED0[1U]; + __IOM uint32_t COMP1; /*!< Offset: 0x030 (R/W) Comparator Register 1 */ + __IOM uint32_t MASK1; /*!< Offset: 0x034 (R/W) Mask Register 1 */ + __IOM uint32_t FUNCTION1; /*!< Offset: 0x038 (R/W) Function Register 1 */ + uint32_t RESERVED1[1U]; + __IOM uint32_t COMP2; /*!< Offset: 0x040 (R/W) Comparator Register 2 */ + __IOM uint32_t MASK2; /*!< Offset: 0x044 (R/W) Mask Register 2 */ + __IOM uint32_t FUNCTION2; /*!< Offset: 0x048 (R/W) Function Register 2 */ + uint32_t RESERVED2[1U]; + __IOM uint32_t COMP3; /*!< Offset: 0x050 (R/W) Comparator Register 3 */ + __IOM uint32_t MASK3; /*!< Offset: 0x054 (R/W) Mask Register 3 */ + __IOM uint32_t FUNCTION3; /*!< Offset: 0x058 (R/W) Function Register 3 */ +} DWT_Type; + +/* DWT Control Register Definitions */ +#define DWT_CTRL_NUMCOMP_Pos 28U /*!< DWT CTRL: NUMCOMP Position */ +#define DWT_CTRL_NUMCOMP_Msk (0xFUL << DWT_CTRL_NUMCOMP_Pos) /*!< DWT CTRL: NUMCOMP Mask */ + +#define DWT_CTRL_NOTRCPKT_Pos 27U /*!< DWT CTRL: NOTRCPKT Position */ +#define DWT_CTRL_NOTRCPKT_Msk (0x1UL << DWT_CTRL_NOTRCPKT_Pos) /*!< DWT CTRL: NOTRCPKT Mask */ + +#define DWT_CTRL_NOEXTTRIG_Pos 26U /*!< DWT CTRL: NOEXTTRIG Position */ +#define DWT_CTRL_NOEXTTRIG_Msk (0x1UL << DWT_CTRL_NOEXTTRIG_Pos) /*!< DWT CTRL: NOEXTTRIG Mask */ + +#define DWT_CTRL_NOCYCCNT_Pos 25U /*!< DWT CTRL: NOCYCCNT Position */ +#define DWT_CTRL_NOCYCCNT_Msk (0x1UL << DWT_CTRL_NOCYCCNT_Pos) /*!< DWT CTRL: NOCYCCNT Mask */ + +#define DWT_CTRL_NOPRFCNT_Pos 24U /*!< DWT CTRL: NOPRFCNT Position */ +#define DWT_CTRL_NOPRFCNT_Msk (0x1UL << DWT_CTRL_NOPRFCNT_Pos) /*!< DWT CTRL: NOPRFCNT Mask */ + +#define DWT_CTRL_CYCEVTENA_Pos 22U /*!< DWT CTRL: CYCEVTENA Position */ +#define DWT_CTRL_CYCEVTENA_Msk (0x1UL << DWT_CTRL_CYCEVTENA_Pos) /*!< DWT CTRL: CYCEVTENA Mask */ + +#define DWT_CTRL_FOLDEVTENA_Pos 21U /*!< DWT CTRL: FOLDEVTENA Position */ +#define DWT_CTRL_FOLDEVTENA_Msk (0x1UL << DWT_CTRL_FOLDEVTENA_Pos) /*!< DWT CTRL: FOLDEVTENA Mask */ + +#define DWT_CTRL_LSUEVTENA_Pos 20U /*!< DWT CTRL: LSUEVTENA Position */ +#define DWT_CTRL_LSUEVTENA_Msk (0x1UL << DWT_CTRL_LSUEVTENA_Pos) /*!< DWT CTRL: LSUEVTENA Mask */ + +#define DWT_CTRL_SLEEPEVTENA_Pos 19U /*!< DWT CTRL: SLEEPEVTENA Position */ +#define DWT_CTRL_SLEEPEVTENA_Msk (0x1UL << DWT_CTRL_SLEEPEVTENA_Pos) /*!< DWT CTRL: SLEEPEVTENA Mask */ + +#define DWT_CTRL_EXCEVTENA_Pos 18U /*!< DWT CTRL: EXCEVTENA Position */ +#define DWT_CTRL_EXCEVTENA_Msk (0x1UL << DWT_CTRL_EXCEVTENA_Pos) /*!< DWT CTRL: EXCEVTENA Mask */ + +#define DWT_CTRL_CPIEVTENA_Pos 17U /*!< DWT CTRL: CPIEVTENA Position */ +#define DWT_CTRL_CPIEVTENA_Msk (0x1UL << DWT_CTRL_CPIEVTENA_Pos) /*!< DWT CTRL: CPIEVTENA Mask */ + +#define DWT_CTRL_EXCTRCENA_Pos 16U /*!< DWT CTRL: EXCTRCENA Position */ +#define DWT_CTRL_EXCTRCENA_Msk (0x1UL << DWT_CTRL_EXCTRCENA_Pos) /*!< DWT CTRL: EXCTRCENA Mask */ + +#define DWT_CTRL_PCSAMPLENA_Pos 12U /*!< DWT CTRL: PCSAMPLENA Position */ +#define DWT_CTRL_PCSAMPLENA_Msk (0x1UL << DWT_CTRL_PCSAMPLENA_Pos) /*!< DWT CTRL: PCSAMPLENA Mask */ + +#define DWT_CTRL_SYNCTAP_Pos 10U /*!< DWT CTRL: SYNCTAP Position */ +#define DWT_CTRL_SYNCTAP_Msk (0x3UL << DWT_CTRL_SYNCTAP_Pos) /*!< DWT CTRL: SYNCTAP Mask */ + +#define DWT_CTRL_CYCTAP_Pos 9U /*!< DWT CTRL: CYCTAP Position */ +#define DWT_CTRL_CYCTAP_Msk (0x1UL << DWT_CTRL_CYCTAP_Pos) /*!< DWT CTRL: CYCTAP Mask */ + +#define DWT_CTRL_POSTINIT_Pos 5U /*!< DWT CTRL: POSTINIT Position */ +#define DWT_CTRL_POSTINIT_Msk (0xFUL << DWT_CTRL_POSTINIT_Pos) /*!< DWT CTRL: POSTINIT Mask */ + +#define DWT_CTRL_POSTPRESET_Pos 1U /*!< DWT CTRL: POSTPRESET Position */ +#define DWT_CTRL_POSTPRESET_Msk (0xFUL << DWT_CTRL_POSTPRESET_Pos) /*!< DWT CTRL: POSTPRESET Mask */ + +#define DWT_CTRL_CYCCNTENA_Pos 0U /*!< DWT CTRL: CYCCNTENA Position */ +#define DWT_CTRL_CYCCNTENA_Msk (0x1UL /*<< DWT_CTRL_CYCCNTENA_Pos*/) /*!< DWT CTRL: CYCCNTENA Mask */ + +/* DWT CPI Count Register Definitions */ +#define DWT_CPICNT_CPICNT_Pos 0U /*!< DWT CPICNT: CPICNT Position */ +#define DWT_CPICNT_CPICNT_Msk (0xFFUL /*<< DWT_CPICNT_CPICNT_Pos*/) /*!< DWT CPICNT: CPICNT Mask */ + +/* DWT Exception Overhead Count Register Definitions */ +#define DWT_EXCCNT_EXCCNT_Pos 0U /*!< DWT EXCCNT: EXCCNT Position */ +#define DWT_EXCCNT_EXCCNT_Msk (0xFFUL /*<< DWT_EXCCNT_EXCCNT_Pos*/) /*!< DWT EXCCNT: EXCCNT Mask */ + +/* DWT Sleep Count Register Definitions */ +#define DWT_SLEEPCNT_SLEEPCNT_Pos 0U /*!< DWT SLEEPCNT: SLEEPCNT Position */ +#define DWT_SLEEPCNT_SLEEPCNT_Msk (0xFFUL /*<< DWT_SLEEPCNT_SLEEPCNT_Pos*/) /*!< DWT SLEEPCNT: SLEEPCNT Mask */ + +/* DWT LSU Count Register Definitions */ +#define DWT_LSUCNT_LSUCNT_Pos 0U /*!< DWT LSUCNT: LSUCNT Position */ +#define DWT_LSUCNT_LSUCNT_Msk (0xFFUL /*<< DWT_LSUCNT_LSUCNT_Pos*/) /*!< DWT LSUCNT: LSUCNT Mask */ + +/* DWT Folded-instruction Count Register Definitions */ +#define DWT_FOLDCNT_FOLDCNT_Pos 0U /*!< DWT FOLDCNT: FOLDCNT Position */ +#define DWT_FOLDCNT_FOLDCNT_Msk (0xFFUL /*<< DWT_FOLDCNT_FOLDCNT_Pos*/) /*!< DWT FOLDCNT: FOLDCNT Mask */ + +/* DWT Comparator Mask Register Definitions */ +#define DWT_MASK_MASK_Pos 0U /*!< DWT MASK: MASK Position */ +#define DWT_MASK_MASK_Msk (0x1FUL /*<< DWT_MASK_MASK_Pos*/) /*!< DWT MASK: MASK Mask */ + +/* DWT Comparator Function Register Definitions */ +#define DWT_FUNCTION_MATCHED_Pos 24U /*!< DWT FUNCTION: MATCHED Position */ +#define DWT_FUNCTION_MATCHED_Msk (0x1UL << DWT_FUNCTION_MATCHED_Pos) /*!< DWT FUNCTION: MATCHED Mask */ + +#define DWT_FUNCTION_DATAVADDR1_Pos 16U /*!< DWT FUNCTION: DATAVADDR1 Position */ +#define DWT_FUNCTION_DATAVADDR1_Msk (0xFUL << DWT_FUNCTION_DATAVADDR1_Pos) /*!< DWT FUNCTION: DATAVADDR1 Mask */ + +#define DWT_FUNCTION_DATAVADDR0_Pos 12U /*!< DWT FUNCTION: DATAVADDR0 Position */ +#define DWT_FUNCTION_DATAVADDR0_Msk (0xFUL << DWT_FUNCTION_DATAVADDR0_Pos) /*!< DWT FUNCTION: DATAVADDR0 Mask */ + +#define DWT_FUNCTION_DATAVSIZE_Pos 10U /*!< DWT FUNCTION: DATAVSIZE Position */ +#define DWT_FUNCTION_DATAVSIZE_Msk (0x3UL << DWT_FUNCTION_DATAVSIZE_Pos) /*!< DWT FUNCTION: DATAVSIZE Mask */ + +#define DWT_FUNCTION_LNK1ENA_Pos 9U /*!< DWT FUNCTION: LNK1ENA Position */ +#define DWT_FUNCTION_LNK1ENA_Msk (0x1UL << DWT_FUNCTION_LNK1ENA_Pos) /*!< DWT FUNCTION: LNK1ENA Mask */ + +#define DWT_FUNCTION_DATAVMATCH_Pos 8U /*!< DWT FUNCTION: DATAVMATCH Position */ +#define DWT_FUNCTION_DATAVMATCH_Msk (0x1UL << DWT_FUNCTION_DATAVMATCH_Pos) /*!< DWT FUNCTION: DATAVMATCH Mask */ + +#define DWT_FUNCTION_CYCMATCH_Pos 7U /*!< DWT FUNCTION: CYCMATCH Position */ +#define DWT_FUNCTION_CYCMATCH_Msk (0x1UL << DWT_FUNCTION_CYCMATCH_Pos) /*!< DWT FUNCTION: CYCMATCH Mask */ + +#define DWT_FUNCTION_EMITRANGE_Pos 5U /*!< DWT FUNCTION: EMITRANGE Position */ +#define DWT_FUNCTION_EMITRANGE_Msk (0x1UL << DWT_FUNCTION_EMITRANGE_Pos) /*!< DWT FUNCTION: EMITRANGE Mask */ + +#define DWT_FUNCTION_FUNCTION_Pos 0U /*!< DWT FUNCTION: FUNCTION Position */ +#define DWT_FUNCTION_FUNCTION_Msk (0xFUL /*<< DWT_FUNCTION_FUNCTION_Pos*/) /*!< DWT FUNCTION: FUNCTION Mask */ + +/*@}*/ /* end of group CMSIS_DWT */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_TPI Trace Port Interface (TPI) + \brief Type definitions for the Trace Port Interface (TPI) + @{ + */ + +/** + \brief Structure type to access the Trace Port Interface Register (TPI). + */ +typedef struct +{ + __IOM uint32_t SSPSR; /*!< Offset: 0x000 (R/ ) Supported Parallel Port Size Register */ + __IOM uint32_t CSPSR; /*!< Offset: 0x004 (R/W) Current Parallel Port Size Register */ + uint32_t RESERVED0[2U]; + __IOM uint32_t ACPR; /*!< Offset: 0x010 (R/W) Asynchronous Clock Prescaler Register */ + uint32_t RESERVED1[55U]; + __IOM uint32_t SPPR; /*!< Offset: 0x0F0 (R/W) Selected Pin Protocol Register */ + uint32_t RESERVED2[131U]; + __IM uint32_t FFSR; /*!< Offset: 0x300 (R/ ) Formatter and Flush Status Register */ + __IOM uint32_t FFCR; /*!< Offset: 0x304 (R/W) Formatter and Flush Control Register */ + __IM uint32_t FSCR; /*!< Offset: 0x308 (R/ ) Formatter Synchronization Counter Register */ + uint32_t RESERVED3[759U]; + __IM uint32_t TRIGGER; /*!< Offset: 0xEE8 (R/ ) TRIGGER */ + __IM uint32_t FIFO0; /*!< Offset: 0xEEC (R/ ) Integration ETM Data */ + __IM uint32_t ITATBCTR2; /*!< Offset: 0xEF0 (R/ ) ITATBCTR2 */ + uint32_t RESERVED4[1U]; + __IM uint32_t ITATBCTR0; /*!< Offset: 0xEF8 (R/ ) ITATBCTR0 */ + __IM uint32_t FIFO1; /*!< Offset: 0xEFC (R/ ) Integration ITM Data */ + __IOM uint32_t ITCTRL; /*!< Offset: 0xF00 (R/W) Integration Mode Control */ + uint32_t RESERVED5[39U]; + __IOM uint32_t CLAIMSET; /*!< Offset: 0xFA0 (R/W) Claim tag set */ + __IOM uint32_t CLAIMCLR; /*!< Offset: 0xFA4 (R/W) Claim tag clear */ + uint32_t RESERVED7[8U]; + __IM uint32_t DEVID; /*!< Offset: 0xFC8 (R/ ) TPIU_DEVID */ + __IM uint32_t DEVTYPE; /*!< Offset: 0xFCC (R/ ) TPIU_DEVTYPE */ +} TPI_Type; + +/* TPI Asynchronous Clock Prescaler Register Definitions */ +#define TPI_ACPR_PRESCALER_Pos 0U /*!< TPI ACPR: PRESCALER Position */ +#define TPI_ACPR_PRESCALER_Msk (0x1FFFUL /*<< TPI_ACPR_PRESCALER_Pos*/) /*!< TPI ACPR: PRESCALER Mask */ + +/* TPI Selected Pin Protocol Register Definitions */ +#define TPI_SPPR_TXMODE_Pos 0U /*!< TPI SPPR: TXMODE Position */ +#define TPI_SPPR_TXMODE_Msk (0x3UL /*<< TPI_SPPR_TXMODE_Pos*/) /*!< TPI SPPR: TXMODE Mask */ + +/* TPI Formatter and Flush Status Register Definitions */ +#define TPI_FFSR_FtNonStop_Pos 3U /*!< TPI FFSR: FtNonStop Position */ +#define TPI_FFSR_FtNonStop_Msk (0x1UL << TPI_FFSR_FtNonStop_Pos) /*!< TPI FFSR: FtNonStop Mask */ + +#define TPI_FFSR_TCPresent_Pos 2U /*!< TPI FFSR: TCPresent Position */ +#define TPI_FFSR_TCPresent_Msk (0x1UL << TPI_FFSR_TCPresent_Pos) /*!< TPI FFSR: TCPresent Mask */ + +#define TPI_FFSR_FtStopped_Pos 1U /*!< TPI FFSR: FtStopped Position */ +#define TPI_FFSR_FtStopped_Msk (0x1UL << TPI_FFSR_FtStopped_Pos) /*!< TPI FFSR: FtStopped Mask */ + +#define TPI_FFSR_FlInProg_Pos 0U /*!< TPI FFSR: FlInProg Position */ +#define TPI_FFSR_FlInProg_Msk (0x1UL /*<< TPI_FFSR_FlInProg_Pos*/) /*!< TPI FFSR: FlInProg Mask */ + +/* TPI Formatter and Flush Control Register Definitions */ +#define TPI_FFCR_TrigIn_Pos 8U /*!< TPI FFCR: TrigIn Position */ +#define TPI_FFCR_TrigIn_Msk (0x1UL << TPI_FFCR_TrigIn_Pos) /*!< TPI FFCR: TrigIn Mask */ + +#define TPI_FFCR_EnFCont_Pos 1U /*!< TPI FFCR: EnFCont Position */ +#define TPI_FFCR_EnFCont_Msk (0x1UL << TPI_FFCR_EnFCont_Pos) /*!< TPI FFCR: EnFCont Mask */ + +/* TPI TRIGGER Register Definitions */ +#define TPI_TRIGGER_TRIGGER_Pos 0U /*!< TPI TRIGGER: TRIGGER Position */ +#define TPI_TRIGGER_TRIGGER_Msk (0x1UL /*<< TPI_TRIGGER_TRIGGER_Pos*/) /*!< TPI TRIGGER: TRIGGER Mask */ + +/* TPI Integration ETM Data Register Definitions (FIFO0) */ +#define TPI_FIFO0_ITM_ATVALID_Pos 29U /*!< TPI FIFO0: ITM_ATVALID Position */ +#define TPI_FIFO0_ITM_ATVALID_Msk (0x3UL << TPI_FIFO0_ITM_ATVALID_Pos) /*!< TPI FIFO0: ITM_ATVALID Mask */ + +#define TPI_FIFO0_ITM_bytecount_Pos 27U /*!< TPI FIFO0: ITM_bytecount Position */ +#define TPI_FIFO0_ITM_bytecount_Msk (0x3UL << TPI_FIFO0_ITM_bytecount_Pos) /*!< TPI FIFO0: ITM_bytecount Mask */ + +#define TPI_FIFO0_ETM_ATVALID_Pos 26U /*!< TPI FIFO0: ETM_ATVALID Position */ +#define TPI_FIFO0_ETM_ATVALID_Msk (0x3UL << TPI_FIFO0_ETM_ATVALID_Pos) /*!< TPI FIFO0: ETM_ATVALID Mask */ + +#define TPI_FIFO0_ETM_bytecount_Pos 24U /*!< TPI FIFO0: ETM_bytecount Position */ +#define TPI_FIFO0_ETM_bytecount_Msk (0x3UL << TPI_FIFO0_ETM_bytecount_Pos) /*!< TPI FIFO0: ETM_bytecount Mask */ + +#define TPI_FIFO0_ETM2_Pos 16U /*!< TPI FIFO0: ETM2 Position */ +#define TPI_FIFO0_ETM2_Msk (0xFFUL << TPI_FIFO0_ETM2_Pos) /*!< TPI FIFO0: ETM2 Mask */ + +#define TPI_FIFO0_ETM1_Pos 8U /*!< TPI FIFO0: ETM1 Position */ +#define TPI_FIFO0_ETM1_Msk (0xFFUL << TPI_FIFO0_ETM1_Pos) /*!< TPI FIFO0: ETM1 Mask */ + +#define TPI_FIFO0_ETM0_Pos 0U /*!< TPI FIFO0: ETM0 Position */ +#define TPI_FIFO0_ETM0_Msk (0xFFUL /*<< TPI_FIFO0_ETM0_Pos*/) /*!< TPI FIFO0: ETM0 Mask */ + +/* TPI ITATBCTR2 Register Definitions */ +#define TPI_ITATBCTR2_ATREADY_Pos 0U /*!< TPI ITATBCTR2: ATREADY Position */ +#define TPI_ITATBCTR2_ATREADY_Msk (0x1UL /*<< TPI_ITATBCTR2_ATREADY_Pos*/) /*!< TPI ITATBCTR2: ATREADY Mask */ + +/* TPI Integration ITM Data Register Definitions (FIFO1) */ +#define TPI_FIFO1_ITM_ATVALID_Pos 29U /*!< TPI FIFO1: ITM_ATVALID Position */ +#define TPI_FIFO1_ITM_ATVALID_Msk (0x3UL << TPI_FIFO1_ITM_ATVALID_Pos) /*!< TPI FIFO1: ITM_ATVALID Mask */ + +#define TPI_FIFO1_ITM_bytecount_Pos 27U /*!< TPI FIFO1: ITM_bytecount Position */ +#define TPI_FIFO1_ITM_bytecount_Msk (0x3UL << TPI_FIFO1_ITM_bytecount_Pos) /*!< TPI FIFO1: ITM_bytecount Mask */ + +#define TPI_FIFO1_ETM_ATVALID_Pos 26U /*!< TPI FIFO1: ETM_ATVALID Position */ +#define TPI_FIFO1_ETM_ATVALID_Msk (0x3UL << TPI_FIFO1_ETM_ATVALID_Pos) /*!< TPI FIFO1: ETM_ATVALID Mask */ + +#define TPI_FIFO1_ETM_bytecount_Pos 24U /*!< TPI FIFO1: ETM_bytecount Position */ +#define TPI_FIFO1_ETM_bytecount_Msk (0x3UL << TPI_FIFO1_ETM_bytecount_Pos) /*!< TPI FIFO1: ETM_bytecount Mask */ + +#define TPI_FIFO1_ITM2_Pos 16U /*!< TPI FIFO1: ITM2 Position */ +#define TPI_FIFO1_ITM2_Msk (0xFFUL << TPI_FIFO1_ITM2_Pos) /*!< TPI FIFO1: ITM2 Mask */ + +#define TPI_FIFO1_ITM1_Pos 8U /*!< TPI FIFO1: ITM1 Position */ +#define TPI_FIFO1_ITM1_Msk (0xFFUL << TPI_FIFO1_ITM1_Pos) /*!< TPI FIFO1: ITM1 Mask */ + +#define TPI_FIFO1_ITM0_Pos 0U /*!< TPI FIFO1: ITM0 Position */ +#define TPI_FIFO1_ITM0_Msk (0xFFUL /*<< TPI_FIFO1_ITM0_Pos*/) /*!< TPI FIFO1: ITM0 Mask */ + +/* TPI ITATBCTR0 Register Definitions */ +#define TPI_ITATBCTR0_ATREADY_Pos 0U /*!< TPI ITATBCTR0: ATREADY Position */ +#define TPI_ITATBCTR0_ATREADY_Msk (0x1UL /*<< TPI_ITATBCTR0_ATREADY_Pos*/) /*!< TPI ITATBCTR0: ATREADY Mask */ + +/* TPI Integration Mode Control Register Definitions */ +#define TPI_ITCTRL_Mode_Pos 0U /*!< TPI ITCTRL: Mode Position */ +#define TPI_ITCTRL_Mode_Msk (0x1UL /*<< TPI_ITCTRL_Mode_Pos*/) /*!< TPI ITCTRL: Mode Mask */ + +/* TPI DEVID Register Definitions */ +#define TPI_DEVID_NRZVALID_Pos 11U /*!< TPI DEVID: NRZVALID Position */ +#define TPI_DEVID_NRZVALID_Msk (0x1UL << TPI_DEVID_NRZVALID_Pos) /*!< TPI DEVID: NRZVALID Mask */ + +#define TPI_DEVID_MANCVALID_Pos 10U /*!< TPI DEVID: MANCVALID Position */ +#define TPI_DEVID_MANCVALID_Msk (0x1UL << TPI_DEVID_MANCVALID_Pos) /*!< TPI DEVID: MANCVALID Mask */ + +#define TPI_DEVID_PTINVALID_Pos 9U /*!< TPI DEVID: PTINVALID Position */ +#define TPI_DEVID_PTINVALID_Msk (0x1UL << TPI_DEVID_PTINVALID_Pos) /*!< TPI DEVID: PTINVALID Mask */ + +#define TPI_DEVID_MinBufSz_Pos 6U /*!< TPI DEVID: MinBufSz Position */ +#define TPI_DEVID_MinBufSz_Msk (0x7UL << TPI_DEVID_MinBufSz_Pos) /*!< TPI DEVID: MinBufSz Mask */ + +#define TPI_DEVID_AsynClkIn_Pos 5U /*!< TPI DEVID: AsynClkIn Position */ +#define TPI_DEVID_AsynClkIn_Msk (0x1UL << TPI_DEVID_AsynClkIn_Pos) /*!< TPI DEVID: AsynClkIn Mask */ + +#define TPI_DEVID_NrTraceInput_Pos 0U /*!< TPI DEVID: NrTraceInput Position */ +#define TPI_DEVID_NrTraceInput_Msk (0x1FUL /*<< TPI_DEVID_NrTraceInput_Pos*/) /*!< TPI DEVID: NrTraceInput Mask */ + +/* TPI DEVTYPE Register Definitions */ +#define TPI_DEVTYPE_MajorType_Pos 4U /*!< TPI DEVTYPE: MajorType Position */ +#define TPI_DEVTYPE_MajorType_Msk (0xFUL << TPI_DEVTYPE_MajorType_Pos) /*!< TPI DEVTYPE: MajorType Mask */ + +#define TPI_DEVTYPE_SubType_Pos 0U /*!< TPI DEVTYPE: SubType Position */ +#define TPI_DEVTYPE_SubType_Msk (0xFUL /*<< TPI_DEVTYPE_SubType_Pos*/) /*!< TPI DEVTYPE: SubType Mask */ + +/*@}*/ /* end of group CMSIS_TPI */ + + +#if (__MPU_PRESENT == 1U) +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_MPU Memory Protection Unit (MPU) + \brief Type definitions for the Memory Protection Unit (MPU) + @{ + */ + +/** + \brief Structure type to access the Memory Protection Unit (MPU). + */ +typedef struct +{ + __IM uint32_t TYPE; /*!< Offset: 0x000 (R/ ) MPU Type Register */ + __IOM uint32_t CTRL; /*!< Offset: 0x004 (R/W) MPU Control Register */ + __IOM uint32_t RNR; /*!< Offset: 0x008 (R/W) MPU Region RNRber Register */ + __IOM uint32_t RBAR; /*!< Offset: 0x00C (R/W) MPU Region Base Address Register */ + __IOM uint32_t RASR; /*!< Offset: 0x010 (R/W) MPU Region Attribute and Size Register */ + __IOM uint32_t RBAR_A1; /*!< Offset: 0x014 (R/W) MPU Alias 1 Region Base Address Register */ + __IOM uint32_t RASR_A1; /*!< Offset: 0x018 (R/W) MPU Alias 1 Region Attribute and Size Register */ + __IOM uint32_t RBAR_A2; /*!< Offset: 0x01C (R/W) MPU Alias 2 Region Base Address Register */ + __IOM uint32_t RASR_A2; /*!< Offset: 0x020 (R/W) MPU Alias 2 Region Attribute and Size Register */ + __IOM uint32_t RBAR_A3; /*!< Offset: 0x024 (R/W) MPU Alias 3 Region Base Address Register */ + __IOM uint32_t RASR_A3; /*!< Offset: 0x028 (R/W) MPU Alias 3 Region Attribute and Size Register */ +} MPU_Type; + +/* MPU Type Register Definitions */ +#define MPU_TYPE_IREGION_Pos 16U /*!< MPU TYPE: IREGION Position */ +#define MPU_TYPE_IREGION_Msk (0xFFUL << MPU_TYPE_IREGION_Pos) /*!< MPU TYPE: IREGION Mask */ + +#define MPU_TYPE_DREGION_Pos 8U /*!< MPU TYPE: DREGION Position */ +#define MPU_TYPE_DREGION_Msk (0xFFUL << MPU_TYPE_DREGION_Pos) /*!< MPU TYPE: DREGION Mask */ + +#define MPU_TYPE_SEPARATE_Pos 0U /*!< MPU TYPE: SEPARATE Position */ +#define MPU_TYPE_SEPARATE_Msk (1UL /*<< MPU_TYPE_SEPARATE_Pos*/) /*!< MPU TYPE: SEPARATE Mask */ + +/* MPU Control Register Definitions */ +#define MPU_CTRL_PRIVDEFENA_Pos 2U /*!< MPU CTRL: PRIVDEFENA Position */ +#define MPU_CTRL_PRIVDEFENA_Msk (1UL << MPU_CTRL_PRIVDEFENA_Pos) /*!< MPU CTRL: PRIVDEFENA Mask */ + +#define MPU_CTRL_HFNMIENA_Pos 1U /*!< MPU CTRL: HFNMIENA Position */ +#define MPU_CTRL_HFNMIENA_Msk (1UL << MPU_CTRL_HFNMIENA_Pos) /*!< MPU CTRL: HFNMIENA Mask */ + +#define MPU_CTRL_ENABLE_Pos 0U /*!< MPU CTRL: ENABLE Position */ +#define MPU_CTRL_ENABLE_Msk (1UL /*<< MPU_CTRL_ENABLE_Pos*/) /*!< MPU CTRL: ENABLE Mask */ + +/* MPU Region Number Register Definitions */ +#define MPU_RNR_REGION_Pos 0U /*!< MPU RNR: REGION Position */ +#define MPU_RNR_REGION_Msk (0xFFUL /*<< MPU_RNR_REGION_Pos*/) /*!< MPU RNR: REGION Mask */ + +/* MPU Region Base Address Register Definitions */ +#define MPU_RBAR_ADDR_Pos 5U /*!< MPU RBAR: ADDR Position */ +#define MPU_RBAR_ADDR_Msk (0x7FFFFFFUL << MPU_RBAR_ADDR_Pos) /*!< MPU RBAR: ADDR Mask */ + +#define MPU_RBAR_VALID_Pos 4U /*!< MPU RBAR: VALID Position */ +#define MPU_RBAR_VALID_Msk (1UL << MPU_RBAR_VALID_Pos) /*!< MPU RBAR: VALID Mask */ + +#define MPU_RBAR_REGION_Pos 0U /*!< MPU RBAR: REGION Position */ +#define MPU_RBAR_REGION_Msk (0xFUL /*<< MPU_RBAR_REGION_Pos*/) /*!< MPU RBAR: REGION Mask */ + +/* MPU Region Attribute and Size Register Definitions */ +#define MPU_RASR_ATTRS_Pos 16U /*!< MPU RASR: MPU Region Attribute field Position */ +#define MPU_RASR_ATTRS_Msk (0xFFFFUL << MPU_RASR_ATTRS_Pos) /*!< MPU RASR: MPU Region Attribute field Mask */ + +#define MPU_RASR_XN_Pos 28U /*!< MPU RASR: ATTRS.XN Position */ +#define MPU_RASR_XN_Msk (1UL << MPU_RASR_XN_Pos) /*!< MPU RASR: ATTRS.XN Mask */ + +#define MPU_RASR_AP_Pos 24U /*!< MPU RASR: ATTRS.AP Position */ +#define MPU_RASR_AP_Msk (0x7UL << MPU_RASR_AP_Pos) /*!< MPU RASR: ATTRS.AP Mask */ + +#define MPU_RASR_TEX_Pos 19U /*!< MPU RASR: ATTRS.TEX Position */ +#define MPU_RASR_TEX_Msk (0x7UL << MPU_RASR_TEX_Pos) /*!< MPU RASR: ATTRS.TEX Mask */ + +#define MPU_RASR_S_Pos 18U /*!< MPU RASR: ATTRS.S Position */ +#define MPU_RASR_S_Msk (1UL << MPU_RASR_S_Pos) /*!< MPU RASR: ATTRS.S Mask */ + +#define MPU_RASR_C_Pos 17U /*!< MPU RASR: ATTRS.C Position */ +#define MPU_RASR_C_Msk (1UL << MPU_RASR_C_Pos) /*!< MPU RASR: ATTRS.C Mask */ + +#define MPU_RASR_B_Pos 16U /*!< MPU RASR: ATTRS.B Position */ +#define MPU_RASR_B_Msk (1UL << MPU_RASR_B_Pos) /*!< MPU RASR: ATTRS.B Mask */ + +#define MPU_RASR_SRD_Pos 8U /*!< MPU RASR: Sub-Region Disable Position */ +#define MPU_RASR_SRD_Msk (0xFFUL << MPU_RASR_SRD_Pos) /*!< MPU RASR: Sub-Region Disable Mask */ + +#define MPU_RASR_SIZE_Pos 1U /*!< MPU RASR: Region Size Field Position */ +#define MPU_RASR_SIZE_Msk (0x1FUL << MPU_RASR_SIZE_Pos) /*!< MPU RASR: Region Size Field Mask */ + +#define MPU_RASR_ENABLE_Pos 0U /*!< MPU RASR: Region enable bit Position */ +#define MPU_RASR_ENABLE_Msk (1UL /*<< MPU_RASR_ENABLE_Pos*/) /*!< MPU RASR: Region enable bit Disable Mask */ + +/*@} end of group CMSIS_MPU */ +#endif + + +#if (__FPU_PRESENT == 1U) +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_FPU Floating Point Unit (FPU) + \brief Type definitions for the Floating Point Unit (FPU) + @{ + */ + +/** + \brief Structure type to access the Floating Point Unit (FPU). + */ +typedef struct +{ + uint32_t RESERVED0[1U]; + __IOM uint32_t FPCCR; /*!< Offset: 0x004 (R/W) Floating-Point Context Control Register */ + __IOM uint32_t FPCAR; /*!< Offset: 0x008 (R/W) Floating-Point Context Address Register */ + __IOM uint32_t FPDSCR; /*!< Offset: 0x00C (R/W) Floating-Point Default Status Control Register */ + __IM uint32_t MVFR0; /*!< Offset: 0x010 (R/ ) Media and FP Feature Register 0 */ + __IM uint32_t MVFR1; /*!< Offset: 0x014 (R/ ) Media and FP Feature Register 1 */ +} FPU_Type; + +/* Floating-Point Context Control Register Definitions */ +#define FPU_FPCCR_ASPEN_Pos 31U /*!< FPCCR: ASPEN bit Position */ +#define FPU_FPCCR_ASPEN_Msk (1UL << FPU_FPCCR_ASPEN_Pos) /*!< FPCCR: ASPEN bit Mask */ + +#define FPU_FPCCR_LSPEN_Pos 30U /*!< FPCCR: LSPEN Position */ +#define FPU_FPCCR_LSPEN_Msk (1UL << FPU_FPCCR_LSPEN_Pos) /*!< FPCCR: LSPEN bit Mask */ + +#define FPU_FPCCR_MONRDY_Pos 8U /*!< FPCCR: MONRDY Position */ +#define FPU_FPCCR_MONRDY_Msk (1UL << FPU_FPCCR_MONRDY_Pos) /*!< FPCCR: MONRDY bit Mask */ + +#define FPU_FPCCR_BFRDY_Pos 6U /*!< FPCCR: BFRDY Position */ +#define FPU_FPCCR_BFRDY_Msk (1UL << FPU_FPCCR_BFRDY_Pos) /*!< FPCCR: BFRDY bit Mask */ + +#define FPU_FPCCR_MMRDY_Pos 5U /*!< FPCCR: MMRDY Position */ +#define FPU_FPCCR_MMRDY_Msk (1UL << FPU_FPCCR_MMRDY_Pos) /*!< FPCCR: MMRDY bit Mask */ + +#define FPU_FPCCR_HFRDY_Pos 4U /*!< FPCCR: HFRDY Position */ +#define FPU_FPCCR_HFRDY_Msk (1UL << FPU_FPCCR_HFRDY_Pos) /*!< FPCCR: HFRDY bit Mask */ + +#define FPU_FPCCR_THREAD_Pos 3U /*!< FPCCR: processor mode bit Position */ +#define FPU_FPCCR_THREAD_Msk (1UL << FPU_FPCCR_THREAD_Pos) /*!< FPCCR: processor mode active bit Mask */ + +#define FPU_FPCCR_USER_Pos 1U /*!< FPCCR: privilege level bit Position */ +#define FPU_FPCCR_USER_Msk (1UL << FPU_FPCCR_USER_Pos) /*!< FPCCR: privilege level bit Mask */ + +#define FPU_FPCCR_LSPACT_Pos 0U /*!< FPCCR: Lazy state preservation active bit Position */ +#define FPU_FPCCR_LSPACT_Msk (1UL /*<< FPU_FPCCR_LSPACT_Pos*/) /*!< FPCCR: Lazy state preservation active bit Mask */ + +/* Floating-Point Context Address Register Definitions */ +#define FPU_FPCAR_ADDRESS_Pos 3U /*!< FPCAR: ADDRESS bit Position */ +#define FPU_FPCAR_ADDRESS_Msk (0x1FFFFFFFUL << FPU_FPCAR_ADDRESS_Pos) /*!< FPCAR: ADDRESS bit Mask */ + +/* Floating-Point Default Status Control Register Definitions */ +#define FPU_FPDSCR_AHP_Pos 26U /*!< FPDSCR: AHP bit Position */ +#define FPU_FPDSCR_AHP_Msk (1UL << FPU_FPDSCR_AHP_Pos) /*!< FPDSCR: AHP bit Mask */ + +#define FPU_FPDSCR_DN_Pos 25U /*!< FPDSCR: DN bit Position */ +#define FPU_FPDSCR_DN_Msk (1UL << FPU_FPDSCR_DN_Pos) /*!< FPDSCR: DN bit Mask */ + +#define FPU_FPDSCR_FZ_Pos 24U /*!< FPDSCR: FZ bit Position */ +#define FPU_FPDSCR_FZ_Msk (1UL << FPU_FPDSCR_FZ_Pos) /*!< FPDSCR: FZ bit Mask */ + +#define FPU_FPDSCR_RMode_Pos 22U /*!< FPDSCR: RMode bit Position */ +#define FPU_FPDSCR_RMode_Msk (3UL << FPU_FPDSCR_RMode_Pos) /*!< FPDSCR: RMode bit Mask */ + +/* Media and FP Feature Register 0 Definitions */ +#define FPU_MVFR0_FP_rounding_modes_Pos 28U /*!< MVFR0: FP rounding modes bits Position */ +#define FPU_MVFR0_FP_rounding_modes_Msk (0xFUL << FPU_MVFR0_FP_rounding_modes_Pos) /*!< MVFR0: FP rounding modes bits Mask */ + +#define FPU_MVFR0_Short_vectors_Pos 24U /*!< MVFR0: Short vectors bits Position */ +#define FPU_MVFR0_Short_vectors_Msk (0xFUL << FPU_MVFR0_Short_vectors_Pos) /*!< MVFR0: Short vectors bits Mask */ + +#define FPU_MVFR0_Square_root_Pos 20U /*!< MVFR0: Square root bits Position */ +#define FPU_MVFR0_Square_root_Msk (0xFUL << FPU_MVFR0_Square_root_Pos) /*!< MVFR0: Square root bits Mask */ + +#define FPU_MVFR0_Divide_Pos 16U /*!< MVFR0: Divide bits Position */ +#define FPU_MVFR0_Divide_Msk (0xFUL << FPU_MVFR0_Divide_Pos) /*!< MVFR0: Divide bits Mask */ + +#define FPU_MVFR0_FP_excep_trapping_Pos 12U /*!< MVFR0: FP exception trapping bits Position */ +#define FPU_MVFR0_FP_excep_trapping_Msk (0xFUL << FPU_MVFR0_FP_excep_trapping_Pos) /*!< MVFR0: FP exception trapping bits Mask */ + +#define FPU_MVFR0_Double_precision_Pos 8U /*!< MVFR0: Double-precision bits Position */ +#define FPU_MVFR0_Double_precision_Msk (0xFUL << FPU_MVFR0_Double_precision_Pos) /*!< MVFR0: Double-precision bits Mask */ + +#define FPU_MVFR0_Single_precision_Pos 4U /*!< MVFR0: Single-precision bits Position */ +#define FPU_MVFR0_Single_precision_Msk (0xFUL << FPU_MVFR0_Single_precision_Pos) /*!< MVFR0: Single-precision bits Mask */ + +#define FPU_MVFR0_A_SIMD_registers_Pos 0U /*!< MVFR0: A_SIMD registers bits Position */ +#define FPU_MVFR0_A_SIMD_registers_Msk (0xFUL /*<< FPU_MVFR0_A_SIMD_registers_Pos*/) /*!< MVFR0: A_SIMD registers bits Mask */ + +/* Media and FP Feature Register 1 Definitions */ +#define FPU_MVFR1_FP_fused_MAC_Pos 28U /*!< MVFR1: FP fused MAC bits Position */ +#define FPU_MVFR1_FP_fused_MAC_Msk (0xFUL << FPU_MVFR1_FP_fused_MAC_Pos) /*!< MVFR1: FP fused MAC bits Mask */ + +#define FPU_MVFR1_FP_HPFP_Pos 24U /*!< MVFR1: FP HPFP bits Position */ +#define FPU_MVFR1_FP_HPFP_Msk (0xFUL << FPU_MVFR1_FP_HPFP_Pos) /*!< MVFR1: FP HPFP bits Mask */ + +#define FPU_MVFR1_D_NaN_mode_Pos 4U /*!< MVFR1: D_NaN mode bits Position */ +#define FPU_MVFR1_D_NaN_mode_Msk (0xFUL << FPU_MVFR1_D_NaN_mode_Pos) /*!< MVFR1: D_NaN mode bits Mask */ + +#define FPU_MVFR1_FtZ_mode_Pos 0U /*!< MVFR1: FtZ mode bits Position */ +#define FPU_MVFR1_FtZ_mode_Msk (0xFUL /*<< FPU_MVFR1_FtZ_mode_Pos*/) /*!< MVFR1: FtZ mode bits Mask */ + +/*@} end of group CMSIS_FPU */ +#endif + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_CoreDebug Core Debug Registers (CoreDebug) + \brief Type definitions for the Core Debug Registers + @{ + */ + +/** + \brief Structure type to access the Core Debug Register (CoreDebug). + */ +typedef struct +{ + __IOM uint32_t DHCSR; /*!< Offset: 0x000 (R/W) Debug Halting Control and Status Register */ + __OM uint32_t DCRSR; /*!< Offset: 0x004 ( /W) Debug Core Register Selector Register */ + __IOM uint32_t DCRDR; /*!< Offset: 0x008 (R/W) Debug Core Register Data Register */ + __IOM uint32_t DEMCR; /*!< Offset: 0x00C (R/W) Debug Exception and Monitor Control Register */ +} CoreDebug_Type; + +/* Debug Halting Control and Status Register Definitions */ +#define CoreDebug_DHCSR_DBGKEY_Pos 16U /*!< CoreDebug DHCSR: DBGKEY Position */ +#define CoreDebug_DHCSR_DBGKEY_Msk (0xFFFFUL << CoreDebug_DHCSR_DBGKEY_Pos) /*!< CoreDebug DHCSR: DBGKEY Mask */ + +#define CoreDebug_DHCSR_S_RESET_ST_Pos 25U /*!< CoreDebug DHCSR: S_RESET_ST Position */ +#define CoreDebug_DHCSR_S_RESET_ST_Msk (1UL << CoreDebug_DHCSR_S_RESET_ST_Pos) /*!< CoreDebug DHCSR: S_RESET_ST Mask */ + +#define CoreDebug_DHCSR_S_RETIRE_ST_Pos 24U /*!< CoreDebug DHCSR: S_RETIRE_ST Position */ +#define CoreDebug_DHCSR_S_RETIRE_ST_Msk (1UL << CoreDebug_DHCSR_S_RETIRE_ST_Pos) /*!< CoreDebug DHCSR: S_RETIRE_ST Mask */ + +#define CoreDebug_DHCSR_S_LOCKUP_Pos 19U /*!< CoreDebug DHCSR: S_LOCKUP Position */ +#define CoreDebug_DHCSR_S_LOCKUP_Msk (1UL << CoreDebug_DHCSR_S_LOCKUP_Pos) /*!< CoreDebug DHCSR: S_LOCKUP Mask */ + +#define CoreDebug_DHCSR_S_SLEEP_Pos 18U /*!< CoreDebug DHCSR: S_SLEEP Position */ +#define CoreDebug_DHCSR_S_SLEEP_Msk (1UL << CoreDebug_DHCSR_S_SLEEP_Pos) /*!< CoreDebug DHCSR: S_SLEEP Mask */ + +#define CoreDebug_DHCSR_S_HALT_Pos 17U /*!< CoreDebug DHCSR: S_HALT Position */ +#define CoreDebug_DHCSR_S_HALT_Msk (1UL << CoreDebug_DHCSR_S_HALT_Pos) /*!< CoreDebug DHCSR: S_HALT Mask */ + +#define CoreDebug_DHCSR_S_REGRDY_Pos 16U /*!< CoreDebug DHCSR: S_REGRDY Position */ +#define CoreDebug_DHCSR_S_REGRDY_Msk (1UL << CoreDebug_DHCSR_S_REGRDY_Pos) /*!< CoreDebug DHCSR: S_REGRDY Mask */ + +#define CoreDebug_DHCSR_C_SNAPSTALL_Pos 5U /*!< CoreDebug DHCSR: C_SNAPSTALL Position */ +#define CoreDebug_DHCSR_C_SNAPSTALL_Msk (1UL << CoreDebug_DHCSR_C_SNAPSTALL_Pos) /*!< CoreDebug DHCSR: C_SNAPSTALL Mask */ + +#define CoreDebug_DHCSR_C_MASKINTS_Pos 3U /*!< CoreDebug DHCSR: C_MASKINTS Position */ +#define CoreDebug_DHCSR_C_MASKINTS_Msk (1UL << CoreDebug_DHCSR_C_MASKINTS_Pos) /*!< CoreDebug DHCSR: C_MASKINTS Mask */ + +#define CoreDebug_DHCSR_C_STEP_Pos 2U /*!< CoreDebug DHCSR: C_STEP Position */ +#define CoreDebug_DHCSR_C_STEP_Msk (1UL << CoreDebug_DHCSR_C_STEP_Pos) /*!< CoreDebug DHCSR: C_STEP Mask */ + +#define CoreDebug_DHCSR_C_HALT_Pos 1U /*!< CoreDebug DHCSR: C_HALT Position */ +#define CoreDebug_DHCSR_C_HALT_Msk (1UL << CoreDebug_DHCSR_C_HALT_Pos) /*!< CoreDebug DHCSR: C_HALT Mask */ + +#define CoreDebug_DHCSR_C_DEBUGEN_Pos 0U /*!< CoreDebug DHCSR: C_DEBUGEN Position */ +#define CoreDebug_DHCSR_C_DEBUGEN_Msk (1UL /*<< CoreDebug_DHCSR_C_DEBUGEN_Pos*/) /*!< CoreDebug DHCSR: C_DEBUGEN Mask */ + +/* Debug Core Register Selector Register Definitions */ +#define CoreDebug_DCRSR_REGWnR_Pos 16U /*!< CoreDebug DCRSR: REGWnR Position */ +#define CoreDebug_DCRSR_REGWnR_Msk (1UL << CoreDebug_DCRSR_REGWnR_Pos) /*!< CoreDebug DCRSR: REGWnR Mask */ + +#define CoreDebug_DCRSR_REGSEL_Pos 0U /*!< CoreDebug DCRSR: REGSEL Position */ +#define CoreDebug_DCRSR_REGSEL_Msk (0x1FUL /*<< CoreDebug_DCRSR_REGSEL_Pos*/) /*!< CoreDebug DCRSR: REGSEL Mask */ + +/* Debug Exception and Monitor Control Register Definitions */ +#define CoreDebug_DEMCR_TRCENA_Pos 24U /*!< CoreDebug DEMCR: TRCENA Position */ +#define CoreDebug_DEMCR_TRCENA_Msk (1UL << CoreDebug_DEMCR_TRCENA_Pos) /*!< CoreDebug DEMCR: TRCENA Mask */ + +#define CoreDebug_DEMCR_MON_REQ_Pos 19U /*!< CoreDebug DEMCR: MON_REQ Position */ +#define CoreDebug_DEMCR_MON_REQ_Msk (1UL << CoreDebug_DEMCR_MON_REQ_Pos) /*!< CoreDebug DEMCR: MON_REQ Mask */ + +#define CoreDebug_DEMCR_MON_STEP_Pos 18U /*!< CoreDebug DEMCR: MON_STEP Position */ +#define CoreDebug_DEMCR_MON_STEP_Msk (1UL << CoreDebug_DEMCR_MON_STEP_Pos) /*!< CoreDebug DEMCR: MON_STEP Mask */ + +#define CoreDebug_DEMCR_MON_PEND_Pos 17U /*!< CoreDebug DEMCR: MON_PEND Position */ +#define CoreDebug_DEMCR_MON_PEND_Msk (1UL << CoreDebug_DEMCR_MON_PEND_Pos) /*!< CoreDebug DEMCR: MON_PEND Mask */ + +#define CoreDebug_DEMCR_MON_EN_Pos 16U /*!< CoreDebug DEMCR: MON_EN Position */ +#define CoreDebug_DEMCR_MON_EN_Msk (1UL << CoreDebug_DEMCR_MON_EN_Pos) /*!< CoreDebug DEMCR: MON_EN Mask */ + +#define CoreDebug_DEMCR_VC_HARDERR_Pos 10U /*!< CoreDebug DEMCR: VC_HARDERR Position */ +#define CoreDebug_DEMCR_VC_HARDERR_Msk (1UL << CoreDebug_DEMCR_VC_HARDERR_Pos) /*!< CoreDebug DEMCR: VC_HARDERR Mask */ + +#define CoreDebug_DEMCR_VC_INTERR_Pos 9U /*!< CoreDebug DEMCR: VC_INTERR Position */ +#define CoreDebug_DEMCR_VC_INTERR_Msk (1UL << CoreDebug_DEMCR_VC_INTERR_Pos) /*!< CoreDebug DEMCR: VC_INTERR Mask */ + +#define CoreDebug_DEMCR_VC_BUSERR_Pos 8U /*!< CoreDebug DEMCR: VC_BUSERR Position */ +#define CoreDebug_DEMCR_VC_BUSERR_Msk (1UL << CoreDebug_DEMCR_VC_BUSERR_Pos) /*!< CoreDebug DEMCR: VC_BUSERR Mask */ + +#define CoreDebug_DEMCR_VC_STATERR_Pos 7U /*!< CoreDebug DEMCR: VC_STATERR Position */ +#define CoreDebug_DEMCR_VC_STATERR_Msk (1UL << CoreDebug_DEMCR_VC_STATERR_Pos) /*!< CoreDebug DEMCR: VC_STATERR Mask */ + +#define CoreDebug_DEMCR_VC_CHKERR_Pos 6U /*!< CoreDebug DEMCR: VC_CHKERR Position */ +#define CoreDebug_DEMCR_VC_CHKERR_Msk (1UL << CoreDebug_DEMCR_VC_CHKERR_Pos) /*!< CoreDebug DEMCR: VC_CHKERR Mask */ + +#define CoreDebug_DEMCR_VC_NOCPERR_Pos 5U /*!< CoreDebug DEMCR: VC_NOCPERR Position */ +#define CoreDebug_DEMCR_VC_NOCPERR_Msk (1UL << CoreDebug_DEMCR_VC_NOCPERR_Pos) /*!< CoreDebug DEMCR: VC_NOCPERR Mask */ + +#define CoreDebug_DEMCR_VC_MMERR_Pos 4U /*!< CoreDebug DEMCR: VC_MMERR Position */ +#define CoreDebug_DEMCR_VC_MMERR_Msk (1UL << CoreDebug_DEMCR_VC_MMERR_Pos) /*!< CoreDebug DEMCR: VC_MMERR Mask */ + +#define CoreDebug_DEMCR_VC_CORERESET_Pos 0U /*!< CoreDebug DEMCR: VC_CORERESET Position */ +#define CoreDebug_DEMCR_VC_CORERESET_Msk (1UL /*<< CoreDebug_DEMCR_VC_CORERESET_Pos*/) /*!< CoreDebug DEMCR: VC_CORERESET Mask */ + +/*@} end of group CMSIS_CoreDebug */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_core_bitfield Core register bit field macros + \brief Macros for use with bit field definitions (xxx_Pos, xxx_Msk). + @{ + */ + +/** + \brief Mask and shift a bit field value for use in a register bit range. + \param[in] field Name of the register bit field. + \param[in] value Value of the bit field. + \return Masked and shifted value. +*/ +#define _VAL2FLD(field, value) ((value << field ## _Pos) & field ## _Msk) + +/** + \brief Mask and shift a register value to extract a bit filed value. + \param[in] field Name of the register bit field. + \param[in] value Value of register. + \return Masked and shifted bit field value. +*/ +#define _FLD2VAL(field, value) ((value & field ## _Msk) >> field ## _Pos) + +/*@} end of group CMSIS_core_bitfield */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_core_base Core Definitions + \brief Definitions for base addresses, unions, and structures. + @{ + */ + +/* Memory mapping of Cortex-M4 Hardware */ +#define SCS_BASE (0xE000E000UL) /*!< System Control Space Base Address */ +#define ITM_BASE (0xE0000000UL) /*!< ITM Base Address */ +#define DWT_BASE (0xE0001000UL) /*!< DWT Base Address */ +#define TPI_BASE (0xE0040000UL) /*!< TPI Base Address */ +#define CoreDebug_BASE (0xE000EDF0UL) /*!< Core Debug Base Address */ +#define SysTick_BASE (SCS_BASE + 0x0010UL) /*!< SysTick Base Address */ +#define NVIC_BASE (SCS_BASE + 0x0100UL) /*!< NVIC Base Address */ +#define SCB_BASE (SCS_BASE + 0x0D00UL) /*!< System Control Block Base Address */ + +#define SCnSCB ((SCnSCB_Type *) SCS_BASE ) /*!< System control Register not in SCB */ +#define SCB ((SCB_Type *) SCB_BASE ) /*!< SCB configuration struct */ +#define SysTick ((SysTick_Type *) SysTick_BASE ) /*!< SysTick configuration struct */ +#define NVIC ((NVIC_Type *) NVIC_BASE ) /*!< NVIC configuration struct */ +#define ITM ((ITM_Type *) ITM_BASE ) /*!< ITM configuration struct */ +#define DWT ((DWT_Type *) DWT_BASE ) /*!< DWT configuration struct */ +#define TPI ((TPI_Type *) TPI_BASE ) /*!< TPI configuration struct */ +#define CoreDebug ((CoreDebug_Type *) CoreDebug_BASE) /*!< Core Debug configuration struct */ + +#if (__MPU_PRESENT == 1U) + #define MPU_BASE (SCS_BASE + 0x0D90UL) /*!< Memory Protection Unit */ + #define MPU ((MPU_Type *) MPU_BASE ) /*!< Memory Protection Unit */ +#endif + +#if (__FPU_PRESENT == 1U) + #define FPU_BASE (SCS_BASE + 0x0F30UL) /*!< Floating Point Unit */ + #define FPU ((FPU_Type *) FPU_BASE ) /*!< Floating Point Unit */ +#endif + +/*@} */ + + + +/******************************************************************************* + * Hardware Abstraction Layer + Core Function Interface contains: + - Core NVIC Functions + - Core SysTick Functions + - Core Debug Functions + - Core Register Access Functions + ******************************************************************************/ +/** + \defgroup CMSIS_Core_FunctionInterface Functions and Instructions Reference +*/ + + + +/* ########################## NVIC functions #################################### */ +/** + \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_NVICFunctions NVIC Functions + \brief Functions that manage interrupts and exceptions via the NVIC. + @{ + */ + +/** + \brief Set Priority Grouping + \details Sets the priority grouping field using the required unlock sequence. + The parameter PriorityGroup is assigned to the field SCB->AIRCR [10:8] PRIGROUP field. + Only values from 0..7 are used. + In case of a conflict between priority grouping and available + priority bits (__NVIC_PRIO_BITS), the smallest possible priority group is set. + \param [in] PriorityGroup Priority grouping field. + */ +__STATIC_INLINE void NVIC_SetPriorityGrouping(uint32_t PriorityGroup) +{ + uint32_t reg_value; + uint32_t PriorityGroupTmp = (PriorityGroup & (uint32_t)0x07UL); /* only values 0..7 are used */ + + reg_value = SCB->AIRCR; /* read old register configuration */ + reg_value &= ~((uint32_t)(SCB_AIRCR_VECTKEY_Msk | SCB_AIRCR_PRIGROUP_Msk)); /* clear bits to change */ + reg_value = (reg_value | + ((uint32_t)0x5FAUL << SCB_AIRCR_VECTKEY_Pos) | + (PriorityGroupTmp << 8U) ); /* Insert write key and priorty group */ + SCB->AIRCR = reg_value; +} + + +/** + \brief Get Priority Grouping + \details Reads the priority grouping field from the NVIC Interrupt Controller. + \return Priority grouping field (SCB->AIRCR [10:8] PRIGROUP field). + */ +__STATIC_INLINE uint32_t NVIC_GetPriorityGrouping(void) +{ + return ((uint32_t)((SCB->AIRCR & SCB_AIRCR_PRIGROUP_Msk) >> SCB_AIRCR_PRIGROUP_Pos)); +} + + +/** + \brief Enable External Interrupt + \details Enables a device-specific interrupt in the NVIC interrupt controller. + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_EnableIRQ(IRQn_Type IRQn) +{ + NVIC->ISER[(((uint32_t)(int32_t)IRQn) >> 5UL)] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Disable External Interrupt + \details Disables a device-specific interrupt in the NVIC interrupt controller. + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_DisableIRQ(IRQn_Type IRQn) +{ + NVIC->ICER[(((uint32_t)(int32_t)IRQn) >> 5UL)] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Get Pending Interrupt + \details Reads the pending register in the NVIC and returns the pending bit for the specified interrupt. + \param [in] IRQn Interrupt number. + \return 0 Interrupt status is not pending. + \return 1 Interrupt status is pending. + */ +__STATIC_INLINE uint32_t NVIC_GetPendingIRQ(IRQn_Type IRQn) +{ + return((uint32_t)(((NVIC->ISPR[(((uint32_t)(int32_t)IRQn) >> 5UL)] & (1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL))) != 0UL) ? 1UL : 0UL)); +} + + +/** + \brief Set Pending Interrupt + \details Sets the pending bit of an external interrupt. + \param [in] IRQn Interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_SetPendingIRQ(IRQn_Type IRQn) +{ + NVIC->ISPR[(((uint32_t)(int32_t)IRQn) >> 5UL)] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Clear Pending Interrupt + \details Clears the pending bit of an external interrupt. + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_ClearPendingIRQ(IRQn_Type IRQn) +{ + NVIC->ICPR[(((uint32_t)(int32_t)IRQn) >> 5UL)] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Get Active Interrupt + \details Reads the active register in NVIC and returns the active bit. + \param [in] IRQn Interrupt number. + \return 0 Interrupt status is not active. + \return 1 Interrupt status is active. + */ +__STATIC_INLINE uint32_t NVIC_GetActive(IRQn_Type IRQn) +{ + return((uint32_t)(((NVIC->IABR[(((uint32_t)(int32_t)IRQn) >> 5UL)] & (1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL))) != 0UL) ? 1UL : 0UL)); +} + + +/** + \brief Set Interrupt Priority + \details Sets the priority of an interrupt. + \note The priority cannot be set for every core interrupt. + \param [in] IRQn Interrupt number. + \param [in] priority Priority to set. + */ +__STATIC_INLINE void NVIC_SetPriority(IRQn_Type IRQn, uint32_t priority) +{ + if ((int32_t)(IRQn) < 0) + { + SCB->SHP[(((uint32_t)(int32_t)IRQn) & 0xFUL)-4UL] = (uint8_t)((priority << (8U - __NVIC_PRIO_BITS)) & (uint32_t)0xFFUL); + } + else + { + NVIC->IP[((uint32_t)(int32_t)IRQn)] = (uint8_t)((priority << (8U - __NVIC_PRIO_BITS)) & (uint32_t)0xFFUL); + } +} + + +/** + \brief Get Interrupt Priority + \details Reads the priority of an interrupt. + The interrupt number can be positive to specify an external (device specific) interrupt, + or negative to specify an internal (core) interrupt. + \param [in] IRQn Interrupt number. + \return Interrupt Priority. + Value is aligned automatically to the implemented priority bits of the microcontroller. + */ +__STATIC_INLINE uint32_t NVIC_GetPriority(IRQn_Type IRQn) +{ + + if ((int32_t)(IRQn) < 0) + { + return(((uint32_t)SCB->SHP[(((uint32_t)(int32_t)IRQn) & 0xFUL)-4UL] >> (8U - __NVIC_PRIO_BITS))); + } + else + { + return(((uint32_t)NVIC->IP[((uint32_t)(int32_t)IRQn)] >> (8U - __NVIC_PRIO_BITS))); + } +} + + +/** + \brief Encode Priority + \details Encodes the priority for an interrupt with the given priority group, + preemptive priority value, and subpriority value. + In case of a conflict between priority grouping and available + priority bits (__NVIC_PRIO_BITS), the smallest possible priority group is set. + \param [in] PriorityGroup Used priority group. + \param [in] PreemptPriority Preemptive priority value (starting from 0). + \param [in] SubPriority Subpriority value (starting from 0). + \return Encoded priority. Value can be used in the function \ref NVIC_SetPriority(). + */ +__STATIC_INLINE uint32_t NVIC_EncodePriority (uint32_t PriorityGroup, uint32_t PreemptPriority, uint32_t SubPriority) +{ + uint32_t PriorityGroupTmp = (PriorityGroup & (uint32_t)0x07UL); /* only values 0..7 are used */ + uint32_t PreemptPriorityBits; + uint32_t SubPriorityBits; + + PreemptPriorityBits = ((7UL - PriorityGroupTmp) > (uint32_t)(__NVIC_PRIO_BITS)) ? (uint32_t)(__NVIC_PRIO_BITS) : (uint32_t)(7UL - PriorityGroupTmp); + SubPriorityBits = ((PriorityGroupTmp + (uint32_t)(__NVIC_PRIO_BITS)) < (uint32_t)7UL) ? (uint32_t)0UL : (uint32_t)((PriorityGroupTmp - 7UL) + (uint32_t)(__NVIC_PRIO_BITS)); + + return ( + ((PreemptPriority & (uint32_t)((1UL << (PreemptPriorityBits)) - 1UL)) << SubPriorityBits) | + ((SubPriority & (uint32_t)((1UL << (SubPriorityBits )) - 1UL))) + ); +} + + +/** + \brief Decode Priority + \details Decodes an interrupt priority value with a given priority group to + preemptive priority value and subpriority value. + In case of a conflict between priority grouping and available + priority bits (__NVIC_PRIO_BITS) the smallest possible priority group is set. + \param [in] Priority Priority value, which can be retrieved with the function \ref NVIC_GetPriority(). + \param [in] PriorityGroup Used priority group. + \param [out] pPreemptPriority Preemptive priority value (starting from 0). + \param [out] pSubPriority Subpriority value (starting from 0). + */ +__STATIC_INLINE void NVIC_DecodePriority (uint32_t Priority, uint32_t PriorityGroup, uint32_t* const pPreemptPriority, uint32_t* const pSubPriority) +{ + uint32_t PriorityGroupTmp = (PriorityGroup & (uint32_t)0x07UL); /* only values 0..7 are used */ + uint32_t PreemptPriorityBits; + uint32_t SubPriorityBits; + + PreemptPriorityBits = ((7UL - PriorityGroupTmp) > (uint32_t)(__NVIC_PRIO_BITS)) ? (uint32_t)(__NVIC_PRIO_BITS) : (uint32_t)(7UL - PriorityGroupTmp); + SubPriorityBits = ((PriorityGroupTmp + (uint32_t)(__NVIC_PRIO_BITS)) < (uint32_t)7UL) ? (uint32_t)0UL : (uint32_t)((PriorityGroupTmp - 7UL) + (uint32_t)(__NVIC_PRIO_BITS)); + + *pPreemptPriority = (Priority >> SubPriorityBits) & (uint32_t)((1UL << (PreemptPriorityBits)) - 1UL); + *pSubPriority = (Priority ) & (uint32_t)((1UL << (SubPriorityBits )) - 1UL); +} + + +/** + \brief System Reset + \details Initiates a system reset request to reset the MCU. + */ +__STATIC_INLINE void NVIC_SystemReset(void) +{ + __DSB(); /* Ensure all outstanding memory accesses included + buffered write are completed before reset */ + SCB->AIRCR = (uint32_t)((0x5FAUL << SCB_AIRCR_VECTKEY_Pos) | + (SCB->AIRCR & SCB_AIRCR_PRIGROUP_Msk) | + SCB_AIRCR_SYSRESETREQ_Msk ); /* Keep priority group unchanged */ + __DSB(); /* Ensure completion of memory access */ + + for(;;) /* wait until reset */ + { + __NOP(); + } +} + +/*@} end of CMSIS_Core_NVICFunctions */ + + + +/* ################################## SysTick function ############################################ */ +/** + \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_SysTickFunctions SysTick Functions + \brief Functions that configure the System. + @{ + */ + +#if (__Vendor_SysTickConfig == 0U) + +/** + \brief System Tick Configuration + \details Initializes the System Timer and its interrupt, and starts the System Tick Timer. + Counter is in free running mode to generate periodic interrupts. + \param [in] ticks Number of ticks between two interrupts. + \return 0 Function succeeded. + \return 1 Function failed. + \note When the variable __Vendor_SysTickConfig is set to 1, then the + function SysTick_Config is not included. In this case, the file device.h + must contain a vendor-specific implementation of this function. + */ +__STATIC_INLINE uint32_t SysTick_Config(uint32_t ticks) +{ + if ((ticks - 1UL) > SysTick_LOAD_RELOAD_Msk) + { + return (1UL); /* Reload value impossible */ + } + + SysTick->LOAD = (uint32_t)(ticks - 1UL); /* set reload register */ + NVIC_SetPriority (SysTick_IRQn, (1UL << __NVIC_PRIO_BITS) - 1UL); /* set Priority for Systick Interrupt */ + SysTick->VAL = 0UL; /* Load the SysTick Counter Value */ + SysTick->CTRL = SysTick_CTRL_CLKSOURCE_Msk | + SysTick_CTRL_TICKINT_Msk | + SysTick_CTRL_ENABLE_Msk; /* Enable SysTick IRQ and SysTick Timer */ + return (0UL); /* Function successful */ +} + +#endif + +/*@} end of CMSIS_Core_SysTickFunctions */ + + + +/* ##################################### Debug In/Output function ########################################### */ +/** + \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_core_DebugFunctions ITM Functions + \brief Functions that access the ITM debug interface. + @{ + */ + +extern volatile int32_t ITM_RxBuffer; /*!< External variable to receive characters. */ +#define ITM_RXBUFFER_EMPTY 0x5AA55AA5U /*!< Value identifying \ref ITM_RxBuffer is ready for next character. */ + + +/** + \brief ITM Send Character + \details Transmits a character via the ITM channel 0, and + \li Just returns when no debugger is connected that has booked the output. + \li Is blocking when a debugger is connected, but the previous character sent has not been transmitted. + \param [in] ch Character to transmit. + \returns Character to transmit. + */ +__STATIC_INLINE uint32_t ITM_SendChar (uint32_t ch) +{ + if (((ITM->TCR & ITM_TCR_ITMENA_Msk) != 0UL) && /* ITM enabled */ + ((ITM->TER & 1UL ) != 0UL) ) /* ITM Port #0 enabled */ + { + while (ITM->PORT[0U].u32 == 0UL) + { + __NOP(); + } + ITM->PORT[0U].u8 = (uint8_t)ch; + } + return (ch); +} + + +/** + \brief ITM Receive Character + \details Inputs a character via the external variable \ref ITM_RxBuffer. + \return Received character. + \return -1 No character pending. + */ +__STATIC_INLINE int32_t ITM_ReceiveChar (void) +{ + int32_t ch = -1; /* no character available */ + + if (ITM_RxBuffer != ITM_RXBUFFER_EMPTY) + { + ch = ITM_RxBuffer; + ITM_RxBuffer = ITM_RXBUFFER_EMPTY; /* ready for next character */ + } + + return (ch); +} + + +/** + \brief ITM Check Character + \details Checks whether a character is pending for reading in the variable \ref ITM_RxBuffer. + \return 0 No character available. + \return 1 Character available. + */ +__STATIC_INLINE int32_t ITM_CheckChar (void) +{ + + if (ITM_RxBuffer == ITM_RXBUFFER_EMPTY) + { + return (0); /* no character available */ + } + else + { + return (1); /* character available */ + } +} + +/*@} end of CMSIS_core_DebugFunctions */ + + + + +#ifdef __cplusplus +} +#endif + +#endif /* __CORE_CM4_H_DEPENDANT */ + +#endif /* __CMSIS_GENERIC */ diff --git a/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cm7.h b/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cm7.h new file mode 100644 index 00000000000..3b7530ad505 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cm7.h @@ -0,0 +1,2512 @@ +/**************************************************************************//** + * @file core_cm7.h + * @brief CMSIS Cortex-M7 Core Peripheral Access Layer Header File + * @version V4.30 + * @date 20. October 2015 + ******************************************************************************/ +/* Copyright (c) 2009 - 2015 ARM LIMITED + + All rights reserved. + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are met: + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + - Neither the name of ARM nor the names of its contributors may be used + to endorse or promote products derived from this software without + specific prior written permission. + * + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE + LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + ---------------------------------------------------------------------------*/ + + +#if defined ( __ICCARM__ ) + #pragma system_include /* treat file as system include file for MISRA check */ +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #pragma clang system_header /* treat file as system include file */ +#endif + +#ifndef __CORE_CM7_H_GENERIC +#define __CORE_CM7_H_GENERIC + +#include + +#ifdef __cplusplus + extern "C" { +#endif + +/** + \page CMSIS_MISRA_Exceptions MISRA-C:2004 Compliance Exceptions + CMSIS violates the following MISRA-C:2004 rules: + + \li Required Rule 8.5, object/function definition in header file.
+ Function definitions in header files are used to allow 'inlining'. + + \li Required Rule 18.4, declaration of union type or object of union type: '{...}'.
+ Unions are used for effective representation of core registers. + + \li Advisory Rule 19.7, Function-like macro defined.
+ Function-like macros are used to allow more efficient code. + */ + + +/******************************************************************************* + * CMSIS definitions + ******************************************************************************/ +/** + \ingroup Cortex_M7 + @{ + */ + +/* CMSIS CM7 definitions */ +#define __CM7_CMSIS_VERSION_MAIN (0x04U) /*!< [31:16] CMSIS HAL main version */ +#define __CM7_CMSIS_VERSION_SUB (0x1EU) /*!< [15:0] CMSIS HAL sub version */ +#define __CM7_CMSIS_VERSION ((__CM7_CMSIS_VERSION_MAIN << 16U) | \ + __CM7_CMSIS_VERSION_SUB ) /*!< CMSIS HAL version number */ + +#define __CORTEX_M (0x07U) /*!< Cortex-M Core */ + + +#if defined ( __CC_ARM ) + #define __ASM __asm /*!< asm keyword for ARM Compiler */ + #define __INLINE __inline /*!< inline keyword for ARM Compiler */ + #define __STATIC_INLINE static __inline + +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #define __ASM __asm /*!< asm keyword for ARM Compiler */ + #define __INLINE __inline /*!< inline keyword for ARM Compiler */ + #define __STATIC_INLINE static __inline + +#elif defined ( __GNUC__ ) + #define __ASM __asm /*!< asm keyword for GNU Compiler */ + #define __INLINE inline /*!< inline keyword for GNU Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __ICCARM__ ) + #define __ASM __asm /*!< asm keyword for IAR Compiler */ + #define __INLINE inline /*!< inline keyword for IAR Compiler. Only available in High optimization mode! */ + #define __STATIC_INLINE static inline + +#elif defined ( __TMS470__ ) + #define __ASM __asm /*!< asm keyword for TI CCS Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __TASKING__ ) + #define __ASM __asm /*!< asm keyword for TASKING Compiler */ + #define __INLINE inline /*!< inline keyword for TASKING Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __CSMC__ ) + #define __packed + #define __ASM _asm /*!< asm keyword for COSMIC Compiler */ + #define __INLINE inline /*!< inline keyword for COSMIC Compiler. Use -pc99 on compile line */ + #define __STATIC_INLINE static inline + +#else + #error Unknown compiler +#endif + +/** __FPU_USED indicates whether an FPU is used or not. + For this, __FPU_PRESENT has to be checked prior to making use of FPU specific registers and functions. +*/ +#if defined ( __CC_ARM ) + #if defined __TARGET_FPU_VFP + #if (__FPU_PRESENT == 1U) + #define __FPU_USED 1U + #else + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #define __FPU_USED 0U + #endif + #else + #define __FPU_USED 0U + #endif + +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #if defined __ARM_PCS_VFP + #if (__FPU_PRESENT == 1) + #define __FPU_USED 1U + #else + #warning "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #define __FPU_USED 0U + #endif + #else + #define __FPU_USED 0U + #endif + +#elif defined ( __GNUC__ ) + #if defined (__VFP_FP__) && !defined(__SOFTFP__) + #if (__FPU_PRESENT == 1U) + #define __FPU_USED 1U + #else + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #define __FPU_USED 0U + #endif + #else + #define __FPU_USED 0U + #endif + +#elif defined ( __ICCARM__ ) + #if defined __ARMVFP__ + #if (__FPU_PRESENT == 1U) + #define __FPU_USED 1U + #else + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #define __FPU_USED 0U + #endif + #else + #define __FPU_USED 0U + #endif + +#elif defined ( __TMS470__ ) + #if defined __TI_VFP_SUPPORT__ + #if (__FPU_PRESENT == 1U) + #define __FPU_USED 1U + #else + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #define __FPU_USED 0U + #endif + #else + #define __FPU_USED 0U + #endif + +#elif defined ( __TASKING__ ) + #if defined __FPU_VFP__ + #if (__FPU_PRESENT == 1U) + #define __FPU_USED 1U + #else + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #define __FPU_USED 0U + #endif + #else + #define __FPU_USED 0U + #endif + +#elif defined ( __CSMC__ ) + #if ( __CSMC__ & 0x400U) + #if (__FPU_PRESENT == 1U) + #define __FPU_USED 1U + #else + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #define __FPU_USED 0U + #endif + #else + #define __FPU_USED 0U + #endif + +#endif + +#include "core_cmInstr.h" /* Core Instruction Access */ +#include "core_cmFunc.h" /* Core Function Access */ +#include "core_cmSimd.h" /* Compiler specific SIMD Intrinsics */ + +#ifdef __cplusplus +} +#endif + +#endif /* __CORE_CM7_H_GENERIC */ + +#ifndef __CMSIS_GENERIC + +#ifndef __CORE_CM7_H_DEPENDANT +#define __CORE_CM7_H_DEPENDANT + +#ifdef __cplusplus + extern "C" { +#endif + +/* check device defines and use defaults */ +#if defined __CHECK_DEVICE_DEFINES + #ifndef __CM7_REV + #define __CM7_REV 0x0000U + #warning "__CM7_REV not defined in device header file; using default!" + #endif + + #ifndef __FPU_PRESENT + #define __FPU_PRESENT 0U + #warning "__FPU_PRESENT not defined in device header file; using default!" + #endif + + #ifndef __MPU_PRESENT + #define __MPU_PRESENT 0U + #warning "__MPU_PRESENT not defined in device header file; using default!" + #endif + + #ifndef __ICACHE_PRESENT + #define __ICACHE_PRESENT 0U + #warning "__ICACHE_PRESENT not defined in device header file; using default!" + #endif + + #ifndef __DCACHE_PRESENT + #define __DCACHE_PRESENT 0U + #warning "__DCACHE_PRESENT not defined in device header file; using default!" + #endif + + #ifndef __DTCM_PRESENT + #define __DTCM_PRESENT 0U + #warning "__DTCM_PRESENT not defined in device header file; using default!" + #endif + + #ifndef __NVIC_PRIO_BITS + #define __NVIC_PRIO_BITS 3U + #warning "__NVIC_PRIO_BITS not defined in device header file; using default!" + #endif + + #ifndef __Vendor_SysTickConfig + #define __Vendor_SysTickConfig 0U + #warning "__Vendor_SysTickConfig not defined in device header file; using default!" + #endif +#endif + +/* IO definitions (access restrictions to peripheral registers) */ +/** + \defgroup CMSIS_glob_defs CMSIS Global Defines + + IO Type Qualifiers are used + \li to specify the access to peripheral variables. + \li for automatic generation of peripheral register debug information. +*/ +#ifdef __cplusplus + #define __I volatile /*!< Defines 'read only' permissions */ +#else + #define __I volatile const /*!< Defines 'read only' permissions */ +#endif +#define __O volatile /*!< Defines 'write only' permissions */ +#define __IO volatile /*!< Defines 'read / write' permissions */ + +/* following defines should be used for structure members */ +#define __IM volatile const /*! Defines 'read only' structure member permissions */ +#define __OM volatile /*! Defines 'write only' structure member permissions */ +#define __IOM volatile /*! Defines 'read / write' structure member permissions */ + +/*@} end of group Cortex_M7 */ + + + +/******************************************************************************* + * Register Abstraction + Core Register contain: + - Core Register + - Core NVIC Register + - Core SCB Register + - Core SysTick Register + - Core Debug Register + - Core MPU Register + - Core FPU Register + ******************************************************************************/ +/** + \defgroup CMSIS_core_register Defines and Type Definitions + \brief Type definitions and defines for Cortex-M processor based devices. +*/ + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_CORE Status and Control Registers + \brief Core Register type definitions. + @{ + */ + +/** + \brief Union type to access the Application Program Status Register (APSR). + */ +typedef union +{ + struct + { + uint32_t _reserved0:16; /*!< bit: 0..15 Reserved */ + uint32_t GE:4; /*!< bit: 16..19 Greater than or Equal flags */ + uint32_t _reserved1:7; /*!< bit: 20..26 Reserved */ + uint32_t Q:1; /*!< bit: 27 Saturation condition flag */ + uint32_t V:1; /*!< bit: 28 Overflow condition code flag */ + uint32_t C:1; /*!< bit: 29 Carry condition code flag */ + uint32_t Z:1; /*!< bit: 30 Zero condition code flag */ + uint32_t N:1; /*!< bit: 31 Negative condition code flag */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} APSR_Type; + +/* APSR Register Definitions */ +#define APSR_N_Pos 31U /*!< APSR: N Position */ +#define APSR_N_Msk (1UL << APSR_N_Pos) /*!< APSR: N Mask */ + +#define APSR_Z_Pos 30U /*!< APSR: Z Position */ +#define APSR_Z_Msk (1UL << APSR_Z_Pos) /*!< APSR: Z Mask */ + +#define APSR_C_Pos 29U /*!< APSR: C Position */ +#define APSR_C_Msk (1UL << APSR_C_Pos) /*!< APSR: C Mask */ + +#define APSR_V_Pos 28U /*!< APSR: V Position */ +#define APSR_V_Msk (1UL << APSR_V_Pos) /*!< APSR: V Mask */ + +#define APSR_Q_Pos 27U /*!< APSR: Q Position */ +#define APSR_Q_Msk (1UL << APSR_Q_Pos) /*!< APSR: Q Mask */ + +#define APSR_GE_Pos 16U /*!< APSR: GE Position */ +#define APSR_GE_Msk (0xFUL << APSR_GE_Pos) /*!< APSR: GE Mask */ + + +/** + \brief Union type to access the Interrupt Program Status Register (IPSR). + */ +typedef union +{ + struct + { + uint32_t ISR:9; /*!< bit: 0.. 8 Exception number */ + uint32_t _reserved0:23; /*!< bit: 9..31 Reserved */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} IPSR_Type; + +/* IPSR Register Definitions */ +#define IPSR_ISR_Pos 0U /*!< IPSR: ISR Position */ +#define IPSR_ISR_Msk (0x1FFUL /*<< IPSR_ISR_Pos*/) /*!< IPSR: ISR Mask */ + + +/** + \brief Union type to access the Special-Purpose Program Status Registers (xPSR). + */ +typedef union +{ + struct + { + uint32_t ISR:9; /*!< bit: 0.. 8 Exception number */ + uint32_t _reserved0:7; /*!< bit: 9..15 Reserved */ + uint32_t GE:4; /*!< bit: 16..19 Greater than or Equal flags */ + uint32_t _reserved1:4; /*!< bit: 20..23 Reserved */ + uint32_t T:1; /*!< bit: 24 Thumb bit (read 0) */ + uint32_t IT:2; /*!< bit: 25..26 saved IT state (read 0) */ + uint32_t Q:1; /*!< bit: 27 Saturation condition flag */ + uint32_t V:1; /*!< bit: 28 Overflow condition code flag */ + uint32_t C:1; /*!< bit: 29 Carry condition code flag */ + uint32_t Z:1; /*!< bit: 30 Zero condition code flag */ + uint32_t N:1; /*!< bit: 31 Negative condition code flag */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} xPSR_Type; + +/* xPSR Register Definitions */ +#define xPSR_N_Pos 31U /*!< xPSR: N Position */ +#define xPSR_N_Msk (1UL << xPSR_N_Pos) /*!< xPSR: N Mask */ + +#define xPSR_Z_Pos 30U /*!< xPSR: Z Position */ +#define xPSR_Z_Msk (1UL << xPSR_Z_Pos) /*!< xPSR: Z Mask */ + +#define xPSR_C_Pos 29U /*!< xPSR: C Position */ +#define xPSR_C_Msk (1UL << xPSR_C_Pos) /*!< xPSR: C Mask */ + +#define xPSR_V_Pos 28U /*!< xPSR: V Position */ +#define xPSR_V_Msk (1UL << xPSR_V_Pos) /*!< xPSR: V Mask */ + +#define xPSR_Q_Pos 27U /*!< xPSR: Q Position */ +#define xPSR_Q_Msk (1UL << xPSR_Q_Pos) /*!< xPSR: Q Mask */ + +#define xPSR_IT_Pos 25U /*!< xPSR: IT Position */ +#define xPSR_IT_Msk (3UL << xPSR_IT_Pos) /*!< xPSR: IT Mask */ + +#define xPSR_T_Pos 24U /*!< xPSR: T Position */ +#define xPSR_T_Msk (1UL << xPSR_T_Pos) /*!< xPSR: T Mask */ + +#define xPSR_GE_Pos 16U /*!< xPSR: GE Position */ +#define xPSR_GE_Msk (0xFUL << xPSR_GE_Pos) /*!< xPSR: GE Mask */ + +#define xPSR_ISR_Pos 0U /*!< xPSR: ISR Position */ +#define xPSR_ISR_Msk (0x1FFUL /*<< xPSR_ISR_Pos*/) /*!< xPSR: ISR Mask */ + + +/** + \brief Union type to access the Control Registers (CONTROL). + */ +typedef union +{ + struct + { + uint32_t nPRIV:1; /*!< bit: 0 Execution privilege in Thread mode */ + uint32_t SPSEL:1; /*!< bit: 1 Stack to be used */ + uint32_t FPCA:1; /*!< bit: 2 FP extension active flag */ + uint32_t _reserved0:29; /*!< bit: 3..31 Reserved */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} CONTROL_Type; + +/* CONTROL Register Definitions */ +#define CONTROL_FPCA_Pos 2U /*!< CONTROL: FPCA Position */ +#define CONTROL_FPCA_Msk (1UL << CONTROL_FPCA_Pos) /*!< CONTROL: FPCA Mask */ + +#define CONTROL_SPSEL_Pos 1U /*!< CONTROL: SPSEL Position */ +#define CONTROL_SPSEL_Msk (1UL << CONTROL_SPSEL_Pos) /*!< CONTROL: SPSEL Mask */ + +#define CONTROL_nPRIV_Pos 0U /*!< CONTROL: nPRIV Position */ +#define CONTROL_nPRIV_Msk (1UL /*<< CONTROL_nPRIV_Pos*/) /*!< CONTROL: nPRIV Mask */ + +/*@} end of group CMSIS_CORE */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_NVIC Nested Vectored Interrupt Controller (NVIC) + \brief Type definitions for the NVIC Registers + @{ + */ + +/** + \brief Structure type to access the Nested Vectored Interrupt Controller (NVIC). + */ +typedef struct +{ + __IOM uint32_t ISER[8U]; /*!< Offset: 0x000 (R/W) Interrupt Set Enable Register */ + uint32_t RESERVED0[24U]; + __IOM uint32_t ICER[8U]; /*!< Offset: 0x080 (R/W) Interrupt Clear Enable Register */ + uint32_t RSERVED1[24U]; + __IOM uint32_t ISPR[8U]; /*!< Offset: 0x100 (R/W) Interrupt Set Pending Register */ + uint32_t RESERVED2[24U]; + __IOM uint32_t ICPR[8U]; /*!< Offset: 0x180 (R/W) Interrupt Clear Pending Register */ + uint32_t RESERVED3[24U]; + __IOM uint32_t IABR[8U]; /*!< Offset: 0x200 (R/W) Interrupt Active bit Register */ + uint32_t RESERVED4[56U]; + __IOM uint8_t IP[240U]; /*!< Offset: 0x300 (R/W) Interrupt Priority Register (8Bit wide) */ + uint32_t RESERVED5[644U]; + __OM uint32_t STIR; /*!< Offset: 0xE00 ( /W) Software Trigger Interrupt Register */ +} NVIC_Type; + +/* Software Triggered Interrupt Register Definitions */ +#define NVIC_STIR_INTID_Pos 0U /*!< STIR: INTLINESNUM Position */ +#define NVIC_STIR_INTID_Msk (0x1FFUL /*<< NVIC_STIR_INTID_Pos*/) /*!< STIR: INTLINESNUM Mask */ + +/*@} end of group CMSIS_NVIC */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_SCB System Control Block (SCB) + \brief Type definitions for the System Control Block Registers + @{ + */ + +/** + \brief Structure type to access the System Control Block (SCB). + */ +typedef struct +{ + __IM uint32_t CPUID; /*!< Offset: 0x000 (R/ ) CPUID Base Register */ + __IOM uint32_t ICSR; /*!< Offset: 0x004 (R/W) Interrupt Control and State Register */ + __IOM uint32_t VTOR; /*!< Offset: 0x008 (R/W) Vector Table Offset Register */ + __IOM uint32_t AIRCR; /*!< Offset: 0x00C (R/W) Application Interrupt and Reset Control Register */ + __IOM uint32_t SCR; /*!< Offset: 0x010 (R/W) System Control Register */ + __IOM uint32_t CCR; /*!< Offset: 0x014 (R/W) Configuration Control Register */ + __IOM uint8_t SHPR[12U]; /*!< Offset: 0x018 (R/W) System Handlers Priority Registers (4-7, 8-11, 12-15) */ + __IOM uint32_t SHCSR; /*!< Offset: 0x024 (R/W) System Handler Control and State Register */ + __IOM uint32_t CFSR; /*!< Offset: 0x028 (R/W) Configurable Fault Status Register */ + __IOM uint32_t HFSR; /*!< Offset: 0x02C (R/W) HardFault Status Register */ + __IOM uint32_t DFSR; /*!< Offset: 0x030 (R/W) Debug Fault Status Register */ + __IOM uint32_t MMFAR; /*!< Offset: 0x034 (R/W) MemManage Fault Address Register */ + __IOM uint32_t BFAR; /*!< Offset: 0x038 (R/W) BusFault Address Register */ + __IOM uint32_t AFSR; /*!< Offset: 0x03C (R/W) Auxiliary Fault Status Register */ + __IM uint32_t ID_PFR[2U]; /*!< Offset: 0x040 (R/ ) Processor Feature Register */ + __IM uint32_t ID_DFR; /*!< Offset: 0x048 (R/ ) Debug Feature Register */ + __IM uint32_t ID_AFR; /*!< Offset: 0x04C (R/ ) Auxiliary Feature Register */ + __IM uint32_t ID_MFR[4U]; /*!< Offset: 0x050 (R/ ) Memory Model Feature Register */ + __IM uint32_t ID_ISAR[5U]; /*!< Offset: 0x060 (R/ ) Instruction Set Attributes Register */ + uint32_t RESERVED0[1U]; + __IM uint32_t CLIDR; /*!< Offset: 0x078 (R/ ) Cache Level ID register */ + __IM uint32_t CTR; /*!< Offset: 0x07C (R/ ) Cache Type register */ + __IM uint32_t CCSIDR; /*!< Offset: 0x080 (R/ ) Cache Size ID Register */ + __IOM uint32_t CSSELR; /*!< Offset: 0x084 (R/W) Cache Size Selection Register */ + __IOM uint32_t CPACR; /*!< Offset: 0x088 (R/W) Coprocessor Access Control Register */ + uint32_t RESERVED3[93U]; + __OM uint32_t STIR; /*!< Offset: 0x200 ( /W) Software Triggered Interrupt Register */ + uint32_t RESERVED4[15U]; + __IM uint32_t MVFR0; /*!< Offset: 0x240 (R/ ) Media and VFP Feature Register 0 */ + __IM uint32_t MVFR1; /*!< Offset: 0x244 (R/ ) Media and VFP Feature Register 1 */ + __IM uint32_t MVFR2; /*!< Offset: 0x248 (R/ ) Media and VFP Feature Register 1 */ + uint32_t RESERVED5[1U]; + __OM uint32_t ICIALLU; /*!< Offset: 0x250 ( /W) I-Cache Invalidate All to PoU */ + uint32_t RESERVED6[1U]; + __OM uint32_t ICIMVAU; /*!< Offset: 0x258 ( /W) I-Cache Invalidate by MVA to PoU */ + __OM uint32_t DCIMVAC; /*!< Offset: 0x25C ( /W) D-Cache Invalidate by MVA to PoC */ + __OM uint32_t DCISW; /*!< Offset: 0x260 ( /W) D-Cache Invalidate by Set-way */ + __OM uint32_t DCCMVAU; /*!< Offset: 0x264 ( /W) D-Cache Clean by MVA to PoU */ + __OM uint32_t DCCMVAC; /*!< Offset: 0x268 ( /W) D-Cache Clean by MVA to PoC */ + __OM uint32_t DCCSW; /*!< Offset: 0x26C ( /W) D-Cache Clean by Set-way */ + __OM uint32_t DCCIMVAC; /*!< Offset: 0x270 ( /W) D-Cache Clean and Invalidate by MVA to PoC */ + __OM uint32_t DCCISW; /*!< Offset: 0x274 ( /W) D-Cache Clean and Invalidate by Set-way */ + uint32_t RESERVED7[6U]; + __IOM uint32_t ITCMCR; /*!< Offset: 0x290 (R/W) Instruction Tightly-Coupled Memory Control Register */ + __IOM uint32_t DTCMCR; /*!< Offset: 0x294 (R/W) Data Tightly-Coupled Memory Control Registers */ + __IOM uint32_t AHBPCR; /*!< Offset: 0x298 (R/W) AHBP Control Register */ + __IOM uint32_t CACR; /*!< Offset: 0x29C (R/W) L1 Cache Control Register */ + __IOM uint32_t AHBSCR; /*!< Offset: 0x2A0 (R/W) AHB Slave Control Register */ + uint32_t RESERVED8[1U]; + __IOM uint32_t ABFSR; /*!< Offset: 0x2A8 (R/W) Auxiliary Bus Fault Status Register */ +} SCB_Type; + +/* SCB CPUID Register Definitions */ +#define SCB_CPUID_IMPLEMENTER_Pos 24U /*!< SCB CPUID: IMPLEMENTER Position */ +#define SCB_CPUID_IMPLEMENTER_Msk (0xFFUL << SCB_CPUID_IMPLEMENTER_Pos) /*!< SCB CPUID: IMPLEMENTER Mask */ + +#define SCB_CPUID_VARIANT_Pos 20U /*!< SCB CPUID: VARIANT Position */ +#define SCB_CPUID_VARIANT_Msk (0xFUL << SCB_CPUID_VARIANT_Pos) /*!< SCB CPUID: VARIANT Mask */ + +#define SCB_CPUID_ARCHITECTURE_Pos 16U /*!< SCB CPUID: ARCHITECTURE Position */ +#define SCB_CPUID_ARCHITECTURE_Msk (0xFUL << SCB_CPUID_ARCHITECTURE_Pos) /*!< SCB CPUID: ARCHITECTURE Mask */ + +#define SCB_CPUID_PARTNO_Pos 4U /*!< SCB CPUID: PARTNO Position */ +#define SCB_CPUID_PARTNO_Msk (0xFFFUL << SCB_CPUID_PARTNO_Pos) /*!< SCB CPUID: PARTNO Mask */ + +#define SCB_CPUID_REVISION_Pos 0U /*!< SCB CPUID: REVISION Position */ +#define SCB_CPUID_REVISION_Msk (0xFUL /*<< SCB_CPUID_REVISION_Pos*/) /*!< SCB CPUID: REVISION Mask */ + +/* SCB Interrupt Control State Register Definitions */ +#define SCB_ICSR_NMIPENDSET_Pos 31U /*!< SCB ICSR: NMIPENDSET Position */ +#define SCB_ICSR_NMIPENDSET_Msk (1UL << SCB_ICSR_NMIPENDSET_Pos) /*!< SCB ICSR: NMIPENDSET Mask */ + +#define SCB_ICSR_PENDSVSET_Pos 28U /*!< SCB ICSR: PENDSVSET Position */ +#define SCB_ICSR_PENDSVSET_Msk (1UL << SCB_ICSR_PENDSVSET_Pos) /*!< SCB ICSR: PENDSVSET Mask */ + +#define SCB_ICSR_PENDSVCLR_Pos 27U /*!< SCB ICSR: PENDSVCLR Position */ +#define SCB_ICSR_PENDSVCLR_Msk (1UL << SCB_ICSR_PENDSVCLR_Pos) /*!< SCB ICSR: PENDSVCLR Mask */ + +#define SCB_ICSR_PENDSTSET_Pos 26U /*!< SCB ICSR: PENDSTSET Position */ +#define SCB_ICSR_PENDSTSET_Msk (1UL << SCB_ICSR_PENDSTSET_Pos) /*!< SCB ICSR: PENDSTSET Mask */ + +#define SCB_ICSR_PENDSTCLR_Pos 25U /*!< SCB ICSR: PENDSTCLR Position */ +#define SCB_ICSR_PENDSTCLR_Msk (1UL << SCB_ICSR_PENDSTCLR_Pos) /*!< SCB ICSR: PENDSTCLR Mask */ + +#define SCB_ICSR_ISRPREEMPT_Pos 23U /*!< SCB ICSR: ISRPREEMPT Position */ +#define SCB_ICSR_ISRPREEMPT_Msk (1UL << SCB_ICSR_ISRPREEMPT_Pos) /*!< SCB ICSR: ISRPREEMPT Mask */ + +#define SCB_ICSR_ISRPENDING_Pos 22U /*!< SCB ICSR: ISRPENDING Position */ +#define SCB_ICSR_ISRPENDING_Msk (1UL << SCB_ICSR_ISRPENDING_Pos) /*!< SCB ICSR: ISRPENDING Mask */ + +#define SCB_ICSR_VECTPENDING_Pos 12U /*!< SCB ICSR: VECTPENDING Position */ +#define SCB_ICSR_VECTPENDING_Msk (0x1FFUL << SCB_ICSR_VECTPENDING_Pos) /*!< SCB ICSR: VECTPENDING Mask */ + +#define SCB_ICSR_RETTOBASE_Pos 11U /*!< SCB ICSR: RETTOBASE Position */ +#define SCB_ICSR_RETTOBASE_Msk (1UL << SCB_ICSR_RETTOBASE_Pos) /*!< SCB ICSR: RETTOBASE Mask */ + +#define SCB_ICSR_VECTACTIVE_Pos 0U /*!< SCB ICSR: VECTACTIVE Position */ +#define SCB_ICSR_VECTACTIVE_Msk (0x1FFUL /*<< SCB_ICSR_VECTACTIVE_Pos*/) /*!< SCB ICSR: VECTACTIVE Mask */ + +/* SCB Vector Table Offset Register Definitions */ +#define SCB_VTOR_TBLOFF_Pos 7U /*!< SCB VTOR: TBLOFF Position */ +#define SCB_VTOR_TBLOFF_Msk (0x1FFFFFFUL << SCB_VTOR_TBLOFF_Pos) /*!< SCB VTOR: TBLOFF Mask */ + +/* SCB Application Interrupt and Reset Control Register Definitions */ +#define SCB_AIRCR_VECTKEY_Pos 16U /*!< SCB AIRCR: VECTKEY Position */ +#define SCB_AIRCR_VECTKEY_Msk (0xFFFFUL << SCB_AIRCR_VECTKEY_Pos) /*!< SCB AIRCR: VECTKEY Mask */ + +#define SCB_AIRCR_VECTKEYSTAT_Pos 16U /*!< SCB AIRCR: VECTKEYSTAT Position */ +#define SCB_AIRCR_VECTKEYSTAT_Msk (0xFFFFUL << SCB_AIRCR_VECTKEYSTAT_Pos) /*!< SCB AIRCR: VECTKEYSTAT Mask */ + +#define SCB_AIRCR_ENDIANESS_Pos 15U /*!< SCB AIRCR: ENDIANESS Position */ +#define SCB_AIRCR_ENDIANESS_Msk (1UL << SCB_AIRCR_ENDIANESS_Pos) /*!< SCB AIRCR: ENDIANESS Mask */ + +#define SCB_AIRCR_PRIGROUP_Pos 8U /*!< SCB AIRCR: PRIGROUP Position */ +#define SCB_AIRCR_PRIGROUP_Msk (7UL << SCB_AIRCR_PRIGROUP_Pos) /*!< SCB AIRCR: PRIGROUP Mask */ + +#define SCB_AIRCR_SYSRESETREQ_Pos 2U /*!< SCB AIRCR: SYSRESETREQ Position */ +#define SCB_AIRCR_SYSRESETREQ_Msk (1UL << SCB_AIRCR_SYSRESETREQ_Pos) /*!< SCB AIRCR: SYSRESETREQ Mask */ + +#define SCB_AIRCR_VECTCLRACTIVE_Pos 1U /*!< SCB AIRCR: VECTCLRACTIVE Position */ +#define SCB_AIRCR_VECTCLRACTIVE_Msk (1UL << SCB_AIRCR_VECTCLRACTIVE_Pos) /*!< SCB AIRCR: VECTCLRACTIVE Mask */ + +#define SCB_AIRCR_VECTRESET_Pos 0U /*!< SCB AIRCR: VECTRESET Position */ +#define SCB_AIRCR_VECTRESET_Msk (1UL /*<< SCB_AIRCR_VECTRESET_Pos*/) /*!< SCB AIRCR: VECTRESET Mask */ + +/* SCB System Control Register Definitions */ +#define SCB_SCR_SEVONPEND_Pos 4U /*!< SCB SCR: SEVONPEND Position */ +#define SCB_SCR_SEVONPEND_Msk (1UL << SCB_SCR_SEVONPEND_Pos) /*!< SCB SCR: SEVONPEND Mask */ + +#define SCB_SCR_SLEEPDEEP_Pos 2U /*!< SCB SCR: SLEEPDEEP Position */ +#define SCB_SCR_SLEEPDEEP_Msk (1UL << SCB_SCR_SLEEPDEEP_Pos) /*!< SCB SCR: SLEEPDEEP Mask */ + +#define SCB_SCR_SLEEPONEXIT_Pos 1U /*!< SCB SCR: SLEEPONEXIT Position */ +#define SCB_SCR_SLEEPONEXIT_Msk (1UL << SCB_SCR_SLEEPONEXIT_Pos) /*!< SCB SCR: SLEEPONEXIT Mask */ + +/* SCB Configuration Control Register Definitions */ +#define SCB_CCR_BP_Pos 18U /*!< SCB CCR: Branch prediction enable bit Position */ +#define SCB_CCR_BP_Msk (1UL << SCB_CCR_BP_Pos) /*!< SCB CCR: Branch prediction enable bit Mask */ + +#define SCB_CCR_IC_Pos 17U /*!< SCB CCR: Instruction cache enable bit Position */ +#define SCB_CCR_IC_Msk (1UL << SCB_CCR_IC_Pos) /*!< SCB CCR: Instruction cache enable bit Mask */ + +#define SCB_CCR_DC_Pos 16U /*!< SCB CCR: Cache enable bit Position */ +#define SCB_CCR_DC_Msk (1UL << SCB_CCR_DC_Pos) /*!< SCB CCR: Cache enable bit Mask */ + +#define SCB_CCR_STKALIGN_Pos 9U /*!< SCB CCR: STKALIGN Position */ +#define SCB_CCR_STKALIGN_Msk (1UL << SCB_CCR_STKALIGN_Pos) /*!< SCB CCR: STKALIGN Mask */ + +#define SCB_CCR_BFHFNMIGN_Pos 8U /*!< SCB CCR: BFHFNMIGN Position */ +#define SCB_CCR_BFHFNMIGN_Msk (1UL << SCB_CCR_BFHFNMIGN_Pos) /*!< SCB CCR: BFHFNMIGN Mask */ + +#define SCB_CCR_DIV_0_TRP_Pos 4U /*!< SCB CCR: DIV_0_TRP Position */ +#define SCB_CCR_DIV_0_TRP_Msk (1UL << SCB_CCR_DIV_0_TRP_Pos) /*!< SCB CCR: DIV_0_TRP Mask */ + +#define SCB_CCR_UNALIGN_TRP_Pos 3U /*!< SCB CCR: UNALIGN_TRP Position */ +#define SCB_CCR_UNALIGN_TRP_Msk (1UL << SCB_CCR_UNALIGN_TRP_Pos) /*!< SCB CCR: UNALIGN_TRP Mask */ + +#define SCB_CCR_USERSETMPEND_Pos 1U /*!< SCB CCR: USERSETMPEND Position */ +#define SCB_CCR_USERSETMPEND_Msk (1UL << SCB_CCR_USERSETMPEND_Pos) /*!< SCB CCR: USERSETMPEND Mask */ + +#define SCB_CCR_NONBASETHRDENA_Pos 0U /*!< SCB CCR: NONBASETHRDENA Position */ +#define SCB_CCR_NONBASETHRDENA_Msk (1UL /*<< SCB_CCR_NONBASETHRDENA_Pos*/) /*!< SCB CCR: NONBASETHRDENA Mask */ + +/* SCB System Handler Control and State Register Definitions */ +#define SCB_SHCSR_USGFAULTENA_Pos 18U /*!< SCB SHCSR: USGFAULTENA Position */ +#define SCB_SHCSR_USGFAULTENA_Msk (1UL << SCB_SHCSR_USGFAULTENA_Pos) /*!< SCB SHCSR: USGFAULTENA Mask */ + +#define SCB_SHCSR_BUSFAULTENA_Pos 17U /*!< SCB SHCSR: BUSFAULTENA Position */ +#define SCB_SHCSR_BUSFAULTENA_Msk (1UL << SCB_SHCSR_BUSFAULTENA_Pos) /*!< SCB SHCSR: BUSFAULTENA Mask */ + +#define SCB_SHCSR_MEMFAULTENA_Pos 16U /*!< SCB SHCSR: MEMFAULTENA Position */ +#define SCB_SHCSR_MEMFAULTENA_Msk (1UL << SCB_SHCSR_MEMFAULTENA_Pos) /*!< SCB SHCSR: MEMFAULTENA Mask */ + +#define SCB_SHCSR_SVCALLPENDED_Pos 15U /*!< SCB SHCSR: SVCALLPENDED Position */ +#define SCB_SHCSR_SVCALLPENDED_Msk (1UL << SCB_SHCSR_SVCALLPENDED_Pos) /*!< SCB SHCSR: SVCALLPENDED Mask */ + +#define SCB_SHCSR_BUSFAULTPENDED_Pos 14U /*!< SCB SHCSR: BUSFAULTPENDED Position */ +#define SCB_SHCSR_BUSFAULTPENDED_Msk (1UL << SCB_SHCSR_BUSFAULTPENDED_Pos) /*!< SCB SHCSR: BUSFAULTPENDED Mask */ + +#define SCB_SHCSR_MEMFAULTPENDED_Pos 13U /*!< SCB SHCSR: MEMFAULTPENDED Position */ +#define SCB_SHCSR_MEMFAULTPENDED_Msk (1UL << SCB_SHCSR_MEMFAULTPENDED_Pos) /*!< SCB SHCSR: MEMFAULTPENDED Mask */ + +#define SCB_SHCSR_USGFAULTPENDED_Pos 12U /*!< SCB SHCSR: USGFAULTPENDED Position */ +#define SCB_SHCSR_USGFAULTPENDED_Msk (1UL << SCB_SHCSR_USGFAULTPENDED_Pos) /*!< SCB SHCSR: USGFAULTPENDED Mask */ + +#define SCB_SHCSR_SYSTICKACT_Pos 11U /*!< SCB SHCSR: SYSTICKACT Position */ +#define SCB_SHCSR_SYSTICKACT_Msk (1UL << SCB_SHCSR_SYSTICKACT_Pos) /*!< SCB SHCSR: SYSTICKACT Mask */ + +#define SCB_SHCSR_PENDSVACT_Pos 10U /*!< SCB SHCSR: PENDSVACT Position */ +#define SCB_SHCSR_PENDSVACT_Msk (1UL << SCB_SHCSR_PENDSVACT_Pos) /*!< SCB SHCSR: PENDSVACT Mask */ + +#define SCB_SHCSR_MONITORACT_Pos 8U /*!< SCB SHCSR: MONITORACT Position */ +#define SCB_SHCSR_MONITORACT_Msk (1UL << SCB_SHCSR_MONITORACT_Pos) /*!< SCB SHCSR: MONITORACT Mask */ + +#define SCB_SHCSR_SVCALLACT_Pos 7U /*!< SCB SHCSR: SVCALLACT Position */ +#define SCB_SHCSR_SVCALLACT_Msk (1UL << SCB_SHCSR_SVCALLACT_Pos) /*!< SCB SHCSR: SVCALLACT Mask */ + +#define SCB_SHCSR_USGFAULTACT_Pos 3U /*!< SCB SHCSR: USGFAULTACT Position */ +#define SCB_SHCSR_USGFAULTACT_Msk (1UL << SCB_SHCSR_USGFAULTACT_Pos) /*!< SCB SHCSR: USGFAULTACT Mask */ + +#define SCB_SHCSR_BUSFAULTACT_Pos 1U /*!< SCB SHCSR: BUSFAULTACT Position */ +#define SCB_SHCSR_BUSFAULTACT_Msk (1UL << SCB_SHCSR_BUSFAULTACT_Pos) /*!< SCB SHCSR: BUSFAULTACT Mask */ + +#define SCB_SHCSR_MEMFAULTACT_Pos 0U /*!< SCB SHCSR: MEMFAULTACT Position */ +#define SCB_SHCSR_MEMFAULTACT_Msk (1UL /*<< SCB_SHCSR_MEMFAULTACT_Pos*/) /*!< SCB SHCSR: MEMFAULTACT Mask */ + +/* SCB Configurable Fault Status Register Definitions */ +#define SCB_CFSR_USGFAULTSR_Pos 16U /*!< SCB CFSR: Usage Fault Status Register Position */ +#define SCB_CFSR_USGFAULTSR_Msk (0xFFFFUL << SCB_CFSR_USGFAULTSR_Pos) /*!< SCB CFSR: Usage Fault Status Register Mask */ + +#define SCB_CFSR_BUSFAULTSR_Pos 8U /*!< SCB CFSR: Bus Fault Status Register Position */ +#define SCB_CFSR_BUSFAULTSR_Msk (0xFFUL << SCB_CFSR_BUSFAULTSR_Pos) /*!< SCB CFSR: Bus Fault Status Register Mask */ + +#define SCB_CFSR_MEMFAULTSR_Pos 0U /*!< SCB CFSR: Memory Manage Fault Status Register Position */ +#define SCB_CFSR_MEMFAULTSR_Msk (0xFFUL /*<< SCB_CFSR_MEMFAULTSR_Pos*/) /*!< SCB CFSR: Memory Manage Fault Status Register Mask */ + +/* SCB Hard Fault Status Register Definitions */ +#define SCB_HFSR_DEBUGEVT_Pos 31U /*!< SCB HFSR: DEBUGEVT Position */ +#define SCB_HFSR_DEBUGEVT_Msk (1UL << SCB_HFSR_DEBUGEVT_Pos) /*!< SCB HFSR: DEBUGEVT Mask */ + +#define SCB_HFSR_FORCED_Pos 30U /*!< SCB HFSR: FORCED Position */ +#define SCB_HFSR_FORCED_Msk (1UL << SCB_HFSR_FORCED_Pos) /*!< SCB HFSR: FORCED Mask */ + +#define SCB_HFSR_VECTTBL_Pos 1U /*!< SCB HFSR: VECTTBL Position */ +#define SCB_HFSR_VECTTBL_Msk (1UL << SCB_HFSR_VECTTBL_Pos) /*!< SCB HFSR: VECTTBL Mask */ + +/* SCB Debug Fault Status Register Definitions */ +#define SCB_DFSR_EXTERNAL_Pos 4U /*!< SCB DFSR: EXTERNAL Position */ +#define SCB_DFSR_EXTERNAL_Msk (1UL << SCB_DFSR_EXTERNAL_Pos) /*!< SCB DFSR: EXTERNAL Mask */ + +#define SCB_DFSR_VCATCH_Pos 3U /*!< SCB DFSR: VCATCH Position */ +#define SCB_DFSR_VCATCH_Msk (1UL << SCB_DFSR_VCATCH_Pos) /*!< SCB DFSR: VCATCH Mask */ + +#define SCB_DFSR_DWTTRAP_Pos 2U /*!< SCB DFSR: DWTTRAP Position */ +#define SCB_DFSR_DWTTRAP_Msk (1UL << SCB_DFSR_DWTTRAP_Pos) /*!< SCB DFSR: DWTTRAP Mask */ + +#define SCB_DFSR_BKPT_Pos 1U /*!< SCB DFSR: BKPT Position */ +#define SCB_DFSR_BKPT_Msk (1UL << SCB_DFSR_BKPT_Pos) /*!< SCB DFSR: BKPT Mask */ + +#define SCB_DFSR_HALTED_Pos 0U /*!< SCB DFSR: HALTED Position */ +#define SCB_DFSR_HALTED_Msk (1UL /*<< SCB_DFSR_HALTED_Pos*/) /*!< SCB DFSR: HALTED Mask */ + +/* SCB Cache Level ID Register Definitions */ +#define SCB_CLIDR_LOUU_Pos 27U /*!< SCB CLIDR: LoUU Position */ +#define SCB_CLIDR_LOUU_Msk (7UL << SCB_CLIDR_LOUU_Pos) /*!< SCB CLIDR: LoUU Mask */ + +#define SCB_CLIDR_LOC_Pos 24U /*!< SCB CLIDR: LoC Position */ +#define SCB_CLIDR_LOC_Msk (7UL << SCB_CLIDR_LOC_Pos) /*!< SCB CLIDR: LoC Mask */ + +/* SCB Cache Type Register Definitions */ +#define SCB_CTR_FORMAT_Pos 29U /*!< SCB CTR: Format Position */ +#define SCB_CTR_FORMAT_Msk (7UL << SCB_CTR_FORMAT_Pos) /*!< SCB CTR: Format Mask */ + +#define SCB_CTR_CWG_Pos 24U /*!< SCB CTR: CWG Position */ +#define SCB_CTR_CWG_Msk (0xFUL << SCB_CTR_CWG_Pos) /*!< SCB CTR: CWG Mask */ + +#define SCB_CTR_ERG_Pos 20U /*!< SCB CTR: ERG Position */ +#define SCB_CTR_ERG_Msk (0xFUL << SCB_CTR_ERG_Pos) /*!< SCB CTR: ERG Mask */ + +#define SCB_CTR_DMINLINE_Pos 16U /*!< SCB CTR: DminLine Position */ +#define SCB_CTR_DMINLINE_Msk (0xFUL << SCB_CTR_DMINLINE_Pos) /*!< SCB CTR: DminLine Mask */ + +#define SCB_CTR_IMINLINE_Pos 0U /*!< SCB CTR: ImInLine Position */ +#define SCB_CTR_IMINLINE_Msk (0xFUL /*<< SCB_CTR_IMINLINE_Pos*/) /*!< SCB CTR: ImInLine Mask */ + +/* SCB Cache Size ID Register Definitions */ +#define SCB_CCSIDR_WT_Pos 31U /*!< SCB CCSIDR: WT Position */ +#define SCB_CCSIDR_WT_Msk (1UL << SCB_CCSIDR_WT_Pos) /*!< SCB CCSIDR: WT Mask */ + +#define SCB_CCSIDR_WB_Pos 30U /*!< SCB CCSIDR: WB Position */ +#define SCB_CCSIDR_WB_Msk (1UL << SCB_CCSIDR_WB_Pos) /*!< SCB CCSIDR: WB Mask */ + +#define SCB_CCSIDR_RA_Pos 29U /*!< SCB CCSIDR: RA Position */ +#define SCB_CCSIDR_RA_Msk (1UL << SCB_CCSIDR_RA_Pos) /*!< SCB CCSIDR: RA Mask */ + +#define SCB_CCSIDR_WA_Pos 28U /*!< SCB CCSIDR: WA Position */ +#define SCB_CCSIDR_WA_Msk (1UL << SCB_CCSIDR_WA_Pos) /*!< SCB CCSIDR: WA Mask */ + +#define SCB_CCSIDR_NUMSETS_Pos 13U /*!< SCB CCSIDR: NumSets Position */ +#define SCB_CCSIDR_NUMSETS_Msk (0x7FFFUL << SCB_CCSIDR_NUMSETS_Pos) /*!< SCB CCSIDR: NumSets Mask */ + +#define SCB_CCSIDR_ASSOCIATIVITY_Pos 3U /*!< SCB CCSIDR: Associativity Position */ +#define SCB_CCSIDR_ASSOCIATIVITY_Msk (0x3FFUL << SCB_CCSIDR_ASSOCIATIVITY_Pos) /*!< SCB CCSIDR: Associativity Mask */ + +#define SCB_CCSIDR_LINESIZE_Pos 0U /*!< SCB CCSIDR: LineSize Position */ +#define SCB_CCSIDR_LINESIZE_Msk (7UL /*<< SCB_CCSIDR_LINESIZE_Pos*/) /*!< SCB CCSIDR: LineSize Mask */ + +/* SCB Cache Size Selection Register Definitions */ +#define SCB_CSSELR_LEVEL_Pos 1U /*!< SCB CSSELR: Level Position */ +#define SCB_CSSELR_LEVEL_Msk (7UL << SCB_CSSELR_LEVEL_Pos) /*!< SCB CSSELR: Level Mask */ + +#define SCB_CSSELR_IND_Pos 0U /*!< SCB CSSELR: InD Position */ +#define SCB_CSSELR_IND_Msk (1UL /*<< SCB_CSSELR_IND_Pos*/) /*!< SCB CSSELR: InD Mask */ + +/* SCB Software Triggered Interrupt Register Definitions */ +#define SCB_STIR_INTID_Pos 0U /*!< SCB STIR: INTID Position */ +#define SCB_STIR_INTID_Msk (0x1FFUL /*<< SCB_STIR_INTID_Pos*/) /*!< SCB STIR: INTID Mask */ + +/* SCB D-Cache Invalidate by Set-way Register Definitions */ +#define SCB_DCISW_WAY_Pos 30U /*!< SCB DCISW: Way Position */ +#define SCB_DCISW_WAY_Msk (3UL << SCB_DCISW_WAY_Pos) /*!< SCB DCISW: Way Mask */ + +#define SCB_DCISW_SET_Pos 5U /*!< SCB DCISW: Set Position */ +#define SCB_DCISW_SET_Msk (0x1FFUL << SCB_DCISW_SET_Pos) /*!< SCB DCISW: Set Mask */ + +/* SCB D-Cache Clean by Set-way Register Definitions */ +#define SCB_DCCSW_WAY_Pos 30U /*!< SCB DCCSW: Way Position */ +#define SCB_DCCSW_WAY_Msk (3UL << SCB_DCCSW_WAY_Pos) /*!< SCB DCCSW: Way Mask */ + +#define SCB_DCCSW_SET_Pos 5U /*!< SCB DCCSW: Set Position */ +#define SCB_DCCSW_SET_Msk (0x1FFUL << SCB_DCCSW_SET_Pos) /*!< SCB DCCSW: Set Mask */ + +/* SCB D-Cache Clean and Invalidate by Set-way Register Definitions */ +#define SCB_DCCISW_WAY_Pos 30U /*!< SCB DCCISW: Way Position */ +#define SCB_DCCISW_WAY_Msk (3UL << SCB_DCCISW_WAY_Pos) /*!< SCB DCCISW: Way Mask */ + +#define SCB_DCCISW_SET_Pos 5U /*!< SCB DCCISW: Set Position */ +#define SCB_DCCISW_SET_Msk (0x1FFUL << SCB_DCCISW_SET_Pos) /*!< SCB DCCISW: Set Mask */ + +/* Instruction Tightly-Coupled Memory Control Register Definitions */ +#define SCB_ITCMCR_SZ_Pos 3U /*!< SCB ITCMCR: SZ Position */ +#define SCB_ITCMCR_SZ_Msk (0xFUL << SCB_ITCMCR_SZ_Pos) /*!< SCB ITCMCR: SZ Mask */ + +#define SCB_ITCMCR_RETEN_Pos 2U /*!< SCB ITCMCR: RETEN Position */ +#define SCB_ITCMCR_RETEN_Msk (1UL << SCB_ITCMCR_RETEN_Pos) /*!< SCB ITCMCR: RETEN Mask */ + +#define SCB_ITCMCR_RMW_Pos 1U /*!< SCB ITCMCR: RMW Position */ +#define SCB_ITCMCR_RMW_Msk (1UL << SCB_ITCMCR_RMW_Pos) /*!< SCB ITCMCR: RMW Mask */ + +#define SCB_ITCMCR_EN_Pos 0U /*!< SCB ITCMCR: EN Position */ +#define SCB_ITCMCR_EN_Msk (1UL /*<< SCB_ITCMCR_EN_Pos*/) /*!< SCB ITCMCR: EN Mask */ + +/* Data Tightly-Coupled Memory Control Register Definitions */ +#define SCB_DTCMCR_SZ_Pos 3U /*!< SCB DTCMCR: SZ Position */ +#define SCB_DTCMCR_SZ_Msk (0xFUL << SCB_DTCMCR_SZ_Pos) /*!< SCB DTCMCR: SZ Mask */ + +#define SCB_DTCMCR_RETEN_Pos 2U /*!< SCB DTCMCR: RETEN Position */ +#define SCB_DTCMCR_RETEN_Msk (1UL << SCB_DTCMCR_RETEN_Pos) /*!< SCB DTCMCR: RETEN Mask */ + +#define SCB_DTCMCR_RMW_Pos 1U /*!< SCB DTCMCR: RMW Position */ +#define SCB_DTCMCR_RMW_Msk (1UL << SCB_DTCMCR_RMW_Pos) /*!< SCB DTCMCR: RMW Mask */ + +#define SCB_DTCMCR_EN_Pos 0U /*!< SCB DTCMCR: EN Position */ +#define SCB_DTCMCR_EN_Msk (1UL /*<< SCB_DTCMCR_EN_Pos*/) /*!< SCB DTCMCR: EN Mask */ + +/* AHBP Control Register Definitions */ +#define SCB_AHBPCR_SZ_Pos 1U /*!< SCB AHBPCR: SZ Position */ +#define SCB_AHBPCR_SZ_Msk (7UL << SCB_AHBPCR_SZ_Pos) /*!< SCB AHBPCR: SZ Mask */ + +#define SCB_AHBPCR_EN_Pos 0U /*!< SCB AHBPCR: EN Position */ +#define SCB_AHBPCR_EN_Msk (1UL /*<< SCB_AHBPCR_EN_Pos*/) /*!< SCB AHBPCR: EN Mask */ + +/* L1 Cache Control Register Definitions */ +#define SCB_CACR_FORCEWT_Pos 2U /*!< SCB CACR: FORCEWT Position */ +#define SCB_CACR_FORCEWT_Msk (1UL << SCB_CACR_FORCEWT_Pos) /*!< SCB CACR: FORCEWT Mask */ + +#define SCB_CACR_ECCEN_Pos 1U /*!< SCB CACR: ECCEN Position */ +#define SCB_CACR_ECCEN_Msk (1UL << SCB_CACR_ECCEN_Pos) /*!< SCB CACR: ECCEN Mask */ + +#define SCB_CACR_SIWT_Pos 0U /*!< SCB CACR: SIWT Position */ +#define SCB_CACR_SIWT_Msk (1UL /*<< SCB_CACR_SIWT_Pos*/) /*!< SCB CACR: SIWT Mask */ + +/* AHBS Control Register Definitions */ +#define SCB_AHBSCR_INITCOUNT_Pos 11U /*!< SCB AHBSCR: INITCOUNT Position */ +#define SCB_AHBSCR_INITCOUNT_Msk (0x1FUL << SCB_AHBPCR_INITCOUNT_Pos) /*!< SCB AHBSCR: INITCOUNT Mask */ + +#define SCB_AHBSCR_TPRI_Pos 2U /*!< SCB AHBSCR: TPRI Position */ +#define SCB_AHBSCR_TPRI_Msk (0x1FFUL << SCB_AHBPCR_TPRI_Pos) /*!< SCB AHBSCR: TPRI Mask */ + +#define SCB_AHBSCR_CTL_Pos 0U /*!< SCB AHBSCR: CTL Position*/ +#define SCB_AHBSCR_CTL_Msk (3UL /*<< SCB_AHBPCR_CTL_Pos*/) /*!< SCB AHBSCR: CTL Mask */ + +/* Auxiliary Bus Fault Status Register Definitions */ +#define SCB_ABFSR_AXIMTYPE_Pos 8U /*!< SCB ABFSR: AXIMTYPE Position*/ +#define SCB_ABFSR_AXIMTYPE_Msk (3UL << SCB_ABFSR_AXIMTYPE_Pos) /*!< SCB ABFSR: AXIMTYPE Mask */ + +#define SCB_ABFSR_EPPB_Pos 4U /*!< SCB ABFSR: EPPB Position*/ +#define SCB_ABFSR_EPPB_Msk (1UL << SCB_ABFSR_EPPB_Pos) /*!< SCB ABFSR: EPPB Mask */ + +#define SCB_ABFSR_AXIM_Pos 3U /*!< SCB ABFSR: AXIM Position*/ +#define SCB_ABFSR_AXIM_Msk (1UL << SCB_ABFSR_AXIM_Pos) /*!< SCB ABFSR: AXIM Mask */ + +#define SCB_ABFSR_AHBP_Pos 2U /*!< SCB ABFSR: AHBP Position*/ +#define SCB_ABFSR_AHBP_Msk (1UL << SCB_ABFSR_AHBP_Pos) /*!< SCB ABFSR: AHBP Mask */ + +#define SCB_ABFSR_DTCM_Pos 1U /*!< SCB ABFSR: DTCM Position*/ +#define SCB_ABFSR_DTCM_Msk (1UL << SCB_ABFSR_DTCM_Pos) /*!< SCB ABFSR: DTCM Mask */ + +#define SCB_ABFSR_ITCM_Pos 0U /*!< SCB ABFSR: ITCM Position*/ +#define SCB_ABFSR_ITCM_Msk (1UL /*<< SCB_ABFSR_ITCM_Pos*/) /*!< SCB ABFSR: ITCM Mask */ + +/*@} end of group CMSIS_SCB */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_SCnSCB System Controls not in SCB (SCnSCB) + \brief Type definitions for the System Control and ID Register not in the SCB + @{ + */ + +/** + \brief Structure type to access the System Control and ID Register not in the SCB. + */ +typedef struct +{ + uint32_t RESERVED0[1U]; + __IM uint32_t ICTR; /*!< Offset: 0x004 (R/ ) Interrupt Controller Type Register */ + __IOM uint32_t ACTLR; /*!< Offset: 0x008 (R/W) Auxiliary Control Register */ +} SCnSCB_Type; + +/* Interrupt Controller Type Register Definitions */ +#define SCnSCB_ICTR_INTLINESNUM_Pos 0U /*!< ICTR: INTLINESNUM Position */ +#define SCnSCB_ICTR_INTLINESNUM_Msk (0xFUL /*<< SCnSCB_ICTR_INTLINESNUM_Pos*/) /*!< ICTR: INTLINESNUM Mask */ + +/* Auxiliary Control Register Definitions */ +#define SCnSCB_ACTLR_DISITMATBFLUSH_Pos 12U /*!< ACTLR: DISITMATBFLUSH Position */ +#define SCnSCB_ACTLR_DISITMATBFLUSH_Msk (1UL << SCnSCB_ACTLR_DISITMATBFLUSH_Pos) /*!< ACTLR: DISITMATBFLUSH Mask */ + +#define SCnSCB_ACTLR_DISRAMODE_Pos 11U /*!< ACTLR: DISRAMODE Position */ +#define SCnSCB_ACTLR_DISRAMODE_Msk (1UL << SCnSCB_ACTLR_DISRAMODE_Pos) /*!< ACTLR: DISRAMODE Mask */ + +#define SCnSCB_ACTLR_FPEXCODIS_Pos 10U /*!< ACTLR: FPEXCODIS Position */ +#define SCnSCB_ACTLR_FPEXCODIS_Msk (1UL << SCnSCB_ACTLR_FPEXCODIS_Pos) /*!< ACTLR: FPEXCODIS Mask */ + +#define SCnSCB_ACTLR_DISFOLD_Pos 2U /*!< ACTLR: DISFOLD Position */ +#define SCnSCB_ACTLR_DISFOLD_Msk (1UL << SCnSCB_ACTLR_DISFOLD_Pos) /*!< ACTLR: DISFOLD Mask */ + +#define SCnSCB_ACTLR_DISMCYCINT_Pos 0U /*!< ACTLR: DISMCYCINT Position */ +#define SCnSCB_ACTLR_DISMCYCINT_Msk (1UL /*<< SCnSCB_ACTLR_DISMCYCINT_Pos*/) /*!< ACTLR: DISMCYCINT Mask */ + +/*@} end of group CMSIS_SCnotSCB */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_SysTick System Tick Timer (SysTick) + \brief Type definitions for the System Timer Registers. + @{ + */ + +/** + \brief Structure type to access the System Timer (SysTick). + */ +typedef struct +{ + __IOM uint32_t CTRL; /*!< Offset: 0x000 (R/W) SysTick Control and Status Register */ + __IOM uint32_t LOAD; /*!< Offset: 0x004 (R/W) SysTick Reload Value Register */ + __IOM uint32_t VAL; /*!< Offset: 0x008 (R/W) SysTick Current Value Register */ + __IM uint32_t CALIB; /*!< Offset: 0x00C (R/ ) SysTick Calibration Register */ +} SysTick_Type; + +/* SysTick Control / Status Register Definitions */ +#define SysTick_CTRL_COUNTFLAG_Pos 16U /*!< SysTick CTRL: COUNTFLAG Position */ +#define SysTick_CTRL_COUNTFLAG_Msk (1UL << SysTick_CTRL_COUNTFLAG_Pos) /*!< SysTick CTRL: COUNTFLAG Mask */ + +#define SysTick_CTRL_CLKSOURCE_Pos 2U /*!< SysTick CTRL: CLKSOURCE Position */ +#define SysTick_CTRL_CLKSOURCE_Msk (1UL << SysTick_CTRL_CLKSOURCE_Pos) /*!< SysTick CTRL: CLKSOURCE Mask */ + +#define SysTick_CTRL_TICKINT_Pos 1U /*!< SysTick CTRL: TICKINT Position */ +#define SysTick_CTRL_TICKINT_Msk (1UL << SysTick_CTRL_TICKINT_Pos) /*!< SysTick CTRL: TICKINT Mask */ + +#define SysTick_CTRL_ENABLE_Pos 0U /*!< SysTick CTRL: ENABLE Position */ +#define SysTick_CTRL_ENABLE_Msk (1UL /*<< SysTick_CTRL_ENABLE_Pos*/) /*!< SysTick CTRL: ENABLE Mask */ + +/* SysTick Reload Register Definitions */ +#define SysTick_LOAD_RELOAD_Pos 0U /*!< SysTick LOAD: RELOAD Position */ +#define SysTick_LOAD_RELOAD_Msk (0xFFFFFFUL /*<< SysTick_LOAD_RELOAD_Pos*/) /*!< SysTick LOAD: RELOAD Mask */ + +/* SysTick Current Register Definitions */ +#define SysTick_VAL_CURRENT_Pos 0U /*!< SysTick VAL: CURRENT Position */ +#define SysTick_VAL_CURRENT_Msk (0xFFFFFFUL /*<< SysTick_VAL_CURRENT_Pos*/) /*!< SysTick VAL: CURRENT Mask */ + +/* SysTick Calibration Register Definitions */ +#define SysTick_CALIB_NOREF_Pos 31U /*!< SysTick CALIB: NOREF Position */ +#define SysTick_CALIB_NOREF_Msk (1UL << SysTick_CALIB_NOREF_Pos) /*!< SysTick CALIB: NOREF Mask */ + +#define SysTick_CALIB_SKEW_Pos 30U /*!< SysTick CALIB: SKEW Position */ +#define SysTick_CALIB_SKEW_Msk (1UL << SysTick_CALIB_SKEW_Pos) /*!< SysTick CALIB: SKEW Mask */ + +#define SysTick_CALIB_TENMS_Pos 0U /*!< SysTick CALIB: TENMS Position */ +#define SysTick_CALIB_TENMS_Msk (0xFFFFFFUL /*<< SysTick_CALIB_TENMS_Pos*/) /*!< SysTick CALIB: TENMS Mask */ + +/*@} end of group CMSIS_SysTick */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_ITM Instrumentation Trace Macrocell (ITM) + \brief Type definitions for the Instrumentation Trace Macrocell (ITM) + @{ + */ + +/** + \brief Structure type to access the Instrumentation Trace Macrocell Register (ITM). + */ +typedef struct +{ + __OM union + { + __OM uint8_t u8; /*!< Offset: 0x000 ( /W) ITM Stimulus Port 8-bit */ + __OM uint16_t u16; /*!< Offset: 0x000 ( /W) ITM Stimulus Port 16-bit */ + __OM uint32_t u32; /*!< Offset: 0x000 ( /W) ITM Stimulus Port 32-bit */ + } PORT [32U]; /*!< Offset: 0x000 ( /W) ITM Stimulus Port Registers */ + uint32_t RESERVED0[864U]; + __IOM uint32_t TER; /*!< Offset: 0xE00 (R/W) ITM Trace Enable Register */ + uint32_t RESERVED1[15U]; + __IOM uint32_t TPR; /*!< Offset: 0xE40 (R/W) ITM Trace Privilege Register */ + uint32_t RESERVED2[15U]; + __IOM uint32_t TCR; /*!< Offset: 0xE80 (R/W) ITM Trace Control Register */ + uint32_t RESERVED3[29U]; + __OM uint32_t IWR; /*!< Offset: 0xEF8 ( /W) ITM Integration Write Register */ + __IM uint32_t IRR; /*!< Offset: 0xEFC (R/ ) ITM Integration Read Register */ + __IOM uint32_t IMCR; /*!< Offset: 0xF00 (R/W) ITM Integration Mode Control Register */ + uint32_t RESERVED4[43U]; + __OM uint32_t LAR; /*!< Offset: 0xFB0 ( /W) ITM Lock Access Register */ + __IM uint32_t LSR; /*!< Offset: 0xFB4 (R/ ) ITM Lock Status Register */ + uint32_t RESERVED5[6U]; + __IM uint32_t PID4; /*!< Offset: 0xFD0 (R/ ) ITM Peripheral Identification Register #4 */ + __IM uint32_t PID5; /*!< Offset: 0xFD4 (R/ ) ITM Peripheral Identification Register #5 */ + __IM uint32_t PID6; /*!< Offset: 0xFD8 (R/ ) ITM Peripheral Identification Register #6 */ + __IM uint32_t PID7; /*!< Offset: 0xFDC (R/ ) ITM Peripheral Identification Register #7 */ + __IM uint32_t PID0; /*!< Offset: 0xFE0 (R/ ) ITM Peripheral Identification Register #0 */ + __IM uint32_t PID1; /*!< Offset: 0xFE4 (R/ ) ITM Peripheral Identification Register #1 */ + __IM uint32_t PID2; /*!< Offset: 0xFE8 (R/ ) ITM Peripheral Identification Register #2 */ + __IM uint32_t PID3; /*!< Offset: 0xFEC (R/ ) ITM Peripheral Identification Register #3 */ + __IM uint32_t CID0; /*!< Offset: 0xFF0 (R/ ) ITM Component Identification Register #0 */ + __IM uint32_t CID1; /*!< Offset: 0xFF4 (R/ ) ITM Component Identification Register #1 */ + __IM uint32_t CID2; /*!< Offset: 0xFF8 (R/ ) ITM Component Identification Register #2 */ + __IM uint32_t CID3; /*!< Offset: 0xFFC (R/ ) ITM Component Identification Register #3 */ +} ITM_Type; + +/* ITM Trace Privilege Register Definitions */ +#define ITM_TPR_PRIVMASK_Pos 0U /*!< ITM TPR: PRIVMASK Position */ +#define ITM_TPR_PRIVMASK_Msk (0xFUL /*<< ITM_TPR_PRIVMASK_Pos*/) /*!< ITM TPR: PRIVMASK Mask */ + +/* ITM Trace Control Register Definitions */ +#define ITM_TCR_BUSY_Pos 23U /*!< ITM TCR: BUSY Position */ +#define ITM_TCR_BUSY_Msk (1UL << ITM_TCR_BUSY_Pos) /*!< ITM TCR: BUSY Mask */ + +#define ITM_TCR_TraceBusID_Pos 16U /*!< ITM TCR: ATBID Position */ +#define ITM_TCR_TraceBusID_Msk (0x7FUL << ITM_TCR_TraceBusID_Pos) /*!< ITM TCR: ATBID Mask */ + +#define ITM_TCR_GTSFREQ_Pos 10U /*!< ITM TCR: Global timestamp frequency Position */ +#define ITM_TCR_GTSFREQ_Msk (3UL << ITM_TCR_GTSFREQ_Pos) /*!< ITM TCR: Global timestamp frequency Mask */ + +#define ITM_TCR_TSPrescale_Pos 8U /*!< ITM TCR: TSPrescale Position */ +#define ITM_TCR_TSPrescale_Msk (3UL << ITM_TCR_TSPrescale_Pos) /*!< ITM TCR: TSPrescale Mask */ + +#define ITM_TCR_SWOENA_Pos 4U /*!< ITM TCR: SWOENA Position */ +#define ITM_TCR_SWOENA_Msk (1UL << ITM_TCR_SWOENA_Pos) /*!< ITM TCR: SWOENA Mask */ + +#define ITM_TCR_DWTENA_Pos 3U /*!< ITM TCR: DWTENA Position */ +#define ITM_TCR_DWTENA_Msk (1UL << ITM_TCR_DWTENA_Pos) /*!< ITM TCR: DWTENA Mask */ + +#define ITM_TCR_SYNCENA_Pos 2U /*!< ITM TCR: SYNCENA Position */ +#define ITM_TCR_SYNCENA_Msk (1UL << ITM_TCR_SYNCENA_Pos) /*!< ITM TCR: SYNCENA Mask */ + +#define ITM_TCR_TSENA_Pos 1U /*!< ITM TCR: TSENA Position */ +#define ITM_TCR_TSENA_Msk (1UL << ITM_TCR_TSENA_Pos) /*!< ITM TCR: TSENA Mask */ + +#define ITM_TCR_ITMENA_Pos 0U /*!< ITM TCR: ITM Enable bit Position */ +#define ITM_TCR_ITMENA_Msk (1UL /*<< ITM_TCR_ITMENA_Pos*/) /*!< ITM TCR: ITM Enable bit Mask */ + +/* ITM Integration Write Register Definitions */ +#define ITM_IWR_ATVALIDM_Pos 0U /*!< ITM IWR: ATVALIDM Position */ +#define ITM_IWR_ATVALIDM_Msk (1UL /*<< ITM_IWR_ATVALIDM_Pos*/) /*!< ITM IWR: ATVALIDM Mask */ + +/* ITM Integration Read Register Definitions */ +#define ITM_IRR_ATREADYM_Pos 0U /*!< ITM IRR: ATREADYM Position */ +#define ITM_IRR_ATREADYM_Msk (1UL /*<< ITM_IRR_ATREADYM_Pos*/) /*!< ITM IRR: ATREADYM Mask */ + +/* ITM Integration Mode Control Register Definitions */ +#define ITM_IMCR_INTEGRATION_Pos 0U /*!< ITM IMCR: INTEGRATION Position */ +#define ITM_IMCR_INTEGRATION_Msk (1UL /*<< ITM_IMCR_INTEGRATION_Pos*/) /*!< ITM IMCR: INTEGRATION Mask */ + +/* ITM Lock Status Register Definitions */ +#define ITM_LSR_ByteAcc_Pos 2U /*!< ITM LSR: ByteAcc Position */ +#define ITM_LSR_ByteAcc_Msk (1UL << ITM_LSR_ByteAcc_Pos) /*!< ITM LSR: ByteAcc Mask */ + +#define ITM_LSR_Access_Pos 1U /*!< ITM LSR: Access Position */ +#define ITM_LSR_Access_Msk (1UL << ITM_LSR_Access_Pos) /*!< ITM LSR: Access Mask */ + +#define ITM_LSR_Present_Pos 0U /*!< ITM LSR: Present Position */ +#define ITM_LSR_Present_Msk (1UL /*<< ITM_LSR_Present_Pos*/) /*!< ITM LSR: Present Mask */ + +/*@}*/ /* end of group CMSIS_ITM */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_DWT Data Watchpoint and Trace (DWT) + \brief Type definitions for the Data Watchpoint and Trace (DWT) + @{ + */ + +/** + \brief Structure type to access the Data Watchpoint and Trace Register (DWT). + */ +typedef struct +{ + __IOM uint32_t CTRL; /*!< Offset: 0x000 (R/W) Control Register */ + __IOM uint32_t CYCCNT; /*!< Offset: 0x004 (R/W) Cycle Count Register */ + __IOM uint32_t CPICNT; /*!< Offset: 0x008 (R/W) CPI Count Register */ + __IOM uint32_t EXCCNT; /*!< Offset: 0x00C (R/W) Exception Overhead Count Register */ + __IOM uint32_t SLEEPCNT; /*!< Offset: 0x010 (R/W) Sleep Count Register */ + __IOM uint32_t LSUCNT; /*!< Offset: 0x014 (R/W) LSU Count Register */ + __IOM uint32_t FOLDCNT; /*!< Offset: 0x018 (R/W) Folded-instruction Count Register */ + __IM uint32_t PCSR; /*!< Offset: 0x01C (R/ ) Program Counter Sample Register */ + __IOM uint32_t COMP0; /*!< Offset: 0x020 (R/W) Comparator Register 0 */ + __IOM uint32_t MASK0; /*!< Offset: 0x024 (R/W) Mask Register 0 */ + __IOM uint32_t FUNCTION0; /*!< Offset: 0x028 (R/W) Function Register 0 */ + uint32_t RESERVED0[1U]; + __IOM uint32_t COMP1; /*!< Offset: 0x030 (R/W) Comparator Register 1 */ + __IOM uint32_t MASK1; /*!< Offset: 0x034 (R/W) Mask Register 1 */ + __IOM uint32_t FUNCTION1; /*!< Offset: 0x038 (R/W) Function Register 1 */ + uint32_t RESERVED1[1U]; + __IOM uint32_t COMP2; /*!< Offset: 0x040 (R/W) Comparator Register 2 */ + __IOM uint32_t MASK2; /*!< Offset: 0x044 (R/W) Mask Register 2 */ + __IOM uint32_t FUNCTION2; /*!< Offset: 0x048 (R/W) Function Register 2 */ + uint32_t RESERVED2[1U]; + __IOM uint32_t COMP3; /*!< Offset: 0x050 (R/W) Comparator Register 3 */ + __IOM uint32_t MASK3; /*!< Offset: 0x054 (R/W) Mask Register 3 */ + __IOM uint32_t FUNCTION3; /*!< Offset: 0x058 (R/W) Function Register 3 */ + uint32_t RESERVED3[981U]; + __OM uint32_t LAR; /*!< Offset: 0xFB0 ( W) Lock Access Register */ + __IM uint32_t LSR; /*!< Offset: 0xFB4 (R ) Lock Status Register */ +} DWT_Type; + +/* DWT Control Register Definitions */ +#define DWT_CTRL_NUMCOMP_Pos 28U /*!< DWT CTRL: NUMCOMP Position */ +#define DWT_CTRL_NUMCOMP_Msk (0xFUL << DWT_CTRL_NUMCOMP_Pos) /*!< DWT CTRL: NUMCOMP Mask */ + +#define DWT_CTRL_NOTRCPKT_Pos 27U /*!< DWT CTRL: NOTRCPKT Position */ +#define DWT_CTRL_NOTRCPKT_Msk (0x1UL << DWT_CTRL_NOTRCPKT_Pos) /*!< DWT CTRL: NOTRCPKT Mask */ + +#define DWT_CTRL_NOEXTTRIG_Pos 26U /*!< DWT CTRL: NOEXTTRIG Position */ +#define DWT_CTRL_NOEXTTRIG_Msk (0x1UL << DWT_CTRL_NOEXTTRIG_Pos) /*!< DWT CTRL: NOEXTTRIG Mask */ + +#define DWT_CTRL_NOCYCCNT_Pos 25U /*!< DWT CTRL: NOCYCCNT Position */ +#define DWT_CTRL_NOCYCCNT_Msk (0x1UL << DWT_CTRL_NOCYCCNT_Pos) /*!< DWT CTRL: NOCYCCNT Mask */ + +#define DWT_CTRL_NOPRFCNT_Pos 24U /*!< DWT CTRL: NOPRFCNT Position */ +#define DWT_CTRL_NOPRFCNT_Msk (0x1UL << DWT_CTRL_NOPRFCNT_Pos) /*!< DWT CTRL: NOPRFCNT Mask */ + +#define DWT_CTRL_CYCEVTENA_Pos 22U /*!< DWT CTRL: CYCEVTENA Position */ +#define DWT_CTRL_CYCEVTENA_Msk (0x1UL << DWT_CTRL_CYCEVTENA_Pos) /*!< DWT CTRL: CYCEVTENA Mask */ + +#define DWT_CTRL_FOLDEVTENA_Pos 21U /*!< DWT CTRL: FOLDEVTENA Position */ +#define DWT_CTRL_FOLDEVTENA_Msk (0x1UL << DWT_CTRL_FOLDEVTENA_Pos) /*!< DWT CTRL: FOLDEVTENA Mask */ + +#define DWT_CTRL_LSUEVTENA_Pos 20U /*!< DWT CTRL: LSUEVTENA Position */ +#define DWT_CTRL_LSUEVTENA_Msk (0x1UL << DWT_CTRL_LSUEVTENA_Pos) /*!< DWT CTRL: LSUEVTENA Mask */ + +#define DWT_CTRL_SLEEPEVTENA_Pos 19U /*!< DWT CTRL: SLEEPEVTENA Position */ +#define DWT_CTRL_SLEEPEVTENA_Msk (0x1UL << DWT_CTRL_SLEEPEVTENA_Pos) /*!< DWT CTRL: SLEEPEVTENA Mask */ + +#define DWT_CTRL_EXCEVTENA_Pos 18U /*!< DWT CTRL: EXCEVTENA Position */ +#define DWT_CTRL_EXCEVTENA_Msk (0x1UL << DWT_CTRL_EXCEVTENA_Pos) /*!< DWT CTRL: EXCEVTENA Mask */ + +#define DWT_CTRL_CPIEVTENA_Pos 17U /*!< DWT CTRL: CPIEVTENA Position */ +#define DWT_CTRL_CPIEVTENA_Msk (0x1UL << DWT_CTRL_CPIEVTENA_Pos) /*!< DWT CTRL: CPIEVTENA Mask */ + +#define DWT_CTRL_EXCTRCENA_Pos 16U /*!< DWT CTRL: EXCTRCENA Position */ +#define DWT_CTRL_EXCTRCENA_Msk (0x1UL << DWT_CTRL_EXCTRCENA_Pos) /*!< DWT CTRL: EXCTRCENA Mask */ + +#define DWT_CTRL_PCSAMPLENA_Pos 12U /*!< DWT CTRL: PCSAMPLENA Position */ +#define DWT_CTRL_PCSAMPLENA_Msk (0x1UL << DWT_CTRL_PCSAMPLENA_Pos) /*!< DWT CTRL: PCSAMPLENA Mask */ + +#define DWT_CTRL_SYNCTAP_Pos 10U /*!< DWT CTRL: SYNCTAP Position */ +#define DWT_CTRL_SYNCTAP_Msk (0x3UL << DWT_CTRL_SYNCTAP_Pos) /*!< DWT CTRL: SYNCTAP Mask */ + +#define DWT_CTRL_CYCTAP_Pos 9U /*!< DWT CTRL: CYCTAP Position */ +#define DWT_CTRL_CYCTAP_Msk (0x1UL << DWT_CTRL_CYCTAP_Pos) /*!< DWT CTRL: CYCTAP Mask */ + +#define DWT_CTRL_POSTINIT_Pos 5U /*!< DWT CTRL: POSTINIT Position */ +#define DWT_CTRL_POSTINIT_Msk (0xFUL << DWT_CTRL_POSTINIT_Pos) /*!< DWT CTRL: POSTINIT Mask */ + +#define DWT_CTRL_POSTPRESET_Pos 1U /*!< DWT CTRL: POSTPRESET Position */ +#define DWT_CTRL_POSTPRESET_Msk (0xFUL << DWT_CTRL_POSTPRESET_Pos) /*!< DWT CTRL: POSTPRESET Mask */ + +#define DWT_CTRL_CYCCNTENA_Pos 0U /*!< DWT CTRL: CYCCNTENA Position */ +#define DWT_CTRL_CYCCNTENA_Msk (0x1UL /*<< DWT_CTRL_CYCCNTENA_Pos*/) /*!< DWT CTRL: CYCCNTENA Mask */ + +/* DWT CPI Count Register Definitions */ +#define DWT_CPICNT_CPICNT_Pos 0U /*!< DWT CPICNT: CPICNT Position */ +#define DWT_CPICNT_CPICNT_Msk (0xFFUL /*<< DWT_CPICNT_CPICNT_Pos*/) /*!< DWT CPICNT: CPICNT Mask */ + +/* DWT Exception Overhead Count Register Definitions */ +#define DWT_EXCCNT_EXCCNT_Pos 0U /*!< DWT EXCCNT: EXCCNT Position */ +#define DWT_EXCCNT_EXCCNT_Msk (0xFFUL /*<< DWT_EXCCNT_EXCCNT_Pos*/) /*!< DWT EXCCNT: EXCCNT Mask */ + +/* DWT Sleep Count Register Definitions */ +#define DWT_SLEEPCNT_SLEEPCNT_Pos 0U /*!< DWT SLEEPCNT: SLEEPCNT Position */ +#define DWT_SLEEPCNT_SLEEPCNT_Msk (0xFFUL /*<< DWT_SLEEPCNT_SLEEPCNT_Pos*/) /*!< DWT SLEEPCNT: SLEEPCNT Mask */ + +/* DWT LSU Count Register Definitions */ +#define DWT_LSUCNT_LSUCNT_Pos 0U /*!< DWT LSUCNT: LSUCNT Position */ +#define DWT_LSUCNT_LSUCNT_Msk (0xFFUL /*<< DWT_LSUCNT_LSUCNT_Pos*/) /*!< DWT LSUCNT: LSUCNT Mask */ + +/* DWT Folded-instruction Count Register Definitions */ +#define DWT_FOLDCNT_FOLDCNT_Pos 0U /*!< DWT FOLDCNT: FOLDCNT Position */ +#define DWT_FOLDCNT_FOLDCNT_Msk (0xFFUL /*<< DWT_FOLDCNT_FOLDCNT_Pos*/) /*!< DWT FOLDCNT: FOLDCNT Mask */ + +/* DWT Comparator Mask Register Definitions */ +#define DWT_MASK_MASK_Pos 0U /*!< DWT MASK: MASK Position */ +#define DWT_MASK_MASK_Msk (0x1FUL /*<< DWT_MASK_MASK_Pos*/) /*!< DWT MASK: MASK Mask */ + +/* DWT Comparator Function Register Definitions */ +#define DWT_FUNCTION_MATCHED_Pos 24U /*!< DWT FUNCTION: MATCHED Position */ +#define DWT_FUNCTION_MATCHED_Msk (0x1UL << DWT_FUNCTION_MATCHED_Pos) /*!< DWT FUNCTION: MATCHED Mask */ + +#define DWT_FUNCTION_DATAVADDR1_Pos 16U /*!< DWT FUNCTION: DATAVADDR1 Position */ +#define DWT_FUNCTION_DATAVADDR1_Msk (0xFUL << DWT_FUNCTION_DATAVADDR1_Pos) /*!< DWT FUNCTION: DATAVADDR1 Mask */ + +#define DWT_FUNCTION_DATAVADDR0_Pos 12U /*!< DWT FUNCTION: DATAVADDR0 Position */ +#define DWT_FUNCTION_DATAVADDR0_Msk (0xFUL << DWT_FUNCTION_DATAVADDR0_Pos) /*!< DWT FUNCTION: DATAVADDR0 Mask */ + +#define DWT_FUNCTION_DATAVSIZE_Pos 10U /*!< DWT FUNCTION: DATAVSIZE Position */ +#define DWT_FUNCTION_DATAVSIZE_Msk (0x3UL << DWT_FUNCTION_DATAVSIZE_Pos) /*!< DWT FUNCTION: DATAVSIZE Mask */ + +#define DWT_FUNCTION_LNK1ENA_Pos 9U /*!< DWT FUNCTION: LNK1ENA Position */ +#define DWT_FUNCTION_LNK1ENA_Msk (0x1UL << DWT_FUNCTION_LNK1ENA_Pos) /*!< DWT FUNCTION: LNK1ENA Mask */ + +#define DWT_FUNCTION_DATAVMATCH_Pos 8U /*!< DWT FUNCTION: DATAVMATCH Position */ +#define DWT_FUNCTION_DATAVMATCH_Msk (0x1UL << DWT_FUNCTION_DATAVMATCH_Pos) /*!< DWT FUNCTION: DATAVMATCH Mask */ + +#define DWT_FUNCTION_CYCMATCH_Pos 7U /*!< DWT FUNCTION: CYCMATCH Position */ +#define DWT_FUNCTION_CYCMATCH_Msk (0x1UL << DWT_FUNCTION_CYCMATCH_Pos) /*!< DWT FUNCTION: CYCMATCH Mask */ + +#define DWT_FUNCTION_EMITRANGE_Pos 5U /*!< DWT FUNCTION: EMITRANGE Position */ +#define DWT_FUNCTION_EMITRANGE_Msk (0x1UL << DWT_FUNCTION_EMITRANGE_Pos) /*!< DWT FUNCTION: EMITRANGE Mask */ + +#define DWT_FUNCTION_FUNCTION_Pos 0U /*!< DWT FUNCTION: FUNCTION Position */ +#define DWT_FUNCTION_FUNCTION_Msk (0xFUL /*<< DWT_FUNCTION_FUNCTION_Pos*/) /*!< DWT FUNCTION: FUNCTION Mask */ + +/*@}*/ /* end of group CMSIS_DWT */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_TPI Trace Port Interface (TPI) + \brief Type definitions for the Trace Port Interface (TPI) + @{ + */ + +/** + \brief Structure type to access the Trace Port Interface Register (TPI). + */ +typedef struct +{ + __IOM uint32_t SSPSR; /*!< Offset: 0x000 (R/ ) Supported Parallel Port Size Register */ + __IOM uint32_t CSPSR; /*!< Offset: 0x004 (R/W) Current Parallel Port Size Register */ + uint32_t RESERVED0[2U]; + __IOM uint32_t ACPR; /*!< Offset: 0x010 (R/W) Asynchronous Clock Prescaler Register */ + uint32_t RESERVED1[55U]; + __IOM uint32_t SPPR; /*!< Offset: 0x0F0 (R/W) Selected Pin Protocol Register */ + uint32_t RESERVED2[131U]; + __IM uint32_t FFSR; /*!< Offset: 0x300 (R/ ) Formatter and Flush Status Register */ + __IOM uint32_t FFCR; /*!< Offset: 0x304 (R/W) Formatter and Flush Control Register */ + __IM uint32_t FSCR; /*!< Offset: 0x308 (R/ ) Formatter Synchronization Counter Register */ + uint32_t RESERVED3[759U]; + __IM uint32_t TRIGGER; /*!< Offset: 0xEE8 (R/ ) TRIGGER */ + __IM uint32_t FIFO0; /*!< Offset: 0xEEC (R/ ) Integration ETM Data */ + __IM uint32_t ITATBCTR2; /*!< Offset: 0xEF0 (R/ ) ITATBCTR2 */ + uint32_t RESERVED4[1U]; + __IM uint32_t ITATBCTR0; /*!< Offset: 0xEF8 (R/ ) ITATBCTR0 */ + __IM uint32_t FIFO1; /*!< Offset: 0xEFC (R/ ) Integration ITM Data */ + __IOM uint32_t ITCTRL; /*!< Offset: 0xF00 (R/W) Integration Mode Control */ + uint32_t RESERVED5[39U]; + __IOM uint32_t CLAIMSET; /*!< Offset: 0xFA0 (R/W) Claim tag set */ + __IOM uint32_t CLAIMCLR; /*!< Offset: 0xFA4 (R/W) Claim tag clear */ + uint32_t RESERVED7[8U]; + __IM uint32_t DEVID; /*!< Offset: 0xFC8 (R/ ) TPIU_DEVID */ + __IM uint32_t DEVTYPE; /*!< Offset: 0xFCC (R/ ) TPIU_DEVTYPE */ +} TPI_Type; + +/* TPI Asynchronous Clock Prescaler Register Definitions */ +#define TPI_ACPR_PRESCALER_Pos 0U /*!< TPI ACPR: PRESCALER Position */ +#define TPI_ACPR_PRESCALER_Msk (0x1FFFUL /*<< TPI_ACPR_PRESCALER_Pos*/) /*!< TPI ACPR: PRESCALER Mask */ + +/* TPI Selected Pin Protocol Register Definitions */ +#define TPI_SPPR_TXMODE_Pos 0U /*!< TPI SPPR: TXMODE Position */ +#define TPI_SPPR_TXMODE_Msk (0x3UL /*<< TPI_SPPR_TXMODE_Pos*/) /*!< TPI SPPR: TXMODE Mask */ + +/* TPI Formatter and Flush Status Register Definitions */ +#define TPI_FFSR_FtNonStop_Pos 3U /*!< TPI FFSR: FtNonStop Position */ +#define TPI_FFSR_FtNonStop_Msk (0x1UL << TPI_FFSR_FtNonStop_Pos) /*!< TPI FFSR: FtNonStop Mask */ + +#define TPI_FFSR_TCPresent_Pos 2U /*!< TPI FFSR: TCPresent Position */ +#define TPI_FFSR_TCPresent_Msk (0x1UL << TPI_FFSR_TCPresent_Pos) /*!< TPI FFSR: TCPresent Mask */ + +#define TPI_FFSR_FtStopped_Pos 1U /*!< TPI FFSR: FtStopped Position */ +#define TPI_FFSR_FtStopped_Msk (0x1UL << TPI_FFSR_FtStopped_Pos) /*!< TPI FFSR: FtStopped Mask */ + +#define TPI_FFSR_FlInProg_Pos 0U /*!< TPI FFSR: FlInProg Position */ +#define TPI_FFSR_FlInProg_Msk (0x1UL /*<< TPI_FFSR_FlInProg_Pos*/) /*!< TPI FFSR: FlInProg Mask */ + +/* TPI Formatter and Flush Control Register Definitions */ +#define TPI_FFCR_TrigIn_Pos 8U /*!< TPI FFCR: TrigIn Position */ +#define TPI_FFCR_TrigIn_Msk (0x1UL << TPI_FFCR_TrigIn_Pos) /*!< TPI FFCR: TrigIn Mask */ + +#define TPI_FFCR_EnFCont_Pos 1U /*!< TPI FFCR: EnFCont Position */ +#define TPI_FFCR_EnFCont_Msk (0x1UL << TPI_FFCR_EnFCont_Pos) /*!< TPI FFCR: EnFCont Mask */ + +/* TPI TRIGGER Register Definitions */ +#define TPI_TRIGGER_TRIGGER_Pos 0U /*!< TPI TRIGGER: TRIGGER Position */ +#define TPI_TRIGGER_TRIGGER_Msk (0x1UL /*<< TPI_TRIGGER_TRIGGER_Pos*/) /*!< TPI TRIGGER: TRIGGER Mask */ + +/* TPI Integration ETM Data Register Definitions (FIFO0) */ +#define TPI_FIFO0_ITM_ATVALID_Pos 29U /*!< TPI FIFO0: ITM_ATVALID Position */ +#define TPI_FIFO0_ITM_ATVALID_Msk (0x3UL << TPI_FIFO0_ITM_ATVALID_Pos) /*!< TPI FIFO0: ITM_ATVALID Mask */ + +#define TPI_FIFO0_ITM_bytecount_Pos 27U /*!< TPI FIFO0: ITM_bytecount Position */ +#define TPI_FIFO0_ITM_bytecount_Msk (0x3UL << TPI_FIFO0_ITM_bytecount_Pos) /*!< TPI FIFO0: ITM_bytecount Mask */ + +#define TPI_FIFO0_ETM_ATVALID_Pos 26U /*!< TPI FIFO0: ETM_ATVALID Position */ +#define TPI_FIFO0_ETM_ATVALID_Msk (0x3UL << TPI_FIFO0_ETM_ATVALID_Pos) /*!< TPI FIFO0: ETM_ATVALID Mask */ + +#define TPI_FIFO0_ETM_bytecount_Pos 24U /*!< TPI FIFO0: ETM_bytecount Position */ +#define TPI_FIFO0_ETM_bytecount_Msk (0x3UL << TPI_FIFO0_ETM_bytecount_Pos) /*!< TPI FIFO0: ETM_bytecount Mask */ + +#define TPI_FIFO0_ETM2_Pos 16U /*!< TPI FIFO0: ETM2 Position */ +#define TPI_FIFO0_ETM2_Msk (0xFFUL << TPI_FIFO0_ETM2_Pos) /*!< TPI FIFO0: ETM2 Mask */ + +#define TPI_FIFO0_ETM1_Pos 8U /*!< TPI FIFO0: ETM1 Position */ +#define TPI_FIFO0_ETM1_Msk (0xFFUL << TPI_FIFO0_ETM1_Pos) /*!< TPI FIFO0: ETM1 Mask */ + +#define TPI_FIFO0_ETM0_Pos 0U /*!< TPI FIFO0: ETM0 Position */ +#define TPI_FIFO0_ETM0_Msk (0xFFUL /*<< TPI_FIFO0_ETM0_Pos*/) /*!< TPI FIFO0: ETM0 Mask */ + +/* TPI ITATBCTR2 Register Definitions */ +#define TPI_ITATBCTR2_ATREADY_Pos 0U /*!< TPI ITATBCTR2: ATREADY Position */ +#define TPI_ITATBCTR2_ATREADY_Msk (0x1UL /*<< TPI_ITATBCTR2_ATREADY_Pos*/) /*!< TPI ITATBCTR2: ATREADY Mask */ + +/* TPI Integration ITM Data Register Definitions (FIFO1) */ +#define TPI_FIFO1_ITM_ATVALID_Pos 29U /*!< TPI FIFO1: ITM_ATVALID Position */ +#define TPI_FIFO1_ITM_ATVALID_Msk (0x3UL << TPI_FIFO1_ITM_ATVALID_Pos) /*!< TPI FIFO1: ITM_ATVALID Mask */ + +#define TPI_FIFO1_ITM_bytecount_Pos 27U /*!< TPI FIFO1: ITM_bytecount Position */ +#define TPI_FIFO1_ITM_bytecount_Msk (0x3UL << TPI_FIFO1_ITM_bytecount_Pos) /*!< TPI FIFO1: ITM_bytecount Mask */ + +#define TPI_FIFO1_ETM_ATVALID_Pos 26U /*!< TPI FIFO1: ETM_ATVALID Position */ +#define TPI_FIFO1_ETM_ATVALID_Msk (0x3UL << TPI_FIFO1_ETM_ATVALID_Pos) /*!< TPI FIFO1: ETM_ATVALID Mask */ + +#define TPI_FIFO1_ETM_bytecount_Pos 24U /*!< TPI FIFO1: ETM_bytecount Position */ +#define TPI_FIFO1_ETM_bytecount_Msk (0x3UL << TPI_FIFO1_ETM_bytecount_Pos) /*!< TPI FIFO1: ETM_bytecount Mask */ + +#define TPI_FIFO1_ITM2_Pos 16U /*!< TPI FIFO1: ITM2 Position */ +#define TPI_FIFO1_ITM2_Msk (0xFFUL << TPI_FIFO1_ITM2_Pos) /*!< TPI FIFO1: ITM2 Mask */ + +#define TPI_FIFO1_ITM1_Pos 8U /*!< TPI FIFO1: ITM1 Position */ +#define TPI_FIFO1_ITM1_Msk (0xFFUL << TPI_FIFO1_ITM1_Pos) /*!< TPI FIFO1: ITM1 Mask */ + +#define TPI_FIFO1_ITM0_Pos 0U /*!< TPI FIFO1: ITM0 Position */ +#define TPI_FIFO1_ITM0_Msk (0xFFUL /*<< TPI_FIFO1_ITM0_Pos*/) /*!< TPI FIFO1: ITM0 Mask */ + +/* TPI ITATBCTR0 Register Definitions */ +#define TPI_ITATBCTR0_ATREADY_Pos 0U /*!< TPI ITATBCTR0: ATREADY Position */ +#define TPI_ITATBCTR0_ATREADY_Msk (0x1UL /*<< TPI_ITATBCTR0_ATREADY_Pos*/) /*!< TPI ITATBCTR0: ATREADY Mask */ + +/* TPI Integration Mode Control Register Definitions */ +#define TPI_ITCTRL_Mode_Pos 0U /*!< TPI ITCTRL: Mode Position */ +#define TPI_ITCTRL_Mode_Msk (0x1UL /*<< TPI_ITCTRL_Mode_Pos*/) /*!< TPI ITCTRL: Mode Mask */ + +/* TPI DEVID Register Definitions */ +#define TPI_DEVID_NRZVALID_Pos 11U /*!< TPI DEVID: NRZVALID Position */ +#define TPI_DEVID_NRZVALID_Msk (0x1UL << TPI_DEVID_NRZVALID_Pos) /*!< TPI DEVID: NRZVALID Mask */ + +#define TPI_DEVID_MANCVALID_Pos 10U /*!< TPI DEVID: MANCVALID Position */ +#define TPI_DEVID_MANCVALID_Msk (0x1UL << TPI_DEVID_MANCVALID_Pos) /*!< TPI DEVID: MANCVALID Mask */ + +#define TPI_DEVID_PTINVALID_Pos 9U /*!< TPI DEVID: PTINVALID Position */ +#define TPI_DEVID_PTINVALID_Msk (0x1UL << TPI_DEVID_PTINVALID_Pos) /*!< TPI DEVID: PTINVALID Mask */ + +#define TPI_DEVID_MinBufSz_Pos 6U /*!< TPI DEVID: MinBufSz Position */ +#define TPI_DEVID_MinBufSz_Msk (0x7UL << TPI_DEVID_MinBufSz_Pos) /*!< TPI DEVID: MinBufSz Mask */ + +#define TPI_DEVID_AsynClkIn_Pos 5U /*!< TPI DEVID: AsynClkIn Position */ +#define TPI_DEVID_AsynClkIn_Msk (0x1UL << TPI_DEVID_AsynClkIn_Pos) /*!< TPI DEVID: AsynClkIn Mask */ + +#define TPI_DEVID_NrTraceInput_Pos 0U /*!< TPI DEVID: NrTraceInput Position */ +#define TPI_DEVID_NrTraceInput_Msk (0x1FUL /*<< TPI_DEVID_NrTraceInput_Pos*/) /*!< TPI DEVID: NrTraceInput Mask */ + +/* TPI DEVTYPE Register Definitions */ +#define TPI_DEVTYPE_MajorType_Pos 4U /*!< TPI DEVTYPE: MajorType Position */ +#define TPI_DEVTYPE_MajorType_Msk (0xFUL << TPI_DEVTYPE_MajorType_Pos) /*!< TPI DEVTYPE: MajorType Mask */ + +#define TPI_DEVTYPE_SubType_Pos 0U /*!< TPI DEVTYPE: SubType Position */ +#define TPI_DEVTYPE_SubType_Msk (0xFUL /*<< TPI_DEVTYPE_SubType_Pos*/) /*!< TPI DEVTYPE: SubType Mask */ + +/*@}*/ /* end of group CMSIS_TPI */ + + +#if (__MPU_PRESENT == 1U) +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_MPU Memory Protection Unit (MPU) + \brief Type definitions for the Memory Protection Unit (MPU) + @{ + */ + +/** + \brief Structure type to access the Memory Protection Unit (MPU). + */ +typedef struct +{ + __IM uint32_t TYPE; /*!< Offset: 0x000 (R/ ) MPU Type Register */ + __IOM uint32_t CTRL; /*!< Offset: 0x004 (R/W) MPU Control Register */ + __IOM uint32_t RNR; /*!< Offset: 0x008 (R/W) MPU Region RNRber Register */ + __IOM uint32_t RBAR; /*!< Offset: 0x00C (R/W) MPU Region Base Address Register */ + __IOM uint32_t RASR; /*!< Offset: 0x010 (R/W) MPU Region Attribute and Size Register */ + __IOM uint32_t RBAR_A1; /*!< Offset: 0x014 (R/W) MPU Alias 1 Region Base Address Register */ + __IOM uint32_t RASR_A1; /*!< Offset: 0x018 (R/W) MPU Alias 1 Region Attribute and Size Register */ + __IOM uint32_t RBAR_A2; /*!< Offset: 0x01C (R/W) MPU Alias 2 Region Base Address Register */ + __IOM uint32_t RASR_A2; /*!< Offset: 0x020 (R/W) MPU Alias 2 Region Attribute and Size Register */ + __IOM uint32_t RBAR_A3; /*!< Offset: 0x024 (R/W) MPU Alias 3 Region Base Address Register */ + __IOM uint32_t RASR_A3; /*!< Offset: 0x028 (R/W) MPU Alias 3 Region Attribute and Size Register */ +} MPU_Type; + +/* MPU Type Register Definitions */ +#define MPU_TYPE_IREGION_Pos 16U /*!< MPU TYPE: IREGION Position */ +#define MPU_TYPE_IREGION_Msk (0xFFUL << MPU_TYPE_IREGION_Pos) /*!< MPU TYPE: IREGION Mask */ + +#define MPU_TYPE_DREGION_Pos 8U /*!< MPU TYPE: DREGION Position */ +#define MPU_TYPE_DREGION_Msk (0xFFUL << MPU_TYPE_DREGION_Pos) /*!< MPU TYPE: DREGION Mask */ + +#define MPU_TYPE_SEPARATE_Pos 0U /*!< MPU TYPE: SEPARATE Position */ +#define MPU_TYPE_SEPARATE_Msk (1UL /*<< MPU_TYPE_SEPARATE_Pos*/) /*!< MPU TYPE: SEPARATE Mask */ + +/* MPU Control Register Definitions */ +#define MPU_CTRL_PRIVDEFENA_Pos 2U /*!< MPU CTRL: PRIVDEFENA Position */ +#define MPU_CTRL_PRIVDEFENA_Msk (1UL << MPU_CTRL_PRIVDEFENA_Pos) /*!< MPU CTRL: PRIVDEFENA Mask */ + +#define MPU_CTRL_HFNMIENA_Pos 1U /*!< MPU CTRL: HFNMIENA Position */ +#define MPU_CTRL_HFNMIENA_Msk (1UL << MPU_CTRL_HFNMIENA_Pos) /*!< MPU CTRL: HFNMIENA Mask */ + +#define MPU_CTRL_ENABLE_Pos 0U /*!< MPU CTRL: ENABLE Position */ +#define MPU_CTRL_ENABLE_Msk (1UL /*<< MPU_CTRL_ENABLE_Pos*/) /*!< MPU CTRL: ENABLE Mask */ + +/* MPU Region Number Register Definitions */ +#define MPU_RNR_REGION_Pos 0U /*!< MPU RNR: REGION Position */ +#define MPU_RNR_REGION_Msk (0xFFUL /*<< MPU_RNR_REGION_Pos*/) /*!< MPU RNR: REGION Mask */ + +/* MPU Region Base Address Register Definitions */ +#define MPU_RBAR_ADDR_Pos 5U /*!< MPU RBAR: ADDR Position */ +#define MPU_RBAR_ADDR_Msk (0x7FFFFFFUL << MPU_RBAR_ADDR_Pos) /*!< MPU RBAR: ADDR Mask */ + +#define MPU_RBAR_VALID_Pos 4U /*!< MPU RBAR: VALID Position */ +#define MPU_RBAR_VALID_Msk (1UL << MPU_RBAR_VALID_Pos) /*!< MPU RBAR: VALID Mask */ + +#define MPU_RBAR_REGION_Pos 0U /*!< MPU RBAR: REGION Position */ +#define MPU_RBAR_REGION_Msk (0xFUL /*<< MPU_RBAR_REGION_Pos*/) /*!< MPU RBAR: REGION Mask */ + +/* MPU Region Attribute and Size Register Definitions */ +#define MPU_RASR_ATTRS_Pos 16U /*!< MPU RASR: MPU Region Attribute field Position */ +#define MPU_RASR_ATTRS_Msk (0xFFFFUL << MPU_RASR_ATTRS_Pos) /*!< MPU RASR: MPU Region Attribute field Mask */ + +#define MPU_RASR_XN_Pos 28U /*!< MPU RASR: ATTRS.XN Position */ +#define MPU_RASR_XN_Msk (1UL << MPU_RASR_XN_Pos) /*!< MPU RASR: ATTRS.XN Mask */ + +#define MPU_RASR_AP_Pos 24U /*!< MPU RASR: ATTRS.AP Position */ +#define MPU_RASR_AP_Msk (0x7UL << MPU_RASR_AP_Pos) /*!< MPU RASR: ATTRS.AP Mask */ + +#define MPU_RASR_TEX_Pos 19U /*!< MPU RASR: ATTRS.TEX Position */ +#define MPU_RASR_TEX_Msk (0x7UL << MPU_RASR_TEX_Pos) /*!< MPU RASR: ATTRS.TEX Mask */ + +#define MPU_RASR_S_Pos 18U /*!< MPU RASR: ATTRS.S Position */ +#define MPU_RASR_S_Msk (1UL << MPU_RASR_S_Pos) /*!< MPU RASR: ATTRS.S Mask */ + +#define MPU_RASR_C_Pos 17U /*!< MPU RASR: ATTRS.C Position */ +#define MPU_RASR_C_Msk (1UL << MPU_RASR_C_Pos) /*!< MPU RASR: ATTRS.C Mask */ + +#define MPU_RASR_B_Pos 16U /*!< MPU RASR: ATTRS.B Position */ +#define MPU_RASR_B_Msk (1UL << MPU_RASR_B_Pos) /*!< MPU RASR: ATTRS.B Mask */ + +#define MPU_RASR_SRD_Pos 8U /*!< MPU RASR: Sub-Region Disable Position */ +#define MPU_RASR_SRD_Msk (0xFFUL << MPU_RASR_SRD_Pos) /*!< MPU RASR: Sub-Region Disable Mask */ + +#define MPU_RASR_SIZE_Pos 1U /*!< MPU RASR: Region Size Field Position */ +#define MPU_RASR_SIZE_Msk (0x1FUL << MPU_RASR_SIZE_Pos) /*!< MPU RASR: Region Size Field Mask */ + +#define MPU_RASR_ENABLE_Pos 0U /*!< MPU RASR: Region enable bit Position */ +#define MPU_RASR_ENABLE_Msk (1UL /*<< MPU_RASR_ENABLE_Pos*/) /*!< MPU RASR: Region enable bit Disable Mask */ + +/*@} end of group CMSIS_MPU */ +#endif + + +#if (__FPU_PRESENT == 1U) +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_FPU Floating Point Unit (FPU) + \brief Type definitions for the Floating Point Unit (FPU) + @{ + */ + +/** + \brief Structure type to access the Floating Point Unit (FPU). + */ +typedef struct +{ + uint32_t RESERVED0[1U]; + __IOM uint32_t FPCCR; /*!< Offset: 0x004 (R/W) Floating-Point Context Control Register */ + __IOM uint32_t FPCAR; /*!< Offset: 0x008 (R/W) Floating-Point Context Address Register */ + __IOM uint32_t FPDSCR; /*!< Offset: 0x00C (R/W) Floating-Point Default Status Control Register */ + __IM uint32_t MVFR0; /*!< Offset: 0x010 (R/ ) Media and FP Feature Register 0 */ + __IM uint32_t MVFR1; /*!< Offset: 0x014 (R/ ) Media and FP Feature Register 1 */ + __IM uint32_t MVFR2; /*!< Offset: 0x018 (R/ ) Media and FP Feature Register 2 */ +} FPU_Type; + +/* Floating-Point Context Control Register Definitions */ +#define FPU_FPCCR_ASPEN_Pos 31U /*!< FPCCR: ASPEN bit Position */ +#define FPU_FPCCR_ASPEN_Msk (1UL << FPU_FPCCR_ASPEN_Pos) /*!< FPCCR: ASPEN bit Mask */ + +#define FPU_FPCCR_LSPEN_Pos 30U /*!< FPCCR: LSPEN Position */ +#define FPU_FPCCR_LSPEN_Msk (1UL << FPU_FPCCR_LSPEN_Pos) /*!< FPCCR: LSPEN bit Mask */ + +#define FPU_FPCCR_MONRDY_Pos 8U /*!< FPCCR: MONRDY Position */ +#define FPU_FPCCR_MONRDY_Msk (1UL << FPU_FPCCR_MONRDY_Pos) /*!< FPCCR: MONRDY bit Mask */ + +#define FPU_FPCCR_BFRDY_Pos 6U /*!< FPCCR: BFRDY Position */ +#define FPU_FPCCR_BFRDY_Msk (1UL << FPU_FPCCR_BFRDY_Pos) /*!< FPCCR: BFRDY bit Mask */ + +#define FPU_FPCCR_MMRDY_Pos 5U /*!< FPCCR: MMRDY Position */ +#define FPU_FPCCR_MMRDY_Msk (1UL << FPU_FPCCR_MMRDY_Pos) /*!< FPCCR: MMRDY bit Mask */ + +#define FPU_FPCCR_HFRDY_Pos 4U /*!< FPCCR: HFRDY Position */ +#define FPU_FPCCR_HFRDY_Msk (1UL << FPU_FPCCR_HFRDY_Pos) /*!< FPCCR: HFRDY bit Mask */ + +#define FPU_FPCCR_THREAD_Pos 3U /*!< FPCCR: processor mode bit Position */ +#define FPU_FPCCR_THREAD_Msk (1UL << FPU_FPCCR_THREAD_Pos) /*!< FPCCR: processor mode active bit Mask */ + +#define FPU_FPCCR_USER_Pos 1U /*!< FPCCR: privilege level bit Position */ +#define FPU_FPCCR_USER_Msk (1UL << FPU_FPCCR_USER_Pos) /*!< FPCCR: privilege level bit Mask */ + +#define FPU_FPCCR_LSPACT_Pos 0U /*!< FPCCR: Lazy state preservation active bit Position */ +#define FPU_FPCCR_LSPACT_Msk (1UL /*<< FPU_FPCCR_LSPACT_Pos*/) /*!< FPCCR: Lazy state preservation active bit Mask */ + +/* Floating-Point Context Address Register Definitions */ +#define FPU_FPCAR_ADDRESS_Pos 3U /*!< FPCAR: ADDRESS bit Position */ +#define FPU_FPCAR_ADDRESS_Msk (0x1FFFFFFFUL << FPU_FPCAR_ADDRESS_Pos) /*!< FPCAR: ADDRESS bit Mask */ + +/* Floating-Point Default Status Control Register Definitions */ +#define FPU_FPDSCR_AHP_Pos 26U /*!< FPDSCR: AHP bit Position */ +#define FPU_FPDSCR_AHP_Msk (1UL << FPU_FPDSCR_AHP_Pos) /*!< FPDSCR: AHP bit Mask */ + +#define FPU_FPDSCR_DN_Pos 25U /*!< FPDSCR: DN bit Position */ +#define FPU_FPDSCR_DN_Msk (1UL << FPU_FPDSCR_DN_Pos) /*!< FPDSCR: DN bit Mask */ + +#define FPU_FPDSCR_FZ_Pos 24U /*!< FPDSCR: FZ bit Position */ +#define FPU_FPDSCR_FZ_Msk (1UL << FPU_FPDSCR_FZ_Pos) /*!< FPDSCR: FZ bit Mask */ + +#define FPU_FPDSCR_RMode_Pos 22U /*!< FPDSCR: RMode bit Position */ +#define FPU_FPDSCR_RMode_Msk (3UL << FPU_FPDSCR_RMode_Pos) /*!< FPDSCR: RMode bit Mask */ + +/* Media and FP Feature Register 0 Definitions */ +#define FPU_MVFR0_FP_rounding_modes_Pos 28U /*!< MVFR0: FP rounding modes bits Position */ +#define FPU_MVFR0_FP_rounding_modes_Msk (0xFUL << FPU_MVFR0_FP_rounding_modes_Pos) /*!< MVFR0: FP rounding modes bits Mask */ + +#define FPU_MVFR0_Short_vectors_Pos 24U /*!< MVFR0: Short vectors bits Position */ +#define FPU_MVFR0_Short_vectors_Msk (0xFUL << FPU_MVFR0_Short_vectors_Pos) /*!< MVFR0: Short vectors bits Mask */ + +#define FPU_MVFR0_Square_root_Pos 20U /*!< MVFR0: Square root bits Position */ +#define FPU_MVFR0_Square_root_Msk (0xFUL << FPU_MVFR0_Square_root_Pos) /*!< MVFR0: Square root bits Mask */ + +#define FPU_MVFR0_Divide_Pos 16U /*!< MVFR0: Divide bits Position */ +#define FPU_MVFR0_Divide_Msk (0xFUL << FPU_MVFR0_Divide_Pos) /*!< MVFR0: Divide bits Mask */ + +#define FPU_MVFR0_FP_excep_trapping_Pos 12U /*!< MVFR0: FP exception trapping bits Position */ +#define FPU_MVFR0_FP_excep_trapping_Msk (0xFUL << FPU_MVFR0_FP_excep_trapping_Pos) /*!< MVFR0: FP exception trapping bits Mask */ + +#define FPU_MVFR0_Double_precision_Pos 8U /*!< MVFR0: Double-precision bits Position */ +#define FPU_MVFR0_Double_precision_Msk (0xFUL << FPU_MVFR0_Double_precision_Pos) /*!< MVFR0: Double-precision bits Mask */ + +#define FPU_MVFR0_Single_precision_Pos 4U /*!< MVFR0: Single-precision bits Position */ +#define FPU_MVFR0_Single_precision_Msk (0xFUL << FPU_MVFR0_Single_precision_Pos) /*!< MVFR0: Single-precision bits Mask */ + +#define FPU_MVFR0_A_SIMD_registers_Pos 0U /*!< MVFR0: A_SIMD registers bits Position */ +#define FPU_MVFR0_A_SIMD_registers_Msk (0xFUL /*<< FPU_MVFR0_A_SIMD_registers_Pos*/) /*!< MVFR0: A_SIMD registers bits Mask */ + +/* Media and FP Feature Register 1 Definitions */ +#define FPU_MVFR1_FP_fused_MAC_Pos 28U /*!< MVFR1: FP fused MAC bits Position */ +#define FPU_MVFR1_FP_fused_MAC_Msk (0xFUL << FPU_MVFR1_FP_fused_MAC_Pos) /*!< MVFR1: FP fused MAC bits Mask */ + +#define FPU_MVFR1_FP_HPFP_Pos 24U /*!< MVFR1: FP HPFP bits Position */ +#define FPU_MVFR1_FP_HPFP_Msk (0xFUL << FPU_MVFR1_FP_HPFP_Pos) /*!< MVFR1: FP HPFP bits Mask */ + +#define FPU_MVFR1_D_NaN_mode_Pos 4U /*!< MVFR1: D_NaN mode bits Position */ +#define FPU_MVFR1_D_NaN_mode_Msk (0xFUL << FPU_MVFR1_D_NaN_mode_Pos) /*!< MVFR1: D_NaN mode bits Mask */ + +#define FPU_MVFR1_FtZ_mode_Pos 0U /*!< MVFR1: FtZ mode bits Position */ +#define FPU_MVFR1_FtZ_mode_Msk (0xFUL /*<< FPU_MVFR1_FtZ_mode_Pos*/) /*!< MVFR1: FtZ mode bits Mask */ + +/* Media and FP Feature Register 2 Definitions */ + +/*@} end of group CMSIS_FPU */ +#endif + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_CoreDebug Core Debug Registers (CoreDebug) + \brief Type definitions for the Core Debug Registers + @{ + */ + +/** + \brief Structure type to access the Core Debug Register (CoreDebug). + */ +typedef struct +{ + __IOM uint32_t DHCSR; /*!< Offset: 0x000 (R/W) Debug Halting Control and Status Register */ + __OM uint32_t DCRSR; /*!< Offset: 0x004 ( /W) Debug Core Register Selector Register */ + __IOM uint32_t DCRDR; /*!< Offset: 0x008 (R/W) Debug Core Register Data Register */ + __IOM uint32_t DEMCR; /*!< Offset: 0x00C (R/W) Debug Exception and Monitor Control Register */ +} CoreDebug_Type; + +/* Debug Halting Control and Status Register Definitions */ +#define CoreDebug_DHCSR_DBGKEY_Pos 16U /*!< CoreDebug DHCSR: DBGKEY Position */ +#define CoreDebug_DHCSR_DBGKEY_Msk (0xFFFFUL << CoreDebug_DHCSR_DBGKEY_Pos) /*!< CoreDebug DHCSR: DBGKEY Mask */ + +#define CoreDebug_DHCSR_S_RESET_ST_Pos 25U /*!< CoreDebug DHCSR: S_RESET_ST Position */ +#define CoreDebug_DHCSR_S_RESET_ST_Msk (1UL << CoreDebug_DHCSR_S_RESET_ST_Pos) /*!< CoreDebug DHCSR: S_RESET_ST Mask */ + +#define CoreDebug_DHCSR_S_RETIRE_ST_Pos 24U /*!< CoreDebug DHCSR: S_RETIRE_ST Position */ +#define CoreDebug_DHCSR_S_RETIRE_ST_Msk (1UL << CoreDebug_DHCSR_S_RETIRE_ST_Pos) /*!< CoreDebug DHCSR: S_RETIRE_ST Mask */ + +#define CoreDebug_DHCSR_S_LOCKUP_Pos 19U /*!< CoreDebug DHCSR: S_LOCKUP Position */ +#define CoreDebug_DHCSR_S_LOCKUP_Msk (1UL << CoreDebug_DHCSR_S_LOCKUP_Pos) /*!< CoreDebug DHCSR: S_LOCKUP Mask */ + +#define CoreDebug_DHCSR_S_SLEEP_Pos 18U /*!< CoreDebug DHCSR: S_SLEEP Position */ +#define CoreDebug_DHCSR_S_SLEEP_Msk (1UL << CoreDebug_DHCSR_S_SLEEP_Pos) /*!< CoreDebug DHCSR: S_SLEEP Mask */ + +#define CoreDebug_DHCSR_S_HALT_Pos 17U /*!< CoreDebug DHCSR: S_HALT Position */ +#define CoreDebug_DHCSR_S_HALT_Msk (1UL << CoreDebug_DHCSR_S_HALT_Pos) /*!< CoreDebug DHCSR: S_HALT Mask */ + +#define CoreDebug_DHCSR_S_REGRDY_Pos 16U /*!< CoreDebug DHCSR: S_REGRDY Position */ +#define CoreDebug_DHCSR_S_REGRDY_Msk (1UL << CoreDebug_DHCSR_S_REGRDY_Pos) /*!< CoreDebug DHCSR: S_REGRDY Mask */ + +#define CoreDebug_DHCSR_C_SNAPSTALL_Pos 5U /*!< CoreDebug DHCSR: C_SNAPSTALL Position */ +#define CoreDebug_DHCSR_C_SNAPSTALL_Msk (1UL << CoreDebug_DHCSR_C_SNAPSTALL_Pos) /*!< CoreDebug DHCSR: C_SNAPSTALL Mask */ + +#define CoreDebug_DHCSR_C_MASKINTS_Pos 3U /*!< CoreDebug DHCSR: C_MASKINTS Position */ +#define CoreDebug_DHCSR_C_MASKINTS_Msk (1UL << CoreDebug_DHCSR_C_MASKINTS_Pos) /*!< CoreDebug DHCSR: C_MASKINTS Mask */ + +#define CoreDebug_DHCSR_C_STEP_Pos 2U /*!< CoreDebug DHCSR: C_STEP Position */ +#define CoreDebug_DHCSR_C_STEP_Msk (1UL << CoreDebug_DHCSR_C_STEP_Pos) /*!< CoreDebug DHCSR: C_STEP Mask */ + +#define CoreDebug_DHCSR_C_HALT_Pos 1U /*!< CoreDebug DHCSR: C_HALT Position */ +#define CoreDebug_DHCSR_C_HALT_Msk (1UL << CoreDebug_DHCSR_C_HALT_Pos) /*!< CoreDebug DHCSR: C_HALT Mask */ + +#define CoreDebug_DHCSR_C_DEBUGEN_Pos 0U /*!< CoreDebug DHCSR: C_DEBUGEN Position */ +#define CoreDebug_DHCSR_C_DEBUGEN_Msk (1UL /*<< CoreDebug_DHCSR_C_DEBUGEN_Pos*/) /*!< CoreDebug DHCSR: C_DEBUGEN Mask */ + +/* Debug Core Register Selector Register Definitions */ +#define CoreDebug_DCRSR_REGWnR_Pos 16U /*!< CoreDebug DCRSR: REGWnR Position */ +#define CoreDebug_DCRSR_REGWnR_Msk (1UL << CoreDebug_DCRSR_REGWnR_Pos) /*!< CoreDebug DCRSR: REGWnR Mask */ + +#define CoreDebug_DCRSR_REGSEL_Pos 0U /*!< CoreDebug DCRSR: REGSEL Position */ +#define CoreDebug_DCRSR_REGSEL_Msk (0x1FUL /*<< CoreDebug_DCRSR_REGSEL_Pos*/) /*!< CoreDebug DCRSR: REGSEL Mask */ + +/* Debug Exception and Monitor Control Register Definitions */ +#define CoreDebug_DEMCR_TRCENA_Pos 24U /*!< CoreDebug DEMCR: TRCENA Position */ +#define CoreDebug_DEMCR_TRCENA_Msk (1UL << CoreDebug_DEMCR_TRCENA_Pos) /*!< CoreDebug DEMCR: TRCENA Mask */ + +#define CoreDebug_DEMCR_MON_REQ_Pos 19U /*!< CoreDebug DEMCR: MON_REQ Position */ +#define CoreDebug_DEMCR_MON_REQ_Msk (1UL << CoreDebug_DEMCR_MON_REQ_Pos) /*!< CoreDebug DEMCR: MON_REQ Mask */ + +#define CoreDebug_DEMCR_MON_STEP_Pos 18U /*!< CoreDebug DEMCR: MON_STEP Position */ +#define CoreDebug_DEMCR_MON_STEP_Msk (1UL << CoreDebug_DEMCR_MON_STEP_Pos) /*!< CoreDebug DEMCR: MON_STEP Mask */ + +#define CoreDebug_DEMCR_MON_PEND_Pos 17U /*!< CoreDebug DEMCR: MON_PEND Position */ +#define CoreDebug_DEMCR_MON_PEND_Msk (1UL << CoreDebug_DEMCR_MON_PEND_Pos) /*!< CoreDebug DEMCR: MON_PEND Mask */ + +#define CoreDebug_DEMCR_MON_EN_Pos 16U /*!< CoreDebug DEMCR: MON_EN Position */ +#define CoreDebug_DEMCR_MON_EN_Msk (1UL << CoreDebug_DEMCR_MON_EN_Pos) /*!< CoreDebug DEMCR: MON_EN Mask */ + +#define CoreDebug_DEMCR_VC_HARDERR_Pos 10U /*!< CoreDebug DEMCR: VC_HARDERR Position */ +#define CoreDebug_DEMCR_VC_HARDERR_Msk (1UL << CoreDebug_DEMCR_VC_HARDERR_Pos) /*!< CoreDebug DEMCR: VC_HARDERR Mask */ + +#define CoreDebug_DEMCR_VC_INTERR_Pos 9U /*!< CoreDebug DEMCR: VC_INTERR Position */ +#define CoreDebug_DEMCR_VC_INTERR_Msk (1UL << CoreDebug_DEMCR_VC_INTERR_Pos) /*!< CoreDebug DEMCR: VC_INTERR Mask */ + +#define CoreDebug_DEMCR_VC_BUSERR_Pos 8U /*!< CoreDebug DEMCR: VC_BUSERR Position */ +#define CoreDebug_DEMCR_VC_BUSERR_Msk (1UL << CoreDebug_DEMCR_VC_BUSERR_Pos) /*!< CoreDebug DEMCR: VC_BUSERR Mask */ + +#define CoreDebug_DEMCR_VC_STATERR_Pos 7U /*!< CoreDebug DEMCR: VC_STATERR Position */ +#define CoreDebug_DEMCR_VC_STATERR_Msk (1UL << CoreDebug_DEMCR_VC_STATERR_Pos) /*!< CoreDebug DEMCR: VC_STATERR Mask */ + +#define CoreDebug_DEMCR_VC_CHKERR_Pos 6U /*!< CoreDebug DEMCR: VC_CHKERR Position */ +#define CoreDebug_DEMCR_VC_CHKERR_Msk (1UL << CoreDebug_DEMCR_VC_CHKERR_Pos) /*!< CoreDebug DEMCR: VC_CHKERR Mask */ + +#define CoreDebug_DEMCR_VC_NOCPERR_Pos 5U /*!< CoreDebug DEMCR: VC_NOCPERR Position */ +#define CoreDebug_DEMCR_VC_NOCPERR_Msk (1UL << CoreDebug_DEMCR_VC_NOCPERR_Pos) /*!< CoreDebug DEMCR: VC_NOCPERR Mask */ + +#define CoreDebug_DEMCR_VC_MMERR_Pos 4U /*!< CoreDebug DEMCR: VC_MMERR Position */ +#define CoreDebug_DEMCR_VC_MMERR_Msk (1UL << CoreDebug_DEMCR_VC_MMERR_Pos) /*!< CoreDebug DEMCR: VC_MMERR Mask */ + +#define CoreDebug_DEMCR_VC_CORERESET_Pos 0U /*!< CoreDebug DEMCR: VC_CORERESET Position */ +#define CoreDebug_DEMCR_VC_CORERESET_Msk (1UL /*<< CoreDebug_DEMCR_VC_CORERESET_Pos*/) /*!< CoreDebug DEMCR: VC_CORERESET Mask */ + +/*@} end of group CMSIS_CoreDebug */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_core_bitfield Core register bit field macros + \brief Macros for use with bit field definitions (xxx_Pos, xxx_Msk). + @{ + */ + +/** + \brief Mask and shift a bit field value for use in a register bit range. + \param[in] field Name of the register bit field. + \param[in] value Value of the bit field. + \return Masked and shifted value. +*/ +#define _VAL2FLD(field, value) ((value << field ## _Pos) & field ## _Msk) + +/** + \brief Mask and shift a register value to extract a bit filed value. + \param[in] field Name of the register bit field. + \param[in] value Value of register. + \return Masked and shifted bit field value. +*/ +#define _FLD2VAL(field, value) ((value & field ## _Msk) >> field ## _Pos) + +/*@} end of group CMSIS_core_bitfield */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_core_base Core Definitions + \brief Definitions for base addresses, unions, and structures. + @{ + */ + +/* Memory mapping of Cortex-M4 Hardware */ +#define SCS_BASE (0xE000E000UL) /*!< System Control Space Base Address */ +#define ITM_BASE (0xE0000000UL) /*!< ITM Base Address */ +#define DWT_BASE (0xE0001000UL) /*!< DWT Base Address */ +#define TPI_BASE (0xE0040000UL) /*!< TPI Base Address */ +#define CoreDebug_BASE (0xE000EDF0UL) /*!< Core Debug Base Address */ +#define SysTick_BASE (SCS_BASE + 0x0010UL) /*!< SysTick Base Address */ +#define NVIC_BASE (SCS_BASE + 0x0100UL) /*!< NVIC Base Address */ +#define SCB_BASE (SCS_BASE + 0x0D00UL) /*!< System Control Block Base Address */ + +#define SCnSCB ((SCnSCB_Type *) SCS_BASE ) /*!< System control Register not in SCB */ +#define SCB ((SCB_Type *) SCB_BASE ) /*!< SCB configuration struct */ +#define SysTick ((SysTick_Type *) SysTick_BASE ) /*!< SysTick configuration struct */ +#define NVIC ((NVIC_Type *) NVIC_BASE ) /*!< NVIC configuration struct */ +#define ITM ((ITM_Type *) ITM_BASE ) /*!< ITM configuration struct */ +#define DWT ((DWT_Type *) DWT_BASE ) /*!< DWT configuration struct */ +#define TPI ((TPI_Type *) TPI_BASE ) /*!< TPI configuration struct */ +#define CoreDebug ((CoreDebug_Type *) CoreDebug_BASE) /*!< Core Debug configuration struct */ + +#if (__MPU_PRESENT == 1U) + #define MPU_BASE (SCS_BASE + 0x0D90UL) /*!< Memory Protection Unit */ + #define MPU ((MPU_Type *) MPU_BASE ) /*!< Memory Protection Unit */ +#endif + +#if (__FPU_PRESENT == 1U) + #define FPU_BASE (SCS_BASE + 0x0F30UL) /*!< Floating Point Unit */ + #define FPU ((FPU_Type *) FPU_BASE ) /*!< Floating Point Unit */ +#endif + +/*@} */ + + + +/******************************************************************************* + * Hardware Abstraction Layer + Core Function Interface contains: + - Core NVIC Functions + - Core SysTick Functions + - Core Debug Functions + - Core Register Access Functions + ******************************************************************************/ +/** + \defgroup CMSIS_Core_FunctionInterface Functions and Instructions Reference +*/ + + + +/* ########################## NVIC functions #################################### */ +/** + \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_NVICFunctions NVIC Functions + \brief Functions that manage interrupts and exceptions via the NVIC. + @{ + */ + +/** + \brief Set Priority Grouping + \details Sets the priority grouping field using the required unlock sequence. + The parameter PriorityGroup is assigned to the field SCB->AIRCR [10:8] PRIGROUP field. + Only values from 0..7 are used. + In case of a conflict between priority grouping and available + priority bits (__NVIC_PRIO_BITS), the smallest possible priority group is set. + \param [in] PriorityGroup Priority grouping field. + */ +__STATIC_INLINE void NVIC_SetPriorityGrouping(uint32_t PriorityGroup) +{ + uint32_t reg_value; + uint32_t PriorityGroupTmp = (PriorityGroup & (uint32_t)0x07UL); /* only values 0..7 are used */ + + reg_value = SCB->AIRCR; /* read old register configuration */ + reg_value &= ~((uint32_t)(SCB_AIRCR_VECTKEY_Msk | SCB_AIRCR_PRIGROUP_Msk)); /* clear bits to change */ + reg_value = (reg_value | + ((uint32_t)0x5FAUL << SCB_AIRCR_VECTKEY_Pos) | + (PriorityGroupTmp << 8U) ); /* Insert write key and priorty group */ + SCB->AIRCR = reg_value; +} + + +/** + \brief Get Priority Grouping + \details Reads the priority grouping field from the NVIC Interrupt Controller. + \return Priority grouping field (SCB->AIRCR [10:8] PRIGROUP field). + */ +__STATIC_INLINE uint32_t NVIC_GetPriorityGrouping(void) +{ + return ((uint32_t)((SCB->AIRCR & SCB_AIRCR_PRIGROUP_Msk) >> SCB_AIRCR_PRIGROUP_Pos)); +} + + +/** + \brief Enable External Interrupt + \details Enables a device-specific interrupt in the NVIC interrupt controller. + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_EnableIRQ(IRQn_Type IRQn) +{ + NVIC->ISER[(((uint32_t)(int32_t)IRQn) >> 5UL)] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Disable External Interrupt + \details Disables a device-specific interrupt in the NVIC interrupt controller. + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_DisableIRQ(IRQn_Type IRQn) +{ + NVIC->ICER[(((uint32_t)(int32_t)IRQn) >> 5UL)] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Get Pending Interrupt + \details Reads the pending register in the NVIC and returns the pending bit for the specified interrupt. + \param [in] IRQn Interrupt number. + \return 0 Interrupt status is not pending. + \return 1 Interrupt status is pending. + */ +__STATIC_INLINE uint32_t NVIC_GetPendingIRQ(IRQn_Type IRQn) +{ + return((uint32_t)(((NVIC->ISPR[(((uint32_t)(int32_t)IRQn) >> 5UL)] & (1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL))) != 0UL) ? 1UL : 0UL)); +} + + +/** + \brief Set Pending Interrupt + \details Sets the pending bit of an external interrupt. + \param [in] IRQn Interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_SetPendingIRQ(IRQn_Type IRQn) +{ + NVIC->ISPR[(((uint32_t)(int32_t)IRQn) >> 5UL)] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Clear Pending Interrupt + \details Clears the pending bit of an external interrupt. + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_ClearPendingIRQ(IRQn_Type IRQn) +{ + NVIC->ICPR[(((uint32_t)(int32_t)IRQn) >> 5UL)] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Get Active Interrupt + \details Reads the active register in NVIC and returns the active bit. + \param [in] IRQn Interrupt number. + \return 0 Interrupt status is not active. + \return 1 Interrupt status is active. + */ +__STATIC_INLINE uint32_t NVIC_GetActive(IRQn_Type IRQn) +{ + return((uint32_t)(((NVIC->IABR[(((uint32_t)(int32_t)IRQn) >> 5UL)] & (1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL))) != 0UL) ? 1UL : 0UL)); +} + + +/** + \brief Set Interrupt Priority + \details Sets the priority of an interrupt. + \note The priority cannot be set for every core interrupt. + \param [in] IRQn Interrupt number. + \param [in] priority Priority to set. + */ +__STATIC_INLINE void NVIC_SetPriority(IRQn_Type IRQn, uint32_t priority) +{ + if ((int32_t)(IRQn) < 0) + { + SCB->SHPR[(((uint32_t)(int32_t)IRQn) & 0xFUL)-4UL] = (uint8_t)((priority << (8U - __NVIC_PRIO_BITS)) & (uint32_t)0xFFUL); + } + else + { + NVIC->IP[((uint32_t)(int32_t)IRQn)] = (uint8_t)((priority << (8U - __NVIC_PRIO_BITS)) & (uint32_t)0xFFUL); + } +} + + +/** + \brief Get Interrupt Priority + \details Reads the priority of an interrupt. + The interrupt number can be positive to specify an external (device specific) interrupt, + or negative to specify an internal (core) interrupt. + \param [in] IRQn Interrupt number. + \return Interrupt Priority. + Value is aligned automatically to the implemented priority bits of the microcontroller. + */ +__STATIC_INLINE uint32_t NVIC_GetPriority(IRQn_Type IRQn) +{ + + if ((int32_t)(IRQn) < 0) + { + return(((uint32_t)SCB->SHPR[(((uint32_t)(int32_t)IRQn) & 0xFUL)-4UL] >> (8U - __NVIC_PRIO_BITS))); + } + else + { + return(((uint32_t)NVIC->IP[((uint32_t)(int32_t)IRQn)] >> (8U - __NVIC_PRIO_BITS))); + } +} + + +/** + \brief Encode Priority + \details Encodes the priority for an interrupt with the given priority group, + preemptive priority value, and subpriority value. + In case of a conflict between priority grouping and available + priority bits (__NVIC_PRIO_BITS), the smallest possible priority group is set. + \param [in] PriorityGroup Used priority group. + \param [in] PreemptPriority Preemptive priority value (starting from 0). + \param [in] SubPriority Subpriority value (starting from 0). + \return Encoded priority. Value can be used in the function \ref NVIC_SetPriority(). + */ +__STATIC_INLINE uint32_t NVIC_EncodePriority (uint32_t PriorityGroup, uint32_t PreemptPriority, uint32_t SubPriority) +{ + uint32_t PriorityGroupTmp = (PriorityGroup & (uint32_t)0x07UL); /* only values 0..7 are used */ + uint32_t PreemptPriorityBits; + uint32_t SubPriorityBits; + + PreemptPriorityBits = ((7UL - PriorityGroupTmp) > (uint32_t)(__NVIC_PRIO_BITS)) ? (uint32_t)(__NVIC_PRIO_BITS) : (uint32_t)(7UL - PriorityGroupTmp); + SubPriorityBits = ((PriorityGroupTmp + (uint32_t)(__NVIC_PRIO_BITS)) < (uint32_t)7UL) ? (uint32_t)0UL : (uint32_t)((PriorityGroupTmp - 7UL) + (uint32_t)(__NVIC_PRIO_BITS)); + + return ( + ((PreemptPriority & (uint32_t)((1UL << (PreemptPriorityBits)) - 1UL)) << SubPriorityBits) | + ((SubPriority & (uint32_t)((1UL << (SubPriorityBits )) - 1UL))) + ); +} + + +/** + \brief Decode Priority + \details Decodes an interrupt priority value with a given priority group to + preemptive priority value and subpriority value. + In case of a conflict between priority grouping and available + priority bits (__NVIC_PRIO_BITS) the smallest possible priority group is set. + \param [in] Priority Priority value, which can be retrieved with the function \ref NVIC_GetPriority(). + \param [in] PriorityGroup Used priority group. + \param [out] pPreemptPriority Preemptive priority value (starting from 0). + \param [out] pSubPriority Subpriority value (starting from 0). + */ +__STATIC_INLINE void NVIC_DecodePriority (uint32_t Priority, uint32_t PriorityGroup, uint32_t* const pPreemptPriority, uint32_t* const pSubPriority) +{ + uint32_t PriorityGroupTmp = (PriorityGroup & (uint32_t)0x07UL); /* only values 0..7 are used */ + uint32_t PreemptPriorityBits; + uint32_t SubPriorityBits; + + PreemptPriorityBits = ((7UL - PriorityGroupTmp) > (uint32_t)(__NVIC_PRIO_BITS)) ? (uint32_t)(__NVIC_PRIO_BITS) : (uint32_t)(7UL - PriorityGroupTmp); + SubPriorityBits = ((PriorityGroupTmp + (uint32_t)(__NVIC_PRIO_BITS)) < (uint32_t)7UL) ? (uint32_t)0UL : (uint32_t)((PriorityGroupTmp - 7UL) + (uint32_t)(__NVIC_PRIO_BITS)); + + *pPreemptPriority = (Priority >> SubPriorityBits) & (uint32_t)((1UL << (PreemptPriorityBits)) - 1UL); + *pSubPriority = (Priority ) & (uint32_t)((1UL << (SubPriorityBits )) - 1UL); +} + + +/** + \brief System Reset + \details Initiates a system reset request to reset the MCU. + */ +__STATIC_INLINE void NVIC_SystemReset(void) +{ + __DSB(); /* Ensure all outstanding memory accesses included + buffered write are completed before reset */ + SCB->AIRCR = (uint32_t)((0x5FAUL << SCB_AIRCR_VECTKEY_Pos) | + (SCB->AIRCR & SCB_AIRCR_PRIGROUP_Msk) | + SCB_AIRCR_SYSRESETREQ_Msk ); /* Keep priority group unchanged */ + __DSB(); /* Ensure completion of memory access */ + + for(;;) /* wait until reset */ + { + __NOP(); + } +} + +/*@} end of CMSIS_Core_NVICFunctions */ + + +/* ########################## FPU functions #################################### */ +/** + \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_FpuFunctions FPU Functions + \brief Function that provides FPU type. + @{ + */ + +/** + \brief get FPU type + \details returns the FPU type + \returns + - \b 0: No FPU + - \b 1: Single precision FPU + - \b 2: Double + Single precision FPU + */ +__STATIC_INLINE uint32_t SCB_GetFPUType(void) +{ + uint32_t mvfr0; + + mvfr0 = SCB->MVFR0; + if ((mvfr0 & 0x00000FF0UL) == 0x220UL) + { + return 2UL; /* Double + Single precision FPU */ + } + else if ((mvfr0 & 0x00000FF0UL) == 0x020UL) + { + return 1UL; /* Single precision FPU */ + } + else + { + return 0UL; /* No FPU */ + } +} + + +/*@} end of CMSIS_Core_FpuFunctions */ + + + +/* ########################## Cache functions #################################### */ +/** + \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_CacheFunctions Cache Functions + \brief Functions that configure Instruction and Data cache. + @{ + */ + +/* Cache Size ID Register Macros */ +#define CCSIDR_WAYS(x) (((x) & SCB_CCSIDR_ASSOCIATIVITY_Msk) >> SCB_CCSIDR_ASSOCIATIVITY_Pos) +#define CCSIDR_SETS(x) (((x) & SCB_CCSIDR_NUMSETS_Msk ) >> SCB_CCSIDR_NUMSETS_Pos ) + + +/** + \brief Enable I-Cache + \details Turns on I-Cache + */ +__STATIC_INLINE void SCB_EnableICache (void) +{ + #if (__ICACHE_PRESENT == 1U) + __DSB(); + __ISB(); + SCB->ICIALLU = 0UL; /* invalidate I-Cache */ + SCB->CCR |= (uint32_t)SCB_CCR_IC_Msk; /* enable I-Cache */ + __DSB(); + __ISB(); + #endif +} + + +/** + \brief Disable I-Cache + \details Turns off I-Cache + */ +__STATIC_INLINE void SCB_DisableICache (void) +{ + #if (__ICACHE_PRESENT == 1U) + __DSB(); + __ISB(); + SCB->CCR &= ~(uint32_t)SCB_CCR_IC_Msk; /* disable I-Cache */ + SCB->ICIALLU = 0UL; /* invalidate I-Cache */ + __DSB(); + __ISB(); + #endif +} + + +/** + \brief Invalidate I-Cache + \details Invalidates I-Cache + */ +__STATIC_INLINE void SCB_InvalidateICache (void) +{ + #if (__ICACHE_PRESENT == 1U) + __DSB(); + __ISB(); + SCB->ICIALLU = 0UL; + __DSB(); + __ISB(); + #endif +} + + +/** + \brief Enable D-Cache + \details Turns on D-Cache + */ +__STATIC_INLINE void SCB_EnableDCache (void) +{ + #if (__DCACHE_PRESENT == 1U) + uint32_t ccsidr; + uint32_t sets; + uint32_t ways; + + SCB->CSSELR = (0U << 1U) | 0U; /* Level 1 data cache */ + __DSB(); + + ccsidr = SCB->CCSIDR; + + /* invalidate D-Cache */ + sets = (uint32_t)(CCSIDR_SETS(ccsidr)); + do { + ways = (uint32_t)(CCSIDR_WAYS(ccsidr)); + do { + SCB->DCISW = (((sets << SCB_DCISW_SET_Pos) & SCB_DCISW_SET_Msk) | + ((ways << SCB_DCISW_WAY_Pos) & SCB_DCISW_WAY_Msk) ); + #if defined ( __CC_ARM ) + __schedule_barrier(); + #endif + } while (ways--); + } while(sets--); + __DSB(); + + SCB->CCR |= (uint32_t)SCB_CCR_DC_Msk; /* enable D-Cache */ + + __DSB(); + __ISB(); + #endif +} + + +/** + \brief Disable D-Cache + \details Turns off D-Cache + */ +__STATIC_INLINE void SCB_DisableDCache (void) +{ + #if (__DCACHE_PRESENT == 1U) + uint32_t ccsidr; + uint32_t sets; + uint32_t ways; + + SCB->CSSELR = (0U << 1U) | 0U; /* Level 1 data cache */ + __DSB(); + + ccsidr = SCB->CCSIDR; + + SCB->CCR &= ~(uint32_t)SCB_CCR_DC_Msk; /* disable D-Cache */ + + /* clean & invalidate D-Cache */ + sets = (uint32_t)(CCSIDR_SETS(ccsidr)); + do { + ways = (uint32_t)(CCSIDR_WAYS(ccsidr)); + do { + SCB->DCCISW = (((sets << SCB_DCCISW_SET_Pos) & SCB_DCCISW_SET_Msk) | + ((ways << SCB_DCCISW_WAY_Pos) & SCB_DCCISW_WAY_Msk) ); + #if defined ( __CC_ARM ) + __schedule_barrier(); + #endif + } while (ways--); + } while(sets--); + + __DSB(); + __ISB(); + #endif +} + + +/** + \brief Invalidate D-Cache + \details Invalidates D-Cache + */ +__STATIC_INLINE void SCB_InvalidateDCache (void) +{ + #if (__DCACHE_PRESENT == 1U) + uint32_t ccsidr; + uint32_t sets; + uint32_t ways; + + SCB->CSSELR = (0U << 1U) | 0U; /* Level 1 data cache */ + __DSB(); + + ccsidr = SCB->CCSIDR; + + /* invalidate D-Cache */ + sets = (uint32_t)(CCSIDR_SETS(ccsidr)); + do { + ways = (uint32_t)(CCSIDR_WAYS(ccsidr)); + do { + SCB->DCISW = (((sets << SCB_DCISW_SET_Pos) & SCB_DCISW_SET_Msk) | + ((ways << SCB_DCISW_WAY_Pos) & SCB_DCISW_WAY_Msk) ); + #if defined ( __CC_ARM ) + __schedule_barrier(); + #endif + } while (ways--); + } while(sets--); + + __DSB(); + __ISB(); + #endif +} + + +/** + \brief Clean D-Cache + \details Cleans D-Cache + */ +__STATIC_INLINE void SCB_CleanDCache (void) +{ + #if (__DCACHE_PRESENT == 1U) + uint32_t ccsidr; + uint32_t sets; + uint32_t ways; + + SCB->CSSELR = (0U << 1U) | 0U; /* Level 1 data cache */ + __DSB(); + + ccsidr = SCB->CCSIDR; + + /* clean D-Cache */ + sets = (uint32_t)(CCSIDR_SETS(ccsidr)); + do { + ways = (uint32_t)(CCSIDR_WAYS(ccsidr)); + do { + SCB->DCCSW = (((sets << SCB_DCCSW_SET_Pos) & SCB_DCCSW_SET_Msk) | + ((ways << SCB_DCCSW_WAY_Pos) & SCB_DCCSW_WAY_Msk) ); + #if defined ( __CC_ARM ) + __schedule_barrier(); + #endif + } while (ways--); + } while(sets--); + + __DSB(); + __ISB(); + #endif +} + + +/** + \brief Clean & Invalidate D-Cache + \details Cleans and Invalidates D-Cache + */ +__STATIC_INLINE void SCB_CleanInvalidateDCache (void) +{ + #if (__DCACHE_PRESENT == 1U) + uint32_t ccsidr; + uint32_t sets; + uint32_t ways; + + SCB->CSSELR = (0U << 1U) | 0U; /* Level 1 data cache */ + __DSB(); + + ccsidr = SCB->CCSIDR; + + /* clean & invalidate D-Cache */ + sets = (uint32_t)(CCSIDR_SETS(ccsidr)); + do { + ways = (uint32_t)(CCSIDR_WAYS(ccsidr)); + do { + SCB->DCCISW = (((sets << SCB_DCCISW_SET_Pos) & SCB_DCCISW_SET_Msk) | + ((ways << SCB_DCCISW_WAY_Pos) & SCB_DCCISW_WAY_Msk) ); + #if defined ( __CC_ARM ) + __schedule_barrier(); + #endif + } while (ways--); + } while(sets--); + + __DSB(); + __ISB(); + #endif +} + + +/** + \brief D-Cache Invalidate by address + \details Invalidates D-Cache for the given address + \param[in] addr address (aligned to 32-byte boundary) + \param[in] dsize size of memory block (in number of bytes) +*/ +__STATIC_INLINE void SCB_InvalidateDCache_by_Addr (uint32_t *addr, int32_t dsize) +{ + #if (__DCACHE_PRESENT == 1U) + int32_t op_size = dsize; + uint32_t op_addr = (uint32_t)addr; + int32_t linesize = 32U; /* in Cortex-M7 size of cache line is fixed to 8 words (32 bytes) */ + + __DSB(); + + while (op_size > 0) { + SCB->DCIMVAC = op_addr; + op_addr += linesize; + op_size -= linesize; + } + + __DSB(); + __ISB(); + #endif +} + + +/** + \brief D-Cache Clean by address + \details Cleans D-Cache for the given address + \param[in] addr address (aligned to 32-byte boundary) + \param[in] dsize size of memory block (in number of bytes) +*/ +__STATIC_INLINE void SCB_CleanDCache_by_Addr (uint32_t *addr, int32_t dsize) +{ + #if (__DCACHE_PRESENT == 1) + int32_t op_size = dsize; + uint32_t op_addr = (uint32_t) addr; + int32_t linesize = 32U; /* in Cortex-M7 size of cache line is fixed to 8 words (32 bytes) */ + + __DSB(); + + while (op_size > 0) { + SCB->DCCMVAC = op_addr; + op_addr += linesize; + op_size -= linesize; + } + + __DSB(); + __ISB(); + #endif +} + + +/** + \brief D-Cache Clean and Invalidate by address + \details Cleans and invalidates D_Cache for the given address + \param[in] addr address (aligned to 32-byte boundary) + \param[in] dsize size of memory block (in number of bytes) +*/ +__STATIC_INLINE void SCB_CleanInvalidateDCache_by_Addr (uint32_t *addr, int32_t dsize) +{ + #if (__DCACHE_PRESENT == 1U) + int32_t op_size = dsize; + uint32_t op_addr = (uint32_t) addr; + int32_t linesize = 32U; /* in Cortex-M7 size of cache line is fixed to 8 words (32 bytes) */ + + __DSB(); + + while (op_size > 0) { + SCB->DCCIMVAC = op_addr; + op_addr += linesize; + op_size -= linesize; + } + + __DSB(); + __ISB(); + #endif +} + + +/*@} end of CMSIS_Core_CacheFunctions */ + + + +/* ################################## SysTick function ############################################ */ +/** + \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_SysTickFunctions SysTick Functions + \brief Functions that configure the System. + @{ + */ + +#if (__Vendor_SysTickConfig == 0U) + +/** + \brief System Tick Configuration + \details Initializes the System Timer and its interrupt, and starts the System Tick Timer. + Counter is in free running mode to generate periodic interrupts. + \param [in] ticks Number of ticks between two interrupts. + \return 0 Function succeeded. + \return 1 Function failed. + \note When the variable __Vendor_SysTickConfig is set to 1, then the + function SysTick_Config is not included. In this case, the file device.h + must contain a vendor-specific implementation of this function. + */ +__STATIC_INLINE uint32_t SysTick_Config(uint32_t ticks) +{ + if ((ticks - 1UL) > SysTick_LOAD_RELOAD_Msk) + { + return (1UL); /* Reload value impossible */ + } + + SysTick->LOAD = (uint32_t)(ticks - 1UL); /* set reload register */ + NVIC_SetPriority (SysTick_IRQn, (1UL << __NVIC_PRIO_BITS) - 1UL); /* set Priority for Systick Interrupt */ + SysTick->VAL = 0UL; /* Load the SysTick Counter Value */ + SysTick->CTRL = SysTick_CTRL_CLKSOURCE_Msk | + SysTick_CTRL_TICKINT_Msk | + SysTick_CTRL_ENABLE_Msk; /* Enable SysTick IRQ and SysTick Timer */ + return (0UL); /* Function successful */ +} + +#endif + +/*@} end of CMSIS_Core_SysTickFunctions */ + + + +/* ##################################### Debug In/Output function ########################################### */ +/** + \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_core_DebugFunctions ITM Functions + \brief Functions that access the ITM debug interface. + @{ + */ + +extern volatile int32_t ITM_RxBuffer; /*!< External variable to receive characters. */ +#define ITM_RXBUFFER_EMPTY 0x5AA55AA5U /*!< Value identifying \ref ITM_RxBuffer is ready for next character. */ + + +/** + \brief ITM Send Character + \details Transmits a character via the ITM channel 0, and + \li Just returns when no debugger is connected that has booked the output. + \li Is blocking when a debugger is connected, but the previous character sent has not been transmitted. + \param [in] ch Character to transmit. + \returns Character to transmit. + */ +__STATIC_INLINE uint32_t ITM_SendChar (uint32_t ch) +{ + if (((ITM->TCR & ITM_TCR_ITMENA_Msk) != 0UL) && /* ITM enabled */ + ((ITM->TER & 1UL ) != 0UL) ) /* ITM Port #0 enabled */ + { + while (ITM->PORT[0U].u32 == 0UL) + { + __NOP(); + } + ITM->PORT[0U].u8 = (uint8_t)ch; + } + return (ch); +} + + +/** + \brief ITM Receive Character + \details Inputs a character via the external variable \ref ITM_RxBuffer. + \return Received character. + \return -1 No character pending. + */ +__STATIC_INLINE int32_t ITM_ReceiveChar (void) +{ + int32_t ch = -1; /* no character available */ + + if (ITM_RxBuffer != ITM_RXBUFFER_EMPTY) + { + ch = ITM_RxBuffer; + ITM_RxBuffer = ITM_RXBUFFER_EMPTY; /* ready for next character */ + } + + return (ch); +} + + +/** + \brief ITM Check Character + \details Checks whether a character is pending for reading in the variable \ref ITM_RxBuffer. + \return 0 No character available. + \return 1 Character available. + */ +__STATIC_INLINE int32_t ITM_CheckChar (void) +{ + + if (ITM_RxBuffer == ITM_RXBUFFER_EMPTY) + { + return (0); /* no character available */ + } + else + { + return (1); /* character available */ + } +} + +/*@} end of CMSIS_core_DebugFunctions */ + + + + +#ifdef __cplusplus +} +#endif + +#endif /* __CORE_CM7_H_DEPENDANT */ + +#endif /* __CMSIS_GENERIC */ diff --git a/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cmFunc.h b/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cmFunc.h new file mode 100644 index 00000000000..652a48af07a --- /dev/null +++ b/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cmFunc.h @@ -0,0 +1,87 @@ +/**************************************************************************//** + * @file core_cmFunc.h + * @brief CMSIS Cortex-M Core Function Access Header File + * @version V4.30 + * @date 20. October 2015 + ******************************************************************************/ +/* Copyright (c) 2009 - 2015 ARM LIMITED + + All rights reserved. + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are met: + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + - Neither the name of ARM nor the names of its contributors may be used + to endorse or promote products derived from this software without + specific prior written permission. + * + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE + LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + ---------------------------------------------------------------------------*/ + + +#if defined ( __ICCARM__ ) + #pragma system_include /* treat file as system include file for MISRA check */ +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #pragma clang system_header /* treat file as system include file */ +#endif + +#ifndef __CORE_CMFUNC_H +#define __CORE_CMFUNC_H + + +/* ########################### Core Function Access ########################### */ +/** \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_RegAccFunctions CMSIS Core Register Access Functions + @{ +*/ + +/*------------------ RealView Compiler -----------------*/ +#if defined ( __CC_ARM ) + #include "cmsis_armcc.h" + +/*------------------ ARM Compiler V6 -------------------*/ +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #include "cmsis_armcc_V6.h" + +/*------------------ GNU Compiler ----------------------*/ +#elif defined ( __GNUC__ ) + #include "cmsis_gcc.h" + +/*------------------ ICC Compiler ----------------------*/ +#elif defined ( __ICCARM__ ) + #include + +/*------------------ TI CCS Compiler -------------------*/ +#elif defined ( __TMS470__ ) + #include + +/*------------------ TASKING Compiler ------------------*/ +#elif defined ( __TASKING__ ) + /* + * The CMSIS functions have been implemented as intrinsics in the compiler. + * Please use "carm -?i" to get an up to date list of all intrinsics, + * Including the CMSIS ones. + */ + +/*------------------ COSMIC Compiler -------------------*/ +#elif defined ( __CSMC__ ) + #include + +#endif + +/*@} end of CMSIS_Core_RegAccFunctions */ + +#endif /* __CORE_CMFUNC_H */ diff --git a/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cmInstr.h b/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cmInstr.h new file mode 100644 index 00000000000..f474b0e6f36 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cmInstr.h @@ -0,0 +1,87 @@ +/**************************************************************************//** + * @file core_cmInstr.h + * @brief CMSIS Cortex-M Core Instruction Access Header File + * @version V4.30 + * @date 20. October 2015 + ******************************************************************************/ +/* Copyright (c) 2009 - 2015 ARM LIMITED + + All rights reserved. + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are met: + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + - Neither the name of ARM nor the names of its contributors may be used + to endorse or promote products derived from this software without + specific prior written permission. + * + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE + LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + ---------------------------------------------------------------------------*/ + + +#if defined ( __ICCARM__ ) + #pragma system_include /* treat file as system include file for MISRA check */ +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #pragma clang system_header /* treat file as system include file */ +#endif + +#ifndef __CORE_CMINSTR_H +#define __CORE_CMINSTR_H + + +/* ########################## Core Instruction Access ######################### */ +/** \defgroup CMSIS_Core_InstructionInterface CMSIS Core Instruction Interface + Access to dedicated instructions + @{ +*/ + +/*------------------ RealView Compiler -----------------*/ +#if defined ( __CC_ARM ) + #include "cmsis_armcc.h" + +/*------------------ ARM Compiler V6 -------------------*/ +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #include "cmsis_armcc_V6.h" + +/*------------------ GNU Compiler ----------------------*/ +#elif defined ( __GNUC__ ) + #include "cmsis_gcc.h" + +/*------------------ ICC Compiler ----------------------*/ +#elif defined ( __ICCARM__ ) + #include + +/*------------------ TI CCS Compiler -------------------*/ +#elif defined ( __TMS470__ ) + #include + +/*------------------ TASKING Compiler ------------------*/ +#elif defined ( __TASKING__ ) + /* + * The CMSIS functions have been implemented as intrinsics in the compiler. + * Please use "carm -?i" to get an up to date list of all intrinsics, + * Including the CMSIS ones. + */ + +/*------------------ COSMIC Compiler -------------------*/ +#elif defined ( __CSMC__ ) + #include + +#endif + +/*@}*/ /* end of group CMSIS_Core_InstructionInterface */ + +#endif /* __CORE_CMINSTR_H */ diff --git a/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cmSimd.h b/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cmSimd.h new file mode 100644 index 00000000000..66bf5c2a725 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/CMSIS/Include/core_cmSimd.h @@ -0,0 +1,96 @@ +/**************************************************************************//** + * @file core_cmSimd.h + * @brief CMSIS Cortex-M SIMD Header File + * @version V4.30 + * @date 20. October 2015 + ******************************************************************************/ +/* Copyright (c) 2009 - 2015 ARM LIMITED + + All rights reserved. + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are met: + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + - Neither the name of ARM nor the names of its contributors may be used + to endorse or promote products derived from this software without + specific prior written permission. + * + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE + LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + ---------------------------------------------------------------------------*/ + + +#if defined ( __ICCARM__ ) + #pragma system_include /* treat file as system include file for MISRA check */ +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #pragma clang system_header /* treat file as system include file */ +#endif + +#ifndef __CORE_CMSIMD_H +#define __CORE_CMSIMD_H + +#ifdef __cplusplus + extern "C" { +#endif + + +/* ################### Compiler specific Intrinsics ########################### */ +/** \defgroup CMSIS_SIMD_intrinsics CMSIS SIMD Intrinsics + Access to dedicated SIMD instructions + @{ +*/ + +/*------------------ RealView Compiler -----------------*/ +#if defined ( __CC_ARM ) + #include "cmsis_armcc.h" + +/*------------------ ARM Compiler V6 -------------------*/ +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #include "cmsis_armcc_V6.h" + +/*------------------ GNU Compiler ----------------------*/ +#elif defined ( __GNUC__ ) + #include "cmsis_gcc.h" + +/*------------------ ICC Compiler ----------------------*/ +#elif defined ( __ICCARM__ ) + #include + +/*------------------ TI CCS Compiler -------------------*/ +#elif defined ( __TMS470__ ) + #include + +/*------------------ TASKING Compiler ------------------*/ +#elif defined ( __TASKING__ ) + /* + * The CMSIS functions have been implemented as intrinsics in the compiler. + * Please use "carm -?i" to get an up to date list of all intrinsics, + * Including the CMSIS ones. + */ + +/*------------------ COSMIC Compiler -------------------*/ +#elif defined ( __CSMC__ ) + #include + +#endif + +/*@} end of group CMSIS_SIMD_intrinsics */ + + +#ifdef __cplusplus +} +#endif + +#endif /* __CORE_CMSIMD_H */ diff --git a/bsp/nuvoton/libraries/m480/CMSIS/Include/core_sc000.h b/bsp/nuvoton/libraries/m480/CMSIS/Include/core_sc000.h new file mode 100644 index 00000000000..514dbd81b9f --- /dev/null +++ b/bsp/nuvoton/libraries/m480/CMSIS/Include/core_sc000.h @@ -0,0 +1,926 @@ +/**************************************************************************//** + * @file core_sc000.h + * @brief CMSIS SC000 Core Peripheral Access Layer Header File + * @version V4.30 + * @date 20. October 2015 + ******************************************************************************/ +/* Copyright (c) 2009 - 2015 ARM LIMITED + + All rights reserved. + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are met: + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + - Neither the name of ARM nor the names of its contributors may be used + to endorse or promote products derived from this software without + specific prior written permission. + * + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE + LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + ---------------------------------------------------------------------------*/ + + +#if defined ( __ICCARM__ ) + #pragma system_include /* treat file as system include file for MISRA check */ +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #pragma clang system_header /* treat file as system include file */ +#endif + +#ifndef __CORE_SC000_H_GENERIC +#define __CORE_SC000_H_GENERIC + +#include + +#ifdef __cplusplus + extern "C" { +#endif + +/** + \page CMSIS_MISRA_Exceptions MISRA-C:2004 Compliance Exceptions + CMSIS violates the following MISRA-C:2004 rules: + + \li Required Rule 8.5, object/function definition in header file.
+ Function definitions in header files are used to allow 'inlining'. + + \li Required Rule 18.4, declaration of union type or object of union type: '{...}'.
+ Unions are used for effective representation of core registers. + + \li Advisory Rule 19.7, Function-like macro defined.
+ Function-like macros are used to allow more efficient code. + */ + + +/******************************************************************************* + * CMSIS definitions + ******************************************************************************/ +/** + \ingroup SC000 + @{ + */ + +/* CMSIS SC000 definitions */ +#define __SC000_CMSIS_VERSION_MAIN (0x04U) /*!< [31:16] CMSIS HAL main version */ +#define __SC000_CMSIS_VERSION_SUB (0x1EU) /*!< [15:0] CMSIS HAL sub version */ +#define __SC000_CMSIS_VERSION ((__SC000_CMSIS_VERSION_MAIN << 16U) | \ + __SC000_CMSIS_VERSION_SUB ) /*!< CMSIS HAL version number */ + +#define __CORTEX_SC (000U) /*!< Cortex secure core */ + + +#if defined ( __CC_ARM ) + #define __ASM __asm /*!< asm keyword for ARM Compiler */ + #define __INLINE __inline /*!< inline keyword for ARM Compiler */ + #define __STATIC_INLINE static __inline + +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #define __ASM __asm /*!< asm keyword for ARM Compiler */ + #define __INLINE __inline /*!< inline keyword for ARM Compiler */ + #define __STATIC_INLINE static __inline + +#elif defined ( __GNUC__ ) + #define __ASM __asm /*!< asm keyword for GNU Compiler */ + #define __INLINE inline /*!< inline keyword for GNU Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __ICCARM__ ) + #define __ASM __asm /*!< asm keyword for IAR Compiler */ + #define __INLINE inline /*!< inline keyword for IAR Compiler. Only available in High optimization mode! */ + #define __STATIC_INLINE static inline + +#elif defined ( __TMS470__ ) + #define __ASM __asm /*!< asm keyword for TI CCS Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __TASKING__ ) + #define __ASM __asm /*!< asm keyword for TASKING Compiler */ + #define __INLINE inline /*!< inline keyword for TASKING Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __CSMC__ ) + #define __packed + #define __ASM _asm /*!< asm keyword for COSMIC Compiler */ + #define __INLINE inline /*!< inline keyword for COSMIC Compiler. Use -pc99 on compile line */ + #define __STATIC_INLINE static inline + +#else + #error Unknown compiler +#endif + +/** __FPU_USED indicates whether an FPU is used or not. + This core does not support an FPU at all +*/ +#define __FPU_USED 0U + +#if defined ( __CC_ARM ) + #if defined __TARGET_FPU_VFP + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #if defined __ARM_PCS_VFP + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __GNUC__ ) + #if defined (__VFP_FP__) && !defined(__SOFTFP__) + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __ICCARM__ ) + #if defined __ARMVFP__ + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __TMS470__ ) + #if defined __TI_VFP_SUPPORT__ + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __TASKING__ ) + #if defined __FPU_VFP__ + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __CSMC__ ) + #if ( __CSMC__ & 0x400U) + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#endif + +#include "core_cmInstr.h" /* Core Instruction Access */ +#include "core_cmFunc.h" /* Core Function Access */ + +#ifdef __cplusplus +} +#endif + +#endif /* __CORE_SC000_H_GENERIC */ + +#ifndef __CMSIS_GENERIC + +#ifndef __CORE_SC000_H_DEPENDANT +#define __CORE_SC000_H_DEPENDANT + +#ifdef __cplusplus + extern "C" { +#endif + +/* check device defines and use defaults */ +#if defined __CHECK_DEVICE_DEFINES + #ifndef __SC000_REV + #define __SC000_REV 0x0000U + #warning "__SC000_REV not defined in device header file; using default!" + #endif + + #ifndef __MPU_PRESENT + #define __MPU_PRESENT 0U + #warning "__MPU_PRESENT not defined in device header file; using default!" + #endif + + #ifndef __NVIC_PRIO_BITS + #define __NVIC_PRIO_BITS 2U + #warning "__NVIC_PRIO_BITS not defined in device header file; using default!" + #endif + + #ifndef __Vendor_SysTickConfig + #define __Vendor_SysTickConfig 0U + #warning "__Vendor_SysTickConfig not defined in device header file; using default!" + #endif +#endif + +/* IO definitions (access restrictions to peripheral registers) */ +/** + \defgroup CMSIS_glob_defs CMSIS Global Defines + + IO Type Qualifiers are used + \li to specify the access to peripheral variables. + \li for automatic generation of peripheral register debug information. +*/ +#ifdef __cplusplus + #define __I volatile /*!< Defines 'read only' permissions */ +#else + #define __I volatile const /*!< Defines 'read only' permissions */ +#endif +#define __O volatile /*!< Defines 'write only' permissions */ +#define __IO volatile /*!< Defines 'read / write' permissions */ + +/* following defines should be used for structure members */ +#define __IM volatile const /*! Defines 'read only' structure member permissions */ +#define __OM volatile /*! Defines 'write only' structure member permissions */ +#define __IOM volatile /*! Defines 'read / write' structure member permissions */ + +/*@} end of group SC000 */ + + + +/******************************************************************************* + * Register Abstraction + Core Register contain: + - Core Register + - Core NVIC Register + - Core SCB Register + - Core SysTick Register + - Core MPU Register + ******************************************************************************/ +/** + \defgroup CMSIS_core_register Defines and Type Definitions + \brief Type definitions and defines for Cortex-M processor based devices. +*/ + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_CORE Status and Control Registers + \brief Core Register type definitions. + @{ + */ + +/** + \brief Union type to access the Application Program Status Register (APSR). + */ +typedef union +{ + struct + { + uint32_t _reserved0:28; /*!< bit: 0..27 Reserved */ + uint32_t V:1; /*!< bit: 28 Overflow condition code flag */ + uint32_t C:1; /*!< bit: 29 Carry condition code flag */ + uint32_t Z:1; /*!< bit: 30 Zero condition code flag */ + uint32_t N:1; /*!< bit: 31 Negative condition code flag */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} APSR_Type; + +/* APSR Register Definitions */ +#define APSR_N_Pos 31U /*!< APSR: N Position */ +#define APSR_N_Msk (1UL << APSR_N_Pos) /*!< APSR: N Mask */ + +#define APSR_Z_Pos 30U /*!< APSR: Z Position */ +#define APSR_Z_Msk (1UL << APSR_Z_Pos) /*!< APSR: Z Mask */ + +#define APSR_C_Pos 29U /*!< APSR: C Position */ +#define APSR_C_Msk (1UL << APSR_C_Pos) /*!< APSR: C Mask */ + +#define APSR_V_Pos 28U /*!< APSR: V Position */ +#define APSR_V_Msk (1UL << APSR_V_Pos) /*!< APSR: V Mask */ + + +/** + \brief Union type to access the Interrupt Program Status Register (IPSR). + */ +typedef union +{ + struct + { + uint32_t ISR:9; /*!< bit: 0.. 8 Exception number */ + uint32_t _reserved0:23; /*!< bit: 9..31 Reserved */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} IPSR_Type; + +/* IPSR Register Definitions */ +#define IPSR_ISR_Pos 0U /*!< IPSR: ISR Position */ +#define IPSR_ISR_Msk (0x1FFUL /*<< IPSR_ISR_Pos*/) /*!< IPSR: ISR Mask */ + + +/** + \brief Union type to access the Special-Purpose Program Status Registers (xPSR). + */ +typedef union +{ + struct + { + uint32_t ISR:9; /*!< bit: 0.. 8 Exception number */ + uint32_t _reserved0:15; /*!< bit: 9..23 Reserved */ + uint32_t T:1; /*!< bit: 24 Thumb bit (read 0) */ + uint32_t _reserved1:3; /*!< bit: 25..27 Reserved */ + uint32_t V:1; /*!< bit: 28 Overflow condition code flag */ + uint32_t C:1; /*!< bit: 29 Carry condition code flag */ + uint32_t Z:1; /*!< bit: 30 Zero condition code flag */ + uint32_t N:1; /*!< bit: 31 Negative condition code flag */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} xPSR_Type; + +/* xPSR Register Definitions */ +#define xPSR_N_Pos 31U /*!< xPSR: N Position */ +#define xPSR_N_Msk (1UL << xPSR_N_Pos) /*!< xPSR: N Mask */ + +#define xPSR_Z_Pos 30U /*!< xPSR: Z Position */ +#define xPSR_Z_Msk (1UL << xPSR_Z_Pos) /*!< xPSR: Z Mask */ + +#define xPSR_C_Pos 29U /*!< xPSR: C Position */ +#define xPSR_C_Msk (1UL << xPSR_C_Pos) /*!< xPSR: C Mask */ + +#define xPSR_V_Pos 28U /*!< xPSR: V Position */ +#define xPSR_V_Msk (1UL << xPSR_V_Pos) /*!< xPSR: V Mask */ + +#define xPSR_T_Pos 24U /*!< xPSR: T Position */ +#define xPSR_T_Msk (1UL << xPSR_T_Pos) /*!< xPSR: T Mask */ + +#define xPSR_ISR_Pos 0U /*!< xPSR: ISR Position */ +#define xPSR_ISR_Msk (0x1FFUL /*<< xPSR_ISR_Pos*/) /*!< xPSR: ISR Mask */ + + +/** + \brief Union type to access the Control Registers (CONTROL). + */ +typedef union +{ + struct + { + uint32_t _reserved0:1; /*!< bit: 0 Reserved */ + uint32_t SPSEL:1; /*!< bit: 1 Stack to be used */ + uint32_t _reserved1:30; /*!< bit: 2..31 Reserved */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} CONTROL_Type; + +/* CONTROL Register Definitions */ +#define CONTROL_SPSEL_Pos 1U /*!< CONTROL: SPSEL Position */ +#define CONTROL_SPSEL_Msk (1UL << CONTROL_SPSEL_Pos) /*!< CONTROL: SPSEL Mask */ + +/*@} end of group CMSIS_CORE */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_NVIC Nested Vectored Interrupt Controller (NVIC) + \brief Type definitions for the NVIC Registers + @{ + */ + +/** + \brief Structure type to access the Nested Vectored Interrupt Controller (NVIC). + */ +typedef struct +{ + __IOM uint32_t ISER[1U]; /*!< Offset: 0x000 (R/W) Interrupt Set Enable Register */ + uint32_t RESERVED0[31U]; + __IOM uint32_t ICER[1U]; /*!< Offset: 0x080 (R/W) Interrupt Clear Enable Register */ + uint32_t RSERVED1[31U]; + __IOM uint32_t ISPR[1U]; /*!< Offset: 0x100 (R/W) Interrupt Set Pending Register */ + uint32_t RESERVED2[31U]; + __IOM uint32_t ICPR[1U]; /*!< Offset: 0x180 (R/W) Interrupt Clear Pending Register */ + uint32_t RESERVED3[31U]; + uint32_t RESERVED4[64U]; + __IOM uint32_t IP[8U]; /*!< Offset: 0x300 (R/W) Interrupt Priority Register */ +} NVIC_Type; + +/*@} end of group CMSIS_NVIC */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_SCB System Control Block (SCB) + \brief Type definitions for the System Control Block Registers + @{ + */ + +/** + \brief Structure type to access the System Control Block (SCB). + */ +typedef struct +{ + __IM uint32_t CPUID; /*!< Offset: 0x000 (R/ ) CPUID Base Register */ + __IOM uint32_t ICSR; /*!< Offset: 0x004 (R/W) Interrupt Control and State Register */ + __IOM uint32_t VTOR; /*!< Offset: 0x008 (R/W) Vector Table Offset Register */ + __IOM uint32_t AIRCR; /*!< Offset: 0x00C (R/W) Application Interrupt and Reset Control Register */ + __IOM uint32_t SCR; /*!< Offset: 0x010 (R/W) System Control Register */ + __IOM uint32_t CCR; /*!< Offset: 0x014 (R/W) Configuration Control Register */ + uint32_t RESERVED0[1U]; + __IOM uint32_t SHP[2U]; /*!< Offset: 0x01C (R/W) System Handlers Priority Registers. [0] is RESERVED */ + __IOM uint32_t SHCSR; /*!< Offset: 0x024 (R/W) System Handler Control and State Register */ + uint32_t RESERVED1[154U]; + __IOM uint32_t SFCR; /*!< Offset: 0x290 (R/W) Security Features Control Register */ +} SCB_Type; + +/* SCB CPUID Register Definitions */ +#define SCB_CPUID_IMPLEMENTER_Pos 24U /*!< SCB CPUID: IMPLEMENTER Position */ +#define SCB_CPUID_IMPLEMENTER_Msk (0xFFUL << SCB_CPUID_IMPLEMENTER_Pos) /*!< SCB CPUID: IMPLEMENTER Mask */ + +#define SCB_CPUID_VARIANT_Pos 20U /*!< SCB CPUID: VARIANT Position */ +#define SCB_CPUID_VARIANT_Msk (0xFUL << SCB_CPUID_VARIANT_Pos) /*!< SCB CPUID: VARIANT Mask */ + +#define SCB_CPUID_ARCHITECTURE_Pos 16U /*!< SCB CPUID: ARCHITECTURE Position */ +#define SCB_CPUID_ARCHITECTURE_Msk (0xFUL << SCB_CPUID_ARCHITECTURE_Pos) /*!< SCB CPUID: ARCHITECTURE Mask */ + +#define SCB_CPUID_PARTNO_Pos 4U /*!< SCB CPUID: PARTNO Position */ +#define SCB_CPUID_PARTNO_Msk (0xFFFUL << SCB_CPUID_PARTNO_Pos) /*!< SCB CPUID: PARTNO Mask */ + +#define SCB_CPUID_REVISION_Pos 0U /*!< SCB CPUID: REVISION Position */ +#define SCB_CPUID_REVISION_Msk (0xFUL /*<< SCB_CPUID_REVISION_Pos*/) /*!< SCB CPUID: REVISION Mask */ + +/* SCB Interrupt Control State Register Definitions */ +#define SCB_ICSR_NMIPENDSET_Pos 31U /*!< SCB ICSR: NMIPENDSET Position */ +#define SCB_ICSR_NMIPENDSET_Msk (1UL << SCB_ICSR_NMIPENDSET_Pos) /*!< SCB ICSR: NMIPENDSET Mask */ + +#define SCB_ICSR_PENDSVSET_Pos 28U /*!< SCB ICSR: PENDSVSET Position */ +#define SCB_ICSR_PENDSVSET_Msk (1UL << SCB_ICSR_PENDSVSET_Pos) /*!< SCB ICSR: PENDSVSET Mask */ + +#define SCB_ICSR_PENDSVCLR_Pos 27U /*!< SCB ICSR: PENDSVCLR Position */ +#define SCB_ICSR_PENDSVCLR_Msk (1UL << SCB_ICSR_PENDSVCLR_Pos) /*!< SCB ICSR: PENDSVCLR Mask */ + +#define SCB_ICSR_PENDSTSET_Pos 26U /*!< SCB ICSR: PENDSTSET Position */ +#define SCB_ICSR_PENDSTSET_Msk (1UL << SCB_ICSR_PENDSTSET_Pos) /*!< SCB ICSR: PENDSTSET Mask */ + +#define SCB_ICSR_PENDSTCLR_Pos 25U /*!< SCB ICSR: PENDSTCLR Position */ +#define SCB_ICSR_PENDSTCLR_Msk (1UL << SCB_ICSR_PENDSTCLR_Pos) /*!< SCB ICSR: PENDSTCLR Mask */ + +#define SCB_ICSR_ISRPREEMPT_Pos 23U /*!< SCB ICSR: ISRPREEMPT Position */ +#define SCB_ICSR_ISRPREEMPT_Msk (1UL << SCB_ICSR_ISRPREEMPT_Pos) /*!< SCB ICSR: ISRPREEMPT Mask */ + +#define SCB_ICSR_ISRPENDING_Pos 22U /*!< SCB ICSR: ISRPENDING Position */ +#define SCB_ICSR_ISRPENDING_Msk (1UL << SCB_ICSR_ISRPENDING_Pos) /*!< SCB ICSR: ISRPENDING Mask */ + +#define SCB_ICSR_VECTPENDING_Pos 12U /*!< SCB ICSR: VECTPENDING Position */ +#define SCB_ICSR_VECTPENDING_Msk (0x1FFUL << SCB_ICSR_VECTPENDING_Pos) /*!< SCB ICSR: VECTPENDING Mask */ + +#define SCB_ICSR_VECTACTIVE_Pos 0U /*!< SCB ICSR: VECTACTIVE Position */ +#define SCB_ICSR_VECTACTIVE_Msk (0x1FFUL /*<< SCB_ICSR_VECTACTIVE_Pos*/) /*!< SCB ICSR: VECTACTIVE Mask */ + +/* SCB Interrupt Control State Register Definitions */ +#define SCB_VTOR_TBLOFF_Pos 7U /*!< SCB VTOR: TBLOFF Position */ +#define SCB_VTOR_TBLOFF_Msk (0x1FFFFFFUL << SCB_VTOR_TBLOFF_Pos) /*!< SCB VTOR: TBLOFF Mask */ + +/* SCB Application Interrupt and Reset Control Register Definitions */ +#define SCB_AIRCR_VECTKEY_Pos 16U /*!< SCB AIRCR: VECTKEY Position */ +#define SCB_AIRCR_VECTKEY_Msk (0xFFFFUL << SCB_AIRCR_VECTKEY_Pos) /*!< SCB AIRCR: VECTKEY Mask */ + +#define SCB_AIRCR_VECTKEYSTAT_Pos 16U /*!< SCB AIRCR: VECTKEYSTAT Position */ +#define SCB_AIRCR_VECTKEYSTAT_Msk (0xFFFFUL << SCB_AIRCR_VECTKEYSTAT_Pos) /*!< SCB AIRCR: VECTKEYSTAT Mask */ + +#define SCB_AIRCR_ENDIANESS_Pos 15U /*!< SCB AIRCR: ENDIANESS Position */ +#define SCB_AIRCR_ENDIANESS_Msk (1UL << SCB_AIRCR_ENDIANESS_Pos) /*!< SCB AIRCR: ENDIANESS Mask */ + +#define SCB_AIRCR_SYSRESETREQ_Pos 2U /*!< SCB AIRCR: SYSRESETREQ Position */ +#define SCB_AIRCR_SYSRESETREQ_Msk (1UL << SCB_AIRCR_SYSRESETREQ_Pos) /*!< SCB AIRCR: SYSRESETREQ Mask */ + +#define SCB_AIRCR_VECTCLRACTIVE_Pos 1U /*!< SCB AIRCR: VECTCLRACTIVE Position */ +#define SCB_AIRCR_VECTCLRACTIVE_Msk (1UL << SCB_AIRCR_VECTCLRACTIVE_Pos) /*!< SCB AIRCR: VECTCLRACTIVE Mask */ + +/* SCB System Control Register Definitions */ +#define SCB_SCR_SEVONPEND_Pos 4U /*!< SCB SCR: SEVONPEND Position */ +#define SCB_SCR_SEVONPEND_Msk (1UL << SCB_SCR_SEVONPEND_Pos) /*!< SCB SCR: SEVONPEND Mask */ + +#define SCB_SCR_SLEEPDEEP_Pos 2U /*!< SCB SCR: SLEEPDEEP Position */ +#define SCB_SCR_SLEEPDEEP_Msk (1UL << SCB_SCR_SLEEPDEEP_Pos) /*!< SCB SCR: SLEEPDEEP Mask */ + +#define SCB_SCR_SLEEPONEXIT_Pos 1U /*!< SCB SCR: SLEEPONEXIT Position */ +#define SCB_SCR_SLEEPONEXIT_Msk (1UL << SCB_SCR_SLEEPONEXIT_Pos) /*!< SCB SCR: SLEEPONEXIT Mask */ + +/* SCB Configuration Control Register Definitions */ +#define SCB_CCR_STKALIGN_Pos 9U /*!< SCB CCR: STKALIGN Position */ +#define SCB_CCR_STKALIGN_Msk (1UL << SCB_CCR_STKALIGN_Pos) /*!< SCB CCR: STKALIGN Mask */ + +#define SCB_CCR_UNALIGN_TRP_Pos 3U /*!< SCB CCR: UNALIGN_TRP Position */ +#define SCB_CCR_UNALIGN_TRP_Msk (1UL << SCB_CCR_UNALIGN_TRP_Pos) /*!< SCB CCR: UNALIGN_TRP Mask */ + +/* SCB System Handler Control and State Register Definitions */ +#define SCB_SHCSR_SVCALLPENDED_Pos 15U /*!< SCB SHCSR: SVCALLPENDED Position */ +#define SCB_SHCSR_SVCALLPENDED_Msk (1UL << SCB_SHCSR_SVCALLPENDED_Pos) /*!< SCB SHCSR: SVCALLPENDED Mask */ + +/*@} end of group CMSIS_SCB */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_SCnSCB System Controls not in SCB (SCnSCB) + \brief Type definitions for the System Control and ID Register not in the SCB + @{ + */ + +/** + \brief Structure type to access the System Control and ID Register not in the SCB. + */ +typedef struct +{ + uint32_t RESERVED0[2U]; + __IOM uint32_t ACTLR; /*!< Offset: 0x008 (R/W) Auxiliary Control Register */ +} SCnSCB_Type; + +/* Auxiliary Control Register Definitions */ +#define SCnSCB_ACTLR_DISMCYCINT_Pos 0U /*!< ACTLR: DISMCYCINT Position */ +#define SCnSCB_ACTLR_DISMCYCINT_Msk (1UL /*<< SCnSCB_ACTLR_DISMCYCINT_Pos*/) /*!< ACTLR: DISMCYCINT Mask */ + +/*@} end of group CMSIS_SCnotSCB */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_SysTick System Tick Timer (SysTick) + \brief Type definitions for the System Timer Registers. + @{ + */ + +/** + \brief Structure type to access the System Timer (SysTick). + */ +typedef struct +{ + __IOM uint32_t CTRL; /*!< Offset: 0x000 (R/W) SysTick Control and Status Register */ + __IOM uint32_t LOAD; /*!< Offset: 0x004 (R/W) SysTick Reload Value Register */ + __IOM uint32_t VAL; /*!< Offset: 0x008 (R/W) SysTick Current Value Register */ + __IM uint32_t CALIB; /*!< Offset: 0x00C (R/ ) SysTick Calibration Register */ +} SysTick_Type; + +/* SysTick Control / Status Register Definitions */ +#define SysTick_CTRL_COUNTFLAG_Pos 16U /*!< SysTick CTRL: COUNTFLAG Position */ +#define SysTick_CTRL_COUNTFLAG_Msk (1UL << SysTick_CTRL_COUNTFLAG_Pos) /*!< SysTick CTRL: COUNTFLAG Mask */ + +#define SysTick_CTRL_CLKSOURCE_Pos 2U /*!< SysTick CTRL: CLKSOURCE Position */ +#define SysTick_CTRL_CLKSOURCE_Msk (1UL << SysTick_CTRL_CLKSOURCE_Pos) /*!< SysTick CTRL: CLKSOURCE Mask */ + +#define SysTick_CTRL_TICKINT_Pos 1U /*!< SysTick CTRL: TICKINT Position */ +#define SysTick_CTRL_TICKINT_Msk (1UL << SysTick_CTRL_TICKINT_Pos) /*!< SysTick CTRL: TICKINT Mask */ + +#define SysTick_CTRL_ENABLE_Pos 0U /*!< SysTick CTRL: ENABLE Position */ +#define SysTick_CTRL_ENABLE_Msk (1UL /*<< SysTick_CTRL_ENABLE_Pos*/) /*!< SysTick CTRL: ENABLE Mask */ + +/* SysTick Reload Register Definitions */ +#define SysTick_LOAD_RELOAD_Pos 0U /*!< SysTick LOAD: RELOAD Position */ +#define SysTick_LOAD_RELOAD_Msk (0xFFFFFFUL /*<< SysTick_LOAD_RELOAD_Pos*/) /*!< SysTick LOAD: RELOAD Mask */ + +/* SysTick Current Register Definitions */ +#define SysTick_VAL_CURRENT_Pos 0U /*!< SysTick VAL: CURRENT Position */ +#define SysTick_VAL_CURRENT_Msk (0xFFFFFFUL /*<< SysTick_VAL_CURRENT_Pos*/) /*!< SysTick VAL: CURRENT Mask */ + +/* SysTick Calibration Register Definitions */ +#define SysTick_CALIB_NOREF_Pos 31U /*!< SysTick CALIB: NOREF Position */ +#define SysTick_CALIB_NOREF_Msk (1UL << SysTick_CALIB_NOREF_Pos) /*!< SysTick CALIB: NOREF Mask */ + +#define SysTick_CALIB_SKEW_Pos 30U /*!< SysTick CALIB: SKEW Position */ +#define SysTick_CALIB_SKEW_Msk (1UL << SysTick_CALIB_SKEW_Pos) /*!< SysTick CALIB: SKEW Mask */ + +#define SysTick_CALIB_TENMS_Pos 0U /*!< SysTick CALIB: TENMS Position */ +#define SysTick_CALIB_TENMS_Msk (0xFFFFFFUL /*<< SysTick_CALIB_TENMS_Pos*/) /*!< SysTick CALIB: TENMS Mask */ + +/*@} end of group CMSIS_SysTick */ + +#if (__MPU_PRESENT == 1U) +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_MPU Memory Protection Unit (MPU) + \brief Type definitions for the Memory Protection Unit (MPU) + @{ + */ + +/** + \brief Structure type to access the Memory Protection Unit (MPU). + */ +typedef struct +{ + __IM uint32_t TYPE; /*!< Offset: 0x000 (R/ ) MPU Type Register */ + __IOM uint32_t CTRL; /*!< Offset: 0x004 (R/W) MPU Control Register */ + __IOM uint32_t RNR; /*!< Offset: 0x008 (R/W) MPU Region RNRber Register */ + __IOM uint32_t RBAR; /*!< Offset: 0x00C (R/W) MPU Region Base Address Register */ + __IOM uint32_t RASR; /*!< Offset: 0x010 (R/W) MPU Region Attribute and Size Register */ +} MPU_Type; + +/* MPU Type Register Definitions */ +#define MPU_TYPE_IREGION_Pos 16U /*!< MPU TYPE: IREGION Position */ +#define MPU_TYPE_IREGION_Msk (0xFFUL << MPU_TYPE_IREGION_Pos) /*!< MPU TYPE: IREGION Mask */ + +#define MPU_TYPE_DREGION_Pos 8U /*!< MPU TYPE: DREGION Position */ +#define MPU_TYPE_DREGION_Msk (0xFFUL << MPU_TYPE_DREGION_Pos) /*!< MPU TYPE: DREGION Mask */ + +#define MPU_TYPE_SEPARATE_Pos 0U /*!< MPU TYPE: SEPARATE Position */ +#define MPU_TYPE_SEPARATE_Msk (1UL /*<< MPU_TYPE_SEPARATE_Pos*/) /*!< MPU TYPE: SEPARATE Mask */ + +/* MPU Control Register Definitions */ +#define MPU_CTRL_PRIVDEFENA_Pos 2U /*!< MPU CTRL: PRIVDEFENA Position */ +#define MPU_CTRL_PRIVDEFENA_Msk (1UL << MPU_CTRL_PRIVDEFENA_Pos) /*!< MPU CTRL: PRIVDEFENA Mask */ + +#define MPU_CTRL_HFNMIENA_Pos 1U /*!< MPU CTRL: HFNMIENA Position */ +#define MPU_CTRL_HFNMIENA_Msk (1UL << MPU_CTRL_HFNMIENA_Pos) /*!< MPU CTRL: HFNMIENA Mask */ + +#define MPU_CTRL_ENABLE_Pos 0U /*!< MPU CTRL: ENABLE Position */ +#define MPU_CTRL_ENABLE_Msk (1UL /*<< MPU_CTRL_ENABLE_Pos*/) /*!< MPU CTRL: ENABLE Mask */ + +/* MPU Region Number Register Definitions */ +#define MPU_RNR_REGION_Pos 0U /*!< MPU RNR: REGION Position */ +#define MPU_RNR_REGION_Msk (0xFFUL /*<< MPU_RNR_REGION_Pos*/) /*!< MPU RNR: REGION Mask */ + +/* MPU Region Base Address Register Definitions */ +#define MPU_RBAR_ADDR_Pos 8U /*!< MPU RBAR: ADDR Position */ +#define MPU_RBAR_ADDR_Msk (0xFFFFFFUL << MPU_RBAR_ADDR_Pos) /*!< MPU RBAR: ADDR Mask */ + +#define MPU_RBAR_VALID_Pos 4U /*!< MPU RBAR: VALID Position */ +#define MPU_RBAR_VALID_Msk (1UL << MPU_RBAR_VALID_Pos) /*!< MPU RBAR: VALID Mask */ + +#define MPU_RBAR_REGION_Pos 0U /*!< MPU RBAR: REGION Position */ +#define MPU_RBAR_REGION_Msk (0xFUL /*<< MPU_RBAR_REGION_Pos*/) /*!< MPU RBAR: REGION Mask */ + +/* MPU Region Attribute and Size Register Definitions */ +#define MPU_RASR_ATTRS_Pos 16U /*!< MPU RASR: MPU Region Attribute field Position */ +#define MPU_RASR_ATTRS_Msk (0xFFFFUL << MPU_RASR_ATTRS_Pos) /*!< MPU RASR: MPU Region Attribute field Mask */ + +#define MPU_RASR_XN_Pos 28U /*!< MPU RASR: ATTRS.XN Position */ +#define MPU_RASR_XN_Msk (1UL << MPU_RASR_XN_Pos) /*!< MPU RASR: ATTRS.XN Mask */ + +#define MPU_RASR_AP_Pos 24U /*!< MPU RASR: ATTRS.AP Position */ +#define MPU_RASR_AP_Msk (0x7UL << MPU_RASR_AP_Pos) /*!< MPU RASR: ATTRS.AP Mask */ + +#define MPU_RASR_TEX_Pos 19U /*!< MPU RASR: ATTRS.TEX Position */ +#define MPU_RASR_TEX_Msk (0x7UL << MPU_RASR_TEX_Pos) /*!< MPU RASR: ATTRS.TEX Mask */ + +#define MPU_RASR_S_Pos 18U /*!< MPU RASR: ATTRS.S Position */ +#define MPU_RASR_S_Msk (1UL << MPU_RASR_S_Pos) /*!< MPU RASR: ATTRS.S Mask */ + +#define MPU_RASR_C_Pos 17U /*!< MPU RASR: ATTRS.C Position */ +#define MPU_RASR_C_Msk (1UL << MPU_RASR_C_Pos) /*!< MPU RASR: ATTRS.C Mask */ + +#define MPU_RASR_B_Pos 16U /*!< MPU RASR: ATTRS.B Position */ +#define MPU_RASR_B_Msk (1UL << MPU_RASR_B_Pos) /*!< MPU RASR: ATTRS.B Mask */ + +#define MPU_RASR_SRD_Pos 8U /*!< MPU RASR: Sub-Region Disable Position */ +#define MPU_RASR_SRD_Msk (0xFFUL << MPU_RASR_SRD_Pos) /*!< MPU RASR: Sub-Region Disable Mask */ + +#define MPU_RASR_SIZE_Pos 1U /*!< MPU RASR: Region Size Field Position */ +#define MPU_RASR_SIZE_Msk (0x1FUL << MPU_RASR_SIZE_Pos) /*!< MPU RASR: Region Size Field Mask */ + +#define MPU_RASR_ENABLE_Pos 0U /*!< MPU RASR: Region enable bit Position */ +#define MPU_RASR_ENABLE_Msk (1UL /*<< MPU_RASR_ENABLE_Pos*/) /*!< MPU RASR: Region enable bit Disable Mask */ + +/*@} end of group CMSIS_MPU */ +#endif + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_CoreDebug Core Debug Registers (CoreDebug) + \brief SC000 Core Debug Registers (DCB registers, SHCSR, and DFSR) are only accessible over DAP and not via processor. + Therefore they are not covered by the SC000 header file. + @{ + */ +/*@} end of group CMSIS_CoreDebug */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_core_bitfield Core register bit field macros + \brief Macros for use with bit field definitions (xxx_Pos, xxx_Msk). + @{ + */ + +/** + \brief Mask and shift a bit field value for use in a register bit range. + \param[in] field Name of the register bit field. + \param[in] value Value of the bit field. + \return Masked and shifted value. +*/ +#define _VAL2FLD(field, value) ((value << field ## _Pos) & field ## _Msk) + +/** + \brief Mask and shift a register value to extract a bit filed value. + \param[in] field Name of the register bit field. + \param[in] value Value of register. + \return Masked and shifted bit field value. +*/ +#define _FLD2VAL(field, value) ((value & field ## _Msk) >> field ## _Pos) + +/*@} end of group CMSIS_core_bitfield */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_core_base Core Definitions + \brief Definitions for base addresses, unions, and structures. + @{ + */ + +/* Memory mapping of SC000 Hardware */ +#define SCS_BASE (0xE000E000UL) /*!< System Control Space Base Address */ +#define SysTick_BASE (SCS_BASE + 0x0010UL) /*!< SysTick Base Address */ +#define NVIC_BASE (SCS_BASE + 0x0100UL) /*!< NVIC Base Address */ +#define SCB_BASE (SCS_BASE + 0x0D00UL) /*!< System Control Block Base Address */ + +#define SCnSCB ((SCnSCB_Type *) SCS_BASE ) /*!< System control Register not in SCB */ +#define SCB ((SCB_Type *) SCB_BASE ) /*!< SCB configuration struct */ +#define SysTick ((SysTick_Type *) SysTick_BASE ) /*!< SysTick configuration struct */ +#define NVIC ((NVIC_Type *) NVIC_BASE ) /*!< NVIC configuration struct */ + +#if (__MPU_PRESENT == 1U) + #define MPU_BASE (SCS_BASE + 0x0D90UL) /*!< Memory Protection Unit */ + #define MPU ((MPU_Type *) MPU_BASE ) /*!< Memory Protection Unit */ +#endif + +/*@} */ + + + +/******************************************************************************* + * Hardware Abstraction Layer + Core Function Interface contains: + - Core NVIC Functions + - Core SysTick Functions + - Core Register Access Functions + ******************************************************************************/ +/** + \defgroup CMSIS_Core_FunctionInterface Functions and Instructions Reference +*/ + + + +/* ########################## NVIC functions #################################### */ +/** + \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_NVICFunctions NVIC Functions + \brief Functions that manage interrupts and exceptions via the NVIC. + @{ + */ + +/* Interrupt Priorities are WORD accessible only under ARMv6M */ +/* The following MACROS handle generation of the register offset and byte masks */ +#define _BIT_SHIFT(IRQn) ( ((((uint32_t)(int32_t)(IRQn)) ) & 0x03UL) * 8UL) +#define _SHP_IDX(IRQn) ( (((((uint32_t)(int32_t)(IRQn)) & 0x0FUL)-8UL) >> 2UL) ) +#define _IP_IDX(IRQn) ( (((uint32_t)(int32_t)(IRQn)) >> 2UL) ) + + +/** + \brief Enable External Interrupt + \details Enables a device-specific interrupt in the NVIC interrupt controller. + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_EnableIRQ(IRQn_Type IRQn) +{ + NVIC->ISER[0U] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Disable External Interrupt + \details Disables a device-specific interrupt in the NVIC interrupt controller. + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_DisableIRQ(IRQn_Type IRQn) +{ + NVIC->ICER[0U] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Get Pending Interrupt + \details Reads the pending register in the NVIC and returns the pending bit for the specified interrupt. + \param [in] IRQn Interrupt number. + \return 0 Interrupt status is not pending. + \return 1 Interrupt status is pending. + */ +__STATIC_INLINE uint32_t NVIC_GetPendingIRQ(IRQn_Type IRQn) +{ + return((uint32_t)(((NVIC->ISPR[0U] & (1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL))) != 0UL) ? 1UL : 0UL)); +} + + +/** + \brief Set Pending Interrupt + \details Sets the pending bit of an external interrupt. + \param [in] IRQn Interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_SetPendingIRQ(IRQn_Type IRQn) +{ + NVIC->ISPR[0U] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Clear Pending Interrupt + \details Clears the pending bit of an external interrupt. + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_ClearPendingIRQ(IRQn_Type IRQn) +{ + NVIC->ICPR[0U] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Set Interrupt Priority + \details Sets the priority of an interrupt. + \note The priority cannot be set for every core interrupt. + \param [in] IRQn Interrupt number. + \param [in] priority Priority to set. + */ +__STATIC_INLINE void NVIC_SetPriority(IRQn_Type IRQn, uint32_t priority) +{ + if ((int32_t)(IRQn) < 0) + { + SCB->SHP[_SHP_IDX(IRQn)] = ((uint32_t)(SCB->SHP[_SHP_IDX(IRQn)] & ~(0xFFUL << _BIT_SHIFT(IRQn))) | + (((priority << (8U - __NVIC_PRIO_BITS)) & (uint32_t)0xFFUL) << _BIT_SHIFT(IRQn))); + } + else + { + NVIC->IP[_IP_IDX(IRQn)] = ((uint32_t)(NVIC->IP[_IP_IDX(IRQn)] & ~(0xFFUL << _BIT_SHIFT(IRQn))) | + (((priority << (8U - __NVIC_PRIO_BITS)) & (uint32_t)0xFFUL) << _BIT_SHIFT(IRQn))); + } +} + + +/** + \brief Get Interrupt Priority + \details Reads the priority of an interrupt. + The interrupt number can be positive to specify an external (device specific) interrupt, + or negative to specify an internal (core) interrupt. + \param [in] IRQn Interrupt number. + \return Interrupt Priority. + Value is aligned automatically to the implemented priority bits of the microcontroller. + */ +__STATIC_INLINE uint32_t NVIC_GetPriority(IRQn_Type IRQn) +{ + + if ((int32_t)(IRQn) < 0) + { + return((uint32_t)(((SCB->SHP[_SHP_IDX(IRQn)] >> _BIT_SHIFT(IRQn) ) & (uint32_t)0xFFUL) >> (8U - __NVIC_PRIO_BITS))); + } + else + { + return((uint32_t)(((NVIC->IP[ _IP_IDX(IRQn)] >> _BIT_SHIFT(IRQn) ) & (uint32_t)0xFFUL) >> (8U - __NVIC_PRIO_BITS))); + } +} + + +/** + \brief System Reset + \details Initiates a system reset request to reset the MCU. + */ +__STATIC_INLINE void NVIC_SystemReset(void) +{ + __DSB(); /* Ensure all outstanding memory accesses included + buffered write are completed before reset */ + SCB->AIRCR = ((0x5FAUL << SCB_AIRCR_VECTKEY_Pos) | + SCB_AIRCR_SYSRESETREQ_Msk); + __DSB(); /* Ensure completion of memory access */ + + for(;;) /* wait until reset */ + { + __NOP(); + } +} + +/*@} end of CMSIS_Core_NVICFunctions */ + + + +/* ################################## SysTick function ############################################ */ +/** + \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_SysTickFunctions SysTick Functions + \brief Functions that configure the System. + @{ + */ + +#if (__Vendor_SysTickConfig == 0U) + +/** + \brief System Tick Configuration + \details Initializes the System Timer and its interrupt, and starts the System Tick Timer. + Counter is in free running mode to generate periodic interrupts. + \param [in] ticks Number of ticks between two interrupts. + \return 0 Function succeeded. + \return 1 Function failed. + \note When the variable __Vendor_SysTickConfig is set to 1, then the + function SysTick_Config is not included. In this case, the file device.h + must contain a vendor-specific implementation of this function. + */ +__STATIC_INLINE uint32_t SysTick_Config(uint32_t ticks) +{ + if ((ticks - 1UL) > SysTick_LOAD_RELOAD_Msk) + { + return (1UL); /* Reload value impossible */ + } + + SysTick->LOAD = (uint32_t)(ticks - 1UL); /* set reload register */ + NVIC_SetPriority (SysTick_IRQn, (1UL << __NVIC_PRIO_BITS) - 1UL); /* set Priority for Systick Interrupt */ + SysTick->VAL = 0UL; /* Load the SysTick Counter Value */ + SysTick->CTRL = SysTick_CTRL_CLKSOURCE_Msk | + SysTick_CTRL_TICKINT_Msk | + SysTick_CTRL_ENABLE_Msk; /* Enable SysTick IRQ and SysTick Timer */ + return (0UL); /* Function successful */ +} + +#endif + +/*@} end of CMSIS_Core_SysTickFunctions */ + + + + +#ifdef __cplusplus +} +#endif + +#endif /* __CORE_SC000_H_DEPENDANT */ + +#endif /* __CMSIS_GENERIC */ diff --git a/bsp/nuvoton/libraries/m480/CMSIS/Include/core_sc300.h b/bsp/nuvoton/libraries/m480/CMSIS/Include/core_sc300.h new file mode 100644 index 00000000000..8bd18aa318a --- /dev/null +++ b/bsp/nuvoton/libraries/m480/CMSIS/Include/core_sc300.h @@ -0,0 +1,1745 @@ +/**************************************************************************//** + * @file core_sc300.h + * @brief CMSIS SC300 Core Peripheral Access Layer Header File + * @version V4.30 + * @date 20. October 2015 + ******************************************************************************/ +/* Copyright (c) 2009 - 2015 ARM LIMITED + + All rights reserved. + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are met: + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + - Neither the name of ARM nor the names of its contributors may be used + to endorse or promote products derived from this software without + specific prior written permission. + * + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE + LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + ---------------------------------------------------------------------------*/ + + +#if defined ( __ICCARM__ ) + #pragma system_include /* treat file as system include file for MISRA check */ +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #pragma clang system_header /* treat file as system include file */ +#endif + +#ifndef __CORE_SC300_H_GENERIC +#define __CORE_SC300_H_GENERIC + +#include + +#ifdef __cplusplus + extern "C" { +#endif + +/** + \page CMSIS_MISRA_Exceptions MISRA-C:2004 Compliance Exceptions + CMSIS violates the following MISRA-C:2004 rules: + + \li Required Rule 8.5, object/function definition in header file.
+ Function definitions in header files are used to allow 'inlining'. + + \li Required Rule 18.4, declaration of union type or object of union type: '{...}'.
+ Unions are used for effective representation of core registers. + + \li Advisory Rule 19.7, Function-like macro defined.
+ Function-like macros are used to allow more efficient code. + */ + + +/******************************************************************************* + * CMSIS definitions + ******************************************************************************/ +/** + \ingroup SC3000 + @{ + */ + +/* CMSIS SC300 definitions */ +#define __SC300_CMSIS_VERSION_MAIN (0x04U) /*!< [31:16] CMSIS HAL main version */ +#define __SC300_CMSIS_VERSION_SUB (0x1EU) /*!< [15:0] CMSIS HAL sub version */ +#define __SC300_CMSIS_VERSION ((__SC300_CMSIS_VERSION_MAIN << 16U) | \ + __SC300_CMSIS_VERSION_SUB ) /*!< CMSIS HAL version number */ + +#define __CORTEX_SC (300U) /*!< Cortex secure core */ + + +#if defined ( __CC_ARM ) + #define __ASM __asm /*!< asm keyword for ARM Compiler */ + #define __INLINE __inline /*!< inline keyword for ARM Compiler */ + #define __STATIC_INLINE static __inline + +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #define __ASM __asm /*!< asm keyword for ARM Compiler */ + #define __INLINE __inline /*!< inline keyword for ARM Compiler */ + #define __STATIC_INLINE static __inline + +#elif defined ( __GNUC__ ) + #define __ASM __asm /*!< asm keyword for GNU Compiler */ + #define __INLINE inline /*!< inline keyword for GNU Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __ICCARM__ ) + #define __ASM __asm /*!< asm keyword for IAR Compiler */ + #define __INLINE inline /*!< inline keyword for IAR Compiler. Only available in High optimization mode! */ + #define __STATIC_INLINE static inline + +#elif defined ( __TMS470__ ) + #define __ASM __asm /*!< asm keyword for TI CCS Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __TASKING__ ) + #define __ASM __asm /*!< asm keyword for TASKING Compiler */ + #define __INLINE inline /*!< inline keyword for TASKING Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __CSMC__ ) + #define __packed + #define __ASM _asm /*!< asm keyword for COSMIC Compiler */ + #define __INLINE inline /*!< inline keyword for COSMIC Compiler. Use -pc99 on compile line */ + #define __STATIC_INLINE static inline + +#else + #error Unknown compiler +#endif + +/** __FPU_USED indicates whether an FPU is used or not. + This core does not support an FPU at all +*/ +#define __FPU_USED 0U + +#if defined ( __CC_ARM ) + #if defined __TARGET_FPU_VFP + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #if defined __ARM_PCS_VFP + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __GNUC__ ) + #if defined (__VFP_FP__) && !defined(__SOFTFP__) + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __ICCARM__ ) + #if defined __ARMVFP__ + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __TMS470__ ) + #if defined __TI_VFP_SUPPORT__ + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __TASKING__ ) + #if defined __FPU_VFP__ + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#elif defined ( __CSMC__ ) + #if ( __CSMC__ & 0x400U) + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #endif + +#endif + +#include "core_cmInstr.h" /* Core Instruction Access */ +#include "core_cmFunc.h" /* Core Function Access */ + +#ifdef __cplusplus +} +#endif + +#endif /* __CORE_SC300_H_GENERIC */ + +#ifndef __CMSIS_GENERIC + +#ifndef __CORE_SC300_H_DEPENDANT +#define __CORE_SC300_H_DEPENDANT + +#ifdef __cplusplus + extern "C" { +#endif + +/* check device defines and use defaults */ +#if defined __CHECK_DEVICE_DEFINES + #ifndef __SC300_REV + #define __SC300_REV 0x0000U + #warning "__SC300_REV not defined in device header file; using default!" + #endif + + #ifndef __MPU_PRESENT + #define __MPU_PRESENT 0U + #warning "__MPU_PRESENT not defined in device header file; using default!" + #endif + + #ifndef __NVIC_PRIO_BITS + #define __NVIC_PRIO_BITS 4U + #warning "__NVIC_PRIO_BITS not defined in device header file; using default!" + #endif + + #ifndef __Vendor_SysTickConfig + #define __Vendor_SysTickConfig 0U + #warning "__Vendor_SysTickConfig not defined in device header file; using default!" + #endif +#endif + +/* IO definitions (access restrictions to peripheral registers) */ +/** + \defgroup CMSIS_glob_defs CMSIS Global Defines + + IO Type Qualifiers are used + \li to specify the access to peripheral variables. + \li for automatic generation of peripheral register debug information. +*/ +#ifdef __cplusplus + #define __I volatile /*!< Defines 'read only' permissions */ +#else + #define __I volatile const /*!< Defines 'read only' permissions */ +#endif +#define __O volatile /*!< Defines 'write only' permissions */ +#define __IO volatile /*!< Defines 'read / write' permissions */ + +/* following defines should be used for structure members */ +#define __IM volatile const /*! Defines 'read only' structure member permissions */ +#define __OM volatile /*! Defines 'write only' structure member permissions */ +#define __IOM volatile /*! Defines 'read / write' structure member permissions */ + +/*@} end of group SC300 */ + + + +/******************************************************************************* + * Register Abstraction + Core Register contain: + - Core Register + - Core NVIC Register + - Core SCB Register + - Core SysTick Register + - Core Debug Register + - Core MPU Register + ******************************************************************************/ +/** + \defgroup CMSIS_core_register Defines and Type Definitions + \brief Type definitions and defines for Cortex-M processor based devices. +*/ + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_CORE Status and Control Registers + \brief Core Register type definitions. + @{ + */ + +/** + \brief Union type to access the Application Program Status Register (APSR). + */ +typedef union +{ + struct + { + uint32_t _reserved0:27; /*!< bit: 0..26 Reserved */ + uint32_t Q:1; /*!< bit: 27 Saturation condition flag */ + uint32_t V:1; /*!< bit: 28 Overflow condition code flag */ + uint32_t C:1; /*!< bit: 29 Carry condition code flag */ + uint32_t Z:1; /*!< bit: 30 Zero condition code flag */ + uint32_t N:1; /*!< bit: 31 Negative condition code flag */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} APSR_Type; + +/* APSR Register Definitions */ +#define APSR_N_Pos 31U /*!< APSR: N Position */ +#define APSR_N_Msk (1UL << APSR_N_Pos) /*!< APSR: N Mask */ + +#define APSR_Z_Pos 30U /*!< APSR: Z Position */ +#define APSR_Z_Msk (1UL << APSR_Z_Pos) /*!< APSR: Z Mask */ + +#define APSR_C_Pos 29U /*!< APSR: C Position */ +#define APSR_C_Msk (1UL << APSR_C_Pos) /*!< APSR: C Mask */ + +#define APSR_V_Pos 28U /*!< APSR: V Position */ +#define APSR_V_Msk (1UL << APSR_V_Pos) /*!< APSR: V Mask */ + +#define APSR_Q_Pos 27U /*!< APSR: Q Position */ +#define APSR_Q_Msk (1UL << APSR_Q_Pos) /*!< APSR: Q Mask */ + + +/** + \brief Union type to access the Interrupt Program Status Register (IPSR). + */ +typedef union +{ + struct + { + uint32_t ISR:9; /*!< bit: 0.. 8 Exception number */ + uint32_t _reserved0:23; /*!< bit: 9..31 Reserved */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} IPSR_Type; + +/* IPSR Register Definitions */ +#define IPSR_ISR_Pos 0U /*!< IPSR: ISR Position */ +#define IPSR_ISR_Msk (0x1FFUL /*<< IPSR_ISR_Pos*/) /*!< IPSR: ISR Mask */ + + +/** + \brief Union type to access the Special-Purpose Program Status Registers (xPSR). + */ +typedef union +{ + struct + { + uint32_t ISR:9; /*!< bit: 0.. 8 Exception number */ + uint32_t _reserved0:15; /*!< bit: 9..23 Reserved */ + uint32_t T:1; /*!< bit: 24 Thumb bit (read 0) */ + uint32_t IT:2; /*!< bit: 25..26 saved IT state (read 0) */ + uint32_t Q:1; /*!< bit: 27 Saturation condition flag */ + uint32_t V:1; /*!< bit: 28 Overflow condition code flag */ + uint32_t C:1; /*!< bit: 29 Carry condition code flag */ + uint32_t Z:1; /*!< bit: 30 Zero condition code flag */ + uint32_t N:1; /*!< bit: 31 Negative condition code flag */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} xPSR_Type; + +/* xPSR Register Definitions */ +#define xPSR_N_Pos 31U /*!< xPSR: N Position */ +#define xPSR_N_Msk (1UL << xPSR_N_Pos) /*!< xPSR: N Mask */ + +#define xPSR_Z_Pos 30U /*!< xPSR: Z Position */ +#define xPSR_Z_Msk (1UL << xPSR_Z_Pos) /*!< xPSR: Z Mask */ + +#define xPSR_C_Pos 29U /*!< xPSR: C Position */ +#define xPSR_C_Msk (1UL << xPSR_C_Pos) /*!< xPSR: C Mask */ + +#define xPSR_V_Pos 28U /*!< xPSR: V Position */ +#define xPSR_V_Msk (1UL << xPSR_V_Pos) /*!< xPSR: V Mask */ + +#define xPSR_Q_Pos 27U /*!< xPSR: Q Position */ +#define xPSR_Q_Msk (1UL << xPSR_Q_Pos) /*!< xPSR: Q Mask */ + +#define xPSR_IT_Pos 25U /*!< xPSR: IT Position */ +#define xPSR_IT_Msk (3UL << xPSR_IT_Pos) /*!< xPSR: IT Mask */ + +#define xPSR_T_Pos 24U /*!< xPSR: T Position */ +#define xPSR_T_Msk (1UL << xPSR_T_Pos) /*!< xPSR: T Mask */ + +#define xPSR_ISR_Pos 0U /*!< xPSR: ISR Position */ +#define xPSR_ISR_Msk (0x1FFUL /*<< xPSR_ISR_Pos*/) /*!< xPSR: ISR Mask */ + + +/** + \brief Union type to access the Control Registers (CONTROL). + */ +typedef union +{ + struct + { + uint32_t nPRIV:1; /*!< bit: 0 Execution privilege in Thread mode */ + uint32_t SPSEL:1; /*!< bit: 1 Stack to be used */ + uint32_t _reserved1:30; /*!< bit: 2..31 Reserved */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} CONTROL_Type; + +/* CONTROL Register Definitions */ +#define CONTROL_SPSEL_Pos 1U /*!< CONTROL: SPSEL Position */ +#define CONTROL_SPSEL_Msk (1UL << CONTROL_SPSEL_Pos) /*!< CONTROL: SPSEL Mask */ + +#define CONTROL_nPRIV_Pos 0U /*!< CONTROL: nPRIV Position */ +#define CONTROL_nPRIV_Msk (1UL /*<< CONTROL_nPRIV_Pos*/) /*!< CONTROL: nPRIV Mask */ + +/*@} end of group CMSIS_CORE */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_NVIC Nested Vectored Interrupt Controller (NVIC) + \brief Type definitions for the NVIC Registers + @{ + */ + +/** + \brief Structure type to access the Nested Vectored Interrupt Controller (NVIC). + */ +typedef struct +{ + __IOM uint32_t ISER[8U]; /*!< Offset: 0x000 (R/W) Interrupt Set Enable Register */ + uint32_t RESERVED0[24U]; + __IOM uint32_t ICER[8U]; /*!< Offset: 0x080 (R/W) Interrupt Clear Enable Register */ + uint32_t RSERVED1[24U]; + __IOM uint32_t ISPR[8U]; /*!< Offset: 0x100 (R/W) Interrupt Set Pending Register */ + uint32_t RESERVED2[24U]; + __IOM uint32_t ICPR[8U]; /*!< Offset: 0x180 (R/W) Interrupt Clear Pending Register */ + uint32_t RESERVED3[24U]; + __IOM uint32_t IABR[8U]; /*!< Offset: 0x200 (R/W) Interrupt Active bit Register */ + uint32_t RESERVED4[56U]; + __IOM uint8_t IP[240U]; /*!< Offset: 0x300 (R/W) Interrupt Priority Register (8Bit wide) */ + uint32_t RESERVED5[644U]; + __OM uint32_t STIR; /*!< Offset: 0xE00 ( /W) Software Trigger Interrupt Register */ +} NVIC_Type; + +/* Software Triggered Interrupt Register Definitions */ +#define NVIC_STIR_INTID_Pos 0U /*!< STIR: INTLINESNUM Position */ +#define NVIC_STIR_INTID_Msk (0x1FFUL /*<< NVIC_STIR_INTID_Pos*/) /*!< STIR: INTLINESNUM Mask */ + +/*@} end of group CMSIS_NVIC */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_SCB System Control Block (SCB) + \brief Type definitions for the System Control Block Registers + @{ + */ + +/** + \brief Structure type to access the System Control Block (SCB). + */ +typedef struct +{ + __IM uint32_t CPUID; /*!< Offset: 0x000 (R/ ) CPUID Base Register */ + __IOM uint32_t ICSR; /*!< Offset: 0x004 (R/W) Interrupt Control and State Register */ + __IOM uint32_t VTOR; /*!< Offset: 0x008 (R/W) Vector Table Offset Register */ + __IOM uint32_t AIRCR; /*!< Offset: 0x00C (R/W) Application Interrupt and Reset Control Register */ + __IOM uint32_t SCR; /*!< Offset: 0x010 (R/W) System Control Register */ + __IOM uint32_t CCR; /*!< Offset: 0x014 (R/W) Configuration Control Register */ + __IOM uint8_t SHP[12U]; /*!< Offset: 0x018 (R/W) System Handlers Priority Registers (4-7, 8-11, 12-15) */ + __IOM uint32_t SHCSR; /*!< Offset: 0x024 (R/W) System Handler Control and State Register */ + __IOM uint32_t CFSR; /*!< Offset: 0x028 (R/W) Configurable Fault Status Register */ + __IOM uint32_t HFSR; /*!< Offset: 0x02C (R/W) HardFault Status Register */ + __IOM uint32_t DFSR; /*!< Offset: 0x030 (R/W) Debug Fault Status Register */ + __IOM uint32_t MMFAR; /*!< Offset: 0x034 (R/W) MemManage Fault Address Register */ + __IOM uint32_t BFAR; /*!< Offset: 0x038 (R/W) BusFault Address Register */ + __IOM uint32_t AFSR; /*!< Offset: 0x03C (R/W) Auxiliary Fault Status Register */ + __IM uint32_t PFR[2U]; /*!< Offset: 0x040 (R/ ) Processor Feature Register */ + __IM uint32_t DFR; /*!< Offset: 0x048 (R/ ) Debug Feature Register */ + __IM uint32_t ADR; /*!< Offset: 0x04C (R/ ) Auxiliary Feature Register */ + __IM uint32_t MMFR[4U]; /*!< Offset: 0x050 (R/ ) Memory Model Feature Register */ + __IM uint32_t ISAR[5U]; /*!< Offset: 0x060 (R/ ) Instruction Set Attributes Register */ + uint32_t RESERVED0[5U]; + __IOM uint32_t CPACR; /*!< Offset: 0x088 (R/W) Coprocessor Access Control Register */ + uint32_t RESERVED1[129U]; + __IOM uint32_t SFCR; /*!< Offset: 0x290 (R/W) Security Features Control Register */ +} SCB_Type; + +/* SCB CPUID Register Definitions */ +#define SCB_CPUID_IMPLEMENTER_Pos 24U /*!< SCB CPUID: IMPLEMENTER Position */ +#define SCB_CPUID_IMPLEMENTER_Msk (0xFFUL << SCB_CPUID_IMPLEMENTER_Pos) /*!< SCB CPUID: IMPLEMENTER Mask */ + +#define SCB_CPUID_VARIANT_Pos 20U /*!< SCB CPUID: VARIANT Position */ +#define SCB_CPUID_VARIANT_Msk (0xFUL << SCB_CPUID_VARIANT_Pos) /*!< SCB CPUID: VARIANT Mask */ + +#define SCB_CPUID_ARCHITECTURE_Pos 16U /*!< SCB CPUID: ARCHITECTURE Position */ +#define SCB_CPUID_ARCHITECTURE_Msk (0xFUL << SCB_CPUID_ARCHITECTURE_Pos) /*!< SCB CPUID: ARCHITECTURE Mask */ + +#define SCB_CPUID_PARTNO_Pos 4U /*!< SCB CPUID: PARTNO Position */ +#define SCB_CPUID_PARTNO_Msk (0xFFFUL << SCB_CPUID_PARTNO_Pos) /*!< SCB CPUID: PARTNO Mask */ + +#define SCB_CPUID_REVISION_Pos 0U /*!< SCB CPUID: REVISION Position */ +#define SCB_CPUID_REVISION_Msk (0xFUL /*<< SCB_CPUID_REVISION_Pos*/) /*!< SCB CPUID: REVISION Mask */ + +/* SCB Interrupt Control State Register Definitions */ +#define SCB_ICSR_NMIPENDSET_Pos 31U /*!< SCB ICSR: NMIPENDSET Position */ +#define SCB_ICSR_NMIPENDSET_Msk (1UL << SCB_ICSR_NMIPENDSET_Pos) /*!< SCB ICSR: NMIPENDSET Mask */ + +#define SCB_ICSR_PENDSVSET_Pos 28U /*!< SCB ICSR: PENDSVSET Position */ +#define SCB_ICSR_PENDSVSET_Msk (1UL << SCB_ICSR_PENDSVSET_Pos) /*!< SCB ICSR: PENDSVSET Mask */ + +#define SCB_ICSR_PENDSVCLR_Pos 27U /*!< SCB ICSR: PENDSVCLR Position */ +#define SCB_ICSR_PENDSVCLR_Msk (1UL << SCB_ICSR_PENDSVCLR_Pos) /*!< SCB ICSR: PENDSVCLR Mask */ + +#define SCB_ICSR_PENDSTSET_Pos 26U /*!< SCB ICSR: PENDSTSET Position */ +#define SCB_ICSR_PENDSTSET_Msk (1UL << SCB_ICSR_PENDSTSET_Pos) /*!< SCB ICSR: PENDSTSET Mask */ + +#define SCB_ICSR_PENDSTCLR_Pos 25U /*!< SCB ICSR: PENDSTCLR Position */ +#define SCB_ICSR_PENDSTCLR_Msk (1UL << SCB_ICSR_PENDSTCLR_Pos) /*!< SCB ICSR: PENDSTCLR Mask */ + +#define SCB_ICSR_ISRPREEMPT_Pos 23U /*!< SCB ICSR: ISRPREEMPT Position */ +#define SCB_ICSR_ISRPREEMPT_Msk (1UL << SCB_ICSR_ISRPREEMPT_Pos) /*!< SCB ICSR: ISRPREEMPT Mask */ + +#define SCB_ICSR_ISRPENDING_Pos 22U /*!< SCB ICSR: ISRPENDING Position */ +#define SCB_ICSR_ISRPENDING_Msk (1UL << SCB_ICSR_ISRPENDING_Pos) /*!< SCB ICSR: ISRPENDING Mask */ + +#define SCB_ICSR_VECTPENDING_Pos 12U /*!< SCB ICSR: VECTPENDING Position */ +#define SCB_ICSR_VECTPENDING_Msk (0x1FFUL << SCB_ICSR_VECTPENDING_Pos) /*!< SCB ICSR: VECTPENDING Mask */ + +#define SCB_ICSR_RETTOBASE_Pos 11U /*!< SCB ICSR: RETTOBASE Position */ +#define SCB_ICSR_RETTOBASE_Msk (1UL << SCB_ICSR_RETTOBASE_Pos) /*!< SCB ICSR: RETTOBASE Mask */ + +#define SCB_ICSR_VECTACTIVE_Pos 0U /*!< SCB ICSR: VECTACTIVE Position */ +#define SCB_ICSR_VECTACTIVE_Msk (0x1FFUL /*<< SCB_ICSR_VECTACTIVE_Pos*/) /*!< SCB ICSR: VECTACTIVE Mask */ + +/* SCB Vector Table Offset Register Definitions */ +#define SCB_VTOR_TBLBASE_Pos 29U /*!< SCB VTOR: TBLBASE Position */ +#define SCB_VTOR_TBLBASE_Msk (1UL << SCB_VTOR_TBLBASE_Pos) /*!< SCB VTOR: TBLBASE Mask */ + +#define SCB_VTOR_TBLOFF_Pos 7U /*!< SCB VTOR: TBLOFF Position */ +#define SCB_VTOR_TBLOFF_Msk (0x3FFFFFUL << SCB_VTOR_TBLOFF_Pos) /*!< SCB VTOR: TBLOFF Mask */ + +/* SCB Application Interrupt and Reset Control Register Definitions */ +#define SCB_AIRCR_VECTKEY_Pos 16U /*!< SCB AIRCR: VECTKEY Position */ +#define SCB_AIRCR_VECTKEY_Msk (0xFFFFUL << SCB_AIRCR_VECTKEY_Pos) /*!< SCB AIRCR: VECTKEY Mask */ + +#define SCB_AIRCR_VECTKEYSTAT_Pos 16U /*!< SCB AIRCR: VECTKEYSTAT Position */ +#define SCB_AIRCR_VECTKEYSTAT_Msk (0xFFFFUL << SCB_AIRCR_VECTKEYSTAT_Pos) /*!< SCB AIRCR: VECTKEYSTAT Mask */ + +#define SCB_AIRCR_ENDIANESS_Pos 15U /*!< SCB AIRCR: ENDIANESS Position */ +#define SCB_AIRCR_ENDIANESS_Msk (1UL << SCB_AIRCR_ENDIANESS_Pos) /*!< SCB AIRCR: ENDIANESS Mask */ + +#define SCB_AIRCR_PRIGROUP_Pos 8U /*!< SCB AIRCR: PRIGROUP Position */ +#define SCB_AIRCR_PRIGROUP_Msk (7UL << SCB_AIRCR_PRIGROUP_Pos) /*!< SCB AIRCR: PRIGROUP Mask */ + +#define SCB_AIRCR_SYSRESETREQ_Pos 2U /*!< SCB AIRCR: SYSRESETREQ Position */ +#define SCB_AIRCR_SYSRESETREQ_Msk (1UL << SCB_AIRCR_SYSRESETREQ_Pos) /*!< SCB AIRCR: SYSRESETREQ Mask */ + +#define SCB_AIRCR_VECTCLRACTIVE_Pos 1U /*!< SCB AIRCR: VECTCLRACTIVE Position */ +#define SCB_AIRCR_VECTCLRACTIVE_Msk (1UL << SCB_AIRCR_VECTCLRACTIVE_Pos) /*!< SCB AIRCR: VECTCLRACTIVE Mask */ + +#define SCB_AIRCR_VECTRESET_Pos 0U /*!< SCB AIRCR: VECTRESET Position */ +#define SCB_AIRCR_VECTRESET_Msk (1UL /*<< SCB_AIRCR_VECTRESET_Pos*/) /*!< SCB AIRCR: VECTRESET Mask */ + +/* SCB System Control Register Definitions */ +#define SCB_SCR_SEVONPEND_Pos 4U /*!< SCB SCR: SEVONPEND Position */ +#define SCB_SCR_SEVONPEND_Msk (1UL << SCB_SCR_SEVONPEND_Pos) /*!< SCB SCR: SEVONPEND Mask */ + +#define SCB_SCR_SLEEPDEEP_Pos 2U /*!< SCB SCR: SLEEPDEEP Position */ +#define SCB_SCR_SLEEPDEEP_Msk (1UL << SCB_SCR_SLEEPDEEP_Pos) /*!< SCB SCR: SLEEPDEEP Mask */ + +#define SCB_SCR_SLEEPONEXIT_Pos 1U /*!< SCB SCR: SLEEPONEXIT Position */ +#define SCB_SCR_SLEEPONEXIT_Msk (1UL << SCB_SCR_SLEEPONEXIT_Pos) /*!< SCB SCR: SLEEPONEXIT Mask */ + +/* SCB Configuration Control Register Definitions */ +#define SCB_CCR_STKALIGN_Pos 9U /*!< SCB CCR: STKALIGN Position */ +#define SCB_CCR_STKALIGN_Msk (1UL << SCB_CCR_STKALIGN_Pos) /*!< SCB CCR: STKALIGN Mask */ + +#define SCB_CCR_BFHFNMIGN_Pos 8U /*!< SCB CCR: BFHFNMIGN Position */ +#define SCB_CCR_BFHFNMIGN_Msk (1UL << SCB_CCR_BFHFNMIGN_Pos) /*!< SCB CCR: BFHFNMIGN Mask */ + +#define SCB_CCR_DIV_0_TRP_Pos 4U /*!< SCB CCR: DIV_0_TRP Position */ +#define SCB_CCR_DIV_0_TRP_Msk (1UL << SCB_CCR_DIV_0_TRP_Pos) /*!< SCB CCR: DIV_0_TRP Mask */ + +#define SCB_CCR_UNALIGN_TRP_Pos 3U /*!< SCB CCR: UNALIGN_TRP Position */ +#define SCB_CCR_UNALIGN_TRP_Msk (1UL << SCB_CCR_UNALIGN_TRP_Pos) /*!< SCB CCR: UNALIGN_TRP Mask */ + +#define SCB_CCR_USERSETMPEND_Pos 1U /*!< SCB CCR: USERSETMPEND Position */ +#define SCB_CCR_USERSETMPEND_Msk (1UL << SCB_CCR_USERSETMPEND_Pos) /*!< SCB CCR: USERSETMPEND Mask */ + +#define SCB_CCR_NONBASETHRDENA_Pos 0U /*!< SCB CCR: NONBASETHRDENA Position */ +#define SCB_CCR_NONBASETHRDENA_Msk (1UL /*<< SCB_CCR_NONBASETHRDENA_Pos*/) /*!< SCB CCR: NONBASETHRDENA Mask */ + +/* SCB System Handler Control and State Register Definitions */ +#define SCB_SHCSR_USGFAULTENA_Pos 18U /*!< SCB SHCSR: USGFAULTENA Position */ +#define SCB_SHCSR_USGFAULTENA_Msk (1UL << SCB_SHCSR_USGFAULTENA_Pos) /*!< SCB SHCSR: USGFAULTENA Mask */ + +#define SCB_SHCSR_BUSFAULTENA_Pos 17U /*!< SCB SHCSR: BUSFAULTENA Position */ +#define SCB_SHCSR_BUSFAULTENA_Msk (1UL << SCB_SHCSR_BUSFAULTENA_Pos) /*!< SCB SHCSR: BUSFAULTENA Mask */ + +#define SCB_SHCSR_MEMFAULTENA_Pos 16U /*!< SCB SHCSR: MEMFAULTENA Position */ +#define SCB_SHCSR_MEMFAULTENA_Msk (1UL << SCB_SHCSR_MEMFAULTENA_Pos) /*!< SCB SHCSR: MEMFAULTENA Mask */ + +#define SCB_SHCSR_SVCALLPENDED_Pos 15U /*!< SCB SHCSR: SVCALLPENDED Position */ +#define SCB_SHCSR_SVCALLPENDED_Msk (1UL << SCB_SHCSR_SVCALLPENDED_Pos) /*!< SCB SHCSR: SVCALLPENDED Mask */ + +#define SCB_SHCSR_BUSFAULTPENDED_Pos 14U /*!< SCB SHCSR: BUSFAULTPENDED Position */ +#define SCB_SHCSR_BUSFAULTPENDED_Msk (1UL << SCB_SHCSR_BUSFAULTPENDED_Pos) /*!< SCB SHCSR: BUSFAULTPENDED Mask */ + +#define SCB_SHCSR_MEMFAULTPENDED_Pos 13U /*!< SCB SHCSR: MEMFAULTPENDED Position */ +#define SCB_SHCSR_MEMFAULTPENDED_Msk (1UL << SCB_SHCSR_MEMFAULTPENDED_Pos) /*!< SCB SHCSR: MEMFAULTPENDED Mask */ + +#define SCB_SHCSR_USGFAULTPENDED_Pos 12U /*!< SCB SHCSR: USGFAULTPENDED Position */ +#define SCB_SHCSR_USGFAULTPENDED_Msk (1UL << SCB_SHCSR_USGFAULTPENDED_Pos) /*!< SCB SHCSR: USGFAULTPENDED Mask */ + +#define SCB_SHCSR_SYSTICKACT_Pos 11U /*!< SCB SHCSR: SYSTICKACT Position */ +#define SCB_SHCSR_SYSTICKACT_Msk (1UL << SCB_SHCSR_SYSTICKACT_Pos) /*!< SCB SHCSR: SYSTICKACT Mask */ + +#define SCB_SHCSR_PENDSVACT_Pos 10U /*!< SCB SHCSR: PENDSVACT Position */ +#define SCB_SHCSR_PENDSVACT_Msk (1UL << SCB_SHCSR_PENDSVACT_Pos) /*!< SCB SHCSR: PENDSVACT Mask */ + +#define SCB_SHCSR_MONITORACT_Pos 8U /*!< SCB SHCSR: MONITORACT Position */ +#define SCB_SHCSR_MONITORACT_Msk (1UL << SCB_SHCSR_MONITORACT_Pos) /*!< SCB SHCSR: MONITORACT Mask */ + +#define SCB_SHCSR_SVCALLACT_Pos 7U /*!< SCB SHCSR: SVCALLACT Position */ +#define SCB_SHCSR_SVCALLACT_Msk (1UL << SCB_SHCSR_SVCALLACT_Pos) /*!< SCB SHCSR: SVCALLACT Mask */ + +#define SCB_SHCSR_USGFAULTACT_Pos 3U /*!< SCB SHCSR: USGFAULTACT Position */ +#define SCB_SHCSR_USGFAULTACT_Msk (1UL << SCB_SHCSR_USGFAULTACT_Pos) /*!< SCB SHCSR: USGFAULTACT Mask */ + +#define SCB_SHCSR_BUSFAULTACT_Pos 1U /*!< SCB SHCSR: BUSFAULTACT Position */ +#define SCB_SHCSR_BUSFAULTACT_Msk (1UL << SCB_SHCSR_BUSFAULTACT_Pos) /*!< SCB SHCSR: BUSFAULTACT Mask */ + +#define SCB_SHCSR_MEMFAULTACT_Pos 0U /*!< SCB SHCSR: MEMFAULTACT Position */ +#define SCB_SHCSR_MEMFAULTACT_Msk (1UL /*<< SCB_SHCSR_MEMFAULTACT_Pos*/) /*!< SCB SHCSR: MEMFAULTACT Mask */ + +/* SCB Configurable Fault Status Register Definitions */ +#define SCB_CFSR_USGFAULTSR_Pos 16U /*!< SCB CFSR: Usage Fault Status Register Position */ +#define SCB_CFSR_USGFAULTSR_Msk (0xFFFFUL << SCB_CFSR_USGFAULTSR_Pos) /*!< SCB CFSR: Usage Fault Status Register Mask */ + +#define SCB_CFSR_BUSFAULTSR_Pos 8U /*!< SCB CFSR: Bus Fault Status Register Position */ +#define SCB_CFSR_BUSFAULTSR_Msk (0xFFUL << SCB_CFSR_BUSFAULTSR_Pos) /*!< SCB CFSR: Bus Fault Status Register Mask */ + +#define SCB_CFSR_MEMFAULTSR_Pos 0U /*!< SCB CFSR: Memory Manage Fault Status Register Position */ +#define SCB_CFSR_MEMFAULTSR_Msk (0xFFUL /*<< SCB_CFSR_MEMFAULTSR_Pos*/) /*!< SCB CFSR: Memory Manage Fault Status Register Mask */ + +/* SCB Hard Fault Status Register Definitions */ +#define SCB_HFSR_DEBUGEVT_Pos 31U /*!< SCB HFSR: DEBUGEVT Position */ +#define SCB_HFSR_DEBUGEVT_Msk (1UL << SCB_HFSR_DEBUGEVT_Pos) /*!< SCB HFSR: DEBUGEVT Mask */ + +#define SCB_HFSR_FORCED_Pos 30U /*!< SCB HFSR: FORCED Position */ +#define SCB_HFSR_FORCED_Msk (1UL << SCB_HFSR_FORCED_Pos) /*!< SCB HFSR: FORCED Mask */ + +#define SCB_HFSR_VECTTBL_Pos 1U /*!< SCB HFSR: VECTTBL Position */ +#define SCB_HFSR_VECTTBL_Msk (1UL << SCB_HFSR_VECTTBL_Pos) /*!< SCB HFSR: VECTTBL Mask */ + +/* SCB Debug Fault Status Register Definitions */ +#define SCB_DFSR_EXTERNAL_Pos 4U /*!< SCB DFSR: EXTERNAL Position */ +#define SCB_DFSR_EXTERNAL_Msk (1UL << SCB_DFSR_EXTERNAL_Pos) /*!< SCB DFSR: EXTERNAL Mask */ + +#define SCB_DFSR_VCATCH_Pos 3U /*!< SCB DFSR: VCATCH Position */ +#define SCB_DFSR_VCATCH_Msk (1UL << SCB_DFSR_VCATCH_Pos) /*!< SCB DFSR: VCATCH Mask */ + +#define SCB_DFSR_DWTTRAP_Pos 2U /*!< SCB DFSR: DWTTRAP Position */ +#define SCB_DFSR_DWTTRAP_Msk (1UL << SCB_DFSR_DWTTRAP_Pos) /*!< SCB DFSR: DWTTRAP Mask */ + +#define SCB_DFSR_BKPT_Pos 1U /*!< SCB DFSR: BKPT Position */ +#define SCB_DFSR_BKPT_Msk (1UL << SCB_DFSR_BKPT_Pos) /*!< SCB DFSR: BKPT Mask */ + +#define SCB_DFSR_HALTED_Pos 0U /*!< SCB DFSR: HALTED Position */ +#define SCB_DFSR_HALTED_Msk (1UL /*<< SCB_DFSR_HALTED_Pos*/) /*!< SCB DFSR: HALTED Mask */ + +/*@} end of group CMSIS_SCB */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_SCnSCB System Controls not in SCB (SCnSCB) + \brief Type definitions for the System Control and ID Register not in the SCB + @{ + */ + +/** + \brief Structure type to access the System Control and ID Register not in the SCB. + */ +typedef struct +{ + uint32_t RESERVED0[1U]; + __IM uint32_t ICTR; /*!< Offset: 0x004 (R/ ) Interrupt Controller Type Register */ + uint32_t RESERVED1[1U]; +} SCnSCB_Type; + +/* Interrupt Controller Type Register Definitions */ +#define SCnSCB_ICTR_INTLINESNUM_Pos 0U /*!< ICTR: INTLINESNUM Position */ +#define SCnSCB_ICTR_INTLINESNUM_Msk (0xFUL /*<< SCnSCB_ICTR_INTLINESNUM_Pos*/) /*!< ICTR: INTLINESNUM Mask */ + +/*@} end of group CMSIS_SCnotSCB */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_SysTick System Tick Timer (SysTick) + \brief Type definitions for the System Timer Registers. + @{ + */ + +/** + \brief Structure type to access the System Timer (SysTick). + */ +typedef struct +{ + __IOM uint32_t CTRL; /*!< Offset: 0x000 (R/W) SysTick Control and Status Register */ + __IOM uint32_t LOAD; /*!< Offset: 0x004 (R/W) SysTick Reload Value Register */ + __IOM uint32_t VAL; /*!< Offset: 0x008 (R/W) SysTick Current Value Register */ + __IM uint32_t CALIB; /*!< Offset: 0x00C (R/ ) SysTick Calibration Register */ +} SysTick_Type; + +/* SysTick Control / Status Register Definitions */ +#define SysTick_CTRL_COUNTFLAG_Pos 16U /*!< SysTick CTRL: COUNTFLAG Position */ +#define SysTick_CTRL_COUNTFLAG_Msk (1UL << SysTick_CTRL_COUNTFLAG_Pos) /*!< SysTick CTRL: COUNTFLAG Mask */ + +#define SysTick_CTRL_CLKSOURCE_Pos 2U /*!< SysTick CTRL: CLKSOURCE Position */ +#define SysTick_CTRL_CLKSOURCE_Msk (1UL << SysTick_CTRL_CLKSOURCE_Pos) /*!< SysTick CTRL: CLKSOURCE Mask */ + +#define SysTick_CTRL_TICKINT_Pos 1U /*!< SysTick CTRL: TICKINT Position */ +#define SysTick_CTRL_TICKINT_Msk (1UL << SysTick_CTRL_TICKINT_Pos) /*!< SysTick CTRL: TICKINT Mask */ + +#define SysTick_CTRL_ENABLE_Pos 0U /*!< SysTick CTRL: ENABLE Position */ +#define SysTick_CTRL_ENABLE_Msk (1UL /*<< SysTick_CTRL_ENABLE_Pos*/) /*!< SysTick CTRL: ENABLE Mask */ + +/* SysTick Reload Register Definitions */ +#define SysTick_LOAD_RELOAD_Pos 0U /*!< SysTick LOAD: RELOAD Position */ +#define SysTick_LOAD_RELOAD_Msk (0xFFFFFFUL /*<< SysTick_LOAD_RELOAD_Pos*/) /*!< SysTick LOAD: RELOAD Mask */ + +/* SysTick Current Register Definitions */ +#define SysTick_VAL_CURRENT_Pos 0U /*!< SysTick VAL: CURRENT Position */ +#define SysTick_VAL_CURRENT_Msk (0xFFFFFFUL /*<< SysTick_VAL_CURRENT_Pos*/) /*!< SysTick VAL: CURRENT Mask */ + +/* SysTick Calibration Register Definitions */ +#define SysTick_CALIB_NOREF_Pos 31U /*!< SysTick CALIB: NOREF Position */ +#define SysTick_CALIB_NOREF_Msk (1UL << SysTick_CALIB_NOREF_Pos) /*!< SysTick CALIB: NOREF Mask */ + +#define SysTick_CALIB_SKEW_Pos 30U /*!< SysTick CALIB: SKEW Position */ +#define SysTick_CALIB_SKEW_Msk (1UL << SysTick_CALIB_SKEW_Pos) /*!< SysTick CALIB: SKEW Mask */ + +#define SysTick_CALIB_TENMS_Pos 0U /*!< SysTick CALIB: TENMS Position */ +#define SysTick_CALIB_TENMS_Msk (0xFFFFFFUL /*<< SysTick_CALIB_TENMS_Pos*/) /*!< SysTick CALIB: TENMS Mask */ + +/*@} end of group CMSIS_SysTick */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_ITM Instrumentation Trace Macrocell (ITM) + \brief Type definitions for the Instrumentation Trace Macrocell (ITM) + @{ + */ + +/** + \brief Structure type to access the Instrumentation Trace Macrocell Register (ITM). + */ +typedef struct +{ + __OM union + { + __OM uint8_t u8; /*!< Offset: 0x000 ( /W) ITM Stimulus Port 8-bit */ + __OM uint16_t u16; /*!< Offset: 0x000 ( /W) ITM Stimulus Port 16-bit */ + __OM uint32_t u32; /*!< Offset: 0x000 ( /W) ITM Stimulus Port 32-bit */ + } PORT [32U]; /*!< Offset: 0x000 ( /W) ITM Stimulus Port Registers */ + uint32_t RESERVED0[864U]; + __IOM uint32_t TER; /*!< Offset: 0xE00 (R/W) ITM Trace Enable Register */ + uint32_t RESERVED1[15U]; + __IOM uint32_t TPR; /*!< Offset: 0xE40 (R/W) ITM Trace Privilege Register */ + uint32_t RESERVED2[15U]; + __IOM uint32_t TCR; /*!< Offset: 0xE80 (R/W) ITM Trace Control Register */ + uint32_t RESERVED3[29U]; + __OM uint32_t IWR; /*!< Offset: 0xEF8 ( /W) ITM Integration Write Register */ + __IM uint32_t IRR; /*!< Offset: 0xEFC (R/ ) ITM Integration Read Register */ + __IOM uint32_t IMCR; /*!< Offset: 0xF00 (R/W) ITM Integration Mode Control Register */ + uint32_t RESERVED4[43U]; + __OM uint32_t LAR; /*!< Offset: 0xFB0 ( /W) ITM Lock Access Register */ + __IM uint32_t LSR; /*!< Offset: 0xFB4 (R/ ) ITM Lock Status Register */ + uint32_t RESERVED5[6U]; + __IM uint32_t PID4; /*!< Offset: 0xFD0 (R/ ) ITM Peripheral Identification Register #4 */ + __IM uint32_t PID5; /*!< Offset: 0xFD4 (R/ ) ITM Peripheral Identification Register #5 */ + __IM uint32_t PID6; /*!< Offset: 0xFD8 (R/ ) ITM Peripheral Identification Register #6 */ + __IM uint32_t PID7; /*!< Offset: 0xFDC (R/ ) ITM Peripheral Identification Register #7 */ + __IM uint32_t PID0; /*!< Offset: 0xFE0 (R/ ) ITM Peripheral Identification Register #0 */ + __IM uint32_t PID1; /*!< Offset: 0xFE4 (R/ ) ITM Peripheral Identification Register #1 */ + __IM uint32_t PID2; /*!< Offset: 0xFE8 (R/ ) ITM Peripheral Identification Register #2 */ + __IM uint32_t PID3; /*!< Offset: 0xFEC (R/ ) ITM Peripheral Identification Register #3 */ + __IM uint32_t CID0; /*!< Offset: 0xFF0 (R/ ) ITM Component Identification Register #0 */ + __IM uint32_t CID1; /*!< Offset: 0xFF4 (R/ ) ITM Component Identification Register #1 */ + __IM uint32_t CID2; /*!< Offset: 0xFF8 (R/ ) ITM Component Identification Register #2 */ + __IM uint32_t CID3; /*!< Offset: 0xFFC (R/ ) ITM Component Identification Register #3 */ +} ITM_Type; + +/* ITM Trace Privilege Register Definitions */ +#define ITM_TPR_PRIVMASK_Pos 0U /*!< ITM TPR: PRIVMASK Position */ +#define ITM_TPR_PRIVMASK_Msk (0xFUL /*<< ITM_TPR_PRIVMASK_Pos*/) /*!< ITM TPR: PRIVMASK Mask */ + +/* ITM Trace Control Register Definitions */ +#define ITM_TCR_BUSY_Pos 23U /*!< ITM TCR: BUSY Position */ +#define ITM_TCR_BUSY_Msk (1UL << ITM_TCR_BUSY_Pos) /*!< ITM TCR: BUSY Mask */ + +#define ITM_TCR_TraceBusID_Pos 16U /*!< ITM TCR: ATBID Position */ +#define ITM_TCR_TraceBusID_Msk (0x7FUL << ITM_TCR_TraceBusID_Pos) /*!< ITM TCR: ATBID Mask */ + +#define ITM_TCR_GTSFREQ_Pos 10U /*!< ITM TCR: Global timestamp frequency Position */ +#define ITM_TCR_GTSFREQ_Msk (3UL << ITM_TCR_GTSFREQ_Pos) /*!< ITM TCR: Global timestamp frequency Mask */ + +#define ITM_TCR_TSPrescale_Pos 8U /*!< ITM TCR: TSPrescale Position */ +#define ITM_TCR_TSPrescale_Msk (3UL << ITM_TCR_TSPrescale_Pos) /*!< ITM TCR: TSPrescale Mask */ + +#define ITM_TCR_SWOENA_Pos 4U /*!< ITM TCR: SWOENA Position */ +#define ITM_TCR_SWOENA_Msk (1UL << ITM_TCR_SWOENA_Pos) /*!< ITM TCR: SWOENA Mask */ + +#define ITM_TCR_DWTENA_Pos 3U /*!< ITM TCR: DWTENA Position */ +#define ITM_TCR_DWTENA_Msk (1UL << ITM_TCR_DWTENA_Pos) /*!< ITM TCR: DWTENA Mask */ + +#define ITM_TCR_SYNCENA_Pos 2U /*!< ITM TCR: SYNCENA Position */ +#define ITM_TCR_SYNCENA_Msk (1UL << ITM_TCR_SYNCENA_Pos) /*!< ITM TCR: SYNCENA Mask */ + +#define ITM_TCR_TSENA_Pos 1U /*!< ITM TCR: TSENA Position */ +#define ITM_TCR_TSENA_Msk (1UL << ITM_TCR_TSENA_Pos) /*!< ITM TCR: TSENA Mask */ + +#define ITM_TCR_ITMENA_Pos 0U /*!< ITM TCR: ITM Enable bit Position */ +#define ITM_TCR_ITMENA_Msk (1UL /*<< ITM_TCR_ITMENA_Pos*/) /*!< ITM TCR: ITM Enable bit Mask */ + +/* ITM Integration Write Register Definitions */ +#define ITM_IWR_ATVALIDM_Pos 0U /*!< ITM IWR: ATVALIDM Position */ +#define ITM_IWR_ATVALIDM_Msk (1UL /*<< ITM_IWR_ATVALIDM_Pos*/) /*!< ITM IWR: ATVALIDM Mask */ + +/* ITM Integration Read Register Definitions */ +#define ITM_IRR_ATREADYM_Pos 0U /*!< ITM IRR: ATREADYM Position */ +#define ITM_IRR_ATREADYM_Msk (1UL /*<< ITM_IRR_ATREADYM_Pos*/) /*!< ITM IRR: ATREADYM Mask */ + +/* ITM Integration Mode Control Register Definitions */ +#define ITM_IMCR_INTEGRATION_Pos 0U /*!< ITM IMCR: INTEGRATION Position */ +#define ITM_IMCR_INTEGRATION_Msk (1UL /*<< ITM_IMCR_INTEGRATION_Pos*/) /*!< ITM IMCR: INTEGRATION Mask */ + +/* ITM Lock Status Register Definitions */ +#define ITM_LSR_ByteAcc_Pos 2U /*!< ITM LSR: ByteAcc Position */ +#define ITM_LSR_ByteAcc_Msk (1UL << ITM_LSR_ByteAcc_Pos) /*!< ITM LSR: ByteAcc Mask */ + +#define ITM_LSR_Access_Pos 1U /*!< ITM LSR: Access Position */ +#define ITM_LSR_Access_Msk (1UL << ITM_LSR_Access_Pos) /*!< ITM LSR: Access Mask */ + +#define ITM_LSR_Present_Pos 0U /*!< ITM LSR: Present Position */ +#define ITM_LSR_Present_Msk (1UL /*<< ITM_LSR_Present_Pos*/) /*!< ITM LSR: Present Mask */ + +/*@}*/ /* end of group CMSIS_ITM */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_DWT Data Watchpoint and Trace (DWT) + \brief Type definitions for the Data Watchpoint and Trace (DWT) + @{ + */ + +/** + \brief Structure type to access the Data Watchpoint and Trace Register (DWT). + */ +typedef struct +{ + __IOM uint32_t CTRL; /*!< Offset: 0x000 (R/W) Control Register */ + __IOM uint32_t CYCCNT; /*!< Offset: 0x004 (R/W) Cycle Count Register */ + __IOM uint32_t CPICNT; /*!< Offset: 0x008 (R/W) CPI Count Register */ + __IOM uint32_t EXCCNT; /*!< Offset: 0x00C (R/W) Exception Overhead Count Register */ + __IOM uint32_t SLEEPCNT; /*!< Offset: 0x010 (R/W) Sleep Count Register */ + __IOM uint32_t LSUCNT; /*!< Offset: 0x014 (R/W) LSU Count Register */ + __IOM uint32_t FOLDCNT; /*!< Offset: 0x018 (R/W) Folded-instruction Count Register */ + __IM uint32_t PCSR; /*!< Offset: 0x01C (R/ ) Program Counter Sample Register */ + __IOM uint32_t COMP0; /*!< Offset: 0x020 (R/W) Comparator Register 0 */ + __IOM uint32_t MASK0; /*!< Offset: 0x024 (R/W) Mask Register 0 */ + __IOM uint32_t FUNCTION0; /*!< Offset: 0x028 (R/W) Function Register 0 */ + uint32_t RESERVED0[1U]; + __IOM uint32_t COMP1; /*!< Offset: 0x030 (R/W) Comparator Register 1 */ + __IOM uint32_t MASK1; /*!< Offset: 0x034 (R/W) Mask Register 1 */ + __IOM uint32_t FUNCTION1; /*!< Offset: 0x038 (R/W) Function Register 1 */ + uint32_t RESERVED1[1U]; + __IOM uint32_t COMP2; /*!< Offset: 0x040 (R/W) Comparator Register 2 */ + __IOM uint32_t MASK2; /*!< Offset: 0x044 (R/W) Mask Register 2 */ + __IOM uint32_t FUNCTION2; /*!< Offset: 0x048 (R/W) Function Register 2 */ + uint32_t RESERVED2[1U]; + __IOM uint32_t COMP3; /*!< Offset: 0x050 (R/W) Comparator Register 3 */ + __IOM uint32_t MASK3; /*!< Offset: 0x054 (R/W) Mask Register 3 */ + __IOM uint32_t FUNCTION3; /*!< Offset: 0x058 (R/W) Function Register 3 */ +} DWT_Type; + +/* DWT Control Register Definitions */ +#define DWT_CTRL_NUMCOMP_Pos 28U /*!< DWT CTRL: NUMCOMP Position */ +#define DWT_CTRL_NUMCOMP_Msk (0xFUL << DWT_CTRL_NUMCOMP_Pos) /*!< DWT CTRL: NUMCOMP Mask */ + +#define DWT_CTRL_NOTRCPKT_Pos 27U /*!< DWT CTRL: NOTRCPKT Position */ +#define DWT_CTRL_NOTRCPKT_Msk (0x1UL << DWT_CTRL_NOTRCPKT_Pos) /*!< DWT CTRL: NOTRCPKT Mask */ + +#define DWT_CTRL_NOEXTTRIG_Pos 26U /*!< DWT CTRL: NOEXTTRIG Position */ +#define DWT_CTRL_NOEXTTRIG_Msk (0x1UL << DWT_CTRL_NOEXTTRIG_Pos) /*!< DWT CTRL: NOEXTTRIG Mask */ + +#define DWT_CTRL_NOCYCCNT_Pos 25U /*!< DWT CTRL: NOCYCCNT Position */ +#define DWT_CTRL_NOCYCCNT_Msk (0x1UL << DWT_CTRL_NOCYCCNT_Pos) /*!< DWT CTRL: NOCYCCNT Mask */ + +#define DWT_CTRL_NOPRFCNT_Pos 24U /*!< DWT CTRL: NOPRFCNT Position */ +#define DWT_CTRL_NOPRFCNT_Msk (0x1UL << DWT_CTRL_NOPRFCNT_Pos) /*!< DWT CTRL: NOPRFCNT Mask */ + +#define DWT_CTRL_CYCEVTENA_Pos 22U /*!< DWT CTRL: CYCEVTENA Position */ +#define DWT_CTRL_CYCEVTENA_Msk (0x1UL << DWT_CTRL_CYCEVTENA_Pos) /*!< DWT CTRL: CYCEVTENA Mask */ + +#define DWT_CTRL_FOLDEVTENA_Pos 21U /*!< DWT CTRL: FOLDEVTENA Position */ +#define DWT_CTRL_FOLDEVTENA_Msk (0x1UL << DWT_CTRL_FOLDEVTENA_Pos) /*!< DWT CTRL: FOLDEVTENA Mask */ + +#define DWT_CTRL_LSUEVTENA_Pos 20U /*!< DWT CTRL: LSUEVTENA Position */ +#define DWT_CTRL_LSUEVTENA_Msk (0x1UL << DWT_CTRL_LSUEVTENA_Pos) /*!< DWT CTRL: LSUEVTENA Mask */ + +#define DWT_CTRL_SLEEPEVTENA_Pos 19U /*!< DWT CTRL: SLEEPEVTENA Position */ +#define DWT_CTRL_SLEEPEVTENA_Msk (0x1UL << DWT_CTRL_SLEEPEVTENA_Pos) /*!< DWT CTRL: SLEEPEVTENA Mask */ + +#define DWT_CTRL_EXCEVTENA_Pos 18U /*!< DWT CTRL: EXCEVTENA Position */ +#define DWT_CTRL_EXCEVTENA_Msk (0x1UL << DWT_CTRL_EXCEVTENA_Pos) /*!< DWT CTRL: EXCEVTENA Mask */ + +#define DWT_CTRL_CPIEVTENA_Pos 17U /*!< DWT CTRL: CPIEVTENA Position */ +#define DWT_CTRL_CPIEVTENA_Msk (0x1UL << DWT_CTRL_CPIEVTENA_Pos) /*!< DWT CTRL: CPIEVTENA Mask */ + +#define DWT_CTRL_EXCTRCENA_Pos 16U /*!< DWT CTRL: EXCTRCENA Position */ +#define DWT_CTRL_EXCTRCENA_Msk (0x1UL << DWT_CTRL_EXCTRCENA_Pos) /*!< DWT CTRL: EXCTRCENA Mask */ + +#define DWT_CTRL_PCSAMPLENA_Pos 12U /*!< DWT CTRL: PCSAMPLENA Position */ +#define DWT_CTRL_PCSAMPLENA_Msk (0x1UL << DWT_CTRL_PCSAMPLENA_Pos) /*!< DWT CTRL: PCSAMPLENA Mask */ + +#define DWT_CTRL_SYNCTAP_Pos 10U /*!< DWT CTRL: SYNCTAP Position */ +#define DWT_CTRL_SYNCTAP_Msk (0x3UL << DWT_CTRL_SYNCTAP_Pos) /*!< DWT CTRL: SYNCTAP Mask */ + +#define DWT_CTRL_CYCTAP_Pos 9U /*!< DWT CTRL: CYCTAP Position */ +#define DWT_CTRL_CYCTAP_Msk (0x1UL << DWT_CTRL_CYCTAP_Pos) /*!< DWT CTRL: CYCTAP Mask */ + +#define DWT_CTRL_POSTINIT_Pos 5U /*!< DWT CTRL: POSTINIT Position */ +#define DWT_CTRL_POSTINIT_Msk (0xFUL << DWT_CTRL_POSTINIT_Pos) /*!< DWT CTRL: POSTINIT Mask */ + +#define DWT_CTRL_POSTPRESET_Pos 1U /*!< DWT CTRL: POSTPRESET Position */ +#define DWT_CTRL_POSTPRESET_Msk (0xFUL << DWT_CTRL_POSTPRESET_Pos) /*!< DWT CTRL: POSTPRESET Mask */ + +#define DWT_CTRL_CYCCNTENA_Pos 0U /*!< DWT CTRL: CYCCNTENA Position */ +#define DWT_CTRL_CYCCNTENA_Msk (0x1UL /*<< DWT_CTRL_CYCCNTENA_Pos*/) /*!< DWT CTRL: CYCCNTENA Mask */ + +/* DWT CPI Count Register Definitions */ +#define DWT_CPICNT_CPICNT_Pos 0U /*!< DWT CPICNT: CPICNT Position */ +#define DWT_CPICNT_CPICNT_Msk (0xFFUL /*<< DWT_CPICNT_CPICNT_Pos*/) /*!< DWT CPICNT: CPICNT Mask */ + +/* DWT Exception Overhead Count Register Definitions */ +#define DWT_EXCCNT_EXCCNT_Pos 0U /*!< DWT EXCCNT: EXCCNT Position */ +#define DWT_EXCCNT_EXCCNT_Msk (0xFFUL /*<< DWT_EXCCNT_EXCCNT_Pos*/) /*!< DWT EXCCNT: EXCCNT Mask */ + +/* DWT Sleep Count Register Definitions */ +#define DWT_SLEEPCNT_SLEEPCNT_Pos 0U /*!< DWT SLEEPCNT: SLEEPCNT Position */ +#define DWT_SLEEPCNT_SLEEPCNT_Msk (0xFFUL /*<< DWT_SLEEPCNT_SLEEPCNT_Pos*/) /*!< DWT SLEEPCNT: SLEEPCNT Mask */ + +/* DWT LSU Count Register Definitions */ +#define DWT_LSUCNT_LSUCNT_Pos 0U /*!< DWT LSUCNT: LSUCNT Position */ +#define DWT_LSUCNT_LSUCNT_Msk (0xFFUL /*<< DWT_LSUCNT_LSUCNT_Pos*/) /*!< DWT LSUCNT: LSUCNT Mask */ + +/* DWT Folded-instruction Count Register Definitions */ +#define DWT_FOLDCNT_FOLDCNT_Pos 0U /*!< DWT FOLDCNT: FOLDCNT Position */ +#define DWT_FOLDCNT_FOLDCNT_Msk (0xFFUL /*<< DWT_FOLDCNT_FOLDCNT_Pos*/) /*!< DWT FOLDCNT: FOLDCNT Mask */ + +/* DWT Comparator Mask Register Definitions */ +#define DWT_MASK_MASK_Pos 0U /*!< DWT MASK: MASK Position */ +#define DWT_MASK_MASK_Msk (0x1FUL /*<< DWT_MASK_MASK_Pos*/) /*!< DWT MASK: MASK Mask */ + +/* DWT Comparator Function Register Definitions */ +#define DWT_FUNCTION_MATCHED_Pos 24U /*!< DWT FUNCTION: MATCHED Position */ +#define DWT_FUNCTION_MATCHED_Msk (0x1UL << DWT_FUNCTION_MATCHED_Pos) /*!< DWT FUNCTION: MATCHED Mask */ + +#define DWT_FUNCTION_DATAVADDR1_Pos 16U /*!< DWT FUNCTION: DATAVADDR1 Position */ +#define DWT_FUNCTION_DATAVADDR1_Msk (0xFUL << DWT_FUNCTION_DATAVADDR1_Pos) /*!< DWT FUNCTION: DATAVADDR1 Mask */ + +#define DWT_FUNCTION_DATAVADDR0_Pos 12U /*!< DWT FUNCTION: DATAVADDR0 Position */ +#define DWT_FUNCTION_DATAVADDR0_Msk (0xFUL << DWT_FUNCTION_DATAVADDR0_Pos) /*!< DWT FUNCTION: DATAVADDR0 Mask */ + +#define DWT_FUNCTION_DATAVSIZE_Pos 10U /*!< DWT FUNCTION: DATAVSIZE Position */ +#define DWT_FUNCTION_DATAVSIZE_Msk (0x3UL << DWT_FUNCTION_DATAVSIZE_Pos) /*!< DWT FUNCTION: DATAVSIZE Mask */ + +#define DWT_FUNCTION_LNK1ENA_Pos 9U /*!< DWT FUNCTION: LNK1ENA Position */ +#define DWT_FUNCTION_LNK1ENA_Msk (0x1UL << DWT_FUNCTION_LNK1ENA_Pos) /*!< DWT FUNCTION: LNK1ENA Mask */ + +#define DWT_FUNCTION_DATAVMATCH_Pos 8U /*!< DWT FUNCTION: DATAVMATCH Position */ +#define DWT_FUNCTION_DATAVMATCH_Msk (0x1UL << DWT_FUNCTION_DATAVMATCH_Pos) /*!< DWT FUNCTION: DATAVMATCH Mask */ + +#define DWT_FUNCTION_CYCMATCH_Pos 7U /*!< DWT FUNCTION: CYCMATCH Position */ +#define DWT_FUNCTION_CYCMATCH_Msk (0x1UL << DWT_FUNCTION_CYCMATCH_Pos) /*!< DWT FUNCTION: CYCMATCH Mask */ + +#define DWT_FUNCTION_EMITRANGE_Pos 5U /*!< DWT FUNCTION: EMITRANGE Position */ +#define DWT_FUNCTION_EMITRANGE_Msk (0x1UL << DWT_FUNCTION_EMITRANGE_Pos) /*!< DWT FUNCTION: EMITRANGE Mask */ + +#define DWT_FUNCTION_FUNCTION_Pos 0U /*!< DWT FUNCTION: FUNCTION Position */ +#define DWT_FUNCTION_FUNCTION_Msk (0xFUL /*<< DWT_FUNCTION_FUNCTION_Pos*/) /*!< DWT FUNCTION: FUNCTION Mask */ + +/*@}*/ /* end of group CMSIS_DWT */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_TPI Trace Port Interface (TPI) + \brief Type definitions for the Trace Port Interface (TPI) + @{ + */ + +/** + \brief Structure type to access the Trace Port Interface Register (TPI). + */ +typedef struct +{ + __IOM uint32_t SSPSR; /*!< Offset: 0x000 (R/ ) Supported Parallel Port Size Register */ + __IOM uint32_t CSPSR; /*!< Offset: 0x004 (R/W) Current Parallel Port Size Register */ + uint32_t RESERVED0[2U]; + __IOM uint32_t ACPR; /*!< Offset: 0x010 (R/W) Asynchronous Clock Prescaler Register */ + uint32_t RESERVED1[55U]; + __IOM uint32_t SPPR; /*!< Offset: 0x0F0 (R/W) Selected Pin Protocol Register */ + uint32_t RESERVED2[131U]; + __IM uint32_t FFSR; /*!< Offset: 0x300 (R/ ) Formatter and Flush Status Register */ + __IOM uint32_t FFCR; /*!< Offset: 0x304 (R/W) Formatter and Flush Control Register */ + __IM uint32_t FSCR; /*!< Offset: 0x308 (R/ ) Formatter Synchronization Counter Register */ + uint32_t RESERVED3[759U]; + __IM uint32_t TRIGGER; /*!< Offset: 0xEE8 (R/ ) TRIGGER */ + __IM uint32_t FIFO0; /*!< Offset: 0xEEC (R/ ) Integration ETM Data */ + __IM uint32_t ITATBCTR2; /*!< Offset: 0xEF0 (R/ ) ITATBCTR2 */ + uint32_t RESERVED4[1U]; + __IM uint32_t ITATBCTR0; /*!< Offset: 0xEF8 (R/ ) ITATBCTR0 */ + __IM uint32_t FIFO1; /*!< Offset: 0xEFC (R/ ) Integration ITM Data */ + __IOM uint32_t ITCTRL; /*!< Offset: 0xF00 (R/W) Integration Mode Control */ + uint32_t RESERVED5[39U]; + __IOM uint32_t CLAIMSET; /*!< Offset: 0xFA0 (R/W) Claim tag set */ + __IOM uint32_t CLAIMCLR; /*!< Offset: 0xFA4 (R/W) Claim tag clear */ + uint32_t RESERVED7[8U]; + __IM uint32_t DEVID; /*!< Offset: 0xFC8 (R/ ) TPIU_DEVID */ + __IM uint32_t DEVTYPE; /*!< Offset: 0xFCC (R/ ) TPIU_DEVTYPE */ +} TPI_Type; + +/* TPI Asynchronous Clock Prescaler Register Definitions */ +#define TPI_ACPR_PRESCALER_Pos 0U /*!< TPI ACPR: PRESCALER Position */ +#define TPI_ACPR_PRESCALER_Msk (0x1FFFUL /*<< TPI_ACPR_PRESCALER_Pos*/) /*!< TPI ACPR: PRESCALER Mask */ + +/* TPI Selected Pin Protocol Register Definitions */ +#define TPI_SPPR_TXMODE_Pos 0U /*!< TPI SPPR: TXMODE Position */ +#define TPI_SPPR_TXMODE_Msk (0x3UL /*<< TPI_SPPR_TXMODE_Pos*/) /*!< TPI SPPR: TXMODE Mask */ + +/* TPI Formatter and Flush Status Register Definitions */ +#define TPI_FFSR_FtNonStop_Pos 3U /*!< TPI FFSR: FtNonStop Position */ +#define TPI_FFSR_FtNonStop_Msk (0x1UL << TPI_FFSR_FtNonStop_Pos) /*!< TPI FFSR: FtNonStop Mask */ + +#define TPI_FFSR_TCPresent_Pos 2U /*!< TPI FFSR: TCPresent Position */ +#define TPI_FFSR_TCPresent_Msk (0x1UL << TPI_FFSR_TCPresent_Pos) /*!< TPI FFSR: TCPresent Mask */ + +#define TPI_FFSR_FtStopped_Pos 1U /*!< TPI FFSR: FtStopped Position */ +#define TPI_FFSR_FtStopped_Msk (0x1UL << TPI_FFSR_FtStopped_Pos) /*!< TPI FFSR: FtStopped Mask */ + +#define TPI_FFSR_FlInProg_Pos 0U /*!< TPI FFSR: FlInProg Position */ +#define TPI_FFSR_FlInProg_Msk (0x1UL /*<< TPI_FFSR_FlInProg_Pos*/) /*!< TPI FFSR: FlInProg Mask */ + +/* TPI Formatter and Flush Control Register Definitions */ +#define TPI_FFCR_TrigIn_Pos 8U /*!< TPI FFCR: TrigIn Position */ +#define TPI_FFCR_TrigIn_Msk (0x1UL << TPI_FFCR_TrigIn_Pos) /*!< TPI FFCR: TrigIn Mask */ + +#define TPI_FFCR_EnFCont_Pos 1U /*!< TPI FFCR: EnFCont Position */ +#define TPI_FFCR_EnFCont_Msk (0x1UL << TPI_FFCR_EnFCont_Pos) /*!< TPI FFCR: EnFCont Mask */ + +/* TPI TRIGGER Register Definitions */ +#define TPI_TRIGGER_TRIGGER_Pos 0U /*!< TPI TRIGGER: TRIGGER Position */ +#define TPI_TRIGGER_TRIGGER_Msk (0x1UL /*<< TPI_TRIGGER_TRIGGER_Pos*/) /*!< TPI TRIGGER: TRIGGER Mask */ + +/* TPI Integration ETM Data Register Definitions (FIFO0) */ +#define TPI_FIFO0_ITM_ATVALID_Pos 29U /*!< TPI FIFO0: ITM_ATVALID Position */ +#define TPI_FIFO0_ITM_ATVALID_Msk (0x3UL << TPI_FIFO0_ITM_ATVALID_Pos) /*!< TPI FIFO0: ITM_ATVALID Mask */ + +#define TPI_FIFO0_ITM_bytecount_Pos 27U /*!< TPI FIFO0: ITM_bytecount Position */ +#define TPI_FIFO0_ITM_bytecount_Msk (0x3UL << TPI_FIFO0_ITM_bytecount_Pos) /*!< TPI FIFO0: ITM_bytecount Mask */ + +#define TPI_FIFO0_ETM_ATVALID_Pos 26U /*!< TPI FIFO0: ETM_ATVALID Position */ +#define TPI_FIFO0_ETM_ATVALID_Msk (0x3UL << TPI_FIFO0_ETM_ATVALID_Pos) /*!< TPI FIFO0: ETM_ATVALID Mask */ + +#define TPI_FIFO0_ETM_bytecount_Pos 24U /*!< TPI FIFO0: ETM_bytecount Position */ +#define TPI_FIFO0_ETM_bytecount_Msk (0x3UL << TPI_FIFO0_ETM_bytecount_Pos) /*!< TPI FIFO0: ETM_bytecount Mask */ + +#define TPI_FIFO0_ETM2_Pos 16U /*!< TPI FIFO0: ETM2 Position */ +#define TPI_FIFO0_ETM2_Msk (0xFFUL << TPI_FIFO0_ETM2_Pos) /*!< TPI FIFO0: ETM2 Mask */ + +#define TPI_FIFO0_ETM1_Pos 8U /*!< TPI FIFO0: ETM1 Position */ +#define TPI_FIFO0_ETM1_Msk (0xFFUL << TPI_FIFO0_ETM1_Pos) /*!< TPI FIFO0: ETM1 Mask */ + +#define TPI_FIFO0_ETM0_Pos 0U /*!< TPI FIFO0: ETM0 Position */ +#define TPI_FIFO0_ETM0_Msk (0xFFUL /*<< TPI_FIFO0_ETM0_Pos*/) /*!< TPI FIFO0: ETM0 Mask */ + +/* TPI ITATBCTR2 Register Definitions */ +#define TPI_ITATBCTR2_ATREADY_Pos 0U /*!< TPI ITATBCTR2: ATREADY Position */ +#define TPI_ITATBCTR2_ATREADY_Msk (0x1UL /*<< TPI_ITATBCTR2_ATREADY_Pos*/) /*!< TPI ITATBCTR2: ATREADY Mask */ + +/* TPI Integration ITM Data Register Definitions (FIFO1) */ +#define TPI_FIFO1_ITM_ATVALID_Pos 29U /*!< TPI FIFO1: ITM_ATVALID Position */ +#define TPI_FIFO1_ITM_ATVALID_Msk (0x3UL << TPI_FIFO1_ITM_ATVALID_Pos) /*!< TPI FIFO1: ITM_ATVALID Mask */ + +#define TPI_FIFO1_ITM_bytecount_Pos 27U /*!< TPI FIFO1: ITM_bytecount Position */ +#define TPI_FIFO1_ITM_bytecount_Msk (0x3UL << TPI_FIFO1_ITM_bytecount_Pos) /*!< TPI FIFO1: ITM_bytecount Mask */ + +#define TPI_FIFO1_ETM_ATVALID_Pos 26U /*!< TPI FIFO1: ETM_ATVALID Position */ +#define TPI_FIFO1_ETM_ATVALID_Msk (0x3UL << TPI_FIFO1_ETM_ATVALID_Pos) /*!< TPI FIFO1: ETM_ATVALID Mask */ + +#define TPI_FIFO1_ETM_bytecount_Pos 24U /*!< TPI FIFO1: ETM_bytecount Position */ +#define TPI_FIFO1_ETM_bytecount_Msk (0x3UL << TPI_FIFO1_ETM_bytecount_Pos) /*!< TPI FIFO1: ETM_bytecount Mask */ + +#define TPI_FIFO1_ITM2_Pos 16U /*!< TPI FIFO1: ITM2 Position */ +#define TPI_FIFO1_ITM2_Msk (0xFFUL << TPI_FIFO1_ITM2_Pos) /*!< TPI FIFO1: ITM2 Mask */ + +#define TPI_FIFO1_ITM1_Pos 8U /*!< TPI FIFO1: ITM1 Position */ +#define TPI_FIFO1_ITM1_Msk (0xFFUL << TPI_FIFO1_ITM1_Pos) /*!< TPI FIFO1: ITM1 Mask */ + +#define TPI_FIFO1_ITM0_Pos 0U /*!< TPI FIFO1: ITM0 Position */ +#define TPI_FIFO1_ITM0_Msk (0xFFUL /*<< TPI_FIFO1_ITM0_Pos*/) /*!< TPI FIFO1: ITM0 Mask */ + +/* TPI ITATBCTR0 Register Definitions */ +#define TPI_ITATBCTR0_ATREADY_Pos 0U /*!< TPI ITATBCTR0: ATREADY Position */ +#define TPI_ITATBCTR0_ATREADY_Msk (0x1UL /*<< TPI_ITATBCTR0_ATREADY_Pos*/) /*!< TPI ITATBCTR0: ATREADY Mask */ + +/* TPI Integration Mode Control Register Definitions */ +#define TPI_ITCTRL_Mode_Pos 0U /*!< TPI ITCTRL: Mode Position */ +#define TPI_ITCTRL_Mode_Msk (0x1UL /*<< TPI_ITCTRL_Mode_Pos*/) /*!< TPI ITCTRL: Mode Mask */ + +/* TPI DEVID Register Definitions */ +#define TPI_DEVID_NRZVALID_Pos 11U /*!< TPI DEVID: NRZVALID Position */ +#define TPI_DEVID_NRZVALID_Msk (0x1UL << TPI_DEVID_NRZVALID_Pos) /*!< TPI DEVID: NRZVALID Mask */ + +#define TPI_DEVID_MANCVALID_Pos 10U /*!< TPI DEVID: MANCVALID Position */ +#define TPI_DEVID_MANCVALID_Msk (0x1UL << TPI_DEVID_MANCVALID_Pos) /*!< TPI DEVID: MANCVALID Mask */ + +#define TPI_DEVID_PTINVALID_Pos 9U /*!< TPI DEVID: PTINVALID Position */ +#define TPI_DEVID_PTINVALID_Msk (0x1UL << TPI_DEVID_PTINVALID_Pos) /*!< TPI DEVID: PTINVALID Mask */ + +#define TPI_DEVID_MinBufSz_Pos 6U /*!< TPI DEVID: MinBufSz Position */ +#define TPI_DEVID_MinBufSz_Msk (0x7UL << TPI_DEVID_MinBufSz_Pos) /*!< TPI DEVID: MinBufSz Mask */ + +#define TPI_DEVID_AsynClkIn_Pos 5U /*!< TPI DEVID: AsynClkIn Position */ +#define TPI_DEVID_AsynClkIn_Msk (0x1UL << TPI_DEVID_AsynClkIn_Pos) /*!< TPI DEVID: AsynClkIn Mask */ + +#define TPI_DEVID_NrTraceInput_Pos 0U /*!< TPI DEVID: NrTraceInput Position */ +#define TPI_DEVID_NrTraceInput_Msk (0x1FUL /*<< TPI_DEVID_NrTraceInput_Pos*/) /*!< TPI DEVID: NrTraceInput Mask */ + +/* TPI DEVTYPE Register Definitions */ +#define TPI_DEVTYPE_MajorType_Pos 4U /*!< TPI DEVTYPE: MajorType Position */ +#define TPI_DEVTYPE_MajorType_Msk (0xFUL << TPI_DEVTYPE_MajorType_Pos) /*!< TPI DEVTYPE: MajorType Mask */ + +#define TPI_DEVTYPE_SubType_Pos 0U /*!< TPI DEVTYPE: SubType Position */ +#define TPI_DEVTYPE_SubType_Msk (0xFUL /*<< TPI_DEVTYPE_SubType_Pos*/) /*!< TPI DEVTYPE: SubType Mask */ + +/*@}*/ /* end of group CMSIS_TPI */ + + +#if (__MPU_PRESENT == 1U) +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_MPU Memory Protection Unit (MPU) + \brief Type definitions for the Memory Protection Unit (MPU) + @{ + */ + +/** + \brief Structure type to access the Memory Protection Unit (MPU). + */ +typedef struct +{ + __IM uint32_t TYPE; /*!< Offset: 0x000 (R/ ) MPU Type Register */ + __IOM uint32_t CTRL; /*!< Offset: 0x004 (R/W) MPU Control Register */ + __IOM uint32_t RNR; /*!< Offset: 0x008 (R/W) MPU Region RNRber Register */ + __IOM uint32_t RBAR; /*!< Offset: 0x00C (R/W) MPU Region Base Address Register */ + __IOM uint32_t RASR; /*!< Offset: 0x010 (R/W) MPU Region Attribute and Size Register */ + __IOM uint32_t RBAR_A1; /*!< Offset: 0x014 (R/W) MPU Alias 1 Region Base Address Register */ + __IOM uint32_t RASR_A1; /*!< Offset: 0x018 (R/W) MPU Alias 1 Region Attribute and Size Register */ + __IOM uint32_t RBAR_A2; /*!< Offset: 0x01C (R/W) MPU Alias 2 Region Base Address Register */ + __IOM uint32_t RASR_A2; /*!< Offset: 0x020 (R/W) MPU Alias 2 Region Attribute and Size Register */ + __IOM uint32_t RBAR_A3; /*!< Offset: 0x024 (R/W) MPU Alias 3 Region Base Address Register */ + __IOM uint32_t RASR_A3; /*!< Offset: 0x028 (R/W) MPU Alias 3 Region Attribute and Size Register */ +} MPU_Type; + +/* MPU Type Register Definitions */ +#define MPU_TYPE_IREGION_Pos 16U /*!< MPU TYPE: IREGION Position */ +#define MPU_TYPE_IREGION_Msk (0xFFUL << MPU_TYPE_IREGION_Pos) /*!< MPU TYPE: IREGION Mask */ + +#define MPU_TYPE_DREGION_Pos 8U /*!< MPU TYPE: DREGION Position */ +#define MPU_TYPE_DREGION_Msk (0xFFUL << MPU_TYPE_DREGION_Pos) /*!< MPU TYPE: DREGION Mask */ + +#define MPU_TYPE_SEPARATE_Pos 0U /*!< MPU TYPE: SEPARATE Position */ +#define MPU_TYPE_SEPARATE_Msk (1UL /*<< MPU_TYPE_SEPARATE_Pos*/) /*!< MPU TYPE: SEPARATE Mask */ + +/* MPU Control Register Definitions */ +#define MPU_CTRL_PRIVDEFENA_Pos 2U /*!< MPU CTRL: PRIVDEFENA Position */ +#define MPU_CTRL_PRIVDEFENA_Msk (1UL << MPU_CTRL_PRIVDEFENA_Pos) /*!< MPU CTRL: PRIVDEFENA Mask */ + +#define MPU_CTRL_HFNMIENA_Pos 1U /*!< MPU CTRL: HFNMIENA Position */ +#define MPU_CTRL_HFNMIENA_Msk (1UL << MPU_CTRL_HFNMIENA_Pos) /*!< MPU CTRL: HFNMIENA Mask */ + +#define MPU_CTRL_ENABLE_Pos 0U /*!< MPU CTRL: ENABLE Position */ +#define MPU_CTRL_ENABLE_Msk (1UL /*<< MPU_CTRL_ENABLE_Pos*/) /*!< MPU CTRL: ENABLE Mask */ + +/* MPU Region Number Register Definitions */ +#define MPU_RNR_REGION_Pos 0U /*!< MPU RNR: REGION Position */ +#define MPU_RNR_REGION_Msk (0xFFUL /*<< MPU_RNR_REGION_Pos*/) /*!< MPU RNR: REGION Mask */ + +/* MPU Region Base Address Register Definitions */ +#define MPU_RBAR_ADDR_Pos 5U /*!< MPU RBAR: ADDR Position */ +#define MPU_RBAR_ADDR_Msk (0x7FFFFFFUL << MPU_RBAR_ADDR_Pos) /*!< MPU RBAR: ADDR Mask */ + +#define MPU_RBAR_VALID_Pos 4U /*!< MPU RBAR: VALID Position */ +#define MPU_RBAR_VALID_Msk (1UL << MPU_RBAR_VALID_Pos) /*!< MPU RBAR: VALID Mask */ + +#define MPU_RBAR_REGION_Pos 0U /*!< MPU RBAR: REGION Position */ +#define MPU_RBAR_REGION_Msk (0xFUL /*<< MPU_RBAR_REGION_Pos*/) /*!< MPU RBAR: REGION Mask */ + +/* MPU Region Attribute and Size Register Definitions */ +#define MPU_RASR_ATTRS_Pos 16U /*!< MPU RASR: MPU Region Attribute field Position */ +#define MPU_RASR_ATTRS_Msk (0xFFFFUL << MPU_RASR_ATTRS_Pos) /*!< MPU RASR: MPU Region Attribute field Mask */ + +#define MPU_RASR_XN_Pos 28U /*!< MPU RASR: ATTRS.XN Position */ +#define MPU_RASR_XN_Msk (1UL << MPU_RASR_XN_Pos) /*!< MPU RASR: ATTRS.XN Mask */ + +#define MPU_RASR_AP_Pos 24U /*!< MPU RASR: ATTRS.AP Position */ +#define MPU_RASR_AP_Msk (0x7UL << MPU_RASR_AP_Pos) /*!< MPU RASR: ATTRS.AP Mask */ + +#define MPU_RASR_TEX_Pos 19U /*!< MPU RASR: ATTRS.TEX Position */ +#define MPU_RASR_TEX_Msk (0x7UL << MPU_RASR_TEX_Pos) /*!< MPU RASR: ATTRS.TEX Mask */ + +#define MPU_RASR_S_Pos 18U /*!< MPU RASR: ATTRS.S Position */ +#define MPU_RASR_S_Msk (1UL << MPU_RASR_S_Pos) /*!< MPU RASR: ATTRS.S Mask */ + +#define MPU_RASR_C_Pos 17U /*!< MPU RASR: ATTRS.C Position */ +#define MPU_RASR_C_Msk (1UL << MPU_RASR_C_Pos) /*!< MPU RASR: ATTRS.C Mask */ + +#define MPU_RASR_B_Pos 16U /*!< MPU RASR: ATTRS.B Position */ +#define MPU_RASR_B_Msk (1UL << MPU_RASR_B_Pos) /*!< MPU RASR: ATTRS.B Mask */ + +#define MPU_RASR_SRD_Pos 8U /*!< MPU RASR: Sub-Region Disable Position */ +#define MPU_RASR_SRD_Msk (0xFFUL << MPU_RASR_SRD_Pos) /*!< MPU RASR: Sub-Region Disable Mask */ + +#define MPU_RASR_SIZE_Pos 1U /*!< MPU RASR: Region Size Field Position */ +#define MPU_RASR_SIZE_Msk (0x1FUL << MPU_RASR_SIZE_Pos) /*!< MPU RASR: Region Size Field Mask */ + +#define MPU_RASR_ENABLE_Pos 0U /*!< MPU RASR: Region enable bit Position */ +#define MPU_RASR_ENABLE_Msk (1UL /*<< MPU_RASR_ENABLE_Pos*/) /*!< MPU RASR: Region enable bit Disable Mask */ + +/*@} end of group CMSIS_MPU */ +#endif + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_CoreDebug Core Debug Registers (CoreDebug) + \brief Type definitions for the Core Debug Registers + @{ + */ + +/** + \brief Structure type to access the Core Debug Register (CoreDebug). + */ +typedef struct +{ + __IOM uint32_t DHCSR; /*!< Offset: 0x000 (R/W) Debug Halting Control and Status Register */ + __OM uint32_t DCRSR; /*!< Offset: 0x004 ( /W) Debug Core Register Selector Register */ + __IOM uint32_t DCRDR; /*!< Offset: 0x008 (R/W) Debug Core Register Data Register */ + __IOM uint32_t DEMCR; /*!< Offset: 0x00C (R/W) Debug Exception and Monitor Control Register */ +} CoreDebug_Type; + +/* Debug Halting Control and Status Register Definitions */ +#define CoreDebug_DHCSR_DBGKEY_Pos 16U /*!< CoreDebug DHCSR: DBGKEY Position */ +#define CoreDebug_DHCSR_DBGKEY_Msk (0xFFFFUL << CoreDebug_DHCSR_DBGKEY_Pos) /*!< CoreDebug DHCSR: DBGKEY Mask */ + +#define CoreDebug_DHCSR_S_RESET_ST_Pos 25U /*!< CoreDebug DHCSR: S_RESET_ST Position */ +#define CoreDebug_DHCSR_S_RESET_ST_Msk (1UL << CoreDebug_DHCSR_S_RESET_ST_Pos) /*!< CoreDebug DHCSR: S_RESET_ST Mask */ + +#define CoreDebug_DHCSR_S_RETIRE_ST_Pos 24U /*!< CoreDebug DHCSR: S_RETIRE_ST Position */ +#define CoreDebug_DHCSR_S_RETIRE_ST_Msk (1UL << CoreDebug_DHCSR_S_RETIRE_ST_Pos) /*!< CoreDebug DHCSR: S_RETIRE_ST Mask */ + +#define CoreDebug_DHCSR_S_LOCKUP_Pos 19U /*!< CoreDebug DHCSR: S_LOCKUP Position */ +#define CoreDebug_DHCSR_S_LOCKUP_Msk (1UL << CoreDebug_DHCSR_S_LOCKUP_Pos) /*!< CoreDebug DHCSR: S_LOCKUP Mask */ + +#define CoreDebug_DHCSR_S_SLEEP_Pos 18U /*!< CoreDebug DHCSR: S_SLEEP Position */ +#define CoreDebug_DHCSR_S_SLEEP_Msk (1UL << CoreDebug_DHCSR_S_SLEEP_Pos) /*!< CoreDebug DHCSR: S_SLEEP Mask */ + +#define CoreDebug_DHCSR_S_HALT_Pos 17U /*!< CoreDebug DHCSR: S_HALT Position */ +#define CoreDebug_DHCSR_S_HALT_Msk (1UL << CoreDebug_DHCSR_S_HALT_Pos) /*!< CoreDebug DHCSR: S_HALT Mask */ + +#define CoreDebug_DHCSR_S_REGRDY_Pos 16U /*!< CoreDebug DHCSR: S_REGRDY Position */ +#define CoreDebug_DHCSR_S_REGRDY_Msk (1UL << CoreDebug_DHCSR_S_REGRDY_Pos) /*!< CoreDebug DHCSR: S_REGRDY Mask */ + +#define CoreDebug_DHCSR_C_SNAPSTALL_Pos 5U /*!< CoreDebug DHCSR: C_SNAPSTALL Position */ +#define CoreDebug_DHCSR_C_SNAPSTALL_Msk (1UL << CoreDebug_DHCSR_C_SNAPSTALL_Pos) /*!< CoreDebug DHCSR: C_SNAPSTALL Mask */ + +#define CoreDebug_DHCSR_C_MASKINTS_Pos 3U /*!< CoreDebug DHCSR: C_MASKINTS Position */ +#define CoreDebug_DHCSR_C_MASKINTS_Msk (1UL << CoreDebug_DHCSR_C_MASKINTS_Pos) /*!< CoreDebug DHCSR: C_MASKINTS Mask */ + +#define CoreDebug_DHCSR_C_STEP_Pos 2U /*!< CoreDebug DHCSR: C_STEP Position */ +#define CoreDebug_DHCSR_C_STEP_Msk (1UL << CoreDebug_DHCSR_C_STEP_Pos) /*!< CoreDebug DHCSR: C_STEP Mask */ + +#define CoreDebug_DHCSR_C_HALT_Pos 1U /*!< CoreDebug DHCSR: C_HALT Position */ +#define CoreDebug_DHCSR_C_HALT_Msk (1UL << CoreDebug_DHCSR_C_HALT_Pos) /*!< CoreDebug DHCSR: C_HALT Mask */ + +#define CoreDebug_DHCSR_C_DEBUGEN_Pos 0U /*!< CoreDebug DHCSR: C_DEBUGEN Position */ +#define CoreDebug_DHCSR_C_DEBUGEN_Msk (1UL /*<< CoreDebug_DHCSR_C_DEBUGEN_Pos*/) /*!< CoreDebug DHCSR: C_DEBUGEN Mask */ + +/* Debug Core Register Selector Register Definitions */ +#define CoreDebug_DCRSR_REGWnR_Pos 16U /*!< CoreDebug DCRSR: REGWnR Position */ +#define CoreDebug_DCRSR_REGWnR_Msk (1UL << CoreDebug_DCRSR_REGWnR_Pos) /*!< CoreDebug DCRSR: REGWnR Mask */ + +#define CoreDebug_DCRSR_REGSEL_Pos 0U /*!< CoreDebug DCRSR: REGSEL Position */ +#define CoreDebug_DCRSR_REGSEL_Msk (0x1FUL /*<< CoreDebug_DCRSR_REGSEL_Pos*/) /*!< CoreDebug DCRSR: REGSEL Mask */ + +/* Debug Exception and Monitor Control Register Definitions */ +#define CoreDebug_DEMCR_TRCENA_Pos 24U /*!< CoreDebug DEMCR: TRCENA Position */ +#define CoreDebug_DEMCR_TRCENA_Msk (1UL << CoreDebug_DEMCR_TRCENA_Pos) /*!< CoreDebug DEMCR: TRCENA Mask */ + +#define CoreDebug_DEMCR_MON_REQ_Pos 19U /*!< CoreDebug DEMCR: MON_REQ Position */ +#define CoreDebug_DEMCR_MON_REQ_Msk (1UL << CoreDebug_DEMCR_MON_REQ_Pos) /*!< CoreDebug DEMCR: MON_REQ Mask */ + +#define CoreDebug_DEMCR_MON_STEP_Pos 18U /*!< CoreDebug DEMCR: MON_STEP Position */ +#define CoreDebug_DEMCR_MON_STEP_Msk (1UL << CoreDebug_DEMCR_MON_STEP_Pos) /*!< CoreDebug DEMCR: MON_STEP Mask */ + +#define CoreDebug_DEMCR_MON_PEND_Pos 17U /*!< CoreDebug DEMCR: MON_PEND Position */ +#define CoreDebug_DEMCR_MON_PEND_Msk (1UL << CoreDebug_DEMCR_MON_PEND_Pos) /*!< CoreDebug DEMCR: MON_PEND Mask */ + +#define CoreDebug_DEMCR_MON_EN_Pos 16U /*!< CoreDebug DEMCR: MON_EN Position */ +#define CoreDebug_DEMCR_MON_EN_Msk (1UL << CoreDebug_DEMCR_MON_EN_Pos) /*!< CoreDebug DEMCR: MON_EN Mask */ + +#define CoreDebug_DEMCR_VC_HARDERR_Pos 10U /*!< CoreDebug DEMCR: VC_HARDERR Position */ +#define CoreDebug_DEMCR_VC_HARDERR_Msk (1UL << CoreDebug_DEMCR_VC_HARDERR_Pos) /*!< CoreDebug DEMCR: VC_HARDERR Mask */ + +#define CoreDebug_DEMCR_VC_INTERR_Pos 9U /*!< CoreDebug DEMCR: VC_INTERR Position */ +#define CoreDebug_DEMCR_VC_INTERR_Msk (1UL << CoreDebug_DEMCR_VC_INTERR_Pos) /*!< CoreDebug DEMCR: VC_INTERR Mask */ + +#define CoreDebug_DEMCR_VC_BUSERR_Pos 8U /*!< CoreDebug DEMCR: VC_BUSERR Position */ +#define CoreDebug_DEMCR_VC_BUSERR_Msk (1UL << CoreDebug_DEMCR_VC_BUSERR_Pos) /*!< CoreDebug DEMCR: VC_BUSERR Mask */ + +#define CoreDebug_DEMCR_VC_STATERR_Pos 7U /*!< CoreDebug DEMCR: VC_STATERR Position */ +#define CoreDebug_DEMCR_VC_STATERR_Msk (1UL << CoreDebug_DEMCR_VC_STATERR_Pos) /*!< CoreDebug DEMCR: VC_STATERR Mask */ + +#define CoreDebug_DEMCR_VC_CHKERR_Pos 6U /*!< CoreDebug DEMCR: VC_CHKERR Position */ +#define CoreDebug_DEMCR_VC_CHKERR_Msk (1UL << CoreDebug_DEMCR_VC_CHKERR_Pos) /*!< CoreDebug DEMCR: VC_CHKERR Mask */ + +#define CoreDebug_DEMCR_VC_NOCPERR_Pos 5U /*!< CoreDebug DEMCR: VC_NOCPERR Position */ +#define CoreDebug_DEMCR_VC_NOCPERR_Msk (1UL << CoreDebug_DEMCR_VC_NOCPERR_Pos) /*!< CoreDebug DEMCR: VC_NOCPERR Mask */ + +#define CoreDebug_DEMCR_VC_MMERR_Pos 4U /*!< CoreDebug DEMCR: VC_MMERR Position */ +#define CoreDebug_DEMCR_VC_MMERR_Msk (1UL << CoreDebug_DEMCR_VC_MMERR_Pos) /*!< CoreDebug DEMCR: VC_MMERR Mask */ + +#define CoreDebug_DEMCR_VC_CORERESET_Pos 0U /*!< CoreDebug DEMCR: VC_CORERESET Position */ +#define CoreDebug_DEMCR_VC_CORERESET_Msk (1UL /*<< CoreDebug_DEMCR_VC_CORERESET_Pos*/) /*!< CoreDebug DEMCR: VC_CORERESET Mask */ + +/*@} end of group CMSIS_CoreDebug */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_core_bitfield Core register bit field macros + \brief Macros for use with bit field definitions (xxx_Pos, xxx_Msk). + @{ + */ + +/** + \brief Mask and shift a bit field value for use in a register bit range. + \param[in] field Name of the register bit field. + \param[in] value Value of the bit field. + \return Masked and shifted value. +*/ +#define _VAL2FLD(field, value) ((value << field ## _Pos) & field ## _Msk) + +/** + \brief Mask and shift a register value to extract a bit filed value. + \param[in] field Name of the register bit field. + \param[in] value Value of register. + \return Masked and shifted bit field value. +*/ +#define _FLD2VAL(field, value) ((value & field ## _Msk) >> field ## _Pos) + +/*@} end of group CMSIS_core_bitfield */ + + +/** + \ingroup CMSIS_core_register + \defgroup CMSIS_core_base Core Definitions + \brief Definitions for base addresses, unions, and structures. + @{ + */ + +/* Memory mapping of Cortex-M3 Hardware */ +#define SCS_BASE (0xE000E000UL) /*!< System Control Space Base Address */ +#define ITM_BASE (0xE0000000UL) /*!< ITM Base Address */ +#define DWT_BASE (0xE0001000UL) /*!< DWT Base Address */ +#define TPI_BASE (0xE0040000UL) /*!< TPI Base Address */ +#define CoreDebug_BASE (0xE000EDF0UL) /*!< Core Debug Base Address */ +#define SysTick_BASE (SCS_BASE + 0x0010UL) /*!< SysTick Base Address */ +#define NVIC_BASE (SCS_BASE + 0x0100UL) /*!< NVIC Base Address */ +#define SCB_BASE (SCS_BASE + 0x0D00UL) /*!< System Control Block Base Address */ + +#define SCnSCB ((SCnSCB_Type *) SCS_BASE ) /*!< System control Register not in SCB */ +#define SCB ((SCB_Type *) SCB_BASE ) /*!< SCB configuration struct */ +#define SysTick ((SysTick_Type *) SysTick_BASE ) /*!< SysTick configuration struct */ +#define NVIC ((NVIC_Type *) NVIC_BASE ) /*!< NVIC configuration struct */ +#define ITM ((ITM_Type *) ITM_BASE ) /*!< ITM configuration struct */ +#define DWT ((DWT_Type *) DWT_BASE ) /*!< DWT configuration struct */ +#define TPI ((TPI_Type *) TPI_BASE ) /*!< TPI configuration struct */ +#define CoreDebug ((CoreDebug_Type *) CoreDebug_BASE) /*!< Core Debug configuration struct */ + +#if (__MPU_PRESENT == 1U) + #define MPU_BASE (SCS_BASE + 0x0D90UL) /*!< Memory Protection Unit */ + #define MPU ((MPU_Type *) MPU_BASE ) /*!< Memory Protection Unit */ +#endif + +/*@} */ + + + +/******************************************************************************* + * Hardware Abstraction Layer + Core Function Interface contains: + - Core NVIC Functions + - Core SysTick Functions + - Core Debug Functions + - Core Register Access Functions + ******************************************************************************/ +/** + \defgroup CMSIS_Core_FunctionInterface Functions and Instructions Reference +*/ + + + +/* ########################## NVIC functions #################################### */ +/** + \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_NVICFunctions NVIC Functions + \brief Functions that manage interrupts and exceptions via the NVIC. + @{ + */ + +/** + \brief Set Priority Grouping + \details Sets the priority grouping field using the required unlock sequence. + The parameter PriorityGroup is assigned to the field SCB->AIRCR [10:8] PRIGROUP field. + Only values from 0..7 are used. + In case of a conflict between priority grouping and available + priority bits (__NVIC_PRIO_BITS), the smallest possible priority group is set. + \param [in] PriorityGroup Priority grouping field. + */ +__STATIC_INLINE void NVIC_SetPriorityGrouping(uint32_t PriorityGroup) +{ + uint32_t reg_value; + uint32_t PriorityGroupTmp = (PriorityGroup & (uint32_t)0x07UL); /* only values 0..7 are used */ + + reg_value = SCB->AIRCR; /* read old register configuration */ + reg_value &= ~((uint32_t)(SCB_AIRCR_VECTKEY_Msk | SCB_AIRCR_PRIGROUP_Msk)); /* clear bits to change */ + reg_value = (reg_value | + ((uint32_t)0x5FAUL << SCB_AIRCR_VECTKEY_Pos) | + (PriorityGroupTmp << 8U) ); /* Insert write key and priorty group */ + SCB->AIRCR = reg_value; +} + + +/** + \brief Get Priority Grouping + \details Reads the priority grouping field from the NVIC Interrupt Controller. + \return Priority grouping field (SCB->AIRCR [10:8] PRIGROUP field). + */ +__STATIC_INLINE uint32_t NVIC_GetPriorityGrouping(void) +{ + return ((uint32_t)((SCB->AIRCR & SCB_AIRCR_PRIGROUP_Msk) >> SCB_AIRCR_PRIGROUP_Pos)); +} + + +/** + \brief Enable External Interrupt + \details Enables a device-specific interrupt in the NVIC interrupt controller. + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_EnableIRQ(IRQn_Type IRQn) +{ + NVIC->ISER[(((uint32_t)(int32_t)IRQn) >> 5UL)] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Disable External Interrupt + \details Disables a device-specific interrupt in the NVIC interrupt controller. + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_DisableIRQ(IRQn_Type IRQn) +{ + NVIC->ICER[(((uint32_t)(int32_t)IRQn) >> 5UL)] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Get Pending Interrupt + \details Reads the pending register in the NVIC and returns the pending bit for the specified interrupt. + \param [in] IRQn Interrupt number. + \return 0 Interrupt status is not pending. + \return 1 Interrupt status is pending. + */ +__STATIC_INLINE uint32_t NVIC_GetPendingIRQ(IRQn_Type IRQn) +{ + return((uint32_t)(((NVIC->ISPR[(((uint32_t)(int32_t)IRQn) >> 5UL)] & (1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL))) != 0UL) ? 1UL : 0UL)); +} + + +/** + \brief Set Pending Interrupt + \details Sets the pending bit of an external interrupt. + \param [in] IRQn Interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_SetPendingIRQ(IRQn_Type IRQn) +{ + NVIC->ISPR[(((uint32_t)(int32_t)IRQn) >> 5UL)] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Clear Pending Interrupt + \details Clears the pending bit of an external interrupt. + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_ClearPendingIRQ(IRQn_Type IRQn) +{ + NVIC->ICPR[(((uint32_t)(int32_t)IRQn) >> 5UL)] = (uint32_t)(1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL)); +} + + +/** + \brief Get Active Interrupt + \details Reads the active register in NVIC and returns the active bit. + \param [in] IRQn Interrupt number. + \return 0 Interrupt status is not active. + \return 1 Interrupt status is active. + */ +__STATIC_INLINE uint32_t NVIC_GetActive(IRQn_Type IRQn) +{ + return((uint32_t)(((NVIC->IABR[(((uint32_t)(int32_t)IRQn) >> 5UL)] & (1UL << (((uint32_t)(int32_t)IRQn) & 0x1FUL))) != 0UL) ? 1UL : 0UL)); +} + + +/** + \brief Set Interrupt Priority + \details Sets the priority of an interrupt. + \note The priority cannot be set for every core interrupt. + \param [in] IRQn Interrupt number. + \param [in] priority Priority to set. + */ +__STATIC_INLINE void NVIC_SetPriority(IRQn_Type IRQn, uint32_t priority) +{ + if ((int32_t)(IRQn) < 0) + { + SCB->SHP[(((uint32_t)(int32_t)IRQn) & 0xFUL)-4UL] = (uint8_t)((priority << (8U - __NVIC_PRIO_BITS)) & (uint32_t)0xFFUL); + } + else + { + NVIC->IP[((uint32_t)(int32_t)IRQn)] = (uint8_t)((priority << (8U - __NVIC_PRIO_BITS)) & (uint32_t)0xFFUL); + } +} + + +/** + \brief Get Interrupt Priority + \details Reads the priority of an interrupt. + The interrupt number can be positive to specify an external (device specific) interrupt, + or negative to specify an internal (core) interrupt. + \param [in] IRQn Interrupt number. + \return Interrupt Priority. + Value is aligned automatically to the implemented priority bits of the microcontroller. + */ +__STATIC_INLINE uint32_t NVIC_GetPriority(IRQn_Type IRQn) +{ + + if ((int32_t)(IRQn) < 0) + { + return(((uint32_t)SCB->SHP[(((uint32_t)(int32_t)IRQn) & 0xFUL)-4UL] >> (8U - __NVIC_PRIO_BITS))); + } + else + { + return(((uint32_t)NVIC->IP[((uint32_t)(int32_t)IRQn)] >> (8U - __NVIC_PRIO_BITS))); + } +} + + +/** + \brief Encode Priority + \details Encodes the priority for an interrupt with the given priority group, + preemptive priority value, and subpriority value. + In case of a conflict between priority grouping and available + priority bits (__NVIC_PRIO_BITS), the smallest possible priority group is set. + \param [in] PriorityGroup Used priority group. + \param [in] PreemptPriority Preemptive priority value (starting from 0). + \param [in] SubPriority Subpriority value (starting from 0). + \return Encoded priority. Value can be used in the function \ref NVIC_SetPriority(). + */ +__STATIC_INLINE uint32_t NVIC_EncodePriority (uint32_t PriorityGroup, uint32_t PreemptPriority, uint32_t SubPriority) +{ + uint32_t PriorityGroupTmp = (PriorityGroup & (uint32_t)0x07UL); /* only values 0..7 are used */ + uint32_t PreemptPriorityBits; + uint32_t SubPriorityBits; + + PreemptPriorityBits = ((7UL - PriorityGroupTmp) > (uint32_t)(__NVIC_PRIO_BITS)) ? (uint32_t)(__NVIC_PRIO_BITS) : (uint32_t)(7UL - PriorityGroupTmp); + SubPriorityBits = ((PriorityGroupTmp + (uint32_t)(__NVIC_PRIO_BITS)) < (uint32_t)7UL) ? (uint32_t)0UL : (uint32_t)((PriorityGroupTmp - 7UL) + (uint32_t)(__NVIC_PRIO_BITS)); + + return ( + ((PreemptPriority & (uint32_t)((1UL << (PreemptPriorityBits)) - 1UL)) << SubPriorityBits) | + ((SubPriority & (uint32_t)((1UL << (SubPriorityBits )) - 1UL))) + ); +} + + +/** + \brief Decode Priority + \details Decodes an interrupt priority value with a given priority group to + preemptive priority value and subpriority value. + In case of a conflict between priority grouping and available + priority bits (__NVIC_PRIO_BITS) the smallest possible priority group is set. + \param [in] Priority Priority value, which can be retrieved with the function \ref NVIC_GetPriority(). + \param [in] PriorityGroup Used priority group. + \param [out] pPreemptPriority Preemptive priority value (starting from 0). + \param [out] pSubPriority Subpriority value (starting from 0). + */ +__STATIC_INLINE void NVIC_DecodePriority (uint32_t Priority, uint32_t PriorityGroup, uint32_t* const pPreemptPriority, uint32_t* const pSubPriority) +{ + uint32_t PriorityGroupTmp = (PriorityGroup & (uint32_t)0x07UL); /* only values 0..7 are used */ + uint32_t PreemptPriorityBits; + uint32_t SubPriorityBits; + + PreemptPriorityBits = ((7UL - PriorityGroupTmp) > (uint32_t)(__NVIC_PRIO_BITS)) ? (uint32_t)(__NVIC_PRIO_BITS) : (uint32_t)(7UL - PriorityGroupTmp); + SubPriorityBits = ((PriorityGroupTmp + (uint32_t)(__NVIC_PRIO_BITS)) < (uint32_t)7UL) ? (uint32_t)0UL : (uint32_t)((PriorityGroupTmp - 7UL) + (uint32_t)(__NVIC_PRIO_BITS)); + + *pPreemptPriority = (Priority >> SubPriorityBits) & (uint32_t)((1UL << (PreemptPriorityBits)) - 1UL); + *pSubPriority = (Priority ) & (uint32_t)((1UL << (SubPriorityBits )) - 1UL); +} + + +/** + \brief System Reset + \details Initiates a system reset request to reset the MCU. + */ +__STATIC_INLINE void NVIC_SystemReset(void) +{ + __DSB(); /* Ensure all outstanding memory accesses included + buffered write are completed before reset */ + SCB->AIRCR = (uint32_t)((0x5FAUL << SCB_AIRCR_VECTKEY_Pos) | + (SCB->AIRCR & SCB_AIRCR_PRIGROUP_Msk) | + SCB_AIRCR_SYSRESETREQ_Msk ); /* Keep priority group unchanged */ + __DSB(); /* Ensure completion of memory access */ + + for(;;) /* wait until reset */ + { + __NOP(); + } +} + +/*@} end of CMSIS_Core_NVICFunctions */ + + + +/* ################################## SysTick function ############################################ */ +/** + \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_SysTickFunctions SysTick Functions + \brief Functions that configure the System. + @{ + */ + +#if (__Vendor_SysTickConfig == 0U) + +/** + \brief System Tick Configuration + \details Initializes the System Timer and its interrupt, and starts the System Tick Timer. + Counter is in free running mode to generate periodic interrupts. + \param [in] ticks Number of ticks between two interrupts. + \return 0 Function succeeded. + \return 1 Function failed. + \note When the variable __Vendor_SysTickConfig is set to 1, then the + function SysTick_Config is not included. In this case, the file device.h + must contain a vendor-specific implementation of this function. + */ +__STATIC_INLINE uint32_t SysTick_Config(uint32_t ticks) +{ + if ((ticks - 1UL) > SysTick_LOAD_RELOAD_Msk) + { + return (1UL); /* Reload value impossible */ + } + + SysTick->LOAD = (uint32_t)(ticks - 1UL); /* set reload register */ + NVIC_SetPriority (SysTick_IRQn, (1UL << __NVIC_PRIO_BITS) - 1UL); /* set Priority for Systick Interrupt */ + SysTick->VAL = 0UL; /* Load the SysTick Counter Value */ + SysTick->CTRL = SysTick_CTRL_CLKSOURCE_Msk | + SysTick_CTRL_TICKINT_Msk | + SysTick_CTRL_ENABLE_Msk; /* Enable SysTick IRQ and SysTick Timer */ + return (0UL); /* Function successful */ +} + +#endif + +/*@} end of CMSIS_Core_SysTickFunctions */ + + + +/* ##################################### Debug In/Output function ########################################### */ +/** + \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_core_DebugFunctions ITM Functions + \brief Functions that access the ITM debug interface. + @{ + */ + +extern volatile int32_t ITM_RxBuffer; /*!< External variable to receive characters. */ +#define ITM_RXBUFFER_EMPTY 0x5AA55AA5U /*!< Value identifying \ref ITM_RxBuffer is ready for next character. */ + + +/** + \brief ITM Send Character + \details Transmits a character via the ITM channel 0, and + \li Just returns when no debugger is connected that has booked the output. + \li Is blocking when a debugger is connected, but the previous character sent has not been transmitted. + \param [in] ch Character to transmit. + \returns Character to transmit. + */ +__STATIC_INLINE uint32_t ITM_SendChar (uint32_t ch) +{ + if (((ITM->TCR & ITM_TCR_ITMENA_Msk) != 0UL) && /* ITM enabled */ + ((ITM->TER & 1UL ) != 0UL) ) /* ITM Port #0 enabled */ + { + while (ITM->PORT[0U].u32 == 0UL) + { + __NOP(); + } + ITM->PORT[0U].u8 = (uint8_t)ch; + } + return (ch); +} + + +/** + \brief ITM Receive Character + \details Inputs a character via the external variable \ref ITM_RxBuffer. + \return Received character. + \return -1 No character pending. + */ +__STATIC_INLINE int32_t ITM_ReceiveChar (void) +{ + int32_t ch = -1; /* no character available */ + + if (ITM_RxBuffer != ITM_RXBUFFER_EMPTY) + { + ch = ITM_RxBuffer; + ITM_RxBuffer = ITM_RXBUFFER_EMPTY; /* ready for next character */ + } + + return (ch); +} + + +/** + \brief ITM Check Character + \details Checks whether a character is pending for reading in the variable \ref ITM_RxBuffer. + \return 0 No character available. + \return 1 Character available. + */ +__STATIC_INLINE int32_t ITM_CheckChar (void) +{ + + if (ITM_RxBuffer == ITM_RXBUFFER_EMPTY) + { + return (0); /* no character available */ + } + else + { + return (1); /* character available */ + } +} + +/*@} end of CMSIS_core_DebugFunctions */ + + + + +#ifdef __cplusplus +} +#endif + +#endif /* __CORE_SC300_H_DEPENDANT */ + +#endif /* __CMSIS_GENERIC */ diff --git a/bsp/nuvoton/libraries/m480/CMSIS/SConscript b/bsp/nuvoton/libraries/m480/CMSIS/SConscript new file mode 100644 index 00000000000..904fca41463 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/CMSIS/SConscript @@ -0,0 +1,16 @@ +import rtconfig +Import('RTT_ROOT') +from building import * + +# get current directory +cwd = GetCurrentDir() + +# The set of source files associated with this SConscript file. +src = Split(""" +""") + +path = [cwd + '/Include',] + +group = DefineGroup('CMSIS', src, depend = [''], CPPPATH = path) + +Return('group') diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/M480.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/M480.h new file mode 100644 index 00000000000..782ee01aa9a --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/M480.h @@ -0,0 +1,713 @@ +/**************************************************************************//** + * @file M480.h + * @version V1.00 + * @brief M480 peripheral access layer header file. + * This file contains all the peripheral register's definitions, + * bits definitions and memory mapping for NuMicro M480 MCU. + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +/** + \mainpage NuMicro M480 Driver Reference Guide + * + * Introduction + * + * This user manual describes the usage of M480 Series MCU device driver + * + * Disclaimer + * + * The Software is furnished "AS IS", without warranty as to performance or results, and + * the entire risk as to performance or results is assumed by YOU. Nuvoton disclaims all + * warranties, express, implied or otherwise, with regard to the Software, its use, or + * operation, including without limitation any and all warranties of merchantability, fitness + * for a particular purpose, and non-infringement of intellectual property rights. + * + * Important Notice + * + * Nuvoton Products are neither intended nor warranted for usage in systems or equipment, + * any malfunction or failure of which may cause loss of human life, bodily injury or severe + * property damage. Such applications are deemed, "Insecure Usage". + * + * Insecure usage includes, but is not limited to: equipment for surgical implementation, + * atomic energy control instruments, airplane or spaceship instruments, the control or + * operation of dynamic, brake or safety systems designed for vehicular use, traffic signal + * instruments, all types of safety devices, and other applications intended to support or + * sustain life. + * + * All Insecure Usage shall be made at customer's risk, and in the event that third parties + * lay claims to Nuvoton as a result of customer's Insecure Usage, customer shall indemnify + * the damages and liabilities thus incurred by Nuvoton. + * + * Please note that all data and specifications are subject to change without notice. All the + * trademarks of products and companies mentioned in this datasheet belong to their respective + * owners. + * + * Copyright Notice + * + * Copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + */ +#ifndef __M480_H__ +#define __M480_H__ + +#ifdef __cplusplus +extern "C" { +#endif + +/******************************************************************************/ +/* Processor and Core Peripherals */ +/******************************************************************************/ +/** @addtogroup CMSIS_Device Device CMSIS Definitions + Configuration of the Cortex-M4 Processor and Core Peripherals + @{ +*/ + +/** + * @details Interrupt Number Definition. + */ +typedef enum IRQn +{ + /****** Cortex-M4 Processor Exceptions Numbers ***************************************************/ + NonMaskableInt_IRQn = -14, /*!< 2 Non Maskable Interrupt */ + MemoryManagement_IRQn = -12, /*!< 4 Memory Management Interrupt */ + BusFault_IRQn = -11, /*!< 5 Bus Fault Interrupt */ + UsageFault_IRQn = -10, /*!< 6 Usage Fault Interrupt */ + SVCall_IRQn = -5, /*!< 11 SV Call Interrupt */ + DebugMonitor_IRQn = -4, /*!< 12 Debug Monitor Interrupt */ + PendSV_IRQn = -2, /*!< 14 Pend SV Interrupt */ + SysTick_IRQn = -1, /*!< 15 System Tick Interrupt */ + + /****** M480 Specific Interrupt Numbers ********************************************************/ + + BOD_IRQn = 0, /*!< Brown Out detection Interrupt */ + IRC_IRQn = 1, /*!< Internal RC Interrupt */ + PWRWU_IRQn = 2, /*!< Power Down Wake Up Interrupt */ + RAMPE_IRQn = 3, /*!< SRAM parity check failed Interrupt */ + CKFAIL_IRQn = 4, /*!< Clock failed Interrupt */ + RTC_IRQn = 6, /*!< Real Time Clock Interrupt */ + TAMPER_IRQn = 7, /*!< Tamper detection Interrupt */ + WDT_IRQn = 8, /*!< Watchdog timer Interrupt */ + WWDT_IRQn = 9, /*!< Window Watchdog timer Interrupt */ + EINT0_IRQn = 10, /*!< External Input 0 Interrupt */ + EINT1_IRQn = 11, /*!< External Input 1 Interrupt */ + EINT2_IRQn = 12, /*!< External Input 2 Interrupt */ + EINT3_IRQn = 13, /*!< External Input 3 Interrupt */ + EINT4_IRQn = 14, /*!< External Input 4 Interrupt */ + EINT5_IRQn = 15, /*!< External Input 5 Interrupt */ + GPA_IRQn = 16, /*!< GPIO Port A Interrupt */ + GPB_IRQn = 17, /*!< GPIO Port B Interrupt */ + GPC_IRQn = 18, /*!< GPIO Port C Interrupt */ + GPD_IRQn = 19, /*!< GPIO Port D Interrupt */ + GPE_IRQn = 20, /*!< GPIO Port E Interrupt */ + GPF_IRQn = 21, /*!< GPIO Port F Interrupt */ + QSPI0_IRQn = 22, /*!< QSPI0 Interrupt */ + SPI0_IRQn = 23, /*!< SPI0 Interrupt */ + BRAKE0_IRQn = 24, /*!< BRAKE0 Interrupt */ + EPWM0P0_IRQn = 25, /*!< EPWM0P0 Interrupt */ + EPWM0P1_IRQn = 26, /*!< EPWM0P1 Interrupt */ + EPWM0P2_IRQn = 27, /*!< EPWM0P2 Interrupt */ + BRAKE1_IRQn = 28, /*!< BRAKE1 Interrupt */ + EPWM1P0_IRQn = 29, /*!< EPWM1P0 Interrupt */ + EPWM1P1_IRQn = 30, /*!< EPWM1P1 Interrupt */ + EPWM1P2_IRQn = 31, /*!< EPWM1P2 Interrupt */ + TMR0_IRQn = 32, /*!< Timer 0 Interrupt */ + TMR1_IRQn = 33, /*!< Timer 1 Interrupt */ + TMR2_IRQn = 34, /*!< Timer 2 Interrupt */ + TMR3_IRQn = 35, /*!< Timer 3 Interrupt */ + UART0_IRQn = 36, /*!< UART 0 Interrupt */ + UART1_IRQn = 37, /*!< UART 1 Interrupt */ + I2C0_IRQn = 38, /*!< I2C 0 Interrupt */ + I2C1_IRQn = 39, /*!< I2C 1 Interrupt */ + PDMA_IRQn = 40, /*!< Peripheral DMA Interrupt */ + DAC_IRQn = 41, /*!< DAC Interrupt */ + EADC00_IRQn = 42, /*!< EADC00 Interrupt */ + EADC01_IRQn = 43, /*!< EADC01 Interrupt */ + ACMP01_IRQn = 44, /*!< Analog Comparator 0 and 1 Interrupt */ + EADC02_IRQn = 46, /*!< EADC02 Interrupt */ + EADC03_IRQn = 47, /*!< EADC03 Interrupt */ + UART2_IRQn = 48, /*!< UART2 Interrupt */ + UART3_IRQn = 49, /*!< UART3 Interrupt */ + QSPI1_IRQn = 50, /*!< QSPI1 Interrupt */ + SPI1_IRQn = 51, /*!< SPI1 Interrupt */ + SPI2_IRQn = 52, /*!< SPI2 Interrupt */ + USBD_IRQn = 53, /*!< USB device Interrupt */ + USBH_IRQn = 54, /*!< USB host Interrupt */ + USBOTG_IRQn = 55, /*!< USB OTG Interrupt */ + CAN0_IRQn = 56, /*!< CAN0 Interrupt */ + CAN1_IRQn = 57, /*!< CAN1 Interrupt */ + SC0_IRQn = 58, /*!< Smart Card 0 Interrupt */ + SC1_IRQn = 59, /*!< Smart Card 1 Interrupt */ + SC2_IRQn = 60, /*!< Smart Card 2 Interrupt */ + SPI3_IRQn = 62, /*!< SPI3 Interrupt */ + EMAC_TX_IRQn = 66, /*!< Ethernet MAC TX Interrupt */ + EMAC_RX_IRQn = 67, /*!< Ethernet MAC RX Interrupt */ + SDH0_IRQn = 64, /*!< Secure Digital Host Controller 0 Interrupt */ + USBD20_IRQn = 65, /*!< High Speed USB device Interrupt */ + I2S0_IRQn = 68, /*!< I2S0 Interrupt */ + OPA_IRQn = 70, /*!< OPA Interrupt */ + CRPT_IRQn = 71, /*!< CRPT Interrupt */ + GPG_IRQn = 72, /*!< GPIO Port G Interrupt */ + EINT6_IRQn = 73, /*!< External Input 6 Interrupt */ + UART4_IRQn = 74, /*!< UART4 Interrupt */ + UART5_IRQn = 75, /*!< UART5 Interrupt */ + USCI0_IRQn = 76, /*!< USCI0 Interrupt */ + USCI1_IRQn = 77, /*!< USCI1 Interrupt */ + BPWM0_IRQn = 78, /*!< BPWM0 Interrupt */ + BPWM1_IRQn = 79, /*!< BPWM1 Interrupt */ + SPIM_IRQn = 80, /*!< SPIM Interrupt */ + CCAP_IRQn = 81, /*!< CCAP Interrupt */ + I2C2_IRQn = 82, /*!< I2C2 Interrupt */ + QEI0_IRQn = 84, /*!< QEI0 Interrupt */ + QEI1_IRQn = 85, /*!< QEI1 Interrupt */ + ECAP0_IRQn = 86, /*!< ECAP0 Interrupt */ + ECAP1_IRQn = 87, /*!< ECAP1 Interrupt */ + GPH_IRQn = 88, /*!< GPIO Port H Interrupt */ + EINT7_IRQn = 89, /*!< External Input 7 Interrupt */ + SDH1_IRQn = 90, /*!< Secure Digital Host Controller 1 Interrupt */ + HSUSBH_IRQn = 92, /*!< High speed USB host Interrupt */ + USBOTG20_IRQn = 93, /*!< High speed USB OTG Interrupt */ + TRNG_IRQn = 101, /*!< TRNG Interrupt */ + UART6_IRQn = 102, /*!< UART6 Interrupt */ + UART7_IRQn = 103, /*!< UART7 Interrupt */ + EADC10_IRQn = 104, /*!< EADC10 Interrupt */ + EADC11_IRQn = 105, /*!< EADC11 Interrupt */ + EADC12_IRQn = 106, /*!< EADC12 Interrupt */ + EADC13_IRQn = 107, /*!< EADC13 Interrupt */ + CAN2_IRQn = 108, /*!< CAN2 Interrupt */ +} +IRQn_Type; + + +/* + * ========================================================================== + * ----------- Processor and Core Peripheral Section ------------------------ + * ========================================================================== + */ + +/* Configuration of the Cortex-M4 Processor and Core Peripherals */ +#define __CM4_REV 0x0201UL /*!< Core Revision r2p1 */ +#define __NVIC_PRIO_BITS 4UL /*!< Number of Bits used for Priority Levels */ +#define __Vendor_SysTickConfig 0UL /*!< Set to 1 if different SysTick Config is used */ +#define __MPU_PRESENT 1UL /*!< MPU present or not */ +#ifdef __FPU_PRESENT +#undef __FPU_PRESENT +#define __FPU_PRESENT 1UL /*!< FPU present or not */ +#else +#define __FPU_PRESENT 1UL /*!< FPU present or not */ +#endif + +/*@}*/ /* end of group CMSIS_Device */ + + +#include "core_cm4.h" /* Cortex-M4 processor and core peripherals */ +#include "system_M480.h" /* System include file */ +#include + + + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/******************************************************************************/ +/* Register definitions */ +/******************************************************************************/ + +#include "sys_reg.h" +#include "clk_reg.h" +#include "fmc_reg.h" +#include "gpio_reg.h" +#include "pdma_reg.h" +#include "timer_reg.h" +#include "wdt_reg.h" +#include "wwdt_reg.h" +#include "rtc_reg.h" +#include "epwm_reg.h" +#include "bpwm_reg.h" +#include "qei_reg.h" +#include "ecap_reg.h" +#include "uart_reg.h" +#include "emac_reg.h" +#include "sc_reg.h" +#include "i2s_reg.h" +#include "spi_reg.h" +#include "qspi_reg.h" +#include "spim_reg.h" +#include "i2c_reg.h" +#include "uuart_reg.h" +#include "uspi_reg.h" +#include "ui2c_reg.h" +#include "can_reg.h" +#include "sdh_reg.h" +#include "ebi_reg.h" +#include "usbd_reg.h" +#include "hsusbd_reg.h" +#include "usbh_reg.h" +#include "hsusbh_reg.h" +#include "otg_reg.h" +#include "hsotg_reg.h" +#include "crc_reg.h" +#include "crypto_reg.h" +#include "trng_reg.h" +#include "eadc_reg.h" +#include "dac_reg.h" +#include "acmp_reg.h" +#include "opa_reg.h" +#include "ccap_reg.h" + + +/** @addtogroup PERIPHERAL_MEM_MAP Peripheral Memory Base + Memory Mapped Structure for Peripherals + @{ + */ +/* Peripheral and SRAM base address */ +#define FLASH_BASE ((uint32_t)0x00000000) /*!< Flash base address */ +#define SRAM_BASE ((uint32_t)0x20000000) /*!< SRAM Base Address */ +#define PERIPH_BASE ((uint32_t)0x40000000) /*!< Peripheral Base Address */ +#define AHBPERIPH_BASE PERIPH_BASE /*!< AHB Base Address */ +#define APBPERIPH_BASE (PERIPH_BASE + (uint32_t)0x00040000) /*!< APB Base Address */ + +/*!< AHB peripherals */ +#define SYS_BASE (AHBPERIPH_BASE + 0x00000UL) +#define CLK_BASE (AHBPERIPH_BASE + 0x00200UL) +#define NMI_BASE (AHBPERIPH_BASE + 0x00300UL) +#define GPIOA_BASE (AHBPERIPH_BASE + 0x04000UL) +#define GPIOB_BASE (AHBPERIPH_BASE + 0x04040UL) +#define GPIOC_BASE (AHBPERIPH_BASE + 0x04080UL) +#define GPIOD_BASE (AHBPERIPH_BASE + 0x040C0UL) +#define GPIOE_BASE (AHBPERIPH_BASE + 0x04100UL) +#define GPIOF_BASE (AHBPERIPH_BASE + 0x04140UL) +#define GPIOG_BASE (AHBPERIPH_BASE + 0x04180UL) +#define GPIOH_BASE (AHBPERIPH_BASE + 0x041C0UL) +#define GPIOI_BASE (AHBPERIPH_BASE + 0x04200UL) +#define GPIO_DBCTL_BASE (AHBPERIPH_BASE + 0x04440UL) +#define GPIO_PIN_DATA_BASE (AHBPERIPH_BASE + 0x04800UL) +#define PDMA_BASE (AHBPERIPH_BASE + 0x08000UL) +#define USBH_BASE (AHBPERIPH_BASE + 0x09000UL) +#define HSUSBH_BASE (AHBPERIPH_BASE + 0x1A000UL) +#define EMAC_BASE (AHBPERIPH_BASE + 0x0B000UL) +#define FMC_BASE (AHBPERIPH_BASE + 0x0C000UL) +#define SDH0_BASE (AHBPERIPH_BASE + 0x0D000UL) +#define SDH1_BASE (AHBPERIPH_BASE + 0x0E000UL) +#define EBI_BASE (AHBPERIPH_BASE + 0x10000UL) +#define HSUSBD_BASE (AHBPERIPH_BASE + 0x19000UL) +#define CCAP_BASE (AHBPERIPH_BASE + 0x30000UL) +#define CRC_BASE (AHBPERIPH_BASE + 0x31000UL) +#define TAMPER_BASE (AHBPERIPH_BASE + 0xE1000UL) + +/*!< APB2 peripherals */ +#define WDT_BASE (APBPERIPH_BASE + 0x00000UL) +#define WWDT_BASE (APBPERIPH_BASE + 0x00100UL) +#define OPA_BASE (APBPERIPH_BASE + 0x06000UL) +#define I2S_BASE (APBPERIPH_BASE + 0x08000UL) +#define EADC1_BASE (APBPERIPH_BASE + 0x0B000UL) +#define TIMER0_BASE (APBPERIPH_BASE + 0x10000UL) +#define TIMER1_BASE (APBPERIPH_BASE + 0x10100UL) +#define EPWM0_BASE (APBPERIPH_BASE + 0x18000UL) +#define BPWM0_BASE (APBPERIPH_BASE + 0x1A000UL) +#define QSPI0_BASE (APBPERIPH_BASE + 0x20000UL) +#define SPI1_BASE (APBPERIPH_BASE + 0x22000UL) +#define SPI3_BASE (APBPERIPH_BASE + 0x24000UL) +#define UART0_BASE (APBPERIPH_BASE + 0x30000UL) +#define UART2_BASE (APBPERIPH_BASE + 0x32000UL) +#define UART4_BASE (APBPERIPH_BASE + 0x34000UL) +#define UART6_BASE (APBPERIPH_BASE + 0x36000UL) +#define I2C0_BASE (APBPERIPH_BASE + 0x40000UL) +#define I2C2_BASE (APBPERIPH_BASE + 0x42000UL) +#define CAN0_BASE (APBPERIPH_BASE + 0x60000UL) +#define CAN2_BASE (APBPERIPH_BASE + 0x62000UL) +#define QEI0_BASE (APBPERIPH_BASE + 0x70000UL) +#define ECAP0_BASE (APBPERIPH_BASE + 0x74000UL) +#define USCI0_BASE (APBPERIPH_BASE + 0x90000UL) + + +/*!< APB1 peripherals */ +#define RTC_BASE (APBPERIPH_BASE + 0x01000UL) +#define EADC_BASE (APBPERIPH_BASE + 0x03000UL) +#define ACMP01_BASE (APBPERIPH_BASE + 0x05000UL) +#define USBD_BASE (APBPERIPH_BASE + 0x80000UL) +#define OTG_BASE (APBPERIPH_BASE + 0x0D000UL) +#define HSOTG_BASE (APBPERIPH_BASE + 0x0F000UL) +#define TIMER2_BASE (APBPERIPH_BASE + 0x11000UL) +#define TIMER3_BASE (APBPERIPH_BASE + 0x11100UL) +#define EPWM1_BASE (APBPERIPH_BASE + 0x19000UL) +#define BPWM1_BASE (APBPERIPH_BASE + 0x1B000UL) +#define SPI0_BASE (APBPERIPH_BASE + 0x21000UL) +#define SPI2_BASE (APBPERIPH_BASE + 0x23000UL) +#define QSPI1_BASE (APBPERIPH_BASE + 0x29000UL) +#define UART1_BASE (APBPERIPH_BASE + 0x31000UL) +#define UART3_BASE (APBPERIPH_BASE + 0x33000UL) +#define UART5_BASE (APBPERIPH_BASE + 0x35000UL) +#define UART7_BASE (APBPERIPH_BASE + 0x37000UL) +#define I2C1_BASE (APBPERIPH_BASE + 0x41000UL) +#define CAN1_BASE (APBPERIPH_BASE + 0x61000UL) +#define QEI1_BASE (APBPERIPH_BASE + 0x71000UL) +#define ECAP1_BASE (APBPERIPH_BASE + 0x75000UL) +#define TRNG_BASE (APBPERIPH_BASE + 0x79000UL) +#define USCI1_BASE (APBPERIPH_BASE + 0x91000UL) +#define CRPT_BASE (0x50080000UL) +#define SPIM_BASE (0x40007000UL) + +#define SC0_BASE (APBPERIPH_BASE + 0x50000UL) +#define SC1_BASE (APBPERIPH_BASE + 0x51000UL) +#define SC2_BASE (APBPERIPH_BASE + 0x52000UL) +#define DAC0_BASE (APBPERIPH_BASE + 0x07000UL) +#define DAC1_BASE (APBPERIPH_BASE + 0x07040UL) +#define DACDBG_BASE (APBPERIPH_BASE + 0x07FECUL) +#define OPA0_BASE (APBPERIPH_BASE + 0x06000UL) + +/*@}*/ /* end of group PERIPHERAL_MEM_MAP */ + + +/** @addtogroup PERIPHERAL_DECLARATION Peripheral Pointer + The Declaration of Peripherals + @{ + */ + +#define SYS ((SYS_T *) SYS_BASE) +#define CLK ((CLK_T *) CLK_BASE) +#define NMI ((NMI_T *) NMI_BASE) +#define PA ((GPIO_T *) GPIOA_BASE) +#define PB ((GPIO_T *) GPIOB_BASE) +#define PC ((GPIO_T *) GPIOC_BASE) +#define PD ((GPIO_T *) GPIOD_BASE) +#define PE ((GPIO_T *) GPIOE_BASE) +#define PF ((GPIO_T *) GPIOF_BASE) +#define PG ((GPIO_T *) GPIOG_BASE) +#define PH ((GPIO_T *) GPIOH_BASE) +#define GPA ((GPIO_T *) GPIOA_BASE) +#define GPB ((GPIO_T *) GPIOB_BASE) +#define GPC ((GPIO_T *) GPIOC_BASE) +#define GPD ((GPIO_T *) GPIOD_BASE) +#define GPE ((GPIO_T *) GPIOE_BASE) +#define GPF ((GPIO_T *) GPIOF_BASE) +#define GPG ((GPIO_T *) GPIOG_BASE) +#define GPH ((GPIO_T *) GPIOH_BASE) +#define GPIO ((GPIO_DBCTL_T *) GPIO_DBCTL_BASE) +#define PDMA ((PDMA_T *) PDMA_BASE) +#define USBH ((USBH_T *) USBH_BASE) +#define HSUSBH ((HSUSBH_T *) HSUSBH_BASE) +#define EMAC ((EMAC_T *) EMAC_BASE) +#define FMC ((FMC_T *) FMC_BASE) +#define SDH0 ((SDH_T *) SDH0_BASE) +#define SDH1 ((SDH_T *) SDH1_BASE) +#define EBI ((EBI_T *) EBI_BASE) +#define CRC ((CRC_T *) CRC_BASE) +#define TAMPER ((TAMPER_T *) TAMPER_BASE) + +#define WDT ((WDT_T *) WDT_BASE) +#define WWDT ((WWDT_T *) WWDT_BASE) +#define RTC ((RTC_T *) RTC_BASE) +#define EADC ((EADC_T *) EADC_BASE) +#define EADC0 ((EADC_T *) EADC_BASE) +#define EADC1 ((EADC_T *) EADC1_BASE) +#define ACMP01 ((ACMP_T *) ACMP01_BASE) + +#define I2S0 ((I2S_T *) I2S_BASE) +#define USBD ((USBD_T *) USBD_BASE) +#define OTG ((OTG_T *) OTG_BASE) +#define HSUSBD ((HSUSBD_T *)HSUSBD_BASE) +#define HSOTG ((HSOTG_T *) HSOTG_BASE) +#define TIMER0 ((TIMER_T *) TIMER0_BASE) +#define TIMER1 ((TIMER_T *) TIMER1_BASE) +#define TIMER2 ((TIMER_T *) TIMER2_BASE) +#define TIMER3 ((TIMER_T *) TIMER3_BASE) +#define EPWM0 ((EPWM_T *) EPWM0_BASE) +#define EPWM1 ((EPWM_T *) EPWM1_BASE) +#define BPWM0 ((BPWM_T *) BPWM0_BASE) +#define BPWM1 ((BPWM_T *) BPWM1_BASE) +#define ECAP0 ((ECAP_T *) ECAP0_BASE) +#define ECAP1 ((ECAP_T *) ECAP1_BASE) +#define QEI0 ((QEI_T *) QEI0_BASE) +#define QEI1 ((QEI_T *) QEI1_BASE) +#define QSPI0 ((QSPI_T *) QSPI0_BASE) +#define QSPI1 ((QSPI_T *) QSPI1_BASE) +#define SPI0 ((SPI_T *) SPI0_BASE) +#define SPI1 ((SPI_T *) SPI1_BASE) +#define SPI2 ((SPI_T *) SPI2_BASE) +#define SPI3 ((SPI_T *) SPI3_BASE) +#define UART0 ((UART_T *) UART0_BASE) +#define UART1 ((UART_T *) UART1_BASE) +#define UART2 ((UART_T *) UART2_BASE) +#define UART3 ((UART_T *) UART3_BASE) +#define UART4 ((UART_T *) UART4_BASE) +#define UART5 ((UART_T *) UART5_BASE) +#define UART6 ((UART_T *) UART6_BASE) +#define UART7 ((UART_T *) UART7_BASE) +#define I2C0 ((I2C_T *) I2C0_BASE) +#define I2C1 ((I2C_T *) I2C1_BASE) +#define I2C2 ((I2C_T *) I2C2_BASE) +#define SC0 ((SC_T *) SC0_BASE) +#define SC1 ((SC_T *) SC1_BASE) +#define SC2 ((SC_T *) SC2_BASE) +#define CAN0 ((CAN_T *) CAN0_BASE) +#define CAN1 ((CAN_T *) CAN1_BASE) +#define CAN2 ((CAN_T *) CAN2_BASE) +#define CRPT ((CRPT_T *) CRPT_BASE) +#define TRNG ((TRNG_T *) TRNG_BASE) +#define SPIM ((volatile SPIM_T *) SPIM_BASE) +#define DAC0 ((DAC_T *) DAC0_BASE) +#define DAC1 ((DAC_T *) DAC1_BASE) +#define USPI0 ((USPI_T *) USCI0_BASE) /*!< USPI0 Configuration Struct */ +#define USPI1 ((USPI_T *) USCI1_BASE) /*!< USPI1 Configuration Struct */ +#define OPA ((OPA_T *) OPA_BASE) +#define UI2C0 ((UI2C_T *) USCI0_BASE) /*!< UI2C0 Configuration Struct */ +#define UI2C1 ((UI2C_T *) USCI1_BASE) /*!< UI2C1 Configuration Struct */ +#define UUART0 ((UUART_T *) USCI0_BASE) /*!< UUART0 Configuration Struct */ +#define UUART1 ((UUART_T *) USCI1_BASE) /*!< UUART1 Configuration Struct */ +#define CCAP ((CCAP_T *) CCAP_BASE) + +/*@}*/ /* end of group ERIPHERAL_DECLARATION */ + +/** @addtogroup IO_ROUTINE I/O Routines + The Declaration of I/O Routines + @{ + */ + +typedef volatile unsigned char vu8; ///< Define 8-bit unsigned volatile data type +typedef volatile unsigned short vu16; ///< Define 16-bit unsigned volatile data type +typedef volatile unsigned long vu32; ///< Define 32-bit unsigned volatile data type + +/** + * @brief Get a 8-bit unsigned value from specified address + * @param[in] addr Address to get 8-bit data from + * @return 8-bit unsigned value stored in specified address + */ +#define M8(addr) (*((vu8 *) (addr))) + +/** + * @brief Get a 16-bit unsigned value from specified address + * @param[in] addr Address to get 16-bit data from + * @return 16-bit unsigned value stored in specified address + * @note The input address must be 16-bit aligned + */ +#define M16(addr) (*((vu16 *) (addr))) + +/** + * @brief Get a 32-bit unsigned value from specified address + * @param[in] addr Address to get 32-bit data from + * @return 32-bit unsigned value stored in specified address + * @note The input address must be 32-bit aligned + */ +#define M32(addr) (*((vu32 *) (addr))) + +/** + * @brief Set a 32-bit unsigned value to specified I/O port + * @param[in] port Port address to set 32-bit data + * @param[in] value Value to write to I/O port + * @return None + * @note The output port must be 32-bit aligned + */ +#define outpw(port,value) *((volatile unsigned int *)(port)) = (value) + +/** + * @brief Get a 32-bit unsigned value from specified I/O port + * @param[in] port Port address to get 32-bit data from + * @return 32-bit unsigned value stored in specified I/O port + * @note The input port must be 32-bit aligned + */ +#define inpw(port) (*((volatile unsigned int *)(port))) + +/** + * @brief Set a 16-bit unsigned value to specified I/O port + * @param[in] port Port address to set 16-bit data + * @param[in] value Value to write to I/O port + * @return None + * @note The output port must be 16-bit aligned + */ +#define outps(port,value) *((volatile unsigned short *)(port)) = (value) + +/** + * @brief Get a 16-bit unsigned value from specified I/O port + * @param[in] port Port address to get 16-bit data from + * @return 16-bit unsigned value stored in specified I/O port + * @note The input port must be 16-bit aligned + */ +#define inps(port) (*((volatile unsigned short *)(port))) + +/** + * @brief Set a 8-bit unsigned value to specified I/O port + * @param[in] port Port address to set 8-bit data + * @param[in] value Value to write to I/O port + * @return None + */ +#define outpb(port,value) *((volatile unsigned char *)(port)) = (value) + +/** + * @brief Get a 8-bit unsigned value from specified I/O port + * @param[in] port Port address to get 8-bit data from + * @return 8-bit unsigned value stored in specified I/O port + */ +#define inpb(port) (*((volatile unsigned char *)(port))) + +/** + * @brief Set a 32-bit unsigned value to specified I/O port + * @param[in] port Port address to set 32-bit data + * @param[in] value Value to write to I/O port + * @return None + * @note The output port must be 32-bit aligned + */ +#define outp32(port,value) *((volatile unsigned int *)(port)) = (value) + +/** + * @brief Get a 32-bit unsigned value from specified I/O port + * @param[in] port Port address to get 32-bit data from + * @return 32-bit unsigned value stored in specified I/O port + * @note The input port must be 32-bit aligned + */ +#define inp32(port) (*((volatile unsigned int *)(port))) + +/** + * @brief Set a 16-bit unsigned value to specified I/O port + * @param[in] port Port address to set 16-bit data + * @param[in] value Value to write to I/O port + * @return None + * @note The output port must be 16-bit aligned + */ +#define outp16(port,value) *((volatile unsigned short *)(port)) = (value) + +/** + * @brief Get a 16-bit unsigned value from specified I/O port + * @param[in] port Port address to get 16-bit data from + * @return 16-bit unsigned value stored in specified I/O port + * @note The input port must be 16-bit aligned + */ +#define inp16(port) (*((volatile unsigned short *)(port))) + +/** + * @brief Set a 8-bit unsigned value to specified I/O port + * @param[in] port Port address to set 8-bit data + * @param[in] value Value to write to I/O port + * @return None + */ +#define outp8(port,value) *((volatile unsigned char *)(port)) = (value) + +/** + * @brief Get a 8-bit unsigned value from specified I/O port + * @param[in] port Port address to get 8-bit data from + * @return 8-bit unsigned value stored in specified I/O port + */ +#define inp8(port) (*((volatile unsigned char *)(port))) + + +/*@}*/ /* end of group IO_ROUTINE */ + +/******************************************************************************/ +/* Legacy Constants */ +/******************************************************************************/ +/** @addtogroup Legacy_Constants Legacy Constants + Legacy Constants + @{ +*/ + +#ifndef NULL +#define NULL (0) ///< NULL pointer +#endif + +#define TRUE (1UL) ///< Boolean true, define to use in API parameters or return value +#define FALSE (0UL) ///< Boolean false, define to use in API parameters or return value + +#define ENABLE (1UL) ///< Enable, define to use in API parameters +#define DISABLE (0UL) ///< Disable, define to use in API parameters + +/* Define one bit mask */ +#define BIT0 (0x00000001UL) ///< Bit 0 mask of an 32 bit integer +#define BIT1 (0x00000002UL) ///< Bit 1 mask of an 32 bit integer +#define BIT2 (0x00000004UL) ///< Bit 2 mask of an 32 bit integer +#define BIT3 (0x00000008UL) ///< Bit 3 mask of an 32 bit integer +#define BIT4 (0x00000010UL) ///< Bit 4 mask of an 32 bit integer +#define BIT5 (0x00000020UL) ///< Bit 5 mask of an 32 bit integer +#define BIT6 (0x00000040UL) ///< Bit 6 mask of an 32 bit integer +#define BIT7 (0x00000080UL) ///< Bit 7 mask of an 32 bit integer +#define BIT8 (0x00000100UL) ///< Bit 8 mask of an 32 bit integer +#define BIT9 (0x00000200UL) ///< Bit 9 mask of an 32 bit integer +#define BIT10 (0x00000400UL) ///< Bit 10 mask of an 32 bit integer +#define BIT11 (0x00000800UL) ///< Bit 11 mask of an 32 bit integer +#define BIT12 (0x00001000UL) ///< Bit 12 mask of an 32 bit integer +#define BIT13 (0x00002000UL) ///< Bit 13 mask of an 32 bit integer +#define BIT14 (0x00004000UL) ///< Bit 14 mask of an 32 bit integer +#define BIT15 (0x00008000UL) ///< Bit 15 mask of an 32 bit integer +#define BIT16 (0x00010000UL) ///< Bit 16 mask of an 32 bit integer +#define BIT17 (0x00020000UL) ///< Bit 17 mask of an 32 bit integer +#define BIT18 (0x00040000UL) ///< Bit 18 mask of an 32 bit integer +#define BIT19 (0x00080000UL) ///< Bit 19 mask of an 32 bit integer +#define BIT20 (0x00100000UL) ///< Bit 20 mask of an 32 bit integer +#define BIT21 (0x00200000UL) ///< Bit 21 mask of an 32 bit integer +#define BIT22 (0x00400000UL) ///< Bit 22 mask of an 32 bit integer +#define BIT23 (0x00800000UL) ///< Bit 23 mask of an 32 bit integer +#define BIT24 (0x01000000UL) ///< Bit 24 mask of an 32 bit integer +#define BIT25 (0x02000000UL) ///< Bit 25 mask of an 32 bit integer +#define BIT26 (0x04000000UL) ///< Bit 26 mask of an 32 bit integer +#define BIT27 (0x08000000UL) ///< Bit 27 mask of an 32 bit integer +#define BIT28 (0x10000000UL) ///< Bit 28 mask of an 32 bit integer +#define BIT29 (0x20000000UL) ///< Bit 29 mask of an 32 bit integer +#define BIT30 (0x40000000UL) ///< Bit 30 mask of an 32 bit integer +#define BIT31 (0x80000000UL) ///< Bit 31 mask of an 32 bit integer + +/* Byte Mask Definitions */ +#define BYTE0_Msk (0x000000FFUL) ///< Mask to get bit0~bit7 from a 32 bit integer +#define BYTE1_Msk (0x0000FF00UL) ///< Mask to get bit8~bit15 from a 32 bit integer +#define BYTE2_Msk (0x00FF0000UL) ///< Mask to get bit16~bit23 from a 32 bit integer +#define BYTE3_Msk (0xFF000000UL) ///< Mask to get bit24~bit31 from a 32 bit integer + +#define GET_BYTE0(u32Param) (((u32Param) & BYTE0_Msk) ) /*!< Extract Byte 0 (Bit 0~ 7) from parameter u32Param */ +#define GET_BYTE1(u32Param) (((u32Param) & BYTE1_Msk) >> 8) /*!< Extract Byte 1 (Bit 8~15) from parameter u32Param */ +#define GET_BYTE2(u32Param) (((u32Param) & BYTE2_Msk) >> 16) /*!< Extract Byte 2 (Bit 16~23) from parameter u32Param */ +#define GET_BYTE3(u32Param) (((u32Param) & BYTE3_Msk) >> 24) /*!< Extract Byte 3 (Bit 24~31) from parameter u32Param */ + +/*@}*/ /* end of group Legacy_Constants */ + + +/******************************************************************************/ +/* Peripheral header files */ +/******************************************************************************/ +#include "nu_sys.h" +#include "nu_clk.h" + +#include "nu_acmp.h" +#include "nu_dac.h" +#include "nu_emac.h" +#include "nu_uart.h" +#include "nu_usci_spi.h" +#include "nu_gpio.h" +#include "nu_ccap.h" +#include "nu_ecap.h" +#include "nu_qei.h" +#include "nu_timer.h" +#include "nu_timer_pwm.h" +#include "nu_pdma.h" +#include "nu_crypto.h" +#include "nu_trng.h" +#include "nu_fmc.h" +#include "nu_spim.h" +#include "nu_i2c.h" +#include "nu_i2s.h" +#include "nu_epwm.h" +#include "nu_eadc.h" +#include "nu_bpwm.h" +#include "nu_wdt.h" +#include "nu_wwdt.h" +#include "nu_opa.h" +#include "nu_crc.h" +#include "nu_ebi.h" +#include "nu_usci_i2c.h" +#include "nu_scuart.h" +#include "nu_sc.h" +#include "nu_spi.h" +#include "nu_qspi.h" +#include "nu_can.h" +#include "nu_rtc.h" +#include "nu_usci_uart.h" +#include "nu_sdh.h" +#include "nu_usbd.h" +#include "nu_hsusbd.h" +#include "nu_otg.h" +#include "nu_hsotg.h" + + +#ifdef __cplusplus +} +#endif + +#endif /* __M480_H__ */ + diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/NuMicro.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/NuMicro.h new file mode 100644 index 00000000000..c627d8af7c4 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/NuMicro.h @@ -0,0 +1,17 @@ +/**************************************************************************//** + * @file NuMicro.h + * @version V1.00 + * @brief NuMicro peripheral access layer header file. + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __NUMICRO_H__ +#define __NUMICRO_H__ + +#include "nutool_clkcfg.h" +#include "M480.h" + +#endif /* __NUMICRO_H__ */ + + diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/acmp_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/acmp_reg.h new file mode 100644 index 00000000000..663f86292a7 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/acmp_reg.h @@ -0,0 +1,240 @@ +/**************************************************************************//** + * @file acmp_reg.h + * @version V1.00 + * @brief ACMP register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __ACMP_REG_H__ +#define __ACMP_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup ACMP Analog Comparator Controller(ACMP) + Memory Mapped Structure for ACMP Controller +@{ */ + +typedef struct +{ + + + /** + * @var ACMP_T::CTL + * Offset: 0x00~0x04 Analog Comparator 0/1 Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ACMPEN |Comparator Enable Bit + * | | |0 = Comparator x Disabled. + * | | |1 = Comparator x Enabled. + * |[1] |ACMPIE |Comparator Interrupt Enable Bit + * | | |0 = Comparator x interrupt Disabled. + * | | |1 = Comparator x interrupt Enabled + * | | |If WKEN (ACMP_CTL0[16]) is set to 1, the wake-up interrupt function will be enabled as well. + * |[3] |ACMPOINV |Comparator Output Inverse + * | | |0 = Comparator x output inverse Disabled. + * | | |1 = Comparator x output inverse Enabled. + * |[5:4] |NEGSEL |Comparator Negative Input Selection + * | | |00 = ACMPx_N pin. + * | | |01 = Internal comparator reference voltage (CRV). + * | | |10 = Band-gap voltage. + * | | |11 = DAC output. + * |[7:6] |POSSEL |Comparator Positive Input Selection + * | | |00 = Input from ACMPx_P0. + * | | |01 = Input from ACMPx_P1. + * | | |10 = Input from ACMPx_P2. + * | | |11 = Input from ACMPx_P3. + * |[9:8] |INTPOL |Interrupt Condition Polarity Selection + * | | |ACMPIFx will be set to 1 when comparator output edge condition is detected. + * | | |00 = Rising edge or falling edge. + * | | |01 = Rising edge. + * | | |10 = Falling edge. + * | | |11 = Reserved. + * |[12] |OUTSEL |Comparator Output Select + * | | |0 = Comparator x output to ACMPx_O pin is unfiltered comparator output. + * | | |1 = Comparator x output to ACMPx_O pin is from filter output. + * |[15:13] |FILTSEL |Comparator Output Filter Count Selection + * | | |000 = Filter function is Disabled. + * | | |001 = ACMPx output is sampled 1 consecutive PCLK. + * | | |010 = ACMPx output is sampled 2 consecutive PCLKs. + * | | |011 = ACMPx output is sampled 4 consecutive PCLKs. + * | | |100 = ACMPx output is sampled 8 consecutive PCLKs. + * | | |101 = ACMPx output is sampled 16 consecutive PCLKs. + * | | |110 = ACMPx output is sampled 32 consecutive PCLKs. + * | | |111 = ACMPx output is sampled 64 consecutive PCLKs. + * |[16] |WKEN |Power-down Wake-up Enable Bit + * | | |0 = Wake-up function Disabled. + * | | |1 = Wake-up function Enabled. + * |[17] |WLATEN |Window Latch Mode Enable Bit + * | | |0 = Window Latch Mode Disabled. + * | | |1 = Window Latch Mode Enabled. + * |[18] |WCMPSEL |Window Compare Mode Selection + * | | |0 = Window Compare Mode Disabled. + * | | |1 = Window Compare Mode is Selected. + * |[25:24] |HYSSEL |Hysteresis Mode Selection + * | | |00 = Hysteresis is 0mV. + * | | |01 = Hysteresis is 10mV. + * | | |10 = Hysteresis is 20mV. + * | | |11 = Hysteresis is 30mV. + * |[29:28] |MODESEL |Propagation Delay Mode Selection + * | | |00 = Max propagation delay is 4.5uS, operation current is 1.2uA. + * | | |01 = Max propagation delay is 2uS, operation current is 3uA. + * | | |10 = Max propagation delay is 600nS, operation current is 10uA. + * | | |11 = Max propagation delay is 200nS, operation current is 75uA. + * @var ACMP_T::STATUS + * Offset: 0x08 Analog Comparator Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ACMPIF0 |Comparator 0 Interrupt Flag + * | | |This bit is set by hardware when the edge condition defined by INTPOL (ACMP_CTL0[9:8]) + * | | |is detected on comparator 0 output. + * | | |This will generate an interrupt if ACMPIE (ACMP_CTL0[1]) is set to 1. + * | | |Note: Write 1 to clear this bit to 0. + * |[1] |ACMPIF1 |Comparator 1 Interrupt Flag + * | | |This bit is set by hardware when the edge condition defined by INTPOL (ACMP_CTL1[9:8]) + * | | |is detected on comparator 1 output. + * | | |This will cause an interrupt if ACMPIE (ACMP_CTL1[1]) is set to 1. + * | | |Note: Write 1 to clear this bit to 0. + * |[4] |ACMPO0 |Comparator 0 Output + * | | |Synchronized to the PCLK to allow reading by software + * | | |Cleared when the comparator 0 is disabled, i.e. + * | | |ACMPEN (ACMP_CTL0[0]) is cleared to 0. + * |[5] |ACMPO1 |Comparator 1 Output + * | | |Synchronized to the PCLK to allow reading by software. + * | | |Cleared when the comparator 1 is disabled, i.e. + * | | |ACMPEN (ACMP_CTL1[0]) is cleared to 0. + * |[8] |WKIF0 |Comparator 0 Power-down Wake-up Interrupt Flag + * | | |This bit will be set to 1 when ACMP0 wake-up interrupt event occurs. + * | | |0 = No power-down wake-up occurred. + * | | |1 = Power-down wake-up occurred. + * | | |Note: Write 1 to clear this bit to 0. + * |[9] |WKIF1 |Comparator 1 Power-down Wake-up Interrupt Flag + * | | |This bit will be set to 1 when ACMP1 wake-up interrupt event occurs. + * | | |0 = No power-down wake-up occurred. + * | | |1 = Power-down wake-up occurred. + * | | |Note: Write 1 to clear this bit to 0. + * |[12] |ACMPS0 |Comparator 0 Status + * | | |Synchronized to the PCLK to allow reading by software + * | | |Cleared when the comparator 0 is disabled, i.e. + * | | |ACMPEN (ACMP_CTL0[0]) is cleared to 0. + * |[13] |ACMPS1 |Comparator 1 Status + * | | |Synchronized to the PCLK to allow reading by software + * | | |Cleared when the comparator 1 is disabled, i.e. + * | | |ACMPEN (ACMP_CTL1[0]) is cleared to 0. + * |[16] |ACMPWO |Comparator Window Output + * | | |This bit shows the output status of window compare mode + * | | |0 = The positive input voltage is outside the window. + * | | |1 = The positive input voltage is in the window. + * @var ACMP_T::VREF + * Offset: 0x0C Analog Comparator Reference Voltage Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |CRVCTL |Comparator Reference Voltage Setting + * | | |CRV = CRV source voltage * (1/6+CRVCTL/24). + * |[6] |CRVSSEL |CRV Source Voltage Selection + * | | |0 = VDDA is selected as CRV source voltage. + * | | |1 = The reference voltage defined by SYS_VREFCTL register is selected as CRV source voltage. + */ + __IO uint32_t CTL[2]; /*!< [0x0000~0x0004] Analog Comparator 0/1 Control Register */ + __IO uint32_t STATUS; /*!< [0x0008] Analog Comparator Status Register */ + __IO uint32_t VREF; /*!< [0x000c] Analog Comparator Reference Voltage Control Register */ + +} ACMP_T; + +/** + @addtogroup ACMP_CONST ACMP Bit Field Definition + Constant Definitions for ACMP Controller +@{ */ + +#define ACMP_CTL_ACMPEN_Pos (0) /*!< ACMP_T::CTL: ACMPEN Position */ +#define ACMP_CTL_ACMPEN_Msk (0x1ul << ACMP_CTL_ACMPEN_Pos) /*!< ACMP_T::CTL: ACMPEN Mask */ + +#define ACMP_CTL_ACMPIE_Pos (1) /*!< ACMP_T::CTL: ACMPIE Position */ +#define ACMP_CTL_ACMPIE_Msk (0x1ul << ACMP_CTL_ACMPIE_Pos) /*!< ACMP_T::CTL: ACMPIE Mask */ + +#define ACMP_CTL_ACMPOINV_Pos (3) /*!< ACMP_T::CTL: ACMPOINV Position */ +#define ACMP_CTL_ACMPOINV_Msk (0x1ul << ACMP_CTL_ACMPOINV_Pos) /*!< ACMP_T::CTL: ACMPOINV Mask */ + +#define ACMP_CTL_NEGSEL_Pos (4) /*!< ACMP_T::CTL: NEGSEL Position */ +#define ACMP_CTL_NEGSEL_Msk (0x3ul << ACMP_CTL_NEGSEL_Pos) /*!< ACMP_T::CTL: NEGSEL Mask */ + +#define ACMP_CTL_POSSEL_Pos (6) /*!< ACMP_T::CTL: POSSEL Position */ +#define ACMP_CTL_POSSEL_Msk (0x3ul << ACMP_CTL_POSSEL_Pos) /*!< ACMP_T::CTL: POSSEL Mask */ + +#define ACMP_CTL_INTPOL_Pos (8) /*!< ACMP_T::CTL: INTPOL Position */ +#define ACMP_CTL_INTPOL_Msk (0x3ul << ACMP_CTL_INTPOL_Pos) /*!< ACMP_T::CTL: INTPOL Mask */ + +#define ACMP_CTL_OUTSEL_Pos (12) /*!< ACMP_T::CTL: OUTSEL Position */ +#define ACMP_CTL_OUTSEL_Msk (0x1ul << ACMP_CTL_OUTSEL_Pos) /*!< ACMP_T::CTL: OUTSEL Mask */ + +#define ACMP_CTL_FILTSEL_Pos (13) /*!< ACMP_T::CTL: FILTSEL Position */ +#define ACMP_CTL_FILTSEL_Msk (0x7ul << ACMP_CTL_FILTSEL_Pos) /*!< ACMP_T::CTL: FILTSEL Mask */ + +#define ACMP_CTL_WKEN_Pos (16) /*!< ACMP_T::CTL: WKEN Position */ +#define ACMP_CTL_WKEN_Msk (0x1ul << ACMP_CTL_WKEN_Pos) /*!< ACMP_T::CTL: WKEN Mask */ + +#define ACMP_CTL_WLATEN_Pos (17) /*!< ACMP_T::CTL: WLATEN Position */ +#define ACMP_CTL_WLATEN_Msk (0x1ul << ACMP_CTL_WLATEN_Pos) /*!< ACMP_T::CTL: WLATEN Mask */ + +#define ACMP_CTL_WCMPSEL_Pos (18) /*!< ACMP_T::CTL: WCMPSEL Position */ +#define ACMP_CTL_WCMPSEL_Msk (0x1ul << ACMP_CTL_WCMPSEL_Pos) /*!< ACMP_T::CTL: WCMPSEL Mask */ + +#define ACMP_CTL_HYSSEL_Pos (24) /*!< ACMP_T::CTL: HYSSEL Position */ +#define ACMP_CTL_HYSSEL_Msk (0x3ul << ACMP_CTL_HYSSEL_Pos) /*!< ACMP_T::CTL: HYSSEL Mask */ + +#define ACMP_CTL_MODESEL_Pos (28) /*!< ACMP_T::CTL: MODESEL Position */ +#define ACMP_CTL_MODESEL_Msk (0x3ul << ACMP_CTL_MODESEL_Pos) /*!< ACMP_T::CTL: MODESEL Mask */ + +#define ACMP_STATUS_ACMPIF0_Pos (0) /*!< ACMP_T::STATUS: ACMPIF0 Position */ +#define ACMP_STATUS_ACMPIF0_Msk (0x1ul << ACMP_STATUS_ACMPIF0_Pos) /*!< ACMP_T::STATUS: ACMPIF0 Mask */ + +#define ACMP_STATUS_ACMPIF1_Pos (1) /*!< ACMP_T::STATUS: ACMPIF1 Position */ +#define ACMP_STATUS_ACMPIF1_Msk (0x1ul << ACMP_STATUS_ACMPIF1_Pos) /*!< ACMP_T::STATUS: ACMPIF1 Mask */ + +#define ACMP_STATUS_ACMPO0_Pos (4) /*!< ACMP_T::STATUS: ACMPO0 Position */ +#define ACMP_STATUS_ACMPO0_Msk (0x1ul << ACMP_STATUS_ACMPO0_Pos) /*!< ACMP_T::STATUS: ACMPO0 Mask */ + +#define ACMP_STATUS_ACMPO1_Pos (5) /*!< ACMP_T::STATUS: ACMPO1 Position */ +#define ACMP_STATUS_ACMPO1_Msk (0x1ul << ACMP_STATUS_ACMPO1_Pos) /*!< ACMP_T::STATUS: ACMPO1 Mask */ + +#define ACMP_STATUS_WKIF0_Pos (8) /*!< ACMP_T::STATUS: WKIF0 Position */ +#define ACMP_STATUS_WKIF0_Msk (0x1ul << ACMP_STATUS_WKIF0_Pos) /*!< ACMP_T::STATUS: WKIF0 Mask */ + +#define ACMP_STATUS_WKIF1_Pos (9) /*!< ACMP_T::STATUS: WKIF1 Position */ +#define ACMP_STATUS_WKIF1_Msk (0x1ul << ACMP_STATUS_WKIF1_Pos) /*!< ACMP_T::STATUS: WKIF1 Mask */ + +#define ACMP_STATUS_ACMPS0_Pos (12) /*!< ACMP_T::STATUS: ACMPS0 Position */ +#define ACMP_STATUS_ACMPS0_Msk (0x1ul << ACMP_STATUS_ACMPS0_Pos) /*!< ACMP_T::STATUS: ACMPS0 Mask */ + +#define ACMP_STATUS_ACMPS1_Pos (13) /*!< ACMP_T::STATUS: ACMPS1 Position */ +#define ACMP_STATUS_ACMPS1_Msk (0x1ul << ACMP_STATUS_ACMPS1_Pos) /*!< ACMP_T::STATUS: ACMPS1 Mask */ + +#define ACMP_STATUS_ACMPWO_Pos (16) /*!< ACMP_T::STATUS: ACMPWO Position */ +#define ACMP_STATUS_ACMPWO_Msk (0x1ul << ACMP_STATUS_ACMPWO_Pos) /*!< ACMP_T::STATUS: ACMPWO Mask */ + +#define ACMP_VREF_CRVCTL_Pos (0) /*!< ACMP_T::VREF: CRVCTL Position */ +#define ACMP_VREF_CRVCTL_Msk (0xful << ACMP_VREF_CRVCTL_Pos) /*!< ACMP_T::VREF: CRVCTL Mask */ + +#define ACMP_VREF_CRVSSEL_Pos (6) /*!< ACMP_T::VREF: CRVSSEL Position */ +#define ACMP_VREF_CRVSSEL_Msk (0x1ul << ACMP_VREF_CRVSSEL_Pos) /*!< ACMP_T::VREF: CRVSSEL Mask */ + +/**@}*/ /* ACMP_CONST */ +/**@}*/ /* end of ACMP register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __ACMP_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/bpwm_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/bpwm_reg.h new file mode 100644 index 00000000000..3a4fc35fdd3 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/bpwm_reg.h @@ -0,0 +1,1835 @@ +/**************************************************************************//** + * @file bpwm_reg.h + * @version V1.00 + * @brief BPWM register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __BPWM_REG_H__ +#define __BPWM_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup BPWM Basic Pulse Width Modulation Controller(BPWM) + Memory Mapped Structure for BPWM Controller +@{ */ + +typedef struct +{ + /** + * @var BCAPDAT_T::RCAPDAT + * Offset: 0x20C BPWM Rising Capture Data Register 0~5 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |RCAPDAT |BPWM Rising Capture Data (Read Only) + * | | |When rising capture condition happened, the BPWM counter value will be saved in this register. + * @var BCAPDAT_T::FCAPDAT + * Offset: 0x210 BPWM Falling Capture Data Register 0~5 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |FCAPDAT |BPWM Falling Capture Data (Read Only) + * | | |When falling capture condition happened, the BPWM counter value will be saved in this register. + */ + __IO uint32_t RCAPDAT; /*!< [0x20C/0x214/0x21C/0x224/0x22C/0x234] BPWM Rising Capture Data Register 0~5 */ + __IO uint32_t FCAPDAT; /*!< [0x210/0x218/0x220/0x228/0x230/0x238] BPWM Falling Capture Data Register 0~5 */ +} BCAPDAT_T; + +typedef struct +{ + + + /** + * @var BPWM_T::CTL0 + * Offset: 0x00 BPWM Control Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CTRLD0 |Center Re-load + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |In up-down counter type, PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the center point of a period + * |[1] |CTRLD1 |Center Re-load + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |In up-down counter type, PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the center point of a period + * |[2] |CTRLD2 |Center Re-load + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |In up-down counter type, PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the center point of a period + * |[3] |CTRLD3 |Center Re-load + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |In up-down counter type, PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the center point of a period + * |[4] |CTRLD4 |Center Re-load + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |In up-down counter type, PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the center point of a period + * |[5] |CTRLD5 |Center Re-load + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |In up-down counter type, PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the center point of a period + * |[16] |IMMLDEN0 |Immediately Load Enable Bit(S) + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point or center point of each period by setting CTRLD bit. + * | | |1 = PERIOD/CMPDAT will load to PBUF and CMPBUF immediately when software update PERIOD/CMPDAT. + * | | |Note: If IMMLDENn is Enabled, WINLDENn and CTRLDn will be invalid. + * |[17] |IMMLDEN1 |Immediately Load Enable Bit(S) + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point or center point of each period by setting CTRLD bit. + * | | |1 = PERIOD/CMPDAT will load to PBUF and CMPBUF immediately when software update PERIOD/CMPDAT. + * | | |Note: If IMMLDENn is Enabled, WINLDENn and CTRLDn will be invalid. + * |[18] |IMMLDEN2 |Immediately Load Enable Bit(S) + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point or center point of each period by setting CTRLD bit. + * | | |1 = PERIOD/CMPDAT will load to PBUF and CMPBUF immediately when software update PERIOD/CMPDAT. + * | | |Note: If IMMLDENn is Enabled, WINLDENn and CTRLDn will be invalid. + * |[19] |IMMLDEN3 |Immediately Load Enable Bit(S) + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point or center point of each period by setting CTRLD bit. + * | | |1 = PERIOD/CMPDAT will load to PBUF and CMPBUF immediately when software update PERIOD/CMPDAT. + * | | |Note: If IMMLDENn is Enabled, WINLDENn and CTRLDn will be invalid. + * |[20] |IMMLDEN4 |Immediately Load Enable Bit(S) + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point or center point of each period by setting CTRLD bit. + * | | |1 = PERIOD/CMPDAT will load to PBUF and CMPBUF immediately when software update PERIOD/CMPDAT. + * | | |Note: If IMMLDENn is Enabled, WINLDENn and CTRLDn will be invalid. + * |[21] |IMMLDEN5 |Immediately Load Enable Bit(S) + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point or center point of each period by setting CTRLD bit. + * | | |1 = PERIOD/CMPDAT will load to PBUF and CMPBUF immediately when software update PERIOD/CMPDAT. + * | | |Note: If IMMLDENn is Enabled, WINLDENn and CTRLDn will be invalid. + * |[30] |DBGHALT |ICE Debug Mode Counter Halt (Write Protect) + * | | |If counter halt is enabled, BPWM all counters will keep current value until exit ICE debug mode. + * | | |0 = ICE debug mode counter halt Disabled. + * | | |1 = ICE debug mode counter halt Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[31] |DBGTRIOFF |ICE Debug Mode Acknowledge Disable (Write Protect) + * | | |0 = ICE debug mode acknowledgement effects BPWM output. + * | | |BPWM pin will be forced as tri-state while ICE debug mode acknowledged. + * | | |1 = ICE debug mode acknowledgement Disabled. + * | | |BPWM pin will keep output no matter ICE debug mode acknowledged or not. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * @var BPWM_T::CTL1 + * Offset: 0x04 BPWM Control Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |CNTTYPE0 |BPWM Counter Behavior Type 0 + * | | |Each bit n controls corresponding BPWM channel n. + * | | |00 = Up counter type (supports in capture mode). + * | | |01 = Down count type (supports in capture mode). + * | | |10 = Up-down counter type. + * | | |11 = Reserved. + * @var BPWM_T::CLKSRC + * Offset: 0x10 BPWM Clock Source Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2:0] |ECLKSRC0 |BPWM_CH01 External Clock Source Select + * | | |000 = BPWMx_CLK, x denotes 0 or 1. + * | | |001 = TIMER0 overflow. + * | | |010 = TIMER1 overflow. + * | | |011 = TIMER2 overflow. + * | | |100 = TIMER3 overflow. + * | | |Others = Reserved. + * @var BPWM_T::CLKPSC + * Offset: 0x14 BPWM Clock Prescale Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[11:0] |CLKPSC |BPWM Counter Clock Prescale + * | | |The clock of BPWM counter is decided by clock prescaler + * | | |Each BPWM pair share one BPWM counter clock prescaler + * | | |The clock of BPWM counter is divided by (CLKPSC+ 1) + * @var BPWM_T::CNTEN + * Offset: 0x20 BPWM Counter Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CNTEN0 |BPWM Counter 0 Enable Bit + * | | |0 = BPWM Counter and clock prescaler stop running. + * | | |1 = BPWM Counter and clock prescaler start running. + * @var BPWM_T::CNTCLR + * Offset: 0x24 BPWM Clear Counter Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CNTCLR0 |Clear BPWM Counter Control Bit 0 + * | | |It is automatically cleared by hardware. + * | | |0 = No effect. + * | | |1 = Clear 16-bit BPWM counter to 0000H. + * @var BPWM_T::PERIOD + * Offset: 0x30 BPWM Period Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |PERIOD |BPWM Period Register + * | | |Up-Count mode: In this mode, BPWM counter counts from 0 to PERIOD, and restarts from 0. + * | | |Down-Count mode: In this mode, BPWM counter counts from PERIOD to 0, and restarts from PERIOD. + * | | |BPWM period time = (PERIOD+1) * BPWM_CLK period. + * | | |Up-Down-Count mode: In this mode, BPWM counter counts from 0 to PERIOD, then decrements to 0 and repeats again. + * | | |BPWM period time = 2 * PERIOD * BPWM_CLK period. + * @var BPWM_T::CMPDAT[6] + * Offset: 0x50 BPWM Comparator Register 0~5 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |CMPDAT |BPWM Comparator Register + * | | |CMPDAT use to compare with CNTR to generate BPWM waveform, interrupt and trigger EADC. + * | | |In independent mode, CMPDAT0~5 denote as 6 independent BPWM_CH0~5 compared point. + * @var BPWM_T::CNT + * Offset: 0x90 BPWM Counter Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |CNT |BPWM Data Register (Read Only) + * | | |User can monitor CNTR to know the current value in 16-bit period counter. + * |[16] |DIRF |BPWM Direction Indicator Flag (Read Only) + * | | |0 = Counter is Down count. + * | | |1 = Counter is UP count. + * @var BPWM_T::WGCTL0 + * Offset: 0xB0 BPWM Generation Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |ZPCTL0 |BPWM Zero Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM zero point output Low. + * | | |10 = BPWM zero point output High. + * | | |11 = BPWM zero point output Toggle. + * | | |BPWM can control output level when BPWM counter count to zero. + * |[3:2] |ZPCTL1 |BPWM Zero Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM zero point output Low. + * | | |10 = BPWM zero point output High. + * | | |11 = BPWM zero point output Toggle. + * | | |BPWM can control output level when BPWM counter count to zero. + * |[5:4] |ZPCTL2 |BPWM Zero Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM zero point output Low. + * | | |10 = BPWM zero point output High. + * | | |11 = BPWM zero point output Toggle. + * | | |BPWM can control output level when BPWM counter count to zero. + * |[7:6] |ZPCTL3 |BPWM Zero Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM zero point output Low. + * | | |10 = BPWM zero point output High. + * | | |11 = BPWM zero point output Toggle. + * | | |BPWM can control output level when BPWM counter count to zero. + * |[9:8] |ZPCTL4 |BPWM Zero Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM zero point output Low. + * | | |10 = BPWM zero point output High. + * | | |11 = BPWM zero point output Toggle. + * | | |BPWM can control output level when BPWM counter count to zero. + * |[11:10] |ZPCTL5 |BPWM Zero Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM zero point output Low. + * | | |10 = BPWM zero point output High. + * | | |11 = BPWM zero point output Toggle. + * | | |BPWM can control output level when BPWM counter count to zero. + * |[17:16] |PRDPCTL0 |BPWM Period (Center) Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM period (center) point output Low. + * | | |10 = BPWM period (center) point output High. + * | | |11 = BPWM period (center) point output Toggle. + * | | |BPWM can control output level when BPWM counter count to (PERIOD+1). + * | | |Note: This bit is center point control when BPWM counter operating in up-down counter type. + * |[19:18] |PRDPCTL1 |BPWM Period (Center) Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM period (center) point output Low. + * | | |10 = BPWM period (center) point output High. + * | | |11 = BPWM period (center) point output Toggle. + * | | |BPWM can control output level when BPWM counter count to (PERIOD+1). + * | | |Note: This bit is center point control when BPWM counter operating in up-down counter type. + * |[21:20] |PRDPCTL2 |BPWM Period (Center) Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM period (center) point output Low. + * | | |10 = BPWM period (center) point output High. + * | | |11 = BPWM period (center) point output Toggle. + * | | |BPWM can control output level when BPWM counter count to (PERIOD+1). + * | | |Note: This bit is center point control when BPWM counter operating in up-down counter type. + * |[23:22] |PRDPCTL3 |BPWM Period (Center) Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM period (center) point output Low. + * | | |10 = BPWM period (center) point output High. + * | | |11 = BPWM period (center) point output Toggle. + * | | |BPWM can control output level when BPWM counter count to (PERIOD+1). + * | | |Note: This bit is center point control when BPWM counter operating in up-down counter type. + * |[25:24] |PRDPCTL4 |BPWM Period (Center) Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM period (center) point output Low. + * | | |10 = BPWM period (center) point output High. + * | | |11 = BPWM period (center) point output Toggle. + * | | |BPWM can control output level when BPWM counter count to (PERIOD+1). + * | | |Note: This bit is center point control when BPWM counter operating in up-down counter type. + * |[27:26] |PRDPCTL5 |BPWM Period (Center) Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM period (center) point output Low. + * | | |10 = BPWM period (center) point output High. + * | | |11 = BPWM period (center) point output Toggle. + * | | |BPWM can control output level when BPWM counter count to (PERIOD+1). + * | | |Note: This bit is center point control when BPWM counter operating in up-down counter type. + * @var BPWM_T::WGCTL1 + * Offset: 0xB4 BPWM Generation Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |CMPUCTL0 |BPWM Compare Up Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM compare up point output Low. + * | | |10 = BPWM compare up point output High. + * | | |11 = BPWM compare up point output Toggle. + * | | |BPWM can control output level when BPWM counter up count to CMPDAT. + * |[3:2] |CMPUCTL1 |BPWM Compare Up Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM compare up point output Low. + * | | |10 = BPWM compare up point output High. + * | | |11 = BPWM compare up point output Toggle. + * | | |BPWM can control output level when BPWM counter up count to CMPDAT. + * |[5:4] |CMPUCTL2 |BPWM Compare Up Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM compare up point output Low. + * | | |10 = BPWM compare up point output High. + * | | |11 = BPWM compare up point output Toggle. + * | | |BPWM can control output level when BPWM counter up count to CMPDAT. + * |[7:6] |CMPUCTL3 |BPWM Compare Up Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM compare up point output Low. + * | | |10 = BPWM compare up point output High. + * | | |11 = BPWM compare up point output Toggle. + * | | |BPWM can control output level when BPWM counter up count to CMPDAT. + * |[9:8] |CMPUCTL4 |BPWM Compare Up Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM compare up point output Low. + * | | |10 = BPWM compare up point output High. + * | | |11 = BPWM compare up point output Toggle. + * | | |BPWM can control output level when BPWM counter up count to CMPDAT. + * |[11:10] |CMPUCTL5 |BPWM Compare Up Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM compare up point output Low. + * | | |10 = BPWM compare up point output High. + * | | |11 = BPWM compare up point output Toggle. + * | | |BPWM can control output level when BPWM counter up count to CMPDAT. + * |[17:16] |CMPDCTL0 |BPWM Compare Down Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM compare down point output Low. + * | | |10 = BPWM compare down point output High. + * | | |11 = BPWM compare down point output Toggle. + * | | |BPWM can control output level when BPWM counter down count to CMPDAT. + * |[19:18] |CMPDCTL1 |BPWM Compare Down Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM compare down point output Low. + * | | |10 = BPWM compare down point output High. + * | | |11 = BPWM compare down point output Toggle. + * | | |BPWM can control output level when BPWM counter down count to CMPDAT. + * |[21:20] |CMPDCTL2 |BPWM Compare Down Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM compare down point output Low. + * | | |10 = BPWM compare down point output High. + * | | |11 = BPWM compare down point output Toggle. + * | | |BPWM can control output level when BPWM counter down count to CMPDAT. + * |[23:22] |CMPDCTL3 |BPWM Compare Down Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM compare down point output Low. + * | | |10 = BPWM compare down point output High. + * | | |11 = BPWM compare down point output Toggle. + * | | |BPWM can control output level when BPWM counter down count to CMPDAT. + * |[25:24] |CMPDCTL4 |BPWM Compare Down Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM compare down point output Low. + * | | |10 = BPWM compare down point output High. + * | | |11 = BPWM compare down point output Toggle. + * | | |BPWM can control output level when BPWM counter down count to CMPDAT. + * |[27:26] |CMPDCTL5 |BPWM Compare Down Point Control + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |00 = Do nothing. + * | | |01 = BPWM compare down point output Low. + * | | |10 = BPWM compare down point output High. + * | | |11 = BPWM compare down point output Toggle. + * | | |BPWM can control output level when BPWM counter down count to CMPDAT. + * @var BPWM_T::MSKEN + * Offset: 0xB8 BPWM Mask Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |MSKEN0 |BPWM Mask Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |The BPWM output signal will be masked when this bit is enabled + * | | |The corresponding BPWM channel n will output MSKDATn (BPWM_MSK[5:0]) data. + * | | |0 = BPWM output signal is non-masked. + * | | |1 = BPWM output signal is masked and output MSKDATn data. + * |[1] |MSKEN1 |BPWM Mask Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |The BPWM output signal will be masked when this bit is enabled + * | | |The corresponding BPWM channel n will output MSKDATn (BPWM_MSK[5:0]) data. + * | | |0 = BPWM output signal is non-masked. + * | | |1 = BPWM output signal is masked and output MSKDATn data. + * |[2] |MSKEN2 |BPWM Mask Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |The BPWM output signal will be masked when this bit is enabled + * | | |The corresponding BPWM channel n will output MSKDATn (BPWM_MSK[5:0]) data. + * | | |0 = BPWM output signal is non-masked. + * | | |1 = BPWM output signal is masked and output MSKDATn data. + * |[3] |MSKEN3 |BPWM Mask Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |The BPWM output signal will be masked when this bit is enabled + * | | |The corresponding BPWM channel n will output MSKDATn (BPWM_MSK[5:0]) data. + * | | |0 = BPWM output signal is non-masked. + * | | |1 = BPWM output signal is masked and output MSKDATn data. + * |[4] |MSKEN4 |BPWM Mask Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |The BPWM output signal will be masked when this bit is enabled + * | | |The corresponding BPWM channel n will output MSKDATn (BPWM_MSK[5:0]) data. + * | | |0 = BPWM output signal is non-masked. + * | | |1 = BPWM output signal is masked and output MSKDATn data. + * |[5] |MSKEN5 |BPWM Mask Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |The BPWM output signal will be masked when this bit is enabled + * | | |The corresponding BPWM channel n will output MSKDATn (BPWM_MSK[5:0]) data. + * | | |0 = BPWM output signal is non-masked. + * | | |1 = BPWM output signal is masked and output MSKDATn data. + * @var BPWM_T::MSK + * Offset: 0xBC BPWM Mask Data Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |MSKDAT0 |BPWM Mask Data Bit + * | | |This data bit control the state of BPWMn output pin, if corresponding mask function is enabled + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Output logic low to BPWMn. + * | | |1 = Output logic high to BPWMn. + * |[1] |MSKDAT1 |BPWM Mask Data Bit + * | | |This data bit control the state of BPWMn output pin, if corresponding mask function is enabled + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Output logic low to BPWMn. + * | | |1 = Output logic high to BPWMn. + * |[2] |MSKDAT2 |BPWM Mask Data Bit + * | | |This data bit control the state of BPWMn output pin, if corresponding mask function is enabled + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Output logic low to BPWMn. + * | | |1 = Output logic high to BPWMn. + * |[3] |MSKDAT3 |BPWM Mask Data Bit + * | | |This data bit control the state of BPWMn output pin, if corresponding mask function is enabled + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Output logic low to BPWMn. + * | | |1 = Output logic high to BPWMn. + * |[4] |MSKDAT4 |BPWM Mask Data Bit + * | | |This data bit control the state of BPWMn output pin, if corresponding mask function is enabled + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Output logic low to BPWMn. + * | | |1 = Output logic high to BPWMn. + * |[5] |MSKDAT5 |BPWM Mask Data Bit + * | | |This data bit control the state of BPWMn output pin, if corresponding mask function is enabled + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Output logic low to BPWMn. + * | | |1 = Output logic high to BPWMn. + * @var BPWM_T::POLCTL + * Offset: 0xD4 BPWM Pin Polar Inverse Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |PINV0 |BPWM PIN Polar Inverse Control + * | | |The register controls polarity state of BPWM output + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = BPWM output polar inverse Disabled. + * | | |1 = BPWM output polar inverse Enabled. + * |[1] |PINV1 |BPWM PIN Polar Inverse Control + * | | |The register controls polarity state of BPWM output + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = BPWM output polar inverse Disabled. + * | | |1 = BPWM output polar inverse Enabled. + * |[2] |PINV2 |BPWM PIN Polar Inverse Control + * | | |The register controls polarity state of BPWM output + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = BPWM output polar inverse Disabled. + * | | |1 = BPWM output polar inverse Enabled. + * |[3] |PINV3 |BPWM PIN Polar Inverse Control + * | | |The register controls polarity state of BPWM output + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = BPWM output polar inverse Disabled. + * | | |1 = BPWM output polar inverse Enabled. + * |[4] |PINV4 |BPWM PIN Polar Inverse Control + * | | |The register controls polarity state of BPWM output + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = BPWM output polar inverse Disabled. + * | | |1 = BPWM output polar inverse Enabled. + * |[5] |PINV5 |BPWM PIN Polar Inverse Control + * | | |The register controls polarity state of BPWM output + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = BPWM output polar inverse Disabled. + * | | |1 = BPWM output polar inverse Enabled. + * @var BPWM_T::POEN + * Offset: 0xD8 BPWM Output Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |POEN0 |BPWM Pin Output Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = BPWM pin at tri-state. + * | | |1 = BPWM pin in output mode. + * |[1] |POEN1 |BPWM Pin Output Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = BPWM pin at tri-state. + * | | |1 = BPWM pin in output mode. + * |[2] |POEN2 |BPWM Pin Output Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = BPWM pin at tri-state. + * | | |1 = BPWM pin in output mode. + * |[3] |POEN3 |BPWM Pin Output Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = BPWM pin at tri-state. + * | | |1 = BPWM pin in output mode. + * |[4] |POEN4 |BPWM Pin Output Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = BPWM pin at tri-state. + * | | |1 = BPWM pin in output mode. + * |[5] |POEN5 |BPWM Pin Output Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = BPWM pin at tri-state. + * | | |1 = BPWM pin in output mode. + * @var BPWM_T::INTEN + * Offset: 0xE0 BPWM Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ZIEN0 |BPWM Zero Point Interrupt 0 Enable Bit + * | | |0 = Zero point interrupt Disabled. + * | | |1 = Zero point interrupt Enabled. + * |[8] |PIEN0 |BPWM Period Point Interrupt 0 Enable Bit + * | | |0 = Period point interrupt Disabled. + * | | |1 = Period point interrupt Enabled. + * | | |Note: When up-down counter type period point means center point. + * |[16] |CMPUIEN0 |BPWM Compare Up Count Interrupt Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Compare up count interrupt Disabled. + * | | |1 = Compare up count interrupt Enabled. + * |[17] |CMPUIEN1 |BPWM Compare Up Count Interrupt Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Compare up count interrupt Disabled. + * | | |1 = Compare up count interrupt Enabled. + * |[18] |CMPUIEN2 |BPWM Compare Up Count Interrupt Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Compare up count interrupt Disabled. + * | | |1 = Compare up count interrupt Enabled. + * |[19] |CMPUIEN3 |BPWM Compare Up Count Interrupt Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Compare up count interrupt Disabled. + * | | |1 = Compare up count interrupt Enabled. + * |[20] |CMPUIEN4 |BPWM Compare Up Count Interrupt Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Compare up count interrupt Disabled. + * | | |1 = Compare up count interrupt Enabled. + * |[21] |CMPUIEN5 |BPWM Compare Up Count Interrupt Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Compare up count interrupt Disabled. + * | | |1 = Compare up count interrupt Enabled. + * |[24] |CMPDIEN0 |BPWM Compare Down Count Interrupt Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Compare down count interrupt Disabled. + * | | |1 = Compare down count interrupt Enabled. + * |[25] |CMPDIEN1 |BPWM Compare Down Count Interrupt Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Compare down count interrupt Disabled. + * | | |1 = Compare down count interrupt Enabled. + * |[26] |CMPDIEN2 |BPWM Compare Down Count Interrupt Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Compare down count interrupt Disabled. + * | | |1 = Compare down count interrupt Enabled. + * |[27] |CMPDIEN3 |BPWM Compare Down Count Interrupt Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Compare down count interrupt Disabled. + * | | |1 = Compare down count interrupt Enabled. + * |[28] |CMPDIEN4 |BPWM Compare Down Count Interrupt Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Compare down count interrupt Disabled. + * | | |1 = Compare down count interrupt Enabled. + * |[29] |CMPDIEN5 |BPWM Compare Down Count Interrupt Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Compare down count interrupt Disabled. + * | | |1 = Compare down count interrupt Enabled. + * @var BPWM_T::INTSTS + * Offset: 0xE8 BPWM Interrupt Flag Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ZIF0 |BPWM Zero Point Interrupt Flag 0 + * | | |This bit is set by hardware when BPWM_CH0 counter reaches zero, software can write 1 to clear this bit to zero. + * |[8] |PIF0 |BPWM Period Point Interrupt Flag 0 + * | | |This bit is set by hardware when BPWM_CH0 counter reaches BPWM_PERIOD0, software can write 1 to clear this bit to zero. + * |[16] |CMPUIF0 |BPWM Compare Up Count Interrupt Flag + * | | |Flag is set by hardware when BPWM counter up count and reaches BPWM_CMPDATn, software can clear this bit by writing 1 to it + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Note: If CMPDAT equal to PERIOD, this flag is not working in up counter type selection. + * |[17] |CMPUIF1 |BPWM Compare Up Count Interrupt Flag + * | | |Flag is set by hardware when BPWM counter up count and reaches BPWM_CMPDATn, software can clear this bit by writing 1 to it + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Note: If CMPDAT equal to PERIOD, this flag is not working in up counter type selection. + * |[18] |CMPUIF2 |BPWM Compare Up Count Interrupt Flag + * | | |Flag is set by hardware when BPWM counter up count and reaches BPWM_CMPDATn, software can clear this bit by writing 1 to it + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Note: If CMPDAT equal to PERIOD, this flag is not working in up counter type selection. + * |[19] |CMPUIF3 |BPWM Compare Up Count Interrupt Flag + * | | |Flag is set by hardware when BPWM counter up count and reaches BPWM_CMPDATn, software can clear this bit by writing 1 to it + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Note: If CMPDAT equal to PERIOD, this flag is not working in up counter type selection. + * |[20] |CMPUIF4 |BPWM Compare Up Count Interrupt Flag + * | | |Flag is set by hardware when BPWM counter up count and reaches BPWM_CMPDATn, software can clear this bit by writing 1 to it + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Note: If CMPDAT equal to PERIOD, this flag is not working in up counter type selection. + * |[21] |CMPUIF5 |BPWM Compare Up Count Interrupt Flag + * | | |Flag is set by hardware when BPWM counter up count and reaches BPWM_CMPDATn, software can clear this bit by writing 1 to it + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Note: If CMPDAT equal to PERIOD, this flag is not working in up counter type selection. + * |[24] |CMPDIF0 |BPWM Compare Down Count Interrupt Flag + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Flag is set by hardware when BPWM counter down count and reaches BPWM_CMPDATn, software can clear this bit by writing 1 to it. + * | | |Note: If CMPDAT equal to PERIOD, this flag is not working in down counter type selection. + * |[25] |CMPDIF1 |BPWM Compare Down Count Interrupt Flag + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Flag is set by hardware when BPWM counter down count and reaches BPWM_CMPDATn, software can clear this bit by writing 1 to it. + * | | |Note: If CMPDAT equal to PERIOD, this flag is not working in down counter type selection. + * |[26] |CMPDIF2 |BPWM Compare Down Count Interrupt Flag + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Flag is set by hardware when BPWM counter down count and reaches BPWM_CMPDATn, software can clear this bit by writing 1 to it. + * | | |Note: If CMPDAT equal to PERIOD, this flag is not working in down counter type selection. + * |[27] |CMPDIF3 |BPWM Compare Down Count Interrupt Flag + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Flag is set by hardware when BPWM counter down count and reaches BPWM_CMPDATn, software can clear this bit by writing 1 to it. + * | | |Note: If CMPDAT equal to PERIOD, this flag is not working in down counter type selection. + * |[28] |CMPDIF4 |BPWM Compare Down Count Interrupt Flag + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Flag is set by hardware when BPWM counter down count and reaches BPWM_CMPDATn, software can clear this bit by writing 1 to it. + * | | |Note: If CMPDAT equal to PERIOD, this flag is not working in down counter type selection. + * |[29] |CMPDIF5 |BPWM Compare Down Count Interrupt Flag + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Flag is set by hardware when BPWM counter down count and reaches BPWM_CMPDATn, software can clear this bit by writing 1 to it. + * | | |Note: If CMPDAT equal to PERIOD, this flag is not working in down counter type selection. + * @var BPWM_T::EADCTS0 + * Offset: 0xF8 BPWM Trigger EADC Source Select Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |TRGSEL0 |BPWM_CH0 Trigger EADC Source Select + * | | |0000 = BPWM_CH0 zero point. + * | | |0001 = BPWM_CH0 period point. + * | | |0010 = BPWM_CH0 zero or period point. + * | | |0011 = BPWM_CH0 up-count CMPDAT point. + * | | |0100 = BPWM_CH0 down-count CMPDAT point. + * | | |0101 = Reserved. + * | | |0110 = Reserved. + * | | |0111 = Reserved. + * | | |1000 = BPWM_CH1 up-count CMPDAT point. + * | | |1001 = BPWM_CH1 down-count CMPDAT point. + * | | |Others reserved + * |[7] |TRGEN0 |BPWM_CH0 Trigger EADC Enable Bit + * |[11:8] |TRGSEL1 |BPWM_CH1 Trigger EADC Source Select + * | | |0000 = BPWM_CH0 zero point. + * | | |0001 = BPWM_CH0 period point. + * | | |0010 = BPWM_CH0 zero or period point. + * | | |0011 = BPWM_CH0 up-count CMPDAT point. + * | | |0100 = BPWM_CH0 down-count CMPDAT point. + * | | |0101 = Reserved. + * | | |0110 = Reserved. + * | | |0111 = Reserved. + * | | |1000 = BPWM_CH1 up-count CMPDAT point. + * | | |1001 = BPWM_CH1 down-count CMPDAT point. + * | | |Others reserved + * |[15] |TRGEN1 |BPWM_CH1 Trigger EADC Enable Bit + * |[19:16] |TRGSEL2 |BPWM_CH2 Trigger EADC Source Select + * | | |0000 = BPWM_CH2 zero point. + * | | |0001 = BPWM_CH2 period point. + * | | |0010 = BPWM_CH2 zero or period point. + * | | |0011 = BPWM_CH2 up-count CMPDAT point. + * | | |0100 = BPWM_CH2 down-count CMPDAT point. + * | | |0101 = Reserved. + * | | |0110 = Reserved. + * | | |0111 = Reserved. + * | | |1000 = BPWM_CH3 up-count CMPDAT point. + * | | |1001 = BPWM_CH3 down-count CMPDAT point. + * | | |Others reserved + * |[23] |TRGEN2 |BPWM_CH2 Trigger EADC Enable Bit + * |[27:24] |TRGSEL3 |BPWM_CH3 Trigger EADC Source Select + * | | |0000 = BPWM_CH2 zero point. + * | | |0001 = BPWM_CH2 period point. + * | | |0010 = BPWM_CH2 zero or period point. + * | | |0011 = BPWM_CH2 up-count CMPDAT point. + * | | |0100 = BPWM_CH2 down-count CMPDAT point. + * | | |0101 = Reserved. + * | | |0110 = Reserved. + * | | |0111 = Reserved. + * | | |1000 = BPWM_CH3 up-count CMPDAT point. + * | | |1001 = BPWM_CH3 down-count CMPDAT point. + * | | |Others reserved. + * |[31] |TRGEN3 |BPWM_CH3 Trigger EADC Enable Bit + * @var BPWM_T::EADCTS1 + * Offset: 0xFC BPWM Trigger EADC Source Select Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |TRGSEL4 |BPWM_CH4 Trigger EADC Source Select + * | | |0000 = BPWM_CH4 zero point. + * | | |0001 = BPWM_CH4 period point. + * | | |0010 = BPWM_CH4 zero or period point. + * | | |0011 = BPWM_CH4 up-count CMPDAT point. + * | | |0100 = BPWM_CH4 down-count CMPDAT point. + * | | |0101 = Reserved. + * | | |0110 = Reserved. + * | | |0111 = Reserved. + * | | |1000 = BPWM_CH5 up-count CMPDAT point. + * | | |1001 = BPWM_CH5 down-count CMPDAT point. + * | | |Others reserved + * |[7] |TRGEN4 |BPWM_CH4 Trigger EADC Enable Bit + * |[11:8] |TRGSEL5 |BPWM_CH5 Trigger EADC Source Select + * | | |0000 = BPWM_CH4 zero point. + * | | |0001 = BPWM_CH4 period point. + * | | |0010 = BPWM_CH4 zero or period point. + * | | |0011 = BPWM_CH4 up-count CMPDAT point. + * | | |0100 = BPWM_CH4 down-count CMPDAT point. + * | | |0101 = Reserved. + * | | |0110 = Reserved. + * | | |0111 = Reserved. + * | | |1000 = BPWM_CH5 up-count CMPDAT point. + * | | |1001 = BPWM_CH5 down-count CMPDAT point. + * | | |Others reserved + * |[15] |TRGEN5 |BPWM_CH5 Trigger EADC Enable Bit + * @var BPWM_T::SSCTL + * Offset: 0x110 BPWM Synchronous Start Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SSEN0 |BPWM Synchronous Start Function 0 Enable Bit + * | | |When synchronous start function is enabled, the BPWM_CH0 counter enable bit (CNTEN0) can be enabled by writing BPWM synchronous start trigger bit (CNTSEN). + * | | |0 = BPWM synchronous start function Disabled. + * | | |1 = BPWM synchronous start function Enabled. + * |[9:8] |SSRC |BPWM Synchronous Start Source Select + * | | |00 = Synchronous start source come from PWM0. + * | | |01 = Synchronous start source come from PWM1. + * | | |10 = Synchronous start source come from BPWM0. + * | | |11 = Synchronous start source come from BPWM1. + * @var BPWM_T::SSTRG + * Offset: 0x114 BPWM Synchronous Start Trigger Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CNTSEN |BPWM Counter Synchronous Start Enable Bit(Write Only) + * | | |BPMW counter synchronous enable function is used to make PWM or BPWM channels start counting at the same time. + * | | |Writing this bit to 1 will also set the counter enable bit if correlated BPWM channel counter synchronous start function is enabled. + * @var BPWM_T::STATUS + * Offset: 0x120 BPWM Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CNTMAX0 |Time-base Counter 0 Equal to 0xFFFF Latched Status + * | | |0 = indicates the time-base counter never reached its maximum value 0xFFFF. + * | | |1 = indicates the time-base counter reached its maximum value, software can write 1 to clear this bit. + * |[16] |EADCTRG0 |EADC Start of Conversion Status + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Indicates no EADC start of conversion trigger event has occurred. + * | | |1 = Indicates an EADC start of conversion trigger event has occurred, software can write 1 to clear this bit. + * |[17] |EADCTRG1 |EADC Start of Conversion Status + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Indicates no EADC start of conversion trigger event has occurred. + * | | |1 = Indicates an EADC start of conversion trigger event has occurred, software can write 1 to clear this bit. + * |[18] |EADCTRG2 |EADC Start of Conversion Status + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Indicates no EADC start of conversion trigger event has occurred. + * | | |1 = Indicates an EADC start of conversion trigger event has occurred, software can write 1 to clear this bit. + * |[19] |EADCTRG3 |EADC Start of Conversion Status + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Indicates no EADC start of conversion trigger event has occurred. + * | | |1 = Indicates an EADC start of conversion trigger event has occurred, software can write 1 to clear this bit. + * |[20] |EADCTRG4 |EADC Start of Conversion Status + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Indicates no EADC start of conversion trigger event has occurred. + * | | |1 = Indicates an EADC start of conversion trigger event has occurred, software can write 1 to clear this bit. + * |[21] |EADCTRG5 |EADC Start of Conversion Status + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Indicates no EADC start of conversion trigger event has occurred. + * | | |1 = Indicates an EADC start of conversion trigger event has occurred, software can write 1 to clear this bit. + * @var BPWM_T::CAPINEN + * Offset: 0x200 BPWM Capture Input Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CAPINEN0 |Capture Input Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = BPWM Channel capture input path Disabled + * | | |The input of BPWM channel capture function is always regarded as 0. + * | | |1 = BPWM Channel capture input path Enabled + * | | |The input of BPWM channel capture function comes from correlative multifunction pin. + * |[1] |CAPINEN1 |Capture Input Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = BPWM Channel capture input path Disabled + * | | |The input of BPWM channel capture function is always regarded as 0. + * | | |1 = BPWM Channel capture input path Enabled + * | | |The input of BPWM channel capture function comes from correlative multifunction pin. + * |[2] |CAPINEN2 |Capture Input Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = BPWM Channel capture input path Disabled + * | | |The input of BPWM channel capture function is always regarded as 0. + * | | |1 = BPWM Channel capture input path Enabled + * | | |The input of BPWM channel capture function comes from correlative multifunction pin. + * |[3] |CAPINEN3 |Capture Input Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = BPWM Channel capture input path Disabled + * | | |The input of BPWM channel capture function is always regarded as 0. + * | | |1 = BPWM Channel capture input path Enabled + * | | |The input of BPWM channel capture function comes from correlative multifunction pin. + * |[4] |CAPINEN4 |Capture Input Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = BPWM Channel capture input path Disabled + * | | |The input of BPWM channel capture function is always regarded as 0. + * | | |1 = BPWM Channel capture input path Enabled + * | | |The input of BPWM channel capture function comes from correlative multifunction pin. + * |[5] |CAPINEN5 |Capture Input Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = BPWM Channel capture input path Disabled + * | | |The input of BPWM channel capture function is always regarded as 0. + * | | |1 = BPWM Channel capture input path Enabled + * | | |The input of BPWM channel capture function comes from correlative multifunction pin. + * @var BPWM_T::CAPCTL + * Offset: 0x204 BPWM Capture Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CAPEN0 |Capture Function Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Capture function Disabled. RCAPDAT/FCAPDAT register will not be updated. + * | | |1 = Capture function Enabled + * | | |Capture latched the BPWM counter value when detected rising or falling edge of input signal and saved to RCAPDAT (Rising latch) and FCAPDAT (Falling latch). + * |[1] |CAPEN1 |Capture Function Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Capture function Disabled. RCAPDAT/FCAPDAT register will not be updated. + * | | |1 = Capture function Enabled + * | | |Capture latched the BPWM counter value when detected rising or falling edge of input signal and saved to RCAPDAT (Rising latch) and FCAPDAT (Falling latch). + * |[2] |CAPEN2 |Capture Function Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Capture function Disabled. RCAPDAT/FCAPDAT register will not be updated. + * | | |1 = Capture function Enabled + * | | |Capture latched the BPWM counter value when detected rising or falling edge of input signal and saved to RCAPDAT (Rising latch) and FCAPDAT (Falling latch). + * |[3] |CAPEN3 |Capture Function Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Capture function Disabled. RCAPDAT/FCAPDAT register will not be updated. + * | | |1 = Capture function Enabled + * | | |Capture latched the BPWM counter value when detected rising or falling edge of input signal and saved to RCAPDAT (Rising latch) and FCAPDAT (Falling latch). + * |[4] |CAPEN4 |Capture Function Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Capture function Disabled. RCAPDAT/FCAPDAT register will not be updated. + * | | |1 = Capture function Enabled + * | | |Capture latched the BPWM counter value when detected rising or falling edge of input signal and saved to RCAPDAT (Rising latch) and FCAPDAT (Falling latch). + * |[5] |CAPEN5 |Capture Function Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Capture function Disabled. RCAPDAT/FCAPDAT register will not be updated. + * | | |1 = Capture function Enabled + * | | |Capture latched the BPWM counter value when detected rising or falling edge of input signal and saved to RCAPDAT (Rising latch) and FCAPDAT (Falling latch). + * |[8] |CAPINV0 |Capture Inverter Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Capture source inverter Disabled. + * | | |1 = Capture source inverter Enabled. Reverse the input signal from GPIO. + * |[9] |CAPINV1 |Capture Inverter Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Capture source inverter Disabled. + * | | |1 = Capture source inverter Enabled. Reverse the input signal from GPIO. + * |[10] |CAPINV2 |Capture Inverter Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Capture source inverter Disabled. + * | | |1 = Capture source inverter Enabled. Reverse the input signal from GPIO. + * |[11] |CAPINV3 |Capture Inverter Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Capture source inverter Disabled. + * | | |1 = Capture source inverter Enabled. Reverse the input signal from GPIO. + * |[12] |CAPINV4 |Capture Inverter Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Capture source inverter Disabled. + * | | |1 = Capture source inverter Enabled. Reverse the input signal from GPIO. + * |[13] |CAPINV5 |Capture Inverter Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Capture source inverter Disabled. + * | | |1 = Capture source inverter Enabled. Reverse the input signal from GPIO. + * |[16] |RCRLDEN0 |Rising Capture Reload Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Rising capture reload counter Disabled. + * | | |1 = Rising capture reload counter Enabled. + * |[17] |RCRLDEN1 |Rising Capture Reload Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Rising capture reload counter Disabled. + * | | |1 = Rising capture reload counter Enabled. + * |[18] |RCRLDEN2 |Rising Capture Reload Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Rising capture reload counter Disabled. + * | | |1 = Rising capture reload counter Enabled. + * |[19] |RCRLDEN3 |Rising Capture Reload Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Rising capture reload counter Disabled. + * | | |1 = Rising capture reload counter Enabled. + * |[20] |RCRLDEN4 |Rising Capture Reload Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Rising capture reload counter Disabled. + * | | |1 = Rising capture reload counter Enabled. + * |[21] |RCRLDEN5 |Rising Capture Reload Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Rising capture reload counter Disabled. + * | | |1 = Rising capture reload counter Enabled. + * |[24] |FCRLDEN0 |Falling Capture Reload Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Falling capture reload counter Disabled. + * | | |1 = Falling capture reload counter Enabled. + * |[25] |FCRLDEN1 |Falling Capture Reload Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Falling capture reload counter Disabled. + * | | |1 = Falling capture reload counter Enabled. + * |[26] |FCRLDEN2 |Falling Capture Reload Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Falling capture reload counter Disabled. + * | | |1 = Falling capture reload counter Enabled. + * |[27] |FCRLDEN3 |Falling Capture Reload Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Falling capture reload counter Disabled. + * | | |1 = Falling capture reload counter Enabled. + * |[28] |FCRLDEN4 |Falling Capture Reload Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Falling capture reload counter Disabled. + * | | |1 = Falling capture reload counter Enabled. + * |[29] |FCRLDEN5 |Falling Capture Reload Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Falling capture reload counter Disabled. + * | | |1 = Falling capture reload counter Enabled. + * @var BPWM_T::CAPSTS + * Offset: 0x208 BPWM Capture Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CRIFOV0 |Capture Rising Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if rising latch happened when the corresponding CAPRIF is 1 + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Note: This bit will be cleared automatically when user clear corresponding CAPRIF. + * |[1] |CRIFOV1 |Capture Rising Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if rising latch happened when the corresponding CAPRIF is 1 + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Note: This bit will be cleared automatically when user clear corresponding CAPRIF. + * |[2] |CRIFOV2 |Capture Rising Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if rising latch happened when the corresponding CAPRIF is 1 + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Note: This bit will be cleared automatically when user clear corresponding CAPRIF. + * |[3] |CRIFOV3 |Capture Rising Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if rising latch happened when the corresponding CAPRIF is 1 + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Note: This bit will be cleared automatically when user clear corresponding CAPRIF. + * |[4] |CRIFOV4 |Capture Rising Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if rising latch happened when the corresponding CAPRIF is 1 + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Note: This bit will be cleared automatically when user clear corresponding CAPRIF. + * |[5] |CRIFOV5 |Capture Rising Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if rising latch happened when the corresponding CAPRIF is 1 + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Note: This bit will be cleared automatically when user clear corresponding CAPRIF. + * |[8] |CFIFOV0 |Capture Falling Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if falling latch happened when the corresponding CAPFIF is 1 + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Note: This bit will be cleared automatically when user clear corresponding CAPFIF. + * |[9] |CFIFOV1 |Capture Falling Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if falling latch happened when the corresponding CAPFIF is 1 + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Note: This bit will be cleared automatically when user clear corresponding CAPFIF. + * |[10] |CFIFOV2 |Capture Falling Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if falling latch happened when the corresponding CAPFIF is 1 + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Note: This bit will be cleared automatically when user clear corresponding CAPFIF. + * |[11] |CFIFOV3 |Capture Falling Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if falling latch happened when the corresponding CAPFIF is 1 + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Note: This bit will be cleared automatically when user clear corresponding CAPFIF. + * |[12] |CFIFOV4 |Capture Falling Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if falling latch happened when the corresponding CAPFIF is 1 + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Note: This bit will be cleared automatically when user clear corresponding CAPFIF. + * |[13] |CFIFOV5 |Capture Falling Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if falling latch happened when the corresponding CAPFIF is 1 + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |Note: This bit will be cleared automatically when user clear corresponding CAPFIF. + * @var BPWM_T::CAPIEN + * Offset: 0x250 BPWM Capture Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[5:0] |CAPRIENn |BPWM Capture Rising Latch Interrupt Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Capture rising edge latch interrupt Disabled. + * | | |1 = Capture rising edge latch interrupt Enabled. + * |[13:8] |CAPFIENn |BPWM Capture Falling Latch Interrupt Enable Bits + * | | |Each bit n controls the corresponding BPWM channel n. + * | | |0 = Capture falling edge latch interrupt Disabled. + * | | |1 = Capture falling edge latch interrupt Enabled. + * @var BPWM_T::CAPIF + * Offset: 0x254 BPWM Capture Interrupt Flag Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CAPRIF0 |BPWM Capture Rising Latch Interrupt Flag + * | | |This bit is writing 1 to clear. Each bit n controls the corresponding BPWM channel n. + * | | |0 = No capture rising latch condition happened. + * | | |1 = Capture rising latch condition happened, this flag will be set to high. + * |[1] |CAPRIF1 |BPWM Capture Rising Latch Interrupt Flag + * | | |This bit is writing 1 to clear. Each bit n controls the corresponding BPWM channel n. + * | | |0 = No capture rising latch condition happened. + * | | |1 = Capture rising latch condition happened, this flag will be set to high. + * |[2] |CAPRIF2 |BPWM Capture Rising Latch Interrupt Flag + * | | |This bit is writing 1 to clear. Each bit n controls the corresponding BPWM channel n. + * | | |0 = No capture rising latch condition happened. + * | | |1 = Capture rising latch condition happened, this flag will be set to high. + * |[3] |CAPRIF3 |BPWM Capture Rising Latch Interrupt Flag + * | | |This bit is writing 1 to clear. Each bit n controls the corresponding BPWM channel n. + * | | |0 = No capture rising latch condition happened. + * | | |1 = Capture rising latch condition happened, this flag will be set to high. + * |[4] |CAPRIF4 |BPWM Capture Rising Latch Interrupt Flag + * | | |This bit is writing 1 to clear. Each bit n controls the corresponding BPWM channel n. + * | | |0 = No capture rising latch condition happened. + * | | |1 = Capture rising latch condition happened, this flag will be set to high. + * |[5] |CAPRIF5 |BPWM Capture Rising Latch Interrupt Flag + * | | |This bit is writing 1 to clear. Each bit n controls the corresponding BPWM channel n. + * | | |0 = No capture rising latch condition happened. + * | | |1 = Capture rising latch condition happened, this flag will be set to high. + * |[8] |CAPFIF0 |BPWM Capture Falling Latch Interrupt Flag + * | | |This bit is writing 1 to clear. Each bit n controls the corresponding BPWM channel n. + * | | |0 = No capture falling latch condition happened. + * | | |1 = Capture falling latch condition happened, this flag will be set to high. + * |[9] |CAPFIF1 |BPWM Capture Falling Latch Interrupt Flag + * | | |This bit is writing 1 to clear. Each bit n controls the corresponding BPWM channel n. + * | | |0 = No capture falling latch condition happened. + * | | |1 = Capture falling latch condition happened, this flag will be set to high. + * |[10] |CAPFIF2 |BPWM Capture Falling Latch Interrupt Flag + * | | |This bit is writing 1 to clear. Each bit n controls the corresponding BPWM channel n. + * | | |0 = No capture falling latch condition happened. + * | | |1 = Capture falling latch condition happened, this flag will be set to high. + * |[11] |CAPFIF3 |BPWM Capture Falling Latch Interrupt Flag + * | | |This bit is writing 1 to clear. Each bit n controls the corresponding BPWM channel n. + * | | |0 = No capture falling latch condition happened. + * | | |1 = Capture falling latch condition happened, this flag will be set to high. + * |[12] |CAPFIF4 |BPWM Capture Falling Latch Interrupt Flag + * | | |This bit is writing 1 to clear. Each bit n controls the corresponding BPWM channel n. + * | | |0 = No capture falling latch condition happened. + * | | |1 = Capture falling latch condition happened, this flag will be set to high. + * |[13] |CAPFIF5 |BPWM Capture Falling Latch Interrupt Flag + * | | |This bit is writing 1 to clear. Each bit n controls the corresponding BPWM channel n. + * | | |0 = No capture falling latch condition happened. + * | | |1 = Capture falling latch condition happened, this flag will be set to high. + * @var BPWM_T::PBUF + * Offset: 0x304 BPWM PERIOD Buffer + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |PBUF |BPWM Period Buffer (Read Only) + * | | |Used as PERIOD active register. + * @var BPWM_T::CMPBUF[6] + * Offset: 0x31C BPWM CMPDAT 0~5 Buffer + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |CMPBUF |BPWM Comparator Buffer (Read Only) + * | | |Used as CMP active register. + */ + __IO uint32_t CTL0; /*!< [0x0000] BPWM Control Register 0 */ + __IO uint32_t CTL1; /*!< [0x0004] BPWM Control Register 1 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[2]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t CLKSRC; /*!< [0x0010] BPWM Clock Source Register */ + __IO uint32_t CLKPSC; /*!< [0x0014] BPWM Clock Prescale Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE1[2]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t CNTEN; /*!< [0x0020] BPWM Counter Enable Register */ + __IO uint32_t CNTCLR; /*!< [0x0024] BPWM Clear Counter Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE2[2]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t PERIOD; /*!< [0x0030] BPWM Period Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE3[7]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t CMPDAT[6]; /*!< [0x0050] BPWM Comparator Register 0~5 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE4[10]; + /// @endcond //HIDDEN_SYMBOLS + __I uint32_t CNT; /*!< [0x0090] BPWM Counter Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE5[7]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t WGCTL0; /*!< [0x00b0] BPWM Generation Register 0 */ + __IO uint32_t WGCTL1; /*!< [0x00b4] BPWM Generation Register 1 */ + __IO uint32_t MSKEN; /*!< [0x00b8] BPWM Mask Enable Register */ + __IO uint32_t MSK; /*!< [0x00bc] BPWM Mask Data Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE6[5]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t POLCTL; /*!< [0x00d4] BPWM Pin Polar Inverse Register */ + __IO uint32_t POEN; /*!< [0x00d8] BPWM Output Enable Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE7[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t INTEN; /*!< [0x00e0] BPWM Interrupt Enable Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE8[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t INTSTS; /*!< [0x00e8] BPWM Interrupt Flag Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE9[3]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t EADCTS0; /*!< [0x00f8] BPWM Trigger EADC Source Select Register 0 */ + __IO uint32_t EADCTS1; /*!< [0x00fc] BPWM Trigger EADC Source Select Register 1 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE10[4]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t SSCTL; /*!< [0x0110] BPWM Synchronous Start Control Register */ + __O uint32_t SSTRG; /*!< [0x0114] BPWM Synchronous Start Trigger Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE11[2]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t STATUS; /*!< [0x0120] BPWM Status Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE12[55]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t CAPINEN; /*!< [0x0200] BPWM Capture Input Enable Register */ + __IO uint32_t CAPCTL; /*!< [0x0204] BPWM Capture Control Register */ + __I uint32_t CAPSTS; /*!< [0x0208] BPWM Capture Status Register */ + BCAPDAT_T CAPDAT[6]; /*!< [0x020C] BPWM Rising and Falling Capture Data Register 0~5 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE13[5]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t CAPIEN; /*!< [0x0250] BPWM Capture Interrupt Enable Register */ + __IO uint32_t CAPIF; /*!< [0x0254] BPWM Capture Interrupt Flag Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE14[43]; + /// @endcond //HIDDEN_SYMBOLS + __I uint32_t PBUF; /*!< [0x0304] BPWM PERIOD Buffer */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE15[5]; + /// @endcond //HIDDEN_SYMBOLS + __I uint32_t CMPBUF[6]; /*!< [0x031c] BPWM CMPDAT 0~5 Buffer */ + +} BPWM_T; + +/** + @addtogroup BPWM_CONST BPWM Bit Field Definition + Constant Definitions for BPWM Controller +@{ */ + +#define BPWM_CTL0_CTRLD0_Pos (0) /*!< BPWM_T::CTL0: CTRLD0 Position */ +#define BPWM_CTL0_CTRLD0_Msk (0x1ul << BPWM_CTL0_CTRLD0_Pos) /*!< BPWM_T::CTL0: CTRLD0 Mask */ + +#define BPWM_CTL0_CTRLD1_Pos (1) /*!< BPWM_T::CTL0: CTRLD1 Position */ +#define BPWM_CTL0_CTRLD1_Msk (0x1ul << BPWM_CTL0_CTRLD1_Pos) /*!< BPWM_T::CTL0: CTRLD1 Mask */ + +#define BPWM_CTL0_CTRLD2_Pos (2) /*!< BPWM_T::CTL0: CTRLD2 Position */ +#define BPWM_CTL0_CTRLD2_Msk (0x1ul << BPWM_CTL0_CTRLD2_Pos) /*!< BPWM_T::CTL0: CTRLD2 Mask */ + +#define BPWM_CTL0_CTRLD3_Pos (3) /*!< BPWM_T::CTL0: CTRLD3 Position */ +#define BPWM_CTL0_CTRLD3_Msk (0x1ul << BPWM_CTL0_CTRLD3_Pos) /*!< BPWM_T::CTL0: CTRLD3 Mask */ + +#define BPWM_CTL0_CTRLD4_Pos (4) /*!< BPWM_T::CTL0: CTRLD4 Position */ +#define BPWM_CTL0_CTRLD4_Msk (0x1ul << BPWM_CTL0_CTRLD4_Pos) /*!< BPWM_T::CTL0: CTRLD4 Mask */ + +#define BPWM_CTL0_CTRLD5_Pos (5) /*!< BPWM_T::CTL0: CTRLD5 Position */ +#define BPWM_CTL0_CTRLD5_Msk (0x1ul << BPWM_CTL0_CTRLD5_Pos) /*!< BPWM_T::CTL0: CTRLD5 Mask */ + +#define BPWM_CTL0_IMMLDEN0_Pos (16) /*!< BPWM_T::CTL0: IMMLDEN0 Position */ +#define BPWM_CTL0_IMMLDEN0_Msk (0x1ul << BPWM_CTL0_IMMLDEN0_Pos) /*!< BPWM_T::CTL0: IMMLDEN0 Mask */ + +#define BPWM_CTL0_IMMLDEN1_Pos (17) /*!< BPWM_T::CTL0: IMMLDEN1 Position */ +#define BPWM_CTL0_IMMLDEN1_Msk (0x1ul << BPWM_CTL0_IMMLDEN1_Pos) /*!< BPWM_T::CTL0: IMMLDEN1 Mask */ + +#define BPWM_CTL0_IMMLDEN2_Pos (18) /*!< BPWM_T::CTL0: IMMLDEN2 Position */ +#define BPWM_CTL0_IMMLDEN2_Msk (0x1ul << BPWM_CTL0_IMMLDEN2_Pos) /*!< BPWM_T::CTL0: IMMLDEN2 Mask */ + +#define BPWM_CTL0_IMMLDEN3_Pos (19) /*!< BPWM_T::CTL0: IMMLDEN3 Position */ +#define BPWM_CTL0_IMMLDEN3_Msk (0x1ul << BPWM_CTL0_IMMLDEN3_Pos) /*!< BPWM_T::CTL0: IMMLDEN3 Mask */ + +#define BPWM_CTL0_IMMLDEN4_Pos (20) /*!< BPWM_T::CTL0: IMMLDEN4 Position */ +#define BPWM_CTL0_IMMLDEN4_Msk (0x1ul << BPWM_CTL0_IMMLDEN4_Pos) /*!< BPWM_T::CTL0: IMMLDEN4 Mask */ + +#define BPWM_CTL0_IMMLDEN5_Pos (21) /*!< BPWM_T::CTL0: IMMLDEN5 Position */ +#define BPWM_CTL0_IMMLDEN5_Msk (0x1ul << BPWM_CTL0_IMMLDEN5_Pos) /*!< BPWM_T::CTL0: IMMLDEN5 Mask */ + +#define BPWM_CTL0_DBGHALT_Pos (30) /*!< BPWM_T::CTL0: DBGHALT Position */ +#define BPWM_CTL0_DBGHALT_Msk (0x1ul << BPWM_CTL0_DBGHALT_Pos) /*!< BPWM_T::CTL0: DBGHALT Mask */ + +#define BPWM_CTL0_DBGTRIOFF_Pos (31) /*!< BPWM_T::CTL0: DBGTRIOFF Position */ +#define BPWM_CTL0_DBGTRIOFF_Msk (0x1ul << BPWM_CTL0_DBGTRIOFF_Pos) /*!< BPWM_T::CTL0: DBGTRIOFF Mask */ + +#define BPWM_CTL1_CNTTYPE0_Pos (0) /*!< BPWM_T::CTL1: CNTTYPE0 Position */ +#define BPWM_CTL1_CNTTYPE0_Msk (0x3ul << BPWM_CTL1_CNTTYPE0_Pos) /*!< BPWM_T::CTL1: CNTTYPE0 Mask */ + +#define BPWM_CLKSRC_ECLKSRC0_Pos (0) /*!< BPWM_T::CLKSRC: ECLKSRC0 Position */ +#define BPWM_CLKSRC_ECLKSRC0_Msk (0x7ul << BPWM_CLKSRC_ECLKSRC0_Pos) /*!< BPWM_T::CLKSRC: ECLKSRC0 Mask */ + +#define BPWM_CLKPSC_CLKPSC_Pos (0) /*!< BPWM_T::CLKPSC: CLKPSC Position */ +#define BPWM_CLKPSC_CLKPSC_Msk (0xffful << BPWM_CLKPSC_CLKPSC_Pos) /*!< BPWM_T::CLKPSC: CLKPSC Mask */ + +#define BPWM_CNTEN_CNTEN0_Pos (0) /*!< BPWM_T::CNTEN: CNTEN0 Position */ +#define BPWM_CNTEN_CNTEN0_Msk (0x1ul << BPWM_CNTEN_CNTEN0_Pos) /*!< BPWM_T::CNTEN: CNTEN0 Mask */ + +#define BPWM_CNTCLR_CNTCLR0_Pos (0) /*!< BPWM_T::CNTCLR: CNTCLR0 Position */ +#define BPWM_CNTCLR_CNTCLR0_Msk (0x1ul << BPWM_CNTCLR_CNTCLR0_Pos) /*!< BPWM_T::CNTCLR: CNTCLR0 Mask */ + +#define BPWM_PERIOD_PERIOD_Pos (0) /*!< BPWM_T::PERIOD: PERIOD Position */ +#define BPWM_PERIOD_PERIOD_Msk (0xfffful << BPWM_PERIOD_PERIOD_Pos) /*!< BPWM_T::PERIOD: PERIOD Mask */ + +#define BPWM_CMPDAT0_CMPDAT_Pos (0) /*!< BPWM_T::CMPDAT0: CMPDAT Position */ +#define BPWM_CMPDAT0_CMPDAT_Msk (0xfffful << BPWM_CMPDAT0_CMPDAT_Pos) /*!< BPWM_T::CMPDAT0: CMPDAT Mask */ + +#define BPWM_CMPDAT1_CMPDAT_Pos (0) /*!< BPWM_T::CMPDAT1: CMPDAT Position */ +#define BPWM_CMPDAT1_CMPDAT_Msk (0xfffful << BPWM_CMPDAT1_CMPDAT_Pos) /*!< BPWM_T::CMPDAT1: CMPDAT Mask */ + +#define BPWM_CMPDAT2_CMPDAT_Pos (0) /*!< BPWM_T::CMPDAT2: CMPDAT Position */ +#define BPWM_CMPDAT2_CMPDAT_Msk (0xfffful << BPWM_CMPDAT2_CMPDAT_Pos) /*!< BPWM_T::CMPDAT2: CMPDAT Mask */ + +#define BPWM_CMPDAT3_CMPDAT_Pos (0) /*!< BPWM_T::CMPDAT3: CMPDAT Position */ +#define BPWM_CMPDAT3_CMPDAT_Msk (0xfffful << BPWM_CMPDAT3_CMPDAT_Pos) /*!< BPWM_T::CMPDAT3: CMPDAT Mask */ + +#define BPWM_CMPDAT4_CMPDAT_Pos (0) /*!< BPWM_T::CMPDAT4: CMPDAT Position */ +#define BPWM_CMPDAT4_CMPDAT_Msk (0xfffful << BPWM_CMPDAT4_CMPDAT_Pos) /*!< BPWM_T::CMPDAT4: CMPDAT Mask */ + +#define BPWM_CMPDAT5_CMPDAT_Pos (0) /*!< BPWM_T::CMPDAT5: CMPDAT Position */ +#define BPWM_CMPDAT5_CMPDAT_Msk (0xfffful << BPWM_CMPDAT5_CMPDAT_Pos) /*!< BPWM_T::CMPDAT5: CMPDAT Mask */ + +#define BPWM_CNT_CNT_Pos (0) /*!< BPWM_T::CNT: CNT Position */ +#define BPWM_CNT_CNT_Msk (0xfffful << BPWM_CNT_CNT_Pos) /*!< BPWM_T::CNT: CNT Mask */ + +#define BPWM_CNT_DIRF_Pos (16) /*!< BPWM_T::CNT: DIRF Position */ +#define BPWM_CNT_DIRF_Msk (0x1ul << BPWM_CNT_DIRF_Pos) /*!< BPWM_T::CNT: DIRF Mask */ + +#define BPWM_WGCTL0_ZPCTL0_Pos (0) /*!< BPWM_T::WGCTL0: ZPCTL0 Position */ +#define BPWM_WGCTL0_ZPCTL0_Msk (0x3ul << BPWM_WGCTL0_ZPCTL0_Pos) /*!< BPWM_T::WGCTL0: ZPCTL0 Mask */ + +#define BPWM_WGCTL0_ZPCTL1_Pos (2) /*!< BPWM_T::WGCTL0: ZPCTL1 Position */ +#define BPWM_WGCTL0_ZPCTL1_Msk (0x3ul << BPWM_WGCTL0_ZPCTL1_Pos) /*!< BPWM_T::WGCTL0: ZPCTL1 Mask */ + +#define BPWM_WGCTL0_ZPCTL2_Pos (4) /*!< BPWM_T::WGCTL0: ZPCTL2 Position */ +#define BPWM_WGCTL0_ZPCTL2_Msk (0x3ul << BPWM_WGCTL0_ZPCTL2_Pos) /*!< BPWM_T::WGCTL0: ZPCTL2 Mask */ + +#define BPWM_WGCTL0_ZPCTL3_Pos (6) /*!< BPWM_T::WGCTL0: ZPCTL3 Position */ +#define BPWM_WGCTL0_ZPCTL3_Msk (0x3ul << BPWM_WGCTL0_ZPCTL3_Pos) /*!< BPWM_T::WGCTL0: ZPCTL3 Mask */ + +#define BPWM_WGCTL0_ZPCTL4_Pos (8) /*!< BPWM_T::WGCTL0: ZPCTL4 Position */ +#define BPWM_WGCTL0_ZPCTL4_Msk (0x3ul << BPWM_WGCTL0_ZPCTL4_Pos) /*!< BPWM_T::WGCTL0: ZPCTL4 Mask */ + +#define BPWM_WGCTL0_ZPCTL5_Pos (10) /*!< BPWM_T::WGCTL0: ZPCTL5 Position */ +#define BPWM_WGCTL0_ZPCTL5_Msk (0x3ul << BPWM_WGCTL0_ZPCTL5_Pos) /*!< BPWM_T::WGCTL0: ZPCTL5 Mask */ + +#define BPWM_WGCTL0_ZPCTLn_Pos (0) /*!< BPWM_T::WGCTL0: ZPCTLn Position */ +#define BPWM_WGCTL0_ZPCTLn_Msk (0xffful << BPWM_WGCTL0_ZPCTLn_Pos) /*!< BPWM_T::WGCTL0: ZPCTLn Mask */ + +#define BPWM_WGCTL0_PRDPCTL0_Pos (16) /*!< BPWM_T::WGCTL0: PRDPCTL0 Position */ +#define BPWM_WGCTL0_PRDPCTL0_Msk (0x3ul << BPWM_WGCTL0_PRDPCTL0_Pos) /*!< BPWM_T::WGCTL0: PRDPCTL0 Mask */ + +#define BPWM_WGCTL0_PRDPCTL1_Pos (18) /*!< BPWM_T::WGCTL0: PRDPCTL1 Position */ +#define BPWM_WGCTL0_PRDPCTL1_Msk (0x3ul << BPWM_WGCTL0_PRDPCTL1_Pos) /*!< BPWM_T::WGCTL0: PRDPCTL1 Mask */ + +#define BPWM_WGCTL0_PRDPCTL2_Pos (20) /*!< BPWM_T::WGCTL0: PRDPCTL2 Position */ +#define BPWM_WGCTL0_PRDPCTL2_Msk (0x3ul << BPWM_WGCTL0_PRDPCTL2_Pos) /*!< BPWM_T::WGCTL0: PRDPCTL2 Mask */ + +#define BPWM_WGCTL0_PRDPCTL3_Pos (22) /*!< BPWM_T::WGCTL0: PRDPCTL3 Position */ +#define BPWM_WGCTL0_PRDPCTL3_Msk (0x3ul << BPWM_WGCTL0_PRDPCTL3_Pos) /*!< BPWM_T::WGCTL0: PRDPCTL3 Mask */ + +#define BPWM_WGCTL0_PRDPCTL4_Pos (24) /*!< BPWM_T::WGCTL0: PRDPCTL4 Position */ +#define BPWM_WGCTL0_PRDPCTL4_Msk (0x3ul << BPWM_WGCTL0_PRDPCTL4_Pos) /*!< BPWM_T::WGCTL0: PRDPCTL4 Mask */ + +#define BPWM_WGCTL0_PRDPCTL5_Pos (26) /*!< BPWM_T::WGCTL0: PRDPCTL5 Position */ +#define BPWM_WGCTL0_PRDPCTL5_Msk (0x3ul << BPWM_WGCTL0_PRDPCTL5_Pos) /*!< BPWM_T::WGCTL0: PRDPCTL5 Mask */ + +#define BPWM_WGCTL0_PRDPCTLn_Pos (16) /*!< BPWM_T::WGCTL0: PRDPCTLn Position */ +#define BPWM_WGCTL0_PRDPCTLn_Msk (0xffful << BPWM_WGCTL0_PRDPCTLn_Pos) /*!< BPWM_T::WGCTL0: PRDPCTLn Mask */ + +#define BPWM_WGCTL1_CMPUCTL0_Pos (0) /*!< BPWM_T::WGCTL1: CMPUCTL0 Position */ +#define BPWM_WGCTL1_CMPUCTL0_Msk (0x3ul << BPWM_WGCTL1_CMPUCTL0_Pos) /*!< BPWM_T::WGCTL1: CMPUCTL0 Mask */ + +#define BPWM_WGCTL1_CMPUCTL1_Pos (2) /*!< BPWM_T::WGCTL1: CMPUCTL1 Position */ +#define BPWM_WGCTL1_CMPUCTL1_Msk (0x3ul << BPWM_WGCTL1_CMPUCTL1_Pos) /*!< BPWM_T::WGCTL1: CMPUCTL1 Mask */ + +#define BPWM_WGCTL1_CMPUCTL2_Pos (4) /*!< BPWM_T::WGCTL1: CMPUCTL2 Position */ +#define BPWM_WGCTL1_CMPUCTL2_Msk (0x3ul << BPWM_WGCTL1_CMPUCTL2_Pos) /*!< BPWM_T::WGCTL1: CMPUCTL2 Mask */ + +#define BPWM_WGCTL1_CMPUCTL3_Pos (6) /*!< BPWM_T::WGCTL1: CMPUCTL3 Position */ +#define BPWM_WGCTL1_CMPUCTL3_Msk (0x3ul << BPWM_WGCTL1_CMPUCTL3_Pos) /*!< BPWM_T::WGCTL1: CMPUCTL3 Mask */ + +#define BPWM_WGCTL1_CMPUCTL4_Pos (8) /*!< BPWM_T::WGCTL1: CMPUCTL4 Position */ +#define BPWM_WGCTL1_CMPUCTL4_Msk (0x3ul << BPWM_WGCTL1_CMPUCTL4_Pos) /*!< BPWM_T::WGCTL1: CMPUCTL4 Mask */ + +#define BPWM_WGCTL1_CMPUCTL5_Pos (10) /*!< BPWM_T::WGCTL1: CMPUCTL5 Position */ +#define BPWM_WGCTL1_CMPUCTL5_Msk (0x3ul << BPWM_WGCTL1_CMPUCTL5_Pos) /*!< BPWM_T::WGCTL1: CMPUCTL5 Mask */ + +#define BPWM_WGCTL1_CMPUCTLn_Pos (0) /*!< BPWM_T::WGCTL1: CMPUCTLn Position */ +#define BPWM_WGCTL1_CMPUCTLn_Msk (0xffful << BPWM_WGCTL1_CMPUCTLn_Pos) /*!< BPWM_T::WGCTL1: CMPUCTLn Mask */ + +#define BPWM_WGCTL1_CMPDCTL0_Pos (16) /*!< BPWM_T::WGCTL1: CMPDCTL0 Position */ +#define BPWM_WGCTL1_CMPDCTL0_Msk (0x3ul << BPWM_WGCTL1_CMPDCTL0_Pos) /*!< BPWM_T::WGCTL1: CMPDCTL0 Mask */ + +#define BPWM_WGCTL1_CMPDCTL1_Pos (18) /*!< BPWM_T::WGCTL1: CMPDCTL1 Position */ +#define BPWM_WGCTL1_CMPDCTL1_Msk (0x3ul << BPWM_WGCTL1_CMPDCTL1_Pos) /*!< BPWM_T::WGCTL1: CMPDCTL1 Mask */ + +#define BPWM_WGCTL1_CMPDCTL2_Pos (20) /*!< BPWM_T::WGCTL1: CMPDCTL2 Position */ +#define BPWM_WGCTL1_CMPDCTL2_Msk (0x3ul << BPWM_WGCTL1_CMPDCTL2_Pos) /*!< BPWM_T::WGCTL1: CMPDCTL2 Mask */ + +#define BPWM_WGCTL1_CMPDCTL3_Pos (22) /*!< BPWM_T::WGCTL1: CMPDCTL3 Position */ +#define BPWM_WGCTL1_CMPDCTL3_Msk (0x3ul << BPWM_WGCTL1_CMPDCTL3_Pos) /*!< BPWM_T::WGCTL1: CMPDCTL3 Mask */ + +#define BPWM_WGCTL1_CMPDCTL4_Pos (24) /*!< BPWM_T::WGCTL1: CMPDCTL4 Position */ +#define BPWM_WGCTL1_CMPDCTL4_Msk (0x3ul << BPWM_WGCTL1_CMPDCTL4_Pos) /*!< BPWM_T::WGCTL1: CMPDCTL4 Mask */ + +#define BPWM_WGCTL1_CMPDCTL5_Pos (26) /*!< BPWM_T::WGCTL1: CMPDCTL5 Position */ +#define BPWM_WGCTL1_CMPDCTL5_Msk (0x3ul << BPWM_WGCTL1_CMPDCTL5_Pos) /*!< BPWM_T::WGCTL1: CMPDCTL5 Mask */ + +#define BPWM_WGCTL1_CMPDCTLn_Pos (16) /*!< BPWM_T::WGCTL1: CMPDCTLn Position */ +#define BPWM_WGCTL1_CMPDCTLn_Msk (0xffful << BPWM_WGCTL1_CMPDCTLn_Pos) /*!< BPWM_T::WGCTL1: CMPDCTLn Mask */ + +#define BPWM_MSKEN_MSKEN0_Pos (0) /*!< BPWM_T::MSKEN: MSKEN0 Position */ +#define BPWM_MSKEN_MSKEN0_Msk (0x1ul << BPWM_MSKEN_MSKEN0_Pos) /*!< BPWM_T::MSKEN: MSKEN0 Mask */ + +#define BPWM_MSKEN_MSKEN1_Pos (1) /*!< BPWM_T::MSKEN: MSKEN1 Position */ +#define BPWM_MSKEN_MSKEN1_Msk (0x1ul << BPWM_MSKEN_MSKEN1_Pos) /*!< BPWM_T::MSKEN: MSKEN1 Mask */ + +#define BPWM_MSKEN_MSKEN2_Pos (2) /*!< BPWM_T::MSKEN: MSKEN2 Position */ +#define BPWM_MSKEN_MSKEN2_Msk (0x1ul << BPWM_MSKEN_MSKEN2_Pos) /*!< BPWM_T::MSKEN: MSKEN2 Mask */ + +#define BPWM_MSKEN_MSKEN3_Pos (3) /*!< BPWM_T::MSKEN: MSKEN3 Position */ +#define BPWM_MSKEN_MSKEN3_Msk (0x1ul << BPWM_MSKEN_MSKEN3_Pos) /*!< BPWM_T::MSKEN: MSKEN3 Mask */ + +#define BPWM_MSKEN_MSKEN4_Pos (4) /*!< BPWM_T::MSKEN: MSKEN4 Position */ +#define BPWM_MSKEN_MSKEN4_Msk (0x1ul << BPWM_MSKEN_MSKEN4_Pos) /*!< BPWM_T::MSKEN: MSKEN4 Mask */ + +#define BPWM_MSKEN_MSKEN5_Pos (5) /*!< BPWM_T::MSKEN: MSKEN5 Position */ +#define BPWM_MSKEN_MSKEN5_Msk (0x1ul << BPWM_MSKEN_MSKEN5_Pos) /*!< BPWM_T::MSKEN: MSKEN5 Mask */ + +#define BPWM_MSKEN_MSKENn_Pos (0) /*!< BPWM_T::MSKEN: MSKENn Position */ +#define BPWM_MSKEN_MSKENn_Msk (0x3ful << BPWM_MSKEN_MSKENn_Pos) /*!< BPWM_T::MSKEN: MSKENn Mask */ + +#define BPWM_MSK_MSKDAT0_Pos (0) /*!< BPWM_T::MSK: MSKDAT0 Position */ +#define BPWM_MSK_MSKDAT0_Msk (0x1ul << BPWM_MSK_MSKDAT0_Pos) /*!< BPWM_T::MSK: MSKDAT0 Mask */ + +#define BPWM_MSK_MSKDAT1_Pos (1) /*!< BPWM_T::MSK: MSKDAT1 Position */ +#define BPWM_MSK_MSKDAT1_Msk (0x1ul << BPWM_MSK_MSKDAT1_Pos) /*!< BPWM_T::MSK: MSKDAT1 Mask */ + +#define BPWM_MSK_MSKDAT2_Pos (2) /*!< BPWM_T::MSK: MSKDAT2 Position */ +#define BPWM_MSK_MSKDAT2_Msk (0x1ul << BPWM_MSK_MSKDAT2_Pos) /*!< BPWM_T::MSK: MSKDAT2 Mask */ + +#define BPWM_MSK_MSKDAT3_Pos (3) /*!< BPWM_T::MSK: MSKDAT3 Position */ +#define BPWM_MSK_MSKDAT3_Msk (0x1ul << BPWM_MSK_MSKDAT3_Pos) /*!< BPWM_T::MSK: MSKDAT3 Mask */ + +#define BPWM_MSK_MSKDAT4_Pos (4) /*!< BPWM_T::MSK: MSKDAT4 Position */ +#define BPWM_MSK_MSKDAT4_Msk (0x1ul << BPWM_MSK_MSKDAT4_Pos) /*!< BPWM_T::MSK: MSKDAT4 Mask */ + +#define BPWM_MSK_MSKDAT5_Pos (5) /*!< BPWM_T::MSK: MSKDAT5 Position */ +#define BPWM_MSK_MSKDAT5_Msk (0x1ul << BPWM_MSK_MSKDAT5_Pos) /*!< BPWM_T::MSK: MSKDAT5 Mask */ + +#define BPWM_MSK_MSKDATn_Pos (0) /*!< BPWM_T::MSK: MSKDATn Position */ +#define BPWM_MSK_MSKDATn_Msk (0x3ful << BPWM_MSK_MSKDATn_Pos) /*!< BPWM_T::MSK: MSKDATn Mask */ + +#define BPWM_POLCTL_PINV0_Pos (0) /*!< BPWM_T::POLCTL: PINV0 Position */ +#define BPWM_POLCTL_PINV0_Msk (0x1ul << BPWM_POLCTL_PINV0_Pos) /*!< BPWM_T::POLCTL: PINV0 Mask */ + +#define BPWM_POLCTL_PINV1_Pos (1) /*!< BPWM_T::POLCTL: PINV1 Position */ +#define BPWM_POLCTL_PINV1_Msk (0x1ul << BPWM_POLCTL_PINV1_Pos) /*!< BPWM_T::POLCTL: PINV1 Mask */ + +#define BPWM_POLCTL_PINV2_Pos (2) /*!< BPWM_T::POLCTL: PINV2 Position */ +#define BPWM_POLCTL_PINV2_Msk (0x1ul << BPWM_POLCTL_PINV2_Pos) /*!< BPWM_T::POLCTL: PINV2 Mask */ + +#define BPWM_POLCTL_PINV3_Pos (3) /*!< BPWM_T::POLCTL: PINV3 Position */ +#define BPWM_POLCTL_PINV3_Msk (0x1ul << BPWM_POLCTL_PINV3_Pos) /*!< BPWM_T::POLCTL: PINV3 Mask */ + +#define BPWM_POLCTL_PINV4_Pos (4) /*!< BPWM_T::POLCTL: PINV4 Position */ +#define BPWM_POLCTL_PINV4_Msk (0x1ul << BPWM_POLCTL_PINV4_Pos) /*!< BPWM_T::POLCTL: PINV4 Mask */ + +#define BPWM_POLCTL_PINV5_Pos (5) /*!< BPWM_T::POLCTL: PINV5 Position */ +#define BPWM_POLCTL_PINV5_Msk (0x1ul << BPWM_POLCTL_PINV5_Pos) /*!< BPWM_T::POLCTL: PINV5 Mask */ + +#define BPWM_POLCTL_PINVn_Pos (0) /*!< BPWM_T::POLCTL: PINVn Position */ +#define BPWM_POLCTL_PINVn_Msk (0x3ful << BPWM_POLCTL_PINVn_Pos) /*!< BPWM_T::POLCTL: PINVn Mask */ + +#define BPWM_POEN_POEN0_Pos (0) /*!< BPWM_T::POEN: POEN0 Position */ +#define BPWM_POEN_POEN0_Msk (0x1ul << BPWM_POEN_POEN0_Pos) /*!< BPWM_T::POEN: POEN0 Mask */ + +#define BPWM_POEN_POEN1_Pos (1) /*!< BPWM_T::POEN: POEN1 Position */ +#define BPWM_POEN_POEN1_Msk (0x1ul << BPWM_POEN_POEN1_Pos) /*!< BPWM_T::POEN: POEN1 Mask */ + +#define BPWM_POEN_POEN2_Pos (2) /*!< BPWM_T::POEN: POEN2 Position */ +#define BPWM_POEN_POEN2_Msk (0x1ul << BPWM_POEN_POEN2_Pos) /*!< BPWM_T::POEN: POEN2 Mask */ + +#define BPWM_POEN_POEN3_Pos (3) /*!< BPWM_T::POEN: POEN3 Position */ +#define BPWM_POEN_POEN3_Msk (0x1ul << BPWM_POEN_POEN3_Pos) /*!< BPWM_T::POEN: POEN3 Mask */ + +#define BPWM_POEN_POEN4_Pos (4) /*!< BPWM_T::POEN: POEN4 Position */ +#define BPWM_POEN_POEN4_Msk (0x1ul << BPWM_POEN_POEN4_Pos) /*!< BPWM_T::POEN: POEN4 Mask */ + +#define BPWM_POEN_POEN5_Pos (5) /*!< BPWM_T::POEN: POEN5 Position */ +#define BPWM_POEN_POEN5_Msk (0x1ul << BPWM_POEN_POEN5_Pos) /*!< BPWM_T::POEN: POEN5 Mask */ + +#define BPWM_POEN_POENn_Pos (0) /*!< BPWM_T::POEN: POENn Position */ +#define BPWM_POEN_POENn_Msk (0x3ful << BPWM_POEN_POENn_Pos) /*!< BPWM_T::POEN: POENn Mask */ + +#define BPWM_INTEN_ZIEN0_Pos (0) /*!< BPWM_T::INTEN: ZIEN0 Position */ +#define BPWM_INTEN_ZIEN0_Msk (0x1ul << BPWM_INTEN_ZIEN0_Pos) /*!< BPWM_T::INTEN: ZIEN0 Mask */ + +#define BPWM_INTEN_PIEN0_Pos (8) /*!< BPWM_T::INTEN: PIEN0 Position */ +#define BPWM_INTEN_PIEN0_Msk (0x1ul << BPWM_INTEN_PIEN0_Pos) /*!< BPWM_T::INTEN: PIEN0 Mask */ + +#define BPWM_INTEN_CMPUIEN0_Pos (16) /*!< BPWM_T::INTEN: CMPUIEN0 Position */ +#define BPWM_INTEN_CMPUIEN0_Msk (0x1ul << BPWM_INTEN_CMPUIEN0_Pos) /*!< BPWM_T::INTEN: CMPUIEN0 Mask */ + +#define BPWM_INTEN_CMPUIEN1_Pos (17) /*!< BPWM_T::INTEN: CMPUIEN1 Position */ +#define BPWM_INTEN_CMPUIEN1_Msk (0x1ul << BPWM_INTEN_CMPUIEN1_Pos) /*!< BPWM_T::INTEN: CMPUIEN1 Mask */ + +#define BPWM_INTEN_CMPUIEN2_Pos (18) /*!< BPWM_T::INTEN: CMPUIEN2 Position */ +#define BPWM_INTEN_CMPUIEN2_Msk (0x1ul << BPWM_INTEN_CMPUIEN2_Pos) /*!< BPWM_T::INTEN: CMPUIEN2 Mask */ + +#define BPWM_INTEN_CMPUIEN3_Pos (19) /*!< BPWM_T::INTEN: CMPUIEN3 Position */ +#define BPWM_INTEN_CMPUIEN3_Msk (0x1ul << BPWM_INTEN_CMPUIEN3_Pos) /*!< BPWM_T::INTEN: CMPUIEN3 Mask */ + +#define BPWM_INTEN_CMPUIEN4_Pos (20) /*!< BPWM_T::INTEN: CMPUIEN4 Position */ +#define BPWM_INTEN_CMPUIEN4_Msk (0x1ul << BPWM_INTEN_CMPUIEN4_Pos) /*!< BPWM_T::INTEN: CMPUIEN4 Mask */ + +#define BPWM_INTEN_CMPUIEN5_Pos (21) /*!< BPWM_T::INTEN: CMPUIEN5 Position */ +#define BPWM_INTEN_CMPUIEN5_Msk (0x1ul << BPWM_INTEN_CMPUIEN5_Pos) /*!< BPWM_T::INTEN: CMPUIEN5 Mask */ + +#define BPWM_INTEN_CMPUIENn_Pos (16) /*!< BPWM_T::INTEN: CMPUIENn Position */ +#define BPWM_INTEN_CMPUIENn_Msk (0x3ful << BPWM_INTEN_CMPUIENn_Pos) /*!< BPWM_T::INTEN: CMPUIENn Mask */ + +#define BPWM_INTEN_CMPDIEN0_Pos (24) /*!< BPWM_T::INTEN: CMPDIEN0 Position */ +#define BPWM_INTEN_CMPDIEN0_Msk (0x1ul << BPWM_INTEN_CMPDIEN0_Pos) /*!< BPWM_T::INTEN: CMPDIEN0 Mask */ + +#define BPWM_INTEN_CMPDIEN1_Pos (25) /*!< BPWM_T::INTEN: CMPDIEN1 Position */ +#define BPWM_INTEN_CMPDIEN1_Msk (0x1ul << BPWM_INTEN_CMPDIEN1_Pos) /*!< BPWM_T::INTEN: CMPDIEN1 Mask */ + +#define BPWM_INTEN_CMPDIEN2_Pos (26) /*!< BPWM_T::INTEN: CMPDIEN2 Position */ +#define BPWM_INTEN_CMPDIEN2_Msk (0x1ul << BPWM_INTEN_CMPDIEN2_Pos) /*!< BPWM_T::INTEN: CMPDIEN2 Mask */ + +#define BPWM_INTEN_CMPDIEN3_Pos (27) /*!< BPWM_T::INTEN: CMPDIEN3 Position */ +#define BPWM_INTEN_CMPDIEN3_Msk (0x1ul << BPWM_INTEN_CMPDIEN3_Pos) /*!< BPWM_T::INTEN: CMPDIEN3 Mask */ + +#define BPWM_INTEN_CMPDIEN4_Pos (28) /*!< BPWM_T::INTEN: CMPDIEN4 Position */ +#define BPWM_INTEN_CMPDIEN4_Msk (0x1ul << BPWM_INTEN_CMPDIEN4_Pos) /*!< BPWM_T::INTEN: CMPDIEN4 Mask */ + +#define BPWM_INTEN_CMPDIEN5_Pos (29) /*!< BPWM_T::INTEN: CMPDIEN5 Position */ +#define BPWM_INTEN_CMPDIEN5_Msk (0x1ul << BPWM_INTEN_CMPDIEN5_Pos) /*!< BPWM_T::INTEN: CMPDIEN5 Mask */ + +#define BPWM_INTEN_CMPDIENn_Pos (24) /*!< BPWM_T::INTEN: CMPDIENn Position */ +#define BPWM_INTEN_CMPDIENn_Msk (0x3ful << BPWM_INTEN_CMPDIENn_Pos) /*!< BPWM_T::INTEN: CMPDIENn Mask */ + +#define BPWM_INTSTS_ZIF0_Pos (0) /*!< BPWM_T::INTSTS: ZIF0 Position */ +#define BPWM_INTSTS_ZIF0_Msk (0x1ul << BPWM_INTSTS_ZIF0_Pos) /*!< BPWM_T::INTSTS: ZIF0 Mask */ + +#define BPWM_INTSTS_PIF0_Pos (8) /*!< BPWM_T::INTSTS: PIF0 Position */ +#define BPWM_INTSTS_PIF0_Msk (0x1ul << BPWM_INTSTS_PIF0_Pos) /*!< BPWM_T::INTSTS: PIF0 Mask */ + +#define BPWM_INTSTS_CMPUIF0_Pos (16) /*!< BPWM_T::INTSTS: CMPUIF0 Position */ +#define BPWM_INTSTS_CMPUIF0_Msk (0x1ul << BPWM_INTSTS_CMPUIF0_Pos) /*!< BPWM_T::INTSTS: CMPUIF0 Mask */ + +#define BPWM_INTSTS_CMPUIF1_Pos (17) /*!< BPWM_T::INTSTS: CMPUIF1 Position */ +#define BPWM_INTSTS_CMPUIF1_Msk (0x1ul << BPWM_INTSTS_CMPUIF1_Pos) /*!< BPWM_T::INTSTS: CMPUIF1 Mask */ + +#define BPWM_INTSTS_CMPUIF2_Pos (18) /*!< BPWM_T::INTSTS: CMPUIF2 Position */ +#define BPWM_INTSTS_CMPUIF2_Msk (0x1ul << BPWM_INTSTS_CMPUIF2_Pos) /*!< BPWM_T::INTSTS: CMPUIF2 Mask */ + +#define BPWM_INTSTS_CMPUIF3_Pos (19) /*!< BPWM_T::INTSTS: CMPUIF3 Position */ +#define BPWM_INTSTS_CMPUIF3_Msk (0x1ul << BPWM_INTSTS_CMPUIF3_Pos) /*!< BPWM_T::INTSTS: CMPUIF3 Mask */ + +#define BPWM_INTSTS_CMPUIF4_Pos (20) /*!< BPWM_T::INTSTS: CMPUIF4 Position */ +#define BPWM_INTSTS_CMPUIF4_Msk (0x1ul << BPWM_INTSTS_CMPUIF4_Pos) /*!< BPWM_T::INTSTS: CMPUIF4 Mask */ + +#define BPWM_INTSTS_CMPUIF5_Pos (21) /*!< BPWM_T::INTSTS: CMPUIF5 Position */ +#define BPWM_INTSTS_CMPUIF5_Msk (0x1ul << BPWM_INTSTS_CMPUIF5_Pos) /*!< BPWM_T::INTSTS: CMPUIF5 Mask */ + +#define BPWM_INTSTS_CMPUIFn_Pos (16) /*!< BPWM_T::INTSTS: CMPUIFn Position */ +#define BPWM_INTSTS_CMPUIFn_Msk (0x3ful << BPWM_INTSTS_CMPUIFn_Pos) /*!< BPWM_T::INTSTS: CMPUIFn Mask */ + +#define BPWM_INTSTS_CMPDIF0_Pos (24) /*!< BPWM_T::INTSTS: CMPDIF0 Position */ +#define BPWM_INTSTS_CMPDIF0_Msk (0x1ul << BPWM_INTSTS_CMPDIF0_Pos) /*!< BPWM_T::INTSTS: CMPDIF0 Mask */ + +#define BPWM_INTSTS_CMPDIF1_Pos (25) /*!< BPWM_T::INTSTS: CMPDIF1 Position */ +#define BPWM_INTSTS_CMPDIF1_Msk (0x1ul << BPWM_INTSTS_CMPDIF1_Pos) /*!< BPWM_T::INTSTS: CMPDIF1 Mask */ + +#define BPWM_INTSTS_CMPDIF2_Pos (26) /*!< BPWM_T::INTSTS: CMPDIF2 Position */ +#define BPWM_INTSTS_CMPDIF2_Msk (0x1ul << BPWM_INTSTS_CMPDIF2_Pos) /*!< BPWM_T::INTSTS: CMPDIF2 Mask */ + +#define BPWM_INTSTS_CMPDIF3_Pos (27) /*!< BPWM_T::INTSTS: CMPDIF3 Position */ +#define BPWM_INTSTS_CMPDIF3_Msk (0x1ul << BPWM_INTSTS_CMPDIF3_Pos) /*!< BPWM_T::INTSTS: CMPDIF3 Mask */ + +#define BPWM_INTSTS_CMPDIF4_Pos (28) /*!< BPWM_T::INTSTS: CMPDIF4 Position */ +#define BPWM_INTSTS_CMPDIF4_Msk (0x1ul << BPWM_INTSTS_CMPDIF4_Pos) /*!< BPWM_T::INTSTS: CMPDIF4 Mask */ + +#define BPWM_INTSTS_CMPDIF5_Pos (29) /*!< BPWM_T::INTSTS: CMPDIF5 Position */ +#define BPWM_INTSTS_CMPDIF5_Msk (0x1ul << BPWM_INTSTS_CMPDIF5_Pos) /*!< BPWM_T::INTSTS: CMPDIF5 Mask */ + +#define BPWM_INTSTS_CMPDIFn_Pos (24) /*!< BPWM_T::INTSTS: CMPDIFn Position */ +#define BPWM_INTSTS_CMPDIFn_Msk (0x3ful << BPWM_INTSTS_CMPDIFn_Pos) /*!< BPWM_T::INTSTS: CMPDIFn Mask */ + +#define BPWM_EADCTS0_TRGSEL0_Pos (0) /*!< BPWM_T::EADCTS0: TRGSEL0 Position */ +#define BPWM_EADCTS0_TRGSEL0_Msk (0xful << BPWM_EADCTS0_TRGSEL0_Pos) /*!< BPWM_T::EADCTS0: TRGSEL0 Mask */ + +#define BPWM_EADCTS0_TRGEN0_Pos (7) /*!< BPWM_T::EADCTS0: TRGEN0 Position */ +#define BPWM_EADCTS0_TRGEN0_Msk (0x1ul << BPWM_EADCTS0_TRGEN0_Pos) /*!< BPWM_T::EADCTS0: TRGEN0 Mask */ + +#define BPWM_EADCTS0_TRGSEL1_Pos (8) /*!< BPWM_T::EADCTS0: TRGSEL1 Position */ +#define BPWM_EADCTS0_TRGSEL1_Msk (0xful << BPWM_EADCTS0_TRGSEL1_Pos) /*!< BPWM_T::EADCTS0: TRGSEL1 Mask */ + +#define BPWM_EADCTS0_TRGEN1_Pos (15) /*!< BPWM_T::EADCTS0: TRGEN1 Position */ +#define BPWM_EADCTS0_TRGEN1_Msk (0x1ul << BPWM_EADCTS0_TRGEN1_Pos) /*!< BPWM_T::EADCTS0: TRGEN1 Mask */ + +#define BPWM_EADCTS0_TRGSEL2_Pos (16) /*!< BPWM_T::EADCTS0: TRGSEL2 Position */ +#define BPWM_EADCTS0_TRGSEL2_Msk (0xful << BPWM_EADCTS0_TRGSEL2_Pos) /*!< BPWM_T::EADCTS0: TRGSEL2 Mask */ + +#define BPWM_EADCTS0_TRGEN2_Pos (23) /*!< BPWM_T::EADCTS0: TRGEN2 Position */ +#define BPWM_EADCTS0_TRGEN2_Msk (0x1ul << BPWM_EADCTS0_TRGEN2_Pos) /*!< BPWM_T::EADCTS0: TRGEN2 Mask */ + +#define BPWM_EADCTS0_TRGSEL3_Pos (24) /*!< BPWM_T::EADCTS0: TRGSEL3 Position */ +#define BPWM_EADCTS0_TRGSEL3_Msk (0xful << BPWM_EADCTS0_TRGSEL3_Pos) /*!< BPWM_T::EADCTS0: TRGSEL3 Mask */ + +#define BPWM_EADCTS0_TRGEN3_Pos (31) /*!< BPWM_T::EADCTS0: TRGEN3 Position */ +#define BPWM_EADCTS0_TRGEN3_Msk (0x1ul << BPWM_EADCTS0_TRGEN3_Pos) /*!< BPWM_T::EADCTS0: TRGEN3 Mask */ + +#define BPWM_EADCTS1_TRGSEL4_Pos (0) /*!< BPWM_T::EADCTS1: TRGSEL4 Position */ +#define BPWM_EADCTS1_TRGSEL4_Msk (0xful << BPWM_EADCTS1_TRGSEL4_Pos) /*!< BPWM_T::EADCTS1: TRGSEL4 Mask */ + +#define BPWM_EADCTS1_TRGEN4_Pos (7) /*!< BPWM_T::EADCTS1: TRGEN4 Position */ +#define BPWM_EADCTS1_TRGEN4_Msk (0x1ul << BPWM_EADCTS1_TRGEN4_Pos) /*!< BPWM_T::EADCTS1: TRGEN4 Mask */ + +#define BPWM_EADCTS1_TRGSEL5_Pos (8) /*!< BPWM_T::EADCTS1: TRGSEL5 Position */ +#define BPWM_EADCTS1_TRGSEL5_Msk (0xful << BPWM_EADCTS1_TRGSEL5_Pos) /*!< BPWM_T::EADCTS1: TRGSEL5 Mask */ + +#define BPWM_EADCTS1_TRGEN5_Pos (15) /*!< BPWM_T::EADCTS1: TRGEN5 Position */ +#define BPWM_EADCTS1_TRGEN5_Msk (0x1ul << BPWM_EADCTS1_TRGEN5_Pos) /*!< BPWM_T::EADCTS1: TRGEN5 Mask */ + +#define BPWM_SSCTL_SSEN0_Pos (0) /*!< BPWM_T::SSCTL: SSEN0 Position */ +#define BPWM_SSCTL_SSEN0_Msk (0x1ul << BPWM_SSCTL_SSEN0_Pos) /*!< BPWM_T::SSCTL: SSEN0 Mask */ + +#define BPWM_SSCTL_SSRC_Pos (8) /*!< BPWM_T::SSCTL: SSRC Position */ +#define BPWM_SSCTL_SSRC_Msk (0x3ul << BPWM_SSCTL_SSRC_Pos) /*!< BPWM_T::SSCTL: SSRC Mask */ + +#define BPWM_SSTRG_CNTSEN_Pos (0) /*!< BPWM_T::SSTRG: CNTSEN Position */ +#define BPWM_SSTRG_CNTSEN_Msk (0x1ul << BPWM_SSTRG_CNTSEN_Pos) /*!< BPWM_T::SSTRG: CNTSEN Mask */ + +#define BPWM_STATUS_CNTMAX0_Pos (0) /*!< BPWM_T::STATUS: CNTMAX0 Position */ +#define BPWM_STATUS_CNTMAX0_Msk (0x1ul << BPWM_STATUS_CNTMAX0_Pos) /*!< BPWM_T::STATUS: CNTMAX0 Mask */ + +#define BPWM_STATUS_EADCTRG0_Pos (16) /*!< BPWM_T::STATUS: EADCTRG0 Position */ +#define BPWM_STATUS_EADCTRG0_Msk (0x1ul << BPWM_STATUS_EADCTRG0_Pos) /*!< BPWM_T::STATUS: EADCTRG0 Mask */ + +#define BPWM_STATUS_EADCTRG1_Pos (17) /*!< BPWM_T::STATUS: EADCTRG1 Position */ +#define BPWM_STATUS_EADCTRG1_Msk (0x1ul << BPWM_STATUS_EADCTRG1_Pos) /*!< BPWM_T::STATUS: EADCTRG1 Mask */ + +#define BPWM_STATUS_EADCTRG2_Pos (18) /*!< BPWM_T::STATUS: EADCTRG2 Position */ +#define BPWM_STATUS_EADCTRG2_Msk (0x1ul << BPWM_STATUS_EADCTRG2_Pos) /*!< BPWM_T::STATUS: EADCTRG2 Mask */ + +#define BPWM_STATUS_EADCTRG3_Pos (19) /*!< BPWM_T::STATUS: EADCTRG3 Position */ +#define BPWM_STATUS_EADCTRG3_Msk (0x1ul << BPWM_STATUS_EADCTRG3_Pos) /*!< BPWM_T::STATUS: EADCTRG3 Mask */ + +#define BPWM_STATUS_EADCTRG4_Pos (20) /*!< BPWM_T::STATUS: EADCTRG4 Position */ +#define BPWM_STATUS_EADCTRG4_Msk (0x1ul << BPWM_STATUS_EADCTRG4_Pos) /*!< BPWM_T::STATUS: EADCTRG4 Mask */ + +#define BPWM_STATUS_EADCTRG5_Pos (21) /*!< BPWM_T::STATUS: EADCTRG5 Position */ +#define BPWM_STATUS_EADCTRG5_Msk (0x1ul << BPWM_STATUS_EADCTRG5_Pos) /*!< BPWM_T::STATUS: EADCTRG5 Mask */ + +#define BPWM_STATUS_EADCTRGn_Pos (16) /*!< BPWM_T::STATUS: EADCTRGn Position */ +#define BPWM_STATUS_EADCTRGn_Msk (0x3ful << BPWM_STATUS_EADCTRGn_Pos) /*!< BPWM_T::STATUS: EADCTRGn Mask */ + +#define BPWM_CAPINEN_CAPINEN0_Pos (0) /*!< BPWM_T::CAPINEN: CAPINEN0 Position */ +#define BPWM_CAPINEN_CAPINEN0_Msk (0x1ul << BPWM_CAPINEN_CAPINEN0_Pos) /*!< BPWM_T::CAPINEN: CAPINEN0 Mask */ + +#define BPWM_CAPINEN_CAPINEN1_Pos (1) /*!< BPWM_T::CAPINEN: CAPINEN1 Position */ +#define BPWM_CAPINEN_CAPINEN1_Msk (0x1ul << BPWM_CAPINEN_CAPINEN1_Pos) /*!< BPWM_T::CAPINEN: CAPINEN1 Mask */ + +#define BPWM_CAPINEN_CAPINEN2_Pos (2) /*!< BPWM_T::CAPINEN: CAPINEN2 Position */ +#define BPWM_CAPINEN_CAPINEN2_Msk (0x1ul << BPWM_CAPINEN_CAPINEN2_Pos) /*!< BPWM_T::CAPINEN: CAPINEN2 Mask */ + +#define BPWM_CAPINEN_CAPINEN3_Pos (3) /*!< BPWM_T::CAPINEN: CAPINEN3 Position */ +#define BPWM_CAPINEN_CAPINEN3_Msk (0x1ul << BPWM_CAPINEN_CAPINEN3_Pos) /*!< BPWM_T::CAPINEN: CAPINEN3 Mask */ + +#define BPWM_CAPINEN_CAPINEN4_Pos (4) /*!< BPWM_T::CAPINEN: CAPINEN4 Position */ +#define BPWM_CAPINEN_CAPINEN4_Msk (0x1ul << BPWM_CAPINEN_CAPINEN4_Pos) /*!< BPWM_T::CAPINEN: CAPINEN4 Mask */ + +#define BPWM_CAPINEN_CAPINEN5_Pos (5) /*!< BPWM_T::CAPINEN: CAPINEN5 Position */ +#define BPWM_CAPINEN_CAPINEN5_Msk (0x1ul << BPWM_CAPINEN_CAPINEN5_Pos) /*!< BPWM_T::CAPINEN: CAPINEN5 Mask */ + +#define BPWM_CAPINEN_CAPINENn_Pos (0) /*!< BPWM_T::CAPINEN: CAPINENn Position */ +#define BPWM_CAPINEN_CAPINENn_Msk (0x3ful << BPWM_CAPINEN_CAPINENn_Pos) /*!< BPWM_T::CAPINEN: CAPINENn Mask */ + +#define BPWM_CAPCTL_CAPEN0_Pos (0) /*!< BPWM_T::CAPCTL: CAPEN0 Position */ +#define BPWM_CAPCTL_CAPEN0_Msk (0x1ul << BPWM_CAPCTL_CAPEN0_Pos) /*!< BPWM_T::CAPCTL: CAPEN0 Mask */ + +#define BPWM_CAPCTL_CAPEN1_Pos (1) /*!< BPWM_T::CAPCTL: CAPEN1 Position */ +#define BPWM_CAPCTL_CAPEN1_Msk (0x1ul << BPWM_CAPCTL_CAPEN1_Pos) /*!< BPWM_T::CAPCTL: CAPEN1 Mask */ + +#define BPWM_CAPCTL_CAPEN2_Pos (2) /*!< BPWM_T::CAPCTL: CAPEN2 Position */ +#define BPWM_CAPCTL_CAPEN2_Msk (0x1ul << BPWM_CAPCTL_CAPEN2_Pos) /*!< BPWM_T::CAPCTL: CAPEN2 Mask */ + +#define BPWM_CAPCTL_CAPEN3_Pos (3) /*!< BPWM_T::CAPCTL: CAPEN3 Position */ +#define BPWM_CAPCTL_CAPEN3_Msk (0x1ul << BPWM_CAPCTL_CAPEN3_Pos) /*!< BPWM_T::CAPCTL: CAPEN3 Mask */ + +#define BPWM_CAPCTL_CAPEN4_Pos (4) /*!< BPWM_T::CAPCTL: CAPEN4 Position */ +#define BPWM_CAPCTL_CAPEN4_Msk (0x1ul << BPWM_CAPCTL_CAPEN4_Pos) /*!< BPWM_T::CAPCTL: CAPEN4 Mask */ + +#define BPWM_CAPCTL_CAPEN5_Pos (5) /*!< BPWM_T::CAPCTL: CAPEN5 Position */ +#define BPWM_CAPCTL_CAPEN5_Msk (0x1ul << BPWM_CAPCTL_CAPEN5_Pos) /*!< BPWM_T::CAPCTL: CAPEN5 Mask */ + +#define BPWM_CAPCTL_CAPENn_Pos (0) /*!< BPWM_T::CAPCTL: CAPENn Position */ +#define BPWM_CAPCTL_CAPENn_Msk (0x3ful << BPWM_CAPCTL_CAPENn_Pos) /*!< BPWM_T::CAPCTL: CAPENn Mask */ + +#define BPWM_CAPCTL_CAPINV0_Pos (8) /*!< BPWM_T::CAPCTL: CAPINV0 Position */ +#define BPWM_CAPCTL_CAPINV0_Msk (0x1ul << BPWM_CAPCTL_CAPINV0_Pos) /*!< BPWM_T::CAPCTL: CAPINV0 Mask */ + +#define BPWM_CAPCTL_CAPINV1_Pos (9) /*!< BPWM_T::CAPCTL: CAPINV1 Position */ +#define BPWM_CAPCTL_CAPINV1_Msk (0x1ul << BPWM_CAPCTL_CAPINV1_Pos) /*!< BPWM_T::CAPCTL: CAPINV1 Mask */ + +#define BPWM_CAPCTL_CAPINV2_Pos (10) /*!< BPWM_T::CAPCTL: CAPINV2 Position */ +#define BPWM_CAPCTL_CAPINV2_Msk (0x1ul << BPWM_CAPCTL_CAPINV2_Pos) /*!< BPWM_T::CAPCTL: CAPINV2 Mask */ + +#define BPWM_CAPCTL_CAPINV3_Pos (11) /*!< BPWM_T::CAPCTL: CAPINV3 Position */ +#define BPWM_CAPCTL_CAPINV3_Msk (0x1ul << BPWM_CAPCTL_CAPINV3_Pos) /*!< BPWM_T::CAPCTL: CAPINV3 Mask */ + +#define BPWM_CAPCTL_CAPINV4_Pos (12) /*!< BPWM_T::CAPCTL: CAPINV4 Position */ +#define BPWM_CAPCTL_CAPINV4_Msk (0x1ul << BPWM_CAPCTL_CAPINV4_Pos) /*!< BPWM_T::CAPCTL: CAPINV4 Mask */ + +#define BPWM_CAPCTL_CAPINV5_Pos (13) /*!< BPWM_T::CAPCTL: CAPINV5 Position */ +#define BPWM_CAPCTL_CAPINV5_Msk (0x1ul << BPWM_CAPCTL_CAPINV5_Pos) /*!< BPWM_T::CAPCTL: CAPINV5 Mask */ + +#define BPWM_CAPCTL_CAPINVn_Pos (8) /*!< BPWM_T::CAPCTL: CAPINVn Position */ +#define BPWM_CAPCTL_CAPINVn_Msk (0x3ful << BPWM_CAPCTL_CAPINVn_Pos) /*!< BPWM_T::CAPCTL: CAPINVn Mask */ + +#define BPWM_CAPCTL_RCRLDEN0_Pos (16) /*!< BPWM_T::CAPCTL: RCRLDEN0 Position */ +#define BPWM_CAPCTL_RCRLDEN0_Msk (0x1ul << BPWM_CAPCTL_RCRLDEN0_Pos) /*!< BPWM_T::CAPCTL: RCRLDEN0 Mask */ + +#define BPWM_CAPCTL_RCRLDEN1_Pos (17) /*!< BPWM_T::CAPCTL: RCRLDEN1 Position */ +#define BPWM_CAPCTL_RCRLDEN1_Msk (0x1ul << BPWM_CAPCTL_RCRLDEN1_Pos) /*!< BPWM_T::CAPCTL: RCRLDEN1 Mask */ + +#define BPWM_CAPCTL_RCRLDEN2_Pos (18) /*!< BPWM_T::CAPCTL: RCRLDEN2 Position */ +#define BPWM_CAPCTL_RCRLDEN2_Msk (0x1ul << BPWM_CAPCTL_RCRLDEN2_Pos) /*!< BPWM_T::CAPCTL: RCRLDEN2 Mask */ + +#define BPWM_CAPCTL_RCRLDEN3_Pos (19) /*!< BPWM_T::CAPCTL: RCRLDEN3 Position */ +#define BPWM_CAPCTL_RCRLDEN3_Msk (0x1ul << BPWM_CAPCTL_RCRLDEN3_Pos) /*!< BPWM_T::CAPCTL: RCRLDEN3 Mask */ + +#define BPWM_CAPCTL_RCRLDEN4_Pos (20) /*!< BPWM_T::CAPCTL: RCRLDEN4 Position */ +#define BPWM_CAPCTL_RCRLDEN4_Msk (0x1ul << BPWM_CAPCTL_RCRLDEN4_Pos) /*!< BPWM_T::CAPCTL: RCRLDEN4 Mask */ + +#define BPWM_CAPCTL_RCRLDEN5_Pos (21) /*!< BPWM_T::CAPCTL: RCRLDEN5 Position */ +#define BPWM_CAPCTL_RCRLDEN5_Msk (0x1ul << BPWM_CAPCTL_RCRLDEN5_Pos) /*!< BPWM_T::CAPCTL: RCRLDEN5 Mask */ + +#define BPWM_CAPCTL_RCRLDENn_Pos (16) /*!< BPWM_T::CAPCTL: RCRLDENn Position */ +#define BPWM_CAPCTL_RCRLDENn_Msk (0x3ful << BPWM_CAPCTL_RCRLDENn_Pos) /*!< BPWM_T::CAPCTL: RCRLDENn Mask */ + +#define BPWM_CAPCTL_FCRLDEN0_Pos (24) /*!< BPWM_T::CAPCTL: FCRLDEN0 Position */ +#define BPWM_CAPCTL_FCRLDEN0_Msk (0x1ul << BPWM_CAPCTL_FCRLDEN0_Pos) /*!< BPWM_T::CAPCTL: FCRLDEN0 Mask */ + +#define BPWM_CAPCTL_FCRLDEN1_Pos (25) /*!< BPWM_T::CAPCTL: FCRLDEN1 Position */ +#define BPWM_CAPCTL_FCRLDEN1_Msk (0x1ul << BPWM_CAPCTL_FCRLDEN1_Pos) /*!< BPWM_T::CAPCTL: FCRLDEN1 Mask */ + +#define BPWM_CAPCTL_FCRLDEN2_Pos (26) /*!< BPWM_T::CAPCTL: FCRLDEN2 Position */ +#define BPWM_CAPCTL_FCRLDEN2_Msk (0x1ul << BPWM_CAPCTL_FCRLDEN2_Pos) /*!< BPWM_T::CAPCTL: FCRLDEN2 Mask */ + +#define BPWM_CAPCTL_FCRLDEN3_Pos (27) /*!< BPWM_T::CAPCTL: FCRLDEN3 Position */ +#define BPWM_CAPCTL_FCRLDEN3_Msk (0x1ul << BPWM_CAPCTL_FCRLDEN3_Pos) /*!< BPWM_T::CAPCTL: FCRLDEN3 Mask */ + +#define BPWM_CAPCTL_FCRLDEN4_Pos (28) /*!< BPWM_T::CAPCTL: FCRLDEN4 Position */ +#define BPWM_CAPCTL_FCRLDEN4_Msk (0x1ul << BPWM_CAPCTL_FCRLDEN4_Pos) /*!< BPWM_T::CAPCTL: FCRLDEN4 Mask */ + +#define BPWM_CAPCTL_FCRLDEN5_Pos (29) /*!< BPWM_T::CAPCTL: FCRLDEN5 Position */ +#define BPWM_CAPCTL_FCRLDEN5_Msk (0x1ul << BPWM_CAPCTL_FCRLDEN5_Pos) /*!< BPWM_T::CAPCTL: FCRLDEN5 Mask */ + +#define BPWM_CAPCTL_FCRLDENn_Pos (24) /*!< BPWM_T::CAPCTL: FCRLDENn Position */ +#define BPWM_CAPCTL_FCRLDENn_Msk (0x3ful << BPWM_CAPCTL_FCRLDENn_Pos) /*!< BPWM_T::CAPCTL: FCRLDENn Mask */ + +#define BPWM_CAPSTS_CRIFOV0_Pos (0) /*!< BPWM_T::CAPSTS: CRIFOV0 Position */ +#define BPWM_CAPSTS_CRIFOV0_Msk (0x1ul << BPWM_CAPSTS_CRIFOV0_Pos) /*!< BPWM_T::CAPSTS: CRIFOV0 Mask */ + +#define BPWM_CAPSTS_CRIFOV1_Pos (1) /*!< BPWM_T::CAPSTS: CRIFOV1 Position */ +#define BPWM_CAPSTS_CRIFOV1_Msk (0x1ul << BPWM_CAPSTS_CRIFOV1_Pos) /*!< BPWM_T::CAPSTS: CRIFOV1 Mask */ + +#define BPWM_CAPSTS_CRIFOV2_Pos (2) /*!< BPWM_T::CAPSTS: CRIFOV2 Position */ +#define BPWM_CAPSTS_CRIFOV2_Msk (0x1ul << BPWM_CAPSTS_CRIFOV2_Pos) /*!< BPWM_T::CAPSTS: CRIFOV2 Mask */ + +#define BPWM_CAPSTS_CRIFOV3_Pos (3) /*!< BPWM_T::CAPSTS: CRIFOV3 Position */ +#define BPWM_CAPSTS_CRIFOV3_Msk (0x1ul << BPWM_CAPSTS_CRIFOV3_Pos) /*!< BPWM_T::CAPSTS: CRIFOV3 Mask */ + +#define BPWM_CAPSTS_CRIFOV4_Pos (4) /*!< BPWM_T::CAPSTS: CRIFOV4 Position */ +#define BPWM_CAPSTS_CRIFOV4_Msk (0x1ul << BPWM_CAPSTS_CRIFOV4_Pos) /*!< BPWM_T::CAPSTS: CRIFOV4 Mask */ + +#define BPWM_CAPSTS_CRIFOV5_Pos (5) /*!< BPWM_T::CAPSTS: CRIFOV5 Position */ +#define BPWM_CAPSTS_CRIFOV5_Msk (0x1ul << BPWM_CAPSTS_CRIFOV5_Pos) /*!< BPWM_T::CAPSTS: CRIFOV5 Mask */ + +#define BPWM_CAPSTS_CRIFOVn_Pos (0) /*!< BPWM_T::CAPSTS: CRIFOVn Position */ +#define BPWM_CAPSTS_CRIFOVn_Msk (0x3ful << BPWM_CAPSTS_CRIFOVn_Pos) /*!< BPWM_T::CAPSTS: CRIFOVn Mask */ + +#define BPWM_CAPSTS_CFIFOV0_Pos (8) /*!< BPWM_T::CAPSTS: CFIFOV0 Position */ +#define BPWM_CAPSTS_CFIFOV0_Msk (0x1ul << BPWM_CAPSTS_CFIFOV0_Pos) /*!< BPWM_T::CAPSTS: CFIFOV0 Mask */ + +#define BPWM_CAPSTS_CFIFOV1_Pos (9) /*!< BPWM_T::CAPSTS: CFIFOV1 Position */ +#define BPWM_CAPSTS_CFIFOV1_Msk (0x1ul << BPWM_CAPSTS_CFIFOV1_Pos) /*!< BPWM_T::CAPSTS: CFIFOV1 Mask */ + +#define BPWM_CAPSTS_CFIFOV2_Pos (10) /*!< BPWM_T::CAPSTS: CFIFOV2 Position */ +#define BPWM_CAPSTS_CFIFOV2_Msk (0x1ul << BPWM_CAPSTS_CFIFOV2_Pos) /*!< BPWM_T::CAPSTS: CFIFOV2 Mask */ + +#define BPWM_CAPSTS_CFIFOV3_Pos (11) /*!< BPWM_T::CAPSTS: CFIFOV3 Position */ +#define BPWM_CAPSTS_CFIFOV3_Msk (0x1ul << BPWM_CAPSTS_CFIFOV3_Pos) /*!< BPWM_T::CAPSTS: CFIFOV3 Mask */ + +#define BPWM_CAPSTS_CFIFOV4_Pos (12) /*!< BPWM_T::CAPSTS: CFIFOV4 Position */ +#define BPWM_CAPSTS_CFIFOV4_Msk (0x1ul << BPWM_CAPSTS_CFIFOV4_Pos) /*!< BPWM_T::CAPSTS: CFIFOV4 Mask */ + +#define BPWM_CAPSTS_CFIFOV5_Pos (13) /*!< BPWM_T::CAPSTS: CFIFOV5 Position */ +#define BPWM_CAPSTS_CFIFOV5_Msk (0x1ul << BPWM_CAPSTS_CFIFOV5_Pos) /*!< BPWM_T::CAPSTS: CFIFOV5 Mask */ + +#define BPWM_CAPSTS_CFIFOVn_Pos (8) /*!< BPWM_T::CAPSTS: CFIFOVn Position */ +#define BPWM_CAPSTS_CFIFOVn_Msk (0x3ful << BPWM_CAPSTS_CFIFOVn_Pos) /*!< BPWM_T::CAPSTS: CFIFOVn Mask */ + +#define BPWM_RCAPDAT0_RCAPDAT_Pos (0) /*!< BPWM_T::RCAPDAT0: RCAPDAT Position */ +#define BPWM_RCAPDAT0_RCAPDAT_Msk (0xfffful << BPWM_RCAPDAT0_RCAPDAT_Pos) /*!< BPWM_T::RCAPDAT0: RCAPDAT Mask */ + +#define BPWM_FCAPDAT0_FCAPDAT_Pos (0) /*!< BPWM_T::FCAPDAT0: FCAPDAT Position */ +#define BPWM_FCAPDAT0_FCAPDAT_Msk (0xfffful << BPWM_FCAPDAT0_FCAPDAT_Pos) /*!< BPWM_T::FCAPDAT0: FCAPDAT Mask */ + +#define BPWM_RCAPDAT1_RCAPDAT_Pos (0) /*!< BPWM_T::RCAPDAT1: RCAPDAT Position */ +#define BPWM_RCAPDAT1_RCAPDAT_Msk (0xfffful << BPWM_RCAPDAT1_RCAPDAT_Pos) /*!< BPWM_T::RCAPDAT1: RCAPDAT Mask */ + +#define BPWM_FCAPDAT1_FCAPDAT_Pos (0) /*!< BPWM_T::FCAPDAT1: FCAPDAT Position */ +#define BPWM_FCAPDAT1_FCAPDAT_Msk (0xfffful << BPWM_FCAPDAT1_FCAPDAT_Pos) /*!< BPWM_T::FCAPDAT1: FCAPDAT Mask */ + +#define BPWM_RCAPDAT2_RCAPDAT_Pos (0) /*!< BPWM_T::RCAPDAT2: RCAPDAT Position */ +#define BPWM_RCAPDAT2_RCAPDAT_Msk (0xfffful << BPWM_RCAPDAT2_RCAPDAT_Pos) /*!< BPWM_T::RCAPDAT2: RCAPDAT Mask */ + +#define BPWM_FCAPDAT2_FCAPDAT_Pos (0) /*!< BPWM_T::FCAPDAT2: FCAPDAT Position */ +#define BPWM_FCAPDAT2_FCAPDAT_Msk (0xfffful << BPWM_FCAPDAT2_FCAPDAT_Pos) /*!< BPWM_T::FCAPDAT2: FCAPDAT Mask */ + +#define BPWM_RCAPDAT3_RCAPDAT_Pos (0) /*!< BPWM_T::RCAPDAT3: RCAPDAT Position */ +#define BPWM_RCAPDAT3_RCAPDAT_Msk (0xfffful << BPWM_RCAPDAT3_RCAPDAT_Pos) /*!< BPWM_T::RCAPDAT3: RCAPDAT Mask */ + +#define BPWM_FCAPDAT3_FCAPDAT_Pos (0) /*!< BPWM_T::FCAPDAT3: FCAPDAT Position */ +#define BPWM_FCAPDAT3_FCAPDAT_Msk (0xfffful << BPWM_FCAPDAT3_FCAPDAT_Pos) /*!< BPWM_T::FCAPDAT3: FCAPDAT Mask */ + +#define BPWM_RCAPDAT4_RCAPDAT_Pos (0) /*!< BPWM_T::RCAPDAT4: RCAPDAT Position */ +#define BPWM_RCAPDAT4_RCAPDAT_Msk (0xfffful << BPWM_RCAPDAT4_RCAPDAT_Pos) /*!< BPWM_T::RCAPDAT4: RCAPDAT Mask */ + +#define BPWM_FCAPDAT4_FCAPDAT_Pos (0) /*!< BPWM_T::FCAPDAT4: FCAPDAT Position */ +#define BPWM_FCAPDAT4_FCAPDAT_Msk (0xfffful << BPWM_FCAPDAT4_FCAPDAT_Pos) /*!< BPWM_T::FCAPDAT4: FCAPDAT Mask */ + +#define BPWM_RCAPDAT5_RCAPDAT_Pos (0) /*!< BPWM_T::RCAPDAT5: RCAPDAT Position */ +#define BPWM_RCAPDAT5_RCAPDAT_Msk (0xfffful << BPWM_RCAPDAT5_RCAPDAT_Pos) /*!< BPWM_T::RCAPDAT5: RCAPDAT Mask */ + +#define BPWM_FCAPDAT5_FCAPDAT_Pos (0) /*!< BPWM_T::FCAPDAT5: FCAPDAT Position */ +#define BPWM_FCAPDAT5_FCAPDAT_Msk (0xfffful << BPWM_FCAPDAT5_FCAPDAT_Pos) /*!< BPWM_T::FCAPDAT5: FCAPDAT Mask */ + +#define BPWM_CAPIEN_CAPRIENn_Pos (0) /*!< BPWM_T::CAPIEN: CAPRIENn Position */ +#define BPWM_CAPIEN_CAPRIENn_Msk (0x3ful << BPWM_CAPIEN_CAPRIENn_Pos) /*!< BPWM_T::CAPIEN: CAPRIENn Mask */ + +#define BPWM_CAPIEN_CAPFIENn_Pos (8) /*!< BPWM_T::CAPIEN: CAPFIENn Position */ +#define BPWM_CAPIEN_CAPFIENn_Msk (0x3ful << BPWM_CAPIEN_CAPFIENn_Pos) /*!< BPWM_T::CAPIEN: CAPFIENn Mask */ + +#define BPWM_CAPIF_CAPRIF0_Pos (0) /*!< BPWM_T::CAPIF: CAPRIF0 Position */ +#define BPWM_CAPIF_CAPRIF0_Msk (0x1ul << BPWM_CAPIF_CAPRIF0_Pos) /*!< BPWM_T::CAPIF: CAPRIF0 Mask */ + +#define BPWM_CAPIF_CAPRIF1_Pos (1) /*!< BPWM_T::CAPIF: CAPRIF1 Position */ +#define BPWM_CAPIF_CAPRIF1_Msk (0x1ul << BPWM_CAPIF_CAPRIF1_Pos) /*!< BPWM_T::CAPIF: CAPRIF1 Mask */ + +#define BPWM_CAPIF_CAPRIF2_Pos (2) /*!< BPWM_T::CAPIF: CAPRIF2 Position */ +#define BPWM_CAPIF_CAPRIF2_Msk (0x1ul << BPWM_CAPIF_CAPRIF2_Pos) /*!< BPWM_T::CAPIF: CAPRIF2 Mask */ + +#define BPWM_CAPIF_CAPRIF3_Pos (3) /*!< BPWM_T::CAPIF: CAPRIF3 Position */ +#define BPWM_CAPIF_CAPRIF3_Msk (0x1ul << BPWM_CAPIF_CAPRIF3_Pos) /*!< BPWM_T::CAPIF: CAPRIF3 Mask */ + +#define BPWM_CAPIF_CAPRIF4_Pos (4) /*!< BPWM_T::CAPIF: CAPRIF4 Position */ +#define BPWM_CAPIF_CAPRIF4_Msk (0x1ul << BPWM_CAPIF_CAPRIF4_Pos) /*!< BPWM_T::CAPIF: CAPRIF4 Mask */ + +#define BPWM_CAPIF_CAPRIF5_Pos (5) /*!< BPWM_T::CAPIF: CAPRIF5 Position */ +#define BPWM_CAPIF_CAPRIF5_Msk (0x1ul << BPWM_CAPIF_CAPRIF5_Pos) /*!< BPWM_T::CAPIF: CAPRIF5 Mask */ + +#define BPWM_CAPIF_CAPRIFn_Pos (0) /*!< BPWM_T::CAPIF: CAPRIFn Position */ +#define BPWM_CAPIF_CAPRIFn_Msk (0x3ful << BPWM_CAPIF_CAPRIFn_Pos) /*!< BPWM_T::CAPIF: CAPRIFn Mask */ + +#define BPWM_CAPIF_CAPFIF0_Pos (8) /*!< BPWM_T::CAPIF: CAPFIF0 Position */ +#define BPWM_CAPIF_CAPFIF0_Msk (0x1ul << BPWM_CAPIF_CAPFIF0_Pos) /*!< BPWM_T::CAPIF: CAPFIF0 Mask */ + +#define BPWM_CAPIF_CAPFIF1_Pos (9) /*!< BPWM_T::CAPIF: CAPFIF1 Position */ +#define BPWM_CAPIF_CAPFIF1_Msk (0x1ul << BPWM_CAPIF_CAPFIF1_Pos) /*!< BPWM_T::CAPIF: CAPFIF1 Mask */ + +#define BPWM_CAPIF_CAPFIF2_Pos (10) /*!< BPWM_T::CAPIF: CAPFIF2 Position */ +#define BPWM_CAPIF_CAPFIF2_Msk (0x1ul << BPWM_CAPIF_CAPFIF2_Pos) /*!< BPWM_T::CAPIF: CAPFIF2 Mask */ + +#define BPWM_CAPIF_CAPFIF3_Pos (11) /*!< BPWM_T::CAPIF: CAPFIF3 Position */ +#define BPWM_CAPIF_CAPFIF3_Msk (0x1ul << BPWM_CAPIF_CAPFIF3_Pos) /*!< BPWM_T::CAPIF: CAPFIF3 Mask */ + +#define BPWM_CAPIF_CAPFIF4_Pos (12) /*!< BPWM_T::CAPIF: CAPFIF4 Position */ +#define BPWM_CAPIF_CAPFIF4_Msk (0x1ul << BPWM_CAPIF_CAPFIF4_Pos) /*!< BPWM_T::CAPIF: CAPFIF4 Mask */ + +#define BPWM_CAPIF_CAPFIF5_Pos (13) /*!< BPWM_T::CAPIF: CAPFIF5 Position */ +#define BPWM_CAPIF_CAPFIF5_Msk (0x1ul << BPWM_CAPIF_CAPFIF5_Pos) /*!< BPWM_T::CAPIF: CAPFIF5 Mask */ + +#define BPWM_CAPIF_CAPFIFn_Pos (8) /*!< BPWM_T::CAPIF: CAPFIFn Position */ +#define BPWM_CAPIF_CAPFIFn_Msk (0x3ful << BPWM_CAPIF_CAPFIFn_Pos) /*!< BPWM_T::CAPIF: CAPFIFn Mask */ + +#define BPWM_PBUF_PBUF_Pos (0) /*!< BPWM_T::PBUF: PBUF Position */ +#define BPWM_PBUF_PBUF_Msk (0xfffful << BPWM_PBUF_PBUF_Pos) /*!< BPWM_T::PBUF: PBUF Mask */ + +#define BPWM_CMPBUF0_CMPBUF_Pos (0) /*!< BPWM_T::CMPBUF0: CMPBUF Position */ +#define BPWM_CMPBUF0_CMPBUF_Msk (0xfffful << BPWM_CMPBUF0_CMPBUF_Pos) /*!< BPWM_T::CMPBUF0: CMPBUF Mask */ + +#define BPWM_CMPBUF1_CMPBUF_Pos (0) /*!< BPWM_T::CMPBUF1: CMPBUF Position */ +#define BPWM_CMPBUF1_CMPBUF_Msk (0xfffful << BPWM_CMPBUF1_CMPBUF_Pos) /*!< BPWM_T::CMPBUF1: CMPBUF Mask */ + +#define BPWM_CMPBUF2_CMPBUF_Pos (0) /*!< BPWM_T::CMPBUF2: CMPBUF Position */ +#define BPWM_CMPBUF2_CMPBUF_Msk (0xfffful << BPWM_CMPBUF2_CMPBUF_Pos) /*!< BPWM_T::CMPBUF2: CMPBUF Mask */ + +#define BPWM_CMPBUF3_CMPBUF_Pos (0) /*!< BPWM_T::CMPBUF3: CMPBUF Position */ +#define BPWM_CMPBUF3_CMPBUF_Msk (0xfffful << BPWM_CMPBUF3_CMPBUF_Pos) /*!< BPWM_T::CMPBUF3: CMPBUF Mask */ + +#define BPWM_CMPBUF4_CMPBUF_Pos (0) /*!< BPWM_T::CMPBUF4: CMPBUF Position */ +#define BPWM_CMPBUF4_CMPBUF_Msk (0xfffful << BPWM_CMPBUF4_CMPBUF_Pos) /*!< BPWM_T::CMPBUF4: CMPBUF Mask */ + +#define BPWM_CMPBUF5_CMPBUF_Pos (0) /*!< BPWM_T::CMPBUF5: CMPBUF Position */ +#define BPWM_CMPBUF5_CMPBUF_Msk (0xfffful << BPWM_CMPBUF5_CMPBUF_Pos) /*!< BPWM_T::CMPBUF5: CMPBUF Mask */ + +/**@}*/ /* BPWM_CONST */ +/**@}*/ /* end of BPWM register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __BPWM_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/can_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/can_reg.h new file mode 100644 index 00000000000..86340d99d85 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/can_reg.h @@ -0,0 +1,759 @@ +/**************************************************************************//** + * @file can_reg.h + * @version V1.00 + * @brief CAN register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __CAN_REG_H__ +#define __CAN_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup CAN Controller Area Network Controller(CAN) + Memory Mapped Structure for CAN Controller +@{ */ + + +typedef struct +{ + + /** + * @var CAN_IF_T::CREQ + * Offset: 0x20, 0x80 IFn Command Request Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[5:0] |MessageNumber|Message Number + * | | |0x01-0x20: Valid Message Number, the Message Object in the Message + * | | |RAM is selected for data transfer. + * | | |0x00: Not a valid Message Number, interpreted as 0x20. + * | | |0x21-0x3F: Not a valid Message Number, interpreted as 0x01-0x1F. + * |[15] |Busy |Busy Flag + * | | |0 = Read/write action has finished. + * | | |1 = Writing to the IFn Command Request Register is in progress + * | | |This bit can only be read by the software. + * @var CAN_IF_T::CMASK + * Offset: 0x24, 0x84 IFn Command Mask Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |DAT_B |Access Data Bytes [7:4] + * | | |Write Operation: + * | | |0 = Data Bytes [7:4] unchanged. + * | | |1 = Transfer Data Bytes [7:4] to Message Object. + * | | |Read Operation: + * | | |0 = Data Bytes [7:4] unchanged. + * | | |1 = Transfer Data Bytes [7:4] to IFn Message Buffer Register. + * |[1] |DAT_A |Access Data Bytes [3:0] + * | | |Write Operation: + * | | |0 = Data Bytes [3:0] unchanged. + * | | |1 = Transfer Data Bytes [3:0] to Message Object. + * | | |Read Operation: + * | | |0 = Data Bytes [3:0] unchanged. + * | | |1 = Transfer Data Bytes [3:0] to IFn Message Buffer Register. + * |[2] |TxRqst_NewDat|Access Transmission Request Bit When Write Operation + * | | |0 = TxRqst bit unchanged. + * | | |1 = Set TxRqst bit. + * | | |Note: If a transmission is requested by programming bit TxRqst/NewDat in the IFn Command Mask Register, bit TxRqst in the IFn Message Control Register will be ignored. + * | | |Access New Data Bit when Read Operation. + * | | |0 = NewDat bit remains unchanged. + * | | |1 = Clear NewDat bit in the Message Object. + * | | |Note: A read access to a Message Object can be combined with the reset of the control bits IntPnd and NewDat + * | | |The values of these bits transferred to the IFn Message Control Register always reflect the status before resetting these bits. + * |[3] |ClrIntPnd |Clear Interrupt Pending Bit + * | | |Write Operation: + * | | |When writing to a Message Object, this bit is ignored. + * | | |Read Operation: + * | | |0 = IntPnd bit (CAN_IFn_MCON[13]) remains unchanged. + * | | |1 = Clear IntPnd bit in the Message Object. + * |[4] |Control |Control Access Control Bits + * | | |Write Operation: + * | | |0 = Control Bits unchanged. + * | | |1 = Transfer Control Bits to Message Object. + * | | |Read Operation: + * | | |0 = Control Bits unchanged. + * | | |1 = Transfer Control Bits to IFn Message Buffer Register. + * |[5] |Arb |Access Arbitration Bits + * | | |Write Operation: + * | | |0 = Arbitration bits unchanged. + * | | |1 = Transfer Identifier + Dir (CAN_IFn_ARB2[13]) + Xtd (CAN_IFn_ARB2[14]) + MsgVal (CAN_IFn_ARB2[15]) to Message Object. + * | | |Read Operation: + * | | |0 = Arbitration bits unchanged. + * | | |1 = Transfer Identifier + Dir + Xtd + MsgVal to IFn Message Buffer Register. + * |[6] |Mask |Access Mask Bits + * | | |Write Operation: + * | | |0 = Mask bits unchanged. + * | | |1 = Transfer Identifier Mask + MDir + MXtd to Message Object. + * | | |Read Operation: + * | | |0 = Mask bits unchanged. + * | | |1 = Transfer Identifier Mask + MDir + MXtd to IFn Message Buffer Register. + * |[7] |WR_RD |Write / Read Mode + * | | |0 = Read: Transfer data from the Message Object addressed by the Command Request Register into the selected Message Buffer Registers. + * | | |1 = Write: Transfer data from the selected Message Buffer Registers to the Message Object addressed by the Command Request Register. + * @var CAN_IF_T::MASK1 + * Offset: 0x28, 0x88 IFn Mask 1 Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |Msk |Identifier Mask 15-0 + * | | |0 = The corresponding bit in the identifier of the message object cannot inhibit the match in the acceptance filtering. + * | | |1 = The corresponding identifier bit is used for acceptance filtering. + * @var CAN_IF_T::MASK2 + * Offset: 0x2C, 0x8C IFn Mask 2 Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[12:0] |Msk |Identifier Mask 28-16 + * | | |0 = The corresponding bit in the identifier of the message object cannot inhibit the match in the acceptance filtering. + * | | |1 = The corresponding identifier bit is used for acceptance filtering. + * |[14] |MDir |Mask Message Direction + * | | |0 = The message direction bit (Dir (CAN_IFn_ARB2[13])) has no effect on the acceptance filtering. + * | | |1 = The message direction bit (Dir) is used for acceptance filtering. + * |[15] |MXtd |Mask Extended Identifier + * | | |0 = The extended identifier bit (IDE) has no effect on the acceptance filtering. + * | | |1 = The extended identifier bit (IDE) is used for acceptance filtering. + * | | |Note: When 11-bit (standard) Identifiers are used for a Message Object, the identifiers of received Data Frames are written into bits ID28 to ID18 (CAN_IFn_ARB2[12:2]) + * | | |For acceptance filtering, only these bits together with mask bits Msk28 to Msk18 (CAN_IFn_MASK2[12:2]) are considered. + * @var CAN_IF_T::ARB1 + * Offset: 0x30, 0x90 IFn Arbitration 1 Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |ID |Message Identifier 15-0 + * | | |ID28 - ID0, 29-bit Identifier (Extended Frame) + * | | |ID28 - ID18, 11-bit Identifier (Standard Frame) + * @var CAN_IF_T::ARB2 + * Offset: 0x34, 0x94 IFn Arbitration 2 Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[12:0] |ID |Message Identifier 28-16 + * | | |ID28 - ID0, 29-bit Identifier (Extended Frame) + * | | |ID28 - ID18, 11-bit Identifier (Standard Frame) + * |[13] |Dir |Message Direction + * | | |0 = Direction is receive. + * | | |On TxRqst, a Remote Frame with the identifier of this Message Object is transmitted + * | | |On reception of a Data Frame with matching identifier, that message is stored in this Message Object. + * | | |1 = Direction is transmit. + * | | |On TxRqst, the respective Message Object is transmitted as a Data Frame + * | | |On reception of a Remote Frame with matching identifier, the TxRqst bit (CAN_IFn_CMASK[2]) of this Message Object is set (if RmtEn (CAN_IFn_MCON[9]) = one). + * |[14] |Xtd |Extended Identifier + * | | |0 = The 11-bit (standard) Identifier will be used for this Message Object. + * | | |1 = The 29-bit (extended) Identifier will be used for this Message Object. + * |[15] |MsgVal |Message Valid + * | | |0 = The Message Object is ignored by the Message Handler. + * | | |1 = The Message Object is configured and should be considered by the Message Handler. + * | | |Note: The application software must reset the MsgVal bit of all unused Messages Objects during the initialization before it resets bit Init (CAN_CON[0]) + * | | |This bit must also be reset before the identifier Id28-0 (CAN_IFn_ARB1/2), the control bits Xtd (CAN_IFn_ARB2[14]), Dir (CAN_IFn_ARB2[13]), or the Data Length Code DLC3-0 (CAN_IFn_MCON[3:0]) are modified, or if the Messages Object is no longer required. + * @var CAN_IF_T::MCON + * Offset: 0x38, 0x98 IFn Message Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |DLC |Data Length Code + * | | |0-8: Data Frame has 0-8 data bytes. + * | | |9-15: Data Frame has 8 data bytes + * | | |Note: The Data Length Code of a Message Object must be defined the same as in all the corresponding objects with the same identifier at other nodes + * | | |When the Message Handler stores a data frame, it will write the DLC to the value given by the received message. + * | | |Data(0): 1st data byte of a CAN Data Frame + * | | |Data(1): 2nd data byte of a CAN Data Frame + * | | |Data(2): 3rd data byte of a CAN Data Frame + * | | |Data(3): 4th data byte of a CAN Data Frame + * | | |Data(4): 5th data byte of a CAN Data Frame + * | | |Data(5): 6th data byte of a CAN Data Frame + * | | |Data(6): 7th data byte of a CAN Data Frame + * | | |Data(7): 8th data byte of a CAN Data Frame + * | | |Note: The Data(0) byte is the first data byte shifted into the shift register of the CAN Core during a reception while the Data(7) byte is the last + * | | |When the Message Handler stores a Data Frame, it will write all the eight data bytes into a Message Object + * | | |If the Data Length Code is less than 8, the remaining bytes of the Message Object will be overwritten by unspecified values. + * |[7] |EoB |End of Buffer + * | | |0 = Message Object belongs to a FIFO Buffer and is not the last Message Object of that FIFO Buffer. + * | | |1 = Single Message Object or last Message Object of a FIFO Buffer. + * | | |Note: This bit is used to concatenate two or more Message Objects (up to 32) to build a FIFO Buffer + * | | |For single Message Objects (not belonging to a FIFO Buffer), this bit must always be set to one + * |[8] |TxRqst |Transmit Request + * | | |0 = This Message Object is not waiting for transmission. + * | | |1 = The transmission of this Message Object is requested and is not yet done. + * |[9] |RmtEn |Remote Enable Bit + * | | |0 = At the reception of a Remote Frame, TxRqst (CAN_IFn_MCON[8]) is left unchanged. + * | | |1 = At the reception of a Remote Frame, TxRqst is set. + * |[10] |RxIE |Receive Interrupt Enable Bit + * | | |0 = IntPnd (CAN_IFn_MCON[13]) will be left unchanged after a successful reception of a frame. + * | | |1 = IntPnd will be set after a successful reception of a frame. + * |[11] |TxIE |Transmit Interrupt Enable Bit + * | | |0 = IntPnd (CAN_IFn_MCON[13]) will be left unchanged after the successful transmission of a frame. + * | | |1 = IntPnd will be set after a successful transmission of a frame. + * |[12] |UMask |Use Acceptance Mask + * | | |0 = Mask ignored. + * | | |1 = Use Mask (Msk28-0, MXtd, and MDir) for acceptance filtering. + * | | |Note: If the UMask bit is set to one, the Message Object's mask bits have to be programmed during initialization of the Message Object before MsgVal bit (CAN_IFn_ARB2[15]) is set to one. + * |[13] |IntPnd |Interrupt Pending + * | | |0 = This message object is not the source of an interrupt. + * | | |1 = This message object is the source of an interrupt + * | | |The Interrupt Identifier in the Interrupt Register will point to this message object if there is no other interrupt source with higher priority. + * |[14] |MsgLst |Message Lost (only valid for Message Objects with direction = receive). + * | | |0 = No message lost since last time this bit was reset by the CPU. + * | | |1 = The Message Handler stored a new message into this object when NewDat was still set, the CPU has lost a message. + * |[15] |NewDat |New Data + * | | |0 = No new data has been written into the data portion of this Message Object by the Message Handler since last time this flag was cleared by the application software. + * | | |1 = The Message Handler or the application software has written new data into the data portion of this Message Object. + * @var CAN_IF_T::DAT_A1 + * Offset: 0x3C, 0x9C IFn Data A1 Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |Data_0_ |Data Byte 0 + * | | |1st data byte of a CAN Data Frame + * |[15:8] |Data_1_ |Data Byte 1 + * | | |2nd data byte of a CAN Data Frame + * @var CAN_IF_T::DAT_A2 + * Offset: 0x40, 0xA0 IFn Data A2 Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |Data_2_ |Data Byte 2 + * | | |3rd data byte of CAN Data Frame + * |[15:8] |Data_3_ |Data Byte 3 + * | | |4th data byte of CAN Data Frame + * @var CAN_IF_T::DAT_B1 + * Offset: 0x44, 0xA4 IFn Data B1 Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |Data_4_ |Data Byte 4 + * | | |5th data byte of CAN Data Frame + * |[15:8] |Data_5_ |Data Byte 5 + * | | |6th data byte of CAN Data Frame + * @var CAN_IF_T::DAT_B2 + * Offset: 0x48, 0xA8 IFn Data B2 Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |Data_6_ |Data Byte 6 + * | | |7th data byte of CAN Data Frame. + * |[15:8] |Data_7_ |Data Byte 7 + * | | |8th data byte of CAN Data Frame. + */ + __IO uint32_t CREQ; /*!< [0x0020] IFn Command Request Register */ + __IO uint32_t CMASK; /*!< [0x0024] IFn Command Mask Register */ + __IO uint32_t MASK1; /*!< [0x0028] IFn Mask 1 Register */ + __IO uint32_t MASK2; /*!< [0x002c] IFn Mask 2 Register */ + __IO uint32_t ARB1; /*!< [0x0030] IFn Arbitration 1 Register */ + __IO uint32_t ARB2; /*!< [0x0034] IFn Arbitration 2 Register */ + __IO uint32_t MCON; /*!< [0x0038] IFn Message Control Register */ + __IO uint32_t DAT_A1; /*!< [0x003c] IFn Data A1 Register */ + __IO uint32_t DAT_A2; /*!< [0x0040] IFn Data A2 Register */ + __IO uint32_t DAT_B1; /*!< [0x0044] IFn Data B1 Register */ + __IO uint32_t DAT_B2; /*!< [0x0048] IFn Data B2 Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[13]; + /// @endcond //HIDDEN_SYMBOLS +} CAN_IF_T; + + +typedef struct +{ + + + /** + * @var CAN_T::CON + * Offset: 0x00 Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |Init |Init Initialization + * | | |0 = Normal Operation. + * | | |1 = Initialization is started. + * |[1] |IE |Module Interrupt Enable Bit + * | | |0 = Function interrupt is Disabled. + * | | |1 = Function interrupt is Enabled. + * |[2] |SIE |Status Change Interrupt Enable Bit + * | | |0 = Disabled - No Status Change Interrupt will be generated. + * | | |1 = Enabled - An interrupt will be generated when a message transfer is successfully completed or a CAN bus error is detected. + * |[3] |EIE |Error Interrupt Enable Bit + * | | |0 = Disabled - No Error Status Interrupt will be generated. + * | | |1 = Enabled - A change in the bits BOff (CAN_STATUS[7]) or EWarn (CAN_STATUS[6]) in the Status Register will generate an interrupt. + * |[5] |DAR |Automatic Re-transmission Disable Bit + * | | |0 = Automatic Retransmission of disturbed messages Enabled. + * | | |1 = Automatic Retransmission Disabled. + * |[6] |CCE |Configuration Change Enable Bit + * | | |0 = No write access to the Bit Timing Register. + * | | |1 = Write access to the Bit Timing Register (CAN_BTIME) allowed. (while Init bit (CAN_CON[0]) = 1). + * |[7] |Test |Test Mode Enable Bit + * | | |0 = Normal Operation. + * | | |1 = Test Mode. + * @var CAN_T::STATUS + * Offset: 0x04 Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2:0] |LEC |Last Error Code (Type of the Last Error to Occur on the CAN Bus) + * | | |The LEC field holds a code, which indicates the type of the last error to occur on the CAN bus + * | | |This field will be cleared to '0' when a message has been transferred (reception or transmission) without error + * | | |The unused code '7' may be written by the CPU to check for updates + * | | |The Error! Reference source not found + * | | |describes the error code. + * |[3] |TxOK |Transmitted a Message Successfully + * | | |0 = Since this bit was reset by the CPU, no message has been successfully transmitted + * | | |This bit is never reset by the CAN Core. + * | | |1 = Since this bit was last reset by the CPU, a message has been successfully (error free and acknowledged by at least one other node) transmitted. + * |[4] |RxOK |Received a Message Successfully + * | | |0 = No message has been successfully received since this bit was last reset by the CPU + * | | |This bit is never reset by the CAN Core. + * | | |1 = A message has been successfully received since this bit was last reset by the CPU (independent of the result of acceptance filtering). + * |[5] |EPass |Error Passive (Read Only) + * | | |0 = The CAN Core is error active. + * | | |1 = The CAN Core is in the error passive state as defined in the CAN Specification. + * |[6] |EWarn |Error Warning Status (Read Only) + * | | |0 = Both error counters are below the error warning limit of 96. + * | | |1 = At least one of the error counters in the EML has reached the error warning limit of 96. + * |[7] |BOff |Bus-off Status (Read Only) + * | | |0 = The CAN module is not in bus-off state. + * | | |1 = The CAN module is in bus-off state. + * @var CAN_T::ERR + * Offset: 0x08 Error Counter Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |TEC |Transmit Error Counter + * | | |Actual state of the Transmit Error Counter. Values between 0 and 255. + * |[14:8] |REC |Receive Error Counter + * | | |Actual state of the Receive Error Counter. Values between 0 and 127. + * |[15] |RP |Receive Error Passive + * | | |0 = The Receive Error Counter is below the error passive level. + * | | |1 = The Receive Error Counter has reached the error passive level as defined in the CAN Specification. + * @var CAN_T::BTIME + * Offset: 0x0C Bit Timing Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[5:0] |BRP |Baud Rate Prescaler + * | | |0x01-0x3F: The value by which the oscillator frequency is divided for generating the bit time quanta + * | | |The bit time is built up from a multiple of this quanta + * | | |Valid values for the Baud Rate Prescaler are [0...63] + * | | |The actual interpretation by the hardware of this value is such that one more than the value programmed here is used. + * |[7:6] |SJW |(Re)Synchronization Jump Width + * | | |0x0-0x3: Valid programmed values are [0...3] + * | | |The actual interpretation by the hardware of this value is such that one more than the value programmed here is used. + * |[11:8] |TSeg1 |Time Segment Before the Sample Point Minus Sync_Seg + * | | |0x01-0x0F: valid values for TSeg1 are [1...15] + * | | |The actual interpretation by the hardware of this value is such that one more than the value programmed is used. + * |[14:12] |TSeg2 |Time Segment After Sample Point + * | | |0x0-0x7: Valid values for TSeg2 are [0...7] + * | | |The actual interpretation by the hardware of this value is such that one more than the value programmed here is used. + * @var CAN_T::IIDR + * Offset: 0x10 Interrupt Identifier Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |IntId |Interrupt Identifier (Indicates the Source of the Interrupt) + * | | |If several interrupts are pending, the CAN Interrupt Register will point to the pending interrupt with the highest priority, disregarding their chronological order + * | | |An interrupt remains pending until the application software has cleared it + * | | |If IntId is different from 0x0000 and IE (CAN_CON[1]) is set, the IRQ interrupt signal to the EIC is active + * | | |The interrupt remains active until IntId is back to value 0x0000 (the cause of the interrupt is reset) or until IE is reset. + * | | |The Status Interrupt has the highest priority + * | | |Among the message interrupts, the Message Object' s interrupt priority decreases with increasing message number. + * | | |A message interrupt is cleared by clearing the Message Object's IntPnd bit (CAN_IFn_MCON[13]) + * | | |The Status Interrupt is cleared by reading the Status Register. + * @var CAN_T::TEST + * Offset: 0x14 Test Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2] |Basic |Basic Mode + * | | |0 = Basic Mode Disabled. + * | | |1= IF1 Registers used as Tx Buffer, IF2 Registers used as Rx Buffer. + * |[3] |Silent |Silent Mode + * | | |0 = Normal operation. + * | | |1 = The module is in Silent Mode. + * |[4] |LBack |Loop Back Mode Enable Bit + * | | |0 = Loop Back Mode is Disabled. + * | | |1 = Loop Back Mode is Enabled. + * |[6:5] |Tx |Tx[1:0]: Control of CAN_TX Pin + * | | |00 = Reset value, CAN_TX pin is controlled by the CAN Core. + * | | |01 = Sample Point can be monitored at CAN_TX pin. + * | | |10 = CAN_TX pin drives a dominant ('0') value. + * | | |11 = CAN_TX pin drives a recessive ('1') value. + * |[7] |Rx |Monitors the Actual Value of CAN_RX Pin (Read Only) *(1) + * | | |0 = The CAN bus is dominant (CAN_RX = '0'). + * | | |1 = The CAN bus is recessive (CAN_RX = '1'). + * @var CAN_T::BRPE + * Offset: 0x18 Baud Rate Prescaler Extension Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |BRPE |BRPE: Baud Rate Prescaler Extension + * | | |0x00-0x0F: By programming BRPE, the Baud Rate Prescaler can be extended to values up to 1023 + * | | |The actual interpretation by the hardware is that one more than the value programmed by BRPE (MSBs) and BTIME (LSBs) is used. + * @var CAN_T::TXREQ1 + * Offset: 0x100 Transmission Request Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |TxRqst16_1|Transmission Request Bits 16-1 (of All Message Objects) + * | | |0 = This Message Object is not waiting for transmission. + * | | |1 = The transmission of this Message Object is requested and is not yet done. + * | | |These bits are read only. + * @var CAN_T::TXREQ2 + * Offset: 0x104 Transmission Request Register 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |TxRqst32_17|Transmission Request Bits 32-17 (of All Message Objects) + * | | |0 = This Message Object is not waiting for transmission. + * | | |1 = The transmission of this Message Object is requested and is not yet done. + * | | |These bits are read only. + * @var CAN_T::NDAT1 + * Offset: 0x120 New Data Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |NewData16_1|New Data Bits 16-1 (of All Message Objects) + * | | |0 = No new data has been written into the data portion of this Message Object by the Message Handler since the last time this flag was cleared by the application software. + * | | |1 = The Message Handler or the application software has written new data into the data portion of this Message Object. + * @var CAN_T::NDAT2 + * Offset: 0x124 New Data Register 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |NewData32_17|New Data Bits 32-17 (of All Message Objects) + * | | |0 = No new data has been written into the data portion of this Message Object by the Message Handler since the last time this flag was cleared by the application software. + * | | |1 = The Message Handler or the application software has written new data into the data portion of this Message Object. + * @var CAN_T::IPND1 + * Offset: 0x140 Interrupt Pending Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |IntPnd16_1|Interrupt Pending Bits 16-1 (of All Message Objects) + * | | |0 = This message object is not the source of an interrupt. + * | | |1 = This message object is the source of an interrupt. + * @var CAN_T::IPND2 + * Offset: 0x144 Interrupt Pending Register 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |IntPnd32_17|Interrupt Pending Bits 32-17 (of All Message Objects) + * | | |0 = This message object is not the source of an interrupt. + * | | |1 = This message object is the source of an interrupt. + * @var CAN_T::MVLD1 + * Offset: 0x160 Message Valid Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |MsgVal16_1|Message Valid Bits 16-1 (of All Message Objects) (Read Only) + * | | |0 = This Message Object is ignored by the Message Handler. + * | | |1 = This Message Object is configured and should be considered by the Message Handler. + * | | |Ex + * | | |CAN_MVLD1[0] means Message object No.1 is valid or not + * | | |If CAN_MVLD1[0] is set, message object No.1 is configured. + * @var CAN_T::MVLD2 + * Offset: 0x164 Message Valid Register 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |MsgVal32_17|Message Valid Bits 32-17 (of All Message Objects) (Read Only) + * | | |0 = This Message Object is ignored by the Message Handler. + * | | |1 = This Message Object is configured and should be considered by the Message Handler. + * | | |Ex.CAN_MVLD2[15] means Message object No.32 is valid or not + * | | |If CAN_MVLD2[15] is set, message object No.32 is configured. + * @var CAN_T::WU_EN + * Offset: 0x168 Wake-up Enable Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |WAKUP_EN |Wake-up Enable Bit + * | | |0 = The wake-up function Disabled. + * | | |1 = The wake-up function Enabled. + * | | |Note: User can wake-up system when there is a falling edge in the CAN_Rx pin. + * @var CAN_T::WU_STATUS + * Offset: 0x16C Wake-up Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |WAKUP_STS |Wake-up Status + * | | |0 = No wake-up event occurred. + * | | |1 = Wake-up event occurred. + * | | |Note: This bit can be cleared by writing '0'. + */ + __IO uint32_t CON; /*!< [0x0000] Control Register */ + __IO uint32_t STATUS; /*!< [0x0004] Status Register */ + __I uint32_t ERR; /*!< [0x0008] Error Counter Register */ + __IO uint32_t BTIME; /*!< [0x000c] Bit Timing Register */ + __I uint32_t IIDR; /*!< [0x0010] Interrupt Identifier Register */ + __IO uint32_t TEST; /*!< [0x0014] Test Register */ + __IO uint32_t BRPE; /*!< [0x0018] Baud Rate Prescaler Extension Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO CAN_IF_T IF[2]; + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE2[8]; + /// @endcond //HIDDEN_SYMBOLS + __I uint32_t TXREQ1; /*!< [0x0100] Transmission Request Register 1 */ + __I uint32_t TXREQ2; /*!< [0x0104] Transmission Request Register 2 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE3[6]; + /// @endcond //HIDDEN_SYMBOLS + __I uint32_t NDAT1; /*!< [0x0120] New Data Register 1 */ + __I uint32_t NDAT2; /*!< [0x0124] New Data Register 2 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE4[6]; + /// @endcond //HIDDEN_SYMBOLS + __I uint32_t IPND1; /*!< [0x0140] Interrupt Pending Register 1 */ + __I uint32_t IPND2; /*!< [0x0144] Interrupt Pending Register 2 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE5[6]; + /// @endcond //HIDDEN_SYMBOLS + __I uint32_t MVLD1; /*!< [0x0160] Message Valid Register 1 */ + __I uint32_t MVLD2; /*!< [0x0164] Message Valid Register 2 */ + __IO uint32_t WU_EN; /*!< [0x0168] Wake-up Enable Control Register */ + __IO uint32_t WU_STATUS; /*!< [0x016c] Wake-up Status Register */ + +} CAN_T; + +/** + @addtogroup CAN_CONST CAN Bit Field Definition + Constant Definitions for CAN Controller +@{ */ + +#define CAN_CON_INIT_Pos (0) /*!< CAN_T::CON: Init Position */ +#define CAN_CON_INIT_Msk (0x1ul << CAN_CON_INIT_Pos) /*!< CAN_T::CON: Init Mask */ + +#define CAN_CON_IE_Pos (1) /*!< CAN_T::CON: IE Position */ +#define CAN_CON_IE_Msk (0x1ul << CAN_CON_IE_Pos) /*!< CAN_T::CON: IE Mask */ + +#define CAN_CON_SIE_Pos (2) /*!< CAN_T::CON: SIE Position */ +#define CAN_CON_SIE_Msk (0x1ul << CAN_CON_SIE_Pos) /*!< CAN_T::CON: SIE Mask */ + +#define CAN_CON_EIE_Pos (3) /*!< CAN_T::CON: EIE Position */ +#define CAN_CON_EIE_Msk (0x1ul << CAN_CON_EIE_Pos) /*!< CAN_T::CON: EIE Mask */ + +#define CAN_CON_DAR_Pos (5) /*!< CAN_T::CON: DAR Position */ +#define CAN_CON_DAR_Msk (0x1ul << CAN_CON_DAR_Pos) /*!< CAN_T::CON: DAR Mask */ + +#define CAN_CON_CCE_Pos (6) /*!< CAN_T::CON: CCE Position */ +#define CAN_CON_CCE_Msk (0x1ul << CAN_CON_CCE_Pos) /*!< CAN_T::CON: CCE Mask */ + +#define CAN_CON_TEST_Pos (7) /*!< CAN_T::CON: Test Position */ +#define CAN_CON_TEST_Msk (0x1ul << CAN_CON_TEST_Pos) /*!< CAN_T::CON: Test Mask */ + +#define CAN_STATUS_LEC_Pos (0) /*!< CAN_T::STATUS: LEC Position */ +#define CAN_STATUS_LEC_Msk (0x7ul << CAN_STATUS_LEC_Pos) /*!< CAN_T::STATUS: LEC Mask */ + +#define CAN_STATUS_TXOK_Pos (3) /*!< CAN_T::STATUS: TxOK Position */ +#define CAN_STATUS_TXOK_Msk (0x1ul << CAN_STATUS_TXOK_Pos) /*!< CAN_T::STATUS: TxOK Mask */ + +#define CAN_STATUS_RXOK_Pos (4) /*!< CAN_T::STATUS: RxOK Position */ +#define CAN_STATUS_RXOK_Msk (0x1ul << CAN_STATUS_RXOK_Pos) /*!< CAN_T::STATUS: RxOK Mask */ + +#define CAN_STATUS_EPASS_Pos (5) /*!< CAN_T::STATUS: EPass Position */ +#define CAN_STATUS_EPASS_Msk (0x1ul << CAN_STATUS_EPASS_Pos) /*!< CAN_T::STATUS: EPass Mask */ + +#define CAN_STATUS_EWARN_Pos (6) /*!< CAN_T::STATUS: EWarn Position */ +#define CAN_STATUS_EWARN_Msk (0x1ul << CAN_STATUS_EWARN_Pos) /*!< CAN_T::STATUS: EWarn Mask */ + +#define CAN_STATUS_BOFF_Pos (7) /*!< CAN_T::STATUS: BOff Position */ +#define CAN_STATUS_BOFF_Msk (0x1ul << CAN_STATUS_BOFF_Pos) /*!< CAN_T::STATUS: BOff Mask */ + +#define CAN_ERR_TEC_Pos (0) /*!< CAN_T::ERR: TEC Position */ +#define CAN_ERR_TEC_Msk (0xfful << CAN_ERR_TEC_Pos) /*!< CAN_T::ERR: TEC Mask */ + +#define CAN_ERR_REC_Pos (8) /*!< CAN_T::ERR: REC Position */ +#define CAN_ERR_REC_Msk (0x7ful << CAN_ERR_REC_Pos) /*!< CAN_T::ERR: REC Mask */ + +#define CAN_ERR_RP_Pos (15) /*!< CAN_T::ERR: RP Position */ +#define CAN_ERR_RP_Msk (0x1ul << CAN_ERR_RP_Pos) /*!< CAN_T::ERR: RP Mask */ + +#define CAN_BTIME_BRP_Pos (0) /*!< CAN_T::BTIME: BRP Position */ +#define CAN_BTIME_BRP_Msk (0x3ful << CAN_BTIME_BRP_Pos) /*!< CAN_T::BTIME: BRP Mask */ + +#define CAN_BTIME_SJW_Pos (6) /*!< CAN_T::BTIME: SJW Position */ +#define CAN_BTIME_SJW_Msk (0x3ul << CAN_BTIME_SJW_Pos) /*!< CAN_T::BTIME: SJW Mask */ + +#define CAN_BTIME_TSEG1_Pos (8) /*!< CAN_T::BTIME: TSeg1 Position */ +#define CAN_BTIME_TSEG1_Msk (0xful << CAN_BTIME_TSEG1_Pos) /*!< CAN_T::BTIME: TSeg1 Mask */ + +#define CAN_BTIME_TSEG2_Pos (12) /*!< CAN_T::BTIME: TSeg2 Position */ +#define CAN_BTIME_TSEG2_Msk (0x7ul << CAN_BTIME_TSEG2_Pos) /*!< CAN_T::BTIME: TSeg2 Mask */ + +#define CAN_IIDR_IntId_Pos (0) /*!< CAN_T::IIDR: IntId Position */ +#define CAN_IIDR_IntId_Msk (0xfffful << CAN_IIDR_IntId_Pos) /*!< CAN_T::IIDR: IntId Mask */ + +#define CAN_TEST_BASIC_Pos (2) /*!< CAN_T::TEST: Basic Position */ +#define CAN_TEST_BASIC_Msk (0x1ul << CAN_TEST_BASIC_Pos) /*!< CAN_T::TEST: Basic Mask */ + +#define CAN_TEST_SILENT_Pos (3) /*!< CAN_T::TEST: Silent Position */ +#define CAN_TEST_SILENT_Msk (0x1ul << CAN_TEST_SILENT_Pos) /*!< CAN_T::TEST: Silent Mask */ + +#define CAN_TEST_LBACK_Pos (4) /*!< CAN_T::TEST: LBack Position */ +#define CAN_TEST_LBACK_Msk (0x1ul << CAN_TEST_LBACK_Pos) /*!< CAN_T::TEST: LBack Mask */ + +#define CAN_TEST_Tx_Pos (5) /*!< CAN_T::TEST: Tx Position */ +#define CAN_TEST_Tx_Msk (0x3ul << CAN_TEST_Tx_Pos) /*!< CAN_T::TEST: Tx Mask */ + +#define CAN_TEST_Rx_Pos (7) /*!< CAN_T::TEST: Rx Position */ +#define CAN_TEST_Rx_Msk (0x1ul << CAN_TEST_Rx_Pos) /*!< CAN_T::TEST: Rx Mask */ + +#define CAN_BRPE_BRPE_Pos (0) /*!< CAN_T::BRPE: BRPE Position */ +#define CAN_BRPE_BRPE_Msk (0xful << CAN_BRPE_BRPE_Pos) /*!< CAN_T::BRPE: BRPE Mask */ + +#define CAN_IF_CREQ_MSGNUM_Pos (0) /*!< CAN_IF_T::CREQ: MessageNumber Position*/ +#define CAN_IF_CREQ_MSGNUM_Msk (0x3ful << CAN_IF_CREQ_MSGNUM_Pos) /*!< CAN_IF_T::CREQ: MessageNumber Mask */ + +#define CAN_IF_CREQ_BUSY_Pos (15) /*!< CAN_IF_T::CREQ: Busy Position */ +#define CAN_IF_CREQ_BUSY_Msk (0x1ul << CAN_IF_CREQ_BUSY_Pos) /*!< CAN_IF_T::CREQ: Busy Mask */ + +#define CAN_IF_CMASK_DATAB_Pos (0) /*!< CAN_IF_T::CMASK: DAT_B Position */ +#define CAN_IF_CMASK_DATAB_Msk (0x1ul << CAN_IF_CMASK_DATAB_Pos) /*!< CAN_IF_T::CMASK: DAT_B Mask */ + +#define CAN_IF_CMASK_DATAA_Pos (1) /*!< CAN_IF_T::CMASK: DAT_A Position */ +#define CAN_IF_CMASK_DATAA_Msk (0x1ul << CAN_IF_CMASK_DATAA_Pos) /*!< CAN_IF_T::CMASK: DAT_A Mask */ + +#define CAN_IF_CMASK_TXRQSTNEWDAT_Pos (2) /*!< CAN_IF_T::CMASK: TxRqst_NewDat Position*/ +#define CAN_IF_CMASK_TXRQSTNEWDAT_Msk (0x1ul << CAN_IF_CMASK_TXRQSTNEWDAT_Pos) /*!< CAN_IF_T::CMASK: TxRqst_NewDat Mask */ + +#define CAN_IF_CMASK_CLRINTPND_Pos (3) /*!< CAN_IF_T::CMASK: ClrIntPnd Position */ +#define CAN_IF_CMASK_CLRINTPND_Msk (0x1ul << CAN_IF_CMASK_CLRINTPND_Pos) /*!< CAN_IF_T::CMASK: ClrIntPnd Mask */ + +#define CAN_IF_CMASK_CONTROL_Pos (4) /*!< CAN_IF_T::CMASK: Control Position */ +#define CAN_IF_CMASK_CONTROL_Msk (0x1ul << CAN_IF_CMASK_CONTROL_Pos) /*!< CAN_IF_T::CMASK: Control Mask */ + +#define CAN_IF_CMASK_ARB_Pos (5) /*!< CAN_IF_T::CMASK: Arb Position */ +#define CAN_IF_CMASK_ARB_Msk (0x1ul << CAN_IF_CMASK_ARB_Pos) /*!< CAN_IF_T::CMASK: Arb Mask */ + +#define CAN_IF_CMASK_MASK_Pos (6) /*!< CAN_IF_T::CMASK: Mask Position */ +#define CAN_IF_CMASK_MASK_Msk (0x1ul << CAN_IF_CMASK_MASK_Pos) /*!< CAN_IF_T::CMASK: Mask Mask */ + +#define CAN_IF_CMASK_WRRD_Pos (7) /*!< CAN_IF_T::CMASK: WR_RD Position */ +#define CAN_IF_CMASK_WRRD_Msk (0x1ul << CAN_IF_CMASK_WRRD_Pos) /*!< CAN_IF_T::CMASK: WR_RD Mask */ + +#define CAN_IF_MASK1_Msk_Pos (0) /*!< CAN_IF_T::MASK1: Msk Position */ +#define CAN_IF_MASK1_Msk_Msk (0xfffful << CAN_IF_MASK1_Msk_Pos) /*!< CAN_IF_T::MASK1: Msk Mask */ + +#define CAN_IF_MASK2_Msk_Pos (0) /*!< CAN_IF_T::MASK2: Msk Position */ +#define CAN_IF_MASK2_Msk_Msk (0x1ffful << CAN_IF_MASK2_Msk_Pos) /*!< CAN_IF_T::MASK2: Msk Mask */ + +#define CAN_IF_MASK2_MDIR_Pos (14) /*!< CAN_IF_T::MASK2: MDir Position */ +#define CAN_IF_MASK2_MDIR_Msk (0x1ul << CAN_IF_MASK2_MDIR_Pos) /*!< CAN_IF_T::MASK2: MDir Mask */ + +#define CAN_IF_MASK2_MXTD_Pos (15) /*!< CAN_IF_T::MASK2: MXtd Position */ +#define CAN_IF_MASK2_MXTD_Msk (0x1ul << CAN_IF_MASK2_MXTD_Pos) /*!< CAN_IF_T::MASK2: MXtd Mask */ + +#define CAN_IF_ARB1_ID_Pos (0) /*!< CAN_IF_T::ARB1: ID Position */ +#define CAN_IF_ARB1_ID_Msk (0xfffful << CAN_IF_ARB1_ID_Pos) /*!< CAN_IF_T::ARB1: ID Mask */ + +#define CAN_IF_ARB2_ID_Pos (0) /*!< CAN_IF_T::ARB2: ID Position */ +#define CAN_IF_ARB2_ID_Msk (0x1ffful << CAN_IF_ARB2_ID_Pos) /*!< CAN_IF_T::ARB2: ID Mask */ + +#define CAN_IF_ARB2_DIR_Pos (13) /*!< CAN_IF_T::ARB2: Dir Position */ +#define CAN_IF_ARB2_DIR_Msk (0x1ul << CAN_IF_ARB2_DIR_Pos) /*!< CAN_IF_T::ARB2: Dir Mask */ + +#define CAN_IF_ARB2_XTD_Pos (14) /*!< CAN_IF_T::ARB2: Xtd Position */ +#define CAN_IF_ARB2_XTD_Msk (0x1ul << CAN_IF_ARB2_XTD_Pos) /*!< CAN_IF_T::ARB2: Xtd Mask */ + +#define CAN_IF_ARB2_MSGVAL_Pos (15) /*!< CAN_IF_T::ARB2: MsgVal Position */ +#define CAN_IF_ARB2_MSGVAL_Msk (0x1ul << CAN_IF_ARB2_MSGVAL_Pos) /*!< CAN_IF_T::ARB2: MsgVal Mask */ + +#define CAN_IF_MCON_DLC_Pos (0) /*!< CAN_IF_T::MCON: DLC Position */ +#define CAN_IF_MCON_DLC_Msk (0xful << CAN_IF_MCON_DLC_Pos) /*!< CAN_IF_T::MCON: DLC Mask */ + +#define CAN_IF_MCON_EOB_Pos (7) /*!< CAN_IF_T::MCON: EoB Position */ +#define CAN_IF_MCON_EOB_Msk (0x1ul << CAN_IF_MCON_EOB_Pos) /*!< CAN_IF_T::MCON: EoB Mask */ + +#define CAN_IF_MCON_TxRqst_Pos (8) /*!< CAN_IF_T::MCON: TxRqst Position */ +#define CAN_IF_MCON_TxRqst_Msk (0x1ul << CAN_IF_MCON_TxRqst_Pos) /*!< CAN_IF_T::MCON: TxRqst Mask */ + +#define CAN_IF_MCON_RmtEn_Pos (9) /*!< CAN_IF_T::MCON: RmtEn Position */ +#define CAN_IF_MCON_RmtEn_Msk (0x1ul << CAN_IF_MCON_RmtEn_Pos) /*!< CAN_IF_T::MCON: RmtEn Mask */ + +#define CAN_IF_MCON_RXIE_Pos (10) /*!< CAN_IF_T::MCON: RxIE Position */ +#define CAN_IF_MCON_RXIE_Msk (0x1ul << CAN_IF_MCON_RXIE_Pos) /*!< CAN_IF_T::MCON: RxIE Mask */ + +#define CAN_IF_MCON_TXIE_Pos (11) /*!< CAN_IF_T::MCON: TxIE Position */ +#define CAN_IF_MCON_TXIE_Msk (0x1ul << CAN_IF_MCON_TXIE_Pos) /*!< CAN_IF_T::MCON: TxIE Mask */ + +#define CAN_IF_MCON_UMASK_Pos (12) /*!< CAN_IF_T::MCON: UMask Position */ +#define CAN_IF_MCON_UMASK_Msk (0x1ul << CAN_IF_MCON_UMASK_Pos) /*!< CAN_IF_T::MCON: UMask Mask */ + +#define CAN_IF_MCON_IntPnd_Pos (13) /*!< CAN_IF_T::MCON: IntPnd Position */ +#define CAN_IF_MCON_IntPnd_Msk (0x1ul << CAN_IF_MCON_IntPnd_Pos) /*!< CAN_IF_T::MCON: IntPnd Mask */ + +#define CAN_IF_MCON_MsgLst_Pos (14) /*!< CAN_IF_T::MCON: MsgLst Position */ +#define CAN_IF_MCON_MsgLst_Msk (0x1ul << CAN_IF_MCON_MsgLst_Pos) /*!< CAN_IF_T::MCON: MsgLst Mask */ + +#define CAN_IF_MCON_NEWDAT_Pos (15) /*!< CAN_IF_T::MCON: NewDat Position */ +#define CAN_IF_MCON_NEWDAT_Msk (0x1ul << CAN_IF_MCON_NEWDAT_Pos) /*!< CAN_IF_T::MCON: NewDat Mask */ + +#define CAN_IF_DAT_A1_DATA0_Pos (0) /*!< CAN_IF_T::DAT_A1: Data_0_ Position */ +#define CAN_IF_DAT_A1_DATA0_Msk (0xfful << CAN_IF_DAT_A1_DATA0_Pos) /*!< CAN_IF_T::DAT_A1: Data_0_ Mask */ + +#define CAN_IF_DAT_A1_DATA1_Pos (8) /*!< CAN_IF_T::DAT_A1: Data_1_ Position */ +#define CAN_IF_DAT_A1_DATA1_Msk (0xfful << CAN_IF_DAT_A1_DATA1_Pos) /*!< CAN_IF_T::DAT_A1: Data_1_ Mask */ + +#define CAN_IF_DAT_A2_DATA2_Pos (0) /*!< CAN_IF_T::DAT_A2: Data_2_ Position */ +#define CAN_IF_DAT_A2_DATA2_Msk (0xfful << CAN_IF_DAT_A2_DATA2_Pos) /*!< CAN_IF_T::DAT_A2: Data_2_ Mask */ + +#define CAN_IF_DAT_A2_DATA3_Pos (8) /*!< CAN_IF_T::DAT_A2: Data_3_ Position */ +#define CAN_IF_DAT_A2_DATA3_Msk (0xfful << CAN_IF_DAT_A2_DATA3_Pos) /*!< CAN_IF_T::DAT_A2: Data_3_ Mask */ + +#define CAN_IF_DAT_B1_DATA4_Pos (0) /*!< CAN_IF_T::DAT_B1: Data_4_ Position */ +#define CAN_IF_DAT_B1_DATA4_Msk (0xfful << CAN_IF_DAT_B1_DATA4_Pos) /*!< CAN_IF_T::DAT_B1: Data_4_ Mask */ + +#define CAN_IF_DAT_B1_DATA5_Pos (8) /*!< CAN_IF_T::DAT_B1: Data_5_ Position */ +#define CAN_IF_DAT_B1_DATA5_Msk (0xfful << CAN_IF_DAT_B1_DATA5_Pos) /*!< CAN_IF_T::DAT_B1: Data_5_ Mask */ + +#define CAN_IF_DAT_B2_DATA6_Pos (0) /*!< CAN_IF_T::DAT_B2: Data_6_ Position */ +#define CAN_IF_DAT_B2_DATA6_Msk (0xfful << CAN_IF_DAT_B2_DATA6_Pos) /*!< CAN_IF_T::DAT_B2: Data_6_ Mask */ + +#define CAN_IF_DAT_B2_DATA7_Pos (8) /*!< CAN_IF_T::DAT_B2: Data_7_ Position */ +#define CAN_IF_DAT_B2_DATA7_Msk (0xfful << CAN_IF_DAT_B2_DATA7_Pos) /*!< CAN_IF_T::DAT_B2: Data_7_ Mask */ + +#define CAN_TXREQ1_TXRQST16_1_Pos (0) /*!< CAN_T::TXREQ1: TxRqst16_1 Position */ +#define CAN_TXREQ1_TXRQST16_1_Msk (0xfffful << CAN_TXREQ1_TXRQST16_1_Pos) /*!< CAN_T::TXREQ1: TxRqst16_1 Mask */ + +#define CAN_TXREQ2_TXRQST32_17_Pos (0) /*!< CAN_T::TXREQ2: TxRqst32_17 Position */ +#define CAN_TXREQ2_TXRQST32_17_Msk (0xfffful << CAN_TXREQ2_TXRQST32_17_Pos) /*!< CAN_T::TXREQ2: TxRqst32_17 Mask */ + +#define CAN_NDAT1_NewData16_1_Pos (0) /*!< CAN_T::NDAT1: NewData16_1 Position */ +#define CAN_NDAT1_NewData16_1_Msk (0xfffful << CAN_NDAT1_NewData16_1_Pos) /*!< CAN_T::NDAT1: NewData16_1 Mask */ + +#define CAN_NDAT2_NewData32_17_Pos (0) /*!< CAN_T::NDAT2: NewData32_17 Position */ +#define CAN_NDAT2_NewData32_17_Msk (0xfffful << CAN_NDAT2_NewData32_17_Pos) /*!< CAN_T::NDAT2: NewData32_17 Mask */ + +#define CAN_IPND1_IntPnd16_1_Pos (0) /*!< CAN_T::IPND1: IntPnd16_1 Position */ +#define CAN_IPND1_IntPnd16_1_Msk (0xfffful << CAN_IPND1_IntPnd16_1_Pos) /*!< CAN_T::IPND1: IntPnd16_1 Mask */ + +#define CAN_IPND2_IntPnd32_17_Pos (0) /*!< CAN_T::IPND2: IntPnd32_17 Position */ +#define CAN_IPND2_IntPnd32_17_Msk (0xfffful << CAN_IPND2_IntPnd32_17_Pos) /*!< CAN_T::IPND2: IntPnd32_17 Mask */ + +#define CAN_MVLD1_MsgVal16_1_Pos (0) /*!< CAN_T::MVLD1: MsgVal16_1 Position */ +#define CAN_MVLD1_MsgVal16_1_Msk (0xfffful << CAN_MVLD1_MsgVal16_1_Pos) /*!< CAN_T::MVLD1: MsgVal16_1 Mask */ + +#define CAN_MVLD2_MsgVal32_17_Pos (0) /*!< CAN_T::MVLD2: MsgVal32_17 Position */ +#define CAN_MVLD2_MsgVal32_17_Msk (0xfffful << CAN_MVLD2_MsgVal32_17_Pos) /*!< CAN_T::MVLD2: MsgVal32_17 Mask */ + +#define CAN_WU_EN_WAKUP_EN_Pos (0) /*!< CAN_T::WU_EN: WAKUP_EN Position */ +#define CAN_WU_EN_WAKUP_EN_Msk (0x1ul << CAN_WU_EN_WAKUP_EN_Pos) /*!< CAN_T::WU_EN: WAKUP_EN Mask */ + +#define CAN_WU_STATUS_WAKUP_STS_Pos (0) /*!< CAN_T::WU_STATUS: WAKUP_STS Position */ +#define CAN_WU_STATUS_WAKUP_STS_Msk (0x1ul << CAN_WU_STATUS_WAKUP_STS_Pos) /*!< CAN_T::WU_STATUS: WAKUP_STS Mask */ + +/**@}*/ /* CAN_CONST */ +/**@}*/ /* end of CAN register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __CAN_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/ccap_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/ccap_reg.h new file mode 100644 index 00000000000..3798f50b96e --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/ccap_reg.h @@ -0,0 +1,496 @@ +/**************************************************************************//** + * @file ccap_reg.h + * @version V1.00 + * @brief CCAP register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __CCAP_REG_H__ +#define __CCAP_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup CCAP Camera Capture Interface Controller (CCAP) + Memory Mapped Structure for CCAP Controller +@{ */ + + +typedef struct { + + + /** + * @var CCAP_T::CTL + * Offset: 0x00 Camera Capture Interface Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CCAPEN |Camera Capture Interface Enable + * | | |0 = Camera Capture Interface Disabled. + * | | |1 = Camera Capture Interface Enabled. + * |[3] |ADDRSW |Packet Buffer Address Switch + * | | |0 = Packet buffer address switch Disabled. + * | | |1 = Packet buffer address switch Enabled. + * |[6] |PKTEN |Packet Output Enable + * | | |0 = Packet output Disabled. + * | | |1 = Packet output Enabled. + * |[7] |MONO |Monochrome CMOS Sensor Select + * | | |0 = Color CMOS Sensor. + * | | |1 = Monochrome CMOS Sensor. The U/V components are ignored when the MONO is enabled. + * |[16] |SHUTTER |Image Capture Interface Automatically Disable The Capture Interface After A Frame Had Been Captured + * | | |0 = Shutter Disabled. + * | | |1 = Shutter Enabled. + * |[20] |UPDATE |Update Register At New Frame + * | | |0 = Update register at new frame Disabled. + * | | |1 = Update register at new frame Enabled (Auto clear to 0 when register updated). + * |[24] |VPRST |Capture Interface Reset + * | | |0 = Capture interface reset Disabled. + * | | |1 = Capture interface reset Enabled. + * @var CCAP_T::PAR + * Offset: 0x04 Camera Capture Interface Parameter Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |INFMT |Sensor Input Data Format + * | | |0 = YCbCr422. + * | | |1 = RGB565. + * |[1] |SENTYPE |Sensor Input Type + * | | |0 = CCIR601. + * | | |1 = CCIR656, VSync & Hsync embedded in the data signal. + * |[2:3] |INDATORD |Sensor Input Data Order + * | | |If INFMT = 0 (YCbCr),. + * | | | Byte 0 1 2 3 + * | | |00 = Y0 U0 Y1 V0. + * | | |01 = Y0 V0 Y1 U0. + * | | |10 = U0 Y0 V0 Y1. + * | | |11 = V0 Y0 U0 Y1. + * | | |If INFMT = 1 (RGB565),. + * | | |00 = Byte0[R[4:0] G[5:3]] Byte1[G[2:0] B[4:0]] + * | | |01 = Byte0[B[4:0] G[5:3]] Byte1[G[2:0] R[4:0]] + * | | |10 = Byte0[G[2:0] B[4:0]] Byte1[R[4:0] G[5:3]] + * | | |11 = Byte0[G[2:0] R[4:0]] Byte1[B[4:0] G[5:3]] + * |[4:5] |OUTFMT |Image Data Format Output To System Memory + * | | |00 = YCbCr422. + * | | |01 = Only output Y. + * | | |10 = RGB555. + * | | |11 = RGB565. + * |[6] |RANGE |Scale Input YUV CCIR601 Color Range To Full Range + * | | |0 = default. + * | | |1 = Scale to full range. + * |[8] |PCLKP |Sensor Pixel Clock Polarity + * | | |0 = Input video data and signals are latched by falling edge of Pixel Clock. + * | | |1 = Input video data and signals are latched by rising edge of Pixel Clock. + * |[9] |HSP |Sensor Hsync Polarity + * | | |0 = Sync Low. + * | | |1 = Sync High. + * |[10] |VSP |Sensor Vsync Polarity + * | | |0 = Sync Low. + * | | |1 = Sync High. + * |[18] |FBB |Field By Blank + * | | |Hardware will tag field0 or field1 by vertical blanking instead of FIELD flag in CCIR-656 mode. + * | | |0 = Field by blank Disabled. + * | | |1 = Field by blank Enabled. + * @var CCAP_T::INT + * Offset: 0x08 Camera Capture Interface Interrupt Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |VINTF |Video Frame End Interrupt + * | | |If this bit shows 1, receiving a frame completed. + * | | |Write 1 to clear it. + * |[1] |MEINTF |Bus Master Transfer Error Interrupt + * | | |If this bit shows 1, Transfer Error occurred. Write 1 to clear it. + * |[3] |ADDRMINTF |Memory Address Match Interrupt + * | | |If this bit shows 1, Memory Address Match Interrupt occurred. + * | | |Write 1 to clear it. + * |[4] |MDINTF |Motion Detection Output Finish Interrupt + * | | |If this bit shows 1, Motion Detection Output Finish Interrupt occurred. + * | | |Write 1 to clear it. + * |[16] |VIEN |Video Frame End Interrupt Enable + * | | |0 = Video frame end interrupt Disabled. + * | | |1 = Video frame end interrupt Enabled. + * |[17] |MEIEN |System Memory Error Interrupt Enable + * | | |0 = System memory error interrupt Disabled. + * | | |1 = System memory error interrupt Enabled. + * |[19] |ADDRMIEN |Address Match Interrupt Enable + * | | |0 = Address match interrupt Disabled. + * | | |1 = Address match interrupt Enabled. + * @var CCAP_T::POSTERIZE + * Offset: 0x0C YUV Component Posterizing Factor Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0:7] |VCOMP |V Component Posterizing Factor + * | | |Final_V_Out = Original_V[7:0] & V_Posterizing_Factor. + * |[8:15] |UCOMP |U Component Posterizing Factor + * | | |Final_U_Out = Original_U[7:0] & U_Posterizing_Factor. + * |[16:23] |YCOMP |Y Component Posterizing Factor + * | | |Final_Y_Out = Original_Y[7:0] & Y_Posterizing_Factor. + * @var CCAP_T::MD + * Offset: 0x10 Motion Detection Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |MDEN |Motion Detection Enable + * | | |0 = CCAP_MD Disabled. + * | | |1 = CCAP_MD Enabled. + * |[8] |MDBS |Motion Detection Block Size + * | | |0 = 16x16. + * | | |1 = 8x8. + * |[9] |MDSM |Motion Detection Save Mode + * | | |0 = 1 bit DIFF + 7 bit Y Differential. + * | | |1 = 1 bit DIFF only. + * |[10:11] |MDDF |Motion Detection Detect Frequency + * | | |00 = Each frame. + * | | |01 = Every 2 frame. + * | | |10 = Every 3 frame. + * | | |11 = Every 4 frame. + * |[16:20] |MDTHR |Motion Detection Differential Threshold + * @var CCAP_T::MDADDR + * Offset: 0x14 Motion Detection Output Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0:31] |MDADDR |Motion Detection Output Address Register (Word Alignment) + * @var CCAP_T::MDYADDR + * Offset: 0x18 Motion Detection Temp Y Output Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0:31] |MDYADDR |Motion Detection Temp Y Output Address Register (Word Alignment) + * @var CCAP_T::SEPIA + * Offset: 0x1C Sepia Effect Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0:7] |VCOMP |Define the constant V component while Sepia color effect is turned on. + * |[8:15] |UCOMP |Define the constant U component while Sepia color effect is turned on. + * @var CCAP_T::CWSP + * Offset: 0x20 Cropping Window Starting Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0:11] |CWSADDRH |Cropping Window Horizontal Starting Address + * |[16:26] |CWSADDRV |Cropping Window Vertical Starting Address + * @var CCAP_T::CWS + * Offset: 0x24 Cropping Window Size Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0:11] |CIWW |Cropping Image Window Width + * |[16:26] |CIWH |Cropping Image Window Height + * @var CCAP_T::PKTSL + * Offset: 0x28 Packet Scaling Vertical/Horizontal Factor Register (LSB) + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0:7] |PKTSHML |Packet Scaling Horizontal Factor M (Lower 8-Bit) + * | | |Specifies the lower 8-bit of denominator part (M) of the horizontal scaling factor. + * | | |The lower 8-bit will be cascaded with higher 8-bit (PKDSHMH) to form a 16-bit denominator (M) of vertical factor. + * | | |The output image width will be equal to the image width * N/M. + * | | |Note: The value of N must be equal to or less than M. + * |[8:15] |PKTSHNL |Packet Scaling Horizontal Factor N (Lower 8-Bit) + * | | |Specify the lower 8-bit of numerator part (N) of the horizontal scaling factor. + * | | |The lower 8-bit will be cascaded with higher 8-bit (PKDSHNH) to form a 16-bit numerator of horizontal factor. + * |[16:23] |PKTSVML |Packet Scaling Vertical Factor M (Lower 8-Bit) + * | | |Specify the lower 8-bit of denominator part (M) of the vertical scaling factor. + * | | |The lower 8-bit will be cascaded with higher 8-bit (PKDSVMH) to form a 16-bit denominator (M) of vertical factor. + * | | |The output image width will be equal to the image height * N/M. + * | | |Note: The value of N must be equal to or less than M. + * |[24:31] |PKTSVNL |Packet Scaling Vertical Factor N (Lower 8-Bit) + * | | |Specify the lower 8-bit of numerator part (N) of the vertical scaling factor. + * | | |The lower 8-bit will be cascaded with higher 8-bit (PKDSVNH) to form a 16-bit numerator of vertical factor + * @var CCAP_T::PLNSL + * Offset: 0x2C Planar Scaling Vertical/Horizontal Factor Register (LSB) + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0:7] |PLNSHML |Planar Scaling Horizontal Factor M (Lower 8-Bit) + * | | |Specify the lower 8-bit of denominator part (M) of the horizontal scaling factor. + * | | |The lower 8-bit will be cascaded with higher 8-bit (PNDSHMH) to form a 16-bit denominator (M) of vertical factor. + * | | |The output image width will be equal to the image width * N/M. + * | | |Note: The value of N must be equal to or less than M. + * |[8:15] |PLNSHNL |Planar Scaling Horizontal Factor N (Lower 8-Bit) + * | | |Specify the lower 8-bit of numerator part (N) of the horizontal scaling factor. + * | | |The lower 8-bit will be cascaded with higher 8-bit (PNDSHNH) to form a 16-bit numerator of horizontal factor. + * |[16:23] |PLNSVML |Planar Scaling Vertical Factor M (Lower 8-Bit) + * | | |Specify the lower 8-bit of denominator part (M) of the vertical scaling factor. + * | | |The lower 8-bit will be cascaded with higher 8-bit (PNDSVMH) to form a 16-bit denominator (M) of vertical factor. + * | | |The output image width will be equal to the image height * N/M. + * | | |Note: The value of N must be equal to or less than M. + * |[24:31] |PLNSVNL |Planar Scaling Vertical Factor N (Lower 8-Bit) + * | | |Specify the lower 8-bit of numerator part (N) of the vertical scaling factor. + * | | |The lower 8-bit will be cascaded with higher 8-bit (PNDSVNH) to form a 16-bit numerator of vertical factor. + * @var CCAP_T::FRCTL + * Offset: 0x30 Scaling Frame Rate Factor Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0:5] |FRM |Scaling Frame Rate Factor M + * | | |Specify the denominator part (M) of the frame rate scaling factor. + * | | |The output image frame rate will be equal to input image frame rate * (N/M). + * | | |Note: The value of N must be equal to or less than M. + * |[8:13] |FRN |Scaling Frame Rate Factor N + * | | |Specify the denominator part (N) of the frame rate scaling factor. + * @var CCAP_T::STRIDE + * Offset: 0x34 Frame Output Pixel Stride Width Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0:13] |PKTSTRIDE |Packet Frame Output Pixel Stride Width + * | | |The output pixel stride size of packet pipe. + * |[16:29] |PLNSTRIDE |Planar Frame Output Pixel Stride Width + * | | |The output pixel stride size of planar pipe. + * @var CCAP_T::FIFOTH + * Offset: 0x3C FIFO Threshold Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0:3] |PLNVFTH |Planar V FIFO Threshold + * |[8:11] |PLNUFTH |Planar U FIFO Threshold + * |[16:20] |PLNYFTH |Planar Y FIFO Threshold + * |[24:28] |PKTFTH |Packet FIFO Threshold + * |[31] |OVF |FIFO Overflow Flag + * @var CCAP_T::CMPADDR + * Offset: 0x40 Compare Memory Base Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0:31] |CMPADDR |Compare Memory Base Address + * | | |Word aligns address; ignore the bits [1:0]. + * @var CCAP_T::LUMA_Y1_THD + * Offset: 0x44 Luminance Y8 to Y1 Threshold Value Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :-----------: | :---- | + * |[0:8] |LUMA_Y1_THRESH |Luminance Y8 to Y1 Threshold Value + * | | |Specify the 8-bit threshold value for the luminance Y bit-8 to the luminance Y 1-bit conversion. + * @var CCAP_T::PKTSM + * Offset: 0x48 Packet Scaling Vertical/Horizontal Factor Register (MSB) + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0:7] |PKTSHMH |Packet Scaling Horizontal Factor M (Higher 8-Bit) + * | | |Specify the lower 8-bit of denominator part (M) of the horizontal scaling factor. + * | | |Please refer to the register CCAP_PKTSL?for the detailed operation. + * |[8:15] |PKTSHNH |Packet Scaling Horizontal Factor N (Higher 8-Bit) + * | | |Specify the lower 8-bit of numerator part (N) of the horizontal scaling factor. + * | | |Please refer to the register CCAP_PKTSL for the detailed operation. + * |[16:23] |PKTSVMH |Packet Scaling Vertical Factor M (Higher 8-Bit) + * | | |Specify the lower 8-bit of denominator part (M) of the vertical scaling factor. + * | | |Please refer to the register CCAP_PKTSL to check the cooperation between these two registers. + * |[24:31] |PKTSVNH |Packet Scaling Vertical Factor N (Higher 8-Bit) + * | | |Specify the higher 8-bit of numerator part (N) of the vertical scaling factor. + * | | |Please refer to the register CCAP_PKTSL?to check the cooperation between these two registers. + * @var CCAP_T::PKTBA0 + * Offset: 0x60 System Memory Packet Base Address 0 Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0:31] |BASEADDR |System Memory Packet Base Address 0 + * | | |Word aligns address; ignore the bits [1:0]. + */ + __IO uint32_t CTL; + __IO uint32_t PAR; + __IO uint32_t INT; + __IO uint32_t POSTERIZE; + __IO uint32_t MD; + __IO uint32_t MDADDR; + __IO uint32_t MDYADDR; + __IO uint32_t SEPIA; + __IO uint32_t CWSP; + __IO uint32_t CWS; + __IO uint32_t PKTSL; + __IO uint32_t PLNSL; + __IO uint32_t FRCTL; + __IO uint32_t STRIDE; + /// @cond HIDDEN_SYMBOLS + uint32_t RESERVE0[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t FIFOTH; + __IO uint32_t CMPADDR; + __IO uint32_t LUMA_Y1_THD; + __IO uint32_t PKTSM; + /// @cond HIDDEN_SYMBOLS + uint32_t RESERVE2[5]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t PKTBA0; +} CCAP_T; + +/** + @addtogroup CCAP_CONST CCAP Bit Field Definition + Constant Definitions for CCAP Controller +@{ */ + +#define CCAP_CTL_CCAPEN_Pos (0) /*!< CCAP_T::CTL: CCAPEN Position */ +#define CCAP_CTL_CCAPEN_Msk (0x1ul << CCAP_CTL_CCAPEN_Pos) /*!< CCAP_T::CTL: CCAPEN Mask */ + +#define CCAP_CTL_ADDRSW_Pos (3) /*!< CCAP_T::CTL: ADDRSW Position */ +#define CCAP_CTL_ADDRSW_Msk (0x1ul << CCAP_CTL_ADDRSW_Pos) /*!< CCAP_T::CTL: ADDRSW Mask */ + +#define CCAP_CTL_PLNEN_Pos (5) /*!< CCAP_T::CTL: PLNEN Position */ +#define CCAP_CTL_PLNEN_Msk (0x1ul << CCAP_CTL_PLNEN_Pos) /*!< CCAP_T::CTL: PLNEN Mask */ + +#define CCAP_CTL_PKTEN_Pos (6) /*!< CCAP_T::CTL: PKTEN Position */ +#define CCAP_CTL_PKTEN_Msk (0x1ul << CCAP_CTL_PKTEN_Pos) /*!< CCAP_T::CTL: PKTEN Mask */ + +#define CCAP_CTL_MONO_Pos (7) /*!< CCAP_T::CTL: MONO Position */ +#define CCAP_CTL_MONO_Msk (0x1ul << CCAP_CTL_MONO_Pos) /*!< CCAP_T::CTL: MONO Mask */ + +#define CCAP_CTL_SHUTTER_Pos (16) /*!< CCAP_T::CTL: SHUTTER Position */ +#define CCAP_CTL_SHUTTER_Msk (0x1ul << CCAP_CTL_SHUTTER_Pos) /*!< CCAP_T::CTL: SHUTTER Mask */ + +#define CCAP_CTL_MY4_SWAP_Pos (17) /*!< CCAP_T::CTL: MY4_SWAP Position */ +#define CCAP_CTL_MY4_SWAP_Msk (0x1ul << CCAP_CTL_MY4_SWAP_Pos) /*!< CCAP_T::CTL: MY4_SWAP Mask */ + +#define CCAP_CTL_MY8_MY4_Pos (18) /*!< CCAP_T::CTL: MY8_MY4 Position */ +#define CCAP_CTL_MY8_MY4_Msk (0x1ul << CCAP_CTL_MY8_MY4_Pos) /*!< CCAP_T::CTL: MY8_MY4 Mask */ + +#define CCAP_CTL_Luma_Y_One_Pos (19) /*!< CCAP_T::CTL: Luma_Y_One Position */ +#define CCAP_CTL_Luma_Y_One_Msk (0x1ul << CCAP_CTL_Luma_Y_One_Pos) /*!< CCAP_T::CTL: Luma_Y_One Mask */ + +#define CCAP_CTL_UPDATE_Pos (20) /*!< CCAP_T::CTL: UPDATE Position */ +#define CCAP_CTL_UPDATE_Msk (0x1ul << CCAP_CTL_UPDATE_Pos) /*!< CCAP_T::CTL: UPDATE Mask */ + +#define CCAP_CTL_VPRST_Pos (24) /*!< CCAP_T::CTL: VPRST Position */ +#define CCAP_CTL_VPRST_Msk (0x1ul << CCAP_CTL_VPRST_Pos) /*!< CCAP_T::CTL: VPRST Mask */ + +#define CCAP_PAR_INFMT_Pos (0) /*!< CCAP_T::PAR: INFMT Position */ +#define CCAP_PAR_INFMT_Msk (0x1ul << CCAP_PAR_INFMT_Pos) /*!< CCAP_T::PAR: INFMT Mask */ + +#define CCAP_PAR_SENTYPE_Pos (1) /*!< CCAP_T::PAR: SENTYPE Position */ +#define CCAP_PAR_SENTYPE_Msk (0x1ul << CCAP_PAR_SENTYPE_Pos) /*!< CCAP_T::PAR: SENTYPE Mask */ + +#define CCAP_PAR_INDATORD_Pos (2) /*!< CCAP_T::PAR: INDATORD Position */ +#define CCAP_PAR_INDATORD_Msk (0x3ul << CCAP_PAR_INDATORD_Pos) /*!< CCAP_T::PAR: INDATORD Mask */ + +#define CCAP_PAR_OUTFMT_Pos (4) /*!< CCAP_T::PAR: OUTFMT Position */ +#define CCAP_PAR_OUTFMT_Msk (0x3ul << CCAP_PAR_OUTFMT_Pos) /*!< CCAP_T::PAR: OUTFMT Mask */ + +#define CCAP_PAR_RANGE_Pos (6) /*!< CCAP_T::PAR: RANGE Position */ +#define CCAP_PAR_RANGE_Msk (0x1ul << CCAP_PAR_RANGE_Pos) /*!< CCAP_T::PAR: RANGE Mask */ + +#define CCAP_PAR_PLNFMT_Pos (7) /*!< CCAP_T::PAR: PLNFMT Position */ +#define CCAP_PAR_PLNFMT_Msk (0x1ul << CCAP_PAR_PLNFMT_Pos) /*!< CCAP_T::PAR: PLNFMT Mask */ + +#define CCAP_PAR_PCLKP_Pos (8) /*!< CCAP_T::PAR: PCLKP Position */ +#define CCAP_PAR_PCLKP_Msk (0x1ul << CCAP_PAR_PCLKP_Pos) /*!< CCAP_T::PAR: PCLKP Mask */ + +#define CCAP_PAR_HSP_Pos (9) /*!< CCAP_T::PAR: HSP Position */ +#define CCAP_PAR_HSP_Msk (0x1ul << CCAP_PAR_HSP_Pos) /*!< CCAP_T::PAR: HSP Mask */ + +#define CCAP_PAR_VSP_Pos (10) /*!< CCAP_T::PAR: VSP Position */ +#define CCAP_PAR_VSP_Msk (0x1ul << CCAP_PAR_VSP_Pos) /*!< CCAP_T::PAR: VSP Mask */ + +#define CCAP_PAR_COLORCTL_Pos (11) /*!< CCAP_T::PAR: COLORCTL Position */ +#define CCAP_PAR_COLORCTL_Msk (0x3ul << CCAP_PAR_COLORCTL_Pos) /*!< CCAP_T::PAR: COLORCTL Mask */ + +#define CCAP_PAR_FBB_Pos (18) /*!< CCAP_T::PAR: FBB Position */ +#define CCAP_PAR_FBB_Msk (0x1ul << CCAP_PAR_FBB_Pos) /*!< CCAP_T::PAR: FBB Mask */ + +#define CCAP_INT_VINTF_Pos (0) /*!< CCAP_T::INT: VINTF Position */ +#define CCAP_INT_VINTF_Msk (0x1ul << CCAP_INT_VINTF_Pos) /*!< CCAP_T::INT: VINTF Mask */ + +#define CCAP_INT_MEINTF_Pos (1) /*!< CCAP_T::INT: MEINTF Position */ +#define CCAP_INT_MEINTF_Msk (0x1ul << CCAP_INT_MEINTF_Pos) /*!< CCAP_T::INT: MEINTF Mask */ + +#define CCAP_INT_ADDRMINTF_Pos (3) /*!< CCAP_T::INT: ADDRMINTF Position */ +#define CCAP_INT_ADDRMINTF_Msk (0x1ul << CCAP_INT_ADDRMINTF_Pos) /*!< CCAP_T::INT: ADDRMINTF Mask */ + +#define CCAP_INT_MDINTF_Pos (4) /*!< CCAP_T::INT: MDINTF Position */ +#define CCAP_INT_MDINTF_Msk (0x1ul << CCAP_INT_MDINTF_Pos) /*!< CCAP_T::INT: MDINTF Mask */ + +#define CCAP_INT_VIEN_Pos (16) /*!< CCAP_T::INT: VIEN Position */ +#define CCAP_INT_VIEN_Msk (0x1ul << CCAP_INT_VIEN_Pos) /*!< CCAP_T::INT: VIEN Mask */ + +#define CCAP_INT_MEIEN_Pos (17) /*!< CCAP_T::INT: MEIEN Position */ +#define CCAP_INT_MEIEN_Msk (0x1ul << CCAP_INT_MEIEN_Pos) /*!< CCAP_T::INT: MEIEN Mask */ + +#define CCAP_INT_ADDRMIEN_Pos (19) /*!< CCAP_T::INT: ADDRMIEN Position */ +#define CCAP_INT_ADDRMIEN_Msk (0x1ul << CCAP_INT_ADDRMIEN_Pos) /*!< CCAP_T::INT: ADDRMIEN Mask */ + +#define CCAP_CWSP_CWSADDRH_Pos (0) /*!< CCAP_T::CWSP: CWSADDRH Position */ +#define CCAP_CWSP_CWSADDRH_Msk (0xffful << CCAP_CWSP_CWSADDRH_Pos) /*!< CCAP_T::CWSP: CWSADDRH Mask */ + +#define CCAP_CWSP_CWSADDRV_Pos (16) /*!< CCAP_T::CWSP: CWSADDRV Position */ +#define CCAP_CWSP_CWSADDRV_Msk (0x7fful << CCAP_CWSP_CWSADDRV_Pos) /*!< CCAP_T::CWSP: CWSADDRV Mask */ + +#define CCAP_CWS_CWW_Pos (0) /*!< CCAP_T::CWS: CWW Position */ +#define CCAP_CWS_CWW_Msk (0xffful << CCAP_CWS_CWW_Pos) /*!< CCAP_T::CWS: CWW Mask */ +#define CCAP_CWS_CWH_Pos (16) /*!< CCAP_T::CWS: CIWH Position */ +#define CCAP_CWS_CWH_Msk (0x7fful << CCAP_CWS_CWH_Pos) /*!< CCAP_T::CWS: CIWH Mask */ + +#define CCAP_PKTSL_PKTSHML_Pos (0) /*!< CCAP_T::PKTSL: PKTSHML Position */ +#define CCAP_PKTSL_PKTSHML_Msk (0xfful << CCAP_PKTSL_PKTSHML_Pos) /*!< CCAP_T::PKTSL: PKTSHML Mask */ + +#define CCAP_PKTSL_PKTSHNL_Pos (8) /*!< CCAP_T::PKTSL: PKTSHNL Position */ +#define CCAP_PKTSL_PKTSHNL_Msk (0xfful << CCAP_PKTSL_PKTSHNL_Pos) /*!< CCAP_T::PKTSL: PKTSHNL Mask */ + +#define CCAP_PKTSL_PKTSVML_Pos (16) /*!< CCAP_T::PKTSL: PKTSVML Position */ +#define CCAP_PKTSL_PKTSVML_Msk (0xfful << CCAP_PKTSL_PKTSVML_Pos) /*!< CCAP_T::PKTSL: PKTSVML Mask */ + +#define CCAP_PKTSL_PKTSVNL_Pos (24) /*!< CCAP_T::PKTSL: PKTSVNL Position */ +#define CCAP_PKTSL_PKTSVNL_Msk (0xfful << CCAP_PKTSL_PKTSVNL_Pos) /*!< CCAP_T::PKTSL: PKTSVNL Mask */ + +#define CCAP_FRCTL_FRM_Pos (0) /*!< CCAP_T::FRCTL: FRM Position */ +#define CCAP_FRCTL_FRM_Msk (0x3ful << CCAP_FRCTL_FRM_Pos) /*!< CCAP_T::FRCTL: FRM Mask */ + +#define CCAP_FRCTL_FRN_Pos (8) /*!< CCAP_T::FRCTL: FRN Position */ +#define CCAP_FRCTL_FRN_Msk (0x3ful << CCAP_FRCTL_FRN_Pos) /*!< CCAP_T::FRCTL: FRN Mask */ + +#define CCAP_STRIDE_PKTSTRIDE_Pos (0) /*!< CCAP_T::STRIDE: PKTSTRIDE Position */ +#define CCAP_STRIDE_PKTSTRIDE_Msk (0x3ffful << CCAP_STRIDE_PKTSTRIDE_Pos) /*!< CCAP_T::STRIDE: PKTSTRIDE Mask */ + +#define CCAP_STRIDE_PLNSTRIDE_Pos (16) /*!< CCAP_T::STRIDE: PLNSTRIDE Position */ +#define CCAP_STRIDE_PLNSTRIDE_Msk (0x3ffful << CCAP_STRIDE_PLNSTRIDE_Pos) /*!< CCAP_T::STRIDE: PLNSTRIDE Mask */ + +#define CCAP_FIFOTH_PLNVFTH_Pos (0) /*!< CCAP_T::FIFOTH: PLNVFTH Position */ +#define CCAP_FIFOTH_PLNVFTH_Msk (0xful << CCAP_FIFOTH_PLNVFTH_Pos) /*!< CCAP_T::FIFOTH: PLNVFTH Mask */ + +#define CCAP_FIFOTH_PLNUFTH_Pos (8) /*!< CCAP_T::FIFOTH: PLNUFTH Position */ +#define CCAP_FIFOTH_PLNUFTH_Msk (0xful << CCAP_FIFOTH_PLNUFTH_Pos) /*!< CCAP_T::FIFOTH: PLNUFTH Mask */ + +#define CCAP_FIFOTH_PLNYFTH_Pos (16) /*!< CCAP_T::FIFOTH: PLNYFTH Position */ +#define CCAP_FIFOTH_PLNYFTH_Msk (0x1ful << CCAP_FIFOTH_PLNYFTH_Pos) /*!< CCAP_T::FIFOTH: PLNYFTH Mask */ + +#define CCAP_FIFOTH_PKTFTH_Pos (24) /*!< CCAP_T::FIFOTH: PKTFTH Position */ +#define CCAP_FIFOTH_PKTFTH_Msk (0x1ful << CCAP_FIFOTH_PKTFTH_Pos) /*!< CCAP_T::FIFOTH: PKTFTH Mask */ + +#define CCAP_FIFOTH_OVF_Pos (31) /*!< CCAP_T::FIFOTH: OVF Position */ +#define CCAP_FIFOTH_OVF_Msk (0x1ul << CCAP_FIFOTH_OVF_Pos) /*!< CCAP_T::FIFOTH: OVF Mask */ + +#define CCAP_CMPADDR_CMPADDR_Pos (0) /*!< CCAP_T::CMPADDR: CMPADDR Position */ +#define CCAP_CMPADDR_CMPADDR_Msk (0xfffffffful << CCAP_CMPADDR_CMPADDR_Pos) /*!< CCAP_T::CMPADDR: CMPADDR Mask */ + +#define CCAP_PKTSM_PKTSHMH_Pos (0) /*!< CCAP_T::PKTSM: PKTSHMH Position */ +#define CCAP_PKTSM_PKTSHMH_Msk (0xfful << CCAP_PKTSM_PKTSHMH_Pos) /*!< CCAP_T::PKTSM: PKTSHMH Mask */ + +#define CCAP_PKTSM_PKTSHNH_Pos (8) /*!< CCAP_T::PKTSM: PKTSHNH Position */ +#define CCAP_PKTSM_PKTSHNH_Msk (0xfful << CCAP_PKTSM_PKTSHNH_Pos) /*!< CCAP_T::PKTSM: PKTSHNH Mask */ + +#define CCAP_PKTSM_PKTSVMH_Pos (16) /*!< CCAP_T::PKTSM: PKTSVMH Position */ +#define CCAP_PKTSM_PKTSVMH_Msk (0xfful << CCAP_PKTSM_PKTSVMH_Pos) /*!< CCAP_T::PKTSM: PKTSVMH Mask */ + +#define CCAP_PKTSM_PKTSVNH_Pos (24) /*!< CCAP_T::PKTSM: PKTSVNH Position */ +#define CCAP_PKTSM_PKTSVNH_Msk (0xfful << CCAP_PKTSM_PKTSVNH_Pos) /*!< CCAP_T::PKTSM: PKTSVNH Mask */ + +#define CCAP_PKTBA0_BASEADDR_Pos (0) /*!< CCAP_T::PKTBA0: BASEADDR Position */ +#define CCAP_PKTBA0_BASEADDR_Msk (0xfffffffful << CCAP_PKTBA0_BASEADDR_Pos) /*!< CCAP_T::PKTBA0: BASEADDR Mask */ + +/**@}*/ /* CCAP_CONST */ +/**@}*/ /* end of CCAP register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __CCAP_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/clk_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/clk_reg.h new file mode 100644 index 00000000000..f9eb61db1e4 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/clk_reg.h @@ -0,0 +1,1691 @@ +/**************************************************************************//** + * @file clk_reg.h + * @version V1.00 + * @brief CLK register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __CLK_REG_H__ +#define __CLK_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup CLK System Clock Controller(CLK) + Memory Mapped Structure for CLK Controller +@{ */ + +typedef struct +{ + + + /** + * @var CLK_T::PWRCTL + * Offset: 0x00 System Power-down Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |HXTEN |HXT Enable Bit (Write Protect) + * | | |The bit default value is set by flash controller user configuration register CONFIG0 [26] + * | | |When the default clock source is from HXT, this bit is set to 1 automatically. + * | | |0 = 4~24 MHz external high speed crystal (HXT) Disabled. + * | | |1 = 4~24 MHz external high speed crystal (HXT) Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[1] |LXTEN |LXT Enable Bit (Write Protect) + * | | |0 = 32.768 kHz external low speed crystal (LXT) Disabled. + * | | |1 = 32.768 kHz external low speed crystal (LXT) Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[2] |HIRCEN |HIRC Enable Bit (Write Protect) + * | | |0 = 12 MHz internal high speed RC oscillator (HIRC) Disabled. + * | | |1 = 12 MHz internal high speed RC oscillator (HIRC) Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[3] |LIRCEN |LIRC Enable Bit (Write Protect) + * | | |0 = 10 kHz internal low speed RC oscillator (LIRC) Disabled. + * | | |1 = 10 kHz internal low speed RC oscillator (LIRC) Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[4] |PDWKDLY |Enable the Wake-up Delay Counter (Write Protect) + * | | |When the chip wakes up from Power-down mode, the clock control will delay certain clock cycles to wait system clock stable. + * | | |The delayed clock cycle is 4096 clock cycles when chip works at 4~24 MHz external high speed crystal oscillator (HXT), and 256 clock cycles when chip works at 12 MHz internal high speed RC oscillator (HIRC). + * | | |0 = Clock cycles delay Disabled. + * | | |1 = Clock cycles delay Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[5] |PDWKIEN |Power-down Mode Wake-up Interrupt Enable Bit (Write Protect) + * | | |0 = Power-down mode wake-up interrupt Disabled. + * | | |1 = Power-down mode wake-up interrupt Enabled. + * | | |Note1: The interrupt will occur when both PDWKIF and PDWKIEN are high. + * | | |Note2: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[6] |PDWKIF |Power-down Mode Wake-up Interrupt Status + * | | |Set by "Power-down wake-up event", it indicates that resume from Power-down mode. + * | | |The flag is set if any wake-up source is occurred. Refer Power Modes and Wake-up Sources chapter. + * | | |Note1: Write 1 to clear the bit to 0. + * | | |Note2: This bit works only if PDWKIEN (CLK_PWRCTL[5]) set to 1. + * |[7] |PDEN |System Power-down Enable (Write Protect) + * | | |When this bit is set to 1, Power-down mode is enabled and chip keeps active till the CPU sleep mode is also active and then the chip enters Power-down mode. + * | | |When chip wakes up from Power-down mode, this bit is auto cleared + * | | |Users need to set this bit again for next Power-down. + * | | |In Power-down mode, HXT and the HIRC will be disabled in this mode, but LXT and LIRC are not controlled by Power-down mode. + * | | |In Power-down mode, the PLL and system clock are disabled, and ignored the clock source selection + * | | |The clocks of peripheral are not controlled by Power-down mode, if the peripheral clock source is from LXT or LIRC. + * | | |0 = Chip will not enter Power-down mode after CPU sleep command WFI. + * | | |1 = Chip enters Power-down mode after CPU sleep command WFI. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[11:10] |HXTGAIN |HXT Gain Control Bit (Write Protect) + * | | |This is a protected register. Please refer to open lock sequence to program it. + * | | |Gain control is used to enlarge the gain of crystal to make sure crystal work normally + * | | |If gain control is enabled, crystal will consume more power than gain control off. + * | | |00 = HXT frequency is lower than from 8 MHz. + * | | |01 = HXT frequency is from 8 MHz to 12 MHz. + * | | |10 = HXT frequency is from 12 MHz to 16 MHz. + * | | |11 = HXT frequency is higher than 16 MHz. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[12] |HXTSELTYP |HXT Crystal Type Select Bit (Write Protect) + * | | |This is a protected register. Please refer to open lock sequence to program it. + * | | |0 = Select INV type. + * | | |1 = Select GM type. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[13] |HXTTBEN |HXT Crystal TURBO Mode (Write Protect) + * | | |This is a protected register. Please refer to open lock sequence to program it. + * | | |0 = HXT Crystal TURBO mode disabled. + * | | |1 = HXT Crystal TURBO mode enabled. + * |[17:16] |HIRCSTBS |HIRC Stable Count Select (Write Protect) + * | | |00 = HIRC stable count is 64 clocks. + * | | |01 = HIRC stable count is 24 clocks. + * | | |others = Reserved. + * |[18] |HIRCEN |HIRC48M Enable Bit (Write Protect) + * | | |0 = 48 MHz internal high speed RC oscillator (HIRC) Disabled. + * | | |1 = 48 MHz internal high speed RC oscillator (HIRC) Enabled. + * @var CLK_T::AHBCLK + * Offset: 0x04 AHB Devices Clock Enable Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1] |PDMACKEN |PDMA Controller Clock Enable Bit + * | | |0 = PDMA peripheral clock Disabled. + * | | |1 = PDMA peripheral clock Enabled. + * |[2] |ISPCKEN |Flash ISP Controller Clock Enable Bit + * | | |0 = Flash ISP peripheral clock Disabled. + * | | |1 = Flash ISP peripheral clock Enabled. + * |[3] |EBICKEN |EBI Controller Clock Enable Bit + * | | |0 = EBI peripheral clock Disabled. + * | | |1 = EBI peripheral clock Enabled. + * |[5] |EMACCKEN |Ethernet Controller Clock Enable Bit + * | | |0 = Ethernet Controller engine clock Disabled. + * | | |1 = Ethernet Controller engine clock Enabled. + * |[6] |SDH0CKEN |SD0 Controller Clock Enable Bit + * | | |0 = SD0 engine clock Disabled. + * | | |1 = SD0 engine clock Enabled. + * |[7] |CRCCKEN |CRC Generator Controller Clock Enable Bit + * | | |0 = CRC peripheral clock Disabled. + * | | |1 = CRC peripheral clock Enabled. + * |[10] |HSUSBDCKEN|HSUSB Device Clock Enable Bit + * | | |0 = HSUSB device controller's clock Disabled. + * | | |1 = HSUSB device controller's clock Enabled. + * |[12] |CRPTCKEN |Cryptographic Accelerator Clock Enable Bit + * | | |0 = Cryptographic Accelerator clock Disabled. + * | | |1 = Cryptographic Accelerator clock Enabled. + * |[14] |SPIMCKEN |SPIM Controller Clock Enable Bit + * | | |0 = SPIM controller clock Disabled. + * | | |1 = SPIM controller clock Enabled. + * |[15] |FMCIDLE |Flash Memory Controller Clock Enable Bit in IDLE Mode + * | | |0 = FMC clock Disabled when chip is under IDLE mode. + * | | |1 = FMC clock Enabled when chip is under IDLE mode. + * |[16] |USBHCKEN |USB HOST Controller Clock Enable Bit + * | | |0 = USB HOST peripheral clock Disabled. + * | | |1 = USB HOST peripheral clock Enabled. + * |[17] |SDH1CKEN |SD1 Controller Clock Enable Bit + * | | |0 = SD1 engine clock Disabled. + * | | |1 = SD1 engine clock Enabled. + * @var CLK_T::APBCLK0 + * Offset: 0x08 APB Devices Clock Enable Control Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |WDTCKEN |Watchdog Timer Clock Enable Bit (Write Protect) + * | | |0 = Watchdog timer clock Disabled. + * | | |1 = Watchdog timer clock Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[1] |RTCCKEN |Real-time-clock APB Interface Clock Enable Bit + * | | |This bit is used to control the RTC APB clock only + * | | |The RTC peripheral clock source is selected from RTCSEL(CLK_CLKSEL3[8]) + * | | |It can be selected to 32.768 kHz external low speed crystal or 10 kHz internal low speed RC oscillator (LIRC). + * | | |0 = RTC clock Disabled. + * | | |1 = RTC clock Enabled. + * |[2] |TMR0CKEN |Timer0 Clock Enable Bit + * | | |0 = Timer0 clock Disabled. + * | | |1 = Timer0 clock Enabled. + * |[3] |TMR1CKEN |Timer1 Clock Enable Bit + * | | |0 = Timer1 clock Disabled. + * | | |1 = Timer1 clock Enabled. + * |[4] |TMR2CKEN |Timer2 Clock Enable Bit + * | | |0 = Timer2 clock Disabled. + * | | |1 = Timer2 clock Enabled. + * |[5] |TMR3CKEN |Timer3 Clock Enable Bit + * | | |0 = Timer3 clock Disabled. + * | | |1 = Timer3 clock Enabled. + * |[6] |CLKOCKEN |CLKO Clock Enable Bit + * | | |0 = CLKO clock Disabled. + * | | |1 = CLKO clock Enabled. + * |[7] |ACMP01CKEN|Analog Comparator 0/1 Clock Enable Bit + * | | |0 = Analog comparator 0/1 clock Disabled. + * | | |1 = Analog comparator 0/1 clock Enabled. + * |[8] |I2C0CKEN |I2C0 Clock Enable Bit + * | | |0 = I2C0 clock Disabled. + * | | |1 = I2C0 clock Enabled. + * |[9] |I2C1CKEN |I2C1 Clock Enable Bit + * | | |0 = I2C1 clock Disabled. + * | | |1 = I2C1 clock Enabled. + * |[10] |I2C2CKEN |I2C2 Clock Enable Bit + * | | |0 = I2C2 clock Disabled. + * | | |1 = I2C2 clock Enabled. + * |[12] |QSPI0CKEN |QSPI0 Clock Enable Bit + * | | |0 = QSPI0 clock Disabled. + * | | |1 = QSPI0 clock Enabled. + * |[13] |SPI0CKEN |SPI0 Clock Enable Bit + * | | |0 = SPI0 clock Disabled. + * | | |1 = SPI0 clock Enabled. + * |[14] |SPI1CKEN |SPI1 Clock Enable Bit + * | | |0 = SPI1 clock Disabled. + * | | |1 = SPI1 clock Enabled. + * |[15] |SPI2CKEN |SPI2 Clock Enable Bit + * | | |0 = SPI2 clock Disabled. + * | | |1 = SPI2 clock Enabled. + * |[16] |UART0CKEN |UART0 Clock Enable Bit + * | | |0 = UART0 clock Disabled. + * | | |1 = UART0 clock Enabled. + * |[17] |UART1CKEN |UART1 Clock Enable Bit + * | | |0 = UART1 clock Disabled. + * | | |1 = UART1 clock Enabled. + * |[18] |UART2CKEN |UART2 Clock Enable Bit + * | | |0 = UART2 clock Disabled. + * | | |1 = UART2 clock Enabled. + * |[19] |UART3CKEN |UART3 Clock Enable Bit + * | | |0 = UART3 clock Disabled. + * | | |1 = UART3 clock Enabled. + * |[20] |UART4CKEN |UART4 Clock Enable Bit + * | | |0 = UART4 clock Disabled. + * | | |1 = UART4 clock Enabled. + * |[21] |UART5CKEN |UART5 Clock Enable Bit + * | | |0 = UART5 clock Disabled. + * | | |1 = UART5 clock Enabled. + * |[24] |CAN0CKEN |CAN0 Clock Enable Bit + * | | |0 = CAN0 clock Disabled. + * | | |1 = CAN0 clock Enabled. + * |[25] |CAN1CKEN |CAN1 Clock Enable Bit + * | | |0 = CAN1 clock Disabled. + * | | |1 = CAN1 clock Enabled. + * |[26] |OTGCKEN |USB OTG Clock Enable Bit + * | | |0 = USB OTG clock Disabled. + * | | |1 = USB OTG clock Enabled. + * |[27] |USBDCKEN |USB Device Clock Enable Bit + * | | |0 = USB Device clock Disabled. + * | | |1 = USB Device clock Enabled. + * |[28] |EADCCKEN |Enhanced Analog-digital-converter (EADC) Clock Enable Bit + * | | |0 = EADC clock Disabled. + * | | |1 = EADC clock Enabled. + * |[29] |I2S0CKEN |I2S0 Clock Enable Bit + * | | |0 = I2S0 Clock Disabled. + * | | |1 = I2S0 Clock Enabled. + * |[30] |HSOTGCKEN |HSUSB OTG Clock Enable Bit + * | | |0 = HSUSB OTG clock Disabled. + * | | |1 = HSUSB OTG clock Enabled. + * @var CLK_T::APBCLK1 + * Offset: 0x0C APB Devices Clock Enable Control Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SC0CKEN |SC0 Clock Enable Bit + * | | |0 = SC0 clock Disabled. + * | | |1 = SC0 clock Enabled. + * |[1] |SC1CKEN |SC1 Clock Enable Bit + * | | |0 = SC1 clock Disabled. + * | | |1 = SC1 clock Enabled. + * |[2] |SC2CKEN |SC2 Clock Enable Bit + * | | |0 = SC2 clock Disabled. + * | | |1 = SC2 clock Enabled. + * |[6] |SPI3CKEN |SPI3 Clock Enable Bit + * | | |0 = SPI3 clock Disabled. + * | | |1 = SPI3 clock Enabled. + * |[8] |USCI0CKEN |USCI0 Clock Enable Bit + * | | |0 = USCI0 clock Disabled. + * | | |1 = USCI0 clock Enabled. + * |[9] |USCI1CKEN |USCI1 Clock Enable Bit + * | | |0 = USCI1 clock Disabled. + * | | |1 = USCI1 clock Enabled. + * |[12] |DACCKEN |DAC Clock Enable Bit + * | | |0 = DAC clock Disabled. + * | | |1 = DAC clock Enabled. + * |[16] |EPWM0CKEN |EPWM0 Clock Enable Bit + * | | |0 = EPWM0 clock Disabled. + * | | |1 = EPWM0 clock Enabled. + * |[17] |EPWM1CKEN |EPWM1 Clock Enable Bit + * | | |0 = EPWM1 clock Disabled. + * | | |1 = EPWM1 clock Enabled. + * |[18] |BPWM0CKEN |BPWM0 Clock Enable Bit + * | | |0 = BPWM0 clock Disabled. + * | | |1 = BPWM0 clock Enabled. + * |[19] |BPWM1CKEN |BPWM1 Clock Enable Bit + * | | |0 = BPWM1 clock Disabled. + * | | |1 = BPWM1 clock Enabled. + * |[22] |QEI0CKEN |QEI0 Clock Enable Bit + * | | |0 = QEI0 clock Disabled. + * | | |1 = QEI0 clock Enabled. + * |[23] |QEI1CKEN |QEI1 Clock Enable Bit + * | | |0 = QEI1 clock Disabled. + * | | |1 = QEI1 clock Enabled. + * |[26] |ECAP0CKEN |ECAP0 Clock Enable Bit + * | | |0 = ECAP0 clock Disabled. + * | | |1 = ECAP0 clock Enabled. + * |[27] |ECAP1CKEN |ECAP1 Clock Enable Bit + * | | |0 = ECAP1 clock Disabled. + * | | |1 = ECAP1 clock Enabled. + * |[30] |OPACKEN |OP Amplifier (OPA) Clock Enable Bit + * | | |0 = OPA clock Disabled. + * | | |1 = OPA clock Enabled. + * @var CLK_T::CLKSEL0 + * Offset: 0x10 Clock Source Select Control Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2:0] |HCLKSEL |HCLK Clock Source Selection (Write Protect) + * | | |Before clock switching, the related clock sources (both pre-select and new-select) must be turned on. + * | | |The default value is reloaded from the value of CFOSC (CONFIG0[26]) in user configuration register of Flash controller by any reset + * | | |Therefore the default value is either 000b or 111b. + * | | |000 = Clock source from HXT. + * | | |001 = Clock source from LXT. + * | | |010 = Clock source from PLL. + * | | |011 = Clock source from LIRC. + * | | |111 = Clock source from HIRC. + * | | |Other = Reserved. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[5:3] |STCLKSEL |Cortex-M4 SysTick Clock Source Selection (Write Protect) + * | | |If SYST_CTRL[2]=0, SysTick uses listed clock source below. + * | | |000 = Clock source from HXT. + * | | |001 = Clock source from LXT. + * | | |010 = Clock source from HXT/2. + * | | |011 = Clock source from HCLK/2. + * | | |111 = Clock source from HIRC/2. + * | | |Note: if SysTick clock source is not from HCLK (i.e + * | | |SYST_CTRL[2] = 0), SysTick clock source must less than or equal to HCLK/2. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[8] |USBSEL |USB Clock Source Selection (Write Protect) + * | | |0 = Clock source from RC48M. + * | | |1 = Clock source from PLL. + * |[21:20] |SDH0SEL |SD0 Engine Clock Source Selection (Write Protect) + * | | |00 = Clock source from HXT clock. + * | | |01 = Clock source from PLL clock. + * | | |10 = Clock source from HCLK. + * | | |11 = Clock source from HIRC clock. + * |[23:22] |SDH1SEL |SD1 Engine Clock Source Selection (Write Protect) + * | | |00 = Clock source from HXT clock. + * | | |01 = Clock source from PLL clock. + * | | |10 = Clock source from HCLK. + * | | |11 = Clock source from HIRC clock. + * @var CLK_T::CLKSEL1 + * Offset: 0x14 Clock Source Select Control Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |WDTSEL |Watchdog Timer Clock Source Selection (Write Protect) + * | | |00 = Reserved. + * | | |01 = Clock source from 32.768 kHz external low speed crystal oscillator (LXT). + * | | |10 = Clock source from HCLK/2048. + * | | |11 = Clock source from 10 kHz internal low speed RC oscillator (LIRC). + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[10:8] |TMR0SEL |TIMER0 Clock Source Selection + * | | |000 = Clock source from 4~24 MHz external high speed crystal oscillator (HXT). + * | | |001 = Clock source from 32.768 kHz external low speed crystal oscillator (LXT). + * | | |010 = Clock source from PCLK0. + * | | |011 = Clock source from external clock TM0 pin. + * | | |101 = Clock source from 10 kHz internal low speed RC oscillator (LIRC). + * | | |111 = Clock source from 12 MHz internal high speed RC oscillator (HIRC). + * | | |Others = Reserved. + * |[14:12] |TMR1SEL |TIMER1 Clock Source Selection + * | | |000 = Clock source from 4~24 MHz external high speed crystal oscillator (HXT). + * | | |001 = Clock source from 32.768 kHz external low speed crystal oscillator (LXT). + * | | |010 = Clock source from PCLK0. + * | | |011 = Clock source from external clock TM1 pin. + * | | |101 = Clock source from 10 kHz internal low speed RC oscillator (LIRC). + * | | |111 = Clock source from 12 MHz internal high speed RC oscillator (HIRC). + * | | |Others = Reserved. + * |[18:16] |TMR2SEL |TIMER2 Clock Source Selection + * | | |000 = Clock source from 4~24 MHz external high speed crystal oscillator (HXT). + * | | |001 = Clock source from 32.768 kHz external low speed crystal oscillator (LXT). + * | | |010 = Clock source from PCLK1. + * | | |011 = Clock source from external clock TM2 pin. + * | | |101 = Clock source from 10 kHz internal low speed RC oscillator (LIRC). + * | | |111 = Clock source from 12 MHz internal high speed RC oscillator (HIRC). + * | | |Others = Reserved. + * |[22:20] |TMR3SEL |TIMER3 Clock Source Selection + * | | |000 = Clock source from 4~24 MHz external high speed crystal oscillator (HXT). + * | | |001 = Clock source from 32.768 kHz external low speed crystal oscillator (LXT). + * | | |010 = Clock source from PCLK1. + * | | |011 = Clock source from external clock TM3 pin. + * | | |101 = Clock source from 10 kHz internal low speed RC oscillator (LIRC). + * | | |111 = Clock source from 12 MHz internal high speed RC oscillator (HIRC). + * | | |Others = Reserved. + * |[25:24] |UART0SEL |UART0 Clock Source Selection + * | | |00 = Clock source from 4~24 MHz external high speed crystal oscillator (HXT). + * | | |01 = Clock source from PLL. + * | | |10 = Clock source from 32.768 kHz external low speed crystal oscillator (LXT). + * | | |11 = Clock source from 12 MHz internal high speed RC oscillator (HIRC). + * |[27:26] |UART1SEL |UART1 Clock Source Selection + * | | |00 = Clock source from 4~24 MHz external high speed crystal oscillator (HXT). + * | | |01 = Clock source from PLL. + * | | |10 = Clock source from 32.768 kHz external low speed crystal oscillator (LXT). + * | | |11 = Clock source from 12 MHz internal high speed RC oscillator (HIRC). + * |[29:28] |CLKOSEL |Clock Divider Clock Source Selection + * | | |00 = Clock source from 4~24 MHz external high speed crystal oscillator (HXT). + * | | |01 = Clock source from 32.768 kHz external low speed crystal oscillator (LXT). + * | | |10 = Clock source from HCLK. + * | | |11 = Clock source from 12 MHz internal high speed RC oscillator (HIRC). + * |[31:30] |WWDTSEL |Window Watchdog Timer Clock Source Selection + * | | |10 = Clock source from HCLK/2048. + * | | |11 = Clock source from 10 kHz internal low speed RC oscillator (LIRC). + * | | |Others = Reserved. + * @var CLK_T::CLKSEL2 + * Offset: 0x18 Clock Source Select Control Register 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |EPWM0SEL |EPWM0 Clock Source Selection + * | | |The peripheral clock source of EPWM0 is defined by EPWM0SEL. + * | | |0 = Clock source from PLL. + * | | |1 = Clock source from PCLK0. + * |[1] |EPWM1SEL |EPWM1 Clock Source Selection + * | | |The peripheral clock source of EPWM1 is defined by EPWM1SEL. + * | | |0 = Clock source from PLL. + * | | |1 = Clock source from PCLK1. + * |[3:2] |QSPI0SEL |QSPI0 Clock Source Selection + * | | |00 = Clock source from 4~24 MHz external high speed crystal oscillator (HXT). + * | | |01 = Clock source from PLL. + * | | |10 = Clock source from PCLK0. + * | | |11 = Clock source from 12 MHz internal high speed RC oscillator (HIRC). + * |[5:4] |SPI0SEL |SPI0 Clock Source Selection + * | | |00 = Clock source from 4~24 MHz external high speed crystal oscillator (HXT). + * | | |01 = Clock source from PLL. + * | | |10 = Clock source from PCLK1. + * | | |11 = Clock source from 12 MHz internal high speed RC oscillator (HIRC). + * |[7:6] |SPI1SEL |SPI1 Clock Source Selection + * | | |00 = Clock source from 4~24 MHz external high speed crystal oscillator (HXT). + * | | |01 = Clock source from PLL. + * | | |10 = Clock source from PCLK0. + * | | |11 = Clock source from 12 MHz internal high speed RC oscillator (HIRC). + * |[8] |BPWM0SEL |BPWM0 Clock Source Selection + * | | |The peripheral clock source of BPWM0 is defined by BPWM0SEL. + * | | |0 = Clock source from PLL. + * | | |1 = Clock source from PCLK0. + * |[9] |BPWM1SEL |BPWM1 Clock Source Selection + * | | |The peripheral clock source of BPWM1 is defined by BPWM1SEL. + * | | |0 = Clock source from PLL. + * | | |1 = Clock source from PCLK1. + * |[11:10] |SPI2SEL |SPI2 Clock Source Selection + * | | |00 = Clock source from 4~24 MHz external high speed crystal oscillator (HXT). + * | | |01 = Clock source from PLL. + * | | |10 = Clock source from PCLK1. + * | | |11 = Clock source from 12 MHz internal high speed RC oscillator (HIRC). + * |[13:12] |SPI3SEL |SPI3 Clock Source Selection + * | | |00 = Clock source from 4~24 MHz external high speed crystal oscillator (HXT). + * | | |01 = Clock source from PLL. + * | | |10 = Clock source from PCLK0. + * | | |11 = Clock source from 12 MHz internal high speed RC oscillator (HIRC). + * @var CLK_T::CLKSEL3 + * Offset: 0x1C Clock Source Select Control Register 3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |SC0SEL |SC0 Clock Source Selection + * | | |00 = Clock source from 4~24 MHz external high speed crystal oscillator (HXT). + * | | |01 = Clock source from PLL. + * | | |10 = Clock source from PCLK0. + * | | |11 = Clock source from 12 MHz internal high speed RC oscillator (HIRC). + * |[3:2] |SC1SEL |SC0 Clock Source Selection + * | | |00 = Clock source from 4~24 MHz external high speed crystal oscillator (HXT). + * | | |01 = Clock source from PLL. + * | | |10 = Clock source from PCLK1. + * | | |11 = Clock source from 12 MHz internal high speed RC oscillator (HIRC). + * |[5:4] |SC2SEL |SC2 Clock Source Selection + * | | |00 = Clock source from 4~24 MHz external high speed crystal oscillator (HXT). + * | | |01 = Clock source from PLL. + * | | |10 = Clock source from PCLK0. + * | | |11 = Clock source from 12 MHz internal high speed RC oscillator (HIRC). + * |[8] |RTCSEL |RTC Clock Source Selection + * | | |0 = Clock source from 32.768 kHz external low speed crystal oscillator (LXT). + * | | |1 = Clock source from 10 kHz internal low speed RC oscillator (LIRC). + * |[17:16] |I2S0SEL |I2S0 Clock Source Selection + * | | |00 = Clock source from HXT clock. + * | | |01 = Clock source from PLL clock. + * | | |10 = Clock source from PCLK. + * | | |11 = Clock source from HIRC clock. + * |[25:24] |UART2SEL |UART2 Clock Source Selection + * | | |00 = Clock source from 4~24 MHz external high speed crystal oscillator (HXT). + * | | |01 = Clock source from PLL. + * | | |10 = Clock source from 32.768 kHz external low speed crystal oscillator (LXT). + * | | |11 = Clock source from 12 MHz internal high speed RC oscillator (HIRC). + * |[27:26] |UART3SEL |UART3 Clock Source Selection + * | | |00 = Clock source from 4~24 MHz external high speed crystal oscillator (HXT). + * | | |01 = Clock source from PLL. + * | | |10 = Clock source from 32.768 kHz external low speed crystal oscillator (LXT). + * | | |11 = Clock source from 12 MHz internal high speed RC oscillator (HIRC). + * |[29:28] |UART4SEL |UART4 Clock Source Selection + * | | |00 = Clock source from 4~24 MHz external high speed crystal oscillator (HXT). + * | | |01 = Clock source from PLL. + * | | |10 = Clock source from 32.768 kHz external low speed crystal oscillator (LXT). + * | | |11 = Clock source from 12 MHz internal high speed RC oscillator (HIRC). + * |[31:30] |UART5SEL |UART5 Clock Source Selection + * | | |00 = Clock source from 4~24 MHz external high speed crystal oscillator (HXT). + * | | |01 = Clock source from PLL. + * | | |10 = Clock source from 32.768 kHz external low speed crystal oscillator (LXT). + * | | |11 = Clock source from 12 MHz internal high speed RC oscillator (HIRC). + * @var CLK_T::CLKDIV0 + * Offset: 0x20 Clock Divider Number Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |HCLKDIV |HCLK Clock Divide Number From HCLK Clock Source + * | | |HCLK clock frequency = (HCLK clock source frequency) / (HCLKDIV + 1). + * |[7:4] |USBDIV |USB Clock Divide Number From PLL Clock + * | | |USB clock frequency = (PLL frequency) / (USBDIV + 1). + * |[11:8] |UART0DIV |UART0 Clock Divide Number From UART0 Clock Source + * | | |UART0 clock frequency = (UART0 clock source frequency) / (UART0DIV + 1). + * |[15:12] |UART1DIV |UART1 Clock Divide Number From UART1 Clock Source + * | | |UART1 clock frequency = (UART1 clock source frequency) / (UART1DIV + 1). + * |[23:16] |EADCDIV |EADC Clock Divide Number From EADC Clock Source + * | | |EADC clock frequency = (EADC clock source frequency) / (EADCDIV + 1). + * |[31:24] |SDH0DIV |SD0 Clock Divide Number From SD0 Clock Source + * | | |SD0 clock frequency = (SD0 clock source frequency) / (SDH0DIV + 1). + * @var CLK_T::CLKDIV1 + * Offset: 0x24 Clock Divider Number Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |SC0DIV |SC0 Clock Divide Number From SC0 Clock Source + * | | |SC0 clock frequency = (SC0 clock source frequency ) / (SC0DIV + 1). + * |[15:8] |SC1DIV |SC1 Clock Divide Number From SC1 Clock Source + * | | |SC1 clock frequency = (SC1 clock source frequency ) / (SC1DIV + 1). + * |[23:16] |SC2DIV |SC2 Clock Divide Number From SC2 Clock Source + * | | |SC2 clock frequency = (SC2 clock source frequency ) / (SC2DIV + 1). + * @var CLK_T::CLKDIV3 + * Offset: 0x2C Clock Divider Number Register 3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:16] |EMACDIV |Ethernet Clock Divide Number Form HCLK + * | | |EMAC MDCLK clock frequency = (HCLK) / (EMACDIV + 1). + * |[31:24] |SDH1DIV |SD1 Clock Divide Number From SD1 Clock Source + * | | |SD1 clock frequency = (SD1 clock source frequency) / (SDH1DIV + 1). + * @var CLK_T::CLKDIV4 + * Offset: 0x30 Clock Divider Number Register 4 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |UART2DIV |UART2 Clock Divide Number From UART2 Clock Source + * | | |UART2 clock frequency = (UART2 clock source frequency) / (UART2DIV + 1). + * |[7:4] |UART3DIV |UART3 Clock Divide Number From UART3 Clock Source + * | | |UART3 clock frequency = (UART3 clock source frequency) / (UART3DIV + 1). + * |[11:8] |UART4DIV |UART4 Clock Divide Number From UART4 Clock Source + * | | |UART4 clock frequency = (UART4 clock source frequency) / (UART4DIV + 1). + * |[15:12] |UART5DIV |UART5 Clock Divide Number From UART5 Clock Source + * | | |UART5 clock frequency = (UART5 clock source frequency) / (UART5DIV + 1). + * @var CLK_T::PCLKDIV + * Offset: 0x34 APB Clock Divider Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2:0] |APB0DIV |APB0 Clock Divider + * | | |APB0 clock can be divided from HCLK + * | | |000: PCLK0 = HCLK. + * | | |001: PCLK0 = 1/2 HCLK. + * | | |010: PCLK0 = 1/4 HCLK. + * | | |011: PCLK0 = 1/8 HCLK. + * | | |100: PCLK0 = 1/16 HCLK. + * | | |Others: Reserved. + * |[6:4] |APB1DIV |APB1 Clock Divider + * | | |APB1 clock can be divided from HCLK + * | | |000: PCLK1 = HCLK. + * | | |001: PCLK1 = 1/2 HCLK. + * | | |010: PCLK1 = 1/4 HCLK. + * | | |011: PCLK1 = 1/8 HCLK. + * | | |100: PCLK1 = 1/16 HCLK. + * | | |Others: Reserved. + * @var CLK_T::PLLCTL + * Offset: 0x40 PLL Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[8:0] |FBDIV |PLL Feedback Divider Control (Write Protect) + * | | |Refer to the formulas below the table. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[13:9] |INDIV |PLL Input Divider Control (Write Protect) + * | | |Refer to the formulas below the table. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[15:14] |OUTDIV |PLL Output Divider Control (Write Protect) + * | | |Refer to the formulas below the table. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[16] |PD |Power-down Mode (Write Protect) + * | | |If set the PDEN bit to 1 in CLK_PWRCTL register, the PLL will enter Power-down mode, too. + * | | |0 = PLL is in normal mode. + * | | |1 = PLL is in Power-down mode (default). + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[17] |BP |PLL Bypass Control (Write Protect) + * | | |0 = PLL is in normal mode (default). + * | | |1 = PLL clock output is same as PLL input clock FIN. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[18] |OE |PLL OE (FOUT Enable) Pin Control (Write Protect) + * | | |0 = PLL FOUT Enabled. + * | | |1 = PLL FOUT is fixed low. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[19] |PLLSRC |PLL Source Clock Selection (Write Protect) + * | | |0 = PLL source clock from 4~24 MHz external high-speed crystal oscillator (HXT). + * | | |1 = PLL source clock from 12 MHz internal high-speed oscillator (HIRC). + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[23] |STBSEL |PLL Stable Counter Selection (Write Protect) + * | | |0 = PLL stable time is 6144 PLL source clock (suitable for source clock is equal to or less than 12 MHz). + * | | |1 = PLL stable time is 12288 PLL source clock (suitable for source clock is larger than 12 MHz). + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * @var CLK_T::STATUS + * Offset: 0x50 Clock Status Monitor Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |HXTSTB |HXT Clock Source Stable Flag (Read Only) + * | | |0 = 4~24 MHz external high speed crystal oscillator (HXT) clock is not stable or disabled. + * | | |1 = 4~24 MHz external high speed crystal oscillator (HXT) clock is stable and enabled. + * |[1] |LXTSTB |LXT Clock Source Stable Flag (Read Only) + * | | |0 = 32.768 kHz external low speed crystal oscillator (LXT) clock is not stable or disabled. + * | | |1 = 32.768 kHz external low speed crystal oscillator (LXT) clock is stabled and enabled. + * |[2] |PLLSTB |Internal PLL Clock Source Stable Flag (Read Only) + * | | |0 = Internal PLL clock is not stable or disabled. + * | | |1 = Internal PLL clock is stable and enabled. + * |[3] |LIRCSTB |LIRC Clock Source Stable Flag (Read Only) + * | | |0 = 10 kHz internal low speed RC oscillator (LIRC) clock is not stable or disabled. + * | | |1 = 10 kHz internal low speed RC oscillator (LIRC) clock is stable and enabled. + * |[4] |HIRCSTB |HIRC Clock Source Stable Flag (Read Only) + * | | |0 = 12 MHz internal high speed RC oscillator (HIRC) clock is not stable or disabled. + * | | |1 = 12 MHz internal high speed RC oscillator (HIRC) clock is stable and enabled. + * | | |Note: This bit is read only. + * |[7] |CLKSFAIL |Clock Switching Fail Flag (Read Only) + * | | |This bit is updated when software switches system clock source + * | | |If switch target clock is stable, this bit will be set to 0 + * | | |If switch target clock is not stable, this bit will be set to 1. + * | | |0 = Clock switching success. + * | | |1 = Clock switching failure. + * | | |Note: Write 1 to clear the bit to 0. + * @var CLK_T::CLKOCTL + * Offset: 0x60 Clock Output Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |FREQSEL |Clock Output Frequency Selection + * | | |The formula of output frequency is + * | | |Fout = Fin/2(N+1). + * | | |Fin is the input clock frequency. + * | | |Fout is the frequency of divider output clock. + * | | |N is the 4-bit value of FREQSEL[3:0]. + * |[4] |CLKOEN |Clock Output Enable Bit + * | | |0 = Clock Output function Disabled. + * | | |1 = Clock Output function Enabled. + * |[5] |DIV1EN |Clock Output Divide One Enable Bit + * | | |0 = Clock Output will output clock with source frequency divided by FREQSEL. + * | | |1 = Clock Output will output clock with source frequency. + * |[6] |CLK1HZEN |Clock Output 1Hz Enable Bit + * | | |0 = 1 Hz clock output for 32.768 kHz frequency compensation Disabled. + * | | |1 = 1 Hz clock output for 32.768 kHz frequency compensation Enabled. + * @var CLK_T::CLKDCTL + * Offset: 0x70 Clock Fail Detector Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[4] |HXTFDEN |HXT Clock Fail Detector Enable Bit + * | | |0 = 4~24 MHz external high speed crystal oscillator (HXT) clock fail detector Disabled. + * | | |1 = 4~24 MHz external high speed crystal oscillator (HXT) clock fail detector Enabled. + * |[5] |HXTFIEN |HXT Clock Fail Interrupt Enable Bit + * | | |0 = 4~24 MHz external high speed crystal oscillator (HXT) clock fail interrupt Disabled. + * | | |1 = 4~24 MHz external high speed crystal oscillator (HXT) clock fail interrupt Enabled. + * |[12] |LXTFDEN |LXT Clock Fail Detector Enable Bit + * | | |0 = 32.768 kHz external low speed crystal oscillator (LXT) clock fail detector Disabled. + * | | |1 = 32.768 kHz external low speed crystal oscillator (LXT) clock fail detector Enabled. + * |[13] |LXTFIEN |LXT Clock Fail Interrupt Enable Bit + * | | |0 = 32.768 kHz external low speed crystal oscillator (LXT) clock fail interrupt Disabled. + * | | |1 = 32.768 kHz external low speed crystal oscillator (LXT) clock fail interrupt Enabled. + * |[16] |HXTFQDEN |HXT Clock Frequency Range Detector Enable Bit + * | | |0 = 4~24 MHz external high speed crystal oscillator (HXT) clock frequency range detector Disabled. + * | | |1 = 4~24 MHz external high speed crystal oscillator (HXT) clock frequency range detector Enabled. + * |[17] |HXTFQIEN |HXT Clock Frequency Range Detector Interrupt Enable Bit + * | | |0 = 4~24 MHz external high speed crystal oscillator (HXT) clock frequency range detector fail interrupt Disabled. + * | | |1 = 4~24 MHz external high speed crystal oscillator (HXT) clock frequency range detector fail interrupt Enabled. + * @var CLK_T::CLKDSTS + * Offset: 0x74 Clock Fail Detector Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |HXTFIF |HXT Clock Fail Interrupt Flag + * | | |0 = 4~24 MHz external high speed crystal oscillator (HXT) clock is normal. + * | | |1 = 4~24 MHz external high speed crystal oscillator (HXT) clock stops. + * | | |Note: Write 1 to clear the bit to 0. + * |[1] |LXTFIF |LXT Clock Fail Interrupt Flag + * | | |0 = 32.768 kHz external low speed crystal oscillator (LXT) clock is normal. + * | | |1 = 32.768 kHz external low speed crystal oscillator (LXT) stops. + * | | |Note: Write 1 to clear the bit to 0. + * |[8] |HXTFQIF |HXT Clock Frequency Range Detector Interrupt Flag + * | | |0 = 4~24 MHz external high speed crystal oscillator (HXT) clock frequency is normal. + * | | |1 = 4~24 MHz external high speed crystal oscillator (HXT) clock frequency is abnormal. + * | | |Note: Write 1 to clear the bit to 0. + * @var CLK_T::CDUPB + * Offset: 0x78 Clock Frequency Range Detector Upper Boundary Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[9:0] |UPERBD |HXT Clock Frequency Range Detector Upper Boundary Value + * | | |The bits define the maximum value of frequency range detector window. + * | | |When HXT frequency higher than this maximum frequency value, the HXT Clock Frequency Range Detector Interrupt Flag will set to 1. + * @var CLK_T::CDLOWB + * Offset: 0x7C Clock Frequency Range Detector Lower Boundary Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[9:0] |LOWERBD |HXT Clock Frequency Range Detector Lower Boundary Value + * | | |The bits define the minimum value of frequency range detector window. + * | | |When HXT frequency lower than this minimum frequency value, the HXT Clock Frequency Range Detector Interrupt Flag will set to 1. + * @var CLK_T::PMUCTL + * Offset: 0x90 Power Manager Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2:0] |PDMSEL |Power-down Mode Selection (Write Protect) + * | | |This is a protected register. Please refer to open lock sequence to program it. + * | | |These bits control chip power-down mode grade selection when CPU execute WFI/WFE instruction. + * | | |000 = Power-down mode is selected. (PD) + * | | |001 = Low leakage Power-down mode is selected (LLPD). + * | | |010 =Fast wake-up Power-down mode is selected (FWPD). + * | | |011 = Reserved. + * | | |100 = Standby Power-down mode 0 is selected (SPD0) (SRAM retention). + * | | |101 = Standby Power-down mode 1 is selected (SPD1). + * | | |110 = Deep Power-down mode is selected (DPD). + * | | |111 = Reserved. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[3] |DPDHOLDEN |Deep-Power-Down Mode GPIO Hold Enable + * | | |0 = When GPIO enters deep power-down mode, all I/O status are tri-state. + * | | |1 = When GPIO enters deep power-down mode, all I/O status are hold to keep normal operating status. + * | | | After chip was waked up from deep power-down mode, the I/O are still keep hold status until user set CLK_IOPDCTL[0] + * | | | to release I/O hold status. + * |[8] |WKTMREN |Wake-up Timer Enable (Write Protect) + * | | |This is a protected register. Please refer to open lock sequence to program it. + * | | |0 = Wake-up timer disable at DPD/SPD mode. + * | | |1 = Wake-up timer enabled at DPD/SPD mode. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[11:9] |WKTMRIS |Wake-up Timer Time-out Interval Select (Write Protect) + * | | |This is a protected register. Please refer to open lock sequence to program it. + * | | |These bits control wake-up timer time-out interval when chip at DPD/SPD mode. + * | | |000 = Time-out interval is 128 OSC10K clocks (12.8 ms). + * | | |001 = Time-out interval is 256 OSC10K clocks (25.6 ms). + * | | |010 = Time-out interval is 512 OSC10K clocks (51.2 ms). + * | | |011 = Time-out interval is 1024 OSC10K clocks (102.4ms). + * | | |100 = Time-out interval is 4096 OSC10K clocks (409.6ms). + * | | |101 = Time-out interval is 8192 OSC10K clocks (819.2ms). + * | | |110 = Time-out interval is 16384 OSC10K clocks (1638.4ms). + * | | |111 = Time-out interval is 65536 OSC10K clocks (6553.6ms). + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[17:16] |WKPINEN |Wake-up Pin Enable (Write Protect) + * | | |This is a protected register. Please refer to open lock sequence to program it. + * | | |00 = Wake-up pin disable at Deep Power-down mode. + * | | |01 = Wake-up pin rising edge enabled at Deep Power-down mode. + * | | |10 = Wake-up pin falling edge enabled at Deep Power-down mode. + * | | |11 = Wake-up pin both edge enabled at Deep Power-down mode. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[18] |ACMPSPWK |ACMP Standby Power-down Mode Wake-up Enable (Write Protect) + * | | |This is a protected register. Please refer to open lock sequence to program it. + * | | |0 = ACMP wake-up disable at Standby Power-down mode. + * | | |1 = ACMP wake-up enabled at Standby Power-down mode. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[23] |RTCWKEN |RTC Wake-up Enable (Write Protect) + * | | |This is a protected register. Please refer to open lock sequence to program it. + * | | |0 = RTC wake-up disable at Deep Power-down mode or Standby Power-down mode. + * | | |1 = RTC wake-up enabled at Deep Power-down mode or Standby Power-down mode. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * @var CLK_T::PMUSTS + * Offset: 0x94 Power Manager Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |PINWK |Pin Wake-up Flag (Read Only) + * | | |This flag indicates that wake-up of chip from Deep Power-down mode was requested by a transition of the WAKEUP pin (GPC.0) + * | | |This flag is cleared when DPD mode is entered. + * |[1] |TMRWK |Timer Wake-up Flag (Read Only) + * | | |This flag indicates that wake-up of chip from Deep Power-down mode (DPD) or Standby Power-down (SPD) mode was requested by wakeup timer time-out + * | | |This flag is cleared when DPD or SPD mode is entered. + * |[2] |RTCWK |RTC Wake-up Flag (Read Only) + * | | |This flag indicates that wakeup of device from Deep Power-down mode (DPD) or Standby Power-down (SPD) mode was requested with a RTC alarm, tick time or tamper happened + * | | |This flag is cleared when DPD or SPD mode is entered. + * |[8] |GPAWK |GPA Wake-up Flag (Read Only) + * | | |This flag indicates that wake-up of chip from Standby Power-down mode was requested by a transition of selected one GPA group pins + * | | |This flag is cleared when SPD mode is entered. + * |[9] |GPBWK |GPB Wake-up Flag (Read Only) + * | | |This flag indicates that wake-up of chip from Standby Power-down mode was requested by a transition of selected one GPB group pins + * | | |This flag is cleared when SPD mode is entered. + * |[10] |GPCWK |GPC Wake-up Flag (Read Only) + * | | |This flag indicates that wake-up of chip from Standby Power-down mode was requested by a transition of selected one GPC group pins + * | | |This flag is cleared when SPD mode is entered. + * |[11] |GPDWK |GPD Wake-up Flag (Read Only) + * | | |This flag indicates that wake-up of chip from Standby Power-down mode was requested by a transition of selected one GPD group pins + * | | |This flag is cleared when SPD mode is entered. + * |[12] |LVRWK |LVR Wake-up Flag (Read Only) + * | | |This flag indicates that wakeup of device from Standby Power-down mode was requested with a LVR happened + * | | |This flag is cleared when SPD mode is entered. + * |[13] |BODWK |BOD Wake-up Flag (Read Only) + * | | |This flag indicates that wakeup of device from Standby Power-down mode (SPD) was requested with a BOD happened + * | | |This flag is cleared when SPD mode is entered. + * |[14] |ACMPWK |ACMP Wake-up Flag (Read Only) + * | | |This flag indicates that wakeup of device from Standby Power-down mode (SPD) was requested with a ACMP transition + * | | |This flag is cleared when SPD mode is entered. + * |[31] |CLRWK |Clear Wake-up Flag + * | | |0 = No clear. + * | | |1 = Clear all wake-up flag. + * @var CLK_T::LDOCTL + * Offset: 0x98 LDO Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[18] |PDBIASEN |Power-down Bias Enable Bit + * | | |0 = Reserved. + * | | |1 = Power-down bias enabled. + * | | |Note: This bit should set to 1 before chip enter power-down mode. + * @var CLK_T::SWKDBCTL + * Offset: 0x9C Standby Power-down Wake-up De-bounce Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |SWKDBCLKSEL|Standby Power-down Wake-up De-bounce Sampling Cycle Selection + * | | |0000 = Sample wake-up input once per 1 clocks. + * | | |0001 = Sample wake-up input once per 2 clocks. + * | | |0010 = Sample wake-up input once per 4 clocks. + * | | |0011 = Sample wake-up input once per 8 clocks. + * | | |0100 = Sample wake-up input once per 16 clocks. + * | | |0101 = Sample wake-up input once per 32 clocks. + * | | |0110 = Sample wake-up input once per 64 clocks. + * | | |0111 = Sample wake-up input once per 128 clocks. + * | | |1000 = Sample wake-up input once per 256 clocks. + * | | |1001 = Sample wake-up input once per 2*256 clocks. + * | | |1010 = Sample wake-up input once per 4*256 clocks. + * | | |1011 = Sample wake-up input once per 8*256 clocks. + * | | |1100 = Sample wake-up input once per 16*256 clocks. + * | | |1101 = Sample wake-up input once per 32*256 clocks. + * | | |1110 = Sample wake-up input once per 64*256 clocks. + * | | |1111 = Sample wake-up input once per 128*256 clocks. + * | | |Note: De-bounce counter clock source is the 10 kHz internal low speed RC oscillator (LIRC). + * @var CLK_T::PASWKCTL + * Offset: 0xA0 GPA Standby Power-down Wake-up Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |WKEN |Standby Power-down Pin Wake-up Enable Bit + * | | |0 = GPA group pin wake-up function disabled. + * | | |1 = GPA group pin wake-up function enabled. + * |[1] |PRWKEN |Pin Rising Edge Wake-up Enable Bit + * | | |0 = GPA group pin rising edge wake-up function disabled. + * | | |1 = GPA group pin rising edge wake-up function enabled. + * |[2] |PFWKEN |Pin Falling Edge Wake-up Enable Bit + * | | |0 = GPA group pin falling edge wake-up function disabled. + * | | |1 = GPA group pin falling edge wake-up function enabled. + * |[7:4] |WKPSEL |GPA Standby Power-down Wake-up Pin Select + * | | |0000 = GPA.0 wake-up function enabled. + * | | |0001 = GPA.1 wake-up function enabled. + * | | |0010 = GPA.2 wake-up function enabled. + * | | |0011 = GPA.3 wake-up function enabled. + * | | |0100 = GPA.4 wake-up function enabled. + * | | |0101 = GPA.5 wake-up function enabled. + * | | |0110 = GPA.6 wake-up function enabled. + * | | |0111 = GPA.7 wake-up function enabled. + * | | |1000 = GPA.8 wake-up function enabled. + * | | |1001 = GPA.9 wake-up function enabled. + * | | |1010 = GPA.10 wake-up function enabled. + * | | |1011 = GPA.11 wake-up function enabled. + * | | |1100 = GPA.12 wake-up function enabled. + * | | |1101 = GPA.13 wake-up function enabled. + * | | |1110 = GPA.14 wake-up function enabled. + * | | |1111 = GPA.15 wake-up function enabled. + * |[8] |DBEN |GPA Input Signal De-bounce Enable Bit + * | | |The DBEN bit is used to enable the de-bounce function for each corresponding IO + * | | |If the input signal pulse width cannot be sampled by continuous two de-bounce sample cycle, the input signal transition is seen as the signal bounce and will not trigger the wake-up + * | | |The de-bounce clock source is the 10 kHz internal low speed RC oscillator. + * | | |0 = Standby power-down wake-up pin De-bounce function disable. + * | | |1 = Standby power-down wake-up pin De-bounce function enable. + * | | |The de-bounce function is valid only for edge triggered. + * @var CLK_T::PBSWKCTL + * Offset: 0xA4 GPB Standby Power-down Wake-up Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |WKEN |Standby Power-down Pin Wake-up Enable Bit + * | | |0 = GPB group pin wake-up function disabled. + * | | |1 = GPB group pin wake-up function enabled. + * |[1] |PRWKEN |Pin Rising Edge Wake-up Enable Bit + * | | |0 = GPB group pin rising edge wake-up function disabled. + * | | |1 = GPB group pin rising edge wake-up function enabled. + * |[2] |PFWKEN |Pin Falling Edge Wake-up Enable Bit + * | | |0 = GPB group pin falling edge wake-up function disabled. + * | | |1 = GPB group pin falling edge wake-up function enabled. + * |[7:4] |WKPSEL |GPB Standby Power-down Wake-up Pin Select + * | | |0000 = GPB.0 wake-up function enabled. + * | | |0001 = GPB.1 wake-up function enabled. + * | | |0010 = GPB.2 wake-up function enabled. + * | | |0011 = GPB.3 wake-up function enabled. + * | | |0100 = GPB.4 wake-up function enabled. + * | | |0101 = GPB.5 wake-up function enabled. + * | | |0110 = GPB.6 wake-up function enabled. + * | | |0111 = GPB.7 wake-up function enabled. + * | | |1000 = GPB.8 wake-up function enabled. + * | | |1001 = GPB.9 wake-up function enabled. + * | | |1010 = GPB.10 wake-up function enabled. + * | | |1011 = GPB.11 wake-up function enabled. + * | | |1100 = GPB.12 wake-up function enabled. + * | | |1101 = GPB.13 wake-up function enabled. + * | | |1110 = GPB.14 wake-up function enabled. + * | | |1111 = GPB.15 wake-up function enabled. + * |[8] |DBEN |GPB Input Signal De-bounce Enable Bit + * | | |The DBEN bit is used to enable the de-bounce function for each corresponding IO + * | | |If the input signal pulse width cannot be sampled by continuous two de-bounce sample cycle, the input signal transition is seen as the signal bounce and will not trigger the wake-up + * | | |The de-bounce clock source is the 10 kHz internal low speed RC oscillator. + * | | |0 = Standby power-down wake-up pin De-bounce function disable. + * | | |1 = Standby power-down wake-up pin De-bounce function enable. + * | | |The de-bounce function is valid only for edge triggered. + * @var CLK_T::PCSWKCTL + * Offset: 0xA8 GPC Standby Power-down Wake-up Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |WKEN |Standby Power-down Pin Wake-up Enable Bit + * | | |0 = GPC group pin wake-up function disabled. + * | | |1 = GPC group pin wake-up function enabled. + * |[1] |PRWKEN |Pin Rising Edge Wake-up Enable Bit + * | | |0 = GPC group pin rising edge wake-up function disabled. + * | | |1 = GPC group pin rising edge wake-up function enabled. + * |[2] |PFWKEN |Pin Falling Edge Wake-up Enable Bit + * | | |0 = GPC group pin falling edge wake-up function disabled. + * | | |1 = GPC group pin falling edge wake-up function enabled. + * |[7:4] |WKPSEL |GPC Standby Power-down Wake-up Pin Select + * | | |0000 = GPC.0 wake-up function enabled. + * | | |0001 = GPC.1 wake-up function enabled. + * | | |0010 = GPC.2 wake-up function enabled. + * | | |0011 = GPC.3 wake-up function enabled. + * | | |0100 = GPC.4 wake-up function enabled. + * | | |0101 = GPC.5 wake-up function enabled. + * | | |0110 = GPC.6 wake-up function enabled. + * | | |0111 = GPC.7 wake-up function enabled. + * | | |1000 = GPC.8 wake-up function enabled. + * | | |1001 = GPC.9 wake-up function enabled. + * | | |1010 = GPC.10 wake-up function enabled. + * | | |1011 = GPC.11 wake-up function enabled. + * | | |1100 = GPC.12 wake-up function enabled. + * | | |1101 = GPC.13 wake-up function enabled. + * | | |1110 = GPC.14 wake-up function enabled. + * | | |1111 = GPC.15 wake-up function enabled. + * |[8] |DBEN |GPC Input Signal De-bounce Enable Bit + * | | |The DBEN bit is used to enable the de-bounce function for each corresponding IO + * | | |If the input signal pulse width cannot be sampled by continuous two de-bounce sample cycle, the input signal transition is seen as the signal bounce and will not trigger the wake-up + * | | |The de-bounce clock source is the 10 kHz internal low speed RC oscillator. + * | | |0 = Standby power-down wake-up pin De-bounce function disable. + * | | |1 = Standby power-down wake-up pin De-bounce function enable. + * | | |The de-bounce function is valid only for edge triggered. + * @var CLK_T::PDSWKCTL + * Offset: 0xAC GPD Standby Power-down Wake-up Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |WKEN |Standby Power-down Pin Wake-up Enable Bit + * | | |0 = GPD group pin wake-up function disabled. + * | | |1 = GPD group pin wake-up function enabled. + * |[1] |PRWKEN |Pin Rising Edge Wake-up Enable Bit + * | | |0 = GPD group pin rising edge wake-up function disabled. + * | | |1 = GPD group pin rising edge wake-up function enabled. + * |[2] |PFWKEN |Pin Falling Edge Wake-up Enable Bit + * | | |0 = GPD group pin falling edge wake-up function disabled. + * | | |1 = GPD group pin falling edge wake-up function enabled. + * |[7:4] |WKPSEL |GPD Standby Power-down Wake-up Pin Select + * | | |0000 = GPD.0 wake-up function enabled. + * | | |0001 = GPD.1 wake-up function enabled. + * | | |0010 = GPD.2 wake-up function enabled. + * | | |0011 = GPD.3 wake-up function enabled. + * | | |0100 = GPD.4 wake-up function enabled. + * | | |0101 = GPD.5 wake-up function enabled. + * | | |0110 = GPD.6 wake-up function enabled. + * | | |0111 = GPD.7 wake-up function enabled. + * | | |1000 = GPD.8 wake-up function enabled. + * | | |1001 = GPD.9 wake-up function enabled. + * | | |1010 = GPD.10 wake-up function enabled. + * | | |1011 = GPD.11 wake-up function enabled. + * | | |1100 = GPD.12 wake-up function enabled. + * | | |1101 = GPD.13 wake-up function enabled. + * | | |1110 = GPD.14 wake-up function enabled. + * | | |1111 = GPD.15 wake-up function enabled. + * |[8] |DBEN |GPD Input Signal De-bounce Enable Bit + * | | |The DBEN bit is used to enable the de-bounce function for each corresponding IO + * | | |If the input signal pulse width cannot be sampled by continuous two de-bounce sample cycle, the input signal transition is seen as the signal bounce and will not trigger the wake-up + * | | |The de-bounce clock source is the 10 kHz internal low speed RC oscillator. + * | | |0 = Standby power-down wake-up pin De-bounce function disable. + * | | |1 = Standby power-down wake-up pin De-bounce function enable. + * | | |The de-bounce function is valid only for edge triggered. + * @var CLK_T::IOPDCTL + * Offset: 0xB0 GPIO Standby Power-down Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |IOHR |GPIO Hold Release + * | | |When GPIO enter standby power-down mode, all I/O status are hold to keep normal operating status + * | | |After chip was waked up from standby power-down mode, the I/O are still keep hold status until user set this bit to release I/O hold status. + * | | |This bit is auto cleared by hardware. + */ + __IO uint32_t PWRCTL; /*!< [0x0000] System Power-down Control Register */ + __IO uint32_t AHBCLK; /*!< [0x0004] AHB Devices Clock Enable Control Register */ + __IO uint32_t APBCLK0; /*!< [0x0008] APB Devices Clock Enable Control Register 0 */ + __IO uint32_t APBCLK1; /*!< [0x000c] APB Devices Clock Enable Control Register 1 */ + __IO uint32_t CLKSEL0; /*!< [0x0010] Clock Source Select Control Register 0 */ + __IO uint32_t CLKSEL1; /*!< [0x0014] Clock Source Select Control Register 1 */ + __IO uint32_t CLKSEL2; /*!< [0x0018] Clock Source Select Control Register 2 */ + __IO uint32_t CLKSEL3; /*!< [0x001c] Clock Source Select Control Register 3 */ + __IO uint32_t CLKDIV0; /*!< [0x0020] Clock Divider Number Register 0 */ + __IO uint32_t CLKDIV1; /*!< [0x0024] Clock Divider Number Register 1 */ + __IO uint32_t CLKDIV2; /*!< [0x0028] Clock Divider Number Register 2 */ + __IO uint32_t CLKDIV3; /*!< [0x002c] Clock Divider Number Register 3 */ + __IO uint32_t CLKDIV4; /*!< [0x0030] Clock Divider Number Register 4 */ + __IO uint32_t PCLKDIV; /*!< [0x0034] APB Clock Divider Register */ + /** @cond HIDDEN_SYMBOLS */ + __I uint32_t RESERVE1[2]; + /** @endcond */ + __IO uint32_t PLLCTL; /*!< [0x0040] PLL Control Register */ + /** @cond HIDDEN_SYMBOLS */ + __I uint32_t RESERVE2[3]; + /** @endcond */ + __I uint32_t STATUS; /*!< [0x0050] Clock Status Monitor Register */ + /** @cond HIDDEN_SYMBOLS */ + __I uint32_t RESERVE3[3]; + /** @endcond */ + __IO uint32_t CLKOCTL; /*!< [0x0060] Clock Output Control Register */ + /** @cond HIDDEN_SYMBOLS */ + __I uint32_t RESERVE4[3]; + /** @endcond */ + __IO uint32_t CLKDCTL; /*!< [0x0070] Clock Fail Detector Control Register */ + __IO uint32_t CLKDSTS; /*!< [0x0074] Clock Fail Detector Status Register */ + __IO uint32_t CDUPB; /*!< [0x0078] Clock Frequency Range Detector Upper Boundary Register */ + __IO uint32_t CDLOWB; /*!< [0x007c] Clock Frequency Range Detector Lower Boundary Register */ + /** @cond HIDDEN_SYMBOLS */ + __I uint32_t RESERVE5[4]; + /** @endcond */ + __IO uint32_t PMUCTL; /*!< [0x0090] Power Manager Control Register */ + __IO uint32_t PMUSTS; /*!< [0x0094] Power Manager Status Register */ + __IO uint32_t LDOCTL; /*!< [0x0098] LDO Control Register */ + __IO uint32_t SWKDBCTL; /*!< [0x009c] Standby Power-down Wake-up De-bounce Control Register */ + __IO uint32_t PASWKCTL; /*!< [0x00a0] GPA Standby Power-down Wake-up Control Register */ + __IO uint32_t PBSWKCTL; /*!< [0x00a4] GPB Standby Power-down Wake-up Control Register */ + __IO uint32_t PCSWKCTL; /*!< [0x00a8] GPC Standby Power-down Wake-up Control Register */ + __IO uint32_t PDSWKCTL; /*!< [0x00ac] GPD Standby Power-down Wake-up Control Register */ + __IO uint32_t IOPDCTL; /*!< [0x00b0] GPIO Standby Power-down Control Register */ + +} CLK_T; + +/** + @addtogroup CLK_CONST CLK Bit Field Definition + Constant Definitions for CLK Controller +@{ */ + +#define CLK_PWRCTL_HXTEN_Pos (0) /*!< CLK_T::PWRCTL: HXTEN Position */ +#define CLK_PWRCTL_HXTEN_Msk (0x1ul << CLK_PWRCTL_HXTEN_Pos) /*!< CLK_T::PWRCTL: HXTEN Mask */ + +#define CLK_PWRCTL_LXTEN_Pos (1) /*!< CLK_T::PWRCTL: LXTEN Position */ +#define CLK_PWRCTL_LXTEN_Msk (0x1ul << CLK_PWRCTL_LXTEN_Pos) /*!< CLK_T::PWRCTL: LXTEN Mask */ + +#define CLK_PWRCTL_HIRCEN_Pos (2) /*!< CLK_T::PWRCTL: HIRCEN Position */ +#define CLK_PWRCTL_HIRCEN_Msk (0x1ul << CLK_PWRCTL_HIRCEN_Pos) /*!< CLK_T::PWRCTL: HIRCEN Mask */ + +#define CLK_PWRCTL_LIRCEN_Pos (3) /*!< CLK_T::PWRCTL: LIRCEN Position */ +#define CLK_PWRCTL_LIRCEN_Msk (0x1ul << CLK_PWRCTL_LIRCEN_Pos) /*!< CLK_T::PWRCTL: LIRCEN Mask */ + +#define CLK_PWRCTL_PDWKDLY_Pos (4) /*!< CLK_T::PWRCTL: PDWKDLY Position */ +#define CLK_PWRCTL_PDWKDLY_Msk (0x1ul << CLK_PWRCTL_PDWKDLY_Pos) /*!< CLK_T::PWRCTL: PDWKDLY Mask */ + +#define CLK_PWRCTL_PDWKIEN_Pos (5) /*!< CLK_T::PWRCTL: PDWKIEN Position */ +#define CLK_PWRCTL_PDWKIEN_Msk (0x1ul << CLK_PWRCTL_PDWKIEN_Pos) /*!< CLK_T::PWRCTL: PDWKIEN Mask */ + +#define CLK_PWRCTL_PDWKIF_Pos (6) /*!< CLK_T::PWRCTL: PDWKIF Position */ +#define CLK_PWRCTL_PDWKIF_Msk (0x1ul << CLK_PWRCTL_PDWKIF_Pos) /*!< CLK_T::PWRCTL: PDWKIF Mask */ + +#define CLK_PWRCTL_PDEN_Pos (7) /*!< CLK_T::PWRCTL: PDEN Position */ +#define CLK_PWRCTL_PDEN_Msk (0x1ul << CLK_PWRCTL_PDEN_Pos) /*!< CLK_T::PWRCTL: PDEN Mask */ + +#define CLK_PWRCTL_HXTGAIN_Pos (10) /*!< CLK_T::PWRCTL: HXTGAIN Position */ +#define CLK_PWRCTL_HXTGAIN_Msk (0x3ul << CLK_PWRCTL_HXTGAIN_Pos) /*!< CLK_T::PWRCTL: HXTGAIN Mask */ + +#define CLK_PWRCTL_HXTSELTYP_Pos (12) /*!< CLK_T::PWRCTL: HXTSELTYP Position */ +#define CLK_PWRCTL_HXTSELTYP_Msk (0x1ul << CLK_PWRCTL_HXTSELTYP_Pos) /*!< CLK_T::PWRCTL: HXTSELTYP Mask */ + +#define CLK_PWRCTL_HXTTBEN_Pos (13) /*!< CLK_T::PWRCTL: HXTTBEN Position */ +#define CLK_PWRCTL_HXTTBEN_Msk (0x1ul << CLK_PWRCTL_HXTTBEN_Pos) /*!< CLK_T::PWRCTL: HXTTBEN Mask */ + +#define CLK_PWRCTL_HIRCSTBS_Pos (16) /*!< CLK_T::PWRCTL: HIRCSTBS Position */ +#define CLK_PWRCTL_HIRCSTBS_Msk (0x3ul << CLK_PWRCTL_HIRCSTBS_Pos) /*!< CLK_T::PWRCTL: HIRCSTBS Mask */ + +#define CLK_PWRCTL_HIRC48MEN_Pos (18) /*!< CLK_T::PWRCTL: HIRC48MEN Position */ +#define CLK_PWRCTL_HIRC48MEN_Msk (0x1ul << CLK_PWRCTL_HIRC48MEN_Pos) /*!< CLK_T::PWRCTL: HIRC48MEN Mask */ + +#define CLK_AHBCLK_PDMACKEN_Pos (1) /*!< CLK_T::AHBCLK: PDMACKEN Position */ +#define CLK_AHBCLK_PDMACKEN_Msk (0x1ul << CLK_AHBCLK_PDMACKEN_Pos) /*!< CLK_T::AHBCLK: PDMACKEN Mask */ + +#define CLK_AHBCLK_ISPCKEN_Pos (2) /*!< CLK_T::AHBCLK: ISPCKEN Position */ +#define CLK_AHBCLK_ISPCKEN_Msk (0x1ul << CLK_AHBCLK_ISPCKEN_Pos) /*!< CLK_T::AHBCLK: ISPCKEN Mask */ + +#define CLK_AHBCLK_EBICKEN_Pos (3) /*!< CLK_T::AHBCLK: EBICKEN Position */ +#define CLK_AHBCLK_EBICKEN_Msk (0x1ul << CLK_AHBCLK_EBICKEN_Pos) /*!< CLK_T::AHBCLK: EBICKEN Mask */ + +#define CLK_AHBCLK_EMACCKEN_Pos (5) /*!< CLK_T::AHBCLK: EMACCKEN Position */ +#define CLK_AHBCLK_EMACCKEN_Msk (0x1ul << CLK_AHBCLK_EMACCKEN_Pos) /*!< CLK_T::AHBCLK: EMACCKEN Mask */ + +#define CLK_AHBCLK_SDH0CKEN_Pos (6) /*!< CLK_T::AHBCLK: SDH0CKEN Position */ +#define CLK_AHBCLK_SDH0CKEN_Msk (0x1ul << CLK_AHBCLK_SDH0CKEN_Pos) /*!< CLK_T::AHBCLK: SDH0CKEN Mask */ + +#define CLK_AHBCLK_CRCCKEN_Pos (7) /*!< CLK_T::AHBCLK: CRCCKEN Position */ +#define CLK_AHBCLK_CRCCKEN_Msk (0x1ul << CLK_AHBCLK_CRCCKEN_Pos) /*!< CLK_T::AHBCLK: CRCCKEN Mask */ + +#define CLK_AHBCLK_CCAPCKEN_Pos (8) /*!< CLK_T::AHBCLK: CCAPCKEN Position */ +#define CLK_AHBCLK_CCAPCKEN_Msk (0x1ul << CLK_AHBCLK_CCAPCKEN_Pos) /*!< CLK_T::AHBCLK: CCAPCKEN Mask */ + +#define CLK_AHBCLK_SENCKEN_Pos (9) /*!< CLK_T::AHBCLK: SENCKEN Position */ +#define CLK_AHBCLK_SENCKEN_Msk (0x1ul << CLK_AHBCLK_SENCKEN_Pos) /*!< CLK_T::AHBCLK: SENCKEN Mask */ + +#define CLK_AHBCLK_HSUSBDCKEN_Pos (10) /*!< CLK_T::AHBCLK: HSUSBDCKEN Position */ +#define CLK_AHBCLK_HSUSBDCKEN_Msk (0x1ul << CLK_AHBCLK_HSUSBDCKEN_Pos) /*!< CLK_T::AHBCLK: HSUSBDCKEN Mask */ + +#define CLK_AHBCLK_CRPTCKEN_Pos (12) /*!< CLK_T::AHBCLK: CRPTCKEN Position */ +#define CLK_AHBCLK_CRPTCKEN_Msk (0x1ul << CLK_AHBCLK_CRPTCKEN_Pos) /*!< CLK_T::AHBCLK: CRPTCKEN Mask */ + +#define CLK_AHBCLK_SPIMCKEN_Pos (14) /*!< CLK_T::AHBCLK: SPIMCKEN Position */ +#define CLK_AHBCLK_SPIMCKEN_Msk (0x1ul << CLK_AHBCLK_SPIMCKEN_Pos) /*!< CLK_T::AHBCLK: SPIMCKEN Mask */ + +#define CLK_AHBCLK_FMCIDLE_Pos (15) /*!< CLK_T::AHBCLK: FMCIDLE Position */ +#define CLK_AHBCLK_FMCIDLE_Msk (0x1ul << CLK_AHBCLK_FMCIDLE_Pos) /*!< CLK_T::AHBCLK: FMCIDLE Mask */ + +#define CLK_AHBCLK_USBHCKEN_Pos (16) /*!< CLK_T::AHBCLK: USBHCKEN Position */ +#define CLK_AHBCLK_USBHCKEN_Msk (0x1ul << CLK_AHBCLK_USBHCKEN_Pos) /*!< CLK_T::AHBCLK: USBHCKEN Mask */ + +#define CLK_AHBCLK_SDH1CKEN_Pos (17) /*!< CLK_T::AHBCLK: SDH1CKEN Position */ +#define CLK_AHBCLK_SDH1CKEN_Msk (0x1ul << CLK_AHBCLK_SDH1CKEN_Pos) /*!< CLK_T::AHBCLK: SDH1CKEN Mask */ + +#define CLK_APBCLK0_WDTCKEN_Pos (0) /*!< CLK_T::APBCLK0: WDTCKEN Position */ +#define CLK_APBCLK0_WDTCKEN_Msk (0x1ul << CLK_APBCLK0_WDTCKEN_Pos) /*!< CLK_T::APBCLK0: WDTCKEN Mask */ + +#define CLK_APBCLK0_RTCCKEN_Pos (1) /*!< CLK_T::APBCLK0: RTCCKEN Position */ +#define CLK_APBCLK0_RTCCKEN_Msk (0x1ul << CLK_APBCLK0_RTCCKEN_Pos) /*!< CLK_T::APBCLK0: RTCCKEN Mask */ + +#define CLK_APBCLK0_TMR0CKEN_Pos (2) /*!< CLK_T::APBCLK0: TMR0CKEN Position */ +#define CLK_APBCLK0_TMR0CKEN_Msk (0x1ul << CLK_APBCLK0_TMR0CKEN_Pos) /*!< CLK_T::APBCLK0: TMR0CKEN Mask */ + +#define CLK_APBCLK0_TMR1CKEN_Pos (3) /*!< CLK_T::APBCLK0: TMR1CKEN Position */ +#define CLK_APBCLK0_TMR1CKEN_Msk (0x1ul << CLK_APBCLK0_TMR1CKEN_Pos) /*!< CLK_T::APBCLK0: TMR1CKEN Mask */ + +#define CLK_APBCLK0_TMR2CKEN_Pos (4) /*!< CLK_T::APBCLK0: TMR2CKEN Position */ +#define CLK_APBCLK0_TMR2CKEN_Msk (0x1ul << CLK_APBCLK0_TMR2CKEN_Pos) /*!< CLK_T::APBCLK0: TMR2CKEN Mask */ + +#define CLK_APBCLK0_TMR3CKEN_Pos (5) /*!< CLK_T::APBCLK0: TMR3CKEN Position */ +#define CLK_APBCLK0_TMR3CKEN_Msk (0x1ul << CLK_APBCLK0_TMR3CKEN_Pos) /*!< CLK_T::APBCLK0: TMR3CKEN Mask */ + +#define CLK_APBCLK0_CLKOCKEN_Pos (6) /*!< CLK_T::APBCLK0: CLKOCKEN Position */ +#define CLK_APBCLK0_CLKOCKEN_Msk (0x1ul << CLK_APBCLK0_CLKOCKEN_Pos) /*!< CLK_T::APBCLK0: CLKOCKEN Mask */ + +#define CLK_APBCLK0_ACMP01CKEN_Pos (7) /*!< CLK_T::APBCLK0: ACMP01CKEN Position */ +#define CLK_APBCLK0_ACMP01CKEN_Msk (0x1ul << CLK_APBCLK0_ACMP01CKEN_Pos) /*!< CLK_T::APBCLK0: ACMP01CKEN Mask */ + +#define CLK_APBCLK0_I2C0CKEN_Pos (8) /*!< CLK_T::APBCLK0: I2C0CKEN Position */ +#define CLK_APBCLK0_I2C0CKEN_Msk (0x1ul << CLK_APBCLK0_I2C0CKEN_Pos) /*!< CLK_T::APBCLK0: I2C0CKEN Mask */ + +#define CLK_APBCLK0_I2C1CKEN_Pos (9) /*!< CLK_T::APBCLK0: I2C1CKEN Position */ +#define CLK_APBCLK0_I2C1CKEN_Msk (0x1ul << CLK_APBCLK0_I2C1CKEN_Pos) /*!< CLK_T::APBCLK0: I2C1CKEN Mask */ + +#define CLK_APBCLK0_I2C2CKEN_Pos (10) /*!< CLK_T::APBCLK0: I2C2CKEN Position */ +#define CLK_APBCLK0_I2C2CKEN_Msk (0x1ul << CLK_APBCLK0_I2C2CKEN_Pos) /*!< CLK_T::APBCLK0: I2C2CKEN Mask */ + +#define CLK_APBCLK0_QSPI0CKEN_Pos (12) /*!< CLK_T::APBCLK0: QSPI0CKEN Position */ +#define CLK_APBCLK0_QSPI0CKEN_Msk (0x1ul << CLK_APBCLK0_QSPI0CKEN_Pos) /*!< CLK_T::APBCLK0: QSPI0CKEN Mask */ + +#define CLK_APBCLK0_SPI0CKEN_Pos (13) /*!< CLK_T::APBCLK0: SPI0CKEN Position */ +#define CLK_APBCLK0_SPI0CKEN_Msk (0x1ul << CLK_APBCLK0_SPI0CKEN_Pos) /*!< CLK_T::APBCLK0: SPI0CKEN Mask */ + +#define CLK_APBCLK0_SPI1CKEN_Pos (14) /*!< CLK_T::APBCLK0: SPI1CKEN Position */ +#define CLK_APBCLK0_SPI1CKEN_Msk (0x1ul << CLK_APBCLK0_SPI1CKEN_Pos) /*!< CLK_T::APBCLK0: SPI1CKEN Mask */ + +#define CLK_APBCLK0_SPI2CKEN_Pos (15) /*!< CLK_T::APBCLK0: SPI2CKEN Position */ +#define CLK_APBCLK0_SPI2CKEN_Msk (0x1ul << CLK_APBCLK0_SPI2CKEN_Pos) /*!< CLK_T::APBCLK0: SPI2CKEN Mask */ + +#define CLK_APBCLK0_UART0CKEN_Pos (16) /*!< CLK_T::APBCLK0: UART0CKEN Position */ +#define CLK_APBCLK0_UART0CKEN_Msk (0x1ul << CLK_APBCLK0_UART0CKEN_Pos) /*!< CLK_T::APBCLK0: UART0CKEN Mask */ + +#define CLK_APBCLK0_UART1CKEN_Pos (17) /*!< CLK_T::APBCLK0: UART1CKEN Position */ +#define CLK_APBCLK0_UART1CKEN_Msk (0x1ul << CLK_APBCLK0_UART1CKEN_Pos) /*!< CLK_T::APBCLK0: UART1CKEN Mask */ + +#define CLK_APBCLK0_UART2CKEN_Pos (18) /*!< CLK_T::APBCLK0: UART2CKEN Position */ +#define CLK_APBCLK0_UART2CKEN_Msk (0x1ul << CLK_APBCLK0_UART2CKEN_Pos) /*!< CLK_T::APBCLK0: UART2CKEN Mask */ + +#define CLK_APBCLK0_UART3CKEN_Pos (19) /*!< CLK_T::APBCLK0: UART3CKEN Position */ +#define CLK_APBCLK0_UART3CKEN_Msk (0x1ul << CLK_APBCLK0_UART3CKEN_Pos) /*!< CLK_T::APBCLK0: UART3CKEN Mask */ + +#define CLK_APBCLK0_UART4CKEN_Pos (20) /*!< CLK_T::APBCLK0: UART4CKEN Position */ +#define CLK_APBCLK0_UART4CKEN_Msk (0x1ul << CLK_APBCLK0_UART4CKEN_Pos) /*!< CLK_T::APBCLK0: UART4CKEN Mask */ + +#define CLK_APBCLK0_UART5CKEN_Pos (21) /*!< CLK_T::APBCLK0: UART5CKEN Position */ +#define CLK_APBCLK0_UART5CKEN_Msk (0x1ul << CLK_APBCLK0_UART5CKEN_Pos) /*!< CLK_T::APBCLK0: UART5CKEN Mask */ + +#define CLK_APBCLK0_UART6CKEN_Pos (22) /*!< CLK_T::APBCLK0: UART6CKEN Position */ +#define CLK_APBCLK0_UART6CKEN_Msk (0x1ul << CLK_APBCLK0_UART6CKEN_Pos) /*!< CLK_T::APBCLK0: UART6CKEN Mask */ + +#define CLK_APBCLK0_UART7CKEN_Pos (23) /*!< CLK_T::APBCLK0: UART7CKEN Position */ +#define CLK_APBCLK0_UART7CKEN_Msk (0x1ul << CLK_APBCLK0_UART7CKEN_Pos) /*!< CLK_T::APBCLK0: UART7CKEN Mask */ + +#define CLK_APBCLK0_CAN0CKEN_Pos (24) /*!< CLK_T::APBCLK0: CAN0CKEN Position */ +#define CLK_APBCLK0_CAN0CKEN_Msk (0x1ul << CLK_APBCLK0_CAN0CKEN_Pos) /*!< CLK_T::APBCLK0: CAN0CKEN Mask */ + +#define CLK_APBCLK0_CAN1CKEN_Pos (25) /*!< CLK_T::APBCLK0: CAN1CKEN Position */ +#define CLK_APBCLK0_CAN1CKEN_Msk (0x1ul << CLK_APBCLK0_CAN1CKEN_Pos) /*!< CLK_T::APBCLK0: CAN1CKEN Mask */ + +#define CLK_APBCLK0_OTGCKEN_Pos (26) /*!< CLK_T::APBCLK0: OTGCKEN Position */ +#define CLK_APBCLK0_OTGCKEN_Msk (0x1ul << CLK_APBCLK0_OTGCKEN_Pos) /*!< CLK_T::APBCLK0: OTGCKEN Mask */ + +#define CLK_APBCLK0_USBDCKEN_Pos (27) /*!< CLK_T::APBCLK0: USBDCKEN Position */ +#define CLK_APBCLK0_USBDCKEN_Msk (0x1ul << CLK_APBCLK0_USBDCKEN_Pos) /*!< CLK_T::APBCLK0: USBDCKEN Mask */ + +#define CLK_APBCLK0_EADCCKEN_Pos (28) /*!< CLK_T::APBCLK0: EADCCKEN Position */ +#define CLK_APBCLK0_EADCCKEN_Msk (0x1ul << CLK_APBCLK0_EADCCKEN_Pos) /*!< CLK_T::APBCLK0: EADCCKEN Mask */ + +#define CLK_APBCLK0_I2S0CKEN_Pos (29) /*!< CLK_T::APBCLK0: I2S0CKEN Position */ +#define CLK_APBCLK0_I2S0CKEN_Msk (0x1ul << CLK_APBCLK0_I2S0CKEN_Pos) /*!< CLK_T::APBCLK0: I2S0CKEN Mask */ + +#define CLK_APBCLK0_HSOTGCKEN_Pos (30) /*!< CLK_T::APBCLK0: HSOTGCKEN Position */ +#define CLK_APBCLK0_HSOTGCKEN_Msk (0x1ul << CLK_APBCLK0_HSOTGCKEN_Pos) /*!< CLK_T::APBCLK0: HSOTGCKEN Mask */ + +#define CLK_APBCLK1_SC0CKEN_Pos (0) /*!< CLK_T::APBCLK1: SC0CKEN Position */ +#define CLK_APBCLK1_SC0CKEN_Msk (0x1ul << CLK_APBCLK1_SC0CKEN_Pos) /*!< CLK_T::APBCLK1: SC0CKEN Mask */ + +#define CLK_APBCLK1_SC1CKEN_Pos (1) /*!< CLK_T::APBCLK1: SC1CKEN Position */ +#define CLK_APBCLK1_SC1CKEN_Msk (0x1ul << CLK_APBCLK1_SC1CKEN_Pos) /*!< CLK_T::APBCLK1: SC1CKEN Mask */ + +#define CLK_APBCLK1_SC2CKEN_Pos (2) /*!< CLK_T::APBCLK1: SC2CKEN Position */ +#define CLK_APBCLK1_SC2CKEN_Msk (0x1ul << CLK_APBCLK1_SC2CKEN_Pos) /*!< CLK_T::APBCLK1: SC2CKEN Mask */ + +#define CLK_APBCLK1_QSPI1CKEN_Pos (4) /*!< CLK_T::APBCLK1: QSPI1CKEN Position */ +#define CLK_APBCLK1_QSPI1CKEN_Msk (0x1ul << CLK_APBCLK1_QSPI1CKEN_Pos) /*!< CLK_T::APBCLK1: QSPI1CKEN Mask */ + +#define CLK_APBCLK1_SPI3CKEN_Pos (6) /*!< CLK_T::APBCLK1: SPI3CKEN Position */ +#define CLK_APBCLK1_SPI3CKEN_Msk (0x1ul << CLK_APBCLK1_SPI3CKEN_Pos) /*!< CLK_T::APBCLK1: SPI3CKEN Mask */ + +#define CLK_APBCLK1_USCI0CKEN_Pos (8) /*!< CLK_T::APBCLK1: USCI0CKEN Position */ +#define CLK_APBCLK1_USCI0CKEN_Msk (0x1ul << CLK_APBCLK1_USCI0CKEN_Pos) /*!< CLK_T::APBCLK1: USCI0CKEN Mask */ + +#define CLK_APBCLK1_USCI1CKEN_Pos (9) /*!< CLK_T::APBCLK1: USCI1CKEN Position */ +#define CLK_APBCLK1_USCI1CKEN_Msk (0x1ul << CLK_APBCLK1_USCI1CKEN_Pos) /*!< CLK_T::APBCLK1: USCI1CKEN Mask */ + +#define CLK_APBCLK1_DACCKEN_Pos (12) /*!< CLK_T::APBCLK1: DACCKEN Position */ +#define CLK_APBCLK1_DACCKEN_Msk (0x1ul << CLK_APBCLK1_DACCKEN_Pos) /*!< CLK_T::APBCLK1: DACCKEN Mask */ + +#define CLK_APBCLK1_EPWM0CKEN_Pos (16) /*!< CLK_T::APBCLK1: EPWM0CKEN Position */ +#define CLK_APBCLK1_EPWM0CKEN_Msk (0x1ul << CLK_APBCLK1_EPWM0CKEN_Pos) /*!< CLK_T::APBCLK1: EPWM0CKEN Mask */ + +#define CLK_APBCLK1_EPWM1CKEN_Pos (17) /*!< CLK_T::APBCLK1: EPWM1CKEN Position */ +#define CLK_APBCLK1_EPWM1CKEN_Msk (0x1ul << CLK_APBCLK1_EPWM1CKEN_Pos) /*!< CLK_T::APBCLK1: EPWM1CKEN Mask */ + +#define CLK_APBCLK1_BPWM0CKEN_Pos (18) /*!< CLK_T::APBCLK1: BPWM0CKEN Position */ +#define CLK_APBCLK1_BPWM0CKEN_Msk (0x1ul << CLK_APBCLK1_BPWM0CKEN_Pos) /*!< CLK_T::APBCLK1: BPWM0CKEN Mask */ + +#define CLK_APBCLK1_BPWM1CKEN_Pos (19) /*!< CLK_T::APBCLK1: BPWM1CKEN Position */ +#define CLK_APBCLK1_BPWM1CKEN_Msk (0x1ul << CLK_APBCLK1_BPWM1CKEN_Pos) /*!< CLK_T::APBCLK1: BPWM1CKEN Mask */ + +#define CLK_APBCLK1_QEI0CKEN_Pos (22) /*!< CLK_T::APBCLK1: QEI0CKEN Position */ +#define CLK_APBCLK1_QEI0CKEN_Msk (0x1ul << CLK_APBCLK1_QEI0CKEN_Pos) /*!< CLK_T::APBCLK1: QEI0CKEN Mask */ + +#define CLK_APBCLK1_QEI1CKEN_Pos (23) /*!< CLK_T::APBCLK1: QEI1CKEN Position */ +#define CLK_APBCLK1_QEI1CKEN_Msk (0x1ul << CLK_APBCLK1_QEI1CKEN_Pos) /*!< CLK_T::APBCLK1: QEI1CKEN Mask */ + +#define CLK_APBCLK1_TRNGCKEN_Pos (25) /*!< CLK_T::APBCLK1: TRNGCKEN Position */ +#define CLK_APBCLK1_TRNGCKEN_Msk (0x1ul << CLK_APBCLK1_TRNGCKEN_Pos) /*!< CLK_T::APBCLK1: TRNGCKEN Mask */ + +#define CLK_APBCLK1_ECAP0CKEN_Pos (26) /*!< CLK_T::APBCLK1: ECAP0CKEN Position */ +#define CLK_APBCLK1_ECAP0CKEN_Msk (0x1ul << CLK_APBCLK1_ECAP0CKEN_Pos) /*!< CLK_T::APBCLK1: ECAP0CKEN Mask */ + +#define CLK_APBCLK1_ECAP1CKEN_Pos (27) /*!< CLK_T::APBCLK1: ECAP1CKEN Position */ +#define CLK_APBCLK1_ECAP1CKEN_Msk (0x1ul << CLK_APBCLK1_ECAP1CKEN_Pos) /*!< CLK_T::APBCLK1: ECAP1CKEN Mask */ + +#define CLK_APBCLK1_CAN2CKEN_Pos (28) /*!< CLK_T::APBCLK1: CAN2CKEN Position */ +#define CLK_APBCLK1_CAN2CKEN_Msk (0x1ul << CLK_APBCLK1_CAN2CKEN_Pos) /*!< CLK_T::APBCLK1: CAN2CKEN Mask */ + +#define CLK_APBCLK1_OPACKEN_Pos (30) /*!< CLK_T::APBCLK1: OPACKEN Position */ +#define CLK_APBCLK1_OPACKEN_Msk (0x1ul << CLK_APBCLK1_OPACKEN_Pos) /*!< CLK_T::APBCLK1: OPACKEN Mask */ + +#define CLK_APBCLK1_EADC1CKEN_Pos (31) /*!< CLK_T::APBCLK1: EADC1CKEN Position */ +#define CLK_APBCLK1_EADC1CKEN_Msk (0x1ul << CLK_APBCLK1_EADC1CKEN_Pos) /*!< CLK_T::APBCLK1: EADC1CKEN Mask */ + +#define CLK_CLKSEL0_HCLKSEL_Pos (0) /*!< CLK_T::CLKSEL0: HCLKSEL Position */ +#define CLK_CLKSEL0_HCLKSEL_Msk (0x7ul << CLK_CLKSEL0_HCLKSEL_Pos) /*!< CLK_T::CLKSEL0: HCLKSEL Mask */ + +#define CLK_CLKSEL0_STCLKSEL_Pos (3) /*!< CLK_T::CLKSEL0: STCLKSEL Position */ +#define CLK_CLKSEL0_STCLKSEL_Msk (0x7ul << CLK_CLKSEL0_STCLKSEL_Pos) /*!< CLK_T::CLKSEL0: STCLKSEL Mask */ + +#define CLK_CLKSEL0_USBSEL_Pos (8) /*!< CLK_T::CLKSEL0: PCLK0SEL Position */ +#define CLK_CLKSEL0_USBSEL_Msk (0x1ul << CLK_CLKSEL0_USBSEL_Pos) /*!< CLK_T::CLKSEL0: PCLK0SEL Mask */ + +#define CLK_CLKSEL0_CCAPSEL_Pos (16) /*!< CLK_T::CLKSEL0: CCAPSEL Position */ +#define CLK_CLKSEL0_CCAPSEL_Msk (0x3ul << CLK_CLKSEL0_CCAPSEL_Pos) /*!< CLK_T::CLKSEL0: CCAPSEL Mask */ + +#define CLK_CLKSEL0_SDH0SEL_Pos (20) /*!< CLK_T::CLKSEL0: SDH0SEL Position */ +#define CLK_CLKSEL0_SDH0SEL_Msk (0x3ul << CLK_CLKSEL0_SDH0SEL_Pos) /*!< CLK_T::CLKSEL0: SDH0SEL Mask */ + +#define CLK_CLKSEL0_SDH1SEL_Pos (22) /*!< CLK_T::CLKSEL0: SDH1SEL Position */ +#define CLK_CLKSEL0_SDH1SEL_Msk (0x3ul << CLK_CLKSEL0_SDH1SEL_Pos) /*!< CLK_T::CLKSEL0: SDH1SEL Mask */ + +#define CLK_CLKSEL1_WDTSEL_Pos (0) /*!< CLK_T::CLKSEL1: WDTSEL Position */ +#define CLK_CLKSEL1_WDTSEL_Msk (0x3ul << CLK_CLKSEL1_WDTSEL_Pos) /*!< CLK_T::CLKSEL1: WDTSEL Mask */ + +#define CLK_CLKSEL1_TMR0SEL_Pos (8) /*!< CLK_T::CLKSEL1: TMR0SEL Position */ +#define CLK_CLKSEL1_TMR0SEL_Msk (0x7ul << CLK_CLKSEL1_TMR0SEL_Pos) /*!< CLK_T::CLKSEL1: TMR0SEL Mask */ + +#define CLK_CLKSEL1_TMR1SEL_Pos (12) /*!< CLK_T::CLKSEL1: TMR1SEL Position */ +#define CLK_CLKSEL1_TMR1SEL_Msk (0x7ul << CLK_CLKSEL1_TMR1SEL_Pos) /*!< CLK_T::CLKSEL1: TMR1SEL Mask */ + +#define CLK_CLKSEL1_TMR2SEL_Pos (16) /*!< CLK_T::CLKSEL1: TMR2SEL Position */ +#define CLK_CLKSEL1_TMR2SEL_Msk (0x7ul << CLK_CLKSEL1_TMR2SEL_Pos) /*!< CLK_T::CLKSEL1: TMR2SEL Mask */ + +#define CLK_CLKSEL1_TMR3SEL_Pos (20) /*!< CLK_T::CLKSEL1: TMR3SEL Position */ +#define CLK_CLKSEL1_TMR3SEL_Msk (0x7ul << CLK_CLKSEL1_TMR3SEL_Pos) /*!< CLK_T::CLKSEL1: TMR3SEL Mask */ + +#define CLK_CLKSEL1_UART0SEL_Pos (24) /*!< CLK_T::CLKSEL1: UART0SEL Position */ +#define CLK_CLKSEL1_UART0SEL_Msk (0x3ul << CLK_CLKSEL1_UART0SEL_Pos) /*!< CLK_T::CLKSEL1: UART0SEL Mask */ + +#define CLK_CLKSEL1_UART1SEL_Pos (26) /*!< CLK_T::CLKSEL1: UART1SEL Position */ +#define CLK_CLKSEL1_UART1SEL_Msk (0x3ul << CLK_CLKSEL1_UART1SEL_Pos) /*!< CLK_T::CLKSEL1: UART1SEL Mask */ + +#define CLK_CLKSEL1_CLKOSEL_Pos (28) /*!< CLK_T::CLKSEL1: CLKOSEL Position */ +#define CLK_CLKSEL1_CLKOSEL_Msk (0x3ul << CLK_CLKSEL1_CLKOSEL_Pos) /*!< CLK_T::CLKSEL1: CLKOSEL Mask */ + +#define CLK_CLKSEL1_WWDTSEL_Pos (30) /*!< CLK_T::CLKSEL1: WWDTSEL Position */ +#define CLK_CLKSEL1_WWDTSEL_Msk (0x3ul << CLK_CLKSEL1_WWDTSEL_Pos) /*!< CLK_T::CLKSEL1: WWDTSEL Mask */ + +#define CLK_CLKSEL2_EPWM0SEL_Pos (0) /*!< CLK_T::CLKSEL2: EPWM0SEL Position */ +#define CLK_CLKSEL2_EPWM0SEL_Msk (0x1ul << CLK_CLKSEL2_EPWM0SEL_Pos) /*!< CLK_T::CLKSEL2: EPWM0SEL Mask */ + +#define CLK_CLKSEL2_EPWM1SEL_Pos (1) /*!< CLK_T::CLKSEL2: EPWM1SEL Position */ +#define CLK_CLKSEL2_EPWM1SEL_Msk (0x1ul << CLK_CLKSEL2_EPWM1SEL_Pos) /*!< CLK_T::CLKSEL2: EPWM1SEL Mask */ + +#define CLK_CLKSEL2_QSPI0SEL_Pos (2) /*!< CLK_T::CLKSEL2: QSPI0SEL Position */ +#define CLK_CLKSEL2_QSPI0SEL_Msk (0x3ul << CLK_CLKSEL2_QSPI0SEL_Pos) /*!< CLK_T::CLKSEL2: QSPI0SEL Mask */ + +#define CLK_CLKSEL2_SPI0SEL_Pos (4) /*!< CLK_T::CLKSEL2: SPI0SEL Position */ +#define CLK_CLKSEL2_SPI0SEL_Msk (0x3ul << CLK_CLKSEL2_SPI0SEL_Pos) /*!< CLK_T::CLKSEL2: SPI0SEL Mask */ + +#define CLK_CLKSEL2_SPI1SEL_Pos (6) /*!< CLK_T::CLKSEL2: SPI1SEL Position */ +#define CLK_CLKSEL2_SPI1SEL_Msk (0x3ul << CLK_CLKSEL2_SPI1SEL_Pos) /*!< CLK_T::CLKSEL2: SPI1SEL Mask */ + +#define CLK_CLKSEL2_BPWM0SEL_Pos (8) /*!< CLK_T::CLKSEL2: BPWM0SEL Position */ +#define CLK_CLKSEL2_BPWM0SEL_Msk (0x1ul << CLK_CLKSEL2_BPWM0SEL_Pos) /*!< CLK_T::CLKSEL2: BPWM0SEL Mask */ + +#define CLK_CLKSEL2_BPWM1SEL_Pos (9) /*!< CLK_T::CLKSEL2: BPWM1SEL Position */ +#define CLK_CLKSEL2_BPWM1SEL_Msk (0x1ul << CLK_CLKSEL2_BPWM1SEL_Pos) /*!< CLK_T::CLKSEL2: BPWM1SEL Mask */ + +#define CLK_CLKSEL2_SPI2SEL_Pos (10) /*!< CLK_T::CLKSEL2: SPI2SEL Position */ +#define CLK_CLKSEL2_SPI2SEL_Msk (0x3ul << CLK_CLKSEL2_SPI2SEL_Pos) /*!< CLK_T::CLKSEL2: SPI2SEL Mask */ + +#define CLK_CLKSEL2_SPI3SEL_Pos (12) /*!< CLK_T::CLKSEL2: SPI3SEL Position */ +#define CLK_CLKSEL2_SPI3SEL_Msk (0x3ul << CLK_CLKSEL2_SPI3SEL_Pos) /*!< CLK_T::CLKSEL2: SPI3SEL Mask */ + +#define CLK_CLKSEL3_SC0SEL_Pos (0) /*!< CLK_T::CLKSEL3: SC0SEL Position */ +#define CLK_CLKSEL3_SC0SEL_Msk (0x3ul << CLK_CLKSEL3_SC0SEL_Pos) /*!< CLK_T::CLKSEL3: SC0SEL Mask */ + +#define CLK_CLKSEL3_SC1SEL_Pos (2) /*!< CLK_T::CLKSEL3: SC1SEL Position */ +#define CLK_CLKSEL3_SC1SEL_Msk (0x3ul << CLK_CLKSEL3_SC1SEL_Pos) /*!< CLK_T::CLKSEL3: SC1SEL Mask */ + +#define CLK_CLKSEL3_SC2SEL_Pos (4) /*!< CLK_T::CLKSEL3: SC2SEL Position */ +#define CLK_CLKSEL3_SC2SEL_Msk (0x3ul << CLK_CLKSEL3_SC2SEL_Pos) /*!< CLK_T::CLKSEL3: SC2SEL Mask */ + +#define CLK_CLKSEL3_RTCSEL_Pos (8) /*!< CLK_T::CLKSEL3: RTCSEL Position */ +#define CLK_CLKSEL3_RTCSEL_Msk (0x1ul << CLK_CLKSEL3_RTCSEL_Pos) /*!< CLK_T::CLKSEL3: RTCSEL Mask */ + +#define CLK_CLKSEL3_QSPI1SEL_Pos (12) /*!< CLK_T::CLKSEL3: QSPI1SEL Position */ +#define CLK_CLKSEL3_QSPI1SEL_Msk (0x3ul << CLK_CLKSEL3_QSPI1SEL_Pos) /*!< CLK_T::CLKSEL3: QSPI1SEL Mask */ + +#define CLK_CLKSEL3_I2S0SEL_Pos (16) /*!< CLK_T::CLKSEL3: I2S0SEL Position */ +#define CLK_CLKSEL3_I2S0SEL_Msk (0x3ul << CLK_CLKSEL3_I2S0SEL_Pos) /*!< CLK_T::CLKSEL3: I2S0SEL Mask */ + +#define CLK_CLKSEL3_UART6SEL_Pos (20) /*!< CLK_T::CLKSEL3: UART6SEL Position */ +#define CLK_CLKSEL3_UART6SEL_Msk (0x3ul << CLK_CLKSEL3_UART6SEL_Pos) /*!< CLK_T::CLKSEL3: UART6SEL Mask */ + +#define CLK_CLKSEL3_UART7SEL_Pos (22) /*!< CLK_T::CLKSEL3: UART7SEL Position */ +#define CLK_CLKSEL3_UART7SEL_Msk (0x3ul << CLK_CLKSEL3_UART7SEL_Pos) /*!< CLK_T::CLKSEL3: UART7SEL Mask */ + +#define CLK_CLKSEL3_UART2SEL_Pos (24) /*!< CLK_T::CLKSEL3: UART2SEL Position */ +#define CLK_CLKSEL3_UART2SEL_Msk (0x3ul << CLK_CLKSEL3_UART2SEL_Pos) /*!< CLK_T::CLKSEL3: UART2SEL Mask */ + +#define CLK_CLKSEL3_UART3SEL_Pos (26) /*!< CLK_T::CLKSEL3: UART3SEL Position */ +#define CLK_CLKSEL3_UART3SEL_Msk (0x3ul << CLK_CLKSEL3_UART3SEL_Pos) /*!< CLK_T::CLKSEL3: UART3SEL Mask */ + +#define CLK_CLKSEL3_UART4SEL_Pos (28) /*!< CLK_T::CLKSEL3: UART4SEL Position */ +#define CLK_CLKSEL3_UART4SEL_Msk (0x3ul << CLK_CLKSEL3_UART4SEL_Pos) /*!< CLK_T::CLKSEL3: UART4SEL Mask */ + +#define CLK_CLKSEL3_UART5SEL_Pos (30) /*!< CLK_T::CLKSEL3: UART5SEL Position */ +#define CLK_CLKSEL3_UART5SEL_Msk (0x3ul << CLK_CLKSEL3_UART5SEL_Pos) /*!< CLK_T::CLKSEL3: UART5SEL Mask */ + +#define CLK_CLKDIV0_HCLKDIV_Pos (0) /*!< CLK_T::CLKDIV0: HCLKDIV Position */ +#define CLK_CLKDIV0_HCLKDIV_Msk (0xful << CLK_CLKDIV0_HCLKDIV_Pos) /*!< CLK_T::CLKDIV0: HCLKDIV Mask */ + +#define CLK_CLKDIV0_USBDIV_Pos (4) /*!< CLK_T::CLKDIV0: USBDIV Position */ +#define CLK_CLKDIV0_USBDIV_Msk (0xful << CLK_CLKDIV0_USBDIV_Pos) /*!< CLK_T::CLKDIV0: USBDIV Mask */ + +#define CLK_CLKDIV0_UART0DIV_Pos (8) /*!< CLK_T::CLKDIV0: UART0DIV Position */ +#define CLK_CLKDIV0_UART0DIV_Msk (0xful << CLK_CLKDIV0_UART0DIV_Pos) /*!< CLK_T::CLKDIV0: UART0DIV Mask */ + +#define CLK_CLKDIV0_UART1DIV_Pos (12) /*!< CLK_T::CLKDIV0: UART1DIV Position */ +#define CLK_CLKDIV0_UART1DIV_Msk (0xful << CLK_CLKDIV0_UART1DIV_Pos) /*!< CLK_T::CLKDIV0: UART1DIV Mask */ + +#define CLK_CLKDIV0_EADCDIV_Pos (16) /*!< CLK_T::CLKDIV0: EADCDIV Position */ +#define CLK_CLKDIV0_EADCDIV_Msk (0xfful << CLK_CLKDIV0_EADCDIV_Pos) /*!< CLK_T::CLKDIV0: EADCDIV Mask */ + +#define CLK_CLKDIV0_SDH0DIV_Pos (24) /*!< CLK_T::CLKDIV0: SDH0DIV Position */ +#define CLK_CLKDIV0_SDH0DIV_Msk (0xfful << CLK_CLKDIV0_SDH0DIV_Pos) /*!< CLK_T::CLKDIV0: SDH0DIV Mask */ + +#define CLK_CLKDIV1_SC0DIV_Pos (0) /*!< CLK_T::CLKDIV1: SC0DIV Position */ +#define CLK_CLKDIV1_SC0DIV_Msk (0xfful << CLK_CLKDIV1_SC0DIV_Pos) /*!< CLK_T::CLKDIV1: SC0DIV Mask */ + +#define CLK_CLKDIV1_SC1DIV_Pos (8) /*!< CLK_T::CLKDIV1: SC1DIV Position */ +#define CLK_CLKDIV1_SC1DIV_Msk (0xfful << CLK_CLKDIV1_SC1DIV_Pos) /*!< CLK_T::CLKDIV1: SC1DIV Mask */ + +#define CLK_CLKDIV1_SC2DIV_Pos (16) /*!< CLK_T::CLKDIV1: SC2DIV Position */ +#define CLK_CLKDIV1_SC2DIV_Msk (0xfful << CLK_CLKDIV1_SC2DIV_Pos) /*!< CLK_T::CLKDIV1: SC2DIV Mask */ + +#define CLK_CLKDIV2_I2SDIV_Pos (0) /*!< CLK_T::CLKDIV2: I2SDIV Position */ +#define CLK_CLKDIV2_I2SDIV_Msk (0xful << CLK_CLKDIV2_I2SDIV_Pos) /*!< CLK_T::CLKDIV2: I2SDIV Mask */ + +#define CLK_CLKDIV2_EADC1DIV_Pos (24) /*!< CLK_T::CLKDIV2: EADC1DIV Position */ +#define CLK_CLKDIV2_EADC1DIV_Msk (0xfful << CLK_CLKDIV2_EADC1DIV_Pos) /*!< CLK_T::CLKDIV2: EADC1DIV Mask */ + +#define CLK_CLKDIV3_CCAPDIV_Pos (0) /*!< CLK_T::CLKDIV3: CCAPDIV Position */ +#define CLK_CLKDIV3_CCAPDIV_Msk (0xfful << CLK_CLKDIV3_CCAPDIV_Pos) /*!< CLK_T::CLKDIV3: CCAPDIV Mask */ + +#define CLK_CLKDIV3_VSENSEDIV_Pos (8) /*!< CLK_T::CLKDIV3: VSENSEDIV Position */ +#define CLK_CLKDIV3_VSENSEDIV_Msk (0xfful << CLK_CLKDIV3_VSENSEDIV_Pos) /*!< CLK_T::CLKDIV3: VSENSEDIV Mask */ + +#define CLK_CLKDIV3_EMACDIV_Pos (16) /*!< CLK_T::CLKDIV3: EMACDIV Position */ +#define CLK_CLKDIV3_EMACDIV_Msk (0xfful << CLK_CLKDIV3_EMACDIV_Pos) /*!< CLK_T::CLKDIV3: EMACDIV Mask */ + +#define CLK_CLKDIV3_SDH1DIV_Pos (24) /*!< CLK_T::CLKDIV3: SDH1DIV Position */ +#define CLK_CLKDIV3_SDH1DIV_Msk (0xfful << CLK_CLKDIV3_SDH1DIV_Pos) /*!< CLK_T::CLKDIV3: SDH1DIV Mask */ + +#define CLK_CLKDIV4_UART2DIV_Pos (0) /*!< CLK_T::CLKDIV4: UART2DIV Position */ +#define CLK_CLKDIV4_UART2DIV_Msk (0xful << CLK_CLKDIV4_UART2DIV_Pos) /*!< CLK_T::CLKDIV4: UART2DIV Mask */ + +#define CLK_CLKDIV4_UART3DIV_Pos (4) /*!< CLK_T::CLKDIV4: UART3DIV Position */ +#define CLK_CLKDIV4_UART3DIV_Msk (0xful << CLK_CLKDIV4_UART3DIV_Pos) /*!< CLK_T::CLKDIV4: UART3DIV Mask */ + +#define CLK_CLKDIV4_UART4DIV_Pos (8) /*!< CLK_T::CLKDIV4: UART4DIV Position */ +#define CLK_CLKDIV4_UART4DIV_Msk (0xful << CLK_CLKDIV4_UART4DIV_Pos) /*!< CLK_T::CLKDIV4: UART4DIV Mask */ + +#define CLK_CLKDIV4_UART5DIV_Pos (12) /*!< CLK_T::CLKDIV4: UART5DIV Position */ +#define CLK_CLKDIV4_UART5DIV_Msk (0xful << CLK_CLKDIV4_UART5DIV_Pos) /*!< CLK_T::CLKDIV4: UART5DIV Mask */ + +#define CLK_CLKDIV4_UART6DIV_Pos (16) /*!< CLK_T::CLKDIV4: UART6DIV Position */ +#define CLK_CLKDIV4_UART6DIV_Msk (0xful << CLK_CLKDIV4_UART6DIV_Pos) /*!< CLK_T::CLKDIV4: UART6DIV Mask */ + +#define CLK_CLKDIV4_UART7DIV_Pos (20) /*!< CLK_T::CLKDIV4: UART7DIV Position */ +#define CLK_CLKDIV4_UART7DIV_Msk (0xful << CLK_CLKDIV4_UART7DIV_Pos) /*!< CLK_T::CLKDIV4: UART7DIV Mask */ + +#define CLK_PCLKDIV_APB0DIV_Pos (0) /*!< CLK_T::PCLKDIV: APB0DIV Position */ +#define CLK_PCLKDIV_APB0DIV_Msk (0x7ul << CLK_PCLKDIV_APB0DIV_Pos) /*!< CLK_T::PCLKDIV: APB0DIV Mask */ + +#define CLK_PCLKDIV_APB1DIV_Pos (4) /*!< CLK_T::PCLKDIV: APB1DIV Position */ +#define CLK_PCLKDIV_APB1DIV_Msk (0x7ul << CLK_PCLKDIV_APB1DIV_Pos) /*!< CLK_T::PCLKDIV: APB1DIV Mask */ + +#define CLK_PLLCTL_FBDIV_Pos (0) /*!< CLK_T::PLLCTL: FBDIV Position */ +#define CLK_PLLCTL_FBDIV_Msk (0x1fful << CLK_PLLCTL_FBDIV_Pos) /*!< CLK_T::PLLCTL: FBDIV Mask */ + +#define CLK_PLLCTL_INDIV_Pos (9) /*!< CLK_T::PLLCTL: INDIV Position */ +#define CLK_PLLCTL_INDIV_Msk (0x1ful << CLK_PLLCTL_INDIV_Pos) /*!< CLK_T::PLLCTL: INDIV Mask */ + +#define CLK_PLLCTL_OUTDIV_Pos (14) /*!< CLK_T::PLLCTL: OUTDIV Position */ +#define CLK_PLLCTL_OUTDIV_Msk (0x3ul << CLK_PLLCTL_OUTDIV_Pos) /*!< CLK_T::PLLCTL: OUTDIV Mask */ + +#define CLK_PLLCTL_PD_Pos (16) /*!< CLK_T::PLLCTL: PD Position */ +#define CLK_PLLCTL_PD_Msk (0x1ul << CLK_PLLCTL_PD_Pos) /*!< CLK_T::PLLCTL: PD Mask */ + +#define CLK_PLLCTL_BP_Pos (17) /*!< CLK_T::PLLCTL: BP Position */ +#define CLK_PLLCTL_BP_Msk (0x1ul << CLK_PLLCTL_BP_Pos) /*!< CLK_T::PLLCTL: BP Mask */ + +#define CLK_PLLCTL_OE_Pos (18) /*!< CLK_T::PLLCTL: OE Position */ +#define CLK_PLLCTL_OE_Msk (0x1ul << CLK_PLLCTL_OE_Pos) /*!< CLK_T::PLLCTL: OE Mask */ + +#define CLK_PLLCTL_PLLSRC_Pos (19) /*!< CLK_T::PLLCTL: PLLSRC Position */ +#define CLK_PLLCTL_PLLSRC_Msk (0x1ul << CLK_PLLCTL_PLLSRC_Pos) /*!< CLK_T::PLLCTL: PLLSRC Mask */ + +#define CLK_PLLCTL_STBSEL_Pos (23) /*!< CLK_T::PLLCTL: STBSEL Position */ +#define CLK_PLLCTL_STBSEL_Msk (0x1ul << CLK_PLLCTL_STBSEL_Pos) /*!< CLK_T::PLLCTL: STBSEL Mask */ + +#define CLK_STATUS_HXTSTB_Pos (0) /*!< CLK_T::STATUS: HXTSTB Position */ +#define CLK_STATUS_HXTSTB_Msk (0x1ul << CLK_STATUS_HXTSTB_Pos) /*!< CLK_T::STATUS: HXTSTB Mask */ + +#define CLK_STATUS_LXTSTB_Pos (1) /*!< CLK_T::STATUS: LXTSTB Position */ +#define CLK_STATUS_LXTSTB_Msk (0x1ul << CLK_STATUS_LXTSTB_Pos) /*!< CLK_T::STATUS: LXTSTB Mask */ + +#define CLK_STATUS_PLLSTB_Pos (2) /*!< CLK_T::STATUS: PLLSTB Position */ +#define CLK_STATUS_PLLSTB_Msk (0x1ul << CLK_STATUS_PLLSTB_Pos) /*!< CLK_T::STATUS: PLLSTB Mask */ + +#define CLK_STATUS_LIRCSTB_Pos (3) /*!< CLK_T::STATUS: LIRCSTB Position */ +#define CLK_STATUS_LIRCSTB_Msk (0x1ul << CLK_STATUS_LIRCSTB_Pos) /*!< CLK_T::STATUS: LIRCSTB Mask */ + +#define CLK_STATUS_HIRCSTB_Pos (4) /*!< CLK_T::STATUS: HIRCSTB Position */ +#define CLK_STATUS_HIRCSTB_Msk (0x1ul << CLK_STATUS_HIRCSTB_Pos) /*!< CLK_T::STATUS: HIRCSTB Mask */ + +#define CLK_STATUS_CLKSFAIL_Pos (7) /*!< CLK_T::STATUS: CLKSFAIL Position */ +#define CLK_STATUS_CLKSFAIL_Msk (0x1ul << CLK_STATUS_CLKSFAIL_Pos) /*!< CLK_T::STATUS: CLKSFAIL Mask */ + +#define CLK_CLKOCTL_FREQSEL_Pos (0) /*!< CLK_T::CLKOCTL: FREQSEL Position */ +#define CLK_CLKOCTL_FREQSEL_Msk (0xful << CLK_CLKOCTL_FREQSEL_Pos) /*!< CLK_T::CLKOCTL: FREQSEL Mask */ + +#define CLK_CLKOCTL_CLKOEN_Pos (4) /*!< CLK_T::CLKOCTL: CLKOEN Position */ +#define CLK_CLKOCTL_CLKOEN_Msk (0x1ul << CLK_CLKOCTL_CLKOEN_Pos) /*!< CLK_T::CLKOCTL: CLKOEN Mask */ + +#define CLK_CLKOCTL_DIV1EN_Pos (5) /*!< CLK_T::CLKOCTL: DIV1EN Position */ +#define CLK_CLKOCTL_DIV1EN_Msk (0x1ul << CLK_CLKOCTL_DIV1EN_Pos) /*!< CLK_T::CLKOCTL: DIV1EN Mask */ + +#define CLK_CLKOCTL_CLK1HZEN_Pos (6) /*!< CLK_T::CLKOCTL: CLK1HZEN Position */ +#define CLK_CLKOCTL_CLK1HZEN_Msk (0x1ul << CLK_CLKOCTL_CLK1HZEN_Pos) /*!< CLK_T::CLKOCTL: CLK1HZEN Mask */ + +#define CLK_CLKDCTL_HXTFDEN_Pos (4) /*!< CLK_T::CLKDCTL: HXTFDEN Position */ +#define CLK_CLKDCTL_HXTFDEN_Msk (0x1ul << CLK_CLKDCTL_HXTFDEN_Pos) /*!< CLK_T::CLKDCTL: HXTFDEN Mask */ + +#define CLK_CLKDCTL_HXTFIEN_Pos (5) /*!< CLK_T::CLKDCTL: HXTFIEN Position */ +#define CLK_CLKDCTL_HXTFIEN_Msk (0x1ul << CLK_CLKDCTL_HXTFIEN_Pos) /*!< CLK_T::CLKDCTL: HXTFIEN Mask */ + +#define CLK_CLKDCTL_LXTFDEN_Pos (12) /*!< CLK_T::CLKDCTL: LXTFDEN Position */ +#define CLK_CLKDCTL_LXTFDEN_Msk (0x1ul << CLK_CLKDCTL_LXTFDEN_Pos) /*!< CLK_T::CLKDCTL: LXTFDEN Mask */ + +#define CLK_CLKDCTL_LXTFIEN_Pos (13) /*!< CLK_T::CLKDCTL: LXTFIEN Position */ +#define CLK_CLKDCTL_LXTFIEN_Msk (0x1ul << CLK_CLKDCTL_LXTFIEN_Pos) /*!< CLK_T::CLKDCTL: LXTFIEN Mask */ + +#define CLK_CLKDCTL_HXTFQDEN_Pos (16) /*!< CLK_T::CLKDCTL: HXTFQDEN Position */ +#define CLK_CLKDCTL_HXTFQDEN_Msk (0x1ul << CLK_CLKDCTL_HXTFQDEN_Pos) /*!< CLK_T::CLKDCTL: HXTFQDEN Mask */ + +#define CLK_CLKDCTL_HXTFQIEN_Pos (17) /*!< CLK_T::CLKDCTL: HXTFQIEN Position */ +#define CLK_CLKDCTL_HXTFQIEN_Msk (0x1ul << CLK_CLKDCTL_HXTFQIEN_Pos) /*!< CLK_T::CLKDCTL: HXTFQIEN Mask */ + +#define CLK_CLKDSTS_HXTFIF_Pos (0) /*!< CLK_T::CLKDSTS: HXTFIF Position */ +#define CLK_CLKDSTS_HXTFIF_Msk (0x1ul << CLK_CLKDSTS_HXTFIF_Pos) /*!< CLK_T::CLKDSTS: HXTFIF Mask */ + +#define CLK_CLKDSTS_LXTFIF_Pos (1) /*!< CLK_T::CLKDSTS: LXTFIF Position */ +#define CLK_CLKDSTS_LXTFIF_Msk (0x1ul << CLK_CLKDSTS_LXTFIF_Pos) /*!< CLK_T::CLKDSTS: LXTFIF Mask */ + +#define CLK_CLKDSTS_HXTFQIF_Pos (8) /*!< CLK_T::CLKDSTS: HXTFQIF Position */ +#define CLK_CLKDSTS_HXTFQIF_Msk (0x1ul << CLK_CLKDSTS_HXTFQIF_Pos) /*!< CLK_T::CLKDSTS: HXTFQIF Mask */ + +#define CLK_CDUPB_UPERBD_Pos (0) /*!< CLK_T::CDUPB: UPERBD Position */ +#define CLK_CDUPB_UPERBD_Msk (0x3fful << CLK_CDUPB_UPERBD_Pos) /*!< CLK_T::CDUPB: UPERBD Mask */ + +#define CLK_CDLOWB_LOWERBD_Pos (0) /*!< CLK_T::CDLOWB: LOWERBD Position */ +#define CLK_CDLOWB_LOWERBD_Msk (0x3fful << CLK_CDLOWB_LOWERBD_Pos) /*!< CLK_T::CDLOWB: LOWERBD Mask */ + +#define CLK_PMUCTL_PDMSEL_Pos (0) /*!< CLK_T::PMUCTL: PDMSEL Position */ +#define CLK_PMUCTL_PDMSEL_Msk (0x7ul << CLK_PMUCTL_PDMSEL_Pos) /*!< CLK_T::PMUCTL: PDMSEL Mask */ + +#define CLK_PMUCTL_DPDHOLDEN_Pos (3) /*!< CLK_T::PMUCTL: DPDHOLDEN Position */ +#define CLK_PMUCTL_DPDHOLDEN_Msk (0x1ul << CLK_PMUCTL_DPDHOLDEN_Pos) /*!< CLK_T::PMUCTL: DPDHOLDEN Mask */ + +#define CLK_PMUCTL_SRETSEL_Pos (4) /*!< CLK_T::PMUCTL: SRETSEL Position */ +#define CLK_PMUCTL_SRETSEL_Msk (0x7ul << CLK_PMUCTL_SRETSEL_Pos) /*!< CLK_T::PMUCTL: SRETSEL Mask */ + +#define CLK_PMUCTL_WKTMREN_Pos (8) /*!< CLK_T::PMUCTL: WKTMREN Position */ +#define CLK_PMUCTL_WKTMREN_Msk (0x1ul << CLK_PMUCTL_WKTMREN_Pos) /*!< CLK_T::PMUCTL: WKTMREN Mask */ + +#define CLK_PMUCTL_WKTMRIS_Pos (9) /*!< CLK_T::PMUCTL: WKTMRIS Position */ +#define CLK_PMUCTL_WKTMRIS_Msk (0xful << CLK_PMUCTL_WKTMRIS_Pos) /*!< CLK_T::PMUCTL: WKTMRIS Mask */ + +#define CLK_PMUCTL_WKPINEN_Pos (16) /*!< CLK_T::PMUCTL: WKPINEN Position */ +#define CLK_PMUCTL_WKPINEN_Msk (0x3ul << CLK_PMUCTL_WKPINEN_Pos) /*!< CLK_T::PMUCTL: WKPINEN Mask */ + +#define CLK_PMUCTL_ACMPSPWK_Pos (18) /*!< CLK_T::PMUCTL: ACMPSPWK Position */ +#define CLK_PMUCTL_ACMPSPWK_Msk (0x1ul << CLK_PMUCTL_ACMPSPWK_Pos) /*!< CLK_T::PMUCTL: ACMPSPWK Mask */ + +#define CLK_PMUCTL_RTCWKEN_Pos (23) /*!< CLK_T::PMUCTL: RTCWKEN Position */ +#define CLK_PMUCTL_RTCWKEN_Msk (0x1ul << CLK_PMUCTL_RTCWKEN_Pos) /*!< CLK_T::PMUCTL: RTCWKEN Mask */ + +#define CLK_PMUCTL_WKPINEN1_Pos (24) /*!< CLK_T::PMUCTL: WKPINEN1 Position */ +#define CLK_PMUCTL_WKPINEN1_Msk (0x3ul << CLK_PMUCTL_WKPINEN1_Pos) /*!< CLK_T::PMUCTL: WKPINEN1 Mask */ + +#define CLK_PMUCTL_WKPINEN2_Pos (26) /*!< CLK_T::PMUCTL: WKPINEN2 Position */ +#define CLK_PMUCTL_WKPINEN2_Msk (0x3ul << CLK_PMUCTL_WKPINEN2_Pos) /*!< CLK_T::PMUCTL: WKPINEN2 Mask */ + +#define CLK_PMUCTL_WKPINEN3_Pos (28) /*!< CLK_T::PMUCTL: WKPINEN3 Position */ +#define CLK_PMUCTL_WKPINEN3_Msk (0x3ul << CLK_PMUCTL_WKPINEN3_Pos) /*!< CLK_T::PMUCTL: WKPINEN3 Mask */ + +#define CLK_PMUCTL_WKPINEN4_Pos (30) /*!< CLK_T::PMUCTL: WKPINEN4 Position */ +#define CLK_PMUCTL_WKPINEN4_Msk (0x3ul << CLK_PMUCTL_WKPINEN4_Pos) /*!< CLK_T::PMUCTL: WKPINEN4 Mask */ + +#define CLK_PMUSTS_PINWK_Pos (0) /*!< CLK_T::PMUSTS: PINWK Position */ +#define CLK_PMUSTS_PINWK_Msk (0x1ul << CLK_PMUSTS_PINWK_Pos) /*!< CLK_T::PMUSTS: PINWK Mask */ + +#define CLK_PMUSTS_TMRWK_Pos (1) /*!< CLK_T::PMUSTS: TMRWK Position */ +#define CLK_PMUSTS_TMRWK_Msk (0x1ul << CLK_PMUSTS_TMRWK_Pos) /*!< CLK_T::PMUSTS: TMRWK Mask */ + +#define CLK_PMUSTS_RTCWK_Pos (2) /*!< CLK_T::PMUSTS: RTCWK Position */ +#define CLK_PMUSTS_RTCWK_Msk (0x1ul << CLK_PMUSTS_RTCWK_Pos) /*!< CLK_T::PMUSTS: RTCWK Mask */ + +#define CLK_PMUSTS_PINWK1_Pos (3) /*!< CLK_T::PMUSTS: PINWK1 Position */ +#define CLK_PMUSTS_PINWK1_Msk (0x1ul << CLK_PMUSTS_PINWK1_Pos) /*!< CLK_T::PMUSTS: PINWK1 Mask */ + +#define CLK_PMUSTS_PINWK2_Pos (4) /*!< CLK_T::PMUSTS: PINWK2 Position */ +#define CLK_PMUSTS_PINWK2_Msk (0x1ul << CLK_PMUSTS_PINWK2_Pos) /*!< CLK_T::PMUSTS: PINWK2 Mask */ + +#define CLK_PMUSTS_PINWK3_Pos (5) /*!< CLK_T::PMUSTS: PINWK3 Position */ +#define CLK_PMUSTS_PINWK3_Msk (0x1ul << CLK_PMUSTS_PINWK3_Pos) /*!< CLK_T::PMUSTS: PINWK3 Mask */ + +#define CLK_PMUSTS_PINWK4_Pos (6) /*!< CLK_T::PMUSTS: PINWK4 Position */ +#define CLK_PMUSTS_PINWK4_Msk (0x1ul << CLK_PMUSTS_PINWK4_Pos) /*!< CLK_T::PMUSTS: PINWK4 Mask */ + +#define CLK_PMUSTS_GPAWK_Pos (8) /*!< CLK_T::PMUSTS: GPAWK Position */ +#define CLK_PMUSTS_GPAWK_Msk (0x1ul << CLK_PMUSTS_GPAWK_Pos) /*!< CLK_T::PMUSTS: GPAWK Mask */ + +#define CLK_PMUSTS_GPBWK_Pos (9) /*!< CLK_T::PMUSTS: GPBWK Position */ +#define CLK_PMUSTS_GPBWK_Msk (0x1ul << CLK_PMUSTS_GPBWK_Pos) /*!< CLK_T::PMUSTS: GPBWK Mask */ + +#define CLK_PMUSTS_GPCWK_Pos (10) /*!< CLK_T::PMUSTS: GPCWK Position */ +#define CLK_PMUSTS_GPCWK_Msk (0x1ul << CLK_PMUSTS_GPCWK_Pos) /*!< CLK_T::PMUSTS: GPCWK Mask */ + +#define CLK_PMUSTS_GPDWK_Pos (11) /*!< CLK_T::PMUSTS: GPDWK Position */ +#define CLK_PMUSTS_GPDWK_Msk (0x1ul << CLK_PMUSTS_GPDWK_Pos) /*!< CLK_T::PMUSTS: GPDWK Mask */ + +#define CLK_PMUSTS_LVRWK_Pos (12) /*!< CLK_T::PMUSTS: LVRWK Position */ +#define CLK_PMUSTS_LVRWK_Msk (0x1ul << CLK_PMUSTS_LVRWK_Pos) /*!< CLK_T::PMUSTS: LVRWK Mask */ + +#define CLK_PMUSTS_BODWK_Pos (13) /*!< CLK_T::PMUSTS: BODWK Position */ +#define CLK_PMUSTS_BODWK_Msk (0x1ul << CLK_PMUSTS_BODWK_Pos) /*!< CLK_T::PMUSTS: BODWK Mask */ + +#define CLK_PMUSTS_ACMPWK_Pos (14) /*!< CLK_T::PMUSTS: ACMPWK Position */ +#define CLK_PMUSTS_ACMPWK_Msk (0x1ul << CLK_PMUSTS_ACMPWK_Pos) /*!< CLK_T::PMUSTS: ACMPWK Mask */ + +#define CLK_PMUSTS_CLRWK_Pos (31) /*!< CLK_T::PMUSTS: CLRWK Position */ +#define CLK_PMUSTS_CLRWK_Msk (0x1ul << CLK_PMUSTS_CLRWK_Pos) /*!< CLK_T::PMUSTS: CLRWK Mask */ + +#define CLK_LDOCTL_PDBIASEN_Pos (18) /*!< CLK_T::LDOCTL: PDBIASEN Position */ +#define CLK_LDOCTL_PDBIASEN_Msk (0x1ul << CLK_LDOCTL_PDBIASEN_Pos) /*!< CLK_T::LDOCTL: PDBIASEN Mask */ + +#define CLK_SWKDBCTL_SWKDBCLKSEL_Pos (0) /*!< CLK_T::SWKDBCTL: SWKDBCLKSEL Position */ +#define CLK_SWKDBCTL_SWKDBCLKSEL_Msk (0xful << CLK_SWKDBCTL_SWKDBCLKSEL_Pos) /*!< CLK_T::SWKDBCTL: SWKDBCLKSEL Mask */ + +#define CLK_PASWKCTL_WKEN_Pos (0) /*!< CLK_T::PASWKCTL: WKEN Position */ +#define CLK_PASWKCTL_WKEN_Msk (0x1ul << CLK_PASWKCTL_WKEN_Pos) /*!< CLK_T::PASWKCTL: WKEN Mask */ + +#define CLK_PASWKCTL_PRWKEN_Pos (1) /*!< CLK_T::PASWKCTL: PRWKEN Position */ +#define CLK_PASWKCTL_PRWKEN_Msk (0x1ul << CLK_PASWKCTL_PRWKEN_Pos) /*!< CLK_T::PASWKCTL: PRWKEN Mask */ + +#define CLK_PASWKCTL_PFWKEN_Pos (2) /*!< CLK_T::PASWKCTL: PFWKEN Position */ +#define CLK_PASWKCTL_PFWKEN_Msk (0x1ul << CLK_PASWKCTL_PFWKEN_Pos) /*!< CLK_T::PASWKCTL: PFWKEN Mask */ + +#define CLK_PASWKCTL_WKPSEL_Pos (4) /*!< CLK_T::PASWKCTL: WKPSEL Position */ +#define CLK_PASWKCTL_WKPSEL_Msk (0xful << CLK_PASWKCTL_WKPSEL_Pos) /*!< CLK_T::PASWKCTL: WKPSEL Mask */ + +#define CLK_PASWKCTL_DBEN_Pos (8) /*!< CLK_T::PASWKCTL: DBEN Position */ +#define CLK_PASWKCTL_DBEN_Msk (0x1ul << CLK_PASWKCTL_DBEN_Pos) /*!< CLK_T::PASWKCTL: DBEN Mask */ + +#define CLK_PBSWKCTL_WKEN_Pos (0) /*!< CLK_T::PBSWKCTL: WKEN Position */ +#define CLK_PBSWKCTL_WKEN_Msk (0x1ul << CLK_PBSWKCTL_WKEN_Pos) /*!< CLK_T::PBSWKCTL: WKEN Mask */ + +#define CLK_PBSWKCTL_PRWKEN_Pos (1) /*!< CLK_T::PBSWKCTL: PRWKEN Position */ +#define CLK_PBSWKCTL_PRWKEN_Msk (0x1ul << CLK_PBSWKCTL_PRWKEN_Pos) /*!< CLK_T::PBSWKCTL: PRWKEN Mask */ + +#define CLK_PBSWKCTL_PFWKEN_Pos (2) /*!< CLK_T::PBSWKCTL: PFWKEN Position */ +#define CLK_PBSWKCTL_PFWKEN_Msk (0x1ul << CLK_PBSWKCTL_PFWKEN_Pos) /*!< CLK_T::PBSWKCTL: PFWKEN Mask */ + +#define CLK_PBSWKCTL_WKPSEL_Pos (4) /*!< CLK_T::PBSWKCTL: WKPSEL Position */ +#define CLK_PBSWKCTL_WKPSEL_Msk (0xful << CLK_PBSWKCTL_WKPSEL_Pos) /*!< CLK_T::PBSWKCTL: WKPSEL Mask */ + +#define CLK_PBSWKCTL_DBEN_Pos (8) /*!< CLK_T::PBSWKCTL: DBEN Position */ +#define CLK_PBSWKCTL_DBEN_Msk (0x1ul << CLK_PBSWKCTL_DBEN_Pos) /*!< CLK_T::PBSWKCTL: DBEN Mask */ + +#define CLK_PCSWKCTL_WKEN_Pos (0) /*!< CLK_T::PCSWKCTL: WKEN Position */ +#define CLK_PCSWKCTL_WKEN_Msk (0x1ul << CLK_PCSWKCTL_WKEN_Pos) /*!< CLK_T::PCSWKCTL: WKEN Mask */ + +#define CLK_PCSWKCTL_PRWKEN_Pos (1) /*!< CLK_T::PCSWKCTL: PRWKEN Position */ +#define CLK_PCSWKCTL_PRWKEN_Msk (0x1ul << CLK_PCSWKCTL_PRWKEN_Pos) /*!< CLK_T::PCSWKCTL: PRWKEN Mask */ + +#define CLK_PCSWKCTL_PFWKEN_Pos (2) /*!< CLK_T::PCSWKCTL: PFWKEN Position */ +#define CLK_PCSWKCTL_PFWKEN_Msk (0x1ul << CLK_PCSWKCTL_PFWKEN_Pos) /*!< CLK_T::PCSWKCTL: PFWKEN Mask */ + +#define CLK_PCSWKCTL_WKPSEL_Pos (4) /*!< CLK_T::PCSWKCTL: WKPSEL Position */ +#define CLK_PCSWKCTL_WKPSEL_Msk (0xful << CLK_PCSWKCTL_WKPSEL_Pos) /*!< CLK_T::PCSWKCTL: WKPSEL Mask */ + +#define CLK_PCSWKCTL_DBEN_Pos (8) /*!< CLK_T::PCSWKCTL: DBEN Position */ +#define CLK_PCSWKCTL_DBEN_Msk (0x1ul << CLK_PCSWKCTL_DBEN_Pos) /*!< CLK_T::PCSWKCTL: DBEN Mask */ + +#define CLK_PDSWKCTL_WKEN_Pos (0) /*!< CLK_T::PDSWKCTL: WKEN Position */ +#define CLK_PDSWKCTL_WKEN_Msk (0x1ul << CLK_PDSWKCTL_WKEN_Pos) /*!< CLK_T::PDSWKCTL: WKEN Mask */ + +#define CLK_PDSWKCTL_PRWKEN_Pos (1) /*!< CLK_T::PDSWKCTL: PRWKEN Position */ +#define CLK_PDSWKCTL_PRWKEN_Msk (0x1ul << CLK_PDSWKCTL_PRWKEN_Pos) /*!< CLK_T::PDSWKCTL: PRWKEN Mask */ + +#define CLK_PDSWKCTL_PFWKEN_Pos (2) /*!< CLK_T::PDSWKCTL: PFWKEN Position */ +#define CLK_PDSWKCTL_PFWKEN_Msk (0x1ul << CLK_PDSWKCTL_PFWKEN_Pos) /*!< CLK_T::PDSWKCTL: PFWKEN Mask */ + +#define CLK_PDSWKCTL_WKPSEL_Pos (4) /*!< CLK_T::PDSWKCTL: WKPSEL Position */ +#define CLK_PDSWKCTL_WKPSEL_Msk (0xful << CLK_PDSWKCTL_WKPSEL_Pos) /*!< CLK_T::PDSWKCTL: WKPSEL Mask */ + +#define CLK_PDSWKCTL_DBEN_Pos (8) /*!< CLK_T::PDSWKCTL: DBEN Position */ +#define CLK_PDSWKCTL_DBEN_Msk (0x1ul << CLK_PDSWKCTL_DBEN_Pos) /*!< CLK_T::PDSWKCTL: DBEN Mask */ + +#define CLK_IOPDCTL_IOHR_Pos (0) /*!< CLK_T::IOPDCTL: IOHR Position */ +#define CLK_IOPDCTL_IOHR_Msk (0x1ul << CLK_IOPDCTL_IOHR_Pos) /*!< CLK_T::IOPDCTL: IOHR Mask */ + +/**@}*/ /* CLK_CONST */ +/**@}*/ /* end of CLK register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __CLK_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/crc_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/crc_reg.h new file mode 100644 index 00000000000..118f79739a3 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/crc_reg.h @@ -0,0 +1,150 @@ +/**************************************************************************//** + * @file crc_reg.h + * @version V1.00 + * @brief CRC register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __CRC_REG_H__ +#define __CRC_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup CRC Cyclic Redundancy Check Controller(CRC) + Memory Mapped Structure for CRC Controller +@{ */ + +typedef struct +{ + + + /** + * @var CRC_T::CTL + * Offset: 0x00 CRC Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CRCEN |CRC Channel Enable Bit + * | | |0 = No effect. + * | | |1 = CRC operation Enabled. + * |[1] |CHKSINIT |Checksum Initialization + * | | |0 = No effect. + * | | |1 = Initial checksum value by auto reload CRC_SEED register value to CRC_CHECKSUM register value. + * | | |Note: This bit will be cleared automatically. + * |[24] |DATREV |Write Data Bit Order Reverse + * | | |This bit is used to enable the bit order reverse function per byte for write data value in CRC_DAT register. + * | | |0 = Bit order reversed for CRC write data in Disabled. + * | | |1 = Bit order reversed for CRC write data in Enabled (per byte). + * | | |Note: If the write data is 0xAABBCCDD, the bit order reverse for CRC write data in is 0x55DD33BB. + * |[25] |CHKSREV |Checksum Bit Order Reverse + * | | |This bit is used to enable the bit order reverse function for checksum result in CRC_CHECKSUM register. + * | | |0 = Bit order reverse for CRC checksum Disabled. + * | | |1 = Bit order reverse for CRC checksum Enabled. + * | | |Note: If the checksum result is 0xDD7B0F2E, the bit order reverse for CRC checksum is 0x74F0DEBB. + * |[26] |DATFMT |Write Data 1's Complement + * | | |This bit is used to enable the 1's complement function for write data value in CRC_DAT register. + * | | |0 = 1's complement for CRC writes data in Disabled. + * | | |1 = 1's complement for CRC writes data in Enabled. + * |[27] |CHKSFMT |Checksum 1's Complement + * | | |This bit is used to enable the 1's complement function for checksum result in CRC_CHECKSUM register. + * | | |0 = 1's complement for CRC checksum Disabled. + * | | |1 = 1's complement for CRC checksum Enabled. + * |[29:28] |DATLEN |CPU Write Data Length + * | | |This field indicates the write data length. + * | | |00 = Data length is 8-bit mode. + * | | |01 = Data length is 16-bit mode. + * | | |1x = Data length is 32-bit mode. + * | | |Note: When the write data length is 8-bit mode, the valid data in CRC_DAT register is only DATA[7:0] bits; if the write data length is 16-bit mode, the valid data in CRC_DAT register is only DATA[15:0] + * |[31:30] |CRCMODE |CRC Polynomial Mode + * | | |This field indicates the CRC operation polynomial mode. + * | | |00 = CRC-CCITT Polynomial mode. + * | | |01 = CRC-8 Polynomial mode. + * | | |10 = CRC-16 Polynomial mode. + * | | |11 = CRC-32 Polynomial mode. + * @var CRC_T::DAT + * Offset: 0x04 CRC Write Data Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |DATA |CRC Write Data Bits + * | | |User can write data directly by CPU mode or use PDMA function to write data to this field to perform CRC operation. + * | | |Note: When the write data length is 8-bit mode, the valid data in CRC_DAT register is only DATA[7:0] bits; if the write data length is 16-bit mode, the valid data in CRC_DAT register is only DATA[15:0]. + * @var CRC_T::SEED + * Offset: 0x08 CRC Seed Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |SEED |CRC Seed Value + * | | |This field indicates the CRC seed value. + * | | |Note: This field will be reloaded as checksum initial value (CRC_CHECKSUM register) after perform CHKSINIT (CRC_CTL[1]). + * @var CRC_T::CHECKSUM + * Offset: 0x0C CRC Checksum Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |CHECKSUM |CRC Checksum Results + * | | |This field indicates the CRC checksum result. + */ + __IO uint32_t CTL; /*!< [0x0000] CRC Control Register */ + __IO uint32_t DAT; /*!< [0x0004] CRC Write Data Register */ + __IO uint32_t SEED; /*!< [0x0008] CRC Seed Register */ + __I uint32_t CHECKSUM; /*!< [0x000c] CRC Checksum Register */ + +} CRC_T; + +/** + @addtogroup CRC_CONST CRC Bit Field Definition + Constant Definitions for CRC Controller +@{ */ + +#define CRC_CTL_CRCEN_Pos (0) /*!< CRC_T::CTL: CRCEN Position */ +#define CRC_CTL_CRCEN_Msk (0x1ul << CRC_CTL_CRCEN_Pos) /*!< CRC_T::CTL: CRCEN Mask */ + +#define CRC_CTL_CHKSINIT_Pos (1) /*!< CRC_T::CTL: CHKSINIT Position */ +#define CRC_CTL_CHKSINIT_Msk (0x1ul << CRC_CTL_CHKSINIT_Pos) /*!< CRC_T::CTL: CHKSINIT Mask */ + +#define CRC_CTL_DATREV_Pos (24) /*!< CRC_T::CTL: DATREV Position */ +#define CRC_CTL_DATREV_Msk (0x1ul << CRC_CTL_DATREV_Pos) /*!< CRC_T::CTL: DATREV Mask */ + +#define CRC_CTL_CHKSREV_Pos (25) /*!< CRC_T::CTL: CHKSREV Position */ +#define CRC_CTL_CHKSREV_Msk (0x1ul << CRC_CTL_CHKSREV_Pos) /*!< CRC_T::CTL: CHKSREV Mask */ + +#define CRC_CTL_DATFMT_Pos (26) /*!< CRC_T::CTL: DATFMT Position */ +#define CRC_CTL_DATFMT_Msk (0x1ul << CRC_CTL_DATFMT_Pos) /*!< CRC_T::CTL: DATFMT Mask */ + +#define CRC_CTL_CHKSFMT_Pos (27) /*!< CRC_T::CTL: CHKSFMT Position */ +#define CRC_CTL_CHKSFMT_Msk (0x1ul << CRC_CTL_CHKSFMT_Pos) /*!< CRC_T::CTL: CHKSFMT Mask */ + +#define CRC_CTL_DATLEN_Pos (28) /*!< CRC_T::CTL: DATLEN Position */ +#define CRC_CTL_DATLEN_Msk (0x3ul << CRC_CTL_DATLEN_Pos) /*!< CRC_T::CTL: DATLEN Mask */ + +#define CRC_CTL_CRCMODE_Pos (30) /*!< CRC_T::CTL: CRCMODE Position */ +#define CRC_CTL_CRCMODE_Msk (0x3ul << CRC_CTL_CRCMODE_Pos) /*!< CRC_T::CTL: CRCMODE Mask */ + +#define CRC_DAT_DATA_Pos (0) /*!< CRC_T::DAT: DATA Position */ +#define CRC_DAT_DATA_Msk (0xfffffffful << CRC_DAT_DATA_Pos) /*!< CRC_T::DAT: DATA Mask */ + +#define CRC_SEED_SEED_Pos (0) /*!< CRC_T::SEED: SEED Position */ +#define CRC_SEED_SEED_Msk (0xfffffffful << CRC_SEED_SEED_Pos) /*!< CRC_T::SEED: SEED Mask */ + +#define CRC_CHECKSUM_CHECKSUM_Pos (0) /*!< CRC_T::CHECKSUM: CHECKSUM Position */ +#define CRC_CHECKSUM_CHECKSUM_Msk (0xfffffffful << CRC_CHECKSUM_CHECKSUM_Pos) /*!< CRC_T::CHECKSUM: CHECKSUM Mask */ + +/**@}*/ /* CRC_CONST */ +/**@}*/ /* end of CRC register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __CRC_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/crypto_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/crypto_reg.h new file mode 100644 index 00000000000..f385975cb4d --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/crypto_reg.h @@ -0,0 +1,2219 @@ +/**************************************************************************//** + * @file crypto_reg.h + * @version V1.00 + * @brief CRYPTO register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __CRYPTO_REG_H__ +#define __CRYPTO_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup CRPT Cryptographic Accelerator(CRPT) + Memory Mapped Structure for Cryptographic Accelerator +@{ */ + +typedef struct +{ + + /** + * @var CRPT_T::INTEN + * Offset: 0x00 Crypto Interrupt Enable Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |AESIEN |AES Interrupt Enable Control + * | | |0 = AES interrupt Disabled. + * | | |1 = AES interrupt Enabled. + * | | |In DMA mode, an interrupt will be triggered when amount of data set in AES_DMA_CNT is fed into the AES engine. + * | | |In Non-DMA mode, an interrupt will be triggered when the AES engine finishes the operation. + * |[1] |AESEIEN |AES Error Flag Enable Control + * | | |0 = AES error interrupt flag Disabled. + * | | |1 = AES error interrupt flag Enabled. + * |[8] |TDESIEN |TDES/DES Interrupt Enable Control + * | | |0 = TDES/DES interrupt Disabled. + * | | |1 = TDES/DES interrupt Enabled. + * | | |In DMA mode, an interrupt will be triggered when amount of data set in TDES_DMA_CNT is fed into the TDES engine. + * | | |In Non-DMA mode, an interrupt will be triggered when the TDES engine finishes the operation. + * |[9] |TDESEIEN |TDES/DES Error Flag Enable Control + * | | |0 = TDES/DES error interrupt flag Disabled. + * | | |1 = TDES/DES error interrupt flag Enabled. + * |[16] |PRNGIEN |PRNG Interrupt Enable Control + * | | |0 = PRNG interrupt Disabled. + * | | |1 = PRNG interrupt Enabled. + * |[22] |ECCIEN |ECC Interrupt Enable Control + * | | |0 = ECC interrupt Disabled. + * | | |1 = ECC interrupt Enabled. + * | | |In DMA mode, an interrupt will be triggered when amount of data set in ECC_DMA_CNT is fed into the ECC engine. + * | | |In Non-DMA mode, an interrupt will be triggered when the ECC engine finishes the operation. + * |[23] |ECCEIEN |ECC Error Interrupt Enable Control + * | | |0 = ECC error interrupt flag Disabled. + * | | |1 = ECC error interrupt flag Enabled. + * |[24] |HMACIEN |SHA/HMAC Interrupt Enable Control + * | | |0 = SHA/HMAC interrupt Disabled. + * | | |1 = SHA/HMAC interrupt Enabled. + * | | |In DMA mode, an interrupt will be triggered when amount of data set in SHA _DMA_CNT is fed into the SHA/HMAC engine + * | | |In Non-DMA mode, an interrupt will be triggered when the SHA/HMAC engine finishes the operation. + * |[25] |HMACEIEN |SHA/HMAC Error Interrupt Enable Control + * | | |0 = SHA/HMAC error interrupt flag Disabled. + * | | |1 = SHA/HMAC error interrupt flag Enabled. + * @var CRPT_T::INTSTS + * Offset: 0x04 Crypto Interrupt Flag + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |AESIF |AES Finish Interrupt Flag + * | | |This bit is cleared by writing 1, and it has no effect by writing 0. + * | | |0 = No AES interrupt. + * | | |= AES encryption/decryption done interrupt. + * |[1] |AESEIF |AES Error Flag + * | | |This bit is cleared by writing 1, and it has no effect by writing 0. + * | | |0 = No AES error. + * | | |1 = AES encryption/decryption done interrupt. + * |[8] |TDESIF |TDES/DES Finish Interrupt Flag + * | | |This bit is cleared by writing 1, and it has no effect by writing 0. + * | | |0 = No TDES/DES interrupt. + * | | |1 = TDES/DES encryption/decryption done interrupt. + * |[9] |TDESEIF |TDES/DES Error Flag + * | | |This bit includes the operating and setting error + * | | |The detailed flag is shown in the CRPT_TDES_STS register + * | | |This includes operating and setting error. + * | | |This bit is cleared by writing 1, and it has no effect by writing 0. + * | | |0 = No TDES/DES error. + * | | |1 = TDES/DES encryption/decryption error interrupt. + * |[16] |PRNGIF |PRNG Finish Interrupt Flag + * | | |This bit is cleared by writing 1, and it has no effect by writing 0. + * | | |0 = No PRNG interrupt. + * | | |1 = PRNG key generation done interrupt. + * |[22] |ECCIF |ECC Finish Interrupt Flag + * | | |This bit is cleared by writing 1, and it has no effect by writing 0. + * | | |0 = No ECC interrupt. + * | | |1 = ECC operation done interrupt. + * |[23] |ECCEIF |ECC Error Flag + * | | |This register includes operating and setting error. The detail flag is shown in CRPT_ECC_STS register. + * | | |This bit is cleared by writing 1, and it has no effect by writing 0. + * | | |0 = No ECC error. + * | | |1 = ECC error interrupt. + * |[24] |HMACIF |SHA/HMAC Finish Interrupt Flag + * | | |This bit is cleared by writing 1, and it has no effect by writing 0. + * | | |0 = No SHA/HMAC interrupt. + * | | |1 = SHA/HMAC operation done interrupt. + * |[25] |HMACEIF |SHA/HMAC Error Flag + * | | |This register includes operating and setting error. The detail flag is shown in CRPT_HMAC_STS register. + * | | |This bit is cleared by writing 1, and it has no effect by writing 0. + * | | |0 = No SHA/HMAC error. + * | | |1 = SHA/HMAC error interrupt. + * @var CRPT_T::PRNG_CTL + * Offset: 0x08 PRNG Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |START |Start PRNG Engine + * | | |0 = Stop PRNG engine. + * | | |1 = Generate new key and store the new key to register CRPT_PRNG_KEYx , which will be cleared when the new key is generated. + * |[1] |SEEDRLD |Reload New Seed for PRNG Engine + * | | |0 = Generating key based on the current seed. + * | | |1 = Reload new seed. + * |[3:2] |KEYSZ |PRNG Generate Key Size + * | | |00 = 64 bits. + * | | |01 = 128 bits. + * | | |10 = 192 bits. + * | | |11 = 256 bits. + * |[8] |BUSY |PRNG Busy (Read Only) + * | | |0 = PRNG engine is idle. + * | | |1 = Indicate that the PRNG engine is generating CRPT_PRNG_KEYx. + * @var CRPT_T::PRNG_SEED + * Offset: 0x0C Seed for PRNG + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |SEED |Seed for PRNG (Write Only) + * | | |The bits store the seed for PRNG engine. + * @var CRPT_T::PRNG_KEY[8] + * Offset: 0x10 ~ 0x2C PRNG Generated Key0 ~ Key7 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |Store PRNG Generated Key (Read Only) + * | | |The bits store the key that is generated by PRNG. + * @var CRPT_T::AES_FDBCK[4] + * Offset: 0x50 ~ 0x5C AES Engine Output Feedback Data after Cryptographic Operation + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |FDBCK |AES Feedback Information + * | | |The feedback value is 128 bits in size. + * | | |The AES engine uses the data from CRPT_AES_FDBCKx as the data inputted to CRPT_AESn_IVx for the next block in DMA cascade mode. + * | | |The AES engine outputs feedback information for IV in the next block's operation + * | | |Software can use this feedback information to implement more than four DMA channels + * | | |Software can store that feedback value temporarily + * | | |After switching back, fill the stored feedback value to this register in the same channel operation, and then continue the operation with the original setting. + * @var CRPT_T::TDES_FDBCKH + * Offset: 0x60 TDES/DES Engine Output Feedback High Word Data after Cryptographic Operation + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |FDBCK |TDES/DES Feedback + * | | |The feedback value is 64 bits in size. + * | | |The TDES/DES engine uses the data from {CRPT_TDES_FDBCKH, CRPT_TDES_FDBCKL} as the data inputted to {CRPT_TDESn_IVH, CRPT_TDESn_IVL} for the next block in DMA cascade mode + * | | |The feedback register is for CBC, CFB, and OFB mode. + * | | |TDES/DES engine outputs feedback information for IV in the next block's operation + * | | |Software can use this feedback information to implement more than four DMA channels + * | | |Software can store that feedback value temporarily + * | | |After switching back, fill the stored feedback value to this register in the same channel operation + * | | |Then can continue the operation with the original setting. + * @var CRPT_T::TDES_FDBCKL + * Offset: 0x64 TDES/DES Engine Output Feedback Low Word Data after Cryptographic Operation + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |FDBCK |TDES/DES Feedback + * | | |The feedback value is 64 bits in size. + * | | |The TDES/DES engine uses the data from {CRPT_TDES_FDBCKH, CRPT_TDES_FDBCKL} as the data inputted to {CRPT_TDESn_IVH, CRPT_TDESn_IVL} for the next block in DMA cascade mode + * | | |The feedback register is for CBC, CFB, and OFB mode. + * | | |TDES/DES engine outputs feedback information for IV in the next block's operation + * | | |Software can use this feedback information to implement more than four DMA channels + * | | |Software can store that feedback value temporarily + * | | |After switching back, fill the stored feedback value to this register in the same channel operation + * | | |Then can continue the operation with the original setting. + * @var CRPT_T::AES_CTL + * Offset: 0x100 AES Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |START |AES Engine Start + * | | |0 = No effect. + * | | |1 = Start AES engine. BUSY flag will be set. + * | | |Note: This bit is always 0 when it's read back. + * |[1] |STOP |AES Engine Stop + * | | |0 = No effect. + * | | |1 = Stop AES engine. + * | | |Note: This bit is always 0 when it's read back. + * |[3:2] |KEYSZ |AES Key Size + * | | |This bit defines three different key size for AES operation. + * | | |2'b00 = 128 bits key. + * | | |2'b01 = 192 bits key. + * | | |2'b10 = 256 bits key. + * | | |2'b11 = Reserved. + * | | |If the AES accelerator is operating and the corresponding flag BUSY is 1, updating this register has no effect. + * |[5] |DMALAST |AES Last Block + * | | |In DMA mode, this bit must be set as beginning the last DMA cascade round. + * | | |In Non-DMA mode, this bit must be set when feeding in the last block of data in ECB, CBC, CTR, OFB, and CFB mode, and feeding in the (last-1) block of data at CBC-CS1, CBC-CS2, and CBC-CS3 mode. + * | | |This bit is always 0 when it's read back. Must be written again once START is triggered. + * |[6] |DMACSCAD |AES Engine DMA with Cascade Mode + * | | |0 = DMA cascade function Disabled. + * | | |1 = In DMA cascade mode, software can update DMA source address register, destination address register, and byte count register during a cascade operation, without finishing the accelerator operation. + * |[7] |DMAEN |AES Engine DMA Enable Control + * | | |0 = AES DMA engine Disabled. + * | | |The AES engine operates in Non-DMA mode, and gets data from the port CRPT_AES_DATIN. + * | | |1 = AES_DMA engine Enabled. + * | | |The AES engine operates in DMA mode, and data movement from/to the engine is done by DMA logic. + * |[15:8] |OPMODE |AES Engine Operation Modes + * | | |0x00 = ECB (Electronic Codebook Mode) 0x01 = CBC (Cipher Block Chaining Mode). + * | | |0x02 = CFB (Cipher Feedback Mode). + * | | |0x03 = OFB (Output Feedback Mode). + * | | |0x04 = CTR (Counter Mode). + * | | |0x10 = CBC-CS1 (CBC Ciphertext-Stealing 1 Mode). + * | | |0x11 = CBC-CS2 (CBC Ciphertext-Stealing 2 Mode). + * | | |0x12 = CBC-CS3 (CBC Ciphertext-Stealing 3 Mode). + * |[16] |ENCRPT |AES Encryption/Decryption + * | | |0 = AES engine executes decryption operation. + * | | |1 = AES engine executes encryption operation. + * |[22] |OUTSWAP |AES Engine Output Data Swap + * | | |0 = Keep the original order. + * | | |1 = The order that CPU outputs data from the accelerator will be changed from {byte3, byte2, byte1, byte0} to {byte0, byte1, byte2, byte3}. + * |[23] |INSWAP |AES Engine Input Data Swap + * | | |0 = Keep the original order. + * | | |1 = The order that CPU feeds data to the accelerator will be changed from {byte3, byte2, byte1, byte0} to {byte0, byte1, byte2, byte3}. + * |[25:24] |CHANNEL |AES Engine Working Channel + * | | |00 = Current control register setting is for channel 0. + * | | |01 = Current control register setting is for channel 1. + * | | |10 = Current control register setting is for channel 2. + * | | |11 = Current control register setting is for channel 3. + * |[30:26] |KEYUNPRT |Unprotect Key + * | | |Writing 0 to CRPT_AES_CTL[31] and "10110" to CRPT_AES_CTL[30:26] is to unprotect the AES key. + * | | |The KEYUNPRT can be read and written + * | | |When it is written as the AES engine is operating, BUSY flag is 1, there would be no effect on KEYUNPRT. + * |[31] |KEYPRT |Protect Key + * | | |Read as a flag to reflect KEYPRT. + * | | |0 = No effect. + * | | |1 = Protect the content of the AES key from reading + * | | |The return value for reading CRPT_AESn_KEYx is not the content of the registers CRPT_AESn_KEYx + * | | |Once it is set, it can be cleared by asserting KEYUNPRT + * | | |And the key content would be cleared as well. + * @var CRPT_T::AES_STS + * Offset: 0x104 AES Engine Flag + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BUSY |AES Engine Busy + * | | |0 = The AES engine is idle or finished. + * | | |1 = The AES engine is under processing. + * |[8] |INBUFEMPTY|AES Input Buffer Empty + * | | |0 = There are some data in input buffer waiting for the AES engine to process. + * | | |1 = AES input buffer is empty + * | | |Software needs to feed data to the AES engine + * | | |Otherwise, the AES engine will be pending to wait for input data. + * |[9] |INBUFFULL |AES Input Buffer Full Flag + * | | |0 = AES input buffer is not full. Software can feed the data into the AES engine. + * | | |1 = AES input buffer is full + * | | |Software cannot feed data to the AES engine + * | | |Otherwise, the flag INBUFERR will be set to 1. + * |[10] |INBUFERR |AES Input Buffer Error Flag + * | | |0 = No error. + * | | |1 = Error happens during feeding data to the AES engine. + * |[12] |CNTERR |CRPT_AESn_CNT Setting Error + * | | |0 = No error in CRPT_AESn_CNT setting. + * | | |1 = CRPT_AESn_CNT is not a multiply of 16 in ECB, CBC, CFB, OFB, and CTR mode. + * |[16] |OUTBUFEMPTY|AES Out Buffer Empty + * | | |0 = AES output buffer is not empty. There are some valid data kept in output buffer. + * | | |1 = AES output buffer is empty + * | | |Software cannot get data from CRPT_AES_DATOUT + * | | |Otherwise, the flag OUTBUFERR will be set to 1 since the output buffer is empty. + * |[17] |OUTBUFFULL|AES Out Buffer Full Flag + * | | |0 = AES output buffer is not full. + * | | |1 = AES output buffer is full, and software needs to get data from CRPT_AES_DATOUT + * | | |Otherwise, the AES engine will be pending since the output buffer is full. + * |[18] |OUTBUFERR |AES Out Buffer Error Flag + * | | |0 = No error. + * | | |1 = Error happens during getting the result from AES engine. + * |[20] |BUSERR |AES DMA Access Bus Error Flag + * | | |0 = No error. + * | | |1 = Bus error will stop DMA operation and AES engine. + * @var CRPT_T::AES_DATIN + * Offset: 0x108 AES Engine Data Input Port Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |DATIN |AES Engine Input Port + * | | |CPU feeds data to AES engine through this port by checking CRPT_AES_STS. Feed data as INBUFFULL is 0. + * @var CRPT_T::AES_DATOUT + * Offset: 0x10C AES Engine Data Output Port Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |DATOUT |AES Engine Output Port + * | | |CPU gets results from the AES engine through this port by checking CRPT_AES_STS + * | | |Get data as OUTBUFEMPTY is 0. + * @var CRPT_T::AES0_KEY[8] + * Offset: 0x110 ~ 0x12C AES Key Word 0 ~ 7 Register for Channel 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |CRPT_AESn_KEYx + * | | |The KEY keeps the security key for AES operation. + * | | |n = 0, 1..3. + * | | |x = 0, 1..7. + * | | |The security key for AES accelerator can be 128, 192, or 256 bits and four, six, or eight 32-bit registers are to store each security key + * | | |{CRPT_AESn_KEY3, CRPT_AESn_KEY2, CRPT_AESn_KEY1, CRPT_AESn_KEY0} stores the 128-bit security key for AES operation + * | | |{CRPT_AESn_KEY5, CRPT_AESn_KEY4, CRPT_AESn_KEY3, CRPT_AESn_KEY2, CRPT_AESn_KEY1, CRPT_AESn_KEY0} stores the 192-bit security key for AES operation + * | | |{CRPT_AESn_KEY7, CRPT_AESn_KEY6, CRPT_AESn_KEY5, CRPT_AESn_KEY4, CRPT_AESn_KEY3, CRPT_AESn_KEY2, CRPT_AESn_KEY1, CRPT_AESn_KEY0} stores the 256-bit security key for AES operation. + * @var CRPT_T::AES0_IV[4] + * Offset: 0x130 ~ 0x13C AES Initial Vector Word 0 ~ 3 Register for Channel 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |IV |AES Initial Vectors + * | | |n = 0, 1..3. + * | | |x = 0, 1..3. + * | | |Four initial vectors (CRPT_AESn_IV0, CRPT_AESn_IV1, CRPT_AESn_IV2, and CRPT_AESn_IV3) are for AES operating in CBC, CFB, and OFB mode + * | | |Four registers (CRPT_AESn_IV0, CRPT_AESn_IV1, CRPT_AESn_IV2, and CRPT_AESn_IV3) act as Nonce counter when the AES engine is operating in CTR mode. + * @var CRPT_T::AES0_SADDR + * Offset: 0x140 AES DMA Source Address Register for Channel 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |SADDR |AES DMA Source Address + * | | |The AES accelerator supports DMA function to transfer the plain text between system memory and embedded FIFO + * | | |The SADDR keeps the source address of the data buffer where the source text is stored + * | | |Based on the source address, the AES accelerator can read the plain text from system memory and do AES operation + * | | |The start of source address should be located at word boundary + * | | |In other words, bit 1 and 0 of SADDR are ignored. + * | | |SADDR can be read and written + * | | |Writing to SADDR while the AES accelerator is operating doesn't affect the current AES operation + * | | |But the value of SADDR will be updated later on + * | | |Consequently, software can prepare the DMA source address for the next AES operation. + * | | |In DMA mode, software can update the next CRPT_AESn_SADDR before triggering START. + * | | |The value of CRPT_AESn_SADDR and CRPT_AESn_DADDR can be the same. + * @var CRPT_T::AES0_DADDR + * Offset: 0x144 AES DMA Destination Address Register for Channel 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |DADDR |AES DMA Destination Address + * | | |The AES accelerator supports DMA function to transfer the cipher text between system memory and embedded FIFO + * | | |The DADDR keeps the destination address of the data buffer where the engine output's text will be stored + * | | |Based on the destination address, the AES accelerator can write the cipher text back to system memory after the AES operation is finished + * | | |The start of destination address should be located at word boundary + * | | |In other words, bit 1 and 0 of DADDR are ignored. + * | | |DADDR can be read and written + * | | |Writing to DADDR while the AES accelerator is operating doesn't affect the current AES operation + * | | |But the value of DADDR will be updated later on + * | | |Consequently, software can prepare the destination address for the next AES operation. + * | | |In DMA mode, software can update the next CRPT_AESn_DADDR before triggering START. + * | | |The value of CRPT_AESn_SADDR and CRPT_AESn_DADDR can be the same. + * @var CRPT_T::AES0_CNT + * Offset: 0x148 AES Byte Count Register for Channel 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |CNT |AES Byte Count + * | | |The CRPT_AESn_CNT keeps the byte count of source text that is for the AES engine operating in DMA mode + * | | |The CRPT_AESn_CNT is 32-bit and the maximum of byte count is 4G bytes. + * | | |CRPT_AESn_CNT can be read and written + * | | |Writing to CRPT_AESn_CNT while the AES accelerator is operating doesn't affect the current AES operation + * | | |But the value of CRPT_AESn_CNT will be updated later on + * | | |Consequently, software can prepare the byte count of data for the next AES operation. + * | | |According to CBC-CS1, CBC-CS2, and CBC-CS3 standard, the count of operation data must be at least one block + * | | |Operations that are less than one block will output unexpected result. + * | | |In Non-DMA ECB, CBC, CFB, OFB, and CTR mode, CRPT_AESn_CNT must be set as byte count for the last block of data before feeding in the last block of data + * | | |In Non-DMA CBC-CS1, CBC-CS2, and CBC-CS3 mode, CRPT_AESn_CNT must be set as byte count for the last two blocks of data before feeding in the last two blocks of data. + * @var CRPT_T::AES1_KEY[8] + * Offset: 0x14C ~ 0x168 AES Key Word 0 ~ 7 Register for Channel 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |CRPT_AESn_KEYx + * | | |The KEY keeps the security key for AES operation. + * | | |n = 0, 1..3. + * | | |x = 0, 1..7. + * | | |The security key for AES accelerator can be 128, 192, or 256 bits and four, six, or eight 32-bit registers are to store each security key + * | | |{CRPT_AESn_KEY3, CRPT_AESn_KEY2, CRPT_AESn_KEY1, CRPT_AESn_KEY0} stores the 128-bit security key for AES operation + * | | |{CRPT_AESn_KEY5, CRPT_AESn_KEY4, CRPT_AESn_KEY3, CRPT_AESn_KEY2, CRPT_AESn_KEY1, CRPT_AESn_KEY0} stores the 192-bit security key for AES operation + * | | |{CRPT_AESn_KEY7, CRPT_AESn_KEY6, CRPT_AESn_KEY5, CRPT_AESn_KEY4, CRPT_AESn_KEY3, CRPT_AESn_KEY2, CRPT_AESn_KEY1, CRPT_AESn_KEY0} stores the 256-bit security key for AES operation. + * @var CRPT_T::AES1_IV[4] + * Offset: 0x16C ~ 0x178 AES Initial Vector Word 0 ~ 3 Register for Channel 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |IV |AES Initial Vectors + * | | |n = 0, 1..3. + * | | |x = 0, 1..3. + * | | |Four initial vectors (CRPT_AESn_IV0, CRPT_AESn_IV1, CRPT_AESn_IV2, and CRPT_AESn_IV3) are for AES operating in CBC, CFB, and OFB mode + * | | |Four registers (CRPT_AESn_IV0, CRPT_AESn_IV1, CRPT_AESn_IV2, and CRPT_AESn_IV3) act as Nonce counter when the AES engine is operating in CTR mode. + * @var CRPT_T::AES1_SADDR + * Offset: 0x17C AES DMA Source Address Register for Channel 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |SADDR |AES DMA Source Address + * | | |The AES accelerator supports DMA function to transfer the plain text between system memory and embedded FIFO + * | | |The SADDR keeps the source address of the data buffer where the source text is stored + * | | |Based on the source address, the AES accelerator can read the plain text from system memory and do AES operation + * | | |The start of source address should be located at word boundary + * | | |In other words, bit 1 and 0 of SADDR are ignored. + * | | |SADDR can be read and written + * | | |Writing to SADDR while the AES accelerator is operating doesn't affect the current AES operation + * | | |But the value of SADDR will be updated later on + * | | |Consequently, software can prepare the DMA source address for the next AES operation. + * | | |In DMA mode, software can update the next CRPT_AESn_SADDR before triggering START. + * | | |The value of CRPT_AESn_SADDR and CRPT_AESn_DADDR can be the same. + * @var CRPT_T::AES1_DADDR + * Offset: 0x180 AES DMA Destination Address Register for Channel 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |DADDR |AES DMA Destination Address + * | | |The AES accelerator supports DMA function to transfer the cipher text between system memory and embedded FIFO + * | | |The DADDR keeps the destination address of the data buffer where the engine output's text will be stored + * | | |Based on the destination address, the AES accelerator can write the cipher text back to system memory after the AES operation is finished + * | | |The start of destination address should be located at word boundary + * | | |In other words, bit 1 and 0 of DADDR are ignored. + * | | |DADDR can be read and written + * | | |Writing to DADDR while the AES accelerator is operating doesn't affect the current AES operation + * | | |But the value of DADDR will be updated later on + * | | |Consequently, software can prepare the destination address for the next AES operation. + * | | |In DMA mode, software can update the next CRPT_AESn_DADDR before triggering START. + * | | |The value of CRPT_AESn_SADDR and CRPT_AESn_DADDR can be the same. + * @var CRPT_T::AES1_CNT + * Offset: 0x184 AES Byte Count Register for Channel 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |CNT |AES Byte Count + * | | |The CRPT_AESn_CNT keeps the byte count of source text that is for the AES engine operating in DMA mode + * | | |The CRPT_AESn_CNT is 32-bit and the maximum of byte count is 4G bytes. + * | | |CRPT_AESn_CNT can be read and written + * | | |Writing to CRPT_AESn_CNT while the AES accelerator is operating doesn't affect the current AES operation + * | | |But the value of CRPT_AESn_CNT will be updated later on + * | | |Consequently, software can prepare the byte count of data for the next AES operation. + * | | |According to CBC-CS1, CBC-CS2, and CBC-CS3 standard, the count of operation data must be at least one block + * | | |Operations that are less than one block will output unexpected result. + * | | |In Non-DMA ECB, CBC, CFB, OFB, and CTR mode, CRPT_AESn_CNT must be set as byte count for the last block of data before feeding in the last block of data + * | | |In Non-DMA CBC-CS1, CBC-CS2, and CBC-CS3 mode, CRPT_AESn_CNT must be set as byte count for the last two blocks of data before feeding in the last two blocks of data. + * @var CRPT_T::AES2_KEY[8] + * Offset: 0x188 ~ 0x1A4 AES Key Word 0 ~ 7 Register for Channel 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |CRPT_AESn_KEYx + * | | |The KEY keeps the security key for AES operation. + * | | |n = 0, 1..3. + * | | |x = 0, 1..7. + * | | |The security key for AES accelerator can be 128, 192, or 256 bits and four, six, or eight 32-bit registers are to store each security key + * | | |{CRPT_AESn_KEY3, CRPT_AESn_KEY2, CRPT_AESn_KEY1, CRPT_AESn_KEY0} stores the 128-bit security key for AES operation + * | | |{CRPT_AESn_KEY5, CRPT_AESn_KEY4, CRPT_AESn_KEY3, CRPT_AESn_KEY2, CRPT_AESn_KEY1, CRPT_AESn_KEY0} stores the 192-bit security key for AES operation + * | | |{CRPT_AESn_KEY7, CRPT_AESn_KEY6, CRPT_AESn_KEY5, CRPT_AESn_KEY4, CRPT_AESn_KEY3, CRPT_AESn_KEY2, CRPT_AESn_KEY1, CRPT_AESn_KEY0} stores the 256-bit security key for AES operation. + * @var CRPT_T::AES2_IV[4] + * Offset: 0x1A8 ~ 0x1B4 AES Initial Vector Word 0 ~ 3 Register for Channel 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |IV |AES Initial Vectors + * | | |n = 0, 1..3. + * | | |x = 0, 1..3. + * | | |Four initial vectors (CRPT_AESn_IV0, CRPT_AESn_IV1, CRPT_AESn_IV2, and CRPT_AESn_IV3) are for AES operating in CBC, CFB, and OFB mode + * | | |Four registers (CRPT_AESn_IV0, CRPT_AESn_IV1, CRPT_AESn_IV2, and CRPT_AESn_IV3) act as Nonce counter when the AES engine is operating in CTR mode. + * @var CRPT_T::AES2_SADDR + * Offset: 0x1B8 AES DMA Source Address Register for Channel 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |SADDR |AES DMA Source Address + * | | |The AES accelerator supports DMA function to transfer the plain text between system memory and embedded FIFO + * | | |The SADDR keeps the source address of the data buffer where the source text is stored + * | | |Based on the source address, the AES accelerator can read the plain text from system memory and do AES operation + * | | |The start of source address should be located at word boundary + * | | |In other words, bit 1 and 0 of SADDR are ignored. + * | | |SADDR can be read and written + * | | |Writing to SADDR while the AES accelerator is operating doesn't affect the current AES operation + * | | |But the value of SADDR will be updated later on + * | | |Consequently, software can prepare the DMA source address for the next AES operation. + * | | |In DMA mode, software can update the next CRPT_AESn_SADDR before triggering START. + * | | |The value of CRPT_AESn_SADDR and CRPT_AESn_DADDR can be the same. + * @var CRPT_T::AES2_DADDR + * Offset: 0x1BC AES DMA Destination Address Register for Channel 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |DADDR |AES DMA Destination Address + * | | |The AES accelerator supports DMA function to transfer the cipher text between system memory and embedded FIFO + * | | |The DADDR keeps the destination address of the data buffer where the engine output's text will be stored + * | | |Based on the destination address, the AES accelerator can write the cipher text back to system memory after the AES operation is finished + * | | |The start of destination address should be located at word boundary + * | | |In other words, bit 1 and 0 of DADDR are ignored. + * | | |DADDR can be read and written + * | | |Writing to DADDR while the AES accelerator is operating doesn't affect the current AES operation + * | | |But the value of DADDR will be updated later on + * | | |Consequently, software can prepare the destination address for the next AES operation. + * | | |In DMA mode, software can update the next CRPT_AESn_DADDR before triggering START. + * | | |The value of CRPT_AESn_SADDR and CRPT_AESn_DADDR can be the same. + * @var CRPT_T::AES2_CNT + * Offset: 0x1C0 AES Byte Count Register for Channel 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |CNT |AES Byte Count + * | | |The CRPT_AESn_CNT keeps the byte count of source text that is for the AES engine operating in DMA mode + * | | |The CRPT_AESn_CNT is 32-bit and the maximum of byte count is 4G bytes. + * | | |CRPT_AESn_CNT can be read and written + * | | |Writing to CRPT_AESn_CNT while the AES accelerator is operating doesn't affect the current AES operation + * | | |But the value of CRPT_AESn_CNT will be updated later on + * | | |Consequently, software can prepare the byte count of data for the next AES operation. + * | | |According to CBC-CS1, CBC-CS2, and CBC-CS3 standard, the count of operation data must be at least one block + * | | |Operations that are less than one block will output unexpected result. + * | | |In Non-DMA ECB, CBC, CFB, OFB, and CTR mode, CRPT_AESn_CNT must be set as byte count for the last block of data before feeding in the last block of data + * | | |In Non-DMA CBC-CS1, CBC-CS2, and CBC-CS3 mode, CRPT_AESn_CNT must be set as byte count for the last two blocks of data before feeding in the last two blocks of data. + * @var CRPT_T::AES3_KEY[8] + * Offset: 0x1C4 ~ 0x1E0 AES Key Word 0 ~ 7 Register for Channel 3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |CRPT_AESn_KEYx + * | | |The KEY keeps the security key for AES operation. + * | | |n = 0, 1..3. + * | | |x = 0, 1..7. + * | | |The security key for AES accelerator can be 128, 192, or 256 bits and four, six, or eight 32-bit registers are to store each security key + * | | |{CRPT_AESn_KEY3, CRPT_AESn_KEY2, CRPT_AESn_KEY1, CRPT_AESn_KEY0} stores the 128-bit security key for AES operation + * | | |{CRPT_AESn_KEY5, CRPT_AESn_KEY4, CRPT_AESn_KEY3, CRPT_AESn_KEY2, CRPT_AESn_KEY1, CRPT_AESn_KEY0} stores the 192-bit security key for AES operation + * | | |{CRPT_AESn_KEY7, CRPT_AESn_KEY6, CRPT_AESn_KEY5, CRPT_AESn_KEY4, CRPT_AESn_KEY3, CRPT_AESn_KEY2, CRPT_AESn_KEY1, CRPT_AESn_KEY0} stores the 256-bit security key for AES operation. + * @var CRPT_T::AES3_IV[4] + * Offset: 0x1E4 ~ 0x1F0 AES Initial Vector Word 0 ~ 3 Register for Channel 3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |IV |AES Initial Vectors + * | | |n = 0, 1..3. + * | | |x = 0, 1..3. + * | | |Four initial vectors (CRPT_AESn_IV0, CRPT_AESn_IV1, CRPT_AESn_IV2, and CRPT_AESn_IV3) are for AES operating in CBC, CFB, and OFB mode + * | | |Four registers (CRPT_AESn_IV0, CRPT_AESn_IV1, CRPT_AESn_IV2, and CRPT_AESn_IV3) act as Nonce counter when the AES engine is operating in CTR mode. + * @var CRPT_T::AES3_SADDR + * Offset: 0x1F4 AES DMA Source Address Register for Channel 3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |SADDR |AES DMA Source Address + * | | |The AES accelerator supports DMA function to transfer the plain text between system memory and embedded FIFO + * | | |The SADDR keeps the source address of the data buffer where the source text is stored + * | | |Based on the source address, the AES accelerator can read the plain text from system memory and do AES operation + * | | |The start of source address should be located at word boundary + * | | |In other words, bit 1 and 0 of SADDR are ignored. + * | | |SADDR can be read and written + * | | |Writing to SADDR while the AES accelerator is operating doesn't affect the current AES operation + * | | |But the value of SADDR will be updated later on + * | | |Consequently, software can prepare the DMA source address for the next AES operation. + * | | |In DMA mode, software can update the next CRPT_AESn_SADDR before triggering START. + * | | |The value of CRPT_AESn_SADDR and CRPT_AESn_DADDR can be the same. + * @var CRPT_T::AES3_DADDR + * Offset: 0x1F8 AES DMA Destination Address Register for Channel 3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |DADDR |AES DMA Destination Address + * | | |The AES accelerator supports DMA function to transfer the cipher text between system memory and embedded FIFO + * | | |The DADDR keeps the destination address of the data buffer where the engine output's text will be stored + * | | |Based on the destination address, the AES accelerator can write the cipher text back to system memory after the AES operation is finished + * | | |The start of destination address should be located at word boundary + * | | |In other words, bit 1 and 0 of DADDR are ignored. + * | | |DADDR can be read and written + * | | |Writing to DADDR while the AES accelerator is operating doesn't affect the current AES operation + * | | |But the value of DADDR will be updated later on + * | | |Consequently, software can prepare the destination address for the next AES operation. + * | | |In DMA mode, software can update the next CRPT_AESn_DADDR before triggering START. + * | | |The value of CRPT_AESn_SADDR and CRPT_AESn_DADDR can be the same. + * @var CRPT_T::AES3_CNT + * Offset: 0x1FC AES Byte Count Register for Channel 3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |CNT |AES Byte Count + * | | |The CRPT_AESn_CNT keeps the byte count of source text that is for the AES engine operating in DMA mode + * | | |The CRPT_AESn_CNT is 32-bit and the maximum of byte count is 4G bytes. + * | | |CRPT_AESn_CNT can be read and written + * | | |Writing to CRPT_AESn_CNT while the AES accelerator is operating doesn't affect the current AES operation + * | | |But the value of CRPT_AESn_CNT will be updated later on + * | | |Consequently, software can prepare the byte count of data for the next AES operation. + * | | |According to CBC-CS1, CBC-CS2, and CBC-CS3 standard, the count of operation data must be at least one block + * | | |Operations that are less than one block will output unexpected result. + * | | |In Non-DMA ECB, CBC, CFB, OFB, and CTR mode, CRPT_AESn_CNT must be set as byte count for the last block of data before feeding in the last block of data + * | | |In Non-DMA CBC-CS1, CBC-CS2, and CBC-CS3 mode, CRPT_AESn_CNT must be set as byte count for the last two blocks of data before feeding in the last two blocks of data. + * @var CRPT_T::TDES_CTL + * Offset: 0x200 TDES/DES Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |START |TDES/DES Engine Start + * | | |0 = No effect. + * | | |1 = Start TDES/DES engine. The flag BUSY would be set. + * | | |Note: The bit is always 0 when it's read back. + * |[1] |STOP |TDES/DES Engine Stop + * | | |0 = No effect. + * | | |1 = Stop TDES/DES engine. + * | | |Note: The bit is always 0 when it's read back. + * |[2] |TMODE |TDES/DES Engine Operating Mode + * | | |0 = Set DES mode for TDES/DES engine. + * | | |1 = Set Triple DES mode for TDES/DES engine. + * |[3] |3KEYS |TDES/DES Key Number + * | | |0 = Select KEY1 and KEY2 in TDES/DES engine. + * | | |1 = Triple keys in TDES/DES engine Enabled. + * |[5] |DMALAST |TDES/DES Engine Start for the Last Block + * | | |In DMA mode, this bit must be set as beginning the last DMA cascade round. + * | | |In Non-DMA mode, this bit must be set as feeding in last block of data. + * |[6] |DMACSCAD |TDES/DES Engine DMA with Cascade Mode + * | | |0 = DMA cascade function Disabled. + * | | |1 = In DMA Cascade mode, software can update DMA source address register, destination address register, and byte count register during a cascade operation, without finishing the accelerator operation. + * |[7] |DMAEN |TDES/DES Engine DMA Enable Control + * | | |0 = TDES_DMA engine Disabled. + * | | |TDES engine operates in Non-DMA mode, and get data from the port CRPT_TDES_DATIN. + * | | |1 = TDES_DMA engine Enabled. + * | | |TDES engine operates in DMA mode, and data movement from/to the engine is done by DMA logic. + * |[10:8] |OPMODE |TDES/DES Engine Operation Mode + * | | |0x00 = ECB (Electronic Codebook Mode). + * | | |0x01 = CBC (Cipher Block Chaining Mode). + * | | |0x02 = CFB (Cipher Feedback Mode). + * | | |0x03 = OFB (Output Feedback Mode). + * | | |0x04 = CTR (Counter Mode). + * | | |Others = CTR (Counter Mode). + * |[16] |ENCRPT |TDES/DES Encryption/Decryption + * | | |0 = TDES engine executes decryption operation. + * | | |1 = TDES engine executes encryption operation. + * |[21] |BLKSWAP |TDES/DES Engine Block Double Word Endian Swap + * | | |0 = Keep the original order, e.g. {WORD_H, WORD_L}. + * | | |1 = When this bit is set to 1, the TDES engine would exchange high and low word in the sequence {WORD_L, WORD_H}. + * |[22] |OUTSWAP |TDES/DES Engine Output Data Swap + * | | |0 = Keep the original order. + * | | |1 = The order that CPU outputs data from the accelerator will be changed from {byte3, byte2, byte1, byte0} to {byte0, byte1, byte2, byte3}. + * |[23] |INSWAP |TDES/DES Engine Input Data Swap + * | | |0 = Keep the original order. + * | | |1 = The order that CPU feeds data to the accelerator will be changed from {byte3, byte2, byte1, byte0} to {byte0, byte1, byte2, byte3}. + * |[25:24] |CHANNEL |TDES/DES Engine Working Channel + * | | |00 = Current control register setting is for channel 0. + * | | |01 = Current control register setting is for channel 1. + * | | |10 = Current control register setting is for channel 2. + * | | |11 = Current control register setting is for channel 3. + * |[30:26] |KEYUNPRT |Unprotect Key + * | | |Writing 0 to CRPT_TDES_CTL [31] and "10110" to CRPT_TDES_CTL [30:26] is to unprotect TDES key. + * | | |The KEYUNPRT can be read and written + * | | |When it is written as the TDES engine is operating, BUSY flag is 1, there would be no effect on KEYUNPRT. + * |[31] |KEYPRT |Protect Key + * | | |Read as a flag to reflect KEYPRT. + * | | |0 = No effect. + * | | |1 = This bit is to protect the content of TDES key from reading + * | | |The return value for reading CRPT_ TDESn_KEYxH/L is not the content in the registers CRPT_ TDESn_KEYxH/L + * | | |Once it is set, it can be cleared by asserting KEYUNPRT + * | | |The key content would be cleared as well. + * @var CRPT_T::TDES_STS + * Offset: 0x204 TDES/DES Engine Flag + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BUSY |TDES/DES Engine Busy + * | | |0 = TDES/DES engine is idle or finished. + * | | |1 = TDES/DES engine is under processing. + * |[8] |INBUFEMPTY|TDES/DES in Buffer Empty + * | | |0 = There are some data in input buffer waiting for the TDES/DES engine to process. + * | | |1 = TDES/DES input buffer is empty + * | | |Software needs to feed data to the TDES/DES engine + * | | |Otherwise, the TDES/DES engine will be pending to wait for input data. + * |[9] |INBUFFULL |TDES/DES in Buffer Full Flag + * | | |0 = TDES/DES input buffer is not full. Software can feed the data into the TDES/DES engine. + * | | |1 = TDES input buffer is full + * | | |Software cannot feed data to the TDES/DES engine + * | | |Otherwise, the flag INBUFERR will be set to 1. + * |[10] |INBUFERR |TDES/DES in Buffer Error Flag + * | | |0 = No error. + * | | |1 = Error happens during feeding data to the TDES/DES engine. + * |[16] |OUTBUFEMPTY|TDES/DES Output Buffer Empty Flag + * | | |0 = TDES/DES output buffer is not empty. There are some valid data kept in output buffer. + * | | |1 = TDES/DES output buffer is empty, Software cannot get data from TDES_DATA_OUT + * | | |Otherwise the flag OUTBUFERR will be set to 1, since output buffer is empty. + * |[17] |OUTBUFFULL|TDES/DES Output Buffer Full Flag + * | | |0 = TDES/DES output buffer is not full. + * | | |1 = TDES/DES output buffer is full, and software needs to get data from TDES_DATA_OUT + * | | |Otherwise, the TDES/DES engine will be pending since output buffer is full. + * |[18] |OUTBUFERR |TDES/DES Out Buffer Error Flag + * | | |0 = No error. + * | | |1 = Error happens during getting test result from TDES/DES engine. + * |[20] |BUSERR |TDES/DES DMA Access Bus Error Flag + * | | |0 = No error. + * | | |1 = Bus error will stop DMA operation and TDES/DES engine. + * @var CRPT_T::TDES0_KEY1H + * Offset: 0x208 TDES/DES Key 1 High Word Register for Channel 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 1 High Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES0_KEY1L + * Offset: 0x20C TDES/DES Key 1 Low Word Register for Channel 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 1 Low Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES0_KEY2H + * Offset: 0x210 TDES Key 2 High Word Register for Channel 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 2 High Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES0_KEY2L + * Offset: 0x214 TDES Key 2 Low Word Register for Channel 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 2 Low Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES0_KEY3H + * Offset: 0x218 TDES Key 3 High Word Register for Channel 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 3 High Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES0_KEY3L + * Offset: 0x21C TDES Key 3 Low Word Register for Channel 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 3 Low Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES0_IVH + * Offset: 0x220 TDES/DES Initial Vector High Word Register for Channel 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |IV |TDES/DES Initial Vector High Word + * | | |Initial vector (IV) is for TDES/DES engine in CBC, CFB, and OFB mode + * | | |IV is Nonce counter for TDES/DES engine in CTR mode. + * @var CRPT_T::TDES0_IVL + * Offset: 0x224 TDES/DES Initial Vector Low Word Register for Channel 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |IV |TDES/DES Initial Vector Low Word + * | | |Initial vector (IV) is for TDES/DES engine in CBC, CFB, and OFB mode + * | | |IV is Nonce counter for TDES/DES engine in CTR mode. + * @var CRPT_T::TDES0_SA + * Offset: 0x228 TDES/DES DMA Source Address Register for Channel 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |SADDR |TDES/DES DMA Source Address + * | | |The TDES/DES accelerator supports DMA function to transfer the plain text between system memory and embedded FIFO + * | | |The CRPT_TDESn_SA keeps the source address of the data buffer where the source text is stored + * | | |Based on the source address, the TDES/DES accelerator can read the plain text from system memory and do TDES/DES operation + * | | |The start of source address should be located at word boundary + * | | |In other words, bit 1 and 0 of CRPT_TDESn_SA are ignored. + * | | |CRPT_TDESn_SA can be read and written + * | | |Writing to CRPT_TDESn_SA while the TDES/DES accelerator is operating doesn't affect the current TDES/DES operation + * | | |But the value of CRPT_TDESn_SA will be updated later on + * | | |Consequently, software can prepare the DMA source address for the next TDES/DES operation. + * | | |In DMA mode, software can update the next CRPT_TDESn_SA before triggering START. + * | | |CRPT_TDESn_SA and CRPT_TDESn_DA can be the same in the value. + * @var CRPT_T::TDES0_DA + * Offset: 0x22C TDES/DES DMA Destination Address Register for Channel 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |DADDR |TDES/DES DMA Destination Address + * | | |The TDES/DES accelerator supports DMA function to transfer the cipher text between system memory and embedded FIFO + * | | |The CRPT_TDESn_DA keeps the destination address of the data buffer where the engine output's text will be stored + * | | |Based on the destination address, the TDES/DES accelerator can write the cipher text back to system memory after the TDES/DES operation is finished + * | | |The start of destination address should be located at word boundary + * | | |In other words, bit 1 and 0 of CRPT_TDESn_DA are ignored. + * | | |CRPT_TDESn_DA can be read and written + * | | |Writing to CRPT_TDESn_DA while the TDES/DES accelerator is operating doesn't affect the current TDES/DES operation + * | | |But the value of CRPT_TDESn_DA will be updated later on + * | | |Consequently, software can prepare the destination address for the next TDES/DES operation. + * | | |In DMA mode, software can update the next CRPT_TDESn_DA before triggering START. + * | | |CRPT_TDESn_SAD and CRPT_TDESn_DA can be the same in the value. + * @var CRPT_T::TDES0_CNT + * Offset: 0x230 TDES/DES Byte Count Register for Channel 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |CNT |TDES/DES Byte Count + * | | |The CRPT_TDESn_CNT keeps the byte count of source text that is for the TDES/DES engine operating in DMA mode + * | | |The CRPT_TDESn_CNT is 32-bit and the maximum of byte count is 4G bytes. + * | | |CRPT_TDESn_CNT can be read and written + * | | |Writing to CRPT_TDESn_CNT while the TDES/DES accelerator is operating doesn't affect the current TDES/DES operation + * | | |But the value of CRPT_TDESn_CNT will be updated later on + * | | |Consequently, software can prepare the byte count of data for the next TDES /DES operation. + * | | |In Non-DMA ECB, CBC, CFB, OFB, and CTR mode, CRPT_TDESn_CNT must be set as byte count for the last block of data before feeding in the last block of data. + * @var CRPT_T::TDES_DATIN + * Offset: 0x234 TDES/DES Engine Input data Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |DATIN |TDES/DES Engine Input Port + * | | |CPU feeds data to TDES/DES engine through this port by checking CRPT_TDES_STS + * | | |Feed data as INBUFFULL is 0. + * @var CRPT_T::TDES_DATOUT + * Offset: 0x238 TDES/DES Engine Output data Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |DATOUT |TDES/DES Engine Output Port + * | | |CPU gets result from the TDES/DES engine through this port by checking CRPT_TDES_STS + * | | |Get data as OUTBUFEMPTY is 0. + * @var CRPT_T::TDES1_KEY1H + * Offset: 0x248 TDES/DES Key 1 High Word Register for Channel 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 1 High Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES1_KEY1L + * Offset: 0x24C TDES/DES Key 1 Low Word Register for Channel 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 1 Low Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES1_KEY2H + * Offset: 0x250 TDES Key 2 High Word Register for Channel 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 2 High Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES1_KEY2L + * Offset: 0x254 TDES Key 2 Low Word Register for Channel 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 2 Low Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES1_KEY3H + * Offset: 0x258 TDES Key 3 High Word Register for Channel 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 3 High Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES1_KEY3L + * Offset: 0x25C TDES Key 3 Low Word Register for Channel 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 3 Low Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES1_IVH + * Offset: 0x260 TDES/DES Initial Vector High Word Register for Channel 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |IV |TDES/DES Initial Vector High Word + * | | |Initial vector (IV) is for TDES/DES engine in CBC, CFB, and OFB mode + * | | |IV is Nonce counter for TDES/DES engine in CTR mode. + * @var CRPT_T::TDES1_IVL + * Offset: 0x264 TDES/DES Initial Vector Low Word Register for Channel 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |IV |TDES/DES Initial Vector Low Word + * | | |Initial vector (IV) is for TDES/DES engine in CBC, CFB, and OFB mode + * | | |IV is Nonce counter for TDES/DES engine in CTR mode. + * @var CRPT_T::TDES1_SA + * Offset: 0x268 TDES/DES DMA Source Address Register for Channel 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |SADDR |TDES/DES DMA Source Address + * | | |The TDES/DES accelerator supports DMA function to transfer the plain text between system memory and embedded FIFO + * | | |The CRPT_TDESn_SA keeps the source address of the data buffer where the source text is stored + * | | |Based on the source address, the TDES/DES accelerator can read the plain text from system memory and do TDES/DES operation + * | | |The start of source address should be located at word boundary + * | | |In other words, bit 1 and 0 of CRPT_TDESn_SA are ignored. + * | | |CRPT_TDESn_SA can be read and written + * | | |Writing to CRPT_TDESn_SA while the TDES/DES accelerator is operating doesn't affect the current TDES/DES operation + * | | |But the value of CRPT_TDESn_SA will be updated later on + * | | |Consequently, software can prepare the DMA source address for the next TDES/DES operation. + * | | |In DMA mode, software can update the next CRPT_TDESn_SA before triggering START. + * | | |CRPT_TDESn_SA and CRPT_TDESn_DA can be the same in the value. + * @var CRPT_T::TDES1_DA + * Offset: 0x26C TDES/DES DMA Destination Address Register for Channel 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |DADDR |TDES/DES DMA Destination Address + * | | |The TDES/DES accelerator supports DMA function to transfer the cipher text between system memory and embedded FIFO + * | | |The CRPT_TDESn_DA keeps the destination address of the data buffer where the engine output's text will be stored + * | | |Based on the destination address, the TDES/DES accelerator can write the cipher text back to system memory after the TDES/DES operation is finished + * | | |The start of destination address should be located at word boundary + * | | |In other words, bit 1 and 0 of CRPT_TDESn_DA are ignored. + * | | |CRPT_TDESn_DA can be read and written + * | | |Writing to CRPT_TDESn_DA while the TDES/DES accelerator is operating doesn't affect the current TDES/DES operation + * | | |But the value of CRPT_TDESn_DA will be updated later on + * | | |Consequently, software can prepare the destination address for the next TDES/DES operation. + * | | |In DMA mode, software can update the next CRPT_TDESn_DA before triggering START. + * | | |CRPT_TDESn_SAD and CRPT_TDESn_DA can be the same in the value. + * @var CRPT_T::TDES1_CNT + * Offset: 0x270 TDES/DES Byte Count Register for Channel 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |CNT |TDES/DES Byte Count + * | | |The CRPT_TDESn_CNT keeps the byte count of source text that is for the TDES/DES engine operating in DMA mode + * | | |The CRPT_TDESn_CNT is 32-bit and the maximum of byte count is 4G bytes. + * | | |CRPT_TDESn_CNT can be read and written + * | | |Writing to CRPT_TDESn_CNT while the TDES/DES accelerator is operating doesn't affect the current TDES/DES operation + * | | |But the value of CRPT_TDESn_CNT will be updated later on + * | | |Consequently, software can prepare the byte count of data for the next TDES /DES operation. + * | | |In Non-DMA ECB, CBC, CFB, OFB, and CTR mode, CRPT_TDESn_CNT must be set as byte count for the last block of data before feeding in the last block of data. + * @var CRPT_T::TDES2_KEY1H + * Offset: 0x288 TDES/DES Key 1 High Word Register for Channel 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 1 High Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES2_KEY1L + * Offset: 0x28C TDES/DES Key 1 Low Word Register for Channel 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 1 Low Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES2_KEY2H + * Offset: 0x290 TDES Key 2 High Word Register for Channel 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 2 High Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES2_KEY2L + * Offset: 0x294 TDES Key 2 Low Word Register for Channel 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 2 Low Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES2_KEY3H + * Offset: 0x298 TDES Key 3 High Word Register for Channel 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 3 High Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES2_KEY3L + * Offset: 0x29C TDES Key 3 Low Word Register for Channel 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 3 Low Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES2_IVH + * Offset: 0x2A0 TDES/DES Initial Vector High Word Register for Channel 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |IV |TDES/DES Initial Vector High Word + * | | |Initial vector (IV) is for TDES/DES engine in CBC, CFB, and OFB mode + * | | |IV is Nonce counter for TDES/DES engine in CTR mode. + * @var CRPT_T::TDES2_IVL + * Offset: 0x2A4 TDES/DES Initial Vector Low Word Register for Channel 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |IV |TDES/DES Initial Vector Low Word + * | | |Initial vector (IV) is for TDES/DES engine in CBC, CFB, and OFB mode + * | | |IV is Nonce counter for TDES/DES engine in CTR mode. + * @var CRPT_T::TDES2_SA + * Offset: 0x2A8 TDES/DES DMA Source Address Register for Channel 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |SADDR |TDES/DES DMA Source Address + * | | |The TDES/DES accelerator supports DMA function to transfer the plain text between system memory and embedded FIFO + * | | |The CRPT_TDESn_SA keeps the source address of the data buffer where the source text is stored + * | | |Based on the source address, the TDES/DES accelerator can read the plain text from system memory and do TDES/DES operation + * | | |The start of source address should be located at word boundary + * | | |In other words, bit 1 and 0 of CRPT_TDESn_SA are ignored. + * | | |CRPT_TDESn_SA can be read and written + * | | |Writing to CRPT_TDESn_SA while the TDES/DES accelerator is operating doesn't affect the current TDES/DES operation + * | | |But the value of CRPT_TDESn_SA will be updated later on + * | | |Consequently, software can prepare the DMA source address for the next TDES/DES operation. + * | | |In DMA mode, software can update the next CRPT_TDESn_SA before triggering START. + * | | |CRPT_TDESn_SA and CRPT_TDESn_DA can be the same in the value. + * @var CRPT_T::TDES2_DA + * Offset: 0x2AC TDES/DES DMA Destination Address Register for Channel 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |DADDR |TDES/DES DMA Destination Address + * | | |The TDES/DES accelerator supports DMA function to transfer the cipher text between system memory and embedded FIFO + * | | |The CRPT_TDESn_DA keeps the destination address of the data buffer where the engine output's text will be stored + * | | |Based on the destination address, the TDES/DES accelerator can write the cipher text back to system memory after the TDES/DES operation is finished + * | | |The start of destination address should be located at word boundary + * | | |In other words, bit 1 and 0 of CRPT_TDESn_DA are ignored. + * | | |CRPT_TDESn_DA can be read and written + * | | |Writing to CRPT_TDESn_DA while the TDES/DES accelerator is operating doesn't affect the current TDES/DES operation + * | | |But the value of CRPT_TDESn_DA will be updated later on + * | | |Consequently, software can prepare the destination address for the next TDES/DES operation. + * | | |In DMA mode, software can update the next CRPT_TDESn_DA before triggering START. + * | | |CRPT_TDESn_SAD and CRPT_TDESn_DA can be the same in the value. + * @var CRPT_T::TDES2_CNT + * Offset: 0x2B0 TDES/DES Byte Count Register for Channel 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |CNT |TDES/DES Byte Count + * | | |The CRPT_TDESn_CNT keeps the byte count of source text that is for the TDES/DES engine operating in DMA mode + * | | |The CRPT_TDESn_CNT is 32-bit and the maximum of byte count is 4G bytes. + * | | |CRPT_TDESn_CNT can be read and written + * | | |Writing to CRPT_TDESn_CNT while the TDES/DES accelerator is operating doesn't affect the current TDES/DES operation + * | | |But the value of CRPT_TDESn_CNT will be updated later on + * | | |Consequently, software can prepare the byte count of data for the next TDES /DES operation. + * | | |In Non-DMA ECB, CBC, CFB, OFB, and CTR mode, CRPT_TDESn_CNT must be set as byte count for the last block of data before feeding in the last block of data. + * @var CRPT_T::TDES3_KEY1H + * Offset: 0x2C8 TDES/DES Key 1 High Word Register for Channel 3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 1 High Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES3_KEY1L + * Offset: 0x2CC TDES/DES Key 1 Low Word Register for Channel 3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 1 High Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES3_KEY2H + * Offset: 0x2D0 TDES Key 2 High Word Register for Channel 3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 2 High Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES3_KEY2L + * Offset: 0x2D4 TDES Key 2 Low Word Register for Channel 3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 2 Low Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES3_KEY3H + * Offset: 0x2D8 TDES Key 3 High Word Register for Channel 3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 3 High Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES3_KEY3L + * Offset: 0x2DC TDES Key 3 Low Word Register for Channel 3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY |TDES/DES Key 3 Low Word + * | | |The key registers for TDES/DES algorithm calculation + * | | |The security key for the TDES/DES accelerator is 64 bits + * | | |Thus, it needs two 32-bit registers to store a security key + * | | |The register CRPT_TDESn_KEYxH is used to keep the bit [63:32] of security key for the TDES/DES operation, while the register CRPT_TDESn_KEYxL is used to keep the bit [31:0]. + * @var CRPT_T::TDES3_IVH + * Offset: 0x2E0 TDES/DES Initial Vector High Word Register for Channel 3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |IV |TDES/DES Initial Vector High Word + * | | |Initial vector (IV) is for TDES/DES engine in CBC, CFB, and OFB mode + * | | |IV is Nonce counter for TDES/DES engine in CTR mode. + * @var CRPT_T::TDES3_IVL + * Offset: 0x2E4 TDES/DES Initial Vector Low Word Register for Channel 3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |IV |TDES/DES Initial Vector Low Word + * | | |Initial vector (IV) is for TDES/DES engine in CBC, CFB, and OFB mode + * | | |IV is Nonce counter for TDES/DES engine in CTR mode. + * @var CRPT_T::TDES3_SA + * Offset: 0x2E8 TDES/DES DMA Source Address Register for Channel 3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |SADDR |TDES/DES DMA Source Address + * | | |The TDES/DES accelerator supports DMA function to transfer the plain text between system memory and embedded FIFO + * | | |The CRPT_TDESn_SA keeps the source address of the data buffer where the source text is stored + * | | |Based on the source address, the TDES/DES accelerator can read the plain text from system memory and do TDES/DES operation + * | | |The start of source address should be located at word boundary + * | | |In other words, bit 1 and 0 of CRPT_TDESn_SA are ignored. + * | | |CRPT_TDESn_SA can be read and written + * | | |Writing to CRPT_TDESn_SA while the TDES/DES accelerator is operating doesn't affect the current TDES/DES operation + * | | |But the value of CRPT_TDESn_SA will be updated later on + * | | |Consequently, software can prepare the DMA source address for the next TDES/DES operation. + * | | |In DMA mode, software can update the next CRPT_TDESn_SA before triggering START. + * | | |CRPT_TDESn_SA and CRPT_TDESn_DA can be the same in the value. + * @var CRPT_T::TDES3_DA + * Offset: 0x2EC TDES/DES DMA Destination Address Register for Channel 3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |DADDR |TDES/DES DMA Destination Address + * | | |The TDES/DES accelerator supports DMA function to transfer the cipher text between system memory and embedded FIFO + * | | |The CRPT_TDESn_DA keeps the destination address of the data buffer where the engine output's text will be stored + * | | |Based on the destination address, the TDES/DES accelerator can write the cipher text back to system memory after the TDES/DES operation is finished + * | | |The start of destination address should be located at word boundary + * | | |In other words, bit 1 and 0 of CRPT_TDESn_DA are ignored. + * | | |CRPT_TDESn_DA can be read and written + * | | |Writing to CRPT_TDESn_DA while the TDES/DES accelerator is operating doesn't affect the current TDES/DES operation + * | | |But the value of CRPT_TDESn_DA will be updated later on + * | | |Consequently, software can prepare the destination address for the next TDES/DES operation. + * | | |In DMA mode, software can update the next CRPT_TDESn_DA before triggering START. + * | | |CRPT_TDESn_SAD and CRPT_TDESn_DA can be the same in the value. + * @var CRPT_T::TDES3_CNT + * Offset: 0x2F0 TDES/DES Byte Count Register for Channel 3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |CNT |TDES/DES Byte Count + * | | |The CRPT_TDESn_CNT keeps the byte count of source text that is for the TDES/DES engine operating in DMA mode + * | | |The CRPT_TDESn_CNT is 32-bit and the maximum of byte count is 4G bytes. + * | | |CRPT_TDESn_CNT can be read and written + * | | |Writing to CRPT_TDESn_CNT while the TDES/DES accelerator is operating doesn't affect the current TDES/DES operation + * | | |But the value of CRPT_TDESn_CNT will be updated later on + * | | |Consequently, software can prepare the byte count of data for the next TDES /DES operation. + * | | |In Non-DMA ECB, CBC, CFB, OFB, and CTR mode, CRPT_TDESn_CNT must be set as byte count for the last block of data before feeding in the last block of data. + * @var CRPT_T::HMAC_CTL + * Offset: 0x300 SHA/HMAC Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |START |SHA/HMAC Engine Start + * | | |0 = No effect. + * | | |1 = Start SHA/HMAC engine. BUSY flag will be set. + * | | |This bit is always 0 when it's read back. + * |[1] |STOP |SHA/HMAC Engine Stop + * | | |0 = No effect. + * | | |1 = Stop SHA/HMAC engine. + * | | |This bit is always 0 when it's read back. + * |[4] |HMACEN |HMAC_SHA Engine Operating Mode + * | | |0 = execute SHA function. + * | | |1 = execute HMAC function. + * |[5] |DMALAST |SHA/HMAC Last Block + * | | |This bit must be set as feeding in last byte of data. + * |[7] |DMAEN |SHA/HMAC Engine DMA Enable Control + * | | |0 = SHA/HMAC DMA engine Disabled. + * | | |SHA/HMAC engine operates in Non-DMA mode, and gets data from the port CRPT_HMAC_DATIN. + * | | |1 = SHA/HMAC DMA engine Enabled. + * | | |SHA/HMAC engine operates in DMA mode, and data movement from/to the engine is done by DMA logic. + * |[10:8] |OPMODE |SHA/HMAC Engine Operation Modes + * | | |0x0xx: SHA160 + * | | |0x100: SHA256 + * | | |0x101: SHA224 + * | | |0x110: SHA512 + * | | |0x111: SHA384 + * | | |These bits can be read and written. But writing to them wouldn't take effect as BUSY is 1. + * |[22] |OUTSWAP |SHA/HMAC Engine Output Data Swap + * | | |0 = Keep the original order. + * | | |1 = The order that CPU feeds data to the accelerator will be changed from {byte3, byte2, byte1, byte0} to {byte0, byte1, byte2, byte3}. + * |[23] |INSWAP |SHA/HMAC Engine Input Data Swap + * | | |0 = Keep the original order. + * | | |1 = The order that CPU feeds data to the accelerator will be changed from {byte3, byte2, byte1, byte0} to {byte0, byte1, byte2, byte3}. + * @var CRPT_T::HMAC_STS + * Offset: 0x304 SHA/HMAC Status Flag + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BUSY |SHA/HMAC Engine Busy + * | | |0 = SHA/HMAC engine is idle or finished. + * | | |1 = SHA/HMAC engine is busy. + * |[1] |DMABUSY |SHA/HMAC Engine DMA Busy Flag + * | | |0 = SHA/HMAC DMA engine is idle or finished. + * | | |1 = SHA/HMAC DMA engine is busy. + * |[8] |DMAERR |SHA/HMAC Engine DMA Error Flag + * | | |0 = Show the SHA/HMAC engine access normal. + * | | |1 = Show the SHA/HMAC engine access error. + * |[16] |DATINREQ |SHA/HMAC Non-DMA Mode Data Input Request + * | | |0 = No effect. + * | | |1 = Request SHA/HMAC Non-DMA mode data input. + * @var CRPT_T::HMAC_DGST[16] + * Offset: 0x308 ~ 0x344 SHA/HMAC Digest Message 0 ~ 15 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |DGST |SHA/HMAC Digest Message Output Register + * | | |For SHA-160, the digest is stored in CRPT_HMAC_DGST0 ~ CRPT_HMAC_DGST4. + * | | |For SHA-224, the digest is stored in CRPT_HMAC_DGST0 ~ CRPT_HMAC_DGST6. + * | | |For SHA-256, the digest is stored in CRPT_HMAC_DGST0 ~ CRPT_HMAC_DGST7. + * | | |For SHA-384, the digest is stored in CRPT_HMAC_DGST0 ~ CRPT_HMAC_DGST11. + * | | |For SHA-512, the digest is stored in CRPT_HMAC_DGST0 ~ CRPT_HMAC_DGST15. + * @var CRPT_T::HMAC_KEYCNT + * Offset: 0x348 SHA/HMAC Key Byte Count Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEYCNT |SHA/HMAC Key Byte Count + * | | |The CRPT_HMAC_KEYCNT keeps the byte count of key that SHA/HMAC engine operates + * | | |The register is 32-bit and the maximum byte count is 4G bytes + * | | |It can be read and written. + * | | |Writing to the register CRPT_HMAC_KEYCNT as the SHA/HMAC accelerator operating doesn't affect the current SHA/HMAC operation + * | | |But the value of CRPT_SHA _KEYCNT will be updated later on + * | | |Consequently, software can prepare the key count for the next SHA/HMAC operation. + * @var CRPT_T::HMAC_SADDR + * Offset: 0x34C SHA/HMAC DMA Source Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |SADDR |SHA/HMAC DMA Source Address + * | | |The SHA/HMAC accelerator supports DMA function to transfer the plain text between system memory and embedded FIFO + * | | |The CRPT_HMAC_SADDR keeps the source address of the data buffer where the source text is stored + * | | |Based on the source address, the SHA/HMAC accelerator can read the plain text from system memory and do SHA/HMAC operation + * | | |The start of source address should be located at word boundary + * | | |In other words, bit 1 and 0 of CRPT_HMAC_SADDR are ignored. + * | | |CRPT_HMAC_SADDR can be read and written + * | | |Writing to CRPT_HMAC_SADDR while the SHA/HMAC accelerator is operating doesn't affect the current SHA/HMAC operation + * | | |But the value of CRPT_HMAC_SADDR will be updated later on + * | | |Consequently, software can prepare the DMA source address for the next SHA/HMAC operation. + * | | |In DMA mode, software can update the next CRPT_HMAC_SADDR before triggering START. + * | | |CRPT_HMAC_SADDR and CRPT_HMAC_DADDR can be the same in the value. + * @var CRPT_T::HMAC_DMACNT + * Offset: 0x350 SHA/HMAC Byte Count Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |DMACNT |SHA/HMAC Operation Byte Count + * | | |The CRPT_HMAC_DMACNT keeps the byte count of source text that is for the SHA/HMAC engine operating in DMA mode + * | | |The CRPT_HMAC_DMACNT is 32-bit and the maximum of byte count is 4G bytes. + * | | |CRPT_HMAC_DMACNT can be read and written + * | | |Writing to CRPT_HMAC_DMACNT while the SHA/HMAC accelerator is operating doesn't affect the current SHA/HMAC operation + * | | |But the value of CRPT_HMAC_DMACNT will be updated later on + * | | |Consequently, software can prepare the byte count of data for the next SHA/HMAC operation. + * | | |In Non-DMA mode, CRPT_HMAC_DMACNT must be set as the byte count of the last block before feeding in the last block of data. + * @var CRPT_T::HMAC_DATIN + * Offset: 0x354 SHA/HMAC Engine Non-DMA Mode Data Input Port Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |DATIN |SHA/HMAC Engine Input Port + * | | |CPU feeds data to SHA/HMAC engine through this port by checking CRPT_HMAC_STS + * | | |Feed data as DATINREQ is 1. + * @var CRPT_T::ECC_CTL + * Offset: 0x800 ECC Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |START |ECC Accelerator Start + * | | |0 = No effect. + * | | |1 = Start ECC accelerator. BUSY flag will be set. + * | | |This bit is always 0 when it's read back. + * | | |ECC accelerator will ignore this START signal when BUSY flag is 1. + * |[1] |STOP |ECC Accelerator Stop + * | | |0 = No effect. + * | | |1 = Abort ECC accelerator and make it into idle state. + * | | |This bit is always 0 when it's read back. + * | | |Remember to clear ECC interrupt flag after stopping ECC accelerator. + * |[7] |DMAEN |ECC Accelerator DMA Enable Control + * | | |0 = ECC DMA engine Disabled. + * | | |1 = ECC DMA engine Enabled. + * | | |Only when START and DMAEN are 1, ECC DMA engine will be active + * |[8] |FSEL |Field Selection + * | | |0 = Binary Field (GF(2^m)). + * | | |1 = Prime Field (GF(p)). + * |[10:9] |ECCOP |Point Operation for BF and PF + * | | |00 = Point multiplication :. + * | | |(POINTX1, POINTY1) = SCALARK * (POINTX1, POINTY1). + * | | |01 = Modulus operation : choose by MODOP (CRPT_ECC_CTL[12:11]). + * | | |10 = Point addition :. + * | | |(POINTX1, POINTY1) = (POINTX1, POINTY1) +. + * | | |(POINTX2, POINTY2) + * | | |11 = Point doubling :. + * | | |(POINTX1, POINTY1) = 2 * (POINTX1, POINTY1). + * | | |Besides above three input data, point operations still need the parameters of elliptic curve (CURVEA, CURVEB, CURVEN and CURVEM) as shown in Figure 6.27-11 + * |[12:11] |MODOP |Modulus Operation for PF + * | | |00 = Division :. + * | | |POINTX1 = (POINTY1 / POINTX1) % CURVEN. + * | | |01 = Multiplication :. + * | | |POINTX1 = (POINTX1 * POINTY1) % CURVEN. + * | | |10 = Addition :. + * | | |POINTX1 = (POINTX1 + POINTY1) % CURVEN. + * | | |11 = Subtraction :. + * | | |POINTX1 = (POINTX1 - POINTY1) % CURVEN. + * | | |MODOP is active only when ECCOP = 01. + * |[16] |LDP1 |The Control Signal of Register for the X and Y Coordinate of the First Point (POINTX1, POINTY1) + * | | |0 = The register for POINTX1 and POINTY1 is not modified by DMA or user. + * | | |1 = The register for POINTX1 and POINTY1 is modified by DMA or user. + * |[17] |LDP2 |The Control Signal of Register for the X and Y Coordinate of the Second Point (POINTX2, POINTY2) + * | | |0 = The register for POINTX2 and POINTY2 is not modified by DMA or user. + * | | |1 = The register for POINTX2 and POINTY2 is modified by DMA or user. + * |[18] |LDA |The Control Signal of Register for the Parameter CURVEA of Elliptic Curve + * | | |0 = The register for CURVEA is not modified by DMA or user. + * | | |1 = The register for CURVEA is modified by DMA or user. + * |[19] |LDB |The Control Signal of Register for the Parameter CURVEB of Elliptic Curve + * | | |0 = The register for CURVEB is not modified by DMA or user. + * | | |1 = The register for CURVEB is modified by DMA or user. + * |[20] |LDN |The Control Signal of Register for the Parameter CURVEN of Elliptic Curve + * | | |0 = The register for CURVEN is not modified by DMA or user. + * | | |1 = The register for CURVEN is modified by DMA or user. + * |[21] |LDK |The Control Signal of Register for SCALARK + * | | |0 = The register for SCALARK is not modified by DMA or user. + * | | |1 = The register for SCALARK is modified by DMA or user. + * |[31:22] |CURVEM |The key length of elliptic curve. + * @var CRPT_T::ECC_STS + * Offset: 0x804 ECC Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BUSY |ECC Accelerator Busy Flag + * | | |0 = The ECC accelerator is idle or finished. + * | | |1 = The ECC accelerator is under processing and protects all registers. + * | | |Remember to clear ECC interrupt flag after ECC accelerator finished + * |[1] |DMABUSY |ECC DMA Busy Flag + * | | |0 = ECC DMA is idle or finished. + * | | |1 = ECC DMA is busy. + * |[16] |BUSERR |ECC DMA Access Bus Error Flag + * | | |0 = No error. + * | | |1 = Bus error will stop DMA operation and ECC accelerator. + * @var CRPT_T::ECC_X1[18] + * Offset: 0x808 ~ 0x84C ECC The X-coordinate word 0 ~ 17 of the first point + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |POINTX1 |ECC the x-coordinate Value of the First Point (POINTX1) + * | | |For B-163 or K-163, POINTX1 is stored in CRPT_ECC_X1_00~CRPT_ECC_X1_05 + * | | |For B-233 or K-233, POINTX1 is stored in CRPT_ECC_X1_00~CRPT_ECC_X1_07 + * | | |For B-283 or K-283, POINTX1 is stored in CRPT_ECC_X1_00~CRPT_ECC_X1_08 + * | | |For B-409 or K-409, POINTX1 is stored in CRPT_ECC_X1_00~CRPT_ECC_X1_12 + * | | |For B-571 or K-571, POINTX1 is stored in CRPT_ECC_X1_00~CRPT_ECC_X1_17 + * | | |For P-192, POINTX1 is stored in CRPT_ECC_X1_00~CRPT_ECC_X1_05 + * | | |For P-224, POINTX1 is stored in CRPT_ECC_X1_00~CRPT_ECC_X1_06 + * | | |For P-256, POINTX1 is stored in CRPT_ECC_X1_00~CRPT_ECC_X1_07 + * | | |For P-384, POINTX1 is stored in CRPT_ECC_X1_00~CRPT_ECC_X1_11 + * | | |For P-521, POINTX1 is stored in CRPT_ECC_X1_00~CRPT_ECC_X1_16 + * @var CRPT_T::ECC_Y1[18] + * Offset: 0x850 ~ 0x894 ECC The Y-coordinate word 0 ~ 17 of the first point + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |POINTY1 |ECC the Y-coordinate Value of the First Point (POINTY1) + * | | |For B-163 or K-163, POINTY1 is stored in CRPT_ECC_Y1_00~CRPT_ECC_Y1_05 + * | | |For B-233 or K-233, POINTY1 is stored in CRPT_ECC_Y1_00~CRPT_ECC_Y1_07 + * | | |For B-283 or K-283, POINTY1 is stored in CRPT_ECC_Y1_00~CRPT_ECC_Y1_08 + * | | |For B-409 or K-409, POINTY1 is stored in CRPT_ECC_Y1_00~CRPT_ECC_Y1_12 + * | | |For B-571 or K-571, POINTY1 is stored in CRPT_ECC_Y1_00~CRPT_ECC_Y1_17 + * | | |For P-192, POINTY1 is stored in CRPT_ECC_Y1_00~CRPT_ECC_Y1_05 + * | | |For P-224, POINTY1 is stored in CRPT_ECC_Y1_00~CRPT_ECC_Y1_06 + * | | |For P-256, POINTY1 is stored in CRPT_ECC_Y1_00~CRPT_ECC_Y1_07 + * | | |For P-384, POINTY1 is stored in CRPT_ECC_Y1_00~CRPT_ECC_Y1_11 + * | | |For P-521, POINTY1 is stored in CRPT_ECC_Y1_00~CRPT_ECC_Y1_16 + * @var CRPT_T::ECC_X2[18] + * Offset: 0x898 ~ 0x8DC ECC The X-coordinate word 0 ~ 17 of the second point + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |POINTX2 |ECC the x-coordinate Value of the Second Point (POINTX2) + * | | |For B-163 or K-163, POINTX2 is stored in CRPT_ECC_X2_00~CRPT_ECC_X2_05 + * | | |For B-233 or K-233, POINTX2 is stored in CRPT_ECC_X2_00~CRPT_ECC_X2_07 + * | | |For B-283 or K-283, POINTX2 is stored in CRPT_ECC_X2_00~CRPT_ECC_X2_08 + * | | |For B-409 or K-409, POINTX2 is stored in CRPT_ECC_X2_00~CRPT_ECC_X2_12 + * | | |For B-571 or K-571, POINTX2 is stored in CRPT_ECC_X2_00~CRPT_ECC_X2_17 + * | | |For P-192, POINTX2 is stored in CRPT_ECC_X2_00~CRPT_ECC_X2_05 + * | | |For P-224, POINTX2 is stored in CRPT_ECC_X2_00~CRPT_ECC_X2_06 + * | | |For P-256, POINTX2 is stored in CRPT_ECC_X2_00~CRPT_ECC_X2_07 + * | | |For P-384, POINTX2 is stored in CRPT_ECC_X2_00~CRPT_ECC_X2_11 + * | | |For P-521, POINTX2 is stored in CRPT_ECC_X2_00~CRPT_ECC_X2_16 + * @var CRPT_T::ECC_Y2[18] + * Offset: 0x8E0 ~ 0x924 ECC The Y-coordinate word 0 ~ 17 of the second point + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |POINTY2 |ECC the Y-coordinate Value of the Second Point (POINTY2) + * | | |For B-163 or K-163, POINTY2 is stored in CRPT_ECC_Y2_00~CRPT_ECC_Y2_05 + * | | |For B-233 or K-233, POINTY2 is stored in CRPT_ECC_Y2_00~CRPT_ECC_Y2_07 + * | | |For B-283 or K-283, POINTY2 is stored in CRPT_ECC_Y2_00~CRPT_ECC_Y2_08 + * | | |For B-409 or K-409, POINTY2 is stored in CRPT_ECC_Y2_00~CRPT_ECC_Y2_12 + * | | |For B-571 or K-571, POINTY2 is stored in CRPT_ECC_Y2_00~CRPT_ECC_Y2_17 + * | | |For P-192, POINTY2 is stored in CRPT_ECC_Y2_00~CRPT_ECC_Y2_05 + * | | |For P-224, POINTY2 is stored in CRPT_ECC_Y2_00~CRPT_ECC_Y2_06 + * | | |For P-256, POINTY2 is stored in CRPT_ECC_Y2_00~CRPT_ECC_Y2_07 + * | | |For P-384, POINTY2 is stored in CRPT_ECC_Y2_00~CRPT_ECC_Y2_11 + * | | |For P-521, POINTY2 is stored in CRPT_ECC_Y2_00~CRPT_ECC_Y2_16 + * @var CRPT_T::ECC_A[18] + * Offset: 0x928 ~ 0x96C ECC The parameter CURVEA word 0 ~ 17 of elliptic curve + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |CURVEA |ECC the Parameter CURVEA Value of Elliptic Curve (CURVEA) + * | | |The formula of elliptic curve is y2=x3+CURVEA*x+CURVEB in GF(p) and y2+x*y=x3+CURVEA*x2+CURVEB in GF(2^m). + * | | |For B-163 or K-163, CURVEA is stored in CRPT_ECC_A_00~CRPT_ECC_A_05 + * | | |For B-233 or K-233, CURVEA is stored in CRPT_ECC_A_00~CRPT_ECC_A_07 + * | | |For B-283 or K-283, CURVEA is stored in CRPT_ECC_A_00~CRPT_ECC_A_08 + * | | |For B-409 or K-409, CURVEA is stored in CRPT_ECC_A_00~CRPT_ECC_A_12 + * | | |For B-571 or K-571, CURVEA is stored in CRPT_ECC_A_00~CRPT_ECC_A_17 + * | | |For P-192, CURVEA is stored in CRPT_ECC_A_00~CRPT_ECC_A_05 + * | | |For P-224, CURVEA is stored in CRPT_ECC_A_00~CRPT_ECC_A_06 + * | | |For P-256, CURVEA is stored in CRPT_ECC_A_00~CRPT_ECC_A_07 + * | | |For P-384, CURVEA is stored in CRPT_ECC_A_00~CRPT_ECC_A_11 + * | | |For P-521, CURVEA is stored in CRPT_ECC_A_00~CRPT_ECC_A_16 + * @var CRPT_T::ECC_B[18] + * Offset: 0x970 ~ 0x9B4 ECC The parameter CURVEB word 0 ~ 17 of elliptic curve + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |CURVEB |ECC the Parameter CURVEB Value of Elliptic Curve (CURVEA) + * | | |The formula of elliptic curve is y2=x3+CURVEA*x+CURVEB in GF(p) and y2+x*y=x3+CURVEA*x2+CURVEB in GF(2^m). + * | | |For B-163 or K-163, CURVEB is stored in CRPT_ECC_B_00~CRPT_ECC_B_05 + * | | |For B-233 or K-233, CURVEB is stored in CRPT_ECC_B_00~CRPT_ECC_B_07 + * | | |For B-283 or K-283, CURVEB is stored in CRPT_ECC_B_00~CRPT_ECC_B_08 + * | | |For B-409 or K-409, CURVEB is stored in CRPT_ECC_B_00~CRPT_ECC_B_12 + * | | |For B-521 or K-521, CURVEB is stored in CRPT_ECC_B_00~CRPT_ECC_B_17 + * | | |For P-192, CURVEB is stored in CRPT_ECC_B_00~CRPT_ECC_B_05 + * | | |For P-224, CURVEB is stored in CRPT_ECC_B_00~CRPT_ECC_B_06 + * | | |For P-256, CURVEB is stored in CRPT_ECC_B_00~CRPT_ECC_B_07 + * | | |For P-384, CURVEB is stored in CRPT_ECC_B_00~CRPT_ECC_B_11 + * | | |For P-521, CURVEB is stored in CRPT_ECC_B_00~CRPT_ECC_B_16 + * @var CRPT_T::ECC_N[18] + * Offset: 0x9B8 ~ 0x9FC ECC The parameter CURVEN word 0 ~ 17 of elliptic curve + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |CURVEN |ECC the Parameter CURVEN Value of Elliptic Curve (CURVEN) + * | | |In GF(p), CURVEN is the prime p. + * | | |In GF(2^m), CURVEN is the irreducible polynomial. + * | | |For B-163 or K-163, CURVEN is stored in CRPT_ECC_N_00~CRPT_ECC_N_05 + * | | |For B-233 or K-233, CURVEN is stored in CRPT_ECC_N_00~CRPT_ECC_N_07 + * | | |For B-283 or K-283, CURVEN is stored in CRPT_ECC_N_00~CRPT_ECC_N_08 + * | | |For B-409 or K-409, CURVEN is stored in CRPT_ECC_N_00~CRPT_ECC_N_12 + * | | |For B-571 or K-571, CURVEN is stored in CRPT_ECC_N_00~CRPT_ECC_N_17 + * | | |For P-192, CURVEN is stored in CRPT_ECC_N_00~CRPT_ECC_N_05 + * | | |For P-224, CURVEN is stored in CRPT_ECC_N_00~CRPT_ECC_N_06 + * | | |For P-256, CURVEN is stored in CRPT_ECC_N_00~CRPT_ECC_N_07 + * | | |For P-384, CURVEN is stored in CRPT_ECC_N_00~CRPT_ECC_N_11 + * | | |For P-521, CURVEN is stored in CRPT_ECC_N_00~CRPT_ECC_N_16 + * @var CRPT_T::ECC_K[18] + * Offset: 0xA00 ~ 0xA44 ECC The scalar SCALARK word0 of point multiplication + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |SCALARK |ECC the Scalar SCALARK Value of Point Multiplication(SCALARK) + * | | |Because the SCALARK usually stores the private key, ECC accelerator do not allow to read the register SCALARK. + * | | |For B-163 or K-163, SCALARK is stored in CRPT_ECC_K_00~CRPT_ECC_K_05 + * | | |For B-233 or K-233, SCALARK is stored in CRPT_ECC_K_00~CRPT_ECC_K_07 + * | | |For B-283 or K-283, SCALARK is stored in CRPT_ECC_K_00~CRPT_ECC_K_08 + * | | |For B-409 or K-409, SCALARK is stored in CRPT_ECC_K_00~CRPT_ECC_K_12 + * | | |For B-571 or K-571, SCALARK is stored in CRPT_ECC_K_00~CRPT_ECC_K_17 + * | | |For P-192, SCALARK is stored in CRPT_ECC_K_00~CRPT_ECC_K_05 + * | | |For P-224, SCALARK is stored in CRPT_ECC_K_00~CRPT_ECC_K_06 + * | | |For P-256, SCALARK is stored in CRPT_ECC_K_00~CRPT_ECC_K_07 + * | | |For P-384, SCALARK is stored in CRPT_ECC_K_00~CRPT_ECC_K_11 + * | | |For P-521, SCALARK is stored in CRPT_ECC_K_00~CRPT_ECC_K_16 + * @var CRPT_T::ECC_SADDR + * Offset: 0xA48 ECC DMA Source Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |SADDR |ECC DMA Source Address + * | | |The ECC accelerator supports DMA function to transfer the DATA and PARAMETER between + * | | |SRAM memory space and ECC accelerator. The SADDR keeps the source address of the data + * | | |buffer where the source text is stored. Based on the source address, the ECC accelerator + * | | |can read the DATA and PARAMETER from SRAM memory space and do ECC operation. The start + * | | |of source address should be located at word boundary. That is, bit 1 and 0 of SADDR are + * | | |ignored. SADDR can be read and written. In DMA mode, software must update the CRPT_ECC_SADDR + * | | |before triggering START. + * @var CRPT_T::ECC_DADDR + * Offset: 0xA4C ECC DMA Destination Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |DADDR |ECC DMA Destination Address + * | | |The ECC accelerator supports DMA function to transfer the DATA and PARAMETER between system memory and ECC accelerator + * | | |The DADDR keeps the destination address of the data buffer where output data of ECC engine will be stored + * | | |Based on the destination address, the ECC accelerator can write the result data back to system memory after the ECC operation is finished + * | | |The start of destination address should be located at word boundary + * | | |That is, bit 1 and 0 of DADDR are ignored + * | | |DADDR can be read and written + * | | |In DMA mode, software must update the CRPT_ECC_DADDR before triggering START + * @var CRPT_T::ECC_STARTREG + * Offset: 0xA50 ECC Starting Address of Updated Registers + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |STARTREG |ECC Starting Address of Updated Registers + * | | |The address of the updated registers that DMA feeds the first data or parameter to ECC engine + * | | |When ECC engine is active, ECC accelerator does not allow users to modify STARTREG + * | | |For example, we want to updated input data from register CRPT_ECC POINTX1 + * | | |Thus, the value of STARTREG is 0x808. + * @var CRPT_T::ECC_WORDCNT + * Offset: 0xA54 ECC DMA Word Count + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |WORDCNT |ECC DMA Word Count + * | | |The CRPT_ECC_WORDCNT keeps the word count of source data that is for the required input data of ECC accelerator with various operations in DMA mode + * | | |Although CRPT_ECC_WORDCNT is 32-bit, the maximum of word count in ECC accelerator is 144 words + * | | |CRPT_ECC_WORDCNT can be read and written + */ + __IO uint32_t INTEN; /*!< [0x0000] Crypto Interrupt Enable Control Register */ + __IO uint32_t INTSTS; /*!< [0x0004] Crypto Interrupt Flag */ + __IO uint32_t PRNG_CTL; /*!< [0x0008] PRNG Control Register */ + __O uint32_t PRNG_SEED; /*!< [0x000c] Seed for PRNG */ + __I uint32_t PRNG_KEY[8]; /*!< [0x0010] ~ [0x002c] PRNG Generated Key0 ~ Key7 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[8]; + /// @endcond //HIDDEN_SYMBOLS + __I uint32_t AES_FDBCK[4]; /*!< [0x0050] ~ [0x005c] AES Engine Output Feedback Data after Cryptographic Operation */ + __I uint32_t TDES_FDBCKH; /*!< [0x0060] TDES/DES Engine Output Feedback High Word Data after Cryptographic Operation */ + __I uint32_t TDES_FDBCKL; /*!< [0x0064] TDES/DES Engine Output Feedback Low Word Data after Cryptographic Operation */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE1[38]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t AES_CTL; /*!< [0x0100] AES Control Register */ + __I uint32_t AES_STS; /*!< [0x0104] AES Engine Flag */ + __IO uint32_t AES_DATIN; /*!< [0x0108] AES Engine Data Input Port Register */ + __I uint32_t AES_DATOUT; /*!< [0x010c] AES Engine Data Output Port Register */ + __IO uint32_t AES0_KEY[8]; /*!< [0x0110] ~ [0x012c] AES Key Word 0~7 Register for Channel 0 */ + __IO uint32_t AES0_IV[4]; /*!< [0x0130] ~ [0x013c] AES Initial Vector Word 0 ~ 3 Register for Channel 0 */ + __IO uint32_t AES0_SADDR; /*!< [0x0140] AES DMA Source Address Register for Channel 0 */ + __IO uint32_t AES0_DADDR; /*!< [0x0144] AES DMA Destination Address Register for Channel 0 */ + __IO uint32_t AES0_CNT; /*!< [0x0148] AES Byte Count Register for Channel 0 */ + __IO uint32_t AES1_KEY[8]; /*!< [0x014c] ~ [0x0168] AES Key Word 0~7 Register for Channel 1 */ + __IO uint32_t AES1_IV[4]; /*!< [0x016c] ~ [0x0178] AES Initial Vector Word 0~3 Register for Channel 1 */ + __IO uint32_t AES1_SADDR; /*!< [0x017c] AES DMA Source Address Register for Channel 1 */ + __IO uint32_t AES1_DADDR; /*!< [0x0180] AES DMA Destination Address Register for Channel 1 */ + __IO uint32_t AES1_CNT; /*!< [0x0184] AES Byte Count Register for Channel 1 */ + __IO uint32_t AES2_KEY[8]; /*!< [0x0188] ~ [0x01a4] AES Key Word 0~7 Register for Channel 2 */ + __IO uint32_t AES2_IV[4]; /*!< [0x01a8] ~ [0x01b4] AES Initial Vector Word 0~3 Register for Channel 2 */ + __IO uint32_t AES2_SADDR; /*!< [0x01b8] AES DMA Source Address Register for Channel 2 */ + __IO uint32_t AES2_DADDR; /*!< [0x01bc] AES DMA Destination Address Register for Channel 2 */ + __IO uint32_t AES2_CNT; /*!< [0x01c0] AES Byte Count Register for Channel 2 */ + __IO uint32_t AES3_KEY[8]; /*!< [0x01c4] ~ [0x01e0] AES Key Word 0~7 Register for Channel 3 */ + __IO uint32_t AES3_IV[4]; /*!< [0x01e4] ~ [0x01f0] AES Initial Vector Word 0~3 Register for Channel 3 */ + __IO uint32_t AES3_SADDR; /*!< [0x01f4] AES DMA Source Address Register for Channel 3 */ + __IO uint32_t AES3_DADDR; /*!< [0x01f8] AES DMA Destination Address Register for Channel 3 */ + __IO uint32_t AES3_CNT; /*!< [0x01fc] AES Byte Count Register for Channel 3 */ + __IO uint32_t TDES_CTL; /*!< [0x0200] TDES/DES Control Register */ + __I uint32_t TDES_STS; /*!< [0x0204] TDES/DES Engine Flag */ + __IO uint32_t TDES0_KEY1H; /*!< [0x0208] TDES/DES Key 1 High Word Register for Channel 0 */ + __IO uint32_t TDES0_KEY1L; /*!< [0x020c] TDES/DES Key 1 Low Word Register for Channel 0 */ + __IO uint32_t TDES0_KEY2H; /*!< [0x0210] TDES Key 2 High Word Register for Channel 0 */ + __IO uint32_t TDES0_KEY2L; /*!< [0x0214] TDES Key 2 Low Word Register for Channel 0 */ + __IO uint32_t TDES0_KEY3H; /*!< [0x0218] TDES Key 3 High Word Register for Channel 0 */ + __IO uint32_t TDES0_KEY3L; /*!< [0x021c] TDES Key 3 Low Word Register for Channel 0 */ + __IO uint32_t TDES0_IVH; /*!< [0x0220] TDES/DES Initial Vector High Word Register for Channel 0 */ + __IO uint32_t TDES0_IVL; /*!< [0x0224] TDES/DES Initial Vector Low Word Register for Channel 0 */ + __IO uint32_t TDES0_SA; /*!< [0x0228] TDES/DES DMA Source Address Register for Channel 0 */ + __IO uint32_t TDES0_DA; /*!< [0x022c] TDES/DES DMA Destination Address Register for Channel 0 */ + __IO uint32_t TDES0_CNT; /*!< [0x0230] TDES/DES Byte Count Register for Channel 0 */ + __IO uint32_t TDES_DATIN; /*!< [0x0234] TDES/DES Engine Input data Word Register */ + __I uint32_t TDES_DATOUT; /*!< [0x0238] TDES/DES Engine Output data Word Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE2[3]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t TDES1_KEY1H; /*!< [0x0248] TDES/DES Key 1 High Word Register for Channel 1 */ + __IO uint32_t TDES1_KEY1L; /*!< [0x024c] TDES/DES Key 1 Low Word Register for Channel 1 */ + __IO uint32_t TDES1_KEY2H; /*!< [0x0250] TDES Key 2 High Word Register for Channel 1 */ + __IO uint32_t TDES1_KEY2L; /*!< [0x0254] TDES Key 2 Low Word Register for Channel 1 */ + __IO uint32_t TDES1_KEY3H; /*!< [0x0258] TDES Key 3 High Word Register for Channel 1 */ + __IO uint32_t TDES1_KEY3L; /*!< [0x025c] TDES Key 3 Low Word Register for Channel 1 */ + __IO uint32_t TDES1_IVH; /*!< [0x0260] TDES/DES Initial Vector High Word Register for Channel 1 */ + __IO uint32_t TDES1_IVL; /*!< [0x0264] TDES/DES Initial Vector Low Word Register for Channel 1 */ + __IO uint32_t TDES1_SA; /*!< [0x0268] TDES/DES DMA Source Address Register for Channel 1 */ + __IO uint32_t TDES1_DA; /*!< [0x026c] TDES/DES DMA Destination Address Register for Channel 1 */ + __IO uint32_t TDES1_CNT; /*!< [0x0270] TDES/DES Byte Count Register for Channel 1 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE3[5]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t TDES2_KEY1H; /*!< [0x0288] TDES/DES Key 1 High Word Register for Channel 2 */ + __IO uint32_t TDES2_KEY1L; /*!< [0x028c] TDES/DES Key 1 Low Word Register for Channel 2 */ + __IO uint32_t TDES2_KEY2H; /*!< [0x0290] TDES Key 2 High Word Register for Channel 2 */ + __IO uint32_t TDES2_KEY2L; /*!< [0x0294] TDES Key 2 Low Word Register for Channel 2 */ + __IO uint32_t TDES2_KEY3H; /*!< [0x0298] TDES Key 3 High Word Register for Channel 2 */ + __IO uint32_t TDES2_KEY3L; /*!< [0x029c] TDES Key 3 Low Word Register for Channel 2 */ + __IO uint32_t TDES2_IVH; /*!< [0x02a0] TDES/DES Initial Vector High Word Register for Channel 2 */ + __IO uint32_t TDES2_IVL; /*!< [0x02a4] TDES/DES Initial Vector Low Word Register for Channel 2 */ + __IO uint32_t TDES2_SA; /*!< [0x02a8] TDES/DES DMA Source Address Register for Channel 2 */ + __IO uint32_t TDES2_DA; /*!< [0x02ac] TDES/DES DMA Destination Address Register for Channel 2 */ + __IO uint32_t TDES2_CNT; /*!< [0x02b0] TDES/DES Byte Count Register for Channel 2 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE4[5]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t TDES3_KEY1H; /*!< [0x02c8] TDES/DES Key 1 High Word Register for Channel 3 */ + __IO uint32_t TDES3_KEY1L; /*!< [0x02cc] TDES/DES Key 1 Low Word Register for Channel 3 */ + __IO uint32_t TDES3_KEY2H; /*!< [0x02d0] TDES Key 2 High Word Register for Channel 3 */ + __IO uint32_t TDES3_KEY2L; /*!< [0x02d4] TDES Key 2 Low Word Register for Channel 3 */ + __IO uint32_t TDES3_KEY3H; /*!< [0x02d8] TDES Key 3 High Word Register for Channel 3 */ + __IO uint32_t TDES3_KEY3L; /*!< [0x02dc] TDES Key 3 Low Word Register for Channel 3 */ + __IO uint32_t TDES3_IVH; /*!< [0x02e0] TDES/DES Initial Vector High Word Register for Channel 3 */ + __IO uint32_t TDES3_IVL; /*!< [0x02e4] TDES/DES Initial Vector Low Word Register for Channel 3 */ + __IO uint32_t TDES3_SA; /*!< [0x02e8] TDES/DES DMA Source Address Register for Channel 3 */ + __IO uint32_t TDES3_DA; /*!< [0x02ec] TDES/DES DMA Destination Address Register for Channel 3 */ + __IO uint32_t TDES3_CNT; /*!< [0x02f0] TDES/DES Byte Count Register for Channel 3 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE5[3]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t HMAC_CTL; /*!< [0x0300] SHA/HMAC Control Register */ + __I uint32_t HMAC_STS; /*!< [0x0304] SHA/HMAC Status Flag */ + __I uint32_t HMAC_DGST[16]; /*!< [0x0308] ~ [0x0344] SHA/HMAC Digest Message 0~15 */ + __IO uint32_t HMAC_KEYCNT; /*!< [0x0348] SHA/HMAC Key Byte Count Register */ + __IO uint32_t HMAC_SADDR; /*!< [0x034c] SHA/HMAC DMA Source Address Register */ + __IO uint32_t HMAC_DMACNT; /*!< [0x0350] SHA/HMAC Byte Count Register */ + __IO uint32_t HMAC_DATIN; /*!< [0x0354] SHA/HMAC Engine Non-DMA Mode Data Input Port Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE6[298]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t ECC_CTL; /*!< [0x0800] ECC Control Register */ + __I uint32_t ECC_STS; /*!< [0x0804] ECC Status Register */ + __IO uint32_t ECC_X1[18]; /*!< [0x0808] ~ [0x084c] ECC The X-coordinate word 0~17 of the first point */ + __IO uint32_t ECC_Y1[18]; /*!< [0x0850] ~ [0x0894] ECC The Y-coordinate word 0~17 of the first point */ + __IO uint32_t ECC_X2[18]; /*!< [0x0898] ~ [0x08dc] ECC The X-coordinate word 0~17 of the second point */ + __IO uint32_t ECC_Y2[18]; /*!< [0x08e0] ~ [0x0924] ECC The Y-coordinate word 0~17 of the second point */ + __IO uint32_t ECC_A[18]; /*!< [0x0928] ~ [0x096c] ECC The parameter CURVEA word 0~17 of elliptic curve */ + __IO uint32_t ECC_B[18]; /*!< [0x0970] ~ [0x09b4] ECC The parameter CURVEB word 0~17 of elliptic curve */ + __IO uint32_t ECC_N[18]; /*!< [0x09b8] ~ [0x09fc] ECC The parameter CURVEN word 0~17 of elliptic curve */ + __O uint32_t ECC_K[18]; /*!< [0x0a00] ~ [0x0a44] ECC The scalar SCALARK word 0~17 of point multiplication */ + __IO uint32_t ECC_SADDR; /*!< [0x0a48] ECC DMA Source Address Register */ + __IO uint32_t ECC_DADDR; /*!< [0x0a4c] ECC DMA Destination Address Register */ + __IO uint32_t ECC_STARTREG; /*!< [0x0a50] ECC Starting Address of Updated Registers */ + __IO uint32_t ECC_WORDCNT; /*!< [0x0a54] ECC DMA Word Count */ + +} CRPT_T; + +/** + @addtogroup CRPT_CONST CRPT Bit Field Definition + Constant Definitions for CRPT Controller +@{ */ + +#define CRPT_INTEN_AESIEN_Pos (0) /*!< CRPT_T::INTEN: AESIEN Position */ +#define CRPT_INTEN_AESIEN_Msk (0x1ul << CRPT_INTEN_AESIEN_Pos) /*!< CRPT_T::INTEN: AESIEN Mask */ + +#define CRPT_INTEN_AESEIEN_Pos (1) /*!< CRPT_T::INTEN: AESEIEN Position */ +#define CRPT_INTEN_AESEIEN_Msk (0x1ul << CRPT_INTEN_AESEIEN_Pos) /*!< CRPT_T::INTEN: AESEIEN Mask */ + +#define CRPT_INTEN_TDESIEN_Pos (8) /*!< CRPT_T::INTEN: TDESIEN Position */ +#define CRPT_INTEN_TDESIEN_Msk (0x1ul << CRPT_INTEN_TDESIEN_Pos) /*!< CRPT_T::INTEN: TDESIEN Mask */ + +#define CRPT_INTEN_TDESEIEN_Pos (9) /*!< CRPT_T::INTEN: TDESEIEN Position */ +#define CRPT_INTEN_TDESEIEN_Msk (0x1ul << CRPT_INTEN_TDESEIEN_Pos) /*!< CRPT_T::INTEN: TDESEIEN Mask */ + +#define CRPT_INTEN_PRNGIEN_Pos (16) /*!< CRPT_T::INTEN: PRNGIEN Position */ +#define CRPT_INTEN_PRNGIEN_Msk (0x1ul << CRPT_INTEN_PRNGIEN_Pos) /*!< CRPT_T::INTEN: PRNGIEN Mask */ + +#define CRPT_INTEN_ECCIEN_Pos (22) /*!< CRPT_T::INTEN: ECCIEN Position */ +#define CRPT_INTEN_ECCIEN_Msk (0x1ul << CRPT_INTEN_ECCIEN_Pos) /*!< CRPT_T::INTEN: ECCIEN Mask */ + +#define CRPT_INTEN_ECCEIEN_Pos (23) /*!< CRPT_T::INTEN: ECCEIEN Position */ +#define CRPT_INTEN_ECCEIEN_Msk (0x1ul << CRPT_INTEN_ECCEIEN_Pos) /*!< CRPT_T::INTEN: ECCEIEN Mask */ + +#define CRPT_INTEN_HMACIEN_Pos (24) /*!< CRPT_T::INTEN: HMACIEN Position */ +#define CRPT_INTEN_HMACIEN_Msk (0x1ul << CRPT_INTEN_HMACIEN_Pos) /*!< CRPT_T::INTEN: HMACIEN Mask */ + +#define CRPT_INTEN_HMACEIEN_Pos (25) /*!< CRPT_T::INTEN: HMACEIEN Position */ +#define CRPT_INTEN_HMACEIEN_Msk (0x1ul << CRPT_INTEN_HMACEIEN_Pos) /*!< CRPT_T::INTEN: HMACEIEN Mask */ + +#define CRPT_INTSTS_AESIF_Pos (0) /*!< CRPT_T::INTSTS: AESIF Position */ +#define CRPT_INTSTS_AESIF_Msk (0x1ul << CRPT_INTSTS_AESIF_Pos) /*!< CRPT_T::INTSTS: AESIF Mask */ + +#define CRPT_INTSTS_AESEIF_Pos (1) /*!< CRPT_T::INTSTS: AESEIF Position */ +#define CRPT_INTSTS_AESEIF_Msk (0x1ul << CRPT_INTSTS_AESEIF_Pos) /*!< CRPT_T::INTSTS: AESEIF Mask */ + +#define CRPT_INTSTS_TDESIF_Pos (8) /*!< CRPT_T::INTSTS: TDESIF Position */ +#define CRPT_INTSTS_TDESIF_Msk (0x1ul << CRPT_INTSTS_TDESIF_Pos) /*!< CRPT_T::INTSTS: TDESIF Mask */ + +#define CRPT_INTSTS_TDESEIF_Pos (9) /*!< CRPT_T::INTSTS: TDESEIF Position */ +#define CRPT_INTSTS_TDESEIF_Msk (0x1ul << CRPT_INTSTS_TDESEIF_Pos) /*!< CRPT_T::INTSTS: TDESEIF Mask */ + +#define CRPT_INTSTS_PRNGIF_Pos (16) /*!< CRPT_T::INTSTS: PRNGIF Position */ +#define CRPT_INTSTS_PRNGIF_Msk (0x1ul << CRPT_INTSTS_PRNGIF_Pos) /*!< CRPT_T::INTSTS: PRNGIF Mask */ + +#define CRPT_INTSTS_ECCIF_Pos (22) /*!< CRPT_T::INTSTS: ECCIF Position */ +#define CRPT_INTSTS_ECCIF_Msk (0x1ul << CRPT_INTSTS_ECCIF_Pos) /*!< CRPT_T::INTSTS: ECCIF Mask */ + +#define CRPT_INTSTS_ECCEIF_Pos (23) /*!< CRPT_T::INTSTS: ECCEIF Position */ +#define CRPT_INTSTS_ECCEIF_Msk (0x1ul << CRPT_INTSTS_ECCEIF_Pos) /*!< CRPT_T::INTSTS: ECCEIF Mask */ + +#define CRPT_INTSTS_HMACIF_Pos (24) /*!< CRPT_T::INTSTS: HMACIF Position */ +#define CRPT_INTSTS_HMACIF_Msk (0x1ul << CRPT_INTSTS_HMACIF_Pos) /*!< CRPT_T::INTSTS: HMACIF Mask */ + +#define CRPT_INTSTS_HMACEIF_Pos (25) /*!< CRPT_T::INTSTS: HMACEIF Position */ +#define CRPT_INTSTS_HMACEIF_Msk (0x1ul << CRPT_INTSTS_HMACEIF_Pos) /*!< CRPT_T::INTSTS: HMACEIF Mask */ + +#define CRPT_PRNG_CTL_START_Pos (0) /*!< CRPT_T::PRNG_CTL: START Position */ +#define CRPT_PRNG_CTL_START_Msk (0x1ul << CRPT_PRNG_CTL_START_Pos) /*!< CRPT_T::PRNG_CTL: START Mask */ + +#define CRPT_PRNG_CTL_SEEDRLD_Pos (1) /*!< CRPT_T::PRNG_CTL: SEEDRLD Position */ +#define CRPT_PRNG_CTL_SEEDRLD_Msk (0x1ul << CRPT_PRNG_CTL_SEEDRLD_Pos) /*!< CRPT_T::PRNG_CTL: SEEDRLD Mask */ + +#define CRPT_PRNG_CTL_KEYSZ_Pos (2) /*!< CRPT_T::PRNG_CTL: KEYSZ Position */ +#define CRPT_PRNG_CTL_KEYSZ_Msk (0x3ul << CRPT_PRNG_CTL_KEYSZ_Pos) /*!< CRPT_T::PRNG_CTL: KEYSZ Mask */ + +#define CRPT_PRNG_CTL_BUSY_Pos (8) /*!< CRPT_T::PRNG_CTL: BUSY Position */ +#define CRPT_PRNG_CTL_BUSY_Msk (0x1ul << CRPT_PRNG_CTL_BUSY_Pos) /*!< CRPT_T::PRNG_CTL: BUSY Mask */ + +#define CRPT_PRNG_SEED_SEED_Pos (0) /*!< CRPT_T::PRNG_SEED: SEED Position */ +#define CRPT_PRNG_SEED_SEED_Msk (0xfffffffful << CRPT_PRNG_SEED_SEED_Pos) /*!< CRPT_T::PRNG_SEED: SEED Mask */ + +#define CRPT_PRNG_KEYx_KEY_Pos (0) /*!< CRPT_T::PRNG_KEY[8]: KEY Position */ +#define CRPT_PRNG_KEYx_KEY_Msk (0xfffffffful << CRPT_PRNG_KEYx_KEY_Pos) /*!< CRPT_T::PRNG_KEY[8]: KEY Mask */ + +#define CRPT_AES_FDBCKx_FDBCK_Pos (0) /*!< CRPT_T::AES_FDBCK[4]: FDBCK Position */ +#define CRPT_AES_FDBCKx_FDBCK_Msk (0xfffffffful << CRPT_AES_FDBCKx_FDBCK_Pos) /*!< CRPT_T::AES_FDBCK[4]: FDBCK Mask */ + +#define CRPT_TDES_FDBCKH_FDBCK_Pos (0) /*!< CRPT_T::TDES_FDBCKH: FDBCK Position */ +#define CRPT_TDES_FDBCKH_FDBCK_Msk (0xfffffffful << CRPT_TDES_FDBCKH_FDBCK_Pos) /*!< CRPT_T::TDES_FDBCKH: FDBCK Mask */ + +#define CRPT_TDES_FDBCKL_FDBCK_Pos (0) /*!< CRPT_T::TDES_FDBCKL: FDBCK Position */ +#define CRPT_TDES_FDBCKL_FDBCK_Msk (0xfffffffful << CRPT_TDES_FDBCKL_FDBCK_Pos) /*!< CRPT_T::TDES_FDBCKL: FDBCK Mask */ + +#define CRPT_AES_CTL_START_Pos (0) /*!< CRPT_T::AES_CTL: START Position */ +#define CRPT_AES_CTL_START_Msk (0x1ul << CRPT_AES_CTL_START_Pos) /*!< CRPT_T::AES_CTL: START Mask */ + +#define CRPT_AES_CTL_STOP_Pos (1) /*!< CRPT_T::AES_CTL: STOP Position */ +#define CRPT_AES_CTL_STOP_Msk (0x1ul << CRPT_AES_CTL_STOP_Pos) /*!< CRPT_T::AES_CTL: STOP Mask */ + +#define CRPT_AES_CTL_KEYSZ_Pos (2) /*!< CRPT_T::AES_CTL: KEYSZ Position */ +#define CRPT_AES_CTL_KEYSZ_Msk (0x3ul << CRPT_AES_CTL_KEYSZ_Pos) /*!< CRPT_T::AES_CTL: KEYSZ Mask */ + +#define CRPT_AES_CTL_DMALAST_Pos (5) /*!< CRPT_T::AES_CTL: DMALAST Position */ +#define CRPT_AES_CTL_DMALAST_Msk (0x1ul << CRPT_AES_CTL_DMALAST_Pos) /*!< CRPT_T::AES_CTL: DMALAST Mask */ + +#define CRPT_AES_CTL_DMACSCAD_Pos (6) /*!< CRPT_T::AES_CTL: DMACSCAD Position */ +#define CRPT_AES_CTL_DMACSCAD_Msk (0x1ul << CRPT_AES_CTL_DMACSCAD_Pos) /*!< CRPT_T::AES_CTL: DMACSCAD Mask */ + +#define CRPT_AES_CTL_DMAEN_Pos (7) /*!< CRPT_T::AES_CTL: DMAEN Position */ +#define CRPT_AES_CTL_DMAEN_Msk (0x1ul << CRPT_AES_CTL_DMAEN_Pos) /*!< CRPT_T::AES_CTL: DMAEN Mask */ + +#define CRPT_AES_CTL_OPMODE_Pos (8) /*!< CRPT_T::AES_CTL: OPMODE Position */ +#define CRPT_AES_CTL_OPMODE_Msk (0xfful << CRPT_AES_CTL_OPMODE_Pos) /*!< CRPT_T::AES_CTL: OPMODE Mask */ + +#define CRPT_AES_CTL_ENCRPT_Pos (16) /*!< CRPT_T::AES_CTL: ENCRPT Position */ +#define CRPT_AES_CTL_ENCRPT_Msk (0x1ul << CRPT_AES_CTL_ENCRPT_Pos) /*!< CRPT_T::AES_CTL: ENCRPT Mask */ + +#define CRPT_AES_CTL_OUTSWAP_Pos (22) /*!< CRPT_T::AES_CTL: OUTSWAP Position */ +#define CRPT_AES_CTL_OUTSWAP_Msk (0x1ul << CRPT_AES_CTL_OUTSWAP_Pos) /*!< CRPT_T::AES_CTL: OUTSWAP Mask */ + +#define CRPT_AES_CTL_INSWAP_Pos (23) /*!< CRPT_T::AES_CTL: INSWAP Position */ +#define CRPT_AES_CTL_INSWAP_Msk (0x1ul << CRPT_AES_CTL_INSWAP_Pos) /*!< CRPT_T::AES_CTL: INSWAP Mask */ + +#define CRPT_AES_CTL_CHANNEL_Pos (24) /*!< CRPT_T::AES_CTL: CHANNEL Position */ +#define CRPT_AES_CTL_CHANNEL_Msk (0x3ul << CRPT_AES_CTL_CHANNEL_Pos) /*!< CRPT_T::AES_CTL: CHANNEL Mask */ + +#define CRPT_AES_CTL_KEYUNPRT_Pos (26) /*!< CRPT_T::AES_CTL: KEYUNPRT Position */ +#define CRPT_AES_CTL_KEYUNPRT_Msk (0x1ful << CRPT_AES_CTL_KEYUNPRT_Pos) /*!< CRPT_T::AES_CTL: KEYUNPRT Mask */ + +#define CRPT_AES_CTL_KEYPRT_Pos (31) /*!< CRPT_T::AES_CTL: KEYPRT Position */ +#define CRPT_AES_CTL_KEYPRT_Msk (0x1ul << CRPT_AES_CTL_KEYPRT_Pos) /*!< CRPT_T::AES_CTL: KEYPRT Mask */ + +#define CRPT_AES_STS_BUSY_Pos (0) /*!< CRPT_T::AES_STS: BUSY Position */ +#define CRPT_AES_STS_BUSY_Msk (0x1ul << CRPT_AES_STS_BUSY_Pos) /*!< CRPT_T::AES_STS: BUSY Mask */ + +#define CRPT_AES_STS_INBUFEMPTY_Pos (8) /*!< CRPT_T::AES_STS: INBUFEMPTY Position */ +#define CRPT_AES_STS_INBUFEMPTY_Msk (0x1ul << CRPT_AES_STS_INBUFEMPTY_Pos) /*!< CRPT_T::AES_STS: INBUFEMPTY Mask */ + +#define CRPT_AES_STS_INBUFFULL_Pos (9) /*!< CRPT_T::AES_STS: INBUFFULL Position */ +#define CRPT_AES_STS_INBUFFULL_Msk (0x1ul << CRPT_AES_STS_INBUFFULL_Pos) /*!< CRPT_T::AES_STS: INBUFFULL Mask */ + +#define CRPT_AES_STS_INBUFERR_Pos (10) /*!< CRPT_T::AES_STS: INBUFERR Position */ +#define CRPT_AES_STS_INBUFERR_Msk (0x1ul << CRPT_AES_STS_INBUFERR_Pos) /*!< CRPT_T::AES_STS: INBUFERR Mask */ + +#define CRPT_AES_STS_CNTERR_Pos (12) /*!< CRPT_T::AES_STS: CNTERR Position */ +#define CRPT_AES_STS_CNTERR_Msk (0x1ul << CRPT_AES_STS_CNTERR_Pos) /*!< CRPT_T::AES_STS: CNTERR Mask */ + +#define CRPT_AES_STS_OUTBUFEMPTY_Pos (16) /*!< CRPT_T::AES_STS: OUTBUFEMPTY Position */ +#define CRPT_AES_STS_OUTBUFEMPTY_Msk (0x1ul << CRPT_AES_STS_OUTBUFEMPTY_Pos) /*!< CRPT_T::AES_STS: OUTBUFEMPTY Mask */ + +#define CRPT_AES_STS_OUTBUFFULL_Pos (17) /*!< CRPT_T::AES_STS: OUTBUFFULL Position */ +#define CRPT_AES_STS_OUTBUFFULL_Msk (0x1ul << CRPT_AES_STS_OUTBUFFULL_Pos) /*!< CRPT_T::AES_STS: OUTBUFFULL Mask */ + +#define CRPT_AES_STS_OUTBUFERR_Pos (18) /*!< CRPT_T::AES_STS: OUTBUFERR Position */ +#define CRPT_AES_STS_OUTBUFERR_Msk (0x1ul << CRPT_AES_STS_OUTBUFERR_Pos) /*!< CRPT_T::AES_STS: OUTBUFERR Mask */ + +#define CRPT_AES_STS_BUSERR_Pos (20) /*!< CRPT_T::AES_STS: BUSERR Position */ +#define CRPT_AES_STS_BUSERR_Msk (0x1ul << CRPT_AES_STS_BUSERR_Pos) /*!< CRPT_T::AES_STS: BUSERR Mask */ + +#define CRPT_AES_DATIN_DATIN_Pos (0) /*!< CRPT_T::AES_DATIN: DATIN Position */ +#define CRPT_AES_DATIN_DATIN_Msk (0xfffffffful << CRPT_AES_DATIN_DATIN_Pos) /*!< CRPT_T::AES_DATIN: DATIN Mask */ + +#define CRPT_AES_DATOUT_DATOUT_Pos (0) /*!< CRPT_T::AES_DATOUT: DATOUT Position */ +#define CRPT_AES_DATOUT_DATOUT_Msk (0xfffffffful << CRPT_AES_DATOUT_DATOUT_Pos) /*!< CRPT_T::AES_DATOUT: DATOUT Mask */ + +#define CRPT_AES0_KEYx_KEY_Pos (0) /*!< CRPT_T::AES0_KEY[8]: KEY Position */ +#define CRPT_AES0_KEYx_KEY_Msk (0xfffffffful << CRPT_AES0_KEYx_KEY_Pos) /*!< CRPT_T::AES0_KEY[8]: KEY Mask */ + +#define CRPT_AES0_IVx_IV_Pos (0) /*!< CRPT_T::AES0_IV[4]: IV Position */ +#define CRPT_AES0_IVx_IV_Msk (0xfffffffful << CRPT_AES0_IVx_IV_Pos) /*!< CRPT_T::AES0_IV[4]: IV Mask */ + +#define CRPT_AES0_SADDR_SADDR_Pos (0) /*!< CRPT_T::AES0_SADDR: SADDR Position */ +#define CRPT_AES0_SADDR_SADDR_Msk (0xfffffffful << CRPT_AES0_SADDR_SADDR_Pos) /*!< CRPT_T::AES0_SADDR: SADDR Mask */ + +#define CRPT_AES0_DADDR_DADDR_Pos (0) /*!< CRPT_T::AES0_DADDR: DADDR Position */ +#define CRPT_AES0_DADDR_DADDR_Msk (0xfffffffful << CRPT_AES0_DADDR_DADDR_Pos) /*!< CRPT_T::AES0_DADDR: DADDR Mask */ + +#define CRPT_AES0_CNT_CNT_Pos (0) /*!< CRPT_T::AES0_CNT: CNT Position */ +#define CRPT_AES0_CNT_CNT_Msk (0xfffffffful << CRPT_AES0_CNT_CNT_Pos) /*!< CRPT_T::AES0_CNT: CNT Mask */ + +#define CRPT_AES1_KEYx_KEY_Pos (0) /*!< CRPT_T::AES1_KEY[8]: KEY Position */ +#define CRPT_AES1_KEYx_KEY_Msk (0xfffffffful << CRPT_AES1_KEYx_KEY_Pos) /*!< CRPT_T::AES1_KEY[8]: KEY Mask */ + +#define CRPT_AES1_IVx_IV_Pos (0) /*!< CRPT_T::AES1_IV[4]: IV Position */ +#define CRPT_AES1_IVx_IV_Msk (0xfffffffful << CRPT_AES1_IVx_IV_Pos) /*!< CRPT_T::AES1_IV[4]: IV Mask */ + +#define CRPT_AES1_SADDR_SADDR_Pos (0) /*!< CRPT_T::AES1_SADDR: SADDR Position */ +#define CRPT_AES1_SADDR_SADDR_Msk (0xfffffffful << CRPT_AES1_SADDR_SADDR_Pos) /*!< CRPT_T::AES1_SADDR: SADDR Mask */ + +#define CRPT_AES1_DADDR_DADDR_Pos (0) /*!< CRPT_T::AES1_DADDR: DADDR Position */ +#define CRPT_AES1_DADDR_DADDR_Msk (0xfffffffful << CRPT_AES1_DADDR_DADDR_Pos) /*!< CRPT_T::AES1_DADDR: DADDR Mask */ + +#define CRPT_AES1_CNT_CNT_Pos (0) /*!< CRPT_T::AES1_CNT: CNT Position */ +#define CRPT_AES1_CNT_CNT_Msk (0xfffffffful << CRPT_AES1_CNT_CNT_Pos) /*!< CRPT_T::AES1_CNT: CNT Mask */ + +#define CRPT_AES2_KEYx_KEY_Pos (0) /*!< CRPT_T::AES2_KEY[8]: KEY Position */ +#define CRPT_AES2_KEYx_KEY_Msk (0xfffffffful << CRPT_AES2_KEYx_KEY_Pos) /*!< CRPT_T::AES2_KEY[8]: KEY Mask */ + +#define CRPT_AES2_IVx_IV_Pos (0) /*!< CRPT_T::AES2_IV[4]: IV Position */ +#define CRPT_AES2_IVx_IV_Msk (0xfffffffful << CRPT_AES2_IVx_IV_Pos) /*!< CRPT_T::AES2_IV[4]: IV Mask */ + +#define CRPT_AES2_SADDR_SADDR_Pos (0) /*!< CRPT_T::AES2_SADDR: SADDR Position */ +#define CRPT_AES2_SADDR_SADDR_Msk (0xfffffffful << CRPT_AES2_SADDR_SADDR_Pos) /*!< CRPT_T::AES2_SADDR: SADDR Mask */ + +#define CRPT_AES2_DADDR_DADDR_Pos (0) /*!< CRPT_T::AES2_DADDR: DADDR Position */ +#define CRPT_AES2_DADDR_DADDR_Msk (0xfffffffful << CRPT_AES2_DADDR_DADDR_Pos) /*!< CRPT_T::AES2_DADDR: DADDR Mask */ + +#define CRPT_AES2_CNT_CNT_Pos (0) /*!< CRPT_T::AES2_CNT: CNT Position */ +#define CRPT_AES2_CNT_CNT_Msk (0xfffffffful << CRPT_AES2_CNT_CNT_Pos) /*!< CRPT_T::AES2_CNT: CNT Mask */ + +#define CRPT_AES3_KEYx_KEY_Pos (0) /*!< CRPT_T::AES3_KEY[8]: KEY Position */ +#define CRPT_AES3_KEYx_KEY_Msk (0xfffffffful << CRPT_AES3_KEYx_KEY_Pos) /*!< CRPT_T::AES3_KEY[8]: KEY Mask */ + +#define CRPT_AES3_IVx_IV_Pos (0) /*!< CRPT_T::AES3_IV[4]: IV Position */ +#define CRPT_AES3_IVx_IV_Msk (0xfffffffful << CRPT_AES3_IVx_IV_Pos) /*!< CRPT_T::AES3_IV[4]: IV Mask */ + +#define CRPT_AES3_SADDR_SADDR_Pos (0) /*!< CRPT_T::AES3_SADDR: SADDR Position */ +#define CRPT_AES3_SADDR_SADDR_Msk (0xfffffffful << CRPT_AES3_SADDR_SADDR_Pos) /*!< CRPT_T::AES3_SADDR: SADDR Mask */ + +#define CRPT_AES3_DADDR_DADDR_Pos (0) /*!< CRPT_T::AES3_DADDR: DADDR Position */ +#define CRPT_AES3_DADDR_DADDR_Msk (0xfffffffful << CRPT_AES3_DADDR_DADDR_Pos) /*!< CRPT_T::AES3_DADDR: DADDR Mask */ + +#define CRPT_AES3_CNT_CNT_Pos (0) /*!< CRPT_T::AES3_CNT: CNT Position */ +#define CRPT_AES3_CNT_CNT_Msk (0xfffffffful << CRPT_AES3_CNT_CNT_Pos) /*!< CRPT_T::AES3_CNT: CNT Mask */ + +#define CRPT_TDES_CTL_START_Pos (0) /*!< CRPT_T::TDES_CTL: START Position */ +#define CRPT_TDES_CTL_START_Msk (0x1ul << CRPT_TDES_CTL_START_Pos) /*!< CRPT_T::TDES_CTL: START Mask */ + +#define CRPT_TDES_CTL_STOP_Pos (1) /*!< CRPT_T::TDES_CTL: STOP Position */ +#define CRPT_TDES_CTL_STOP_Msk (0x1ul << CRPT_TDES_CTL_STOP_Pos) /*!< CRPT_T::TDES_CTL: STOP Mask */ + +#define CRPT_TDES_CTL_TMODE_Pos (2) /*!< CRPT_T::TDES_CTL: TMODE Position */ +#define CRPT_TDES_CTL_TMODE_Msk (0x1ul << CRPT_TDES_CTL_TMODE_Pos) /*!< CRPT_T::TDES_CTL: TMODE Mask */ + +#define CRPT_TDES_CTL_3KEYS_Pos (3) /*!< CRPT_T::TDES_CTL: 3KEYS Position */ +#define CRPT_TDES_CTL_3KEYS_Msk (0x1ul << CRPT_TDES_CTL_3KEYS_Pos) /*!< CRPT_T::TDES_CTL: 3KEYS Mask */ + +#define CRPT_TDES_CTL_DMALAST_Pos (5) /*!< CRPT_T::TDES_CTL: DMALAST Position */ +#define CRPT_TDES_CTL_DMALAST_Msk (0x1ul << CRPT_TDES_CTL_DMALAST_Pos) /*!< CRPT_T::TDES_CTL: DMALAST Mask */ + +#define CRPT_TDES_CTL_DMACSCAD_Pos (6) /*!< CRPT_T::TDES_CTL: DMACSCAD Position */ +#define CRPT_TDES_CTL_DMACSCAD_Msk (0x1ul << CRPT_TDES_CTL_DMACSCAD_Pos) /*!< CRPT_T::TDES_CTL: DMACSCAD Mask */ + +#define CRPT_TDES_CTL_DMAEN_Pos (7) /*!< CRPT_T::TDES_CTL: DMAEN Position */ +#define CRPT_TDES_CTL_DMAEN_Msk (0x1ul << CRPT_TDES_CTL_DMAEN_Pos) /*!< CRPT_T::TDES_CTL: DMAEN Mask */ + +#define CRPT_TDES_CTL_OPMODE_Pos (8) /*!< CRPT_T::TDES_CTL: OPMODE Position */ +#define CRPT_TDES_CTL_OPMODE_Msk (0x7ul << CRPT_TDES_CTL_OPMODE_Pos) /*!< CRPT_T::TDES_CTL: OPMODE Mask */ + +#define CRPT_TDES_CTL_ENCRPT_Pos (16) /*!< CRPT_T::TDES_CTL: ENCRPT Position */ +#define CRPT_TDES_CTL_ENCRPT_Msk (0x1ul << CRPT_TDES_CTL_ENCRPT_Pos) /*!< CRPT_T::TDES_CTL: ENCRPT Mask */ + +#define CRPT_TDES_CTL_BLKSWAP_Pos (21) /*!< CRPT_T::TDES_CTL: BLKSWAP Position */ +#define CRPT_TDES_CTL_BLKSWAP_Msk (0x1ul << CRPT_TDES_CTL_BLKSWAP_Pos) /*!< CRPT_T::TDES_CTL: BLKSWAP Mask */ + +#define CRPT_TDES_CTL_OUTSWAP_Pos (22) /*!< CRPT_T::TDES_CTL: OUTSWAP Position */ +#define CRPT_TDES_CTL_OUTSWAP_Msk (0x1ul << CRPT_TDES_CTL_OUTSWAP_Pos) /*!< CRPT_T::TDES_CTL: OUTSWAP Mask */ + +#define CRPT_TDES_CTL_INSWAP_Pos (23) /*!< CRPT_T::TDES_CTL: INSWAP Position */ +#define CRPT_TDES_CTL_INSWAP_Msk (0x1ul << CRPT_TDES_CTL_INSWAP_Pos) /*!< CRPT_T::TDES_CTL: INSWAP Mask */ + +#define CRPT_TDES_CTL_CHANNEL_Pos (24) /*!< CRPT_T::TDES_CTL: CHANNEL Position */ +#define CRPT_TDES_CTL_CHANNEL_Msk (0x3ul << CRPT_TDES_CTL_CHANNEL_Pos) /*!< CRPT_T::TDES_CTL: CHANNEL Mask */ + +#define CRPT_TDES_CTL_KEYUNPRT_Pos (26) /*!< CRPT_T::TDES_CTL: KEYUNPRT Position */ +#define CRPT_TDES_CTL_KEYUNPRT_Msk (0x1ful << CRPT_TDES_CTL_KEYUNPRT_Pos) /*!< CRPT_T::TDES_CTL: KEYUNPRT Mask */ + +#define CRPT_TDES_CTL_KEYPRT_Pos (31) /*!< CRPT_T::TDES_CTL: KEYPRT Position */ +#define CRPT_TDES_CTL_KEYPRT_Msk (0x1ul << CRPT_TDES_CTL_KEYPRT_Pos) /*!< CRPT_T::TDES_CTL: KEYPRT Mask */ + +#define CRPT_TDES_STS_BUSY_Pos (0) /*!< CRPT_T::TDES_STS: BUSY Position */ +#define CRPT_TDES_STS_BUSY_Msk (0x1ul << CRPT_TDES_STS_BUSY_Pos) /*!< CRPT_T::TDES_STS: BUSY Mask */ + +#define CRPT_TDES_STS_INBUFEMPTY_Pos (8) /*!< CRPT_T::TDES_STS: INBUFEMPTY Position */ +#define CRPT_TDES_STS_INBUFEMPTY_Msk (0x1ul << CRPT_TDES_STS_INBUFEMPTY_Pos) /*!< CRPT_T::TDES_STS: INBUFEMPTY Mask */ + +#define CRPT_TDES_STS_INBUFFULL_Pos (9) /*!< CRPT_T::TDES_STS: INBUFFULL Position */ +#define CRPT_TDES_STS_INBUFFULL_Msk (0x1ul << CRPT_TDES_STS_INBUFFULL_Pos) /*!< CRPT_T::TDES_STS: INBUFFULL Mask */ + +#define CRPT_TDES_STS_INBUFERR_Pos (10) /*!< CRPT_T::TDES_STS: INBUFERR Position */ +#define CRPT_TDES_STS_INBUFERR_Msk (0x1ul << CRPT_TDES_STS_INBUFERR_Pos) /*!< CRPT_T::TDES_STS: INBUFERR Mask */ + +#define CRPT_TDES_STS_OUTBUFEMPTY_Pos (16) /*!< CRPT_T::TDES_STS: OUTBUFEMPTY Position */ +#define CRPT_TDES_STS_OUTBUFEMPTY_Msk (0x1ul << CRPT_TDES_STS_OUTBUFEMPTY_Pos) /*!< CRPT_T::TDES_STS: OUTBUFEMPTY Mask */ + +#define CRPT_TDES_STS_OUTBUFFULL_Pos (17) /*!< CRPT_T::TDES_STS: OUTBUFFULL Position */ +#define CRPT_TDES_STS_OUTBUFFULL_Msk (0x1ul << CRPT_TDES_STS_OUTBUFFULL_Pos) /*!< CRPT_T::TDES_STS: OUTBUFFULL Mask */ + +#define CRPT_TDES_STS_OUTBUFERR_Pos (18) /*!< CRPT_T::TDES_STS: OUTBUFERR Position */ +#define CRPT_TDES_STS_OUTBUFERR_Msk (0x1ul << CRPT_TDES_STS_OUTBUFERR_Pos) /*!< CRPT_T::TDES_STS: OUTBUFERR Mask */ + +#define CRPT_TDES_STS_BUSERR_Pos (20) /*!< CRPT_T::TDES_STS: BUSERR Position */ +#define CRPT_TDES_STS_BUSERR_Msk (0x1ul << CRPT_TDES_STS_BUSERR_Pos) /*!< CRPT_T::TDES_STS: BUSERR Mask */ + +#define CRPT_TDES0_KEYxH_KEY_Pos (0) /*!< CRPT_T::TDES0_KEYxH: KEY Position */ +#define CRPT_TDES0_KEYxH_KEY_Msk (0xfffffffful << CRPT_TDES0_KEYxH_KEY_Pos) /*!< CRPT_T::TDES0_KEYxH: KEY Mask */ + +#define CRPT_TDES0_KEYxL_KEY_Pos (0) /*!< CRPT_T::TDES0_KEYxL: KEY Position */ +#define CRPT_TDES0_KEYxL_KEY_Msk (0xfffffffful << CRPT_TDES0_KEYxL_KEY_Pos) /*!< CRPT_T::TDES0_KEYxL: KEY Mask */ + +#define CRPT_TDES0_IVH_IV_Pos (0) /*!< CRPT_T::TDES0_IVH: IV Position */ +#define CRPT_TDES0_IVH_IV_Msk (0xfffffffful << CRPT_TDES0_IVH_IV_Pos) /*!< CRPT_T::TDES0_IVH: IV Mask */ + +#define CRPT_TDES0_IVL_IV_Pos (0) /*!< CRPT_T::TDES0_IVL: IV Position */ +#define CRPT_TDES0_IVL_IV_Msk (0xfffffffful << CRPT_TDES0_IVL_IV_Pos) /*!< CRPT_T::TDES0_IVL: IV Mask */ + +#define CRPT_TDES0_SADDR_SADDR_Pos (0) /*!< CRPT_T::TDES0_SADDR: SADDR Position */ +#define CRPT_TDES0_SADDR_SADDR_Msk (0xfffffffful << CRPT_TDES0_SADDR_SADDR_Pos) /*!< CRPT_T::TDES0_SADDR: SADDR Mask */ + +#define CRPT_TDES0_DADDR_DADDR_Pos (0) /*!< CRPT_T::TDES0_DADDR: DADDR Position */ +#define CRPT_TDES0_DADDR_DADDR_Msk (0xfffffffful << CRPT_TDES0_DADDR_DADDR_Pos) /*!< CRPT_T::TDES0_DADDR: DADDR Mask */ + +#define CRPT_TDES0_CNT_CNT_Pos (0) /*!< CRPT_T::TDES0_CNT: CNT Position */ +#define CRPT_TDES0_CNT_CNT_Msk (0xfffffffful << CRPT_TDES0_CNT_CNT_Pos) /*!< CRPT_T::TDES0_CNT: CNT Mask */ + +#define CRPT_TDES_DATIN_DATIN_Pos (0) /*!< CRPT_T::TDES_DATIN: DATIN Position */ +#define CRPT_TDES_DATIN_DATIN_Msk (0xfffffffful << CRPT_TDES_DATIN_DATIN_Pos) /*!< CRPT_T::TDES_DATIN: DATIN Mask */ + +#define CRPT_TDES_DATOUT_DATOUT_Pos (0) /*!< CRPT_T::TDES_DATOUT: DATOUT Position */ +#define CRPT_TDES_DATOUT_DATOUT_Msk (0xfffffffful << CRPT_TDES_DATOUT_DATOUT_Pos) /*!< CRPT_T::TDES_DATOUT: DATOUT Mask */ + +#define CRPT_TDES1_KEYxH_KEY_Pos (0) /*!< CRPT_T::TDES1_KEYxH: KEY Position */ +#define CRPT_TDES1_KEYxH_KEY_Msk (0xfffffffful << CRPT_TDES1_KEYxH_KEY_Pos) /*!< CRPT_T::TDES1_KEYxH: KEY Mask */ + +#define CRPT_TDES1_KEYxL_KEY_Pos (0) /*!< CRPT_T::TDES1_KEYxL: KEY Position */ +#define CRPT_TDES1_KEYxL_KEY_Msk (0xfffffffful << CRPT_TDES1_KEY1L_KEY_Pos) /*!< CRPT_T::TDES1_KEYxL: KEY Mask */ + +#define CRPT_TDES1_IVH_IV_Pos (0) /*!< CRPT_T::TDES1_IVH: IV Position */ +#define CRPT_TDES1_IVH_IV_Msk (0xfffffffful << CRPT_TDES1_IVH_IV_Pos) /*!< CRPT_T::TDES1_IVH: IV Mask */ + +#define CRPT_TDES1_IVL_IV_Pos (0) /*!< CRPT_T::TDES1_IVL: IV Position */ +#define CRPT_TDES1_IVL_IV_Msk (0xfffffffful << CRPT_TDES1_IVL_IV_Pos) /*!< CRPT_T::TDES1_IVL: IV Mask */ + +#define CRPT_TDES1_SADDR_SADDR_Pos (0) /*!< CRPT_T::TDES1_SADDR: SADDR Position */ +#define CRPT_TDES1_SADDR_SADDR_Msk (0xfffffffful << CRPT_TDES1_SADDR_SADDR_Pos) /*!< CRPT_T::TDES1_SADDR: SADDR Mask */ + +#define CRPT_TDES1_DADDR_DADDR_Pos (0) /*!< CRPT_T::TDES1_DADDR: DADDR Position */ +#define CRPT_TDES1_DADDR_DADDR_Msk (0xfffffffful << CRPT_TDES1_DADDR_DADDR_Pos) /*!< CRPT_T::TDES1_DADDR: DADDR Mask */ + +#define CRPT_TDES1_CNT_CNT_Pos (0) /*!< CRPT_T::TDES1_CNT: CNT Position */ +#define CRPT_TDES1_CNT_CNT_Msk (0xfffffffful << CRPT_TDES1_CNT_CNT_Pos) /*!< CRPT_T::TDES1_CNT: CNT Mask */ + +#define CRPT_TDES2_KEYxH_KEY_Pos (0) /*!< CRPT_T::TDES2_KEYxH: KEY Position */ +#define CRPT_TDES2_KEYxH_KEY_Msk (0xfffffffful << CRPT_TDES2_KEYxH_KEY_Pos) /*!< CRPT_T::TDES2_KEYxH: KEY Mask */ + +#define CRPT_TDES2_KEYxL_KEY_Pos (0) /*!< CRPT_T::TDES2_KEYxL: KEY Position */ +#define CRPT_TDES2_KEYxL_KEY_Msk (0xfffffffful << CRPT_TDES2_KEYxL_KEY_Pos) /*!< CRPT_T::TDES2_KEYxL: KEY Mask */ + +#define CRPT_TDES2_IVH_IV_Pos (0) /*!< CRPT_T::TDES2_IVH: IV Position */ +#define CRPT_TDES2_IVH_IV_Msk (0xfffffffful << CRPT_TDES2_IVH_IV_Pos) /*!< CRPT_T::TDES2_IVH: IV Mask */ + +#define CRPT_TDES2_IVL_IV_Pos (0) /*!< CRPT_T::TDES2_IVL: IV Position */ +#define CRPT_TDES2_IVL_IV_Msk (0xfffffffful << CRPT_TDES2_IVL_IV_Pos) /*!< CRPT_T::TDES2_IVL: IV Mask */ + +#define CRPT_TDES2_SADDR_SADDR_Pos (0) /*!< CRPT_T::TDES2_SADDR: SADDR Position */ +#define CRPT_TDES2_SADDR_SADDR_Msk (0xfffffffful << CRPT_TDES2_SADDR_SADDR_Pos) /*!< CRPT_T::TDES2_SADDR: SADDR Mask */ + +#define CRPT_TDES2_DADDR_DADDR_Pos (0) /*!< CRPT_T::TDES2_DADDR: DADDR Position */ +#define CRPT_TDES2_DADDR_DADDR_Msk (0xfffffffful << CRPT_TDES2_DADDR_DADDR_Pos) /*!< CRPT_T::TDES2_DADDR: DADDR Mask */ + +#define CRPT_TDES2_CNT_CNT_Pos (0) /*!< CRPT_T::TDES2_CNT: CNT Position */ +#define CRPT_TDES2_CNT_CNT_Msk (0xfffffffful << CRPT_TDES2_CNT_CNT_Pos) /*!< CRPT_T::TDES2_CNT: CNT Mask */ + +#define CRPT_TDES3_KEYxH_KEY_Pos (0) /*!< CRPT_T::TDES3_KEYxH: KEY Position */ +#define CRPT_TDES3_KEYxH_KEY_Msk (0xfffffffful << CRPT_TDES3_KEYxH_KEY_Pos) /*!< CRPT_T::TDES3_KEYxH: KEY Mask */ + +#define CRPT_TDES3_KEYxL_KEY_Pos (0) /*!< CRPT_T::TDES3_KEYxL: KEY Position */ +#define CRPT_TDES3_KEYxL_KEY_Msk (0xfffffffful << CRPT_TDES3_KEYxL_KEY_Pos) /*!< CRPT_T::TDES3_KEYxL: KEY Mask */ + +#define CRPT_TDES3_IVH_IV_Pos (0) /*!< CRPT_T::TDES3_IVH: IV Position */ +#define CRPT_TDES3_IVH_IV_Msk (0xfffffffful << CRPT_TDES3_IVH_IV_Pos) /*!< CRPT_T::TDES3_IVH: IV Mask */ + +#define CRPT_TDES3_IVL_IV_Pos (0) /*!< CRPT_T::TDES3_IVL: IV Position */ +#define CRPT_TDES3_IVL_IV_Msk (0xfffffffful << CRPT_TDES3_IVL_IV_Pos) /*!< CRPT_T::TDES3_IVL: IV Mask */ + +#define CRPT_TDES3_SADDR_SADDR_Pos (0) /*!< CRPT_T::TDES3_SADDR: SADDR Position */ +#define CRPT_TDES3_SADDR_SADDR_Msk (0xfffffffful << CRPT_TDES3_SADDR_SADDR_Pos) /*!< CRPT_T::TDES3_SADDR: SADDR Mask */ + +#define CRPT_TDES3_DADDR_DADDR_Pos (0) /*!< CRPT_T::TDES3_DADDR: DADDR Position */ +#define CRPT_TDES3_DADDR_DADDR_Msk (0xfffffffful << CRPT_TDES3_DADDR_DADDR_Pos) /*!< CRPT_T::TDES3_DADDR: DADDR Mask */ + +#define CRPT_TDES3_CNT_CNT_Pos (0) /*!< CRPT_T::TDES3_CNT: CNT Position */ +#define CRPT_TDES3_CNT_CNT_Msk (0xfffffffful << CRPT_TDES3_CNT_CNT_Pos) /*!< CRPT_T::TDES3_CNT: CNT Mask */ + +#define CRPT_HMAC_CTL_START_Pos (0) /*!< CRPT_T::HMAC_CTL: START Position */ +#define CRPT_HMAC_CTL_START_Msk (0x1ul << CRPT_HMAC_CTL_START_Pos) /*!< CRPT_T::HMAC_CTL: START Mask */ + +#define CRPT_HMAC_CTL_STOP_Pos (1) /*!< CRPT_T::HMAC_CTL: STOP Position */ +#define CRPT_HMAC_CTL_STOP_Msk (0x1ul << CRPT_HMAC_CTL_STOP_Pos) /*!< CRPT_T::HMAC_CTL: STOP Mask */ + +#define CRPT_HMAC_CTL_HMACEN_Pos (4) /*!< CRPT_T::HMAC_CTL: HMACEN Position */ +#define CRPT_HMAC_CTL_HMACEN_Msk (0x1ul << CRPT_HMAC_CTL_HMACEN_Pos) /*!< CRPT_T::HMAC_CTL: HMACEN Mask */ + +#define CRPT_HMAC_CTL_DMALAST_Pos (5) /*!< CRPT_T::HMAC_CTL: DMALAST Position */ +#define CRPT_HMAC_CTL_DMALAST_Msk (0x1ul << CRPT_HMAC_CTL_DMALAST_Pos) /*!< CRPT_T::HMAC_CTL: DMALAST Mask */ + +#define CRPT_HMAC_CTL_DMAEN_Pos (7) /*!< CRPT_T::HMAC_CTL: DMAEN Position */ +#define CRPT_HMAC_CTL_DMAEN_Msk (0x1ul << CRPT_HMAC_CTL_DMAEN_Pos) /*!< CRPT_T::HMAC_CTL: DMAEN Mask */ + +#define CRPT_HMAC_CTL_OPMODE_Pos (8) /*!< CRPT_T::HMAC_CTL: OPMODE Position */ +#define CRPT_HMAC_CTL_OPMODE_Msk (0x7ul << CRPT_HMAC_CTL_OPMODE_Pos) /*!< CRPT_T::HMAC_CTL: OPMODE Mask */ + +#define CRPT_HMAC_CTL_OUTSWAP_Pos (22) /*!< CRPT_T::HMAC_CTL: OUTSWAP Position */ +#define CRPT_HMAC_CTL_OUTSWAP_Msk (0x1ul << CRPT_HMAC_CTL_OUTSWAP_Pos) /*!< CRPT_T::HMAC_CTL: OUTSWAP Mask */ + +#define CRPT_HMAC_CTL_INSWAP_Pos (23) /*!< CRPT_T::HMAC_CTL: INSWAP Position */ +#define CRPT_HMAC_CTL_INSWAP_Msk (0x1ul << CRPT_HMAC_CTL_INSWAP_Pos) /*!< CRPT_T::HMAC_CTL: INSWAP Mask */ + +#define CRPT_HMAC_STS_BUSY_Pos (0) /*!< CRPT_T::HMAC_STS: BUSY Position */ +#define CRPT_HMAC_STS_BUSY_Msk (0x1ul << CRPT_HMAC_STS_BUSY_Pos) /*!< CRPT_T::HMAC_STS: BUSY Mask */ + +#define CRPT_HMAC_STS_DMABUSY_Pos (1) /*!< CRPT_T::HMAC_STS: DMABUSY Position */ +#define CRPT_HMAC_STS_DMABUSY_Msk (0x1ul << CRPT_HMAC_STS_DMABUSY_Pos) /*!< CRPT_T::HMAC_STS: DMABUSY Mask */ + +#define CRPT_HMAC_STS_DMAERR_Pos (8) /*!< CRPT_T::HMAC_STS: DMAERR Position */ +#define CRPT_HMAC_STS_DMAERR_Msk (0x1ul << CRPT_HMAC_STS_DMAERR_Pos) /*!< CRPT_T::HMAC_STS: DMAERR Mask */ + +#define CRPT_HMAC_STS_DATINREQ_Pos (16) /*!< CRPT_T::HMAC_STS: DATINREQ Position */ +#define CRPT_HMAC_STS_DATINREQ_Msk (0x1ul << CRPT_HMAC_STS_DATINREQ_Pos) /*!< CRPT_T::HMAC_STS: DATINREQ Mask */ + +#define CRPT_HMAC_DGSTx_DGST_Pos (0) /*!< CRPT_T::HMAC_DGST[16]: DGST Position */ +#define CRPT_HMAC_DGSTx_DGST_Msk (0xfffffffful << CRPT_HMAC_DGSTx_DGST_Pos) /*!< CRPT_T::HMAC_DGST[16]: DGST Mask */ + +#define CRPT_HMAC_KEYCNT_KEYCNT_Pos (0) /*!< CRPT_T::HMAC_KEYCNT: KEYCNT Position */ +#define CRPT_HMAC_KEYCNT_KEYCNT_Msk (0xfffffffful << CRPT_HMAC_KEYCNT_KEYCNT_Pos) /*!< CRPT_T::HMAC_KEYCNT: KEYCNT Mask */ + +#define CRPT_HMAC_SADDR_SADDR_Pos (0) /*!< CRPT_T::HMAC_SADDR: SADDR Position */ +#define CRPT_HMAC_SADDR_SADDR_Msk (0xfffffffful << CRPT_HMAC_SADDR_SADDR_Pos) /*!< CRPT_T::HMAC_SADDR: SADDR Mask */ + +#define CRPT_HMAC_DMACNT_DMACNT_Pos (0) /*!< CRPT_T::HMAC_DMACNT: DMACNT Position */ +#define CRPT_HMAC_DMACNT_DMACNT_Msk (0xfffffffful << CRPT_HMAC_DMACNT_DMACNT_Pos) /*!< CRPT_T::HMAC_DMACNT: DMACNT Mask */ + +#define CRPT_HMAC_DATIN_DATIN_Pos (0) /*!< CRPT_T::HMAC_DATIN: DATIN Position */ +#define CRPT_HMAC_DATIN_DATIN_Msk (0xfffffffful << CRPT_HMAC_DATIN_DATIN_Pos) /*!< CRPT_T::HMAC_DATIN: DATIN Mask */ + +#define CRPT_ECC_CTL_START_Pos (0) /*!< CRPT_T::ECC_CTL: START Position */ +#define CRPT_ECC_CTL_START_Msk (0x1ul << CRPT_ECC_CTL_START_Pos) /*!< CRPT_T::ECC_CTL: START Mask */ + +#define CRPT_ECC_CTL_STOP_Pos (1) /*!< CRPT_T::ECC_CTL: STOP Position */ +#define CRPT_ECC_CTL_STOP_Msk (0x1ul << CRPT_ECC_CTL_STOP_Pos) /*!< CRPT_T::ECC_CTL: STOP Mask */ + +#define CRPT_ECC_CTL_DMAEN_Pos (7) /*!< CRPT_T::ECC_CTL: DMAEN Position */ +#define CRPT_ECC_CTL_DMAEN_Msk (0x1ul << CRPT_ECC_CTL_DMAEN_Pos) /*!< CRPT_T::ECC_CTL: DMAEN Mask */ + +#define CRPT_ECC_CTL_FSEL_Pos (8) /*!< CRPT_T::ECC_CTL: FSEL Position */ +#define CRPT_ECC_CTL_FSEL_Msk (0x1ul << CRPT_ECC_CTL_FSEL_Pos) /*!< CRPT_T::ECC_CTL: FSEL Mask */ + +#define CRPT_ECC_CTL_ECCOP_Pos (9) /*!< CRPT_T::ECC_CTL: ECCOP Position */ +#define CRPT_ECC_CTL_ECCOP_Msk (0x3ul << CRPT_ECC_CTL_ECCOP_Pos) /*!< CRPT_T::ECC_CTL: ECCOP Mask */ + +#define CRPT_ECC_CTL_MODOP_Pos (11) /*!< CRPT_T::ECC_CTL: MODOP Position */ +#define CRPT_ECC_CTL_MODOP_Msk (0x3ul << CRPT_ECC_CTL_MODOP_Pos) /*!< CRPT_T::ECC_CTL: MODOP Mask */ + +#define CRPT_ECC_CTL_LDP1_Pos (16) /*!< CRPT_T::ECC_CTL: LDP1 Position */ +#define CRPT_ECC_CTL_LDP1_Msk (0x1ul << CRPT_ECC_CTL_LDP1_Pos) /*!< CRPT_T::ECC_CTL: LDP1 Mask */ + +#define CRPT_ECC_CTL_LDP2_Pos (17) /*!< CRPT_T::ECC_CTL: LDP2 Position */ +#define CRPT_ECC_CTL_LDP2_Msk (0x1ul << CRPT_ECC_CTL_LDP2_Pos) /*!< CRPT_T::ECC_CTL: LDP2 Mask */ + +#define CRPT_ECC_CTL_LDA_Pos (18) /*!< CRPT_T::ECC_CTL: LDA Position */ +#define CRPT_ECC_CTL_LDA_Msk (0x1ul << CRPT_ECC_CTL_LDA_Pos) /*!< CRPT_T::ECC_CTL: LDA Mask */ + +#define CRPT_ECC_CTL_LDB_Pos (19) /*!< CRPT_T::ECC_CTL: LDB Position */ +#define CRPT_ECC_CTL_LDB_Msk (0x1ul << CRPT_ECC_CTL_LDB_Pos) /*!< CRPT_T::ECC_CTL: LDB Mask */ + +#define CRPT_ECC_CTL_LDN_Pos (20) /*!< CRPT_T::ECC_CTL: LDN Position */ +#define CRPT_ECC_CTL_LDN_Msk (0x1ul << CRPT_ECC_CTL_LDN_Pos) /*!< CRPT_T::ECC_CTL: LDN Mask */ + +#define CRPT_ECC_CTL_LDK_Pos (21) /*!< CRPT_T::ECC_CTL: LDK Position */ +#define CRPT_ECC_CTL_LDK_Msk (0x1ul << CRPT_ECC_CTL_LDK_Pos) /*!< CRPT_T::ECC_CTL: LDK Mask */ + +#define CRPT_ECC_CTL_CURVEM_Pos (22) /*!< CRPT_T::ECC_CTL: CURVEM Position */ +#define CRPT_ECC_CTL_CURVEM_Msk (0x3fful << CRPT_ECC_CTL_CURVEM_Pos) /*!< CRPT_T::ECC_CTL: CURVEM Mask */ + +#define CRPT_ECC_STS_BUSY_Pos (0) /*!< CRPT_T::ECC_STS: BUSY Position */ +#define CRPT_ECC_STS_BUSY_Msk (0x1ul << CRPT_ECC_STS_BUSY_Pos) /*!< CRPT_T::ECC_STS: BUSY Mask */ + +#define CRPT_ECC_STS_DMABUSY_Pos (1) /*!< CRPT_T::ECC_STS: DMABUSY Position */ +#define CRPT_ECC_STS_DMABUSY_Msk (0x1ul << CRPT_ECC_STS_DMABUSY_Pos) /*!< CRPT_T::ECC_STS: DMABUSY Mask */ + +#define CRPT_ECC_STS_BUSERR_Pos (16) /*!< CRPT_T::ECC_STS: BUSERR Position */ +#define CRPT_ECC_STS_BUSERR_Msk (0x1ul << CRPT_ECC_STS_BUSERR_Pos) /*!< CRPT_T::ECC_STS: BUSERR Mask */ + +#define CRPT_ECC_X1_POINTX1_Pos (0) /*!< CRPT_T::ECC_X1[18]: POINTX1 Position */ +#define CRPT_ECC_X1_POINTX1_Msk (0xfffffffful << CRPT_ECC_X1_POINTX1_Pos) /*!< CRPT_T::ECC_X1[18]: POINTX1 Mask */ + +#define CRPT_ECC_Y1_POINTY1_Pos (0) /*!< CRPT_T::ECC_Y1[18]: POINTY1 Position */ +#define CRPT_ECC_Y1_POINTY1_Msk (0xfffffffful << CRPT_ECC_Y1_POINTY1_Pos) /*!< CRPT_T::ECC_Y1[18]: POINTY1 Mask */ + +#define CRPT_ECC_X2_POINTX2_Pos (0) /*!< CRPT_T::ECC_X2[18]: POINTX2 Position */ +#define CRPT_ECC_X2_POINTX2_Msk (0xfffffffful << CRPT_ECC_X2_POINTX2_Pos) /*!< CRPT_T::ECC_X2[18]: POINTX2 Mask */ + +#define CRPT_ECC_Y2_POINTY2_Pos (0) /*!< CRPT_T::ECC_Y2[18]: POINTY2 Position */ +#define CRPT_ECC_Y2_POINTY2_Msk (0xfffffffful << CRPT_ECC_Y2_POINTY2_Pos) /*!< CRPT_T::ECC_Y2[18]: POINTY2 Mask */ + +#define CRPT_ECC_A_CURVEA_Pos (0) /*!< CRPT_T::ECC_A[18]: CURVEA Position */ +#define CRPT_ECC_A_CURVEA_Msk (0xfffffffful << CRPT_ECC_A_CURVEA_Pos) /*!< CRPT_T::ECC_A[18]: CURVEA Mask */ + +#define CRPT_ECC_B_CURVEB_Pos (0) /*!< CRPT_T::ECC_B[18]: CURVEB Position */ +#define CRPT_ECC_B_CURVEB_Msk (0xfffffffful << CRPT_ECC_B_CURVEB_Pos) /*!< CRPT_T::ECC_B[18]: CURVEB Mask */ + +#define CRPT_ECC_N_CURVEN_Pos (0) /*!< CRPT_T::ECC_N[18]: CURVEN Position */ +#define CRPT_ECC_N_CURVEN_Msk (0xfffffffful << CRPT_ECC_N_CURVEN_Pos) /*!< CRPT_T::ECC_N[18]: CURVEN Mask */ + +#define CRPT_ECC_K_SCALARK_Pos (0) /*!< CRPT_T::ECC_K[18]: SCALARK Position */ +#define CRPT_ECC_K_SCALARK_Msk (0xfffffffful << CRPT_ECC_K_SCALARK_Pos) /*!< CRPT_T::ECC_K[18]: SCALARK Mask */ + +#define CRPT_ECC_DADDR_DADDR_Pos (0) /*!< CRPT_T::ECC_DADDR: DADDR Position */ +#define CRPT_ECC_DADDR_DADDR_Msk (0xfffffffful << CRPT_ECC_DADDR_DADDR_Pos) /*!< CRPT_T::ECC_DADDR: DADDR Mask */ + +#define CRPT_ECC_STARTREG_STARTREG_Pos (0) /*!< CRPT_T::ECC_STARTREG: STARTREG Position*/ +#define CRPT_ECC_STARTREG_STARTREG_Msk (0xfffffffful << CRPT_ECC_STARTREG_STARTREG_Pos) /*!< CRPT_T::ECC_STARTREG: STARTREG Mask */ + +#define CRPT_ECC_WORDCNT_WORDCNT_Pos (0) /*!< CRPT_T::ECC_WORDCNT: WORDCNT Position */ +#define CRPT_ECC_WORDCNT_WORDCNT_Msk (0xfffffffful << CRPT_ECC_WORDCNT_WORDCNT_Pos) /*!< CRPT_T::ECC_WORDCNT: WORDCNT Mask */ + +/**@}*/ /* CRPT_CONST CRYPTO */ +/**@}*/ /* end of CRYPTO register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __CRYPTO_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/dac_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/dac_reg.h new file mode 100644 index 00000000000..bf2f67a5f1f --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/dac_reg.h @@ -0,0 +1,210 @@ +/**************************************************************************//** + * @file dac_reg.h + * @version V1.00 + * @brief DAC register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __DAC_REG_H__ +#define __DAC_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup DAC Digital to Analog Converter(DAC) + Memory Mapped Structure for DAC Controller +@{ */ + +typedef struct +{ + + + /** + * @var DAC_T::CTL + * Offset: 0x00 DAC Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |DACEN |DAC Enable Bit + * | | |0 = DAC is Disabled. + * | | |1 = DAC is Enabled. + * |[1] |DACIEN |DAC Interrupt Enable Bit + * | | |0 = Interrupt is Disabled. + * | | |1 = Interrupt is Enabled. + * |[2] |DMAEN |DMA Mode Enable Bit + * | | |0 = DMA mode Disabled. + * | | |1 = DMA mode Enabled. + * |[3] |DMAURIEN |DMA Under-run Interrupt Enable Bit + * | | |0 = DMA under-run interrupt Disabled. + * | | |1 = DMA under-run interrupt Enabled. + * |[4] |TRGEN |Trigger Mode Enable Bit + * | | |0 = DAC event trigger mode Disabled. + * | | |1 = DAC event trigger mode Enabled. + * |[7:5] |TRGSEL |Trigger Source Selection + * | | |000 = Software trigger. + * | | |001 = External pin DAC0_ST trigger. + * | | |010 = Timer 0 trigger. + * | | |011 = Timer 1 trigger. + * | | |100 = Timer 2 trigger. + * | | |101 = Timer 3 trigger. + * | | |110 = EPWM0 trigger. + * | | |111 = EPWM1 trigger. + * |[8] |BYPASS |Bypass Buffer Mode + * | | |0 = Output voltage buffer Enabled. + * | | |1 = Output voltage buffer Disabled. + * |[10] |LALIGN |DAC Data Left-aligned Enabled Control + * | | |0 = Right alignment. + * | | |1 = Left alignment. + * |[13:12] |ETRGSEL |External Pin Trigger Selection + * | | |00 = Low level trigger. + * | | |01 = High level trigger. + * | | |10 = Falling edge trigger. + * | | |11 = Rising edge trigger. + * |[15:14] |BWSEL |DAC Data Bit-width Selection + * | | |00 = data is 12 bits. + * | | |01 = data is 8 bits. + * | | |Others = reserved. + * |[16] |GRPEN |DAC Group Mode Enable Bit + * | | |0 = DAC0 and DAC1 are not grouped. + * | | |1 = DAC0 and DAC1 are grouped. + * @var DAC_T::SWTRG + * Offset: 0x04 DAC Software Trigger Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SWTRG |Software Trigger + * | | |0 = Software trigger Disabled. + * | | |1 = Software trigger Enabled. + * | | |User writes this bit to generate one shot pulse and it is cleared to 0 by hardware automatically; Reading this bit will always get 0. + * @var DAC_T::DAT + * Offset: 0x08 DAC Data Holding Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |DACDAT |DAC 12-bit Holding Data + * | | |These bits are written by user software which specifies 12-bit conversion data for DAC output + * | | |The unused bits (DAC_DAT[3:0] in left-alignment mode and DAC_DAT[15:12] in right alignment mode) are ignored by DAC controller hardware. + * | | |12 bit left alignment: user has to load data into DAC_DAT[15:4] bits. + * | | |12 bit right alignment: user has to load data into DAC_DAT[11:0] bits. + * @var DAC_T::DATOUT + * Offset: 0x0C DAC Data Output Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[11:0] |DATOUT |DAC 12-bit Output Data + * | | |These bits are current digital data for DAC output conversion. + * | | |It is loaded from DAC_DAT register and user cannot write it directly. + * @var DAC_T::STATUS + * Offset: 0x10 DAC Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |FINISH |DAC Conversion Complete Finish Flag + * | | |0 = DAC is in conversion state. + * | | |1 = DAC conversion finish. + * | | |This bit set to 1 when conversion time counter counts to SETTLET + * | | |It is cleared to 0 when DAC starts a new conversion + * | | |User writes 1 to clear this bit to 0. + * |[1] |DMAUDR |DMA Under-run Interrupt Flag + * | | |0 = No DMA under-run error condition occurred. + * | | |1 = DMA under-run error condition occurred. + * | | |User writes 1 to clear this bit. + * |[8] |BUSY |DAC Busy Flag (Read Only) + * | | |0 = DAC is ready for next conversion. + * | | |1 = DAC is busy in conversion. + * | | |This is read only bit. + * @var DAC_T::TCTL + * Offset: 0x14 DAC Timing Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[9:0] |SETTLET |DAC Output Settling Time + * | | |User software needs to write appropriate value to these bits to meet DAC conversion settling time base on PCLK (APB clock) speed. + * | | |For example, DAC controller clock speed is 80MHz and DAC conversion settling time is 1 us, SETTLETvalue must be greater than 0x50. + * | | |SELTTLET = DAC controller clock speed x settling time. + */ + __IO uint32_t CTL; /*!< [0x0000] DAC Control Register */ + __IO uint32_t SWTRG; /*!< [0x0004] DAC Software Trigger Control Register */ + __IO uint32_t DAT; /*!< [0x0008] DAC Data Holding Register */ + __I uint32_t DATOUT; /*!< [0x000c] DAC Data Output Register */ + __IO uint32_t STATUS; /*!< [0x0010] DAC Status Register */ + __IO uint32_t TCTL; /*!< [0x0014] DAC Timing Control Register */ + +} DAC_T; + +/** + @addtogroup DAC_CONST DAC Bit Field Definition + Constant Definitions for DAC Controller +@{ */ + +#define DAC_CTL_DACEN_Pos (0) /*!< DAC_T::CTL: DACEN Position */ +#define DAC_CTL_DACEN_Msk (0x1ul << DAC_CTL_DACEN_Pos) /*!< DAC_T::CTL: DACEN Mask */ + +#define DAC_CTL_DACIEN_Pos (1) /*!< DAC_T::CTL: DACIEN Position */ +#define DAC_CTL_DACIEN_Msk (0x1ul << DAC_CTL_DACIEN_Pos) /*!< DAC_T::CTL: DACIEN Mask */ + +#define DAC_CTL_DMAEN_Pos (2) /*!< DAC_T::CTL: DMAEN Position */ +#define DAC_CTL_DMAEN_Msk (0x1ul << DAC_CTL_DMAEN_Pos) /*!< DAC_T::CTL: DMAEN Mask */ + +#define DAC_CTL_DMAURIEN_Pos (3) /*!< DAC_T::CTL: DMAURIEN Position */ +#define DAC_CTL_DMAURIEN_Msk (0x1ul << DAC_CTL_DMAURIEN_Pos) /*!< DAC_T::CTL: DMAURIEN Mask */ + +#define DAC_CTL_TRGEN_Pos (4) /*!< DAC_T::CTL: TRGEN Position */ +#define DAC_CTL_TRGEN_Msk (0x1ul << DAC_CTL_TRGEN_Pos) /*!< DAC_T::CTL: TRGEN Mask */ + +#define DAC_CTL_TRGSEL_Pos (5) /*!< DAC_T::CTL: TRGSEL Position */ +#define DAC_CTL_TRGSEL_Msk (0x7ul << DAC_CTL_TRGSEL_Pos) /*!< DAC_T::CTL: TRGSEL Mask */ + +#define DAC_CTL_BYPASS_Pos (8) /*!< DAC_T::CTL: BYPASS Position */ +#define DAC_CTL_BYPASS_Msk (0x1ul << DAC_CTL_BYPASS_Pos) /*!< DAC_T::CTL: BYPASS Mask */ + +#define DAC_CTL_LALIGN_Pos (10) /*!< DAC_T::CTL: LALIGN Position */ +#define DAC_CTL_LALIGN_Msk (0x1ul << DAC_CTL_LALIGN_Pos) /*!< DAC_T::CTL: LALIGN Mask */ + +#define DAC_CTL_ETRGSEL_Pos (12) /*!< DAC_T::CTL: ETRGSEL Position */ +#define DAC_CTL_ETRGSEL_Msk (0x3ul << DAC_CTL_ETRGSEL_Pos) /*!< DAC_T::CTL: ETRGSEL Mask */ + +#define DAC_CTL_BWSEL_Pos (14) /*!< DAC_T::CTL: BWSEL Position */ +#define DAC_CTL_BWSEL_Msk (0x3ul << DAC_CTL_BWSEL_Pos) /*!< DAC_T::CTL: BWSEL Mask */ + +#define DAC_CTL_GRPEN_Pos (16) /*!< DAC_T::CTL: GRPEN Position */ +#define DAC_CTL_GRPEN_Msk (0x1ul << DAC_CTL_GRPEN_Pos) /*!< DAC_T::CTL: GRPEN Mask */ + +#define DAC_SWTRG_SWTRG_Pos (0) /*!< DAC_T::SWTRG: SWTRG Position */ +#define DAC_SWTRG_SWTRG_Msk (0x1ul << DAC_SWTRG_SWTRG_Pos) /*!< DAC_T::SWTRG: SWTRG Mask */ + +#define DAC_DAT_DACDAT_Pos (0) /*!< DAC_T::DAT: DACDAT Position */ +#define DAC_DAT_DACDAT_Msk (0xfffful << DAC_DAT_DACDAT_Pos) /*!< DAC_T::DAT: DACDAT Mask */ + +#define DAC_DATOUT_DATOUT_Pos (0) /*!< DAC_T::DATOUT: DATOUT Position */ +#define DAC_DATOUT_DATOUT_Msk (0xffful << DAC_DATOUT_DATOUT_Pos) /*!< DAC_T::DATOUT: DATOUT Mask */ + +#define DAC_STATUS_FINISH_Pos (0) /*!< DAC_T::STATUS: FINISH Position */ +#define DAC_STATUS_FINISH_Msk (0x1ul << DAC_STATUS_FINISH_Pos) /*!< DAC_T::STATUS: FINISH Mask */ + +#define DAC_STATUS_DMAUDR_Pos (1) /*!< DAC_T::STATUS: DMAUDR Position */ +#define DAC_STATUS_DMAUDR_Msk (0x1ul << DAC_STATUS_DMAUDR_Pos) /*!< DAC_T::STATUS: DMAUDR Mask */ + +#define DAC_STATUS_BUSY_Pos (8) /*!< DAC_T::STATUS: BUSY Position */ +#define DAC_STATUS_BUSY_Msk (0x1ul << DAC_STATUS_BUSY_Pos) /*!< DAC_T::STATUS: BUSY Mask */ + +#define DAC_TCTL_SETTLET_Pos (0) /*!< DAC_T::TCTL: SETTLET Position */ +#define DAC_TCTL_SETTLET_Msk (0x3fful << DAC_TCTL_SETTLET_Pos) /*!< DAC_T::TCTL: SETTLET Mask */ + +/**@}*/ /* DAC_CONST */ +/**@}*/ /* end of DAC register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __DAC_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/eadc_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/eadc_reg.h new file mode 100644 index 00000000000..ee500f6ec90 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/eadc_reg.h @@ -0,0 +1,1714 @@ +/**************************************************************************//** + * @file eadc_reg.h + * @version V1.00 + * @brief EADC register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __EADC_REG_H__ +#define __EADC_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup EADC Enhanced Analog to Digital Converter(EADC) + Memory Mapped Structure for EADC Controller +@{ */ + +typedef struct +{ + + + /** + * @var EADC_T::DAT[19] + * Offset: 0x00 ADC Data Register 0~18 for Sample Module 0~18 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |RESULT |ADC Conversion Result + * | | |This field contains 12 bits conversion result. + * | | |When DMOF (EADC_CTL[9]) is set to 0, 12-bit ADC conversion result with unsigned format will be filled in RESULT[11:0] and zero will be filled in RESULT[15:12]. + * | | |When DMOF (EADC_CTL[9]) set to 1, 12-bit ADC conversion result with 2'complement format will be filled in RESULT[11:0] and signed bits to will be filled in RESULT[15:12]. + * |[16] |OV |Overrun Flag + * | | |If converted data in RESULT[11:0] has not been read before new conversion result is loaded to this register, OV is set to 1. + * | | |0 = Data in RESULT[11:0] is recent conversion result. + * | | |1 = Data in RESULT[11:0] is overwrite. + * | | |Note: It is cleared by hardware after EADC_DAT register is read. + * |[17] |VALID |Valid Flag + * | | |This bit is set to 1 when corresponding sample module channel analog input conversion is completed and cleared by hardware after EADC_DAT register is read. + * | | |0 = Data in RESULT[11:0] bits is not valid. + * | | |1 = Data in RESULT[11:0] bits is valid. + * @var EADC_T::CURDAT + * Offset: 0x4C ADC PDMA Current Transfer Data Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[17:0] |CURDAT |ADC PDMA Current Transfer Data Register + * | | |This register is a shadow register of EADC_DATn (n=0~18) for PDMA support. + * | | |This is a read only register. + * @var EADC_T::CTL + * Offset: 0x50 ADC Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ADCEN |ADC Converter Enable Bit + * | | |0 = Disabled EADC. + * | | |1 = Enabled EADC. + * | | |Note: Before starting ADC conversion function, this bit should be set to 1 + * | | |Clear it to 0 to disable ADC converter analog circuit power consumption. + * |[1] |ADCRST |ADC Converter Control Circuits Reset + * | | |0 = No effect. + * | | |1 = Cause ADC control circuits reset to initial state, but not change the ADC registers value. + * | | |Note: ADCRST bit remains 1 during ADC reset, when ADC reset end, the ADCRST bit is automatically cleared to 0. + * |[2] |ADCIEN0 |Specific Sample Module ADC ADINT0 Interrupt Enable Bit + * | | |The ADC converter generates a conversion end ADIF0 (EADC_STATUS2[0]) upon the end of specific sample module ADC conversion + * | | |If ADCIEN0 bit is set then conversion end interrupt request ADINT0 is generated. + * | | |0 = Specific sample module ADC ADINT0 interrupt function Disabled. + * | | |1 = Specific sample module ADC ADINT0 interrupt function Enabled. + * |[3] |ADCIEN1 |Specific Sample Module ADC ADINT1 Interrupt Enable Bit + * | | |The ADC converter generates a conversion end ADIF1 (EADC_STATUS2[1]) upon the end of specific sample module ADC conversion + * | | |If ADCIEN1 bit is set then conversion end interrupt request ADINT1 is generated. + * | | |0 = Specific sample module ADC ADINT1 interrupt function Disabled. + * | | |1 = Specific sample module ADC ADINT1 interrupt function Enabled. + * |[4] |ADCIEN2 |Specific Sample Module ADC ADINT2 Interrupt Enable Bit + * | | |The ADC converter generates a conversion end ADIF2 (EADC_STATUS2[2]) upon the end of specific sample module ADC conversion + * | | |If ADCIEN2 bit is set then conversion end interrupt request ADINT2 is generated. + * | | |0 = Specific sample module ADC ADINT2 interrupt function Disabled. + * | | |1 = Specific sample module ADC ADINT2 interrupt function Enabled. + * |[5] |ADCIEN3 |Specific Sample Module ADC ADINT3 Interrupt Enable Bit + * | | |The ADC converter generates a conversion end ADIF3 (EADC_STATUS2[3]) upon the end of specific sample module ADC conversion + * | | |If ADCIEN3 bit is set then conversion end interrupt request ADINT3 is generated. + * | | |0 = Specific sample module ADC ADINT3 interrupt function Disabled. + * | | |1 = Specific sample module ADC ADINT3 interrupt function Enabled. + * |[7:6] |RESSEL |Resolution Selection + * | | |00 = 6-bit ADC result will be put at RESULT (EADC_DATn[5:0]). + * | | |01 = 8-bit ADC result will be put at RESULT (EADC_DATn[7:0]). + * | | |10 = 10-bit ADC result will be put at RESULT (EADC_DATn[9:0]). + * | | |11 = 12-bit ADC result will be put at RESULT (EADC_DATn[11:0]). + * |[8] |DIFFEN |Differential Analog Input Mode Enable Bit + * | | |0 = Single-end analog input mode. + * | | |1 = Differential analog input mode. + * |[9] |DMOF |ADC Differential Input Mode Output Format + * | | |0 = ADC conversion result will be filled in RESULT (EADC_DATn[15:0] , n= 0 ~18) with unsigned format. + * | | |1 = ADC conversion result will be filled in RESULT (EADC_DATn[15:0] , n= 0 ~18) with 2'complement format. + * |[11] |PDMAEN |PDMA Transfer Enable Bit + * | | |When ADC conversion is completed, the converted data is loaded into EADC_DATn (n: 0 ~ 18) register, user can enable this bit to generate a PDMA data transfer request. + * | | |0 = PDMA data transfer Disabled. + * | | |1 = PDMA data transfer Enabled. + * | | |Note: When set this bit field to 1, user must set ADCIENn (EADC_CTL[5:2], n=0~3) = 0 to disable interrupt. + * @var EADC_T::SWTRG + * Offset: 0x54 ADC Sample Module Software Start Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[18:0] |SWTRG |ADC Sample Module 0~18 Software Force to Start ADC Conversion + * | | |0 = No effect. + * | | |1 = Cause an ADC conversion when the priority is given to sample module. + * | | |Note: After write this register to start ADC conversion, the EADC_PENDSTS register will show which sample module will conversion + * | | |If user want to disable the conversion of the sample module, user can write EADC_PENDSTS register to clear it. + * @var EADC_T::PENDSTS + * Offset: 0x58 ADC Start of Conversion Pending Flag Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[18:0] |STPF |ADC Sample Module 0~18 Start of Conversion Pending Flag + * | | |Read: + * | | |0 = There is no pending conversion for sample module. + * | | |1 = Sample module ADC start of conversion is pending. + * | | |Write: + * | | |1 = clear pending flag & cancel the conversion for sample module. + * | | |Note: This bit remains 1 during pending state, when the respective ADC conversion is end, the STPFn (n=0~18) bit is automatically cleared to 0 + * @var EADC_T::OVSTS + * Offset: 0x5C ADC Sample Module Start of Conversion Overrun Flag Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[18:0] |SPOVF |ADC SAMPLE0~18 Overrun Flag + * | | |0 = No sample module event overrun. + * | | |1 = Indicates a new sample module event is generated while an old one event is pending. + * | | |Note: This bit is cleared by writing 1 to it. + * @var EADC_T::SCTL[19] + * Offset: 0x80 ADC Sample Module 0~18 Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |CHSEL |ADC Sample Module Channel Selection + * | | |00H = EADC_CH0 (slow channel). + * | | |01H = EADC_CH1 (slow channel). + * | | |02H = EADC_CH2 (slow channel). + * | | |03H = EADC_CH3 (slow channel). + * | | |04H = EADC_CH4 (slow channel). + * | | |05H = EADC_CH5 (slow channel). + * | | |06H = EADC_CH6 (slow channel). + * | | |07H = EADC_CH7 (slow channel). + * | | |08H = EADC_CH8 (slow channel). + * | | |09H = EADC_CH9 (slow channel). + * | | |0AH = EADC_CH10 (fast channel). + * | | |0BH = EADC_CH11 (fast channel). + * | | |0CH = EADC_CH12 (fast channel). + * | | |0DH = EADC_CH13 (fast channel). + * | | |0EH = EADC_CH14 (fast channel). + * | | |0FH = EADC_CH15 (fast channel). + * |[4] |EXTREN |ADC External Trigger Rising Edge Enable Bit + * | | |0 = Rising edge Disabled when ADC selects EADC0_ST as trigger source. + * | | |1 = Rising edge Enabled when ADC selects EADC0_ST as trigger source. + * |[5] |EXTFEN |ADC External Trigger Falling Edge Enable Bit + * | | |0 = Falling edge Disabled when ADC selects EADC0_ST as trigger source. + * | | |1 = Falling edge Enabled when ADC selects EADC0_ST as trigger source. + * |[7:6] |TRGDLYDIV |ADC Sample Module Start of Conversion Trigger Delay Clock Divider Selection + * | | |Trigger delay clock frequency: + * | | |00 = ADC_CLK/1. + * | | |01 = ADC_CLK/2. + * | | |10 = ADC_CLK/4. + * | | |11 = ADC_CLK/16. + * |[15:8] |TRGDLYCNT |ADC Sample Module Start of Conversion Trigger Delay Time + * | | |Trigger delay time = TRGDLYCNT x ADC_CLK x n (n=1,2,4,16 from TRGDLYDIV setting). + * |[20:16] |TRGSEL |ADC Sample Module Start of Conversion Trigger Source Selection + * | | |0H = Disable trigger. + * | | |1H = External trigger from EADC0_ST pin input. + * | | |2H = ADC ADINT0 interrupt EOC (End of conversion) pulse trigger. + * | | |3H = ADC ADINT1 interrupt EOC (End of conversion) pulse trigger. + * | | |4H = Timer0 overflow pulse trigger. + * | | |5H = Timer1 overflow pulse trigger. + * | | |6H = Timer2 overflow pulse trigger. + * | | |7H = Timer3 overflow pulse trigger. + * | | |8H = EPWM0TG0. + * | | |9H = EPWM0TG1. + * | | |AH = EPWM0TG2. + * | | |BH = EPWM0TG3. + * | | |CH = EPWM0TG4. + * | | |DH = EPWM0TG5. + * | | |EH = EPWM1TG0. + * | | |FH = EPWM1TG1. + * | | |10H = EPWM1TG2. + * | | |11H = EPWM1TG3. + * | | |12H = EPWM1TG4. + * | | |13H = EPWM1TG5. + * | | |14H = BPWM0TG. + * | | |15H = BPWM1TG. + * | | |other = Reserved. + * |[22] |INTPOS |Interrupt Flag Position Select + * | | |0 = Set ADIFn (EADC_STATUS2[n], n=0~3) at ADC end of conversion. + * | | |1 = Set ADIFn (EADC_STATUS2[n], n=0~3) at ADC start of conversion. + * |[23] |DBMEN |Double Buffer Mode Enable Bit + * | | |0 = Sample has one sample result register. (default). + * | | |1 = Sample has two sample result registers. + * |[31:24] |EXTSMPT |ADC Sampling Time Extend + * | | |When ADC converting at high conversion rate, the sampling time of analog input voltage may not enough if input channel loading is heavy, user can extend ADC sampling time after trigger source is coming to get enough sampling time. + * | | |The range of start delay time is from 0~255 ADC clock. + * @var EADC_T::INTSRC[4] + * Offset: 0xD0 ADC interrupt 0~3 Source Enable Control Register. + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SPLIE0 |Sample Module 0 Interrupt Enable Bit + * | | |0 = Sample Module 0 interrupt Disabled. + * | | |1 = Sample Module 0 interrupt Enabled. + * |[1] |SPLIE1 |Sample Module 1 Interrupt Enable Bit + * | | |0 = Sample Module 1 interrupt Disabled. + * | | |1 = Sample Module 1 interrupt Enabled. + * |[2] |SPLIE2 |Sample Module 2 Interrupt Enable Bit + * | | |0 = Sample Module 2 interrupt Disabled. + * | | |1 = Sample Module 2 interrupt Enabled. + * |[3] |SPLIE3 |Sample Module 3 Interrupt Enable Bit + * | | |0 = Sample Module 3 interrupt Disabled. + * | | |1 = Sample Module 3 interrupt Enabled. + * |[4] |SPLIE4 |Sample Module 4 Interrupt Enable Bit + * | | |0 = Sample Module 4 interrupt Disabled. + * | | |1 = Sample Module 4 interrupt Enabled. + * |[5] |SPLIE5 |Sample Module 5 Interrupt Enable Bit + * | | |0 = Sample Module 5 interrupt Disabled. + * | | |1 = Sample Module 5 interrupt Enabled. + * |[6] |SPLIE6 |Sample Module 6 Interrupt Enable Bit + * | | |0 = Sample Module 6 interrupt Disabled. + * | | |1 = Sample Module 6 interrupt Enabled. + * |[7] |SPLIE7 |Sample Module 7 Interrupt Enable Bit + * | | |0 = Sample Module 7 interrupt Disabled. + * | | |1 = Sample Module 7 interrupt Enabled. + * |[8] |SPLIE8 |Sample Module 8 Interrupt Enable Bit + * | | |0 = Sample Module 8 interrupt Disabled. + * | | |1 = Sample Module 8 interrupt Enabled. + * |[9] |SPLIE9 |Sample Module 9 Interrupt Enable Bit + * | | |0 = Sample Module 9 interrupt Disabled. + * | | |1 = Sample Module 9 interrupt Enabled. + * |[10] |SPLIE10 |Sample Module 10 Interrupt Enable Bit + * | | |0 = Sample Module 10 interrupt Disabled. + * | | |1 = Sample Module 10 interrupt Enabled. + * |[11] |SPLIE11 |Sample Module 11 Interrupt Enable Bit + * | | |0 = Sample Module 11 interrupt Disabled. + * | | |1 = Sample Module 11 interrupt Enabled. + * |[12] |SPLIE12 |Sample Module 12 Interrupt Enable Bit + * | | |0 = Sample Module 12 interrupt Disabled. + * | | |1 = Sample Module 12 interrupt Enabled. + * |[13] |SPLIE13 |Sample Module 13 Interrupt Enable Bit + * | | |0 = Sample Module 13 interrupt Disabled. + * | | |1 = Sample Module 13 interrupt Enabled. + * |[14] |SPLIE14 |Sample Module 14 Interrupt Enable Bit + * | | |0 = Sample Module 14 interrupt Disabled. + * | | |1 = Sample Module 14 interrupt Enabled. + * |[15] |SPLIE15 |Sample Module 15 Interrupt Enable Bit + * | | |0 = Sample Module 15 interrupt Disabled. + * | | |1 = Sample Module 15 interrupt Enabled. + * |[16] |SPLIE16 |Sample Module 16 Interrupt Enable Bit + * | | |0 = Sample Module 16 interrupt Disabled. + * | | |1 = Sample Module 16 interrupt Enabled. + * |[17] |SPLIE17 |Sample Module 17 Interrupt Enable Bit + * | | |0 = Sample Module 17 interrupt Disabled. + * | | |1 = Sample Module 17 interrupt Enabled. + * |[18] |SPLIE18 |Sample Module 18 Interrupt Enable Bit + * | | |0 = Sample Module 18 interrupt Disabled. + * | | |1 = Sample Module 18 interrupt Enabled. + * @var EADC_T::CMP[4] + * Offset: 0xE0 ADC Result Compare Register 0~3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ADCMPEN |ADC Result Compare Enable Bit + * | | |0 = Compare Disabled. + * | | |1 = Compare Enabled. + * | | |Set this bit to 1 to enable compare CMPDAT (EADC_CMPn[27:16], n=0~3) with specified sample module conversion result when converted data is loaded into EADC_DAT register. + * |[1] |ADCMPIE |ADC Result Compare Interrupt Enable Bit + * | | |0 = Compare function interrupt Disabled. + * | | |1 = Compare function interrupt Enabled. + * | | |If the compare function is enabled and the compare condition matches the setting of CMPCOND (EADC_CMPn[2], n=0~3) and CMPMCNT (EADC_CMPn[11:8], n=0~3), ADCMPFn (EADC_STATUS2[7:4], n=0~3) will be asserted, in the meanwhile, if ADCMPIE is set to 1, a compare interrupt request is generated. + * |[2] |CMPCOND |Compare Condition + * | | |0= Set the compare condition as that when a 12-bit ADC conversion result is less than the 12-bit CMPDAT (EADC_CMPn [27:16]), the internal match counter will increase one. + * | | |1= Set the compare condition as that when a 12-bit ADC conversion result is greater or equal to the 12-bit CMPDAT (EADC_CMPn [27:16]), the internal match counter will increase one. + * | | |Note: When the internal counter reaches the value to (CMPMCNT (EADC_CMPn[11:8], n=0~3) +1), the CMPF bit will be set. + * |[7:3] |CMPSPL |Compare Sample Module Selection + * | | |00000 = Sample Module 0 conversion result EADC_DAT0 is selected to be compared. + * | | |00001 = Sample Module 1 conversion result EADC_DAT1 is selected to be compared. + * | | |00010 = Sample Module 2 conversion result EADC_DAT2 is selected to be compared. + * | | |00011 = Sample Module 3 conversion result EADC_DAT3 is selected to be compared. + * | | |00100 = Sample Module 4 conversion result EADC_DAT4 is selected to be compared. + * | | |00101 = Sample Module 5 conversion result EADC_DAT5 is selected to be compared. + * | | |00110 = Sample Module 6 conversion result EADC_DAT6 is selected to be compared. + * | | |00111 = Sample Module 7 conversion result EADC_DAT7 is selected to be compared. + * | | |01000 = Sample Module 8 conversion result EADC_DAT8 is selected to be compared. + * | | |01001 = Sample Module 9 conversion result EADC_DAT9 is selected to be compared. + * | | |01010 = Sample Module 10 conversion result EADC_DAT10 is selected to be compared. + * | | |01011 = Sample Module 11 conversion result EADC_DAT11 is selected to be compared. + * | | |01100 = Sample Module 12 conversion result EADC_DAT12 is selected to be compared. + * | | |01101 = Sample Module 13 conversion result EADC_DAT13 is selected to be compared. + * | | |01110 = Sample Module 14 conversion result EADC_DAT14 is selected to be compared. + * | | |01111 = Sample Module 15 conversion result EADC_DAT15 is selected to be compared. + * | | |10000 = Sample Module 16 conversion result EADC_DAT16 is selected to be compared. + * | | |10001 = Sample Module 17 conversion result EADC_DAT17 is selected to be compared. + * | | |10010 = Sample Module 18 conversion result EADC_DAT18 is selected to be compared. + * |[11:8] |CMPMCNT |Compare Match Count + * | | |When the specified ADC sample module analog conversion result matches the compare condition defined by CMPCOND (EADC_CMPn[2], n=0~3), the internal match counter will increase 1 + * | | |If the compare result does not meet the compare condition, the internal compare match counter will reset to 0 + * | | |When the internal counter reaches the value to (CMPMCNT +1), the ADCMPFn (EADC_STATUS2[7:4], n=0~3) will be set. + * |[15] |CMPWEN |Compare Window Mode Enable Bit + * | | |0 = ADCMPF0 (EADC_STATUS2[4]) will be set when EADC_CMP0 compared condition matched + * | | |ADCMPF2 (EADC_STATUS2[6]) will be set when EADC_CMP2 compared condition matched + * | | |1 = ADCMPF0 (EADC_STATUS2[4]) will be set when both EADC_CMP0 and EADC_CMP1 compared condition matched + * | | |ADCMPF2 (EADC_STATUS2[6]) will be set when both EADC_CMP2 and EADC_CMP3 compared condition matched. + * | | |Note: This bit is only present in EADC_CMP0 and EADC_CMP2 register. + * |[27:16] |CMPDAT |Comparison Data + * | | |The 12 bits data is used to compare with conversion result of specified sample module + * | | |User can use it to monitor the external analog input pin voltage transition without imposing a load on software. + * @var EADC_T::STATUS0 + * Offset: 0xF0 ADC Status Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |VALID |EADC_DAT0~15 Data Valid Flag + * | | |It is a mirror of VALID bit in sample module ADC result data register EADC_DATn. (n=0~18). + * |[31:16] |OV |EADC_DAT0~15 Overrun Flag + * | | |It is a mirror to OV bit in sample module ADC result data register EADC_DATn. (n=0~18). + * @var EADC_T::STATUS1 + * Offset: 0xF4 ADC Status Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2:0] |VALID |EADC_DAT16~18 Data Valid Flag + * | | |It is a mirror of VALID bit in sample module ADC result data register EADC_DATn. (n=0~18). + * |[18:16] |OV |EADC_DAT16~18 Overrun Flag + * | | |It is a mirror to OV bit in sample module ADC result data register EADC_DATn. (n=0~18). + * @var EADC_T::STATUS2 + * Offset: 0xF8 ADC Status Register 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ADIF0 |ADC ADINT0 Interrupt Flag + * | | |0 = No ADINT0 interrupt pulse received. + * | | |1 = ADINT0 interrupt pulse has been received. + * | | |Note1: This bit is cleared by writing 1 to it. + * | | |Note2:This bit indicates whether an ADC conversion of specific sample module has been completed + * |[1] |ADIF1 |ADC ADINT1 Interrupt Flag + * | | |0 = No ADINT1 interrupt pulse received. + * | | |1 = ADINT1 interrupt pulse has been received. + * | | |Note1: This bit is cleared by writing 1 to it. + * | | |Note2:This bit indicates whether an ADC conversion of specific sample module has been completed + * |[2] |ADIF2 |ADC ADINT2 Interrupt Flag + * | | |0 = No ADINT2 interrupt pulse received. + * | | |1 = ADINT2 interrupt pulse has been received. + * | | |Note1: This bit is cleared by writing 1 to it. + * | | |Note2:This bit indicates whether an ADC conversion of specific sample module has been completed + * |[3] |ADIF3 |ADC ADINT3 Interrupt Flag + * | | |0 = No ADINT3 interrupt pulse received. + * | | |1 = ADINT3 interrupt pulse has been received. + * | | |Note1: This bit is cleared by writing 1 to it. + * | | |Note2:This bit indicates whether an ADC conversion of specific sample module has been completed + * |[4] |ADCMPF0 |ADC Compare 0 Flag + * | | |When the specific sample module ADC conversion result meets setting condition in EADC_CMP0 then this bit is set to 1. + * | | |0 = Conversion result in EADC_DAT does not meet EADC_CMP0 register setting. + * | | |1 = Conversion result in EADC_DAT meets EADC_CMP0 register setting. + * | | |Note: This bit is cleared by writing 1 to it. + * |[5] |ADCMPF1 |ADC Compare 1 Flag + * | | |When the specific sample module ADC conversion result meets setting condition in EADC_CMP1 then this bit is set to 1. + * | | |0 = Conversion result in EADC_DAT does not meet EADC_CMP1 register setting. + * | | |1 = Conversion result in EADC_DAT meets EADC_CMP1 register setting. + * | | |Note: This bit is cleared by writing 1 to it. + * |[6] |ADCMPF2 |ADC Compare 2 Flag + * | | |When the specific sample module ADC conversion result meets setting condition in EADC_CMP2 then this bit is set to 1. + * | | |0 = Conversion result in EADC_DAT does not meet EADC_CMP2 register setting. + * | | |1 = Conversion result in EADC_DAT meets EADC_CMP2 register setting. + * | | |Note: This bit is cleared by writing 1 to it. + * |[7] |ADCMPF3 |ADC Compare 3 Flag + * | | |When the specific sample module ADC conversion result meets setting condition in EADC_CMP3 then this bit is set to 1. + * | | |0 = Conversion result in EADC_DAT does not meet EADC_CMP3 register setting. + * | | |1 = Conversion result in EADC_DAT meets EADC_CMP3 register setting. + * | | |Note: This bit is cleared by writing 1 to it. + * |[8] |ADOVIF0 |ADC ADINT0 Interrupt Flag Overrun + * | | |0 = ADINT0 interrupt flag is not overwritten to 1. + * | | |1 = ADINT0 interrupt flag is overwritten to 1. + * | | |Note: This bit is cleared by writing 1 to it. + * |[9] |ADOVIF1 |ADC ADINT1 Interrupt Flag Overrun + * | | |0 = ADINT1 interrupt flag is not overwritten to 1. + * | | |1 = ADINT1 interrupt flag is overwritten to 1. + * | | |Note: This bit is cleared by writing 1 to it. + * |[10] |ADOVIF2 |ADC ADINT2 Interrupt Flag Overrun + * | | |0 = ADINT2 interrupt flag is not overwritten to 1. + * | | |1 = ADINT2 interrupt flag is s overwritten to 1. + * | | |Note: This bit is cleared by writing 1 to it. + * |[11] |ADOVIF3 |ADC ADINT3 Interrupt Flag Overrun + * | | |0 = ADINT3 interrupt flag is not overwritten to 1. + * | | |1 = ADINT3 interrupt flag is overwritten to 1. + * | | |Note: This bit is cleared by writing 1 to it. + * |[12] |ADCMPO0 |ADC Compare 0 Output Status (Read Only) + * | | |The 12 bits compare0 data CMPDAT0 (EADC_CMP0[27:16]) is used to compare with conversion result of specified sample module + * | | |User can use it to monitor the external analog input pin voltage status. + * | | |0 = Conversion result in EADC_DAT less than CMPDAT0 setting. + * | | |1 = Conversion result in EADC_DAT great than or equal CMPDAT0 setting. + * |[13] |ADCMPO1 |ADC Compare 1 Output Status (Read Only) + * | | |The 12 bits compare1 data CMPDAT1 (EADC_CMP1[27:16]) is used to compare with conversion result of specified sample module + * | | |User can use it to monitor the external analog input pin voltage status. + * | | |0 = Conversion result in EADC_DAT less than CMPDAT1 setting. + * | | |1 = Conversion result in EADC_DAT great than or equal CMPDAT1 setting. + * |[14] |ADCMPO2 |ADC Compare 2 Output Status (Read Only) + * | | |The 12 bits compare2 data CMPDAT2 (EADC_CMP2[27:16]) is used to compare with conversion result of specified sample module + * | | |User can use it to monitor the external analog input pin voltage status. + * | | |0 = Conversion result in EADC_DAT less than CMPDAT2 setting. + * | | |1 = Conversion result in EADC_DAT great than or equal CMPDAT2 setting. + * |[15] |ADCMPO3 |ADC Compare 3 Output Status (Read Only) + * | | |The 12 bits compare3 data CMPDAT3 (EADC_CMP3[27:16]) is used to compare with conversion result of specified sample module + * | | |User can use it to monitor the external analog input pin voltage status. + * | | |0 = Conversion result in EADC_DAT less than CMPDAT3 setting. + * | | |1 = Conversion result in EADC_DAT great than or equal CMPDAT3 setting. + * |[20:16] |CHANNEL |Current Conversion Channel (Read Only) + * | | |This filed reflects ADC current conversion channel when BUSY=1. + * | | |It is read only. + * | | |00H = EADC_CH0. + * | | |01H = EADC_CH1. + * | | |02H = EADC_CH2. + * | | |03H = EADC_CH3. + * | | |04H = EADC_CH4. + * | | |05H = EADC_CH5. + * | | |06H = EADC_CH6. + * | | |07H = EADC_CH7. + * | | |08H = EADC_CH8. + * | | |09H = EADC_CH9. + * | | |0AH = EADC_CH10. + * | | |0BH = EADC_CH11. + * | | |0CH = EADC_CH12. + * | | |0DH = EADC_CH13. + * | | |0EH = EADC_CH14. + * | | |0FH = EADC_CH15. + * | | |10H = VBG. + * | | |11H = VTEMP. + * | | |12H = VBAT/4. + * |[23] |BUSY |Busy/Idle (Read Only) + * | | |0 = EADC is in idle state. + * | | |1 = EADC is busy at conversion. + * |[24] |ADOVIF |All ADC Interrupt Flag Overrun Bits Check (Read Only) + * | | |n=0~3. + * | | |0 = None of ADINT interrupt flag ADOVIFn (EADC_STATUS2[11:8]) is overwritten to 1. + * | | |1 = Any one of ADINT interrupt flag ADOVIFn (EADC_STATUS2[11:8]) is overwritten to 1. + * | | |Note: This bit will keep 1 when any ADOVIFn Flag is equal to 1. + * |[25] |STOVF |for All ADC Sample Module Start of Conversion Overrun Flags Check (Read Only) + * | | |n=0~18. + * | | |0 = None of sample module event overrun flag SPOVFn (EADC_OVSTS[n]) is set to 1. + * | | |1 = Any one of sample module event overrun flag SPOVFn (EADC_OVSTS[n]) is set to 1. + * | | |Note: This bit will keep 1 when any SPOVFn Flag is equal to 1. + * |[26] |AVALID |for All Sample Module ADC Result Data Register EADC_DAT Data Valid Flag Check (Read Only) + * | | |n=0~18. + * | | |0 = None of sample module data register valid flag VALIDn (EADC_DATn[17]) is set to 1. + * | | |1 = Any one of sample module data register valid flag VALIDn (EADC_DATn[17]) is set to 1. + * | | |Note: This bit will keep 1 when any VALIDn Flag is equal to 1. + * |[27] |AOV |for All Sample Module ADC Result Data Register Overrun Flags Check (Read Only) + * | | |n=0~18. + * | | |0 = None of sample module data register overrun flag OVn (EADC_DATn[16]) is set to 1. + * | | |1 = Any one of sample module data register overrun flag OVn (EADC_DATn[16]) is set to 1. + * | | |Note: This bit will keep 1 when any OVn Flag is equal to 1. + * @var EADC_T::STATUS3 + * Offset: 0xFC ADC Status Register 3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[4:0] |CURSPL |ADC Current Sample Module + * | | |This register show the current ADC is controlled by which sample module control logic modules. + * | | |If the ADC is Idle, this bit filed will set to 0x1F. + * | | |This is a read only register. + * @var EADC_T::DDAT[4] + * Offset: 0x100 ADC Double Data Register 0 for Sample Module 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |RESULT |ADC Conversion Results + * | | |This field contains 12 bits conversion results. + * | | |When the DMOF (EADC_CTL[9]) is set to 0, 12-bit ADC conversion result with unsigned format will be filled in RESULT [11:0] and zero will be filled in RESULT [15:12]. + * | | |When DMOF (EADC_CTL[9]) set to 1, 12-bit ADC conversion result with 2'complement format will be filled in RESULT [11:0] and signed bits to will be filled in RESULT [15:12]. + * |[16] |OV |Overrun Flag + * | | |0 = Data in RESULT (EADC_DATn[15:0], n=0~3) is recent conversion result. + * | | |1 = Data in RESULT (EADC_DATn[15:0], n=0~3) is overwrite. + * | | |If converted data in RESULT[15:0] has not been read before new conversion result is loaded to this register, OV is set to 1 + * | | |It is cleared by hardware after EADC_DDAT register is read. + * |[17] |VALID |Valid Flag + * | | |0 = Double data in RESULT (EADC_DDATn[15:0]) is not valid. + * | | |1 = Double data in RESULT (EADC_DDATn[15:0]) is valid. + * | | |This bit is set to 1 when corresponding sample module channel analog input conversion is completed and cleared by hardware after EADC_DDATn register is read + * | | |(n=0~3). + * @var EADC_T::PWRM + * Offset: 0x110 ADC Power Management Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |PWUPRDY |ADC Power-up Sequence Completed and Ready for Conversion (Read Only) + * | | |0 = ADC is not ready for conversion may be in power down state or in the progress of start up. + * | | |1 = ADC is ready for conversion. + * |[1] |PWUCALEN |Power Up Calibration Function Enable Control + * | | |0 = Disable the function of calibration at power up. + * | | |1 = Enable the function of calibration at power up. + * | | |Note: This bit work together with CALSEL (EADC_CALCTL [3]), see the following + * | | |{PWUCALEN, CALSEL } Description: + * | | |PWUCALEN is 0 and CALSEL is 0: No need to calibrate. + * | | |PWUCALEN is 0 and CALSEL is 1: No need to calibrate. + * | | |PWUCALEN is 1 and CALSEL is 0: Load calibration word when power up. + * | | |PWUCALEN is 1 and CALSEL is 1: Calibrate when power up. + * |[3:2] |PWDMOD |ADC Power-down Mode + * | | |Set this bit fields to select ADC power down mode when system power-down. + * | | |00 = ADC Deep power down mode. + * | | |01 = ADC Power down. + * | | |10 = ADC Standby mode. + * | | |11 = ADC Deep power down mode. + * | | |Note: Different PWDMOD has different power down/up sequence, in order to avoid ADC powering up with wrong sequence; user must keep PWMOD consistent each time in power down and start up + * |[19:8] |LDOSUT |ADC Internal LDO Start-up Time + * | | |Set this bit fields to control LDO start-up time + * | | |The minimum required LDO start-up time is 20us + * | | |LDO start-up time = (1/ADC_CLK) x LDOSUT. + * @var EADC_T::CALCTL + * Offset: 0x114 ADC Calibration Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1] |CALSTART |Calibration Functional Block Start + * | | |0 = Stops calibration functional block. + * | | |1 = Starts calibration functional block. + * | | |Note: This bit is set by SW and clear by HW after re-calibration finish + * |[2] |CALDONE |Calibration Functional Block Complete (Read Only) + * | | |0 = During a calibration. + * | | |1 = Calibration is completed. + * |[3] |CALSEL |Select Calibration Functional Block + * | | |0 = Load calibration word when calibration functional block is active. + * | | |1 = Execute calibration when calibration functional block is active. + * @var EADC_T::CALDWRD + * Offset: 0x118 ADC Calibration Load Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[6:0] |CALWORD |Calibration Word Bits + * | | |Write to this register with the previous calibration word before load calibration action. + * | | |Read this register after calibration done. + * | | |Note: The calibration block contains two parts CALIBRATION and LOAD CALIBRATION; if the calibration block configure as CALIBRATION; then this register represent the result of calibration when calibration is completed; if configure as LOAD CALIBRATION ; configure this register before loading calibration action, after loading calibration complete, the laoded calibration word will apply to the ADC; while in loading calibration function the loaded value will not be equal to the original CALWORD until calibration is done. + */ + __I uint32_t DAT[19]; /*!< [0x0000] ADC Data Register 0~18 for Sample Module 0~18 */ + __I uint32_t CURDAT; /*!< [0x004c] ADC PDMA Current Transfer Data Register */ + __IO uint32_t CTL; /*!< [0x0050] ADC Control Register */ + __O uint32_t SWTRG; /*!< [0x0054] ADC Sample Module Software Start Register */ + __IO uint32_t PENDSTS; /*!< [0x0058] ADC Start of Conversion Pending Flag Register */ + __IO uint32_t OVSTS; /*!< [0x005c] ADC Sample Module Start of Conversion Overrun Flag Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[8]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t SCTL[19]; /*!< [0x0080] ADC Sample Module 0~18 Control Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE1[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t INTSRC[4]; /*!< [0x00d0] ADC interrupt 0~3 Source Enable Control Register. */ + __IO uint32_t CMP[4]; /*!< [0x00e0] ADC Result Compare Register 0~3 */ + __I uint32_t STATUS0; /*!< [0x00f0] ADC Status Register 0 */ + __I uint32_t STATUS1; /*!< [0x00f4] ADC Status Register 1 */ + __IO uint32_t STATUS2; /*!< [0x00f8] ADC Status Register 2 */ + __I uint32_t STATUS3; /*!< [0x00fc] ADC Status Register 3 */ + __I uint32_t DDAT[4]; /*!< [0x0100] ADC Double Data Register 0~3 for Sample Module 0~3 */ + __IO uint32_t PWRM; /*!< [0x0110] ADC Power Management Register */ + __IO uint32_t CALCTL; /*!< [0x0114] ADC Calibration Control Register */ + __IO uint32_t CALDWRD; /*!< [0x0118] ADC Calibration Load Word Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE2[5]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t PDMACTL; /*!< [0x0130] ADC PDMA Control Register */ +} EADC_T; + +/** + @addtogroup EADC_CONST EADC Bit Field Definition + Constant Definitions for EADC Controller +@{ */ + +#define EADC_DAT_RESULT_Pos (0) /*!< EADC_T::DAT: RESULT Position */ +#define EADC_DAT_RESULT_Msk (0xfffful << EADC_DAT_RESULT_Pos) /*!< EADC_T::DAT: RESULT Mask */ + +#define EADC_DAT_OV_Pos (16) /*!< EADC_T::DAT: OV Position */ +#define EADC_DAT_OV_Msk (0x1ul << EADC_DAT_OV_Pos) /*!< EADC_T::DAT: OV Mask */ + +#define EADC_DAT_VALID_Pos (17) /*!< EADC_T::DAT: VALID Position */ +#define EADC_DAT_VALID_Msk (0x1ul << EADC_DAT_VALID_Pos) /*!< EADC_T::DAT: VALID Mask */ + +#define EADC_DAT0_RESULT_Pos (0) /*!< EADC_T::DAT0: RESULT Position */ +#define EADC_DAT0_RESULT_Msk (0xfffful << EADC_DAT0_RESULT_Pos) /*!< EADC_T::DAT0: RESULT Mask */ + +#define EADC_DAT0_OV_Pos (16) /*!< EADC_T::DAT0: OV Position */ +#define EADC_DAT0_OV_Msk (0x1ul << EADC_DAT0_OV_Pos) /*!< EADC_T::DAT0: OV Mask */ + +#define EADC_DAT0_VALID_Pos (17) /*!< EADC_T::DAT0: VALID Position */ +#define EADC_DAT0_VALID_Msk (0x1ul << EADC_DAT0_VALID_Pos) /*!< EADC_T::DAT0: VALID Mask */ + +#define EADC_DAT1_RESULT_Pos (0) /*!< EADC_T::DAT1: RESULT Position */ +#define EADC_DAT1_RESULT_Msk (0xfffful << EADC_DAT1_RESULT_Pos) /*!< EADC_T::DAT1: RESULT Mask */ + +#define EADC_DAT1_OV_Pos (16) /*!< EADC_T::DAT1: OV Position */ +#define EADC_DAT1_OV_Msk (0x1ul << EADC_DAT1_OV_Pos) /*!< EADC_T::DAT1: OV Mask */ + +#define EADC_DAT1_VALID_Pos (17) /*!< EADC_T::DAT1: VALID Position */ +#define EADC_DAT1_VALID_Msk (0x1ul << EADC_DAT1_VALID_Pos) /*!< EADC_T::DAT1: VALID Mask */ + +#define EADC_DAT2_RESULT_Pos (0) /*!< EADC_T::DAT2: RESULT Position */ +#define EADC_DAT2_RESULT_Msk (0xfffful << EADC_DAT2_RESULT_Pos) /*!< EADC_T::DAT2: RESULT Mask */ + +#define EADC_DAT2_OV_Pos (16) /*!< EADC_T::DAT2: OV Position */ +#define EADC_DAT2_OV_Msk (0x1ul << EADC_DAT2_OV_Pos) /*!< EADC_T::DAT2: OV Mask */ + +#define EADC_DAT2_VALID_Pos (17) /*!< EADC_T::DAT2: VALID Position */ +#define EADC_DAT2_VALID_Msk (0x1ul << EADC_DAT2_VALID_Pos) /*!< EADC_T::DAT2: VALID Mask */ + +#define EADC_DAT3_RESULT_Pos (0) /*!< EADC_T::DAT3: RESULT Position */ +#define EADC_DAT3_RESULT_Msk (0xfffful << EADC_DAT3_RESULT_Pos) /*!< EADC_T::DAT3: RESULT Mask */ + +#define EADC_DAT3_OV_Pos (16) /*!< EADC_T::DAT3: OV Position */ +#define EADC_DAT3_OV_Msk (0x1ul << EADC_DAT3_OV_Pos) /*!< EADC_T::DAT3: OV Mask */ + +#define EADC_DAT3_VALID_Pos (17) /*!< EADC_T::DAT3: VALID Position */ +#define EADC_DAT3_VALID_Msk (0x1ul << EADC_DAT3_VALID_Pos) /*!< EADC_T::DAT3: VALID Mask */ + +#define EADC_DAT4_RESULT_Pos (0) /*!< EADC_T::DAT4: RESULT Position */ +#define EADC_DAT4_RESULT_Msk (0xfffful << EADC_DAT4_RESULT_Pos) /*!< EADC_T::DAT4: RESULT Mask */ + +#define EADC_DAT4_OV_Pos (16) /*!< EADC_T::DAT4: OV Position */ +#define EADC_DAT4_OV_Msk (0x1ul << EADC_DAT4_OV_Pos) /*!< EADC_T::DAT4: OV Mask */ + +#define EADC_DAT4_VALID_Pos (17) /*!< EADC_T::DAT4: VALID Position */ +#define EADC_DAT4_VALID_Msk (0x1ul << EADC_DAT4_VALID_Pos) /*!< EADC_T::DAT4: VALID Mask */ + +#define EADC_DAT5_RESULT_Pos (0) /*!< EADC_T::DAT5: RESULT Position */ +#define EADC_DAT5_RESULT_Msk (0xfffful << EADC_DAT5_RESULT_Pos) /*!< EADC_T::DAT5: RESULT Mask */ + +#define EADC_DAT5_OV_Pos (16) /*!< EADC_T::DAT5: OV Position */ +#define EADC_DAT5_OV_Msk (0x1ul << EADC_DAT5_OV_Pos) /*!< EADC_T::DAT5: OV Mask */ + +#define EADC_DAT5_VALID_Pos (17) /*!< EADC_T::DAT5: VALID Position */ +#define EADC_DAT5_VALID_Msk (0x1ul << EADC_DAT5_VALID_Pos) /*!< EADC_T::DAT5: VALID Mask */ + +#define EADC_DAT6_RESULT_Pos (0) /*!< EADC_T::DAT6: RESULT Position */ +#define EADC_DAT6_RESULT_Msk (0xfffful << EADC_DAT6_RESULT_Pos) /*!< EADC_T::DAT6: RESULT Mask */ + +#define EADC_DAT6_OV_Pos (16) /*!< EADC_T::DAT6: OV Position */ +#define EADC_DAT6_OV_Msk (0x1ul << EADC_DAT6_OV_Pos) /*!< EADC_T::DAT6: OV Mask */ + +#define EADC_DAT6_VALID_Pos (17) /*!< EADC_T::DAT6: VALID Position */ +#define EADC_DAT6_VALID_Msk (0x1ul << EADC_DAT6_VALID_Pos) /*!< EADC_T::DAT6: VALID Mask */ + +#define EADC_DAT7_RESULT_Pos (0) /*!< EADC_T::DAT7: RESULT Position */ +#define EADC_DAT7_RESULT_Msk (0xfffful << EADC_DAT7_RESULT_Pos) /*!< EADC_T::DAT7: RESULT Mask */ + +#define EADC_DAT7_OV_Pos (16) /*!< EADC_T::DAT7: OV Position */ +#define EADC_DAT7_OV_Msk (0x1ul << EADC_DAT7_OV_Pos) /*!< EADC_T::DAT7: OV Mask */ + +#define EADC_DAT7_VALID_Pos (17) /*!< EADC_T::DAT7: VALID Position */ +#define EADC_DAT7_VALID_Msk (0x1ul << EADC_DAT7_VALID_Pos) /*!< EADC_T::DAT7: VALID Mask */ + +#define EADC_DAT8_RESULT_Pos (0) /*!< EADC_T::DAT8: RESULT Position */ +#define EADC_DAT8_RESULT_Msk (0xfffful << EADC_DAT8_RESULT_Pos) /*!< EADC_T::DAT8: RESULT Mask */ + +#define EADC_DAT8_OV_Pos (16) /*!< EADC_T::DAT8: OV Position */ +#define EADC_DAT8_OV_Msk (0x1ul << EADC_DAT8_OV_Pos) /*!< EADC_T::DAT8: OV Mask */ + +#define EADC_DAT8_VALID_Pos (17) /*!< EADC_T::DAT8: VALID Position */ +#define EADC_DAT8_VALID_Msk (0x1ul << EADC_DAT8_VALID_Pos) /*!< EADC_T::DAT8: VALID Mask */ + +#define EADC_DAT9_RESULT_Pos (0) /*!< EADC_T::DAT9: RESULT Position */ +#define EADC_DAT9_RESULT_Msk (0xfffful << EADC_DAT9_RESULT_Pos) /*!< EADC_T::DAT9: RESULT Mask */ + +#define EADC_DAT9_OV_Pos (16) /*!< EADC_T::DAT9: OV Position */ +#define EADC_DAT9_OV_Msk (0x1ul << EADC_DAT9_OV_Pos) /*!< EADC_T::DAT9: OV Mask */ + +#define EADC_DAT9_VALID_Pos (17) /*!< EADC_T::DAT9: VALID Position */ +#define EADC_DAT9_VALID_Msk (0x1ul << EADC_DAT9_VALID_Pos) /*!< EADC_T::DAT9: VALID Mask */ + +#define EADC_DAT10_RESULT_Pos (0) /*!< EADC_T::DAT10: RESULT Position */ +#define EADC_DAT10_RESULT_Msk (0xfffful << EADC_DAT10_RESULT_Pos) /*!< EADC_T::DAT10: RESULT Mask */ + +#define EADC_DAT10_OV_Pos (16) /*!< EADC_T::DAT10: OV Position */ +#define EADC_DAT10_OV_Msk (0x1ul << EADC_DAT10_OV_Pos) /*!< EADC_T::DAT10: OV Mask */ + +#define EADC_DAT10_VALID_Pos (17) /*!< EADC_T::DAT10: VALID Position */ +#define EADC_DAT10_VALID_Msk (0x1ul << EADC_DAT10_VALID_Pos) /*!< EADC_T::DAT10: VALID Mask */ + +#define EADC_DAT11_RESULT_Pos (0) /*!< EADC_T::DAT11: RESULT Position */ +#define EADC_DAT11_RESULT_Msk (0xfffful << EADC_DAT11_RESULT_Pos) /*!< EADC_T::DAT11: RESULT Mask */ + +#define EADC_DAT11_OV_Pos (16) /*!< EADC_T::DAT11: OV Position */ +#define EADC_DAT11_OV_Msk (0x1ul << EADC_DAT11_OV_Pos) /*!< EADC_T::DAT11: OV Mask */ + +#define EADC_DAT11_VALID_Pos (17) /*!< EADC_T::DAT11: VALID Position */ +#define EADC_DAT11_VALID_Msk (0x1ul << EADC_DAT11_VALID_Pos) /*!< EADC_T::DAT11: VALID Mask */ + +#define EADC_DAT12_RESULT_Pos (0) /*!< EADC_T::DAT12: RESULT Position */ +#define EADC_DAT12_RESULT_Msk (0xfffful << EADC_DAT12_RESULT_Pos) /*!< EADC_T::DAT12: RESULT Mask */ + +#define EADC_DAT12_OV_Pos (16) /*!< EADC_T::DAT12: OV Position */ +#define EADC_DAT12_OV_Msk (0x1ul << EADC_DAT12_OV_Pos) /*!< EADC_T::DAT12: OV Mask */ + +#define EADC_DAT12_VALID_Pos (17) /*!< EADC_T::DAT12: VALID Position */ +#define EADC_DAT12_VALID_Msk (0x1ul << EADC_DAT12_VALID_Pos) /*!< EADC_T::DAT12: VALID Mask */ + +#define EADC_DAT13_RESULT_Pos (0) /*!< EADC_T::DAT13: RESULT Position */ +#define EADC_DAT13_RESULT_Msk (0xfffful << EADC_DAT13_RESULT_Pos) /*!< EADC_T::DAT13: RESULT Mask */ + +#define EADC_DAT13_OV_Pos (16) /*!< EADC_T::DAT13: OV Position */ +#define EADC_DAT13_OV_Msk (0x1ul << EADC_DAT13_OV_Pos) /*!< EADC_T::DAT13: OV Mask */ + +#define EADC_DAT13_VALID_Pos (17) /*!< EADC_T::DAT13: VALID Position */ +#define EADC_DAT13_VALID_Msk (0x1ul << EADC_DAT13_VALID_Pos) /*!< EADC_T::DAT13: VALID Mask */ + +#define EADC_DAT14_RESULT_Pos (0) /*!< EADC_T::DAT14: RESULT Position */ +#define EADC_DAT14_RESULT_Msk (0xfffful << EADC_DAT14_RESULT_Pos) /*!< EADC_T::DAT14: RESULT Mask */ + +#define EADC_DAT14_OV_Pos (16) /*!< EADC_T::DAT14: OV Position */ +#define EADC_DAT14_OV_Msk (0x1ul << EADC_DAT14_OV_Pos) /*!< EADC_T::DAT14: OV Mask */ + +#define EADC_DAT14_VALID_Pos (17) /*!< EADC_T::DAT14: VALID Position */ +#define EADC_DAT14_VALID_Msk (0x1ul << EADC_DAT14_VALID_Pos) /*!< EADC_T::DAT14: VALID Mask */ + +#define EADC_DAT15_RESULT_Pos (0) /*!< EADC_T::DAT15: RESULT Position */ +#define EADC_DAT15_RESULT_Msk (0xfffful << EADC_DAT15_RESULT_Pos) /*!< EADC_T::DAT15: RESULT Mask */ + +#define EADC_DAT15_OV_Pos (16) /*!< EADC_T::DAT15: OV Position */ +#define EADC_DAT15_OV_Msk (0x1ul << EADC_DAT15_OV_Pos) /*!< EADC_T::DAT15: OV Mask */ + +#define EADC_DAT15_VALID_Pos (17) /*!< EADC_T::DAT15: VALID Position */ +#define EADC_DAT15_VALID_Msk (0x1ul << EADC_DAT15_VALID_Pos) /*!< EADC_T::DAT15: VALID Mask */ + +#define EADC_DAT16_RESULT_Pos (0) /*!< EADC_T::DAT16: RESULT Position */ +#define EADC_DAT16_RESULT_Msk (0xfffful << EADC_DAT16_RESULT_Pos) /*!< EADC_T::DAT16: RESULT Mask */ + +#define EADC_DAT16_OV_Pos (16) /*!< EADC_T::DAT16: OV Position */ +#define EADC_DAT16_OV_Msk (0x1ul << EADC_DAT16_OV_Pos) /*!< EADC_T::DAT16: OV Mask */ + +#define EADC_DAT16_VALID_Pos (17) /*!< EADC_T::DAT16: VALID Position */ +#define EADC_DAT16_VALID_Msk (0x1ul << EADC_DAT16_VALID_Pos) /*!< EADC_T::DAT16: VALID Mask */ + +#define EADC_DAT17_RESULT_Pos (0) /*!< EADC_T::DAT17: RESULT Position */ +#define EADC_DAT17_RESULT_Msk (0xfffful << EADC_DAT17_RESULT_Pos) /*!< EADC_T::DAT17: RESULT Mask */ + +#define EADC_DAT17_OV_Pos (16) /*!< EADC_T::DAT17: OV Position */ +#define EADC_DAT17_OV_Msk (0x1ul << EADC_DAT17_OV_Pos) /*!< EADC_T::DAT17: OV Mask */ + +#define EADC_DAT17_VALID_Pos (17) /*!< EADC_T::DAT17: VALID Position */ +#define EADC_DAT17_VALID_Msk (0x1ul << EADC_DAT17_VALID_Pos) /*!< EADC_T::DAT17: VALID Mask */ + +#define EADC_DAT18_RESULT_Pos (0) /*!< EADC_T::DAT18: RESULT Position */ +#define EADC_DAT18_RESULT_Msk (0xfffful << EADC_DAT18_RESULT_Pos) /*!< EADC_T::DAT18: RESULT Mask */ + +#define EADC_DAT18_OV_Pos (16) /*!< EADC_T::DAT18: OV Position */ +#define EADC_DAT18_OV_Msk (0x1ul << EADC_DAT18_OV_Pos) /*!< EADC_T::DAT18: OV Mask */ + +#define EADC_DAT18_VALID_Pos (17) /*!< EADC_T::DAT18: VALID Position */ +#define EADC_DAT18_VALID_Msk (0x1ul << EADC_DAT18_VALID_Pos) /*!< EADC_T::DAT18: VALID Mask */ + +#define EADC_CURDAT_CURDAT_Pos (0) /*!< EADC_T::CURDAT: CURDAT Position */ +#define EADC_CURDAT_CURDAT_Msk (0x3fffful << EADC_CURDAT_CURDAT_Pos) /*!< EADC_T::CURDAT: CURDAT Mask */ + +#define EADC_CTL_ADCEN_Pos (0) /*!< EADC_T::CTL: ADCEN Position */ +#define EADC_CTL_ADCEN_Msk (0x1ul << EADC_CTL_ADCEN_Pos) /*!< EADC_T::CTL: ADCEN Mask */ + +#define EADC_CTL_ADCRST_Pos (1) /*!< EADC_T::CTL: ADCRST Position */ +#define EADC_CTL_ADCRST_Msk (0x1ul << EADC_CTL_ADCRST_Pos) /*!< EADC_T::CTL: ADCRST Mask */ + +#define EADC_CTL_ADCIEN0_Pos (2) /*!< EADC_T::CTL: ADCIEN0 Position */ +#define EADC_CTL_ADCIEN0_Msk (0x1ul << EADC_CTL_ADCIEN0_Pos) /*!< EADC_T::CTL: ADCIEN0 Mask */ + +#define EADC_CTL_ADCIEN1_Pos (3) /*!< EADC_T::CTL: ADCIEN1 Position */ +#define EADC_CTL_ADCIEN1_Msk (0x1ul << EADC_CTL_ADCIEN1_Pos) /*!< EADC_T::CTL: ADCIEN1 Mask */ + +#define EADC_CTL_ADCIEN2_Pos (4) /*!< EADC_T::CTL: ADCIEN2 Position */ +#define EADC_CTL_ADCIEN2_Msk (0x1ul << EADC_CTL_ADCIEN2_Pos) /*!< EADC_T::CTL: ADCIEN2 Mask */ + +#define EADC_CTL_ADCIEN3_Pos (5) /*!< EADC_T::CTL: ADCIEN3 Position */ +#define EADC_CTL_ADCIEN3_Msk (0x1ul << EADC_CTL_ADCIEN3_Pos) /*!< EADC_T::CTL: ADCIEN3 Mask */ + +#define EADC_CTL_RESSEL_Pos (6) /*!< EADC_T::CTL: RESSEL Position */ +#define EADC_CTL_RESSEL_Msk (0x3ul << EADC_CTL_RESSEL_Pos) /*!< EADC_T::CTL: RESSEL Mask */ + +#define EADC_CTL_DIFFEN_Pos (8) /*!< EADC_T::CTL: DIFFEN Position */ +#define EADC_CTL_DIFFEN_Msk (0x1ul << EADC_CTL_DIFFEN_Pos) /*!< EADC_T::CTL: DIFFEN Mask */ + +#define EADC_CTL_DMOF_Pos (9) /*!< EADC_T::CTL: DMOF Position */ +#define EADC_CTL_DMOF_Msk (0x1ul << EADC_CTL_DMOF_Pos) /*!< EADC_T::CTL: DMOF Mask */ + +#define EADC_CTL_PDMAEN_Pos (11) /*!< EADC_T::CTL: PDMAEN Position */ +#define EADC_CTL_PDMAEN_Msk (0x1ul << EADC_CTL_PDMAEN_Pos) /*!< EADC_T::CTL: PDMAEN Mask */ + +#define EADC_SWTRG_SWTRG_Pos (0) /*!< EADC_T::SWTRG: SWTRG Position */ +#define EADC_SWTRG_SWTRG_Msk (0x7fffful << EADC_SWTRG_SWTRG_Pos) /*!< EADC_T::SWTRG: SWTRG Mask */ + +#define EADC_PENDSTS_STPF_Pos (0) /*!< EADC_T::PENDSTS: STPF Position */ +#define EADC_PENDSTS_STPF_Msk (0x7fffful << EADC_PENDSTS_STPF_Pos) /*!< EADC_T::PENDSTS: STPF Mask */ + +#define EADC_OVSTS_SPOVF_Pos (0) /*!< EADC_T::OVSTS: SPOVF Position */ +#define EADC_OVSTS_SPOVF_Msk (0x7fffful << EADC_OVSTS_SPOVF_Pos) /*!< EADC_T::OVSTS: SPOVF Mask */ + +#define EADC_SCTL_CHSEL_Pos (0) /*!< EADC_T::SCTL: CHSEL Position */ +#define EADC_SCTL_CHSEL_Msk (0xful << EADC_SCTL_CHSEL_Pos) /*!< EADC_T::SCTL: CHSEL Mask */ + +#define EADC_SCTL_EXTREN_Pos (4) /*!< EADC_T::SCTL: EXTREN Position */ +#define EADC_SCTL_EXTREN_Msk (0x1ul << EADC_SCTL_EXTREN_Pos) /*!< EADC_T::SCTL: EXTREN Mask */ + +#define EADC_SCTL_EXTFEN_Pos (5) /*!< EADC_T::SCTL: EXTFEN Position */ +#define EADC_SCTL_EXTFEN_Msk (0x1ul << EADC_SCTL_EXTFEN_Pos) /*!< EADC_T::SCTL: EXTFEN Mask */ + +#define EADC_SCTL_TRGDLYDIV_Pos (6) /*!< EADC_T::SCTL: TRGDLYDIV Position */ +#define EADC_SCTL_TRGDLYDIV_Msk (0x3ul << EADC_SCTL_TRGDLYDIV_Pos) /*!< EADC_T::SCTL: TRGDLYDIV Mask */ + +#define EADC_SCTL_TRGDLYCNT_Pos (8) /*!< EADC_T::SCTL: TRGDLYCNT Position */ +#define EADC_SCTL_TRGDLYCNT_Msk (0xfful << EADC_SCTL_TRGDLYCNT_Pos) /*!< EADC_T::SCTL: TRGDLYCNT Mask */ + +#define EADC_SCTL_TRGSEL_Pos (16) /*!< EADC_T::SCTL: TRGSEL Position */ +#define EADC_SCTL_TRGSEL_Msk (0x1ful << EADC_SCTL_TRGSEL_Pos) /*!< EADC_T::SCTL: TRGSEL Mask */ + +#define EADC_SCTL_INTPOS_Pos (22) /*!< EADC_T::SCTL: INTPOS Position */ +#define EADC_SCTL_INTPOS_Msk (0x1ul << EADC_SCTL_INTPOS_Pos) /*!< EADC_T::SCTL: INTPOS Mask */ + +#define EADC_SCTL_DBMEN_Pos (23) /*!< EADC_T::SCTL: DBMEN Position */ +#define EADC_SCTL_DBMEN_Msk (0x1ul << EADC_SCTL_DBMEN_Pos) /*!< EADC_T::SCTL: DBMEN Mask */ + +#define EADC_SCTL_EXTSMPT_Pos (24) /*!< EADC_T::SCTL: EXTSMPT Position */ +#define EADC_SCTL_EXTSMPT_Msk (0xfful << EADC_SCTL_EXTSMPT_Pos) /*!< EADC_T::SCTL: EXTSMPT Mask */ + +#define EADC_SCTL0_CHSEL_Pos (0) /*!< EADC_T::SCTL0: CHSEL Position */ +#define EADC_SCTL0_CHSEL_Msk (0xful << EADC_SCTL0_CHSEL_Pos) /*!< EADC_T::SCTL0: CHSEL Mask */ + +#define EADC_SCTL0_EXTREN_Pos (4) /*!< EADC_T::SCTL0: EXTREN Position */ +#define EADC_SCTL0_EXTREN_Msk (0x1ul << EADC_SCTL0_EXTREN_Pos) /*!< EADC_T::SCTL0: EXTREN Mask */ + +#define EADC_SCTL0_EXTFEN_Pos (5) /*!< EADC_T::SCTL0: EXTFEN Position */ +#define EADC_SCTL0_EXTFEN_Msk (0x1ul << EADC_SCTL0_EXTFEN_Pos) /*!< EADC_T::SCTL0: EXTFEN Mask */ + +#define EADC_SCTL0_TRGDLYDIV_Pos (6) /*!< EADC_T::SCTL0: TRGDLYDIV Position */ +#define EADC_SCTL0_TRGDLYDIV_Msk (0x3ul << EADC_SCTL0_TRGDLYDIV_Pos) /*!< EADC_T::SCTL0: TRGDLYDIV Mask */ + +#define EADC_SCTL0_TRGDLYCNT_Pos (8) /*!< EADC_T::SCTL0: TRGDLYCNT Position */ +#define EADC_SCTL0_TRGDLYCNT_Msk (0xfful << EADC_SCTL0_TRGDLYCNT_Pos) /*!< EADC_T::SCTL0: TRGDLYCNT Mask */ + +#define EADC_SCTL0_TRGSEL_Pos (16) /*!< EADC_T::SCTL0: TRGSEL Position */ +#define EADC_SCTL0_TRGSEL_Msk (0x1ful << EADC_SCTL0_TRGSEL_Pos) /*!< EADC_T::SCTL0: TRGSEL Mask */ + +#define EADC_SCTL0_INTPOS_Pos (22) /*!< EADC_T::SCTL0: INTPOS Position */ +#define EADC_SCTL0_INTPOS_Msk (0x1ul << EADC_SCTL0_INTPOS_Pos) /*!< EADC_T::SCTL0: INTPOS Mask */ + +#define EADC_SCTL0_DBMEN_Pos (23) /*!< EADC_T::SCTL0: DBMEN Position */ +#define EADC_SCTL0_DBMEN_Msk (0x1ul << EADC_SCTL0_DBMEN_Pos) /*!< EADC_T::SCTL0: DBMEN Mask */ + +#define EADC_SCTL0_EXTSMPT_Pos (24) /*!< EADC_T::SCTL0: EXTSMPT Position */ +#define EADC_SCTL0_EXTSMPT_Msk (0xfful << EADC_SCTL0_EXTSMPT_Pos) /*!< EADC_T::SCTL0: EXTSMPT Mask */ + +#define EADC_SCTL1_CHSEL_Pos (0) /*!< EADC_T::SCTL1: CHSEL Position */ +#define EADC_SCTL1_CHSEL_Msk (0xful << EADC_SCTL1_CHSEL_Pos) /*!< EADC_T::SCTL1: CHSEL Mask */ + +#define EADC_SCTL1_EXTREN_Pos (4) /*!< EADC_T::SCTL1: EXTREN Position */ +#define EADC_SCTL1_EXTREN_Msk (0x1ul << EADC_SCTL1_EXTREN_Pos) /*!< EADC_T::SCTL1: EXTREN Mask */ + +#define EADC_SCTL1_EXTFEN_Pos (5) /*!< EADC_T::SCTL1: EXTFEN Position */ +#define EADC_SCTL1_EXTFEN_Msk (0x1ul << EADC_SCTL1_EXTFEN_Pos) /*!< EADC_T::SCTL1: EXTFEN Mask */ + +#define EADC_SCTL1_TRGDLYDIV_Pos (6) /*!< EADC_T::SCTL1: TRGDLYDIV Position */ +#define EADC_SCTL1_TRGDLYDIV_Msk (0x3ul << EADC_SCTL1_TRGDLYDIV_Pos) /*!< EADC_T::SCTL1: TRGDLYDIV Mask */ + +#define EADC_SCTL1_TRGDLYCNT_Pos (8) /*!< EADC_T::SCTL1: TRGDLYCNT Position */ +#define EADC_SCTL1_TRGDLYCNT_Msk (0xfful << EADC_SCTL1_TRGDLYCNT_Pos) /*!< EADC_T::SCTL1: TRGDLYCNT Mask */ + +#define EADC_SCTL1_TRGSEL_Pos (16) /*!< EADC_T::SCTL1: TRGSEL Position */ +#define EADC_SCTL1_TRGSEL_Msk (0x1ful << EADC_SCTL1_TRGSEL_Pos) /*!< EADC_T::SCTL1: TRGSEL Mask */ + +#define EADC_SCTL1_INTPOS_Pos (22) /*!< EADC_T::SCTL1: INTPOS Position */ +#define EADC_SCTL1_INTPOS_Msk (0x1ul << EADC_SCTL1_INTPOS_Pos) /*!< EADC_T::SCTL1: INTPOS Mask */ + +#define EADC_SCTL1_DBMEN_Pos (23) /*!< EADC_T::SCTL1: DBMEN Position */ +#define EADC_SCTL1_DBMEN_Msk (0x1ul << EADC_SCTL1_DBMEN_Pos) /*!< EADC_T::SCTL1: DBMEN Mask */ + +#define EADC_SCTL1_EXTSMPT_Pos (24) /*!< EADC_T::SCTL1: EXTSMPT Position */ +#define EADC_SCTL1_EXTSMPT_Msk (0xfful << EADC_SCTL1_EXTSMPT_Pos) /*!< EADC_T::SCTL1: EXTSMPT Mask */ + +#define EADC_SCTL2_CHSEL_Pos (0) /*!< EADC_T::SCTL2: CHSEL Position */ +#define EADC_SCTL2_CHSEL_Msk (0xful << EADC_SCTL2_CHSEL_Pos) /*!< EADC_T::SCTL2: CHSEL Mask */ + +#define EADC_SCTL2_EXTREN_Pos (4) /*!< EADC_T::SCTL2: EXTREN Position */ +#define EADC_SCTL2_EXTREN_Msk (0x1ul << EADC_SCTL2_EXTREN_Pos) /*!< EADC_T::SCTL2: EXTREN Mask */ + +#define EADC_SCTL2_EXTFEN_Pos (5) /*!< EADC_T::SCTL2: EXTFEN Position */ +#define EADC_SCTL2_EXTFEN_Msk (0x1ul << EADC_SCTL2_EXTFEN_Pos) /*!< EADC_T::SCTL2: EXTFEN Mask */ + +#define EADC_SCTL2_TRGDLYDIV_Pos (6) /*!< EADC_T::SCTL2: TRGDLYDIV Position */ +#define EADC_SCTL2_TRGDLYDIV_Msk (0x3ul << EADC_SCTL2_TRGDLYDIV_Pos) /*!< EADC_T::SCTL2: TRGDLYDIV Mask */ + +#define EADC_SCTL2_TRGDLYCNT_Pos (8) /*!< EADC_T::SCTL2: TRGDLYCNT Position */ +#define EADC_SCTL2_TRGDLYCNT_Msk (0xfful << EADC_SCTL2_TRGDLYCNT_Pos) /*!< EADC_T::SCTL2: TRGDLYCNT Mask */ + +#define EADC_SCTL2_TRGSEL_Pos (16) /*!< EADC_T::SCTL2: TRGSEL Position */ +#define EADC_SCTL2_TRGSEL_Msk (0x1ful << EADC_SCTL2_TRGSEL_Pos) /*!< EADC_T::SCTL2: TRGSEL Mask */ + +#define EADC_SCTL2_INTPOS_Pos (22) /*!< EADC_T::SCTL2: INTPOS Position */ +#define EADC_SCTL2_INTPOS_Msk (0x1ul << EADC_SCTL2_INTPOS_Pos) /*!< EADC_T::SCTL2: INTPOS Mask */ + +#define EADC_SCTL2_DBMEN_Pos (23) /*!< EADC_T::SCTL2: DBMEN Position */ +#define EADC_SCTL2_DBMEN_Msk (0x1ul << EADC_SCTL2_DBMEN_Pos) /*!< EADC_T::SCTL2: DBMEN Mask */ + +#define EADC_SCTL2_EXTSMPT_Pos (24) /*!< EADC_T::SCTL2: EXTSMPT Position */ +#define EADC_SCTL2_EXTSMPT_Msk (0xfful << EADC_SCTL2_EXTSMPT_Pos) /*!< EADC_T::SCTL2: EXTSMPT Mask */ + +#define EADC_SCTL3_CHSEL_Pos (0) /*!< EADC_T::SCTL3: CHSEL Position */ +#define EADC_SCTL3_CHSEL_Msk (0xful << EADC_SCTL3_CHSEL_Pos) /*!< EADC_T::SCTL3: CHSEL Mask */ + +#define EADC_SCTL3_EXTREN_Pos (4) /*!< EADC_T::SCTL3: EXTREN Position */ +#define EADC_SCTL3_EXTREN_Msk (0x1ul << EADC_SCTL3_EXTREN_Pos) /*!< EADC_T::SCTL3: EXTREN Mask */ + +#define EADC_SCTL3_EXTFEN_Pos (5) /*!< EADC_T::SCTL3: EXTFEN Position */ +#define EADC_SCTL3_EXTFEN_Msk (0x1ul << EADC_SCTL3_EXTFEN_Pos) /*!< EADC_T::SCTL3: EXTFEN Mask */ + +#define EADC_SCTL3_TRGDLYDIV_Pos (6) /*!< EADC_T::SCTL3: TRGDLYDIV Position */ +#define EADC_SCTL3_TRGDLYDIV_Msk (0x3ul << EADC_SCTL3_TRGDLYDIV_Pos) /*!< EADC_T::SCTL3: TRGDLYDIV Mask */ + +#define EADC_SCTL3_TRGDLYCNT_Pos (8) /*!< EADC_T::SCTL3: TRGDLYCNT Position */ +#define EADC_SCTL3_TRGDLYCNT_Msk (0xfful << EADC_SCTL3_TRGDLYCNT_Pos) /*!< EADC_T::SCTL3: TRGDLYCNT Mask */ + +#define EADC_SCTL3_TRGSEL_Pos (16) /*!< EADC_T::SCTL3: TRGSEL Position */ +#define EADC_SCTL3_TRGSEL_Msk (0x1ful << EADC_SCTL3_TRGSEL_Pos) /*!< EADC_T::SCTL3: TRGSEL Mask */ + +#define EADC_SCTL3_INTPOS_Pos (22) /*!< EADC_T::SCTL3: INTPOS Position */ +#define EADC_SCTL3_INTPOS_Msk (0x1ul << EADC_SCTL3_INTPOS_Pos) /*!< EADC_T::SCTL3: INTPOS Mask */ + +#define EADC_SCTL3_DBMEN_Pos (23) /*!< EADC_T::SCTL3: DBMEN Position */ +#define EADC_SCTL3_DBMEN_Msk (0x1ul << EADC_SCTL3_DBMEN_Pos) /*!< EADC_T::SCTL3: DBMEN Mask */ + +#define EADC_SCTL3_EXTSMPT_Pos (24) /*!< EADC_T::SCTL3: EXTSMPT Position */ +#define EADC_SCTL3_EXTSMPT_Msk (0xfful << EADC_SCTL3_EXTSMPT_Pos) /*!< EADC_T::SCTL3: EXTSMPT Mask */ + +#define EADC_SCTL4_CHSEL_Pos (0) /*!< EADC_T::SCTL4: CHSEL Position */ +#define EADC_SCTL4_CHSEL_Msk (0xful << EADC_SCTL4_CHSEL_Pos) /*!< EADC_T::SCTL4: CHSEL Mask */ + +#define EADC_SCTL4_EXTREN_Pos (4) /*!< EADC_T::SCTL4: EXTREN Position */ +#define EADC_SCTL4_EXTREN_Msk (0x1ul << EADC_SCTL4_EXTREN_Pos) /*!< EADC_T::SCTL4: EXTREN Mask */ + +#define EADC_SCTL4_EXTFEN_Pos (5) /*!< EADC_T::SCTL4: EXTFEN Position */ +#define EADC_SCTL4_EXTFEN_Msk (0x1ul << EADC_SCTL4_EXTFEN_Pos) /*!< EADC_T::SCTL4: EXTFEN Mask */ + +#define EADC_SCTL4_TRGDLYDIV_Pos (6) /*!< EADC_T::SCTL4: TRGDLYDIV Position */ +#define EADC_SCTL4_TRGDLYDIV_Msk (0x3ul << EADC_SCTL4_TRGDLYDIV_Pos) /*!< EADC_T::SCTL4: TRGDLYDIV Mask */ + +#define EADC_SCTL4_TRGDLYCNT_Pos (8) /*!< EADC_T::SCTL4: TRGDLYCNT Position */ +#define EADC_SCTL4_TRGDLYCNT_Msk (0xfful << EADC_SCTL4_TRGDLYCNT_Pos) /*!< EADC_T::SCTL4: TRGDLYCNT Mask */ + +#define EADC_SCTL4_TRGSEL_Pos (16) /*!< EADC_T::SCTL4: TRGSEL Position */ +#define EADC_SCTL4_TRGSEL_Msk (0x1ful << EADC_SCTL4_TRGSEL_Pos) /*!< EADC_T::SCTL4: TRGSEL Mask */ + +#define EADC_SCTL4_INTPOS_Pos (22) /*!< EADC_T::SCTL4: INTPOS Position */ +#define EADC_SCTL4_INTPOS_Msk (0x1ul << EADC_SCTL4_INTPOS_Pos) /*!< EADC_T::SCTL4: INTPOS Mask */ + +#define EADC_SCTL4_EXTSMPT_Pos (24) /*!< EADC_T::SCTL4: EXTSMPT Position */ +#define EADC_SCTL4_EXTSMPT_Msk (0xfful << EADC_SCTL4_EXTSMPT_Pos) /*!< EADC_T::SCTL4: EXTSMPT Mask */ + +#define EADC_SCTL5_CHSEL_Pos (0) /*!< EADC_T::SCTL5: CHSEL Position */ +#define EADC_SCTL5_CHSEL_Msk (0xful << EADC_SCTL5_CHSEL_Pos) /*!< EADC_T::SCTL5: CHSEL Mask */ + +#define EADC_SCTL5_EXTREN_Pos (4) /*!< EADC_T::SCTL5: EXTREN Position */ +#define EADC_SCTL5_EXTREN_Msk (0x1ul << EADC_SCTL5_EXTREN_Pos) /*!< EADC_T::SCTL5: EXTREN Mask */ + +#define EADC_SCTL5_EXTFEN_Pos (5) /*!< EADC_T::SCTL5: EXTFEN Position */ +#define EADC_SCTL5_EXTFEN_Msk (0x1ul << EADC_SCTL5_EXTFEN_Pos) /*!< EADC_T::SCTL5: EXTFEN Mask */ + +#define EADC_SCTL5_TRGDLYDIV_Pos (6) /*!< EADC_T::SCTL5: TRGDLYDIV Position */ +#define EADC_SCTL5_TRGDLYDIV_Msk (0x3ul << EADC_SCTL5_TRGDLYDIV_Pos) /*!< EADC_T::SCTL5: TRGDLYDIV Mask */ + +#define EADC_SCTL5_TRGDLYCNT_Pos (8) /*!< EADC_T::SCTL5: TRGDLYCNT Position */ +#define EADC_SCTL5_TRGDLYCNT_Msk (0xfful << EADC_SCTL5_TRGDLYCNT_Pos) /*!< EADC_T::SCTL5: TRGDLYCNT Mask */ + +#define EADC_SCTL5_TRGSEL_Pos (16) /*!< EADC_T::SCTL5: TRGSEL Position */ +#define EADC_SCTL5_TRGSEL_Msk (0x1ful << EADC_SCTL5_TRGSEL_Pos) /*!< EADC_T::SCTL5: TRGSEL Mask */ + +#define EADC_SCTL5_INTPOS_Pos (22) /*!< EADC_T::SCTL5: INTPOS Position */ +#define EADC_SCTL5_INTPOS_Msk (0x1ul << EADC_SCTL5_INTPOS_Pos) /*!< EADC_T::SCTL5: INTPOS Mask */ + +#define EADC_SCTL5_EXTSMPT_Pos (24) /*!< EADC_T::SCTL5: EXTSMPT Position */ +#define EADC_SCTL5_EXTSMPT_Msk (0xfful << EADC_SCTL5_EXTSMPT_Pos) /*!< EADC_T::SCTL5: EXTSMPT Mask */ + +#define EADC_SCTL6_CHSEL_Pos (0) /*!< EADC_T::SCTL6: CHSEL Position */ +#define EADC_SCTL6_CHSEL_Msk (0xful << EADC_SCTL6_CHSEL_Pos) /*!< EADC_T::SCTL6: CHSEL Mask */ + +#define EADC_SCTL6_EXTREN_Pos (4) /*!< EADC_T::SCTL6: EXTREN Position */ +#define EADC_SCTL6_EXTREN_Msk (0x1ul << EADC_SCTL6_EXTREN_Pos) /*!< EADC_T::SCTL6: EXTREN Mask */ + +#define EADC_SCTL6_EXTFEN_Pos (5) /*!< EADC_T::SCTL6: EXTFEN Position */ +#define EADC_SCTL6_EXTFEN_Msk (0x1ul << EADC_SCTL6_EXTFEN_Pos) /*!< EADC_T::SCTL6: EXTFEN Mask */ + +#define EADC_SCTL6_TRGDLYDIV_Pos (6) /*!< EADC_T::SCTL6: TRGDLYDIV Position */ +#define EADC_SCTL6_TRGDLYDIV_Msk (0x3ul << EADC_SCTL6_TRGDLYDIV_Pos) /*!< EADC_T::SCTL6: TRGDLYDIV Mask */ + +#define EADC_SCTL6_TRGDLYCNT_Pos (8) /*!< EADC_T::SCTL6: TRGDLYCNT Position */ +#define EADC_SCTL6_TRGDLYCNT_Msk (0xfful << EADC_SCTL6_TRGDLYCNT_Pos) /*!< EADC_T::SCTL6: TRGDLYCNT Mask */ + +#define EADC_SCTL6_TRGSEL_Pos (16) /*!< EADC_T::SCTL6: TRGSEL Position */ +#define EADC_SCTL6_TRGSEL_Msk (0x1ful << EADC_SCTL6_TRGSEL_Pos) /*!< EADC_T::SCTL6: TRGSEL Mask */ + +#define EADC_SCTL6_INTPOS_Pos (22) /*!< EADC_T::SCTL6: INTPOS Position */ +#define EADC_SCTL6_INTPOS_Msk (0x1ul << EADC_SCTL6_INTPOS_Pos) /*!< EADC_T::SCTL6: INTPOS Mask */ + +#define EADC_SCTL6_EXTSMPT_Pos (24) /*!< EADC_T::SCTL6: EXTSMPT Position */ +#define EADC_SCTL6_EXTSMPT_Msk (0xfful << EADC_SCTL6_EXTSMPT_Pos) /*!< EADC_T::SCTL6: EXTSMPT Mask */ + +#define EADC_SCTL7_CHSEL_Pos (0) /*!< EADC_T::SCTL7: CHSEL Position */ +#define EADC_SCTL7_CHSEL_Msk (0xful << EADC_SCTL7_CHSEL_Pos) /*!< EADC_T::SCTL7: CHSEL Mask */ + +#define EADC_SCTL7_EXTREN_Pos (4) /*!< EADC_T::SCTL7: EXTREN Position */ +#define EADC_SCTL7_EXTREN_Msk (0x1ul << EADC_SCTL7_EXTREN_Pos) /*!< EADC_T::SCTL7: EXTREN Mask */ + +#define EADC_SCTL7_EXTFEN_Pos (5) /*!< EADC_T::SCTL7: EXTFEN Position */ +#define EADC_SCTL7_EXTFEN_Msk (0x1ul << EADC_SCTL7_EXTFEN_Pos) /*!< EADC_T::SCTL7: EXTFEN Mask */ + +#define EADC_SCTL7_TRGDLYDIV_Pos (6) /*!< EADC_T::SCTL7: TRGDLYDIV Position */ +#define EADC_SCTL7_TRGDLYDIV_Msk (0x3ul << EADC_SCTL7_TRGDLYDIV_Pos) /*!< EADC_T::SCTL7: TRGDLYDIV Mask */ + +#define EADC_SCTL7_TRGDLYCNT_Pos (8) /*!< EADC_T::SCTL7: TRGDLYCNT Position */ +#define EADC_SCTL7_TRGDLYCNT_Msk (0xfful << EADC_SCTL7_TRGDLYCNT_Pos) /*!< EADC_T::SCTL7: TRGDLYCNT Mask */ + +#define EADC_SCTL7_TRGSEL_Pos (16) /*!< EADC_T::SCTL7: TRGSEL Position */ +#define EADC_SCTL7_TRGSEL_Msk (0x1ful << EADC_SCTL7_TRGSEL_Pos) /*!< EADC_T::SCTL7: TRGSEL Mask */ + +#define EADC_SCTL7_INTPOS_Pos (22) /*!< EADC_T::SCTL7: INTPOS Position */ +#define EADC_SCTL7_INTPOS_Msk (0x1ul << EADC_SCTL7_INTPOS_Pos) /*!< EADC_T::SCTL7: INTPOS Mask */ + +#define EADC_SCTL7_EXTSMPT_Pos (24) /*!< EADC_T::SCTL7: EXTSMPT Position */ +#define EADC_SCTL7_EXTSMPT_Msk (0xfful << EADC_SCTL7_EXTSMPT_Pos) /*!< EADC_T::SCTL7: EXTSMPT Mask */ + +#define EADC_SCTL8_CHSEL_Pos (0) /*!< EADC_T::SCTL8: CHSEL Position */ +#define EADC_SCTL8_CHSEL_Msk (0xful << EADC_SCTL8_CHSEL_Pos) /*!< EADC_T::SCTL8: CHSEL Mask */ + +#define EADC_SCTL8_EXTREN_Pos (4) /*!< EADC_T::SCTL8: EXTREN Position */ +#define EADC_SCTL8_EXTREN_Msk (0x1ul << EADC_SCTL8_EXTREN_Pos) /*!< EADC_T::SCTL8: EXTREN Mask */ + +#define EADC_SCTL8_EXTFEN_Pos (5) /*!< EADC_T::SCTL8: EXTFEN Position */ +#define EADC_SCTL8_EXTFEN_Msk (0x1ul << EADC_SCTL8_EXTFEN_Pos) /*!< EADC_T::SCTL8: EXTFEN Mask */ + +#define EADC_SCTL8_TRGDLYDIV_Pos (6) /*!< EADC_T::SCTL8: TRGDLYDIV Position */ +#define EADC_SCTL8_TRGDLYDIV_Msk (0x3ul << EADC_SCTL8_TRGDLYDIV_Pos) /*!< EADC_T::SCTL8: TRGDLYDIV Mask */ + +#define EADC_SCTL8_TRGDLYCNT_Pos (8) /*!< EADC_T::SCTL8: TRGDLYCNT Position */ +#define EADC_SCTL8_TRGDLYCNT_Msk (0xfful << EADC_SCTL8_TRGDLYCNT_Pos) /*!< EADC_T::SCTL8: TRGDLYCNT Mask */ + +#define EADC_SCTL8_TRGSEL_Pos (16) /*!< EADC_T::SCTL8: TRGSEL Position */ +#define EADC_SCTL8_TRGSEL_Msk (0x1ful << EADC_SCTL8_TRGSEL_Pos) /*!< EADC_T::SCTL8: TRGSEL Mask */ + +#define EADC_SCTL8_INTPOS_Pos (22) /*!< EADC_T::SCTL8: INTPOS Position */ +#define EADC_SCTL8_INTPOS_Msk (0x1ul << EADC_SCTL8_INTPOS_Pos) /*!< EADC_T::SCTL8: INTPOS Mask */ + +#define EADC_SCTL8_EXTSMPT_Pos (24) /*!< EADC_T::SCTL8: EXTSMPT Position */ +#define EADC_SCTL8_EXTSMPT_Msk (0xfful << EADC_SCTL8_EXTSMPT_Pos) /*!< EADC_T::SCTL8: EXTSMPT Mask */ + +#define EADC_SCTL9_CHSEL_Pos (0) /*!< EADC_T::SCTL9: CHSEL Position */ +#define EADC_SCTL9_CHSEL_Msk (0xful << EADC_SCTL9_CHSEL_Pos) /*!< EADC_T::SCTL9: CHSEL Mask */ + +#define EADC_SCTL9_EXTREN_Pos (4) /*!< EADC_T::SCTL9: EXTREN Position */ +#define EADC_SCTL9_EXTREN_Msk (0x1ul << EADC_SCTL9_EXTREN_Pos) /*!< EADC_T::SCTL9: EXTREN Mask */ + +#define EADC_SCTL9_EXTFEN_Pos (5) /*!< EADC_T::SCTL9: EXTFEN Position */ +#define EADC_SCTL9_EXTFEN_Msk (0x1ul << EADC_SCTL9_EXTFEN_Pos) /*!< EADC_T::SCTL9: EXTFEN Mask */ + +#define EADC_SCTL9_TRGDLYDIV_Pos (6) /*!< EADC_T::SCTL9: TRGDLYDIV Position */ +#define EADC_SCTL9_TRGDLYDIV_Msk (0x3ul << EADC_SCTL9_TRGDLYDIV_Pos) /*!< EADC_T::SCTL9: TRGDLYDIV Mask */ + +#define EADC_SCTL9_TRGDLYCNT_Pos (8) /*!< EADC_T::SCTL9: TRGDLYCNT Position */ +#define EADC_SCTL9_TRGDLYCNT_Msk (0xfful << EADC_SCTL9_TRGDLYCNT_Pos) /*!< EADC_T::SCTL9: TRGDLYCNT Mask */ + +#define EADC_SCTL9_TRGSEL_Pos (16) /*!< EADC_T::SCTL9: TRGSEL Position */ +#define EADC_SCTL9_TRGSEL_Msk (0x1ful << EADC_SCTL9_TRGSEL_Pos) /*!< EADC_T::SCTL9: TRGSEL Mask */ + +#define EADC_SCTL9_INTPOS_Pos (22) /*!< EADC_T::SCTL9: INTPOS Position */ +#define EADC_SCTL9_INTPOS_Msk (0x1ul << EADC_SCTL9_INTPOS_Pos) /*!< EADC_T::SCTL9: INTPOS Mask */ + +#define EADC_SCTL9_EXTSMPT_Pos (24) /*!< EADC_T::SCTL9: EXTSMPT Position */ +#define EADC_SCTL9_EXTSMPT_Msk (0xfful << EADC_SCTL9_EXTSMPT_Pos) /*!< EADC_T::SCTL9: EXTSMPT Mask */ + +#define EADC_SCTL10_CHSEL_Pos (0) /*!< EADC_T::SCTL10: CHSEL Position */ +#define EADC_SCTL10_CHSEL_Msk (0xful << EADC_SCTL10_CHSEL_Pos) /*!< EADC_T::SCTL10: CHSEL Mask */ + +#define EADC_SCTL10_EXTREN_Pos (4) /*!< EADC_T::SCTL10: EXTREN Position */ +#define EADC_SCTL10_EXTREN_Msk (0x1ul << EADC_SCTL10_EXTREN_Pos) /*!< EADC_T::SCTL10: EXTREN Mask */ + +#define EADC_SCTL10_EXTFEN_Pos (5) /*!< EADC_T::SCTL10: EXTFEN Position */ +#define EADC_SCTL10_EXTFEN_Msk (0x1ul << EADC_SCTL10_EXTFEN_Pos) /*!< EADC_T::SCTL10: EXTFEN Mask */ + +#define EADC_SCTL10_TRGDLYDIV_Pos (6) /*!< EADC_T::SCTL10: TRGDLYDIV Position */ +#define EADC_SCTL10_TRGDLYDIV_Msk (0x3ul << EADC_SCTL10_TRGDLYDIV_Pos) /*!< EADC_T::SCTL10: TRGDLYDIV Mask */ + +#define EADC_SCTL10_TRGDLYCNT_Pos (8) /*!< EADC_T::SCTL10: TRGDLYCNT Position */ +#define EADC_SCTL10_TRGDLYCNT_Msk (0xfful << EADC_SCTL10_TRGDLYCNT_Pos) /*!< EADC_T::SCTL10: TRGDLYCNT Mask */ + +#define EADC_SCTL10_TRGSEL_Pos (16) /*!< EADC_T::SCTL10: TRGSEL Position */ +#define EADC_SCTL10_TRGSEL_Msk (0x1ful << EADC_SCTL10_TRGSEL_Pos) /*!< EADC_T::SCTL10: TRGSEL Mask */ + +#define EADC_SCTL10_INTPOS_Pos (22) /*!< EADC_T::SCTL10: INTPOS Position */ +#define EADC_SCTL10_INTPOS_Msk (0x1ul << EADC_SCTL10_INTPOS_Pos) /*!< EADC_T::SCTL10: INTPOS Mask */ + +#define EADC_SCTL10_EXTSMPT_Pos (24) /*!< EADC_T::SCTL10: EXTSMPT Position */ +#define EADC_SCTL10_EXTSMPT_Msk (0xfful << EADC_SCTL10_EXTSMPT_Pos) /*!< EADC_T::SCTL10: EXTSMPT Mask */ + +#define EADC_SCTL11_CHSEL_Pos (0) /*!< EADC_T::SCTL11: CHSEL Position */ +#define EADC_SCTL11_CHSEL_Msk (0xful << EADC_SCTL11_CHSEL_Pos) /*!< EADC_T::SCTL11: CHSEL Mask */ + +#define EADC_SCTL11_EXTREN_Pos (4) /*!< EADC_T::SCTL11: EXTREN Position */ +#define EADC_SCTL11_EXTREN_Msk (0x1ul << EADC_SCTL11_EXTREN_Pos) /*!< EADC_T::SCTL11: EXTREN Mask */ + +#define EADC_SCTL11_EXTFEN_Pos (5) /*!< EADC_T::SCTL11: EXTFEN Position */ +#define EADC_SCTL11_EXTFEN_Msk (0x1ul << EADC_SCTL11_EXTFEN_Pos) /*!< EADC_T::SCTL11: EXTFEN Mask */ + +#define EADC_SCTL11_TRGDLYDIV_Pos (6) /*!< EADC_T::SCTL11: TRGDLYDIV Position */ +#define EADC_SCTL11_TRGDLYDIV_Msk (0x3ul << EADC_SCTL11_TRGDLYDIV_Pos) /*!< EADC_T::SCTL11: TRGDLYDIV Mask */ + +#define EADC_SCTL11_TRGDLYCNT_Pos (8) /*!< EADC_T::SCTL11: TRGDLYCNT Position */ +#define EADC_SCTL11_TRGDLYCNT_Msk (0xfful << EADC_SCTL11_TRGDLYCNT_Pos) /*!< EADC_T::SCTL11: TRGDLYCNT Mask */ + +#define EADC_SCTL11_TRGSEL_Pos (16) /*!< EADC_T::SCTL11: TRGSEL Position */ +#define EADC_SCTL11_TRGSEL_Msk (0x1ful << EADC_SCTL11_TRGSEL_Pos) /*!< EADC_T::SCTL11: TRGSEL Mask */ + +#define EADC_SCTL11_INTPOS_Pos (22) /*!< EADC_T::SCTL11: INTPOS Position */ +#define EADC_SCTL11_INTPOS_Msk (0x1ul << EADC_SCTL11_INTPOS_Pos) /*!< EADC_T::SCTL11: INTPOS Mask */ + +#define EADC_SCTL11_EXTSMPT_Pos (24) /*!< EADC_T::SCTL11: EXTSMPT Position */ +#define EADC_SCTL11_EXTSMPT_Msk (0xfful << EADC_SCTL11_EXTSMPT_Pos) /*!< EADC_T::SCTL11: EXTSMPT Mask */ + +#define EADC_SCTL12_CHSEL_Pos (0) /*!< EADC_T::SCTL12: CHSEL Position */ +#define EADC_SCTL12_CHSEL_Msk (0xful << EADC_SCTL12_CHSEL_Pos) /*!< EADC_T::SCTL12: CHSEL Mask */ + +#define EADC_SCTL12_EXTREN_Pos (4) /*!< EADC_T::SCTL12: EXTREN Position */ +#define EADC_SCTL12_EXTREN_Msk (0x1ul << EADC_SCTL12_EXTREN_Pos) /*!< EADC_T::SCTL12: EXTREN Mask */ + +#define EADC_SCTL12_EXTFEN_Pos (5) /*!< EADC_T::SCTL12: EXTFEN Position */ +#define EADC_SCTL12_EXTFEN_Msk (0x1ul << EADC_SCTL12_EXTFEN_Pos) /*!< EADC_T::SCTL12: EXTFEN Mask */ + +#define EADC_SCTL12_TRGDLYDIV_Pos (6) /*!< EADC_T::SCTL12: TRGDLYDIV Position */ +#define EADC_SCTL12_TRGDLYDIV_Msk (0x3ul << EADC_SCTL12_TRGDLYDIV_Pos) /*!< EADC_T::SCTL12: TRGDLYDIV Mask */ + +#define EADC_SCTL12_TRGDLYCNT_Pos (8) /*!< EADC_T::SCTL12: TRGDLYCNT Position */ +#define EADC_SCTL12_TRGDLYCNT_Msk (0xfful << EADC_SCTL12_TRGDLYCNT_Pos) /*!< EADC_T::SCTL12: TRGDLYCNT Mask */ + +#define EADC_SCTL12_TRGSEL_Pos (16) /*!< EADC_T::SCTL12: TRGSEL Position */ +#define EADC_SCTL12_TRGSEL_Msk (0x1ful << EADC_SCTL12_TRGSEL_Pos) /*!< EADC_T::SCTL12: TRGSEL Mask */ + +#define EADC_SCTL12_INTPOS_Pos (22) /*!< EADC_T::SCTL12: INTPOS Position */ +#define EADC_SCTL12_INTPOS_Msk (0x1ul << EADC_SCTL12_INTPOS_Pos) /*!< EADC_T::SCTL12: INTPOS Mask */ + +#define EADC_SCTL12_EXTSMPT_Pos (24) /*!< EADC_T::SCTL12: EXTSMPT Position */ +#define EADC_SCTL12_EXTSMPT_Msk (0xfful << EADC_SCTL12_EXTSMPT_Pos) /*!< EADC_T::SCTL12: EXTSMPT Mask */ + +#define EADC_SCTL13_CHSEL_Pos (0) /*!< EADC_T::SCTL13: CHSEL Position */ +#define EADC_SCTL13_CHSEL_Msk (0xful << EADC_SCTL13_CHSEL_Pos) /*!< EADC_T::SCTL13: CHSEL Mask */ + +#define EADC_SCTL13_EXTREN_Pos (4) /*!< EADC_T::SCTL13: EXTREN Position */ +#define EADC_SCTL13_EXTREN_Msk (0x1ul << EADC_SCTL13_EXTREN_Pos) /*!< EADC_T::SCTL13: EXTREN Mask */ + +#define EADC_SCTL13_EXTFEN_Pos (5) /*!< EADC_T::SCTL13: EXTFEN Position */ +#define EADC_SCTL13_EXTFEN_Msk (0x1ul << EADC_SCTL13_EXTFEN_Pos) /*!< EADC_T::SCTL13: EXTFEN Mask */ + +#define EADC_SCTL13_TRGDLYDIV_Pos (6) /*!< EADC_T::SCTL13: TRGDLYDIV Position */ +#define EADC_SCTL13_TRGDLYDIV_Msk (0x3ul << EADC_SCTL13_TRGDLYDIV_Pos) /*!< EADC_T::SCTL13: TRGDLYDIV Mask */ + +#define EADC_SCTL13_TRGDLYCNT_Pos (8) /*!< EADC_T::SCTL13: TRGDLYCNT Position */ +#define EADC_SCTL13_TRGDLYCNT_Msk (0xfful << EADC_SCTL13_TRGDLYCNT_Pos) /*!< EADC_T::SCTL13: TRGDLYCNT Mask */ + +#define EADC_SCTL13_TRGSEL_Pos (16) /*!< EADC_T::SCTL13: TRGSEL Position */ +#define EADC_SCTL13_TRGSEL_Msk (0x1ful << EADC_SCTL13_TRGSEL_Pos) /*!< EADC_T::SCTL13: TRGSEL Mask */ + +#define EADC_SCTL13_INTPOS_Pos (22) /*!< EADC_T::SCTL13: INTPOS Position */ +#define EADC_SCTL13_INTPOS_Msk (0x1ul << EADC_SCTL13_INTPOS_Pos) /*!< EADC_T::SCTL13: INTPOS Mask */ + +#define EADC_SCTL13_EXTSMPT_Pos (24) /*!< EADC_T::SCTL13: EXTSMPT Position */ +#define EADC_SCTL13_EXTSMPT_Msk (0xfful << EADC_SCTL13_EXTSMPT_Pos) /*!< EADC_T::SCTL13: EXTSMPT Mask */ + +#define EADC_SCTL14_CHSEL_Pos (0) /*!< EADC_T::SCTL14: CHSEL Position */ +#define EADC_SCTL14_CHSEL_Msk (0xful << EADC_SCTL14_CHSEL_Pos) /*!< EADC_T::SCTL14: CHSEL Mask */ + +#define EADC_SCTL14_EXTREN_Pos (4) /*!< EADC_T::SCTL14: EXTREN Position */ +#define EADC_SCTL14_EXTREN_Msk (0x1ul << EADC_SCTL14_EXTREN_Pos) /*!< EADC_T::SCTL14: EXTREN Mask */ + +#define EADC_SCTL14_EXTFEN_Pos (5) /*!< EADC_T::SCTL14: EXTFEN Position */ +#define EADC_SCTL14_EXTFEN_Msk (0x1ul << EADC_SCTL14_EXTFEN_Pos) /*!< EADC_T::SCTL14: EXTFEN Mask */ + +#define EADC_SCTL14_TRGDLYDIV_Pos (6) /*!< EADC_T::SCTL14: TRGDLYDIV Position */ +#define EADC_SCTL14_TRGDLYDIV_Msk (0x3ul << EADC_SCTL14_TRGDLYDIV_Pos) /*!< EADC_T::SCTL14: TRGDLYDIV Mask */ + +#define EADC_SCTL14_TRGDLYCNT_Pos (8) /*!< EADC_T::SCTL14: TRGDLYCNT Position */ +#define EADC_SCTL14_TRGDLYCNT_Msk (0xfful << EADC_SCTL14_TRGDLYCNT_Pos) /*!< EADC_T::SCTL14: TRGDLYCNT Mask */ + +#define EADC_SCTL14_TRGSEL_Pos (16) /*!< EADC_T::SCTL14: TRGSEL Position */ +#define EADC_SCTL14_TRGSEL_Msk (0x1ful << EADC_SCTL14_TRGSEL_Pos) /*!< EADC_T::SCTL14: TRGSEL Mask */ + +#define EADC_SCTL14_INTPOS_Pos (22) /*!< EADC_T::SCTL14: INTPOS Position */ +#define EADC_SCTL14_INTPOS_Msk (0x1ul << EADC_SCTL14_INTPOS_Pos) /*!< EADC_T::SCTL14: INTPOS Mask */ + +#define EADC_SCTL14_EXTSMPT_Pos (24) /*!< EADC_T::SCTL14: EXTSMPT Position */ +#define EADC_SCTL14_EXTSMPT_Msk (0xfful << EADC_SCTL14_EXTSMPT_Pos) /*!< EADC_T::SCTL14: EXTSMPT Mask */ + +#define EADC_SCTL15_CHSEL_Pos (0) /*!< EADC_T::SCTL15: CHSEL Position */ +#define EADC_SCTL15_CHSEL_Msk (0xful << EADC_SCTL15_CHSEL_Pos) /*!< EADC_T::SCTL15: CHSEL Mask */ + +#define EADC_SCTL15_EXTREN_Pos (4) /*!< EADC_T::SCTL15: EXTREN Position */ +#define EADC_SCTL15_EXTREN_Msk (0x1ul << EADC_SCTL15_EXTREN_Pos) /*!< EADC_T::SCTL15: EXTREN Mask */ + +#define EADC_SCTL15_EXTFEN_Pos (5) /*!< EADC_T::SCTL15: EXTFEN Position */ +#define EADC_SCTL15_EXTFEN_Msk (0x1ul << EADC_SCTL15_EXTFEN_Pos) /*!< EADC_T::SCTL15: EXTFEN Mask */ + +#define EADC_SCTL15_TRGDLYDIV_Pos (6) /*!< EADC_T::SCTL15: TRGDLYDIV Position */ +#define EADC_SCTL15_TRGDLYDIV_Msk (0x3ul << EADC_SCTL15_TRGDLYDIV_Pos) /*!< EADC_T::SCTL15: TRGDLYDIV Mask */ + +#define EADC_SCTL15_TRGDLYCNT_Pos (8) /*!< EADC_T::SCTL15: TRGDLYCNT Position */ +#define EADC_SCTL15_TRGDLYCNT_Msk (0xfful << EADC_SCTL15_TRGDLYCNT_Pos) /*!< EADC_T::SCTL15: TRGDLYCNT Mask */ + +#define EADC_SCTL15_TRGSEL_Pos (16) /*!< EADC_T::SCTL15: TRGSEL Position */ +#define EADC_SCTL15_TRGSEL_Msk (0x1ful << EADC_SCTL15_TRGSEL_Pos) /*!< EADC_T::SCTL15: TRGSEL Mask */ + +#define EADC_SCTL15_INTPOS_Pos (22) /*!< EADC_T::SCTL15: INTPOS Position */ +#define EADC_SCTL15_INTPOS_Msk (0x1ul << EADC_SCTL15_INTPOS_Pos) /*!< EADC_T::SCTL15: INTPOS Mask */ + +#define EADC_SCTL15_EXTSMPT_Pos (24) /*!< EADC_T::SCTL15: EXTSMPT Position */ +#define EADC_SCTL15_EXTSMPT_Msk (0xfful << EADC_SCTL15_EXTSMPT_Pos) /*!< EADC_T::SCTL15: EXTSMPT Mask */ + +#define EADC_SCTL16_EXTSMPT_Pos (24) /*!< EADC_T::SCTL16: EXTSMPT Position */ +#define EADC_SCTL16_EXTSMPT_Msk (0xfful << EADC_SCTL16_EXTSMPT_Pos) /*!< EADC_T::SCTL16: EXTSMPT Mask */ + +#define EADC_SCTL17_EXTSMPT_Pos (24) /*!< EADC_T::SCTL17: EXTSMPT Position */ +#define EADC_SCTL17_EXTSMPT_Msk (0xfful << EADC_SCTL17_EXTSMPT_Pos) /*!< EADC_T::SCTL17: EXTSMPT Mask */ + +#define EADC_SCTL18_EXTSMPT_Pos (24) /*!< EADC_T::SCTL18: EXTSMPT Position */ +#define EADC_SCTL18_EXTSMPT_Msk (0xfful << EADC_SCTL18_EXTSMPT_Pos) /*!< EADC_T::SCTL18: EXTSMPT Mask */ + +#define EADC_INTSRC0_SPLIE0_Pos (0) /*!< EADC_T::INTSRC0: SPLIE0 Position */ +#define EADC_INTSRC0_SPLIE0_Msk (0x1ul << EADC_INTSRC0_SPLIE0_Pos) /*!< EADC_T::INTSRC0: SPLIE0 Mask */ + +#define EADC_INTSRC0_SPLIE1_Pos (1) /*!< EADC_T::INTSRC0: SPLIE1 Position */ +#define EADC_INTSRC0_SPLIE1_Msk (0x1ul << EADC_INTSRC0_SPLIE1_Pos) /*!< EADC_T::INTSRC0: SPLIE1 Mask */ + +#define EADC_INTSRC0_SPLIE2_Pos (2) /*!< EADC_T::INTSRC0: SPLIE2 Position */ +#define EADC_INTSRC0_SPLIE2_Msk (0x1ul << EADC_INTSRC0_SPLIE2_Pos) /*!< EADC_T::INTSRC0: SPLIE2 Mask */ + +#define EADC_INTSRC0_SPLIE3_Pos (3) /*!< EADC_T::INTSRC0: SPLIE3 Position */ +#define EADC_INTSRC0_SPLIE3_Msk (0x1ul << EADC_INTSRC0_SPLIE3_Pos) /*!< EADC_T::INTSRC0: SPLIE3 Mask */ + +#define EADC_INTSRC0_SPLIE4_Pos (4) /*!< EADC_T::INTSRC0: SPLIE4 Position */ +#define EADC_INTSRC0_SPLIE4_Msk (0x1ul << EADC_INTSRC0_SPLIE4_Pos) /*!< EADC_T::INTSRC0: SPLIE4 Mask */ + +#define EADC_INTSRC0_SPLIE5_Pos (5) /*!< EADC_T::INTSRC0: SPLIE5 Position */ +#define EADC_INTSRC0_SPLIE5_Msk (0x1ul << EADC_INTSRC0_SPLIE5_Pos) /*!< EADC_T::INTSRC0: SPLIE5 Mask */ + +#define EADC_INTSRC0_SPLIE6_Pos (6) /*!< EADC_T::INTSRC0: SPLIE6 Position */ +#define EADC_INTSRC0_SPLIE6_Msk (0x1ul << EADC_INTSRC0_SPLIE6_Pos) /*!< EADC_T::INTSRC0: SPLIE6 Mask */ + +#define EADC_INTSRC0_SPLIE7_Pos (7) /*!< EADC_T::INTSRC0: SPLIE7 Position */ +#define EADC_INTSRC0_SPLIE7_Msk (0x1ul << EADC_INTSRC0_SPLIE7_Pos) /*!< EADC_T::INTSRC0: SPLIE7 Mask */ + +#define EADC_INTSRC0_SPLIE8_Pos (8) /*!< EADC_T::INTSRC0: SPLIE8 Position */ +#define EADC_INTSRC0_SPLIE8_Msk (0x1ul << EADC_INTSRC0_SPLIE8_Pos) /*!< EADC_T::INTSRC0: SPLIE8 Mask */ + +#define EADC_INTSRC0_SPLIE9_Pos (9) /*!< EADC_T::INTSRC0: SPLIE9 Position */ +#define EADC_INTSRC0_SPLIE9_Msk (0x1ul << EADC_INTSRC0_SPLIE9_Pos) /*!< EADC_T::INTSRC0: SPLIE9 Mask */ + +#define EADC_INTSRC0_SPLIE10_Pos (10) /*!< EADC_T::INTSRC0: SPLIE10 Position */ +#define EADC_INTSRC0_SPLIE10_Msk (0x1ul << EADC_INTSRC0_SPLIE10_Pos) /*!< EADC_T::INTSRC0: SPLIE10 Mask */ + +#define EADC_INTSRC0_SPLIE11_Pos (11) /*!< EADC_T::INTSRC0: SPLIE11 Position */ +#define EADC_INTSRC0_SPLIE11_Msk (0x1ul << EADC_INTSRC0_SPLIE11_Pos) /*!< EADC_T::INTSRC0: SPLIE11 Mask */ + +#define EADC_INTSRC0_SPLIE12_Pos (12) /*!< EADC_T::INTSRC0: SPLIE12 Position */ +#define EADC_INTSRC0_SPLIE12_Msk (0x1ul << EADC_INTSRC0_SPLIE12_Pos) /*!< EADC_T::INTSRC0: SPLIE12 Mask */ + +#define EADC_INTSRC0_SPLIE13_Pos (13) /*!< EADC_T::INTSRC0: SPLIE13 Position */ +#define EADC_INTSRC0_SPLIE13_Msk (0x1ul << EADC_INTSRC0_SPLIE13_Pos) /*!< EADC_T::INTSRC0: SPLIE13 Mask */ + +#define EADC_INTSRC0_SPLIE14_Pos (14) /*!< EADC_T::INTSRC0: SPLIE14 Position */ +#define EADC_INTSRC0_SPLIE14_Msk (0x1ul << EADC_INTSRC0_SPLIE14_Pos) /*!< EADC_T::INTSRC0: SPLIE14 Mask */ + +#define EADC_INTSRC0_SPLIE15_Pos (15) /*!< EADC_T::INTSRC0: SPLIE15 Position */ +#define EADC_INTSRC0_SPLIE15_Msk (0x1ul << EADC_INTSRC0_SPLIE15_Pos) /*!< EADC_T::INTSRC0: SPLIE15 Mask */ + +#define EADC_INTSRC0_SPLIE16_Pos (16) /*!< EADC_T::INTSRC0: SPLIE16 Position */ +#define EADC_INTSRC0_SPLIE16_Msk (0x1ul << EADC_INTSRC0_SPLIE16_Pos) /*!< EADC_T::INTSRC0: SPLIE16 Mask */ + +#define EADC_INTSRC0_SPLIE17_Pos (17) /*!< EADC_T::INTSRC0: SPLIE17 Position */ +#define EADC_INTSRC0_SPLIE17_Msk (0x1ul << EADC_INTSRC0_SPLIE17_Pos) /*!< EADC_T::INTSRC0: SPLIE17 Mask */ + +#define EADC_INTSRC0_SPLIE18_Pos (18) /*!< EADC_T::INTSRC0: SPLIE18 Position */ +#define EADC_INTSRC0_SPLIE18_Msk (0x1ul << EADC_INTSRC0_SPLIE18_Pos) /*!< EADC_T::INTSRC0: SPLIE18 Mask */ + +#define EADC_INTSRC1_SPLIE0_Pos (0) /*!< EADC_T::INTSRC1: SPLIE0 Position */ +#define EADC_INTSRC1_SPLIE0_Msk (0x1ul << EADC_INTSRC1_SPLIE0_Pos) /*!< EADC_T::INTSRC1: SPLIE0 Mask */ + +#define EADC_INTSRC1_SPLIE1_Pos (1) /*!< EADC_T::INTSRC1: SPLIE1 Position */ +#define EADC_INTSRC1_SPLIE1_Msk (0x1ul << EADC_INTSRC1_SPLIE1_Pos) /*!< EADC_T::INTSRC1: SPLIE1 Mask */ + +#define EADC_INTSRC1_SPLIE2_Pos (2) /*!< EADC_T::INTSRC1: SPLIE2 Position */ +#define EADC_INTSRC1_SPLIE2_Msk (0x1ul << EADC_INTSRC1_SPLIE2_Pos) /*!< EADC_T::INTSRC1: SPLIE2 Mask */ + +#define EADC_INTSRC1_SPLIE3_Pos (3) /*!< EADC_T::INTSRC1: SPLIE3 Position */ +#define EADC_INTSRC1_SPLIE3_Msk (0x1ul << EADC_INTSRC1_SPLIE3_Pos) /*!< EADC_T::INTSRC1: SPLIE3 Mask */ + +#define EADC_INTSRC1_SPLIE4_Pos (4) /*!< EADC_T::INTSRC1: SPLIE4 Position */ +#define EADC_INTSRC1_SPLIE4_Msk (0x1ul << EADC_INTSRC1_SPLIE4_Pos) /*!< EADC_T::INTSRC1: SPLIE4 Mask */ + +#define EADC_INTSRC1_SPLIE5_Pos (5) /*!< EADC_T::INTSRC1: SPLIE5 Position */ +#define EADC_INTSRC1_SPLIE5_Msk (0x1ul << EADC_INTSRC1_SPLIE5_Pos) /*!< EADC_T::INTSRC1: SPLIE5 Mask */ + +#define EADC_INTSRC1_SPLIE6_Pos (6) /*!< EADC_T::INTSRC1: SPLIE6 Position */ +#define EADC_INTSRC1_SPLIE6_Msk (0x1ul << EADC_INTSRC1_SPLIE6_Pos) /*!< EADC_T::INTSRC1: SPLIE6 Mask */ + +#define EADC_INTSRC1_SPLIE7_Pos (7) /*!< EADC_T::INTSRC1: SPLIE7 Position */ +#define EADC_INTSRC1_SPLIE7_Msk (0x1ul << EADC_INTSRC1_SPLIE7_Pos) /*!< EADC_T::INTSRC1: SPLIE7 Mask */ + +#define EADC_INTSRC1_SPLIE8_Pos (8) /*!< EADC_T::INTSRC1: SPLIE8 Position */ +#define EADC_INTSRC1_SPLIE8_Msk (0x1ul << EADC_INTSRC1_SPLIE8_Pos) /*!< EADC_T::INTSRC1: SPLIE8 Mask */ + +#define EADC_INTSRC1_SPLIE9_Pos (9) /*!< EADC_T::INTSRC1: SPLIE9 Position */ +#define EADC_INTSRC1_SPLIE9_Msk (0x1ul << EADC_INTSRC1_SPLIE9_Pos) /*!< EADC_T::INTSRC1: SPLIE9 Mask */ + +#define EADC_INTSRC1_SPLIE10_Pos (10) /*!< EADC_T::INTSRC1: SPLIE10 Position */ +#define EADC_INTSRC1_SPLIE10_Msk (0x1ul << EADC_INTSRC1_SPLIE10_Pos) /*!< EADC_T::INTSRC1: SPLIE10 Mask */ + +#define EADC_INTSRC1_SPLIE11_Pos (11) /*!< EADC_T::INTSRC1: SPLIE11 Position */ +#define EADC_INTSRC1_SPLIE11_Msk (0x1ul << EADC_INTSRC1_SPLIE11_Pos) /*!< EADC_T::INTSRC1: SPLIE11 Mask */ + +#define EADC_INTSRC1_SPLIE12_Pos (12) /*!< EADC_T::INTSRC1: SPLIE12 Position */ +#define EADC_INTSRC1_SPLIE12_Msk (0x1ul << EADC_INTSRC1_SPLIE12_Pos) /*!< EADC_T::INTSRC1: SPLIE12 Mask */ + +#define EADC_INTSRC1_SPLIE13_Pos (13) /*!< EADC_T::INTSRC1: SPLIE13 Position */ +#define EADC_INTSRC1_SPLIE13_Msk (0x1ul << EADC_INTSRC1_SPLIE13_Pos) /*!< EADC_T::INTSRC1: SPLIE13 Mask */ + +#define EADC_INTSRC1_SPLIE14_Pos (14) /*!< EADC_T::INTSRC1: SPLIE14 Position */ +#define EADC_INTSRC1_SPLIE14_Msk (0x1ul << EADC_INTSRC1_SPLIE14_Pos) /*!< EADC_T::INTSRC1: SPLIE14 Mask */ + +#define EADC_INTSRC1_SPLIE15_Pos (15) /*!< EADC_T::INTSRC1: SPLIE15 Position */ +#define EADC_INTSRC1_SPLIE15_Msk (0x1ul << EADC_INTSRC1_SPLIE15_Pos) /*!< EADC_T::INTSRC1: SPLIE15 Mask */ + +#define EADC_INTSRC1_SPLIE16_Pos (16) /*!< EADC_T::INTSRC1: SPLIE16 Position */ +#define EADC_INTSRC1_SPLIE16_Msk (0x1ul << EADC_INTSRC1_SPLIE16_Pos) /*!< EADC_T::INTSRC1: SPLIE16 Mask */ + +#define EADC_INTSRC1_SPLIE17_Pos (17) /*!< EADC_T::INTSRC1: SPLIE17 Position */ +#define EADC_INTSRC1_SPLIE17_Msk (0x1ul << EADC_INTSRC1_SPLIE17_Pos) /*!< EADC_T::INTSRC1: SPLIE17 Mask */ + +#define EADC_INTSRC1_SPLIE18_Pos (18) /*!< EADC_T::INTSRC1: SPLIE18 Position */ +#define EADC_INTSRC1_SPLIE18_Msk (0x1ul << EADC_INTSRC1_SPLIE18_Pos) /*!< EADC_T::INTSRC1: SPLIE18 Mask */ + +#define EADC_INTSRC2_SPLIE0_Pos (0) /*!< EADC_T::INTSRC2: SPLIE0 Position */ +#define EADC_INTSRC2_SPLIE0_Msk (0x1ul << EADC_INTSRC2_SPLIE0_Pos) /*!< EADC_T::INTSRC2: SPLIE0 Mask */ + +#define EADC_INTSRC2_SPLIE1_Pos (1) /*!< EADC_T::INTSRC2: SPLIE1 Position */ +#define EADC_INTSRC2_SPLIE1_Msk (0x1ul << EADC_INTSRC2_SPLIE1_Pos) /*!< EADC_T::INTSRC2: SPLIE1 Mask */ + +#define EADC_INTSRC2_SPLIE2_Pos (2) /*!< EADC_T::INTSRC2: SPLIE2 Position */ +#define EADC_INTSRC2_SPLIE2_Msk (0x1ul << EADC_INTSRC2_SPLIE2_Pos) /*!< EADC_T::INTSRC2: SPLIE2 Mask */ + +#define EADC_INTSRC2_SPLIE3_Pos (3) /*!< EADC_T::INTSRC2: SPLIE3 Position */ +#define EADC_INTSRC2_SPLIE3_Msk (0x1ul << EADC_INTSRC2_SPLIE3_Pos) /*!< EADC_T::INTSRC2: SPLIE3 Mask */ + +#define EADC_INTSRC2_SPLIE4_Pos (4) /*!< EADC_T::INTSRC2: SPLIE4 Position */ +#define EADC_INTSRC2_SPLIE4_Msk (0x1ul << EADC_INTSRC2_SPLIE4_Pos) /*!< EADC_T::INTSRC2: SPLIE4 Mask */ + +#define EADC_INTSRC2_SPLIE5_Pos (5) /*!< EADC_T::INTSRC2: SPLIE5 Position */ +#define EADC_INTSRC2_SPLIE5_Msk (0x1ul << EADC_INTSRC2_SPLIE5_Pos) /*!< EADC_T::INTSRC2: SPLIE5 Mask */ + +#define EADC_INTSRC2_SPLIE6_Pos (6) /*!< EADC_T::INTSRC2: SPLIE6 Position */ +#define EADC_INTSRC2_SPLIE6_Msk (0x1ul << EADC_INTSRC2_SPLIE6_Pos) /*!< EADC_T::INTSRC2: SPLIE6 Mask */ + +#define EADC_INTSRC2_SPLIE7_Pos (7) /*!< EADC_T::INTSRC2: SPLIE7 Position */ +#define EADC_INTSRC2_SPLIE7_Msk (0x1ul << EADC_INTSRC2_SPLIE7_Pos) /*!< EADC_T::INTSRC2: SPLIE7 Mask */ + +#define EADC_INTSRC2_SPLIE8_Pos (8) /*!< EADC_T::INTSRC2: SPLIE8 Position */ +#define EADC_INTSRC2_SPLIE8_Msk (0x1ul << EADC_INTSRC2_SPLIE8_Pos) /*!< EADC_T::INTSRC2: SPLIE8 Mask */ + +#define EADC_INTSRC2_SPLIE9_Pos (9) /*!< EADC_T::INTSRC2: SPLIE9 Position */ +#define EADC_INTSRC2_SPLIE9_Msk (0x1ul << EADC_INTSRC2_SPLIE9_Pos) /*!< EADC_T::INTSRC2: SPLIE9 Mask */ + +#define EADC_INTSRC2_SPLIE10_Pos (10) /*!< EADC_T::INTSRC2: SPLIE10 Position */ +#define EADC_INTSRC2_SPLIE10_Msk (0x1ul << EADC_INTSRC2_SPLIE10_Pos) /*!< EADC_T::INTSRC2: SPLIE10 Mask */ + +#define EADC_INTSRC2_SPLIE11_Pos (11) /*!< EADC_T::INTSRC2: SPLIE11 Position */ +#define EADC_INTSRC2_SPLIE11_Msk (0x1ul << EADC_INTSRC2_SPLIE11_Pos) /*!< EADC_T::INTSRC2: SPLIE11 Mask */ + +#define EADC_INTSRC2_SPLIE12_Pos (12) /*!< EADC_T::INTSRC2: SPLIE12 Position */ +#define EADC_INTSRC2_SPLIE12_Msk (0x1ul << EADC_INTSRC2_SPLIE12_Pos) /*!< EADC_T::INTSRC2: SPLIE12 Mask */ + +#define EADC_INTSRC2_SPLIE13_Pos (13) /*!< EADC_T::INTSRC2: SPLIE13 Position */ +#define EADC_INTSRC2_SPLIE13_Msk (0x1ul << EADC_INTSRC2_SPLIE13_Pos) /*!< EADC_T::INTSRC2: SPLIE13 Mask */ + +#define EADC_INTSRC2_SPLIE14_Pos (14) /*!< EADC_T::INTSRC2: SPLIE14 Position */ +#define EADC_INTSRC2_SPLIE14_Msk (0x1ul << EADC_INTSRC2_SPLIE14_Pos) /*!< EADC_T::INTSRC2: SPLIE14 Mask */ + +#define EADC_INTSRC2_SPLIE15_Pos (15) /*!< EADC_T::INTSRC2: SPLIE15 Position */ +#define EADC_INTSRC2_SPLIE15_Msk (0x1ul << EADC_INTSRC2_SPLIE15_Pos) /*!< EADC_T::INTSRC2: SPLIE15 Mask */ + +#define EADC_INTSRC2_SPLIE16_Pos (16) /*!< EADC_T::INTSRC2: SPLIE16 Position */ +#define EADC_INTSRC2_SPLIE16_Msk (0x1ul << EADC_INTSRC2_SPLIE16_Pos) /*!< EADC_T::INTSRC2: SPLIE16 Mask */ + +#define EADC_INTSRC2_SPLIE17_Pos (17) /*!< EADC_T::INTSRC2: SPLIE17 Position */ +#define EADC_INTSRC2_SPLIE17_Msk (0x1ul << EADC_INTSRC2_SPLIE17_Pos) /*!< EADC_T::INTSRC2: SPLIE17 Mask */ + +#define EADC_INTSRC2_SPLIE18_Pos (18) /*!< EADC_T::INTSRC2: SPLIE18 Position */ +#define EADC_INTSRC2_SPLIE18_Msk (0x1ul << EADC_INTSRC2_SPLIE18_Pos) /*!< EADC_T::INTSRC2: SPLIE18 Mask */ + +#define EADC_INTSRC3_SPLIE0_Pos (0) /*!< EADC_T::INTSRC3: SPLIE0 Position */ +#define EADC_INTSRC3_SPLIE0_Msk (0x1ul << EADC_INTSRC3_SPLIE0_Pos) /*!< EADC_T::INTSRC3: SPLIE0 Mask */ + +#define EADC_INTSRC3_SPLIE1_Pos (1) /*!< EADC_T::INTSRC3: SPLIE1 Position */ +#define EADC_INTSRC3_SPLIE1_Msk (0x1ul << EADC_INTSRC3_SPLIE1_Pos) /*!< EADC_T::INTSRC3: SPLIE1 Mask */ + +#define EADC_INTSRC3_SPLIE2_Pos (2) /*!< EADC_T::INTSRC3: SPLIE2 Position */ +#define EADC_INTSRC3_SPLIE2_Msk (0x1ul << EADC_INTSRC3_SPLIE2_Pos) /*!< EADC_T::INTSRC3: SPLIE2 Mask */ + +#define EADC_INTSRC3_SPLIE3_Pos (3) /*!< EADC_T::INTSRC3: SPLIE3 Position */ +#define EADC_INTSRC3_SPLIE3_Msk (0x1ul << EADC_INTSRC3_SPLIE3_Pos) /*!< EADC_T::INTSRC3: SPLIE3 Mask */ + +#define EADC_INTSRC3_SPLIE4_Pos (4) /*!< EADC_T::INTSRC3: SPLIE4 Position */ +#define EADC_INTSRC3_SPLIE4_Msk (0x1ul << EADC_INTSRC3_SPLIE4_Pos) /*!< EADC_T::INTSRC3: SPLIE4 Mask */ + +#define EADC_INTSRC3_SPLIE5_Pos (5) /*!< EADC_T::INTSRC3: SPLIE5 Position */ +#define EADC_INTSRC3_SPLIE5_Msk (0x1ul << EADC_INTSRC3_SPLIE5_Pos) /*!< EADC_T::INTSRC3: SPLIE5 Mask */ + +#define EADC_INTSRC3_SPLIE6_Pos (6) /*!< EADC_T::INTSRC3: SPLIE6 Position */ +#define EADC_INTSRC3_SPLIE6_Msk (0x1ul << EADC_INTSRC3_SPLIE6_Pos) /*!< EADC_T::INTSRC3: SPLIE6 Mask */ + +#define EADC_INTSRC3_SPLIE7_Pos (7) /*!< EADC_T::INTSRC3: SPLIE7 Position */ +#define EADC_INTSRC3_SPLIE7_Msk (0x1ul << EADC_INTSRC3_SPLIE7_Pos) /*!< EADC_T::INTSRC3: SPLIE7 Mask */ + +#define EADC_INTSRC3_SPLIE8_Pos (8) /*!< EADC_T::INTSRC3: SPLIE8 Position */ +#define EADC_INTSRC3_SPLIE8_Msk (0x1ul << EADC_INTSRC3_SPLIE8_Pos) /*!< EADC_T::INTSRC3: SPLIE8 Mask */ + +#define EADC_INTSRC3_SPLIE9_Pos (9) /*!< EADC_T::INTSRC3: SPLIE9 Position */ +#define EADC_INTSRC3_SPLIE9_Msk (0x1ul << EADC_INTSRC3_SPLIE9_Pos) /*!< EADC_T::INTSRC3: SPLIE9 Mask */ + +#define EADC_INTSRC3_SPLIE10_Pos (10) /*!< EADC_T::INTSRC3: SPLIE10 Position */ +#define EADC_INTSRC3_SPLIE10_Msk (0x1ul << EADC_INTSRC3_SPLIE10_Pos) /*!< EADC_T::INTSRC3: SPLIE10 Mask */ + +#define EADC_INTSRC3_SPLIE11_Pos (11) /*!< EADC_T::INTSRC3: SPLIE11 Position */ +#define EADC_INTSRC3_SPLIE11_Msk (0x1ul << EADC_INTSRC3_SPLIE11_Pos) /*!< EADC_T::INTSRC3: SPLIE11 Mask */ + +#define EADC_INTSRC3_SPLIE12_Pos (12) /*!< EADC_T::INTSRC3: SPLIE12 Position */ +#define EADC_INTSRC3_SPLIE12_Msk (0x1ul << EADC_INTSRC3_SPLIE12_Pos) /*!< EADC_T::INTSRC3: SPLIE12 Mask */ + +#define EADC_INTSRC3_SPLIE13_Pos (13) /*!< EADC_T::INTSRC3: SPLIE13 Position */ +#define EADC_INTSRC3_SPLIE13_Msk (0x1ul << EADC_INTSRC3_SPLIE13_Pos) /*!< EADC_T::INTSRC3: SPLIE13 Mask */ + +#define EADC_INTSRC3_SPLIE14_Pos (14) /*!< EADC_T::INTSRC3: SPLIE14 Position */ +#define EADC_INTSRC3_SPLIE14_Msk (0x1ul << EADC_INTSRC3_SPLIE14_Pos) /*!< EADC_T::INTSRC3: SPLIE14 Mask */ + +#define EADC_INTSRC3_SPLIE15_Pos (15) /*!< EADC_T::INTSRC3: SPLIE15 Position */ +#define EADC_INTSRC3_SPLIE15_Msk (0x1ul << EADC_INTSRC3_SPLIE15_Pos) /*!< EADC_T::INTSRC3: SPLIE15 Mask */ + +#define EADC_INTSRC3_SPLIE16_Pos (16) /*!< EADC_T::INTSRC3: SPLIE16 Position */ +#define EADC_INTSRC3_SPLIE16_Msk (0x1ul << EADC_INTSRC3_SPLIE16_Pos) /*!< EADC_T::INTSRC3: SPLIE16 Mask */ + +#define EADC_INTSRC3_SPLIE17_Pos (17) /*!< EADC_T::INTSRC3: SPLIE17 Position */ +#define EADC_INTSRC3_SPLIE17_Msk (0x1ul << EADC_INTSRC3_SPLIE17_Pos) /*!< EADC_T::INTSRC3: SPLIE17 Mask */ + +#define EADC_INTSRC3_SPLIE18_Pos (18) /*!< EADC_T::INTSRC3: SPLIE18 Position */ +#define EADC_INTSRC3_SPLIE18_Msk (0x1ul << EADC_INTSRC3_SPLIE18_Pos) /*!< EADC_T::INTSRC3: SPLIE18 Mask */ + +#define EADC_CMP_ADCMPEN_Pos (0) /*!< EADC_T::CMP: ADCMPEN Position */ +#define EADC_CMP_ADCMPEN_Msk (0x1ul << EADC_CMP_ADCMPEN_Pos) /*!< EADC_T::CMP: ADCMPEN Mask */ + +#define EADC_CMP_ADCMPIE_Pos (1) /*!< EADC_T::CMP: ADCMPIE Position */ +#define EADC_CMP_ADCMPIE_Msk (0x1ul << EADC_CMP_ADCMPIE_Pos) /*!< EADC_T::CMP: ADCMPIE Mask */ + +#define EADC_CMP_CMPCOND_Pos (2) /*!< EADC_T::CMP: CMPCOND Position */ +#define EADC_CMP_CMPCOND_Msk (0x1ul << EADC_CMP_CMPCOND_Pos) /*!< EADC_T::CMP: CMPCOND Mask */ + +#define EADC_CMP_CMPSPL_Pos (3) /*!< EADC_T::CMP: CMPSPL Position */ +#define EADC_CMP_CMPSPL_Msk (0x1ful << EADC_CMP_CMPSPL_Pos) /*!< EADC_T::CMP: CMPSPL Mask */ + +#define EADC_CMP_CMPMCNT_Pos (8) /*!< EADC_T::CMP: CMPMCNT Position */ +#define EADC_CMP_CMPMCNT_Msk (0xful << EADC_CMP_CMPMCNT_Pos) /*!< EADC_T::CMP: CMPMCNT Mask */ + +#define EADC_CMP_CMPWEN_Pos (15) /*!< EADC_T::CMP: CMPWEN Position */ +#define EADC_CMP_CMPWEN_Msk (0x1ul << EADC_CMP_CMPWEN_Pos) /*!< EADC_T::CMP: CMPWEN Mask */ + +#define EADC_CMP_CMPDAT_Pos (16) /*!< EADC_T::CMP: CMPDAT Position */ +#define EADC_CMP_CMPDAT_Msk (0xffful << EADC_CMP_CMPDAT_Pos) /*!< EADC_T::CMP: CMPDAT Mask */ + +#define EADC_CMP0_ADCMPEN_Pos (0) /*!< EADC_T::CMP0: ADCMPEN Position */ +#define EADC_CMP0_ADCMPEN_Msk (0x1ul << EADC_CMP0_ADCMPEN_Pos) /*!< EADC_T::CMP0: ADCMPEN Mask */ + +#define EADC_CMP0_ADCMPIE_Pos (1) /*!< EADC_T::CMP0: ADCMPIE Position */ +#define EADC_CMP0_ADCMPIE_Msk (0x1ul << EADC_CMP0_ADCMPIE_Pos) /*!< EADC_T::CMP0: ADCMPIE Mask */ + +#define EADC_CMP0_CMPCOND_Pos (2) /*!< EADC_T::CMP0: CMPCOND Position */ +#define EADC_CMP0_CMPCOND_Msk (0x1ul << EADC_CMP0_CMPCOND_Pos) /*!< EADC_T::CMP0: CMPCOND Mask */ + +#define EADC_CMP0_CMPSPL_Pos (3) /*!< EADC_T::CMP0: CMPSPL Position */ +#define EADC_CMP0_CMPSPL_Msk (0x1ful << EADC_CMP0_CMPSPL_Pos) /*!< EADC_T::CMP0: CMPSPL Mask */ + +#define EADC_CMP0_CMPMCNT_Pos (8) /*!< EADC_T::CMP0: CMPMCNT Position */ +#define EADC_CMP0_CMPMCNT_Msk (0xful << EADC_CMP0_CMPMCNT_Pos) /*!< EADC_T::CMP0: CMPMCNT Mask */ + +#define EADC_CMP0_CMPWEN_Pos (15) /*!< EADC_T::CMP0: CMPWEN Position */ +#define EADC_CMP0_CMPWEN_Msk (0x1ul << EADC_CMP0_CMPWEN_Pos) /*!< EADC_T::CMP0: CMPWEN Mask */ + +#define EADC_CMP0_CMPDAT_Pos (16) /*!< EADC_T::CMP0: CMPDAT Position */ +#define EADC_CMP0_CMPDAT_Msk (0xffful << EADC_CMP0_CMPDAT_Pos) /*!< EADC_T::CMP0: CMPDAT Mask */ + +#define EADC_CMP1_ADCMPEN_Pos (0) /*!< EADC_T::CMP1: ADCMPEN Position */ +#define EADC_CMP1_ADCMPEN_Msk (0x1ul << EADC_CMP1_ADCMPEN_Pos) /*!< EADC_T::CMP1: ADCMPEN Mask */ + +#define EADC_CMP1_ADCMPIE_Pos (1) /*!< EADC_T::CMP1: ADCMPIE Position */ +#define EADC_CMP1_ADCMPIE_Msk (0x1ul << EADC_CMP1_ADCMPIE_Pos) /*!< EADC_T::CMP1: ADCMPIE Mask */ + +#define EADC_CMP1_CMPCOND_Pos (2) /*!< EADC_T::CMP1: CMPCOND Position */ +#define EADC_CMP1_CMPCOND_Msk (0x1ul << EADC_CMP1_CMPCOND_Pos) /*!< EADC_T::CMP1: CMPCOND Mask */ + +#define EADC_CMP1_CMPSPL_Pos (3) /*!< EADC_T::CMP1: CMPSPL Position */ +#define EADC_CMP1_CMPSPL_Msk (0x1ful << EADC_CMP1_CMPSPL_Pos) /*!< EADC_T::CMP1: CMPSPL Mask */ + +#define EADC_CMP1_CMPMCNT_Pos (8) /*!< EADC_T::CMP1: CMPMCNT Position */ +#define EADC_CMP1_CMPMCNT_Msk (0xful << EADC_CMP1_CMPMCNT_Pos) /*!< EADC_T::CMP1: CMPMCNT Mask */ + +#define EADC_CMP1_CMPWEN_Pos (15) /*!< EADC_T::CMP1: CMPWEN Position */ +#define EADC_CMP1_CMPWEN_Msk (0x1ul << EADC_CMP1_CMPWEN_Pos) /*!< EADC_T::CMP1: CMPWEN Mask */ + +#define EADC_CMP1_CMPDAT_Pos (16) /*!< EADC_T::CMP1: CMPDAT Position */ +#define EADC_CMP1_CMPDAT_Msk (0xffful << EADC_CMP1_CMPDAT_Pos) /*!< EADC_T::CMP1: CMPDAT Mask */ + +#define EADC_CMP2_ADCMPEN_Pos (0) /*!< EADC_T::CMP2: ADCMPEN Position */ +#define EADC_CMP2_ADCMPEN_Msk (0x1ul << EADC_CMP2_ADCMPEN_Pos) /*!< EADC_T::CMP2: ADCMPEN Mask */ + +#define EADC_CMP2_ADCMPIE_Pos (1) /*!< EADC_T::CMP2: ADCMPIE Position */ +#define EADC_CMP2_ADCMPIE_Msk (0x1ul << EADC_CMP2_ADCMPIE_Pos) /*!< EADC_T::CMP2: ADCMPIE Mask */ + +#define EADC_CMP2_CMPCOND_Pos (2) /*!< EADC_T::CMP2: CMPCOND Position */ +#define EADC_CMP2_CMPCOND_Msk (0x1ul << EADC_CMP2_CMPCOND_Pos) /*!< EADC_T::CMP2: CMPCOND Mask */ + +#define EADC_CMP2_CMPSPL_Pos (3) /*!< EADC_T::CMP2: CMPSPL Position */ +#define EADC_CMP2_CMPSPL_Msk (0x1ful << EADC_CMP2_CMPSPL_Pos) /*!< EADC_T::CMP2: CMPSPL Mask */ + +#define EADC_CMP2_CMPMCNT_Pos (8) /*!< EADC_T::CMP2: CMPMCNT Position */ +#define EADC_CMP2_CMPMCNT_Msk (0xful << EADC_CMP2_CMPMCNT_Pos) /*!< EADC_T::CMP2: CMPMCNT Mask */ + +#define EADC_CMP2_CMPWEN_Pos (15) /*!< EADC_T::CMP2: CMPWEN Position */ +#define EADC_CMP2_CMPWEN_Msk (0x1ul << EADC_CMP2_CMPWEN_Pos) /*!< EADC_T::CMP2: CMPWEN Mask */ + +#define EADC_CMP2_CMPDAT_Pos (16) /*!< EADC_T::CMP2: CMPDAT Position */ +#define EADC_CMP2_CMPDAT_Msk (0xffful << EADC_CMP2_CMPDAT_Pos) /*!< EADC_T::CMP2: CMPDAT Mask */ + +#define EADC_CMP3_ADCMPEN_Pos (0) /*!< EADC_T::CMP3: ADCMPEN Position */ +#define EADC_CMP3_ADCMPEN_Msk (0x1ul << EADC_CMP3_ADCMPEN_Pos) /*!< EADC_T::CMP3: ADCMPEN Mask */ + +#define EADC_CMP3_ADCMPIE_Pos (1) /*!< EADC_T::CMP3: ADCMPIE Position */ +#define EADC_CMP3_ADCMPIE_Msk (0x1ul << EADC_CMP3_ADCMPIE_Pos) /*!< EADC_T::CMP3: ADCMPIE Mask */ + +#define EADC_CMP3_CMPCOND_Pos (2) /*!< EADC_T::CMP3: CMPCOND Position */ +#define EADC_CMP3_CMPCOND_Msk (0x1ul << EADC_CMP3_CMPCOND_Pos) /*!< EADC_T::CMP3: CMPCOND Mask */ + +#define EADC_CMP3_CMPSPL_Pos (3) /*!< EADC_T::CMP3: CMPSPL Position */ +#define EADC_CMP3_CMPSPL_Msk (0x1ful << EADC_CMP3_CMPSPL_Pos) /*!< EADC_T::CMP3: CMPSPL Mask */ + +#define EADC_CMP3_CMPMCNT_Pos (8) /*!< EADC_T::CMP3: CMPMCNT Position */ +#define EADC_CMP3_CMPMCNT_Msk (0xful << EADC_CMP3_CMPMCNT_Pos) /*!< EADC_T::CMP3: CMPMCNT Mask */ + +#define EADC_CMP3_CMPWEN_Pos (15) /*!< EADC_T::CMP3: CMPWEN Position */ +#define EADC_CMP3_CMPWEN_Msk (0x1ul << EADC_CMP3_CMPWEN_Pos) /*!< EADC_T::CMP3: CMPWEN Mask */ + +#define EADC_CMP3_CMPDAT_Pos (16) /*!< EADC_T::CMP3: CMPDAT Position */ +#define EADC_CMP3_CMPDAT_Msk (0xffful << EADC_CMP3_CMPDAT_Pos) /*!< EADC_T::CMP3: CMPDAT Mask */ + +#define EADC_STATUS0_VALID_Pos (0) /*!< EADC_T::STATUS0: VALID Position */ +#define EADC_STATUS0_VALID_Msk (0xfffful << EADC_STATUS0_VALID_Pos) /*!< EADC_T::STATUS0: VALID Mask */ + +#define EADC_STATUS0_OV_Pos (16) /*!< EADC_T::STATUS0: OV Position */ +#define EADC_STATUS0_OV_Msk (0xfffful << EADC_STATUS0_OV_Pos) /*!< EADC_T::STATUS0: OV Mask */ + +#define EADC_STATUS1_VALID_Pos (0) /*!< EADC_T::STATUS1: VALID Position */ +#define EADC_STATUS1_VALID_Msk (0x7ul << EADC_STATUS1_VALID_Pos) /*!< EADC_T::STATUS1: VALID Mask */ + +#define EADC_STATUS1_OV_Pos (16) /*!< EADC_T::STATUS1: OV Position */ +#define EADC_STATUS1_OV_Msk (0x7ul << EADC_STATUS1_OV_Pos) /*!< EADC_T::STATUS1: OV Mask */ + +#define EADC_STATUS2_ADIF0_Pos (0) /*!< EADC_T::STATUS2: ADIF0 Position */ +#define EADC_STATUS2_ADIF0_Msk (0x1ul << EADC_STATUS2_ADIF0_Pos) /*!< EADC_T::STATUS2: ADIF0 Mask */ + +#define EADC_STATUS2_ADIF1_Pos (1) /*!< EADC_T::STATUS2: ADIF1 Position */ +#define EADC_STATUS2_ADIF1_Msk (0x1ul << EADC_STATUS2_ADIF1_Pos) /*!< EADC_T::STATUS2: ADIF1 Mask */ + +#define EADC_STATUS2_ADIF2_Pos (2) /*!< EADC_T::STATUS2: ADIF2 Position */ +#define EADC_STATUS2_ADIF2_Msk (0x1ul << EADC_STATUS2_ADIF2_Pos) /*!< EADC_T::STATUS2: ADIF2 Mask */ + +#define EADC_STATUS2_ADIF3_Pos (3) /*!< EADC_T::STATUS2: ADIF3 Position */ +#define EADC_STATUS2_ADIF3_Msk (0x1ul << EADC_STATUS2_ADIF3_Pos) /*!< EADC_T::STATUS2: ADIF3 Mask */ + +#define EADC_STATUS2_ADCMPF0_Pos (4) /*!< EADC_T::STATUS2: ADCMPF0 Position */ +#define EADC_STATUS2_ADCMPF0_Msk (0x1ul << EADC_STATUS2_ADCMPF0_Pos) /*!< EADC_T::STATUS2: ADCMPF0 Mask */ + +#define EADC_STATUS2_ADCMPF1_Pos (5) /*!< EADC_T::STATUS2: ADCMPF1 Position */ +#define EADC_STATUS2_ADCMPF1_Msk (0x1ul << EADC_STATUS2_ADCMPF1_Pos) /*!< EADC_T::STATUS2: ADCMPF1 Mask */ + +#define EADC_STATUS2_ADCMPF2_Pos (6) /*!< EADC_T::STATUS2: ADCMPF2 Position */ +#define EADC_STATUS2_ADCMPF2_Msk (0x1ul << EADC_STATUS2_ADCMPF2_Pos) /*!< EADC_T::STATUS2: ADCMPF2 Mask */ + +#define EADC_STATUS2_ADCMPF3_Pos (7) /*!< EADC_T::STATUS2: ADCMPF3 Position */ +#define EADC_STATUS2_ADCMPF3_Msk (0x1ul << EADC_STATUS2_ADCMPF3_Pos) /*!< EADC_T::STATUS2: ADCMPF3 Mask */ + +#define EADC_STATUS2_ADOVIF0_Pos (8) /*!< EADC_T::STATUS2: ADOVIF0 Position */ +#define EADC_STATUS2_ADOVIF0_Msk (0x1ul << EADC_STATUS2_ADOVIF0_Pos) /*!< EADC_T::STATUS2: ADOVIF0 Mask */ + +#define EADC_STATUS2_ADOVIF1_Pos (9) /*!< EADC_T::STATUS2: ADOVIF1 Position */ +#define EADC_STATUS2_ADOVIF1_Msk (0x1ul << EADC_STATUS2_ADOVIF1_Pos) /*!< EADC_T::STATUS2: ADOVIF1 Mask */ + +#define EADC_STATUS2_ADOVIF2_Pos (10) /*!< EADC_T::STATUS2: ADOVIF2 Position */ +#define EADC_STATUS2_ADOVIF2_Msk (0x1ul << EADC_STATUS2_ADOVIF2_Pos) /*!< EADC_T::STATUS2: ADOVIF2 Mask */ + +#define EADC_STATUS2_ADOVIF3_Pos (11) /*!< EADC_T::STATUS2: ADOVIF3 Position */ +#define EADC_STATUS2_ADOVIF3_Msk (0x1ul << EADC_STATUS2_ADOVIF3_Pos) /*!< EADC_T::STATUS2: ADOVIF3 Mask */ + +#define EADC_STATUS2_ADCMPO0_Pos (12) /*!< EADC_T::STATUS2: ADCMPO0 Position */ +#define EADC_STATUS2_ADCMPO0_Msk (0x1ul << EADC_STATUS2_ADCMPO0_Pos) /*!< EADC_T::STATUS2: ADCMPO0 Mask */ + +#define EADC_STATUS2_ADCMPO1_Pos (13) /*!< EADC_T::STATUS2: ADCMPO1 Position */ +#define EADC_STATUS2_ADCMPO1_Msk (0x1ul << EADC_STATUS2_ADCMPO1_Pos) /*!< EADC_T::STATUS2: ADCMPO1 Mask */ + +#define EADC_STATUS2_ADCMPO2_Pos (14) /*!< EADC_T::STATUS2: ADCMPO2 Position */ +#define EADC_STATUS2_ADCMPO2_Msk (0x1ul << EADC_STATUS2_ADCMPO2_Pos) /*!< EADC_T::STATUS2: ADCMPO2 Mask */ + +#define EADC_STATUS2_ADCMPO3_Pos (15) /*!< EADC_T::STATUS2: ADCMPO3 Position */ +#define EADC_STATUS2_ADCMPO3_Msk (0x1ul << EADC_STATUS2_ADCMPO3_Pos) /*!< EADC_T::STATUS2: ADCMPO3 Mask */ + +#define EADC_STATUS2_CHANNEL_Pos (16) /*!< EADC_T::STATUS2: CHANNEL Position */ +#define EADC_STATUS2_CHANNEL_Msk (0x1ful << EADC_STATUS2_CHANNEL_Pos) /*!< EADC_T::STATUS2: CHANNEL Mask */ + +#define EADC_STATUS2_BUSY_Pos (23) /*!< EADC_T::STATUS2: BUSY Position */ +#define EADC_STATUS2_BUSY_Msk (0x1ul << EADC_STATUS2_BUSY_Pos) /*!< EADC_T::STATUS2: BUSY Mask */ + +#define EADC_STATUS2_ADOVIF_Pos (24) /*!< EADC_T::STATUS2: ADOVIF Position */ +#define EADC_STATUS2_ADOVIF_Msk (0x1ul << EADC_STATUS2_ADOVIF_Pos) /*!< EADC_T::STATUS2: ADOVIF Mask */ + +#define EADC_STATUS2_STOVF_Pos (25) /*!< EADC_T::STATUS2: STOVF Position */ +#define EADC_STATUS2_STOVF_Msk (0x1ul << EADC_STATUS2_STOVF_Pos) /*!< EADC_T::STATUS2: STOVF Mask */ + +#define EADC_STATUS2_AVALID_Pos (26) /*!< EADC_T::STATUS2: AVALID Position */ +#define EADC_STATUS2_AVALID_Msk (0x1ul << EADC_STATUS2_AVALID_Pos) /*!< EADC_T::STATUS2: AVALID Mask */ + +#define EADC_STATUS2_AOV_Pos (27) /*!< EADC_T::STATUS2: AOV Position */ +#define EADC_STATUS2_AOV_Msk (0x1ul << EADC_STATUS2_AOV_Pos) /*!< EADC_T::STATUS2: AOV Mask */ + +#define EADC_STATUS3_CURSPL_Pos (0) /*!< EADC_T::STATUS3: CURSPL Position */ +#define EADC_STATUS3_CURSPL_Msk (0x1ful << EADC_STATUS3_CURSPL_Pos) /*!< EADC_T::STATUS3: CURSPL Mask */ + +#define EADC_DDAT0_RESULT_Pos (0) /*!< EADC_T::DDAT0: RESULT Position */ +#define EADC_DDAT0_RESULT_Msk (0xfffful << EADC_DDAT0_RESULT_Pos) /*!< EADC_T::DDAT0: RESULT Mask */ + +#define EADC_DDAT0_OV_Pos (16) /*!< EADC_T::DDAT0: OV Position */ +#define EADC_DDAT0_OV_Msk (0x1ul << EADC_DDAT0_OV_Pos) /*!< EADC_T::DDAT0: OV Mask */ + +#define EADC_DDAT0_VALID_Pos (17) /*!< EADC_T::DDAT0: VALID Position */ +#define EADC_DDAT0_VALID_Msk (0x1ul << EADC_DDAT0_VALID_Pos) /*!< EADC_T::DDAT0: VALID Mask */ + +#define EADC_DDAT1_RESULT_Pos (0) /*!< EADC_T::DDAT1: RESULT Position */ +#define EADC_DDAT1_RESULT_Msk (0xfffful << EADC_DDAT1_RESULT_Pos) /*!< EADC_T::DDAT1: RESULT Mask */ + +#define EADC_DDAT1_OV_Pos (16) /*!< EADC_T::DDAT1: OV Position */ +#define EADC_DDAT1_OV_Msk (0x1ul << EADC_DDAT1_OV_Pos) /*!< EADC_T::DDAT1: OV Mask */ + +#define EADC_DDAT1_VALID_Pos (17) /*!< EADC_T::DDAT1: VALID Position */ +#define EADC_DDAT1_VALID_Msk (0x1ul << EADC_DDAT1_VALID_Pos) /*!< EADC_T::DDAT1: VALID Mask */ + +#define EADC_DDAT2_RESULT_Pos (0) /*!< EADC_T::DDAT2: RESULT Position */ +#define EADC_DDAT2_RESULT_Msk (0xfffful << EADC_DDAT2_RESULT_Pos) /*!< EADC_T::DDAT2: RESULT Mask */ + +#define EADC_DDAT2_OV_Pos (16) /*!< EADC_T::DDAT2: OV Position */ +#define EADC_DDAT2_OV_Msk (0x1ul << EADC_DDAT2_OV_Pos) /*!< EADC_T::DDAT2: OV Mask */ + +#define EADC_DDAT2_VALID_Pos (17) /*!< EADC_T::DDAT2: VALID Position */ +#define EADC_DDAT2_VALID_Msk (0x1ul << EADC_DDAT2_VALID_Pos) /*!< EADC_T::DDAT2: VALID Mask */ + +#define EADC_DDAT3_RESULT_Pos (0) /*!< EADC_T::DDAT3: RESULT Position */ +#define EADC_DDAT3_RESULT_Msk (0xfffful << EADC_DDAT3_RESULT_Pos) /*!< EADC_T::DDAT3: RESULT Mask */ + +#define EADC_DDAT3_OV_Pos (16) /*!< EADC_T::DDAT3: OV Position */ +#define EADC_DDAT3_OV_Msk (0x1ul << EADC_DDAT3_OV_Pos) /*!< EADC_T::DDAT3: OV Mask */ + +#define EADC_DDAT3_VALID_Pos (17) /*!< EADC_T::DDAT3: VALID Position */ +#define EADC_DDAT3_VALID_Msk (0x1ul << EADC_DDAT3_VALID_Pos) /*!< EADC_T::DDAT3: VALID Mask */ + +#define EADC_PWRM_PWUPRDY_Pos (0) /*!< EADC_T::PWRM: PWUPRDY Position */ +#define EADC_PWRM_PWUPRDY_Msk (0x1ul << EADC_PWRM_PWUPRDY_Pos) /*!< EADC_T::PWRM: PWUPRDY Mask */ + +#define EADC_PWRM_PWUCALEN_Pos (1) /*!< EADC_T::PWRM: PWUCALEN Position */ +#define EADC_PWRM_PWUCALEN_Msk (0x1ul << EADC_PWRM_PWUCALEN_Pos) /*!< EADC_T::PWRM: PWUCALEN Mask */ + +#define EADC_PWRM_PWDMOD_Pos (2) /*!< EADC_T::PWRM: PWDMOD Position */ +#define EADC_PWRM_PWDMOD_Msk (0x3ul << EADC_PWRM_PWDMOD_Pos) /*!< EADC_T::PWRM: PWDMOD Mask */ + +#define EADC_PWRM_LDOSUT_Pos (8) /*!< EADC_T::PWRM: LDOSUT Position */ +#define EADC_PWRM_LDOSUT_Msk (0xffful << EADC_PWRM_LDOSUT_Pos) /*!< EADC_T::PWRM: LDOSUT Mask */ + +#define EADC_CALCTL_CALSTART_Pos (1) /*!< EADC_T::CALCTL: CALSTART Position */ +#define EADC_CALCTL_CALSTART_Msk (0x1ul << EADC_CALCTL_CALSTART_Pos) /*!< EADC_T::CALCTL: CALSTART Mask */ + +#define EADC_CALCTL_CALDONE_Pos (2) /*!< EADC_T::CALCTL: CALDONE Position */ +#define EADC_CALCTL_CALDONE_Msk (0x1ul << EADC_CALCTL_CALDONE_Pos) /*!< EADC_T::CALCTL: CALDONE Mask */ + +#define EADC_CALCTL_CALSEL_Pos (3) /*!< EADC_T::CALCTL: CALSEL Position */ +#define EADC_CALCTL_CALSEL_Msk (0x1ul << EADC_CALCTL_CALSEL_Pos) /*!< EADC_T::CALCTL: CALSEL Mask */ + +#define EADC_CALDWRD_CALWORD_Pos (0) /*!< EADC_T::CALDWRD: CALWORD Position */ +#define EADC_CALDWRD_CALWORD_Msk (0x7ful << EADC_CALDWRD_CALWORD_Pos) /*!< EADC_T::CALDWRD: CALWORD Mask */ + +/**@}*/ /* EADC_CONST */ +/**@}*/ /* end of EADC register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __EADC_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/ebi_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/ebi_reg.h new file mode 100644 index 00000000000..9a48d3c286d --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/ebi_reg.h @@ -0,0 +1,429 @@ +/**************************************************************************//** + * @file ebi_reg.h + * @version V1.00 + * @brief EBI register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __EBI_REG_H__ +#define __EBI_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup EBI External Bus Interface Controller(EBI) + Memory Mapped Structure for EBI Controller +@{ */ + +typedef struct +{ + + + /** + * @var EBI_T::CTL0 + * Offset: 0x00 External Bus Interface Bank0 Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |EN |EBI Enable Bit + * | | |This bit is the functional enable bit for EBI. + * | | |0 = EBI function Disabled. + * | | |1 = EBI function Enabled. + * |[1] |DW16 |EBI Data Width 16-bit Select + * | | |This bit defines if the EBI data width is 8-bit or 16-bit. + * | | |0 = EBI data width is 8-bit. + * | | |1 = EBI data width is 16-bit. + * |[2] |CSPOLINV |Chip Select Pin Polar Inverse + * | | |This bit defines the active level of EBI chip select pin (EBI_nCS). + * | | |0 = Chip select pin (EBI_nCS) is active low. + * | | |1 = Chip select pin (EBI_nCS) is active high. + * |[3] |ADSEPEN |EBI Address/Data Bus Separating Mode Enable Bit + * | | |0 = Address/Data Bus Separating Mode Disabled. + * | | |1 = Address/Data Bus Separating Mode Enabled. + * |[4] |CACCESS |Continuous Data Access Mode + * | | |When con tenuous access mode enabled, the tASU, tALE and tLHD cycles are bypass for continuous data transfer request. + * | | |0 = Continuous data access mode Disabled. + * | | |1 = Continuous data access mode Enabled. + * |[10:8] |MCLKDIV |External Output Clock Divider + * | | |The frequency of EBI output clock (MCLK) is controlled by MCLKDIV as follow: + * | | |000 = HCLK/1. + * | | |001 = HCLK/2. + * | | |010 = HCLK/4. + * | | |011 = HCLK/8. + * | | |100 = HCLK/16. + * | | |101 = HCLK/32. + * | | |110 = HCLK/64. + * | | |111 = HCLK/128. + * |[18:16] |TALE |Extend Time of ALE + * | | |The EBI_ALE high pulse period (tALE) to latch the address can be controlled by TALE. + * | | |tALE = (TALE+1)*EBI_MCLK. + * | | |Note: This field only available in EBI_CTL0 register + * |[24] |WBUFEN |EBI Write Buffer Enable Bit + * | | |0 = EBI write buffer Disabled. + * | | |1 = EBI write buffer Enabled. + * | | |Note: This bit only available in EBI_CTL0 register + * @var EBI_T::TCTL0 + * Offset: 0x04 External Bus Interface Bank0 Timing Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:3] |TACC |EBI Data Access Time + * | | |TACC define data access time (tACC). + * | | |tACC = (TACC +1) * EBI_MCLK. + * |[10:8] |TAHD |EBI Data Access Hold Time + * | | |TAHD define data access hold time (tAHD). + * | | |tAHD = (TAHD +1) * EBI_MCLK. + * |[15:12] |W2X |Idle Cycle After Write + * | | |This field defines the number of W2X idle cycle. + * | | |W2X idle cycle = (W2X * EBI_MCLK). + * | | |When write action is finish, W2X idle cycle is inserted and EBI_nCS return to idle state. + * |[22] |RAHDOFF |Access Hold Time Disable Control When Read + * | | |0 = The Data Access Hold Time (tAHD) during EBI reading is Enabled. + * | | |1 = The Data Access Hold Time (tAHD) during EBI reading is Disabled. + * |[23] |WAHDOFF |Access Hold Time Disable Control When Write + * | | |0 = The Data Access Hold Time (tAHD) during EBI writing is Enabled. + * | | |1 = The Data Access Hold Time (tAHD) during EBI writing is Disabled. + * |[27:24] |R2R |Idle Cycle Between Read-to-read + * | | |This field defines the number of R2R idle cycle. + * | | |R2R idle cycle = (R2R * EBI_MCLK). + * | | |When read action is finish and next action is going to read, R2R idle cycle is inserted and EBI_nCS return to idle state. + * @var EBI_T::CTL1 + * Offset: 0x10 External Bus Interface Bank1 Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |EN |EBI Enable Bit + * | | |This bit is the functional enable bit for EBI. + * | | |0 = EBI function Disabled. + * | | |1 = EBI function Enabled. + * |[1] |DW16 |EBI Data Width 16-bit Select + * | | |This bit defines if the EBI data width is 8-bit or 16-bit. + * | | |0 = EBI data width is 8-bit. + * | | |1 = EBI data width is 16-bit. + * |[2] |CSPOLINV |Chip Select Pin Polar Inverse + * | | |This bit defines the active level of EBI chip select pin (EBI_nCS). + * | | |0 = Chip select pin (EBI_nCS) is active low. + * | | |1 = Chip select pin (EBI_nCS) is active high. + * |[3] |ADSEPEN |EBI Address/Data Bus Separating Mode Enable Bit + * | | |0 = Address/Data Bus Separating Mode Disabled. + * | | |1 = Address/Data Bus Separating Mode Enabled. + * |[4] |CACCESS |Continuous Data Access Mode + * | | |When con tenuous access mode enabled, the tASU, tALE and tLHD cycles are bypass for continuous data transfer request. + * | | |0 = Continuous data access mode Disabled. + * | | |1 = Continuous data access mode Enabled. + * |[10:8] |MCLKDIV |External Output Clock Divider + * | | |The frequency of EBI output clock (MCLK) is controlled by MCLKDIV as follow: + * | | |000 = HCLK/1. + * | | |001 = HCLK/2. + * | | |010 = HCLK/4. + * | | |011 = HCLK/8. + * | | |100 = HCLK/16. + * | | |101 = HCLK/32. + * | | |110 = HCLK/64. + * | | |111 = HCLK/128. + * |[18:16] |TALE |Extend Time of ALE + * | | |The EBI_ALE high pulse period (tALE) to latch the address can be controlled by TALE. + * | | |tALE = (TALE+1)*EBI_MCLK. + * | | |Note: This field only available in EBI_CTL0 register + * |[24] |WBUFEN |EBI Write Buffer Enable Bit + * | | |0 = EBI write buffer Disabled. + * | | |1 = EBI write buffer Enabled. + * | | |Note: This bit only available in EBI_CTL0 register + * @var EBI_T::TCTL1 + * Offset: 0x14 External Bus Interface Bank1 Timing Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:3] |TACC |EBI Data Access Time + * | | |TACC define data access time (tACC). + * | | |tACC = (TACC +1) * EBI_MCLK. + * |[10:8] |TAHD |EBI Data Access Hold Time + * | | |TAHD define data access hold time (tAHD). + * | | |tAHD = (TAHD +1) * EBI_MCLK. + * |[15:12] |W2X |Idle Cycle After Write + * | | |This field defines the number of W2X idle cycle. + * | | |W2X idle cycle = (W2X * EBI_MCLK). + * | | |When write action is finish, W2X idle cycle is inserted and EBI_nCS return to idle state. + * |[22] |RAHDOFF |Access Hold Time Disable Control When Read + * | | |0 = The Data Access Hold Time (tAHD) during EBI reading is Enabled. + * | | |1 = The Data Access Hold Time (tAHD) during EBI reading is Disabled. + * |[23] |WAHDOFF |Access Hold Time Disable Control When Write + * | | |0 = The Data Access Hold Time (tAHD) during EBI writing is Enabled. + * | | |1 = The Data Access Hold Time (tAHD) during EBI writing is Disabled. + * |[27:24] |R2R |Idle Cycle Between Read-to-read + * | | |This field defines the number of R2R idle cycle. + * | | |R2R idle cycle = (R2R * EBI_MCLK). + * | | |When read action is finish and next action is going to read, R2R idle cycle is inserted and EBI_nCS return to idle state. + * @var EBI_T::CTL2 + * Offset: 0x20 External Bus Interface Bank2 Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |EN |EBI Enable Bit + * | | |This bit is the functional enable bit for EBI. + * | | |0 = EBI function Disabled. + * | | |1 = EBI function Enabled. + * |[1] |DW16 |EBI Data Width 16-bit Select + * | | |This bit defines if the EBI data width is 8-bit or 16-bit. + * | | |0 = EBI data width is 8-bit. + * | | |1 = EBI data width is 16-bit. + * |[2] |CSPOLINV |Chip Select Pin Polar Inverse + * | | |This bit defines the active level of EBI chip select pin (EBI_nCS). + * | | |0 = Chip select pin (EBI_nCS) is active low. + * | | |1 = Chip select pin (EBI_nCS) is active high. + * |[3] |ADSEPEN |EBI Address/Data Bus Separating Mode Enable Bit + * | | |0 = Address/Data Bus Separating Mode Disabled. + * | | |1 = Address/Data Bus Separating Mode Enabled. + * |[4] |CACCESS |Continuous Data Access Mode + * | | |When con tenuous access mode enabled, the tASU, tALE and tLHD cycles are bypass for continuous data transfer request. + * | | |0 = Continuous data access mode Disabled. + * | | |1 = Continuous data access mode Enabled. + * |[10:8] |MCLKDIV |External Output Clock Divider + * | | |The frequency of EBI output clock (MCLK) is controlled by MCLKDIV as follow: + * | | |000 = HCLK/1. + * | | |001 = HCLK/2. + * | | |010 = HCLK/4. + * | | |011 = HCLK/8. + * | | |100 = HCLK/16. + * | | |101 = HCLK/32. + * | | |110 = HCLK/64. + * | | |111 = HCLK/128. + * |[18:16] |TALE |Extend Time of ALE + * | | |The EBI_ALE high pulse period (tALE) to latch the address can be controlled by TALE. + * | | |tALE = (TALE+1)*EBI_MCLK. + * | | |Note: This field only available in EBI_CTL0 register + * |[24] |WBUFEN |EBI Write Buffer Enable Bit + * | | |0 = EBI write buffer Disabled. + * | | |1 = EBI write buffer Enabled. + * | | |Note: This bit only available in EBI_CTL0 register + * @var EBI_T::TCTL2 + * Offset: 0x24 External Bus Interface Bank2 Timing Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:3] |TACC |EBI Data Access Time + * | | |TACC define data access time (tACC). + * | | |tACC = (TACC +1) * EBI_MCLK. + * |[10:8] |TAHD |EBI Data Access Hold Time + * | | |TAHD define data access hold time (tAHD). + * | | |tAHD = (TAHD +1) * EBI_MCLK. + * |[15:12] |W2X |Idle Cycle After Write + * | | |This field defines the number of W2X idle cycle. + * | | |W2X idle cycle = (W2X * EBI_MCLK). + * | | |When write action is finish, W2X idle cycle is inserted and EBI_nCS return to idle state. + * |[22] |RAHDOFF |Access Hold Time Disable Control When Read + * | | |0 = The Data Access Hold Time (tAHD) during EBI reading is Enabled. + * | | |1 = The Data Access Hold Time (tAHD) during EBI reading is Disabled. + * |[23] |WAHDOFF |Access Hold Time Disable Control When Write + * | | |0 = The Data Access Hold Time (tAHD) during EBI writing is Enabled. + * | | |1 = The Data Access Hold Time (tAHD) during EBI writing is Disabled. + * |[27:24] |R2R |Idle Cycle Between Read-to-read + * | | |This field defines the number of R2R idle cycle. + * | | |R2R idle cycle = (R2R * EBI_MCLK). + * | | |When read action is finish and next action is going to read, R2R idle cycle is inserted and EBI_nCS return to idle state. + */ + __IO uint32_t CTL0; /*!< [0x0000] External Bus Interface Bank0 Control Register */ + __IO uint32_t TCTL0; /*!< [0x0004] External Bus Interface Bank0 Timing Control Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[2]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t CTL1; /*!< [0x0010] External Bus Interface Bank1 Control Register */ + __IO uint32_t TCTL1; /*!< [0x0014] External Bus Interface Bank1 Timing Control Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE1[2]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t CTL2; /*!< [0x0020] External Bus Interface Bank2 Control Register */ + __IO uint32_t TCTL2; /*!< [0x0024] External Bus Interface Bank2 Timing Control Register */ + +} EBI_T; + +/** + @addtogroup EBI_CONST EBI Bit Field Definition + Constant Definitions for EBI Controller +@{ */ + +#define EBI_CTL_EN_Pos (0) /*!< EBI_T::CTL: EN Position */ +#define EBI_CTL_EN_Msk (0x1ul << EBI_CTL_EN_Pos) /*!< EBI_T::CTL: EN Mask */ + +#define EBI_CTL_DW16_Pos (1) /*!< EBI_T::CTL: DW16 Position */ +#define EBI_CTL_DW16_Msk (0x1ul << EBI_CTL_DW16_Pos) /*!< EBI_T::CTL: DW16 Mask */ + +#define EBI_CTL_CSPOLINV_Pos (2) /*!< EBI_T::CTL: CSPOLINV Position */ +#define EBI_CTL_CSPOLINV_Msk (0x1ul << EBI_CTL_CSPOLINV_Pos) /*!< EBI_T::CTL: CSPOLINV Mask */ + +#define EBI_CTL_ADSEPEN_Pos (3) /*!< EBI_T::CTL: ADSEPEN Position */ +#define EBI_CTL_ADSEPEN_Msk (0x1ul << EBI_CTL_ADSEPEN_Pos) /*!< EBI_T::CTL: ADSEPEN Mask */ + +#define EBI_CTL_CACCESS_Pos (4) /*!< EBI_T::CTL: CACCESS Position */ +#define EBI_CTL_CACCESS_Msk (0x1ul << EBI_CTL_CACCESS_Pos) /*!< EBI_T::CTL: CACCESS Mask */ + +#define EBI_CTL_MCLKDIV_Pos (8) /*!< EBI_T::CTL: MCLKDIV Position */ +#define EBI_CTL_MCLKDIV_Msk (0x7ul << EBI_CTL_MCLKDIV_Pos) /*!< EBI_T::CTL: MCLKDIV Mask */ + +#define EBI_CTL_TALE_Pos (16) /*!< EBI_T::CTL: TALE Position */ +#define EBI_CTL_TALE_Msk (0x7ul << EBI_CTL_TALE_Pos) /*!< EBI_T::CTL: TALE Mask */ + +#define EBI_CTL_WBUFEN_Pos (24) /*!< EBI_T::CTL: WBUFEN Position */ +#define EBI_CTL_WBUFEN_Msk (0x1ul << EBI_CTL_WBUFEN_Pos) /*!< EBI_T::CTL: WBUFEN Mask */ + +#define EBI_TCTL_TACC_Pos (3) /*!< EBI_T::TCTL: TACC Position */ +#define EBI_TCTL_TACC_Msk (0x1ful << EBI_TCTL_TACC_Pos) /*!< EBI_T::TCTL: TACC Mask */ + +#define EBI_TCTL_TAHD_Pos (8) /*!< EBI_T::TCTL: TAHD Position */ +#define EBI_TCTL_TAHD_Msk (0x7ul << EBI_TCTL_TAHD_Pos) /*!< EBI_T::TCTL: TAHD Mask */ + +#define EBI_TCTL_W2X_Pos (12) /*!< EBI_T::TCTL: W2X Position */ +#define EBI_TCTL_W2X_Msk (0xful << EBI_TCTL_W2X_Pos) /*!< EBI_T::TCTL: W2X Mask */ + +#define EBI_TCTL_RAHDOFF_Pos (22) /*!< EBI_T::TCTL: RAHDOFF Position */ +#define EBI_TCTL_RAHDOFF_Msk (0x1ul << EBI_TCTL_RAHDOFF_Pos) /*!< EBI_T::TCTL: RAHDOFF Mask */ + +#define EBI_TCTL_WAHDOFF_Pos (23) /*!< EBI_T::TCTL: WAHDOFF Position */ +#define EBI_TCTL_WAHDOFF_Msk (0x1ul << EBI_TCTL_WAHDOFF_Pos) /*!< EBI_T::TCTL: WAHDOFF Mask */ + +#define EBI_TCTL_R2R_Pos (24) /*!< EBI_T::TCTL: R2R Position */ +#define EBI_TCTL_R2R_Msk (0xful << EBI_TCTL_R2R_Pos) /*!< EBI_T::TCTL: R2R Mask */ + +#define EBI_CTL0_EN_Pos (0) /*!< EBI_T::CTL0: EN Position */ +#define EBI_CTL0_EN_Msk (0x1ul << EBI_CTL0_EN_Pos) /*!< EBI_T::CTL0: EN Mask */ + +#define EBI_CTL0_DW16_Pos (1) /*!< EBI_T::CTL0: DW16 Position */ +#define EBI_CTL0_DW16_Msk (0x1ul << EBI_CTL0_DW16_Pos) /*!< EBI_T::CTL0: DW16 Mask */ + +#define EBI_CTL0_CSPOLINV_Pos (2) /*!< EBI_T::CTL0: CSPOLINV Position */ +#define EBI_CTL0_CSPOLINV_Msk (0x1ul << EBI_CTL0_CSPOLINV_Pos) /*!< EBI_T::CTL0: CSPOLINV Mask */ + +#define EBI_CTL0_ADSEPEN_Pos (3) /*!< EBI_T::CTL0: ADSEPEN Position */ +#define EBI_CTL0_ADSEPEN_Msk (0x1ul << EBI_CTL0_ADSEPEN_Pos) /*!< EBI_T::CTL0: ADSEPEN Mask */ + +#define EBI_CTL0_CACCESS_Pos (4) /*!< EBI_T::CTL0: CACCESS Position */ +#define EBI_CTL0_CACCESS_Msk (0x1ul << EBI_CTL0_CACCESS_Pos) /*!< EBI_T::CTL0: CACCESS Mask */ + +#define EBI_CTL0_MCLKDIV_Pos (8) /*!< EBI_T::CTL0: MCLKDIV Position */ +#define EBI_CTL0_MCLKDIV_Msk (0x7ul << EBI_CTL0_MCLKDIV_Pos) /*!< EBI_T::CTL0: MCLKDIV Mask */ + +#define EBI_CTL0_TALE_Pos (16) /*!< EBI_T::CTL0: TALE Position */ +#define EBI_CTL0_TALE_Msk (0x7ul << EBI_CTL0_TALE_Pos) /*!< EBI_T::CTL0: TALE Mask */ + +#define EBI_CTL0_WBUFEN_Pos (24) /*!< EBI_T::CTL0: WBUFEN Position */ +#define EBI_CTL0_WBUFEN_Msk (0x1ul << EBI_CTL0_WBUFEN_Pos) /*!< EBI_T::CTL0: WBUFEN Mask */ + +#define EBI_TCTL0_TACC_Pos (3) /*!< EBI_T::TCTL0: TACC Position */ +#define EBI_TCTL0_TACC_Msk (0x1ful << EBI_TCTL0_TACC_Pos) /*!< EBI_T::TCTL0: TACC Mask */ + +#define EBI_TCTL0_TAHD_Pos (8) /*!< EBI_T::TCTL0: TAHD Position */ +#define EBI_TCTL0_TAHD_Msk (0x7ul << EBI_TCTL0_TAHD_Pos) /*!< EBI_T::TCTL0: TAHD Mask */ + +#define EBI_TCTL0_W2X_Pos (12) /*!< EBI_T::TCTL0: W2X Position */ +#define EBI_TCTL0_W2X_Msk (0xful << EBI_TCTL0_W2X_Pos) /*!< EBI_T::TCTL0: W2X Mask */ + +#define EBI_TCTL0_RAHDOFF_Pos (22) /*!< EBI_T::TCTL0: RAHDOFF Position */ +#define EBI_TCTL0_RAHDOFF_Msk (0x1ul << EBI_TCTL0_RAHDOFF_Pos) /*!< EBI_T::TCTL0: RAHDOFF Mask */ + +#define EBI_TCTL0_WAHDOFF_Pos (23) /*!< EBI_T::TCTL0: WAHDOFF Position */ +#define EBI_TCTL0_WAHDOFF_Msk (0x1ul << EBI_TCTL0_WAHDOFF_Pos) /*!< EBI_T::TCTL0: WAHDOFF Mask */ + +#define EBI_TCTL0_R2R_Pos (24) /*!< EBI_T::TCTL0: R2R Position */ +#define EBI_TCTL0_R2R_Msk (0xful << EBI_TCTL0_R2R_Pos) /*!< EBI_T::TCTL0: R2R Mask */ + +#define EBI_CTL1_EN_Pos (0) /*!< EBI_T::CTL1: EN Position */ +#define EBI_CTL1_EN_Msk (0x1ul << EBI_CTL1_EN_Pos) /*!< EBI_T::CTL1: EN Mask */ + +#define EBI_CTL1_DW16_Pos (1) /*!< EBI_T::CTL1: DW16 Position */ +#define EBI_CTL1_DW16_Msk (0x1ul << EBI_CTL1_DW16_Pos) /*!< EBI_T::CTL1: DW16 Mask */ + +#define EBI_CTL1_CSPOLINV_Pos (2) /*!< EBI_T::CTL1: CSPOLINV Position */ +#define EBI_CTL1_CSPOLINV_Msk (0x1ul << EBI_CTL1_CSPOLINV_Pos) /*!< EBI_T::CTL1: CSPOLINV Mask */ + +#define EBI_CTL1_ADSEPEN_Pos (3) /*!< EBI_T::CTL1: ADSEPEN Position */ +#define EBI_CTL1_ADSEPEN_Msk (0x1ul << EBI_CTL1_ADSEPEN_Pos) /*!< EBI_T::CTL1: ADSEPEN Mask */ + +#define EBI_CTL1_CACCESS_Pos (4) /*!< EBI_T::CTL1: CACCESS Position */ +#define EBI_CTL1_CACCESS_Msk (0x1ul << EBI_CTL1_CACCESS_Pos) /*!< EBI_T::CTL1: CACCESS Mask */ + +#define EBI_CTL1_MCLKDIV_Pos (8) /*!< EBI_T::CTL1: MCLKDIV Position */ +#define EBI_CTL1_MCLKDIV_Msk (0x7ul << EBI_CTL1_MCLKDIV_Pos) /*!< EBI_T::CTL1: MCLKDIV Mask */ + +#define EBI_CTL1_TALE_Pos (16) /*!< EBI_T::CTL1: TALE Position */ +#define EBI_CTL1_TALE_Msk (0x7ul << EBI_CTL1_TALE_Pos) /*!< EBI_T::CTL1: TALE Mask */ + +#define EBI_CTL1_WBUFEN_Pos (24) /*!< EBI_T::CTL1: WBUFEN Position */ +#define EBI_CTL1_WBUFEN_Msk (0x1ul << EBI_CTL1_WBUFEN_Pos) /*!< EBI_T::CTL1: WBUFEN Mask */ + +#define EBI_TCTL1_TACC_Pos (3) /*!< EBI_T::TCTL1: TACC Position */ +#define EBI_TCTL1_TACC_Msk (0x1ful << EBI_TCTL1_TACC_Pos) /*!< EBI_T::TCTL1: TACC Mask */ + +#define EBI_TCTL1_TAHD_Pos (8) /*!< EBI_T::TCTL1: TAHD Position */ +#define EBI_TCTL1_TAHD_Msk (0x7ul << EBI_TCTL1_TAHD_Pos) /*!< EBI_T::TCTL1: TAHD Mask */ + +#define EBI_TCTL1_W2X_Pos (12) /*!< EBI_T::TCTL1: W2X Position */ +#define EBI_TCTL1_W2X_Msk (0xful << EBI_TCTL1_W2X_Pos) /*!< EBI_T::TCTL1: W2X Mask */ + +#define EBI_TCTL1_RAHDOFF_Pos (22) /*!< EBI_T::TCTL1: RAHDOFF Position */ +#define EBI_TCTL1_RAHDOFF_Msk (0x1ul << EBI_TCTL1_RAHDOFF_Pos) /*!< EBI_T::TCTL1: RAHDOFF Mask */ + +#define EBI_TCTL1_WAHDOFF_Pos (23) /*!< EBI_T::TCTL1: WAHDOFF Position */ +#define EBI_TCTL1_WAHDOFF_Msk (0x1ul << EBI_TCTL1_WAHDOFF_Pos) /*!< EBI_T::TCTL1: WAHDOFF Mask */ + +#define EBI_TCTL1_R2R_Pos (24) /*!< EBI_T::TCTL1: R2R Position */ +#define EBI_TCTL1_R2R_Msk (0xful << EBI_TCTL1_R2R_Pos) /*!< EBI_T::TCTL1: R2R Mask */ + +#define EBI_CTL2_EN_Pos (0) /*!< EBI_T::CTL2: EN Position */ +#define EBI_CTL2_EN_Msk (0x1ul << EBI_CTL2_EN_Pos) /*!< EBI_T::CTL2: EN Mask */ + +#define EBI_CTL2_DW16_Pos (1) /*!< EBI_T::CTL2: DW16 Position */ +#define EBI_CTL2_DW16_Msk (0x1ul << EBI_CTL2_DW16_Pos) /*!< EBI_T::CTL2: DW16 Mask */ + +#define EBI_CTL2_CSPOLINV_Pos (2) /*!< EBI_T::CTL2: CSPOLINV Position */ +#define EBI_CTL2_CSPOLINV_Msk (0x1ul << EBI_CTL2_CSPOLINV_Pos) /*!< EBI_T::CTL2: CSPOLINV Mask */ + +#define EBI_CTL2_ADSEPEN_Pos (3) /*!< EBI_T::CTL2: ADSEPEN Position */ +#define EBI_CTL2_ADSEPEN_Msk (0x1ul << EBI_CTL2_ADSEPEN_Pos) /*!< EBI_T::CTL2: ADSEPEN Mask */ + +#define EBI_CTL2_CACCESS_Pos (4) /*!< EBI_T::CTL2: CACCESS Position */ +#define EBI_CTL2_CACCESS_Msk (0x1ul << EBI_CTL2_CACCESS_Pos) /*!< EBI_T::CTL2: CACCESS Mask */ + +#define EBI_CTL2_MCLKDIV_Pos (8) /*!< EBI_T::CTL2: MCLKDIV Position */ +#define EBI_CTL2_MCLKDIV_Msk (0x7ul << EBI_CTL2_MCLKDIV_Pos) /*!< EBI_T::CTL2: MCLKDIV Mask */ + +#define EBI_CTL2_TALE_Pos (16) /*!< EBI_T::CTL2: TALE Position */ +#define EBI_CTL2_TALE_Msk (0x7ul << EBI_CTL2_TALE_Pos) /*!< EBI_T::CTL2: TALE Mask */ + +#define EBI_CTL2_WBUFEN_Pos (24) /*!< EBI_T::CTL2: WBUFEN Position */ +#define EBI_CTL2_WBUFEN_Msk (0x1ul << EBI_CTL2_WBUFEN_Pos) /*!< EBI_T::CTL2: WBUFEN Mask */ + +#define EBI_TCTL2_TACC_Pos (3) /*!< EBI_T::TCTL2: TACC Position */ +#define EBI_TCTL2_TACC_Msk (0x1ful << EBI_TCTL2_TACC_Pos) /*!< EBI_T::TCTL2: TACC Mask */ + +#define EBI_TCTL2_TAHD_Pos (8) /*!< EBI_T::TCTL2: TAHD Position */ +#define EBI_TCTL2_TAHD_Msk (0x7ul << EBI_TCTL2_TAHD_Pos) /*!< EBI_T::TCTL2: TAHD Mask */ + +#define EBI_TCTL2_W2X_Pos (12) /*!< EBI_T::TCTL2: W2X Position */ +#define EBI_TCTL2_W2X_Msk (0xful << EBI_TCTL2_W2X_Pos) /*!< EBI_T::TCTL2: W2X Mask */ + +#define EBI_TCTL2_RAHDOFF_Pos (22) /*!< EBI_T::TCTL2: RAHDOFF Position */ +#define EBI_TCTL2_RAHDOFF_Msk (0x1ul << EBI_TCTL2_RAHDOFF_Pos) /*!< EBI_T::TCTL2: RAHDOFF Mask */ + +#define EBI_TCTL2_WAHDOFF_Pos (23) /*!< EBI_T::TCTL2: WAHDOFF Position */ +#define EBI_TCTL2_WAHDOFF_Msk (0x1ul << EBI_TCTL2_WAHDOFF_Pos) /*!< EBI_T::TCTL2: WAHDOFF Mask */ + +#define EBI_TCTL2_R2R_Pos (24) /*!< EBI_T::TCTL2: R2R Position */ +#define EBI_TCTL2_R2R_Msk (0xful << EBI_TCTL2_R2R_Pos) /*!< EBI_T::TCTL2: R2R Mask */ + +/**@}*/ /* EBI_CONST */ +/**@}*/ /* end of EBI register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __EBI_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/ecap_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/ecap_reg.h new file mode 100644 index 00000000000..d22d9dc4de8 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/ecap_reg.h @@ -0,0 +1,390 @@ +/**************************************************************************//** + * @file ecap_reg.h + * @version V1.00 + * @brief ECAP register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __ECAP_REG_H__ +#define __ECAP_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup ECAP Enhanced Input Capture Timer(ECAP) + Memory Mapped Structure for ECAP Controller +@{ */ + +typedef struct +{ + + /** + * @var ECAP_T::CNT + * Offset: 0x00 Input Capture Counter (24-bit up counter) + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:0] |CNT |Input Capture Timer/Counter + * | | |The input Capture Timer/Counter is a 24-bit up-counting counter + * | | |The clock source for the counter is from the clock divider + * @var ECAP_T::HLD0 + * Offset: 0x04 Input Capture Hold Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:0] |HOLD |Input Capture Counter Hold Register + * | | |When an active input capture channel detects a valid edge signal change, the ECAPCNT value is latched into the corresponding holding register + * | | |Each input channel has its own holding register named by ECAP_HLDx where x is from 0 to 2 to indicate inputs from IC0 to IC2, respectively. + * @var ECAP_T::HLD1 + * Offset: 0x08 Input Capture Hold Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:0] |HOLD |Input Capture Counter Hold Register + * | | |When an active input capture channel detects a valid edge signal change, the ECAPCNT value is latched into the corresponding holding register + * | | |Each input channel has its own holding register named by ECAP_HLDx where x is from 0 to 2 to indicate inputs from IC0 to IC2, respectively. + * @var ECAP_T::HLD2 + * Offset: 0x0C Input Capture Hold Register 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:0] |HOLD |Input Capture Counter Hold Register + * | | |When an active input capture channel detects a valid edge signal change, the ECAPCNT value is latched into the corresponding holding register + * | | |Each input channel has its own holding register named by ECAP_HLDx where x is from 0 to 2 to indicate inputs from IC0 to IC2, respectively. + * @var ECAP_T::CNTCMP + * Offset: 0x10 Input Capture Compare Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:0] |CNTCMP |Input Capture Counter Compare Register + * | | |If the compare function is enabled (CMPEN = 1), this register (ECAP_CNTCMP) is used to compare with the capture counter (ECAP_CNT). + * | | |If the reload control is enabled (RLDEN[n] = 1, n=0~3), an overflow event or capture events will trigger the hardware to load the value of this register (ECAP_CNTCMP) into ECAP_CNT. + * @var ECAP_T::CTL0 + * Offset: 0x14 Input Capture Control Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2:0] |NFCLKSEL |Noise Filter Clock Pre-divide Selection + * | | |To determine the sampling frequency of the Noise Filter clock + * | | |000 = CAP_CLK. + * | | |001 = CAP_CLK/2. + * | | |010 = CAP_CLK/4. + * | | |011 = CAP_CLK/16. + * | | |100 = CAP_CLK/32. + * | | |101 = CAP_CLK/64. + * |[3] |CAPNFDIS |Input Capture Noise Filter Disable Control + * | | |0 = Noise filter of Input Capture Enabled. + * | | |1 = Noise filter of Input Capture Disabled (Bypass). + * |[4] |IC0EN |Port Pin IC0 Input to Input Capture Unit Enable Control + * | | |0 = IC0 input to Input Capture Unit Disabled. + * | | |1 = IC0 input to Input Capture Unit Enabled. + * |[5] |IC1EN |Port Pin IC1 Input to Input Capture Unit Enable Control + * | | |0 = IC1 input to Input Capture Unit Disabled. + * | | |1 = IC1 input to Input Capture Unit Enabled. + * |[6] |IC2EN |Port Pin IC2 Input to Input Capture Unit Enable Control + * | | |0 = IC2 input to Input Capture Unit Disabled. + * | | |1 = IC2 input to Input Capture Unit Enabled. + * |[9:8] |CAPSEL0 |CAP0 Input Source Selection + * | | |00 = CAP0 input is from port pin ICAP0. + * | | |01 = Reserved. + * | | |10 = CAP0 input is from signal CHA of QEI controller unit n. + * | | |11 = Reserved. + * | | |Note: Input capture unit n matches QEIn, where n = 0~1. + * |[11:10] |CAPSEL1 |CAP1 Input Source Selection + * | | |00 = CAP1 input is from port pin ICAP1. + * | | |01 = Reserved. + * | | |10 = CAP1 input is from signal CHB of QEI controller unit n. + * | | |11 = Reserved. + * | | |Note: Input capture unit n matches QEIn, where n = 0~1. + * |[13:12] |CAPSEL2 |CAP2 Input Source Selection + * | | |00 = CAP2 input is from port pin ICAP2. + * | | |01 = Reserved. + * | | |10 = CAP2 input is from signal CHX of QEI controller unit n. + * | | |11 = Reserved. + * | | |Note: Input capture unit n matches QEIn, where n = 0~1. + * |[16] |CAPIEN0 |Input Capture Channel 0 Interrupt Enable Control + * | | |0 = The flag CAPTF0 can trigger Input Capture interrupt Disabled. + * | | |1 = The flag CAPTF0 can trigger Input Capture interrupt Enabled. + * |[17] |CAPIEN1 |Input Capture Channel 1 Interrupt Enable Control + * | | |0 = The flag CAPTF1 can trigger Input Capture interrupt Disabled. + * | | |1 = The flag CAPTF1 can trigger Input Capture interrupt Enabled. + * |[18] |CAPIEN2 |Input Capture Channel 2 Interrupt Enable Control + * | | |0 = The flag CAPTF2 can trigger Input Capture interrupt Disabled. + * | | |1 = The flag CAPTF2 can trigger Input Capture interrupt Enabled. + * |[20] |OVIEN |CAPOVF Trigger Input Capture Interrupt Enable Control + * | | |0 = The flag CAPOVF can trigger Input Capture interrupt Disabled. + * | | |1 = The flag CAPOVF can trigger Input Capture interrupt Enabled. + * |[21] |CMPIEN |CAPCMPF Trigger Input Capture Interrupt Enable Control + * | | |0 = The flag CAPCMPF can trigger Input Capture interrupt Disabled. + * | | |1 = The flag CAPCMPF can trigger Input Capture interrupt Enabled. + * |[24] |CNTEN |Input Capture Counter Start Counting Control + * | | |Setting this bit to 1, the capture counter (ECAP_CNT) starts up-counting synchronously with the clock from the . + * | | |0 = ECAP_CNT stop counting. + * | | |1 = ECAP_CNT starts up-counting. + * |[25] |CMPCLREN |Input Capture Counter Cleared by Compare-match Control + * | | |If this bit is set to 1, the capture counter (ECAP_CNT) will be cleared to 0 when the compare-match event (CAPCMPF = 1) occurs. + * | | |0 = Compare-match event (CAPCMPF) can clear capture counter (ECAP_CNT) Disabled. + * | | |1 = Compare-match event (CAPCMPF) can clear capture counter (ECAP_CNT) Enabled. + * |[28] |CMPEN |Compare Function Enable Control + * | | |The compare function in input capture timer/counter is to compare the dynamic counting ECAP_CNT with the compare register ECAP_CNTCMP, if ECAP_CNT value reaches ECAP_CNTCMP, the flag CAPCMPF will be set. + * | | |0 = The compare function Disabled. + * | | |1 = The compare function Enabled. + * |[29] |CAPEN |Input Capture Timer/Counter Enable Control + * | | |0 = Input Capture function Disabled. + * | | |1 = Input Capture function Enabled. + * @var ECAP_T::CTL1 + * Offset: 0x18 Input Capture Control Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |EDGESEL0 |Channel 0 Captured Edge Selection + * | | |Input capture0 can detect falling edge change only, rising edge change only or both edge change + * | | |00 = Detect rising edge only. + * | | |01 = Detect falling edge only. + * | | |1x = Detect both rising and falling edge. + * |[3:2] |EDGESEL1 |Channel 1 Captured Edge Selection + * | | |Input capture1 can detect falling edge change only, rising edge change only or both edge change + * | | |00 = Detect rising edge only. + * | | |01 = Detect falling edge only. + * | | |1x = Detect both rising and falling edge. + * |[5:4] |EDGESEL2 |Channel 2 Captured Edge Selection + * | | |Input capture2 can detect falling edge change only, rising edge change only or both edge changes + * | | |00 = Detect rising edge only. + * | | |01 = Detect falling edge only. + * | | |1x = Detect both rising and falling edge. + * |[8] |CAP0RLDEN |Capture Counteru2019s Reload Function Triggered by Event CAPTE0 Enable Bit + * | | |0 = The reload triggered by Event CAPTE0 Disabled. + * | | |1 = The reload triggered by Event CAPTE0 Enabled. + * |[9] |CAP1RLDEN |Capture Counteru2019s Reload Function Triggered by Event CAPTE1 Enable Bit + * | | |0 = The reload triggered by Event CAPTE1 Disabled. + * | | |1 = The reload triggered by Event CAPTE1 Enabled. + * |[10] |CAP2RLDEN |Capture Counteru2019s Reload Function Triggered by Event CAPTE2 Enable Bit + * | | |0 = The reload triggered by Event CAPTE2 Disabled. + * | | |1 = The reload triggered by Event CAPTE2 Enabled. + * |[11] |OVRLDEN |Capture Counteru2019s Reload Function Triggered by Overflow Enable Bit + * | | |0 = The reload triggered by CAPOV Disabled. + * | | |1 = The reload triggered by CAPOV Enabled. + * |[14:12] |CLKSEL |Capture Timer Clock Divide Selection + * | | |The capture timer clock has a pre-divider with eight divided options controlled by CLKSEL[2:0]. + * | | |000 = CAP_CLK/1. + * | | |001 = CAP_CLK/4. + * | | |010 = CAP_CLK/16. + * | | |011 = CAP_CLK/32. + * | | |100 = CAP_CLK/64. + * | | |101 = CAP_CLK/96. + * | | |110 = CAP_CLK/112. + * | | |111 = CAP_CLK/128. + * |[17:16] |CNTSRCSEL |Capture Timer/Counter Clock Source Selection + * | | |Select the capture timer/counter clock source. + * | | |00 = CAP_CLK (default). + * | | |01 = CAP0. + * | | |10 = CAP1. + * | | |11 = CAP2. + * |[20] |CAP0CLREN |Capture Counter Cleared by Capture Event0 Control + * | | |0 = Event CAPTE0 can clear capture counter (ECAP_CNT) Disabled. + * | | |1 = Event CAPTE0 can clear capture counter (ECAP_CNT) Enabled. + * |[21] |CAP1CLREN |Capture Counter Cleared by Capture Event1 Control + * | | |0 = Event CAPTE1 can clear capture counter (ECAP_CNT) Disabled. + * | | |1 = Event CAPTE1 can clear capture counter (ECAP_CNT) Enabled. + * |[22] |CAP2CLREN |Capture Counter Cleared by Capture Event2 Control + * | | |0 = Event CAPTE2 can clear capture counter (ECAP_CNT) Disabled. + * | | |1 = Event CAPTE2 can clear capture counter (ECAP_CNT) Enabled. + * @var ECAP_T::STATUS + * Offset: 0x1C Input Capture Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CAPTF0 |Input Capture Channel 0 Triggered Flag + * | | |When the input capture channel 0 detects a valid edge change at CAP0 input, it will set flag CAPTF0 to high. + * | | |0 = No valid edge change has been detected at CAP0 input since last clear. + * | | |1 = At least a valid edge change has been detected at CAP0 input since last clear. + * | | |Note: This bit is only cleared by writing 1 to it. + * |[1] |CAPTF1 |Input Capture Channel 1 Triggered Flag + * | | |When the input capture channel 1 detects a valid edge change at CAP1 input, it will set flag CAPTF1 to high. + * | | |0 = No valid edge change has been detected at CAP1 input since last clear. + * | | |1 = At least a valid edge change has been detected at CAP1 input since last clear. + * | | |Note: This bit is only cleared by writing 1 to it. + * |[2] |CAPTF2 |Input Capture Channel 2 Triggered Flag + * | | |When the input capture channel 2 detects a valid edge change at CAP2 input, it will set flag CAPTF2 to high. + * | | |0 = No valid edge change has been detected at CAP2 input since last clear. + * | | |1 = At least a valid edge change has been detected at CAP2 input since last clear. + * | | |Note: This bit is only cleared by writing 1 to it. + * |[4] |CAPCMPF |Input Capture Compare-match Flag + * | | |If the input capture compare function is enabled, the flag is set by hardware when capture counter (ECAP_CNT) up counts and reaches the ECAP_CNTCMP value. + * | | |0 = ECAP_CNT has not matched ECAP_CNTCMP value since last clear. + * | | |1 = ECAP_CNT has matched ECAP_CNTCMP value at least once since last clear. + * | | |Note: This bit is only cleared by writing 1 to it. + * |[5] |CAPOVF |Input Capture Counter Overflow Flag + * | | |Flag is set by hardware when counter (ECAP_CNT) overflows from 0x00FF_FFFF to zero. + * | | |0 = No overflow event has occurred since last clear. + * | | |1 = Overflow event(s) has/have occurred since last clear. + * | | |Note: This bit is only cleared by writing 1 to it. + * |[6] |CAP0 |Value of Input Channel 0, CAP0 (Read Only) + * | | |Reflecting the value of input channel 0, CAP0 + * | | |(The bit is read only and write is ignored) + * |[7] |CAP1 |Value of Input Channel 1, CAP1 (Read Only) + * | | |Reflecting the value of input channel 1, CAP1 + * | | |(The bit is read only and write is ignored) + * |[8] |CAP2 |Value of Input Channel 2, CAP2 (Read Only) + * | | |Reflecting the value of input channel 2, CAP2. + * | | |(The bit is read only and write is ignored) + */ + __IO uint32_t CNT; /*!< [0x0000] Input Capture Counter */ + __IO uint32_t HLD0; /*!< [0x0004] Input Capture Hold Register 0 */ + __IO uint32_t HLD1; /*!< [0x0008] Input Capture Hold Register 1 */ + __IO uint32_t HLD2; /*!< [0x000c] Input Capture Hold Register 2 */ + __IO uint32_t CNTCMP; /*!< [0x0010] Input Capture Compare Register */ + __IO uint32_t CTL0; /*!< [0x0014] Input Capture Control Register 0 */ + __IO uint32_t CTL1; /*!< [0x0018] Input Capture Control Register 1 */ + __IO uint32_t STATUS; /*!< [0x001c] Input Capture Status Register */ + +} ECAP_T; + +/** + @addtogroup ECAP_CONST ECAP Bit Field Definition + Constant Definitions for ECAP Controller +@{ */ + +#define ECAP_CNT_CNT_Pos (0) /*!< ECAP_T::CNT: CNT Position */ +#define ECAP_CNT_CNT_Msk (0xfffffful << ECAP_CNT_CNT_Pos) /*!< ECAP_T::CNT: CNT Mask */ + +#define ECAP_HLD0_HOLD_Pos (0) /*!< ECAP_T::HLD0: HOLD Position */ +#define ECAP_HLD0_HOLD_Msk (0xfffffful << ECAP_HLD0_HOLD_Pos) /*!< ECAP_T::HLD0: HOLD Mask */ + +#define ECAP_HLD1_HOLD_Pos (0) /*!< ECAP_T::HLD1: HOLD Position */ +#define ECAP_HLD1_HOLD_Msk (0xfffffful << ECAP_HLD1_HOLD_Pos) /*!< ECAP_T::HLD1: HOLD Mask */ + +#define ECAP_HLD2_HOLD_Pos (0) /*!< ECAP_T::HLD2: HOLD Position */ +#define ECAP_HLD2_HOLD_Msk (0xfffffful << ECAP_HLD2_HOLD_Pos) /*!< ECAP_T::HLD2: HOLD Mask */ + +#define ECAP_CNTCMP_CNTCMP_Pos (0) /*!< ECAP_T::CNTCMP: CNTCMP Position */ +#define ECAP_CNTCMP_CNTCMP_Msk (0xfffffful << ECAP_CNTCMP_CNTCMP_Pos) /*!< ECAP_T::CNTCMP: CNTCMP Mask */ + +#define ECAP_CTL0_NFCLKSEL_Pos (0) /*!< ECAP_T::CTL0: NFCLKSEL Position */ +#define ECAP_CTL0_NFCLKSEL_Msk (0x7ul << ECAP_CTL0_NFCLKSEL_Pos) /*!< ECAP_T::CTL0: NFCLKSEL Mask */ + +#define ECAP_CTL0_CAPNFDIS_Pos (3) /*!< ECAP_T::CTL0: CAPNFDIS Position */ +#define ECAP_CTL0_CAPNFDIS_Msk (0x1ul << ECAP_CTL0_CAPNFDIS_Pos) /*!< ECAP_T::CTL0: CAPNFDIS Mask */ + +#define ECAP_CTL0_IC0EN_Pos (4) /*!< ECAP_T::CTL0: IC0EN Position */ +#define ECAP_CTL0_IC0EN_Msk (0x1ul << ECAP_CTL0_IC0EN_Pos) /*!< ECAP_T::CTL0: IC0EN Mask */ + +#define ECAP_CTL0_IC1EN_Pos (5) /*!< ECAP_T::CTL0: IC1EN Position */ +#define ECAP_CTL0_IC1EN_Msk (0x1ul << ECAP_CTL0_IC1EN_Pos) /*!< ECAP_T::CTL0: IC1EN Mask */ + +#define ECAP_CTL0_IC2EN_Pos (6) /*!< ECAP_T::CTL0: IC2EN Position */ +#define ECAP_CTL0_IC2EN_Msk (0x1ul << ECAP_CTL0_IC2EN_Pos) /*!< ECAP_T::CTL0: IC2EN Mask */ + +#define ECAP_CTL0_CAPSEL0_Pos (8) /*!< ECAP_T::CTL0: CAPSEL0 Position */ +#define ECAP_CTL0_CAPSEL0_Msk (0x3ul << ECAP_CTL0_CAPSEL0_Pos) /*!< ECAP_T::CTL0: CAPSEL0 Mask */ + +#define ECAP_CTL0_CAPSEL1_Pos (10) /*!< ECAP_T::CTL0: CAPSEL1 Position */ +#define ECAP_CTL0_CAPSEL1_Msk (0x3ul << ECAP_CTL0_CAPSEL1_Pos) /*!< ECAP_T::CTL0: CAPSEL1 Mask */ + +#define ECAP_CTL0_CAPSEL2_Pos (12) /*!< ECAP_T::CTL0: CAPSEL2 Position */ +#define ECAP_CTL0_CAPSEL2_Msk (0x3ul << ECAP_CTL0_CAPSEL2_Pos) /*!< ECAP_T::CTL0: CAPSEL2 Mask */ + +#define ECAP_CTL0_CAPIEN0_Pos (16) /*!< ECAP_T::CTL0: CAPIEN0 Position */ +#define ECAP_CTL0_CAPIEN0_Msk (0x1ul << ECAP_CTL0_CAPIEN0_Pos) /*!< ECAP_T::CTL0: CAPIEN0 Mask */ + +#define ECAP_CTL0_CAPIEN1_Pos (17) /*!< ECAP_T::CTL0: CAPIEN1 Position */ +#define ECAP_CTL0_CAPIEN1_Msk (0x1ul << ECAP_CTL0_CAPIEN1_Pos) /*!< ECAP_T::CTL0: CAPIEN1 Mask */ + +#define ECAP_CTL0_CAPIEN2_Pos (18) /*!< ECAP_T::CTL0: CAPIEN2 Position */ +#define ECAP_CTL0_CAPIEN2_Msk (0x1ul << ECAP_CTL0_CAPIEN2_Pos) /*!< ECAP_T::CTL0: CAPIEN2 Mask */ + +#define ECAP_CTL0_OVIEN_Pos (20) /*!< ECAP_T::CTL0: OVIEN Position */ +#define ECAP_CTL0_OVIEN_Msk (0x1ul << ECAP_CTL0_OVIEN_Pos) /*!< ECAP_T::CTL0: OVIEN Mask */ + +#define ECAP_CTL0_CMPIEN_Pos (21) /*!< ECAP_T::CTL0: CMPIEN Position */ +#define ECAP_CTL0_CMPIEN_Msk (0x1ul << ECAP_CTL0_CMPIEN_Pos) /*!< ECAP_T::CTL0: CMPIEN Mask */ + +#define ECAP_CTL0_CNTEN_Pos (24) /*!< ECAP_T::CTL0: CNTEN Position */ +#define ECAP_CTL0_CNTEN_Msk (0x1ul << ECAP_CTL0_CNTEN_Pos) /*!< ECAP_T::CTL0: CNTEN Mask */ + +#define ECAP_CTL0_CMPCLREN_Pos (25) /*!< ECAP_T::CTL0: CMPCLREN Position */ +#define ECAP_CTL0_CMPCLREN_Msk (0x1ul << ECAP_CTL0_CMPCLREN_Pos) /*!< ECAP_T::CTL0: CMPCLREN Mask */ + +#define ECAP_CTL0_CMPEN_Pos (28) /*!< ECAP_T::CTL0: CMPEN Position */ +#define ECAP_CTL0_CMPEN_Msk (0x1ul << ECAP_CTL0_CMPEN_Pos) /*!< ECAP_T::CTL0: CMPEN Mask */ + +#define ECAP_CTL0_CAPEN_Pos (29) /*!< ECAP_T::CTL0: CAPEN Position */ +#define ECAP_CTL0_CAPEN_Msk (0x1ul << ECAP_CTL0_CAPEN_Pos) /*!< ECAP_T::CTL0: CAPEN Mask */ + +#define ECAP_CTL1_EDGESEL0_Pos (0) /*!< ECAP_T::CTL1: EDGESEL0 Position */ +#define ECAP_CTL1_EDGESEL0_Msk (0x3ul << ECAP_CTL1_EDGESEL0_Pos) /*!< ECAP_T::CTL1: EDGESEL0 Mask */ + +#define ECAP_CTL1_EDGESEL1_Pos (2) /*!< ECAP_T::CTL1: EDGESEL1 Position */ +#define ECAP_CTL1_EDGESEL1_Msk (0x3ul << ECAP_CTL1_EDGESEL1_Pos) /*!< ECAP_T::CTL1: EDGESEL1 Mask */ + +#define ECAP_CTL1_EDGESEL2_Pos (4) /*!< ECAP_T::CTL1: EDGESEL2 Position */ +#define ECAP_CTL1_EDGESEL2_Msk (0x3ul << ECAP_CTL1_EDGESEL2_Pos) /*!< ECAP_T::CTL1: EDGESEL2 Mask */ + +#define ECAP_CTL1_CAP0RLDEN_Pos (8) /*!< ECAP_T::CTL1: CAP0RLDEN Position */ +#define ECAP_CTL1_CAP0RLDEN_Msk (0x1ul << ECAP_CTL1_CAP0RLDEN_Pos) /*!< ECAP_T::CTL1: CAP0RLDEN Mask */ + +#define ECAP_CTL1_CAP1RLDEN_Pos (9) /*!< ECAP_T::CTL1: CAP1RLDEN Position */ +#define ECAP_CTL1_CAP1RLDEN_Msk (0x1ul << ECAP_CTL1_CAP1RLDEN_Pos) /*!< ECAP_T::CTL1: CAP1RLDEN Mask */ + +#define ECAP_CTL1_CAP2RLDEN_Pos (10) /*!< ECAP_T::CTL1: CAP2RLDEN Position */ +#define ECAP_CTL1_CAP2RLDEN_Msk (0x1ul << ECAP_CTL1_CAP2RLDEN_Pos) /*!< ECAP_T::CTL1: CAP2RLDEN Mask */ + +#define ECAP_CTL1_OVRLDEN_Pos (11) /*!< ECAP_T::CTL1: OVRLDEN Position */ +#define ECAP_CTL1_OVRLDEN_Msk (0x1ul << ECAP_CTL1_OVRLDEN_Pos) /*!< ECAP_T::CTL1: OVRLDEN Mask */ + +#define ECAP_CTL1_CLKSEL_Pos (12) /*!< ECAP_T::CTL1: CLKSEL Position */ +#define ECAP_CTL1_CLKSEL_Msk (0x7ul << ECAP_CTL1_CLKSEL_Pos) /*!< ECAP_T::CTL1: CLKSEL Mask */ + +#define ECAP_CTL1_CNTSRCSEL_Pos (16) /*!< ECAP_T::CTL1: CNTSRCSEL Position */ +#define ECAP_CTL1_CNTSRCSEL_Msk (0x3ul << ECAP_CTL1_CNTSRCSEL_Pos) /*!< ECAP_T::CTL1: CNTSRCSEL Mask */ + +#define ECAP_CTL1_CAP0CLREN_Pos (20) /*!< ECAP_T::CTL1: CAP0CLREN Position */ +#define ECAP_CTL1_CAP0CLREN_Msk (0x1ul << ECAP_CTL1_CAP0CLREN_Pos) /*!< ECAP_T::CTL1: CAP0CLREN Mask */ + +#define ECAP_CTL1_CAP1CLREN_Pos (21) /*!< ECAP_T::CTL1: CAP1CLREN Position */ +#define ECAP_CTL1_CAP1CLREN_Msk (0x1ul << ECAP_CTL1_CAP1CLREN_Pos) /*!< ECAP_T::CTL1: CAP1CLREN Mask */ + +#define ECAP_CTL1_CAP2CLREN_Pos (22) /*!< ECAP_T::CTL1: CAP2CLREN Position */ +#define ECAP_CTL1_CAP2CLREN_Msk (0x1ul << ECAP_CTL1_CAP2CLREN_Pos) /*!< ECAP_T::CTL1: CAP2CLREN Mask */ + +#define ECAP_STATUS_CAPTF0_Pos (0) /*!< ECAP_T::STATUS: CAPTF0 Position */ +#define ECAP_STATUS_CAPTF0_Msk (0x1ul << ECAP_STATUS_CAPTF0_Pos) /*!< ECAP_T::STATUS: CAPTF0 Mask */ + +#define ECAP_STATUS_CAPTF1_Pos (1) /*!< ECAP_T::STATUS: CAPTF1 Position */ +#define ECAP_STATUS_CAPTF1_Msk (0x1ul << ECAP_STATUS_CAPTF1_Pos) /*!< ECAP_T::STATUS: CAPTF1 Mask */ + +#define ECAP_STATUS_CAPTF2_Pos (2) /*!< ECAP_T::STATUS: CAPTF2 Position */ +#define ECAP_STATUS_CAPTF2_Msk (0x1ul << ECAP_STATUS_CAPTF2_Pos) /*!< ECAP_T::STATUS: CAPTF2 Mask */ + +#define ECAP_STATUS_CAPCMPF_Pos (4) /*!< ECAP_T::STATUS: CAPCMPF Position */ +#define ECAP_STATUS_CAPCMPF_Msk (0x1ul << ECAP_STATUS_CAPCMPF_Pos) /*!< ECAP_T::STATUS: CAPCMPF Mask */ + +#define ECAP_STATUS_CAPOVF_Pos (5) /*!< ECAP_T::STATUS: CAPOVF Position */ +#define ECAP_STATUS_CAPOVF_Msk (0x1ul << ECAP_STATUS_CAPOVF_Pos) /*!< ECAP_T::STATUS: CAPOVF Mask */ + +#define ECAP_STATUS_CAP0_Pos (8) /*!< ECAP_T::STATUS: CAP0 Position */ +#define ECAP_STATUS_CAP0_Msk (0x1ul << ECAP_STATUS_CAP0_Pos) /*!< ECAP_T::STATUS: CAP0 Mask */ + +#define ECAP_STATUS_CAP1_Pos (9) /*!< ECAP_T::STATUS: CAP1 Position */ +#define ECAP_STATUS_CAP1_Msk (0x1ul << ECAP_STATUS_CAP1_Pos) /*!< ECAP_T::STATUS: CAP1 Mask */ + +#define ECAP_STATUS_CAP2_Pos (10) /*!< ECAP_T::STATUS: CAP2 Position */ +#define ECAP_STATUS_CAP2_Msk (0x1ul << ECAP_STATUS_CAP2_Pos) /*!< ECAP_T::STATUS: CAP2 Mask */ + +/**@}*/ /* ECAP_CONST */ +/**@}*/ /* end of ECAP register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __ECAP_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/emac_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/emac_reg.h new file mode 100644 index 00000000000..831df4a3a1f --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/emac_reg.h @@ -0,0 +1,2063 @@ +/**************************************************************************//** + * @file emac_reg.h + * @version V1.00 + * @brief EMAC register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __EMAC_REG_H__ +#define __EMAC_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup EMAC Ethernet MAC Controller(EMAC) + Memory Mapped Structure for EMAC Controller +@{ */ + +typedef struct +{ + + /** + * @var EMAC_T::CAMCTL + * Offset: 0x00 CAM Comparison Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |AUP |Accept Unicast Packet + * | | |The AUP controls the unicast packet reception + * | | |If AUP is enabled, EMAC receives all incoming packet its destination MAC address is a unicast address. + * | | |0 = EMAC receives packet depends on the CAM comparison result. + * | | |1 = EMAC receives all unicast packets. + * |[1] |AMP |Accept Multicast Packet + * | | |The AMP controls the multicast packet reception + * | | |If AMP is enabled, EMAC receives all incoming packet its destination MAC address is a multicast address. + * | | |0 = EMAC receives packet depends on the CAM comparison result. + * | | |1 = EMAC receives all multicast packets. + * |[2] |ABP |Accept Broadcast Packet + * | | |The ABP controls the broadcast packet reception + * | | |If ABP is enabled, EMAC receives all incoming packet its destination MAC address is a broadcast address. + * | | |0 = EMAC receives packet depends on the CAM comparison result. + * | | |1 = EMAC receives all broadcast packets. + * |[3] |COMPEN |Complement CAM Comparison Enable Bit + * | | |The COMPEN controls the complement of the CAM comparison result + * | | |If the CMPEN and COMPEN are both enabled, the incoming packet with specific destination MAC address + * | | |configured in CAM entry will be dropped + * | | |And the incoming packet with destination MAC address does not configured in any CAM entry will be received. + * | | |0 = Complement CAM comparison result Disabled. + * | | |1 = Complement CAM comparison result Enabled. + * |[4] |CMPEN |CAM Compare Enable Bit + * | | |The CMPEN controls the enable of CAM comparison function for destination MAC address recognition + * | | |If software wants to receive a packet with specific destination MAC address, configures the MAC address + * | | |into CAM 12~0, then enables that CAM entry and set CMPEN to 1. + * | | |0 = CAM comparison function for destination MAC address recognition Disabled. + * | | |1 = CAM comparison function for destination MAC address recognition Enabled. + * @var EMAC_T::CAMEN + * Offset: 0x04 CAM Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CAMxEN |CAM Entry X Enable Bit + * | | |The CAMxEN controls the validation of CAM entry x. + * | | |The CAM entry 13, 14 and 15 are for PAUSE control frame transmission + * | | |If software wants to transmit a PAUSE control frame out to network, the enable bits of these three CAM + * | | |entries all must be enabled first. + * | | |0 = CAM entry x Disabled. + * | | |1 = CAM entry x Enabled. + * @var EMAC_T::CAM0M + * Offset: 0x08 CAM0 Most Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |MACADDR2 |MAC Address Byte 2 + * |[15:8] |MACADDR3 |MAC Address Byte 3 + * |[23:16] |MACADDR4 |MAC Address Byte 4 + * |[31:24] |MACADDR5 |MAC Address Byte 5 + * | | |The CAMxM keeps the bit 47~16 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM0L + * Offset: 0x0C CAM0 Least Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:16] |MACADDR0 |MAC Address Byte 0 + * |[31:24] |MACADDR1 |MAC Address Byte 1 + * | | |The CAMxL keeps the bit 15~0 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM1M + * Offset: 0x10 CAM1 Most Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |MACADDR2 |MAC Address Byte 2 + * |[15:8] |MACADDR3 |MAC Address Byte 3 + * |[23:16] |MACADDR4 |MAC Address Byte 4 + * |[31:24] |MACADDR5 |MAC Address Byte 5 + * | | |The CAMxM keeps the bit 47~16 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM1L + * Offset: 0x14 CAM1 Least Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:16] |MACADDR0 |MAC Address Byte 0 + * |[31:24] |MACADDR1 |MAC Address Byte 1 + * | | |The CAMxL keeps the bit 15~0 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM2M + * Offset: 0x18 CAM2 Most Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |MACADDR2 |MAC Address Byte 2 + * |[15:8] |MACADDR3 |MAC Address Byte 3 + * |[23:16] |MACADDR4 |MAC Address Byte 4 + * |[31:24] |MACADDR5 |MAC Address Byte 5 + * | | |The CAMxM keeps the bit 47~16 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM2L + * Offset: 0x1C CAM2 Least Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:16] |MACADDR0 |MAC Address Byte 0 + * |[31:24] |MACADDR1 |MAC Address Byte 1 + * | | |The CAMxL keeps the bit 15~0 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM3M + * Offset: 0x20 CAM3 Most Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |MACADDR2 |MAC Address Byte 2 + * |[15:8] |MACADDR3 |MAC Address Byte 3 + * |[23:16] |MACADDR4 |MAC Address Byte 4 + * |[31:24] |MACADDR5 |MAC Address Byte 5 + * | | |The CAMxM keeps the bit 47~16 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM3L + * Offset: 0x24 CAM3 Least Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:16] |MACADDR0 |MAC Address Byte 0 + * |[31:24] |MACADDR1 |MAC Address Byte 1 + * | | |The CAMxL keeps the bit 15~0 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM4M + * Offset: 0x28 CAM4 Most Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |MACADDR2 |MAC Address Byte 2 + * |[15:8] |MACADDR3 |MAC Address Byte 3 + * |[23:16] |MACADDR4 |MAC Address Byte 4 + * |[31:24] |MACADDR5 |MAC Address Byte 5 + * | | |The CAMxM keeps the bit 47~16 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM4L + * Offset: 0x2C CAM4 Least Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:16] |MACADDR0 |MAC Address Byte 0 + * |[31:24] |MACADDR1 |MAC Address Byte 1 + * | | |The CAMxL keeps the bit 15~0 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM5M + * Offset: 0x30 CAM5 Most Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |MACADDR2 |MAC Address Byte 2 + * |[15:8] |MACADDR3 |MAC Address Byte 3 + * |[23:16] |MACADDR4 |MAC Address Byte 4 + * |[31:24] |MACADDR5 |MAC Address Byte 5 + * | | |The CAMxM keeps the bit 47~16 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM5L + * Offset: 0x34 CAM5 Least Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:16] |MACADDR0 |MAC Address Byte 0 + * |[31:24] |MACADDR1 |MAC Address Byte 1 + * | | |The CAMxL keeps the bit 15~0 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM6M + * Offset: 0x38 CAM6 Most Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |MACADDR2 |MAC Address Byte 2 + * |[15:8] |MACADDR3 |MAC Address Byte 3 + * |[23:16] |MACADDR4 |MAC Address Byte 4 + * |[31:24] |MACADDR5 |MAC Address Byte 5 + * | | |The CAMxM keeps the bit 47~16 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM6L + * Offset: 0x3C CAM6 Least Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:16] |MACADDR0 |MAC Address Byte 0 + * |[31:24] |MACADDR1 |MAC Address Byte 1 + * | | |The CAMxL keeps the bit 15~0 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM7M + * Offset: 0x40 CAM7 Most Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |MACADDR2 |MAC Address Byte 2 + * |[15:8] |MACADDR3 |MAC Address Byte 3 + * |[23:16] |MACADDR4 |MAC Address Byte 4 + * |[31:24] |MACADDR5 |MAC Address Byte 5 + * | | |The CAMxM keeps the bit 47~16 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM7L + * Offset: 0x44 CAM7 Least Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:16] |MACADDR0 |MAC Address Byte 0 + * |[31:24] |MACADDR1 |MAC Address Byte 1 + * | | |The CAMxL keeps the bit 15~0 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM8M + * Offset: 0x48 CAM8 Most Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |MACADDR2 |MAC Address Byte 2 + * |[15:8] |MACADDR3 |MAC Address Byte 3 + * |[23:16] |MACADDR4 |MAC Address Byte 4 + * |[31:24] |MACADDR5 |MAC Address Byte 5 + * | | |The CAMxM keeps the bit 47~16 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM8L + * Offset: 0x4C CAM8 Least Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:16] |MACADDR0 |MAC Address Byte 0 + * |[31:24] |MACADDR1 |MAC Address Byte 1 + * | | |The CAMxL keeps the bit 15~0 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM9M + * Offset: 0x50 CAM9 Most Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |MACADDR2 |MAC Address Byte 2 + * |[15:8] |MACADDR3 |MAC Address Byte 3 + * |[23:16] |MACADDR4 |MAC Address Byte 4 + * |[31:24] |MACADDR5 |MAC Address Byte 5 + * | | |The CAMxM keeps the bit 47~16 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM9L + * Offset: 0x54 CAM9 Least Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:16] |MACADDR0 |MAC Address Byte 0 + * |[31:24] |MACADDR1 |MAC Address Byte 1 + * | | |The CAMxL keeps the bit 15~0 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM10M + * Offset: 0x58 CAM10 Most Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |MACADDR2 |MAC Address Byte 2 + * |[15:8] |MACADDR3 |MAC Address Byte 3 + * |[23:16] |MACADDR4 |MAC Address Byte 4 + * |[31:24] |MACADDR5 |MAC Address Byte 5 + * | | |The CAMxM keeps the bit 47~16 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM10L + * Offset: 0x5C CAM10 Least Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:16] |MACADDR0 |MAC Address Byte 0 + * |[31:24] |MACADDR1 |MAC Address Byte 1 + * | | |The CAMxL keeps the bit 15~0 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM11M + * Offset: 0x60 CAM11 Most Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |MACADDR2 |MAC Address Byte 2 + * |[15:8] |MACADDR3 |MAC Address Byte 3 + * |[23:16] |MACADDR4 |MAC Address Byte 4 + * |[31:24] |MACADDR5 |MAC Address Byte 5 + * | | |The CAMxM keeps the bit 47~16 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM11L + * Offset: 0x64 CAM11 Least Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:16] |MACADDR0 |MAC Address Byte 0 + * |[31:24] |MACADDR1 |MAC Address Byte 1 + * | | |The CAMxL keeps the bit 15~0 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM12M + * Offset: 0x68 CAM12 Most Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |MACADDR2 |MAC Address Byte 2 + * |[15:8] |MACADDR3 |MAC Address Byte 3 + * |[23:16] |MACADDR4 |MAC Address Byte 4 + * |[31:24] |MACADDR5 |MAC Address Byte 5 + * | | |The CAMxM keeps the bit 47~16 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM12L + * Offset: 0x6C CAM12 Least Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:16] |MACADDR0 |MAC Address Byte 0 + * |[31:24] |MACADDR1 |MAC Address Byte 1 + * | | |The CAMxL keeps the bit 15~0 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM13M + * Offset: 0x70 CAM13 Most Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |MACADDR2 |MAC Address Byte 2 + * |[15:8] |MACADDR3 |MAC Address Byte 3 + * |[23:16] |MACADDR4 |MAC Address Byte 4 + * |[31:24] |MACADDR5 |MAC Address Byte 5 + * | | |The CAMxM keeps the bit 47~16 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM13L + * Offset: 0x74 CAM13 Least Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:16] |MACADDR0 |MAC Address Byte 0 + * |[31:24] |MACADDR1 |MAC Address Byte 1 + * | | |The CAMxL keeps the bit 15~0 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM14M + * Offset: 0x78 CAM14 Most Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |MACADDR2 |MAC Address Byte 2 + * |[15:8] |MACADDR3 |MAC Address Byte 3 + * |[23:16] |MACADDR4 |MAC Address Byte 4 + * |[31:24] |MACADDR5 |MAC Address Byte 5 + * | | |The CAMxM keeps the bit 47~16 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM14L + * Offset: 0x7C CAM14 Least Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:16] |MACADDR0 |MAC Address Byte 0 + * |[31:24] |MACADDR1 |MAC Address Byte 1 + * | | |The CAMxL keeps the bit 15~0 of MAC address + * | | |The x can be the 0~14 + * | | |The register pair {EMAC_CAMxM, EMAC_CAMxL} represents a CAM entry and keeps a MAC address. + * | | |For example, if the MAC address 00-50-BA-33-BA-44 kept in CAM entry 1, the register EMAC_CAM1M is + * | | |0x0050_BA33 and EMAC_CAM1L is 0xBA44_0000. + * @var EMAC_T::CAM15MSB + * Offset: 0x80 CAM15 Most Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |OPCODE |OP Code Field of PAUSE Control Frame + * | | |In the PAUSE control frame, an op code field defined and is 0x0001. + * |[31:16] |LENGTH |LENGTH Field of PAUSE Control Frame + * | | |In the PAUSE control frame, a LENGTH field defined and is 0x8808. + * @var EMAC_T::CAM15LSB + * Offset: 0x84 CAM15 Least Significant Word Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:24] |OPERAND |Pause Parameter + * | | |In the PAUSE control frame, an OPERAND field defined and controls how much time the destination + * | | |Ethernet MAC Controller paused + * | | |The unit of the OPERAND is a slot time, the 512-bit time. + * @var EMAC_T::TXDSA + * Offset: 0x88 Transmit Descriptor Link List Start Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |TXDSA |Transmit Descriptor Link-list Start Address + * | | |The TXDSA keeps the start address of transmit descriptor link-list + * | | |If the software enables the bit TXON (EMAC_CTL[8]), the content of TXDSA will be loaded into the + * | | |current transmit descriptor start address register (EMAC_CTXDSA) + * | | |The TXDSA does not be updated by EMAC + * | | |During the operation, EMAC will ignore the bits [1:0] of TXDSA + * | | |This means that TX descriptors must locate at word boundary memory address. + * @var EMAC_T::RXDSA + * Offset: 0x8C Receive Descriptor Link List Start Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |RXDSA |Receive Descriptor Link-list Start Address + * | | |The RXDSA keeps the start address of receive descriptor link-list + * | | |If the S/W enables the bit RXON (EMAC_CTL[0]), the content of RXDSA will be loaded into the current + * | | |receive descriptor start address register (EMAC_CRXDSA) + * | | |The RXDSA does not be updated by EMAC + * | | |During the operation, EMAC will ignore the bits [1:0] of RXDSA + * | | |This means that RX descriptors must locate at word boundary memory address. + * @var EMAC_T::CTL + * Offset: 0x90 MAC Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |RXON |Frame Reception ON + * | | |The RXON controls the normal packet reception of EMAC + * | | |If the RXON is set to high, the EMAC starts the packet reception process, including the RX + * | | |descriptor fetching, packet reception and RX descriptor modification. + * | | |It is necessary to finish EMAC initial sequence before enable RXON + * | | |Otherwise, the EMAC operation is undefined. + * | | |If the RXON is disabled during EMAC is receiving an incoming packet, the EMAC stops the packet + * | | |reception process after the current packet reception finished. + * | | |0 = Packet reception process stopped. + * | | |1 = Packet reception process started. + * |[1] |ALP |Accept Long Packet + * | | |The ALP controls the long packet, which packet length is greater than 1518 bytes, reception + * | | |If the ALP is set to high, the EMAC will accept the long packet. + * | | |Otherwise, the long packet will be dropped. + * | | |0 = Ethernet MAC controller dropped the long packet. + * | | |1 = Ethernet MAC controller received the long packet. + * |[2] |ARP |Accept Runt Packet + * | | |The ARP controls the runt packet, which length is less than 64 bytes, reception + * | | |If the ARP is set to high, the EMAC will accept the runt packet. + * | | |Otherwise, the runt packet will be dropped. + * | | |0 = Ethernet MAC controller dropped the runt packet. + * | | |1 = Ethernet MAC controller received the runt packet. + * |[3] |ACP |Accept Control Packet + * | | |The ACP controls the control frame reception + * | | |If the ACP is set to high, the EMAC will accept the control frame + * | | |Otherwise, the control frame will be dropped + * | | |It is recommended that S/W only enable ACP while EMAC is operating on full duplex mode. + * | | |0 = Ethernet MAC controller dropped the control frame. + * | | |1 = Ethernet MAC controller received the control frame. + * |[4] |AEP |Accept CRC Error Packet + * | | |The AEP controls the EMAC accepts or drops the CRC error packet + * | | |If the AEP is set to high, the incoming packet with CRC error will be received by EMAC as a good packet. + * | | |0 = Ethernet MAC controller dropped the CRC error packet. + * | | |1 = Ethernet MAC controller received the CRC error packet. + * |[5] |STRIPCRC |Strip CRC Checksum + * | | |The STRIPCRC controls if the length of incoming packet is calculated with 4 bytes CRC checksum + * | | |If the STRIPCRC is set to high, 4 bytes CRC checksum is excluded from length calculation of incoming packet. + * | | |0 = The 4 bytes CRC checksum is included in packet length calculation. + * | | |1 = The 4 bytes CRC checksum is excluded in packet length calculation. + * |[6] |WOLEN |Wake on LAN Enable Bit + * | | |The WOLEN high enables the functionality that Ethernet MAC controller checked if the incoming packet + * | | |is Magic Packet and wakeup system from Power-down mode. + * | | |If incoming packet was a Magic Packet and the system was in Power-down, the Ethernet MAC controller + * | | |would generate a wakeup event to wake system up from Power-down mode. + * | | |0 = Wake-up by Magic Packet function Disabled. + * | | |1 = Wake-up by Magic Packet function Enabled. + * |[8] |TXON |Frame Transmission ON + * | | |The TXON controls the normal packet transmission of EMAC + * | | |If the TXON is set to high, the EMAC starts the packet transmission process, including the TX + * | | |descriptor fetching, packet transmission and TX descriptor modification. + * | | |It is must to finish EMAC initial sequence before enable TXON + * | | |Otherwise, the EMAC operation is undefined. + * | | |If the TXON is disabled during EMAC is transmitting a packet out, the EMAC stops the packet + * | | |transmission process after the current packet transmission finished. + * | | |0 = Packet transmission process stopped. + * | | |1 = Packet transmission process started. + * |[9] |NODEF |No Deferral + * | | |The NODEF controls the enable of deferral exceed counter + * | | |If NODEF is set to high, the deferral exceed counter is disabled + * | | |The NODEF is only useful while EMAC is operating on half duplex mode. + * | | |0 = The deferral exceed counter Enabled. + * | | |1 = The deferral exceed counter Disabled. + * |[16] |SDPZ |Send PAUSE Frame + * | | |The SDPZ controls the PAUSE control frame transmission. + * | | |If S/W wants to send a PAUSE control frame out, the CAM entry 13, 14 and 15 must be configured + * | | |first and the corresponding CAM enable bit of CAMEN register also must be set. + * | | |Then, set SDPZ to 1 enables the PAUSE control frame transmission. + * | | |The SDPZ is a self-clear bit + * | | |This means after the PAUSE control frame transmission has completed, the SDPZ will be cleared automatically. + * | | |It is recommended that only enabling SNDPAUSE while EMAC is operating in Full Duplex mode. + * | | |0 = PAUSE control frame transmission completed. + * | | |1 = PAUSE control frame transmission Enabled. + * |[17] |SQECHKEN |SQE Checking Enable Bit + * | | |The SQECHKEN controls the enable of SQE checking + * | | |The SQE checking is only available while EMAC is operating on 10M bps and half duplex mode + * | | |In other words, the SQECHKEN cannot affect EMAC operation, if the EMAC is operating on 100Mbps + * | | |or full duplex mode. + * | | |0 = SQE checking Disabled while EMAC is operating in 10Mbps and Half Duplex mode. + * | | |1 = SQE checking Enabled while EMAC is operating in 10Mbps and Half Duplex mode. + * |[18] |FUDUP |Full Duplex Mode Selection + * | | |The FUDUP controls that if EMAC is operating on full or half duplex mode. + * | | |0 = EMAC operates in half duplex mode. + * | | |1 = EMAC operates in full duplex mode. + * |[19] |RMIIRXCTL |RMII RX Control + * | | |The RMIIRXCTL control the receive data sample in RMII mode + * | | |It's necessary to set this bit high when RMIIEN (EMAC_CTL[ [22]) is high. + * | | |0 = RMII RX control disabled. + * | | |1 = RMII RX control enabled. + * |[20] |OPMODE |Operation Mode Selection + * | | |The OPMODE defines that if the EMAC is operating on 10M or 100M bps mode + * | | |The RST (EMAC_CTL[24]) would not affect OPMODE value. + * | | |0 = EMAC operates in 10Mbps mode. + * | | |1 = EMAC operates in 100Mbps mode. + * |[22] |RMIIEN |RMII Mode Enable Bit + * | | |This bit controls if Ethernet MAC controller connected with off-chip Ethernet PHY by MII + * | | |interface or RMII interface + * | | |The RST (EMAC_CTL[24]) would not affect RMIIEN value. + * | | |0 = Ethernet MAC controller RMII mode Disabled. + * | | |1 = Ethernet MAC controller RMII mode Enabled. + * | | |NOTE: This field must keep 1. + * |[24] |RST |Software Reset + * | | |The RST implements a reset function to make the EMAC return default state + * | | |The RST is a self-clear bit + * | | |This means after the software reset finished, the RST will be cleared automatically + * | | |Enable RST can also reset all control and status registers, exclusive of the control bits + * | | |RMIIEN (EMAC_CTL[22]), and OPMODE (EMAC_CTL[20]). + * | | |The EMAC re-initial is necessary after the software reset completed. + * | | |0 = Software reset completed. + * | | |1 = Software reset Enabled. + * @var EMAC_T::MIIMDAT + * Offset: 0x94 MII Management Data Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |DATA |MII Management Data + * | | |The DATA is the 16 bits data that will be written into the registers of external PHY for MII + * | | |Management write command or the data from the registers of external PHY for MII Management read command. + * @var EMAC_T::MIIMCTL + * Offset: 0x98 MII Management Control and Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[4:0] |PHYREG |PHY Register Address + * | | |The PHYREG keeps the address to indicate which register of external PHY is the target of the + * | | |MII management command. + * |[12:8] |PHYADDR |PHY Address + * | | |The PHYADDR keeps the address to differentiate which external PHY is the target of the MII management command. + * |[16] |WRITE |Write Command + * | | |The Write defines the MII management command is a read or write. + * | | |0 = MII management command is a read command. + * | | |1 = MII management command is a write command. + * |[17] |BUSY |Busy Bit + * | | |The BUSY controls the enable of the MII management frame generation + * | | |If S/W wants to access registers of external PHY, it set BUSY to high and EMAC generates + * | | |the MII management frame to external PHY through MII Management I/F + * | | |The BUSY is a self-clear bit + * | | |This means the BUSY will be cleared automatically after the MII management command finished. + * | | |0 = MII management command generation finished. + * | | |1 = MII management command generation Enabled. + * |[18] |PREAMSP |Preamble Suppress + * | | |The PREAMSP controls the preamble field generation of MII management frame + * | | |If the PREAMSP is set to high, the preamble field generation of MII management frame is skipped. + * | | |0 = Preamble field generation of MII management frame not skipped. + * | | |1 = Preamble field generation of MII management frame skipped. + * |[19] |MDCON |MDC Clock ON + * | | |The MDC controls the MDC clock generation. If the MDCON is set to high, the MDC clock is turned on. + * | | |0 = MDC clock off. + * | | |1 = MDC clock on. + * @var EMAC_T::FIFOCTL + * Offset: 0x9C FIFO Threshold Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |RXFIFOTH |RXFIFO Low Threshold + * | | |The RXFIFOTH controls when RXDMA requests internal arbiter for data transfer between RXFIFO + * | | |and system memory + * | | |The RXFIFOTH defines not only the high threshold of RXFIFO, but also the low threshold + * | | |The low threshold is the half of high threshold always + * | | |During the packet reception, if the RXFIFO reaches the high threshold, the RXDMA starts to + * | | |transfer frame data from RXFIFO to system memory + * | | |If the frame data in RXFIFO is less than low threshold, RXDMA stops to transfer the frame + * | | |data to system memory. + * | | |00 = Depend on the burst length setting + * | | |If the burst length is 8 words, high threshold is 8 words, too. + * | | |01 = RXFIFO high threshold is 64B and low threshold is 32B. + * | | |10 = RXFIFO high threshold is 128B and low threshold is 64B. + * | | |11 = RXFIFO high threshold is 192B and low threshold is 96B. + * |[9:8] |TXFIFOTH |TXFIFO Low Threshold + * | | |The TXFIFOTH controls when TXDMA requests internal arbiter for data transfer between system + * | | |memory and TXFIFO + * | | |The TXFIFOTH defines not only the low threshold of TXFIFO, but also the high threshold + * | | |The high threshold is the twice of low threshold always + * | | |During the packet transmission, if the TXFIFO reaches the high threshold, the TXDMA stops + * | | |generate request to transfer frame data from system memory to TXFIFO + * | | |If the frame data in TXFIFO is less than low threshold, TXDMA starts to transfer frame data + * | | |from system memory to TXFIFO. + * | | |The TXFIFOTH also defines when the TXMAC starts to transmit frame out to network + * | | |The TXMAC starts to transmit the frame out while the TXFIFO first time reaches the high threshold + * | | |during the transmission of the frame + * | | |If the frame data length is less than TXFIFO high threshold, the TXMAC starts to transmit the frame + * | | |out after the frame data are all inside the TXFIFO. + * | | |00 = Undefined. + * | | |01 = TXFIFO low threshold is 64B and high threshold is 128B. + * | | |10 = TXFIFO low threshold is 80B and high threshold is 160B. + * | | |11 = TXFIFO low threshold is 96B and high threshold is 192B. + * |[21:20] |BURSTLEN |DMA Burst Length + * | | |This defines the burst length of AHB bus cycle while EMAC accesses system memory. + * | | |00 = 4 words. + * | | |01 = 8 words. + * | | |10 = 16 words. + * | | |11 = 16 words. + * @var EMAC_T::TXST + * Offset: 0xA0 Transmit Start Demand Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |TXST |Transmit Start Demand + * | | |If the TX descriptor is not available for use of TXDMA after the TXON (EMAC_CTL[8]) is enabled, + * | | |the FSM (Finite State Machine) of TXDMA enters the Halt state and the frame transmission is halted + * | | |After the S/W has prepared the new TX descriptor for frame transmission, it must issue a write + * | | |command to EMAC_TXST register to make TXDMA to leave Halt state and continue the frame transmission. + * | | |The EMAC_TXST is a write only register and read from this register is undefined. + * | | |The write to EMAC_TXST register takes effect only when TXDMA stayed at Halt state. + * @var EMAC_T::RXST + * Offset: 0xA4 Receive Start Demand Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |RXST |Receive Start Demand + * | | |If the RX descriptor is not available for use of RXDMA after the RXON (EMAC_CTL[0]) is enabled, + * | | |the FSM (Finite State Machine) of RXDMA enters the Halt state and the frame reception is halted + * | | |After the S/W has prepared the new RX descriptor for frame reception, it must issue a write + * | | |command to EMAC_RXST register to make RXDMA to leave Halt state and continue the frame reception. + * | | |The EMAC_RXST is a write only register and read from this register is undefined. + * | | |The write to EMAC_RXST register take effect only when RXDMA stayed at Halt state. + * @var EMAC_T::MRFL + * Offset: 0xA8 Maximum Receive Frame Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |MRFL |Maximum Receive Frame Length + * | | |The MRFL defines the maximum frame length for received frame + * | | |If the frame length of received frame is greater than MRFL, and bit MFLEIEN (EMAC_INTEN[8]) + * | | |is also enabled, the bit MFLEIF (EMAC_INTSTS[8]) is set and the RX interrupt is triggered. + * | | |It is recommended that only use MRFL to qualify the length of received frame while S/W wants to + * | | |receive a frame which length is greater than 1518 bytes. + * @var EMAC_T::INTEN + * Offset: 0xAC MAC Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |RXIEN |Receive Interrupt Enable Bit + * | | |The RXIEN controls the RX interrupt generation. + * | | |If RXIEN is enabled and RXIF (EMAC_INTSTS[0]) is high, EMAC generates the RX interrupt to CPU + * | | |If RXIEN is disabled, no RX interrupt is generated to CPU even any status bit EMAC_INTSTS[15:1] + * | | |is set and the corresponding bit of EMAC_INTEN is enabled + * | | |In other words, if S/W wants to receive RX interrupt from EMAC, this bit must be enabled + * | | |And, if S/W doesn't want to receive any RX interrupt from EMAC, disables this bit. + * | | |0 = RXIF (EMAC_INTSTS[0]) is masked and RX interrupt generation Disabled. + * | | |1 = RXIF (EMAC_INTSTS[0]) is not masked and RX interrupt generation Enabled. + * |[1] |CRCEIEN |CRC Error Interrupt Enable Bit + * | | |The CRCEIEN controls the CRCEIF (EMAC_INTSTS[1]) interrupt generation + * | | |If CRCEIF (EMAC_INTSTS[1]) is set, and both CRCEIEN and RXIEN (EMAC_INTEN[0]) are enabled, the + * | | |EMAC generates the RX interrupt to CPU + * | | |If CRCEIEN or RXIEN (EMAC_INTEN[0]) is disabled, no RX interrupt is generated to CPU even the + * | | |CRCEIF (EMAC_INTSTS[1]) is set. + * | | |0 = CRCEIF (EMAC_INTSTS[1]) trigger RX interrupt Disabled. + * | | |1 = CRCEIF (EMAC_INTSTS[1]) trigger RX interrupt Enabled. + * |[2] |RXOVIEN |Receive FIFO Overflow Interrupt Enable Bit + * | | |The RXOVIEN controls the RXOVIF (EMAC_INTSTS[2]) interrupt generation + * | | |If RXOVIF (EMAC_INTSTS[2]) is set, and both RXOVIEN and RXIEN (EMAC_INTEN[0]) are enabled, the + * | | |EMAC generates the RX interrupt to CPU + * | | |If RXOVIEN or RXIEN (EMAC_INTEN[0]) is disabled, no RX interrupt is generated to CPU even the + * | | |RXOVIF (EMAC_INTSTS[2]) is set. + * | | |0 = RXOVIF (EMAC_INTSTS[2]) trigger RX interrupt Disabled. + * | | |1 = RXOVIF (EMAC_INTSTS[2]) trigger RX interrupt Enabled. + * |[3] |LPIEN |Long Packet Interrupt Enable Bit + * | | |The LPIEN controls the LPIF (EMAC_INTSTS[3]) interrupt generation + * | | |If LPIF (EMAC_INTSTS[3]) is set, and both LPIEN and RXIEN (EMAC_INTEN[0]) are enabled, the EMAC + * | | |generates the RX interrupt to CPU + * | | |If LPIEN or RXIEN (EMAC_INTEN[0]) is disabled, no RX interrupt is generated to CPU even the LPIF + * | | |(EMAC_INTSTS[3]) is set. + * | | |0 = LPIF (EMAC_INTSTS[3]) trigger RX interrupt Disabled. + * | | |1 = LPIF (EMAC_INTSTS[3]) trigger RX interrupt Enabled. + * |[4] |RXGDIEN |Receive Good Interrupt Enable Bit + * | | |The RXGDIEN controls the RXGDIF (EMAC_INTSTS[4]) interrupt generation + * | | |If RXGDIF (EMAC_INTSTS[4]) is set, and both RXGDIEN and RXIEN (EMAC_INTEN[0]) are enabled, the + * | | |EMAC generates the RX interrupt to CPU + * | | |If RXGDIEN or RXIEN (EMAC_INTEN[0]) is disabled, no RX interrupt is generated to CPU even the + * | | |RXGDIF (EMAC_INTSTS[4]) is set. + * | | |0 = RXGDIF (EMAC_INTSTS[4]) trigger RX interrupt Disabled. + * | | |1 = RXGDIF (EMAC_INTSTS[4]) trigger RX interrupt Enabled. + * |[5] |ALIEIEN |Alignment Error Interrupt Enable Bit + * | | |The ALIEIEN controls the ALIEIF (EMAC_INTSTS[5]) interrupt generation + * | | |If ALIEIF (EMAC_INTSTS[5]) is set, and both ALIEIEN and RXIEN (EMAC_INTEN[0]) are enabled, the + * | | |EMAC generates the RX interrupt to CPU + * | | |If ALIEIEN or RXIEN (EMAC_INTEN[0]) is disabled, no RX interrupt is generated to CPU even the + * | | |ALIEIF (EMAC_INTSTS[5]) is set. + * | | |0 = ALIEIF (EMAC_INTSTS[5]) trigger RX interrupt Disabled. + * | | |1 = ALIEIF (EMAC_INTSTS[5]) trigger RX interrupt Enabled. + * |[6] |RPIEN |Runt Packet Interrupt Enable Bit + * | | |The RPIEN controls the RPIF (EMAC_INTSTS[6]) interrupt generation + * | | |If RPIF (EMAC_INTSTS[6]) is set, and both RPIEN and RXIEN (EMAC_INTEN[0]) are enabled, the EMAC + * | | |generates the RX interrupt to CPU + * | | |If RPIEN or RXIEN (EMAC_INTEN[0]) is disabled, no RX interrupt is generated to CPU even the + * | | |RPIF (EMAC_INTSTS[6]) is set. + * | | |0 = RPIF (EMAC_INTSTS[6]) trigger RX interrupt Disabled. + * | | |1 = RPIF (EMAC_INTSTS[6]) trigger RX interrupt Enabled. + * |[7] |MPCOVIEN |Miss Packet Counter Overrun Interrupt Enable Bit + * | | |The MPCOVIEN controls the MPCOVIF (EMAC_INTSTS[7]) interrupt generation + * | | |If MPCOVIF (EMAC_INTSTS[7]) is set, and both MPCOVIEN and RXIEN (EMAC_INTEN[0]) are enabled, + * | | |the EMAC generates the RX interrupt to CPU + * | | |If MPCOVIEN or RXIEN (EMAC_INTEN[0]) is disabled, no RX interrupt is generated to CPU even the + * | | |MPCOVIF (EMAC_INTSTS[7]) is set. + * | | |0 = MPCOVIF (EMAC_INTSTS[7]) trigger RX interrupt Disabled. + * | | |1 = MPCOVIF (EMAC_INTSTS[7]) trigger RX interrupt Enabled. + * |[8] |MFLEIEN |Maximum Frame Length Exceed Interrupt Enable Bit + * | | |The MFLEIEN controls the MFLEIF (EMAC_INTSTS[8]) interrupt generation + * | | |If MFLEIF (EMAC_INTSTS[8]) is set, and both MFLEIEN and RXIEN (EMAC_INTEN[0]) are enabled, the + * | | |EMAC generates the RX interrupt to CPU + * | | |If MFLEIEN or RXIEN (EMAC_INTEN[0]) is disabled, no RX interrupt is generated to CPU even the + * | | |MFLEIF (EMAC_INTSTS[8]) is set. + * | | |0 = MFLEIF (EMAC_INTSTS[8]) trigger RX interrupt Disabled. + * | | |1 = MFLEIF (EMAC_INTSTS[8]) trigger RX interrupt Enabled. + * |[9] |DENIEN |DMA Early Notification Interrupt Enable Bit + * | | |The DENIEN controls the DENIF (EMAC_INTSTS[9]) interrupt generation + * | | |If DENIF (EMAC_INTSTS[9]) is set, and both DENIEN and RXIEN (EMAC_INTEN[0]) are enabled, the + * | | |EMAC generates the RX interrupt to CPU + * | | |If DENIEN or RXIEN (EMAC_INTEN[0]) is disabled, no RX interrupt is generated to CPU even the + * | | |DENIF (EMAC_INTSTS[9]) is set. + * | | |0 = TDENIF (EMAC_INTSTS[9]) trigger RX interrupt Disabled. + * | | |1 = TDENIF (EMAC_INTSTS[9]) trigger RX interrupt Enabled. + * |[10] |RDUIEN |Receive Descriptor Unavailable Interrupt Enable Bit + * | | |The RDUIEN controls the RDUIF (EMAC_INTSTS[10]) interrupt generation + * | | |If RDUIF (EMAC_INTSTS[10]) is set, and both RDUIEN and RXIEN (EMAC_INTEN[0]) are enabled, the + * | | |EMAC generates the RX interrupt to CPU + * | | |If RDUIEN or RXIEN (EMAC_INTEN[0]) is disabled, no RX interrupt is generated to CPU even the + * | | |RDUIF (EMAC_MIOSTA[10]) register is set. + * | | |0 = RDUIF (EMAC_INTSTS[10]) trigger RX interrupt Disabled. + * | | |1 = RDUIF (EMAC_INTSTS[10]) trigger RX interrupt Enabled. + * |[11] |RXBEIEN |Receive Bus Error Interrupt Enable Bit + * | | |The RXBEIEN controls the RXBEIF (EMAC_INTSTS[11]) interrupt generation + * | | |If RXBEIF (EMAC_INTSTS[11]) is set, and both RXBEIEN and RXIEN (EMAC_INTEN[0]) are enabled, the + * | | |EMAC generates the RX interrupt to CPU + * | | |If RXBEIEN or RXIEN (EMAC_INTEN[0]) is disabled, no RX interrupt is generated to CPU even the + * | | |RXBEIF (EMAC_INTSTS[11]) is set. + * | | |0 = RXBEIF (EMAC_INTSTS[11]) trigger RX interrupt Disabled. + * | | |1 = RXBEIF (EMAC_INTSTS[11]) trigger RX interrupt Enabled. + * |[14] |CFRIEN |Control Frame Receive Interrupt Enable Bit + * | | |The CFRIEN controls the CFRIF (EMAC_INTSTS[14]) interrupt generation + * | | |If CFRIF (EMAC_INTSTS[14]) is set, and both CFRIEN and RXIEN (EMAC_INTEN[0]) are enabled, the + * | | |EMAC generates the RX interrupt to CPU + * | | |If CFRIEN or RXIEN (EMAC_INTEN[0]) is disabled, no RX interrupt is generated to CPU even the + * | | |CFRIF (EMAC_INTSTS[14]) register is set. + * | | |0 = CFRIF (EMAC_INTSTS[14]) trigger RX interrupt Disabled. + * | | |1 = CFRIF (EMAC_INTSTS[14]) trigger RX interrupt Enabled. + * |[15] |WOLIEN |Wake on LAN Interrupt Enable Bit + * | | |The WOLIEN controls the WOLIF (EMAC_INTSTS[15]) interrupt generation + * | | |If WOLIF (EMAC_INTSTS[15]) is set, and both WOLIEN and RXIEN (EMAC_INTEN[0]) are enabled, + * | | |the EMAC generates the RX interrupt to CPU + * | | |If WOLIEN or RXIEN (EMAC_INTEN[0]) is disabled, no RX interrupt is generated to CPU even the + * | | |WOLIF (EMAC_INTSTS[15]) is set. + * | | |0 = WOLIF (EMAC_INTSTS[15]) trigger RX interrupt Disabled. + * | | |1 = WOLIF (EMAC_INTSTS[15]) trigger RX interrupt Enabled. + * |[16] |TXIEN |Transmit Interrupt Enable Bit + * | | |The TXIEN controls the TX interrupt generation. + * | | |If TXIEN is enabled and TXIF (EMAC_INTSTS[16]) is high, EMAC generates the TX interrupt to CPU + * | | |If TXIEN is disabled, no TX interrupt is generated to CPU even any status bit of + * | | |EMAC_INTSTS[24:17] set and the corresponding bit of EMAC_INTEN is enabled + * | | |In other words, if S/W wants to receive TX interrupt from EMAC, this bit must be enabled + * | | |And, if S/W doesn't want to receive any TX interrupt from EMAC, disables this bit. + * | | |0 = TXIF (EMAC_INTSTS[16]) is masked and TX interrupt generation Disabled. + * | | |1 = TXIF (EMAC_INTSTS[16]) is not masked and TX interrupt generation Enabled. + * |[17] |TXUDIEN |Transmit FIFO Underflow Interrupt Enable Bit + * | | |The TXUDIEN controls the TXUDIF (EMAC_INTSTS[17]) interrupt generation + * | | |If TXUDIF (EMAC_INTSTS[17]) is set, and both TXUDIEN and TXIEN (EMAC_INTEN[16]) are enabled, + * | | |the EMAC generates the TX interrupt to CPU + * | | |If TXUDIEN or TXIEN (EMAC_INTEN[16]) is disabled, no TX interrupt is generated to CPU even + * | | |the TXUDIF (EMAC_INTSTS[17]) is set. + * | | |0 = TXUDIF (EMAC_INTSTS[17]) TX interrupt Disabled. + * | | |1 = TXUDIF (EMAC_INTSTS[17]) TX interrupt Enabled. + * |[18] |TXCPIEN |Transmit Completion Interrupt Enable Bit + * | | |The TXCPIEN controls the TXCPIF (EMAC_INTSTS[18]) interrupt generation + * | | |If TXCPIF (EMAC_INTSTS[18]) is set, and both TXCPIEN and TXIEN (EMAC_INTEN[16]) are enabled, + * | | |the EMAC generates the TX interrupt to CPU + * | | |If TXCPIEN or TXIEN (EMAC_INTEN[16]) is disabled, no TX interrupt is generated to CPU even the + * | | |TXCPIF (EMAC_INTSTS[18]) is set. + * | | |0 = TXCPIF (EMAC_INTSTS[18]) trigger TX interrupt Disabled. + * | | |1 = TXCPIF (EMAC_INTSTS[18]) trigger TX interrupt Enabled. + * |[19] |EXDEFIEN |Defer Exceed Interrupt Enable Bit + * | | |The EXDEFIEN controls the EXDEFIF (EMAC_INTSTS[19]) interrupt generation + * | | |If EXDEFIF (EMAC_INTSTS[19]) is set, and both EXDEFIEN and TXIEN (EMAC_INTEN[16]) are enabled, + * | | |the EMAC generates the TX interrupt to CPU + * | | |If EXDEFIEN or TXIEN (EMAC_INTEN[16]) is disabled, no TX interrupt is generated to CPU even the + * | | |EXDEFIF (EMAC_INTSTS[19]) is set. + * | | |0 = EXDEFIF (EMAC_INTSTS[19]) trigger TX interrupt Disabled. + * | | |1 = EXDEFIF (EMAC_INTSTS[19]) trigger TX interrupt Enabled. + * |[20] |NCSIEN |No Carrier Sense Interrupt Enable Bit + * | | |The NCSIEN controls the NCSIF (EMAC_INTSTS[20]) interrupt generation + * | | |If NCSIF (EMAC_INTSTS[20]) is set, and both NCSIEN and TXIEN (EMAC_INTEN[16]) are enabled, the + * | | |EMAC generates the TX interrupt to CPU + * | | |If NCSIEN or TXIEN (EMAC_INTEN[16]) is disabled, no TX interrupt is generated to CPU even the + * | | |NCSIF (EMAC_INTSTS[20]) is set. + * | | |0 = NCSIF (EMAC_INTSTS[20]) trigger TX interrupt Disabled. + * | | |1 = NCSIF (EMAC_INTSTS[20]) trigger TX interrupt Enabled. + * |[21] |TXABTIEN |Transmit Abort Interrupt Enable Bit + * | | |The TXABTIEN controls the TXABTIF (EMAC_INTSTS[21]) interrupt generation + * | | |If TXABTIF (EMAC_INTSTS[21]) is set, and both TXABTIEN and TXIEN (EMAC_INTEN[16]) are enabled, + * | | |the EMAC generates the TX interrupt to CPU + * | | |If TXABTIEN or TXIEN (EMAC_INTEN[16]) is disabled, no TX interrupt is generated to CPU even the + * | | |TXABTIF (EMAC_INTSTS[21]) is set. + * | | |0 = TXABTIF (EMAC_INTSTS[21]) trigger TX interrupt Disabled. + * | | |1 = TXABTIF (EMAC_INTSTS[21]) trigger TX interrupt Enabled. + * |[22] |LCIEN |Late Collision Interrupt Enable Bit + * | | |The LCIEN controls the LCIF (EMAC_INTSTS[22]) interrupt generation + * | | |If LCIF (EMAC_INTSTS[22]) is set, and both LCIEN and TXIEN (EMAC_INTEN[16]) are enabled, the + * | | |EMAC generates the TX interrupt to CPU + * | | |If LCIEN or TXIEN (EMAC_INTEN[16]) is disabled, no TX interrupt is generated to CPU even the + * | | |LCIF (EMAC_INTSTS[22]) is set. + * | | |0 = LCIF (EMAC_INTSTS[22]) trigger TX interrupt Disabled. + * | | |1 = LCIF (EMAC_INTSTS[22]) trigger TX interrupt Enabled. + * |[23] |TDUIEN |Transmit Descriptor Unavailable Interrupt Enable Bit + * | | |The TDUIEN controls the TDUIF (EMAC_INTSTS[23]) interrupt generation + * | | |If TDUIF (EMAC_INTSTS[23]) is set, and both TDUIEN and TXIEN (EMAC_INTEN[16]) are enabled, the + * | | |EMAC generates the TX interrupt to CPU + * | | |If TDUIEN or TXIEN (EMAC_INTEN[16]) is disabled, no TX interrupt is generated to CPU even the + * | | |TDUIF (EMAC_INTSTS[23]) is set. + * | | |0 = TDUIF (EMAC_INTSTS[23]) trigger TX interrupt Disabled. + * | | |1 = TDUIF (EMAC_INTSTS[23]) trigger TX interrupt Enabled. + * |[24] |TXBEIEN |Transmit Bus Error Interrupt Enable Bit + * | | |The TXBEIEN controls the TXBEIF (EMAC_INTSTS[24]) interrupt generation + * | | |If TXBEIF (EMAC_INTSTS[24]) is set, and both TXBEIEN and TXIEN (EMAC_INTEN[16]) are enabled, the + * | | |EMAC generates the TX interrupt to CPU + * | | |If TXBEIEN or TXIEN (EMAC_INTEN[16]) is disabled, no TX interrupt is generated to CPU even the + * | | |TXBEIF (EMAC_INTSTS[24]) is set. + * | | |0 = TXBEIF (EMAC_INTSTS[24]) trigger TX interrupt Disabled. + * | | |1 = TXBEIF (EMAC_INTSTS[24]) trigger TX interrupt Enabled. + * |[28] |TSALMIEN |Time Stamp Alarm Interrupt Enable Bit + * | | |The TSALMIEN controls the TSALMIF (EMAC_INTSTS[28]) interrupt generation + * | | |If TSALMIF (EMAC_INTSTS[28]) is set, and both TSALMIEN and TXIEN (EMAC_INTEN[16]) enabled, the + * | | |EMAC generates the TX interrupt to CPU + * | | |If TSALMIEN or TXIEN (EMAC_INTEN[16]) disabled, no TX interrupt generated to CPU even the + * | | |TXTSALMIF (EMAC_INTEN[28]) is set. + * | | |0 = TXTSALMIF (EMAC_INTSTS[28]) trigger TX interrupt Disabled. + * | | |1 = TXTSALMIF (EMAC_INTSTS[28]) trigger TX interrupt Enabled. + * @var EMAC_T::INTSTS + * Offset: 0xB0 MAC Interrupt Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |RXIF |Receive Interrupt + * | | |The RXIF indicates the RX interrupt status. + * | | |If RXIF high and its corresponding enable bit, RXIEN (EMAC_INTEN[0]), is also high indicates + * | | |the EMAC generates RX interrupt to CPU + * | | |If RXIF is high but RXIEN (EMAC_INTEN[0]) is disabled, no RX interrupt is generated. + * | | |The RXIF is logic OR result of bit logic AND result of EMAC_INTSTS[15:1] and EMAC_INTEN[15:1] + * | | |In other words, if any bit of EMAC_INTSTS[15:1] is high and its corresponding enable bit in + * | | |EMAC_INTEN[15:1] is also enabled, the RXIF will be high. + * | | |Because the RXIF is a logic OR result, clears EMAC_INTSTS[15:1] makes RXIF be cleared, too. + * | | |0 = No status bit in EMAC_INTSTS[15:1] is set or no enable bit in EMAC_INTEN[15:1] is enabled. + * | | |1 = At least one status in EMAC_INTSTS[15:1] is set and its corresponding enable bit in + * | | |EMAC_INTEN[15:1] is enabled, too. + * |[1] |CRCEIF |CRC Error Interrupt + * | | |The CRCEIF high indicates the incoming packet incurred the CRC error and the packet is dropped + * | | |If the AEP (EMAC_CTL[4]) is set, the CRC error packet will be regarded as a good packet and + * | | |CRCEIF will not be set. + * | | |If the CRCEIF is high and CRCEIEN (EMAC_INTEN[1]) is enabled, the RXIF will be high + * | | |Write 1 to this bit clears the CRCEIF status. + * | | |0 = The frame does not incur CRC error. + * | | |1 = The frame incurred CRC error. + * |[2] |RXOVIF |Receive FIFO Overflow Interrupt + * | | |The RXOVIF high indicates the RXFIFO overflow occurred during packet reception + * | | |While the RXFIFO overflow occurred, the EMAC drops the current receiving packer + * | | |If the RXFIFO overflow occurred often, it is recommended that modify RXFIFO threshold control, + * | | |the RXFIFOTH of FFTCR register, to higher level. + * | | |If the RXOVIF is high and RXOVIEN (EMAC_INTEN[2]) is enabled, the RXIF will be high + * | | |Write 1 to this bit clears the RXOVIF status. + * | | |0 = No RXFIFO overflow occurred during packet reception. + * | | |1 = RXFIFO overflow occurred during packet reception. + * |[3] |LPIF |Long Packet Interrupt Flag + * | | |The LPIF high indicates the length of the incoming packet is greater than 1518 bytes and the + * | | |incoming packet is dropped + * | | |If the ALP (EMAC_CTL[1]) is set, the long packet will be regarded as a good packet and LPIF will not be set. + * | | |If the LPIF is high and LPIEN (EMAC_INTEN[3]) is enabled, the RXIF will be high + * | | |Write 1 to this bit clears the LPIF status. + * | | |0 = The incoming frame is not a long frame or S/W wants to receive a long frame. + * | | |1 = The incoming frame is a long frame and dropped. + * |[4] |RXGDIF |Receive Good Interrupt + * | | |The RXGDIF high indicates the frame reception has completed. + * | | |If the RXGDIF is high and RXGDIEN (EAMC_MIEN[4]) is enabled, the RXIF will be high + * | | |Write 1 to this bit clears the RXGDIF status. + * | | |0 = The frame reception has not complete yet. + * | | |1 = The frame reception has completed. + * |[5] |ALIEIF |Alignment Error Interrupt + * | | |The ALIEIF high indicates the length of the incoming frame is not a multiple of byte + * | | |If the ALIEIF is high and ALIEIEN (EMAC_INTEN[5]) is enabled, the RXIF will be high + * | | |Write 1 to this bit clears the ALIEIF status. + * | | |0 = The frame length is a multiple of byte. + * | | |1 = The frame length is not a multiple of byte. + * |[6] |RPIF |Runt Packet Interrupt + * | | |The RPIF high indicates the length of the incoming packet is less than 64 bytes and the packet is dropped + * | | |If the ARP (EMAC_CTL[2]) is set, the short packet is regarded as a good packet and RPIF will not be set. + * | | |If the RPIF is high and RPIEN (EMAC_INTEN[6]) is enabled, the RXIF will be high + * | | |Write 1 to this bit clears the RPIF status. + * | | |0 = The incoming frame is not a short frame or S/W wants to receive a short frame. + * | | |1 = The incoming frame is a short frame and dropped. + * |[7] |MPCOVIF |Missed Packet Counter Overrun Interrupt Flag + * | | |The MPCOVIF high indicates the MPCNT, Missed Packet Count, has overflow + * | | |If the MPCOVIF is high and MPCOVIEN (EMAC_INTEN[7]) is enabled, the RXIF will be high + * | | |Write 1 to this bit clears the MPCOVIF status. + * | | |0 = The MPCNT has not rolled over yet. + * | | |1 = The MPCNT has rolled over yet. + * |[8] |MFLEIF |Maximum Frame Length Exceed Interrupt Flag + * | | |The MFLEIF high indicates the length of the incoming packet has exceeded the length limitation + * | | |configured in DMARFC register and the incoming packet is dropped + * | | |If the MFLEIF is high and MFLEIEN (EMAC_INTEN[8]) is enabled, the RXIF will be high + * | | |Write 1 to this bit clears the MFLEIF status. + * | | |0 = The length of the incoming packet does not exceed the length limitation configured in DMARFC. + * | | |1 = The length of the incoming packet has exceeded the length limitation configured in DMARFC. + * |[9] |DENIF |DMA Early Notification Interrupt + * | | |The DENIF high indicates the EMAC has received the LENGTH field of the incoming packet. + * | | |If the DENIF is high and DENIENI (EMAC_INTEN[9]) is enabled, the RXIF will be high + * | | |Write 1 to this bit clears the DENIF status. + * | | |0 = The LENGTH field of incoming packet has not received yet. + * | | |1 = The LENGTH field of incoming packet has received. + * |[10] |RDUIF |Receive Descriptor Unavailable Interrupt + * | | |The RDUIF high indicates that there is no available RX descriptor for packet reception and + * | | |RXDMA will stay at Halt state + * | | |Once, the RXDMA enters the Halt state, S/W must issues a write command to RSDR register to + * | | |make RXDMA leave Halt state while new RX descriptor is available. + * | | |If the RDUIF is high and RDUIEN (EMAC_INTEN[10]) is enabled, the RXIF will be high + * | | |Write 1 to this bit clears the RDUIF status. + * | | |0 = RX descriptor is available. + * | | |1 = RX descriptor is unavailable. + * |[11] |RXBEIF |Receive Bus Error Interrupt + * | | |The RXBEIF high indicates the memory controller replies ERROR response while EMAC access + * | | |system memory through RXDMA during packet reception process + * | | |Reset EMAC is recommended while RXBEIF status is high. + * | | |If the RXBEIF is high and RXBEIEN (EMAC_INTEN[11]) is enabled, the RXIF will be high + * | | |Write 1 to this bit clears the RXBEIF status. + * | | |0 = No ERROR response is received. + * | | |1 = ERROR response is received. + * |[14] |CFRIF |Control Frame Receive Interrupt + * | | |The CFRIF high indicates EMAC receives a flow control frame + * | | |The CFRIF only available while EMAC is operating on full duplex mode. + * | | |If the CFRIF is high and CFRIEN (EMAC_INTEN[14]) is enabled, the RXIF will be high + * | | |Write 1 to this bit clears the CFRIF status. + * | | |0 = The EMAC does not receive the flow control frame. + * | | |1 = The EMAC receives a flow control frame. + * |[15] |WOLIF |Wake on LAN Interrupt Flag + * | | |The WOLIF high indicates EMAC receives a Magic Packet + * | | |The CFRIF only available while system is in power down mode and WOLEN is set high. + * | | |If the WOLIF is high and WOLIEN (EMAC_INTEN[15]) is enabled, the RXIF will be high + * | | |Write 1 to this bit clears the WOLIF status. + * | | |0 = The EMAC does not receive the Magic Packet. + * | | |1 = The EMAC receives a Magic Packet. + * |[16] |TXIF |Transmit Interrupt + * | | |The TXIF indicates the TX interrupt status. + * | | |If TXIF high and its corresponding enable bit, TXIEN (EMAC_INTEN[16]), is also high indicates + * | | |the EMAC generates TX interrupt to CPU + * | | |If TXIF is high but TXIEN (EMAC_INTEN[16]) is disabled, no TX interrupt is generated. + * | | |The TXIF is logic OR result of bit logic AND result of EMAC_INTSTS[28:17] and EMAC_INTEN[28:17] + * | | |In other words, if any bit of EMAC_INTSTS[28:17] is high and its corresponding enable bit + * | | |in EMAC_INTEN[28:17] is also enabled, the TXIF will be high + * | | |Because the TXIF is a logic OR result, clears EMAC_INTSTS[28:17] makes TXIF be cleared, too. + * | | |0 = No status bit in EMAC_INTSTS[28:17] is set or no enable bit in EMAC_INTEN[28:17] is enabled. + * | | |1 = At least one status in EMAC_INTSTS[28:17] is set and its corresponding enable bit + * | | |in EMAC_INTEN[28:17] is enabled, too. + * |[17] |TXUDIF |Transmit FIFO Underflow Interrupt + * | | |The TXUDIF high indicates the TXFIFO underflow occurred during packet transmission + * | | |While the TXFIFO underflow occurred, the EMAC will retransmit the packet automatically + * | | |without S/W intervention + * | | |If the TXFIFO underflow occurred often, it is recommended that modify TXFIFO threshold control, + * | | |the TXFIFOTH of FFTCR register, to higher level. + * | | |If the TXUDIF is high and TXUDIEN (EMAC_INTEN[17]) is enabled, the TXIF will be high + * | | |Write 1 to this bit clears the TXUDIF status. + * | | |0 = No TXFIFO underflow occurred during packet transmission. + * | | |1 = TXFIFO underflow occurred during packet transmission. + * |[18] |TXCPIF |Transmit Completion Interrupt + * | | |The TXCPIF indicates the packet transmission has completed correctly. + * | | |If the TXCPIF is high and TXCPIEN (EMAC_INTEN[18]) is enabled, the TXIF will be high + * | | |Write 1 to this bit clears the TXCPIF status. + * | | |0 = The packet transmission not completed. + * | | |1 = The packet transmission has completed. + * |[19] |EXDEFIF |Defer Exceed Interrupt + * | | |The EXDEFIF high indicates the frame waiting for transmission has deferred over 0.32768ms + * | | |on 100Mbps mode, or 3.2768ms on 10Mbps mode. + * | | |The deferral exceed check will only be done while bit NODEF of MCMDR is disabled, and EMAC + * | | |is operating on half-duplex mode. + * | | |If the EXDEFIF is high and EXDEFIEN (EMAC_INTEN[19]) is enabled, the TXIF will be high + * | | |Write 1 to this bit clears the EXDEFIF status. + * | | |0 = Frame waiting for transmission has not deferred over 0.32768ms (100Mbps) or 3.2768ms (10Mbps). + * | | |1 = Frame waiting for transmission has deferred over 0.32768ms (100Mbps) or 3.2768ms (10Mbps). + * |[20] |NCSIF |No Carrier Sense Interrupt + * | | |The NCSIF high indicates the MII I/F signal CRS does not active at the start of or during + * | | |the packet transmission + * | | |The NCSIF is only available while EMAC is operating on half-duplex mode + * | | |If the NCSIF is high and NCSIEN (EMAC_INTEN[20]) is enabled, the TXIF will be high. + * | | |Write 1 to this bit clears the NCSIF status. + * | | |0 = CRS signal actives correctly. + * | | |1 = CRS signal does not active at the start of or during the packet transmission. + * |[21] |TXABTIF |Transmit Abort Interrupt + * | | |The TXABTIF high indicates the packet incurred 16 consecutive collisions during transmission, + * | | |and then the transmission process for this packet is aborted + * | | |The transmission abort is only available while EMAC is operating on half-duplex mode. + * | | |If the TXABTIF is high and TXABTIEN (EMAC_INTEN[21]) is enabled, the TXIF will be high + * | | |Write 1 to this bit clears the TXABTIF status. + * | | |0 = Packet does not incur 16 consecutive collisions during transmission. + * | | |1 = Packet incurred 16 consecutive collisions during transmission. + * |[22] |LCIF |Late Collision Interrupt + * | | |The LCIF high indicates the collision occurred in the outside of 64 bytes collision window + * | | |This means after the 64 bytes of a frame has been transmitted out to the network, the collision + * | | |still occurred. + * | | |The late collision check will only be done while EMAC is operating on half-duplex mode + * | | |If the LCIF is high and LCIEN (EMAC_INTEN[22]) is enabled, the TXIF will be high. + * | | |Write 1 to this bit clears the LCIF status. + * | | |0 = No collision occurred in the outside of 64 bytes collision window. + * | | |1 = Collision occurred in the outside of 64 bytes collision window. + * |[23] |TDUIF |Transmit Descriptor Unavailable Interrupt + * | | |The TDUIF high indicates that there is no available TX descriptor for packet transmission and + * | | |TXDMA will stay at Halt state. + * | | |Once, the TXDMA enters the Halt state, S/W must issues a write command to TSDR register to make + * | | |TXDMA leave Halt state while new TX descriptor is available. + * | | |If the TDUIF is high and TDUIEN (EMAC_INTEN[23]) is enabled, the TXIF will be high. + * | | |Write 1 to this bit clears the TDUIF status. + * | | |0 = TX descriptor is available. + * | | |1 = TX descriptor is unavailable. + * |[24] |TXBEIF |Transmit Bus Error Interrupt + * | | |The TXBEIF high indicates the memory controller replies ERROR response while EMAC access system + * | | |memory through TXDMA during packet transmission process + * | | |Reset EMAC is recommended while TXBEIF status is high. + * | | |If the TXBEIF is high and TXBEIEN (EMAC_INTEN[24]) is enabled, the TXIF will be high. + * | | |Write 1 to this bit clears the TXBEIF status. + * | | |0 = No ERROR response is received. + * | | |1 = ERROR response is received. + * |[28] |TSALMIF |Time Stamp Alarm Interrupt + * | | |The TSALMIF high indicates the EMAC_TSSEC register value equals to EMAC_ALMSEC register and + * | | |EMAC_TSSUBSEC register value equals to register EMAC_ALMSUBLSR. + * | | |If TSALMIF is high and TSALMIEN (EMAC_INTEN[28]) enabled, the TXIF will be high. + * | | |Write 1 to this bit clears the TSALMIF status. + * | | |0 = EMAC_TSSEC did not equal EMAC_ALMSEC or EMAC_TSSUBSEC did not equal EMAC_ALMSUBSEC. + * | | |1 = EMAC_TSSEC equals EMAC_ALMSEC and EMAC_TSSUBSEC equals EMAC_ALMSUBSEC. + * @var EMAC_T::GENSTS + * Offset: 0xB4 MAC General Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CFR |Control Frame Received + * | | |The CFRIF high indicates EMAC receives a flow control frame + * | | |The CFRIF only available while EMAC is operating on full duplex mode. + * | | |0 = The EMAC does not receive the flow control frame. + * | | |1 = The EMAC receives a flow control frame. + * |[1] |RXHALT |Receive Halted + * | | |The RXHALT high indicates the next normal packet reception process will be halted because + * | | |the bit RXON of MCMDR is disabled be S/W. + * | | |0 = Next normal packet reception process will go on. + * | | |1 = Next normal packet reception process will be halted. + * |[2] |RXFFULL |RXFIFO Full + * | | |The RXFFULL indicates the RXFIFO is full due to four 64-byte packets are kept in RXFIFO + * | | |and the following incoming packet will be dropped. + * | | |0 = The RXFIFO is not full. + * | | |1 = The RXFIFO is full and the following incoming packet will be dropped. + * |[7:4] |COLCNT |Collision Count + * | | |The COLCNT indicates that how many collisions occurred consecutively during a packet transmission + * | | |If the packet incurred 16 consecutive collisions during transmission, the COLCNT will be + * | | |0 and bit TXABTIF will be set to 1. + * |[8] |DEF |Deferred Transmission + * | | |The DEF high indicates the packet transmission has deferred once + * | | |The DEF is only available while EMAC is operating on half-duplex mode. + * | | |0 = Packet transmission does not defer. + * | | |1 = Packet transmission has deferred once. + * |[9] |TXPAUSED |Transmission Paused + * | | |The TXPAUSED high indicates the next normal packet transmission process will be paused temporally + * | | |because EMAC received a PAUSE control frame. + * | | |0 = Next normal packet transmission process will go on. + * | | |1 = Next normal packet transmission process will be paused. + * |[10] |SQE |Signal Quality Error + * | | |The SQE high indicates the SQE error found at end of packet transmission on 10Mbps half-duplex mode + * | | |The SQE error check will only be done while both bit SQECHKEN (EMAC_CTL[17]) is enabled and EMAC + * | | |is operating on 10Mbps half-duplex mode. + * | | |0 = No SQE error found at end of packet transmission. + * | | |1 = SQE error found at end of packet transmission. + * |[11] |TXHALT |Transmission Halted + * | | |The TXHALT high indicates the next normal packet transmission process will be halted because + * | | |the bit TXON (EMAC_CTL[8]) is disabled be S/W. + * | | |0 = Next normal packet transmission process will go on. + * | | |1 = Next normal packet transmission process will be halted. + * |[12] |RPSTS |Remote Pause Status + * | | |The RPSTS indicates that remote pause counter down counting actives. + * | | |After Ethernet MAC controller sent PAUSE frame out successfully, it starts the remote pause + * | | |counter down counting + * | | |When this bit high, it's predictable that remote Ethernet MAC controller wouldn't start the packet + * | | |transmission until the down counting done. + * | | |0 = Remote pause counter down counting done. + * | | |1 = Remote pause counter down counting actives. + * @var EMAC_T::MPCNT + * Offset: 0xB8 Missed Packet Count Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |MPCNT |Miss Packet Count + * | | |The MPCNT indicates the number of packets that were dropped due to various types of receive errors + * | | |The following type of receiving error makes missed packet counter increase: + * | | |1. Incoming packet is incurred RXFIFO overflow. + * | | |2. Incoming packet is dropped due to RXON is disabled. + * | | |3. Incoming packet is incurred CRC error. + * @var EMAC_T::RPCNT + * Offset: 0xBC MAC Receive Pause Count Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |RPCNT |MAC Receive Pause Count + * | | |The RPCNT keeps the OPERAND field of the PAUSE control frame + * | | |It indicates how many slot time (512 bit time) the TX of EMAC will be paused. + * @var EMAC_T::FRSTS + * Offset: 0xC8 DMA Receive Frame Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |RXFLT |Receive Frame LENGTH + * | | |The RXFLT keeps the LENGTH field of each incoming Ethernet packet + * | | |If the bit DENIEN (EMAC_INTEN[9]) is enabled and the LENGTH field of incoming packet has + * | | |received, the bit DENIF (EMAC_INTSTS[9]) will be set and trigger interrupt. + * | | |And, the content of LENGTH field will be stored in RXFLT. + * @var EMAC_T::CTXDSA + * Offset: 0xCC Current Transmit Descriptor Start Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |CTXDSA |Current Transmit Descriptor Start Address + * | | |The CTXDSA keeps the start address of TX descriptor that is used by TXDMA currently + * | | |The CTXDSA is read only and write to this register has no effect. + * @var EMAC_T::CTXBSA + * Offset: 0xD0 Current Transmit Buffer Start Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |CTXBSA |Current Transmit Buffer Start Address + * | | |The CTXDSA keeps the start address of TX frame buffer that is used by TXDMA currently + * | | |The CTXBSA is read only and write to this register has no effect. + * @var EMAC_T::CRXDSA + * Offset: 0xD4 Current Receive Descriptor Start Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |CRXDSA |Current Receive Descriptor Start Address + * | | |The CRXDSA keeps the start address of RX descriptor that is used by RXDMA currently + * | | |The CRXDSA is read only and write to this register has no effect. + * @var EMAC_T::CRXBSA + * Offset: 0xD8 Current Receive Buffer Start Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |CRXBSA |Current Receive Buffer Start Address + * | | |The CRXBSA keeps the start address of RX frame buffer that is used by RXDMA currently + * | | |The CRXBSA is read only and write to this register has no effect. + * @var EMAC_T::TSCTL + * Offset: 0x100 Time Stamp Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |TSEN |Time Stamp Function Enable Bit + * | | |This bit controls if the IEEE 1588 PTP time stamp function is enabled or not. + * | | |Set this bit high to enable IEEE 1588 PTP time stamp function while set this bit low + * | | |to disable IEEE 1588 PTP time stamp function. + * | | |0 = I EEE 1588 PTP time stamp function Disabled. + * | | |1 = IEEE 1588 PTP time stamp function Enabled. + * |[1] |TSIEN |Time Stamp Counter Initialization Enable Bit + * | | |Set this bit high enables Ethernet MAC controller to load value of register EMAC_UPDSEC + * | | |and EMAC_UPDSUBSEC to PTP time stamp counter. + * | | |After the load operation finished, Ethernet MAC controller clear this bit to low automatically. + * | | |0 = Time stamp counter initialization done. + * | | |1 = Time stamp counter initialization Enabled. + * |[2] |TSMODE |Time Stamp Fine Update Enable Bit + * | | |This bit chooses the time stamp counter update mode. + * | | |0 = Time stamp counter is in coarse update mode. + * | | |1 = Time stamp counter is in fine update mode. + * |[3] |TSUPDATE |Time Stamp Counter Time Update Enable Bit + * | | |Set this bit high enables Ethernet MAC controller to add value of register EMAC_UPDSEC and + * | | |EMAC_UPDSUBSEC to PTP time stamp counter. + * | | |After the add operation finished, Ethernet MAC controller clear this bit to low automatically. + * | | |0 = No action. + * | | |1 = EMAC_UPDSEC updated to EMAC_TSSEC and EMAC_UPDSUBSEC updated to EMAC_TSSUBSEC. + * |[5] |TSALMEN |Time Stamp Alarm Enable Bit + * | | |Set this bit high enable Ethernet MAC controller to set TSALMIF (EMAC_INTSTS[28]) high when + * | | |EMAC_TSSEC equals to EMAC_ALMSEC and EMAC_TSSUBSEC equals to EMAC_ALMSUBSEC. + * | | |0 = Alarm disabled when EMAC_TSSEC equals to EMAC_ALMSEC and EMAC_TSSUBSEC equals to EMAC_ALMSUBSEC. + * | | |1 = Alarm enabled when EMAC_TSSEC equals to EMAC_ALMSEC and EMAC_TSSUBSEC equals to EMAC_ALMSUBSEC. + * @var EMAC_T::TSSEC + * Offset: 0x110 Time Stamp Counter Second Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |SEC |Time Stamp Counter Second + * | | |This register reflects the bit [63:32] value of 64-bit reference timing counter + * | | |This 32-bit value is used as the second part of time stamp when TSEN (EMAC_TSCTL[0]) is high. + * @var EMAC_T::TSSUBSEC + * Offset: 0x114 Time Stamp Counter Sub Second Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |SUBSEC |Time Stamp Counter Sub-second + * | | |This register reflects the bit [31:0] value of 64-bit reference timing counter + * | | |This 32-bit value is used as the sub-second part of time stamp when TSEN (EMAC_TSCTL[0]) is high. + * @var EMAC_T::TSINC + * Offset: 0x118 Time Stamp Increment Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |CNTINC |Time Stamp Counter Increment + * | | |Time stamp counter increment value. + * | | |If TSEN (EMAC_TSCTL[0]) is high, EMAC adds EMAC_TSSUBSEC with this 8-bit value every + * | | |time when it wants to increase the EMAC_TSSUBSEC value. + * @var EMAC_T::TSADDEND + * Offset: 0x11C Time Stamp Addend Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |ADDEND |Time Stamp Counter Addend + * | | |This register keeps a 32-bit value for accumulator to enable increment of EMAC_TSSUBSEC. + * | | |If TSEN (EMAC_TSCTL[0]) and TSMODE (EMAC_TSCTL[2]) are both high, EMAC increases accumulator + * | | |with this 32-bit value in each HCLK + * | | |Once the accumulator is overflow, it generates a enable to increase EMAC_TSSUBSEC with an 8-bit + * | | |value kept in register EMAC_TSINC. + * @var EMAC_T::UPDSEC + * Offset: 0x120 Time Stamp Update Second Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |SEC |Time Stamp Counter Second Update + * | | |When TSIEN (EMAC_TSCTL[1]) is high + * | | |EMAC loads this 32-bit value to EMAC_TSSEC directly + * | | |When TSUPDATE (EMAC_TSCTL[3]) is high, EMAC increases EMAC_TSSEC with this 32-bit value. + * @var EMAC_T::UPDSUBSEC + * Offset: 0x124 Time Stamp Update Sub Second Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |SUBSEC |Time Stamp Counter Sub-second Update + * | | |When TSIEN (EMAC_TSCTL[1]) is high + * | | |EMAC loads this 32-bit value to EMAC_TSSUBSEC directly + * | | |When TSUPDATE (EMAC_TSCTL[3]) is high, EMAC increases EMAC_TSSUBSEC with this 32-bit value. + * @var EMAC_T::ALMSEC + * Offset: 0x128 Time Stamp Alarm Second Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |SEC |Time Stamp Counter Second Alarm + * | | |Time stamp counter second part alarm value. + * | | |This value is only useful when ALMEN (EMAC_TSCTL[5]) high + * | | |If ALMEN (EMAC_TSCTL[5]) is high, EMAC_TSSEC equals to EMAC_ALMSEC and EMAC_TSSUBSEC equals to + * | | |EMAC_ALMSUBSEC, Ethernet MAC controller set TSALMIF (EMAC_INTSTS[28]) high. + * @var EMAC_T::ALMSUBSEC + * Offset: 0x12C Time Stamp Alarm Sub Second Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |SUBSEC |Time Stamp Counter Sub-second Alarm + * | | |Time stamp counter sub-second part alarm value. + * | | |This value is only useful when ALMEN (EMAC_TSCTL[5]) high + * | | |If ALMEN (EMAC_TSCTL[5]) is high, EMAC_TSSEC equals to EMAC_ALMSEC and EMAC_TSSUBSEC equals to + * | | |EMAC_ALMSUBSEC, Ethernet MAC controller set TSALMIF (EMAC_INTSTS[28]) high. + */ + __IO uint32_t CAMCTL; /*!< [0x0000] CAM Comparison Control Register */ + __IO uint32_t CAMEN; /*!< [0x0004] CAM Enable Register */ + __IO uint32_t CAM0M; /*!< [0x0008] CAM0 Most Significant Word Register */ + __IO uint32_t CAM0L; /*!< [0x000c] CAM0 Least Significant Word Register */ + __IO uint32_t CAM1M; /*!< [0x0010] CAM1 Most Significant Word Register */ + __IO uint32_t CAM1L; /*!< [0x0014] CAM1 Least Significant Word Register */ + __IO uint32_t CAM2M; /*!< [0x0018] CAM2 Most Significant Word Register */ + __IO uint32_t CAM2L; /*!< [0x001c] CAM2 Least Significant Word Register */ + __IO uint32_t CAM3M; /*!< [0x0020] CAM3 Most Significant Word Register */ + __IO uint32_t CAM3L; /*!< [0x0024] CAM3 Least Significant Word Register */ + __IO uint32_t CAM4M; /*!< [0x0028] CAM4 Most Significant Word Register */ + __IO uint32_t CAM4L; /*!< [0x002c] CAM4 Least Significant Word Register */ + __IO uint32_t CAM5M; /*!< [0x0030] CAM5 Most Significant Word Register */ + __IO uint32_t CAM5L; /*!< [0x0034] CAM5 Least Significant Word Register */ + __IO uint32_t CAM6M; /*!< [0x0038] CAM6 Most Significant Word Register */ + __IO uint32_t CAM6L; /*!< [0x003c] CAM6 Least Significant Word Register */ + __IO uint32_t CAM7M; /*!< [0x0040] CAM7 Most Significant Word Register */ + __IO uint32_t CAM7L; /*!< [0x0044] CAM7 Least Significant Word Register */ + __IO uint32_t CAM8M; /*!< [0x0048] CAM8 Most Significant Word Register */ + __IO uint32_t CAM8L; /*!< [0x004c] CAM8 Least Significant Word Register */ + __IO uint32_t CAM9M; /*!< [0x0050] CAM9 Most Significant Word Register */ + __IO uint32_t CAM9L; /*!< [0x0054] CAM9 Least Significant Word Register */ + __IO uint32_t CAM10M; /*!< [0x0058] CAM10 Most Significant Word Register */ + __IO uint32_t CAM10L; /*!< [0x005c] CAM10 Least Significant Word Register */ + __IO uint32_t CAM11M; /*!< [0x0060] CAM11 Most Significant Word Register */ + __IO uint32_t CAM11L; /*!< [0x0064] CAM11 Least Significant Word Register */ + __IO uint32_t CAM12M; /*!< [0x0068] CAM12 Most Significant Word Register */ + __IO uint32_t CAM12L; /*!< [0x006c] CAM12 Least Significant Word Register */ + __IO uint32_t CAM13M; /*!< [0x0070] CAM13 Most Significant Word Register */ + __IO uint32_t CAM13L; /*!< [0x0074] CAM13 Least Significant Word Register */ + __IO uint32_t CAM14M; /*!< [0x0078] CAM14 Most Significant Word Register */ + __IO uint32_t CAM14L; /*!< [0x007c] CAM14 Least Significant Word Register */ + __IO uint32_t CAM15MSB; /*!< [0x0080] CAM15 Most Significant Word Register */ + __IO uint32_t CAM15LSB; /*!< [0x0084] CAM15 Least Significant Word Register */ + __IO uint32_t TXDSA; /*!< [0x0088] Transmit Descriptor Link List Start Address Register */ + __IO uint32_t RXDSA; /*!< [0x008c] Receive Descriptor Link List Start Address Register */ + __IO uint32_t CTL; /*!< [0x0090] MAC Control Register */ + __IO uint32_t MIIMDAT; /*!< [0x0094] MII Management Data Register */ + __IO uint32_t MIIMCTL; /*!< [0x0098] MII Management Control and Address Register */ + __IO uint32_t FIFOCTL; /*!< [0x009c] FIFO Threshold Control Register */ + __O uint32_t TXST; /*!< [0x00a0] Transmit Start Demand Register */ + __O uint32_t RXST; /*!< [0x00a4] Receive Start Demand Register */ + __IO uint32_t MRFL; /*!< [0x00a8] Maximum Receive Frame Control Register */ + __IO uint32_t INTEN; /*!< [0x00ac] MAC Interrupt Enable Register */ + __IO uint32_t INTSTS; /*!< [0x00b0] MAC Interrupt Status Register */ + __IO uint32_t GENSTS; /*!< [0x00b4] MAC General Status Register */ + __IO uint32_t MPCNT; /*!< [0x00b8] Missed Packet Count Register */ + __I uint32_t RPCNT; /*!< [0x00bc] MAC Receive Pause Count Register */ + /** @cond HIDDEN_SYMBOLS */ + __I uint32_t RESERVE0[2]; + /** @endcond */ + __IO uint32_t FRSTS; /*!< [0x00c8] DMA Receive Frame Status Register */ + __I uint32_t CTXDSA; /*!< [0x00cc] Current Transmit Descriptor Start Address Register */ + __I uint32_t CTXBSA; /*!< [0x00d0] Current Transmit Buffer Start Address Register */ + __I uint32_t CRXDSA; /*!< [0x00d4] Current Receive Descriptor Start Address Register */ + __I uint32_t CRXBSA; /*!< [0x00d8] Current Receive Buffer Start Address Register */ + /** @cond HIDDEN_SYMBOLS */ + __I uint32_t RESERVE1[9]; + /** @endcond */ + __IO uint32_t TSCTL; /*!< [0x0100] Time Stamp Control Register */ + /** @cond HIDDEN_SYMBOLS */ + __I uint32_t RESERVE2[3]; + /** @endcond */ + __I uint32_t TSSEC; /*!< [0x0110] Time Stamp Counter Second Register */ + __I uint32_t TSSUBSEC; /*!< [0x0114] Time Stamp Counter Sub Second Register */ + __IO uint32_t TSINC; /*!< [0x0118] Time Stamp Increment Register */ + __IO uint32_t TSADDEND; /*!< [0x011c] Time Stamp Addend Register */ + __IO uint32_t UPDSEC; /*!< [0x0120] Time Stamp Update Second Register */ + __IO uint32_t UPDSUBSEC; /*!< [0x0124] Time Stamp Update Sub Second Register */ + __IO uint32_t ALMSEC; /*!< [0x0128] Time Stamp Alarm Second Register */ + __IO uint32_t ALMSUBSEC; /*!< [0x012c] Time Stamp Alarm Sub Second Register */ + +} EMAC_T; + +/** + @addtogroup EMAC_CONST EMAC Bit Field Definition + Constant Definitions for EMAC Controller +@{ */ + +#define EMAC_CAMCTL_AUP_Pos (0) /*!< EMAC_T::CAMCTL: AUP Position */ +#define EMAC_CAMCTL_AUP_Msk (0x1ul << EMAC_CAMCTL_AUP_Pos) /*!< EMAC_T::CAMCTL: AUP Mask */ + +#define EMAC_CAMCTL_AMP_Pos (1) /*!< EMAC_T::CAMCTL: AMP Position */ +#define EMAC_CAMCTL_AMP_Msk (0x1ul << EMAC_CAMCTL_AMP_Pos) /*!< EMAC_T::CAMCTL: AMP Mask */ + +#define EMAC_CAMCTL_ABP_Pos (2) /*!< EMAC_T::CAMCTL: ABP Position */ +#define EMAC_CAMCTL_ABP_Msk (0x1ul << EMAC_CAMCTL_ABP_Pos) /*!< EMAC_T::CAMCTL: ABP Mask */ + +#define EMAC_CAMCTL_COMPEN_Pos (3) /*!< EMAC_T::CAMCTL: COMPEN Position */ +#define EMAC_CAMCTL_COMPEN_Msk (0x1ul << EMAC_CAMCTL_COMPEN_Pos) /*!< EMAC_T::CAMCTL: COMPEN Mask */ + +#define EMAC_CAMCTL_CMPEN_Pos (4) /*!< EMAC_T::CAMCTL: CMPEN Position */ +#define EMAC_CAMCTL_CMPEN_Msk (0x1ul << EMAC_CAMCTL_CMPEN_Pos) /*!< EMAC_T::CAMCTL: CMPEN Mask */ + +#define EMAC_CAMEN_CAMxEN_Pos (0) /*!< EMAC_T::CAMEN: CAMxEN Position */ +#define EMAC_CAMEN_CAMxEN_Msk (0x1ul << EMAC_CAMEN_CAMxEN_Pos) /*!< EMAC_T::CAMEN: CAMxEN Mask */ + +#define EMAC_CAM0M_MACADDR2_Pos (0) /*!< EMAC_T::CAM0M: MACADDR2 Position */ +#define EMAC_CAM0M_MACADDR2_Msk (0xfful << EMAC_CAM0M_MACADDR2_Pos) /*!< EMAC_T::CAM0M: MACADDR2 Mask */ + +#define EMAC_CAM0M_MACADDR3_Pos (8) /*!< EMAC_T::CAM0M: MACADDR3 Position */ +#define EMAC_CAM0M_MACADDR3_Msk (0xfful << EMAC_CAM0M_MACADDR3_Pos) /*!< EMAC_T::CAM0M: MACADDR3 Mask */ + +#define EMAC_CAM0M_MACADDR4_Pos (16) /*!< EMAC_T::CAM0M: MACADDR4 Position */ +#define EMAC_CAM0M_MACADDR4_Msk (0xfful << EMAC_CAM0M_MACADDR4_Pos) /*!< EMAC_T::CAM0M: MACADDR4 Mask */ + +#define EMAC_CAM0M_MACADDR5_Pos (24) /*!< EMAC_T::CAM0M: MACADDR5 Position */ +#define EMAC_CAM0M_MACADDR5_Msk (0xfful << EMAC_CAM0M_MACADDR5_Pos) /*!< EMAC_T::CAM0M: MACADDR5 Mask */ + +#define EMAC_CAM0L_MACADDR0_Pos (16) /*!< EMAC_T::CAM0L: MACADDR0 Position */ +#define EMAC_CAM0L_MACADDR0_Msk (0xfful << EMAC_CAM0L_MACADDR0_Pos) /*!< EMAC_T::CAM0L: MACADDR0 Mask */ + +#define EMAC_CAM0L_MACADDR1_Pos (24) /*!< EMAC_T::CAM0L: MACADDR1 Position */ +#define EMAC_CAM0L_MACADDR1_Msk (0xfful << EMAC_CAM0L_MACADDR1_Pos) /*!< EMAC_T::CAM0L: MACADDR1 Mask */ + +#define EMAC_CAM1M_MACADDR2_Pos (0) /*!< EMAC_T::CAM1M: MACADDR2 Position */ +#define EMAC_CAM1M_MACADDR2_Msk (0xfful << EMAC_CAM1M_MACADDR2_Pos) /*!< EMAC_T::CAM1M: MACADDR2 Mask */ + +#define EMAC_CAM1M_MACADDR3_Pos (8) /*!< EMAC_T::CAM1M: MACADDR3 Position */ +#define EMAC_CAM1M_MACADDR3_Msk (0xfful << EMAC_CAM1M_MACADDR3_Pos) /*!< EMAC_T::CAM1M: MACADDR3 Mask */ + +#define EMAC_CAM1M_MACADDR4_Pos (16) /*!< EMAC_T::CAM1M: MACADDR4 Position */ +#define EMAC_CAM1M_MACADDR4_Msk (0xfful << EMAC_CAM1M_MACADDR4_Pos) /*!< EMAC_T::CAM1M: MACADDR4 Mask */ + +#define EMAC_CAM1M_MACADDR5_Pos (24) /*!< EMAC_T::CAM1M: MACADDR5 Position */ +#define EMAC_CAM1M_MACADDR5_Msk (0xfful << EMAC_CAM1M_MACADDR5_Pos) /*!< EMAC_T::CAM1M: MACADDR5 Mask */ + +#define EMAC_CAM1L_MACADDR0_Pos (16) /*!< EMAC_T::CAM1L: MACADDR0 Position */ +#define EMAC_CAM1L_MACADDR0_Msk (0xfful << EMAC_CAM1L_MACADDR0_Pos) /*!< EMAC_T::CAM1L: MACADDR0 Mask */ + +#define EMAC_CAM1L_MACADDR1_Pos (24) /*!< EMAC_T::CAM1L: MACADDR1 Position */ +#define EMAC_CAM1L_MACADDR1_Msk (0xfful << EMAC_CAM1L_MACADDR1_Pos) /*!< EMAC_T::CAM1L: MACADDR1 Mask */ + +#define EMAC_CAM2M_MACADDR2_Pos (0) /*!< EMAC_T::CAM2M: MACADDR2 Position */ +#define EMAC_CAM2M_MACADDR2_Msk (0xfful << EMAC_CAM2M_MACADDR2_Pos) /*!< EMAC_T::CAM2M: MACADDR2 Mask */ + +#define EMAC_CAM2M_MACADDR3_Pos (8) /*!< EMAC_T::CAM2M: MACADDR3 Position */ +#define EMAC_CAM2M_MACADDR3_Msk (0xfful << EMAC_CAM2M_MACADDR3_Pos) /*!< EMAC_T::CAM2M: MACADDR3 Mask */ + +#define EMAC_CAM2M_MACADDR4_Pos (16) /*!< EMAC_T::CAM2M: MACADDR4 Position */ +#define EMAC_CAM2M_MACADDR4_Msk (0xfful << EMAC_CAM2M_MACADDR4_Pos) /*!< EMAC_T::CAM2M: MACADDR4 Mask */ + +#define EMAC_CAM2M_MACADDR5_Pos (24) /*!< EMAC_T::CAM2M: MACADDR5 Position */ +#define EMAC_CAM2M_MACADDR5_Msk (0xfful << EMAC_CAM2M_MACADDR5_Pos) /*!< EMAC_T::CAM2M: MACADDR5 Mask */ + +#define EMAC_CAM2L_MACADDR0_Pos (16) /*!< EMAC_T::CAM2L: MACADDR0 Position */ +#define EMAC_CAM2L_MACADDR0_Msk (0xfful << EMAC_CAM2L_MACADDR0_Pos) /*!< EMAC_T::CAM2L: MACADDR0 Mask */ + +#define EMAC_CAM2L_MACADDR1_Pos (24) /*!< EMAC_T::CAM2L: MACADDR1 Position */ +#define EMAC_CAM2L_MACADDR1_Msk (0xfful << EMAC_CAM2L_MACADDR1_Pos) /*!< EMAC_T::CAM2L: MACADDR1 Mask */ + +#define EMAC_CAM3M_MACADDR2_Pos (0) /*!< EMAC_T::CAM3M: MACADDR2 Position */ +#define EMAC_CAM3M_MACADDR2_Msk (0xfful << EMAC_CAM3M_MACADDR2_Pos) /*!< EMAC_T::CAM3M: MACADDR2 Mask */ + +#define EMAC_CAM3M_MACADDR3_Pos (8) /*!< EMAC_T::CAM3M: MACADDR3 Position */ +#define EMAC_CAM3M_MACADDR3_Msk (0xfful << EMAC_CAM3M_MACADDR3_Pos) /*!< EMAC_T::CAM3M: MACADDR3 Mask */ + +#define EMAC_CAM3M_MACADDR4_Pos (16) /*!< EMAC_T::CAM3M: MACADDR4 Position */ +#define EMAC_CAM3M_MACADDR4_Msk (0xfful << EMAC_CAM3M_MACADDR4_Pos) /*!< EMAC_T::CAM3M: MACADDR4 Mask */ + +#define EMAC_CAM3M_MACADDR5_Pos (24) /*!< EMAC_T::CAM3M: MACADDR5 Position */ +#define EMAC_CAM3M_MACADDR5_Msk (0xfful << EMAC_CAM3M_MACADDR5_Pos) /*!< EMAC_T::CAM3M: MACADDR5 Mask */ + +#define EMAC_CAM3L_MACADDR0_Pos (16) /*!< EMAC_T::CAM3L: MACADDR0 Position */ +#define EMAC_CAM3L_MACADDR0_Msk (0xfful << EMAC_CAM3L_MACADDR0_Pos) /*!< EMAC_T::CAM3L: MACADDR0 Mask */ + +#define EMAC_CAM3L_MACADDR1_Pos (24) /*!< EMAC_T::CAM3L: MACADDR1 Position */ +#define EMAC_CAM3L_MACADDR1_Msk (0xfful << EMAC_CAM3L_MACADDR1_Pos) /*!< EMAC_T::CAM3L: MACADDR1 Mask */ + +#define EMAC_CAM4M_MACADDR2_Pos (0) /*!< EMAC_T::CAM4M: MACADDR2 Position */ +#define EMAC_CAM4M_MACADDR2_Msk (0xfful << EMAC_CAM4M_MACADDR2_Pos) /*!< EMAC_T::CAM4M: MACADDR2 Mask */ + +#define EMAC_CAM4M_MACADDR3_Pos (8) /*!< EMAC_T::CAM4M: MACADDR3 Position */ +#define EMAC_CAM4M_MACADDR3_Msk (0xfful << EMAC_CAM4M_MACADDR3_Pos) /*!< EMAC_T::CAM4M: MACADDR3 Mask */ + +#define EMAC_CAM4M_MACADDR4_Pos (16) /*!< EMAC_T::CAM4M: MACADDR4 Position */ +#define EMAC_CAM4M_MACADDR4_Msk (0xfful << EMAC_CAM4M_MACADDR4_Pos) /*!< EMAC_T::CAM4M: MACADDR4 Mask */ + +#define EMAC_CAM4M_MACADDR5_Pos (24) /*!< EMAC_T::CAM4M: MACADDR5 Position */ +#define EMAC_CAM4M_MACADDR5_Msk (0xfful << EMAC_CAM4M_MACADDR5_Pos) /*!< EMAC_T::CAM4M: MACADDR5 Mask */ + +#define EMAC_CAM4L_MACADDR0_Pos (16) /*!< EMAC_T::CAM4L: MACADDR0 Position */ +#define EMAC_CAM4L_MACADDR0_Msk (0xfful << EMAC_CAM4L_MACADDR0_Pos) /*!< EMAC_T::CAM4L: MACADDR0 Mask */ + +#define EMAC_CAM4L_MACADDR1_Pos (24) /*!< EMAC_T::CAM4L: MACADDR1 Position */ +#define EMAC_CAM4L_MACADDR1_Msk (0xfful << EMAC_CAM4L_MACADDR1_Pos) /*!< EMAC_T::CAM4L: MACADDR1 Mask */ + +#define EMAC_CAM5M_MACADDR2_Pos (0) /*!< EMAC_T::CAM5M: MACADDR2 Position */ +#define EMAC_CAM5M_MACADDR2_Msk (0xfful << EMAC_CAM5M_MACADDR2_Pos) /*!< EMAC_T::CAM5M: MACADDR2 Mask */ + +#define EMAC_CAM5M_MACADDR3_Pos (8) /*!< EMAC_T::CAM5M: MACADDR3 Position */ +#define EMAC_CAM5M_MACADDR3_Msk (0xfful << EMAC_CAM5M_MACADDR3_Pos) /*!< EMAC_T::CAM5M: MACADDR3 Mask */ + +#define EMAC_CAM5M_MACADDR4_Pos (16) /*!< EMAC_T::CAM5M: MACADDR4 Position */ +#define EMAC_CAM5M_MACADDR4_Msk (0xfful << EMAC_CAM5M_MACADDR4_Pos) /*!< EMAC_T::CAM5M: MACADDR4 Mask */ + +#define EMAC_CAM5M_MACADDR5_Pos (24) /*!< EMAC_T::CAM5M: MACADDR5 Position */ +#define EMAC_CAM5M_MACADDR5_Msk (0xfful << EMAC_CAM5M_MACADDR5_Pos) /*!< EMAC_T::CAM5M: MACADDR5 Mask */ + +#define EMAC_CAM5L_MACADDR0_Pos (16) /*!< EMAC_T::CAM5L: MACADDR0 Position */ +#define EMAC_CAM5L_MACADDR0_Msk (0xfful << EMAC_CAM5L_MACADDR0_Pos) /*!< EMAC_T::CAM5L: MACADDR0 Mask */ + +#define EMAC_CAM5L_MACADDR1_Pos (24) /*!< EMAC_T::CAM5L: MACADDR1 Position */ +#define EMAC_CAM5L_MACADDR1_Msk (0xfful << EMAC_CAM5L_MACADDR1_Pos) /*!< EMAC_T::CAM5L: MACADDR1 Mask */ + +#define EMAC_CAM6M_MACADDR2_Pos (0) /*!< EMAC_T::CAM6M: MACADDR2 Position */ +#define EMAC_CAM6M_MACADDR2_Msk (0xfful << EMAC_CAM6M_MACADDR2_Pos) /*!< EMAC_T::CAM6M: MACADDR2 Mask */ + +#define EMAC_CAM6M_MACADDR3_Pos (8) /*!< EMAC_T::CAM6M: MACADDR3 Position */ +#define EMAC_CAM6M_MACADDR3_Msk (0xfful << EMAC_CAM6M_MACADDR3_Pos) /*!< EMAC_T::CAM6M: MACADDR3 Mask */ + +#define EMAC_CAM6M_MACADDR4_Pos (16) /*!< EMAC_T::CAM6M: MACADDR4 Position */ +#define EMAC_CAM6M_MACADDR4_Msk (0xfful << EMAC_CAM6M_MACADDR4_Pos) /*!< EMAC_T::CAM6M: MACADDR4 Mask */ + +#define EMAC_CAM6M_MACADDR5_Pos (24) /*!< EMAC_T::CAM6M: MACADDR5 Position */ +#define EMAC_CAM6M_MACADDR5_Msk (0xfful << EMAC_CAM6M_MACADDR5_Pos) /*!< EMAC_T::CAM6M: MACADDR5 Mask */ + +#define EMAC_CAM6L_MACADDR0_Pos (16) /*!< EMAC_T::CAM6L: MACADDR0 Position */ +#define EMAC_CAM6L_MACADDR0_Msk (0xfful << EMAC_CAM6L_MACADDR0_Pos) /*!< EMAC_T::CAM6L: MACADDR0 Mask */ + +#define EMAC_CAM6L_MACADDR1_Pos (24) /*!< EMAC_T::CAM6L: MACADDR1 Position */ +#define EMAC_CAM6L_MACADDR1_Msk (0xfful << EMAC_CAM6L_MACADDR1_Pos) /*!< EMAC_T::CAM6L: MACADDR1 Mask */ + +#define EMAC_CAM7M_MACADDR2_Pos (0) /*!< EMAC_T::CAM7M: MACADDR2 Position */ +#define EMAC_CAM7M_MACADDR2_Msk (0xfful << EMAC_CAM7M_MACADDR2_Pos) /*!< EMAC_T::CAM7M: MACADDR2 Mask */ + +#define EMAC_CAM7M_MACADDR3_Pos (8) /*!< EMAC_T::CAM7M: MACADDR3 Position */ +#define EMAC_CAM7M_MACADDR3_Msk (0xfful << EMAC_CAM7M_MACADDR3_Pos) /*!< EMAC_T::CAM7M: MACADDR3 Mask */ + +#define EMAC_CAM7M_MACADDR4_Pos (16) /*!< EMAC_T::CAM7M: MACADDR4 Position */ +#define EMAC_CAM7M_MACADDR4_Msk (0xfful << EMAC_CAM7M_MACADDR4_Pos) /*!< EMAC_T::CAM7M: MACADDR4 Mask */ + +#define EMAC_CAM7M_MACADDR5_Pos (24) /*!< EMAC_T::CAM7M: MACADDR5 Position */ +#define EMAC_CAM7M_MACADDR5_Msk (0xfful << EMAC_CAM7M_MACADDR5_Pos) /*!< EMAC_T::CAM7M: MACADDR5 Mask */ + +#define EMAC_CAM7L_MACADDR0_Pos (16) /*!< EMAC_T::CAM7L: MACADDR0 Position */ +#define EMAC_CAM7L_MACADDR0_Msk (0xfful << EMAC_CAM7L_MACADDR0_Pos) /*!< EMAC_T::CAM7L: MACADDR0 Mask */ + +#define EMAC_CAM7L_MACADDR1_Pos (24) /*!< EMAC_T::CAM7L: MACADDR1 Position */ +#define EMAC_CAM7L_MACADDR1_Msk (0xfful << EMAC_CAM7L_MACADDR1_Pos) /*!< EMAC_T::CAM7L: MACADDR1 Mask */ + +#define EMAC_CAM8M_MACADDR2_Pos (0) /*!< EMAC_T::CAM8M: MACADDR2 Position */ +#define EMAC_CAM8M_MACADDR2_Msk (0xfful << EMAC_CAM8M_MACADDR2_Pos) /*!< EMAC_T::CAM8M: MACADDR2 Mask */ + +#define EMAC_CAM8M_MACADDR3_Pos (8) /*!< EMAC_T::CAM8M: MACADDR3 Position */ +#define EMAC_CAM8M_MACADDR3_Msk (0xfful << EMAC_CAM8M_MACADDR3_Pos) /*!< EMAC_T::CAM8M: MACADDR3 Mask */ + +#define EMAC_CAM8M_MACADDR4_Pos (16) /*!< EMAC_T::CAM8M: MACADDR4 Position */ +#define EMAC_CAM8M_MACADDR4_Msk (0xfful << EMAC_CAM8M_MACADDR4_Pos) /*!< EMAC_T::CAM8M: MACADDR4 Mask */ + +#define EMAC_CAM8M_MACADDR5_Pos (24) /*!< EMAC_T::CAM8M: MACADDR5 Position */ +#define EMAC_CAM8M_MACADDR5_Msk (0xfful << EMAC_CAM8M_MACADDR5_Pos) /*!< EMAC_T::CAM8M: MACADDR5 Mask */ + +#define EMAC_CAM8L_MACADDR0_Pos (16) /*!< EMAC_T::CAM8L: MACADDR0 Position */ +#define EMAC_CAM8L_MACADDR0_Msk (0xfful << EMAC_CAM8L_MACADDR0_Pos) /*!< EMAC_T::CAM8L: MACADDR0 Mask */ + +#define EMAC_CAM8L_MACADDR1_Pos (24) /*!< EMAC_T::CAM8L: MACADDR1 Position */ +#define EMAC_CAM8L_MACADDR1_Msk (0xfful << EMAC_CAM8L_MACADDR1_Pos) /*!< EMAC_T::CAM8L: MACADDR1 Mask */ + +#define EMAC_CAM9M_MACADDR2_Pos (0) /*!< EMAC_T::CAM9M: MACADDR2 Position */ +#define EMAC_CAM9M_MACADDR2_Msk (0xfful << EMAC_CAM9M_MACADDR2_Pos) /*!< EMAC_T::CAM9M: MACADDR2 Mask */ + +#define EMAC_CAM9M_MACADDR3_Pos (8) /*!< EMAC_T::CAM9M: MACADDR3 Position */ +#define EMAC_CAM9M_MACADDR3_Msk (0xfful << EMAC_CAM9M_MACADDR3_Pos) /*!< EMAC_T::CAM9M: MACADDR3 Mask */ + +#define EMAC_CAM9M_MACADDR4_Pos (16) /*!< EMAC_T::CAM9M: MACADDR4 Position */ +#define EMAC_CAM9M_MACADDR4_Msk (0xfful << EMAC_CAM9M_MACADDR4_Pos) /*!< EMAC_T::CAM9M: MACADDR4 Mask */ + +#define EMAC_CAM9M_MACADDR5_Pos (24) /*!< EMAC_T::CAM9M: MACADDR5 Position */ +#define EMAC_CAM9M_MACADDR5_Msk (0xfful << EMAC_CAM9M_MACADDR5_Pos) /*!< EMAC_T::CAM9M: MACADDR5 Mask */ + +#define EMAC_CAM9L_MACADDR0_Pos (16) /*!< EMAC_T::CAM9L: MACADDR0 Position */ +#define EMAC_CAM9L_MACADDR0_Msk (0xfful << EMAC_CAM9L_MACADDR0_Pos) /*!< EMAC_T::CAM9L: MACADDR0 Mask */ + +#define EMAC_CAM9L_MACADDR1_Pos (24) /*!< EMAC_T::CAM9L: MACADDR1 Position */ +#define EMAC_CAM9L_MACADDR1_Msk (0xfful << EMAC_CAM9L_MACADDR1_Pos) /*!< EMAC_T::CAM9L: MACADDR1 Mask */ + +#define EMAC_CAM10M_MACADDR2_Pos (0) /*!< EMAC_T::CAM10M: MACADDR2 Position */ +#define EMAC_CAM10M_MACADDR2_Msk (0xfful << EMAC_CAM10M_MACADDR2_Pos) /*!< EMAC_T::CAM10M: MACADDR2 Mask */ + +#define EMAC_CAM10M_MACADDR3_Pos (8) /*!< EMAC_T::CAM10M: MACADDR3 Position */ +#define EMAC_CAM10M_MACADDR3_Msk (0xfful << EMAC_CAM10M_MACADDR3_Pos) /*!< EMAC_T::CAM10M: MACADDR3 Mask */ + +#define EMAC_CAM10M_MACADDR4_Pos (16) /*!< EMAC_T::CAM10M: MACADDR4 Position */ +#define EMAC_CAM10M_MACADDR4_Msk (0xfful << EMAC_CAM10M_MACADDR4_Pos) /*!< EMAC_T::CAM10M: MACADDR4 Mask */ + +#define EMAC_CAM10M_MACADDR5_Pos (24) /*!< EMAC_T::CAM10M: MACADDR5 Position */ +#define EMAC_CAM10M_MACADDR5_Msk (0xfful << EMAC_CAM10M_MACADDR5_Pos) /*!< EMAC_T::CAM10M: MACADDR5 Mask */ + +#define EMAC_CAM10L_MACADDR0_Pos (16) /*!< EMAC_T::CAM10L: MACADDR0 Position */ +#define EMAC_CAM10L_MACADDR0_Msk (0xfful << EMAC_CAM10L_MACADDR0_Pos) /*!< EMAC_T::CAM10L: MACADDR0 Mask */ + +#define EMAC_CAM10L_MACADDR1_Pos (24) /*!< EMAC_T::CAM10L: MACADDR1 Position */ +#define EMAC_CAM10L_MACADDR1_Msk (0xfful << EMAC_CAM10L_MACADDR1_Pos) /*!< EMAC_T::CAM10L: MACADDR1 Mask */ + +#define EMAC_CAM11M_MACADDR2_Pos (0) /*!< EMAC_T::CAM11M: MACADDR2 Position */ +#define EMAC_CAM11M_MACADDR2_Msk (0xfful << EMAC_CAM11M_MACADDR2_Pos) /*!< EMAC_T::CAM11M: MACADDR2 Mask */ + +#define EMAC_CAM11M_MACADDR3_Pos (8) /*!< EMAC_T::CAM11M: MACADDR3 Position */ +#define EMAC_CAM11M_MACADDR3_Msk (0xfful << EMAC_CAM11M_MACADDR3_Pos) /*!< EMAC_T::CAM11M: MACADDR3 Mask */ + +#define EMAC_CAM11M_MACADDR4_Pos (16) /*!< EMAC_T::CAM11M: MACADDR4 Position */ +#define EMAC_CAM11M_MACADDR4_Msk (0xfful << EMAC_CAM11M_MACADDR4_Pos) /*!< EMAC_T::CAM11M: MACADDR4 Mask */ + +#define EMAC_CAM11M_MACADDR5_Pos (24) /*!< EMAC_T::CAM11M: MACADDR5 Position */ +#define EMAC_CAM11M_MACADDR5_Msk (0xfful << EMAC_CAM11M_MACADDR5_Pos) /*!< EMAC_T::CAM11M: MACADDR5 Mask */ + +#define EMAC_CAM11L_MACADDR0_Pos (16) /*!< EMAC_T::CAM11L: MACADDR0 Position */ +#define EMAC_CAM11L_MACADDR0_Msk (0xfful << EMAC_CAM11L_MACADDR0_Pos) /*!< EMAC_T::CAM11L: MACADDR0 Mask */ + +#define EMAC_CAM11L_MACADDR1_Pos (24) /*!< EMAC_T::CAM11L: MACADDR1 Position */ +#define EMAC_CAM11L_MACADDR1_Msk (0xfful << EMAC_CAM11L_MACADDR1_Pos) /*!< EMAC_T::CAM11L: MACADDR1 Mask */ + +#define EMAC_CAM12M_MACADDR2_Pos (0) /*!< EMAC_T::CAM12M: MACADDR2 Position */ +#define EMAC_CAM12M_MACADDR2_Msk (0xfful << EMAC_CAM12M_MACADDR2_Pos) /*!< EMAC_T::CAM12M: MACADDR2 Mask */ + +#define EMAC_CAM12M_MACADDR3_Pos (8) /*!< EMAC_T::CAM12M: MACADDR3 Position */ +#define EMAC_CAM12M_MACADDR3_Msk (0xfful << EMAC_CAM12M_MACADDR3_Pos) /*!< EMAC_T::CAM12M: MACADDR3 Mask */ + +#define EMAC_CAM12M_MACADDR4_Pos (16) /*!< EMAC_T::CAM12M: MACADDR4 Position */ +#define EMAC_CAM12M_MACADDR4_Msk (0xfful << EMAC_CAM12M_MACADDR4_Pos) /*!< EMAC_T::CAM12M: MACADDR4 Mask */ + +#define EMAC_CAM12M_MACADDR5_Pos (24) /*!< EMAC_T::CAM12M: MACADDR5 Position */ +#define EMAC_CAM12M_MACADDR5_Msk (0xfful << EMAC_CAM12M_MACADDR5_Pos) /*!< EMAC_T::CAM12M: MACADDR5 Mask */ + +#define EMAC_CAM12L_MACADDR0_Pos (16) /*!< EMAC_T::CAM12L: MACADDR0 Position */ +#define EMAC_CAM12L_MACADDR0_Msk (0xfful << EMAC_CAM12L_MACADDR0_Pos) /*!< EMAC_T::CAM12L: MACADDR0 Mask */ + +#define EMAC_CAM12L_MACADDR1_Pos (24) /*!< EMAC_T::CAM12L: MACADDR1 Position */ +#define EMAC_CAM12L_MACADDR1_Msk (0xfful << EMAC_CAM12L_MACADDR1_Pos) /*!< EMAC_T::CAM12L: MACADDR1 Mask */ + +#define EMAC_CAM13M_MACADDR2_Pos (0) /*!< EMAC_T::CAM13M: MACADDR2 Position */ +#define EMAC_CAM13M_MACADDR2_Msk (0xfful << EMAC_CAM13M_MACADDR2_Pos) /*!< EMAC_T::CAM13M: MACADDR2 Mask */ + +#define EMAC_CAM13M_MACADDR3_Pos (8) /*!< EMAC_T::CAM13M: MACADDR3 Position */ +#define EMAC_CAM13M_MACADDR3_Msk (0xfful << EMAC_CAM13M_MACADDR3_Pos) /*!< EMAC_T::CAM13M: MACADDR3 Mask */ + +#define EMAC_CAM13M_MACADDR4_Pos (16) /*!< EMAC_T::CAM13M: MACADDR4 Position */ +#define EMAC_CAM13M_MACADDR4_Msk (0xfful << EMAC_CAM13M_MACADDR4_Pos) /*!< EMAC_T::CAM13M: MACADDR4 Mask */ + +#define EMAC_CAM13M_MACADDR5_Pos (24) /*!< EMAC_T::CAM13M: MACADDR5 Position */ +#define EMAC_CAM13M_MACADDR5_Msk (0xfful << EMAC_CAM13M_MACADDR5_Pos) /*!< EMAC_T::CAM13M: MACADDR5 Mask */ + +#define EMAC_CAM13L_MACADDR0_Pos (16) /*!< EMAC_T::CAM13L: MACADDR0 Position */ +#define EMAC_CAM13L_MACADDR0_Msk (0xfful << EMAC_CAM13L_MACADDR0_Pos) /*!< EMAC_T::CAM13L: MACADDR0 Mask */ + +#define EMAC_CAM13L_MACADDR1_Pos (24) /*!< EMAC_T::CAM13L: MACADDR1 Position */ +#define EMAC_CAM13L_MACADDR1_Msk (0xfful << EMAC_CAM13L_MACADDR1_Pos) /*!< EMAC_T::CAM13L: MACADDR1 Mask */ + +#define EMAC_CAM14M_MACADDR2_Pos (0) /*!< EMAC_T::CAM14M: MACADDR2 Position */ +#define EMAC_CAM14M_MACADDR2_Msk (0xfful << EMAC_CAM14M_MACADDR2_Pos) /*!< EMAC_T::CAM14M: MACADDR2 Mask */ + +#define EMAC_CAM14M_MACADDR3_Pos (8) /*!< EMAC_T::CAM14M: MACADDR3 Position */ +#define EMAC_CAM14M_MACADDR3_Msk (0xfful << EMAC_CAM14M_MACADDR3_Pos) /*!< EMAC_T::CAM14M: MACADDR3 Mask */ + +#define EMAC_CAM14M_MACADDR4_Pos (16) /*!< EMAC_T::CAM14M: MACADDR4 Position */ +#define EMAC_CAM14M_MACADDR4_Msk (0xfful << EMAC_CAM14M_MACADDR4_Pos) /*!< EMAC_T::CAM14M: MACADDR4 Mask */ + +#define EMAC_CAM14M_MACADDR5_Pos (24) /*!< EMAC_T::CAM14M: MACADDR5 Position */ +#define EMAC_CAM14M_MACADDR5_Msk (0xfful << EMAC_CAM14M_MACADDR5_Pos) /*!< EMAC_T::CAM14M: MACADDR5 Mask */ + +#define EMAC_CAM14L_MACADDR0_Pos (16) /*!< EMAC_T::CAM14L: MACADDR0 Position */ +#define EMAC_CAM14L_MACADDR0_Msk (0xfful << EMAC_CAM14L_MACADDR0_Pos) /*!< EMAC_T::CAM14L: MACADDR0 Mask */ + +#define EMAC_CAM14L_MACADDR1_Pos (24) /*!< EMAC_T::CAM14L: MACADDR1 Position */ +#define EMAC_CAM14L_MACADDR1_Msk (0xfful << EMAC_CAM14L_MACADDR1_Pos) /*!< EMAC_T::CAM14L: MACADDR1 Mask */ + +#define EMAC_CAM15MSB_OPCODE_Pos (0) /*!< EMAC_T::CAM15MSB: OPCODE Position */ +#define EMAC_CAM15MSB_OPCODE_Msk (0xfffful << EMAC_CAM15MSB_OPCODE_Pos) /*!< EMAC_T::CAM15MSB: OPCODE Mask */ + +#define EMAC_CAM15MSB_LENGTH_Pos (16) /*!< EMAC_T::CAM15MSB: LENGTH Position */ +#define EMAC_CAM15MSB_LENGTH_Msk (0xfffful << EMAC_CAM15MSB_LENGTH_Pos) /*!< EMAC_T::CAM15MSB: LENGTH Mask */ + +#define EMAC_CAM15LSB_OPERAND_Pos (24) /*!< EMAC_T::CAM15LSB: OPERAND Position */ +#define EMAC_CAM15LSB_OPERAND_Msk (0xfful << EMAC_CAM15LSB_OPERAND_Pos) /*!< EMAC_T::CAM15LSB: OPERAND Mask */ + +#define EMAC_TXDSA_TXDSA_Pos (0) /*!< EMAC_T::TXDSA: TXDSA Position */ +#define EMAC_TXDSA_TXDSA_Msk (0xfffffffful << EMAC_TXDSA_TXDSA_Pos) /*!< EMAC_T::TXDSA: TXDSA Mask */ + +#define EMAC_RXDSA_RXDSA_Pos (0) /*!< EMAC_T::RXDSA: RXDSA Position */ +#define EMAC_RXDSA_RXDSA_Msk (0xfffffffful << EMAC_RXDSA_RXDSA_Pos) /*!< EMAC_T::RXDSA: RXDSA Mask */ + +#define EMAC_CTL_RXON_Pos (0) /*!< EMAC_T::CTL: RXON Position */ +#define EMAC_CTL_RXON_Msk (0x1ul << EMAC_CTL_RXON_Pos) /*!< EMAC_T::CTL: RXON Mask */ + +#define EMAC_CTL_ALP_Pos (1) /*!< EMAC_T::CTL: ALP Position */ +#define EMAC_CTL_ALP_Msk (0x1ul << EMAC_CTL_ALP_Pos) /*!< EMAC_T::CTL: ALP Mask */ + +#define EMAC_CTL_ARP_Pos (2) /*!< EMAC_T::CTL: ARP Position */ +#define EMAC_CTL_ARP_Msk (0x1ul << EMAC_CTL_ARP_Pos) /*!< EMAC_T::CTL: ARP Mask */ + +#define EMAC_CTL_ACP_Pos (3) /*!< EMAC_T::CTL: ACP Position */ +#define EMAC_CTL_ACP_Msk (0x1ul << EMAC_CTL_ACP_Pos) /*!< EMAC_T::CTL: ACP Mask */ + +#define EMAC_CTL_AEP_Pos (4) /*!< EMAC_T::CTL: AEP Position */ +#define EMAC_CTL_AEP_Msk (0x1ul << EMAC_CTL_AEP_Pos) /*!< EMAC_T::CTL: AEP Mask */ + +#define EMAC_CTL_STRIPCRC_Pos (5) /*!< EMAC_T::CTL: STRIPCRC Position */ +#define EMAC_CTL_STRIPCRC_Msk (0x1ul << EMAC_CTL_STRIPCRC_Pos) /*!< EMAC_T::CTL: STRIPCRC Mask */ + +#define EMAC_CTL_WOLEN_Pos (6) /*!< EMAC_T::CTL: WOLEN Position */ +#define EMAC_CTL_WOLEN_Msk (0x1ul << EMAC_CTL_WOLEN_Pos) /*!< EMAC_T::CTL: WOLEN Mask */ + +#define EMAC_CTL_TXON_Pos (8) /*!< EMAC_T::CTL: TXON Position */ +#define EMAC_CTL_TXON_Msk (0x1ul << EMAC_CTL_TXON_Pos) /*!< EMAC_T::CTL: TXON Mask */ + +#define EMAC_CTL_NODEF_Pos (9) /*!< EMAC_T::CTL: NODEF Position */ +#define EMAC_CTL_NODEF_Msk (0x1ul << EMAC_CTL_NODEF_Pos) /*!< EMAC_T::CTL: NODEF Mask */ + +#define EMAC_CTL_SDPZ_Pos (16) /*!< EMAC_T::CTL: SDPZ Position */ +#define EMAC_CTL_SDPZ_Msk (0x1ul << EMAC_CTL_SDPZ_Pos) /*!< EMAC_T::CTL: SDPZ Mask */ + +#define EMAC_CTL_SQECHKEN_Pos (17) /*!< EMAC_T::CTL: SQECHKEN Position */ +#define EMAC_CTL_SQECHKEN_Msk (0x1ul << EMAC_CTL_SQECHKEN_Pos) /*!< EMAC_T::CTL: SQECHKEN Mask */ + +#define EMAC_CTL_FUDUP_Pos (18) /*!< EMAC_T::CTL: FUDUP Position */ +#define EMAC_CTL_FUDUP_Msk (0x1ul << EMAC_CTL_FUDUP_Pos) /*!< EMAC_T::CTL: FUDUP Mask */ + +#define EMAC_CTL_RMIIRXCTL_Pos (19) /*!< EMAC_T::CTL: RMIIRXCTL Position */ +#define EMAC_CTL_RMIIRXCTL_Msk (0x1ul << EMAC_CTL_RMIIRXCTL_Pos) /*!< EMAC_T::CTL: RMIIRXCTL Mask */ + +#define EMAC_CTL_OPMODE_Pos (20) /*!< EMAC_T::CTL: OPMODE Position */ +#define EMAC_CTL_OPMODE_Msk (0x1ul << EMAC_CTL_OPMODE_Pos) /*!< EMAC_T::CTL: OPMODE Mask */ + +#define EMAC_CTL_RMIIEN_Pos (22) /*!< EMAC_T::CTL: RMIIEN Position */ +#define EMAC_CTL_RMIIEN_Msk (0x1ul << EMAC_CTL_RMIIEN_Pos) /*!< EMAC_T::CTL: RMIIEN Mask */ + +#define EMAC_CTL_RST_Pos (24) /*!< EMAC_T::CTL: RST Position */ +#define EMAC_CTL_RST_Msk (0x1ul << EMAC_CTL_RST_Pos) /*!< EMAC_T::CTL: RST Mask */ + +#define EMAC_MIIMDAT_DATA_Pos (0) /*!< EMAC_T::MIIMDAT: DATA Position */ +#define EMAC_MIIMDAT_DATA_Msk (0xfffful << EMAC_MIIMDAT_DATA_Pos) /*!< EMAC_T::MIIMDAT: DATA Mask */ + +#define EMAC_MIIMCTL_PHYREG_Pos (0) /*!< EMAC_T::MIIMCTL: PHYREG Position */ +#define EMAC_MIIMCTL_PHYREG_Msk (0x1ful << EMAC_MIIMCTL_PHYREG_Pos) /*!< EMAC_T::MIIMCTL: PHYREG Mask */ + +#define EMAC_MIIMCTL_PHYADDR_Pos (8) /*!< EMAC_T::MIIMCTL: PHYADDR Position */ +#define EMAC_MIIMCTL_PHYADDR_Msk (0x1ful << EMAC_MIIMCTL_PHYADDR_Pos) /*!< EMAC_T::MIIMCTL: PHYADDR Mask */ + +#define EMAC_MIIMCTL_WRITE_Pos (16) /*!< EMAC_T::MIIMCTL: WRITE Position */ +#define EMAC_MIIMCTL_WRITE_Msk (0x1ul << EMAC_MIIMCTL_WRITE_Pos) /*!< EMAC_T::MIIMCTL: WRITE Mask */ + +#define EMAC_MIIMCTL_BUSY_Pos (17) /*!< EMAC_T::MIIMCTL: BUSY Position */ +#define EMAC_MIIMCTL_BUSY_Msk (0x1ul << EMAC_MIIMCTL_BUSY_Pos) /*!< EMAC_T::MIIMCTL: BUSY Mask */ + +#define EMAC_MIIMCTL_PREAMSP_Pos (18) /*!< EMAC_T::MIIMCTL: PREAMSP Position */ +#define EMAC_MIIMCTL_PREAMSP_Msk (0x1ul << EMAC_MIIMCTL_PREAMSP_Pos) /*!< EMAC_T::MIIMCTL: PREAMSP Mask */ + +#define EMAC_MIIMCTL_MDCON_Pos (19) /*!< EMAC_T::MIIMCTL: MDCON Position */ +#define EMAC_MIIMCTL_MDCON_Msk (0x1ul << EMAC_MIIMCTL_MDCON_Pos) /*!< EMAC_T::MIIMCTL: MDCON Mask */ + +#define EMAC_FIFOCTL_RXFIFOTH_Pos (0) /*!< EMAC_T::FIFOCTL: RXFIFOTH Position */ +#define EMAC_FIFOCTL_RXFIFOTH_Msk (0x3ul << EMAC_FIFOCTL_RXFIFOTH_Pos) /*!< EMAC_T::FIFOCTL: RXFIFOTH Mask */ + +#define EMAC_FIFOCTL_TXFIFOTH_Pos (8) /*!< EMAC_T::FIFOCTL: TXFIFOTH Position */ +#define EMAC_FIFOCTL_TXFIFOTH_Msk (0x3ul << EMAC_FIFOCTL_TXFIFOTH_Pos) /*!< EMAC_T::FIFOCTL: TXFIFOTH Mask */ + +#define EMAC_FIFOCTL_BURSTLEN_Pos (20) /*!< EMAC_T::FIFOCTL: BURSTLEN Position */ +#define EMAC_FIFOCTL_BURSTLEN_Msk (0x3ul << EMAC_FIFOCTL_BURSTLEN_Pos) /*!< EMAC_T::FIFOCTL: BURSTLEN Mask */ + +#define EMAC_TXST_TXST_Pos (0) /*!< EMAC_T::TXST: TXST Position */ +#define EMAC_TXST_TXST_Msk (0xfffffffful << EMAC_TXST_TXST_Pos) /*!< EMAC_T::TXST: TXST Mask */ + +#define EMAC_RXST_RXST_Pos (0) /*!< EMAC_T::RXST: RXST Position */ +#define EMAC_RXST_RXST_Msk (0xfffffffful << EMAC_RXST_RXST_Pos) /*!< EMAC_T::RXST: RXST Mask */ + +#define EMAC_MRFL_MRFL_Pos (0) /*!< EMAC_T::MRFL: MRFL Position */ +#define EMAC_MRFL_MRFL_Msk (0xfffful << EMAC_MRFL_MRFL_Pos) /*!< EMAC_T::MRFL: MRFL Mask */ + +#define EMAC_INTEN_RXIEN_Pos (0) /*!< EMAC_T::INTEN: RXIEN Position */ +#define EMAC_INTEN_RXIEN_Msk (0x1ul << EMAC_INTEN_RXIEN_Pos) /*!< EMAC_T::INTEN: RXIEN Mask */ + +#define EMAC_INTEN_CRCEIEN_Pos (1) /*!< EMAC_T::INTEN: CRCEIEN Position */ +#define EMAC_INTEN_CRCEIEN_Msk (0x1ul << EMAC_INTEN_CRCEIEN_Pos) /*!< EMAC_T::INTEN: CRCEIEN Mask */ + +#define EMAC_INTEN_RXOVIEN_Pos (2) /*!< EMAC_T::INTEN: RXOVIEN Position */ +#define EMAC_INTEN_RXOVIEN_Msk (0x1ul << EMAC_INTEN_RXOVIEN_Pos) /*!< EMAC_T::INTEN: RXOVIEN Mask */ + +#define EMAC_INTEN_LPIEN_Pos (3) /*!< EMAC_T::INTEN: LPIEN Position */ +#define EMAC_INTEN_LPIEN_Msk (0x1ul << EMAC_INTEN_LPIEN_Pos) /*!< EMAC_T::INTEN: LPIEN Mask */ + +#define EMAC_INTEN_RXGDIEN_Pos (4) /*!< EMAC_T::INTEN: RXGDIEN Position */ +#define EMAC_INTEN_RXGDIEN_Msk (0x1ul << EMAC_INTEN_RXGDIEN_Pos) /*!< EMAC_T::INTEN: RXGDIEN Mask */ + +#define EMAC_INTEN_ALIEIEN_Pos (5) /*!< EMAC_T::INTEN: ALIEIEN Position */ +#define EMAC_INTEN_ALIEIEN_Msk (0x1ul << EMAC_INTEN_ALIEIEN_Pos) /*!< EMAC_T::INTEN: ALIEIEN Mask */ + +#define EMAC_INTEN_RPIEN_Pos (6) /*!< EMAC_T::INTEN: RPIEN Position */ +#define EMAC_INTEN_RPIEN_Msk (0x1ul << EMAC_INTEN_RPIEN_Pos) /*!< EMAC_T::INTEN: RPIEN Mask */ + +#define EMAC_INTEN_MPCOVIEN_Pos (7) /*!< EMAC_T::INTEN: MPCOVIEN Position */ +#define EMAC_INTEN_MPCOVIEN_Msk (0x1ul << EMAC_INTEN_MPCOVIEN_Pos) /*!< EMAC_T::INTEN: MPCOVIEN Mask */ + +#define EMAC_INTEN_MFLEIEN_Pos (8) /*!< EMAC_T::INTEN: MFLEIEN Position */ +#define EMAC_INTEN_MFLEIEN_Msk (0x1ul << EMAC_INTEN_MFLEIEN_Pos) /*!< EMAC_T::INTEN: MFLEIEN Mask */ + +#define EMAC_INTEN_DENIEN_Pos (9) /*!< EMAC_T::INTEN: DENIEN Position */ +#define EMAC_INTEN_DENIEN_Msk (0x1ul << EMAC_INTEN_DENIEN_Pos) /*!< EMAC_T::INTEN: DENIEN Mask */ + +#define EMAC_INTEN_RDUIEN_Pos (10) /*!< EMAC_T::INTEN: RDUIEN Position */ +#define EMAC_INTEN_RDUIEN_Msk (0x1ul << EMAC_INTEN_RDUIEN_Pos) /*!< EMAC_T::INTEN: RDUIEN Mask */ + +#define EMAC_INTEN_RXBEIEN_Pos (11) /*!< EMAC_T::INTEN: RXBEIEN Position */ +#define EMAC_INTEN_RXBEIEN_Msk (0x1ul << EMAC_INTEN_RXBEIEN_Pos) /*!< EMAC_T::INTEN: RXBEIEN Mask */ + +#define EMAC_INTEN_CFRIEN_Pos (14) /*!< EMAC_T::INTEN: CFRIEN Position */ +#define EMAC_INTEN_CFRIEN_Msk (0x1ul << EMAC_INTEN_CFRIEN_Pos) /*!< EMAC_T::INTEN: CFRIEN Mask */ + +#define EMAC_INTEN_WOLIEN_Pos (15) /*!< EMAC_T::INTEN: WOLIEN Position */ +#define EMAC_INTEN_WOLIEN_Msk (0x1ul << EMAC_INTEN_WOLIEN_Pos) /*!< EMAC_T::INTEN: WOLIEN Mask */ + +#define EMAC_INTEN_TXIEN_Pos (16) /*!< EMAC_T::INTEN: TXIEN Position */ +#define EMAC_INTEN_TXIEN_Msk (0x1ul << EMAC_INTEN_TXIEN_Pos) /*!< EMAC_T::INTEN: TXIEN Mask */ + +#define EMAC_INTEN_TXUDIEN_Pos (17) /*!< EMAC_T::INTEN: TXUDIEN Position */ +#define EMAC_INTEN_TXUDIEN_Msk (0x1ul << EMAC_INTEN_TXUDIEN_Pos) /*!< EMAC_T::INTEN: TXUDIEN Mask */ + +#define EMAC_INTEN_TXCPIEN_Pos (18) /*!< EMAC_T::INTEN: TXCPIEN Position */ +#define EMAC_INTEN_TXCPIEN_Msk (0x1ul << EMAC_INTEN_TXCPIEN_Pos) /*!< EMAC_T::INTEN: TXCPIEN Mask */ + +#define EMAC_INTEN_EXDEFIEN_Pos (19) /*!< EMAC_T::INTEN: EXDEFIEN Position */ +#define EMAC_INTEN_EXDEFIEN_Msk (0x1ul << EMAC_INTEN_EXDEFIEN_Pos) /*!< EMAC_T::INTEN: EXDEFIEN Mask */ + +#define EMAC_INTEN_NCSIEN_Pos (20) /*!< EMAC_T::INTEN: NCSIEN Position */ +#define EMAC_INTEN_NCSIEN_Msk (0x1ul << EMAC_INTEN_NCSIEN_Pos) /*!< EMAC_T::INTEN: NCSIEN Mask */ + +#define EMAC_INTEN_TXABTIEN_Pos (21) /*!< EMAC_T::INTEN: TXABTIEN Position */ +#define EMAC_INTEN_TXABTIEN_Msk (0x1ul << EMAC_INTEN_TXABTIEN_Pos) /*!< EMAC_T::INTEN: TXABTIEN Mask */ + +#define EMAC_INTEN_LCIEN_Pos (22) /*!< EMAC_T::INTEN: LCIEN Position */ +#define EMAC_INTEN_LCIEN_Msk (0x1ul << EMAC_INTEN_LCIEN_Pos) /*!< EMAC_T::INTEN: LCIEN Mask */ + +#define EMAC_INTEN_TDUIEN_Pos (23) /*!< EMAC_T::INTEN: TDUIEN Position */ +#define EMAC_INTEN_TDUIEN_Msk (0x1ul << EMAC_INTEN_TDUIEN_Pos) /*!< EMAC_T::INTEN: TDUIEN Mask */ + +#define EMAC_INTEN_TXBEIEN_Pos (24) /*!< EMAC_T::INTEN: TXBEIEN Position */ +#define EMAC_INTEN_TXBEIEN_Msk (0x1ul << EMAC_INTEN_TXBEIEN_Pos) /*!< EMAC_T::INTEN: TXBEIEN Mask */ + +#define EMAC_INTEN_TSALMIEN_Pos (28) /*!< EMAC_T::INTEN: TSALMIEN Position */ +#define EMAC_INTEN_TSALMIEN_Msk (0x1ul << EMAC_INTEN_TSALMIEN_Pos) /*!< EMAC_T::INTEN: TSALMIEN Mask */ + +#define EMAC_INTSTS_RXIF_Pos (0) /*!< EMAC_T::INTSTS: RXIF Position */ +#define EMAC_INTSTS_RXIF_Msk (0x1ul << EMAC_INTSTS_RXIF_Pos) /*!< EMAC_T::INTSTS: RXIF Mask */ + +#define EMAC_INTSTS_CRCEIF_Pos (1) /*!< EMAC_T::INTSTS: CRCEIF Position */ +#define EMAC_INTSTS_CRCEIF_Msk (0x1ul << EMAC_INTSTS_CRCEIF_Pos) /*!< EMAC_T::INTSTS: CRCEIF Mask */ + +#define EMAC_INTSTS_RXOVIF_Pos (2) /*!< EMAC_T::INTSTS: RXOVIF Position */ +#define EMAC_INTSTS_RXOVIF_Msk (0x1ul << EMAC_INTSTS_RXOVIF_Pos) /*!< EMAC_T::INTSTS: RXOVIF Mask */ + +#define EMAC_INTSTS_LPIF_Pos (3) /*!< EMAC_T::INTSTS: LPIF Position */ +#define EMAC_INTSTS_LPIF_Msk (0x1ul << EMAC_INTSTS_LPIF_Pos) /*!< EMAC_T::INTSTS: LPIF Mask */ + +#define EMAC_INTSTS_RXGDIF_Pos (4) /*!< EMAC_T::INTSTS: RXGDIF Position */ +#define EMAC_INTSTS_RXGDIF_Msk (0x1ul << EMAC_INTSTS_RXGDIF_Pos) /*!< EMAC_T::INTSTS: RXGDIF Mask */ + +#define EMAC_INTSTS_ALIEIF_Pos (5) /*!< EMAC_T::INTSTS: ALIEIF Position */ +#define EMAC_INTSTS_ALIEIF_Msk (0x1ul << EMAC_INTSTS_ALIEIF_Pos) /*!< EMAC_T::INTSTS: ALIEIF Mask */ + +#define EMAC_INTSTS_RPIF_Pos (6) /*!< EMAC_T::INTSTS: RPIF Position */ +#define EMAC_INTSTS_RPIF_Msk (0x1ul << EMAC_INTSTS_RPIF_Pos) /*!< EMAC_T::INTSTS: RPIF Mask */ + +#define EMAC_INTSTS_MPCOVIF_Pos (7) /*!< EMAC_T::INTSTS: MPCOVIF Position */ +#define EMAC_INTSTS_MPCOVIF_Msk (0x1ul << EMAC_INTSTS_MPCOVIF_Pos) /*!< EMAC_T::INTSTS: MPCOVIF Mask */ + +#define EMAC_INTSTS_MFLEIF_Pos (8) /*!< EMAC_T::INTSTS: MFLEIF Position */ +#define EMAC_INTSTS_MFLEIF_Msk (0x1ul << EMAC_INTSTS_MFLEIF_Pos) /*!< EMAC_T::INTSTS: MFLEIF Mask */ + +#define EMAC_INTSTS_DENIF_Pos (9) /*!< EMAC_T::INTSTS: DENIF Position */ +#define EMAC_INTSTS_DENIF_Msk (0x1ul << EMAC_INTSTS_DENIF_Pos) /*!< EMAC_T::INTSTS: DENIF Mask */ + +#define EMAC_INTSTS_RDUIF_Pos (10) /*!< EMAC_T::INTSTS: RDUIF Position */ +#define EMAC_INTSTS_RDUIF_Msk (0x1ul << EMAC_INTSTS_RDUIF_Pos) /*!< EMAC_T::INTSTS: RDUIF Mask */ + +#define EMAC_INTSTS_RXBEIF_Pos (11) /*!< EMAC_T::INTSTS: RXBEIF Position */ +#define EMAC_INTSTS_RXBEIF_Msk (0x1ul << EMAC_INTSTS_RXBEIF_Pos) /*!< EMAC_T::INTSTS: RXBEIF Mask */ + +#define EMAC_INTSTS_CFRIF_Pos (14) /*!< EMAC_T::INTSTS: CFRIF Position */ +#define EMAC_INTSTS_CFRIF_Msk (0x1ul << EMAC_INTSTS_CFRIF_Pos) /*!< EMAC_T::INTSTS: CFRIF Mask */ + +#define EMAC_INTSTS_WOLIF_Pos (15) /*!< EMAC_T::INTSTS: WOLIF Position */ +#define EMAC_INTSTS_WOLIF_Msk (0x1ul << EMAC_INTSTS_WOLIF_Pos) /*!< EMAC_T::INTSTS: WOLIF Mask */ + +#define EMAC_INTSTS_TXIF_Pos (16) /*!< EMAC_T::INTSTS: TXIF Position */ +#define EMAC_INTSTS_TXIF_Msk (0x1ul << EMAC_INTSTS_TXIF_Pos) /*!< EMAC_T::INTSTS: TXIF Mask */ + +#define EMAC_INTSTS_TXUDIF_Pos (17) /*!< EMAC_T::INTSTS: TXUDIF Position */ +#define EMAC_INTSTS_TXUDIF_Msk (0x1ul << EMAC_INTSTS_TXUDIF_Pos) /*!< EMAC_T::INTSTS: TXUDIF Mask */ + +#define EMAC_INTSTS_TXCPIF_Pos (18) /*!< EMAC_T::INTSTS: TXCPIF Position */ +#define EMAC_INTSTS_TXCPIF_Msk (0x1ul << EMAC_INTSTS_TXCPIF_Pos) /*!< EMAC_T::INTSTS: TXCPIF Mask */ + +#define EMAC_INTSTS_EXDEFIF_Pos (19) /*!< EMAC_T::INTSTS: EXDEFIF Position */ +#define EMAC_INTSTS_EXDEFIF_Msk (0x1ul << EMAC_INTSTS_EXDEFIF_Pos) /*!< EMAC_T::INTSTS: EXDEFIF Mask */ + +#define EMAC_INTSTS_NCSIF_Pos (20) /*!< EMAC_T::INTSTS: NCSIF Position */ +#define EMAC_INTSTS_NCSIF_Msk (0x1ul << EMAC_INTSTS_NCSIF_Pos) /*!< EMAC_T::INTSTS: NCSIF Mask */ + +#define EMAC_INTSTS_TXABTIF_Pos (21) /*!< EMAC_T::INTSTS: TXABTIF Position */ +#define EMAC_INTSTS_TXABTIF_Msk (0x1ul << EMAC_INTSTS_TXABTIF_Pos) /*!< EMAC_T::INTSTS: TXABTIF Mask */ + +#define EMAC_INTSTS_LCIF_Pos (22) /*!< EMAC_T::INTSTS: LCIF Position */ +#define EMAC_INTSTS_LCIF_Msk (0x1ul << EMAC_INTSTS_LCIF_Pos) /*!< EMAC_T::INTSTS: LCIF Mask */ + +#define EMAC_INTSTS_TDUIF_Pos (23) /*!< EMAC_T::INTSTS: TDUIF Position */ +#define EMAC_INTSTS_TDUIF_Msk (0x1ul << EMAC_INTSTS_TDUIF_Pos) /*!< EMAC_T::INTSTS: TDUIF Mask */ + +#define EMAC_INTSTS_TXBEIF_Pos (24) /*!< EMAC_T::INTSTS: TXBEIF Position */ +#define EMAC_INTSTS_TXBEIF_Msk (0x1ul << EMAC_INTSTS_TXBEIF_Pos) /*!< EMAC_T::INTSTS: TXBEIF Mask */ + +#define EMAC_INTSTS_TSALMIF_Pos (28) /*!< EMAC_T::INTSTS: TSALMIF Position */ +#define EMAC_INTSTS_TSALMIF_Msk (0x1ul << EMAC_INTSTS_TSALMIF_Pos) /*!< EMAC_T::INTSTS: TSALMIF Mask */ + +#define EMAC_GENSTS_CFR_Pos (0) /*!< EMAC_T::GENSTS: CFR Position */ +#define EMAC_GENSTS_CFR_Msk (0x1ul << EMAC_GENSTS_CFR_Pos) /*!< EMAC_T::GENSTS: CFR Mask */ + +#define EMAC_GENSTS_RXHALT_Pos (1) /*!< EMAC_T::GENSTS: RXHALT Position */ +#define EMAC_GENSTS_RXHALT_Msk (0x1ul << EMAC_GENSTS_RXHALT_Pos) /*!< EMAC_T::GENSTS: RXHALT Mask */ + +#define EMAC_GENSTS_RXFFULL_Pos (2) /*!< EMAC_T::GENSTS: RXFFULL Position */ +#define EMAC_GENSTS_RXFFULL_Msk (0x1ul << EMAC_GENSTS_RXFFULL_Pos) /*!< EMAC_T::GENSTS: RXFFULL Mask */ + +#define EMAC_GENSTS_COLCNT_Pos (4) /*!< EMAC_T::GENSTS: COLCNT Position */ +#define EMAC_GENSTS_COLCNT_Msk (0xful << EMAC_GENSTS_COLCNT_Pos) /*!< EMAC_T::GENSTS: COLCNT Mask */ + +#define EMAC_GENSTS_DEF_Pos (8) /*!< EMAC_T::GENSTS: DEF Position */ +#define EMAC_GENSTS_DEF_Msk (0x1ul << EMAC_GENSTS_DEF_Pos) /*!< EMAC_T::GENSTS: DEF Mask */ + +#define EMAC_GENSTS_TXPAUSED_Pos (9) /*!< EMAC_T::GENSTS: TXPAUSED Position */ +#define EMAC_GENSTS_TXPAUSED_Msk (0x1ul << EMAC_GENSTS_TXPAUSED_Pos) /*!< EMAC_T::GENSTS: TXPAUSED Mask */ + +#define EMAC_GENSTS_SQE_Pos (10) /*!< EMAC_T::GENSTS: SQE Position */ +#define EMAC_GENSTS_SQE_Msk (0x1ul << EMAC_GENSTS_SQE_Pos) /*!< EMAC_T::GENSTS: SQE Mask */ + +#define EMAC_GENSTS_TXHALT_Pos (11) /*!< EMAC_T::GENSTS: TXHALT Position */ +#define EMAC_GENSTS_TXHALT_Msk (0x1ul << EMAC_GENSTS_TXHALT_Pos) /*!< EMAC_T::GENSTS: TXHALT Mask */ + +#define EMAC_GENSTS_RPSTS_Pos (12) /*!< EMAC_T::GENSTS: RPSTS Position */ +#define EMAC_GENSTS_RPSTS_Msk (0x1ul << EMAC_GENSTS_RPSTS_Pos) /*!< EMAC_T::GENSTS: RPSTS Mask */ + +#define EMAC_MPCNT_MPCNT_Pos (0) /*!< EMAC_T::MPCNT: MPCNT Position */ +#define EMAC_MPCNT_MPCNT_Msk (0xfffful << EMAC_MPCNT_MPCNT_Pos) /*!< EMAC_T::MPCNT: MPCNT Mask */ + +#define EMAC_RPCNT_RPCNT_Pos (0) /*!< EMAC_T::RPCNT: RPCNT Position */ +#define EMAC_RPCNT_RPCNT_Msk (0xfffful << EMAC_RPCNT_RPCNT_Pos) /*!< EMAC_T::RPCNT: RPCNT Mask */ + +#define EMAC_FRSTS_RXFLT_Pos (0) /*!< EMAC_T::FRSTS: RXFLT Position */ +#define EMAC_FRSTS_RXFLT_Msk (0xfffful << EMAC_FRSTS_RXFLT_Pos) /*!< EMAC_T::FRSTS: RXFLT Mask */ + +#define EMAC_CTXDSA_CTXDSA_Pos (0) /*!< EMAC_T::CTXDSA: CTXDSA Position */ +#define EMAC_CTXDSA_CTXDSA_Msk (0xfffffffful << EMAC_CTXDSA_CTXDSA_Pos) /*!< EMAC_T::CTXDSA: CTXDSA Mask */ + +#define EMAC_CTXBSA_CTXBSA_Pos (0) /*!< EMAC_T::CTXBSA: CTXBSA Position */ +#define EMAC_CTXBSA_CTXBSA_Msk (0xfffffffful << EMAC_CTXBSA_CTXBSA_Pos) /*!< EMAC_T::CTXBSA: CTXBSA Mask */ + +#define EMAC_CRXDSA_CRXDSA_Pos (0) /*!< EMAC_T::CRXDSA: CRXDSA Position */ +#define EMAC_CRXDSA_CRXDSA_Msk (0xfffffffful << EMAC_CRXDSA_CRXDSA_Pos) /*!< EMAC_T::CRXDSA: CRXDSA Mask */ + +#define EMAC_CRXBSA_CRXBSA_Pos (0) /*!< EMAC_T::CRXBSA: CRXBSA Position */ +#define EMAC_CRXBSA_CRXBSA_Msk (0xfffffffful << EMAC_CRXBSA_CRXBSA_Pos) /*!< EMAC_T::CRXBSA: CRXBSA Mask */ + +#define EMAC_TSCTL_TSEN_Pos (0) /*!< EMAC_T::TSCTL: TSEN Position */ +#define EMAC_TSCTL_TSEN_Msk (0x1ul << EMAC_TSCTL_TSEN_Pos) /*!< EMAC_T::TSCTL: TSEN Mask */ + +#define EMAC_TSCTL_TSIEN_Pos (1) /*!< EMAC_T::TSCTL: TSIEN Position */ +#define EMAC_TSCTL_TSIEN_Msk (0x1ul << EMAC_TSCTL_TSIEN_Pos) /*!< EMAC_T::TSCTL: TSIEN Mask */ + +#define EMAC_TSCTL_TSMODE_Pos (2) /*!< EMAC_T::TSCTL: TSMODE Position */ +#define EMAC_TSCTL_TSMODE_Msk (0x1ul << EMAC_TSCTL_TSMODE_Pos) /*!< EMAC_T::TSCTL: TSMODE Mask */ + +#define EMAC_TSCTL_TSUPDATE_Pos (3) /*!< EMAC_T::TSCTL: TSUPDATE Position */ +#define EMAC_TSCTL_TSUPDATE_Msk (0x1ul << EMAC_TSCTL_TSUPDATE_Pos) /*!< EMAC_T::TSCTL: TSUPDATE Mask */ + +#define EMAC_TSCTL_TSALMEN_Pos (5) /*!< EMAC_T::TSCTL: TSALMEN Position */ +#define EMAC_TSCTL_TSALMEN_Msk (0x1ul << EMAC_TSCTL_TSALMEN_Pos) /*!< EMAC_T::TSCTL: TSALMEN Mask */ + +#define EMAC_TSSEC_SEC_Pos (0) /*!< EMAC_T::TSSEC: SEC Position */ +#define EMAC_TSSEC_SEC_Msk (0xfffffffful << EMAC_TSSEC_SEC_Pos) /*!< EMAC_T::TSSEC: SEC Mask */ + +#define EMAC_TSSUBSEC_SUBSEC_Pos (0) /*!< EMAC_T::TSSUBSEC: SUBSEC Position */ +#define EMAC_TSSUBSEC_SUBSEC_Msk (0xfffffffful << EMAC_TSSUBSEC_SUBSEC_Pos) /*!< EMAC_T::TSSUBSEC: SUBSEC Mask */ + +#define EMAC_TSINC_CNTINC_Pos (0) /*!< EMAC_T::TSINC: CNTINC Position */ +#define EMAC_TSINC_CNTINC_Msk (0xfful << EMAC_TSINC_CNTINC_Pos) /*!< EMAC_T::TSINC: CNTINC Mask */ + +#define EMAC_TSADDEND_ADDEND_Pos (0) /*!< EMAC_T::TSADDEND: ADDEND Position */ +#define EMAC_TSADDEND_ADDEND_Msk (0xfffffffful << EMAC_TSADDEND_ADDEND_Pos) /*!< EMAC_T::TSADDEND: ADDEND Mask */ + +#define EMAC_UPDSEC_SEC_Pos (0) /*!< EMAC_T::UPDSEC: SEC Position */ +#define EMAC_UPDSEC_SEC_Msk (0xfffffffful << EMAC_UPDSEC_SEC_Pos) /*!< EMAC_T::UPDSEC: SEC Mask */ + +#define EMAC_UPDSUBSEC_SUBSEC_Pos (0) /*!< EMAC_T::UPDSUBSEC: SUBSEC Position */ +#define EMAC_UPDSUBSEC_SUBSEC_Msk (0xfffffffful << EMAC_UPDSUBSEC_SUBSEC_Pos) /*!< EMAC_T::UPDSUBSEC: SUBSEC Mask */ + +#define EMAC_ALMSEC_SEC_Pos (0) /*!< EMAC_T::ALMSEC: SEC Position */ +#define EMAC_ALMSEC_SEC_Msk (0xfffffffful << EMAC_ALMSEC_SEC_Pos) /*!< EMAC_T::ALMSEC: SEC Mask */ + +#define EMAC_ALMSUBSEC_SUBSEC_Pos (0) /*!< EMAC_T::ALMSUBSEC: SUBSEC Position */ +#define EMAC_ALMSUBSEC_SUBSEC_Msk (0xfffffffful << EMAC_ALMSUBSEC_SUBSEC_Pos) /*!< EMAC_T::ALMSUBSEC: SUBSEC Mask */ + +/**@}*/ /* EMAC_CONST */ +/**@}*/ /* end of EMAC register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __EMAC_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/epwm_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/epwm_reg.h new file mode 100644 index 00000000000..aa4ba4a478b --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/epwm_reg.h @@ -0,0 +1,4023 @@ +/**************************************************************************//** + * @file epwm_reg.h + * @version V1.00 + * @brief EPWM register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __EPWM_REG_H__ +#define __EPWM_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup EPWM Pulse Width Modulation Controller(EPWM) + Memory Mapped Structure for EPWM Controller +@{ */ + +typedef struct +{ + /** + * @var ECAPDAT_T::RCAPDAT + * Offset: 0x20C EPWM Rising Capture Data Register 0~5 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |RCAPDAT |EPWM Rising Capture Data (Read Only) + * | | |When rising capture condition happened, the EPWM counter value will be saved in this register. + * @var ECAPDAT_T::FCAPDAT + * Offset: 0x210 EPWM Falling Capture Data Register 0~5 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |FCAPDAT |EPWM Falling Capture Data (Read Only) + * | | |When falling capture condition happened, the EPWM counter value will be saved in this register. + */ + __IO uint32_t RCAPDAT; /*!< [0x20C/0x214/0x21C/0x224/0x22C/0x234] EPWM Rising Capture Data Register 0~5 */ + __IO uint32_t FCAPDAT; /*!< [0x210/0x218/0x220/0x228/0x230/0x238] EPWM Falling Capture Data Register 0~5 */ +} ECAPDAT_T; + +typedef struct +{ + + + /** + * @var EPWM_T::CTL0 + * Offset: 0x00 EPWM Control Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CTRLD0 |Center Re-load + * | | |In up-down counter type, PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the center point of a period + * |[1] |CTRLD1 |Center Re-load + * | | |In up-down counter type, PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the center point of a period + * |[2] |CTRLD2 |Center Re-load + * | | |In up-down counter type, PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the center point of a period + * |[3] |CTRLD3 |Center Re-load + * | | |In up-down counter type, PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the center point of a period + * |[4] |CTRLD4 |Center Re-load + * | | |In up-down counter type, PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the center point of a period + * |[5] |CTRLD5 |Center Re-load + * | | |In up-down counter type, PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the center point of a period + * |[8] |WINLDEN0 |Window Load Enable Bits + * | | |0 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point or center point of each period by setting CTRLD bit. + * | | |1 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point of each period when valid reload window is set + * | | |The valid reload window is set by software write 1 to EPWM_LOAD register and cleared by hardware after load success. + * |[9] |WINLDEN1 |Window Load Enable Bits + * | | |0 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point or center point of each period by setting CTRLD bit. + * | | |1 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point of each period when valid reload window is set + * | | |The valid reload window is set by software write 1 to EPWM_LOAD register and cleared by hardware after load success. + * |[10] |WINLDEN2 |Window Load Enable Bits + * | | |0 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point or center point of each period by setting CTRLD bit. + * | | |1 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point of each period when valid reload window is set + * | | |The valid reload window is set by software write 1 to EPWM_LOAD register and cleared by hardware after load success. + * |[11] |WINLDEN3 |Window Load Enable Bits + * | | |0 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point or center point of each period by setting CTRLD bit. + * | | |1 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point of each period when valid reload window is set + * | | |The valid reload window is set by software write 1 to EPWM_LOAD register and cleared by hardware after load success. + * |[12] |WINLDEN4 |Window Load Enable Bits + * | | |0 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point or center point of each period by setting CTRLD bit. + * | | |1 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point of each period when valid reload window is set + * | | |The valid reload window is set by software write 1 to EPWM_LOAD register and cleared by hardware after load success. + * |[13] |WINLDEN5 |Window Load Enable Bits + * | | |0 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point or center point of each period by setting CTRLD bit. + * | | |1 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point of each period when valid reload window is set + * | | |The valid reload window is set by software write 1 to EPWM_LOAD register and cleared by hardware after load success. + * |[16] |IMMLDEN0 |Immediately Load Enable Bits + * | | |0 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point or center point of each period by setting CTRLD bit. + * | | |1 = PERIOD/CMPDAT will load to PBUF and CMPBUF immediately when software update PERIOD/CMPDAT. + * | | |Note: If IMMLDENn is enabled, WINLDENn and CTRLDn will be invalid. + * |[17] |IMMLDEN1 |Immediately Load Enable Bits + * | | |0 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point or center point of each period by setting CTRLD bit. + * | | |1 = PERIOD/CMPDAT will load to PBUF and CMPBUF immediately when software update PERIOD/CMPDAT. + * | | |Note: If IMMLDENn is enabled, WINLDENn and CTRLDn will be invalid. + * |[18] |IMMLDEN2 |Immediately Load Enable Bits + * | | |0 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point or center point of each period by setting CTRLD bit. + * | | |1 = PERIOD/CMPDAT will load to PBUF and CMPBUF immediately when software update PERIOD/CMPDAT. + * | | |Note: If IMMLDENn is enabled, WINLDENn and CTRLDn will be invalid. + * |[19] |IMMLDEN3 |Immediately Load Enable Bits + * | | |0 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point or center point of each period by setting CTRLD bit. + * | | |1 = PERIOD/CMPDAT will load to PBUF and CMPBUF immediately when software update PERIOD/CMPDAT. + * | | |Note: If IMMLDENn is enabled, WINLDENn and CTRLDn will be invalid. + * |[20] |IMMLDEN4 |Immediately Load Enable Bits + * | | |0 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point or center point of each period by setting CTRLD bit. + * | | |1 = PERIOD/CMPDAT will load to PBUF and CMPBUF immediately when software update PERIOD/CMPDAT. + * | | |Note: If IMMLDENn is enabled, WINLDENn and CTRLDn will be invalid. + * |[21] |IMMLDEN5 |Immediately Load Enable Bits + * | | |0 = PERIOD will load to PBUF at the end point of each period + * | | |CMPDAT will load to CMPBUF at the end point or center point of each period by setting CTRLD bit. + * | | |1 = PERIOD/CMPDAT will load to PBUF and CMPBUF immediately when software update PERIOD/CMPDAT. + * | | |Note: If IMMLDENn is enabled, WINLDENn and CTRLDn will be invalid. + * |[24] |GROUPEN |Group Function Enable Bit(S) + * | | |0 = The output waveform of each EPWM channel are independent. + * | | |1 = Unify the EPWM_CH2 and EPWM_CH4 to output the same waveform as EPWM_CH0 and unify the EPWM_CH3 and EPWM_CH5 to output the same waveform as EPWM_CH1. + * |[30] |DBGHALT |ICE Debug Mode Counter Halt (Write Protect) + * | | |If counter halt is enabled, EPWM all counters will keep current value until exit ICE debug mode. + * | | |0 = ICE debug mode counter halt disable. + * | | |1 = ICE debug mode counter halt enable. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[31] |DBGTRIOFF |ICE Debug Mode Acknowledge Disable (Write Protect) + * | | |0 = ICE debug mode acknowledgement effects EPWM output. + * | | |EPWM pin will be forced as tri-state while ICE debug mode acknowledged. + * | | |1 = ICE debug mode acknowledgement disabled. + * | | |EPWM pin will keep output no matter ICE debug mode acknowledged or not. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * @var EPWM_T::CTL1 + * Offset: 0x04 EPWM Control Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |CNTTYPE0 |EPWM Counter Behavior Type + * | | |00 = Up counter type (supports in capture mode). + * | | |01 = Down count type (supports in capture mode). + * | | |10 = Up-down counter type. + * | | |11 = Reserved. + * |[3:2] |CNTTYPE1 |EPWM Counter Behavior Type + * | | |00 = Up counter type (supports in capture mode). + * | | |01 = Down count type (supports in capture mode). + * | | |10 = Up-down counter type. + * | | |11 = Reserved. + * |[5:4] |CNTTYPE2 |EPWM Counter Behavior Type + * | | |00 = Up counter type (supports in capture mode). + * | | |01 = Down count type (supports in capture mode). + * | | |10 = Up-down counter type. + * | | |11 = Reserved. + * |[7:6] |CNTTYPE3 |EPWM Counter Behavior Type + * | | |00 = Up counter type (supports in capture mode). + * | | |01 = Down count type (supports in capture mode). + * | | |10 = Up-down counter type. + * | | |11 = Reserved. + * |[9:8] |CNTTYPE4 |EPWM Counter Behavior Type + * | | |00 = Up counter type (supports in capture mode). + * | | |01 = Down count type (supports in capture mode). + * | | |10 = Up-down counter type. + * | | |11 = Reserved. + * |[11:10] |CNTTYPE5 |EPWM Counter Behavior Type + * | | |00 = Up counter type (supports in capture mode). + * | | |01 = Down count type (supports in capture mode). + * | | |10 = Up-down counter type. + * | | |11 = Reserved. + * |[16] |CNTMODE0 |EPWM Counter Mode + * | | |0 = Auto-reload mode. + * | | |1 = One-shot mode. + * |[17] |CNTMODE1 |EPWM Counter Mode + * | | |0 = Auto-reload mode. + * | | |1 = One-shot mode. + * |[18] |CNTMODE2 |EPWM Counter Mode + * | | |0 = Auto-reload mode. + * | | |1 = One-shot mode. + * |[19] |CNTMODE3 |EPWM Counter Mode + * | | |0 = Auto-reload mode. + * | | |1 = One-shot mode. + * |[20] |CNTMODE4 |EPWM Counter Mode + * | | |0 = Auto-reload mode. + * | | |1 = One-shot mode. + * |[21] |CNTMODE5 |EPWM Counter Mode + * | | |0 = Auto-reload mode. + * | | |1 = One-shot mode. + * |[24] |OUTMODE0 |EPWM Output Mode + * | | |Each bit n controls the output mode of corresponding EPWM channel n. + * | | |0 = EPWM independent mode. + * | | |1 = EPWM complementary mode. + * | | |Note: When operating in group function, these bits must all set to the same mode. + * |[25] |OUTMODE2 |EPWM Output Mode + * | | |Each bit n controls the output mode of corresponding EPWM channel n. + * | | |0 = EPWM independent mode. + * | | |1 = EPWM complementary mode. + * | | |Note: When operating in group function, these bits must all set to the same mode. + * |[26] |OUTMODE4 |EPWM Output Mode + * | | |Each bit n controls the output mode of corresponding EPWM channel n. + * | | |0 = EPWM independent mode. + * | | |1 = EPWM complementary mode. + * | | |Note: When operating in group function, these bits must all set to the same mode. + * @var EPWM_T::SYNC + * Offset: 0x08 EPWM Synchronization Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |PHSEN0 |SYNC Phase Enable Bits + * | | |0 = EPWM counter disable to load PHS value. + * | | |1 = EPWM counter enable to load PHS value. + * |[1] |PHSEN2 |SYNC Phase Enable Bits + * | | |0 = EPWM counter disable to load PHS value. + * | | |1 = EPWM counter enable to load PHS value. + * |[2] |PHSEN4 |SYNC Phase Enable Bits + * | | |0 = EPWM counter disable to load PHS value. + * | | |1 = EPWM counter enable to load PHS value. + * |[9:8] |SINSRC0 |EPWM0_SYNC_IN Source Selection + * | | |00 = Synchronize source from SYNC_IN or SWSYNC. + * | | |01 = Counter equal to 0. + * | | |10 = Counter equal to EPWM_CMPDATm, m denotes 1, 3, 5. + * | | |11 = SYNC_OUT will not be generated. + * |[11:10] |SINSRC2 |EPWM0_SYNC_IN Source Selection + * | | |00 = Synchronize source from SYNC_IN or SWSYNC. + * | | |01 = Counter equal to 0. + * | | |10 = Counter equal to EPWM_CMPDATm, m denotes 1, 3, 5. + * | | |11 = SYNC_OUT will not be generated. + * |[13:12] |SINSRC4 |EPWM0_SYNC_IN Source Selection + * | | |00 = Synchronize source from SYNC_IN or SWSYNC. + * | | |01 = Counter equal to 0. + * | | |10 = Counter equal to EPWM_CMPDATm, m denotes 1, 3, 5. + * | | |11 = SYNC_OUT will not be generated. + * |[16] |SNFLTEN |EPWM0_SYNC_IN Noise Filter Enable Bits + * | | |0 = Noise filter of input pin EPWM0_SYNC_IN is Disabled. + * | | |1 = Noise filter of input pin EPWM0_SYNC_IN is Enabled. + * |[19:17] |SFLTCSEL |SYNC Edge Detector Filter Clock Selection + * | | |000 = Filter clock = HCLK. + * | | |001 = Filter clock = HCLK/2. + * | | |010 = Filter clock = HCLK/4. + * | | |011 = Filter clock = HCLK/8. + * | | |100 = Filter clock = HCLK/16. + * | | |101 = Filter clock = HCLK/32. + * | | |110 = Filter clock = HCLK/64. + * | | |111 = Filter clock = HCLK/128. + * |[22:20] |SFLTCNT |SYNC Edge Detector Filter Count + * | | |The register bits control the counter number of edge detector. + * |[23] |SINPINV |SYNC Input Pin Inverse + * | | |0 = The state of pin SYNC is passed to the negative edge detector. + * | | |1 = The inversed state of pin SYNC is passed to the negative edge detector. + * |[24] |PHSDIR0 |EPWM Phase Direction Control + * | | |0 = Control EPWM counter count decrement after synchronizing. + * | | |1 = Control EPWM counter count increment after synchronizing. + * |[25] |PHSDIR2 |EPWM Phase Direction Control + * | | |0 = Control EPWM counter count decrement after synchronizing. + * | | |1 = Control EPWM counter count increment after synchronizing. + * |[26] |PHSDIR4 |EPWM Phase Direction Control + * | | |0 = Control EPWM counter count decrement after synchronizing. + * | | |1 = Control EPWM counter count increment after synchronizing. + * @var EPWM_T::SWSYNC + * Offset: 0x0C EPWM Software Control Synchronization Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SWSYNC0 |Software SYNC Function + * | | |When SINSRCn (EPWM_SYNC[13:8]) is selected to 0, SYNC_OUT source is come from SYNC_IN or this bit. + * |[1] |SWSYNC2 |Software SYNC Function + * | | |When SINSRCn (EPWM_SYNC[13:8]) is selected to 0, SYNC_OUT source is come from SYNC_IN or this bit. + * |[2] |SWSYNC4 |Software SYNC Function + * | | |When SINSRCn (EPWM_SYNC[13:8]) is selected to 0, SYNC_OUT source is come from SYNC_IN or this bit. + * @var EPWM_T::CLKSRC + * Offset: 0x10 EPWM Clock Source Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2:0] |ECLKSRC0 |EPWM_CH01 External Clock Source Select + * | | |000 = EPWMx_CLK, x denotes 0 or 1. + * | | |001 = TIMER0 overflow. + * | | |010 = TIMER1 overflow. + * | | |011 = TIMER2 overflow. + * | | |100 = TIMER3 overflow. + * | | |Others = Reserved. + * |[10:8] |ECLKSRC2 |EPWM_CH23 External Clock Source Select + * | | |000 = EPWMx_CLK, x denotes 0 or 1. + * | | |001 = TIMER0 overflow. + * | | |010 = TIMER1 overflow. + * | | |011 = TIMER2 overflow. + * | | |100 = TIMER3 overflow. + * | | |Others = Reserved. + * |[18:16] |ECLKSRC4 |EPWM_CH45 External Clock Source Select + * | | |000 = EPWMx_CLK, x denotes 0 or 1. + * | | |001 = TIMER0 overflow. + * | | |010 = TIMER1 overflow. + * | | |011 = TIMER2 overflow. + * | | |100 = TIMER3 overflow. + * | | |Others = Reserved. + * @var EPWM_T::CLKPSC[3] + * Offset: 0x14 EPWM Clock Prescale Register 0/1, 2/3, 4/5 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[11:0] |CLKPSC |EPWM Counter Clock Prescale + * | | |The clock of EPWM counter is decided by clock prescaler + * | | |Each EPWM pair share one EPWM counter clock prescaler + * | | |The clock of EPWM counter is divided by (CLKPSC+ 1) + * @var EPWM_T::CNTEN + * Offset: 0x20 EPWM Counter Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CNTEN0 |EPWM Counter Enable Bits + * | | |0 = EPWM Counter and clock prescaler Stop Running. + * | | |1 = EPWM Counter and clock prescaler Start Running. + * |[1] |CNTEN1 |EPWM Counter Enable Bits + * | | |0 = EPWM Counter and clock prescaler Stop Running. + * | | |1 = EPWM Counter and clock prescaler Start Running. + * |[2] |CNTEN2 |EPWM Counter Enable Bits + * | | |0 = EPWM Counter and clock prescaler Stop Running. + * | | |1 = EPWM Counter and clock prescaler Start Running. + * |[3] |CNTEN3 |EPWM Counter Enable Bits + * | | |0 = EPWM Counter and clock prescaler Stop Running. + * | | |1 = EPWM Counter and clock prescaler Start Running. + * |[4] |CNTEN4 |EPWM Counter Enable Bits + * | | |0 = EPWM Counter and clock prescaler Stop Running. + * | | |1 = EPWM Counter and clock prescaler Start Running. + * |[5] |CNTEN5 |EPWM Counter Enable Bits + * | | |0 = EPWM Counter and clock prescaler Stop Running. + * | | |1 = EPWM Counter and clock prescaler Start Running. + * @var EPWM_T::CNTCLR + * Offset: 0x24 EPWM Clear Counter Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CNTCLR0 |Clear EPWM Counter Control Bit + * | | |It is automatically cleared by hardware. Each bit n controls the corresponding EPWM channel n. + * | | |0 = No effect. + * | | |1 = Clear 16-bit EPWM counter to 0000H. + * |[1] |CNTCLR1 |Clear EPWM Counter Control Bit + * | | |It is automatically cleared by hardware. Each bit n controls the corresponding EPWM channel n. + * | | |0 = No effect. + * | | |1 = Clear 16-bit EPWM counter to 0000H. + * |[2] |CNTCLR2 |Clear EPWM Counter Control Bit + * | | |It is automatically cleared by hardware. Each bit n controls the corresponding EPWM channel n. + * | | |0 = No effect. + * | | |1 = Clear 16-bit EPWM counter to 0000H. + * |[3] |CNTCLR3 |Clear EPWM Counter Control Bit + * | | |It is automatically cleared by hardware. Each bit n controls the corresponding EPWM channel n. + * | | |0 = No effect. + * | | |1 = Clear 16-bit EPWM counter to 0000H. + * |[4] |CNTCLR4 |Clear EPWM Counter Control Bit + * | | |It is automatically cleared by hardware. Each bit n controls the corresponding EPWM channel n. + * | | |0 = No effect. + * | | |1 = Clear 16-bit EPWM counter to 0000H. + * |[5] |CNTCLR5 |Clear EPWM Counter Control Bit + * | | |It is automatically cleared by hardware. Each bit n controls the corresponding EPWM channel n. + * | | |0 = No effect. + * | | |1 = Clear 16-bit EPWM counter to 0000H. + * @var EPWM_T::LOAD + * Offset: 0x28 EPWM Load Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |LOAD0 |Re-load EPWM Comparator Register (CMPDAT) Control Bit + * | | |This bit is software write, hardware clear when current EPWM period end. + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Set load window of window loading mode. + * | | |Read Operation: + * | | |0 = No load window is set. + * | | |1 = Load window is set. + * | | |Note: This bit only use in window loading mode, WINLDENn(EPWM_CTL0[13:8]) = 1. + * |[1] |LOAD1 |Re-load EPWM Comparator Register (CMPDAT) Control Bit + * | | |This bit is software write, hardware clear when current EPWM period end. + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Set load window of window loading mode. + * | | |Read Operation: + * | | |0 = No load window is set. + * | | |1 = Load window is set. + * | | |Note: This bit only use in window loading mode, WINLDENn(EPWM_CTL0[13:8]) = 1. + * |[2] |LOAD2 |Re-load EPWM Comparator Register (CMPDAT) Control Bit + * | | |This bit is software write, hardware clear when current EPWM period end. + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Set load window of window loading mode. + * | | |Read Operation: + * | | |0 = No load window is set. + * | | |1 = Load window is set. + * | | |Note: This bit only use in window loading mode, WINLDENn(EPWM_CTL0[13:8]) = 1. + * |[3] |LOAD3 |Re-load EPWM Comparator Register (CMPDAT) Control Bit + * | | |This bit is software write, hardware clear when current EPWM period end. + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Set load window of window loading mode. + * | | |Read Operation: + * | | |0 = No load window is set. + * | | |1 = Load window is set. + * | | |Note: This bit only use in window loading mode, WINLDENn(EPWM_CTL0[13:8]) = 1. + * |[4] |LOAD4 |Re-load EPWM Comparator Register (CMPDAT) Control Bit + * | | |This bit is software write, hardware clear when current EPWM period end. + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Set load window of window loading mode. + * | | |Read Operation: + * | | |0 = No load window is set. + * | | |1 = Load window is set. + * | | |Note: This bit only use in window loading mode, WINLDENn(EPWM_CTL0[13:8]) = 1. + * |[5] |LOAD5 |Re-load EPWM Comparator Register (CMPDAT) Control Bit + * | | |This bit is software write, hardware clear when current EPWM period end. + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Set load window of window loading mode. + * | | |Read Operation: + * | | |0 = No load window is set. + * | | |1 = Load window is set. + * | | |Note: This bit only use in window loading mode, WINLDENn(EPWM_CTL0[13:8]) = 1. + * @var EPWM_T::PERIOD[6] + * Offset: 0x30 EPWM Period Register 0~5 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |PERIOD |EPWM Period Register + * | | |Up-Count mode: In this mode, EPWM counter counts from 0 to PERIOD, and restarts from 0. + * | | |Down-Count mode: In this mode, EPWM counter counts from PERIOD to 0, and restarts from PERIOD. + * | | |EPWM period time = (PERIOD+1) * EPWM_CLK period. + * | | |Up-Down-Count mode: In this mode, EPWM counter counts from 0 to PERIOD, then decrements to 0 and repeats again. + * | | |EPWM period time = 2 * PERIOD * EPWM_CLK period. + * @var EPWM_T::CMPDAT[6] + * Offset: 0x50 EPWM Comparator Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |CMP |EPWM Comparator Register + * | | |CMP use to compare with CNTR to generate EPWM waveform, interrupt and trigger EADC/DAC. + * | | |In independent mode, CMPDAT0~5 denote as 6 independent EPWM_CH0~5 compared point. + * | | |In complementary mode, CMPDAT0, 2, 4 denote as first compared point, and CMPDAT1, 3, 5 denote as second compared point for the corresponding 3 complementary pairs EPWM_CH0 and EPWM_CH1, EPWM_CH2 and EPWM_CH3, EPWM_CH4 and EPWM_CH5. + * @var EPWM_T::DTCTL[3] + * Offset: 0x70 EPWM Dead-Time Control Register 0/1,2/3,4/5 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[11:0] |DTCNT |Dead-time Counter (Write Protect) + * | | |The dead-time can be calculated from the following formula: + * | | |Dead-time = (DTCNT[11:0]+1) * EPWM_CLK period. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[16] |DTEN |Enable Dead-time Insertion for EPWM Pair (EPWM_CH0, EPWM_CH1) (EPWM_CH2, EPWM_CH3) (EPWM_CH4, EPWM_CH5) (Write Protect) + * | | |Dead-time insertion is only active when this pair of complementary EPWM is enabled + * | | |If dead- time insertion is inactive, the outputs of pin pair are complementary without any delay. + * | | |0 = Dead-time insertion Disabled on the pin pair. + * | | |1 = Dead-time insertion Enabled on the pin pair. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[24] |DTCKSEL |Dead-time Clock Select (Write Protect) + * | | |0 = Dead-time clock source from EPWM_CLK. + * | | |1 = Dead-time clock source from prescaler output. + * | | |Note: This register is write protected. Refer toREGWRPROT register. + * @var EPWM_T::PHS[3] + * Offset: 0x80 EPWM Counter Phase Register 0/1,2/3,4/5 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |PHS |EPWM Synchronous Start Phase Bits + * | | |PHS determines the EPWM synchronous start phase value. These bits only use in synchronous function. + * @var EPWM_T::CNT[6] + * Offset: 0x90 EPWM Counter Register 0~5 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |CNT |EPWM Data Register (Read Only) + * | | |User can monitor CNTR to know the current value in 16-bit period counter. + * |[16] |DIRF |EPWM Direction Indicator Flag (Read Only) + * | | |0 = Counter is Down count. + * | | |1 = Counter is UP count. + * @var EPWM_T::WGCTL0 + * Offset: 0xB0 EPWM Generation Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |ZPCTL0 |EPWM Zero Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM zero point output Low. + * | | |10 = EPWM zero point output High. + * | | |11 = EPWM zero point output Toggle. + * | | |EPWM can control output level when EPWM counter count to zero. + * |[3:2] |ZPCTL1 |EPWM Zero Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM zero point output Low. + * | | |10 = EPWM zero point output High. + * | | |11 = EPWM zero point output Toggle. + * | | |EPWM can control output level when EPWM counter count to zero. + * |[5:4] |ZPCTL2 |EPWM Zero Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM zero point output Low. + * | | |10 = EPWM zero point output High. + * | | |11 = EPWM zero point output Toggle. + * | | |EPWM can control output level when EPWM counter count to zero. + * |[7:6] |ZPCTL3 |EPWM Zero Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM zero point output Low. + * | | |10 = EPWM zero point output High. + * | | |11 = EPWM zero point output Toggle. + * | | |EPWM can control output level when EPWM counter count to zero. + * |[9:8] |ZPCTL4 |EPWM Zero Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM zero point output Low. + * | | |10 = EPWM zero point output High. + * | | |11 = EPWM zero point output Toggle. + * | | |EPWM can control output level when EPWM counter count to zero. + * |[11:10] |ZPCTL5 |EPWM Zero Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM zero point output Low. + * | | |10 = EPWM zero point output High. + * | | |11 = EPWM zero point output Toggle. + * | | |EPWM can control output level when EPWM counter count to zero. + * |[17:16] |PRDPCTL0 |EPWM Period (Center) Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM period (center) point output Low. + * | | |10 = EPWM period (center) point output High. + * | | |11 = EPWM period (center) point output Toggle. + * | | |EPWM can control output level when EPWM counter count to (PERIODn+1). + * | | |Note: This bit is center point control when EPWM counter operating in up-down counter type. + * |[19:18] |PRDPCTL1 |EPWM Period (Center) Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM period (center) point output Low. + * | | |10 = EPWM period (center) point output High. + * | | |11 = EPWM period (center) point output Toggle. + * | | |EPWM can control output level when EPWM counter count to (PERIODn+1). + * | | |Note: This bit is center point control when EPWM counter operating in up-down counter type. + * |[21:20] |PRDPCTL2 |EPWM Period (Center) Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM period (center) point output Low. + * | | |10 = EPWM period (center) point output High. + * | | |11 = EPWM period (center) point output Toggle. + * | | |EPWM can control output level when EPWM counter count to (PERIODn+1). + * | | |Note: This bit is center point control when EPWM counter operating in up-down counter type. + * |[23:22] |PRDPCTL3 |EPWM Period (Center) Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM period (center) point output Low. + * | | |10 = EPWM period (center) point output High. + * | | |11 = EPWM period (center) point output Toggle. + * | | |EPWM can control output level when EPWM counter count to (PERIODn+1). + * | | |Note: This bit is center point control when EPWM counter operating in up-down counter type. + * |[25:24] |PRDPCTL4 |EPWM Period (Center) Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM period (center) point output Low. + * | | |10 = EPWM period (center) point output High. + * | | |11 = EPWM period (center) point output Toggle. + * | | |EPWM can control output level when EPWM counter count to (PERIODn+1). + * | | |Note: This bit is center point control when EPWM counter operating in up-down counter type. + * |[27:26] |PRDPCTL5 |EPWM Period (Center) Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM period (center) point output Low. + * | | |10 = EPWM period (center) point output High. + * | | |11 = EPWM period (center) point output Toggle. + * | | |EPWM can control output level when EPWM counter count to (PERIODn+1). + * | | |Note: This bit is center point control when EPWM counter operating in up-down counter type. + * @var EPWM_T::WGCTL1 + * Offset: 0xB4 EPWM Generation Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |CMPUCTL0 |EPWM Compare Up Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM compare up point output Low. + * | | |10 = EPWM compare up point output High. + * | | |11 = EPWM compare up point output Toggle. + * | | |EPWM can control output level when EPWM counter up count to CMPDAT. + * | | |Note: In complementary mode, CMPUCTL1, 3, 5 use as another CMPUCTL for channel 0, 2, 4. + * |[3:2] |CMPUCTL1 |EPWM Compare Up Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM compare up point output Low. + * | | |10 = EPWM compare up point output High. + * | | |11 = EPWM compare up point output Toggle. + * | | |EPWM can control output level when EPWM counter up count to CMPDAT. + * | | |Note: In complementary mode, CMPUCTL1, 3, 5 use as another CMPUCTL for channel 0, 2, 4. + * |[5:4] |CMPUCTL2 |EPWM Compare Up Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM compare up point output Low. + * | | |10 = EPWM compare up point output High. + * | | |11 = EPWM compare up point output Toggle. + * | | |EPWM can control output level when EPWM counter up count to CMPDAT. + * | | |Note: In complementary mode, CMPUCTL1, 3, 5 use as another CMPUCTL for channel 0, 2, 4. + * |[7:6] |CMPUCTL3 |EPWM Compare Up Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM compare up point output Low. + * | | |10 = EPWM compare up point output High. + * | | |11 = EPWM compare up point output Toggle. + * | | |EPWM can control output level when EPWM counter up count to CMPDAT. + * | | |Note: In complementary mode, CMPUCTL1, 3, 5 use as another CMPUCTL for channel 0, 2, 4. + * |[9:8] |CMPUCTL4 |EPWM Compare Up Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM compare up point output Low. + * | | |10 = EPWM compare up point output High. + * | | |11 = EPWM compare up point output Toggle. + * | | |EPWM can control output level when EPWM counter up count to CMPDAT. + * | | |Note: In complementary mode, CMPUCTL1, 3, 5 use as another CMPUCTL for channel 0, 2, 4. + * |[11:10] |CMPUCTL5 |EPWM Compare Up Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM compare up point output Low. + * | | |10 = EPWM compare up point output High. + * | | |11 = EPWM compare up point output Toggle. + * | | |EPWM can control output level when EPWM counter up count to CMPDAT. + * | | |Note: In complementary mode, CMPUCTL1, 3, 5 use as another CMPUCTL for channel 0, 2, 4. + * |[17:16] |CMPDCTL0 |EPWM Compare Down Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM compare down point output Low. + * | | |10 = EPWM compare down point output High. + * | | |11 = EPWM compare down point output Toggle. + * | | |EPWM can control output level when EPWM counter down count to CMPDAT. + * | | |Note: In complementary mode, CMPDCTL1, 3, 5 use as another CMPDCTL for channel 0, 2, 4. + * |[19:18] |CMPDCTL1 |EPWM Compare Down Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM compare down point output Low. + * | | |10 = EPWM compare down point output High. + * | | |11 = EPWM compare down point output Toggle. + * | | |EPWM can control output level when EPWM counter down count to CMPDAT. + * | | |Note: In complementary mode, CMPDCTL1, 3, 5 use as another CMPDCTL for channel 0, 2, 4. + * |[21:20] |CMPDCTL2 |EPWM Compare Down Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM compare down point output Low. + * | | |10 = EPWM compare down point output High. + * | | |11 = EPWM compare down point output Toggle. + * | | |EPWM can control output level when EPWM counter down count to CMPDAT. + * | | |Note: In complementary mode, CMPDCTL1, 3, 5 use as another CMPDCTL for channel 0, 2, 4. + * |[23:22] |CMPDCTL3 |EPWM Compare Down Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM compare down point output Low. + * | | |10 = EPWM compare down point output High. + * | | |11 = EPWM compare down point output Toggle. + * | | |EPWM can control output level when EPWM counter down count to CMPDAT. + * | | |Note: In complementary mode, CMPDCTL1, 3, 5 use as another CMPDCTL for channel 0, 2, 4. + * |[25:24] |CMPDCTL4 |EPWM Compare Down Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM compare down point output Low. + * | | |10 = EPWM compare down point output High. + * | | |11 = EPWM compare down point output Toggle. + * | | |EPWM can control output level when EPWM counter down count to CMPDAT. + * | | |Note: In complementary mode, CMPDCTL1, 3, 5 use as another CMPDCTL for channel 0, 2, 4. + * |[27:26] |CMPDCTL5 |EPWM Compare Down Point Control + * | | |00 = Do nothing. + * | | |01 = EPWM compare down point output Low. + * | | |10 = EPWM compare down point output High. + * | | |11 = EPWM compare down point output Toggle. + * | | |EPWM can control output level when EPWM counter down count to CMPDAT. + * | | |Note: In complementary mode, CMPDCTL1, 3, 5 use as another CMPDCTL for channel 0, 2, 4. + * @var EPWM_T::MSKEN + * Offset: 0xB8 EPWM Mask Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |MSKEN0 |EPWM Mask Enable Bits + * | | |The EPWM output signal will be masked when this bit is enabled + * | | |The corresponding EPWM channel n will output MSKDATn (EPWM_MSK[5:0]) data. + * | | |0 = EPWM output signal is non-masked. + * | | |1 = EPWM output signal is masked and output MSKDATn data. + * |[1] |MSKEN1 |EPWM Mask Enable Bits + * | | |The EPWM output signal will be masked when this bit is enabled + * | | |The corresponding EPWM channel n will output MSKDATn (EPWM_MSK[5:0]) data. + * | | |0 = EPWM output signal is non-masked. + * | | |1 = EPWM output signal is masked and output MSKDATn data. + * |[2] |MSKEN2 |EPWM Mask Enable Bits + * | | |The EPWM output signal will be masked when this bit is enabled + * | | |The corresponding EPWM channel n will output MSKDATn (EPWM_MSK[5:0]) data. + * | | |0 = EPWM output signal is non-masked. + * | | |1 = EPWM output signal is masked and output MSKDATn data. + * |[3] |MSKEN3 |EPWM Mask Enable Bits + * | | |The EPWM output signal will be masked when this bit is enabled + * | | |The corresponding EPWM channel n will output MSKDATn (EPWM_MSK[5:0]) data. + * | | |0 = EPWM output signal is non-masked. + * | | |1 = EPWM output signal is masked and output MSKDATn data. + * |[4] |MSKEN4 |EPWM Mask Enable Bits + * | | |The EPWM output signal will be masked when this bit is enabled + * | | |The corresponding EPWM channel n will output MSKDATn (EPWM_MSK[5:0]) data. + * | | |0 = EPWM output signal is non-masked. + * | | |1 = EPWM output signal is masked and output MSKDATn data. + * |[5] |MSKEN5 |EPWM Mask Enable Bits + * | | |The EPWM output signal will be masked when this bit is enabled + * | | |The corresponding EPWM channel n will output MSKDATn (EPWM_MSK[5:0]) data. + * | | |0 = EPWM output signal is non-masked. + * | | |1 = EPWM output signal is masked and output MSKDATn data. + * @var EPWM_T::MSK + * Offset: 0xBC EPWM Mask Data Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |MSKDAT0 |EPWM Mask Data Bit + * | | |This data bit control the state of EPWMn output pin, if corresponding mask function is enabled. + * | | |0 = Output logic low to EPWM channel n. + * | | |1 = Output logic high to EPWM channel n. + * |[1] |MSKDAT1 |EPWM Mask Data Bit + * | | |This data bit control the state of EPWMn output pin, if corresponding mask function is enabled. + * | | |0 = Output logic low to EPWM channel n. + * | | |1 = Output logic high to EPWM channel n. + * |[2] |MSKDAT2 |EPWM Mask Data Bit + * | | |This data bit control the state of EPWMn output pin, if corresponding mask function is enabled. + * | | |0 = Output logic low to EPWM channel n. + * | | |1 = Output logic high to EPWM channel n. + * |[3] |MSKDAT3 |EPWM Mask Data Bit + * | | |This data bit control the state of EPWMn output pin, if corresponding mask function is enabled. + * | | |0 = Output logic low to EPWM channel n. + * | | |1 = Output logic high to EPWM channel n. + * |[4] |MSKDAT4 |EPWM Mask Data Bit + * | | |This data bit control the state of EPWMn output pin, if corresponding mask function is enabled. + * | | |0 = Output logic low to EPWM channel n. + * | | |1 = Output logic high to EPWM channel n. + * |[5] |MSKDAT5 |EPWM Mask Data Bit + * | | |This data bit control the state of EPWMn output pin, if corresponding mask function is enabled. + * | | |0 = Output logic low to EPWM channel n. + * | | |1 = Output logic high to EPWM channel n. + * @var EPWM_T::BNF + * Offset: 0xC0 EPWM Brake Noise Filter Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BRK0NFEN |EPWM Brake 0 Noise Filter Enable Bit + * | | |0 = Noise filter of EPWM Brake 0 Disabled. + * | | |1 = Noise filter of EPWM Brake 0 Enabled. + * |[3:1] |BRK0NFSEL |Brake 0 Edge Detector Filter Clock Selection + * | | |000 = Filter clock = HCLK. + * | | |001 = Filter clock = HCLK/2. + * | | |010 = Filter clock = HCLK/4. + * | | |011 = Filter clock = HCLK/8. + * | | |100 = Filter clock = HCLK/16. + * | | |101 = Filter clock = HCLK/32. + * | | |110 = Filter clock = HCLK/64. + * | | |111 = Filter clock = HCLK/128. + * |[6:4] |BRK0FCNT |Brake 0 Edge Detector Filter Count + * | | |The register bits control the Brake0 filter counter to count from 0 to BRK1FCNT. + * |[7] |BRK0PINV |Brake 0 Pin Inverse + * | | |0 = The state of pin EPWMx_BRAKE0 is passed to the negative edge detector. + * | | |1 = The inversed state of pin EPWMx_BRAKE10 is passed to the negative edge detector. + * |[8] |BRK1NFEN |EPWM Brake 1 Noise Filter Enable Bit + * | | |0 = Noise filter of EPWM Brake 1 Disabled. + * | | |1 = Noise filter of EPWM Brake 1 Enabled. + * |[11:9] |BRK1NFSEL |Brake 1 Edge Detector Filter Clock Selection + * | | |000 = Filter clock = HCLK. + * | | |001 = Filter clock = HCLK/2. + * | | |010 = Filter clock = HCLK/4. + * | | |011 = Filter clock = HCLK/8. + * | | |100 = Filter clock = HCLK/16. + * | | |101 = Filter clock = HCLK/32. + * | | |110 = Filter clock = HCLK/64. + * | | |111 = Filter clock = HCLK/128. + * |[14:12] |BRK1FCNT |Brake 1 Edge Detector Filter Count + * | | |The register bits control the Brake1 filter counter to count from 0 to BRK1FCNT. + * |[15] |BRK1PINV |Brake 1 Pin Inverse + * | | |0 = The state of pin EPWMx_BRAKE1 is passed to the negative edge detector. + * | | |1 = The inversed state of pin EPWMx_BRAKE1 is passed to the negative edge detector. + * |[16] |BK0SRC |Brake 0 Pin Source Select + * | | |For EPWM0 setting: + * | | |0 = Brake 0 pin source come from EPWM0_BRAKE0. + * | | |1 = Brake 0 pin source come from EPWM1_BRAKE0. + * | | |For EPWM1 setting: + * | | |0 = Brake 0 pin source come from EPWM1_BRAKE0. + * | | |1 = Brake 0 pin source come from EPWM0_BRAKE0. + * |[24] |BK1SRC |Brake 1 Pin Source Select + * | | |For EPWM0 setting: + * | | |0 = Brake 1 pin source come from EPWM0_BRAKE1. + * | | |1 = Brake 1 pin source come from EPWM1_BRAKE1. + * | | |For EPWM1 setting: + * | | |0 = Brake 1 pin source come from EPWM1_BRAKE1. + * | | |1 = Brake 1 pin source come from EPWM0_BRAKE1. + * @var EPWM_T::FAILBRK + * Offset: 0xC4 EPWM System Fail Brake Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CSSBRKEN |Clock Security System Detection Trigger EPWM Brake Function 0 Enable Bit + * | | |0 = Brake Function triggered by CSS detection Disabled. + * | | |1 = Brake Function triggered by CSS detection Enabled. + * |[1] |BODBRKEN |Brown-out Detection Trigger EPWM Brake Function 0 Enable Bit + * | | |0 = Brake Function triggered by BOD Disabled. + * | | |1 = Brake Function triggered by BOD Enabled. + * |[2] |RAMBRKEN |SRAM Parity Error Detection Trigger EPWM Brake Function 0 Enable Bit + * | | |0 = Brake Function triggered by SRAM parity error detection Disabled. + * | | |1 = Brake Function triggered by SRAM parity error detection Enabled. + * |[3] |CORBRKEN |Core Lockup Detection Trigger EPWM Brake Function 0 Enable Bit + * | | |0 = Brake Function triggered by Core lockup detection Disabled. + * | | |1 = Brake Function triggered by Core lockup detection Enabled. + * @var EPWM_T::BRKCTL[3] + * Offset: 0xC8 EPWM Brake Edge Detect Control Register 0/1,2/3,4/5 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CPO0EBEN |Enable ACMP0_O Digital Output As Edge-detect Brake Source (Write Protect) + * | | |0 = ACMP0_O as edge-detect brake source Disabled. + * | | |1 = ACMP0_O as edge-detect brake source Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[1] |CPO1EBEN |Enable ACMP1_O Digital Output As Edge-detect Brake Source (Write Protect) + * | | |0 = ACMP1_O as edge-detect brake source Disabled. + * | | |1 = ACMP1_O as edge-detect brake source Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[4] |BRKP0EEN |Enable EPWMx_BRAKE0 Pin As Edge-detect Brake Source (Write Protect) + * | | |0 = EPWMx_BRAKE0 pin as edge-detect brake source Disabled. + * | | |1 = EPWMx_BRAKE0 pin as edge-detect brake source Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[5] |BRKP1EEN |Enable EPWMx_BRAKE1 Pin As Edge-detect Brake Source (Write Protect) + * | | |0 = EPWMx_BRAKE1 pin as edge-detect brake source Disabled. + * | | |1 = EPWMx_BRAKE1 pin as edge-detect brake source Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[7] |SYSEBEN |Enable System Fail As Edge-detect Brake Source (Write Protect) + * | | |0 = System Fail condition as edge-detect brake source Disabled. + * | | |1 = System Fail condition as edge-detect brake source Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[8] |CPO0LBEN |Enable ACMP0_O Digital Output As Level-detect Brake Source (Write Protect) + * | | |0 = ACMP0_O as level-detect brake source Disabled. + * | | |1 = ACMP0_O as level-detect brake source Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[9] |CPO1LBEN |Enable ACMP1_O Digital Output As Level-detect Brake Source (Write Protect) + * | | |0 = ACMP1_O as level-detect brake source Disabled. + * | | |1 = ACMP1_O as level-detect brake source Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[12] |BRKP0LEN |Enable BKP0 Pin As Level-detect Brake Source (Write Protect) + * | | |0 = EPWMx_BRAKE0 pin as level-detect brake source Disabled. + * | | |1 = EPWMx_BRAKE0 pin as level-detect brake source Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[13] |BRKP1LEN |Enable BKP1 Pin As Level-detect Brake Source (Write Protect) + * | | |0 = EPWMx_BRAKE1 pin as level-detect brake source Disabled. + * | | |1 = EPWMx_BRAKE1 pin as level-detect brake source Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[15] |SYSLBEN |Enable System Fail As Level-detect Brake Source (Write Protect) + * | | |0 = System Fail condition as level-detect brake source Disabled. + * | | |1 = System Fail condition as level-detect brake source Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[17:16] |BRKAEVEN |EPWM Brake Action Select for Even Channel (Write Protect) + * | | |00 = EPWMx brake event will not affect even channels output. + * | | |01 = EPWM even channel output tri-state when EPWMx brake event happened. + * | | |10 = EPWM even channel output low level when EPWMx brake event happened. + * | | |11 = EPWM even channel output high level when EPWMx brake event happened. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[19:18] |BRKAODD |EPWM Brake Action Select for Odd Channel (Write Protect) + * | | |00 = EPWMx brake event will not affect odd channels output. + * | | |01 = EPWM odd channel output tri-state when EPWMx brake event happened. + * | | |10 = EPWM odd channel output low level when EPWMx brake event happened. + * | | |11 = EPWM odd channel output high level when EPWMx brake event happened. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[20] |EADCEBEN |Enable EADC Result Monitor (EADCRM) As Edge-detect Brake Source (Write Protect) + * | | |0 = EADCRM as edge-detect brake source Disabled. + * | | |1 = EADCRM as edge-detect brake source Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[28] |EADCLBEN |Enable EADC Result Monitor (EADCRM) As Level-detect Brake Source (Write Protect) + * | | |0 = EADCRM as level-detect brake source Disabled. + * | | |1 = EADCRM as level-detect brake source Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * @var EPWM_T::POLCTL + * Offset: 0xD4 EPWM Pin Polar Inverse Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |PINV0 |EPWM PIN Polar Inverse Control + * | | |The register controls polarity state of EPWM output. + * | | |0 = EPWM output polar inverse Disabled. + * | | |1 = EPWM output polar inverse Enabled. + * |[1] |PINV1 |EPWM PIN Polar Inverse Control + * | | |The register controls polarity state of EPWM output. + * | | |0 = EPWM output polar inverse Disabled. + * | | |1 = EPWM output polar inverse Enabled. + * |[2] |PINV2 |EPWM PIN Polar Inverse Control + * | | |The register controls polarity state of EPWM output. + * | | |0 = EPWM output polar inverse Disabled. + * | | |1 = EPWM output polar inverse Enabled. + * |[3] |PINV3 |EPWM PIN Polar Inverse Control + * | | |The register controls polarity state of EPWM output. + * | | |0 = EPWM output polar inverse Disabled. + * | | |1 = EPWM output polar inverse Enabled. + * |[4] |PINV4 |EPWM PIN Polar Inverse Control + * | | |The register controls polarity state of EPWM output. + * | | |0 = EPWM output polar inverse Disabled. + * | | |1 = EPWM output polar inverse Enabled. + * |[5] |PINV5 |EPWM PIN Polar Inverse Control + * | | |The register controls polarity state of EPWM output. + * | | |0 = EPWM output polar inverse Disabled. + * | | |1 = EPWM output polar inverse Enabled. + * @var EPWM_T::POEN + * Offset: 0xD8 EPWM Output Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |POEN0 |EPWM Pin Output Enable Bits + * | | |0 = EPWM pin at tri-state. + * | | |1 = EPWM pin in output mode. + * |[1] |POEN1 |EPWM Pin Output Enable Bits + * | | |0 = EPWM pin at tri-state. + * | | |1 = EPWM pin in output mode. + * |[2] |POEN2 |EPWM Pin Output Enable Bits + * | | |0 = EPWM pin at tri-state. + * | | |1 = EPWM pin in output mode. + * |[3] |POEN3 |EPWM Pin Output Enable Bits + * | | |0 = EPWM pin at tri-state. + * | | |1 = EPWM pin in output mode. + * |[4] |POEN4 |EPWM Pin Output Enable Bits + * | | |0 = EPWM pin at tri-state. + * | | |1 = EPWM pin in output mode. + * |[5] |POEN5 |EPWM Pin Output Enable Bits + * | | |0 = EPWM pin at tri-state. + * | | |1 = EPWM pin in output mode. + * @var EPWM_T::SWBRK + * Offset: 0xDC EPWM Software Brake Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BRKETRG0 |EPWM Edge Brake Software Trigger (Write Only) (Write Protect) + * | | |Write 1 to this bit will trigger edge brake, and set BRKEIFn to 1 in EPWM_INTSTS1 register. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[1] |BRKETRG2 |EPWM Edge Brake Software Trigger (Write Only) (Write Protect) + * | | |Write 1 to this bit will trigger edge brake, and set BRKEIFn to 1 in EPWM_INTSTS1 register. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[2] |BRKETRG4 |EPWM Edge Brake Software Trigger (Write Only) (Write Protect) + * | | |Write 1 to this bit will trigger edge brake, and set BRKEIFn to 1 in EPWM_INTSTS1 register. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[8] |BRKLTRG0 |EPWM Level Brake Software Trigger (Write Only) (Write Protect) + * | | |Write 1 to this bit will trigger level brake, and set BRKLIFn to 1 in EPWM_INTSTS1 register. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[9] |BRKLTRG2 |EPWM Level Brake Software Trigger (Write Only) (Write Protect) + * | | |Write 1 to this bit will trigger level brake, and set BRKLIFn to 1 in EPWM_INTSTS1 register. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[10] |BRKLTRG4 |EPWM Level Brake Software Trigger (Write Only) (Write Protect) + * | | |Write 1 to this bit will trigger level brake, and set BRKLIFn to 1 in EPWM_INTSTS1 register. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * @var EPWM_T::INTEN0 + * Offset: 0xE0 EPWM Interrupt Enable Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ZIEN0 |EPWM Zero Point Interrupt Enable Bits + * | | |0 = Zero point interrupt Disabled. + * | | |1 = Zero point interrupt Enabled. + * | | |Note: Odd channels will read always 0 at complementary mode. + * |[1] |ZIEN1 |EPWM Zero Point Interrupt Enable Bits + * | | |0 = Zero point interrupt Disabled. + * | | |1 = Zero point interrupt Enabled. + * | | |Note: Odd channels will read always 0 at complementary mode. + * |[2] |ZIEN2 |EPWM Zero Point Interrupt Enable Bits + * | | |0 = Zero point interrupt Disabled. + * | | |1 = Zero point interrupt Enabled. + * | | |Note: Odd channels will read always 0 at complementary mode. + * |[3] |ZIEN3 |EPWM Zero Point Interrupt Enable Bits + * | | |0 = Zero point interrupt Disabled. + * | | |1 = Zero point interrupt Enabled. + * | | |Note: Odd channels will read always 0 at complementary mode. + * |[4] |ZIEN4 |EPWM Zero Point Interrupt Enable Bits + * | | |0 = Zero point interrupt Disabled. + * | | |1 = Zero point interrupt Enabled. + * | | |Note: Odd channels will read always 0 at complementary mode. + * |[5] |ZIEN5 |EPWM Zero Point Interrupt Enable Bits + * | | |0 = Zero point interrupt Disabled. + * | | |1 = Zero point interrupt Enabled. + * | | |Note: Odd channels will read always 0 at complementary mode. + * |[8] |PIEN0 |EPWM Period Point Interrupt Enable Bits + * | | |0 = Period point interrupt Disabled. + * | | |1 = Period point interrupt Enabled. + * | | |Note1: When up-down counter type period point means center point. + * | | |Note2: Odd channels will read always 0 at complementary mode. + * |[9] |PIEN1 |EPWM Period Point Interrupt Enable Bits + * | | |0 = Period point interrupt Disabled. + * | | |1 = Period point interrupt Enabled. + * | | |Note1: When up-down counter type period point means center point. + * | | |Note2: Odd channels will read always 0 at complementary mode. + * |[10] |PIEN2 |EPWM Period Point Interrupt Enable Bits + * | | |0 = Period point interrupt Disabled. + * | | |1 = Period point interrupt Enabled. + * | | |Note1: When up-down counter type period point means center point. + * | | |Note2: Odd channels will read always 0 at complementary mode. + * |[11] |PIEN3 |EPWM Period Point Interrupt Enable Bits + * | | |0 = Period point interrupt Disabled. + * | | |1 = Period point interrupt Enabled. + * | | |Note1: When up-down counter type period point means center point. + * | | |Note2: Odd channels will read always 0 at complementary mode. + * |[12] |PIEN4 |EPWM Period Point Interrupt Enable Bits + * | | |0 = Period point interrupt Disabled. + * | | |1 = Period point interrupt Enabled. + * | | |Note1: When up-down counter type period point means center point. + * | | |Note2: Odd channels will read always 0 at complementary mode. + * |[13] |PIEN5 |EPWM Period Point Interrupt Enable Bits + * | | |0 = Period point interrupt Disabled. + * | | |1 = Period point interrupt Enabled. + * | | |Note1: When up-down counter type period point means center point. + * | | |Note2: Odd channels will read always 0 at complementary mode. + * |[16] |CMPUIEN0 |EPWM Compare Up Count Interrupt Enable Bits + * | | |0 = Compare up count interrupt Disabled. + * | | |1 = Compare up count interrupt Enabled. + * | | |Note: In complementary mode, CMPUIEN1, 3, 5 use as another CMPUIEN for channel 0, 2, 4. + * |[17] |CMPUIEN1 |EPWM Compare Up Count Interrupt Enable Bits + * | | |0 = Compare up count interrupt Disabled. + * | | |1 = Compare up count interrupt Enabled. + * | | |Note: In complementary mode, CMPUIEN1, 3, 5 use as another CMPUIEN for channel 0, 2, 4. + * |[18] |CMPUIEN2 |EPWM Compare Up Count Interrupt Enable Bits + * | | |0 = Compare up count interrupt Disabled. + * | | |1 = Compare up count interrupt Enabled. + * | | |Note: In complementary mode, CMPUIEN1, 3, 5 use as another CMPUIEN for channel 0, 2, 4. + * |[19] |CMPUIEN3 |EPWM Compare Up Count Interrupt Enable Bits + * | | |0 = Compare up count interrupt Disabled. + * | | |1 = Compare up count interrupt Enabled. + * | | |Note: In complementary mode, CMPUIEN1, 3, 5 use as another CMPUIEN for channel 0, 2, 4. + * |[20] |CMPUIEN4 |EPWM Compare Up Count Interrupt Enable Bits + * | | |0 = Compare up count interrupt Disabled. + * | | |1 = Compare up count interrupt Enabled. + * | | |Note: In complementary mode, CMPUIEN1, 3, 5 use as another CMPUIEN for channel 0, 2, 4. + * |[21] |CMPUIEN5 |EPWM Compare Up Count Interrupt Enable Bits + * | | |0 = Compare up count interrupt Disabled. + * | | |1 = Compare up count interrupt Enabled. + * | | |Note: In complementary mode, CMPUIEN1, 3, 5 use as another CMPUIEN for channel 0, 2, 4. + * |[24] |CMPDIEN0 |EPWM Compare Down Count Interrupt Enable Bits + * | | |0 = Compare down count interrupt Disabled. + * | | |1 = Compare down count interrupt Enabled. + * | | |Note: In complementary mode, CMPDIEN1, 3, 5 use as another CMPDIEN for channel 0, 2, 4. + * |[25] |CMPDIEN1 |EPWM Compare Down Count Interrupt Enable Bits + * | | |0 = Compare down count interrupt Disabled. + * | | |1 = Compare down count interrupt Enabled. + * | | |Note: In complementary mode, CMPDIEN1, 3, 5 use as another CMPDIEN for channel 0, 2, 4. + * |[26] |CMPDIEN2 |EPWM Compare Down Count Interrupt Enable Bits + * | | |0 = Compare down count interrupt Disabled. + * | | |1 = Compare down count interrupt Enabled. + * | | |Note: In complementary mode, CMPDIEN1, 3, 5 use as another CMPDIEN for channel 0, 2, 4. + * |[27] |CMPDIEN3 |EPWM Compare Down Count Interrupt Enable Bits + * | | |0 = Compare down count interrupt Disabled. + * | | |1 = Compare down count interrupt Enabled. + * | | |Note: In complementary mode, CMPDIEN1, 3, 5 use as another CMPDIEN for channel 0, 2, 4. + * |[28] |CMPDIEN4 |EPWM Compare Down Count Interrupt Enable Bits + * | | |0 = Compare down count interrupt Disabled. + * | | |1 = Compare down count interrupt Enabled. + * | | |Note: In complementary mode, CMPDIEN1, 3, 5 use as another CMPDIEN for channel 0, 2, 4. + * |[29] |CMPDIEN5 |EPWM Compare Down Count Interrupt Enable Bits + * | | |0 = Compare down count interrupt Disabled. + * | | |1 = Compare down count interrupt Enabled. + * | | |Note: In complementary mode, CMPDIEN1, 3, 5 use as another CMPDIEN for channel 0, 2, 4. + * @var EPWM_T::INTEN1 + * Offset: 0xE4 EPWM Interrupt Enable Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BRKEIEN0_1|EPWM Edge-detect Brake Interrupt Enable for Channel0/1 (Write Protect) + * | | |0 = Edge-detect Brake interrupt for channel0/1 Disabled. + * | | |1 = Edge-detect Brake interrupt for channel0/1 Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[1] |BRKEIEN2_3|EPWM Edge-detect Brake Interrupt Enable for Channel2/3 (Write Protect) + * | | |0 = Edge-detect Brake interrupt for channel2/3 Disabled. + * | | |1 = Edge-detect Brake interrupt for channel2/3 Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[2] |BRKEIEN4_5|EPWM Edge-detect Brake Interrupt Enable for Channel4/5 (Write Protect) + * | | |0 = Edge-detect Brake interrupt for channel4/5 Disabled. + * | | |1 = Edge-detect Brake interrupt for channel4/5 Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[8] |BRKLIEN0_1|EPWM Level-detect Brake Interrupt Enable for Channel0/1 (Write Protect) + * | | |0 = Level-detect Brake interrupt for channel0/1 Disabled. + * | | |1 = Level-detect Brake interrupt for channel0/1 Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[9] |BRKLIEN2_3|EPWM Level-detect Brake Interrupt Enable for Channel2/3 (Write Protect) + * | | |0 = Level-detect Brake interrupt for channel2/3 Disabled. + * | | |1 = Level-detect Brake interrupt for channel2/3 Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[10] |BRKLIEN4_5|EPWM Level-detect Brake Interrupt Enable for Channel4/5 (Write Protect) + * | | |0 = Level-detect Brake interrupt for channel4/5 Disabled. + * | | |1 = Level-detect Brake interrupt for channel4/5 Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * @var EPWM_T::INTSTS0 + * Offset: 0xE8 EPWM Interrupt Flag Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ZIF0 |EPWM Zero Point Interrupt Flag + * | | |This bit is set by hardware when EPWM counter reaches zero, software can write 1 to clear this bit to zero. + * |[1] |ZIF1 |EPWM Zero Point Interrupt Flag + * | | |This bit is set by hardware when EPWM counter reaches zero, software can write 1 to clear this bit to zero. + * |[2] |ZIF2 |EPWM Zero Point Interrupt Flag + * | | |This bit is set by hardware when EPWM counter reaches zero, software can write 1 to clear this bit to zero. + * |[3] |ZIF3 |EPWM Zero Point Interrupt Flag + * | | |This bit is set by hardware when EPWM counter reaches zero, software can write 1 to clear this bit to zero. + * |[4] |ZIF4 |EPWM Zero Point Interrupt Flag + * | | |This bit is set by hardware when EPWM counter reaches zero, software can write 1 to clear this bit to zero. + * |[5] |ZIF5 |EPWM Zero Point Interrupt Flag + * | | |This bit is set by hardware when EPWM counter reaches zero, software can write 1 to clear this bit to zero. + * |[8] |PIF0 |EPWM Period Point Interrupt Flag + * | | |This bit is set by hardware when EPWM counter reaches EPWM_PERIODn, software can write 1 to clear this bit to zero. + * |[9] |PIF1 |EPWM Period Point Interrupt Flag + * | | |This bit is set by hardware when EPWM counter reaches EPWM_PERIODn, software can write 1 to clear this bit to zero. + * |[10] |PIF2 |EPWM Period Point Interrupt Flag + * | | |This bit is set by hardware when EPWM counter reaches EPWM_PERIODn, software can write 1 to clear this bit to zero. + * |[11] |PIF3 |EPWM Period Point Interrupt Flag + * | | |This bit is set by hardware when EPWM counter reaches EPWM_PERIODn, software can write 1 to clear this bit to zero. + * |[12] |PIF4 |EPWM Period Point Interrupt Flag + * | | |This bit is set by hardware when EPWM counter reaches EPWM_PERIODn, software can write 1 to clear this bit to zero. + * |[13] |PIF5 |EPWM Period Point Interrupt Flag + * | | |This bit is set by hardware when EPWM counter reaches EPWM_PERIODn, software can write 1 to clear this bit to zero. + * |[16] |CMPUIF0 |EPWM Compare Up Count Interrupt Flag + * | | |Flag is set by hardware when EPWM counter up count and reaches EPWM_CMPDATn, software can clear this bit by writing 1 to it. + * | | |Note1: If CMPDAT equal to PERIOD, this flag is not working in up counter type selection. + * | | |Note2: In complementary mode, CMPUIF1, 3, 5 use as another CMPUIF for channel 0, 2, 4. + * |[17] |CMPUIF1 |EPWM Compare Up Count Interrupt Flag + * | | |Flag is set by hardware when EPWM counter up count and reaches EPWM_CMPDATn, software can clear this bit by writing 1 to it. + * | | |Note1: If CMPDAT equal to PERIOD, this flag is not working in up counter type selection. + * | | |Note2: In complementary mode, CMPUIF1, 3, 5 use as another CMPUIF for channel 0, 2, 4. + * |[18] |CMPUIF2 |EPWM Compare Up Count Interrupt Flag + * | | |Flag is set by hardware when EPWM counter up count and reaches EPWM_CMPDATn, software can clear this bit by writing 1 to it. + * | | |Note1: If CMPDAT equal to PERIOD, this flag is not working in up counter type selection. + * | | |Note2: In complementary mode, CMPUIF1, 3, 5 use as another CMPUIF for channel 0, 2, 4. + * |[19] |CMPUIF3 |EPWM Compare Up Count Interrupt Flag + * | | |Flag is set by hardware when EPWM counter up count and reaches EPWM_CMPDATn, software can clear this bit by writing 1 to it. + * | | |Note1: If CMPDAT equal to PERIOD, this flag is not working in up counter type selection. + * | | |Note2: In complementary mode, CMPUIF1, 3, 5 use as another CMPUIF for channel 0, 2, 4. + * |[20] |CMPUIF4 |EPWM Compare Up Count Interrupt Flag + * | | |Flag is set by hardware when EPWM counter up count and reaches EPWM_CMPDATn, software can clear this bit by writing 1 to it. + * | | |Note1: If CMPDAT equal to PERIOD, this flag is not working in up counter type selection. + * | | |Note2: In complementary mode, CMPUIF1, 3, 5 use as another CMPUIF for channel 0, 2, 4. + * |[21] |CMPUIF5 |EPWM Compare Up Count Interrupt Flag + * | | |Flag is set by hardware when EPWM counter up count and reaches EPWM_CMPDATn, software can clear this bit by writing 1 to it. + * | | |Note1: If CMPDAT equal to PERIOD, this flag is not working in up counter type selection. + * | | |Note2: In complementary mode, CMPUIF1, 3, 5 use as another CMPUIF for channel 0, 2, 4. + * |[24] |CMPDIF0 |EPWM Compare Down Count Interrupt Flag + * | | |Flag is set by hardware when EPWM counter down count and reaches EPWM_CMPDATn, software can clear this bit by writing 1 to it. + * | | |Note1: If CMPDAT equal to PERIOD, this flag is not working in down counter type selection. + * | | |Note2: In complementary mode, CMPDIF1, 3, 5 use as another CMPDIF for channel 0, 2, 4. + * |[25] |CMPDIF1 |EPWM Compare Down Count Interrupt Flag + * | | |Flag is set by hardware when EPWM counter down count and reaches EPWM_CMPDATn, software can clear this bit by writing 1 to it. + * | | |Note1: If CMPDAT equal to PERIOD, this flag is not working in down counter type selection. + * | | |Note2: In complementary mode, CMPDIF1, 3, 5 use as another CMPDIF for channel 0, 2, 4. + * |[26] |CMPDIF2 |EPWM Compare Down Count Interrupt Flag + * | | |Flag is set by hardware when EPWM counter down count and reaches EPWM_CMPDATn, software can clear this bit by writing 1 to it. + * | | |Note1: If CMPDAT equal to PERIOD, this flag is not working in down counter type selection. + * | | |Note2: In complementary mode, CMPDIF1, 3, 5 use as another CMPDIF for channel 0, 2, 4. + * |[27] |CMPDIF3 |EPWM Compare Down Count Interrupt Flag + * | | |Flag is set by hardware when EPWM counter down count and reaches EPWM_CMPDATn, software can clear this bit by writing 1 to it. + * | | |Note1: If CMPDAT equal to PERIOD, this flag is not working in down counter type selection. + * | | |Note2: In complementary mode, CMPDIF1, 3, 5 use as another CMPDIF for channel 0, 2, 4. + * |[28] |CMPDIF4 |EPWM Compare Down Count Interrupt Flag + * | | |Flag is set by hardware when EPWM counter down count and reaches EPWM_CMPDATn, software can clear this bit by writing 1 to it. + * | | |Note1: If CMPDAT equal to PERIOD, this flag is not working in down counter type selection. + * | | |Note2: In complementary mode, CMPDIF1, 3, 5 use as another CMPDIF for channel 0, 2, 4. + * |[29] |CMPDIF5 |EPWM Compare Down Count Interrupt Flag + * | | |Flag is set by hardware when EPWM counter down count and reaches EPWM_CMPDATn, software can clear this bit by writing 1 to it. + * | | |Note1: If CMPDAT equal to PERIOD, this flag is not working in down counter type selection. + * | | |Note2: In complementary mode, CMPDIF1, 3, 5 use as another CMPDIF for channel 0, 2, 4. + * @var EPWM_T::INTSTS1 + * Offset: 0xEC EPWM Interrupt Flag Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BRKEIF0 |EPWM Channel0 Edge-detect Brake Interrupt Flag (Write Protect) + * | | |0 = EPWM channel0 edge-detect brake event do not happened. + * | | |1 = When EPWM channel0 edge-detect brake event happened, this bit is set to 1, writing 1 to clear. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[1] |BRKEIF1 |EPWM Channel1 Edge-detect Brake Interrupt Flag (Write Protect) + * | | |0 = EPWM channel1 edge-detect brake event do not happened. + * | | |1 = When EPWM channel1 edge-detect brake event happened, this bit is set to 1, writing 1 to clear. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[2] |BRKEIF2 |EPWM Channel2 Edge-detect Brake Interrupt Flag (Write Protect) + * | | |0 = EPWM channel2 edge-detect brake event do not happened. + * | | |1 = When EPWM channel2 edge-detect brake event happened, this bit is set to 1, writing 1 to clear. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[3] |BRKEIF3 |EPWM Channel3 Edge-detect Brake Interrupt Flag (Write Protect) + * | | |0 = EPWM channel3 edge-detect brake event do not happened. + * | | |1 = When EPWM channel3 edge-detect brake event happened, this bit is set to 1, writing 1 to clear. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[4] |BRKEIF4 |EPWM Channel4 Edge-detect Brake Interrupt Flag (Write Protect) + * | | |0 = EPWM channel4 edge-detect brake event do not happened. + * | | |1 = When EPWM channel4 edge-detect brake event happened, this bit is set to 1, writing 1 to clear. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[5] |BRKEIF5 |EPWM Channel5 Edge-detect Brake Interrupt Flag (Write Protect) + * | | |0 = EPWM channel5 edge-detect brake event do not happened. + * | | |1 = When EPWM channel5 edge-detect brake event happened, this bit is set to 1, writing 1 to clear. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[8] |BRKLIF0 |EPWM Channel0 Level-detect Brake Interrupt Flag (Write Protect) + * | | |0 = EPWM channel0 level-detect brake event do not happened. + * | | |1 = When EPWM channel0 level-detect brake event happened, this bit is set to 1, writing 1 to clear. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[9] |BRKLIF1 |EPWM Channel1 Level-detect Brake Interrupt Flag (Write Protect) + * | | |0 = EPWM channel1 level-detect brake event do not happened. + * | | |1 = When EPWM channel1 level-detect brake event happened, this bit is set to 1, writing 1 to clear. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[10] |BRKLIF2 |EPWM Channel2 Level-detect Brake Interrupt Flag (Write Protect) + * | | |0 = EPWM channel2 level-detect brake event do not happened. + * | | |1 = When EPWM channel2 level-detect brake event happened, this bit is set to 1, writing 1 to clear. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[11] |BRKLIF3 |EPWM Channel3 Level-detect Brake Interrupt Flag (Write Protect) + * | | |0 = EPWM channel3 level-detect brake event do not happened. + * | | |1 = When EPWM channel3 level-detect brake event happened, this bit is set to 1, writing 1 to clear. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[12] |BRKLIF4 |EPWM Channel4 Level-detect Brake Interrupt Flag (Write Protect) + * | | |0 = EPWM channel4 level-detect brake event do not happened. + * | | |1 = When EPWM channel4 level-detect brake event happened, this bit is set to 1, writing 1 to clear. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[13] |BRKLIF5 |EPWM Channel5 Level-detect Brake Interrupt Flag (Write Protect) + * | | |0 = EPWM channel5 level-detect brake event do not happened. + * | | |1 = When EEPWM channel5 level-detect brake event happened, this bit is set to 1, writing 1 to clear. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[16] |BRKESTS0 |EPWM Channel0 Edge-detect Brake Status (Read Only) + * | | |0 = EPWM channel0 edge-detect brake state is released. + * | | |1 = When EPWM channel0 edge-detect brake detects a falling edge of any enabled brake source; this flag will be set to indicate the EPWM channel0 at brake state, writing 1 to clear. + * |[17] |BRKESTS1 |EPWM Channel1 Edge-detect Brake Status (Read Only) + * | | |0 = EPWM channel1 edge-detect brake state is released. + * | | |1 = When EPWM channel1 edge-detect brake detects a falling edge of any enabled brake source; this flag will be set to indicate the EPWM channel1 at brake state, writing 1 to clear. + * |[18] |BRKESTS2 |EPWM Channel2 Edge-detect Brake Status (Read Only) + * | | |0 = EPWM channel2 edge-detect brake state is released. + * | | |1 = When EPWM channel2 edge-detect brake detects a falling edge of any enabled brake source; this flag will be set to indicate the EPWM channel2 at brake state, writing 1 to clear. + * |[19] |BRKESTS3 |EPWM Channel3 Edge-detect Brake Status (Read Only) + * | | |0 = EPWM channel3 edge-detect brake state is released. + * | | |1 = When EPWM channel3 edge-detect brake detects a falling edge of any enabled brake source; this flag will be set to indicate the EPWM channel3 at brake state, writing 1 to clear. + * |[20] |BRKESTS4 |EPWM Channel4 Edge-detect Brake Status (Read Only) + * | | |0 = EPWM channel4 edge-detect brake state is released. + * | | |1 = When EPWM channel4 edge-detect brake detects a falling edge of any enabled brake source; this flag will be set to indicate the EPWM channel4 at brake state, writing 1 to clear. + * |[21] |BRKESTS5 |EPWM Channel5 Edge-detect Brake Status (Read Only) + * | | |0 = EPWM channel5 edge-detect brake state is released. + * | | |1 = When EPWM channel5 edge-detect brake detects a falling edge of any enabled brake source; this flag will be set to indicate the EPWM channel5 at brake state, writing 1 to clear. + * |[24] |BRKLSTS0 |EPWM Channel0 Level-detect Brake Status (Read Only) + * | | |0 = EPWM channel0 level-detect brake state is released. + * | | |1 = When EPWM channel0 level-detect brake detects a falling edge of any enabled brake source; this flag will be set to indicate the EPWM channel0 at brake state. + * | | |Note: This bit is read only and auto cleared by hardware + * | | |When enabled brake source return to high level, EPWM will release brake state until current EPWM period finished + * | | |The EPWM waveform will start output from next full EPWM period. + * |[25] |BRKLSTS1 |EPWM Channel1 Level-detect Brake Status (Read Only) + * | | |0 = EPWM channel1 level-detect brake state is released. + * | | |1 = When EPWM channel1 level-detect brake detects a falling edge of any enabled brake source; this flag will be set to indicate the EPWM channel1 at brake state. + * | | |Note: This bit is read only and auto cleared by hardware + * | | |When enabled brake source return to high level, EPWM will release brake state until current EPWM period finished + * | | |The EPWM waveform will start output from next full EPWM period. + * |[26] |BRKLSTS2 |EPWM Channel2 Level-detect Brake Status (Read Only) + * | | |0 = EPWM channel2 level-detect brake state is released. + * | | |1 = When EPWM channel2 level-detect brake detects a falling edge of any enabled brake source; this flag will be set to indicate the EPWM channel2 at brake state. + * | | |Note: This bit is read only and auto cleared by hardware + * | | |When enabled brake source return to high level, EPWM will release brake state until current EPWM period finished + * | | |The EPWM waveform will start output from next full EPWM period. + * |[27] |BRKLSTS3 |EPWM Channel3 Level-detect Brake Status (Read Only) + * | | |0 = EPWM channel3 level-detect brake state is released. + * | | |1 = When EPWM channel3 level-detect brake detects a falling edge of any enabled brake source; this flag will be set to indicate the EPWM channel3 at brake state. + * | | |Note: This bit is read only and auto cleared by hardware + * | | |When enabled brake source return to high level, EPWM will release brake state until current EPWM period finished + * | | |The EPWM waveform will start output from next full EPWM period. + * |[28] |BRKLSTS4 |EPWM Channel4 Level-detect Brake Status (Read Only) + * | | |0 = EPWM channel4 level-detect brake state is released. + * | | |1 = When EPWM channel4 level-detect brake detects a falling edge of any enabled brake source; this flag will be set to indicate the EPWM channel4 at brake state. + * | | |Note: This bit is read only and auto cleared by hardware + * | | |When enabled brake source return to high level, EPWM will release brake state until current EPWM period finished + * | | |The EPWM waveform will start output from next full EPWM period. + * |[29] |BRKLSTS5 |EPWM Channel5 Level-detect Brake Status (Read Only) + * | | |0 = EPWM channel5 level-detect brake state is released. + * | | |1 = When EPWM channel5 level-detect brake detects a falling edge of any enabled brake source; this flag will be set to indicate the EPWM channel5 at brake state. + * | | |Note: This bit is read only and auto cleared by hardware + * | | |When enabled brake source return to high level, EPWM will release brake state until current EPWM period finished + * | | |The EPWM waveform will start output from next full EPWM period. + * @var EPWM_T::DACTRGEN + * Offset: 0xF4 EPWM Trigger DAC Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ZTE0 |EPWM Zero Point Trigger DAC Enable Bits + * | | |EPWM can trigger EADC/DAC/DMA to start action when EPWM counter down count to zero if this bit is set to1. + * | | |0 = EPWM period point trigger DAC function Disabled. + * | | |1 = EPWM period point trigger DAC function Enabled. + * |[1] |ZTE1 |EPWM Zero Point Trigger DAC Enable Bits + * | | |EPWM can trigger EADC/DAC/DMA to start action when EPWM counter down count to zero if this bit is set to1. + * | | |0 = EPWM period point trigger DAC function Disabled. + * | | |1 = EPWM period point trigger DAC function Enabled. + * |[2] |ZTE2 |EPWM Zero Point Trigger DAC Enable Bits + * | | |EPWM can trigger EADC/DAC/DMA to start action when EPWM counter down count to zero if this bit is set to1. + * | | |0 = EPWM period point trigger DAC function Disabled. + * | | |1 = EPWM period point trigger DAC function Enabled. + * |[3] |ZTE3 |EPWM Zero Point Trigger DAC Enable Bits + * | | |EPWM can trigger EADC/DAC/DMA to start action when EPWM counter down count to zero if this bit is set to1. + * | | |0 = EPWM period point trigger DAC function Disabled. + * | | |1 = EPWM period point trigger DAC function Enabled. + * |[4] |ZTE4 |EPWM Zero Point Trigger DAC Enable Bits + * | | |EPWM can trigger EADC/DAC/DMA to start action when EPWM counter down count to zero if this bit is set to1. + * | | |0 = EPWM period point trigger DAC function Disabled. + * | | |1 = EPWM period point trigger DAC function Enabled. + * |[5] |ZTE5 |EPWM Zero Point Trigger DAC Enable Bits + * | | |EPWM can trigger EADC/DAC/DMA to start action when EPWM counter down count to zero if this bit is set to1. + * | | |0 = EPWM period point trigger DAC function Disabled. + * | | |1 = EPWM period point trigger DAC function Enabled. + * |[8] |PTE0 |EPWM Period Point Trigger DAC Enable Bits + * | | |EPWM can trigger DAC to start action when EPWM counter up count to (PERIODn+1) if this bit is set to1. + * | | |0 = EPWM period point trigger DAC function Disabled. + * | | |1 = EPWM period point trigger DAC function Enabled. + * |[9] |PTE1 |EPWM Period Point Trigger DAC Enable Bits + * | | |EPWM can trigger DAC to start action when EPWM counter up count to (PERIODn+1) if this bit is set to1. + * | | |0 = EPWM period point trigger DAC function Disabled. + * | | |1 = EPWM period point trigger DAC function Enabled. + * |[10] |PTE2 |EPWM Period Point Trigger DAC Enable Bits + * | | |EPWM can trigger DAC to start action when EPWM counter up count to (PERIODn+1) if this bit is set to1. + * | | |0 = EPWM period point trigger DAC function Disabled. + * | | |1 = EPWM period point trigger DAC function Enabled. + * |[11] |PTE3 |EPWM Period Point Trigger DAC Enable Bits + * | | |EPWM can trigger DAC to start action when EPWM counter up count to (PERIODn+1) if this bit is set to1. + * | | |0 = EPWM period point trigger DAC function Disabled. + * | | |1 = EPWM period point trigger DAC function Enabled. + * |[12] |PTE4 |EPWM Period Point Trigger DAC Enable Bits + * | | |EPWM can trigger DAC to start action when EPWM counter up count to (PERIODn+1) if this bit is set to1. + * | | |0 = EPWM period point trigger DAC function Disabled. + * | | |1 = EPWM period point trigger DAC function Enabled. + * |[13] |PTE5 |EPWM Period Point Trigger DAC Enable Bits + * | | |EPWM can trigger DAC to start action when EPWM counter up count to (PERIODn+1) if this bit is set to1. + * | | |0 = EPWM period point trigger DAC function Disabled. + * | | |1 = EPWM period point trigger DAC function Enabled. + * |[16] |CUTRGE0 |EPWM Compare Up Count Point Trigger DAC Enable Bits + * | | |EPWM can trigger DAC to start action when EPWM counter up count to CMPDAT if this bit is set to1. + * | | |0 = EPWM Compare Up point trigger DAC function Disabled. + * | | |1 = EPWM Compare Up point trigger DAC function Enabled. + * | | |Note1: This bit should keep at 0 when EPWM counter operating in down counter type. + * | | |Note2: In complementary mode, CUTRGE1, 3, 5 use as another CUTRGE for channel 0, 2, 4. + * |[17] |CUTRGE1 |EPWM Compare Up Count Point Trigger DAC Enable Bits + * | | |EPWM can trigger DAC to start action when EPWM counter up count to CMPDAT if this bit is set to1. + * | | |0 = EPWM Compare Up point trigger DAC function Disabled. + * | | |1 = EPWM Compare Up point trigger DAC function Enabled. + * | | |Note1: This bit should keep at 0 when EPWM counter operating in down counter type. + * | | |Note2: In complementary mode, CUTRGE1, 3, 5 use as another CUTRGE for channel 0, 2, 4. + * |[18] |CUTRGE2 |EPWM Compare Up Count Point Trigger DAC Enable Bits + * | | |EPWM can trigger DAC to start action when EPWM counter up count to CMPDAT if this bit is set to1. + * | | |0 = EPWM Compare Up point trigger DAC function Disabled. + * | | |1 = EPWM Compare Up point trigger DAC function Enabled. + * | | |Note1: This bit should keep at 0 when EPWM counter operating in down counter type. + * | | |Note2: In complementary mode, CUTRGE1, 3, 5 use as another CUTRGE for channel 0, 2, 4. + * |[19] |CUTRGE3 |EPWM Compare Up Count Point Trigger DAC Enable Bits + * | | |EPWM can trigger DAC to start action when EPWM counter up count to CMPDAT if this bit is set to1. + * | | |0 = EPWM Compare Up point trigger DAC function Disabled. + * | | |1 = EPWM Compare Up point trigger DAC function Enabled. + * | | |Note1: This bit should keep at 0 when EPWM counter operating in down counter type. + * | | |Note2: In complementary mode, CUTRGE1, 3, 5 use as another CUTRGE for channel 0, 2, 4. + * |[20] |CUTRGE4 |EPWM Compare Up Count Point Trigger DAC Enable Bits + * | | |EPWM can trigger DAC to start action when EPWM counter up count to CMPDAT if this bit is set to1. + * | | |0 = EPWM Compare Up point trigger DAC function Disabled. + * | | |1 = EPWM Compare Up point trigger DAC function Enabled. + * | | |Note1: This bit should keep at 0 when EPWM counter operating in down counter type. + * | | |Note2: In complementary mode, CUTRGE1, 3, 5 use as another CUTRGE for channel 0, 2, 4. + * |[21] |CUTRGE5 |EPWM Compare Up Count Point Trigger DAC Enable Bits + * | | |EPWM can trigger DAC to start action when EPWM counter up count to CMPDAT if this bit is set to1. + * | | |0 = EPWM Compare Up point trigger DAC function Disabled. + * | | |1 = EPWM Compare Up point trigger DAC function Enabled. + * | | |Note1: This bit should keep at 0 when EPWM counter operating in down counter type. + * | | |Note2: In complementary mode, CUTRGE1, 3, 5 use as another CUTRGE for channel 0, 2, 4. + * |[24] |CDTRGE0 |EPWM Compare Down Count Point Trigger DAC Enable Bits + * | | |EPWM can trigger DAC to start action when EPWM counter down count to CMPDAT if this bit is set to1. + * | | |0 = EPWM Compare Down count point trigger DAC function Disabled. + * | | |1 = EPWM Compare Down count point trigger DAC function Enabled. + * | | |Note1: This bit should keep at 0 when EPWM counter operating in up counter type. + * | | |Note2: In complementary mode, CDTRGE1, 3, 5 use as another CDTRGE for channel 0, 2, 4. + * |[25] |CDTRGE1 |EPWM Compare Down Count Point Trigger DAC Enable Bits + * | | |EPWM can trigger DAC to start action when EPWM counter down count to CMPDAT if this bit is set to1. + * | | |0 = EPWM Compare Down count point trigger DAC function Disabled. + * | | |1 = EPWM Compare Down count point trigger DAC function Enabled. + * | | |Note1: This bit should keep at 0 when EPWM counter operating in up counter type. + * | | |Note2: In complementary mode, CDTRGE1, 3, 5 use as another CDTRGE for channel 0, 2, 4. + * |[26] |CDTRGE2 |EPWM Compare Down Count Point Trigger DAC Enable Bits + * | | |EPWM can trigger DAC to start action when EPWM counter down count to CMPDAT if this bit is set to1. + * | | |0 = EPWM Compare Down count point trigger DAC function Disabled. + * | | |1 = EPWM Compare Down count point trigger DAC function Enabled. + * | | |Note1: This bit should keep at 0 when EPWM counter operating in up counter type. + * | | |Note2: In complementary mode, CDTRGE1, 3, 5 use as another CDTRGE for channel 0, 2, 4. + * |[27] |CDTRGE3 |EPWM Compare Down Count Point Trigger DAC Enable Bits + * | | |EPWM can trigger DAC to start action when EPWM counter down count to CMPDAT if this bit is set to1. + * | | |0 = EPWM Compare Down count point trigger DAC function Disabled. + * | | |1 = EPWM Compare Down count point trigger DAC function Enabled. + * | | |Note1: This bit should keep at 0 when EPWM counter operating in up counter type. + * | | |Note2: In complementary mode, CDTRGE1, 3, 5 use as another CDTRGE for channel 0, 2, 4. + * |[28] |CDTRGE4 |EPWM Compare Down Count Point Trigger DAC Enable Bits + * | | |EPWM can trigger DAC to start action when EPWM counter down count to CMPDAT if this bit is set to1. + * | | |0 = EPWM Compare Down count point trigger DAC function Disabled. + * | | |1 = EPWM Compare Down count point trigger DAC function Enabled. + * | | |Note1: This bit should keep at 0 when EPWM counter operating in up counter type. + * | | |Note2: In complementary mode, CDTRGE1, 3, 5 use as another CDTRGE for channel 0, 2, 4. + * |[29] |CDTRGE5 |EPWM Compare Down Count Point Trigger DAC Enable Bits + * | | |EPWM can trigger DAC to start action when EPWM counter down count to CMPDAT if this bit is set to1. + * | | |0 = EPWM Compare Down count point trigger DAC function Disabled. + * | | |1 = EPWM Compare Down count point trigger DAC function Enabled. + * | | |Note1: This bit should keep at 0 when EPWM counter operating in up counter type. + * | | |Note2: In complementary mode, CDTRGE1, 3, 5 use as another CDTRGE for channel 0, 2, 4. + * @var EPWM_T::EADCTS0 + * Offset: 0xF8 EPWM Trigger EADC Source Select Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |TRGSEL0 |EPWM_CH0 Trigger EADC Source Select + * | | |0000 = EPWM_CH0 zero point. + * | | |0001 = EPWM_CH0 period point. + * | | |0010 = EPWM_CH0 zero or period point. + * | | |0011 = EPWM_CH0 up-count CMPDAT point. + * | | |0100 = EPWM_CH0 down-count CMPDAT point. + * | | |0101 = EPWM_CH1 zero point. + * | | |0110 = EPWM_CH1 period point. + * | | |0111 = EPWM_CH1 zero or period point. + * | | |1000 = EPWM_CH1 up-count CMPDAT point. + * | | |1001 = EPWM_CH1 down-count CMPDAT point. + * | | |1010 = EPWM_CH0 up-count free CMPDAT point. + * | | |1011 = EPWM_CH0 down-count free CMPDAT point. + * | | |1100 = EPWM_CH2 up-count free CMPDAT point. + * | | |1101 = EPWM_CH2 down-count free CMPDAT point. + * | | |1110 = EPWM_CH4 up-count free CMPDAT point. + * | | |1111 = EPWM_CH4 down-count free CMPDAT point. + * |[7] |TRGEN0 |EPWM_CH0 Trigger EADC enable bit + * |[11:8] |TRGSEL1 |EPWM_CH1 Trigger EADC Source Select + * | | |0000 = EPWM_CH0 zero point. + * | | |0001 = EPWM_CH0 period point. + * | | |0010 = EPWM_CH0 zero or period point. + * | | |0011 = EPWM_CH0 up-count CMPDAT point. + * | | |0100 = EPWM_CH0 down-count CMPDAT point. + * | | |0101 = EPWM_CH1 zero point. + * | | |0110 = EPWM_CH1 period point. + * | | |0111 = EPWM_CH1 zero or period point. + * | | |1000 = EPWM_CH1 up-count CMPDAT point. + * | | |1001 = EPWM_CH1 down-count CMPDAT point. + * | | |1010 = EPWM_CH0 up-count free CMPDAT point. + * | | |1011 = EPWM_CH0 down-count free CMPDAT point. + * | | |1100 = EPWM_CH2 up-count free CMPDAT point. + * | | |1101 = EPWM_CH2 down-count free CMPDAT point. + * | | |1110 = EPWM_CH4 up-count free CMPDAT point. + * | | |1111 = EPWM_CH4 down-count free CMPDAT point. + * |[15] |TRGEN1 |EPWM_CH1 Trigger EADC enable bit + * |[19:16] |TRGSEL2 |EPWM_CH2 Trigger EADC Source Select + * | | |0000 = EPWM_CH2 zero point. + * | | |0001 = EPWM_CH2 period point. + * | | |0010 = EPWM_CH2 zero or period point. + * | | |0011 = EPWM_CH2 up-count CMPDAT point. + * | | |0100 = EPWM_CH2 down-count CMPDAT point. + * | | |0101 = EPWM_CH3 zero point. + * | | |0110 = EPWM_CH3 period point. + * | | |0111 = EPWM_CH3 zero or period point. + * | | |1000 = EPWM_CH3 up-count CMPDAT point. + * | | |1001 = EPWM_CH3 down-count CMPDAT point. + * | | |1010 = EPWM_CH0 up-count free CMPDAT point. + * | | |1011 = EPWM_CH0 down-count free CMPDAT point. + * | | |1100 = EPWM_CH2 up-count free CMPDAT point. + * | | |1101 = EPWM_CH2 down-count free CMPDAT point. + * | | |1110 = EPWM_CH4 up-count free CMPDAT point. + * | | |1111 = EPWM_CH4 down-count free CMPDAT point. + * |[23] |TRGEN2 |EPWM_CH2 Trigger EADC enable bit + * |[27:24] |TRGSEL3 |EPWM_CH3 Trigger EADC Source Select + * | | |0000 = EPWM_CH2 zero point. + * | | |0001 = EPWM_CH2 period point. + * | | |0010 = EPWM_CH2 zero or period point. + * | | |0011 = EPWM_CH2 up-count CMPDAT point. + * | | |0100 = EPWM_CH2 down-count CMPDAT point. + * | | |0101 = EPWM_CH3 zero point. + * | | |0110 = EPWM_CH3 period point. + * | | |0111 = EPWM_CH3 zero or period point. + * | | |1000 = EPWM_CH3 up-count CMPDAT point. + * | | |1001 = EPWM_CH3 down-count CMPDAT point. + * | | |1010 = EPWM_CH0 up-count free CMPDAT point. + * | | |1011 = EPWM_CH0 down-count free CMPDAT point. + * | | |1100 = EPWM_CH2 up-count free CMPDAT point. + * | | |1101 = EPWM_CH2 down-count free CMPDAT point. + * | | |1110 = EPWM_CH4 up-count free CMPDAT point. + * | | |1111 = EPWM_CH4 down-count free CMPDAT point. + * |[31] |TRGEN3 |EPWM_CH3 Trigger EADC enable bit + * @var EPWM_T::EADCTS1 + * Offset: 0xFC EPWM Trigger EADC Source Select Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |TRGSEL4 |EPWM_CH4 Trigger EADC Source Select + * | | |0000 = EPWM_CH4 zero point. + * | | |0001 = EPWM_CH4 period point. + * | | |0010 = EPWM_CH4 zero or period point. + * | | |0011 = EPWM_CH4 up-count CMPDAT point. + * | | |0100 = EPWM_CH4 down-count CMPDAT point. + * | | |0101 = EPWM_CH5 zero point. + * | | |0110 = EPWM_CH5 period point. + * | | |0111 = EPWM_CH5 zero or period point. + * | | |1000 = EPWM_CH5 up-count CMPDAT point. + * | | |1001 = EPWM_CH5 down-count CMPDAT point. + * | | |1010 = EPWM_CH0 up-count free CMPDAT point. + * | | |1011 = EPWM_CH0 down-count free CMPDAT point. + * | | |1100 = EPWM_CH2 up-count free CMPDAT point. + * | | |1101 = EPWM_CH2 down-count free CMPDAT point. + * | | |1110 = EPWM_CH4 up-count free CMPDAT point. + * | | |1111 = EPWM_CH4 down-count free CMPDAT point. + * |[7] |TRGEN4 |EPWM_CH4 Trigger EADC enable bit + * |[11:8] |TRGSEL5 |EPWM_CH5 Trigger EADC Source Select + * | | |0000 = EPWM_CH4 zero point. + * | | |0001 = EPWM_CH4 period point. + * | | |0010 = EPWM_CH4 zero or period point. + * | | |0011 = EPWM_CH4 up-count CMPDAT point. + * | | |0100 = EPWM_CH4 down-count CMPDAT point. + * | | |0101 = EPWM_CH5 zero point. + * | | |0110 = EPWM_CH5 period point. + * | | |0111 = EPWM_CH5 zero or period point. + * | | |1000 = EPWM_CH5 up-count CMPDAT point. + * | | |1001 = EPWM_CH5 down-count CMPDAT point. + * | | |1010 = EPWM_CH0 up-count free CMPDAT point. + * | | |1011 = EPWM_CH0 down-count free CMPDAT point. + * | | |1100 = EPWM_CH2 up-count free CMPDAT point. + * | | |1101 = EPWM_CH2 down-count free CMPDAT point. + * | | |1110 = EPWM_CH4 up-count free CMPDAT point. + * | | |1111 = EPWM_CH4 down-count free CMPDAT point. + * |[15] |TRGEN5 |EPWM_CH5 Trigger EADC enable bit + * @var EPWM_T::FTCMPDAT[3] + * Offset: 0x100 EPWM Free Trigger Compare Register 0/1,2/3,4/5 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |FTCMP |EPWM Free Trigger Compare Register + * | | |FTCMP use to compare with even CNTR to trigger EADC + * | | |FTCMPDAT0, 2, 4 corresponding complementary pairs EPWM_CH0 and EPWM_CH1, EPWM_CH2 and EPWM_CH3, EPWM_CH4 and EPWM_CH5. + * @var EPWM_T::SSCTL + * Offset: 0x110 EPWM Synchronous Start Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SSEN0 |EPWM Synchronous Start Function Enable Bits + * | | |When synchronous start function is enabled, the EPWM counter enable register (EPWM_CNTEN) can be enabled by writing EPWM synchronous start trigger bit (CNTSEN). + * | | |0 = EPWM synchronous start function Disabled. + * | | |1 = EPWM synchronous start function Enabled. + * |[1] |SSEN1 |EPWM Synchronous Start Function Enable Bits + * | | |When synchronous start function is enabled, the EPWM counter enable register (EPWM_CNTEN) can be enabled by writing EPWM synchronous start trigger bit (CNTSEN). + * | | |0 = EPWM synchronous start function Disabled. + * | | |1 = EPWM synchronous start function Enabled. + * |[2] |SSEN2 |EPWM Synchronous Start Function Enable Bits + * | | |When synchronous start function is enabled, the EPWM counter enable register (EPWM_CNTEN) can be enabled by writing EPWM synchronous start trigger bit (CNTSEN). + * | | |0 = EPWM synchronous start function Disabled. + * | | |1 = EPWM synchronous start function Enabled. + * |[3] |SSEN3 |EPWM Synchronous Start Function Enable Bits + * | | |When synchronous start function is enabled, the EPWM counter enable register (EPWM_CNTEN) can be enabled by writing EPWM synchronous start trigger bit (CNTSEN). + * | | |0 = EPWM synchronous start function Disabled. + * | | |1 = EPWM synchronous start function Enabled. + * |[4] |SSEN4 |EPWM Synchronous Start Function Enable Bits + * | | |When synchronous start function is enabled, the EPWM counter enable register (EPWM_CNTEN) can be enabled by writing EPWM synchronous start trigger bit (CNTSEN). + * | | |0 = EPWM synchronous start function Disabled. + * | | |1 = EPWM synchronous start function Enabled. + * |[5] |SSEN5 |EPWM Synchronous Start Function Enable Bits + * | | |When synchronous start function is enabled, the EPWM counter enable register (EPWM_CNTEN) can be enabled by writing EPWM synchronous start trigger bit (CNTSEN). + * | | |0 = EPWM synchronous start function Disabled. + * | | |1 = EPWM synchronous start function Enabled. + * |[9:8] |SSRC |EPWM Synchronous Start Source Select Bits + * | | |00 = Synchronous start source come from EPWM0. + * | | |01 = Synchronous start source come from EPWM1. + * | | |10 = Synchronous start source come from BPWM0. + * | | |11 = Synchronous start source come from BPWM1. + * @var EPWM_T::SSTRG + * Offset: 0x114 EPWM Synchronous Start Trigger Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CNTSEN |EPWM Counter Synchronous Start Enable (Write Only) + * | | |PMW counter synchronous enable function is used to make selected EPWM channels (include EPWM0_CHx and EPWM1_CHx) start counting at the same time. + * | | |Writing this bit to 1 will also set the counter enable bit (CNTENn, n denotes channel 0 to 5) if correlated EPWM channel counter synchronous start function is enabled. + * @var EPWM_T::LEBCTL + * Offset: 0x118 EPWM Leading Edge Blanking Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |LEBEN |EPWM Leading Edge Blanking Enable Bit + * | | |0 = EPWM Leading Edge Blanking Disabled. + * | | |1 = EPWM Leading Edge Blanking Enabled. + * |[8] |SRCEN0 |EPWM Leading Edge Blanking Source From EPWM_CH0 Enable Bit + * | | |0 = EPWM Leading Edge Blanking Source from EPWM_CH0 Disabled. + * | | |1 = EPWM Leading Edge Blanking Source from EPWM_CH0 Enabled. + * |[9] |SRCEN2 |EPWM Leading Edge Blanking Source From EPWM_CH2 Enable Bit + * | | |0 = EPWM Leading Edge Blanking Source from EPWM_CH2 Disabled. + * | | |1 = EPWM Leading Edge Blanking Source from EPWM_CH2 Enabled. + * |[10] |SRCEN4 |EPWM Leading Edge Blanking Source From EPWM_CH4 Enable Bit + * | | |0 = EPWM Leading Edge Blanking Source from EPWM_CH4 Disabled. + * | | |1 = EPWM Leading Edge Blanking Source from EPWM_CH4 Enabled. + * |[17:16] |TRGTYPE |EPWM Leading Edge Blanking Trigger Type + * | | |0 = When detect leading edge blanking source rising edge, blanking counter start counting. + * | | |1 = When detect leading edge blanking source falling edge, blanking counter start counting. + * | | |2 = When detect leading edge blanking source rising or falling edge, blanking counter start counting. + * | | |3 = Reserved. + * @var EPWM_T::LEBCNT + * Offset: 0x11C EPWM Leading Edge Blanking Counter Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[8:0] |LEBCNT |EPWM Leading Edge Blanking Counter + * | | |This counter value decides leading edge blanking window size + * | | |Blanking window size = LEBCNT+1, and LEB counter clock base is ECLK. + * @var EPWM_T::STATUS + * Offset: 0x120 EPWM Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CNTMAXF0 |Time-base Counter Equal to 0xFFFF Latched Flag + * | | |0 = indicates the time-base counter never reached its maximum value 0xFFFF. + * | | |1 = indicates the time-base counter reached its maximum value, software can write 1 to clear this bit. + * |[1] |CNTMAXF1 |Time-base Counter Equal to 0xFFFF Latched Flag + * | | |0 = indicates the time-base counter never reached its maximum value 0xFFFF. + * | | |1 = indicates the time-base counter reached its maximum value, software can write 1 to clear this bit. + * |[2] |CNTMAXF2 |Time-base Counter Equal to 0xFFFF Latched Flag + * | | |0 = indicates the time-base counter never reached its maximum value 0xFFFF. + * | | |1 = indicates the time-base counter reached its maximum value, software can write 1 to clear this bit. + * |[3] |CNTMAXF3 |Time-base Counter Equal to 0xFFFF Latched Flag + * | | |0 = indicates the time-base counter never reached its maximum value 0xFFFF. + * | | |1 = indicates the time-base counter reached its maximum value, software can write 1 to clear this bit. + * |[4] |CNTMAXF4 |Time-base Counter Equal to 0xFFFF Latched Flag + * | | |0 = indicates the time-base counter never reached its maximum value 0xFFFF. + * | | |1 = indicates the time-base counter reached its maximum value, software can write 1 to clear this bit. + * |[5] |CNTMAXF5 |Time-base Counter Equal to 0xFFFF Latched Flag + * | | |0 = indicates the time-base counter never reached its maximum value 0xFFFF. + * | | |1 = indicates the time-base counter reached its maximum value, software can write 1 to clear this bit. + * |[8] |SYNCINF0 |Input Synchronization Latched Flag + * | | |0 = Indicates no SYNC_IN event has occurred. + * | | |1 = Indicates an SYNC_IN event has occurred, software can write 1 to clear this bit. + * |[9] |SYNCINF2 |Input Synchronization Latched Flag + * | | |0 = Indicates no SYNC_IN event has occurred. + * | | |1 = Indicates an SYNC_IN event has occurred, software can write 1 to clear this bit. + * |[10] |SYNCINF4 |Input Synchronization Latched Flag + * | | |0 = Indicates no SYNC_IN event has occurred. + * | | |1 = Indicates an SYNC_IN event has occurred, software can write 1 to clear this bit. + * |[16] |EADCTRGF0 |EADC Start of Conversion Flag + * | | |0 = Indicates no EADC start of conversion trigger event has occurred. + * | | |1 = Indicates an EADC start of conversion trigger event has occurred, software can write 1 to clear this bit. + * |[17] |EADCTRGF1 |EADC Start of Conversion Flag + * | | |0 = Indicates no EADC start of conversion trigger event has occurred. + * | | |1 = Indicates an EADC start of conversion trigger event has occurred, software can write 1 to clear this bit. + * |[18] |EADCTRGF2 |EADC Start of Conversion Flag + * | | |0 = Indicates no EADC start of conversion trigger event has occurred. + * | | |1 = Indicates an EADC start of conversion trigger event has occurred, software can write 1 to clear this bit. + * |[19] |EADCTRGF3 |EADC Start of Conversion Flag + * | | |0 = Indicates no EADC start of conversion trigger event has occurred. + * | | |1 = Indicates an EADC start of conversion trigger event has occurred, software can write 1 to clear this bit. + * |[20] |EADCTRGF4 |EADC Start of Conversion Flag + * | | |0 = Indicates no EADC start of conversion trigger event has occurred. + * | | |1 = Indicates an EADC start of conversion trigger event has occurred, software can write 1 to clear this bit. + * |[21] |EADCTRGF5 |EADC Start of Conversion Flag + * | | |0 = Indicates no EADC start of conversion trigger event has occurred. + * | | |1 = Indicates an EADC start of conversion trigger event has occurred, software can write 1 to clear this bit. + * |[24] |DACTRGF |DAC Start of Conversion Flag + * | | |0 = Indicates no DAC start of conversion trigger event has occurred. + * | | |1 = Indicates an DAC start of conversion trigger event has occurred, software can write 1 to clear this bit + * @var EPWM_T::IFA[6] + * Offset: 0x130 EPWM Interrupt Flag Accumulator Register 0~5 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |IFACNT |EPWM_CHn Interrupt Flag Counter + * | | |The register sets the count number which defines how many times of EPWM_CHn period occurs to set bit IFAIFn to request the EPWM period interrupt. + * | | |EPWM flag will be set in every IFACNT[15:0] times of EPWM period. + * |[24] |STPMOD |EPWM_CHn Interrupt Flag Accumulator Stop Mode Enable Bits + * | | |0 = EPWM_CHn interrupt flag accumulator stop mode disable. + * | | |1 = EPWM_CHn interrupt flag accumulator stop mode enable. + * |[29:28] |IFASEL |EPWM_CHn Interrupt Flag Accumulator Source Select + * | | |00 = CNT equal to Zero in channel n. + * | | |01 = CNT equal to PERIOD in channel n. + * | | |10 = CNT equal to CMPU in channel n. + * | | |11 = CNT equal to CMPD in channel n. + * |[31] |IFAEN |EPWM_CHn Interrupt Flag Accumulator Enable Bits + * | | |0 = EPWM_CHn interrupt flag accumulator disable. + * | | |1 = EPWM_CHn interrupt flag accumulator enable. + * @var EPWM_T::AINTSTS + * Offset: 0x150 EPWM Accumulator Interrupt Flag Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |IFAIF0 |EPWM_CHn Interrupt Flag Accumulator Interrupt Flag + * | | |Flag is set by hardware when condition match IFASEL in EPWM_IFAn register, software can clear this bit by writing 1 to it. + * |[1] |IFAIF1 |EPWM_CHn Interrupt Flag Accumulator Interrupt Flag + * | | |Flag is set by hardware when condition match IFASEL in EPWM_IFAn register, software can clear this bit by writing 1 to it. + * |[2] |IFAIF2 |EPWM_CHn Interrupt Flag Accumulator Interrupt Flag + * | | |Flag is set by hardware when condition match IFASEL in EPWM_IFAn register, software can clear this bit by writing 1 to it. + * |[3] |IFAIF3 |EPWM_CHn Interrupt Flag Accumulator Interrupt Flag + * | | |Flag is set by hardware when condition match IFASEL in EPWM_IFAn register, software can clear this bit by writing 1 to it. + * |[4] |IFAIF4 |EPWM_CHn Interrupt Flag Accumulator Interrupt Flag + * | | |Flag is set by hardware when condition match IFASEL in EPWM_IFAn register, software can clear this bit by writing 1 to it. + * |[5] |IFAIF5 |EPWM_CHn Interrupt Flag Accumulator Interrupt Flag + * | | |Flag is set by hardware when condition match IFASEL in EPWM_IFAn register, software can clear this bit by writing 1 to it. + * @var EPWM_T::AINTEN + * Offset: 0x154 EPWM Accumulator Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |IFAIEN0 |EPWM_CHn Interrupt Flag Accumulator Interrupt Enable Bits + * | | |0 = Interrupt Flag accumulator interrupt Disabled. + * | | |1 = Interrupt Flag accumulator interrupt Enabled. + * |[1] |IFAIEN1 |EPWM_CHn Interrupt Flag Accumulator Interrupt Enable Bits + * | | |0 = Interrupt Flag accumulator interrupt Disabled. + * | | |1 = Interrupt Flag accumulator interrupt Enabled. + * |[2] |IFAIEN2 |EPWM_CHn Interrupt Flag Accumulator Interrupt Enable Bits + * | | |0 = Interrupt Flag accumulator interrupt Disabled. + * | | |1 = Interrupt Flag accumulator interrupt Enabled. + * |[3] |IFAIEN3 |EPWM_CHn Interrupt Flag Accumulator Interrupt Enable Bits + * | | |0 = Interrupt Flag accumulator interrupt Disabled. + * | | |1 = Interrupt Flag accumulator interrupt Enabled. + * |[4] |IFAIEN4 |EPWM_CHn Interrupt Flag Accumulator Interrupt Enable Bits + * | | |0 = Interrupt Flag accumulator interrupt Disabled. + * | | |1 = Interrupt Flag accumulator interrupt Enabled. + * |[5] |IFAIEN5 |EPWM_CHn Interrupt Flag Accumulator Interrupt Enable Bits + * | | |0 = Interrupt Flag accumulator interrupt Disabled. + * | | |1 = Interrupt Flag accumulator interrupt Enabled. + * @var EPWM_T::APDMACTL + * Offset: 0x158 EPWM Accumulator PDMA Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |APDMAEN0 |Channel N Accumulator PDMA Enable Bits + * | | |0 = Channel n PDMA function Disabled. + * | | |1 = Channel n PDMA function Enabled for the channel n to trigger PDMA to transfer memory data to register. + * |[1] |APDMAEN1 |Channel N Accumulator PDMA Enable Bits + * | | |0 = Channel n PDMA function Disabled. + * | | |1 = Channel n PDMA function Enabled for the channel n to trigger PDMA to transfer memory data to register. + * |[2] |APDMAEN2 |Channel N Accumulator PDMA Enable Bits + * | | |0 = Channel n PDMA function Disabled. + * | | |1 = Channel n PDMA function Enabled for the channel n to trigger PDMA to transfer memory data to register. + * |[3] |APDMAEN3 |Channel N Accumulator PDMA Enable Bits + * | | |0 = Channel n PDMA function Disabled. + * | | |1 = Channel n PDMA function Enabled for the channel n to trigger PDMA to transfer memory data to register. + * |[4] |APDMAEN4 |Channel N Accumulator PDMA Enable Bits + * | | |0 = Channel n PDMA function Disabled. + * | | |1 = Channel n PDMA function Enabled for the channel n to trigger PDMA to transfer memory data to register. + * |[5] |APDMAEN5 |Channel N Accumulator PDMA Enable Bits + * | | |0 = Channel n PDMA function Disabled. + * | | |1 = Channel n PDMA function Enabled for the channel n to trigger PDMA to transfer memory data to register. + * @var EPWM_T::CAPINEN + * Offset: 0x200 EPWM Capture Input Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CAPINEN0 |Capture Input Enable Bits + * | | |0 = EPWM Channel capture input path Disabled + * | | |The input of EPWM channel capture function is always regarded as 0. + * | | |1 = EPWM Channel capture input path Enabled + * | | |The input of EPWM channel capture function comes from correlative multifunction pin. + * |[1] |CAPINEN1 |Capture Input Enable Bits + * | | |0 = EPWM Channel capture input path Disabled + * | | |The input of EPWM channel capture function is always regarded as 0. + * | | |1 = EPWM Channel capture input path Enabled + * | | |The input of EPWM channel capture function comes from correlative multifunction pin. + * |[2] |CAPINEN2 |Capture Input Enable Bits + * | | |0 = EPWM Channel capture input path Disabled + * | | |The input of EPWM channel capture function is always regarded as 0. + * | | |1 = EPWM Channel capture input path Enabled + * | | |The input of EPWM channel capture function comes from correlative multifunction pin. + * |[3] |CAPINEN3 |Capture Input Enable Bits + * | | |0 = EPWM Channel capture input path Disabled + * | | |The input of EPWM channel capture function is always regarded as 0. + * | | |1 = EPWM Channel capture input path Enabled + * | | |The input of EPWM channel capture function comes from correlative multifunction pin. + * |[4] |CAPINEN4 |Capture Input Enable Bits + * | | |0 = EPWM Channel capture input path Disabled + * | | |The input of EPWM channel capture function is always regarded as 0. + * | | |1 = EPWM Channel capture input path Enabled + * | | |The input of EPWM channel capture function comes from correlative multifunction pin. + * |[5] |CAPINEN5 |Capture Input Enable Bits + * | | |0 = EPWM Channel capture input path Disabled + * | | |The input of EPWM channel capture function is always regarded as 0. + * | | |1 = EPWM Channel capture input path Enabled + * | | |The input of EPWM channel capture function comes from correlative multifunction pin. + * @var EPWM_T::CAPCTL + * Offset: 0x204 EPWM Capture Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CAPEN0 |Capture Function Enable Bits + * | | |0 = Capture function Disabled. RCAPDAT/FCAPDAT register will not be updated. + * | | |1 = Capture function Enabled + * | | |Capture latched the EPWM counter value when detected rising or falling edge of input signal and saved to RCAPDAT (Rising latch) and FCAPDAT (Falling latch). + * |[1] |CAPEN1 |Capture Function Enable Bits + * | | |0 = Capture function Disabled. RCAPDAT/FCAPDAT register will not be updated. + * | | |1 = Capture function Enabled + * | | |Capture latched the EPWM counter value when detected rising or falling edge of input signal and saved to RCAPDAT (Rising latch) and FCAPDAT (Falling latch). + * |[2] |CAPEN2 |Capture Function Enable Bits + * | | |0 = Capture function Disabled. RCAPDAT/FCAPDAT register will not be updated. + * | | |1 = Capture function Enabled + * | | |Capture latched the EPWM counter value when detected rising or falling edge of input signal and saved to RCAPDAT (Rising latch) and FCAPDAT (Falling latch). + * |[3] |CAPEN3 |Capture Function Enable Bits + * | | |0 = Capture function Disabled. RCAPDAT/FCAPDAT register will not be updated. + * | | |1 = Capture function Enabled + * | | |Capture latched the EPWM counter value when detected rising or falling edge of input signal and saved to RCAPDAT (Rising latch) and FCAPDAT (Falling latch). + * |[4] |CAPEN4 |Capture Function Enable Bits + * | | |0 = Capture function Disabled. RCAPDAT/FCAPDAT register will not be updated. + * | | |1 = Capture function Enabled + * | | |Capture latched the EPWM counter value when detected rising or falling edge of input signal and saved to RCAPDAT (Rising latch) and FCAPDAT (Falling latch). + * |[5] |CAPEN5 |Capture Function Enable Bits + * | | |0 = Capture function Disabled. RCAPDAT/FCAPDAT register will not be updated. + * | | |1 = Capture function Enabled + * | | |Capture latched the EPWM counter value when detected rising or falling edge of input signal and saved to RCAPDAT (Rising latch) and FCAPDAT (Falling latch). + * |[8] |CAPINV0 |Capture Inverter Enable Bits + * | | |0 = Capture source inverter Disabled. + * | | |1 = Capture source inverter Enabled. Reverse the input signal from GPIO. + * |[9] |CAPINV1 |Capture Inverter Enable Bits + * | | |0 = Capture source inverter Disabled. + * | | |1 = Capture source inverter Enabled. Reverse the input signal from GPIO. + * |[10] |CAPINV2 |Capture Inverter Enable Bits + * | | |0 = Capture source inverter Disabled. + * | | |1 = Capture source inverter Enabled. Reverse the input signal from GPIO. + * |[11] |CAPINV3 |Capture Inverter Enable Bits + * | | |0 = Capture source inverter Disabled. + * | | |1 = Capture source inverter Enabled. Reverse the input signal from GPIO. + * |[12] |CAPINV4 |Capture Inverter Enable Bits + * | | |0 = Capture source inverter Disabled. + * | | |1 = Capture source inverter Enabled. Reverse the input signal from GPIO. + * |[13] |CAPINV5 |Capture Inverter Enable Bits + * | | |0 = Capture source inverter Disabled. + * | | |1 = Capture source inverter Enabled. Reverse the input signal from GPIO. + * |[16] |RCRLDEN0 |Rising Capture Reload Enable Bits + * | | |0 = Rising capture reload counter Disabled. + * | | |1 = Rising capture reload counter Enabled. + * |[17] |RCRLDEN1 |Rising Capture Reload Enable Bits + * | | |0 = Rising capture reload counter Disabled. + * | | |1 = Rising capture reload counter Enabled. + * |[18] |RCRLDEN2 |Rising Capture Reload Enable Bits + * | | |0 = Rising capture reload counter Disabled. + * | | |1 = Rising capture reload counter Enabled. + * |[19] |RCRLDEN3 |Rising Capture Reload Enable Bits + * | | |0 = Rising capture reload counter Disabled. + * | | |1 = Rising capture reload counter Enabled. + * |[20] |RCRLDEN4 |Rising Capture Reload Enable Bits + * | | |0 = Rising capture reload counter Disabled. + * | | |1 = Rising capture reload counter Enabled. + * |[21] |RCRLDEN5 |Rising Capture Reload Enable Bits + * | | |0 = Rising capture reload counter Disabled. + * | | |1 = Rising capture reload counter Enabled. + * |[24] |FCRLDEN0 |Falling Capture Reload Enable Bits + * | | |0 = Falling capture reload counter Disabled. + * | | |1 = Falling capture reload counter Enabled. + * |[25] |FCRLDEN1 |Falling Capture Reload Enable Bits + * | | |0 = Falling capture reload counter Disabled. + * | | |1 = Falling capture reload counter Enabled. + * |[26] |FCRLDEN2 |Falling Capture Reload Enable Bits + * | | |0 = Falling capture reload counter Disabled. + * | | |1 = Falling capture reload counter Enabled. + * |[27] |FCRLDEN3 |Falling Capture Reload Enable Bits + * | | |0 = Falling capture reload counter Disabled. + * | | |1 = Falling capture reload counter Enabled. + * |[28] |FCRLDEN4 |Falling Capture Reload Enable Bits + * | | |0 = Falling capture reload counter Disabled. + * | | |1 = Falling capture reload counter Enabled. + * |[29] |FCRLDEN5 |Falling Capture Reload Enable Bits + * | | |0 = Falling capture reload counter Disabled. + * | | |1 = Falling capture reload counter Enabled. + * @var EPWM_T::CAPSTS + * Offset: 0x208 EPWM Capture Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CRLIFOV0 |Capture Rising Latch Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if rising latch happened when the corresponding CRLIF is 1. + * | | |Note: This bit will be cleared automatically when user clear corresponding CRLIF. + * |[1] |CRLIFOV1 |Capture Rising Latch Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if rising latch happened when the corresponding CRLIF is 1. + * | | |Note: This bit will be cleared automatically when user clear corresponding CRLIF. + * |[2] |CRLIFOV2 |Capture Rising Latch Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if rising latch happened when the corresponding CRLIF is 1. + * | | |Note: This bit will be cleared automatically when user clear corresponding CRLIF. + * |[3] |CRLIFOV3 |Capture Rising Latch Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if rising latch happened when the corresponding CRLIF is 1. + * | | |Note: This bit will be cleared automatically when user clear corresponding CRLIF. + * |[4] |CRLIFOV4 |Capture Rising Latch Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if rising latch happened when the corresponding CRLIF is 1. + * | | |Note: This bit will be cleared automatically when user clear corresponding CRLIF. + * |[5] |CRLIFOV5 |Capture Rising Latch Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if rising latch happened when the corresponding CRLIF is 1. + * | | |Note: This bit will be cleared automatically when user clear corresponding CRLIF. + * |[8] |CFLIFOV0 |Capture Falling Latch Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if falling latch happened when the corresponding CFLIF is 1. + * | | |Note: This bit will be cleared automatically when user clear corresponding CFLIF. + * |[9] |CFLIFOV1 |Capture Falling Latch Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if falling latch happened when the corresponding CFLIF is 1. + * | | |Note: This bit will be cleared automatically when user clear corresponding CFLIF. + * |[10] |CFLIFOV2 |Capture Falling Latch Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if falling latch happened when the corresponding CFLIF is 1. + * | | |Note: This bit will be cleared automatically when user clear corresponding CFLIF. + * |[11] |CFLIFOV3 |Capture Falling Latch Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if falling latch happened when the corresponding CFLIF is 1. + * | | |Note: This bit will be cleared automatically when user clear corresponding CFLIF. + * |[12] |CFLIFOV4 |Capture Falling Latch Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if falling latch happened when the corresponding CFLIF is 1. + * | | |Note: This bit will be cleared automatically when user clear corresponding CFLIF. + * |[13] |CFLIFOV5 |Capture Falling Latch Interrupt Flag Overrun Status (Read Only) + * | | |This flag indicates if falling latch happened when the corresponding CFLIF is 1. + * | | |Note: This bit will be cleared automatically when user clear corresponding CFLIF. + * @var EPWM_T::PDMACTL + * Offset: 0x23C EPWM PDMA Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CHEN0_1 |Channel 0/1 PDMA Enable + * | | |0 = Channel 0/1 PDMA function Disabled. + * | | |1 = Channel 0/1 PDMA function Enabled for the channel 0/1 captured data and transfer to memory. + * |[2:1] |CAPMOD0_1 |Select EPWM_RCAPDAT0/1 or EPWM_FCAPDAT0/1 to Do PDMA Transfer + * | | |00 = Reserved. + * | | |01 = EPWM_RCAPDAT0/1. + * | | |10 = EPWM_FCAPDAT0/1. + * | | |11 = Both EPWM_RCAPDAT0/1 and EPWM_FCAPDAT0/1. + * |[3] |CAPORD0_1 |Capture Channel 0/1 Rising/Falling Order + * | | |Set this bit to determine whether the EPWM_RCAPDAT0/1 or EPWM_FCAPDAT0/1 is the first captured data transferred to memory through PDMA when CAPMOD0_1 =11. + * | | |0 = EPWM_FCAPDAT0/1 is the first captured data to memory. + * | | |1 = EPWM_RCAPDAT0/1 is the first captured data to memory. + * |[4] |CHSEL0_1 |Select Channel 0/1 to Do PDMA Transfer + * | | |0 = Channel0. + * | | |1 = Channel1. + * |[8] |CHEN2_3 |Channel 2/3 PDMA Enable + * | | |0 = Channel 2/3 PDMA function Disabled. + * | | |1 = Channel 2/3 PDMA function Enabled for the channel 2/3 captured data and transfer to memory. + * |[10:9] |CAPMOD2_3 |Select EPWM_RCAPDAT2/3 or EPWM_FCAODAT2/3 to Do PDMA Transfer + * | | |00 = Reserved. + * | | |01 = EPWM_RCAPDAT2/3. + * | | |10 = EPWM_FCAPDAT2/3. + * | | |11 = Both EPWM_RCAPDAT2/3 and EPWM_FCAPDAT2/3. + * |[11] |CAPORD2_3 |Capture Channel 2/3 Rising/Falling Order + * | | |Set this bit to determine whether the EPWM_RCAPDAT2/3 or EPWM_FCAPDAT2/3 is the first captured data transferred to memory through PDMA when CAPMOD2_3 =11. + * | | |0 = EPWM_FCAPDAT2/3 is the first captured data to memory. + * | | |1 = EPWM_RCAPDAT2/3 is the first captured data to memory. + * |[12] |CHSEL2_3 |Select Channel 2/3 to Do PDMA Transfer + * | | |0 = Channel2. + * | | |1 = Channel3. + * |[16] |CHEN4_5 |Channel 4/5 PDMA Enable + * | | |0 = Channel 4/5 PDMA function Disabled. + * | | |1 = Channel 4/5 PDMA function Enabled for the channel 4/5 captured data and transfer to memory. + * |[18:17] |CAPMOD4_5 |Select EPWM_RCAPDAT4/5 or EPWM_FCAPDAT4/5 to Do PDMA Transfer + * | | |00 = Reserved. + * | | |01 = EPWM_RCAPDAT4/5. + * | | |10 = EPWM_FCAPDAT4/5. + * | | |11 = Both EPWM_RCAPDAT4/5 and EPWM_FCAPDAT4/5. + * |[19] |CAPORD4_5 |Capture Channel 4/5 Rising/Falling Order + * | | |Set this bit to determine whether the EPWM_RCAPDAT4/5 or EPWM_FCAPDAT4/5 is the first captured data transferred to memory through PDMA when CAPMOD4_5 =11. + * | | |0 = EPWM_FCAPDAT4/5 is the first captured data to memory. + * | | |1 = EPWM_RCAPDAT4/5 is the first captured data to memory. + * |[20] |CHSEL4_5 |Select Channel 4/5 to Do PDMA Transfer + * | | |0 = Channel4. + * | | |1 = Channel5. + * @var EPWM_T::PDMACAP[3] + * Offset: 0x240 EPWM Capture Channel 01 PDMA Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |CAPBUF |EPWM Capture PDMA Register (Read Only) + * | | |This register is use as a buffer to transfer EPWM capture rising or falling data to memory by PDMA. + * @var EPWM_T::CAPIEN + * Offset: 0x250 EPWM Capture Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CAPRIEN0 |EPWM Capture Rising Latch Interrupt Enable Bits + * | | |0 = Capture rising edge latch interrupt Disabled. + * | | |1 = Capture rising edge latch interrupt Enabled. + * |[1] |CAPRIEN1 |EPWM Capture Rising Latch Interrupt Enable Bits + * | | |0 = Capture rising edge latch interrupt Disabled. + * | | |1 = Capture rising edge latch interrupt Enabled. + * |[2] |CAPRIEN2 |EPWM Capture Rising Latch Interrupt Enable Bits + * | | |0 = Capture rising edge latch interrupt Disabled. + * | | |1 = Capture rising edge latch interrupt Enabled. + * |[3] |CAPRIEN3 |EPWM Capture Rising Latch Interrupt Enable Bits + * | | |0 = Capture rising edge latch interrupt Disabled. + * | | |1 = Capture rising edge latch interrupt Enabled. + * |[4] |CAPRIEN4 |EPWM Capture Rising Latch Interrupt Enable Bits + * | | |0 = Capture rising edge latch interrupt Disabled. + * | | |1 = Capture rising edge latch interrupt Enabled. + * |[5] |CAPRIEN5 |EPWM Capture Rising Latch Interrupt Enable Bits + * | | |0 = Capture rising edge latch interrupt Disabled. + * | | |1 = Capture rising edge latch interrupt Enabled. + * |[8] |CAPFIEN0 |EPWM Capture Falling Latch Interrupt Enable Bits + * | | |0 = Capture falling edge latch interrupt Disabled. + * | | |1 = Capture falling edge latch interrupt Enabled. + * |[9] |CAPFIEN1 |EPWM Capture Falling Latch Interrupt Enable Bits + * | | |0 = Capture falling edge latch interrupt Disabled. + * | | |1 = Capture falling edge latch interrupt Enabled. + * |[10] |CAPFIEN2 |EPWM Capture Falling Latch Interrupt Enable Bits + * | | |0 = Capture falling edge latch interrupt Disabled. + * | | |1 = Capture falling edge latch interrupt Enabled. + * |[11] |CAPFIEN3 |EPWM Capture Falling Latch Interrupt Enable Bits + * | | |0 = Capture falling edge latch interrupt Disabled. + * | | |1 = Capture falling edge latch interrupt Enabled. + * |[12] |CAPFIEN4 |EPWM Capture Falling Latch Interrupt Enable Bits + * | | |0 = Capture falling edge latch interrupt Disabled. + * | | |1 = Capture falling edge latch interrupt Enabled. + * |[13] |CAPFIEN5 |EPWM Capture Falling Latch Interrupt Enable Bits + * | | |0 = Capture falling edge latch interrupt Disabled. + * | | |1 = Capture falling edge latch interrupt Enabled. + * @var EPWM_T::CAPIF + * Offset: 0x254 EPWM Capture Interrupt Flag Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CRLIF0 |EPWM Capture Rising Latch Interrupt Flag + * | | |This bit is writing 1 to clear. + * | | |0 = No capture rising latch condition happened. + * | | |1 = Capture rising latch condition happened, this flag will be set to high. + * | | |Note: When Capture with PDMA operating, CAPIF corresponding channel CRLIF will cleared by hardware after PDMA transfer data. + * |[1] |CRLIF1 |EPWM Capture Rising Latch Interrupt Flag + * | | |This bit is writing 1 to clear. + * | | |0 = No capture rising latch condition happened. + * | | |1 = Capture rising latch condition happened, this flag will be set to high. + * | | |Note: When Capture with PDMA operating, CAPIF corresponding channel CRLIF will cleared by hardware after PDMA transfer data. + * |[2] |CRLIF2 |EPWM Capture Rising Latch Interrupt Flag + * | | |This bit is writing 1 to clear. + * | | |0 = No capture rising latch condition happened. + * | | |1 = Capture rising latch condition happened, this flag will be set to high. + * | | |Note: When Capture with PDMA operating, CAPIF corresponding channel CRLIF will cleared by hardware after PDMA transfer data. + * |[3] |CRLIF3 |EPWM Capture Rising Latch Interrupt Flag + * | | |This bit is writing 1 to clear. + * | | |0 = No capture rising latch condition happened. + * | | |1 = Capture rising latch condition happened, this flag will be set to high. + * | | |Note: When Capture with PDMA operating, CAPIF corresponding channel CRLIF will cleared by hardware after PDMA transfer data. + * |[4] |CRLIF4 |EPWM Capture Rising Latch Interrupt Flag + * | | |This bit is writing 1 to clear. + * | | |0 = No capture rising latch condition happened. + * | | |1 = Capture rising latch condition happened, this flag will be set to high. + * | | |Note: When Capture with PDMA operating, CAPIF corresponding channel CRLIF will cleared by hardware after PDMA transfer data. + * |[5] |CRLIF5 |EPWM Capture Rising Latch Interrupt Flag + * | | |This bit is writing 1 to clear. + * | | |0 = No capture rising latch condition happened. + * | | |1 = Capture rising latch condition happened, this flag will be set to high. + * | | |Note: When Capture with PDMA operating, CAPIF corresponding channel CRLIF will cleared by hardware after PDMA transfer data. + * |[8] |CFLIF0 |EPWM Capture Falling Latch Interrupt Flag + * | | |This bit is writing 1 to clear. + * | | |0 = No capture falling latch condition happened. + * | | |1 = Capture falling latch condition happened, this flag will be set to high. + * | | |Note: When Capture with PDMA operating, CAPIF corresponding channel CFLIF will cleared by hardware after PDMA transfer data. + * |[9] |CFLIF1 |EPWM Capture Falling Latch Interrupt Flag + * | | |This bit is writing 1 to clear. + * | | |0 = No capture falling latch condition happened. + * | | |1 = Capture falling latch condition happened, this flag will be set to high. + * | | |Note: When Capture with PDMA operating, CAPIF corresponding channel CFLIF will cleared by hardware after PDMA transfer data. + * |[10] |CFLIF2 |EPWM Capture Falling Latch Interrupt Flag + * | | |This bit is writing 1 to clear. + * | | |0 = No capture falling latch condition happened. + * | | |1 = Capture falling latch condition happened, this flag will be set to high. + * | | |Note: When Capture with PDMA operating, CAPIF corresponding channel CFLIF will cleared by hardware after PDMA transfer data. + * |[11] |CFLIF3 |EPWM Capture Falling Latch Interrupt Flag + * | | |This bit is writing 1 to clear. + * | | |0 = No capture falling latch condition happened. + * | | |1 = Capture falling latch condition happened, this flag will be set to high. + * | | |Note: When Capture with PDMA operating, CAPIF corresponding channel CFLIF will cleared by hardware after PDMA transfer data. + * |[12] |CFLIF4 |EPWM Capture Falling Latch Interrupt Flag + * | | |This bit is writing 1 to clear. + * | | |0 = No capture falling latch condition happened. + * | | |1 = Capture falling latch condition happened, this flag will be set to high. + * | | |Note: When Capture with PDMA operating, CAPIF corresponding channel CFLIF will cleared by hardware after PDMA transfer data. + * |[13] |CFLIF5 |EPWM Capture Falling Latch Interrupt Flag + * | | |This bit is writing 1 to clear. + * | | |0 = No capture falling latch condition happened. + * | | |1 = Capture falling latch condition happened, this flag will be set to high. + * | | |Note: When Capture with PDMA operating, CAPIF corresponding channel CFLIF will cleared by hardware after PDMA transfer data. + * @var EPWM_T::PBUF[6] + * Offset: 0x304 EPWM PERIOD0~5 Buffer + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |PBUF |EPWM Period Register Buffer (Read Only) + * | | |Used as PERIOD active register. + * @var EPWM_T::CMPBUF[6] + * Offset: 0x31C EPWM CMPDAT0~5 Buffer + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |CMPBUF |EPWM Comparator Register Buffer (Read Only) + * | | |Used as CMP active register. + * @var EPWM_T::CPSCBUF[3] + * Offset: 0x334 EPWM CLKPSC0_1/2_3/4_5 Buffer + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[11:0] |CPSCBUF |EPWM Counter Clock Prescale Buffer + * | | |Use as EPWM counter clock prescale active register. + * @var EPWM_T::FTCBUF[3] + * Offset: 0x340 EPWM FTCMPDAT0_1/2_3/4_5 Buffer + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |FTCMPBUF |EPWM FTCMPDAT Buffer (Read Only) + * | | |Used as FTCMPDAT active register. + * @var EPWM_T::FTCI + * Offset: 0x34C EPWM FTCMPDAT Indicator Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |FTCMU0 |EPWM FTCMPDAT Up Indicator + * | | |Indicator will be set to high when FTCMPDATn equal to CNTn and DIRF=1, software can write 1 to clear this bit. + * |[1] |FTCMU2 |EPWM FTCMPDAT Up Indicator + * | | |Indicator will be set to high when FTCMPDATn equal to CNTn and DIRF=1, software can write 1 to clear this bit. + * |[2] |FTCMU4 |EPWM FTCMPDAT Up Indicator + * | | |Indicator will be set to high when FTCMPDATn equal to CNTn and DIRF=1, software can write 1 to clear this bit. + * |[8] |FTCMD0 |EPWM FTCMPDAT Down Indicator + * | | |Indicator will be set to high when FTCMPDATn equal to CNTn and DIRF=0, software can write 1 to clear this bit. + * |[9] |FTCMD2 |EPWM FTCMPDAT Down Indicator + * | | |Indicator will be set to high when FTCMPDATn equal to CNTn and DIRF=0, software can write 1 to clear this bit. + * |[10] |FTCMD4 |EPWM FTCMPDAT Down Indicator + * | | |Indicator will be set to high when FTCMPDATn equal to CNTn and DIRF=0, software can write 1 to clear this bit. + */ + __IO uint32_t CTL0; /*!< [0x0000] EPWM Control Register 0 */ + __IO uint32_t CTL1; /*!< [0x0004] EPWM Control Register 1 */ + __IO uint32_t SYNC; /*!< [0x0008] EPWM Synchronization Register */ + __IO uint32_t SWSYNC; /*!< [0x000c] EPWM Software Control Synchronization Register */ + __IO uint32_t CLKSRC; /*!< [0x0010] EPWM Clock Source Register */ + __IO uint32_t CLKPSC[3]; /*!< [0x0014] EPWM Clock Prescale Register 0/1,2/3,4/5 */ + __IO uint32_t CNTEN; /*!< [0x0020] EPWM Counter Enable Register */ + __IO uint32_t CNTCLR; /*!< [0x0024] EPWM Clear Counter Register */ + __IO uint32_t LOAD; /*!< [0x0028] EPWM Load Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t PERIOD[6]; /*!< [0x0030] EPWM Period Register 0~5 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE1[2]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t CMPDAT[6]; /*!< [0x0050] EPWM Comparator Register 0~5 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE2[2]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t DTCTL[3]; /*!< [0x0070] EPWM Dead-Time Control Register 0/1,2/3,4/5 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE3[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t PHS[3]; /*!< [0x0080] EPWM Counter Phase Register 0/1,2/3,4/5 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE4[1]; + /// @endcond //HIDDEN_SYMBOLS + __I uint32_t CNT[6]; /*!< [0x0090] EPWM Counter Register 0~5 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE5[2]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t WGCTL0; /*!< [0x00b0] EPWM Generation Register 0 */ + __IO uint32_t WGCTL1; /*!< [0x00b4] EPWM Generation Register 1 */ + __IO uint32_t MSKEN; /*!< [0x00b8] EPWM Mask Enable Register */ + __IO uint32_t MSK; /*!< [0x00bc] EPWM Mask Data Register */ + __IO uint32_t BNF; /*!< [0x00c0] EPWM Brake Noise Filter Register */ + __IO uint32_t FAILBRK; /*!< [0x00c4] EPWM System Fail Brake Control Register */ + __IO uint32_t BRKCTL[3]; /*!< [0x00c8] EPWM Brake Edge Detect Control Register 0/1,2/3,4/5 */ + __IO uint32_t POLCTL; /*!< [0x00d4] EPWM Pin Polar Inverse Register */ + __IO uint32_t POEN; /*!< [0x00d8] EPWM Output Enable Register */ + __O uint32_t SWBRK; /*!< [0x00dc] EPWM Software Brake Control Register */ + __IO uint32_t INTEN0; /*!< [0x00e0] EPWM Interrupt Enable Register 0 */ + __IO uint32_t INTEN1; /*!< [0x00e4] EPWM Interrupt Enable Register 1 */ + __IO uint32_t INTSTS0; /*!< [0x00e8] EPWM Interrupt Flag Register 0 */ + __IO uint32_t INTSTS1; /*!< [0x00ec] EPWM Interrupt Flag Register 1 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE6[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t DACTRGEN; /*!< [0x00f4] EPWM Trigger DAC Enable Register */ + __IO uint32_t EADCTS0; /*!< [0x00f8] EPWM Trigger EADC Source Select Register 0 */ + __IO uint32_t EADCTS1; /*!< [0x00fc] EPWM Trigger EADC Source Select Register 1 */ + __IO uint32_t FTCMPDAT[3]; /*!< [0x0100] EPWM Free Trigger Compare Register 0/1,2/3,4/5 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE7[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t SSCTL; /*!< [0x0110] EPWM Synchronous Start Control Register */ + __O uint32_t SSTRG; /*!< [0x0114] EPWM Synchronous Start Trigger Register */ + __IO uint32_t LEBCTL; /*!< [0x0118] EPWM Leading Edge Blanking Control Register */ + __IO uint32_t LEBCNT; /*!< [0x011c] EPWM Leading Edge Blanking Counter Register */ + __IO uint32_t STATUS; /*!< [0x0120] EPWM Status Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE8[3]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t IFA[6]; /*!< [0x0130] EPWM Interrupt Flag Accumulator Register 0~5 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE9[2]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t AINTSTS; /*!< [0x0150] EPWM Accumulator Interrupt Flag Register */ + __IO uint32_t AINTEN; /*!< [0x0154] EPWM Accumulator Interrupt Enable Register */ + __IO uint32_t APDMACTL; /*!< [0x0158] EPWM Accumulator PDMA Control Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE10[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t FDEN; /*!< [0x0160] EPWM Fault Detect Enable Register */ + __IO uint32_t FDCTL[6]; /*!< [0x0164~0x178] EPWM Fault Detect Control Register 0~5 */ + __IO uint32_t FDIEN; /*!< [0x017C] EPWM Fault Detect Interrupt Enable Register */ + __IO uint32_t FDSTS; /*!< [0x0180] EPWM Fault Detect Interrupt Flag Register */ + __IO uint32_t EADCPSCCTL; /*!< [0x0184] EPWM Trigger EADC Prescale Control Register */ + __IO uint32_t EADCPSC0; /*!< [0x0188] EPWM Trigger EADC Prescale Register 0 */ + __IO uint32_t EADCPSC1; /*!< [0x018C] EPWM Trigger EADC Prescale Register 1 */ + __IO uint32_t EADCPSCNT0; /*!< [0x0190] EPWM Trigger EADC Prescale Counter Register 0 */ + __IO uint32_t EADCPSCNT1; /*!< [0x0194] EPWM Trigger EADC Prescale Counter Register 1 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE11[26]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t CAPINEN; /*!< [0x0200] EPWM Capture Input Enable Register */ + __IO uint32_t CAPCTL; /*!< [0x0204] EPWM Capture Control Register */ + __I uint32_t CAPSTS; /*!< [0x0208] EPWM Capture Status Register */ + ECAPDAT_T CAPDAT[6]; /*!< [0x020C] EPWM Rising and Falling Capture Data Register 0~5 */ + __IO uint32_t PDMACTL; /*!< [0x023c] EPWM PDMA Control Register */ + __I uint32_t PDMACAP[3]; /*!< [0x0240] EPWM Capture Channel 01,23,45 PDMA Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE12[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t CAPIEN; /*!< [0x0250] EPWM Capture Interrupt Enable Register */ + __IO uint32_t CAPIF; /*!< [0x0254] EPWM Capture Interrupt Flag Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE13[43]; + /// @endcond //HIDDEN_SYMBOLS + __I uint32_t PBUF[6]; /*!< [0x0304] EPWM PERIOD0~5 Buffer */ + __I uint32_t CMPBUF[6]; /*!< [0x031c] EPWM CMPDAT0~5 Buffer */ + __I uint32_t CPSCBUF[3]; /*!< [0x0334] EPWM CLKPSC0_1/2_3/4_5 Buffer */ + __I uint32_t FTCBUF[3]; /*!< [0x0340] EPWM FTCMPDAT0_1/2_3/4_5 Buffer */ + __IO uint32_t FTCI; /*!< [0x034c] EPWM FTCMPDAT Indicator Register */ + +} EPWM_T; + +/** + @addtogroup EPWM_CONST EPWM Bit Field Definition + Constant Definitions for EPWM Controller +@{ */ + +#define EPWM_CTL0_CTRLD0_Pos (0) /*!< EPWM_T::CTL0: CTRLD0 Position */ +#define EPWM_CTL0_CTRLD0_Msk (0x1ul << EPWM_CTL0_CTRLD0_Pos) /*!< EPWM_T::CTL0: CTRLD0 Mask */ + +#define EPWM_CTL0_CTRLD1_Pos (1) /*!< EPWM_T::CTL0: CTRLD1 Position */ +#define EPWM_CTL0_CTRLD1_Msk (0x1ul << EPWM_CTL0_CTRLD1_Pos) /*!< EPWM_T::CTL0: CTRLD1 Mask */ + +#define EPWM_CTL0_CTRLD2_Pos (2) /*!< EPWM_T::CTL0: CTRLD2 Position */ +#define EPWM_CTL0_CTRLD2_Msk (0x1ul << EPWM_CTL0_CTRLD2_Pos) /*!< EPWM_T::CTL0: CTRLD2 Mask */ + +#define EPWM_CTL0_CTRLD3_Pos (3) /*!< EPWM_T::CTL0: CTRLD3 Position */ +#define EPWM_CTL0_CTRLD3_Msk (0x1ul << EPWM_CTL0_CTRLD3_Pos) /*!< EPWM_T::CTL0: CTRLD3 Mask */ + +#define EPWM_CTL0_CTRLD4_Pos (4) /*!< EPWM_T::CTL0: CTRLD4 Position */ +#define EPWM_CTL0_CTRLD4_Msk (0x1ul << EPWM_CTL0_CTRLD4_Pos) /*!< EPWM_T::CTL0: CTRLD4 Mask */ + +#define EPWM_CTL0_CTRLD5_Pos (5) /*!< EPWM_T::CTL0: CTRLD5 Position */ +#define EPWM_CTL0_CTRLD5_Msk (0x1ul << EPWM_CTL0_CTRLD5_Pos) /*!< EPWM_T::CTL0: CTRLD5 Mask */ + +#define EPWM_CTL0_WINLDEN0_Pos (8) /*!< EPWM_T::CTL0: WINLDEN0 Position */ +#define EPWM_CTL0_WINLDEN0_Msk (0x1ul << EPWM_CTL0_WINLDEN0_Pos) /*!< EPWM_T::CTL0: WINLDEN0 Mask */ + +#define EPWM_CTL0_WINLDEN1_Pos (9) /*!< EPWM_T::CTL0: WINLDEN1 Position */ +#define EPWM_CTL0_WINLDEN1_Msk (0x1ul << EPWM_CTL0_WINLDEN1_Pos) /*!< EPWM_T::CTL0: WINLDEN1 Mask */ + +#define EPWM_CTL0_WINLDEN2_Pos (10) /*!< EPWM_T::CTL0: WINLDEN2 Position */ +#define EPWM_CTL0_WINLDEN2_Msk (0x1ul << EPWM_CTL0_WINLDEN2_Pos) /*!< EPWM_T::CTL0: WINLDEN2 Mask */ + +#define EPWM_CTL0_WINLDEN3_Pos (11) /*!< EPWM_T::CTL0: WINLDEN3 Position */ +#define EPWM_CTL0_WINLDEN3_Msk (0x1ul << EPWM_CTL0_WINLDEN3_Pos) /*!< EPWM_T::CTL0: WINLDEN3 Mask */ + +#define EPWM_CTL0_WINLDEN4_Pos (12) /*!< EPWM_T::CTL0: WINLDEN4 Position */ +#define EPWM_CTL0_WINLDEN4_Msk (0x1ul << EPWM_CTL0_WINLDEN4_Pos) /*!< EPWM_T::CTL0: WINLDEN4 Mask */ + +#define EPWM_CTL0_WINLDEN5_Pos (13) /*!< EPWM_T::CTL0: WINLDEN5 Position */ +#define EPWM_CTL0_WINLDEN5_Msk (0x1ul << EPWM_CTL0_WINLDEN5_Pos) /*!< EPWM_T::CTL0: WINLDEN5 Mask */ + +#define EPWM_CTL0_IMMLDEN0_Pos (16) /*!< EPWM_T::CTL0: IMMLDEN0 Position */ +#define EPWM_CTL0_IMMLDEN0_Msk (0x1ul << EPWM_CTL0_IMMLDEN0_Pos) /*!< EPWM_T::CTL0: IMMLDEN0 Mask */ + +#define EPWM_CTL0_IMMLDEN1_Pos (17) /*!< EPWM_T::CTL0: IMMLDEN1 Position */ +#define EPWM_CTL0_IMMLDEN1_Msk (0x1ul << EPWM_CTL0_IMMLDEN1_Pos) /*!< EPWM_T::CTL0: IMMLDEN1 Mask */ + +#define EPWM_CTL0_IMMLDEN2_Pos (18) /*!< EPWM_T::CTL0: IMMLDEN2 Position */ +#define EPWM_CTL0_IMMLDEN2_Msk (0x1ul << EPWM_CTL0_IMMLDEN2_Pos) /*!< EPWM_T::CTL0: IMMLDEN2 Mask */ + +#define EPWM_CTL0_IMMLDEN3_Pos (19) /*!< EPWM_T::CTL0: IMMLDEN3 Position */ +#define EPWM_CTL0_IMMLDEN3_Msk (0x1ul << EPWM_CTL0_IMMLDEN3_Pos) /*!< EPWM_T::CTL0: IMMLDEN3 Mask */ + +#define EPWM_CTL0_IMMLDEN4_Pos (20) /*!< EPWM_T::CTL0: IMMLDEN4 Position */ +#define EPWM_CTL0_IMMLDEN4_Msk (0x1ul << EPWM_CTL0_IMMLDEN4_Pos) /*!< EPWM_T::CTL0: IMMLDEN4 Mask */ + +#define EPWM_CTL0_IMMLDEN5_Pos (21) /*!< EPWM_T::CTL0: IMMLDEN5 Position */ +#define EPWM_CTL0_IMMLDEN5_Msk (0x1ul << EPWM_CTL0_IMMLDEN5_Pos) /*!< EPWM_T::CTL0: IMMLDEN5 Mask */ + +#define EPWM_CTL0_GROUPEN_Pos (24) /*!< EPWM_T::CTL0: GROUPEN Position */ +#define EPWM_CTL0_GROUPEN_Msk (0x1ul << EPWM_CTL0_GROUPEN_Pos) /*!< EPWM_T::CTL0: GROUPEN Mask */ + +#define EPWM_CTL0_DBGHALT_Pos (30) /*!< EPWM_T::CTL0: DBGHALT Position */ +#define EPWM_CTL0_DBGHALT_Msk (0x1ul << EPWM_CTL0_DBGHALT_Pos) /*!< EPWM_T::CTL0: DBGHALT Mask */ + +#define EPWM_CTL0_DBGTRIOFF_Pos (31) /*!< EPWM_T::CTL0: DBGTRIOFF Position */ +#define EPWM_CTL0_DBGTRIOFF_Msk (0x1ul << EPWM_CTL0_DBGTRIOFF_Pos) /*!< EPWM_T::CTL0: DBGTRIOFF Mask */ + +#define EPWM_CTL1_CNTTYPE0_Pos (0) /*!< EPWM_T::CTL1: CNTTYPE0 Position */ +#define EPWM_CTL1_CNTTYPE0_Msk (0x3ul << EPWM_CTL1_CNTTYPE0_Pos) /*!< EPWM_T::CTL1: CNTTYPE0 Mask */ + +#define EPWM_CTL1_CNTTYPE1_Pos (2) /*!< EPWM_T::CTL1: CNTTYPE1 Position */ +#define EPWM_CTL1_CNTTYPE1_Msk (0x3ul << EPWM_CTL1_CNTTYPE1_Pos) /*!< EPWM_T::CTL1: CNTTYPE1 Mask */ + +#define EPWM_CTL1_CNTTYPE2_Pos (4) /*!< EPWM_T::CTL1: CNTTYPE2 Position */ +#define EPWM_CTL1_CNTTYPE2_Msk (0x3ul << EPWM_CTL1_CNTTYPE2_Pos) /*!< EPWM_T::CTL1: CNTTYPE2 Mask */ + +#define EPWM_CTL1_CNTTYPE3_Pos (6) /*!< EPWM_T::CTL1: CNTTYPE3 Position */ +#define EPWM_CTL1_CNTTYPE3_Msk (0x3ul << EPWM_CTL1_CNTTYPE3_Pos) /*!< EPWM_T::CTL1: CNTTYPE3 Mask */ + +#define EPWM_CTL1_CNTTYPE4_Pos (8) /*!< EPWM_T::CTL1: CNTTYPE4 Position */ +#define EPWM_CTL1_CNTTYPE4_Msk (0x3ul << EPWM_CTL1_CNTTYPE4_Pos) /*!< EPWM_T::CTL1: CNTTYPE4 Mask */ + +#define EPWM_CTL1_CNTTYPE5_Pos (10) /*!< EPWM_T::CTL1: CNTTYPE5 Position */ +#define EPWM_CTL1_CNTTYPE5_Msk (0x3ul << EPWM_CTL1_CNTTYPE5_Pos) /*!< EPWM_T::CTL1: CNTTYPE5 Mask */ + +#define EPWM_CTL1_CNTMODE0_Pos (16) /*!< EPWM_T::CTL1: CNTMODE0 Position */ +#define EPWM_CTL1_CNTMODE0_Msk (0x1ul << EPWM_CTL1_CNTMODE0_Pos) /*!< EPWM_T::CTL1: CNTMODE0 Mask */ + +#define EPWM_CTL1_CNTMODE1_Pos (17) /*!< EPWM_T::CTL1: CNTMODE1 Position */ +#define EPWM_CTL1_CNTMODE1_Msk (0x1ul << EPWM_CTL1_CNTMODE1_Pos) /*!< EPWM_T::CTL1: CNTMODE1 Mask */ + +#define EPWM_CTL1_CNTMODE2_Pos (18) /*!< EPWM_T::CTL1: CNTMODE2 Position */ +#define EPWM_CTL1_CNTMODE2_Msk (0x1ul << EPWM_CTL1_CNTMODE2_Pos) /*!< EPWM_T::CTL1: CNTMODE2 Mask */ + +#define EPWM_CTL1_CNTMODE3_Pos (19) /*!< EPWM_T::CTL1: CNTMODE3 Position */ +#define EPWM_CTL1_CNTMODE3_Msk (0x1ul << EPWM_CTL1_CNTMODE3_Pos) /*!< EPWM_T::CTL1: CNTMODE3 Mask */ + +#define EPWM_CTL1_CNTMODE4_Pos (20) /*!< EPWM_T::CTL1: CNTMODE4 Position */ +#define EPWM_CTL1_CNTMODE4_Msk (0x1ul << EPWM_CTL1_CNTMODE4_Pos) /*!< EPWM_T::CTL1: CNTMODE4 Mask */ + +#define EPWM_CTL1_CNTMODE5_Pos (21) /*!< EPWM_T::CTL1: CNTMODE5 Position */ +#define EPWM_CTL1_CNTMODE5_Msk (0x1ul << EPWM_CTL1_CNTMODE5_Pos) /*!< EPWM_T::CTL1: CNTMODE5 Mask */ + +#define EPWM_CTL1_OUTMODE0_Pos (24) /*!< EPWM_T::CTL1: OUTMODE0 Position */ +#define EPWM_CTL1_OUTMODE0_Msk (0x1ul << EPWM_CTL1_OUTMODE0_Pos) /*!< EPWM_T::CTL1: OUTMODE0 Mask */ + +#define EPWM_CTL1_OUTMODE2_Pos (25) /*!< EPWM_T::CTL1: OUTMODE2 Position */ +#define EPWM_CTL1_OUTMODE2_Msk (0x1ul << EPWM_CTL1_OUTMODE2_Pos) /*!< EPWM_T::CTL1: OUTMODE2 Mask */ + +#define EPWM_CTL1_OUTMODE4_Pos (26) /*!< EPWM_T::CTL1: OUTMODE4 Position */ +#define EPWM_CTL1_OUTMODE4_Msk (0x1ul << EPWM_CTL1_OUTMODE4_Pos) /*!< EPWM_T::CTL1: OUTMODE4 Mask */ + +#define EPWM_SYNC_PHSEN0_Pos (0) /*!< EPWM_T::SYNC: PHSEN0 Position */ +#define EPWM_SYNC_PHSEN0_Msk (0x1ul << EPWM_SYNC_PHSEN0_Pos) /*!< EPWM_T::SYNC: PHSEN0 Mask */ + +#define EPWM_SYNC_PHSEN2_Pos (1) /*!< EPWM_T::SYNC: PHSEN2 Position */ +#define EPWM_SYNC_PHSEN2_Msk (0x1ul << EPWM_SYNC_PHSEN2_Pos) /*!< EPWM_T::SYNC: PHSEN2 Mask */ + +#define EPWM_SYNC_PHSEN4_Pos (2) /*!< EPWM_T::SYNC: PHSEN4 Position */ +#define EPWM_SYNC_PHSEN4_Msk (0x1ul << EPWM_SYNC_PHSEN4_Pos) /*!< EPWM_T::SYNC: PHSEN4 Mask */ + +#define EPWM_SYNC_SINSRC0_Pos (8) /*!< EPWM_T::SYNC: SINSRC0 Position */ +#define EPWM_SYNC_SINSRC0_Msk (0x3ul << EPWM_SYNC_SINSRC0_Pos) /*!< EPWM_T::SYNC: SINSRC0 Mask */ + +#define EPWM_SYNC_SINSRC2_Pos (10) /*!< EPWM_T::SYNC: SINSRC2 Position */ +#define EPWM_SYNC_SINSRC2_Msk (0x3ul << EPWM_SYNC_SINSRC2_Pos) /*!< EPWM_T::SYNC: SINSRC2 Mask */ + +#define EPWM_SYNC_SINSRC4_Pos (12) /*!< EPWM_T::SYNC: SINSRC4 Position */ +#define EPWM_SYNC_SINSRC4_Msk (0x3ul << EPWM_SYNC_SINSRC4_Pos) /*!< EPWM_T::SYNC: SINSRC4 Mask */ + +#define EPWM_SYNC_SNFLTEN_Pos (16) /*!< EPWM_T::SYNC: SNFLTEN Position */ +#define EPWM_SYNC_SNFLTEN_Msk (0x1ul << EPWM_SYNC_SNFLTEN_Pos) /*!< EPWM_T::SYNC: SNFLTEN Mask */ + +#define EPWM_SYNC_SFLTCSEL_Pos (17) /*!< EPWM_T::SYNC: SFLTCSEL Position */ +#define EPWM_SYNC_SFLTCSEL_Msk (0x7ul << EPWM_SYNC_SFLTCSEL_Pos) /*!< EPWM_T::SYNC: SFLTCSEL Mask */ + +#define EPWM_SYNC_SFLTCNT_Pos (20) /*!< EPWM_T::SYNC: SFLTCNT Position */ +#define EPWM_SYNC_SFLTCNT_Msk (0x7ul << EPWM_SYNC_SFLTCNT_Pos) /*!< EPWM_T::SYNC: SFLTCNT Mask */ + +#define EPWM_SYNC_SINPINV_Pos (23) /*!< EPWM_T::SYNC: SINPINV Position */ +#define EPWM_SYNC_SINPINV_Msk (0x1ul << EPWM_SYNC_SINPINV_Pos) /*!< EPWM_T::SYNC: SINPINV Mask */ + +#define EPWM_SYNC_PHSDIR0_Pos (24) /*!< EPWM_T::SYNC: PHSDIR0 Position */ +#define EPWM_SYNC_PHSDIR0_Msk (0x1ul << EPWM_SYNC_PHSDIR0_Pos) /*!< EPWM_T::SYNC: PHSDIR0 Mask */ + +#define EPWM_SYNC_PHSDIR2_Pos (25) /*!< EPWM_T::SYNC: PHSDIR2 Position */ +#define EPWM_SYNC_PHSDIR2_Msk (0x1ul << EPWM_SYNC_PHSDIR2_Pos) /*!< EPWM_T::SYNC: PHSDIR2 Mask */ + +#define EPWM_SYNC_PHSDIR4_Pos (26) /*!< EPWM_T::SYNC: PHSDIR4 Position */ +#define EPWM_SYNC_PHSDIR4_Msk (0x1ul << EPWM_SYNC_PHSDIR4_Pos) /*!< EPWM_T::SYNC: PHSDIR4 Mask */ + +#define EPWM_SWSYNC_SWSYNC0_Pos (0) /*!< EPWM_T::SWSYNC: SWSYNC0 Position */ +#define EPWM_SWSYNC_SWSYNC0_Msk (0x1ul << EPWM_SWSYNC_SWSYNC0_Pos) /*!< EPWM_T::SWSYNC: SWSYNC0 Mask */ + +#define EPWM_SWSYNC_SWSYNC2_Pos (1) /*!< EPWM_T::SWSYNC: SWSYNC2 Position */ +#define EPWM_SWSYNC_SWSYNC2_Msk (0x1ul << EPWM_SWSYNC_SWSYNC2_Pos) /*!< EPWM_T::SWSYNC: SWSYNC2 Mask */ + +#define EPWM_SWSYNC_SWSYNC4_Pos (2) /*!< EPWM_T::SWSYNC: SWSYNC4 Position */ +#define EPWM_SWSYNC_SWSYNC4_Msk (0x1ul << EPWM_SWSYNC_SWSYNC4_Pos) /*!< EPWM_T::SWSYNC: SWSYNC4 Mask */ + +#define EPWM_CLKSRC_ECLKSRC0_Pos (0) /*!< EPWM_T::CLKSRC: ECLKSRC0 Position */ +#define EPWM_CLKSRC_ECLKSRC0_Msk (0x7ul << EPWM_CLKSRC_ECLKSRC0_Pos) /*!< EPWM_T::CLKSRC: ECLKSRC0 Mask */ + +#define EPWM_CLKSRC_ECLKSRC2_Pos (8) /*!< EPWM_T::CLKSRC: ECLKSRC2 Position */ +#define EPWM_CLKSRC_ECLKSRC2_Msk (0x7ul << EPWM_CLKSRC_ECLKSRC2_Pos) /*!< EPWM_T::CLKSRC: ECLKSRC2 Mask */ + +#define EPWM_CLKSRC_ECLKSRC4_Pos (16) /*!< EPWM_T::CLKSRC: ECLKSRC4 Position */ +#define EPWM_CLKSRC_ECLKSRC4_Msk (0x7ul << EPWM_CLKSRC_ECLKSRC4_Pos) /*!< EPWM_T::CLKSRC: ECLKSRC4 Mask */ + +#define EPWM_CLKPSC0_1_CLKPSC_Pos (0) /*!< EPWM_T::CLKPSC0_1: CLKPSC Position */ +#define EPWM_CLKPSC0_1_CLKPSC_Msk (0xffful << EPWM_CLKPSC0_1_CLKPSC_Pos) /*!< EPWM_T::CLKPSC0_1: CLKPSC Mask */ + +#define EPWM_CLKPSC2_3_CLKPSC_Pos (0) /*!< EPWM_T::CLKPSC2_3: CLKPSC Position */ +#define EPWM_CLKPSC2_3_CLKPSC_Msk (0xffful << EPWM_CLKPSC2_3_CLKPSC_Pos) /*!< EPWM_T::CLKPSC2_3: CLKPSC Mask */ + +#define EPWM_CLKPSC4_5_CLKPSC_Pos (0) /*!< EPWM_T::CLKPSC4_5: CLKPSC Position */ +#define EPWM_CLKPSC4_5_CLKPSC_Msk (0xffful << EPWM_CLKPSC4_5_CLKPSC_Pos) /*!< EPWM_T::CLKPSC4_5: CLKPSC Mask */ + +#define EPWM_CNTEN_CNTEN0_Pos (0) /*!< EPWM_T::CNTEN: CNTEN0 Position */ +#define EPWM_CNTEN_CNTEN0_Msk (0x1ul << EPWM_CNTEN_CNTEN0_Pos) /*!< EPWM_T::CNTEN: CNTEN0 Mask */ + +#define EPWM_CNTEN_CNTEN1_Pos (1) /*!< EPWM_T::CNTEN: CNTEN1 Position */ +#define EPWM_CNTEN_CNTEN1_Msk (0x1ul << EPWM_CNTEN_CNTEN1_Pos) /*!< EPWM_T::CNTEN: CNTEN1 Mask */ + +#define EPWM_CNTEN_CNTEN2_Pos (2) /*!< EPWM_T::CNTEN: CNTEN2 Position */ +#define EPWM_CNTEN_CNTEN2_Msk (0x1ul << EPWM_CNTEN_CNTEN2_Pos) /*!< EPWM_T::CNTEN: CNTEN2 Mask */ + +#define EPWM_CNTEN_CNTEN3_Pos (3) /*!< EPWM_T::CNTEN: CNTEN3 Position */ +#define EPWM_CNTEN_CNTEN3_Msk (0x1ul << EPWM_CNTEN_CNTEN3_Pos) /*!< EPWM_T::CNTEN: CNTEN3 Mask */ + +#define EPWM_CNTEN_CNTEN4_Pos (4) /*!< EPWM_T::CNTEN: CNTEN4 Position */ +#define EPWM_CNTEN_CNTEN4_Msk (0x1ul << EPWM_CNTEN_CNTEN4_Pos) /*!< EPWM_T::CNTEN: CNTEN4 Mask */ + +#define EPWM_CNTEN_CNTEN5_Pos (5) /*!< EPWM_T::CNTEN: CNTEN5 Position */ +#define EPWM_CNTEN_CNTEN5_Msk (0x1ul << EPWM_CNTEN_CNTEN5_Pos) /*!< EPWM_T::CNTEN: CNTEN5 Mask */ + +#define EPWM_CNTCLR_CNTCLR0_Pos (0) /*!< EPWM_T::CNTCLR: CNTCLR0 Position */ +#define EPWM_CNTCLR_CNTCLR0_Msk (0x1ul << EPWM_CNTCLR_CNTCLR0_Pos) /*!< EPWM_T::CNTCLR: CNTCLR0 Mask */ + +#define EPWM_CNTCLR_CNTCLR1_Pos (1) /*!< EPWM_T::CNTCLR: CNTCLR1 Position */ +#define EPWM_CNTCLR_CNTCLR1_Msk (0x1ul << EPWM_CNTCLR_CNTCLR1_Pos) /*!< EPWM_T::CNTCLR: CNTCLR1 Mask */ + +#define EPWM_CNTCLR_CNTCLR2_Pos (2) /*!< EPWM_T::CNTCLR: CNTCLR2 Position */ +#define EPWM_CNTCLR_CNTCLR2_Msk (0x1ul << EPWM_CNTCLR_CNTCLR2_Pos) /*!< EPWM_T::CNTCLR: CNTCLR2 Mask */ + +#define EPWM_CNTCLR_CNTCLR3_Pos (3) /*!< EPWM_T::CNTCLR: CNTCLR3 Position */ +#define EPWM_CNTCLR_CNTCLR3_Msk (0x1ul << EPWM_CNTCLR_CNTCLR3_Pos) /*!< EPWM_T::CNTCLR: CNTCLR3 Mask */ + +#define EPWM_CNTCLR_CNTCLR4_Pos (4) /*!< EPWM_T::CNTCLR: CNTCLR4 Position */ +#define EPWM_CNTCLR_CNTCLR4_Msk (0x1ul << EPWM_CNTCLR_CNTCLR4_Pos) /*!< EPWM_T::CNTCLR: CNTCLR4 Mask */ + +#define EPWM_CNTCLR_CNTCLR5_Pos (5) /*!< EPWM_T::CNTCLR: CNTCLR5 Position */ +#define EPWM_CNTCLR_CNTCLR5_Msk (0x1ul << EPWM_CNTCLR_CNTCLR5_Pos) /*!< EPWM_T::CNTCLR: CNTCLR5 Mask */ + +#define EPWM_LOAD_LOAD0_Pos (0) /*!< EPWM_T::LOAD: LOAD0 Position */ +#define EPWM_LOAD_LOAD0_Msk (0x1ul << EPWM_LOAD_LOAD0_Pos) /*!< EPWM_T::LOAD: LOAD0 Mask */ + +#define EPWM_LOAD_LOAD1_Pos (1) /*!< EPWM_T::LOAD: LOAD1 Position */ +#define EPWM_LOAD_LOAD1_Msk (0x1ul << EPWM_LOAD_LOAD1_Pos) /*!< EPWM_T::LOAD: LOAD1 Mask */ + +#define EPWM_LOAD_LOAD2_Pos (2) /*!< EPWM_T::LOAD: LOAD2 Position */ +#define EPWM_LOAD_LOAD2_Msk (0x1ul << EPWM_LOAD_LOAD2_Pos) /*!< EPWM_T::LOAD: LOAD2 Mask */ + +#define EPWM_LOAD_LOAD3_Pos (3) /*!< EPWM_T::LOAD: LOAD3 Position */ +#define EPWM_LOAD_LOAD3_Msk (0x1ul << EPWM_LOAD_LOAD3_Pos) /*!< EPWM_T::LOAD: LOAD3 Mask */ + +#define EPWM_LOAD_LOAD4_Pos (4) /*!< EPWM_T::LOAD: LOAD4 Position */ +#define EPWM_LOAD_LOAD4_Msk (0x1ul << EPWM_LOAD_LOAD4_Pos) /*!< EPWM_T::LOAD: LOAD4 Mask */ + +#define EPWM_LOAD_LOAD5_Pos (5) /*!< EPWM_T::LOAD: LOAD5 Position */ +#define EPWM_LOAD_LOAD5_Msk (0x1ul << EPWM_LOAD_LOAD5_Pos) /*!< EPWM_T::LOAD: LOAD5 Mask */ + +#define EPWM_PERIOD0_PERIOD_Pos (0) /*!< EPWM_T::PERIOD0: PERIOD Position */ +#define EPWM_PERIOD0_PERIOD_Msk (0xfffful << EPWM_PERIOD0_PERIOD_Pos) /*!< EPWM_T::PERIOD0: PERIOD Mask */ + +#define EPWM_PERIOD1_PERIOD_Pos (0) /*!< EPWM_T::PERIOD1: PERIOD Position */ +#define EPWM_PERIOD1_PERIOD_Msk (0xfffful << EPWM_PERIOD1_PERIOD_Pos) /*!< EPWM_T::PERIOD1: PERIOD Mask */ + +#define EPWM_PERIOD2_PERIOD_Pos (0) /*!< EPWM_T::PERIOD2: PERIOD Position */ +#define EPWM_PERIOD2_PERIOD_Msk (0xfffful << EPWM_PERIOD2_PERIOD_Pos) /*!< EPWM_T::PERIOD2: PERIOD Mask */ + +#define EPWM_PERIOD3_PERIOD_Pos (0) /*!< EPWM_T::PERIOD3: PERIOD Position */ +#define EPWM_PERIOD3_PERIOD_Msk (0xfffful << EPWM_PERIOD3_PERIOD_Pos) /*!< EPWM_T::PERIOD3: PERIOD Mask */ + +#define EPWM_PERIOD4_PERIOD_Pos (0) /*!< EPWM_T::PERIOD4: PERIOD Position */ +#define EPWM_PERIOD4_PERIOD_Msk (0xfffful << EPWM_PERIOD4_PERIOD_Pos) /*!< EPWM_T::PERIOD4: PERIOD Mask */ + +#define EPWM_PERIOD5_PERIOD_Pos (0) /*!< EPWM_T::PERIOD5: PERIOD Position */ +#define EPWM_PERIOD5_PERIOD_Msk (0xfffful << EPWM_PERIOD5_PERIOD_Pos) /*!< EPWM_T::PERIOD5: PERIOD Mask */ + +#define EPWM_CMPDAT0_CMP_Pos (0) /*!< EPWM_T::CMPDAT0: CMP Position */ +#define EPWM_CMPDAT0_CMP_Msk (0xfffful << EPWM_CMPDAT0_CMP_Pos) /*!< EPWM_T::CMPDAT0: CMP Mask */ + +#define EPWM_CMPDAT1_CMP_Pos (0) /*!< EPWM_T::CMPDAT1: CMP Position */ +#define EPWM_CMPDAT1_CMP_Msk (0xfffful << EPWM_CMPDAT1_CMP_Pos) /*!< EPWM_T::CMPDAT1: CMP Mask */ + +#define EPWM_CMPDAT2_CMP_Pos (0) /*!< EPWM_T::CMPDAT2: CMP Position */ +#define EPWM_CMPDAT2_CMP_Msk (0xfffful << EPWM_CMPDAT2_CMP_Pos) /*!< EPWM_T::CMPDAT2: CMP Mask */ + +#define EPWM_CMPDAT3_CMP_Pos (0) /*!< EPWM_T::CMPDAT3: CMP Position */ +#define EPWM_CMPDAT3_CMP_Msk (0xfffful << EPWM_CMPDAT3_CMP_Pos) /*!< EPWM_T::CMPDAT3: CMP Mask */ + +#define EPWM_CMPDAT4_CMP_Pos (0) /*!< EPWM_T::CMPDAT4: CMP Position */ +#define EPWM_CMPDAT4_CMP_Msk (0xfffful << EPWM_CMPDAT4_CMP_Pos) /*!< EPWM_T::CMPDAT4: CMP Mask */ + +#define EPWM_CMPDAT5_CMP_Pos (0) /*!< EPWM_T::CMPDAT5: CMP Position */ +#define EPWM_CMPDAT5_CMP_Msk (0xfffful << EPWM_CMPDAT5_CMP_Pos) /*!< EPWM_T::CMPDAT5: CMP Mask */ + +#define EPWM_DTCTL0_1_DTCNT_Pos (0) /*!< EPWM_T::DTCTL0_1: DTCNT Position */ +#define EPWM_DTCTL0_1_DTCNT_Msk (0xffful << EPWM_DTCTL0_1_DTCNT_Pos) /*!< EPWM_T::DTCTL0_1: DTCNT Mask */ + +#define EPWM_DTCTL0_1_DTEN_Pos (16) /*!< EPWM_T::DTCTL0_1: DTEN Position */ +#define EPWM_DTCTL0_1_DTEN_Msk (0x1ul << EPWM_DTCTL0_1_DTEN_Pos) /*!< EPWM_T::DTCTL0_1: DTEN Mask */ + +#define EPWM_DTCTL0_1_DTCKSEL_Pos (24) /*!< EPWM_T::DTCTL0_1: DTCKSEL Position */ +#define EPWM_DTCTL0_1_DTCKSEL_Msk (0x1ul << EPWM_DTCTL0_1_DTCKSEL_Pos) /*!< EPWM_T::DTCTL0_1: DTCKSEL Mask */ + +#define EPWM_DTCTL2_3_DTCNT_Pos (0) /*!< EPWM_T::DTCTL2_3: DTCNT Position */ +#define EPWM_DTCTL2_3_DTCNT_Msk (0xffful << EPWM_DTCTL2_3_DTCNT_Pos) /*!< EPWM_T::DTCTL2_3: DTCNT Mask */ + +#define EPWM_DTCTL2_3_DTEN_Pos (16) /*!< EPWM_T::DTCTL2_3: DTEN Position */ +#define EPWM_DTCTL2_3_DTEN_Msk (0x1ul << EPWM_DTCTL2_3_DTEN_Pos) /*!< EPWM_T::DTCTL2_3: DTEN Mask */ + +#define EPWM_DTCTL2_3_DTCKSEL_Pos (24) /*!< EPWM_T::DTCTL2_3: DTCKSEL Position */ +#define EPWM_DTCTL2_3_DTCKSEL_Msk (0x1ul << EPWM_DTCTL2_3_DTCKSEL_Pos) /*!< EPWM_T::DTCTL2_3: DTCKSEL Mask */ + +#define EPWM_DTCTL4_5_DTCNT_Pos (0) /*!< EPWM_T::DTCTL4_5: DTCNT Position */ +#define EPWM_DTCTL4_5_DTCNT_Msk (0xffful << EPWM_DTCTL4_5_DTCNT_Pos) /*!< EPWM_T::DTCTL4_5: DTCNT Mask */ + +#define EPWM_DTCTL4_5_DTEN_Pos (16) /*!< EPWM_T::DTCTL4_5: DTEN Position */ +#define EPWM_DTCTL4_5_DTEN_Msk (0x1ul << EPWM_DTCTL4_5_DTEN_Pos) /*!< EPWM_T::DTCTL4_5: DTEN Mask */ + +#define EPWM_DTCTL4_5_DTCKSEL_Pos (24) /*!< EPWM_T::DTCTL4_5: DTCKSEL Position */ +#define EPWM_DTCTL4_5_DTCKSEL_Msk (0x1ul << EPWM_DTCTL4_5_DTCKSEL_Pos) /*!< EPWM_T::DTCTL4_5: DTCKSEL Mask */ + +#define EPWM_PHS0_1_PHS_Pos (0) /*!< EPWM_T::PHS0_1: PHS Position */ +#define EPWM_PHS0_1_PHS_Msk (0xfffful << EPWM_PHS0_1_PHS_Pos) /*!< EPWM_T::PHS0_1: PHS Mask */ + +#define EPWM_PHS2_3_PHS_Pos (0) /*!< EPWM_T::PHS2_3: PHS Position */ +#define EPWM_PHS2_3_PHS_Msk (0xfffful << EPWM_PHS2_3_PHS_Pos) /*!< EPWM_T::PHS2_3: PHS Mask */ + +#define EPWM_PHS4_5_PHS_Pos (0) /*!< EPWM_T::PHS4_5: PHS Position */ +#define EPWM_PHS4_5_PHS_Msk (0xfffful << EPWM_PHS4_5_PHS_Pos) /*!< EPWM_T::PHS4_5: PHS Mask */ + +#define EPWM_CNT0_CNT_Pos (0) /*!< EPWM_T::CNT0: CNT Position */ +#define EPWM_CNT0_CNT_Msk (0xfffful << EPWM_CNT0_CNT_Pos) /*!< EPWM_T::CNT0: CNT Mask */ + +#define EPWM_CNT0_DIRF_Pos (16) /*!< EPWM_T::CNT0: DIRF Position */ +#define EPWM_CNT0_DIRF_Msk (0x1ul << EPWM_CNT0_DIRF_Pos) /*!< EPWM_T::CNT0: DIRF Mask */ + +#define EPWM_CNT1_CNT_Pos (0) /*!< EPWM_T::CNT1: CNT Position */ +#define EPWM_CNT1_CNT_Msk (0xfffful << EPWM_CNT1_CNT_Pos) /*!< EPWM_T::CNT1: CNT Mask */ + +#define EPWM_CNT1_DIRF_Pos (16) /*!< EPWM_T::CNT1: DIRF Position */ +#define EPWM_CNT1_DIRF_Msk (0x1ul << EPWM_CNT1_DIRF_Pos) /*!< EPWM_T::CNT1: DIRF Mask */ + +#define EPWM_CNT2_CNT_Pos (0) /*!< EPWM_T::CNT2: CNT Position */ +#define EPWM_CNT2_CNT_Msk (0xfffful << EPWM_CNT2_CNT_Pos) /*!< EPWM_T::CNT2: CNT Mask */ + +#define EPWM_CNT2_DIRF_Pos (16) /*!< EPWM_T::CNT2: DIRF Position */ +#define EPWM_CNT2_DIRF_Msk (0x1ul << EPWM_CNT2_DIRF_Pos) /*!< EPWM_T::CNT2: DIRF Mask */ + +#define EPWM_CNT3_CNT_Pos (0) /*!< EPWM_T::CNT3: CNT Position */ +#define EPWM_CNT3_CNT_Msk (0xfffful << EPWM_CNT3_CNT_Pos) /*!< EPWM_T::CNT3: CNT Mask */ + +#define EPWM_CNT3_DIRF_Pos (16) /*!< EPWM_T::CNT3: DIRF Position */ +#define EPWM_CNT3_DIRF_Msk (0x1ul << EPWM_CNT3_DIRF_Pos) /*!< EPWM_T::CNT3: DIRF Mask */ + +#define EPWM_CNT4_CNT_Pos (0) /*!< EPWM_T::CNT4: CNT Position */ +#define EPWM_CNT4_CNT_Msk (0xfffful << EPWM_CNT4_CNT_Pos) /*!< EPWM_T::CNT4: CNT Mask */ + +#define EPWM_CNT4_DIRF_Pos (16) /*!< EPWM_T::CNT4: DIRF Position */ +#define EPWM_CNT4_DIRF_Msk (0x1ul << EPWM_CNT4_DIRF_Pos) /*!< EPWM_T::CNT4: DIRF Mask */ + +#define EPWM_CNT5_CNT_Pos (0) /*!< EPWM_T::CNT5: CNT Position */ +#define EPWM_CNT5_CNT_Msk (0xfffful << EPWM_CNT5_CNT_Pos) /*!< EPWM_T::CNT5: CNT Mask */ + +#define EPWM_CNT5_DIRF_Pos (16) /*!< EPWM_T::CNT5: DIRF Position */ +#define EPWM_CNT5_DIRF_Msk (0x1ul << EPWM_CNT5_DIRF_Pos) /*!< EPWM_T::CNT5: DIRF Mask */ + +#define EPWM_WGCTL0_ZPCTL0_Pos (0) /*!< EPWM_T::WGCTL0: ZPCTL0 Position */ +#define EPWM_WGCTL0_ZPCTL0_Msk (0x3ul << EPWM_WGCTL0_ZPCTL0_Pos) /*!< EPWM_T::WGCTL0: ZPCTL0 Mask */ + +#define EPWM_WGCTL0_ZPCTL1_Pos (2) /*!< EPWM_T::WGCTL0: ZPCTL1 Position */ +#define EPWM_WGCTL0_ZPCTL1_Msk (0x3ul << EPWM_WGCTL0_ZPCTL1_Pos) /*!< EPWM_T::WGCTL0: ZPCTL1 Mask */ + +#define EPWM_WGCTL0_ZPCTL2_Pos (4) /*!< EPWM_T::WGCTL0: ZPCTL2 Position */ +#define EPWM_WGCTL0_ZPCTL2_Msk (0x3ul << EPWM_WGCTL0_ZPCTL2_Pos) /*!< EPWM_T::WGCTL0: ZPCTL2 Mask */ + +#define EPWM_WGCTL0_ZPCTL3_Pos (6) /*!< EPWM_T::WGCTL0: ZPCTL3 Position */ +#define EPWM_WGCTL0_ZPCTL3_Msk (0x3ul << EPWM_WGCTL0_ZPCTL3_Pos) /*!< EPWM_T::WGCTL0: ZPCTL3 Mask */ + +#define EPWM_WGCTL0_ZPCTL4_Pos (8) /*!< EPWM_T::WGCTL0: ZPCTL4 Position */ +#define EPWM_WGCTL0_ZPCTL4_Msk (0x3ul << EPWM_WGCTL0_ZPCTL4_Pos) /*!< EPWM_T::WGCTL0: ZPCTL4 Mask */ + +#define EPWM_WGCTL0_ZPCTL5_Pos (10) /*!< EPWM_T::WGCTL0: ZPCTL5 Position */ +#define EPWM_WGCTL0_ZPCTL5_Msk (0x3ul << EPWM_WGCTL0_ZPCTL5_Pos) /*!< EPWM_T::WGCTL0: ZPCTL5 Mask */ + +#define EPWM_WGCTL0_PRDPCTL0_Pos (16) /*!< EPWM_T::WGCTL0: PRDPCTL0 Position */ +#define EPWM_WGCTL0_PRDPCTL0_Msk (0x3ul << EPWM_WGCTL0_PRDPCTL0_Pos) /*!< EPWM_T::WGCTL0: PRDPCTL0 Mask */ + +#define EPWM_WGCTL0_PRDPCTL1_Pos (18) /*!< EPWM_T::WGCTL0: PRDPCTL1 Position */ +#define EPWM_WGCTL0_PRDPCTL1_Msk (0x3ul << EPWM_WGCTL0_PRDPCTL1_Pos) /*!< EPWM_T::WGCTL0: PRDPCTL1 Mask */ + +#define EPWM_WGCTL0_PRDPCTL2_Pos (20) /*!< EPWM_T::WGCTL0: PRDPCTL2 Position */ +#define EPWM_WGCTL0_PRDPCTL2_Msk (0x3ul << EPWM_WGCTL0_PRDPCTL2_Pos) /*!< EPWM_T::WGCTL0: PRDPCTL2 Mask */ + +#define EPWM_WGCTL0_PRDPCTL3_Pos (22) /*!< EPWM_T::WGCTL0: PRDPCTL3 Position */ +#define EPWM_WGCTL0_PRDPCTL3_Msk (0x3ul << EPWM_WGCTL0_PRDPCTL3_Pos) /*!< EPWM_T::WGCTL0: PRDPCTL3 Mask */ + +#define EPWM_WGCTL0_PRDPCTL4_Pos (24) /*!< EPWM_T::WGCTL0: PRDPCTL4 Position */ +#define EPWM_WGCTL0_PRDPCTL4_Msk (0x3ul << EPWM_WGCTL0_PRDPCTL4_Pos) /*!< EPWM_T::WGCTL0: PRDPCTL4 Mask */ + +#define EPWM_WGCTL0_PRDPCTL5_Pos (26) /*!< EPWM_T::WGCTL0: PRDPCTL5 Position */ +#define EPWM_WGCTL0_PRDPCTL5_Msk (0x3ul << EPWM_WGCTL0_PRDPCTL5_Pos) /*!< EPWM_T::WGCTL0: PRDPCTL5 Mask */ + +#define EPWM_WGCTL1_CMPUCTL0_Pos (0) /*!< EPWM_T::WGCTL1: CMPUCTL0 Position */ +#define EPWM_WGCTL1_CMPUCTL0_Msk (0x3ul << EPWM_WGCTL1_CMPUCTL0_Pos) /*!< EPWM_T::WGCTL1: CMPUCTL0 Mask */ + +#define EPWM_WGCTL1_CMPUCTL1_Pos (2) /*!< EPWM_T::WGCTL1: CMPUCTL1 Position */ +#define EPWM_WGCTL1_CMPUCTL1_Msk (0x3ul << EPWM_WGCTL1_CMPUCTL1_Pos) /*!< EPWM_T::WGCTL1: CMPUCTL1 Mask */ + +#define EPWM_WGCTL1_CMPUCTL2_Pos (4) /*!< EPWM_T::WGCTL1: CMPUCTL2 Position */ +#define EPWM_WGCTL1_CMPUCTL2_Msk (0x3ul << EPWM_WGCTL1_CMPUCTL2_Pos) /*!< EPWM_T::WGCTL1: CMPUCTL2 Mask */ + +#define EPWM_WGCTL1_CMPUCTL3_Pos (6) /*!< EPWM_T::WGCTL1: CMPUCTL3 Position */ +#define EPWM_WGCTL1_CMPUCTL3_Msk (0x3ul << EPWM_WGCTL1_CMPUCTL3_Pos) /*!< EPWM_T::WGCTL1: CMPUCTL3 Mask */ + +#define EPWM_WGCTL1_CMPUCTL4_Pos (8) /*!< EPWM_T::WGCTL1: CMPUCTL4 Position */ +#define EPWM_WGCTL1_CMPUCTL4_Msk (0x3ul << EPWM_WGCTL1_CMPUCTL4_Pos) /*!< EPWM_T::WGCTL1: CMPUCTL4 Mask */ + +#define EPWM_WGCTL1_CMPUCTL5_Pos (10) /*!< EPWM_T::WGCTL1: CMPUCTL5 Position */ +#define EPWM_WGCTL1_CMPUCTL5_Msk (0x3ul << EPWM_WGCTL1_CMPUCTL5_Pos) /*!< EPWM_T::WGCTL1: CMPUCTL5 Mask */ + +#define EPWM_WGCTL1_CMPDCTL0_Pos (16) /*!< EPWM_T::WGCTL1: CMPDCTL0 Position */ +#define EPWM_WGCTL1_CMPDCTL0_Msk (0x3ul << EPWM_WGCTL1_CMPDCTL0_Pos) /*!< EPWM_T::WGCTL1: CMPDCTL0 Mask */ + +#define EPWM_WGCTL1_CMPDCTL1_Pos (18) /*!< EPWM_T::WGCTL1: CMPDCTL1 Position */ +#define EPWM_WGCTL1_CMPDCTL1_Msk (0x3ul << EPWM_WGCTL1_CMPDCTL1_Pos) /*!< EPWM_T::WGCTL1: CMPDCTL1 Mask */ + +#define EPWM_WGCTL1_CMPDCTL2_Pos (20) /*!< EPWM_T::WGCTL1: CMPDCTL2 Position */ +#define EPWM_WGCTL1_CMPDCTL2_Msk (0x3ul << EPWM_WGCTL1_CMPDCTL2_Pos) /*!< EPWM_T::WGCTL1: CMPDCTL2 Mask */ + +#define EPWM_WGCTL1_CMPDCTL3_Pos (22) /*!< EPWM_T::WGCTL1: CMPDCTL3 Position */ +#define EPWM_WGCTL1_CMPDCTL3_Msk (0x3ul << EPWM_WGCTL1_CMPDCTL3_Pos) /*!< EPWM_T::WGCTL1: CMPDCTL3 Mask */ + +#define EPWM_WGCTL1_CMPDCTL4_Pos (24) /*!< EPWM_T::WGCTL1: CMPDCTL4 Position */ +#define EPWM_WGCTL1_CMPDCTL4_Msk (0x3ul << EPWM_WGCTL1_CMPDCTL4_Pos) /*!< EPWM_T::WGCTL1: CMPDCTL4 Mask */ + +#define EPWM_WGCTL1_CMPDCTL5_Pos (26) /*!< EPWM_T::WGCTL1: CMPDCTL5 Position */ +#define EPWM_WGCTL1_CMPDCTL5_Msk (0x3ul << EPWM_WGCTL1_CMPDCTL5_Pos) /*!< EPWM_T::WGCTL1: CMPDCTL5 Mask */ + +#define EPWM_MSKEN_MSKEN0_Pos (0) /*!< EPWM_T::MSKEN: MSKEN0 Position */ +#define EPWM_MSKEN_MSKEN0_Msk (0x1ul << EPWM_MSKEN_MSKEN0_Pos) /*!< EPWM_T::MSKEN: MSKEN0 Mask */ + +#define EPWM_MSKEN_MSKEN1_Pos (1) /*!< EPWM_T::MSKEN: MSKEN1 Position */ +#define EPWM_MSKEN_MSKEN1_Msk (0x1ul << EPWM_MSKEN_MSKEN1_Pos) /*!< EPWM_T::MSKEN: MSKEN1 Mask */ + +#define EPWM_MSKEN_MSKEN2_Pos (2) /*!< EPWM_T::MSKEN: MSKEN2 Position */ +#define EPWM_MSKEN_MSKEN2_Msk (0x1ul << EPWM_MSKEN_MSKEN2_Pos) /*!< EPWM_T::MSKEN: MSKEN2 Mask */ + +#define EPWM_MSKEN_MSKEN3_Pos (3) /*!< EPWM_T::MSKEN: MSKEN3 Position */ +#define EPWM_MSKEN_MSKEN3_Msk (0x1ul << EPWM_MSKEN_MSKEN3_Pos) /*!< EPWM_T::MSKEN: MSKEN3 Mask */ + +#define EPWM_MSKEN_MSKEN4_Pos (4) /*!< EPWM_T::MSKEN: MSKEN4 Position */ +#define EPWM_MSKEN_MSKEN4_Msk (0x1ul << EPWM_MSKEN_MSKEN4_Pos) /*!< EPWM_T::MSKEN: MSKEN4 Mask */ + +#define EPWM_MSKEN_MSKEN5_Pos (5) /*!< EPWM_T::MSKEN: MSKEN5 Position */ +#define EPWM_MSKEN_MSKEN5_Msk (0x1ul << EPWM_MSKEN_MSKEN5_Pos) /*!< EPWM_T::MSKEN: MSKEN5 Mask */ + +#define EPWM_MSK_MSKDAT0_Pos (0) /*!< EPWM_T::MSK: MSKDAT0 Position */ +#define EPWM_MSK_MSKDAT0_Msk (0x1ul << EPWM_MSK_MSKDAT0_Pos) /*!< EPWM_T::MSK: MSKDAT0 Mask */ + +#define EPWM_MSK_MSKDAT1_Pos (1) /*!< EPWM_T::MSK: MSKDAT1 Position */ +#define EPWM_MSK_MSKDAT1_Msk (0x1ul << EPWM_MSK_MSKDAT1_Pos) /*!< EPWM_T::MSK: MSKDAT1 Mask */ + +#define EPWM_MSK_MSKDAT2_Pos (2) /*!< EPWM_T::MSK: MSKDAT2 Position */ +#define EPWM_MSK_MSKDAT2_Msk (0x1ul << EPWM_MSK_MSKDAT2_Pos) /*!< EPWM_T::MSK: MSKDAT2 Mask */ + +#define EPWM_MSK_MSKDAT3_Pos (3) /*!< EPWM_T::MSK: MSKDAT3 Position */ +#define EPWM_MSK_MSKDAT3_Msk (0x1ul << EPWM_MSK_MSKDAT3_Pos) /*!< EPWM_T::MSK: MSKDAT3 Mask */ + +#define EPWM_MSK_MSKDAT4_Pos (4) /*!< EPWM_T::MSK: MSKDAT4 Position */ +#define EPWM_MSK_MSKDAT4_Msk (0x1ul << EPWM_MSK_MSKDAT4_Pos) /*!< EPWM_T::MSK: MSKDAT4 Mask */ + +#define EPWM_MSK_MSKDAT5_Pos (5) /*!< EPWM_T::MSK: MSKDAT5 Position */ +#define EPWM_MSK_MSKDAT5_Msk (0x1ul << EPWM_MSK_MSKDAT5_Pos) /*!< EPWM_T::MSK: MSKDAT5 Mask */ + +#define EPWM_BNF_BRK0NFEN_Pos (0) /*!< EPWM_T::BNF: BRK0NFEN Position */ +#define EPWM_BNF_BRK0NFEN_Msk (0x1ul << EPWM_BNF_BRK0NFEN_Pos) /*!< EPWM_T::BNF: BRK0NFEN Mask */ + +#define EPWM_BNF_BRK0NFSEL_Pos (1) /*!< EPWM_T::BNF: BRK0NFSEL Position */ +#define EPWM_BNF_BRK0NFSEL_Msk (0x7ul << EPWM_BNF_BRK0NFSEL_Pos) /*!< EPWM_T::BNF: BRK0NFSEL Mask */ + +#define EPWM_BNF_BRK0FCNT_Pos (4) /*!< EPWM_T::BNF: BRK0FCNT Position */ +#define EPWM_BNF_BRK0FCNT_Msk (0x7ul << EPWM_BNF_BRK0FCNT_Pos) /*!< EPWM_T::BNF: BRK0FCNT Mask */ + +#define EPWM_BNF_BRK0PINV_Pos (7) /*!< EPWM_T::BNF: BRK0PINV Position */ +#define EPWM_BNF_BRK0PINV_Msk (0x1ul << EPWM_BNF_BRK0PINV_Pos) /*!< EPWM_T::BNF: BRK0PINV Mask */ + +#define EPWM_BNF_BRK1NFEN_Pos (8) /*!< EPWM_T::BNF: BRK1NFEN Position */ +#define EPWM_BNF_BRK1NFEN_Msk (0x1ul << EPWM_BNF_BRK1NFEN_Pos) /*!< EPWM_T::BNF: BRK1NFEN Mask */ + +#define EPWM_BNF_BRK1NFSEL_Pos (9) /*!< EPWM_T::BNF: BRK1NFSEL Position */ +#define EPWM_BNF_BRK1NFSEL_Msk (0x7ul << EPWM_BNF_BRK1NFSEL_Pos) /*!< EPWM_T::BNF: BRK1NFSEL Mask */ + +#define EPWM_BNF_BRK1FCNT_Pos (12) /*!< EPWM_T::BNF: BRK1FCNT Position */ +#define EPWM_BNF_BRK1FCNT_Msk (0x7ul << EPWM_BNF_BRK1FCNT_Pos) /*!< EPWM_T::BNF: BRK1FCNT Mask */ + +#define EPWM_BNF_BRK1PINV_Pos (15) /*!< EPWM_T::BNF: BRK1PINV Position */ +#define EPWM_BNF_BRK1PINV_Msk (0x1ul << EPWM_BNF_BRK1PINV_Pos) /*!< EPWM_T::BNF: BRK1PINV Mask */ + +#define EPWM_BNF_BK0SRC_Pos (16) /*!< EPWM_T::BNF: BK0SRC Position */ +#define EPWM_BNF_BK0SRC_Msk (0x1ul << EPWM_BNF_BK0SRC_Pos) /*!< EPWM_T::BNF: BK0SRC Mask */ + +#define EPWM_BNF_BK1SRC_Pos (24) /*!< EPWM_T::BNF: BK1SRC Position */ +#define EPWM_BNF_BK1SRC_Msk (0x1ul << EPWM_BNF_BK1SRC_Pos) /*!< EPWM_T::BNF: BK1SRC Mask */ + +#define EPWM_FAILBRK_CSSBRKEN_Pos (0) /*!< EPWM_T::FAILBRK: CSSBRKEN Position */ +#define EPWM_FAILBRK_CSSBRKEN_Msk (0x1ul << EPWM_FAILBRK_CSSBRKEN_Pos) /*!< EPWM_T::FAILBRK: CSSBRKEN Mask */ + +#define EPWM_FAILBRK_BODBRKEN_Pos (1) /*!< EPWM_T::FAILBRK: BODBRKEN Position */ +#define EPWM_FAILBRK_BODBRKEN_Msk (0x1ul << EPWM_FAILBRK_BODBRKEN_Pos) /*!< EPWM_T::FAILBRK: BODBRKEN Mask */ + +#define EPWM_FAILBRK_RAMBRKEN_Pos (2) /*!< EPWM_T::FAILBRK: RAMBRKEN Position */ +#define EPWM_FAILBRK_RAMBRKEN_Msk (0x1ul << EPWM_FAILBRK_RAMBRKEN_Pos) /*!< EPWM_T::FAILBRK: RAMBRKEN Mask */ + +#define EPWM_FAILBRK_CORBRKEN_Pos (3) /*!< EPWM_T::FAILBRK: CORBRKEN Position */ +#define EPWM_FAILBRK_CORBRKEN_Msk (0x1ul << EPWM_FAILBRK_CORBRKEN_Pos) /*!< EPWM_T::FAILBRK: CORBRKEN Mask */ + +#define EPWM_BRKCTL0_1_CPO0EBEN_Pos (0) /*!< EPWM_T::BRKCTL0_1: CPO0EBEN Position */ +#define EPWM_BRKCTL0_1_CPO0EBEN_Msk (0x1ul << EPWM_BRKCTL0_1_CPO0EBEN_Pos) /*!< EPWM_T::BRKCTL0_1: CPO0EBEN Mask */ + +#define EPWM_BRKCTL0_1_CPO1EBEN_Pos (1) /*!< EPWM_T::BRKCTL0_1: CPO1EBEN Position */ +#define EPWM_BRKCTL0_1_CPO1EBEN_Msk (0x1ul << EPWM_BRKCTL0_1_CPO1EBEN_Pos) /*!< EPWM_T::BRKCTL0_1: CPO1EBEN Mask */ + +#define EPWM_BRKCTL0_1_BRKP0EEN_Pos (4) /*!< EPWM_T::BRKCTL0_1: BRKP0EEN Position */ +#define EPWM_BRKCTL0_1_BRKP0EEN_Msk (0x1ul << EPWM_BRKCTL0_1_BRKP0EEN_Pos) /*!< EPWM_T::BRKCTL0_1: BRKP0EEN Mask */ + +#define EPWM_BRKCTL0_1_BRKP1EEN_Pos (5) /*!< EPWM_T::BRKCTL0_1: BRKP1EEN Position */ +#define EPWM_BRKCTL0_1_BRKP1EEN_Msk (0x1ul << EPWM_BRKCTL0_1_BRKP1EEN_Pos) /*!< EPWM_T::BRKCTL0_1: BRKP1EEN Mask */ + +#define EPWM_BRKCTL0_1_SYSEBEN_Pos (7) /*!< EPWM_T::BRKCTL0_1: SYSEBEN Position */ +#define EPWM_BRKCTL0_1_SYSEBEN_Msk (0x1ul << EPWM_BRKCTL0_1_SYSEBEN_Pos) /*!< EPWM_T::BRKCTL0_1: SYSEBEN Mask */ + +#define EPWM_BRKCTL0_1_CPO0LBEN_Pos (8) /*!< EPWM_T::BRKCTL0_1: CPO0LBEN Position */ +#define EPWM_BRKCTL0_1_CPO0LBEN_Msk (0x1ul << EPWM_BRKCTL0_1_CPO0LBEN_Pos) /*!< EPWM_T::BRKCTL0_1: CPO0LBEN Mask */ + +#define EPWM_BRKCTL0_1_CPO1LBEN_Pos (9) /*!< EPWM_T::BRKCTL0_1: CPO1LBEN Position */ +#define EPWM_BRKCTL0_1_CPO1LBEN_Msk (0x1ul << EPWM_BRKCTL0_1_CPO1LBEN_Pos) /*!< EPWM_T::BRKCTL0_1: CPO1LBEN Mask */ + +#define EPWM_BRKCTL0_1_BRKP0LEN_Pos (12) /*!< EPWM_T::BRKCTL0_1: BRKP0LEN Position */ +#define EPWM_BRKCTL0_1_BRKP0LEN_Msk (0x1ul << EPWM_BRKCTL0_1_BRKP0LEN_Pos) /*!< EPWM_T::BRKCTL0_1: BRKP0LEN Mask */ + +#define EPWM_BRKCTL0_1_BRKP1LEN_Pos (13) /*!< EPWM_T::BRKCTL0_1: BRKP1LEN Position */ +#define EPWM_BRKCTL0_1_BRKP1LEN_Msk (0x1ul << EPWM_BRKCTL0_1_BRKP1LEN_Pos) /*!< EPWM_T::BRKCTL0_1: BRKP1LEN Mask */ + +#define EPWM_BRKCTL0_1_SYSLBEN_Pos (15) /*!< EPWM_T::BRKCTL0_1: SYSLBEN Position */ +#define EPWM_BRKCTL0_1_SYSLBEN_Msk (0x1ul << EPWM_BRKCTL0_1_SYSLBEN_Pos) /*!< EPWM_T::BRKCTL0_1: SYSLBEN Mask */ + +#define EPWM_BRKCTL0_1_BRKAEVEN_Pos (16) /*!< EPWM_T::BRKCTL0_1: BRKAEVEN Position */ +#define EPWM_BRKCTL0_1_BRKAEVEN_Msk (0x3ul << EPWM_BRKCTL0_1_BRKAEVEN_Pos) /*!< EPWM_T::BRKCTL0_1: BRKAEVEN Mask */ + +#define EPWM_BRKCTL0_1_BRKAODD_Pos (18) /*!< EPWM_T::BRKCTL0_1: BRKAODD Position */ +#define EPWM_BRKCTL0_1_BRKAODD_Msk (0x3ul << EPWM_BRKCTL0_1_BRKAODD_Pos) /*!< EPWM_T::BRKCTL0_1: BRKAODD Mask */ + +#define EPWM_BRKCTL0_1_EADCEBEN_Pos (20) /*!< EPWM_T::BRKCTL0_1: EADCEBEN Position */ +#define EPWM_BRKCTL0_1_EADCEBEN_Msk (0x1ul << EPWM_BRKCTL0_1_EADCEBEN_Pos) /*!< EPWM_T::BRKCTL0_1: EADCEBEN Mask */ + +#define EPWM_BRKCTL0_1_EADCLBEN_Pos (28) /*!< EPWM_T::BRKCTL0_1: EADCLBEN Position */ +#define EPWM_BRKCTL0_1_EADCLBEN_Msk (0x1ul << EPWM_BRKCTL0_1_EADCLBEN_Pos) /*!< EPWM_T::BRKCTL0_1: EADCLBEN Mask */ + +#define EPWM_BRKCTL2_3_CPO0EBEN_Pos (0) /*!< EPWM_T::BRKCTL2_3: CPO0EBEN Position */ +#define EPWM_BRKCTL2_3_CPO0EBEN_Msk (0x1ul << EPWM_BRKCTL2_3_CPO0EBEN_Pos) /*!< EPWM_T::BRKCTL2_3: CPO0EBEN Mask */ + +#define EPWM_BRKCTL2_3_CPO1EBEN_Pos (1) /*!< EPWM_T::BRKCTL2_3: CPO1EBEN Position */ +#define EPWM_BRKCTL2_3_CPO1EBEN_Msk (0x1ul << EPWM_BRKCTL2_3_CPO1EBEN_Pos) /*!< EPWM_T::BRKCTL2_3: CPO1EBEN Mask */ + +#define EPWM_BRKCTL2_3_BRKP0EEN_Pos (4) /*!< EPWM_T::BRKCTL2_3: BRKP0EEN Position */ +#define EPWM_BRKCTL2_3_BRKP0EEN_Msk (0x1ul << EPWM_BRKCTL2_3_BRKP0EEN_Pos) /*!< EPWM_T::BRKCTL2_3: BRKP0EEN Mask */ + +#define EPWM_BRKCTL2_3_BRKP1EEN_Pos (5) /*!< EPWM_T::BRKCTL2_3: BRKP1EEN Position */ +#define EPWM_BRKCTL2_3_BRKP1EEN_Msk (0x1ul << EPWM_BRKCTL2_3_BRKP1EEN_Pos) /*!< EPWM_T::BRKCTL2_3: BRKP1EEN Mask */ + +#define EPWM_BRKCTL2_3_SYSEBEN_Pos (7) /*!< EPWM_T::BRKCTL2_3: SYSEBEN Position */ +#define EPWM_BRKCTL2_3_SYSEBEN_Msk (0x1ul << EPWM_BRKCTL2_3_SYSEBEN_Pos) /*!< EPWM_T::BRKCTL2_3: SYSEBEN Mask */ + +#define EPWM_BRKCTL2_3_CPO0LBEN_Pos (8) /*!< EPWM_T::BRKCTL2_3: CPO0LBEN Position */ +#define EPWM_BRKCTL2_3_CPO0LBEN_Msk (0x1ul << EPWM_BRKCTL2_3_CPO0LBEN_Pos) /*!< EPWM_T::BRKCTL2_3: CPO0LBEN Mask */ + +#define EPWM_BRKCTL2_3_CPO1LBEN_Pos (9) /*!< EPWM_T::BRKCTL2_3: CPO1LBEN Position */ +#define EPWM_BRKCTL2_3_CPO1LBEN_Msk (0x1ul << EPWM_BRKCTL2_3_CPO1LBEN_Pos) /*!< EPWM_T::BRKCTL2_3: CPO1LBEN Mask */ + +#define EPWM_BRKCTL2_3_BRKP0LEN_Pos (12) /*!< EPWM_T::BRKCTL2_3: BRKP0LEN Position */ +#define EPWM_BRKCTL2_3_BRKP0LEN_Msk (0x1ul << EPWM_BRKCTL2_3_BRKP0LEN_Pos) /*!< EPWM_T::BRKCTL2_3: BRKP0LEN Mask */ + +#define EPWM_BRKCTL2_3_BRKP1LEN_Pos (13) /*!< EPWM_T::BRKCTL2_3: BRKP1LEN Position */ +#define EPWM_BRKCTL2_3_BRKP1LEN_Msk (0x1ul << EPWM_BRKCTL2_3_BRKP1LEN_Pos) /*!< EPWM_T::BRKCTL2_3: BRKP1LEN Mask */ + +#define EPWM_BRKCTL2_3_SYSLBEN_Pos (15) /*!< EPWM_T::BRKCTL2_3: SYSLBEN Position */ +#define EPWM_BRKCTL2_3_SYSLBEN_Msk (0x1ul << EPWM_BRKCTL2_3_SYSLBEN_Pos) /*!< EPWM_T::BRKCTL2_3: SYSLBEN Mask */ + +#define EPWM_BRKCTL2_3_BRKAEVEN_Pos (16) /*!< EPWM_T::BRKCTL2_3: BRKAEVEN Position */ +#define EPWM_BRKCTL2_3_BRKAEVEN_Msk (0x3ul << EPWM_BRKCTL2_3_BRKAEVEN_Pos) /*!< EPWM_T::BRKCTL2_3: BRKAEVEN Mask */ + +#define EPWM_BRKCTL2_3_BRKAODD_Pos (18) /*!< EPWM_T::BRKCTL2_3: BRKAODD Position */ +#define EPWM_BRKCTL2_3_BRKAODD_Msk (0x3ul << EPWM_BRKCTL2_3_BRKAODD_Pos) /*!< EPWM_T::BRKCTL2_3: BRKAODD Mask */ + +#define EPWM_BRKCTL2_3_EADCEBEN_Pos (20) /*!< EPWM_T::BRKCTL2_3: EADCEBEN Position */ +#define EPWM_BRKCTL2_3_EADCEBEN_Msk (0x1ul << EPWM_BRKCTL2_3_EADCEBEN_Pos) /*!< EPWM_T::BRKCTL2_3: EADCEBEN Mask */ + +#define EPWM_BRKCTL2_3_EADCLBEN_Pos (28) /*!< EPWM_T::BRKCTL2_3: EADCLBEN Position */ +#define EPWM_BRKCTL2_3_EADCLBEN_Msk (0x1ul << EPWM_BRKCTL2_3_EADCLBEN_Pos) /*!< EPWM_T::BRKCTL2_3: EADCLBEN Mask */ + +#define EPWM_BRKCTL4_5_CPO0EBEN_Pos (0) /*!< EPWM_T::BRKCTL4_5: CPO0EBEN Position */ +#define EPWM_BRKCTL4_5_CPO0EBEN_Msk (0x1ul << EPWM_BRKCTL4_5_CPO0EBEN_Pos) /*!< EPWM_T::BRKCTL4_5: CPO0EBEN Mask */ + +#define EPWM_BRKCTL4_5_CPO1EBEN_Pos (1) /*!< EPWM_T::BRKCTL4_5: CPO1EBEN Position */ +#define EPWM_BRKCTL4_5_CPO1EBEN_Msk (0x1ul << EPWM_BRKCTL4_5_CPO1EBEN_Pos) /*!< EPWM_T::BRKCTL4_5: CPO1EBEN Mask */ + +#define EPWM_BRKCTL4_5_BRKP0EEN_Pos (4) /*!< EPWM_T::BRKCTL4_5: BRKP0EEN Position */ +#define EPWM_BRKCTL4_5_BRKP0EEN_Msk (0x1ul << EPWM_BRKCTL4_5_BRKP0EEN_Pos) /*!< EPWM_T::BRKCTL4_5: BRKP0EEN Mask */ + +#define EPWM_BRKCTL4_5_BRKP1EEN_Pos (5) /*!< EPWM_T::BRKCTL4_5: BRKP1EEN Position */ +#define EPWM_BRKCTL4_5_BRKP1EEN_Msk (0x1ul << EPWM_BRKCTL4_5_BRKP1EEN_Pos) /*!< EPWM_T::BRKCTL4_5: BRKP1EEN Mask */ + +#define EPWM_BRKCTL4_5_SYSEBEN_Pos (7) /*!< EPWM_T::BRKCTL4_5: SYSEBEN Position */ +#define EPWM_BRKCTL4_5_SYSEBEN_Msk (0x1ul << EPWM_BRKCTL4_5_SYSEBEN_Pos) /*!< EPWM_T::BRKCTL4_5: SYSEBEN Mask */ + +#define EPWM_BRKCTL4_5_CPO0LBEN_Pos (8) /*!< EPWM_T::BRKCTL4_5: CPO0LBEN Position */ +#define EPWM_BRKCTL4_5_CPO0LBEN_Msk (0x1ul << EPWM_BRKCTL4_5_CPO0LBEN_Pos) /*!< EPWM_T::BRKCTL4_5: CPO0LBEN Mask */ + +#define EPWM_BRKCTL4_5_CPO1LBEN_Pos (9) /*!< EPWM_T::BRKCTL4_5: CPO1LBEN Position */ +#define EPWM_BRKCTL4_5_CPO1LBEN_Msk (0x1ul << EPWM_BRKCTL4_5_CPO1LBEN_Pos) /*!< EPWM_T::BRKCTL4_5: CPO1LBEN Mask */ + +#define EPWM_BRKCTL4_5_BRKP0LEN_Pos (12) /*!< EPWM_T::BRKCTL4_5: BRKP0LEN Position */ +#define EPWM_BRKCTL4_5_BRKP0LEN_Msk (0x1ul << EPWM_BRKCTL4_5_BRKP0LEN_Pos) /*!< EPWM_T::BRKCTL4_5: BRKP0LEN Mask */ + +#define EPWM_BRKCTL4_5_BRKP1LEN_Pos (13) /*!< EPWM_T::BRKCTL4_5: BRKP1LEN Position */ +#define EPWM_BRKCTL4_5_BRKP1LEN_Msk (0x1ul << EPWM_BRKCTL4_5_BRKP1LEN_Pos) /*!< EPWM_T::BRKCTL4_5: BRKP1LEN Mask */ + +#define EPWM_BRKCTL4_5_SYSLBEN_Pos (15) /*!< EPWM_T::BRKCTL4_5: SYSLBEN Position */ +#define EPWM_BRKCTL4_5_SYSLBEN_Msk (0x1ul << EPWM_BRKCTL4_5_SYSLBEN_Pos) /*!< EPWM_T::BRKCTL4_5: SYSLBEN Mask */ + +#define EPWM_BRKCTL4_5_BRKAEVEN_Pos (16) /*!< EPWM_T::BRKCTL4_5: BRKAEVEN Position */ +#define EPWM_BRKCTL4_5_BRKAEVEN_Msk (0x3ul << EPWM_BRKCTL4_5_BRKAEVEN_Pos) /*!< EPWM_T::BRKCTL4_5: BRKAEVEN Mask */ + +#define EPWM_BRKCTL4_5_BRKAODD_Pos (18) /*!< EPWM_T::BRKCTL4_5: BRKAODD Position */ +#define EPWM_BRKCTL4_5_BRKAODD_Msk (0x3ul << EPWM_BRKCTL4_5_BRKAODD_Pos) /*!< EPWM_T::BRKCTL4_5: BRKAODD Mask */ + +#define EPWM_BRKCTL4_5_EADCEBEN_Pos (20) /*!< EPWM_T::BRKCTL4_5: EADCEBEN Position */ +#define EPWM_BRKCTL4_5_EADCEBEN_Msk (0x1ul << EPWM_BRKCTL4_5_EADCEBEN_Pos) /*!< EPWM_T::BRKCTL4_5: EADCEBEN Mask */ + +#define EPWM_BRKCTL4_5_EADCLBEN_Pos (28) /*!< EPWM_T::BRKCTL4_5: EADCLBEN Position */ +#define EPWM_BRKCTL4_5_EADCLBEN_Msk (0x1ul << EPWM_BRKCTL4_5_EADCLBEN_Pos) /*!< EPWM_T::BRKCTL4_5: EADCLBEN Mask */ + +#define EPWM_POLCTL_PINV0_Pos (0) /*!< EPWM_T::POLCTL: PINV0 Position */ +#define EPWM_POLCTL_PINV0_Msk (0x1ul << EPWM_POLCTL_PINV0_Pos) /*!< EPWM_T::POLCTL: PINV0 Mask */ + +#define EPWM_POLCTL_PINV1_Pos (1) /*!< EPWM_T::POLCTL: PINV1 Position */ +#define EPWM_POLCTL_PINV1_Msk (0x1ul << EPWM_POLCTL_PINV1_Pos) /*!< EPWM_T::POLCTL: PINV1 Mask */ + +#define EPWM_POLCTL_PINV2_Pos (2) /*!< EPWM_T::POLCTL: PINV2 Position */ +#define EPWM_POLCTL_PINV2_Msk (0x1ul << EPWM_POLCTL_PINV2_Pos) /*!< EPWM_T::POLCTL: PINV2 Mask */ + +#define EPWM_POLCTL_PINV3_Pos (3) /*!< EPWM_T::POLCTL: PINV3 Position */ +#define EPWM_POLCTL_PINV3_Msk (0x1ul << EPWM_POLCTL_PINV3_Pos) /*!< EPWM_T::POLCTL: PINV3 Mask */ + +#define EPWM_POLCTL_PINV4_Pos (4) /*!< EPWM_T::POLCTL: PINV4 Position */ +#define EPWM_POLCTL_PINV4_Msk (0x1ul << EPWM_POLCTL_PINV4_Pos) /*!< EPWM_T::POLCTL: PINV4 Mask */ + +#define EPWM_POLCTL_PINV5_Pos (5) /*!< EPWM_T::POLCTL: PINV5 Position */ +#define EPWM_POLCTL_PINV5_Msk (0x1ul << EPWM_POLCTL_PINV5_Pos) /*!< EPWM_T::POLCTL: PINV5 Mask */ + +#define EPWM_POEN_POEN0_Pos (0) /*!< EPWM_T::POEN: POEN0 Position */ +#define EPWM_POEN_POEN0_Msk (0x1ul << EPWM_POEN_POEN0_Pos) /*!< EPWM_T::POEN: POEN0 Mask */ + +#define EPWM_POEN_POEN1_Pos (1) /*!< EPWM_T::POEN: POEN1 Position */ +#define EPWM_POEN_POEN1_Msk (0x1ul << EPWM_POEN_POEN1_Pos) /*!< EPWM_T::POEN: POEN1 Mask */ + +#define EPWM_POEN_POEN2_Pos (2) /*!< EPWM_T::POEN: POEN2 Position */ +#define EPWM_POEN_POEN2_Msk (0x1ul << EPWM_POEN_POEN2_Pos) /*!< EPWM_T::POEN: POEN2 Mask */ + +#define EPWM_POEN_POEN3_Pos (3) /*!< EPWM_T::POEN: POEN3 Position */ +#define EPWM_POEN_POEN3_Msk (0x1ul << EPWM_POEN_POEN3_Pos) /*!< EPWM_T::POEN: POEN3 Mask */ + +#define EPWM_POEN_POEN4_Pos (4) /*!< EPWM_T::POEN: POEN4 Position */ +#define EPWM_POEN_POEN4_Msk (0x1ul << EPWM_POEN_POEN4_Pos) /*!< EPWM_T::POEN: POEN4 Mask */ + +#define EPWM_POEN_POEN5_Pos (5) /*!< EPWM_T::POEN: POEN5 Position */ +#define EPWM_POEN_POEN5_Msk (0x1ul << EPWM_POEN_POEN5_Pos) /*!< EPWM_T::POEN: POEN5 Mask */ + +#define EPWM_SWBRK_BRKETRG0_Pos (0) /*!< EPWM_T::SWBRK: BRKETRG0 Position */ +#define EPWM_SWBRK_BRKETRG0_Msk (0x1ul << EPWM_SWBRK_BRKETRG0_Pos) /*!< EPWM_T::SWBRK: BRKETRG0 Mask */ + +#define EPWM_SWBRK_BRKETRG2_Pos (1) /*!< EPWM_T::SWBRK: BRKETRG2 Position */ +#define EPWM_SWBRK_BRKETRG2_Msk (0x1ul << EPWM_SWBRK_BRKETRG2_Pos) /*!< EPWM_T::SWBRK: BRKETRG2 Mask */ + +#define EPWM_SWBRK_BRKETRG4_Pos (2) /*!< EPWM_T::SWBRK: BRKETRG4 Position */ +#define EPWM_SWBRK_BRKETRG4_Msk (0x1ul << EPWM_SWBRK_BRKETRG4_Pos) /*!< EPWM_T::SWBRK: BRKETRG4 Mask */ + +#define EPWM_SWBRK_BRKLTRG0_Pos (8) /*!< EPWM_T::SWBRK: BRKLTRG0 Position */ +#define EPWM_SWBRK_BRKLTRG0_Msk (0x1ul << EPWM_SWBRK_BRKLTRG0_Pos) /*!< EPWM_T::SWBRK: BRKLTRG0 Mask */ + +#define EPWM_SWBRK_BRKLTRG2_Pos (9) /*!< EPWM_T::SWBRK: BRKLTRG2 Position */ +#define EPWM_SWBRK_BRKLTRG2_Msk (0x1ul << EPWM_SWBRK_BRKLTRG2_Pos) /*!< EPWM_T::SWBRK: BRKLTRG2 Mask */ + +#define EPWM_SWBRK_BRKLTRG4_Pos (10) /*!< EPWM_T::SWBRK: BRKLTRG4 Position */ +#define EPWM_SWBRK_BRKLTRG4_Msk (0x1ul << EPWM_SWBRK_BRKLTRG4_Pos) /*!< EPWM_T::SWBRK: BRKLTRG4 Mask */ + +#define EPWM_INTEN0_ZIEN0_Pos (0) /*!< EPWM_T::INTEN0: ZIEN0 Position */ +#define EPWM_INTEN0_ZIEN0_Msk (0x1ul << EPWM_INTEN0_ZIEN0_Pos) /*!< EPWM_T::INTEN0: ZIEN0 Mask */ + +#define EPWM_INTEN0_ZIEN1_Pos (1) /*!< EPWM_T::INTEN0: ZIEN1 Position */ +#define EPWM_INTEN0_ZIEN1_Msk (0x1ul << EPWM_INTEN0_ZIEN1_Pos) /*!< EPWM_T::INTEN0: ZIEN1 Mask */ + +#define EPWM_INTEN0_ZIEN2_Pos (2) /*!< EPWM_T::INTEN0: ZIEN2 Position */ +#define EPWM_INTEN0_ZIEN2_Msk (0x1ul << EPWM_INTEN0_ZIEN2_Pos) /*!< EPWM_T::INTEN0: ZIEN2 Mask */ + +#define EPWM_INTEN0_ZIEN3_Pos (3) /*!< EPWM_T::INTEN0: ZIEN3 Position */ +#define EPWM_INTEN0_ZIEN3_Msk (0x1ul << EPWM_INTEN0_ZIEN3_Pos) /*!< EPWM_T::INTEN0: ZIEN3 Mask */ + +#define EPWM_INTEN0_ZIEN4_Pos (4) /*!< EPWM_T::INTEN0: ZIEN4 Position */ +#define EPWM_INTEN0_ZIEN4_Msk (0x1ul << EPWM_INTEN0_ZIEN4_Pos) /*!< EPWM_T::INTEN0: ZIEN4 Mask */ + +#define EPWM_INTEN0_ZIEN5_Pos (5) /*!< EPWM_T::INTEN0: ZIEN5 Position */ +#define EPWM_INTEN0_ZIEN5_Msk (0x1ul << EPWM_INTEN0_ZIEN5_Pos) /*!< EPWM_T::INTEN0: ZIEN5 Mask */ + +#define EPWM_INTEN0_PIEN0_Pos (8) /*!< EPWM_T::INTEN0: PIEN0 Position */ +#define EPWM_INTEN0_PIEN0_Msk (0x1ul << EPWM_INTEN0_PIEN0_Pos) /*!< EPWM_T::INTEN0: PIEN0 Mask */ + +#define EPWM_INTEN0_PIEN1_Pos (9) /*!< EPWM_T::INTEN0: PIEN1 Position */ +#define EPWM_INTEN0_PIEN1_Msk (0x1ul << EPWM_INTEN0_PIEN1_Pos) /*!< EPWM_T::INTEN0: PIEN1 Mask */ + +#define EPWM_INTEN0_PIEN2_Pos (10) /*!< EPWM_T::INTEN0: PIEN2 Position */ +#define EPWM_INTEN0_PIEN2_Msk (0x1ul << EPWM_INTEN0_PIEN2_Pos) /*!< EPWM_T::INTEN0: PIEN2 Mask */ + +#define EPWM_INTEN0_PIEN3_Pos (11) /*!< EPWM_T::INTEN0: PIEN3 Position */ +#define EPWM_INTEN0_PIEN3_Msk (0x1ul << EPWM_INTEN0_PIEN3_Pos) /*!< EPWM_T::INTEN0: PIEN3 Mask */ + +#define EPWM_INTEN0_PIEN4_Pos (12) /*!< EPWM_T::INTEN0: PIEN4 Position */ +#define EPWM_INTEN0_PIEN4_Msk (0x1ul << EPWM_INTEN0_PIEN4_Pos) /*!< EPWM_T::INTEN0: PIEN4 Mask */ + +#define EPWM_INTEN0_PIEN5_Pos (13) /*!< EPWM_T::INTEN0: PIEN5 Position */ +#define EPWM_INTEN0_PIEN5_Msk (0x1ul << EPWM_INTEN0_PIEN5_Pos) /*!< EPWM_T::INTEN0: PIEN5 Mask */ + +#define EPWM_INTEN0_CMPUIEN0_Pos (16) /*!< EPWM_T::INTEN0: CMPUIEN0 Position */ +#define EPWM_INTEN0_CMPUIEN0_Msk (0x1ul << EPWM_INTEN0_CMPUIEN0_Pos) /*!< EPWM_T::INTEN0: CMPUIEN0 Mask */ + +#define EPWM_INTEN0_CMPUIEN1_Pos (17) /*!< EPWM_T::INTEN0: CMPUIEN1 Position */ +#define EPWM_INTEN0_CMPUIEN1_Msk (0x1ul << EPWM_INTEN0_CMPUIEN1_Pos) /*!< EPWM_T::INTEN0: CMPUIEN1 Mask */ + +#define EPWM_INTEN0_CMPUIEN2_Pos (18) /*!< EPWM_T::INTEN0: CMPUIEN2 Position */ +#define EPWM_INTEN0_CMPUIEN2_Msk (0x1ul << EPWM_INTEN0_CMPUIEN2_Pos) /*!< EPWM_T::INTEN0: CMPUIEN2 Mask */ + +#define EPWM_INTEN0_CMPUIEN3_Pos (19) /*!< EPWM_T::INTEN0: CMPUIEN3 Position */ +#define EPWM_INTEN0_CMPUIEN3_Msk (0x1ul << EPWM_INTEN0_CMPUIEN3_Pos) /*!< EPWM_T::INTEN0: CMPUIEN3 Mask */ + +#define EPWM_INTEN0_CMPUIEN4_Pos (20) /*!< EPWM_T::INTEN0: CMPUIEN4 Position */ +#define EPWM_INTEN0_CMPUIEN4_Msk (0x1ul << EPWM_INTEN0_CMPUIEN4_Pos) /*!< EPWM_T::INTEN0: CMPUIEN4 Mask */ + +#define EPWM_INTEN0_CMPUIEN5_Pos (21) /*!< EPWM_T::INTEN0: CMPUIEN5 Position */ +#define EPWM_INTEN0_CMPUIEN5_Msk (0x1ul << EPWM_INTEN0_CMPUIEN5_Pos) /*!< EPWM_T::INTEN0: CMPUIEN5 Mask */ + +#define EPWM_INTEN0_CMPDIEN0_Pos (24) /*!< EPWM_T::INTEN0: CMPDIEN0 Position */ +#define EPWM_INTEN0_CMPDIEN0_Msk (0x1ul << EPWM_INTEN0_CMPDIEN0_Pos) /*!< EPWM_T::INTEN0: CMPDIEN0 Mask */ + +#define EPWM_INTEN0_CMPDIEN1_Pos (25) /*!< EPWM_T::INTEN0: CMPDIEN1 Position */ +#define EPWM_INTEN0_CMPDIEN1_Msk (0x1ul << EPWM_INTEN0_CMPDIEN1_Pos) /*!< EPWM_T::INTEN0: CMPDIEN1 Mask */ + +#define EPWM_INTEN0_CMPDIEN2_Pos (26) /*!< EPWM_T::INTEN0: CMPDIEN2 Position */ +#define EPWM_INTEN0_CMPDIEN2_Msk (0x1ul << EPWM_INTEN0_CMPDIEN2_Pos) /*!< EPWM_T::INTEN0: CMPDIEN2 Mask */ + +#define EPWM_INTEN0_CMPDIEN3_Pos (27) /*!< EPWM_T::INTEN0: CMPDIEN3 Position */ +#define EPWM_INTEN0_CMPDIEN3_Msk (0x1ul << EPWM_INTEN0_CMPDIEN3_Pos) /*!< EPWM_T::INTEN0: CMPDIEN3 Mask */ + +#define EPWM_INTEN0_CMPDIEN4_Pos (28) /*!< EPWM_T::INTEN0: CMPDIEN4 Position */ +#define EPWM_INTEN0_CMPDIEN4_Msk (0x1ul << EPWM_INTEN0_CMPDIEN4_Pos) /*!< EPWM_T::INTEN0: CMPDIEN4 Mask */ + +#define EPWM_INTEN0_CMPDIEN5_Pos (29) /*!< EPWM_T::INTEN0: CMPDIEN5 Position */ +#define EPWM_INTEN0_CMPDIEN5_Msk (0x1ul << EPWM_INTEN0_CMPDIEN5_Pos) /*!< EPWM_T::INTEN0: CMPDIEN5 Mask */ + +#define EPWM_INTEN1_BRKEIEN0_1_Pos (0) /*!< EPWM_T::INTEN1: BRKEIEN0_1 Position */ +#define EPWM_INTEN1_BRKEIEN0_1_Msk (0x1ul << EPWM_INTEN1_BRKEIEN0_1_Pos) /*!< EPWM_T::INTEN1: BRKEIEN0_1 Mask */ + +#define EPWM_INTEN1_BRKEIEN2_3_Pos (1) /*!< EPWM_T::INTEN1: BRKEIEN2_3 Position */ +#define EPWM_INTEN1_BRKEIEN2_3_Msk (0x1ul << EPWM_INTEN1_BRKEIEN2_3_Pos) /*!< EPWM_T::INTEN1: BRKEIEN2_3 Mask */ + +#define EPWM_INTEN1_BRKEIEN4_5_Pos (2) /*!< EPWM_T::INTEN1: BRKEIEN4_5 Position */ +#define EPWM_INTEN1_BRKEIEN4_5_Msk (0x1ul << EPWM_INTEN1_BRKEIEN4_5_Pos) /*!< EPWM_T::INTEN1: BRKEIEN4_5 Mask */ + +#define EPWM_INTEN1_BRKLIEN0_1_Pos (8) /*!< EPWM_T::INTEN1: BRKLIEN0_1 Position */ +#define EPWM_INTEN1_BRKLIEN0_1_Msk (0x1ul << EPWM_INTEN1_BRKLIEN0_1_Pos) /*!< EPWM_T::INTEN1: BRKLIEN0_1 Mask */ + +#define EPWM_INTEN1_BRKLIEN2_3_Pos (9) /*!< EPWM_T::INTEN1: BRKLIEN2_3 Position */ +#define EPWM_INTEN1_BRKLIEN2_3_Msk (0x1ul << EPWM_INTEN1_BRKLIEN2_3_Pos) /*!< EPWM_T::INTEN1: BRKLIEN2_3 Mask */ + +#define EPWM_INTEN1_BRKLIEN4_5_Pos (10) /*!< EPWM_T::INTEN1: BRKLIEN4_5 Position */ +#define EPWM_INTEN1_BRKLIEN4_5_Msk (0x1ul << EPWM_INTEN1_BRKLIEN4_5_Pos) /*!< EPWM_T::INTEN1: BRKLIEN4_5 Mask */ + +#define EPWM_INTSTS0_ZIF0_Pos (0) /*!< EPWM_T::INTSTS0: ZIF0 Position */ +#define EPWM_INTSTS0_ZIF0_Msk (0x1ul << EPWM_INTSTS0_ZIF0_Pos) /*!< EPWM_T::INTSTS0: ZIF0 Mask */ + +#define EPWM_INTSTS0_ZIF1_Pos (1) /*!< EPWM_T::INTSTS0: ZIF1 Position */ +#define EPWM_INTSTS0_ZIF1_Msk (0x1ul << EPWM_INTSTS0_ZIF1_Pos) /*!< EPWM_T::INTSTS0: ZIF1 Mask */ + +#define EPWM_INTSTS0_ZIF2_Pos (2) /*!< EPWM_T::INTSTS0: ZIF2 Position */ +#define EPWM_INTSTS0_ZIF2_Msk (0x1ul << EPWM_INTSTS0_ZIF2_Pos) /*!< EPWM_T::INTSTS0: ZIF2 Mask */ + +#define EPWM_INTSTS0_ZIF3_Pos (3) /*!< EPWM_T::INTSTS0: ZIF3 Position */ +#define EPWM_INTSTS0_ZIF3_Msk (0x1ul << EPWM_INTSTS0_ZIF3_Pos) /*!< EPWM_T::INTSTS0: ZIF3 Mask */ + +#define EPWM_INTSTS0_ZIF4_Pos (4) /*!< EPWM_T::INTSTS0: ZIF4 Position */ +#define EPWM_INTSTS0_ZIF4_Msk (0x1ul << EPWM_INTSTS0_ZIF4_Pos) /*!< EPWM_T::INTSTS0: ZIF4 Mask */ + +#define EPWM_INTSTS0_ZIF5_Pos (5) /*!< EPWM_T::INTSTS0: ZIF5 Position */ +#define EPWM_INTSTS0_ZIF5_Msk (0x1ul << EPWM_INTSTS0_ZIF5_Pos) /*!< EPWM_T::INTSTS0: ZIF5 Mask */ + +#define EPWM_INTSTS0_PIF0_Pos (8) /*!< EPWM_T::INTSTS0: PIF0 Position */ +#define EPWM_INTSTS0_PIF0_Msk (0x1ul << EPWM_INTSTS0_PIF0_Pos) /*!< EPWM_T::INTSTS0: PIF0 Mask */ + +#define EPWM_INTSTS0_PIF1_Pos (9) /*!< EPWM_T::INTSTS0: PIF1 Position */ +#define EPWM_INTSTS0_PIF1_Msk (0x1ul << EPWM_INTSTS0_PIF1_Pos) /*!< EPWM_T::INTSTS0: PIF1 Mask */ + +#define EPWM_INTSTS0_PIF2_Pos (10) /*!< EPWM_T::INTSTS0: PIF2 Position */ +#define EPWM_INTSTS0_PIF2_Msk (0x1ul << EPWM_INTSTS0_PIF2_Pos) /*!< EPWM_T::INTSTS0: PIF2 Mask */ + +#define EPWM_INTSTS0_PIF3_Pos (11) /*!< EPWM_T::INTSTS0: PIF3 Position */ +#define EPWM_INTSTS0_PIF3_Msk (0x1ul << EPWM_INTSTS0_PIF3_Pos) /*!< EPWM_T::INTSTS0: PIF3 Mask */ + +#define EPWM_INTSTS0_PIF4_Pos (12) /*!< EPWM_T::INTSTS0: PIF4 Position */ +#define EPWM_INTSTS0_PIF4_Msk (0x1ul << EPWM_INTSTS0_PIF4_Pos) /*!< EPWM_T::INTSTS0: PIF4 Mask */ + +#define EPWM_INTSTS0_PIF5_Pos (13) /*!< EPWM_T::INTSTS0: PIF5 Position */ +#define EPWM_INTSTS0_PIF5_Msk (0x1ul << EPWM_INTSTS0_PIF5_Pos) /*!< EPWM_T::INTSTS0: PIF5 Mask */ + +#define EPWM_INTSTS0_CMPUIF0_Pos (16) /*!< EPWM_T::INTSTS0: CMPUIF0 Position */ +#define EPWM_INTSTS0_CMPUIF0_Msk (0x1ul << EPWM_INTSTS0_CMPUIF0_Pos) /*!< EPWM_T::INTSTS0: CMPUIF0 Mask */ + +#define EPWM_INTSTS0_CMPUIF1_Pos (17) /*!< EPWM_T::INTSTS0: CMPUIF1 Position */ +#define EPWM_INTSTS0_CMPUIF1_Msk (0x1ul << EPWM_INTSTS0_CMPUIF1_Pos) /*!< EPWM_T::INTSTS0: CMPUIF1 Mask */ + +#define EPWM_INTSTS0_CMPUIF2_Pos (18) /*!< EPWM_T::INTSTS0: CMPUIF2 Position */ +#define EPWM_INTSTS0_CMPUIF2_Msk (0x1ul << EPWM_INTSTS0_CMPUIF2_Pos) /*!< EPWM_T::INTSTS0: CMPUIF2 Mask */ + +#define EPWM_INTSTS0_CMPUIF3_Pos (19) /*!< EPWM_T::INTSTS0: CMPUIF3 Position */ +#define EPWM_INTSTS0_CMPUIF3_Msk (0x1ul << EPWM_INTSTS0_CMPUIF3_Pos) /*!< EPWM_T::INTSTS0: CMPUIF3 Mask */ + +#define EPWM_INTSTS0_CMPUIF4_Pos (20) /*!< EPWM_T::INTSTS0: CMPUIF4 Position */ +#define EPWM_INTSTS0_CMPUIF4_Msk (0x1ul << EPWM_INTSTS0_CMPUIF4_Pos) /*!< EPWM_T::INTSTS0: CMPUIF4 Mask */ + +#define EPWM_INTSTS0_CMPUIF5_Pos (21) /*!< EPWM_T::INTSTS0: CMPUIF5 Position */ +#define EPWM_INTSTS0_CMPUIF5_Msk (0x1ul << EPWM_INTSTS0_CMPUIF5_Pos) /*!< EPWM_T::INTSTS0: CMPUIF5 Mask */ + +#define EPWM_INTSTS0_CMPDIF0_Pos (24) /*!< EPWM_T::INTSTS0: CMPDIF0 Position */ +#define EPWM_INTSTS0_CMPDIF0_Msk (0x1ul << EPWM_INTSTS0_CMPDIF0_Pos) /*!< EPWM_T::INTSTS0: CMPDIF0 Mask */ + +#define EPWM_INTSTS0_CMPDIF1_Pos (25) /*!< EPWM_T::INTSTS0: CMPDIF1 Position */ +#define EPWM_INTSTS0_CMPDIF1_Msk (0x1ul << EPWM_INTSTS0_CMPDIF1_Pos) /*!< EPWM_T::INTSTS0: CMPDIF1 Mask */ + +#define EPWM_INTSTS0_CMPDIF2_Pos (26) /*!< EPWM_T::INTSTS0: CMPDIF2 Position */ +#define EPWM_INTSTS0_CMPDIF2_Msk (0x1ul << EPWM_INTSTS0_CMPDIF2_Pos) /*!< EPWM_T::INTSTS0: CMPDIF2 Mask */ + +#define EPWM_INTSTS0_CMPDIF3_Pos (27) /*!< EPWM_T::INTSTS0: CMPDIF3 Position */ +#define EPWM_INTSTS0_CMPDIF3_Msk (0x1ul << EPWM_INTSTS0_CMPDIF3_Pos) /*!< EPWM_T::INTSTS0: CMPDIF3 Mask */ + +#define EPWM_INTSTS0_CMPDIF4_Pos (28) /*!< EPWM_T::INTSTS0: CMPDIF4 Position */ +#define EPWM_INTSTS0_CMPDIF4_Msk (0x1ul << EPWM_INTSTS0_CMPDIF4_Pos) /*!< EPWM_T::INTSTS0: CMPDIF4 Mask */ + +#define EPWM_INTSTS0_CMPDIF5_Pos (29) /*!< EPWM_T::INTSTS0: CMPDIF5 Position */ +#define EPWM_INTSTS0_CMPDIF5_Msk (0x1ul << EPWM_INTSTS0_CMPDIF5_Pos) /*!< EPWM_T::INTSTS0: CMPDIF5 Mask */ + +#define EPWM_INTSTS1_BRKEIF0_Pos (0) /*!< EPWM_T::INTSTS1: BRKEIF0 Position */ +#define EPWM_INTSTS1_BRKEIF0_Msk (0x1ul << EPWM_INTSTS1_BRKEIF0_Pos) /*!< EPWM_T::INTSTS1: BRKEIF0 Mask */ + +#define EPWM_INTSTS1_BRKEIF1_Pos (1) /*!< EPWM_T::INTSTS1: BRKEIF1 Position */ +#define EPWM_INTSTS1_BRKEIF1_Msk (0x1ul << EPWM_INTSTS1_BRKEIF1_Pos) /*!< EPWM_T::INTSTS1: BRKEIF1 Mask */ + +#define EPWM_INTSTS1_BRKEIF2_Pos (2) /*!< EPWM_T::INTSTS1: BRKEIF2 Position */ +#define EPWM_INTSTS1_BRKEIF2_Msk (0x1ul << EPWM_INTSTS1_BRKEIF2_Pos) /*!< EPWM_T::INTSTS1: BRKEIF2 Mask */ + +#define EPWM_INTSTS1_BRKEIF3_Pos (3) /*!< EPWM_T::INTSTS1: BRKEIF3 Position */ +#define EPWM_INTSTS1_BRKEIF3_Msk (0x1ul << EPWM_INTSTS1_BRKEIF3_Pos) /*!< EPWM_T::INTSTS1: BRKEIF3 Mask */ + +#define EPWM_INTSTS1_BRKEIF4_Pos (4) /*!< EPWM_T::INTSTS1: BRKEIF4 Position */ +#define EPWM_INTSTS1_BRKEIF4_Msk (0x1ul << EPWM_INTSTS1_BRKEIF4_Pos) /*!< EPWM_T::INTSTS1: BRKEIF4 Mask */ + +#define EPWM_INTSTS1_BRKEIF5_Pos (5) /*!< EPWM_T::INTSTS1: BRKEIF5 Position */ +#define EPWM_INTSTS1_BRKEIF5_Msk (0x1ul << EPWM_INTSTS1_BRKEIF5_Pos) /*!< EPWM_T::INTSTS1: BRKEIF5 Mask */ + +#define EPWM_INTSTS1_BRKLIF0_Pos (8) /*!< EPWM_T::INTSTS1: BRKLIF0 Position */ +#define EPWM_INTSTS1_BRKLIF0_Msk (0x1ul << EPWM_INTSTS1_BRKLIF0_Pos) /*!< EPWM_T::INTSTS1: BRKLIF0 Mask */ + +#define EPWM_INTSTS1_BRKLIF1_Pos (9) /*!< EPWM_T::INTSTS1: BRKLIF1 Position */ +#define EPWM_INTSTS1_BRKLIF1_Msk (0x1ul << EPWM_INTSTS1_BRKLIF1_Pos) /*!< EPWM_T::INTSTS1: BRKLIF1 Mask */ + +#define EPWM_INTSTS1_BRKLIF2_Pos (10) /*!< EPWM_T::INTSTS1: BRKLIF2 Position */ +#define EPWM_INTSTS1_BRKLIF2_Msk (0x1ul << EPWM_INTSTS1_BRKLIF2_Pos) /*!< EPWM_T::INTSTS1: BRKLIF2 Mask */ + +#define EPWM_INTSTS1_BRKLIF3_Pos (11) /*!< EPWM_T::INTSTS1: BRKLIF3 Position */ +#define EPWM_INTSTS1_BRKLIF3_Msk (0x1ul << EPWM_INTSTS1_BRKLIF3_Pos) /*!< EPWM_T::INTSTS1: BRKLIF3 Mask */ + +#define EPWM_INTSTS1_BRKLIF4_Pos (12) /*!< EPWM_T::INTSTS1: BRKLIF4 Position */ +#define EPWM_INTSTS1_BRKLIF4_Msk (0x1ul << EPWM_INTSTS1_BRKLIF4_Pos) /*!< EPWM_T::INTSTS1: BRKLIF4 Mask */ + +#define EPWM_INTSTS1_BRKLIF5_Pos (13) /*!< EPWM_T::INTSTS1: BRKLIF5 Position */ +#define EPWM_INTSTS1_BRKLIF5_Msk (0x1ul << EPWM_INTSTS1_BRKLIF5_Pos) /*!< EPWM_T::INTSTS1: BRKLIF5 Mask */ + +#define EPWM_INTSTS1_BRKESTS0_Pos (16) /*!< EPWM_T::INTSTS1: BRKESTS0 Position */ +#define EPWM_INTSTS1_BRKESTS0_Msk (0x1ul << EPWM_INTSTS1_BRKESTS0_Pos) /*!< EPWM_T::INTSTS1: BRKESTS0 Mask */ + +#define EPWM_INTSTS1_BRKESTS1_Pos (17) /*!< EPWM_T::INTSTS1: BRKESTS1 Position */ +#define EPWM_INTSTS1_BRKESTS1_Msk (0x1ul << EPWM_INTSTS1_BRKESTS1_Pos) /*!< EPWM_T::INTSTS1: BRKESTS1 Mask */ + +#define EPWM_INTSTS1_BRKESTS2_Pos (18) /*!< EPWM_T::INTSTS1: BRKESTS2 Position */ +#define EPWM_INTSTS1_BRKESTS2_Msk (0x1ul << EPWM_INTSTS1_BRKESTS2_Pos) /*!< EPWM_T::INTSTS1: BRKESTS2 Mask */ + +#define EPWM_INTSTS1_BRKESTS3_Pos (19) /*!< EPWM_T::INTSTS1: BRKESTS3 Position */ +#define EPWM_INTSTS1_BRKESTS3_Msk (0x1ul << EPWM_INTSTS1_BRKESTS3_Pos) /*!< EPWM_T::INTSTS1: BRKESTS3 Mask */ + +#define EPWM_INTSTS1_BRKESTS4_Pos (20) /*!< EPWM_T::INTSTS1: BRKESTS4 Position */ +#define EPWM_INTSTS1_BRKESTS4_Msk (0x1ul << EPWM_INTSTS1_BRKESTS4_Pos) /*!< EPWM_T::INTSTS1: BRKESTS4 Mask */ + +#define EPWM_INTSTS1_BRKESTS5_Pos (21) /*!< EPWM_T::INTSTS1: BRKESTS5 Position */ +#define EPWM_INTSTS1_BRKESTS5_Msk (0x1ul << EPWM_INTSTS1_BRKESTS5_Pos) /*!< EPWM_T::INTSTS1: BRKESTS5 Mask */ + +#define EPWM_INTSTS1_BRKLSTS0_Pos (24) /*!< EPWM_T::INTSTS1: BRKLSTS0 Position */ +#define EPWM_INTSTS1_BRKLSTS0_Msk (0x1ul << EPWM_INTSTS1_BRKLSTS0_Pos) /*!< EPWM_T::INTSTS1: BRKLSTS0 Mask */ + +#define EPWM_INTSTS1_BRKLSTS1_Pos (25) /*!< EPWM_T::INTSTS1: BRKLSTS1 Position */ +#define EPWM_INTSTS1_BRKLSTS1_Msk (0x1ul << EPWM_INTSTS1_BRKLSTS1_Pos) /*!< EPWM_T::INTSTS1: BRKLSTS1 Mask */ + +#define EPWM_INTSTS1_BRKLSTS2_Pos (26) /*!< EPWM_T::INTSTS1: BRKLSTS2 Position */ +#define EPWM_INTSTS1_BRKLSTS2_Msk (0x1ul << EPWM_INTSTS1_BRKLSTS2_Pos) /*!< EPWM_T::INTSTS1: BRKLSTS2 Mask */ + +#define EPWM_INTSTS1_BRKLSTS3_Pos (27) /*!< EPWM_T::INTSTS1: BRKLSTS3 Position */ +#define EPWM_INTSTS1_BRKLSTS3_Msk (0x1ul << EPWM_INTSTS1_BRKLSTS3_Pos) /*!< EPWM_T::INTSTS1: BRKLSTS3 Mask */ + +#define EPWM_INTSTS1_BRKLSTS4_Pos (28) /*!< EPWM_T::INTSTS1: BRKLSTS4 Position */ +#define EPWM_INTSTS1_BRKLSTS4_Msk (0x1ul << EPWM_INTSTS1_BRKLSTS4_Pos) /*!< EPWM_T::INTSTS1: BRKLSTS4 Mask */ + +#define EPWM_INTSTS1_BRKLSTS5_Pos (29) /*!< EPWM_T::INTSTS1: BRKLSTS5 Position */ +#define EPWM_INTSTS1_BRKLSTS5_Msk (0x1ul << EPWM_INTSTS1_BRKLSTS5_Pos) /*!< EPWM_T::INTSTS1: BRKLSTS5 Mask */ + +#define EPWM_DACTRGEN_ZTE0_Pos (0) /*!< EPWM_T::DACTRGEN: ZTE0 Position */ +#define EPWM_DACTRGEN_ZTE0_Msk (0x1ul << EPWM_DACTRGEN_ZTE0_Pos) /*!< EPWM_T::DACTRGEN: ZTE0 Mask */ + +#define EPWM_DACTRGEN_ZTE1_Pos (1) /*!< EPWM_T::DACTRGEN: ZTE1 Position */ +#define EPWM_DACTRGEN_ZTE1_Msk (0x1ul << EPWM_DACTRGEN_ZTE1_Pos) /*!< EPWM_T::DACTRGEN: ZTE1 Mask */ + +#define EPWM_DACTRGEN_ZTE2_Pos (2) /*!< EPWM_T::DACTRGEN: ZTE2 Position */ +#define EPWM_DACTRGEN_ZTE2_Msk (0x1ul << EPWM_DACTRGEN_ZTE2_Pos) /*!< EPWM_T::DACTRGEN: ZTE2 Mask */ + +#define EPWM_DACTRGEN_ZTE3_Pos (3) /*!< EPWM_T::DACTRGEN: ZTE3 Position */ +#define EPWM_DACTRGEN_ZTE3_Msk (0x1ul << EPWM_DACTRGEN_ZTE3_Pos) /*!< EPWM_T::DACTRGEN: ZTE3 Mask */ + +#define EPWM_DACTRGEN_ZTE4_Pos (4) /*!< EPWM_T::DACTRGEN: ZTE4 Position */ +#define EPWM_DACTRGEN_ZTE4_Msk (0x1ul << EPWM_DACTRGEN_ZTE4_Pos) /*!< EPWM_T::DACTRGEN: ZTE4 Mask */ + +#define EPWM_DACTRGEN_ZTE5_Pos (5) /*!< EPWM_T::DACTRGEN: ZTE5 Position */ +#define EPWM_DACTRGEN_ZTE5_Msk (0x1ul << EPWM_DACTRGEN_ZTE5_Pos) /*!< EPWM_T::DACTRGEN: ZTE5 Mask */ + +#define EPWM_DACTRGEN_PTE0_Pos (8) /*!< EPWM_T::DACTRGEN: PTE0 Position */ +#define EPWM_DACTRGEN_PTE0_Msk (0x1ul << EPWM_DACTRGEN_PTE0_Pos) /*!< EPWM_T::DACTRGEN: PTE0 Mask */ + +#define EPWM_DACTRGEN_PTE1_Pos (9) /*!< EPWM_T::DACTRGEN: PTE1 Position */ +#define EPWM_DACTRGEN_PTE1_Msk (0x1ul << EPWM_DACTRGEN_PTE1_Pos) /*!< EPWM_T::DACTRGEN: PTE1 Mask */ + +#define EPWM_DACTRGEN_PTE2_Pos (10) /*!< EPWM_T::DACTRGEN: PTE2 Position */ +#define EPWM_DACTRGEN_PTE2_Msk (0x1ul << EPWM_DACTRGEN_PTE2_Pos) /*!< EPWM_T::DACTRGEN: PTE2 Mask */ + +#define EPWM_DACTRGEN_PTE3_Pos (11) /*!< EPWM_T::DACTRGEN: PTE3 Position */ +#define EPWM_DACTRGEN_PTE3_Msk (0x1ul << EPWM_DACTRGEN_PTE3_Pos) /*!< EPWM_T::DACTRGEN: PTE3 Mask */ + +#define EPWM_DACTRGEN_PTE4_Pos (12) /*!< EPWM_T::DACTRGEN: PTE4 Position */ +#define EPWM_DACTRGEN_PTE4_Msk (0x1ul << EPWM_DACTRGEN_PTE4_Pos) /*!< EPWM_T::DACTRGEN: PTE4 Mask */ + +#define EPWM_DACTRGEN_PTE5_Pos (13) /*!< EPWM_T::DACTRGEN: PTE5 Position */ +#define EPWM_DACTRGEN_PTE5_Msk (0x1ul << EPWM_DACTRGEN_PTE5_Pos) /*!< EPWM_T::DACTRGEN: PTE5 Mask */ + +#define EPWM_DACTRGEN_CUTRGE0_Pos (16) /*!< EPWM_T::DACTRGEN: CUTRGE0 Position */ +#define EPWM_DACTRGEN_CUTRGE0_Msk (0x1ul << EPWM_DACTRGEN_CUTRGE0_Pos) /*!< EPWM_T::DACTRGEN: CUTRGE0 Mask */ + +#define EPWM_DACTRGEN_CUTRGE1_Pos (17) /*!< EPWM_T::DACTRGEN: CUTRGE1 Position */ +#define EPWM_DACTRGEN_CUTRGE1_Msk (0x1ul << EPWM_DACTRGEN_CUTRGE1_Pos) /*!< EPWM_T::DACTRGEN: CUTRGE1 Mask */ + +#define EPWM_DACTRGEN_CUTRGE2_Pos (18) /*!< EPWM_T::DACTRGEN: CUTRGE2 Position */ +#define EPWM_DACTRGEN_CUTRGE2_Msk (0x1ul << EPWM_DACTRGEN_CUTRGE2_Pos) /*!< EPWM_T::DACTRGEN: CUTRGE2 Mask */ + +#define EPWM_DACTRGEN_CUTRGE3_Pos (19) /*!< EPWM_T::DACTRGEN: CUTRGE3 Position */ +#define EPWM_DACTRGEN_CUTRGE3_Msk (0x1ul << EPWM_DACTRGEN_CUTRGE3_Pos) /*!< EPWM_T::DACTRGEN: CUTRGE3 Mask */ + +#define EPWM_DACTRGEN_CUTRGE4_Pos (20) /*!< EPWM_T::DACTRGEN: CUTRGE4 Position */ +#define EPWM_DACTRGEN_CUTRGE4_Msk (0x1ul << EPWM_DACTRGEN_CUTRGE4_Pos) /*!< EPWM_T::DACTRGEN: CUTRGE4 Mask */ + +#define EPWM_DACTRGEN_CUTRGE5_Pos (21) /*!< EPWM_T::DACTRGEN: CUTRGE5 Position */ +#define EPWM_DACTRGEN_CUTRGE5_Msk (0x1ul << EPWM_DACTRGEN_CUTRGE5_Pos) /*!< EPWM_T::DACTRGEN: CUTRGE5 Mask */ + +#define EPWM_DACTRGEN_CDTRGE0_Pos (24) /*!< EPWM_T::DACTRGEN: CDTRGE0 Position */ +#define EPWM_DACTRGEN_CDTRGE0_Msk (0x1ul << EPWM_DACTRGEN_CDTRGE0_Pos) /*!< EPWM_T::DACTRGEN: CDTRGE0 Mask */ + +#define EPWM_DACTRGEN_CDTRGE1_Pos (25) /*!< EPWM_T::DACTRGEN: CDTRGE1 Position */ +#define EPWM_DACTRGEN_CDTRGE1_Msk (0x1ul << EPWM_DACTRGEN_CDTRGE1_Pos) /*!< EPWM_T::DACTRGEN: CDTRGE1 Mask */ + +#define EPWM_DACTRGEN_CDTRGE2_Pos (26) /*!< EPWM_T::DACTRGEN: CDTRGE2 Position */ +#define EPWM_DACTRGEN_CDTRGE2_Msk (0x1ul << EPWM_DACTRGEN_CDTRGE2_Pos) /*!< EPWM_T::DACTRGEN: CDTRGE2 Mask */ + +#define EPWM_DACTRGEN_CDTRGE3_Pos (27) /*!< EPWM_T::DACTRGEN: CDTRGE3 Position */ +#define EPWM_DACTRGEN_CDTRGE3_Msk (0x1ul << EPWM_DACTRGEN_CDTRGE3_Pos) /*!< EPWM_T::DACTRGEN: CDTRGE3 Mask */ + +#define EPWM_DACTRGEN_CDTRGE4_Pos (28) /*!< EPWM_T::DACTRGEN: CDTRGE4 Position */ +#define EPWM_DACTRGEN_CDTRGE4_Msk (0x1ul << EPWM_DACTRGEN_CDTRGE4_Pos) /*!< EPWM_T::DACTRGEN: CDTRGE4 Mask */ + +#define EPWM_DACTRGEN_CDTRGE5_Pos (29) /*!< EPWM_T::DACTRGEN: CDTRGE5 Position */ +#define EPWM_DACTRGEN_CDTRGE5_Msk (0x1ul << EPWM_DACTRGEN_CDTRGE5_Pos) /*!< EPWM_T::DACTRGEN: CDTRGE5 Mask */ + +#define EPWM_EADCTS0_TRGSEL0_Pos (0) /*!< EPWM_T::EADCTS0: TRGSEL0 Position */ +#define EPWM_EADCTS0_TRGSEL0_Msk (0xful << EPWM_EADCTS0_TRGSEL0_Pos) /*!< EPWM_T::EADCTS0: TRGSEL0 Mask */ + +#define EPWM_EADCTS0_TRGEN0_Pos (7) /*!< EPWM_T::EADCTS0: TRGEN0 Position */ +#define EPWM_EADCTS0_TRGEN0_Msk (0x1ul << EPWM_EADCTS0_TRGEN0_Pos) /*!< EPWM_T::EADCTS0: TRGEN0 Mask */ + +#define EPWM_EADCTS0_TRGSEL1_Pos (8) /*!< EPWM_T::EADCTS0: TRGSEL1 Position */ +#define EPWM_EADCTS0_TRGSEL1_Msk (0xful << EPWM_EADCTS0_TRGSEL1_Pos) /*!< EPWM_T::EADCTS0: TRGSEL1 Mask */ + +#define EPWM_EADCTS0_TRGEN1_Pos (15) /*!< EPWM_T::EADCTS0: TRGEN1 Position */ +#define EPWM_EADCTS0_TRGEN1_Msk (0x1ul << EPWM_EADCTS0_TRGEN1_Pos) /*!< EPWM_T::EADCTS0: TRGEN1 Mask */ + +#define EPWM_EADCTS0_TRGSEL2_Pos (16) /*!< EPWM_T::EADCTS0: TRGSEL2 Position */ +#define EPWM_EADCTS0_TRGSEL2_Msk (0xful << EPWM_EADCTS0_TRGSEL2_Pos) /*!< EPWM_T::EADCTS0: TRGSEL2 Mask */ + +#define EPWM_EADCTS0_TRGEN2_Pos (23) /*!< EPWM_T::EADCTS0: TRGEN2 Position */ +#define EPWM_EADCTS0_TRGEN2_Msk (0x1ul << EPWM_EADCTS0_TRGEN2_Pos) /*!< EPWM_T::EADCTS0: TRGEN2 Mask */ + +#define EPWM_EADCTS0_TRGSEL3_Pos (24) /*!< EPWM_T::EADCTS0: TRGSEL3 Position */ +#define EPWM_EADCTS0_TRGSEL3_Msk (0xful << EPWM_EADCTS0_TRGSEL3_Pos) /*!< EPWM_T::EADCTS0: TRGSEL3 Mask */ + +#define EPWM_EADCTS0_TRGEN3_Pos (31) /*!< EPWM_T::EADCTS0: TRGEN3 Position */ +#define EPWM_EADCTS0_TRGEN3_Msk (0x1ul << EPWM_EADCTS0_TRGEN3_Pos) /*!< EPWM_T::EADCTS0: TRGEN3 Mask */ + +#define EPWM_EADCTS1_TRGSEL4_Pos (0) /*!< EPWM_T::EADCTS1: TRGSEL4 Position */ +#define EPWM_EADCTS1_TRGSEL4_Msk (0xful << EPWM_EADCTS1_TRGSEL4_Pos) /*!< EPWM_T::EADCTS1: TRGSEL4 Mask */ + +#define EPWM_EADCTS1_TRGEN4_Pos (7) /*!< EPWM_T::EADCTS1: TRGEN4 Position */ +#define EPWM_EADCTS1_TRGEN4_Msk (0x1ul << EPWM_EADCTS1_TRGEN4_Pos) /*!< EPWM_T::EADCTS1: TRGEN4 Mask */ + +#define EPWM_EADCTS1_TRGSEL5_Pos (8) /*!< EPWM_T::EADCTS1: TRGSEL5 Position */ +#define EPWM_EADCTS1_TRGSEL5_Msk (0xful << EPWM_EADCTS1_TRGSEL5_Pos) /*!< EPWM_T::EADCTS1: TRGSEL5 Mask */ + +#define EPWM_EADCTS1_TRGEN5_Pos (15) /*!< EPWM_T::EADCTS1: TRGEN5 Position */ +#define EPWM_EADCTS1_TRGEN5_Msk (0x1ul << EPWM_EADCTS1_TRGEN5_Pos) /*!< EPWM_T::EADCTS1: TRGEN5 Mask */ + +#define EPWM_FTCMPDAT0_1_FTCMP_Pos (0) /*!< EPWM_T::FTCMPDAT0_1: FTCMP Position */ +#define EPWM_FTCMPDAT0_1_FTCMP_Msk (0xfffful << EPWM_FTCMPDAT0_1_FTCMP_Pos) /*!< EPWM_T::FTCMPDAT0_1: FTCMP Mask */ + +#define EPWM_FTCMPDAT2_3_FTCMP_Pos (0) /*!< EPWM_T::FTCMPDAT2_3: FTCMP Position */ +#define EPWM_FTCMPDAT2_3_FTCMP_Msk (0xfffful << EPWM_FTCMPDAT2_3_FTCMP_Pos) /*!< EPWM_T::FTCMPDAT2_3: FTCMP Mask */ + +#define EPWM_FTCMPDAT4_5_FTCMP_Pos (0) /*!< EPWM_T::FTCMPDAT4_5: FTCMP Position */ +#define EPWM_FTCMPDAT4_5_FTCMP_Msk (0xfffful << EPWM_FTCMPDAT4_5_FTCMP_Pos) /*!< EPWM_T::FTCMPDAT4_5: FTCMP Mask */ + +#define EPWM_SSCTL_SSEN0_Pos (0) /*!< EPWM_T::SSCTL: SSEN0 Position */ +#define EPWM_SSCTL_SSEN0_Msk (0x1ul << EPWM_SSCTL_SSEN0_Pos) /*!< EPWM_T::SSCTL: SSEN0 Mask */ + +#define EPWM_SSCTL_SSEN1_Pos (1) /*!< EPWM_T::SSCTL: SSEN1 Position */ +#define EPWM_SSCTL_SSEN1_Msk (0x1ul << EPWM_SSCTL_SSEN1_Pos) /*!< EPWM_T::SSCTL: SSEN1 Mask */ + +#define EPWM_SSCTL_SSEN2_Pos (2) /*!< EPWM_T::SSCTL: SSEN2 Position */ +#define EPWM_SSCTL_SSEN2_Msk (0x1ul << EPWM_SSCTL_SSEN2_Pos) /*!< EPWM_T::SSCTL: SSEN2 Mask */ + +#define EPWM_SSCTL_SSEN3_Pos (3) /*!< EPWM_T::SSCTL: SSEN3 Position */ +#define EPWM_SSCTL_SSEN3_Msk (0x1ul << EPWM_SSCTL_SSEN3_Pos) /*!< EPWM_T::SSCTL: SSEN3 Mask */ + +#define EPWM_SSCTL_SSEN4_Pos (4) /*!< EPWM_T::SSCTL: SSEN4 Position */ +#define EPWM_SSCTL_SSEN4_Msk (0x1ul << EPWM_SSCTL_SSEN4_Pos) /*!< EPWM_T::SSCTL: SSEN4 Mask */ + +#define EPWM_SSCTL_SSEN5_Pos (5) /*!< EPWM_T::SSCTL: SSEN5 Position */ +#define EPWM_SSCTL_SSEN5_Msk (0x1ul << EPWM_SSCTL_SSEN5_Pos) /*!< EPWM_T::SSCTL: SSEN5 Mask */ + +#define EPWM_SSCTL_SSRC_Pos (8) /*!< EPWM_T::SSCTL: SSRC Position */ +#define EPWM_SSCTL_SSRC_Msk (0x3ul << EPWM_SSCTL_SSRC_Pos) /*!< EPWM_T::SSCTL: SSRC Mask */ + +#define EPWM_SSTRG_CNTSEN_Pos (0) /*!< EPWM_T::SSTRG: CNTSEN Position */ +#define EPWM_SSTRG_CNTSEN_Msk (0x1ul << EPWM_SSTRG_CNTSEN_Pos) /*!< EPWM_T::SSTRG: CNTSEN Mask */ + +#define EPWM_LEBCTL_LEBEN_Pos (0) /*!< EPWM_T::LEBCTL: LEBEN Position */ +#define EPWM_LEBCTL_LEBEN_Msk (0x1ul << EPWM_LEBCTL_LEBEN_Pos) /*!< EPWM_T::LEBCTL: LEBEN Mask */ + +#define EPWM_LEBCTL_SRCEN0_Pos (8) /*!< EPWM_T::LEBCTL: SRCEN0 Position */ +#define EPWM_LEBCTL_SRCEN0_Msk (0x1ul << EPWM_LEBCTL_SRCEN0_Pos) /*!< EPWM_T::LEBCTL: SRCEN0 Mask */ + +#define EPWM_LEBCTL_SRCEN2_Pos (9) /*!< EPWM_T::LEBCTL: SRCEN2 Position */ +#define EPWM_LEBCTL_SRCEN2_Msk (0x1ul << EPWM_LEBCTL_SRCEN2_Pos) /*!< EPWM_T::LEBCTL: SRCEN2 Mask */ + +#define EPWM_LEBCTL_SRCEN4_Pos (10) /*!< EPWM_T::LEBCTL: SRCEN4 Position */ +#define EPWM_LEBCTL_SRCEN4_Msk (0x1ul << EPWM_LEBCTL_SRCEN4_Pos) /*!< EPWM_T::LEBCTL: SRCEN4 Mask */ + +#define EPWM_LEBCTL_TRGTYPE_Pos (16) /*!< EPWM_T::LEBCTL: TRGTYPE Position */ +#define EPWM_LEBCTL_TRGTYPE_Msk (0x3ul << EPWM_LEBCTL_TRGTYPE_Pos) /*!< EPWM_T::LEBCTL: TRGTYPE Mask */ + +#define EPWM_LEBCNT_LEBCNT_Pos (0) /*!< EPWM_T::LEBCNT: LEBCNT Position */ +#define EPWM_LEBCNT_LEBCNT_Msk (0x1fful << EPWM_LEBCNT_LEBCNT_Pos) /*!< EPWM_T::LEBCNT: LEBCNT Mask */ + +#define EPWM_STATUS_CNTMAXF0_Pos (0) /*!< EPWM_T::STATUS: CNTMAXF0 Position */ +#define EPWM_STATUS_CNTMAXF0_Msk (0x1ul << EPWM_STATUS_CNTMAXF0_Pos) /*!< EPWM_T::STATUS: CNTMAXF0 Mask */ + +#define EPWM_STATUS_CNTMAXF1_Pos (1) /*!< EPWM_T::STATUS: CNTMAXF1 Position */ +#define EPWM_STATUS_CNTMAXF1_Msk (0x1ul << EPWM_STATUS_CNTMAXF1_Pos) /*!< EPWM_T::STATUS: CNTMAXF1 Mask */ + +#define EPWM_STATUS_CNTMAXF2_Pos (2) /*!< EPWM_T::STATUS: CNTMAXF2 Position */ +#define EPWM_STATUS_CNTMAXF2_Msk (0x1ul << EPWM_STATUS_CNTMAXF2_Pos) /*!< EPWM_T::STATUS: CNTMAXF2 Mask */ + +#define EPWM_STATUS_CNTMAXF3_Pos (3) /*!< EPWM_T::STATUS: CNTMAXF3 Position */ +#define EPWM_STATUS_CNTMAXF3_Msk (0x1ul << EPWM_STATUS_CNTMAXF3_Pos) /*!< EPWM_T::STATUS: CNTMAXF3 Mask */ + +#define EPWM_STATUS_CNTMAXF4_Pos (4) /*!< EPWM_T::STATUS: CNTMAXF4 Position */ +#define EPWM_STATUS_CNTMAXF4_Msk (0x1ul << EPWM_STATUS_CNTMAXF4_Pos) /*!< EPWM_T::STATUS: CNTMAXF4 Mask */ + +#define EPWM_STATUS_CNTMAXF5_Pos (5) /*!< EPWM_T::STATUS: CNTMAXF5 Position */ +#define EPWM_STATUS_CNTMAXF5_Msk (0x1ul << EPWM_STATUS_CNTMAXF5_Pos) /*!< EPWM_T::STATUS: CNTMAXF5 Mask */ + +#define EPWM_STATUS_SYNCINF0_Pos (8) /*!< EPWM_T::STATUS: SYNCINF0 Position */ +#define EPWM_STATUS_SYNCINF0_Msk (0x1ul << EPWM_STATUS_SYNCINF0_Pos) /*!< EPWM_T::STATUS: SYNCINF0 Mask */ + +#define EPWM_STATUS_SYNCINF2_Pos (9) /*!< EPWM_T::STATUS: SYNCINF2 Position */ +#define EPWM_STATUS_SYNCINF2_Msk (0x1ul << EPWM_STATUS_SYNCINF2_Pos) /*!< EPWM_T::STATUS: SYNCINF2 Mask */ + +#define EPWM_STATUS_SYNCINF4_Pos (10) /*!< EPWM_T::STATUS: SYNCINF4 Position */ +#define EPWM_STATUS_SYNCINF4_Msk (0x1ul << EPWM_STATUS_SYNCINF4_Pos) /*!< EPWM_T::STATUS: SYNCINF4 Mask */ + +#define EPWM_STATUS_EADCTRGF0_Pos (16) /*!< EPWM_T::STATUS: EADCTRGF0 Position */ +#define EPWM_STATUS_EADCTRGF0_Msk (0x1ul << EPWM_STATUS_EADCTRGF0_Pos) /*!< EPWM_T::STATUS: EADCTRGF0 Mask */ + +#define EPWM_STATUS_EADCTRGF1_Pos (17) /*!< EPWM_T::STATUS: EADCTRGF1 Position */ +#define EPWM_STATUS_EADCTRGF1_Msk (0x1ul << EPWM_STATUS_EADCTRGF1_Pos) /*!< EPWM_T::STATUS: EADCTRGF1 Mask */ + +#define EPWM_STATUS_EADCTRGF2_Pos (18) /*!< EPWM_T::STATUS: EADCTRGF2 Position */ +#define EPWM_STATUS_EADCTRGF2_Msk (0x1ul << EPWM_STATUS_EADCTRGF2_Pos) /*!< EPWM_T::STATUS: EADCTRGF2 Mask */ + +#define EPWM_STATUS_EADCTRGF3_Pos (19) /*!< EPWM_T::STATUS: EADCTRGF3 Position */ +#define EPWM_STATUS_EADCTRGF3_Msk (0x1ul << EPWM_STATUS_EADCTRGF3_Pos) /*!< EPWM_T::STATUS: EADCTRGF3 Mask */ + +#define EPWM_STATUS_EADCTRGF4_Pos (20) /*!< EPWM_T::STATUS: EADCTRGF4 Position */ +#define EPWM_STATUS_EADCTRGF4_Msk (0x1ul << EPWM_STATUS_EADCTRGF4_Pos) /*!< EPWM_T::STATUS: EADCTRGF4 Mask */ + +#define EPWM_STATUS_EADCTRGF5_Pos (21) /*!< EPWM_T::STATUS: EADCTRGF5 Position */ +#define EPWM_STATUS_EADCTRGF5_Msk (0x1ul << EPWM_STATUS_EADCTRGF5_Pos) /*!< EPWM_T::STATUS: EADCTRGF5 Mask */ + +#define EPWM_STATUS_DACTRGF_Pos (24) /*!< EPWM_T::STATUS: DACTRGF Position */ +#define EPWM_STATUS_DACTRGF_Msk (0x1ul << EPWM_STATUS_DACTRGF_Pos) /*!< EPWM_T::STATUS: DACTRGF Mask */ + +#define EPWM_IFA0_IFACNT_Pos (0) /*!< EPWM_T::IFA0: IFACNT Position */ +#define EPWM_IFA0_IFACNT_Msk (0xfffful << EPWM_IFA0_IFACNT_Pos) /*!< EPWM_T::IFA0: IFACNT Mask */ + +#define EPWM_IFA0_STPMOD_Pos (24) /*!< EPWM_T::IFA0: STPMOD Position */ +#define EPWM_IFA0_STPMOD_Msk (0x1ul << EPWM_IFA0_STPMOD_Pos) /*!< EPWM_T::IFA0: STPMOD Mask */ + +#define EPWM_IFA0_IFASEL_Pos (28) /*!< EPWM_T::IFA0: IFASEL Position */ +#define EPWM_IFA0_IFASEL_Msk (0x3ul << EPWM_IFA0_IFASEL_Pos) /*!< EPWM_T::IFA0: IFASEL Mask */ + +#define EPWM_IFA0_IFAEN_Pos (31) /*!< EPWM_T::IFA0: IFAEN Position */ +#define EPWM_IFA0_IFAEN_Msk (0x1ul << EPWM_IFA0_IFAEN_Pos) /*!< EPWM_T::IFA0: IFAEN Mask */ + +#define EPWM_IFA1_IFACNT_Pos (0) /*!< EPWM_T::IFA1: IFACNT Position */ +#define EPWM_IFA1_IFACNT_Msk (0xfffful << EPWM_IFA1_IFACNT_Pos) /*!< EPWM_T::IFA1: IFACNT Mask */ + +#define EPWM_IFA1_STPMOD_Pos (24) /*!< EPWM_T::IFA1: STPMOD Position */ +#define EPWM_IFA1_STPMOD_Msk (0x1ul << EPWM_IFA1_STPMOD_Pos) /*!< EPWM_T::IFA1: STPMOD Mask */ + +#define EPWM_IFA1_IFASEL_Pos (28) /*!< EPWM_T::IFA1: IFASEL Position */ +#define EPWM_IFA1_IFASEL_Msk (0x3ul << EPWM_IFA1_IFASEL_Pos) /*!< EPWM_T::IFA1: IFASEL Mask */ + +#define EPWM_IFA1_IFAEN_Pos (31) /*!< EPWM_T::IFA1: IFAEN Position */ +#define EPWM_IFA1_IFAEN_Msk (0x1ul << EPWM_IFA1_IFAEN_Pos) /*!< EPWM_T::IFA1: IFAEN Mask */ + +#define EPWM_IFA2_IFACNT_Pos (0) /*!< EPWM_T::IFA2: IFACNT Position */ +#define EPWM_IFA2_IFACNT_Msk (0xfffful << EPWM_IFA2_IFACNT_Pos) /*!< EPWM_T::IFA2: IFACNT Mask */ + +#define EPWM_IFA2_STPMOD_Pos (24) /*!< EPWM_T::IFA2: STPMOD Position */ +#define EPWM_IFA2_STPMOD_Msk (0x1ul << EPWM_IFA2_STPMOD_Pos) /*!< EPWM_T::IFA2: STPMOD Mask */ + +#define EPWM_IFA2_IFASEL_Pos (28) /*!< EPWM_T::IFA2: IFASEL Position */ +#define EPWM_IFA2_IFASEL_Msk (0x3ul << EPWM_IFA2_IFASEL_Pos) /*!< EPWM_T::IFA2: IFASEL Mask */ + +#define EPWM_IFA2_IFAEN_Pos (31) /*!< EPWM_T::IFA2: IFAEN Position */ +#define EPWM_IFA2_IFAEN_Msk (0x1ul << EPWM_IFA2_IFAEN_Pos) /*!< EPWM_T::IFA2: IFAEN Mask */ + +#define EPWM_IFA3_IFACNT_Pos (0) /*!< EPWM_T::IFA3: IFACNT Position */ +#define EPWM_IFA3_IFACNT_Msk (0xfffful << EPWM_IFA3_IFACNT_Pos) /*!< EPWM_T::IFA3: IFACNT Mask */ + +#define EPWM_IFA3_STPMOD_Pos (24) /*!< EPWM_T::IFA3: STPMOD Position */ +#define EPWM_IFA3_STPMOD_Msk (0x1ul << EPWM_IFA3_STPMOD_Pos) /*!< EPWM_T::IFA3: STPMOD Mask */ + +#define EPWM_IFA3_IFASEL_Pos (28) /*!< EPWM_T::IFA3: IFASEL Position */ +#define EPWM_IFA3_IFASEL_Msk (0x3ul << EPWM_IFA3_IFASEL_Pos) /*!< EPWM_T::IFA3: IFASEL Mask */ + +#define EPWM_IFA3_IFAEN_Pos (31) /*!< EPWM_T::IFA3: IFAEN Position */ +#define EPWM_IFA3_IFAEN_Msk (0x1ul << EPWM_IFA3_IFAEN_Pos) /*!< EPWM_T::IFA3: IFAEN Mask */ + +#define EPWM_IFA4_IFACNT_Pos (0) /*!< EPWM_T::IFA4: IFACNT Position */ +#define EPWM_IFA4_IFACNT_Msk (0xfffful << EPWM_IFA4_IFACNT_Pos) /*!< EPWM_T::IFA4: IFACNT Mask */ + +#define EPWM_IFA4_STPMOD_Pos (24) /*!< EPWM_T::IFA4: STPMOD Position */ +#define EPWM_IFA4_STPMOD_Msk (0x1ul << EPWM_IFA4_STPMOD_Pos) /*!< EPWM_T::IFA4: STPMOD Mask */ + +#define EPWM_IFA4_IFASEL_Pos (28) /*!< EPWM_T::IFA4: IFASEL Position */ +#define EPWM_IFA4_IFASEL_Msk (0x3ul << EPWM_IFA4_IFASEL_Pos) /*!< EPWM_T::IFA4: IFASEL Mask */ + +#define EPWM_IFA4_IFAEN_Pos (31) /*!< EPWM_T::IFA4: IFAEN Position */ +#define EPWM_IFA4_IFAEN_Msk (0x1ul << EPWM_IFA4_IFAEN_Pos) /*!< EPWM_T::IFA4: IFAEN Mask */ + +#define EPWM_IFA5_IFACNT_Pos (0) /*!< EPWM_T::IFA5: IFACNT Position */ +#define EPWM_IFA5_IFACNT_Msk (0xfffful << EPWM_IFA5_IFACNT_Pos) /*!< EPWM_T::IFA5: IFACNT Mask */ + +#define EPWM_IFA5_STPMOD_Pos (24) /*!< EPWM_T::IFA5: STPMOD Position */ +#define EPWM_IFA5_STPMOD_Msk (0x1ul << EPWM_IFA5_STPMOD_Pos) /*!< EPWM_T::IFA5: STPMOD Mask */ + +#define EPWM_IFA5_IFASEL_Pos (28) /*!< EPWM_T::IFA5: IFASEL Position */ +#define EPWM_IFA5_IFASEL_Msk (0x3ul << EPWM_IFA5_IFASEL_Pos) /*!< EPWM_T::IFA5: IFASEL Mask */ + +#define EPWM_IFA5_IFAEN_Pos (31) /*!< EPWM_T::IFA5: IFAEN Position */ +#define EPWM_IFA5_IFAEN_Msk (0x1ul << EPWM_IFA5_IFAEN_Pos) /*!< EPWM_T::IFA5: IFAEN Mask */ + +#define EPWM_AINTSTS_IFAIF0_Pos (0) /*!< EPWM_T::AINTSTS: IFAIF0 Position */ +#define EPWM_AINTSTS_IFAIF0_Msk (0x1ul << EPWM_AINTSTS_IFAIF0_Pos) /*!< EPWM_T::AINTSTS: IFAIF0 Mask */ + +#define EPWM_AINTSTS_IFAIF1_Pos (1) /*!< EPWM_T::AINTSTS: IFAIF1 Position */ +#define EPWM_AINTSTS_IFAIF1_Msk (0x1ul << EPWM_AINTSTS_IFAIF1_Pos) /*!< EPWM_T::AINTSTS: IFAIF1 Mask */ + +#define EPWM_AINTSTS_IFAIF2_Pos (2) /*!< EPWM_T::AINTSTS: IFAIF2 Position */ +#define EPWM_AINTSTS_IFAIF2_Msk (0x1ul << EPWM_AINTSTS_IFAIF2_Pos) /*!< EPWM_T::AINTSTS: IFAIF2 Mask */ + +#define EPWM_AINTSTS_IFAIF3_Pos (3) /*!< EPWM_T::AINTSTS: IFAIF3 Position */ +#define EPWM_AINTSTS_IFAIF3_Msk (0x1ul << EPWM_AINTSTS_IFAIF3_Pos) /*!< EPWM_T::AINTSTS: IFAIF3 Mask */ + +#define EPWM_AINTSTS_IFAIF4_Pos (4) /*!< EPWM_T::AINTSTS: IFAIF4 Position */ +#define EPWM_AINTSTS_IFAIF4_Msk (0x1ul << EPWM_AINTSTS_IFAIF4_Pos) /*!< EPWM_T::AINTSTS: IFAIF4 Mask */ + +#define EPWM_AINTSTS_IFAIF5_Pos (5) /*!< EPWM_T::AINTSTS: IFAIF5 Position */ +#define EPWM_AINTSTS_IFAIF5_Msk (0x1ul << EPWM_AINTSTS_IFAIF5_Pos) /*!< EPWM_T::AINTSTS: IFAIF5 Mask */ + +#define EPWM_AINTEN_IFAIEN0_Pos (0) /*!< EPWM_T::AINTEN: IFAIEN0 Position */ +#define EPWM_AINTEN_IFAIEN0_Msk (0x1ul << EPWM_AINTEN_IFAIEN0_Pos) /*!< EPWM_T::AINTEN: IFAIEN0 Mask */ + +#define EPWM_AINTEN_IFAIEN1_Pos (1) /*!< EPWM_T::AINTEN: IFAIEN1 Position */ +#define EPWM_AINTEN_IFAIEN1_Msk (0x1ul << EPWM_AINTEN_IFAIEN1_Pos) /*!< EPWM_T::AINTEN: IFAIEN1 Mask */ + +#define EPWM_AINTEN_IFAIEN2_Pos (2) /*!< EPWM_T::AINTEN: IFAIEN2 Position */ +#define EPWM_AINTEN_IFAIEN2_Msk (0x1ul << EPWM_AINTEN_IFAIEN2_Pos) /*!< EPWM_T::AINTEN: IFAIEN2 Mask */ + +#define EPWM_AINTEN_IFAIEN3_Pos (3) /*!< EPWM_T::AINTEN: IFAIEN3 Position */ +#define EPWM_AINTEN_IFAIEN3_Msk (0x1ul << EPWM_AINTEN_IFAIEN3_Pos) /*!< EPWM_T::AINTEN: IFAIEN3 Mask */ + +#define EPWM_AINTEN_IFAIEN4_Pos (4) /*!< EPWM_T::AINTEN: IFAIEN4 Position */ +#define EPWM_AINTEN_IFAIEN4_Msk (0x1ul << EPWM_AINTEN_IFAIEN4_Pos) /*!< EPWM_T::AINTEN: IFAIEN4 Mask */ + +#define EPWM_AINTEN_IFAIEN5_Pos (5) /*!< EPWM_T::AINTEN: IFAIEN5 Position */ +#define EPWM_AINTEN_IFAIEN5_Msk (0x1ul << EPWM_AINTEN_IFAIEN5_Pos) /*!< EPWM_T::AINTEN: IFAIEN5 Mask */ + +#define EPWM_APDMACTL_APDMAEN0_Pos (0) /*!< EPWM_T::APDMACTL: APDMAEN0 Position */ +#define EPWM_APDMACTL_APDMAEN0_Msk (0x1ul << EPWM_APDMACTL_APDMAEN0_Pos) /*!< EPWM_T::APDMACTL: APDMAEN0 Mask */ + +#define EPWM_APDMACTL_APDMAEN1_Pos (1) /*!< EPWM_T::APDMACTL: APDMAEN1 Position */ +#define EPWM_APDMACTL_APDMAEN1_Msk (0x1ul << EPWM_APDMACTL_APDMAEN1_Pos) /*!< EPWM_T::APDMACTL: APDMAEN1 Mask */ + +#define EPWM_APDMACTL_APDMAEN2_Pos (2) /*!< EPWM_T::APDMACTL: APDMAEN2 Position */ +#define EPWM_APDMACTL_APDMAEN2_Msk (0x1ul << EPWM_APDMACTL_APDMAEN2_Pos) /*!< EPWM_T::APDMACTL: APDMAEN2 Mask */ + +#define EPWM_APDMACTL_APDMAEN3_Pos (3) /*!< EPWM_T::APDMACTL: APDMAEN3 Position */ +#define EPWM_APDMACTL_APDMAEN3_Msk (0x1ul << EPWM_APDMACTL_APDMAEN3_Pos) /*!< EPWM_T::APDMACTL: APDMAEN3 Mask */ + +#define EPWM_APDMACTL_APDMAEN4_Pos (4) /*!< EPWM_T::APDMACTL: APDMAEN4 Position */ +#define EPWM_APDMACTL_APDMAEN4_Msk (0x1ul << EPWM_APDMACTL_APDMAEN4_Pos) /*!< EPWM_T::APDMACTL: APDMAEN4 Mask */ + +#define EPWM_APDMACTL_APDMAEN5_Pos (5) /*!< EPWM_T::APDMACTL: APDMAEN5 Position */ +#define EPWM_APDMACTL_APDMAEN5_Msk (0x1ul << EPWM_APDMACTL_APDMAEN5_Pos) /*!< EPWM_T::APDMACTL: APDMAEN5 Mask */ + +#define EPWM_FDEN_FDEN0_Pos (0) /*!< EPWM_T::FDEN: FDEN0 Position */ +#define EPWM_FDEN_FDEN0_Msk (0x1ul << EPWM_FDEN_FDEN0_Pos) /*!< EPWM_T::FDEN: FDEN0 Mask */ + +#define EPWM_FDEN_FDEN1_Pos (1) /*!< EPWM_T::FDEN: FDEN1 Position */ +#define EPWM_FDEN_FDEN1_Msk (0x1ul << EPWM_FDEN_FDEN1_Pos) /*!< EPWM_T::FDEN: FDEN1 Mask */ + +#define EPWM_FDEN_FDEN2_Pos (2) /*!< EPWM_T::FDEN: FDEN2 Position */ +#define EPWM_FDEN_FDEN2_Msk (0x1ul << EPWM_FDEN_FDEN2_Pos) /*!< EPWM_T::FDEN: FDEN2 Mask */ + +#define EPWM_FDEN_FDEN3_Pos (3) /*!< EPWM_T::FDEN: FDEN3 Position */ +#define EPWM_FDEN_FDEN3_Msk (0x1ul << EPWM_FDEN_FDEN3_Pos) /*!< EPWM_T::FDEN: FDEN3 Mask */ + +#define EPWM_FDEN_FDEN4_Pos (4) /*!< EPWM_T::FDEN: FDEN4 Position */ +#define EPWM_FDEN_FDEN4_Msk (0x1ul << EPWM_FDEN_FDEN4_Pos) /*!< EPWM_T::FDEN: FDEN4 Mask */ + +#define EPWM_FDEN_FDEN5_Pos (5) /*!< EPWM_T::FDEN: FDEN5 Position */ +#define EPWM_FDEN_FDEN5_Msk (0x1ul << EPWM_FDEN_FDEN5_Pos) /*!< EPWM_T::FDEN: FDEN5 Mask */ + +#define EPWM_FDEN_FDODIS0_Pos (8) /*!< EPWM_T::FDEN: FDODIS0 Position */ +#define EPWM_FDEN_FDODIS0_Msk (0x1ul << EPWM_FDEN_FDODIS0_Pos) /*!< EPWM_T::FDEN: FDODIS0 Mask */ + +#define EPWM_FDEN_FDODIS1_Pos (9) /*!< EPWM_T::FDEN: FDODIS1 Position */ +#define EPWM_FDEN_FDODIS1_Msk (0x1ul << EPWM_FDEN_FDODIS1_Pos) /*!< EPWM_T::FDEN: FDODIS1 Mask */ + +#define EPWM_FDEN_FDODIS2_Pos (10) /*!< EPWM_T::FDEN: FDODIS2 Position */ +#define EPWM_FDEN_FDODIS2_Msk (0x1ul << EPWM_FDEN_FDODIS2_Pos) /*!< EPWM_T::FDEN: FDODIS2 Mask */ + +#define EPWM_FDEN_FDODIS3_Pos (11) /*!< EPWM_T::FDEN: FDODIS3 Position */ +#define EPWM_FDEN_FDODIS3_Msk (0x1ul << EPWM_FDEN_FDODIS3_Pos) /*!< EPWM_T::FDEN: FDODIS3 Mask */ + +#define EPWM_FDEN_FDODIS4_Pos (12) /*!< EPWM_T::FDEN: FDODIS4 Position */ +#define EPWM_FDEN_FDODIS4_Msk (0x1ul << EPWM_FDEN_FDODIS4_Pos) /*!< EPWM_T::FDEN: FDODIS4 Mask */ + +#define EPWM_FDEN_FDODIS5_Pos (13) /*!< EPWM_T::FDEN: FDODIS5 Position */ +#define EPWM_FDEN_FDODIS5_Msk (0x1ul << EPWM_FDEN_FDODIS5_Pos) /*!< EPWM_T::FDEN: FDODIS5 Mask */ + +#define EPWM_FDEN_FDCKS0_Pos (16) /*!< EPWM_T::FDEN: FDCKS0 Position */ +#define EPWM_FDEN_FDCKS0_Msk (0x1ul << EPWM_FDEN_FDCKS0_Pos) /*!< EPWM_T::FDEN: FDCKS0 Mask */ + +#define EPWM_FDEN_FDCKS1_Pos (17) /*!< EPWM_T::FDEN: FDCKS1 Position */ +#define EPWM_FDEN_FDCKS1_Msk (0x1ul << EPWM_FDEN_FDCKS1_Pos) /*!< EPWM_T::FDEN: FDCKS1 Mask */ + +#define EPWM_FDEN_FDCKS2_Pos (18) /*!< EPWM_T::FDEN: FDCKS2 Position */ +#define EPWM_FDEN_FDCKS2_Msk (0x1ul << EPWM_FDEN_FDCKS2_Pos) /*!< EPWM_T::FDEN: FDCKS2 Mask */ + +#define EPWM_FDEN_FDCKS3_Pos (19) /*!< EPWM_T::FDEN: FDCKS3 Position */ +#define EPWM_FDEN_FDCKS3_Msk (0x1ul << EPWM_FDEN_FDCKS3_Pos) /*!< EPWM_T::FDEN: FDCKS3 Mask */ + +#define EPWM_FDEN_FDCKS4_Pos (20) /*!< EPWM_T::FDEN: FDCKS4 Position */ +#define EPWM_FDEN_FDCKS4_Msk (0x1ul << EPWM_FDEN_FDCKS4_Pos) /*!< EPWM_T::FDEN: FDCKS4 Mask */ + +#define EPWM_FDEN_FDCKS5_Pos (21) /*!< EPWM_T::FDEN: FDCKS5 Position */ +#define EPWM_FDEN_FDCKS5_Msk (0x1ul << EPWM_FDEN_FDCKS5_Pos) /*!< EPWM_T::FDEN: FDCKS5 Mask */ + +#define EPWM_FDCTL0_TRMSKCNT_Pos (0) /*!< EPWM_T::FDCTL0: TRMSKCNT Position */ +#define EPWM_FDCTL0_TRMSKCNT_Msk (0x7ful << EPWM_FDCTL0_TRMSKCNT_Pos) /*!< EPWM_T::FDCTL0: TRMSKCNT Mask */ + +#define EPWM_FDCTL0_FDMSKEN_Pos (15) /*!< EPWM_T::FDCTL0: FDMSKEN Position */ +#define EPWM_FDCTL0_FDMSKEN_Msk (0x1ul << EPWM_FDCTL0_FDMSKEN_Pos) /*!< EPWM_T::FDCTL0: FDMSKEN Mask */ + +#define EPWM_FDCTL0_DGSMPCYC_Pos (16) /*!< EPWM_T::FDCTL0: DGSMPCYC Position */ +#define EPWM_FDCTL0_DGSMPCYC_Msk (0x7ul << EPWM_FDCTL0_DGSMPCYC_Pos) /*!< EPWM_T::FDCTL0: DGSMPCYC Mask */ + +#define EPWM_FDCTL0_FDCKSEL_Pos (28) /*!< EPWM_T::FDCTL0: FDCKSEL Position */ +#define EPWM_FDCTL0_FDCKSEL_Msk (0x3ul << EPWM_FDCTL0_FDCKSEL_Pos) /*!< EPWM_T::FDCTL0: FDCKSEL Mask */ + +#define EPWM_FDCTL0_FDDGEN_Pos (31) /*!< EPWM_T::FDCTL0: FDDGEN Position */ +#define EPWM_FDCTL0_FDDGEN_Msk (0x1ul << EPWM_FDCTL0_FDDGEN_Pos) /*!< EPWM_T::FDCTL0: FDDGEN Mask */ + +#define EPWM_FDCTL1_TRMSKCNT_Pos (0) /*!< EPWM_T::FDCTL1: TRMSKCNT Position */ +#define EPWM_FDCTL1_TRMSKCNT_Msk (0x7ful << EPWM_FDCTL1_TRMSKCNT_Pos) /*!< EPWM_T::FDCTL1: TRMSKCNT Mask */ + +#define EPWM_FDCTL1_FDMSKEN_Pos (15) /*!< EPWM_T::FDCTL1: FDMSKEN Position */ +#define EPWM_FDCTL1_FDMSKEN_Msk (0x1ul << EPWM_FDCTL1_FDMSKEN_Pos) /*!< EPWM_T::FDCTL1: FDMSKEN Mask */ + +#define EPWM_FDCTL1_DGSMPCYC_Pos (16) /*!< EPWM_T::FDCTL1: DGSMPCYC Position */ +#define EPWM_FDCTL1_DGSMPCYC_Msk (0x7ul << EPWM_FDCTL1_DGSMPCYC_Pos) /*!< EPWM_T::FDCTL1: DGSMPCYC Mask */ + +#define EPWM_FDCTL1_FDCKSEL_Pos (28) /*!< EPWM_T::FDCTL1: FDCKSEL Position */ +#define EPWM_FDCTL1_FDCKSEL_Msk (0x3ul << EPWM_FDCTL1_FDCKSEL_Pos) /*!< EPWM_T::FDCTL1: FDCKSEL Mask */ + +#define EPWM_FDCTL1_FDDGEN_Pos (31) /*!< EPWM_T::FDCTL1: FDDGEN Position */ +#define EPWM_FDCTL1_FDDGEN_Msk (0x1ul << EPWM_FDCTL1_FDDGEN_Pos) /*!< EPWM_T::FDCTL1: FDDGEN Mask */ + +#define EPWM_FDCTL2_TRMSKCNT_Pos (0) /*!< EPWM_T::FDCTL2: TRMSKCNT Position */ +#define EPWM_FDCTL2_TRMSKCNT_Msk (0x7ful << EPWM_FDCTL2_TRMSKCNT_Pos) /*!< EPWM_T::FDCTL2: TRMSKCNT Mask */ + +#define EPWM_FDCTL2_FDMSKEN_Pos (15) /*!< EPWM_T::FDCTL2: FDMSKEN Position */ +#define EPWM_FDCTL2_FDMSKEN_Msk (0x1ul << EPWM_FDCTL2_FDMSKEN_Pos) /*!< EPWM_T::FDCTL2: FDMSKEN Mask */ + +#define EPWM_FDCTL2_DGSMPCYC_Pos (16) /*!< EPWM_T::FDCTL2: DGSMPCYC Position */ +#define EPWM_FDCTL2_DGSMPCYC_Msk (0x7ul << EPWM_FDCTL2_DGSMPCYC_Pos) /*!< EPWM_T::FDCTL2: DGSMPCYC Mask */ + +#define EPWM_FDCTL2_FDCKSEL_Pos (28) /*!< EPWM_T::FDCTL2: FDCKSEL Position */ +#define EPWM_FDCTL2_FDCKSEL_Msk (0x3ul << EPWM_FDCTL2_FDCKSEL_Pos) /*!< EPWM_T::FDCTL2: FDCKSEL Mask */ + +#define EPWM_FDCTL2_FDDGEN_Pos (31) /*!< EPWM_T::FDCTL2: FDDGEN Position */ +#define EPWM_FDCTL2_FDDGEN_Msk (0x1ul << EPWM_FDCTL2_FDDGEN_Pos) /*!< EPWM_T::FDCTL2: FDDGEN Mask */ + +#define EPWM_FDCTL3_TRMSKCNT_Pos (0) /*!< EPWM_T::FDCTL3: TRMSKCNT Position */ +#define EPWM_FDCTL3_TRMSKCNT_Msk (0x7ful << EPWM_FDCTL3_TRMSKCNT_Pos) /*!< EPWM_T::FDCTL3: TRMSKCNT Mask */ + +#define EPWM_FDCTL3_FDMSKEN_Pos (15) /*!< EPWM_T::FDCTL3: FDMSKEN Position */ +#define EPWM_FDCTL3_FDMSKEN_Msk (0x1ul << EPWM_FDCTL3_FDMSKEN_Pos) /*!< EPWM_T::FDCTL3: FDMSKEN Mask */ + +#define EPWM_FDCTL3_DGSMPCYC_Pos (16) /*!< EPWM_T::FDCTL3: DGSMPCYC Position */ +#define EPWM_FDCTL3_DGSMPCYC_Msk (0x7ul << EPWM_FDCTL3_DGSMPCYC_Pos) /*!< EPWM_T::FDCTL3: DGSMPCYC Mask */ + +#define EPWM_FDCTL3_FDCKSEL_Pos (28) /*!< EPWM_T::FDCTL3: FDCKSEL Position */ +#define EPWM_FDCTL3_FDCKSEL_Msk (0x3ul << EPWM_FDCTL3_FDCKSEL_Pos) /*!< EPWM_T::FDCTL3: FDCKSEL Mask */ + +#define EPWM_FDCTL3_FDDGEN_Pos (31) /*!< EPWM_T::FDCTL3: FDDGEN Position */ +#define EPWM_FDCTL3_FDDGEN_Msk (0x1ul << EPWM_FDCTL3_FDDGEN_Pos) /*!< EPWM_T::FDCTL3: FDDGEN Mask */ + +#define EPWM_FDCTL4_TRMSKCNT_Pos (0) /*!< EPWM_T::FDCTL4: TRMSKCNT Position */ +#define EPWM_FDCTL4_TRMSKCNT_Msk (0x7ful << EPWM_FDCTL4_TRMSKCNT_Pos) /*!< EPWM_T::FDCTL4: TRMSKCNT Mask */ + +#define EPWM_FDCTL4_FDMSKEN_Pos (15) /*!< EPWM_T::FDCTL4: FDMSKEN Position */ +#define EPWM_FDCTL4_FDMSKEN_Msk (0x1ul << EPWM_FDCTL4_FDMSKEN_Pos) /*!< EPWM_T::FDCTL4: FDMSKEN Mask */ + +#define EPWM_FDCTL4_DGSMPCYC_Pos (16) /*!< EPWM_T::FDCTL4: DGSMPCYC Position */ +#define EPWM_FDCTL4_DGSMPCYC_Msk (0x7ul << EPWM_FDCTL4_DGSMPCYC_Pos) /*!< EPWM_T::FDCTL4: DGSMPCYC Mask */ + +#define EPWM_FDCTL4_FDCKSEL_Pos (28) /*!< EPWM_T::FDCTL4: FDCKSEL Position */ +#define EPWM_FDCTL4_FDCKSEL_Msk (0x3ul << EPWM_FDCTL4_FDCKSEL_Pos) /*!< EPWM_T::FDCTL4: FDCKSEL Mask */ + +#define EPWM_FDCTL4_FDDGEN_Pos (31) /*!< EPWM_T::FDCTL4: FDDGEN Position */ +#define EPWM_FDCTL4_FDDGEN_Msk (0x1ul << EPWM_FDCTL4_FDDGEN_Pos) /*!< EPWM_T::FDCTL4: FDDGEN Mask */ + +#define EPWM_FDCTL5_TRMSKCNT_Pos (0) /*!< EPWM_T::FDCTL5: TRMSKCNT Position */ +#define EPWM_FDCTL5_TRMSKCNT_Msk (0x7ful << EPWM_FDCTL5_TRMSKCNT_Pos) /*!< EPWM_T::FDCTL5: TRMSKCNT Mask */ + +#define EPWM_FDCTL5_FDMSKEN_Pos (15) /*!< EPWM_T::FDCTL5: FDMSKEN Position */ +#define EPWM_FDCTL5_FDMSKEN_Msk (0x1ul << EPWM_FDCTL5_FDMSKEN_Pos) /*!< EPWM_T::FDCTL5: FDMSKEN Mask */ + +#define EPWM_FDCTL5_DGSMPCYC_Pos (16) /*!< EPWM_T::FDCTL5: DGSMPCYC Position */ +#define EPWM_FDCTL5_DGSMPCYC_Msk (0x7ul << EPWM_FDCTL5_DGSMPCYC_Pos) /*!< EPWM_T::FDCTL5: DGSMPCYC Mask */ + +#define EPWM_FDCTL5_FDCKSEL_Pos (28) /*!< EPWM_T::FDCTL5: FDCKSEL Position */ +#define EPWM_FDCTL5_FDCKSEL_Msk (0x3ul << EPWM_FDCTL5_FDCKSEL_Pos) /*!< EPWM_T::FDCTL5: FDCKSEL Mask */ + +#define EPWM_FDCTL5_FDDGEN_Pos (31) /*!< EPWM_T::FDCTL5: FDDGEN Position */ +#define EPWM_FDCTL5_FDDGEN_Msk (0x1ul << EPWM_FDCTL5_FDDGEN_Pos) /*!< EPWM_T::FDCTL5: FDDGEN Mask */ + +#define EPWM_FDIEN_FDIEN0_Pos (0) /*!< EPWM_T::FDIEN: FDIEN0 Position */ +#define EPWM_FDIEN_FDIEN0_Msk (0x1ul << EPWM_FDIEN_FDIEN0_Pos) /*!< EPWM_T::FDIEN: FDIEN0 Mask */ + +#define EPWM_FDIEN_FDIEN1_Pos (1) /*!< EPWM_T::FDIEN: FDIEN1 Position */ +#define EPWM_FDIEN_FDIEN1_Msk (0x1ul << EPWM_FDIEN_FDIEN1_Pos) /*!< EPWM_T::FDIEN: FDIEN1 Mask */ + +#define EPWM_FDIEN_FDIEN2_Pos (2) /*!< EPWM_T::FDIEN: FDIEN2 Position */ +#define EPWM_FDIEN_FDIEN2_Msk (0x1ul << EPWM_FDIEN_FDIEN2_Pos) /*!< EPWM_T::FDIEN: FDIEN2 Mask */ + +#define EPWM_FDIEN_FDIEN3_Pos (3) /*!< EPWM_T::FDIEN: FDIEN3 Position */ +#define EPWM_FDIEN_FDIEN3_Msk (0x1ul << EPWM_FDIEN_FDIEN3_Pos) /*!< EPWM_T::FDIEN: FDIEN3 Mask */ + +#define EPWM_FDIEN_FDIEN4_Pos (4) /*!< EPWM_T::FDIEN: FDIEN4 Position */ +#define EPWM_FDIEN_FDIEN4_Msk (0x1ul << EPWM_FDIEN_FDIEN4_Pos) /*!< EPWM_T::FDIEN: FDIEN4 Mask */ + +#define EPWM_FDIEN_FDIEN5_Pos (5) /*!< EPWM_T::FDIEN: FDIEN5 Position */ +#define EPWM_FDIEN_FDIEN5_Msk (0x1ul << EPWM_FDIEN_FDIEN5_Pos) /*!< EPWM_T::FDIEN: FDIEN5 Mask */ + +#define EPWM_FDSTS_FDIF0_Pos (0) /*!< EPWM_T::FDSTS: FDIF0 Position */ +#define EPWM_FDSTS_FDIF0_Msk (0x1ul << EPWM_FDSTS_FDIF0_Pos) /*!< EPWM_T::FDSTS: FDIF0 Mask */ + +#define EPWM_FDSTS_FDIF1_Pos (1) /*!< EPWM_T::FDSTS: FDIF1 Position */ +#define EPWM_FDSTS_FDIF1_Msk (0x1ul << EPWM_FDSTS_FDIF1_Pos) /*!< EPWM_T::FDSTS: FDIF1 Mask */ + +#define EPWM_FDSTS_FDIF2_Pos (2) /*!< EPWM_T::FDSTS: FDIF2 Position */ +#define EPWM_FDSTS_FDIF2_Msk (0x1ul << EPWM_FDSTS_FDIF2_Pos) /*!< EPWM_T::FDSTS: FDIF2 Mask */ + +#define EPWM_FDSTS_FDIF3_Pos (3) /*!< EPWM_T::FDSTS: FDIF3 Position */ +#define EPWM_FDSTS_FDIF3_Msk (0x1ul << EPWM_FDSTS_FDIF3_Pos) /*!< EPWM_T::FDSTS: FDIF3 Mask */ + +#define EPWM_FDSTS_FDIF4_Pos (4) /*!< EPWM_T::FDSTS: FDIF4 Position */ +#define EPWM_FDSTS_FDIF4_Msk (0x1ul << EPWM_FDSTS_FDIF4_Pos) /*!< EPWM_T::FDSTS: FDIF4 Mask */ + +#define EPWM_FDSTS_FDIF5_Pos (5) /*!< EPWM_T::FDSTS: FDIF5 Position */ +#define EPWM_FDSTS_FDIF5_Msk (0x1ul << EPWM_FDSTS_FDIF5_Pos) /*!< EPWM_T::FDSTS: FDIF5 Mask */ + +#define EPWM_EADCPSCCTL_PSCEN0_Pos (0) /*!< EPWM_T::EADCPSCCTL: PSCEN0 Position */ +#define EPWM_EADCPSCCTL_PSCEN0_Msk (0x1ul << EPWM_EADCPSCCTL_PSCEN0_Pos) /*!< EPWM_T::EADCPSCCTL: PSCEN0 Mask */ + +#define EPWM_EADCPSCCTL_PSCEN1_Pos (1) /*!< EPWM_T::EADCPSCCTL: PSCEN1 Position */ +#define EPWM_EADCPSCCTL_PSCEN1_Msk (0x1ul << EPWM_EADCPSCCTL_PSCEN1_Pos) /*!< EPWM_T::EADCPSCCTL: PSCEN1 Mask */ + +#define EPWM_EADCPSCCTL_PSCEN2_Pos (2) /*!< EPWM_T::EADCPSCCTL: PSCEN2 Position */ +#define EPWM_EADCPSCCTL_PSCEN2_Msk (0x1ul << EPWM_EADCPSCCTL_PSCEN2_Pos) /*!< EPWM_T::EADCPSCCTL: PSCEN2 Mask */ + +#define EPWM_EADCPSCCTL_PSCEN3_Pos (3) /*!< EPWM_T::EADCPSCCTL: PSCEN3 Position */ +#define EPWM_EADCPSCCTL_PSCEN3_Msk (0x1ul << EPWM_EADCPSCCTL_PSCEN3_Pos) /*!< EPWM_T::EADCPSCCTL: PSCEN3 Mask */ + +#define EPWM_EADCPSCCTL_PSCEN4_Pos (4) /*!< EPWM_T::EADCPSCCTL: PSCEN4 Position */ +#define EPWM_EADCPSCCTL_PSCEN4_Msk (0x1ul << EPWM_EADCPSCCTL_PSCEN4_Pos) /*!< EPWM_T::EADCPSCCTL: PSCEN4 Mask */ + +#define EPWM_EADCPSCCTL_PSCEN5_Pos (5) /*!< EPWM_T::EADCPSCCTL: PSCEN5 Position */ +#define EPWM_EADCPSCCTL_PSCEN5_Msk (0x1ul << EPWM_EADCPSCCTL_PSCEN5_Pos) /*!< EPWM_T::EADCPSCCTL: PSCEN5 Mask */ + +#define EPWM_EADCPSC0_EADCPSC0_Pos (0) /*!< EPWM_T::EADCPSC0: EADCPSC0 Position */ +#define EPWM_EADCPSC0_EADCPSC0_Msk (0xful << EPWM_EADCPSC0_EADCPSC0_Pos) /*!< EPWM_T::EADCPSC0: EADCPSC0 Mask */ + +#define EPWM_EADCPSC0_EADCPSC1_Pos (8) /*!< EPWM_T::EADCPSC0: EADCPSC1 Position */ +#define EPWM_EADCPSC0_EADCPSC1_Msk (0xful << EPWM_EADCPSC0_EADCPSC1_Pos) /*!< EPWM_T::EADCPSC0: EADCPSC1 Mask */ + +#define EPWM_EADCPSC0_EADCPSC2_Pos (16) /*!< EPWM_T::EADCPSC0: EADCPSC2 Position */ +#define EPWM_EADCPSC0_EADCPSC2_Msk (0xful << EPWM_EADCPSC0_EADCPSC2_Pos) /*!< EPWM_T::EADCPSC0: EADCPSC2 Mask */ + +#define EPWM_EADCPSC0_EADCPSC3_Pos (24) /*!< EPWM_T::EADCPSC0: EADCPSC3 Position */ +#define EPWM_EADCPSC0_EADCPSC3_Msk (0xful << EPWM_EADCPSC0_EADCPSC3_Pos) /*!< EPWM_T::EADCPSC0: EADCPSC3 Mask */ + +#define EPWM_EADCPSC1_EADCPSC4_Pos (0) /*!< EPWM_T::EADCPSC1: EADCPSC4 Position */ +#define EPWM_EADCPSC1_EADCPSC4_Msk (0xful << EPWM_EADCPSC1_EADCPSC4_Pos) /*!< EPWM_T::EADCPSC1: EADCPSC4 Mask */ + +#define EPWM_EADCPSC1_EADCPSC5_Pos (8) /*!< EPWM_T::EADCPSC1: EADCPSC5 Position */ +#define EPWM_EADCPSC1_EADCPSC5_Msk (0xful << EPWM_EADCPSC1_EADCPSC5_Pos) /*!< EPWM_T::EADCPSC1: EADCPSC5 Mask */ + +#define EPWM_EADCPSCNT0_PSCNT0_Pos (0) /*!< EPWM_T::EADCPSCNT0: PSCNT0 Position */ +#define EPWM_EADCPSCNT0_PSCNT0_Msk (0xful << EPWM_EADCPSCNT0_PSCNT0_Pos) /*!< EPWM_T::EADCPSCNT0: PSCNT0 Mask */ + +#define EPWM_EADCPSCNT0_PSCNT1_Pos (8) /*!< EPWM_T::EADCPSCNT0: PSCNT1 Position */ +#define EPWM_EADCPSCNT0_PSCNT1_Msk (0xful << EPWM_EADCPSCNT0_PSCNT1_Pos) /*!< EPWM_T::EADCPSCNT0: PSCNT1 Mask */ + +#define EPWM_EADCPSCNT0_PSCNT2_Pos (16) /*!< EPWM_T::EADCPSCNT0: PSCNT2 Position */ +#define EPWM_EADCPSCNT0_PSCNT2_Msk (0xful << EPWM_EADCPSCNT0_PSCNT2_Pos) /*!< EPWM_T::EADCPSCNT0: PSCNT2 Mask */ + +#define EPWM_EADCPSCNT0_PSCNT3_Pos (24) /*!< EPWM_T::EADCPSCNT0: PSCNT3 Position */ +#define EPWM_EADCPSCNT0_PSCNT3_Msk (0xful << EPWM_EADCPSCNT0_PSCNT3_Pos) /*!< EPWM_T::EADCPSCNT0: PSCNT3 Mask */ + +#define EPWM_EADCPSCNT1_PSCNT4_Pos (0) /*!< EPWM_T::EADCPSCNT1: PSCNT4 Position */ +#define EPWM_EADCPSCNT1_PSCNT4_Msk (0xful << EPWM_EADCPSCNT1_PSCNT4_Pos) /*!< EPWM_T::EADCPSCNT1: PSCNT4 Mask */ + +#define EPWM_EADCPSCNT1_PSCNT5_Pos (8) /*!< EPWM_T::EADCPSCNT1: PSCNT5 Position */ +#define EPWM_EADCPSCNT1_PSCNT5_Msk (0xful << EPWM_EADCPSCNT1_PSCNT5_Pos) /*!< EPWM_T::EADCPSCNT1: PSCNT5 Mask */ + +#define EPWM_CAPINEN_CAPINEN0_Pos (0) /*!< EPWM_T::CAPINEN: CAPINEN0 Position */ +#define EPWM_CAPINEN_CAPINEN0_Msk (0x1ul << EPWM_CAPINEN_CAPINEN0_Pos) /*!< EPWM_T::CAPINEN: CAPINEN0 Mask */ + +#define EPWM_CAPINEN_CAPINEN1_Pos (1) /*!< EPWM_T::CAPINEN: CAPINEN1 Position */ +#define EPWM_CAPINEN_CAPINEN1_Msk (0x1ul << EPWM_CAPINEN_CAPINEN1_Pos) /*!< EPWM_T::CAPINEN: CAPINEN1 Mask */ + +#define EPWM_CAPINEN_CAPINEN2_Pos (2) /*!< EPWM_T::CAPINEN: CAPINEN2 Position */ +#define EPWM_CAPINEN_CAPINEN2_Msk (0x1ul << EPWM_CAPINEN_CAPINEN2_Pos) /*!< EPWM_T::CAPINEN: CAPINEN2 Mask */ + +#define EPWM_CAPINEN_CAPINEN3_Pos (3) /*!< EPWM_T::CAPINEN: CAPINEN3 Position */ +#define EPWM_CAPINEN_CAPINEN3_Msk (0x1ul << EPWM_CAPINEN_CAPINEN3_Pos) /*!< EPWM_T::CAPINEN: CAPINEN3 Mask */ + +#define EPWM_CAPINEN_CAPINEN4_Pos (4) /*!< EPWM_T::CAPINEN: CAPINEN4 Position */ +#define EPWM_CAPINEN_CAPINEN4_Msk (0x1ul << EPWM_CAPINEN_CAPINEN4_Pos) /*!< EPWM_T::CAPINEN: CAPINEN4 Mask */ + +#define EPWM_CAPINEN_CAPINEN5_Pos (5) /*!< EPWM_T::CAPINEN: CAPINEN5 Position */ +#define EPWM_CAPINEN_CAPINEN5_Msk (0x1ul << EPWM_CAPINEN_CAPINEN5_Pos) /*!< EPWM_T::CAPINEN: CAPINEN5 Mask */ + +#define EPWM_CAPCTL_CAPEN0_Pos (0) /*!< EPWM_T::CAPCTL: CAPEN0 Position */ +#define EPWM_CAPCTL_CAPEN0_Msk (0x1ul << EPWM_CAPCTL_CAPEN0_Pos) /*!< EPWM_T::CAPCTL: CAPEN0 Mask */ + +#define EPWM_CAPCTL_CAPEN1_Pos (1) /*!< EPWM_T::CAPCTL: CAPEN1 Position */ +#define EPWM_CAPCTL_CAPEN1_Msk (0x1ul << EPWM_CAPCTL_CAPEN1_Pos) /*!< EPWM_T::CAPCTL: CAPEN1 Mask */ + +#define EPWM_CAPCTL_CAPEN2_Pos (2) /*!< EPWM_T::CAPCTL: CAPEN2 Position */ +#define EPWM_CAPCTL_CAPEN2_Msk (0x1ul << EPWM_CAPCTL_CAPEN2_Pos) /*!< EPWM_T::CAPCTL: CAPEN2 Mask */ + +#define EPWM_CAPCTL_CAPEN3_Pos (3) /*!< EPWM_T::CAPCTL: CAPEN3 Position */ +#define EPWM_CAPCTL_CAPEN3_Msk (0x1ul << EPWM_CAPCTL_CAPEN3_Pos) /*!< EPWM_T::CAPCTL: CAPEN3 Mask */ + +#define EPWM_CAPCTL_CAPEN4_Pos (4) /*!< EPWM_T::CAPCTL: CAPEN4 Position */ +#define EPWM_CAPCTL_CAPEN4_Msk (0x1ul << EPWM_CAPCTL_CAPEN4_Pos) /*!< EPWM_T::CAPCTL: CAPEN4 Mask */ + +#define EPWM_CAPCTL_CAPEN5_Pos (5) /*!< EPWM_T::CAPCTL: CAPEN5 Position */ +#define EPWM_CAPCTL_CAPEN5_Msk (0x1ul << EPWM_CAPCTL_CAPEN5_Pos) /*!< EPWM_T::CAPCTL: CAPEN5 Mask */ + +#define EPWM_CAPCTL_CAPINV0_Pos (8) /*!< EPWM_T::CAPCTL: CAPINV0 Position */ +#define EPWM_CAPCTL_CAPINV0_Msk (0x1ul << EPWM_CAPCTL_CAPINV0_Pos) /*!< EPWM_T::CAPCTL: CAPINV0 Mask */ + +#define EPWM_CAPCTL_CAPINV1_Pos (9) /*!< EPWM_T::CAPCTL: CAPINV1 Position */ +#define EPWM_CAPCTL_CAPINV1_Msk (0x1ul << EPWM_CAPCTL_CAPINV1_Pos) /*!< EPWM_T::CAPCTL: CAPINV1 Mask */ + +#define EPWM_CAPCTL_CAPINV2_Pos (10) /*!< EPWM_T::CAPCTL: CAPINV2 Position */ +#define EPWM_CAPCTL_CAPINV2_Msk (0x1ul << EPWM_CAPCTL_CAPINV2_Pos) /*!< EPWM_T::CAPCTL: CAPINV2 Mask */ + +#define EPWM_CAPCTL_CAPINV3_Pos (11) /*!< EPWM_T::CAPCTL: CAPINV3 Position */ +#define EPWM_CAPCTL_CAPINV3_Msk (0x1ul << EPWM_CAPCTL_CAPINV3_Pos) /*!< EPWM_T::CAPCTL: CAPINV3 Mask */ + +#define EPWM_CAPCTL_CAPINV4_Pos (12) /*!< EPWM_T::CAPCTL: CAPINV4 Position */ +#define EPWM_CAPCTL_CAPINV4_Msk (0x1ul << EPWM_CAPCTL_CAPINV4_Pos) /*!< EPWM_T::CAPCTL: CAPINV4 Mask */ + +#define EPWM_CAPCTL_CAPINV5_Pos (13) /*!< EPWM_T::CAPCTL: CAPINV5 Position */ +#define EPWM_CAPCTL_CAPINV5_Msk (0x1ul << EPWM_CAPCTL_CAPINV5_Pos) /*!< EPWM_T::CAPCTL: CAPINV5 Mask */ + +#define EPWM_CAPCTL_RCRLDEN0_Pos (16) /*!< EPWM_T::CAPCTL: RCRLDEN0 Position */ +#define EPWM_CAPCTL_RCRLDEN0_Msk (0x1ul << EPWM_CAPCTL_RCRLDEN0_Pos) /*!< EPWM_T::CAPCTL: RCRLDEN0 Mask */ + +#define EPWM_CAPCTL_RCRLDEN1_Pos (17) /*!< EPWM_T::CAPCTL: RCRLDEN1 Position */ +#define EPWM_CAPCTL_RCRLDEN1_Msk (0x1ul << EPWM_CAPCTL_RCRLDEN1_Pos) /*!< EPWM_T::CAPCTL: RCRLDEN1 Mask */ + +#define EPWM_CAPCTL_RCRLDEN2_Pos (18) /*!< EPWM_T::CAPCTL: RCRLDEN2 Position */ +#define EPWM_CAPCTL_RCRLDEN2_Msk (0x1ul << EPWM_CAPCTL_RCRLDEN2_Pos) /*!< EPWM_T::CAPCTL: RCRLDEN2 Mask */ + +#define EPWM_CAPCTL_RCRLDEN3_Pos (19) /*!< EPWM_T::CAPCTL: RCRLDEN3 Position */ +#define EPWM_CAPCTL_RCRLDEN3_Msk (0x1ul << EPWM_CAPCTL_RCRLDEN3_Pos) /*!< EPWM_T::CAPCTL: RCRLDEN3 Mask */ + +#define EPWM_CAPCTL_RCRLDEN4_Pos (20) /*!< EPWM_T::CAPCTL: RCRLDEN4 Position */ +#define EPWM_CAPCTL_RCRLDEN4_Msk (0x1ul << EPWM_CAPCTL_RCRLDEN4_Pos) /*!< EPWM_T::CAPCTL: RCRLDEN4 Mask */ + +#define EPWM_CAPCTL_RCRLDEN5_Pos (21) /*!< EPWM_T::CAPCTL: RCRLDEN5 Position */ +#define EPWM_CAPCTL_RCRLDEN5_Msk (0x1ul << EPWM_CAPCTL_RCRLDEN5_Pos) /*!< EPWM_T::CAPCTL: RCRLDEN5 Mask */ + +#define EPWM_CAPCTL_FCRLDEN0_Pos (24) /*!< EPWM_T::CAPCTL: FCRLDEN0 Position */ +#define EPWM_CAPCTL_FCRLDEN0_Msk (0x1ul << EPWM_CAPCTL_FCRLDEN0_Pos) /*!< EPWM_T::CAPCTL: FCRLDEN0 Mask */ + +#define EPWM_CAPCTL_FCRLDEN1_Pos (25) /*!< EPWM_T::CAPCTL: FCRLDEN1 Position */ +#define EPWM_CAPCTL_FCRLDEN1_Msk (0x1ul << EPWM_CAPCTL_FCRLDEN1_Pos) /*!< EPWM_T::CAPCTL: FCRLDEN1 Mask */ + +#define EPWM_CAPCTL_FCRLDEN2_Pos (26) /*!< EPWM_T::CAPCTL: FCRLDEN2 Position */ +#define EPWM_CAPCTL_FCRLDEN2_Msk (0x1ul << EPWM_CAPCTL_FCRLDEN2_Pos) /*!< EPWM_T::CAPCTL: FCRLDEN2 Mask */ + +#define EPWM_CAPCTL_FCRLDEN3_Pos (27) /*!< EPWM_T::CAPCTL: FCRLDEN3 Position */ +#define EPWM_CAPCTL_FCRLDEN3_Msk (0x1ul << EPWM_CAPCTL_FCRLDEN3_Pos) /*!< EPWM_T::CAPCTL: FCRLDEN3 Mask */ + +#define EPWM_CAPCTL_FCRLDEN4_Pos (28) /*!< EPWM_T::CAPCTL: FCRLDEN4 Position */ +#define EPWM_CAPCTL_FCRLDEN4_Msk (0x1ul << EPWM_CAPCTL_FCRLDEN4_Pos) /*!< EPWM_T::CAPCTL: FCRLDEN4 Mask */ + +#define EPWM_CAPCTL_FCRLDEN5_Pos (29) /*!< EPWM_T::CAPCTL: FCRLDEN5 Position */ +#define EPWM_CAPCTL_FCRLDEN5_Msk (0x1ul << EPWM_CAPCTL_FCRLDEN5_Pos) /*!< EPWM_T::CAPCTL: FCRLDEN5 Mask */ + +#define EPWM_CAPSTS_CRLIFOV0_Pos (0) /*!< EPWM_T::CAPSTS: CRLIFOV0 Position */ +#define EPWM_CAPSTS_CRLIFOV0_Msk (0x1ul << EPWM_CAPSTS_CRLIFOV0_Pos) /*!< EPWM_T::CAPSTS: CRLIFOV0 Mask */ + +#define EPWM_CAPSTS_CRLIFOV1_Pos (1) /*!< EPWM_T::CAPSTS: CRLIFOV1 Position */ +#define EPWM_CAPSTS_CRLIFOV1_Msk (0x1ul << EPWM_CAPSTS_CRLIFOV1_Pos) /*!< EPWM_T::CAPSTS: CRLIFOV1 Mask */ + +#define EPWM_CAPSTS_CRLIFOV2_Pos (2) /*!< EPWM_T::CAPSTS: CRLIFOV2 Position */ +#define EPWM_CAPSTS_CRLIFOV2_Msk (0x1ul << EPWM_CAPSTS_CRLIFOV2_Pos) /*!< EPWM_T::CAPSTS: CRLIFOV2 Mask */ + +#define EPWM_CAPSTS_CRLIFOV3_Pos (3) /*!< EPWM_T::CAPSTS: CRLIFOV3 Position */ +#define EPWM_CAPSTS_CRLIFOV3_Msk (0x1ul << EPWM_CAPSTS_CRLIFOV3_Pos) /*!< EPWM_T::CAPSTS: CRLIFOV3 Mask */ + +#define EPWM_CAPSTS_CRLIFOV4_Pos (4) /*!< EPWM_T::CAPSTS: CRLIFOV4 Position */ +#define EPWM_CAPSTS_CRLIFOV4_Msk (0x1ul << EPWM_CAPSTS_CRLIFOV4_Pos) /*!< EPWM_T::CAPSTS: CRLIFOV4 Mask */ + +#define EPWM_CAPSTS_CRLIFOV5_Pos (5) /*!< EPWM_T::CAPSTS: CRLIFOV5 Position */ +#define EPWM_CAPSTS_CRLIFOV5_Msk (0x1ul << EPWM_CAPSTS_CRLIFOV5_Pos) /*!< EPWM_T::CAPSTS: CRLIFOV5 Mask */ + +#define EPWM_CAPSTS_CFLIFOV0_Pos (8) /*!< EPWM_T::CAPSTS: CFLIFOV0 Position */ +#define EPWM_CAPSTS_CFLIFOV0_Msk (0x1ul << EPWM_CAPSTS_CFLIFOV0_Pos) /*!< EPWM_T::CAPSTS: CFLIFOV0 Mask */ + +#define EPWM_CAPSTS_CFLIFOV1_Pos (9) /*!< EPWM_T::CAPSTS: CFLIFOV1 Position */ +#define EPWM_CAPSTS_CFLIFOV1_Msk (0x1ul << EPWM_CAPSTS_CFLIFOV1_Pos) /*!< EPWM_T::CAPSTS: CFLIFOV1 Mask */ + +#define EPWM_CAPSTS_CFLIFOV2_Pos (10) /*!< EPWM_T::CAPSTS: CFLIFOV2 Position */ +#define EPWM_CAPSTS_CFLIFOV2_Msk (0x1ul << EPWM_CAPSTS_CFLIFOV2_Pos) /*!< EPWM_T::CAPSTS: CFLIFOV2 Mask */ + +#define EPWM_CAPSTS_CFLIFOV3_Pos (11) /*!< EPWM_T::CAPSTS: CFLIFOV3 Position */ +#define EPWM_CAPSTS_CFLIFOV3_Msk (0x1ul << EPWM_CAPSTS_CFLIFOV3_Pos) /*!< EPWM_T::CAPSTS: CFLIFOV3 Mask */ + +#define EPWM_CAPSTS_CFLIFOV4_Pos (12) /*!< EPWM_T::CAPSTS: CFLIFOV4 Position */ +#define EPWM_CAPSTS_CFLIFOV4_Msk (0x1ul << EPWM_CAPSTS_CFLIFOV4_Pos) /*!< EPWM_T::CAPSTS: CFLIFOV4 Mask */ + +#define EPWM_CAPSTS_CFLIFOV5_Pos (13) /*!< EPWM_T::CAPSTS: CFLIFOV5 Position */ +#define EPWM_CAPSTS_CFLIFOV5_Msk (0x1ul << EPWM_CAPSTS_CFLIFOV5_Pos) /*!< EPWM_T::CAPSTS: CFLIFOV5 Mask */ + +#define EPWM_RCAPDAT0_RCAPDAT_Pos (0) /*!< EPWM_T::RCAPDAT0: RCAPDAT Position */ +#define EPWM_RCAPDAT0_RCAPDAT_Msk (0xfffful << EPWM_RCAPDAT0_RCAPDAT_Pos) /*!< EPWM_T::RCAPDAT0: RCAPDAT Mask */ + +#define EPWM_FCAPDAT0_FCAPDAT_Pos (0) /*!< EPWM_T::FCAPDAT0: FCAPDAT Position */ +#define EPWM_FCAPDAT0_FCAPDAT_Msk (0xfffful << EPWM_FCAPDAT0_FCAPDAT_Pos) /*!< EPWM_T::FCAPDAT0: FCAPDAT Mask */ + +#define EPWM_RCAPDAT1_RCAPDAT_Pos (0) /*!< EPWM_T::RCAPDAT1: RCAPDAT Position */ +#define EPWM_RCAPDAT1_RCAPDAT_Msk (0xfffful << EPWM_RCAPDAT1_RCAPDAT_Pos) /*!< EPWM_T::RCAPDAT1: RCAPDAT Mask */ + +#define EPWM_FCAPDAT1_FCAPDAT_Pos (0) /*!< EPWM_T::FCAPDAT1: FCAPDAT Position */ +#define EPWM_FCAPDAT1_FCAPDAT_Msk (0xfffful << EPWM_FCAPDAT1_FCAPDAT_Pos) /*!< EPWM_T::FCAPDAT1: FCAPDAT Mask */ + +#define EPWM_RCAPDAT2_RCAPDAT_Pos (0) /*!< EPWM_T::RCAPDAT2: RCAPDAT Position */ +#define EPWM_RCAPDAT2_RCAPDAT_Msk (0xfffful << EPWM_RCAPDAT2_RCAPDAT_Pos) /*!< EPWM_T::RCAPDAT2: RCAPDAT Mask */ + +#define EPWM_FCAPDAT2_FCAPDAT_Pos (0) /*!< EPWM_T::FCAPDAT2: FCAPDAT Position */ +#define EPWM_FCAPDAT2_FCAPDAT_Msk (0xfffful << EPWM_FCAPDAT2_FCAPDAT_Pos) /*!< EPWM_T::FCAPDAT2: FCAPDAT Mask */ + +#define EPWM_RCAPDAT3_RCAPDAT_Pos (0) /*!< EPWM_T::RCAPDAT3: RCAPDAT Position */ +#define EPWM_RCAPDAT3_RCAPDAT_Msk (0xfffful << EPWM_RCAPDAT3_RCAPDAT_Pos) /*!< EPWM_T::RCAPDAT3: RCAPDAT Mask */ + +#define EPWM_FCAPDAT3_FCAPDAT_Pos (0) /*!< EPWM_T::FCAPDAT3: FCAPDAT Position */ +#define EPWM_FCAPDAT3_FCAPDAT_Msk (0xfffful << EPWM_FCAPDAT3_FCAPDAT_Pos) /*!< EPWM_T::FCAPDAT3: FCAPDAT Mask */ + +#define EPWM_RCAPDAT4_RCAPDAT_Pos (0) /*!< EPWM_T::RCAPDAT4: RCAPDAT Position */ +#define EPWM_RCAPDAT4_RCAPDAT_Msk (0xfffful << EPWM_RCAPDAT4_RCAPDAT_Pos) /*!< EPWM_T::RCAPDAT4: RCAPDAT Mask */ + +#define EPWM_FCAPDAT4_FCAPDAT_Pos (0) /*!< EPWM_T::FCAPDAT4: FCAPDAT Position */ +#define EPWM_FCAPDAT4_FCAPDAT_Msk (0xfffful << EPWM_FCAPDAT4_FCAPDAT_Pos) /*!< EPWM_T::FCAPDAT4: FCAPDAT Mask */ + +#define EPWM_RCAPDAT5_RCAPDAT_Pos (0) /*!< EPWM_T::RCAPDAT5: RCAPDAT Position */ +#define EPWM_RCAPDAT5_RCAPDAT_Msk (0xfffful << EPWM_RCAPDAT5_RCAPDAT_Pos) /*!< EPWM_T::RCAPDAT5: RCAPDAT Mask */ + +#define EPWM_FCAPDAT5_FCAPDAT_Pos (0) /*!< EPWM_T::FCAPDAT5: FCAPDAT Position */ +#define EPWM_FCAPDAT5_FCAPDAT_Msk (0xfffful << EPWM_FCAPDAT5_FCAPDAT_Pos) /*!< EPWM_T::FCAPDAT5: FCAPDAT Mask */ + +#define EPWM_PDMACTL_CHEN0_1_Pos (0) /*!< EPWM_T::PDMACTL: CHEN0_1 Position */ +#define EPWM_PDMACTL_CHEN0_1_Msk (0x1ul << EPWM_PDMACTL_CHEN0_1_Pos) /*!< EPWM_T::PDMACTL: CHEN0_1 Mask */ + +#define EPWM_PDMACTL_CAPMOD0_1_Pos (1) /*!< EPWM_T::PDMACTL: CAPMOD0_1 Position */ +#define EPWM_PDMACTL_CAPMOD0_1_Msk (0x3ul << EPWM_PDMACTL_CAPMOD0_1_Pos) /*!< EPWM_T::PDMACTL: CAPMOD0_1 Mask */ + +#define EPWM_PDMACTL_CAPORD0_1_Pos (3) /*!< EPWM_T::PDMACTL: CAPORD0_1 Position */ +#define EPWM_PDMACTL_CAPORD0_1_Msk (0x1ul << EPWM_PDMACTL_CAPORD0_1_Pos) /*!< EPWM_T::PDMACTL: CAPORD0_1 Mask */ + +#define EPWM_PDMACTL_CHSEL0_1_Pos (4) /*!< EPWM_T::PDMACTL: CHSEL0_1 Position */ +#define EPWM_PDMACTL_CHSEL0_1_Msk (0x1ul << EPWM_PDMACTL_CHSEL0_1_Pos) /*!< EPWM_T::PDMACTL: CHSEL0_1 Mask */ + +#define EPWM_PDMACTL_CHEN2_3_Pos (8) /*!< EPWM_T::PDMACTL: CHEN2_3 Position */ +#define EPWM_PDMACTL_CHEN2_3_Msk (0x1ul << EPWM_PDMACTL_CHEN2_3_Pos) /*!< EPWM_T::PDMACTL: CHEN2_3 Mask */ + +#define EPWM_PDMACTL_CAPMOD2_3_Pos (9) /*!< EPWM_T::PDMACTL: CAPMOD2_3 Position */ +#define EPWM_PDMACTL_CAPMOD2_3_Msk (0x3ul << EPWM_PDMACTL_CAPMOD2_3_Pos) /*!< EPWM_T::PDMACTL: CAPMOD2_3 Mask */ + +#define EPWM_PDMACTL_CAPORD2_3_Pos (11) /*!< EPWM_T::PDMACTL: CAPORD2_3 Position */ +#define EPWM_PDMACTL_CAPORD2_3_Msk (0x1ul << EPWM_PDMACTL_CAPORD2_3_Pos) /*!< EPWM_T::PDMACTL: CAPORD2_3 Mask */ + +#define EPWM_PDMACTL_CHSEL2_3_Pos (12) /*!< EPWM_T::PDMACTL: CHSEL2_3 Position */ +#define EPWM_PDMACTL_CHSEL2_3_Msk (0x1ul << EPWM_PDMACTL_CHSEL2_3_Pos) /*!< EPWM_T::PDMACTL: CHSEL2_3 Mask */ + +#define EPWM_PDMACTL_CHEN4_5_Pos (16) /*!< EPWM_T::PDMACTL: CHEN4_5 Position */ +#define EPWM_PDMACTL_CHEN4_5_Msk (0x1ul << EPWM_PDMACTL_CHEN4_5_Pos) /*!< EPWM_T::PDMACTL: CHEN4_5 Mask */ + +#define EPWM_PDMACTL_CAPMOD4_5_Pos (17) /*!< EPWM_T::PDMACTL: CAPMOD4_5 Position */ +#define EPWM_PDMACTL_CAPMOD4_5_Msk (0x3ul << EPWM_PDMACTL_CAPMOD4_5_Pos) /*!< EPWM_T::PDMACTL: CAPMOD4_5 Mask */ + +#define EPWM_PDMACTL_CAPORD4_5_Pos (19) /*!< EPWM_T::PDMACTL: CAPORD4_5 Position */ +#define EPWM_PDMACTL_CAPORD4_5_Msk (0x1ul << EPWM_PDMACTL_CAPORD4_5_Pos) /*!< EPWM_T::PDMACTL: CAPORD4_5 Mask */ + +#define EPWM_PDMACTL_CHSEL4_5_Pos (20) /*!< EPWM_T::PDMACTL: CHSEL4_5 Position */ +#define EPWM_PDMACTL_CHSEL4_5_Msk (0x1ul << EPWM_PDMACTL_CHSEL4_5_Pos) /*!< EPWM_T::PDMACTL: CHSEL4_5 Mask */ + +#define EPWM_PDMACAP0_1_CAPBUF_Pos (0) /*!< EPWM_T::PDMACAP0_1: CAPBUF Position */ +#define EPWM_PDMACAP0_1_CAPBUF_Msk (0xfffful << EPWM_PDMACAP0_1_CAPBUF_Pos) /*!< EPWM_T::PDMACAP0_1: CAPBUF Mask */ + +#define EPWM_PDMACAP2_3_CAPBUF_Pos (0) /*!< EPWM_T::PDMACAP2_3: CAPBUF Position */ +#define EPWM_PDMACAP2_3_CAPBUF_Msk (0xfffful << EPWM_PDMACAP2_3_CAPBUF_Pos) /*!< EPWM_T::PDMACAP2_3: CAPBUF Mask */ + +#define EPWM_PDMACAP4_5_CAPBUF_Pos (0) /*!< EPWM_T::PDMACAP4_5: CAPBUF Position */ +#define EPWM_PDMACAP4_5_CAPBUF_Msk (0xfffful << EPWM_PDMACAP4_5_CAPBUF_Pos) /*!< EPWM_T::PDMACAP4_5: CAPBUF Mask */ + +#define EPWM_CAPIEN_CAPRIEN0_Pos (0) /*!< EPWM_T::CAPIEN: CAPRIEN0 Position */ +#define EPWM_CAPIEN_CAPRIEN0_Msk (0x1ul << EPWM_CAPIEN_CAPRIEN0_Pos) /*!< EPWM_T::CAPIEN: CAPRIEN0 Mask */ + +#define EPWM_CAPIEN_CAPRIEN1_Pos (1) /*!< EPWM_T::CAPIEN: CAPRIEN1 Position */ +#define EPWM_CAPIEN_CAPRIEN1_Msk (0x1ul << EPWM_CAPIEN_CAPRIEN1_Pos) /*!< EPWM_T::CAPIEN: CAPRIEN1 Mask */ + +#define EPWM_CAPIEN_CAPRIEN2_Pos (2) /*!< EPWM_T::CAPIEN: CAPRIEN2 Position */ +#define EPWM_CAPIEN_CAPRIEN2_Msk (0x1ul << EPWM_CAPIEN_CAPRIEN2_Pos) /*!< EPWM_T::CAPIEN: CAPRIEN2 Mask */ + +#define EPWM_CAPIEN_CAPRIEN3_Pos (3) /*!< EPWM_T::CAPIEN: CAPRIEN3 Position */ +#define EPWM_CAPIEN_CAPRIEN3_Msk (0x1ul << EPWM_CAPIEN_CAPRIEN3_Pos) /*!< EPWM_T::CAPIEN: CAPRIEN3 Mask */ + +#define EPWM_CAPIEN_CAPRIEN4_Pos (4) /*!< EPWM_T::CAPIEN: CAPRIEN4 Position */ +#define EPWM_CAPIEN_CAPRIEN4_Msk (0x1ul << EPWM_CAPIEN_CAPRIEN4_Pos) /*!< EPWM_T::CAPIEN: CAPRIEN4 Mask */ + +#define EPWM_CAPIEN_CAPRIEN5_Pos (5) /*!< EPWM_T::CAPIEN: CAPRIEN5 Position */ +#define EPWM_CAPIEN_CAPRIEN5_Msk (0x1ul << EPWM_CAPIEN_CAPRIEN5_Pos) /*!< EPWM_T::CAPIEN: CAPRIEN5 Mask */ + +#define EPWM_CAPIEN_CAPFIEN0_Pos (8) /*!< EPWM_T::CAPIEN: CAPFIEN0 Position */ +#define EPWM_CAPIEN_CAPFIEN0_Msk (0x1ul << EPWM_CAPIEN_CAPFIEN0_Pos) /*!< EPWM_T::CAPIEN: CAPFIEN0 Mask */ + +#define EPWM_CAPIEN_CAPFIEN1_Pos (9) /*!< EPWM_T::CAPIEN: CAPFIEN1 Position */ +#define EPWM_CAPIEN_CAPFIEN1_Msk (0x1ul << EPWM_CAPIEN_CAPFIEN1_Pos) /*!< EPWM_T::CAPIEN: CAPFIEN1 Mask */ + +#define EPWM_CAPIEN_CAPFIEN2_Pos (10) /*!< EPWM_T::CAPIEN: CAPFIEN2 Position */ +#define EPWM_CAPIEN_CAPFIEN2_Msk (0x1ul << EPWM_CAPIEN_CAPFIEN2_Pos) /*!< EPWM_T::CAPIEN: CAPFIEN2 Mask */ + +#define EPWM_CAPIEN_CAPFIEN3_Pos (11) /*!< EPWM_T::CAPIEN: CAPFIEN3 Position */ +#define EPWM_CAPIEN_CAPFIEN3_Msk (0x1ul << EPWM_CAPIEN_CAPFIEN3_Pos) /*!< EPWM_T::CAPIEN: CAPFIEN3 Mask */ + +#define EPWM_CAPIEN_CAPFIEN4_Pos (12) /*!< EPWM_T::CAPIEN: CAPFIEN4 Position */ +#define EPWM_CAPIEN_CAPFIEN4_Msk (0x1ul << EPWM_CAPIEN_CAPFIEN4_Pos) /*!< EPWM_T::CAPIEN: CAPFIEN4 Mask */ + +#define EPWM_CAPIEN_CAPFIEN5_Pos (13) /*!< EPWM_T::CAPIEN: CAPFIEN5 Position */ +#define EPWM_CAPIEN_CAPFIEN5_Msk (0x1ul << EPWM_CAPIEN_CAPFIEN5_Pos) /*!< EPWM_T::CAPIEN: CAPFIEN5 Mask */ + +#define EPWM_CAPIF_CRLIF0_Pos (0) /*!< EPWM_T::CAPIF: CRLIF0 Position */ +#define EPWM_CAPIF_CRLIF0_Msk (0x1ul << EPWM_CAPIF_CRLIF0_Pos) /*!< EPWM_T::CAPIF: CRLIF0 Mask */ + +#define EPWM_CAPIF_CRLIF1_Pos (1) /*!< EPWM_T::CAPIF: CRLIF1 Position */ +#define EPWM_CAPIF_CRLIF1_Msk (0x1ul << EPWM_CAPIF_CRLIF1_Pos) /*!< EPWM_T::CAPIF: CRLIF1 Mask */ + +#define EPWM_CAPIF_CRLIF2_Pos (2) /*!< EPWM_T::CAPIF: CRLIF2 Position */ +#define EPWM_CAPIF_CRLIF2_Msk (0x1ul << EPWM_CAPIF_CRLIF2_Pos) /*!< EPWM_T::CAPIF: CRLIF2 Mask */ + +#define EPWM_CAPIF_CRLIF3_Pos (3) /*!< EPWM_T::CAPIF: CRLIF3 Position */ +#define EPWM_CAPIF_CRLIF3_Msk (0x1ul << EPWM_CAPIF_CRLIF3_Pos) /*!< EPWM_T::CAPIF: CRLIF3 Mask */ + +#define EPWM_CAPIF_CRLIF4_Pos (4) /*!< EPWM_T::CAPIF: CRLIF4 Position */ +#define EPWM_CAPIF_CRLIF4_Msk (0x1ul << EPWM_CAPIF_CRLIF4_Pos) /*!< EPWM_T::CAPIF: CRLIF4 Mask */ + +#define EPWM_CAPIF_CRLIF5_Pos (5) /*!< EPWM_T::CAPIF: CRLIF5 Position */ +#define EPWM_CAPIF_CRLIF5_Msk (0x1ul << EPWM_CAPIF_CRLIF5_Pos) /*!< EPWM_T::CAPIF: CRLIF5 Mask */ + +#define EPWM_CAPIF_CFLIF0_Pos (8) /*!< EPWM_T::CAPIF: CFLIF0 Position */ +#define EPWM_CAPIF_CFLIF0_Msk (0x1ul << EPWM_CAPIF_CFLIF0_Pos) /*!< EPWM_T::CAPIF: CFLIF0 Mask */ + +#define EPWM_CAPIF_CFLIF1_Pos (9) /*!< EPWM_T::CAPIF: CFLIF1 Position */ +#define EPWM_CAPIF_CFLIF1_Msk (0x1ul << EPWM_CAPIF_CFLIF1_Pos) /*!< EPWM_T::CAPIF: CFLIF1 Mask */ + +#define EPWM_CAPIF_CFLIF2_Pos (10) /*!< EPWM_T::CAPIF: CFLIF2 Position */ +#define EPWM_CAPIF_CFLIF2_Msk (0x1ul << EPWM_CAPIF_CFLIF2_Pos) /*!< EPWM_T::CAPIF: CFLIF2 Mask */ + +#define EPWM_CAPIF_CFLIF3_Pos (11) /*!< EPWM_T::CAPIF: CFLIF3 Position */ +#define EPWM_CAPIF_CFLIF3_Msk (0x1ul << EPWM_CAPIF_CFLIF3_Pos) /*!< EPWM_T::CAPIF: CFLIF3 Mask */ + +#define EPWM_CAPIF_CFLIF4_Pos (12) /*!< EPWM_T::CAPIF: CFLIF4 Position */ +#define EPWM_CAPIF_CFLIF4_Msk (0x1ul << EPWM_CAPIF_CFLIF4_Pos) /*!< EPWM_T::CAPIF: CFLIF4 Mask */ + +#define EPWM_CAPIF_CFLIF5_Pos (13) /*!< EPWM_T::CAPIF: CFLIF5 Position */ +#define EPWM_CAPIF_CFLIF5_Msk (0x1ul << EPWM_CAPIF_CFLIF5_Pos) /*!< EPWM_T::CAPIF: CFLIF5 Mask */ + +#define EPWM_PBUF0_PBUF_Pos (0) /*!< EPWM_T::PBUF0: PBUF Position */ +#define EPWM_PBUF0_PBUF_Msk (0xfffful << EPWM_PBUF0_PBUF_Pos) /*!< EPWM_T::PBUF0: PBUF Mask */ + +#define EPWM_PBUF1_PBUF_Pos (0) /*!< EPWM_T::PBUF1: PBUF Position */ +#define EPWM_PBUF1_PBUF_Msk (0xfffful << EPWM_PBUF1_PBUF_Pos) /*!< EPWM_T::PBUF1: PBUF Mask */ + +#define EPWM_PBUF2_PBUF_Pos (0) /*!< EPWM_T::PBUF2: PBUF Position */ +#define EPWM_PBUF2_PBUF_Msk (0xfffful << EPWM_PBUF2_PBUF_Pos) /*!< EPWM_T::PBUF2: PBUF Mask */ + +#define EPWM_PBUF3_PBUF_Pos (0) /*!< EPWM_T::PBUF3: PBUF Position */ +#define EPWM_PBUF3_PBUF_Msk (0xfffful << EPWM_PBUF3_PBUF_Pos) /*!< EPWM_T::PBUF3: PBUF Mask */ + +#define EPWM_PBUF4_PBUF_Pos (0) /*!< EPWM_T::PBUF4: PBUF Position */ +#define EPWM_PBUF4_PBUF_Msk (0xfffful << EPWM_PBUF4_PBUF_Pos) /*!< EPWM_T::PBUF4: PBUF Mask */ + +#define EPWM_PBUF5_PBUF_Pos (0) /*!< EPWM_T::PBUF5: PBUF Position */ +#define EPWM_PBUF5_PBUF_Msk (0xfffful << EPWM_PBUF5_PBUF_Pos) /*!< EPWM_T::PBUF5: PBUF Mask */ + +#define EPWM_CMPBUF0_CMPBUF_Pos (0) /*!< EPWM_T::CMPBUF0: CMPBUF Position */ +#define EPWM_CMPBUF0_CMPBUF_Msk (0xfffful << EPWM_CMPBUF0_CMPBUF_Pos) /*!< EPWM_T::CMPBUF0: CMPBUF Mask */ + +#define EPWM_CMPBUF1_CMPBUF_Pos (0) /*!< EPWM_T::CMPBUF1: CMPBUF Position */ +#define EPWM_CMPBUF1_CMPBUF_Msk (0xfffful << EPWM_CMPBUF1_CMPBUF_Pos) /*!< EPWM_T::CMPBUF1: CMPBUF Mask */ + +#define EPWM_CMPBUF2_CMPBUF_Pos (0) /*!< EPWM_T::CMPBUF2: CMPBUF Position */ +#define EPWM_CMPBUF2_CMPBUF_Msk (0xfffful << EPWM_CMPBUF2_CMPBUF_Pos) /*!< EPWM_T::CMPBUF2: CMPBUF Mask */ + +#define EPWM_CMPBUF3_CMPBUF_Pos (0) /*!< EPWM_T::CMPBUF3: CMPBUF Position */ +#define EPWM_CMPBUF3_CMPBUF_Msk (0xfffful << EPWM_CMPBUF3_CMPBUF_Pos) /*!< EPWM_T::CMPBUF3: CMPBUF Mask */ + +#define EPWM_CMPBUF4_CMPBUF_Pos (0) /*!< EPWM_T::CMPBUF4: CMPBUF Position */ +#define EPWM_CMPBUF4_CMPBUF_Msk (0xfffful << EPWM_CMPBUF4_CMPBUF_Pos) /*!< EPWM_T::CMPBUF4: CMPBUF Mask */ + +#define EPWM_CMPBUF5_CMPBUF_Pos (0) /*!< EPWM_T::CMPBUF5: CMPBUF Position */ +#define EPWM_CMPBUF5_CMPBUF_Msk (0xfffful << EPWM_CMPBUF5_CMPBUF_Pos) /*!< EPWM_T::CMPBUF5: CMPBUF Mask */ + +#define EPWM_CPSCBUF0_1_CPSCBUF_Pos (0) /*!< EPWM_T::CPSCBUF0_1: CPSCBUF Position */ +#define EPWM_CPSCBUF0_1_CPSCBUF_Msk (0xffful << EPWM_CPSCBUF0_1_CPSCBUF_Pos) /*!< EPWM_T::CPSCBUF0_1: CPSCBUF Mask */ + +#define EPWM_CPSCBUF2_3_CPSCBUF_Pos (0) /*!< EPWM_T::CPSCBUF2_3: CPSCBUF Position */ +#define EPWM_CPSCBUF2_3_CPSCBUF_Msk (0xffful << EPWM_CPSCBUF2_3_CPSCBUF_Pos) /*!< EPWM_T::CPSCBUF2_3: CPSCBUF Mask */ + +#define EPWM_CPSCBUF4_5_CPSCBUF_Pos (0) /*!< EPWM_T::CPSCBUF4_5: CPSCBUF Position */ +#define EPWM_CPSCBUF4_5_CPSCBUF_Msk (0xffful << EPWM_CPSCBUF4_5_CPSCBUF_Pos) /*!< EPWM_T::CPSCBUF4_5: CPSCBUF Mask */ + +#define EPWM_FTCBUF0_1_FTCMPBUF_Pos (0) /*!< EPWM_T::FTCBUF0_1: FTCMPBUF Position */ +#define EPWM_FTCBUF0_1_FTCMPBUF_Msk (0xfffful << EPWM_FTCBUF0_1_FTCMPBUF_Pos) /*!< EPWM_T::FTCBUF0_1: FTCMPBUF Mask */ + +#define EPWM_FTCBUF2_3_FTCMPBUF_Pos (0) /*!< EPWM_T::FTCBUF2_3: FTCMPBUF Position */ +#define EPWM_FTCBUF2_3_FTCMPBUF_Msk (0xfffful << EPWM_FTCBUF2_3_FTCMPBUF_Pos) /*!< EPWM_T::FTCBUF2_3: FTCMPBUF Mask */ + +#define EPWM_FTCBUF4_5_FTCMPBUF_Pos (0) /*!< EPWM_T::FTCBUF4_5: FTCMPBUF Position */ +#define EPWM_FTCBUF4_5_FTCMPBUF_Msk (0xfffful << EPWM_FTCBUF4_5_FTCMPBUF_Pos) /*!< EPWM_T::FTCBUF4_5: FTCMPBUF Mask */ + +#define EPWM_FTCI_FTCMU0_Pos (0) /*!< EPWM_T::FTCI: FTCMU0 Position */ +#define EPWM_FTCI_FTCMU0_Msk (0x1ul << EPWM_FTCI_FTCMU0_Pos) /*!< EPWM_T::FTCI: FTCMU0 Mask */ + +#define EPWM_FTCI_FTCMU2_Pos (1) /*!< EPWM_T::FTCI: FTCMU2 Position */ +#define EPWM_FTCI_FTCMU2_Msk (0x1ul << EPWM_FTCI_FTCMU2_Pos) /*!< EPWM_T::FTCI: FTCMU2 Mask */ + +#define EPWM_FTCI_FTCMU4_Pos (2) /*!< EPWM_T::FTCI: FTCMU4 Position */ +#define EPWM_FTCI_FTCMU4_Msk (0x1ul << EPWM_FTCI_FTCMU4_Pos) /*!< EPWM_T::FTCI: FTCMU4 Mask */ + +#define EPWM_FTCI_FTCMD0_Pos (8) /*!< EPWM_T::FTCI: FTCMD0 Position */ +#define EPWM_FTCI_FTCMD0_Msk (0x1ul << EPWM_FTCI_FTCMD0_Pos) /*!< EPWM_T::FTCI: FTCMD0 Mask */ + +#define EPWM_FTCI_FTCMD2_Pos (9) /*!< EPWM_T::FTCI: FTCMD2 Position */ +#define EPWM_FTCI_FTCMD2_Msk (0x1ul << EPWM_FTCI_FTCMD2_Pos) /*!< EPWM_T::FTCI: FTCMD2 Mask */ + +#define EPWM_FTCI_FTCMD4_Pos (10) /*!< EPWM_T::FTCI: FTCMD4 Position */ +#define EPWM_FTCI_FTCMD4_Msk (0x1ul << EPWM_FTCI_FTCMD4_Pos) /*!< EPWM_T::FTCI: FTCMD4 Mask */ + +/**@}*/ /* EPWM_CONST */ +/**@}*/ /* end of EPWM register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __EPWM_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/fmc_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/fmc_reg.h new file mode 100644 index 00000000000..af50c0bfb39 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/fmc_reg.h @@ -0,0 +1,688 @@ +/**************************************************************************//** + * @file fmc_reg.h + * @version V1.00 + * @brief FMC register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __FMC_REG_H__ +#define __FMC_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup FMC Flash Memory Controller(FMC) + Memory Mapped Structure for FMC Controller +@{ */ + +typedef struct +{ + /** + * @var FMC_T::ISPCTL + * Offset: 0x00 ISP Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ISPEN |ISP Enable Bit (Write Protect) + * | | |ISP function enable bit. Set this bit to enable ISP function. + * | | |0 = ISP function Disabled. + * | | |1 = ISP function Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[1] |BS |Boot Select (Write Protect) + * | | |When MBS in CONFIG0 is 1, set/clear this bit to select next booting from LDROM/APROM, respectively + * | | |This bit also functions as chip booting status flag, which can be used to check where chip booted from + * | | |This bit is initiated with the inversed value of CBS[1] (CONFIG0[7]) after any reset is happened except CPU reset (CPU is 1) or system reset (SYS) is happened + * | | |0 = Booting from APROM when MBS (CONFIG0[5]) is 1. + * | | |1 = Booting from LDROM when MBS (CONFIG0[5]) is 1. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[2] |SPUEN |SPROM Update Enable Bit (Write Protect) + * | | |0 = SPROM cannot be updated. + * | | |1 = SPROM can be updated. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[3] |APUEN |APROM Update Enable Bit (Write Protect) + * | | |0 = APROM cannot be updated when the chip runs in APROM. + * | | |1 = APROM can be updated when the chip runs in APROM. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[4] |CFGUEN |CONFIG Update Enable Bit (Write Protect) + * | | |0 = CONFIG cannot be updated. + * | | |1 = CONFIG can be updated. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[5] |LDUEN |LDROM Update Enable Bit (Write Protect) + * | | |LDROM update enable bit. + * | | |0 = LDROM cannot be updated. + * | | |1 = LDROM can be updated. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[6] |ISPFF |ISP Fail Flag (Write Protect) + * | | |This bit is set by hardware when a triggered ISP meets any of the following conditions: + * | | |This bit needs to be cleared by writing 1 to it. + * | | |(1) APROM writes to itself if APUEN is set to 0. + * | | |(2) LDROM writes to itself if LDUEN is set to 0. + * | | |(3) CONFIG is erased/programmed if CFGUEN is set to 0. + * | | |(4) SPROM is erased/programmed if SPUEN is set to 0 + * | | |(5) SPROM is programmed at SPROM secured mode. + * | | |(6) Page Erase command at LOCK mode with ICE connection + * | | |(7) Erase or Program command at brown-out detected + * | | |(8) Destination address is illegal, such as over an available range. + * | | |(9) Invalid ISP commands + * | | |(10) Vector address is mapping to SPROM region + * | | |(11) KPROM is erased/programmed if KEYLOCK is set to 1 + * | | |(12) APROM(except for Data Flash) is erased/programmed if KEYLOCK is set to 1 + * | | |(13) LDROM is erased/programmed if KEYLOCK is set to 1 + * | | |(14) SPROM is erased/programmed if KEYLOCK is set to 1 and KEYENROM[1:0] are 1. + * | | |(15) CONFIG is erased/programmed if KEYLOCK is set to 1 and KEYENROM[1:0] are 1 + * | | |(16) Invalid operations (except for chip erase) with ICE connection if SBLOCK is not 0x5A + * | | |(17) Read any content of boot loader with ICE connection + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[16] |BL |Boot Loader Booting (Write Protect) + * | | |This bit is initiated with the inversed value of MBS (CONFIG0[5]) + * | | |Any reset, except CPU reset (CPU is 1) or system reset (SYS), BL will be reloaded + * | | |This bit is used to check chip boot from Boot Loader or not + * | | |User should keep original value of this bit when updating FMC_ISPCTL register. + * | | |0 = Booting from APROM or LDROM. + * | | |1 = Booting from Boot Loader. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * @var FMC_T::ISPADDR + * Offset: 0x04 ISP Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |ISPADDR |ISP Address + * | | |The NuMicro M480 series is equipped with embedded flash + * | | |ISPADDR[1:0] must be kept 00 for ISP 32-bit operation + * | | |ISPADDR[2:0] must be kept 000 for ISP 64-bit operation. + * | | |For CRC32 Checksum Calculation command, this field is the flash starting address for checksum calculation, 4 Kbytes alignment is necessary for CRC32 checksum calculation. + * | | |For FLASH 32-bit Program, ISP address needs word alignment (4-byte) + * | | |For FLASH 64-bit Program, ISP address needs double word alignment (8-byte). + * @var FMC_T::ISPDAT + * Offset: 0x08 ISP Data Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |ISPDAT |ISP Data + * | | |Write data to this register before ISP program operation. + * | | |Read data from this register after ISP read operation. + * | | |When ISPFF (FMC_ISPCTL[6]) is 1, ISPDAT = 0xffff_ffff + * | | |For Run CRC32 Checksum Calculation command, ISPDAT is the memory size (byte) and 4 Kbytes alignment + * | | |For ISP Read CRC32 Checksum command, ISPDAT is the checksum result + * | | |If ISPDAT = 0x0000_0000, it means that (1) the checksum calculation is in progress, or (2) the memory range for checksum calculation is incorrect + * @var FMC_T::ISPCMD + * Offset: 0x0C ISP Command Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[6:0] |CMD |ISP Command + * | | |ISP command table is shown below: + * | | |0x00= FLASH Read. + * | | |0x04= Read Unique ID. + * | | |0x08= Read Flash All-One Result. + * | | |0x0B= Read Company ID. + * | | |0x0C= Read Device ID. + * | | |0x0D= Read Checksum. + * | | |0x21= FLASH 32-bit Program. + * | | |0x22= FLASH Page Erase. Erase any page in two banks, except for OTP. + * | | |0x23= FLASH Bank Erase. Erase all pages of APROM in BANK0 or BANK1. + * | | |0x25= FLASH Block Erase. Erase four pages alignment of APROM in BANK0 or BANK1.. + * | | |0x27= FLASH Multi-Word Program. + * | | |0x28= Run Flash All-One Verification. + * | | |0x2D= Run Checksum Calculation. + * | | |0x2E= Vector Remap. + * | | |0x40= FLASH 64-bit Read. + * | | |0x61= FLASH 64-bit Program. + * | | |The other commands are invalid. + * @var FMC_T::ISPTRG + * Offset: 0x10 ISP Trigger Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ISPGO |ISP Start Trigger (Write Protect) + * | | |Write 1 to start ISP operation and this bit will be cleared to 0 by hardware automatically when ISP operation is finished. + * | | |0 = ISP operation is finished. + * | | |1 = ISP is progressed. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * @var FMC_T::DFBA + * Offset: 0x14 Data Flash Base Address + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |DFBA |Data Flash Base Address + * | | |This register indicates Data Flash start address. It is a read only register. + * | | |The Data Flash is shared with APROM. the content of this register is loaded from CONFIG1 + * | | |This register is valid when DFEN (CONFIG0[0]) =0 . + * @var FMC_T::ISPSTS + * Offset: 0x40 ISP Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ISPBUSY |ISP Busy Flag (Read Only) + * | | |Write 1 to start ISP operation and this bit will be cleared to 0 by hardware automatically when ISP operation is finished. + * | | |This bit is the mirror of ISPGO(FMC_ISPTRG[0]). + * | | |0 = ISP operation is finished. + * | | |1 = ISP is progressed. + * |[2:1] |CBS |Boot Selection of CONFIG (Read Only) + * | | |This bit is initiated with the CBS (CONFIG0[7:6]) after any reset is happened except CPU reset (CPU is 1) or system reset (SYS) is happened. + * | | |The following function is valid when MBS (FMC_ISPSTS[3])= 1. + * | | |00 = LDROM with IAP mode. + * | | |01 = LDROM without IAP mode. + * | | |10 = APROM with IAP mode. + * | | |11 = APROM without IAP mode. + * |[3] |MBS |Boot From Boot Loader Selection Flag (Read Only) + * | | |This bit is initiated with the MBS (CONFIG0[5]) after any reset is happened except CPU reset (CPU is 1) or system reset (SYS) is happened + * | | |0 = Booting from Boot Loader. + * | | |1 = Booting from LDROM/APROM.(.see CBS bit setting) + * |[4] |FCYCDIS |Flash Access Cycle Auto-tuning Disabled Flag (Read Only) + * | | |This bit is set if flash access cycle auto-tuning function is disabled + * | | |The auto-tunning function is disabled by FADIS(FMC_CYCCTL[8]) or HIRC clock is not ready. + * | | |0 = Flash access cycle auto-tuning is enabled. + * | | |1 = Flash access cycle auto-tuning is disabled. + * |[5] |PGFF |Flash Program with Fast Verification Flag (Read Only) + * | | |This bit is set if data is mismatched at ISP programming verification + * | | |This bit is clear by performing ISP flash erase or ISP read CID operation + * | | |0 = Flash Program is success. + * | | |1 = Flash Program is fail. Program data is different with data in the flash memory + * |[6] |ISPFF |ISP Fail Flag (Write Protect) + * | | |This bit is the mirror of ISPFF (FMC_ISPCTL[6]), it needs to be cleared by writing 1 to FMC_ISPCTL[6] or FMC_ISPSTS[6] + * | | |This bit is set by hardware when a triggered ISP meets any of the following conditions: + * | | |(1) APROM writes to itself if APUEN is set to 0. + * | | |(2) LDROM writes to itself if LDUEN is set to 0. + * | | |(3) CONFIG is erased/programmed if CFGUEN is set to 0. + * | | |(4) SPROM is erased/programmed if SPUEN is set to 0 + * | | |(5) SPROM is programmed at SPROM secured mode. + * | | |(6) Page Erase command at LOCK mode with ICE connection + * | | |(7) Erase or Program command at brown-out detected + * | | |(8) Destination address is illegal, such as over an available range. + * | | |(9) Invalid ISP commands + * | | |(10) Vector address is mapping to SPROM region. + * | | |(11) KPROM is erased/programmed if KEYLOCK is set to 1 + * | | |(12) APROM(except for Data Flash) is erased/programmed if KEYLOCK is set to 1 + * | | |(13) LDROM is erased/programmed if KEYLOCK is set to 1 + * | | |(14) SPROM is erased/programmed if KEYLOCK is set to 1 and KEYENROM[1:0] are 1. + * | | |(15) CONFIG is erased/programmed if KEYLOCK is set to 1 and KEYENROM[1:0] are 1. + * | | |(16) Invalid operations (except for chip erase) with ICE connection if SBLOCK is not 0x5A + * | | |(17) Read any content of boot loader with ICE connection + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[7] |ALLONE |Flash All-one Verification Flag + * | | |This bit is set by hardware if all of flash bits are 1, and clear if flash bits are not all 1 after "Run Flash All-One Verification" complete; this bit also can be clear by writing 1 + * | | |0 = All of flash bits are 1 after "Run Flash All-One Verification" complete. + * | | |1 = Flash bits are not all 1 after "Run Flash All-One Verification" complete. + * |[23:9] |VECMAP |Vector Page Mapping Address (Read Only) + * | | |All access to 0x0000_0000~0x0000_01FF is remapped to the flash memory address {VECMAP[14:0], 9u2019h000} ~ {VECMAP[14:0], 9u2019h1FF} + * |[31] |SCODE |Security Code Active Flag + * | | |This bit is set by hardware when detecting SPROM secured code is active at flash initiation, or software writes 1 to this bit to make secured code active; this bit is clear by SPROM page erase operation. + * | | |0 = Secured code is inactive. + * | | |1 = Secured code is active. + * @var FMC_T::CYCCTL + * Offset: 0x4C Flash Access Cycle Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |CYCLE |Flash Access Cycle Control (Write Protect) + * | | |0001 = CPU access with one wait cycle if cache miss; flash access cycle is 1;. + * | | |The HCLK working frequency range range is<27MHz + * | | |0010 = CPU access with two wait cycles if cache miss; flash access cycle is 2;. + * | | | The optimized HCLK working frequency range is 27~54 MHz + * | | |0011 = CPU access with three wait cycles if cache miss; flash access cycle is 3;. + * | | |The optimized HCLK working frequency range is 54~81MHz + * | | |0100 = CPU access with four wait cycles if cache miss; flash access cycle is 4;. + * | | | The optimized HCLK working frequency range is81~108MHz + * | | |0101 = CPU access with five wait cycles if cache miss; flash access cycle is 5;. + * | | |The optimized HCLK working frequency range is 108~135MHz + * | | |0110 = CPU access with six wait cycles if cache miss; flash access cycle is 6;. + * | | | The optimized HCLK working frequency range is 135~162MHz + * | | |0111 = CPU access with seven wait cycles if cache miss; flash access cycle is 7;. + * | | | The optimized HCLK working frequency range is 162~192MHz + * | | |1000 = CPU access with eight wait cycles if cache miss; flash access cycle is 8;. + * | | |The optimized HCLK working frequency range is >192MHz + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * @var FMC_T::KPKEY0 + * Offset: 0x50 KPROM KEY0 Data Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KPKEY0 |KPROM KEY0 Data (Write Only) + * | | |Write KPKEY0 data to this register before KEY Comparison operation. + * @var FMC_T::KPKEY1 + * Offset: 0x54 KPROM KEY1 Data Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KPKEY1 |KPROM KEY1 Data (Write Only) + * | | |Write KPKEY1 data to this register before KEY Comparison operation. + * @var FMC_T::KPKEY2 + * Offset: 0x58 KPROM KEY2 Data Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KPKEY2 |KPROM KEY2 Data (Write Only) + * | | |Write KPKEY2 data to this register before KEY Comparison operation. + * @var FMC_T::KPKEYTRG + * Offset: 0x5C KPROM KEY Comparison Trigger Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |KPKEYGO |KPROM KEY Comparison Start Trigger (Write Protection) + * | | |Write 1 to start KEY comparison operation and this bit will be cleared to 0 by hardware automatically when KEY comparison operation is finished + * | | |This trigger operation is valid while FORBID (FMC_KPKEYSTS [3]) is 0. + * | | |0 = KEY comparison operation is finished. + * | | |1 = KEY comparison is progressed. + * | | |Note: This bit is write-protected. Refer to the SYS_REGLCTL register. + * |[1] |TCEN |Timeout Counting Enable (Write Protection) + * | | |0 = Timeout counting is disabled. + * | | |1 = Timeout counting is enabled if input key is matched after key comparison finish. + * | | |10 minutes is at least for timeout, and average is about 20 minutes. + * | | |Note: This bit is write-protected. Refer to the SYS_REGLCTL register. + * @var FMC_T::KPKEYSTS + * Offset: 0x60 KPROM KEY Comparison Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |KEYBUSY |KEY Comparison Busy (Read Only) + * | | |0 = KEY comparison is finished. + * | | |1 = KEY comparison is busy. + * |[1] |KEYLOCK |KEY LOCK Flag + * | | |This bit is set to 1 if KEYMATCH (FMC_KPKEYSTS [2]) is 0 and cleared to 0 if KEYMATCH is 1 in Security Key protection + * | | |After Mass Erase operation, users must reset or power on /off to clear this bit to 0 + * | | |This bit also can be set to 1 while + * | | | - CPU write 1 to KEYLOCK(FMC_KPKEYSTS[1]) or + * | | | - KEYFLAG(FMC_KPKEYSTS[4]) is 1 at power-on or reset or + * | | | - KEYENROM is programmed a non-0xFF value or + * | | | - Timeout event or + * | | | - FORBID(FMC_KPKEYSTS[3]) is 1 + * | | |0 = KPROM, LDROM and APROM (not include Data Flash) is not in write protection. + * | | |1 = KPROM, LDROM and APROM (not include Data Flash) is in write protection. + * | | |SPROM write protect is depended on SPFLAG. + * | | |CONFIG write protect is depended on CFGFLAG + * |[2] |KEYMATCH |KEY Match Flag (Read Only) + * | | |This bit is set to 1 after KEY comparison complete if the KEY0, KEY1 and KEY2 are matched with the 96-bit security keys in KPROM; and cleared to 0 if KEYs are unmatched + * | | |This bit is also cleared to 0 while + * | | | - CPU writing 1 to KEYLOCK(FMC_KPKEYSTS[1]) or + * | | | - Timeout event or + * | | | - KPROM is erased or + * | | | - KEYENROM is programmed to a non-0xFF value. + * | | | - Chip is in power down mode. + * | | |0 = KEY0, KEY1, and KEY2 are unmatched with the KPROM setting. + * | | |1 = KEY0, KEY1, and KEY2 are matched with the KPROM setting. + * |[3] |FORBID |KEY Comparison Forbidden Flag (Read Only) + * | | |This bit is set to 1 when KPKECNT(FMC_KPKEY0[4:0]) is more than KPKEMAX (FMC_KPKEY0[12:8]) or KPCNT (FMC_KPCNT [2:0]) is more than KPMAX (FMC_KPCNT [10:8]). + * | | |0 = KEY comparison is not forbidden. + * | | |1 = KEY comparison is forbidden, KEYGO (FMC_KEYTRG [0]) cannot trigger. + * |[4] |KEYFLAG |KEY Protection Enabled Flag (Read Only) + * | | |This bit is set while the KEYENROM [7:0] is not 0xFF at power-on or reset + * | | |This bit is cleared to 0 by hardware while KPROM is erased + * | | |This bit is set to 1 by hardware while KEYENROM is programmed to a non-0xFF value. + * | | |0 = Security Key protection is disabled. + * | | |1 = Security Key protection is enabled. + * |[5] |CFGFLAG |CONFIG Write-protection Enabled Flag (Read Only) + * | | |This bit is set while the KEYENROM [0] is 0 at power-on or reset + * | | |This bit is cleared to 0 by hardware while KPROM is erased + * | | |This bit is set to 1 by hardware while KEYENROM[0] is programmed to 0. + * | | |0 = CONFIG write-protection is disabled. + * | | |1 = CONFIG write-protection is enabled. + * |[6] |SPFLAG |SPROM Write-protection Enabled Flag (Read Only) + * | | |This bit is set while the KEYENROM [1] is 0 at power-on or reset + * | | |This bit is cleared to 0 by hardware while KPROM is erased + * | | |This bit is set to 1 by hardware while KEYENROM[1] is programmed to 0. + * | | |0 = SPROM write-protection is disabled. + * | | |1 = SPROM write-protection is enabled. + * @var FMC_T::KPKEYCNT + * Offset: 0x64 KPROM KEY-Unmatched Counting Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[5:0] |KPKECNT |Error Key Entry Counter at Each Power-on (Read Only) + * | | |KPKECNT is increased when entry keys is wrong in Security Key protection + * | | |KPKECNT is cleared to 0 if key comparison is matched or system power-on. + * |[13:8] |KPKEMAX |Maximum Number for Error Key Entry at Each Power-on (Read Only) + * | | |KPKEMAX is the maximum error key entry number at each power-on + * | | |When KPKEMAXROM of KPROM is erased or programmed, KPKEMAX will also be updated + * | | |KPKEMAX is used to limit KPKECNT(FMC_KPKEY0[5:0]) maximum counting + * | | |The FORBID (FMC_KPKEYSTS [3]) will be set to 1 when KPKECNT is more than KPKEMAX. + * @var FMC_T::KPCNT + * Offset: 0x68 KPROM KEY-Unmatched Power-On Counting Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |KPCNT |Power-on Counter for Error Key Entry(Read Only) + * | | |KPCNT is the power-on counting for error key entry in Security Key protection + * | | |KPCNT is cleared to 0 if key comparison is matched. + * |[11:8] |KPMAX |Power-on Maximum Number for Error Key Entry (Read Only) + * | | |KPMAX is the power-on maximum number for error key entry + * | | |When KPMAXROM of KPROM is erased or programmed, KPMAX will also be updated + * | | |KPMAX is used to limit KPCNT (FMC_KPCNT [3:0]) maximum counting + * | | |The FORBID(FMC_KPKEYSTS[3]) will be set to 1 when KPCNT is more than KPMAX + * @var FMC_T::MPDAT0 + * Offset: 0x80 ISP Data0 Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |ISPDAT0 |ISP Data 0 + * | | |This register is the first 32-bit data for 32-bit/64-bit/multi-word programming, and it is also the mirror of FMC_ISPDAT, both registers keep the same data + * @var FMC_T::MPDAT1 + * Offset: 0x84 ISP Data1 Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |ISPDAT1 |ISP Data 1 + * | | |This register is the second 32-bit data for 64-bit/multi-word programming. + * @var FMC_T::MPDAT2 + * Offset: 0x88 ISP Data2 Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |ISPDAT2 |ISP Data 2 + * | | |This register is the third 32-bit data for multi-word programming. + * @var FMC_T::MPDAT3 + * Offset: 0x8C ISP Data3 Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |ISPDAT3 |ISP Data 3 + * | | |This register is the fourth 32-bit data for multi-word programming. + * @var FMC_T::MPSTS + * Offset: 0xC0 ISP Multi-Program Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |MPBUSY |ISP Multi-word Program Busy Flag (Read Only) + * | | |Write 1 to start ISP Multi-Word program operation and this bit will be cleared to 0 by hardware automatically when ISP Multi-Word program operation is finished. + * | | |This bit is the mirror of ISPGO(FMC_ISPTRG[0]). + * | | |0 = ISP Multi-Word program operation is finished. + * | | |1 = ISP Multi-Word program operation is progressed. + * |[1] |PPGO |ISP Multi-program Status (Read Only) + * | | |0 = ISP multi-word program operation is not active. + * | | |1 = ISP multi-word program operation is in progress. + * |[2] |ISPFF |ISP Fail Flag (Read Only) + * | | |This bit is the mirror of ISPFF (FMC_ISPCTL[6]), it needs to be cleared by writing 1 to FMC_ISPCTL[6] or FMC_ISPSTS[6] + * | | |This bit is set by hardware when a triggered ISP meets any of the following conditions: + * | | |(1) APROM writes to itself if APUEN is set to 0. + * | | |(2) LDROM writes to itself if LDUEN is set to 0. + * | | |(3) CONFIG is erased/programmed if CFGUEN is set to 0. + * | | |(4) SPROM is erased/programmed if SPUEN is set to 0 + * | | |(5) SPROM is programmed at SPROM secured mode. + * | | |(6) Page Erase command at LOCK mode with ICE connection + * | | |(7) Erase or Program command at brown-out detected + * | | |(8) Destination address is illegal, such as over an available range. + * | | |(9) Invalid ISP commands + * | | |(10) Vector address is mapping to SPROM region. + * |[4] |D0 |ISP DATA 0 Flag (Read Only) + * | | |This bit is set when FMC_MPDAT0 is written and auto-clear to 0 when the FMC_MPDAT0 data is programmed to flash complete. + * | | |0 = FMC_MPDAT0 register is empty, or program to flash complete. + * | | |1 = FMC_MPDAT0 register has been written, and not program to flash complete. + * |[5] |D1 |ISP DATA 1 Flag (Read Only) + * | | |This bit is set when FMC_MPDAT1 is written and auto-clear to 0 when the FMC_MPDAT1 data is programmed to flash complete. + * | | |0 = FMC_MPDAT1 register is empty, or program to flash complete. + * | | |1 = FMC_MPDAT1 register has been written, and not program to flash complete. + * |[6] |D2 |ISP DATA 2 Flag (Read Only) + * | | |This bit is set when FMC_MPDAT2 is written and auto-clear to 0 when the FMC_MPDAT2 data is programmed to flash complete. + * | | |0 = FMC_MPDAT2 register is empty, or program to flash complete. + * | | |1 = FMC_MPDAT2 register has been written, and not program to flash complete. + * |[7] |D3 |ISP DATA 3 Flag (Read Only) + * | | |This bit is set when FMC_MPDAT3 is written and auto-clear to 0 when the FMC_MPDAT3 data is programmed to flash complete. + * | | |0 = FMC_MPDAT3 register is empty, or program to flash complete. + * | | |1 = FMC_MPDAT3 register has been written, and not program to flash complete. + * @var FMC_T::MPADDR + * Offset: 0xC4 ISP Multi-Program Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |MPADDR |ISP Multi-word Program Address + * | | |MPADDR is the address of ISP multi-word program operation when ISPGO flag is 1. + * | | |MPADDR will keep the final ISP address when ISP multi-word program is complete. + */ + __IO uint32_t ISPCTL; /*!< [0x0000] ISP Control Register */ + __IO uint32_t ISPADDR; /*!< [0x0004] ISP Address Register */ + __IO uint32_t ISPDAT; /*!< [0x0008] ISP Data Register */ + __IO uint32_t ISPCMD; /*!< [0x000c] ISP Command Register */ + __IO uint32_t ISPTRG; /*!< [0x0010] ISP Trigger Control Register */ + __I uint32_t DFBA; /*!< [0x0014] Data Flash Base Address */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[10]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t ISPSTS; /*!< [0x0040] ISP Status Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE1[2]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t CYCCTL; /*!< [0x004c] Flash Access Cycle Control Register */ + __O uint32_t KPKEY0; /*!< [0x0050] KPROM KEY0 Data Register */ + __O uint32_t KPKEY1; /*!< [0x0054] KPROM KEY1 Data Register */ + __O uint32_t KPKEY2; /*!< [0x0058] KPROM KEY2 Data Register */ + __IO uint32_t KPKEYTRG; /*!< [0x005c] KPROM KEY Comparison Trigger Control Register */ + __IO uint32_t KPKEYSTS; /*!< [0x0060] KPROM KEY Comparison Status Register */ + __I uint32_t KPKEYCNT; /*!< [0x0064] KPROM KEY-Unmatched Counting Register */ + __I uint32_t KPCNT; /*!< [0x0068] KPROM KEY-Unmatched Power-On Counting Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE2[5]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t MPDAT0; /*!< [0x0080] ISP Data0 Register */ + __IO uint32_t MPDAT1; /*!< [0x0084] ISP Data1 Register */ + __IO uint32_t MPDAT2; /*!< [0x0088] ISP Data2 Register */ + __IO uint32_t MPDAT3; /*!< [0x008c] ISP Data3 Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE3[12]; + /// @endcond //HIDDEN_SYMBOLS + __I uint32_t MPSTS; /*!< [0x00c0] ISP Multi-Program Status Register */ + __I uint32_t MPADDR; /*!< [0x00c4] ISP Multi-Program Address Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE4[2]; + /// @endcond //HIDDEN_SYMBOLS + __I uint32_t XOMR0STS; /*!< [0x00d0] XOM Region 0 Status Register */ + __I uint32_t XOMR1STS; /*!< [0x00d4] XOM Region 1 Status Register */ + __I uint32_t XOMR2STS; /*!< [0x00d8] XOM Region 2 Status Register */ + __I uint32_t XOMR3STS; /*!< [0x00dc] XOM Region 3 Status Register */ + __I uint32_t XOMSTS; /*!< [0x00e0] XOM Status Register */ + +} FMC_T; + +/** + @addtogroup FMC_CONST FMC Bit Field Definition + Constant Definitions for FMC Controller +@{ */ + +#define FMC_ISPCTL_ISPEN_Pos (0) /*!< FMC_T::ISPCTL: ISPEN Position */ +#define FMC_ISPCTL_ISPEN_Msk (0x1ul << FMC_ISPCTL_ISPEN_Pos) /*!< FMC_T::ISPCTL: ISPEN Mask */ + +#define FMC_ISPCTL_BS_Pos (1) /*!< FMC_T::ISPCTL: BS Position */ +#define FMC_ISPCTL_BS_Msk (0x1ul << FMC_ISPCTL_BS_Pos) /*!< FMC_T::ISPCTL: BS Mask */ + +#define FMC_ISPCTL_SPUEN_Pos (2) /*!< FMC_T::ISPCTL: SPUEN Position */ +#define FMC_ISPCTL_SPUEN_Msk (0x1ul << FMC_ISPCTL_SPUEN_Pos) /*!< FMC_T::ISPCTL: SPUEN Mask */ + +#define FMC_ISPCTL_APUEN_Pos (3) /*!< FMC_T::ISPCTL: APUEN Position */ +#define FMC_ISPCTL_APUEN_Msk (0x1ul << FMC_ISPCTL_APUEN_Pos) /*!< FMC_T::ISPCTL: APUEN Mask */ + +#define FMC_ISPCTL_CFGUEN_Pos (4) /*!< FMC_T::ISPCTL: CFGUEN Position */ +#define FMC_ISPCTL_CFGUEN_Msk (0x1ul << FMC_ISPCTL_CFGUEN_Pos) /*!< FMC_T::ISPCTL: CFGUEN Mask */ + +#define FMC_ISPCTL_LDUEN_Pos (5) /*!< FMC_T::ISPCTL: LDUEN Position */ +#define FMC_ISPCTL_LDUEN_Msk (0x1ul << FMC_ISPCTL_LDUEN_Pos) /*!< FMC_T::ISPCTL: LDUEN Mask */ + +#define FMC_ISPCTL_ISPFF_Pos (6) /*!< FMC_T::ISPCTL: ISPFF Position */ +#define FMC_ISPCTL_ISPFF_Msk (0x1ul << FMC_ISPCTL_ISPFF_Pos) /*!< FMC_T::ISPCTL: ISPFF Mask */ + +#define FMC_ISPCTL_BL_Pos (16) /*!< FMC_T::ISPCTL: BL Position */ +#define FMC_ISPCTL_BL_Msk (0x1ul << FMC_ISPCTL_BL_Pos) /*!< FMC_T::ISPCTL: BL Mask */ + +#define FMC_ISPADDR_ISPADDR_Pos (0) /*!< FMC_T::ISPADDR: ISPADDR Position */ +#define FMC_ISPADDR_ISPADDR_Msk (0xfffffffful << FMC_ISPADDR_ISPADDR_Pos) /*!< FMC_T::ISPADDR: ISPADDR Mask */ + +#define FMC_ISPDAT_ISPDAT_Pos (0) /*!< FMC_T::ISPDAT: ISPDAT Position */ +#define FMC_ISPDAT_ISPDAT_Msk (0xfffffffful << FMC_ISPDAT_ISPDAT_Pos) /*!< FMC_T::ISPDAT: ISPDAT Mask */ + +#define FMC_ISPCMD_CMD_Pos (0) /*!< FMC_T::ISPCMD: CMD Position */ +#define FMC_ISPCMD_CMD_Msk (0x7ful << FMC_ISPCMD_CMD_Pos) /*!< FMC_T::ISPCMD: CMD Mask */ + +#define FMC_ISPTRG_ISPGO_Pos (0) /*!< FMC_T::ISPTRG: ISPGO Position */ +#define FMC_ISPTRG_ISPGO_Msk (0x1ul << FMC_ISPTRG_ISPGO_Pos) /*!< FMC_T::ISPTRG: ISPGO Mask */ + +#define FMC_DFBA_DFBA_Pos (0) /*!< FMC_T::DFBA: DFBA Position */ +#define FMC_DFBA_DFBA_Msk (0xfffffffful << FMC_DFBA_DFBA_Pos) /*!< FMC_T::DFBA: DFBA Mask */ + +#define FMC_ISPSTS_ISPBUSY_Pos (0) /*!< FMC_T::ISPSTS: ISPBUSY Position */ +#define FMC_ISPSTS_ISPBUSY_Msk (0x1ul << FMC_ISPSTS_ISPBUSY_Pos) /*!< FMC_T::ISPSTS: ISPBUSY Mask */ + +#define FMC_ISPSTS_CBS_Pos (1) /*!< FMC_T::ISPSTS: CBS Position */ +#define FMC_ISPSTS_CBS_Msk (0x3ul << FMC_ISPSTS_CBS_Pos) /*!< FMC_T::ISPSTS: CBS Mask */ + +#define FMC_ISPSTS_MBS_Pos (3) /*!< FMC_T::ISPSTS: MBS Position */ +#define FMC_ISPSTS_MBS_Msk (0x1ul << FMC_ISPSTS_MBS_Pos) /*!< FMC_T::ISPSTS: MBS Mask */ + +#define FMC_ISPSTS_FCYCDIS_Pos (4) /*!< FMC_T::ISPSTS: FCYCDIS Position */ +#define FMC_ISPSTS_FCYCDIS_Msk (0x1ul << FMC_ISPSTS_FCYCDIS_Pos) /*!< FMC_T::ISPSTS: FCYCDIS Mask */ + +#define FMC_ISPSTS_PGFF_Pos (5) /*!< FMC_T::ISPSTS: PGFF Position */ +#define FMC_ISPSTS_PGFF_Msk (0x1ul << FMC_ISPSTS_PGFF_Pos) /*!< FMC_T::ISPSTS: PGFF Mask */ + +#define FMC_ISPSTS_ISPFF_Pos (6) /*!< FMC_T::ISPSTS: ISPFF Position */ +#define FMC_ISPSTS_ISPFF_Msk (0x1ul << FMC_ISPSTS_ISPFF_Pos) /*!< FMC_T::ISPSTS: ISPFF Mask */ + +#define FMC_ISPSTS_ALLONE_Pos (7) /*!< FMC_T::ISPSTS: ALLONE Position */ +#define FMC_ISPSTS_ALLONE_Msk (0x1ul << FMC_ISPSTS_ALLONE_Pos) /*!< FMC_T::ISPSTS: ALLONE Mask */ + +#define FMC_ISPSTS_VECMAP_Pos (9) /*!< FMC_T::ISPSTS: VECMAP Position */ +#define FMC_ISPSTS_VECMAP_Msk (0x7ffful << FMC_ISPSTS_VECMAP_Pos) /*!< FMC_T::ISPSTS: VECMAP Mask */ + +#define FMC_ISPSTS_SCODE_Pos (31) /*!< FMC_T::ISPSTS: SCODE Position */ +#define FMC_ISPSTS_SCODE_Msk (0x1ul << FMC_ISPSTS_SCODE_Pos) /*!< FMC_T::ISPSTS: SCODE Mask */ + +#define FMC_CYCCTL_CYCLE_Pos (0) /*!< FMC_T::CYCCTL: CYCLE Position */ +#define FMC_CYCCTL_CYCLE_Msk (0xful << FMC_CYCCTL_CYCLE_Pos) /*!< FMC_T::CYCCTL: CYCLE Mask */ + +#define FMC_KPKEY0_KPKEY0_Pos (0) /*!< FMC_T::KPKEY0: KPKEY0 Position */ +#define FMC_KPKEY0_KPKEY0_Msk (0xfffffffful << FMC_KPKEY0_KPKEY0_Pos) /*!< FMC_T::KPKEY0: KPKEY0 Mask */ + +#define FMC_KPKEY1_KPKEY1_Pos (0) /*!< FMC_T::KPKEY1: KPKEY1 Position */ +#define FMC_KPKEY1_KPKEY1_Msk (0xfffffffful << FMC_KPKEY1_KPKEY1_Pos) /*!< FMC_T::KPKEY1: KPKEY1 Mask */ + +#define FMC_KPKEY2_KPKEY2_Pos (0) /*!< FMC_T::KPKEY2: KPKEY2 Position */ +#define FMC_KPKEY2_KPKEY2_Msk (0xfffffffful << FMC_KPKEY2_KPKEY2_Pos) /*!< FMC_T::KPKEY2: KPKEY2 Mask */ + +#define FMC_KPKEYTRG_KPKEYGO_Pos (0) /*!< FMC_T::KPKEYTRG: KPKEYGO Position */ +#define FMC_KPKEYTRG_KPKEYGO_Msk (0x1ul << FMC_KPKEYTRG_KPKEYGO_Pos) /*!< FMC_T::KPKEYTRG: KPKEYGO Mask */ + +#define FMC_KPKEYTRG_TCEN_Pos (1) /*!< FMC_T::KPKEYTRG: TCEN Position */ +#define FMC_KPKEYTRG_TCEN_Msk (0x1ul << FMC_KPKEYTRG_TCEN_Pos) /*!< FMC_T::KPKEYTRG: TCEN Mask */ + +#define FMC_KPKEYSTS_KEYBUSY_Pos (0) /*!< FMC_T::KPKEYSTS: KEYBUSY Position */ +#define FMC_KPKEYSTS_KEYBUSY_Msk (0x1ul << FMC_KPKEYSTS_KEYBUSY_Pos) /*!< FMC_T::KPKEYSTS: KEYBUSY Mask */ + +#define FMC_KPKEYSTS_KEYLOCK_Pos (1) /*!< FMC_T::KPKEYSTS: KEYLOCK Position */ +#define FMC_KPKEYSTS_KEYLOCK_Msk (0x1ul << FMC_KPKEYSTS_KEYLOCK_Pos) /*!< FMC_T::KPKEYSTS: KEYLOCK Mask */ + +#define FMC_KPKEYSTS_KEYMATCH_Pos (2) /*!< FMC_T::KPKEYSTS: KEYMATCH Position */ +#define FMC_KPKEYSTS_KEYMATCH_Msk (0x1ul << FMC_KPKEYSTS_KEYMATCH_Pos) /*!< FMC_T::KPKEYSTS: KEYMATCH Mask */ + +#define FMC_KPKEYSTS_FORBID_Pos (3) /*!< FMC_T::KPKEYSTS: FORBID Position */ +#define FMC_KPKEYSTS_FORBID_Msk (0x1ul << FMC_KPKEYSTS_FORBID_Pos) /*!< FMC_T::KPKEYSTS: FORBID Mask */ + +#define FMC_KPKEYSTS_KEYFLAG_Pos (4) /*!< FMC_T::KPKEYSTS: KEYFLAG Position */ +#define FMC_KPKEYSTS_KEYFLAG_Msk (0x1ul << FMC_KPKEYSTS_KEYFLAG_Pos) /*!< FMC_T::KPKEYSTS: KEYFLAG Mask */ + +#define FMC_KPKEYSTS_CFGFLAG_Pos (5) /*!< FMC_T::KPKEYSTS: CFGFLAG Position */ +#define FMC_KPKEYSTS_CFGFLAG_Msk (0x1ul << FMC_KPKEYSTS_CFGFLAG_Pos) /*!< FMC_T::KPKEYSTS: CFGFLAG Mask */ + +#define FMC_KPKEYSTS_SPFLAG_Pos (6) /*!< FMC_T::KPKEYSTS: SPFLAG Position */ +#define FMC_KPKEYSTS_SPFLAG_Msk (0x1ul << FMC_KPKEYSTS_SPFLAG_Pos) /*!< FMC_T::KPKEYSTS: SPFLAG Mask */ + +#define FMC_KPKEYCNT_KPKECNT_Pos (0) /*!< FMC_T::KPKEYCNT: KPKECNT Position */ +#define FMC_KPKEYCNT_KPKECNT_Msk (0x3ful << FMC_KPKEYCNT_KPKECNT_Pos) /*!< FMC_T::KPKEYCNT: KPKECNT Mask */ + +#define FMC_KPKEYCNT_KPKEMAX_Pos (8) /*!< FMC_T::KPKEYCNT: KPKEMAX Position */ +#define FMC_KPKEYCNT_KPKEMAX_Msk (0x3ful << FMC_KPKEYCNT_KPKEMAX_Pos) /*!< FMC_T::KPKEYCNT: KPKEMAX Mask */ + +#define FMC_KPCNT_KPCNT_Pos (0) /*!< FMC_T::KPCNT: KPCNT Position */ +#define FMC_KPCNT_KPCNT_Msk (0xful << FMC_KPCNT_KPCNT_Pos) /*!< FMC_T::KPCNT: KPCNT Mask */ + +#define FMC_KPCNT_KPMAX_Pos (8) /*!< FMC_T::KPCNT: KPMAX Position */ +#define FMC_KPCNT_KPMAX_Msk (0xful << FMC_KPCNT_KPMAX_Pos) /*!< FMC_T::KPCNT: KPMAX Mask */ + +#define FMC_MPDAT0_ISPDAT0_Pos (0) /*!< FMC_T::MPDAT0: ISPDAT0 Position */ +#define FMC_MPDAT0_ISPDAT0_Msk (0xfffffffful << FMC_MPDAT0_ISPDAT0_Pos) /*!< FMC_T::MPDAT0: ISPDAT0 Mask */ + +#define FMC_MPDAT1_ISPDAT1_Pos (0) /*!< FMC_T::MPDAT1: ISPDAT1 Position */ +#define FMC_MPDAT1_ISPDAT1_Msk (0xfffffffful << FMC_MPDAT1_ISPDAT1_Pos) /*!< FMC_T::MPDAT1: ISPDAT1 Mask */ + +#define FMC_MPDAT2_ISPDAT2_Pos (0) /*!< FMC_T::MPDAT2: ISPDAT2 Position */ +#define FMC_MPDAT2_ISPDAT2_Msk (0xfffffffful << FMC_MPDAT2_ISPDAT2_Pos) /*!< FMC_T::MPDAT2: ISPDAT2 Mask */ + +#define FMC_MPDAT3_ISPDAT3_Pos (0) /*!< FMC_T::MPDAT3: ISPDAT3 Position */ +#define FMC_MPDAT3_ISPDAT3_Msk (0xfffffffful << FMC_MPDAT3_ISPDAT3_Pos) /*!< FMC_T::MPDAT3: ISPDAT3 Mask */ + +#define FMC_MPSTS_MPBUSY_Pos (0) /*!< FMC_T::MPSTS: MPBUSY Position */ +#define FMC_MPSTS_MPBUSY_Msk (0x1ul << FMC_MPSTS_MPBUSY_Pos) /*!< FMC_T::MPSTS: MPBUSY Mask */ + +#define FMC_MPSTS_PPGO_Pos (1) /*!< FMC_T::MPSTS: PPGO Position */ +#define FMC_MPSTS_PPGO_Msk (0x1ul << FMC_MPSTS_PPGO_Pos) /*!< FMC_T::MPSTS: PPGO Mask */ + +#define FMC_MPSTS_ISPFF_Pos (2) /*!< FMC_T::MPSTS: ISPFF Position */ +#define FMC_MPSTS_ISPFF_Msk (0x1ul << FMC_MPSTS_ISPFF_Pos) /*!< FMC_T::MPSTS: ISPFF Mask */ + +#define FMC_MPSTS_D0_Pos (4) /*!< FMC_T::MPSTS: D0 Position */ +#define FMC_MPSTS_D0_Msk (0x1ul << FMC_MPSTS_D0_Pos) /*!< FMC_T::MPSTS: D0 Mask */ + +#define FMC_MPSTS_D1_Pos (5) /*!< FMC_T::MPSTS: D1 Position */ +#define FMC_MPSTS_D1_Msk (0x1ul << FMC_MPSTS_D1_Pos) /*!< FMC_T::MPSTS: D1 Mask */ + +#define FMC_MPSTS_D2_Pos (6) /*!< FMC_T::MPSTS: D2 Position */ +#define FMC_MPSTS_D2_Msk (0x1ul << FMC_MPSTS_D2_Pos) /*!< FMC_T::MPSTS: D2 Mask */ + +#define FMC_MPSTS_D3_Pos (7) /*!< FMC_T::MPSTS: D3 Position */ +#define FMC_MPSTS_D3_Msk (0x1ul << FMC_MPSTS_D3_Pos) /*!< FMC_T::MPSTS: D3 Mask */ + +#define FMC_MPADDR_MPADDR_Pos (0) /*!< FMC_T::MPADDR: MPADDR Position */ +#define FMC_MPADDR_MPADDR_Msk (0xfffffffful << FMC_MPADDR_MPADDR_Pos) /*!< FMC_T::MPADDR: MPADDR Mask */ + +#define FMC_XOMR0STS_SIZE_Pos (0) /*!< FMC_T::XOMR0STS: SIZE Position */ +#define FMC_XOMR0STS_SIZE_Msk (0xfful << FMC_XOMR0STS_SIZE_Pos) /*!< FMC_T::XOMR0STS: SIZE Mask */ + +#define FMC_XOMR0STS_BASE_Pos (8) /*!< FMC_T::XOMR0STS: BASE Position */ +#define FMC_XOMR0STS_BASE_Msk (0xfffffful << FMC_XOMR0STS_BASE_Pos) /*!< FMC_T::XOMR0STS: BASE Mask */ + +#define FMC_XOMR1STS_SIZE_Pos (0) /*!< FMC_T::XOMR1STS: SIZE Position */ +#define FMC_XOMR1STS_SIZE_Msk (0xfful << FMC_XOMR1STS_SIZE_Pos) /*!< FMC_T::XOMR1STS: SIZE Mask */ + +#define FMC_XOMR1STS_BASE_Pos (8) /*!< FMC_T::XOMR1STS: BASE Position */ +#define FMC_XOMR1STS_BASE_Msk (0xfffffful << FMC_XOMR1STS_BASE_Pos) /*!< FMC_T::XOMR1STS: BASE Mask */ + +#define FMC_XOMR2STS_SIZE_Pos (0) /*!< FMC_T::XOMR2STS: SIZE Position */ +#define FMC_XOMR2STS_SIZE_Msk (0xfful << FMC_XOMR2STS_SIZE_Pos) /*!< FMC_T::XOMR2STS: SIZE Mask */ + +#define FMC_XOMR2STS_BASE_Pos (8) /*!< FMC_T::XOMR2STS: BASE Position */ +#define FMC_XOMR2STS_BASE_Msk (0xfffffful << FMC_XOM20STS_BASE_Pos) /*!< FMC_T::XOMR2STS: BASE Mask */ + +#define FMC_XOMR3STS_SIZE_Pos (0) /*!< FMC_T::XOMR3STS: SIZE Position */ +#define FMC_XOMR3STS_SIZE_Msk (0xfful << FMC_XOMR3STS_SIZE_Pos) /*!< FMC_T::XOMR3STS: SIZE Mask */ + +#define FMC_XOMR3STS_BASE_Pos (8) /*!< FMC_T::XOMR3STS: BASE Position */ +#define FMC_XOMR3STS_BASE_Msk (0xfffffful << FMC_XOMR3STS_BASE_Pos) /*!< FMC_T::XOMR3STS: BASE Mask */ + +#define FMC_XOMSTS_XOMR0ON_Pos (0) /*!< FMC_T::XOMSTS: XOMR0ON Position */ +#define FMC_XOMSTS_XOMR0ON_Msk (0x1ul << FMC_XOMSTS_XOMR0ON_Pos) /*!< FMC_T::XOMSTS: XOMR0ON Mask */ + +#define FMC_XOMSTS_XOMR1ON_Pos (1) /*!< FMC_T::XOMSTS: XOMR1ON Position */ +#define FMC_XOMSTS_XOMR1ON_Msk (0x1ul << FMC_XOMSTS_XOMR1ON_Pos) /*!< FMC_T::XOMSTS: XOMR1ON Mask */ + +#define FMC_XOMSTS_XOMR2ON_Pos (2) /*!< FMC_T::XOMSTS: XOMR2ON Position */ +#define FMC_XOMSTS_XOMR2ON_Msk (0x1ul << FMC_XOMSTS_XOMR2ON_Pos) /*!< FMC_T::XOMSTS: XOMR2ON Mask */ + +#define FMC_XOMSTS_XOMR3ON_Pos (3) /*!< FMC_T::XOMSTS: XOMR3ON Position */ +#define FMC_XOMSTS_XOMR3ON_Msk (0x1ul << FMC_XOMSTS_XOMR3ON_Pos) /*!< FMC_T::XOMSTS: XOMR3ON Mask */ + +#define FMC_XOMSTS_XOMPEF_Pos (4) /*!< FMC_T::XOMSTS: XOMPEF Position */ +#define FMC_XOMSTS_XOMPEF_Msk (0x1ul << FMC_XOMSTS_XOMPEF_Pos) /*!< FMC_T::XOMSTS: XOMPEF Mask */ + +/**@}*/ /* FMC_CONST */ +/**@}*/ /* end of FMC register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __FMC_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/gpio_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/gpio_reg.h new file mode 100644 index 00000000000..9876f972845 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/gpio_reg.h @@ -0,0 +1,936 @@ +/**************************************************************************//** + * @file gpio_reg.h + * @version V1.00 + * @brief GPIO register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __GPIO_REG_H__ +#define __GPIO_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup GPIO General Purpose Input/Output Controller(GPIO) + Memory Mapped Structure for GPIO Controller +@{ */ + + +typedef struct +{ + + /** + * @var GPIO_T::MODE + * Offset: 0x00/0x40/0x80/0xC0/0x100/0x140/0x180/0x1C0 Port A-H I/O Mode Control + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2n+1:2n]|MODEn |Port A-H I/O Pin[n] Mode Control + * | | |Determine each I/O mode of Px.n pins. + * | | |00 = Px.n is in Input mode. + * | | |01 = Px.n is in Push-pull Output mode. + * | | |10 = Px.n is in Open-drain Output mode. + * | | |11 = Px.n is in Quasi-bidirectional mode. + * | | |Note1: The initial value of this field is defined by CIOINI (CONFIG0 [10]). + * | | |If CIOINI is set to 0, the default value is 0xFFFF_FFFF and all pins will be quasi-bidirectional mode after chip powered on. + * | | |If CIOINI is set to 1, the default value is 0x0000_0000 and all pins will be input mode after chip powered on. + * | | |Note2: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * @var GPIO_T::DINOFF + * Offset: 0x04/0x44/0x84/0xC4/0x104/0x144/0x184/0x1C4 Port A-H Digital Input Path Disable Control + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[n+16] |DINOFFn |Port A-H Pin[n] Digital Input Path Disable Control + * | | |Each of these bits is used to control if the digital input path of corresponding Px.n pin is disabled. + * | | |If input is analog signal, users can disable Px.n digital input path to avoid input current leakage. + * | | |0 = Px.n digital input path Enabled. + * | | |1 = Px.n digital input path Disabled (digital input tied to low). + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * @var GPIO_T::DOUT + * Offset: 0x08/0x48/0x88/0xC8/0x108/0x148/0x188/0x1C8 Port A-H Data Output Value + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[n] |DOUTn |Port A-H Pin[n] Output Value + * | | |Each of these bits controls the status of a Px.n pin when the Px.n is configured as Push-pull output, Open-drain output or Quasi-bidirectional mode. + * | | |0 = Px.n will drive Low if the Px.n pin is configured as Push-pull output, Open-drain output or Quasi-bidirectional mode. + * | | |1 = Px.n will drive High if the Px.n pin is configured as Push-pull output or Quasi-bidirectional mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * @var GPIO_T::DATMSK + * Offset: 0x0C/0x4C/0x8C/0xCC/0x10C/0x14C/0x18C/0x1CC Port A-H Data Output Write Mask + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[n] |DATMSKn |Port A-H Pin[n] Data Output Write Mask + * | | |These bits are used to protect the corresponding DOUT (Px_DOUT[n]) bit. + * | | |When the DATMSK (Px_DATMSK[n]) bit is set to 1, the corresponding DOUT (Px_DOUT[n]) bit is protected. + * | | |If the write signal is masked, writing data to the protect bit is ignored. + * | | |0 = Corresponding DOUT (Px_DOUT[n]) bit can be updated. + * | | |1 = Corresponding DOUT (Px_DOUT[n]) bit protected. + * | | |Note1: This function only protects the corresponding DOUT (Px_DOUT[n]) bit, and will not protect the corresponding PDIO (Pxn_PDIO[n]) bit. + * | | |Note2: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * @var GPIO_T::PIN + * Offset: 0x10/0x50/0x90/0xD0/0x110/0x150/0x190/0x1D0 Port A-H Pin Value + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[n] |PINn |Port A-H Pin[n] Pin Value + * | | |Each bit of the register reflects the actual status of the respective Px.n pin. + * | | |If the bit is 1, it indicates the corresponding pin status is high; else the pin status is low. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * @var GPIO_T::DBEN + * Offset: 0x14/0x54/0x94/0xD4/0x114/0x154/0x194/0x1D4 Port A-H De-Bounce Enable Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[n] |DBENn |Port A-H Pin[n] Input Signal De-Bounce Enable Bit + * | | |The DBEN[n] bit is used to enable the de-bounce function for each corresponding bit. + * | | |If the input signal pulse width cannot be sampled by continuous two de-bounce sample cycle, the input signal transition is seen as the signal bounce and will not trigger the interrupt. + * | | |The de-bounce clock source is controlled by DBCLKSRC (GPIO_DBCTL [4]), one de-bounce sample cycle period is controlled by DBCLKSEL (GPIO_DBCTL [3:0]). + * | | |0 = Px.n de-bounce function Disabled. + * | | |1 = Px.n de-bounce function Enabled. + * | | |The de-bounce function is valid only for edge triggered interrupt. + * | | |If the interrupt mode is level triggered, the de-bounce enable bit is ignored. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * @var GPIO_T::INTTYPE + * Offset: 0x18/0x58/0x98/0xD8/0x118/0x158/0x198/0x1D8 Port A-H Interrupt Trigger Type Control + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[n] |TYPEn |Port A-H Pin[n] Edge or Level Detection Interrupt Trigger Type Control + * | | |TYPE (Px_INTTYPE[n]) bit is used to control the triggered interrupt is by level trigger or by edge trigger. + * | | |If the interrupt is by edge trigger, the trigger source can be controlled by de-bounce. + * | | |If the interrupt is by level trigger, the input source is sampled by one HCLK clock and generates the interrupt. + * | | |0 = Edge trigger interrupt. + * | | |1 = Level trigger interrupt. + * | | |If the pin is set as the level trigger interrupt, only one level can be set on the registers RHIEN (Px_INTEN[n+16])/FLIEN (Px_INTEN[n]). + * | | |If both levels to trigger interrupt are set, the setting is ignored and no interrupt will occur. + * | | |The de-bounce function is valid only for edge triggered interrupt. + * | | |If the interrupt mode is level triggered, the de-bounce enable bit is ignored. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * @var GPIO_T::INTEN + * Offset: 0x1C/0x5C/0x9C/0xDC/0x11C/0x15C/0x19C/0x1DC Port A-H Interrupt Enable Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[n] |FLIENn |Port A-H Pin[n] Falling Edge or Low Level Interrupt Trigger Type Enable Bit + * | | |The FLIEN (Px_INTEN[n]) bit is used to enable the interrupt for each of the corresponding input Px.n pin. + * | | |Set bit to 1 also enable the pin wake-up function. + * | | |When setting the FLIEN (Px_INTEN[n]) bit to 1 : + * | | |If the interrupt is level trigger (TYPE (Px_INTTYPE[n]) bit is set to 1), the input Px.n pin will generate the interrupt while this pin state is at low level. + * | | |If the interrupt is edge trigger(TYPE (Px_INTTYPE[n]) bit is set to 0), the input Px.n pin will generate the interrupt while this pin state changed from high to low. + * | | |0 = Px.n level low or high to low interrupt Disabled. + * | | |1 = Px.n level low or high to low interrupt Enabled. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[n+16] |RHIENn |Port A-H Pin[n] Rising Edge or High Level Interrupt Trigger Type Enable Bit + * | | |The RHIEN (Px_INTEN[n+16]) bit is used to enable the interrupt for each of the corresponding input Px.n pin + * | | |Set bit to 1 also enable the pin wake-up function. + * | | |When setting the RHIEN (Px_INTEN[n+16]) bit to 1 : + * | | |If the interrupt is level trigger (TYPE (Px_INTTYPE[n]) bit is set to 1), the input Px.n pin will generate the interrupt while this pin state is at high level. + * | | |If the interrupt is edge trigger (TYPE (Px_INTTYPE[n]) bit is set to 0), the input Px.n pin will generate the interrupt while this pin state changed from low to high. + * | | |0 = Px.n level high or low to high interrupt Disabled. + * | | |1 = Px.n level high or low to high interrupt Enabled. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * @var GPIO_T::INTSRC + * Offset: 0x20/0x60/0xA0/0xE0/0x120/0x160/0x1A0/0x1E0 Port A-H Interrupt Source Flag + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[n] |INTSRCn |Port A-H Pin[n] Interrupt Source Flag + * | | |Write Operation : + * | | |0 = No action. + * | | |1 = Clear the corresponding pending interrupt. + * | | |Read Operation : + * | | |0 = No interrupt at Px.n. + * | | |1 = Px.n generates an interrupt. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * @var GPIO_T::SMTEN + * Offset: 0x24/0x64/0xA4/0xE4/0x124/0x164/0x1A4/0x1E4 Port A-H Input Schmitt Trigger Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[n] |SMTENn |Port A-H Pin[n] Input Schmitt Trigger Enable Bit + * | | |0 = Px.n input Schmitt trigger function Disabled. + * | | |1 = Px.n input Schmitt trigger function Enabled. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * @var GPIO_T::SLEWCTL + * Offset: 0x28/0x68/0xA8/0xE8/0x128/0x168/0x1A8/0x1E8 Port A-H High Slew Rate Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2n+1:2n]|HSRENn |Port A-H Pin[n] High Slew Rate Control + * | | |00 = Px.n output with normal slew rate mode (maximum 40 MHz at 2.7V). + * | | |01 = Px.n output with high slew rate mode (maximum 80 MHz at 2.7V). + * | | |10 = Px.n output with fast slew rate mode (maximum 100 MHz at 2.7V. + * | | |11 = Reserved. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * @var GPIO_T::PUSEL + * Offset: 0x30/0x70/0xB0/0xF0/0x130/0x170/0x1B0/0x1F0 Port A-H Pull-up and Pull-down Selection Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2n+1:2n]|PUSELn |Port A-H Pin[n] Pull-up and Pull-down Enable Register + * | | |Determine each I/O Pull-up/pull-down of Px.n pins. + * | | |00 = Px.n pull-up and pull-up disable. + * | | |01 = Px.n pull-up enable. + * | | |10 = Px.n pull-down enable. + * | | |11 = Reserved. + * | | |Note1: + * | | |Basically, the pull-up control and pull-down control has following behavior limitation + * | | |The independent pull-up control register only valid when MODEn set as tri-state and open-drain mode + * | | |The independent pull-down control register only valid when MODEn set as tri-state mode + * | | |When both pull-up pull-down is set as 1 at tri-state mode, keep I/O in tri-state mode + * | | |Note2: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + */ + + __IO uint32_t MODE; /* Offset: 0x00/0x40/0x80/0xC0/0x100/0x140/0x180/0x1C0 Port A-H I/O Mode Control */ + __IO uint32_t DINOFF; /* Offset: 0x04/0x44/0x84/0xC4/0x104/0x144/0x184/0x1C4 Port A-H Digital Input Path Disable Control */ + __IO uint32_t DOUT; /* Offset: 0x08/0x48/0x88/0xC8/0x108/0x148/0x188/0x1C8 Port A-H Data Output Value */ + __IO uint32_t DATMSK; /* Offset: 0x0C/0x4C/0x8C/0xCC/0x10C/0x14C/0x18C/0x1CC Port A-H Data Output Write Mask */ + __I uint32_t PIN; /* Offset: 0x10/0x50/0x90/0xD0/0x110/0x150/0x190/0x1D0 Port A-H Pin Value */ + __IO uint32_t DBEN; /* Offset: 0x14/0x54/0x94/0xD4/0x114/0x154/0x194/0x1D4 Port A-H De-Bounce Enable Control Register */ + __IO uint32_t INTTYPE; /* Offset: 0x18/0x58/0x98/0xD8/0x118/0x158/0x198/0x1D8 Port A-H Interrupt Trigger Type Control */ + __IO uint32_t INTEN; /* Offset: 0x1C/0x5C/0x9C/0xDC/0x11C/0x15C/0x19C/0x1DC Port A-H Interrupt Enable Control Register */ + __IO uint32_t INTSRC; /* Offset: 0x20/0x60/0xA0/0xE0/0x120/0x160/0x1A0/0x1E0 Port A-H Interrupt Source Flag */ + __IO uint32_t SMTEN; /* Offset: 0x24/0x64/0xA4/0xE4/0x124/0x164/0x1A4/0x1E4 Port A-H Input Schmitt Trigger Enable Register */ + __IO uint32_t SLEWCTL; /* Offset: 0x28/0x68/0xA8/0xE8/0x128/0x168/0x1A8/0x1E8 Port A-H High Slew Rate Control Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t PUSEL; /* Offset: 0x30/0x70/0xB0/0xF0/0x130/0x170/0x1B0/0x1F0 Port A-H Pull-up and Pull-down Enable Register */ + +} GPIO_T; + +typedef struct +{ + + /** + * @var GPIO_DBCTL_T::DBCTL + * Offset: 0x440 Interrupt De-bounce Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |DBCLKSEL |De-Bounce Sampling Cycle Selection + * | | |0000 = Sample interrupt input once per 1 clocks. + * | | |0001 = Sample interrupt input once per 2 clocks. + * | | |0010 = Sample interrupt input once per 4 clocks. + * | | |0011 = Sample interrupt input once per 8 clocks. + * | | |0100 = Sample interrupt input once per 16 clocks. + * | | |0101 = Sample interrupt input once per 32 clocks. + * | | |0110 = Sample interrupt input once per 64 clocks. + * | | |0111 = Sample interrupt input once per 128 clocks. + * | | |1000 = Sample interrupt input once per 256 clocks. + * | | |1001 = Sample interrupt input once per 2*256 clocks. + * | | |1010 = Sample interrupt input once per 4*256 clocks. + * | | |1011 = Sample interrupt input once per 8*256 clocks. + * | | |1100 = Sample interrupt input once per 16*256 clocks. + * | | |1101 = Sample interrupt input once per 32*256 clocks. + * | | |1110 = Sample interrupt input once per 64*256 clocks. + * | | |1111 = Sample interrupt input once per 128*256 clocks. + * |[4] |DBCLKSRC |De-Bounce Counter Clock Source Selection + * | | |0 = De-bounce counter clock source is the HCLK. + * | | |1 = De-bounce counter clock source is the 10 kHz internal low speed RC oscillator (LIRC). + * |[5] |ICLKON |Interrupt Clock On Mode + * | | |0 = Edge detection circuit is active only if I/O pin corresponding RHIEN (Px_INTEN[n+16])/FLIEN (Px_INTEN[n]) bit is set to 1. + * | | |1 = All I/O pins edge detection circuit is always active after reset. + * | | |Note: It is recommended to disable this bit to save system power if no special application concern. + */ + + __IO uint32_t DBCTL; /* Offset: 0x440 Interrupt De-bounce Control Register */ + +} GPIO_DBCTL_T; + +/** + @addtogroup GPIO_CONST GPIO Bit Field Definition + Constant Definitions for GPIO Controller +@{ */ + +#define GPIO_MODE_MODE0_Pos (0) /*!< GPIO_T::MODE: MODE0 Position */ +#define GPIO_MODE_MODE0_Msk (0x3ul << GPIO_MODE_MODE0_Pos) /*!< GPIO_T::MODE: MODE0 Mask */ + +#define GPIO_MODE_MODE1_Pos (2) /*!< GPIO_T::MODE: MODE1 Position */ +#define GPIO_MODE_MODE1_Msk (0x3ul << GPIO_MODE_MODE1_Pos) /*!< GPIO_T::MODE: MODE1 Mask */ + +#define GPIO_MODE_MODE2_Pos (4) /*!< GPIO_T::MODE: MODE2 Position */ +#define GPIO_MODE_MODE2_Msk (0x3ul << GPIO_MODE_MODE2_Pos) /*!< GPIO_T::MODE: MODE2 Mask */ + +#define GPIO_MODE_MODE3_Pos (6) /*!< GPIO_T::MODE: MODE3 Position */ +#define GPIO_MODE_MODE3_Msk (0x3ul << GPIO_MODE_MODE3_Pos) /*!< GPIO_T::MODE: MODE3 Mask */ + +#define GPIO_MODE_MODE4_Pos (8) /*!< GPIO_T::MODE: MODE4 Position */ +#define GPIO_MODE_MODE4_Msk (0x3ul << GPIO_MODE_MODE4_Pos) /*!< GPIO_T::MODE: MODE4 Mask */ + +#define GPIO_MODE_MODE5_Pos (10) /*!< GPIO_T::MODE: MODE5 Position */ +#define GPIO_MODE_MODE5_Msk (0x3ul << GPIO_MODE_MODE5_Pos) /*!< GPIO_T::MODE: MODE5 Mask */ + +#define GPIO_MODE_MODE6_Pos (12) /*!< GPIO_T::MODE: MODE6 Position */ +#define GPIO_MODE_MODE6_Msk (0x3ul << GPIO_MODE_MODE6_Pos) /*!< GPIO_T::MODE: MODE6 Mask */ + +#define GPIO_MODE_MODE7_Pos (14) /*!< GPIO_T::MODE: MODE7 Position */ +#define GPIO_MODE_MODE7_Msk (0x3ul << GPIO_MODE_MODE7_Pos) /*!< GPIO_T::MODE: MODE7 Mask */ + +#define GPIO_MODE_MODE8_Pos (16) /*!< GPIO_T::MODE: MODE8 Position */ +#define GPIO_MODE_MODE8_Msk (0x3ul << GPIO_MODE_MODE8_Pos) /*!< GPIO_T::MODE: MODE8 Mask */ + +#define GPIO_MODE_MODE9_Pos (18) /*!< GPIO_T::MODE: MODE9 Position */ +#define GPIO_MODE_MODE9_Msk (0x3ul << GPIO_MODE_MODE9_Pos) /*!< GPIO_T::MODE: MODE9 Mask */ + +#define GPIO_MODE_MODE10_Pos (20) /*!< GPIO_T::MODE: MODE10 Position */ +#define GPIO_MODE_MODE10_Msk (0x3ul << GPIO_MODE_MODE10_Pos) /*!< GPIO_T::MODE: MODE10 Mask */ + +#define GPIO_MODE_MODE11_Pos (22) /*!< GPIO_T::MODE: MODE11 Position */ +#define GPIO_MODE_MODE11_Msk (0x3ul << GPIO_MODE_MODE11_Pos) /*!< GPIO_T::MODE: MODE11 Mask */ + +#define GPIO_MODE_MODE12_Pos (24) /*!< GPIO_T::MODE: MODE12 Position */ +#define GPIO_MODE_MODE12_Msk (0x3ul << GPIO_MODE_MODE12_Pos) /*!< GPIO_T::MODE: MODE12 Mask */ + +#define GPIO_MODE_MODE13_Pos (26) /*!< GPIO_T::MODE: MODE13 Position */ +#define GPIO_MODE_MODE13_Msk (0x3ul << GPIO_MODE_MODE13_Pos) /*!< GPIO_T::MODE: MODE13 Mask */ + +#define GPIO_MODE_MODE14_Pos (28) /*!< GPIO_T::MODE: MODE14 Position */ +#define GPIO_MODE_MODE14_Msk (0x3ul << GPIO_MODE_MODE14_Pos) /*!< GPIO_T::MODE: MODE14 Mask */ + +#define GPIO_MODE_MODE15_Pos (30) /*!< GPIO_T::MODE: MODE15 Position */ +#define GPIO_MODE_MODE15_Msk (0x3ul << GPIO_MODE_MODE15_Pos) /*!< GPIO_T::MODE: MODE15 Mask */ + +#define GPIO_DINOFF_DINOFF0_Pos (16) /*!< GPIO_T::DINOFF: DINOFF0 Position */ +#define GPIO_DINOFF_DINOFF0_Msk (0x1ul << GPIO_DINOFF_DINOFF0_Pos) /*!< GPIO_T::DINOFF: DINOFF0 Mask */ + +#define GPIO_DINOFF_DINOFF1_Pos (17) /*!< GPIO_T::DINOFF: DINOFF1 Position */ +#define GPIO_DINOFF_DINOFF1_Msk (0x1ul << GPIO_DINOFF_DINOFF1_Pos) /*!< GPIO_T::DINOFF: DINOFF1 Mask */ + +#define GPIO_DINOFF_DINOFF2_Pos (18) /*!< GPIO_T::DINOFF: DINOFF2 Position */ +#define GPIO_DINOFF_DINOFF2_Msk (0x1ul << GPIO_DINOFF_DINOFF2_Pos) /*!< GPIO_T::DINOFF: DINOFF2 Mask */ + +#define GPIO_DINOFF_DINOFF3_Pos (19) /*!< GPIO_T::DINOFF: DINOFF3 Position */ +#define GPIO_DINOFF_DINOFF3_Msk (0x1ul << GPIO_DINOFF_DINOFF3_Pos) /*!< GPIO_T::DINOFF: DINOFF3 Mask */ + +#define GPIO_DINOFF_DINOFF4_Pos (20) /*!< GPIO_T::DINOFF: DINOFF4 Position */ +#define GPIO_DINOFF_DINOFF4_Msk (0x1ul << GPIO_DINOFF_DINOFF4_Pos) /*!< GPIO_T::DINOFF: DINOFF4 Mask */ + +#define GPIO_DINOFF_DINOFF5_Pos (21) /*!< GPIO_T::DINOFF: DINOFF5 Position */ +#define GPIO_DINOFF_DINOFF5_Msk (0x1ul << GPIO_DINOFF_DINOFF5_Pos) /*!< GPIO_T::DINOFF: DINOFF5 Mask */ + +#define GPIO_DINOFF_DINOFF6_Pos (22) /*!< GPIO_T::DINOFF: DINOFF6 Position */ +#define GPIO_DINOFF_DINOFF6_Msk (0x1ul << GPIO_DINOFF_DINOFF6_Pos) /*!< GPIO_T::DINOFF: DINOFF6 Mask */ + +#define GPIO_DINOFF_DINOFF7_Pos (23) /*!< GPIO_T::DINOFF: DINOFF7 Position */ +#define GPIO_DINOFF_DINOFF7_Msk (0x1ul << GPIO_DINOFF_DINOFF7_Pos) /*!< GPIO_T::DINOFF: DINOFF7 Mask */ + +#define GPIO_DINOFF_DINOFF8_Pos (24) /*!< GPIO_T::DINOFF: DINOFF8 Position */ +#define GPIO_DINOFF_DINOFF8_Msk (0x1ul << GPIO_DINOFF_DINOFF8_Pos) /*!< GPIO_T::DINOFF: DINOFF8 Mask */ + +#define GPIO_DINOFF_DINOFF9_Pos (25) /*!< GPIO_T::DINOFF: DINOFF9 Position */ +#define GPIO_DINOFF_DINOFF9_Msk (0x1ul << GPIO_DINOFF_DINOFF9_Pos) /*!< GPIO_T::DINOFF: DINOFF9 Mask */ + +#define GPIO_DINOFF_DINOFF10_Pos (26) /*!< GPIO_T::DINOFF: DINOFF10 Position */ +#define GPIO_DINOFF_DINOFF10_Msk (0x1ul << GPIO_DINOFF_DINOFF10_Pos) /*!< GPIO_T::DINOFF: DINOFF10 Mask */ + +#define GPIO_DINOFF_DINOFF11_Pos (27) /*!< GPIO_T::DINOFF: DINOFF11 Position */ +#define GPIO_DINOFF_DINOFF11_Msk (0x1ul << GPIO_DINOFF_DINOFF11_Pos) /*!< GPIO_T::DINOFF: DINOFF11 Mask */ + +#define GPIO_DINOFF_DINOFF12_Pos (28) /*!< GPIO_T::DINOFF: DINOFF12 Position */ +#define GPIO_DINOFF_DINOFF12_Msk (0x1ul << GPIO_DINOFF_DINOFF12_Pos) /*!< GPIO_T::DINOFF: DINOFF12 Mask */ + +#define GPIO_DINOFF_DINOFF13_Pos (29) /*!< GPIO_T::DINOFF: DINOFF13 Position */ +#define GPIO_DINOFF_DINOFF13_Msk (0x1ul << GPIO_DINOFF_DINOFF13_Pos) /*!< GPIO_T::DINOFF: DINOFF13 Mask */ + +#define GPIO_DINOFF_DINOFF14_Pos (30) /*!< GPIO_T::DINOFF: DINOFF14 Position */ +#define GPIO_DINOFF_DINOFF14_Msk (0x1ul << GPIO_DINOFF_DINOFF14_Pos) /*!< GPIO_T::DINOFF: DINOFF14 Mask */ + +#define GPIO_DINOFF_DINOFF15_Pos (31) /*!< GPIO_T::DINOFF: DINOFF15 Position */ +#define GPIO_DINOFF_DINOFF15_Msk (0x1ul << GPIO_DINOFF_DINOFF15_Pos) /*!< GPIO_T::DINOFF: DINOFF15 Mask */ + +#define GPIO_DOUT_DOUT0_Pos (0) /*!< GPIO_T::DOUT: DOUT0 Position */ +#define GPIO_DOUT_DOUT0_Msk (0x1ul << GPIO_DOUT_DOUT0_Pos) /*!< GPIO_T::DOUT: DOUT0 Mask */ + +#define GPIO_DOUT_DOUT1_Pos (1) /*!< GPIO_T::DOUT: DOUT1 Position */ +#define GPIO_DOUT_DOUT1_Msk (0x1ul << GPIO_DOUT_DOUT1_Pos) /*!< GPIO_T::DOUT: DOUT1 Mask */ + +#define GPIO_DOUT_DOUT2_Pos (2) /*!< GPIO_T::DOUT: DOUT2 Position */ +#define GPIO_DOUT_DOUT2_Msk (0x1ul << GPIO_DOUT_DOUT2_Pos) /*!< GPIO_T::DOUT: DOUT2 Mask */ + +#define GPIO_DOUT_DOUT3_Pos (3) /*!< GPIO_T::DOUT: DOUT3 Position */ +#define GPIO_DOUT_DOUT3_Msk (0x1ul << GPIO_DOUT_DOUT3_Pos) /*!< GPIO_T::DOUT: DOUT3 Mask */ + +#define GPIO_DOUT_DOUT4_Pos (4) /*!< GPIO_T::DOUT: DOUT4 Position */ +#define GPIO_DOUT_DOUT4_Msk (0x1ul << GPIO_DOUT_DOUT4_Pos) /*!< GPIO_T::DOUT: DOUT4 Mask */ + +#define GPIO_DOUT_DOUT5_Pos (5) /*!< GPIO_T::DOUT: DOUT5 Position */ +#define GPIO_DOUT_DOUT5_Msk (0x1ul << GPIO_DOUT_DOUT5_Pos) /*!< GPIO_T::DOUT: DOUT5 Mask */ + +#define GPIO_DOUT_DOUT6_Pos (6) /*!< GPIO_T::DOUT: DOUT6 Position */ +#define GPIO_DOUT_DOUT6_Msk (0x1ul << GPIO_DOUT_DOUT6_Pos) /*!< GPIO_T::DOUT: DOUT6 Mask */ + +#define GPIO_DOUT_DOUT7_Pos (7) /*!< GPIO_T::DOUT: DOUT7 Position */ +#define GPIO_DOUT_DOUT7_Msk (0x1ul << GPIO_DOUT_DOUT7_Pos) /*!< GPIO_T::DOUT: DOUT7 Mask */ + +#define GPIO_DOUT_DOUT8_Pos (8) /*!< GPIO_T::DOUT: DOUT8 Position */ +#define GPIO_DOUT_DOUT8_Msk (0x1ul << GPIO_DOUT_DOUT8_Pos) /*!< GPIO_T::DOUT: DOUT8 Mask */ + +#define GPIO_DOUT_DOUT9_Pos (9) /*!< GPIO_T::DOUT: DOUT9 Position */ +#define GPIO_DOUT_DOUT9_Msk (0x1ul << GPIO_DOUT_DOUT9_Pos) /*!< GPIO_T::DOUT: DOUT9 Mask */ + +#define GPIO_DOUT_DOUT10_Pos (10) /*!< GPIO_T::DOUT: DOUT10 Position */ +#define GPIO_DOUT_DOUT10_Msk (0x1ul << GPIO_DOUT_DOUT10_Pos) /*!< GPIO_T::DOUT: DOUT10 Mask */ + +#define GPIO_DOUT_DOUT11_Pos (11) /*!< GPIO_T::DOUT: DOUT11 Position */ +#define GPIO_DOUT_DOUT11_Msk (0x1ul << GPIO_DOUT_DOUT11_Pos) /*!< GPIO_T::DOUT: DOUT11 Mask */ + +#define GPIO_DOUT_DOUT12_Pos (12) /*!< GPIO_T::DOUT: DOUT12 Position */ +#define GPIO_DOUT_DOUT12_Msk (0x1ul << GPIO_DOUT_DOUT12_Pos) /*!< GPIO_T::DOUT: DOUT12 Mask */ + +#define GPIO_DOUT_DOUT13_Pos (13) /*!< GPIO_T::DOUT: DOUT13 Position */ +#define GPIO_DOUT_DOUT13_Msk (0x1ul << GPIO_DOUT_DOUT13_Pos) /*!< GPIO_T::DOUT: DOUT13 Mask */ + +#define GPIO_DOUT_DOUT14_Pos (14) /*!< GPIO_T::DOUT: DOUT14 Position */ +#define GPIO_DOUT_DOUT14_Msk (0x1ul << GPIO_DOUT_DOUT14_Pos) /*!< GPIO_T::DOUT: DOUT14 Mask */ + +#define GPIO_DOUT_DOUT15_Pos (15) /*!< GPIO_T::DOUT: DOUT15 Position */ +#define GPIO_DOUT_DOUT15_Msk (0x1ul << GPIO_DOUT_DOUT15_Pos) /*!< GPIO_T::DOUT: DOUT15 Mask */ + +#define GPIO_DATMSK_DATMSK0_Pos (0) /*!< GPIO_T::DATMSK: DATMSK0 Position */ +#define GPIO_DATMSK_DATMSK0_Msk (0x1ul << GPIO_DATMSK_DATMSK0_Pos) /*!< GPIO_T::DATMSK: DATMSK0 Mask */ + +#define GPIO_DATMSK_DATMSK1_Pos (1) /*!< GPIO_T::DATMSK: DATMSK1 Position */ +#define GPIO_DATMSK_DATMSK1_Msk (0x1ul << GPIO_DATMSK_DATMSK1_Pos) /*!< GPIO_T::DATMSK: DATMSK1 Mask */ + +#define GPIO_DATMSK_DATMSK2_Pos (2) /*!< GPIO_T::DATMSK: DATMSK2 Position */ +#define GPIO_DATMSK_DATMSK2_Msk (0x1ul << GPIO_DATMSK_DATMSK2_Pos) /*!< GPIO_T::DATMSK: DATMSK2 Mask */ + +#define GPIO_DATMSK_DATMSK3_Pos (3) /*!< GPIO_T::DATMSK: DATMSK3 Position */ +#define GPIO_DATMSK_DATMSK3_Msk (0x1ul << GPIO_DATMSK_DATMSK3_Pos) /*!< GPIO_T::DATMSK: DATMSK3 Mask */ + +#define GPIO_DATMSK_DATMSK4_Pos (4) /*!< GPIO_T::DATMSK: DATMSK4 Position */ +#define GPIO_DATMSK_DATMSK4_Msk (0x1ul << GPIO_DATMSK_DATMSK4_Pos) /*!< GPIO_T::DATMSK: DATMSK4 Mask */ + +#define GPIO_DATMSK_DATMSK5_Pos (5) /*!< GPIO_T::DATMSK: DATMSK5 Position */ +#define GPIO_DATMSK_DATMSK5_Msk (0x1ul << GPIO_DATMSK_DATMSK5_Pos) /*!< GPIO_T::DATMSK: DATMSK5 Mask */ + +#define GPIO_DATMSK_DATMSK6_Pos (6) /*!< GPIO_T::DATMSK: DATMSK6 Position */ +#define GPIO_DATMSK_DATMSK6_Msk (0x1ul << GPIO_DATMSK_DATMSK6_Pos) /*!< GPIO_T::DATMSK: DATMSK6 Mask */ + +#define GPIO_DATMSK_DATMSK7_Pos (7) /*!< GPIO_T::DATMSK: DATMSK7 Position */ +#define GPIO_DATMSK_DATMSK7_Msk (0x1ul << GPIO_DATMSK_DATMSK7_Pos) /*!< GPIO_T::DATMSK: DATMSK7 Mask */ + +#define GPIO_DATMSK_DATMSK8_Pos (8) /*!< GPIO_T::DATMSK: DATMSK8 Position */ +#define GPIO_DATMSK_DATMSK8_Msk (0x1ul << GPIO_DATMSK_DATMSK8_Pos) /*!< GPIO_T::DATMSK: DATMSK8 Mask */ + +#define GPIO_DATMSK_DATMSK9_Pos (9) /*!< GPIO_T::DATMSK: DATMSK9 Position */ +#define GPIO_DATMSK_DATMSK9_Msk (0x1ul << GPIO_DATMSK_DATMSK9_Pos) /*!< GPIO_T::DATMSK: DATMSK9 Mask */ + +#define GPIO_DATMSK_DATMSK10_Pos (10) /*!< GPIO_T::DATMSK: DATMSK10 Position */ +#define GPIO_DATMSK_DATMSK10_Msk (0x1ul << GPIO_DATMSK_DATMSK10_Pos) /*!< GPIO_T::DATMSK: DATMSK10 Mask */ + +#define GPIO_DATMSK_DATMSK11_Pos (11) /*!< GPIO_T::DATMSK: DATMSK11 Position */ +#define GPIO_DATMSK_DATMSK11_Msk (0x1ul << GPIO_DATMSK_DATMSK11_Pos) /*!< GPIO_T::DATMSK: DATMSK11 Mask */ + +#define GPIO_DATMSK_DATMSK12_Pos (12) /*!< GPIO_T::DATMSK: DATMSK12 Position */ +#define GPIO_DATMSK_DATMSK12_Msk (0x1ul << GPIO_DATMSK_DATMSK12_Pos) /*!< GPIO_T::DATMSK: DATMSK12 Mask */ + +#define GPIO_DATMSK_DATMSK13_Pos (13) /*!< GPIO_T::DATMSK: DATMSK13 Position */ +#define GPIO_DATMSK_DATMSK13_Msk (0x1ul << GPIO_DATMSK_DATMSK13_Pos) /*!< GPIO_T::DATMSK: DATMSK13 Mask */ + +#define GPIO_DATMSK_DATMSK14_Pos (14) /*!< GPIO_T::DATMSK: DATMSK14 Position */ +#define GPIO_DATMSK_DATMSK14_Msk (0x1ul << GPIO_DATMSK_DATMSK14_Pos) /*!< GPIO_T::DATMSK: DATMSK14 Mask */ + +#define GPIO_DATMSK_DATMSK15_Pos (15) /*!< GPIO_T::DATMSK: DATMSK15 Position */ +#define GPIO_DATMSK_DATMSK15_Msk (0x1ul << GPIO_DATMSK_DATMSK15_Pos) /*!< GPIO_T::DATMSK: DATMSK15 Mask */ + +#define GPIO_PIN_PIN0_Pos (0) /*!< GPIO_T::PIN: PIN0 Position */ +#define GPIO_PIN_PIN0_Msk (0x1ul << GPIO_PIN_PIN0_Pos) /*!< GPIO_T::PIN: PIN0 Mask */ + +#define GPIO_PIN_PIN1_Pos (1) /*!< GPIO_T::PIN: PIN1 Position */ +#define GPIO_PIN_PIN1_Msk (0x1ul << GPIO_PIN_PIN1_Pos) /*!< GPIO_T::PIN: PIN1 Mask */ + +#define GPIO_PIN_PIN2_Pos (2) /*!< GPIO_T::PIN: PIN2 Position */ +#define GPIO_PIN_PIN2_Msk (0x1ul << GPIO_PIN_PIN2_Pos) /*!< GPIO_T::PIN: PIN2 Mask */ + +#define GPIO_PIN_PIN3_Pos (3) /*!< GPIO_T::PIN: PIN3 Position */ +#define GPIO_PIN_PIN3_Msk (0x1ul << GPIO_PIN_PIN3_Pos) /*!< GPIO_T::PIN: PIN3 Mask */ + +#define GPIO_PIN_PIN4_Pos (4) /*!< GPIO_T::PIN: PIN4 Position */ +#define GPIO_PIN_PIN4_Msk (0x1ul << GPIO_PIN_PIN4_Pos) /*!< GPIO_T::PIN: PIN4 Mask */ + +#define GPIO_PIN_PIN5_Pos (5) /*!< GPIO_T::PIN: PIN5 Position */ +#define GPIO_PIN_PIN5_Msk (0x1ul << GPIO_PIN_PIN5_Pos) /*!< GPIO_T::PIN: PIN5 Mask */ + +#define GPIO_PIN_PIN6_Pos (6) /*!< GPIO_T::PIN: PIN6 Position */ +#define GPIO_PIN_PIN6_Msk (0x1ul << GPIO_PIN_PIN6_Pos) /*!< GPIO_T::PIN: PIN6 Mask */ + +#define GPIO_PIN_PIN7_Pos (7) /*!< GPIO_T::PIN: PIN7 Position */ +#define GPIO_PIN_PIN7_Msk (0x1ul << GPIO_PIN_PIN7_Pos) /*!< GPIO_T::PIN: PIN7 Mask */ + +#define GPIO_PIN_PIN8_Pos (8) /*!< GPIO_T::PIN: PIN8 Position */ +#define GPIO_PIN_PIN8_Msk (0x1ul << GPIO_PIN_PIN8_Pos) /*!< GPIO_T::PIN: PIN8 Mask */ + +#define GPIO_PIN_PIN9_Pos (9) /*!< GPIO_T::PIN: PIN9 Position */ +#define GPIO_PIN_PIN9_Msk (0x1ul << GPIO_PIN_PIN9_Pos) /*!< GPIO_T::PIN: PIN9 Mask */ + +#define GPIO_PIN_PIN10_Pos (10) /*!< GPIO_T::PIN: PIN10 Position */ +#define GPIO_PIN_PIN10_Msk (0x1ul << GPIO_PIN_PIN10_Pos) /*!< GPIO_T::PIN: PIN10 Mask */ + +#define GPIO_PIN_PIN11_Pos (11) /*!< GPIO_T::PIN: PIN11 Position */ +#define GPIO_PIN_PIN11_Msk (0x1ul << GPIO_PIN_PIN11_Pos) /*!< GPIO_T::PIN: PIN11 Mask */ + +#define GPIO_PIN_PIN12_Pos (12) /*!< GPIO_T::PIN: PIN12 Position */ +#define GPIO_PIN_PIN12_Msk (0x1ul << GPIO_PIN_PIN12_Pos) /*!< GPIO_T::PIN: PIN12 Mask */ + +#define GPIO_PIN_PIN13_Pos (13) /*!< GPIO_T::PIN: PIN13 Position */ +#define GPIO_PIN_PIN13_Msk (0x1ul << GPIO_PIN_PIN13_Pos) /*!< GPIO_T::PIN: PIN13 Mask */ + +#define GPIO_PIN_PIN14_Pos (14) /*!< GPIO_T::PIN: PIN14 Position */ +#define GPIO_PIN_PIN14_Msk (0x1ul << GPIO_PIN_PIN14_Pos) /*!< GPIO_T::PIN: PIN14 Mask */ + +#define GPIO_PIN_PIN15_Pos (15) /*!< GPIO_T::PIN: PIN15 Position */ +#define GPIO_PIN_PIN15_Msk (0x1ul << GPIO_PIN_PIN15_Pos) /*!< GPIO_T::PIN: PIN15 Mask */ + +#define GPIO_DBEN_DBEN0_Pos (0) /*!< GPIO_T::DBEN: DBEN0 Position */ +#define GPIO_DBEN_DBEN0_Msk (0x1ul << GPIO_DBEN_DBEN0_Pos) /*!< GPIO_T::DBEN: DBEN0 Mask */ + +#define GPIO_DBEN_DBEN1_Pos (1) /*!< GPIO_T::DBEN: DBEN1 Position */ +#define GPIO_DBEN_DBEN1_Msk (0x1ul << GPIO_DBEN_DBEN1_Pos) /*!< GPIO_T::DBEN: DBEN1 Mask */ + +#define GPIO_DBEN_DBEN2_Pos (2) /*!< GPIO_T::DBEN: DBEN2 Position */ +#define GPIO_DBEN_DBEN2_Msk (0x1ul << GPIO_DBEN_DBEN2_Pos) /*!< GPIO_T::DBEN: DBEN2 Mask */ + +#define GPIO_DBEN_DBEN3_Pos (3) /*!< GPIO_T::DBEN: DBEN3 Position */ +#define GPIO_DBEN_DBEN3_Msk (0x1ul << GPIO_DBEN_DBEN3_Pos) /*!< GPIO_T::DBEN: DBEN3 Mask */ + +#define GPIO_DBEN_DBEN4_Pos (4) /*!< GPIO_T::DBEN: DBEN4 Position */ +#define GPIO_DBEN_DBEN4_Msk (0x1ul << GPIO_DBEN_DBEN4_Pos) /*!< GPIO_T::DBEN: DBEN4 Mask */ + +#define GPIO_DBEN_DBEN5_Pos (5) /*!< GPIO_T::DBEN: DBEN5 Position */ +#define GPIO_DBEN_DBEN5_Msk (0x1ul << GPIO_DBEN_DBEN5_Pos) /*!< GPIO_T::DBEN: DBEN5 Mask */ + +#define GPIO_DBEN_DBEN6_Pos (6) /*!< GPIO_T::DBEN: DBEN6 Position */ +#define GPIO_DBEN_DBEN6_Msk (0x1ul << GPIO_DBEN_DBEN6_Pos) /*!< GPIO_T::DBEN: DBEN6 Mask */ + +#define GPIO_DBEN_DBEN7_Pos (7) /*!< GPIO_T::DBEN: DBEN7 Position */ +#define GPIO_DBEN_DBEN7_Msk (0x1ul << GPIO_DBEN_DBEN7_Pos) /*!< GPIO_T::DBEN: DBEN7 Mask */ + +#define GPIO_DBEN_DBEN8_Pos (8) /*!< GPIO_T::DBEN: DBEN8 Position */ +#define GPIO_DBEN_DBEN8_Msk (0x1ul << GPIO_DBEN_DBEN8_Pos) /*!< GPIO_T::DBEN: DBEN8 Mask */ + +#define GPIO_DBEN_DBEN9_Pos (9) /*!< GPIO_T::DBEN: DBEN9 Position */ +#define GPIO_DBEN_DBEN9_Msk (0x1ul << GPIO_DBEN_DBEN9_Pos) /*!< GPIO_T::DBEN: DBEN9 Mask */ + +#define GPIO_DBEN_DBEN10_Pos (10) /*!< GPIO_T::DBEN: DBEN10 Position */ +#define GPIO_DBEN_DBEN10_Msk (0x1ul << GPIO_DBEN_DBEN10_Pos) /*!< GPIO_T::DBEN: DBEN10 Mask */ + +#define GPIO_DBEN_DBEN11_Pos (11) /*!< GPIO_T::DBEN: DBEN11 Position */ +#define GPIO_DBEN_DBEN11_Msk (0x1ul << GPIO_DBEN_DBEN11_Pos) /*!< GPIO_T::DBEN: DBEN11 Mask */ + +#define GPIO_DBEN_DBEN12_Pos (12) /*!< GPIO_T::DBEN: DBEN12 Position */ +#define GPIO_DBEN_DBEN12_Msk (0x1ul << GPIO_DBEN_DBEN12_Pos) /*!< GPIO_T::DBEN: DBEN12 Mask */ + +#define GPIO_DBEN_DBEN13_Pos (13) /*!< GPIO_T::DBEN: DBEN13 Position */ +#define GPIO_DBEN_DBEN13_Msk (0x1ul << GPIO_DBEN_DBEN13_Pos) /*!< GPIO_T::DBEN: DBEN13 Mask */ + +#define GPIO_DBEN_DBEN14_Pos (14) /*!< GPIO_T::DBEN: DBEN14 Position */ +#define GPIO_DBEN_DBEN14_Msk (0x1ul << GPIO_DBEN_DBEN14_Pos) /*!< GPIO_T::DBEN: DBEN14 Mask */ + +#define GPIO_DBEN_DBEN15_Pos (15) /*!< GPIO_T::DBEN: DBEN15 Position */ +#define GPIO_DBEN_DBEN15_Msk (0x1ul << GPIO_DBEN_DBEN15_Pos) /*!< GPIO_T::DBEN: DBEN15 Mask */ + +#define GPIO_INTTYPE_TYPE0_Pos (0) /*!< GPIO_T::INTTYPE: TYPE0 Position */ +#define GPIO_INTTYPE_TYPE0_Msk (0x1ul << GPIO_INTTYPE_TYPE0_Pos) /*!< GPIO_T::INTTYPE: TYPE0 Mask */ + +#define GPIO_INTTYPE_TYPE1_Pos (1) /*!< GPIO_T::INTTYPE: TYPE1 Position */ +#define GPIO_INTTYPE_TYPE1_Msk (0x1ul << GPIO_INTTYPE_TYPE1_Pos) /*!< GPIO_T::INTTYPE: TYPE1 Mask */ + +#define GPIO_INTTYPE_TYPE2_Pos (2) /*!< GPIO_T::INTTYPE: TYPE2 Position */ +#define GPIO_INTTYPE_TYPE2_Msk (0x1ul << GPIO_INTTYPE_TYPE2_Pos) /*!< GPIO_T::INTTYPE: TYPE2 Mask */ + +#define GPIO_INTTYPE_TYPE3_Pos (3) /*!< GPIO_T::INTTYPE: TYPE3 Position */ +#define GPIO_INTTYPE_TYPE3_Msk (0x1ul << GPIO_INTTYPE_TYPE3_Pos) /*!< GPIO_T::INTTYPE: TYPE3 Mask */ + +#define GPIO_INTTYPE_TYPE4_Pos (4) /*!< GPIO_T::INTTYPE: TYPE4 Position */ +#define GPIO_INTTYPE_TYPE4_Msk (0x1ul << GPIO_INTTYPE_TYPE4_Pos) /*!< GPIO_T::INTTYPE: TYPE4 Mask */ + +#define GPIO_INTTYPE_TYPE5_Pos (5) /*!< GPIO_T::INTTYPE: TYPE5 Position */ +#define GPIO_INTTYPE_TYPE5_Msk (0x1ul << GPIO_INTTYPE_TYPE5_Pos) /*!< GPIO_T::INTTYPE: TYPE5 Mask */ + +#define GPIO_INTTYPE_TYPE6_Pos (6) /*!< GPIO_T::INTTYPE: TYPE6 Position */ +#define GPIO_INTTYPE_TYPE6_Msk (0x1ul << GPIO_INTTYPE_TYPE6_Pos) /*!< GPIO_T::INTTYPE: TYPE6 Mask */ + +#define GPIO_INTTYPE_TYPE7_Pos (7) /*!< GPIO_T::INTTYPE: TYPE7 Position */ +#define GPIO_INTTYPE_TYPE7_Msk (0x1ul << GPIO_INTTYPE_TYPE7_Pos) /*!< GPIO_T::INTTYPE: TYPE7 Mask */ + +#define GPIO_INTTYPE_TYPE8_Pos (8) /*!< GPIO_T::INTTYPE: TYPE8 Position */ +#define GPIO_INTTYPE_TYPE8_Msk (0x1ul << GPIO_INTTYPE_TYPE8_Pos) /*!< GPIO_T::INTTYPE: TYPE8 Mask */ + +#define GPIO_INTTYPE_TYPE9_Pos (9) /*!< GPIO_T::INTTYPE: TYPE9 Position */ +#define GPIO_INTTYPE_TYPE9_Msk (0x1ul << GPIO_INTTYPE_TYPE9_Pos) /*!< GPIO_T::INTTYPE: TYPE9 Mask */ + +#define GPIO_INTTYPE_TYPE10_Pos (10) /*!< GPIO_T::INTTYPE: TYPE10 Position */ +#define GPIO_INTTYPE_TYPE10_Msk (0x1ul << GPIO_INTTYPE_TYPE10_Pos) /*!< GPIO_T::INTTYPE: TYPE10 Mask */ + +#define GPIO_INTTYPE_TYPE11_Pos (11) /*!< GPIO_T::INTTYPE: TYPE11 Position */ +#define GPIO_INTTYPE_TYPE11_Msk (0x1ul << GPIO_INTTYPE_TYPE11_Pos) /*!< GPIO_T::INTTYPE: TYPE11 Mask */ + +#define GPIO_INTTYPE_TYPE12_Pos (12) /*!< GPIO_T::INTTYPE: TYPE12 Position */ +#define GPIO_INTTYPE_TYPE12_Msk (0x1ul << GPIO_INTTYPE_TYPE12_Pos) /*!< GPIO_T::INTTYPE: TYPE12 Mask */ + +#define GPIO_INTTYPE_TYPE13_Pos (13) /*!< GPIO_T::INTTYPE: TYPE13 Position */ +#define GPIO_INTTYPE_TYPE13_Msk (0x1ul << GPIO_INTTYPE_TYPE13_Pos) /*!< GPIO_T::INTTYPE: TYPE13 Mask */ + +#define GPIO_INTTYPE_TYPE14_Pos (14) /*!< GPIO_T::INTTYPE: TYPE14 Position */ +#define GPIO_INTTYPE_TYPE14_Msk (0x1ul << GPIO_INTTYPE_TYPE14_Pos) /*!< GPIO_T::INTTYPE: TYPE14 Mask */ + +#define GPIO_INTTYPE_TYPE15_Pos (15) /*!< GPIO_T::INTTYPE: TYPE15 Position */ +#define GPIO_INTTYPE_TYPE15_Msk (0x1ul << GPIO_INTTYPE_TYPE15_Pos) /*!< GPIO_T::INTTYPE: TYPE15 Mask */ + +#define GPIO_INTEN_FLIEN0_Pos (0) /*!< GPIO_T::INTEN: FLIEN0 Position */ +#define GPIO_INTEN_FLIEN0_Msk (0x1ul << GPIO_INTEN_FLIEN0_Pos) /*!< GPIO_T::INTEN: FLIEN0 Mask */ + +#define GPIO_INTEN_FLIEN1_Pos (1) /*!< GPIO_T::INTEN: FLIEN1 Position */ +#define GPIO_INTEN_FLIEN1_Msk (0x1ul << GPIO_INTEN_FLIEN1_Pos) /*!< GPIO_T::INTEN: FLIEN1 Mask */ + +#define GPIO_INTEN_FLIEN2_Pos (2) /*!< GPIO_T::INTEN: FLIEN2 Position */ +#define GPIO_INTEN_FLIEN2_Msk (0x1ul << GPIO_INTEN_FLIEN2_Pos) /*!< GPIO_T::INTEN: FLIEN2 Mask */ + +#define GPIO_INTEN_FLIEN3_Pos (3) /*!< GPIO_T::INTEN: FLIEN3 Position */ +#define GPIO_INTEN_FLIEN3_Msk (0x1ul << GPIO_INTEN_FLIEN3_Pos) /*!< GPIO_T::INTEN: FLIEN3 Mask */ + +#define GPIO_INTEN_FLIEN4_Pos (4) /*!< GPIO_T::INTEN: FLIEN4 Position */ +#define GPIO_INTEN_FLIEN4_Msk (0x1ul << GPIO_INTEN_FLIEN4_Pos) /*!< GPIO_T::INTEN: FLIEN4 Mask */ + +#define GPIO_INTEN_FLIEN5_Pos (5) /*!< GPIO_T::INTEN: FLIEN5 Position */ +#define GPIO_INTEN_FLIEN5_Msk (0x1ul << GPIO_INTEN_FLIEN5_Pos) /*!< GPIO_T::INTEN: FLIEN5 Mask */ + +#define GPIO_INTEN_FLIEN6_Pos (6) /*!< GPIO_T::INTEN: FLIEN6 Position */ +#define GPIO_INTEN_FLIEN6_Msk (0x1ul << GPIO_INTEN_FLIEN6_Pos) /*!< GPIO_T::INTEN: FLIEN6 Mask */ + +#define GPIO_INTEN_FLIEN7_Pos (7) /*!< GPIO_T::INTEN: FLIEN7 Position */ +#define GPIO_INTEN_FLIEN7_Msk (0x1ul << GPIO_INTEN_FLIEN7_Pos) /*!< GPIO_T::INTEN: FLIEN7 Mask */ + +#define GPIO_INTEN_FLIEN8_Pos (8) /*!< GPIO_T::INTEN: FLIEN8 Position */ +#define GPIO_INTEN_FLIEN8_Msk (0x1ul << GPIO_INTEN_FLIEN8_Pos) /*!< GPIO_T::INTEN: FLIEN8 Mask */ + +#define GPIO_INTEN_FLIEN9_Pos (9) /*!< GPIO_T::INTEN: FLIEN9 Position */ +#define GPIO_INTEN_FLIEN9_Msk (0x1ul << GPIO_INTEN_FLIEN9_Pos) /*!< GPIO_T::INTEN: FLIEN9 Mask */ + +#define GPIO_INTEN_FLIEN10_Pos (10) /*!< GPIO_T::INTEN: FLIEN10 Position */ +#define GPIO_INTEN_FLIEN10_Msk (0x1ul << GPIO_INTEN_FLIEN10_Pos) /*!< GPIO_T::INTEN: FLIEN10 Mask */ + +#define GPIO_INTEN_FLIEN11_Pos (11) /*!< GPIO_T::INTEN: FLIEN11 Position */ +#define GPIO_INTEN_FLIEN11_Msk (0x1ul << GPIO_INTEN_FLIEN11_Pos) /*!< GPIO_T::INTEN: FLIEN11 Mask */ + +#define GPIO_INTEN_FLIEN12_Pos (12) /*!< GPIO_T::INTEN: FLIEN12 Position */ +#define GPIO_INTEN_FLIEN12_Msk (0x1ul << GPIO_INTEN_FLIEN12_Pos) /*!< GPIO_T::INTEN: FLIEN12 Mask */ + +#define GPIO_INTEN_FLIEN13_Pos (13) /*!< GPIO_T::INTEN: FLIEN13 Position */ +#define GPIO_INTEN_FLIEN13_Msk (0x1ul << GPIO_INTEN_FLIEN13_Pos) /*!< GPIO_T::INTEN: FLIEN13 Mask */ + +#define GPIO_INTEN_FLIEN14_Pos (14) /*!< GPIO_T::INTEN: FLIEN14 Position */ +#define GPIO_INTEN_FLIEN14_Msk (0x1ul << GPIO_INTEN_FLIEN14_Pos) /*!< GPIO_T::INTEN: FLIEN14 Mask */ + +#define GPIO_INTEN_FLIEN15_Pos (15) /*!< GPIO_T::INTEN: FLIEN15 Position */ +#define GPIO_INTEN_FLIEN15_Msk (0x1ul << GPIO_INTEN_FLIEN15_Pos) /*!< GPIO_T::INTEN: FLIEN15 Mask */ + +#define GPIO_INTEN_RHIEN0_Pos (16) /*!< GPIO_T::INTEN: RHIEN0 Position */ +#define GPIO_INTEN_RHIEN0_Msk (0x1ul << GPIO_INTEN_RHIEN0_Pos) /*!< GPIO_T::INTEN: RHIEN0 Mask */ + +#define GPIO_INTEN_RHIEN1_Pos (17) /*!< GPIO_T::INTEN: RHIEN1 Position */ +#define GPIO_INTEN_RHIEN1_Msk (0x1ul << GPIO_INTEN_RHIEN1_Pos) /*!< GPIO_T::INTEN: RHIEN1 Mask */ + +#define GPIO_INTEN_RHIEN2_Pos (18) /*!< GPIO_T::INTEN: RHIEN2 Position */ +#define GPIO_INTEN_RHIEN2_Msk (0x1ul << GPIO_INTEN_RHIEN2_Pos) /*!< GPIO_T::INTEN: RHIEN2 Mask */ + +#define GPIO_INTEN_RHIEN3_Pos (19) /*!< GPIO_T::INTEN: RHIEN3 Position */ +#define GPIO_INTEN_RHIEN3_Msk (0x1ul << GPIO_INTEN_RHIEN3_Pos) /*!< GPIO_T::INTEN: RHIEN3 Mask */ + +#define GPIO_INTEN_RHIEN4_Pos (20) /*!< GPIO_T::INTEN: RHIEN4 Position */ +#define GPIO_INTEN_RHIEN4_Msk (0x1ul << GPIO_INTEN_RHIEN4_Pos) /*!< GPIO_T::INTEN: RHIEN4 Mask */ + +#define GPIO_INTEN_RHIEN5_Pos (21) /*!< GPIO_T::INTEN: RHIEN5 Position */ +#define GPIO_INTEN_RHIEN5_Msk (0x1ul << GPIO_INTEN_RHIEN5_Pos) /*!< GPIO_T::INTEN: RHIEN5 Mask */ + +#define GPIO_INTEN_RHIEN6_Pos (22) /*!< GPIO_T::INTEN: RHIEN6 Position */ +#define GPIO_INTEN_RHIEN6_Msk (0x1ul << GPIO_INTEN_RHIEN6_Pos) /*!< GPIO_T::INTEN: RHIEN6 Mask */ + +#define GPIO_INTEN_RHIEN7_Pos (23) /*!< GPIO_T::INTEN: RHIEN7 Position */ +#define GPIO_INTEN_RHIEN7_Msk (0x1ul << GPIO_INTEN_RHIEN7_Pos) /*!< GPIO_T::INTEN: RHIEN7 Mask */ + +#define GPIO_INTEN_RHIEN8_Pos (24) /*!< GPIO_T::INTEN: RHIEN8 Position */ +#define GPIO_INTEN_RHIEN8_Msk (0x1ul << GPIO_INTEN_RHIEN8_Pos) /*!< GPIO_T::INTEN: RHIEN8 Mask */ + +#define GPIO_INTEN_RHIEN9_Pos (25) /*!< GPIO_T::INTEN: RHIEN9 Position */ +#define GPIO_INTEN_RHIEN9_Msk (0x1ul << GPIO_INTEN_RHIEN9_Pos) /*!< GPIO_T::INTEN: RHIEN9 Mask */ + +#define GPIO_INTEN_RHIEN10_Pos (26) /*!< GPIO_T::INTEN: RHIEN10 Position */ +#define GPIO_INTEN_RHIEN10_Msk (0x1ul << GPIO_INTEN_RHIEN10_Pos) /*!< GPIO_T::INTEN: RHIEN10 Mask */ + +#define GPIO_INTEN_RHIEN11_Pos (27) /*!< GPIO_T::INTEN: RHIEN11 Position */ +#define GPIO_INTEN_RHIEN11_Msk (0x1ul << GPIO_INTEN_RHIEN11_Pos) /*!< GPIO_T::INTEN: RHIEN11 Mask */ + +#define GPIO_INTEN_RHIEN12_Pos (28) /*!< GPIO_T::INTEN: RHIEN12 Position */ +#define GPIO_INTEN_RHIEN12_Msk (0x1ul << GPIO_INTEN_RHIEN12_Pos) /*!< GPIO_T::INTEN: RHIEN12 Mask */ + +#define GPIO_INTEN_RHIEN13_Pos (29) /*!< GPIO_T::INTEN: RHIEN13 Position */ +#define GPIO_INTEN_RHIEN13_Msk (0x1ul << GPIO_INTEN_RHIEN13_Pos) /*!< GPIO_T::INTEN: RHIEN13 Mask */ + +#define GPIO_INTEN_RHIEN14_Pos (30) /*!< GPIO_T::INTEN: RHIEN14 Position */ +#define GPIO_INTEN_RHIEN14_Msk (0x1ul << GPIO_INTEN_RHIEN14_Pos) /*!< GPIO_T::INTEN: RHIEN14 Mask */ + +#define GPIO_INTEN_RHIEN15_Pos (31) /*!< GPIO_T::INTEN: RHIEN15 Position */ +#define GPIO_INTEN_RHIEN15_Msk (0x1ul << GPIO_INTEN_RHIEN15_Pos) /*!< GPIO_T::INTEN: RHIEN15 Mask */ + +#define GPIO_INTSRC_INTSRC0_Pos (0) /*!< GPIO_T::INTSRC: INTSRC0 Position */ +#define GPIO_INTSRC_INTSRC0_Msk (0x1ul << GPIO_INTSRC_INTSRC0_Pos) /*!< GPIO_T::INTSRC: INTSRC0 Mask */ + +#define GPIO_INTSRC_INTSRC1_Pos (1) /*!< GPIO_T::INTSRC: INTSRC1 Position */ +#define GPIO_INTSRC_INTSRC1_Msk (0x1ul << GPIO_INTSRC_INTSRC1_Pos) /*!< GPIO_T::INTSRC: INTSRC1 Mask */ + +#define GPIO_INTSRC_INTSRC2_Pos (2) /*!< GPIO_T::INTSRC: INTSRC2 Position */ +#define GPIO_INTSRC_INTSRC2_Msk (0x1ul << GPIO_INTSRC_INTSRC2_Pos) /*!< GPIO_T::INTSRC: INTSRC2 Mask */ + +#define GPIO_INTSRC_INTSRC3_Pos (3) /*!< GPIO_T::INTSRC: INTSRC3 Position */ +#define GPIO_INTSRC_INTSRC3_Msk (0x1ul << GPIO_INTSRC_INTSRC3_Pos) /*!< GPIO_T::INTSRC: INTSRC3 Mask */ + +#define GPIO_INTSRC_INTSRC4_Pos (4) /*!< GPIO_T::INTSRC: INTSRC4 Position */ +#define GPIO_INTSRC_INTSRC4_Msk (0x1ul << GPIO_INTSRC_INTSRC4_Pos) /*!< GPIO_T::INTSRC: INTSRC4 Mask */ + +#define GPIO_INTSRC_INTSRC5_Pos (5) /*!< GPIO_T::INTSRC: INTSRC5 Position */ +#define GPIO_INTSRC_INTSRC5_Msk (0x1ul << GPIO_INTSRC_INTSRC5_Pos) /*!< GPIO_T::INTSRC: INTSRC5 Mask */ + +#define GPIO_INTSRC_INTSRC6_Pos (6) /*!< GPIO_T::INTSRC: INTSRC6 Position */ +#define GPIO_INTSRC_INTSRC6_Msk (0x1ul << GPIO_INTSRC_INTSRC6_Pos) /*!< GPIO_T::INTSRC: INTSRC6 Mask */ + +#define GPIO_INTSRC_INTSRC7_Pos (7) /*!< GPIO_T::INTSRC: INTSRC7 Position */ +#define GPIO_INTSRC_INTSRC7_Msk (0x1ul << GPIO_INTSRC_INTSRC7_Pos) /*!< GPIO_T::INTSRC: INTSRC7 Mask */ + +#define GPIO_INTSRC_INTSRC8_Pos (8) /*!< GPIO_T::INTSRC: INTSRC8 Position */ +#define GPIO_INTSRC_INTSRC8_Msk (0x1ul << GPIO_INTSRC_INTSRC8_Pos) /*!< GPIO_T::INTSRC: INTSRC8 Mask */ + +#define GPIO_INTSRC_INTSRC9_Pos (9) /*!< GPIO_T::INTSRC: INTSRC9 Position */ +#define GPIO_INTSRC_INTSRC9_Msk (0x1ul << GPIO_INTSRC_INTSRC9_Pos) /*!< GPIO_T::INTSRC: INTSRC9 Mask */ + +#define GPIO_INTSRC_INTSRC10_Pos (10) /*!< GPIO_T::INTSRC: INTSRC10 Position */ +#define GPIO_INTSRC_INTSRC10_Msk (0x1ul << GPIO_INTSRC_INTSRC10_Pos) /*!< GPIO_T::INTSRC: INTSRC10 Mask */ + +#define GPIO_INTSRC_INTSRC11_Pos (11) /*!< GPIO_T::INTSRC: INTSRC11 Position */ +#define GPIO_INTSRC_INTSRC11_Msk (0x1ul << GPIO_INTSRC_INTSRC11_Pos) /*!< GPIO_T::INTSRC: INTSRC11 Mask */ + +#define GPIO_INTSRC_INTSRC12_Pos (12) /*!< GPIO_T::INTSRC: INTSRC12 Position */ +#define GPIO_INTSRC_INTSRC12_Msk (0x1ul << GPIO_INTSRC_INTSRC12_Pos) /*!< GPIO_T::INTSRC: INTSRC12 Mask */ + +#define GPIO_INTSRC_INTSRC13_Pos (13) /*!< GPIO_T::INTSRC: INTSRC13 Position */ +#define GPIO_INTSRC_INTSRC13_Msk (0x1ul << GPIO_INTSRC_INTSRC13_Pos) /*!< GPIO_T::INTSRC: INTSRC13 Mask */ + +#define GPIO_INTSRC_INTSRC14_Pos (14) /*!< GPIO_T::INTSRC: INTSRC14 Position */ +#define GPIO_INTSRC_INTSRC14_Msk (0x1ul << GPIO_INTSRC_INTSRC14_Pos) /*!< GPIO_T::INTSRC: INTSRC14 Mask */ + +#define GPIO_INTSRC_INTSRC15_Pos (15) /*!< GPIO_T::INTSRC: INTSRC15 Position */ +#define GPIO_INTSRC_INTSRC15_Msk (0x1ul << GPIO_INTSRC_INTSRC15_Pos) /*!< GPIO_T::INTSRC: INTSRC15 Mask */ + +#define GPIO_SMTEN_SMTEN0_Pos (0) /*!< GPIO_T::SMTEN: SMTEN0 Position */ +#define GPIO_SMTEN_SMTEN0_Msk (0x1ul << GPIO_SMTEN_SMTEN0_Pos) /*!< GPIO_T::SMTEN: SMTEN0 Mask */ + +#define GPIO_SMTEN_SMTEN1_Pos (1) /*!< GPIO_T::SMTEN: SMTEN1 Position */ +#define GPIO_SMTEN_SMTEN1_Msk (0x1ul << GPIO_SMTEN_SMTEN1_Pos) /*!< GPIO_T::SMTEN: SMTEN1 Mask */ + +#define GPIO_SMTEN_SMTEN2_Pos (2) /*!< GPIO_T::SMTEN: SMTEN2 Position */ +#define GPIO_SMTEN_SMTEN2_Msk (0x1ul << GPIO_SMTEN_SMTEN2_Pos) /*!< GPIO_T::SMTEN: SMTEN2 Mask */ + +#define GPIO_SMTEN_SMTEN3_Pos (3) /*!< GPIO_T::SMTEN: SMTEN3 Position */ +#define GPIO_SMTEN_SMTEN3_Msk (0x1ul << GPIO_SMTEN_SMTEN3_Pos) /*!< GPIO_T::SMTEN: SMTEN3 Mask */ + +#define GPIO_SMTEN_SMTEN4_Pos (4) /*!< GPIO_T::SMTEN: SMTEN4 Position */ +#define GPIO_SMTEN_SMTEN4_Msk (0x1ul << GPIO_SMTEN_SMTEN4_Pos) /*!< GPIO_T::SMTEN: SMTEN4 Mask */ + +#define GPIO_SMTEN_SMTEN5_Pos (5) /*!< GPIO_T::SMTEN: SMTEN5 Position */ +#define GPIO_SMTEN_SMTEN5_Msk (0x1ul << GPIO_SMTEN_SMTEN5_Pos) /*!< GPIO_T::SMTEN: SMTEN5 Mask */ + +#define GPIO_SMTEN_SMTEN6_Pos (6) /*!< GPIO_T::SMTEN: SMTEN6 Position */ +#define GPIO_SMTEN_SMTEN6_Msk (0x1ul << GPIO_SMTEN_SMTEN6_Pos) /*!< GPIO_T::SMTEN: SMTEN6 Mask */ + +#define GPIO_SMTEN_SMTEN7_Pos (7) /*!< GPIO_T::SMTEN: SMTEN7 Position */ +#define GPIO_SMTEN_SMTEN7_Msk (0x1ul << GPIO_SMTEN_SMTEN7_Pos) /*!< GPIO_T::SMTEN: SMTEN7 Mask */ + +#define GPIO_SMTEN_SMTEN8_Pos (8) /*!< GPIO_T::SMTEN: SMTEN8 Position */ +#define GPIO_SMTEN_SMTEN8_Msk (0x1ul << GPIO_SMTEN_SMTEN8_Pos) /*!< GPIO_T::SMTEN: SMTEN8 Mask */ + +#define GPIO_SMTEN_SMTEN9_Pos (9) /*!< GPIO_T::SMTEN: SMTEN9 Position */ +#define GPIO_SMTEN_SMTEN9_Msk (0x1ul << GPIO_SMTEN_SMTEN9_Pos) /*!< GPIO_T::SMTEN: SMTEN9 Mask */ + +#define GPIO_SMTEN_SMTEN10_Pos (10) /*!< GPIO_T::SMTEN: SMTEN10 Position */ +#define GPIO_SMTEN_SMTEN10_Msk (0x1ul << GPIO_SMTEN_SMTEN10_Pos) /*!< GPIO_T::SMTEN: SMTEN10 Mask */ + +#define GPIO_SMTEN_SMTEN11_Pos (11) /*!< GPIO_T::SMTEN: SMTEN11 Position */ +#define GPIO_SMTEN_SMTEN11_Msk (0x1ul << GPIO_SMTEN_SMTEN11_Pos) /*!< GPIO_T::SMTEN: SMTEN11 Mask */ + +#define GPIO_SMTEN_SMTEN12_Pos (12) /*!< GPIO_T::SMTEN: SMTEN12 Position */ +#define GPIO_SMTEN_SMTEN12_Msk (0x1ul << GPIO_SMTEN_SMTEN12_Pos) /*!< GPIO_T::SMTEN: SMTEN12 Mask */ + +#define GPIO_SMTEN_SMTEN13_Pos (13) /*!< GPIO_T::SMTEN: SMTEN13 Position */ +#define GPIO_SMTEN_SMTEN13_Msk (0x1ul << GPIO_SMTEN_SMTEN13_Pos) /*!< GPIO_T::SMTEN: SMTEN13 Mask */ + +#define GPIO_SMTEN_SMTEN14_Pos (14) /*!< GPIO_T::SMTEN: SMTEN14 Position */ +#define GPIO_SMTEN_SMTEN14_Msk (0x1ul << GPIO_SMTEN_SMTEN14_Pos) /*!< GPIO_T::SMTEN: SMTEN14 Mask */ + +#define GPIO_SMTEN_SMTEN15_Pos (15) /*!< GPIO_T::SMTEN: SMTEN15 Position */ +#define GPIO_SMTEN_SMTEN15_Msk (0x1ul << GPIO_SMTEN_SMTEN15_Pos) /*!< GPIO_T::SMTEN: SMTEN15 Mask */ + +#define GPIO_SLEWCTL_HSREN0_Pos (0) /*!< GPIO_T::SLEWCTL: HSREN0 Position */ +#define GPIO_SLEWCTL_HSREN0_Msk (0x3ul << GPIO_SLEWCTL_HSREN0_Pos) /*!< GPIO_T::SLEWCTL: HSREN0 Mask */ + +#define GPIO_SLEWCTL_HSREN1_Pos (2) /*!< GPIO_T::SLEWCTL: HSREN1 Position */ +#define GPIO_SLEWCTL_HSREN1_Msk (0x3ul << GPIO_SLEWCTL_HSREN1_Pos) /*!< GPIO_T::SLEWCTL: HSREN1 Mask */ + +#define GPIO_SLEWCTL_HSREN2_Pos (4) /*!< GPIO_T::SLEWCTL: HSREN2 Position */ +#define GPIO_SLEWCTL_HSREN2_Msk (0x3ul << GPIO_SLEWCTL_HSREN2_Pos) /*!< GPIO_T::SLEWCTL: HSREN2 Mask */ + +#define GPIO_SLEWCTL_HSREN3_Pos (6) /*!< GPIO_T::SLEWCTL: HSREN3 Position */ +#define GPIO_SLEWCTL_HSREN3_Msk (0x3ul << GPIO_SLEWCTL_HSREN3_Pos) /*!< GPIO_T::SLEWCTL: HSREN3 Mask */ + +#define GPIO_SLEWCTL_HSREN4_Pos (8) /*!< GPIO_T::SLEWCTL: HSREN4 Position */ +#define GPIO_SLEWCTL_HSREN4_Msk (0x3ul << GPIO_SLEWCTL_HSREN4_Pos) /*!< GPIO_T::SLEWCTL: HSREN4 Mask */ + +#define GPIO_SLEWCTL_HSREN5_Pos (10) /*!< GPIO_T::SLEWCTL: HSREN5 Position */ +#define GPIO_SLEWCTL_HSREN5_Msk (0x3ul << GPIO_SLEWCTL_HSREN5_Pos) /*!< GPIO_T::SLEWCTL: HSREN5 Mask */ + +#define GPIO_SLEWCTL_HSREN6_Pos (12) /*!< GPIO_T::SLEWCTL: HSREN6 Position */ +#define GPIO_SLEWCTL_HSREN6_Msk (0x3ul << GPIO_SLEWCTL_HSREN6_Pos) /*!< GPIO_T::SLEWCTL: HSREN6 Mask */ + +#define GPIO_SLEWCTL_HSREN7_Pos (14) /*!< GPIO_T::SLEWCTL: HSREN7 Position */ +#define GPIO_SLEWCTL_HSREN7_Msk (0x3ul << GPIO_SLEWCTL_HSREN7_Pos) /*!< GPIO_T::SLEWCTL: HSREN7 Mask */ + +#define GPIO_SLEWCTL_HSREN8_Pos (16) /*!< GPIO_T::SLEWCTL: HSREN8 Position */ +#define GPIO_SLEWCTL_HSREN8_Msk (0x3ul << GPIO_SLEWCTL_HSREN8_Pos) /*!< GPIO_T::SLEWCTL: HSREN8 Mask */ + +#define GPIO_SLEWCTL_HSREN9_Pos (18) /*!< GPIO_T::SLEWCTL: HSREN9 Position */ +#define GPIO_SLEWCTL_HSREN9_Msk (0x3ul << GPIO_SLEWCTL_HSREN9_Pos) /*!< GPIO_T::SLEWCTL: HSREN9 Mask */ + +#define GPIO_SLEWCTL_HSREN10_Pos (20) /*!< GPIO_T::SLEWCTL: HSREN10 Position */ +#define GPIO_SLEWCTL_HSREN10_Msk (0x3ul << GPIO_SLEWCTL_HSREN10_Pos) /*!< GPIO_T::SLEWCTL: HSREN10 Mask */ + +#define GPIO_SLEWCTL_HSREN11_Pos (22) /*!< GPIO_T::SLEWCTL: HSREN11 Position */ +#define GPIO_SLEWCTL_HSREN11_Msk (0x3ul << GPIO_SLEWCTL_HSREN11_Pos) /*!< GPIO_T::SLEWCTL: HSREN11 Mask */ + +#define GPIO_SLEWCTL_HSREN12_Pos (24) /*!< GPIO_T::SLEWCTL: HSREN12 Position */ +#define GPIO_SLEWCTL_HSREN12_Msk (0x3ul << GPIO_SLEWCTL_HSREN12_Pos) /*!< GPIO_T::SLEWCTL: HSREN12 Mask */ + +#define GPIO_SLEWCTL_HSREN13_Pos (26) /*!< GPIO_T::SLEWCTL: HSREN13 Position */ +#define GPIO_SLEWCTL_HSREN13_Msk (0x3ul << GPIO_SLEWCTL_HSREN13_Pos) /*!< GPIO_T::SLEWCTL: HSREN13 Mask */ + +#define GPIO_SLEWCTL_HSREN14_Pos (28) /*!< GPIO_T::SLEWCTL: HSREN14 Position */ +#define GPIO_SLEWCTL_HSREN14_Msk (0x3ul << GPIO_SLEWCTL_HSREN14_Pos) /*!< GPIO_T::SLEWCTL: HSREN14 Mask */ + +#define GPIO_SLEWCTL_HSREN15_Pos (30) /*!< GPIO_T::SLEWCTL: HSREN15 Position */ +#define GPIO_SLEWCTL_HSREN15_Msk (0x3ul << GPIO_SLEWCTL_HSREN15_Pos) /*!< GPIO_T::SLEWCTL: HSREN15 Mask */ + +#define GPIO_PUSEL_PUSEL0_Pos (0) /*!< GPIO_T::PUSEL: PUSEL0 Position */ +#define GPIO_PUSEL_PUSEL0_Msk (0x3ul << GPIO_PUSEL_PUSEL0_Pos) /*!< GPIO_T::PUSEL: PUSEL0 Mask */ + +#define GPIO_PUSEL_PUSEL1_Pos (2) /*!< GPIO_T::PUSEL: PUSEL1 Position */ +#define GPIO_PUSEL_PUSEL1_Msk (0x3ul << GPIO_PUSEL_PUSEL1_Pos) /*!< GPIO_T::PUSEL: PUSEL1 Mask */ + +#define GPIO_PUSEL_PUSEL2_Pos (4) /*!< GPIO_T::PUSEL: PUSEL2 Position */ +#define GPIO_PUSEL_PUSEL2_Msk (0x3ul << GPIO_PUSEL_PUSEL2_Pos) /*!< GPIO_T::PUSEL: PUSEL2 Mask */ + +#define GPIO_PUSEL_PUSEL3_Pos (6) /*!< GPIO_T::PUSEL: PUSEL3 Position */ +#define GPIO_PUSEL_PUSEL3_Msk (0x3ul << GPIO_PUSEL_PUSEL3_Pos) /*!< GPIO_T::PUSEL: PUSEL3 Mask */ + +#define GPIO_PUSEL_PUSEL4_Pos (8) /*!< GPIO_T::PUSEL: PUSEL4 Position */ +#define GPIO_PUSEL_PUSEL4_Msk (0x3ul << GPIO_PUSEL_PUSEL4_Pos) /*!< GPIO_T::PUSEL: PUSEL4 Mask */ + +#define GPIO_PUSEL_PUSEL5_Pos (10) /*!< GPIO_T::PUSEL: PUSEL5 Position */ +#define GPIO_PUSEL_PUSEL5_Msk (0x3ul << GPIO_PUSEL_PUSEL5_Pos) /*!< GPIO_T::PUSEL: PUSEL5 Mask */ + +#define GPIO_PUSEL_PUSEL6_Pos (12) /*!< GPIO_T::PUSEL: PUSEL6 Position */ +#define GPIO_PUSEL_PUSEL6_Msk (0x3ul << GPIO_PUSEL_PUSEL6_Pos) /*!< GPIO_T::PUSEL: PUSEL6 Mask */ + +#define GPIO_PUSEL_PUSEL7_Pos (14) /*!< GPIO_T::PUSEL: PUSEL7 Position */ +#define GPIO_PUSEL_PUSEL7_Msk (0x3ul << GPIO_PUSEL_PUSEL7_Pos) /*!< GPIO_T::PUSEL: PUSEL7 Mask */ + +#define GPIO_PUSEL_PUSEL8_Pos (16) /*!< GPIO_T::PUSEL: PUSEL8 Position */ +#define GPIO_PUSEL_PUSEL8_Msk (0x3ul << GPIO_PUSEL_PUSEL8_Pos) /*!< GPIO_T::PUSEL: PUSEL8 Mask */ + +#define GPIO_PUSEL_PUSEL9_Pos (18) /*!< GPIO_T::PUSEL: PUSEL9 Position */ +#define GPIO_PUSEL_PUSEL9_Msk (0x3ul << GPIO_PUSEL_PUSEL9_Pos) /*!< GPIO_T::PUSEL: PUSEL9 Mask */ + +#define GPIO_PUSEL_PUSEL10_Pos (20) /*!< GPIO_T::PUSEL: PUSEL10 Position */ +#define GPIO_PUSEL_PUSEL10_Msk (0x3ul << GPIO_PUSEL_PUSEL10_Pos) /*!< GPIO_T::PUSEL: PUSEL10 Mask */ + +#define GPIO_PUSEL_PUSEL11_Pos (22) /*!< GPIO_T::PUSEL: PUSEL11 Position */ +#define GPIO_PUSEL_PUSEL11_Msk (0x3ul << GPIO_PUSEL_PUSEL11_Pos) /*!< GPIO_T::PUSEL: PUSEL11 Mask */ + +#define GPIO_PUSEL_PUSEL12_Pos (24) /*!< GPIO_T::PUSEL: PUSEL12 Position */ +#define GPIO_PUSEL_PUSEL12_Msk (0x3ul << GPIO_PUSEL_PUSEL12_Pos) /*!< GPIO_T::PUSEL: PUSEL12 Mask */ + +#define GPIO_PUSEL_PUSEL13_Pos (26) /*!< GPIO_T::PUSEL: PUSEL13 Position */ +#define GPIO_PUSEL_PUSEL13_Msk (0x3ul << GPIO_PUSEL_PUSEL13_Pos) /*!< GPIO_T::PUSEL: PUSEL13 Mask */ + +#define GPIO_PUSEL_PUSEL14_Pos (28) /*!< GPIO_T::PUSEL: PUSEL14 Position */ +#define GPIO_PUSEL_PUSEL14_Msk (0x3ul << GPIO_PUSEL_PUSEL14_Pos) /*!< GPIO_T::PUSEL: PUSEL14 Mask */ + +#define GPIO_PUSEL_PUSEL15_Pos (30) /*!< GPIO_T::PUSEL: PUSEL15 Position */ +#define GPIO_PUSEL_PUSEL15_Msk (0x3ul << GPIO_PUSEL_PUSEL15_Pos) /*!< GPIO_T::PUSEL: PUSEL15 Mask */ + +#define GPIO_DBCTL_DBCLKSEL_Pos (0) /*!< GPIO_T::DBCTL: DBCLKSEL Position */ +#define GPIO_DBCTL_DBCLKSEL_Msk (0xFul << GPIO_DBCTL_DBCLKSEL_Pos) /*!< GPIO_T::DBCTL: DBCLKSEL Mask */ + +#define GPIO_DBCTL_DBCLKSRC_Pos (4) /*!< GPIO_T::DBCTL: DBCLKSRC Position */ +#define GPIO_DBCTL_DBCLKSRC_Msk (1ul << GPIO_DBCTL_DBCLKSRC_Pos) /*!< GPIO_T::DBCTL: DBCLKSRC Mask */ + +#define GPIO_DBCTL_ICLKON_Pos (5) /*!< GPIO_T::DBCTL: ICLKON Position */ +#define GPIO_DBCTL_ICLKON_Msk (1ul << GPIO_DBCTL_ICLKON_Pos) /*!< GPIO_T::DBCTL: ICLKON Mask */ + +/**@}*/ /* GPIO_CONST */ +/**@}*/ /* end of GPIO register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __GPIO_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/hsotg_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/hsotg_reg.h new file mode 100644 index 00000000000..52c6a434155 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/hsotg_reg.h @@ -0,0 +1,398 @@ +/**************************************************************************//** + * @file hsotg_reg.h + * @version V1.00 + * @brief HSOTG register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __HSOTG_REG_H__ +#define __HSOTG_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup HSOTG High Speed USB On-The-Go Controller(HSOTG) + Memory Mapped Structure for HSOTG Controller +@{ */ + +typedef struct +{ + + + /** + * @var HSOTG_T::CTL + * Offset: 0x00 HSOTG Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |VBUSDROP |Drop VBUS Control + * | | |If user application running on this OTG A-device wants to conserve power, set this bit to drop VBUS + * | | |BUSREQ (OTG_CTL[1]) will be also cleared no matter A-device or B-device. + * | | |0 = Not drop the VBUS. + * | | |1 = Drop the VBUS. + * |[1] |BUSREQ |OTG Bus Request + * | | |If OTG A-device wants to do data transfers via USB bus, setting this bit will drive VBUS high to detect USB device connection + * | | |If user won't use the bus any more, clearing this bit will drop VBUS to save power + * | | |This bit will be cleared when A-device goes to A_wait_vfall state + * | | |This bit will be also cleared if VBUSDROP (OTG_CTL[0]) bit is set or IDSTS (OTG_STATUS[1]) changed. + * | | |If user of an OTG-B Device wants to request VBUS, setting this bit will run SRP protocol + * | | |This bit will be cleared if SRP failure (OTG A-device does not provide VBUS after B-device issues ARP in specified interval, defined in OTG specification) + * | | |This bit will be also cleared if VBUSDROP (OTG_CTL[0]) bit is set IDSTS (OTG_STATUS[1]) changed. + * | | |0 = Not launch VBUS in OTG A-device or not request SRP in OTG B-device. + * | | |1 = Launch VBUS in OTG A-device or request SRP in OTG B-device. + * |[2] |HNPREQEN |OTG HNP Request Enable Bit + * | | |When USB frame as A-device, set this bit when A-device allows to process HNP protocol -- A-device changes role from Host to Peripheral + * | | |This bit will be cleared when OTG state changes from a_suspend to a_peripheral or goes back to a_idle state + * | | |When USB frame as B-device, set this bit after the OTG A-device successfully sends a SetFeature (b_hnp_enable) command to the OTG B-device to start role change -- B-device changes role from Peripheral to Host + * | | |This bit will be cleared when OTG state changes from b_peripheral to b_wait_acon or goes back to b_idle state. + * | | |0 = HNP request Disabled. + * | | |1 = HNP request Enabled (A-device can change role from Host to Peripheral or B-device can change role from Peripheral to Host). + * | | |Note: Refer to OTG specification to get a_suspend, a_peripheral, a_idle and b_idle state. + * |[4] |OTGEN |OTG Function Enable Bit + * | | |User needs to set this bit to enable OTG function while USB frame configured as OTG device + * | | |When USB frame not configured as OTG device, this bit is must be low. + * | | |0= OTG function Disabled. + * | | |1 = OTG function Enabled. + * |[5] |WKEN |OTG ID Pin Wake-up Enable Bit + * | | |0 = OTG ID pin status change wake-up function Disabled. + * | | |1 = OTG ID pin status change wake-up function Enabled. + * @var HSOTG_T::PHYCTL + * Offset: 0x04 HSOTG PHY Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |OTGPHYEN |OTG PHY Enable + * | | |When USB frame is configured as OTG-device or ID-dependent, user needs to set this bit before using OTG function + * | | |If device is not configured as OTG-device nor ID-dependent, this bit is "don't care". + * | | |0 = OTG PHY Disabled. + * | | |1 = OTG PHY Enabled. + * |[1] |IDDETEN |ID Detection Enable Bit + * | | |0 = Detect ID pin status Disabled. + * | | |1 = Detect ID pin status Enabled. + * |[4] |VBENPOL |Off-chip USB VBUS Power Switch Enable Polarity + * | | |The OTG controller will enable off-chip USB VBUS power switch to provide VBUS power when need + * | | |A USB_VBUS_EN pin is used to control the off-chip USB VBUS power switch. + * | | |The polarity of enabling off-chip USB VBUS power switch (high active or low active) depends on the selected component + * | | |Set this bit as following according to the polarity of off-chip USB VBUS power switch. + * | | |0 = The off-chip USB VBUS power switch enable is active high. + * | | |1 = The off-chip USB VBUS power switch enable is active low. + * |[5] |VBSTSPOL |Off-chip USB VBUS Power Switch Status Polarity + * | | |The polarity of off-chip USB VBUS power switch valid signal depends on the selected component + * | | |A USB_VBUS_ST pin is used to monitor the valid signal of the off-chip USB VBUS power switch + * | | |Set this bit as following according to the polarity of off-chip USB VBUS power switch. + * | | |0 = The polarity of off-chip USB VBUS power switch valid status is high. + * | | |1 = The polarity of off-chip USB VBUS power switch valid status is low. + * @var HSOTG_T::INTEN + * Offset: 0x08 HSOTG Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ROLECHGIEN|Role (Host or Peripheral) Changed Interrupt Enable Bit + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * |[1] |VBEIEN |VBUS Error Interrupt Enable Bit + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * | | |Note: VBUS error means going to a_vbus_err state. Please refer to A-device state diagram in OTG spec. + * |[2] |SRPFIEN |SRP Fail Interrupt Enable Bit + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * |[3] |HNPFIEN |HNP Fail Interrupt Enable Bit + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * |[4] |GOIDLEIEN |OTG Device Goes to IDLE State Interrupt Enable Bit + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * | | |Note: Going to idle state means going to a_idle or b_idle state + * | | |Please refer to A-device state diagram and B-device state diagram in OTG spec. + * |[5] |IDCHGIEN |IDSTS Changed Interrupt Enable Bit + * | | |If this bit is set to 1 and IDSTS (OTG_STATUS[1]) status is changed from high to low or from low to high, a interrupt will be asserted. + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * |[6] |PDEVIEN |Act As Peripheral Interrupt Enable Bit + * | | |If this bit is set to 1 and the device is changed as a peripheral, a interrupt will be asserted. + * | | |0 = This device as a peripheral interrupt Disabled. + * | | |1 = This device as a peripheral interrupt Enabled. + * |[7] |HOSTIEN |Act As Host Interrupt Enable Bit + * | | |If this bit is set to 1 and the device is changed as a host, a interrupt will be asserted. + * | | |0 = This device as a host interrupt Disabled. + * | | |1 = This device as a host interrupt Enabled. + * |[8] |BVLDCHGIEN|B-device Session Valid Status Changed Interrupt Enable Bit + * | | |If this bit is set to 1 and BVLD (OTG_STATUS[3]) status is changed from high to low or from low to high, a interrupt will be asserted. + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * |[9] |AVLDCHGIEN|A-device Session Valid Status Changed Interrupt Enable Bit + * | | |If this bit is set to 1 and AVLD (OTG_STATUS[4]) status is changed from high to low or from low to high, a interrupt will be asserted. + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * |[10] |VBCHGIEN |VBUSVLD Status Changed Interrupt Enable Bit + * | | |If this bit is set to 1 and VBUSVLD (OTG_STATUS[5]) status is changed from high to low or from low to high, a interrupt will be asserted. + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * |[11] |SECHGIEN |SESSEND Status Changed Interrupt Enable Bit + * | | |If this bit is set to 1 and SESSEND (OTG_STATUS[2]) status is changed from high to low or from low to high, a interrupt will be asserted. + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * |[13] |SRPDETIEN |SRP Detected Interrupt Enable Bit + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * @var HSOTG_T::INTSTS + * Offset: 0x0C HSOTG Interrupt Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ROLECHGIF |OTG Role Change Interrupt Status + * | | |This flag is set when the role of an OTG device changed from a host to a peripheral, or changed from a peripheral to a host while USB_ID pin status does not change. + * | | |0 = OTG device role not changed. + * | | |1 = OTG device role changed. + * | | |Note: Write 1 to clear this flag. + * |[1] |VBEIF |VBUS Error Interrupt Status + * | | |This bit will be set when voltage on VBUS cannot reach a minimum valid threshold 4.4V within a maximum time of 100ms after OTG A-device starting to drive VBUS high. + * | | |0 = OTG A-device drives VBUS over threshold voltage before this interval expires. + * | | |1 = OTG A-device cannot drive VBUS over threshold voltage before this interval expires. + * | | |Note: Write 1 to clear this flag and recover from the VBUS error state. + * |[2] |SRPFIF |SRP Fail Interrupt Status + * | | |After initiating SRP, an OTG B-device will wait for the OTG A-device to drive VBUS high at least TB_SRP_FAIL minimum, defined in OTG specification + * | | |This flag is set when the OTG B-device does not get VBUS high after this interval. + * | | |0 = OTG B-device gets VBUS high before this interval. + * | | |1 = OTG B-device does not get VBUS high before this interval. + * | | |Note: Write 1 to clear this flag. + * |[3] |HNPFIF |HNP Fail Interrupt Status + * | | |When A-device has granted B-device to be host and USB bus is in SE0 (both USB_D+ and USB_D- low) state, this bit will be set when A-device does not connect after specified interval expires. + * | | |0 = A-device connects to B-device before specified interval expires. + * | | |1 = A-device does not connect to B-device before specified interval expires. + * | | |Note: Write 1 to clear this flag. + * |[4] |GOIDLEIF |OTG Device Goes to IDLE Interrupt Status + * | | |Flag is set if the OTG device transfers from non-idle state to idle state + * | | |The OTG device will be neither a host nor a peripheral. + * | | |0 = OTG device does not go back to idle state (a_idle or b_idle). + * | | |1 = OTG device goes back to idle state(a_idle or b_idle). + * | | |Note 1: Going to idle state means going to a_idle or b_idle state. Please refer to OTG specification. + * | | |Note 2: Write 1 to clear this flag. + * |[5] |IDCHGIF |ID State Change Interrupt Status + * | | |0 = IDSTS (OTG_STATUS[1]) not toggled. + * | | |1 = IDSTS (OTG_STATUS[1]) from high to low or from low to high. + * | | |Note: Write 1 to clear this flag. + * |[6] |PDEVIF |Act As Peripheral Interrupt Status + * | | |0= This device does not act as a peripheral. + * | | |1 = This device acts as a peripheral. + * | | |Note: Write 1 to clear this flag. + * |[7] |HOSTIF |Act As Host Interrupt Status + * | | |0= This device does not act as a host. + * | | |1 = This device acts as a host. + * | | |Note: Write 1 to clear this flag. + * |[8] |BVLDCHGIF |B-device Session Valid State Change Interrupt Status + * | | |0 = BVLD (OTG_STATUS[3]) is not toggled. + * | | |1 = BVLD (OTG_STATUS[3]) from high to low or low to high. + * | | |Note: Write 1 to clear this status. + * |[9] |AVLDCHGIF |A-device Session Valid State Change Interrupt Status + * | | |0 = AVLD (OTG_STATUS[4]) not toggled. + * | | |1 = AVLD (OTG_STATUS[4]) from high to low or low to high. + * | | |Note: Write 1 to clear this status. + * |[10] |VBCHGIF |VBUSVLD State Change Interrupt Status + * | | |0 = VBUSVLD (OTG_STATUS[5]) not toggled. + * | | |1 = VBUSVLD (OTG_STATUS[5]) from high to low or from low to high. + * | | |Note: Write 1 to clear this status. + * |[11] |SECHGIF |SESSEND State Change Interrupt Status + * | | |0 = SESSEND (OTG_STATUS[2]) not toggled. + * | | |1 = SESSEND (OTG_STATUS[2]) from high to low or from low to high. + * | | |Note: Write 1 to clear this flag. + * |[13] |SRPDETIF |SRP Detected Interrupt Status + * | | |0 = SRP not detected. + * | | |1 = SRP detected. + * | | |Note: Write 1 to clear this status. + * @var HSOTG_T::STATUS + * Offset: 0x10 HSOTG Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |OVERCUR |over Current Condition + * | | |The voltage on VBUS cannot reach a minimum VBUS valid threshold, 4.4V minimum, within a maximum time of 100ms after OTG A-device drives VBUS high. + * | | |0 = OTG A-device drives VBUS successfully. + * | | |1 = OTG A-device cannot drives VBUS high in this interval. + * |[1] |IDSTS |USB_ID Pin State of Mini-b/Micro-plug + * | | |0 = Mini-A/Micro-A plug is attached. + * | | |1 = Mini-B/Micro-B plug is attached. + * |[2] |SESSEND |Session End Status + * | | |When VBUS voltage is lower than 0.4V, this bit will be set to 1 + * | | |Session end means no meaningful power on VBUS. + * | | |0 = Session is not end. + * | | |1 = Session is end. + * |[3] |BVLD |B-device Session Valid Status + * | | |0 = B-device session is not valid. + * | | |1 = B-device session is valid. + * |[4] |AVLD |A-device Session Valid Status + * | | |0 = A-device session is not valid. + * | | |1 = A-device session is valid. + * |[5] |VBUSVLD |VBUS Valid Status + * | | |When VBUS is larger than 4.7V and A-device drives VBUS , this bit will be set to 1. + * | | |0 = VBUS is not valid. + * | | |1 = VBUS is valid. + * |[6] |ASPERI |As Peripheral Status + * | | |When OTG as peripheral, this bit is set. + * | | |0: OTG not as peripheral + * | | |1: OTG as peripheral + * |[7] |ASHOST |As Host Status + * | | |When OTG as Host, this bit is set. + * | | |0: OTG not as Host + * | | |1: OTG as Host + */ + __IO uint32_t CTL; /*!< [0x0000] HSOTG Control Register */ + __IO uint32_t PHYCTL; /*!< [0x0004] HSOTG PHY Control Register */ + __IO uint32_t INTEN; /*!< [0x0008] HSOTG Interrupt Enable Register */ + __IO uint32_t INTSTS; /*!< [0x000c] HSOTG Interrupt Status Register */ + __I uint32_t STATUS; /*!< [0x0010] HSOTG Status Register */ + +} HSOTG_T; + +/** + @addtogroup HSOTG_CONST HSOTG Bit Field Definition + Constant Definitions for HSOTG Controller +@{ */ + +#define HSOTG_CTL_VBUSDROP_Pos (0) /*!< HSOTG_T::CTL: VBUSDROP Position */ +#define HSOTG_CTL_VBUSDROP_Msk (0x1ul << HSOTG_CTL_VBUSDROP_Pos) /*!< HSOTG_T::CTL: VBUSDROP Mask */ + +#define HSOTG_CTL_BUSREQ_Pos (1) /*!< HSOTG_T::CTL: BUSREQ Position */ +#define HSOTG_CTL_BUSREQ_Msk (0x1ul << HSOTG_CTL_BUSREQ_Pos) /*!< HSOTG_T::CTL: BUSREQ Mask */ + +#define HSOTG_CTL_HNPREQEN_Pos (2) /*!< HSOTG_T::CTL: HNPREQEN Position */ +#define HSOTG_CTL_HNPREQEN_Msk (0x1ul << HSOTG_CTL_HNPREQEN_Pos) /*!< HSOTG_T::CTL: HNPREQEN Mask */ + +#define HSOTG_CTL_OTGEN_Pos (4) /*!< HSOTG_T::CTL: OTGEN Position */ +#define HSOTG_CTL_OTGEN_Msk (0x1ul << HSOTG_CTL_OTGEN_Pos) /*!< HSOTG_T::CTL: OTGEN Mask */ + +#define HSOTG_CTL_WKEN_Pos (5) /*!< HSOTG_T::CTL: WKEN Position */ +#define HSOTG_CTL_WKEN_Msk (0x1ul << HSOTG_CTL_WKEN_Pos) /*!< HSOTG_T::CTL: WKEN Mask */ + +#define HSOTG_PHYCTL_OTGPHYEN_Pos (0) /*!< HSOTG_T::PHYCTL: OTGPHYEN Position */ +#define HSOTG_PHYCTL_OTGPHYEN_Msk (0x1ul << HSOTG_PHYCTL_OTGPHYEN_Pos) /*!< HSOTG_T::PHYCTL: OTGPHYEN Mask */ + +#define HSOTG_PHYCTL_IDDETEN_Pos (1) /*!< HSOTG_T::PHYCTL: IDDETEN Position */ +#define HSOTG_PHYCTL_IDDETEN_Msk (0x1ul << HSOTG_PHYCTL_IDDETEN_Pos) /*!< HSOTG_T::PHYCTL: IDDETEN Mask */ + +#define HSOTG_PHYCTL_VBENPOL_Pos (4) /*!< HSOTG_T::PHYCTL: VBENPOL Position */ +#define HSOTG_PHYCTL_VBENPOL_Msk (0x1ul << HSOTG_PHYCTL_VBENPOL_Pos) /*!< HSOTG_T::PHYCTL: VBENPOL Mask */ + +#define HSOTG_PHYCTL_VBSTSPOL_Pos (5) /*!< HSOTG_T::PHYCTL: VBSTSPOL Position */ +#define HSOTG_PHYCTL_VBSTSPOL_Msk (0x1ul << HSOTG_PHYCTL_VBSTSPOL_Pos) /*!< HSOTG_T::PHYCTL: VBSTSPOL Mask */ + +#define HSOTG_INTEN_ROLECHGIEN_Pos (0) /*!< HSOTG_T::INTEN: ROLECHGIEN Position */ +#define HSOTG_INTEN_ROLECHGIEN_Msk (0x1ul << HSOTG_INTEN_ROLECHGIEN_Pos) /*!< HSOTG_T::INTEN: ROLECHGIEN Mask */ + +#define HSOTG_INTEN_VBEIEN_Pos (1) /*!< HSOTG_T::INTEN: VBEIEN Position */ +#define HSOTG_INTEN_VBEIEN_Msk (0x1ul << HSOTG_INTEN_VBEIEN_Pos) /*!< HSOTG_T::INTEN: VBEIEN Mask */ + +#define HSOTG_INTEN_SRPFIEN_Pos (2) /*!< HSOTG_T::INTEN: SRPFIEN Position */ +#define HSOTG_INTEN_SRPFIEN_Msk (0x1ul << HSOTG_INTEN_SRPFIEN_Pos) /*!< HSOTG_T::INTEN: SRPFIEN Mask */ + +#define HSOTG_INTEN_HNPFIEN_Pos (3) /*!< HSOTG_T::INTEN: HNPFIEN Position */ +#define HSOTG_INTEN_HNPFIEN_Msk (0x1ul << HSOTG_INTEN_HNPFIEN_Pos) /*!< HSOTG_T::INTEN: HNPFIEN Mask */ + +#define HSOTG_INTEN_GOIDLEIEN_Pos (4) /*!< HSOTG_T::INTEN: GOIDLEIEN Position */ +#define HSOTG_INTEN_GOIDLEIEN_Msk (0x1ul << HSOTG_INTEN_GOIDLEIEN_Pos) /*!< HSOTG_T::INTEN: GOIDLEIEN Mask */ + +#define HSOTG_INTEN_IDCHGIEN_Pos (5) /*!< HSOTG_T::INTEN: IDCHGIEN Position */ +#define HSOTG_INTEN_IDCHGIEN_Msk (0x1ul << HSOTG_INTEN_IDCHGIEN_Pos) /*!< HSOTG_T::INTEN: IDCHGIEN Mask */ + +#define HSOTG_INTEN_PDEVIEN_Pos (6) /*!< HSOTG_T::INTEN: PDEVIEN Position */ +#define HSOTG_INTEN_PDEVIEN_Msk (0x1ul << HSOTG_INTEN_PDEVIEN_Pos) /*!< HSOTG_T::INTEN: PDEVIEN Mask */ + +#define HSOTG_INTEN_HOSTIEN_Pos (7) /*!< HSOTG_T::INTEN: HOSTIEN Position */ +#define HSOTG_INTEN_HOSTIEN_Msk (0x1ul << HSOTG_INTEN_HOSTIEN_Pos) /*!< HSOTG_T::INTEN: HOSTIEN Mask */ + +#define HSOTG_INTEN_BVLDCHGIEN_Pos (8) /*!< HSOTG_T::INTEN: BVLDCHGIEN Position */ +#define HSOTG_INTEN_BVLDCHGIEN_Msk (0x1ul << HSOTG_INTEN_BVLDCHGIEN_Pos) /*!< HSOTG_T::INTEN: BVLDCHGIEN Mask */ + +#define HSOTG_INTEN_AVLDCHGIEN_Pos (9) /*!< HSOTG_T::INTEN: AVLDCHGIEN Position */ +#define HSOTG_INTEN_AVLDCHGIEN_Msk (0x1ul << HSOTG_INTEN_AVLDCHGIEN_Pos) /*!< HSOTG_T::INTEN: AVLDCHGIEN Mask */ + +#define HSOTG_INTEN_VBCHGIEN_Pos (10) /*!< HSOTG_T::INTEN: VBCHGIEN Position */ +#define HSOTG_INTEN_VBCHGIEN_Msk (0x1ul << HSOTG_INTEN_VBCHGIEN_Pos) /*!< HSOTG_T::INTEN: VBCHGIEN Mask */ + +#define HSOTG_INTEN_SECHGIEN_Pos (11) /*!< HSOTG_T::INTEN: SECHGIEN Position */ +#define HSOTG_INTEN_SECHGIEN_Msk (0x1ul << HSOTG_INTEN_SECHGIEN_Pos) /*!< HSOTG_T::INTEN: SECHGIEN Mask */ + +#define HSOTG_INTEN_SRPDETIEN_Pos (13) /*!< HSOTG_T::INTEN: SRPDETIEN Position */ +#define HSOTG_INTEN_SRPDETIEN_Msk (0x1ul << HSOTG_INTEN_SRPDETIEN_Pos) /*!< HSOTG_T::INTEN: SRPDETIEN Mask */ + +#define HSOTG_INTSTS_ROLECHGIF_Pos (0) /*!< HSOTG_T::INTSTS: ROLECHGIF Position */ +#define HSOTG_INTSTS_ROLECHGIF_Msk (0x1ul << HSOTG_INTSTS_ROLECHGIF_Pos) /*!< HSOTG_T::INTSTS: ROLECHGIF Mask */ + +#define HSOTG_INTSTS_VBEIF_Pos (1) /*!< HSOTG_T::INTSTS: VBEIF Position */ +#define HSOTG_INTSTS_VBEIF_Msk (0x1ul << HSOTG_INTSTS_VBEIF_Pos) /*!< HSOTG_T::INTSTS: VBEIF Mask */ + +#define HSOTG_INTSTS_SRPFIF_Pos (2) /*!< HSOTG_T::INTSTS: SRPFIF Position */ +#define HSOTG_INTSTS_SRPFIF_Msk (0x1ul << HSOTG_INTSTS_SRPFIF_Pos) /*!< HSOTG_T::INTSTS: SRPFIF Mask */ + +#define HSOTG_INTSTS_HNPFIF_Pos (3) /*!< HSOTG_T::INTSTS: HNPFIF Position */ +#define HSOTG_INTSTS_HNPFIF_Msk (0x1ul << HSOTG_INTSTS_HNPFIF_Pos) /*!< HSOTG_T::INTSTS: HNPFIF Mask */ + +#define HSOTG_INTSTS_GOIDLEIF_Pos (4) /*!< HSOTG_T::INTSTS: GOIDLEIF Position */ +#define HSOTG_INTSTS_GOIDLEIF_Msk (0x1ul << HSOTG_INTSTS_GOIDLEIF_Pos) /*!< HSOTG_T::INTSTS: GOIDLEIF Mask */ + +#define HSOTG_INTSTS_IDCHGIF_Pos (5) /*!< HSOTG_T::INTSTS: IDCHGIF Position */ +#define HSOTG_INTSTS_IDCHGIF_Msk (0x1ul << HSOTG_INTSTS_IDCHGIF_Pos) /*!< HSOTG_T::INTSTS: IDCHGIF Mask */ + +#define HSOTG_INTSTS_PDEVIF_Pos (6) /*!< HSOTG_T::INTSTS: PDEVIF Position */ +#define HSOTG_INTSTS_PDEVIF_Msk (0x1ul << HSOTG_INTSTS_PDEVIF_Pos) /*!< HSOTG_T::INTSTS: PDEVIF Mask */ + +#define HSOTG_INTSTS_HOSTIF_Pos (7) /*!< HSOTG_T::INTSTS: HOSTIF Position */ +#define HSOTG_INTSTS_HOSTIF_Msk (0x1ul << HSOTG_INTSTS_HOSTIF_Pos) /*!< HSOTG_T::INTSTS: HOSTIF Mask */ + +#define HSOTG_INTSTS_BVLDCHGIF_Pos (8) /*!< HSOTG_T::INTSTS: BVLDCHGIF Position */ +#define HSOTG_INTSTS_BVLDCHGIF_Msk (0x1ul << HSOTG_INTSTS_BVLDCHGIF_Pos) /*!< HSOTG_T::INTSTS: BVLDCHGIF Mask */ + +#define HSOTG_INTSTS_AVLDCHGIF_Pos (9) /*!< HSOTG_T::INTSTS: AVLDCHGIF Position */ +#define HSOTG_INTSTS_AVLDCHGIF_Msk (0x1ul << HSOTG_INTSTS_AVLDCHGIF_Pos) /*!< HSOTG_T::INTSTS: AVLDCHGIF Mask */ + +#define HSOTG_INTSTS_VBCHGIF_Pos (10) /*!< HSOTG_T::INTSTS: VBCHGIF Position */ +#define HSOTG_INTSTS_VBCHGIF_Msk (0x1ul << HSOTG_INTSTS_VBCHGIF_Pos) /*!< HSOTG_T::INTSTS: VBCHGIF Mask */ + +#define HSOTG_INTSTS_SECHGIF_Pos (11) /*!< HSOTG_T::INTSTS: SECHGIF Position */ +#define HSOTG_INTSTS_SECHGIF_Msk (0x1ul << HSOTG_INTSTS_SECHGIF_Pos) /*!< HSOTG_T::INTSTS: SECHGIF Mask */ + +#define HSOTG_INTSTS_SRPDETIF_Pos (13) /*!< HSOTG_T::INTSTS: SRPDETIF Position */ +#define HSOTG_INTSTS_SRPDETIF_Msk (0x1ul << HSOTG_INTSTS_SRPDETIF_Pos) /*!< HSOTG_T::INTSTS: SRPDETIF Mask */ + +#define HSOTG_STATUS_OVERCUR_Pos (0) /*!< HSOTG_T::STATUS: OVERCUR Position */ +#define HSOTG_STATUS_OVERCUR_Msk (0x1ul << HSOTG_STATUS_OVERCUR_Pos) /*!< HSOTG_T::STATUS: OVERCUR Mask */ + +#define HSOTG_STATUS_IDSTS_Pos (1) /*!< HSOTG_T::STATUS: IDSTS Position */ +#define HSOTG_STATUS_IDSTS_Msk (0x1ul << HSOTG_STATUS_IDSTS_Pos) /*!< HSOTG_T::STATUS: IDSTS Mask */ + +#define HSOTG_STATUS_SESSEND_Pos (2) /*!< HSOTG_T::STATUS: SESSEND Position */ +#define HSOTG_STATUS_SESSEND_Msk (0x1ul << HSOTG_STATUS_SESSEND_Pos) /*!< HSOTG_T::STATUS: SESSEND Mask */ + +#define HSOTG_STATUS_BVLD_Pos (3) /*!< HSOTG_T::STATUS: BVLD Position */ +#define HSOTG_STATUS_BVLD_Msk (0x1ul << HSOTG_STATUS_BVLD_Pos) /*!< HSOTG_T::STATUS: BVLD Mask */ + +#define HSOTG_STATUS_AVLD_Pos (4) /*!< HSOTG_T::STATUS: AVLD Position */ +#define HSOTG_STATUS_AVLD_Msk (0x1ul << HSOTG_STATUS_AVLD_Pos) /*!< HSOTG_T::STATUS: AVLD Mask */ + +#define HSOTG_STATUS_VBUSVLD_Pos (5) /*!< HSOTG_T::STATUS: VBUSVLD Position */ +#define HSOTG_STATUS_VBUSVLD_Msk (0x1ul << HSOTG_STATUS_VBUSVLD_Pos) /*!< HSOTG_T::STATUS: VBUSVLD Mask */ + +#define HSOTG_STATUS_ASPERI_Pos (6) /*!< HSOTG_T::STATUS: ASPERI Position */ +#define HSOTG_STATUS_ASPERI_Msk (0x1ul << HSOTG_STATUS_ASPERI_Pos) /*!< HSOTG_T::STATUS: ASPERI Mask */ + +#define HSOTG_STATUS_ASHOST_Pos (7) /*!< HSOTG_T::STATUS: ASHOST Position */ +#define HSOTG_STATUS_ASHOST_Msk (0x1ul << HSOTG_STATUS_ASHOST_Pos) /*!< HSOTG_T::STATUS: ASHOST Mask */ + +/**@}*/ /* HSOTG_CONST */ +/**@}*/ /* end of HSOTG register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __HSOTG_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/hsusbd_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/hsusbd_reg.h new file mode 100644 index 00000000000..7c301802397 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/hsusbd_reg.h @@ -0,0 +1,1381 @@ +/**************************************************************************//** + * @file hsusbd_reg.h + * @version V1.00 + * @brief HSUSBD register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __HSUSBD_REG_H__ +#define __HSUSBD_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup HSUSBD USB 2.0 Device Controller(HSUSBD) + Memory Mapped Structure for HSUSBD Controller +@{ */ + +typedef struct +{ + + /** + * @var HSUSBD_EP_T::EPDAT + * Offset: 0x00 Endpoint n Data Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |EPDAT |Endpoint A~L Data Register + * | | |Endpoint A~L data buffer for the buffer transaction (read or write). + * | | |Note: Only word access is supported. + * @var HSUSBD_EP_T::EPDAT_BYTE + * Offset: 0x00 Endpoint n Data Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |EPDAT |Endpoint A~L Data Register + * | | |Endpoint A~L data buffer for the buffer transaction (read or write). + * | | |Note: Only byte access is supported. + * @var HSUSBD_EP_T::EPINTSTS + * Offset: 0x04 Endpoint n Interrupt Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BUFFULLIF |Buffer Full + * | | |For an IN endpoint, the currently selected buffer is full, or no buffer is available to the local side for writing (no space to write) + * | | |For an OUT endpoint, there is a buffer available on the local side, and there are FIFO full of bytes available to be read (entire packet is available for reading). + * | | |0 = The endpoint packet buffer is not full. + * | | |1 = The endpoint packet buffer is full. + * | | |Note: This bit is read-only. + * |[1] |BUFEMPTYIF|Buffer Empty + * | | |For an IN endpoint, a buffer is available to the local side for writing up to FIFO full of bytes. + * | | |0 = The endpoint buffer is not empty. + * | | |1 = The endpoint buffer is empty. + * | | |For an OUT endpoint: + * | | |0 = The currently selected buffer has not a count of 0. + * | | |1 = The currently selected buffer has a count of 0, or no buffer is available on the local side (nothing to read). + * | | |Note: This bit is read-only. + * |[2] |SHORTTXIF |Short Packet Transferred Interrupt + * | | |0 = The length of the last packet was not less than the Maximum Packet Size (EPMPS). + * | | |1 = The length of the last packet was less than the Maximum Packet Size (EPMPS). + * | | |Note: Write 1 to clear this bit to 0. + * |[3] |TXPKIF |Data Packet Transmitted Interrupt + * | | |0 = Not a data packet is transmitted from the endpoint to the host. + * | | |1 = A data packet is transmitted from the endpoint to the host. + * | | |Note: Write 1 to clear this bit to 0. + * |[4] |RXPKIF |Data Packet Received Interrupt + * | | |0 = No data packet is received from the host by the endpoint. + * | | |1 = A data packet is received from the host by the endpoint. + * | | |Note: Write 1 to clear this bit to 0. + * |[5] |OUTTKIF |Data OUT Token Interrupt + * | | |0 = A Data OUT token has not been received from the host. + * | | |1 = A Data OUT token has been received from the host + * | | |This bit also set by PING token (in high-speed only). + * | | |Note: Write 1 to clear this bit to 0. + * |[6] |INTKIF |Data IN Token Interrupt + * | | |0 = Not Data IN token has been received from the host. + * | | |1 = A Data IN token has been received from the host. + * | | |Note: Write 1 to clear this bit to 0. + * |[7] |PINGIF |PING Token Interrupt + * | | |0 = A Data PING token has not been received from the host. + * | | |1 = A Data PING token has been received from the host. + * | | |Note: Write 1 to clear this bit to 0. + * |[8] |NAKIF |USB NAK Sent + * | | |0 = The last USB IN packet could be provided, and was acknowledged with an ACK. + * | | |1 = The last USB IN packet could not be provided, and was acknowledged with a NAK. + * | | |Note: Write 1 to clear this bit to 0. + * |[9] |STALLIF |USB STALL Sent + * | | |0 = The last USB packet could be accepted or provided because the endpoint was stalled, and was acknowledged with a STALL. + * | | |1 = The last USB packet could not be accepted or provided because the endpoint was stalled, and was acknowledged with a STALL. + * | | |Note: Write 1 to clear this bit to 0. + * |[10] |NYETIF |NYET Sent + * | | |0 = The space available in the RAM is sufficient to accommodate the next on coming data packet. + * | | |1 = The space available in the RAM is not sufficient to accommodate the next on coming data packet. + * | | |Note: Write 1 to clear this bit to 0. + * |[11] |ERRIF |ERR Sent + * | | |0 = No any error in the transaction. + * | | |1 = There occurs any error in the transaction. + * | | |Note: Write 1 to clear this bit to 0. + * |[12] |SHORTRXIF |Bulk Out Short Packet Received + * | | |0 = No bulk out short packet is received. + * | | |1 = Received bulk out short packet (including zero length packet). + * | | |Note: Write 1 to clear this bit to 0. + * @var HSUSBD_EP_T::EPINTEN + * Offset: 0x08 Endpoint n Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BUFFULLIEN|Buffer Full Interrupt + * | | |When set, this bit enables a local interrupt to be set when a buffer full condition is detected on the bus. + * | | |0 = Buffer full interrupt Disabled. + * | | |1 = Buffer full interrupt Enabled. + * |[1] |BUFEMPTYIEN|Buffer Empty Interrupt + * | | |When set, this bit enables a local interrupt to be set when a buffer empty condition is detected on the bus. + * | | |0 = Buffer empty interrupt Disabled. + * | | |1 = Buffer empty interrupt Enabled. + * |[2] |SHORTTXIEN|Short Packet Transferred Interrupt Enable Bit + * | | |When set, this bit enables a local interrupt to be set when a short data packet has been transferred to/from the host. + * | | |0 = Short data packet interrupt Disabled. + * | | |1 = Short data packet interrupt Enabled. + * |[3] |TXPKIEN |Data Packet Transmitted Interrupt Enable Bit + * | | |When set, this bit enables a local interrupt to be set when a data packet has been received from the host. + * | | |0 = Data packet has been received from the host interrupt Disabled. + * | | |1 = Data packet has been received from the host interrupt Enabled. + * |[4] |RXPKIEN |Data Packet Received Interrupt Enable Bit + * | | |When set, this bit enables a local interrupt to be set when a data packet has been transmitted to the host. + * | | |0 = Data packet has been transmitted to the host interrupt Disabled. + * | | |1 = Data packet has been transmitted to the host interrupt Enabled. + * |[5] |OUTTKIEN |Data OUT Token Interrupt Enable Bit + * | | |When set, this bit enables a local interrupt to be set when a Data OUT token has been received from the host. + * | | |0 = Data OUT token interrupt Disabled. + * | | |1 = Data OUT token interrupt Enabled. + * |[6] |INTKIEN |Data IN Token Interrupt Enable Bit + * | | |When set, this bit enables a local interrupt to be set when a Data IN token has been received from the host. + * | | |0 = Data IN token interrupt Disabled. + * | | |1 = Data IN token interrupt Enabled. + * |[7] |PINGIEN |PING Token Interrupt Enable Bit + * | | |When set, this bit enables a local interrupt to be set when a PING token has been received from the host. + * | | |0 = PING token interrupt Disabled. + * | | |1 = PING token interrupt Enabled. + * |[8] |NAKIEN |USB NAK Sent Interrupt Enable Bit + * | | |When set, this bit enables a local interrupt to be set when a NAK token is sent to the host. + * | | |0 = NAK token interrupt Disabled. + * | | |1 = NAK token interrupt Enabled. + * |[9] |STALLIEN |USB STALL Sent Interrupt Enable Bit + * | | |When set, this bit enables a local interrupt to be set when a stall token is sent to the host. + * | | |0 = STALL token interrupt Disabled. + * | | |1 = STALL token interrupt Enabled. + * |[10] |NYETIEN |NYET Interrupt Enable Bit + * | | |When set, this bit enables a local interrupt to be set whenever NYET condition occurs on the bus for this endpoint. + * | | |0 = NYET condition interrupt Disabled. + * | | |1 = NYET condition interrupt Enabled. + * |[11] |ERRIEN |ERR Interrupt Enable Bit + * | | |When set, this bit enables a local interrupt to be set whenever ERR condition occurs on the bus for this endpoint. + * | | |0 = Error event interrupt Disabled. + * | | |1 = Error event interrupt Enabled. + * |[12] |SHORTRXIEN|Bulk Out Short Packet Interrupt Enable Bit + * | | |When set, this bit enables a local interrupt to be set whenever bulk out short packet occurs on the bus for this endpoint. + * | | |0 = Bulk out interrupt Disabled. + * | | |1 = Bulk out interrupt Enabled. + * @var HSUSBD_EP_T::EPDATCNT + * Offset: 0x0C Endpoint n Data Available Count Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |DATCNT |Data Count + * | | |For an IN endpoint (EPDIR(USBD_EPxCFG[3] is high.), this register returns the number of valid bytes in the IN endpoint packet buffer. + * | | |For an OUT endpoint (EPDIR(USBD_EPxCFG[3] is low.), this register returns the number of received valid bytes in the Host OUT transfer. + * |[30:16] |DMALOOP |DMA Loop + * | | |This register is the remaining DMA loop to complete. Each loop means 32-byte transfer. + * @var HSUSBD_EP_T::EPRSPCTL + * Offset: 0x10 Endpoint n Response Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |FLUSH |Buffer Flush + * | | |Writing 1 to this bit causes the packet buffer to be flushed and the corresponding EP_AVAIL register to be cleared + * | | |This bit is self-clearing + * | | |This bit should always be written after an configuration event. + * | | |0 = The packet buffer is not flushed. + * | | |1 = The packet buffer is flushed by user. + * |[2:1] |MODE |Mode Control + * | | |The two bits decide the operation mode of the in-endpoint. + * | | |00: Auto-Validate Mode + * | | |01: Manual-Validate Mode + * | | |10: Fly Mode + * | | |11: Reserved + * | | |These bits are not valid for an out-endpoint + * | | |The auto validate mode will be activated when the reserved mode is selected + * |[3] |TOGGLE |Endpoint Toggle + * | | |This bit is used to clear the endpoint data toggle bit + * | | |Reading this bit returns the current state of the endpoint data toggle bit. + * | | |The local CPU may use this bit to initialize the end-point's toggle in case of reception of a Set Interface request or a Clear Feature (ep_halt) request from the host + * | | |Only when toggle bit is "1", this bit can be written into the inversed write data bit[3]. + * | | |0 = Not clear the endpoint data toggle bit. + * | | |1 = Clear the endpoint data toggle bit. + * |[4] |HALT |Endpoint Halt + * | | |This bit is used to send a STALL handshake as response to the token from the host + * | | |When an Endpoint Set Feature (ep_halt) is detected by the local CPU, it must write a '1' to this bit. + * | | |0 = Not send a STALL handshake as response to the token from the host. + * | | |1 = Send a STALL handshake as response to the token from the host. + * |[5] |ZEROLEN |Zero Length + * | | |This bit is used to send a zero-length packet response to an IN-token + * | | |When this bit is set, a zero packet is sent to the host on reception of an IN-token + * | | |This bit gets cleared once the zero length data packet is sent. + * | | |0 = A zero packet is not sent to the host on reception of an IN-token. + * | | |1 = A zero packet is sent to the host on reception of an IN-token. + * |[6] |SHORTTXEN |Short Packet Transfer Enable + * | | |This bit is applicable only in case of Auto-Validate Method + * | | |This bit is set to validate any remaining data in the buffer which is not equal to the MPS of the endpoint, and happens to be the last transfer + * | | |This bit gets cleared once the data packet is sent. + * | | |0 = Not validate any remaining data in the buffer which is not equal to the MPS of the endpoint. + * | | |1 = Validate any remaining data in the buffer which is not equal to the MPS of the endpoint. + * |[7] |DISBUF |Buffer Disable Bit + * | | |This bit is used to receive unknown size OUT short packet + * | | |The received packet size is reference USBD_EPxDATCNT register. + * | | |0 = Buffer Not Disabled when Bulk-OUT short packet is received. + * | | |1 = Buffer Disabled when Bulk-OUT short packet is received. + * @var HSUSBD_EP_T::EPMPS + * Offset: 0x14 Endpoint n Maximum Packet Size Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[10:0] |EPMPS |Endpoint Maximum Packet Size + * | | |This field determines the Maximum Packet Size of the Endpoint. + * @var HSUSBD_EP_T::EPTXCNT + * Offset: 0x18 Endpoint n Transfer Count Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[10:0] |TXCNT |Endpoint Transfer Count + * | | |For IN endpoints, this field determines the total number of bytes to be sent to the host in case of manual validation method. + * | | |For OUT endpoints, this field has no effect. + * @var HSUSBD_EP_T::EPCFG + * Offset: 0x1C Endpoint n Configuration Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |EPEN |Endpoint Valid + * | | |When set, this bit enables this endpoint + * | | |This bit has no effect on Endpoint 0, which is always enabled. + * | | |0 = The endpoint Disabled. + * | | |1 = The endpoint Enabled. + * |[2:1] |EPTYPE |Endpoint Type + * | | |This field selects the type of this endpoint. Endpoint 0 is forced to a Control type. + * | | |00 = Reserved. + * | | |01 = Bulk. + * | | |10 = Interrupt. + * | | |11 = Isochronous. + * |[3] |EPDIR |Endpoint Direction + * | | |0 = out-endpoint (Host OUT to Device). + * | | |1 = in-endpoint (Host IN to Device). + * | | |Note: A maximum of one OUT and IN endpoint is allowed for each endpoint number. + * |[7:4] |EPNUM |Endpoint Number + * | | |This field selects the number of the endpoint. Valid numbers 1 to 15. + * | | |Note: Do not support two endpoints have same endpoint number. + * @var HSUSBD_EP_T::EPBUFST + * Offset: 0x20 Endpoint n RAM Start Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[11:0] |SADDR |Endpoint Start Address + * | | |This is the start-address of the RAM space allocated for the endpoint A~L. + * @var HSUSBD_EP_T::EPBUFEND + * Offset: 0x24 Endpoint n RAM End Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[11:0] |EADDR |Endpoint End Address + * | | |This is the end-address of the RAM space allocated for the endpoint A~L. + */ + + union + { + __IO uint32_t EPDAT; + __IO uint8_t EPDAT_BYTE; + + }; /*!< [0x0000] Endpoint n Data Register */ + + __IO uint32_t EPINTSTS; /*!< [0x0004] Endpoint n Interrupt Status Register */ + __IO uint32_t EPINTEN; /*!< [0x0008] Endpoint n Interrupt Enable Register */ + __I uint32_t EPDATCNT; /*!< [0x000c] Endpoint n Data Available Count Register */ + __IO uint32_t EPRSPCTL; /*!< [0x0010] Endpoint n Response Control Register */ + __IO uint32_t EPMPS; /*!< [0x0014] Endpoint n Maximum Packet Size Register */ + __IO uint32_t EPTXCNT; /*!< [0x0018] Endpoint n Transfer Count Register */ + __IO uint32_t EPCFG; /*!< [0x001c] Endpoint n Configuration Register */ + __IO uint32_t EPBUFST; /*!< [0x0020] Endpoint n RAM Start Address Register */ + __IO uint32_t EPBUFEND; /*!< [0x0024] Endpoint n RAM End Address Register */ + +} HSUSBD_EP_T; + +typedef struct +{ + + /** + * @var HSUSBD_T::GINTSTS + * Offset: 0x00 Global Interrupt Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |USBIF |USB Interrupt + * | | |This bit conveys the interrupt status for USB specific events endpoint + * | | |When set, USB interrupt status register should be read to determine the cause of the interrupt. + * | | |0 = No interrupt event occurred. + * | | |1 = The related interrupt event is occurred. + * |[1] |CEPIF |Control Endpoint Interrupt + * | | |This bit conveys the interrupt status for control endpoint + * | | |When set, Control-ep's interrupt status register should be read to determine the cause of the interrupt. + * | | |0 = No interrupt event occurred. + * | | |1 = The related interrupt event is occurred. + * |[2] |EPAIF |Endpoint a Interrupt + * | | |When set, the corresponding Endpoint A's interrupt status register should be read to determine the cause of the interrupt. + * | | |0 = No interrupt event occurred. + * | | |1 = The related interrupt event is occurred. + * |[3] |EPBIF |Endpoint B Interrupt + * | | |When set, the corresponding Endpoint B's interrupt status register should be read to determine the cause of the interrupt. + * | | |0 = No interrupt event occurred. + * | | |1 = The related interrupt event is occurred. + * |[4] |EPCIF |Endpoint C Interrupt + * | | |When set, the corresponding Endpoint C's interrupt status register should be read to determine the cause of the interrupt. + * | | |0 = No interrupt event occurred. + * | | |1 = The related interrupt event is occurred. + * |[5] |EPDIF |Endpoint D Interrupt + * | | |When set, the corresponding Endpoint D's interrupt status register should be read to determine the cause of the interrupt. + * | | |0 = No interrupt event occurred. + * | | |1 = The related interrupt event is occurred. + * |[6] |EPEIF |Endpoint E Interrupt + * | | |When set, the corresponding Endpoint E's interrupt status register should be read to determine the cause of the interrupt. + * | | |0 = No interrupt event occurred. + * | | |1 = The related interrupt event is occurred. + * |[7] |EPFIF |Endpoint F Interrupt + * | | |When set, the corresponding Endpoint F's interrupt status register should be read to determine the cause of the interrupt. + * | | |0 = No interrupt event occurred. + * | | |1 = The related interrupt event is occurred. + * |[8] |EPGIF |Endpoint G Interrupt + * | | |When set, the corresponding Endpoint G's interrupt status register should be read to determine the cause of the interrupt. + * | | |0 = No interrupt event occurred. + * | | |1 = The related interrupt event is occurred. + * |[9] |EPHIF |Endpoint H Interrupt + * | | |When set, the corresponding Endpoint H's interrupt status register should be read to determine the cause of the interrupt. + * | | |0 = No interrupt event occurred. + * | | |1 = The related interrupt event is occurred. + * |[10] |EPIIF |Endpoint I Interrupt + * | | |When set, the corresponding Endpoint I's interrupt status register should be read to determine the cause of the interrupt. + * | | |0 = No interrupt event occurred. + * | | |1 = The related interrupt event is occurred. + * |[11] |EPJIF |Endpoint J Interrupt + * | | |When set, the corresponding Endpoint J's interrupt status register should be read to determine the cause of the interrupt. + * | | |0 = No interrupt event occurred. + * | | |1 = The related interrupt event is occurred. + * |[12] |EPKIF |Endpoint K Interrupt + * | | |When set, the corresponding Endpoint K's interrupt status register should be read to determine the cause of the interrupt. + * | | |0 = No interrupt event occurred. + * | | |1 = The related interrupt event is occurred. + * |[13] |EPLIF |Endpoint L Interrupt + * | | |When set, the corresponding Endpoint L's interrupt status register should be read to determine the cause of the interrupt. + * | | |0 = No interrupt event occurred. + * | | |1 = The related interrupt event is occurred. + * @var HSUSBD_T::GINTEN + * Offset: 0x08 Global Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |USBIEN |USB Interrupt Enable Bit + * | | |When set, this bit enables a local interrupt to be generated when a USB event occurs on the bus. + * | | |0 = The related interrupt Disabled. + * | | |1 = The related interrupt Enabled. + * |[1] |CEPIEN |Control Endpoint Interrupt Enable Bit + * | | |When set, this bit enables a local interrupt to be generated when an interrupt is pending for the control endpoint. + * | | |0 = The related interrupt Disabled. + * | | |1 = The related interrupt Enabled. + * |[2] |EPAIEN |Interrupt Enable Control for Endpoint a + * | | |When set, this bit enables a local interrupt to be generated when an interrupt is pending for the endpoint A. + * | | |0 = The related interrupt Disabled. + * | | |1 = The related interrupt Enabled. + * |[3] |EPBIEN |Interrupt Enable Control for Endpoint B + * | | |When set, this bit enables a local interrupt to be generated when an interrupt is pending for the endpoint B + * | | |0 = The related interrupt Disabled. + * | | |1 = The related interrupt Enabled. + * |[4] |EPCIEN |Interrupt Enable Control for Endpoint C + * | | |When set, this bit enables a local interrupt to be generated when an interrupt is pending for the endpoint C + * | | |0 = The related interrupt Disabled. + * | | |1 = The related interrupt Enabled. + * |[5] |EPDIEN |Interrupt Enable Control for Endpoint D + * | | |When set, this bit enables a local interrupt to be generated when an interrupt is pending for the endpoint D + * | | |0 = The related interrupt Disabled. + * | | |1 = The related interrupt Enabled. + * |[6] |EPEIEN |Interrupt Enable Control for Endpoint E + * | | |When set, this bit enables a local interrupt to be generated when an interrupt is pending for the endpoint E + * | | |0 = The related interrupt Disabled. + * | | |1 = The related interrupt Enabled. + * |[7] |EPFIEN |Interrupt Enable Control for Endpoint F + * | | |When set, this bit enables a local interrupt to be generated when an interrupt is pending for the endpoint F + * | | |0 = The related interrupt Disabled. + * | | |1 = The related interrupt Enabled. + * |[8] |EPGIEN |Interrupt Enable Control for Endpoint G + * | | |When set, this bit enables a local interrupt to be generated when an interrupt is pending for the endpoint G + * | | |0 = The related interrupt Disabled. + * | | |1 = The related interrupt Enabled. + * |[9] |EPHIEN |Interrupt Enable Control for Endpoint H + * | | |When set, this bit enables a local interrupt to be generated when an interrupt is pending for the endpoint H + * | | |0 = The related interrupt Disabled. + * | | |1 = The related interrupt Enabled. + * |[10] |EPIIEN |Interrupt Enable Control for Endpoint I + * | | |When set, this bit enables a local interrupt to be generated when an interrupt is pending for the endpoint I + * | | |0 = The related interrupt Disabled. + * | | |1 = The related interrupt Enabled. + * |[11] |EPJIEN |Interrupt Enable Control for Endpoint J + * | | |When set, this bit enables a local interrupt to be generated when an interrupt is pending for the endpoint J + * | | |0 = The related interrupt Disabled. + * | | |1 = The related interrupt Enabled. + * |[12] |EPKIEN |Interrupt Enable Control for Endpoint K + * | | |When set, this bit enables a local interrupt to be generated when an interrupt is pending for the endpoint K + * | | |0 = The related interrupt Disabled. + * | | |1 = The related interrupt Enabled. + * |[13] |EPLIEN |Interrupt Enable Control for Endpoint L + * | | |When set, this bit enables a local interrupt to be generated when an interrupt is pending for the endpoint L + * | | |0 = The related interrupt Disabled. + * | | |1 = The related interrupt Enabled. + * @var HSUSBD_T::BUSINTSTS + * Offset: 0x10 USB Bus Interrupt Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SOFIF |SOF Receive Control + * | | |This bit indicates when a start-of-frame packet has been received. + * | | |0 = No start-of-frame packet has been received. + * | | |1 = Start-of-frame packet has been received. + * | | |Note: Write 1 to clear this bit to 0. + * |[1] |RSTIF |Reset Status + * | | |When set, this bit indicates that either the USB root port reset is end. + * | | |0 = No USB root port reset is end. + * | | |1 = USB root port reset is end. + * | | |Note: Write 1 to clear this bit to 0. + * |[2] |RESUMEIF |Resume + * | | |When set, this bit indicates that a device resume has occurred. + * | | |0 = No device resume has occurred. + * | | |1 = Device resume has occurred. + * | | |Note: Write 1 to clear this bit to 0. + * |[3] |SUSPENDIF |Suspend Request + * | | |This bit is set as default and it has to be cleared by writing '1' before the USB reset + * | | |This bit is also set when a USB Suspend request is detected from the host. + * | | |0 = No USB Suspend request is detected from the host. + * | | |1= USB Suspend request is detected from the host. + * | | |Note: Write 1 to clear this bit to 0. + * |[4] |HISPDIF |High-speed Settle + * | | |0 = No valid high-speed reset protocol is detected. + * | | |1 = Valid high-speed reset protocol is over and the device has settled in high-speed. + * | | |Note: Write 1 to clear this bit to 0. + * |[5] |DMADONEIF |DMA Completion Interrupt + * | | |0 = No DMA transfer over. + * | | |1 = DMA transfer is over. + * | | |Note: Write 1 to clear this bit to 0. + * |[6] |PHYCLKVLDIF|Usable Clock Interrupt + * | | |0 = Usable clock is not available. + * | | |1 = Usable clock is available from the transceiver. + * | | |Note: Write 1 to clear this bit to 0. + * |[8] |VBUSDETIF |VBUS Detection Interrupt Status + * | | |0 = No VBUS is plug-in. + * | | |1 = VBUS is plug-in. + * | | |Note: Write 1 to clear this bit to 0. + * @var HSUSBD_T::BUSINTEN + * Offset: 0x14 USB Bus Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SOFIEN |SOF Interrupt + * | | |This bit enables the SOF interrupt. + * | | |0 = SOF interrupt Disabled. + * | | |1 = SOF interrupt Enabled. + * |[1] |RSTIEN |Reset Status + * | | |This bit enables the USB-Reset interrupt. + * | | |0 = USB-Reset interrupt Disabled. + * | | |1 = USB-Reset interrupt Enabled. + * |[2] |RESUMEIEN |Resume + * | | |This bit enables the Resume interrupt. + * | | |0 = Resume interrupt Disabled. + * | | |1 = Resume interrupt Enabled. + * |[3] |SUSPENDIEN|Suspend Request + * | | |This bit enables the Suspend interrupt. + * | | |0 = Suspend interrupt Disabled. + * | | |1 = Suspend interrupt Enabled. + * |[4] |HISPDIEN |High-speed Settle + * | | |This bit enables the high-speed settle interrupt. + * | | |0 = High-speed settle interrupt Disabled. + * | | |1 = High-speed settle interrupt Enabled. + * |[5] |DMADONEIEN|DMA Completion Interrupt + * | | |This bit enables the DMA completion interrupt + * | | |0 = DMA completion interrupt Disabled. + * | | |1 = DMA completion interrupt Enabled. + * |[6] |PHYCLKVLDIEN|Usable Clock Interrupt + * | | |This bit enables the usable clock interrupt. + * | | |0 = Usable clock interrupt Disabled. + * | | |1 = Usable clock interrupt Enabled. + * |[8] |VBUSDETIEN|VBUS Detection Interrupt Enable Bit + * | | |This bit enables the VBUS floating detection interrupt. + * | | |0 = VBUS floating detection interrupt Disabled. + * | | |1 = VBUS floating detection interrupt Enabled. + * @var HSUSBD_T::OPER + * Offset: 0x18 USB Operational Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |RESUMEEN |Generate Resume + * | | |0 = No Resume sequence to be initiated to the host. + * | | |1 = A Resume sequence to be initiated to the host if device remote wakeup is enabled + * | | |This bit is self-clearing. + * |[1] |HISPDEN |USB High-speed + * | | |0 = The USB device controller to suppress the chirp-sequence during reset protocol, thereby allowing the USB device controller to settle in full-speed, even though it is connected to a USB2.0 Host. + * | | |1 = The USB device controller to initiate a chirp-sequence during reset protocol. + * |[2] |CURSPD |USB Current Speed + * | | |0 = The device has settled in Full Speed. + * | | |1 = The USB device controller has settled in High-speed. + * @var HSUSBD_T::FRAMECNT + * Offset: 0x1C USB Frame Count Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2:0] |MFRAMECNT |Micro-frame Counter + * | | |This field contains the micro-frame number for the frame number in the frame counter field. + * |[13:3] |FRAMECNT |Frame Counter + * | | |This field contains the frame count from the most recent start-of-frame packet. + * @var HSUSBD_T::FADDR + * Offset: 0x20 USB Function Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[6:0] |FADDR |USB Function Address + * | | |This field contains the current USB address of the device + * | | |This field is cleared when a root port reset is detected + * @var HSUSBD_T::TEST + * Offset: 0x24 USB Test Mode Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2:0] |TESTMODE |Test Mode Selection + * | | |000 = Normal Operation. + * | | |001 = Test_J. + * | | |010 = Test_K. + * | | |011 = Test_SE0_NAK. + * | | |100 = Test_Packet. + * | | |101 = Test_Force_Enable. + * | | |110 = Reserved. + * | | |111 = Reserved. + * | | |Note: This field is cleared when root port reset is detected. + * @var HSUSBD_T::CEPDAT + * Offset: 0x28 Control-Endpoint Data Buffer + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |DAT |Control-endpoint Data Buffer + * | | |Control endpoint data buffer for the buffer transaction (read or write). + * | | |Note: Only word access is supported. + * @var HSUSBD_T::CEPDAT_BYTE + * Offset: 0x28 Control-Endpoint Data Buffer + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |DAT |Control-endpoint Data Buffer + * | | |Control endpoint data buffer for the buffer transaction (read or write). + * | | |Note: Only byte access is supported. + * @var HSUSBD_T::CEPCTL + * Offset: 0x2C Control-Endpoint Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |NAKCLR |No Acknowledge Control + * | | |This bit plays a crucial role in any control transfer. + * | | |0 = The bit is being cleared by the local CPU by writing zero, the USB device controller will be responding with NAKs for the subsequent status phase + * | | |This mechanism holds the host from moving to the next request, until the local CPU is also ready to process the next request. + * | | |1 = This bit is set to one by the USB device controller, whenever a setup token is received + * | | |The local CPU can take its own time to finish off any house-keeping work based on the request and then clear this bit. + * | | |Note: Only when CPU writes data[1:0] is 2'b10 or 2'b00, this bit can be updated. + * |[1] |STALLEN |Stall Enable Bit + * | | |When this stall bit is set, the control endpoint sends a stall handshake in response to any in or out token thereafter + * | | |This is typically used for response to invalid/unsupported requests + * | | |When this bit is being set the NAK clear bit has to be cleared at the same time since the NAK clear bit has highest priority than STALL + * | | |It is automatically cleared on receipt of a next setup-token + * | | |So, the local CPU need not write again to clear this bit. + * | | |0 = No sends a stall handshake in response to any in or out token thereafter. + * | | |1 = The control endpoint sends a stall handshake in response to any in or out token thereafter. + * | | |Note: Only when CPU writes data[1:0] is 2'b10 or 2'b00, this bit can be updated. + * |[2] |ZEROLEN |Zero Packet Length + * | | |This bit is valid for Auto Validation mode only. + * | | |0 = No zero length packet to the host during Data stage to an IN token. + * | | |1 = USB device controller can send a zero length packet to the host during Data stage to an IN token + * | | |This bit gets cleared once the zero length data packet is sent + * | | |So, the local CPU need not write again to clear this bit. + * |[3] |FLUSH |CEP-flush Bit + * | | |0 = No the packet buffer and its corresponding USBD_CEPDATCNT register to be cleared. + * | | |1 = The packet buffer and its corresponding USBD_CEPDATCNT register to be cleared + * | | |This bit is self-cleaning. + * @var HSUSBD_T::CEPINTEN + * Offset: 0x30 Control-Endpoint Interrupt Enable + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SETUPTKIEN|Setup Token Interrupt Enable Bit + * | | |0 = The SETUP token interrupt in Control Endpoint Disabled. + * | | |1 = The SETUP token interrupt in Control Endpoint Enabled. + * |[1] |SETUPPKIEN|Setup Packet Interrupt + * | | |0 = The SETUP packet interrupt in Control Endpoint Disabled. + * | | |1 = The SETUP packet interrupt in Control Endpoint Enabled. + * |[2] |OUTTKIEN |Out Token Interrupt + * | | |0 = The OUT token interrupt in Control Endpoint Disabled. + * | | |1 = The OUT token interrupt in Control Endpoint Enabled. + * |[3] |INTKIEN |In Token Interrupt + * | | |0 = The IN token interrupt in Control Endpoint Disabled. + * | | |1 = The IN token interrupt in Control Endpoint Enabled. + * |[4] |PINGIEN |Ping Token Interrupt + * | | |0 = The ping token interrupt in Control Endpoint Disabled. + * | | |1 = The ping token interrupt Control Endpoint Enabled. + * |[5] |TXPKIEN |Data Packet Transmitted Interrupt + * | | |0 = The data packet transmitted interrupt in Control Endpoint Disabled. + * | | |1 = The data packet transmitted interrupt in Control Endpoint Enabled. + * |[6] |RXPKIEN |Data Packet Received Interrupt + * | | |0 = The data received interrupt in Control Endpoint Disabled. + * | | |1 = The data received interrupt in Control Endpoint Enabled. + * |[7] |NAKIEN |NAK Sent Interrupt + * | | |0 = The NAK sent interrupt in Control Endpoint Disabled. + * | | |1 = The NAK sent interrupt in Control Endpoint Enabled. + * |[8] |STALLIEN |STALL Sent Interrupt + * | | |0 = The STALL sent interrupt in Control Endpoint Disabled. + * | | |1 = The STALL sent interrupt in Control Endpoint Enabled. + * |[9] |ERRIEN |USB Error Interrupt + * | | |0 = The USB Error interrupt in Control Endpoint Disabled. + * | | |1 = The USB Error interrupt in Control Endpoint Enabled. + * |[10] |STSDONEIEN|Status Completion Interrupt + * | | |0 = The Status Completion interrupt in Control Endpoint Disabled. + * | | |1 = The Status Completion interrupt in Control Endpoint Enabled. + * |[11] |BUFFULLIEN|Buffer Full Interrupt + * | | |0 = The buffer full interrupt in Control Endpoint Disabled. + * | | |1 = The buffer full interrupt in Control Endpoint Enabled. + * |[12] |BUFEMPTYIEN|Buffer Empty Interrupt + * | | |0 = The buffer empty interrupt in Control Endpoint Disabled. + * | | |1= The buffer empty interrupt in Control Endpoint Enabled. + * @var HSUSBD_T::CEPINTSTS + * Offset: 0x34 Control-Endpoint Interrupt Status + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SETUPTKIF |Setup Token Interrupt + * | | |0 = Not a Setup token is received. + * | | |1 = A Setup token is received. Writing 1 clears this status bit + * | | |Note: Write 1 to clear this bit to 0. + * |[1] |SETUPPKIF |Setup Packet Interrupt + * | | |This bit must be cleared (by writing 1) before the next setup packet can be received + * | | |If the bit is not cleared, then the successive setup packets will be overwritten in the setup packet buffer. + * | | |0 = Not a Setup packet has been received from the host. + * | | |1 = A Setup packet has been received from the host. + * | | |Note: Write 1 to clear this bit to 0. + * |[2] |OUTTKIF |Out Token Interrupt + * | | |0 = The control-endpoint does not received an OUT token from the host. + * | | |1 = The control-endpoint receives an OUT token from the host. + * | | |Note: Write 1 to clear this bit to 0. + * |[3] |INTKIF |in Token Interrupt + * | | |0 = The control-endpoint does not received an IN token from the host. + * | | |1 = The control-endpoint receives an IN token from the host. + * | | |Note: Write 1 to clear this bit to 0. + * |[4] |PINGIF |Ping Token Interrupt + * | | |0 = The control-endpoint does not received a ping token from the host. + * | | |1 = The control-endpoint receives a ping token from the host. + * | | |Note: Write 1 to clear this bit to 0. + * |[5] |TXPKIF |Data Packet Transmitted Interrupt + * | | |0 = Not a data packet is successfully transmitted to the host in response to an IN-token and an ACK-token is received for the same. + * | | |1 = A data packet is successfully transmitted to the host in response to an IN-token and an ACK-token is received for the same. + * | | |Note: Write 1 to clear this bit to 0. + * |[6] |RXPKIF |Data Packet Received Interrupt + * | | |0 = Not a data packet is successfully received from the host for an OUT-token and an ACK is sent to the host. + * | | |1 = A data packet is successfully received from the host for an OUT-token and an ACK is sent to the host. + * | | |Note: Write 1 to clear this bit to 0. + * |[7] |NAKIF |NAK Sent Interrupt + * | | |0 = Not a NAK-token is sent in response to an IN/OUT token. + * | | |1 = A NAK-token is sent in response to an IN/OUT token. + * | | |Note: Write 1 to clear this bit to 0. + * |[8] |STALLIF |STALL Sent Interrupt + * | | |0 = Not a stall-token is sent in response to an IN/OUT token. + * | | |1 = A stall-token is sent in response to an IN/OUT token. + * | | |Note: Write 1 to clear this bit to 0. + * |[9] |ERRIF |USB Error Interrupt + * | | |0 = No error had occurred during the transaction. + * | | |1 = An error had occurred during the transaction. + * | | |Note: Write 1 to clear this bit to 0. + * |[10] |STSDONEIF |Status Completion Interrupt + * | | |0 = Not a USB transaction has completed successfully. + * | | |1 = The status stage of a USB transaction has completed successfully. + * | | |Note: Write 1 to clear this bit to 0. + * |[11] |BUFFULLIF |Buffer Full Interrupt + * | | |0 = The control-endpoint buffer is not full. + * | | |1 = The control-endpoint buffer is full. + * | | |Note: Write 1 to clear this bit to 0. + * |[12] |BUFEMPTYIF|Buffer Empty Interrupt + * | | |0 = The control-endpoint buffer is not empty. + * | | |1 = The control-endpoint buffer is empty. + * | | |Note: Write 1 to clear this bit to 0. + * @var HSUSBD_T::CEPTXCNT + * Offset: 0x38 Control-Endpoint In-transfer Data Count + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |TXCNT |In-transfer Data Count + * | | |There is no mode selection for the control endpoint (but it operates like manual mode).The local-CPU has to fill the control-endpoint buffer with the data to be sent for an in-token and to write the count of bytes in this register + * | | |When zero is written into this field, a zero length packet is sent to the host + * | | |When the count written in the register is more than the MPS, the data sent will be of only MPS. + * @var HSUSBD_T::CEPRXCNT + * Offset: 0x3C Control-Endpoint Out-transfer Data Count + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |RXCNT |Out-transfer Data Count + * | | |The USB device controller maintains the count of the data received in case of an out transfer, during the control transfer. + * @var HSUSBD_T::CEPDATCNT + * Offset: 0x40 Control-Endpoint data count + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |DATCNT |Control-endpoint Data Count + * | | |The USB device controller maintains the count of the data of control-endpoint. + * @var HSUSBD_T::SETUP1_0 + * Offset: 0x44 Setup1 & Setup0 bytes + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |SETUP0 |Setup Byte 0[7:0] + * | | |This register provides byte 0 of the last setup packet received + * | | |For a Standard Device Request, the following bmRequestType information is returned. + * | | |Bit 7(Direction): + * | | | 0: Host to device + * | | | 1: Device to host + * | | |Bit 6-5 (Type): + * | | | 00: Standard + * | | | 01: Class + * | | | 10: Vendor + * | | | 11: Reserved + * | | |Bit 4-0 (Recipient) + * | | | 00000: Device + * | | | 00001: Interface + * | | | 00010: Endpoint + * | | | 00011: Other + * | | | Others: Reserved + * |[15:8] |SETUP1 |Setup Byte 1[15:8] + * | | |This register provides byte 1 of the last setup packet received + * | | |For a Standard Device Request, the following bRequest Code information is returned. + * | | |00000000 = Get Status. + * | | |00000001 = Clear Feature. + * | | |00000010 = Reserved. + * | | |00000011 = Set Feature. + * | | |00000100 = Reserved. + * | | |00000101 = Set Address. + * | | |00000110 = Get Descriptor. + * | | |00000111 = Set Descriptor. + * | | |00001000 = Get Configuration. + * | | |00001001 = Set Configuration. + * | | |00001010 = Get Interface. + * | | |00001011 = Set Interface. + * | | |00001100 = Sync Frame. + * @var HSUSBD_T::SETUP3_2 + * Offset: 0x48 Setup3 & Setup2 Bytes + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |SETUP2 |Setup Byte 2 [7:0] + * | | |This register provides byte 2 of the last setup packet received + * | | |For a Standard Device Request, the least significant byte of the wValue field is returned + * |[15:8] |SETUP3 |Setup Byte 3 [15:8] + * | | |This register provides byte 3 of the last setup packet received + * | | |For a Standard Device Request, the most significant byte of the wValue field is returned. + * @var HSUSBD_T::SETUP5_4 + * Offset: 0x4C Setup5 & Setup4 Bytes + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |SETUP4 |Setup Byte 4[7:0] + * | | |This register provides byte 4 of the last setup packet received + * | | |For a Standard Device Request, the least significant byte of the wIndex is returned. + * |[15:8] |SETUP5 |Setup Byte 5[15:8] + * | | |This register provides byte 5 of the last setup packet received + * | | |For a Standard Device Request, the most significant byte of the wIndex field is returned. + * @var HSUSBD_T::SETUP7_6 + * Offset: 0x50 Setup7 & Setup6 Bytes + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |SETUP6 |Setup Byte 6[7:0] + * | | |This register provides byte 6 of the last setup packet received + * | | |For a Standard Device Request, the least significant byte of the wLength field is returned. + * |[15:8] |SETUP7 |Setup Byte 7[15:8] + * | | |This register provides byte 7 of the last setup packet received + * | | |For a Standard Device Request, the most significant byte of the wLength field is returned. + * @var HSUSBD_T::CEPBUFST + * Offset: 0x54 Control Endpoint RAM Start Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[11:0] |SADDR |Control-endpoint Start Address + * | | |This is the start-address of the RAM space allocated for the control-endpoint. + * @var HSUSBD_T::CEPBUFEND + * Offset: 0x58 Control Endpoint RAM End Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[11:0] |EADDR |Control-endpoint End Address + * | | |This is the end-address of the RAM space allocated for the control-endpoint. + * @var HSUSBD_T::DMACTL + * Offset: 0x5C DMA Control Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |EPNUM |DMA Endpoint Address Bits + * | | |Used to define the Endpoint Address + * |[4] |DMARD |DMA Operation + * | | |0 : The operation is a DMA write (read from USB buffer) + * | | |DMA will check endpoint data available count (USBD_EPxDATCNT) according to EPNM setting before to perform DMA write operation. + * | | |1 : The operation is a DMA read (write to USB buffer). + * |[5] |DMAEN |DMA Enable Bit + * | | |0 : DMA function Disabled. + * | | |1 : DMA function Enabled. + * |[6] |SGEN |Scatter Gather Function Enable Bit + * | | |0 : Scatter gather function Disabled. + * | | |1 : Scatter gather function Enabled. + * |[7] |DMARST |Reset DMA State Machine + * | | |0 : No reset the DMA state machine. + * | | |1 : Reset the DMA state machine. + * |[8] |SVINEP |Serve IN Endpoint + * | | |This bit is used to specify DMA serving endpoint-IN endpoint or OUT endpoint. + * | | |0: DMA serves OUT endpoint + * | | |1: DMA serves IN endpoint + * @var HSUSBD_T::DMACNT + * Offset: 0x60 DMA Count Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[19:0] |DMACNT |DMA Transfer Count + * | | |The transfer count of the DMA operation to be performed is written to this register. + * @var HSUSBD_T::DMAADDR + * Offset: 0x700 AHB DMA Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |DMAADDR |DMAADDR + * | | |The register specifies the address from which the DMA has to read / write + * | | |The address must WORD (32-bit) aligned. + * @var HSUSBD_T::PHYCTL + * Offset: 0x704 USB PHY Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[8] |DPPUEN |DP Pull-up + * | | |0 = Pull-up resistor on D+ Disabled. + * | | |1 = Pull-up resistor on D+ Enabled. + * |[9] |PHYEN |PHY Suspend Enable Bit + * | | |0 = The USB PHY is suspend. + * | | |1 = The USB PHY is not suspend. + * |[24] |WKEN |Wake-up Enable Bit + * | | |0 = The wake-up function Disabled. + * | | |1 = The wake-up function Enabled. + * |[31] |VBUSDET |VBUS Status + * | | |0 = The VBUS is not detected yet. + * | | |1 = The VBUS is detected. + */ + + __I uint32_t GINTSTS; /*!< [0x0000] Global Interrupt Status Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t GINTEN; /*!< [0x0008] Global Interrupt Enable Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE1[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t BUSINTSTS; /*!< [0x0010] USB Bus Interrupt Status Register */ + __IO uint32_t BUSINTEN; /*!< [0x0014] USB Bus Interrupt Enable Register */ + __IO uint32_t OPER; /*!< [0x0018] USB Operational Register */ + __I uint32_t FRAMECNT; /*!< [0x001c] USB Frame Count Register */ + __IO uint32_t FADDR; /*!< [0x0020] USB Function Address Register */ + __IO uint32_t TEST; /*!< [0x0024] USB Test Mode Register */ + + union + { + __IO uint32_t CEPDAT; + __IO uint8_t CEPDAT_BYTE; + + }; /*!< [0x0028] Control-Endpoint Data Buffer */ + + __IO uint32_t CEPCTL; /*!< [0x002c] Control-Endpoint Control Register */ + __IO uint32_t CEPINTEN; /*!< [0x0030] Control-Endpoint Interrupt Enable */ + __IO uint32_t CEPINTSTS; /*!< [0x0034] Control-Endpoint Interrupt Status */ + __IO uint32_t CEPTXCNT; /*!< [0x0038] Control-Endpoint In-transfer Data Count */ + __I uint32_t CEPRXCNT; /*!< [0x003c] Control-Endpoint Out-transfer Data Count */ + __I uint32_t CEPDATCNT; /*!< [0x0040] Control-Endpoint data count */ + __I uint32_t SETUP1_0; /*!< [0x0044] Setup1 & Setup0 bytes */ + __I uint32_t SETUP3_2; /*!< [0x0048] Setup3 & Setup2 Bytes */ + __I uint32_t SETUP5_4; /*!< [0x004c] Setup5 & Setup4 Bytes */ + __I uint32_t SETUP7_6; /*!< [0x0050] Setup7 & Setup6 Bytes */ + __IO uint32_t CEPBUFST; /*!< [0x0054] Control Endpoint RAM Start Address Register */ + __IO uint32_t CEPBUFEND; /*!< [0x0058] Control Endpoint RAM End Address Register */ + __IO uint32_t DMACTL; /*!< [0x005c] DMA Control Status Register */ + __IO uint32_t DMACNT; /*!< [0x0060] DMA Count Register */ + + HSUSBD_EP_T EP[12]; + + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE2[303]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t DMAADDR; /*!< [0x0700] AHB DMA Address Register */ + __IO uint32_t PHYCTL; /*!< [0x0704] USB PHY Control Register */ + +} HSUSBD_T; + +/** + @addtogroup HSUSBD_CONST HSUSBD Bit Field Definition + Constant Definitions for HSUSBD Controller +@{ */ + +#define HSUSBD_GINTSTS_USBIF_Pos (0) /*!< HSUSBD_T::GINTSTS: USBIF Position */ +#define HSUSBD_GINTSTS_USBIF_Msk (0x1ul << HSUSBD_GINTSTS_USBIF_Pos) /*!< HSUSBD_T::GINTSTS: USBIF Mask */ + +#define HSUSBD_GINTSTS_CEPIF_Pos (1) /*!< HSUSBD_T::GINTSTS: CEPIF Position */ +#define HSUSBD_GINTSTS_CEPIF_Msk (0x1ul << HSUSBD_GINTSTS_CEPIF_Pos) /*!< HSUSBD_T::GINTSTS: CEPIF Mask */ + +#define HSUSBD_GINTSTS_EPAIF_Pos (2) /*!< HSUSBD_T::GINTSTS: EPAIF Position */ +#define HSUSBD_GINTSTS_EPAIF_Msk (0x1ul << HSUSBD_GINTSTS_EPAIF_Pos) /*!< HSUSBD_T::GINTSTS: EPAIF Mask */ + +#define HSUSBD_GINTSTS_EPBIF_Pos (3) /*!< HSUSBD_T::GINTSTS: EPBIF Position */ +#define HSUSBD_GINTSTS_EPBIF_Msk (0x1ul << HSUSBD_GINTSTS_EPBIF_Pos) /*!< HSUSBD_T::GINTSTS: EPBIF Mask */ + +#define HSUSBD_GINTSTS_EPCIF_Pos (4) /*!< HSUSBD_T::GINTSTS: EPCIF Position */ +#define HSUSBD_GINTSTS_EPCIF_Msk (0x1ul << HSUSBD_GINTSTS_EPCIF_Pos) /*!< HSUSBD_T::GINTSTS: EPCIF Mask */ + +#define HSUSBD_GINTSTS_EPDIF_Pos (5) /*!< HSUSBD_T::GINTSTS: EPDIF Position */ +#define HSUSBD_GINTSTS_EPDIF_Msk (0x1ul << HSUSBD_GINTSTS_EPDIF_Pos) /*!< HSUSBD_T::GINTSTS: EPDIF Mask */ + +#define HSUSBD_GINTSTS_EPEIF_Pos (6) /*!< HSUSBD_T::GINTSTS: EPEIF Position */ +#define HSUSBD_GINTSTS_EPEIF_Msk (0x1ul << HSUSBD_GINTSTS_EPEIF_Pos) /*!< HSUSBD_T::GINTSTS: EPEIF Mask */ + +#define HSUSBD_GINTSTS_EPFIF_Pos (7) /*!< HSUSBD_T::GINTSTS: EPFIF Position */ +#define HSUSBD_GINTSTS_EPFIF_Msk (0x1ul << HSUSBD_GINTSTS_EPFIF_Pos) /*!< HSUSBD_T::GINTSTS: EPFIF Mask */ + +#define HSUSBD_GINTSTS_EPGIF_Pos (8) /*!< HSUSBD_T::GINTSTS: EPGIF Position */ +#define HSUSBD_GINTSTS_EPGIF_Msk (0x1ul << HSUSBD_GINTSTS_EPGIF_Pos) /*!< HSUSBD_T::GINTSTS: EPGIF Mask */ + +#define HSUSBD_GINTSTS_EPHIF_Pos (9) /*!< HSUSBD_T::GINTSTS: EPHIF Position */ +#define HSUSBD_GINTSTS_EPHIF_Msk (0x1ul << HSUSBD_GINTSTS_EPHIF_Pos) /*!< HSUSBD_T::GINTSTS: EPHIF Mask */ + +#define HSUSBD_GINTSTS_EPIIF_Pos (10) /*!< HSUSBD_T::GINTSTS: EPIIF Position */ +#define HSUSBD_GINTSTS_EPIIF_Msk (0x1ul << HSUSBD_GINTSTS_EPIIF_Pos) /*!< HSUSBD_T::GINTSTS: EPIIF Mask */ + +#define HSUSBD_GINTSTS_EPJIF_Pos (11) /*!< HSUSBD_T::GINTSTS: EPJIF Position */ +#define HSUSBD_GINTSTS_EPJIF_Msk (0x1ul << HSUSBD_GINTSTS_EPJIF_Pos) /*!< HSUSBD_T::GINTSTS: EPJIF Mask */ + +#define HSUSBD_GINTSTS_EPKIF_Pos (12) /*!< HSUSBD_T::GINTSTS: EPKIF Position */ +#define HSUSBD_GINTSTS_EPKIF_Msk (0x1ul << HSUSBD_GINTSTS_EPKIF_Pos) /*!< HSUSBD_T::GINTSTS: EPKIF Mask */ + +#define HSUSBD_GINTSTS_EPLIF_Pos (13) /*!< HSUSBD_T::GINTSTS: EPLIF Position */ +#define HSUSBD_GINTSTS_EPLIF_Msk (0x1ul << HSUSBD_GINTSTS_EPLIF_Pos) /*!< HSUSBD_T::GINTSTS: EPLIF Mask */ + +#define HSUSBD_GINTEN_USBIEN_Pos (0) /*!< HSUSBD_T::GINTEN: USBIEN Position */ +#define HSUSBD_GINTEN_USBIEN_Msk (0x1ul << HSUSBD_GINTEN_USBIEN_Pos) /*!< HSUSBD_T::GINTEN: USBIEN Mask */ + +#define HSUSBD_GINTEN_CEPIEN_Pos (1) /*!< HSUSBD_T::GINTEN: CEPIEN Position */ +#define HSUSBD_GINTEN_CEPIEN_Msk (0x1ul << HSUSBD_GINTEN_CEPIEN_Pos) /*!< HSUSBD_T::GINTEN: CEPIEN Mask */ + +#define HSUSBD_GINTEN_EPAIEN_Pos (2) /*!< HSUSBD_T::GINTEN: EPAIEN Position */ +#define HSUSBD_GINTEN_EPAIEN_Msk (0x1ul << HSUSBD_GINTEN_EPAIEN_Pos) /*!< HSUSBD_T::GINTEN: EPAIEN Mask */ + +#define HSUSBD_GINTEN_EPBIEN_Pos (3) /*!< HSUSBD_T::GINTEN: EPBIEN Position */ +#define HSUSBD_GINTEN_EPBIEN_Msk (0x1ul << HSUSBD_GINTEN_EPBIEN_Pos) /*!< HSUSBD_T::GINTEN: EPBIEN Mask */ + +#define HSUSBD_GINTEN_EPCIEN_Pos (4) /*!< HSUSBD_T::GINTEN: EPCIEN Position */ +#define HSUSBD_GINTEN_EPCIEN_Msk (0x1ul << HSUSBD_GINTEN_EPCIEN_Pos) /*!< HSUSBD_T::GINTEN: EPCIEN Mask */ + +#define HSUSBD_GINTEN_EPDIEN_Pos (5) /*!< HSUSBD_T::GINTEN: EPDIEN Position */ +#define HSUSBD_GINTEN_EPDIEN_Msk (0x1ul << HSUSBD_GINTEN_EPDIEN_Pos) /*!< HSUSBD_T::GINTEN: EPDIEN Mask */ + +#define HSUSBD_GINTEN_EPEIEN_Pos (6) /*!< HSUSBD_T::GINTEN: EPEIEN Position */ +#define HSUSBD_GINTEN_EPEIEN_Msk (0x1ul << HSUSBD_GINTEN_EPEIEN_Pos) /*!< HSUSBD_T::GINTEN: EPEIEN Mask */ + +#define HSUSBD_GINTEN_EPFIEN_Pos (7) /*!< HSUSBD_T::GINTEN: EPFIEN Position */ +#define HSUSBD_GINTEN_EPFIEN_Msk (0x1ul << HSUSBD_GINTEN_EPFIEN_Pos) /*!< HSUSBD_T::GINTEN: EPFIEN Mask */ + +#define HSUSBD_GINTEN_EPGIEN_Pos (8) /*!< HSUSBD_T::GINTEN: EPGIEN Position */ +#define HSUSBD_GINTEN_EPGIEN_Msk (0x1ul << HSUSBD_GINTEN_EPGIEN_Pos) /*!< HSUSBD_T::GINTEN: EPGIEN Mask */ + +#define HSUSBD_GINTEN_EPHIEN_Pos (9) /*!< HSUSBD_T::GINTEN: EPHIEN Position */ +#define HSUSBD_GINTEN_EPHIEN_Msk (0x1ul << HSUSBD_GINTEN_EPHIEN_Pos) /*!< HSUSBD_T::GINTEN: EPHIEN Mask */ + +#define HSUSBD_GINTEN_EPIIEN_Pos (10) /*!< HSUSBD_T::GINTEN: EPIIEN Position */ +#define HSUSBD_GINTEN_EPIIEN_Msk (0x1ul << HSUSBD_GINTEN_EPIIEN_Pos) /*!< HSUSBD_T::GINTEN: EPIIEN Mask */ + +#define HSUSBD_GINTEN_EPJIEN_Pos (11) /*!< HSUSBD_T::GINTEN: EPJIEN Position */ +#define HSUSBD_GINTEN_EPJIEN_Msk (0x1ul << HSUSBD_GINTEN_EPJIEN_Pos) /*!< HSUSBD_T::GINTEN: EPJIEN Mask */ + +#define HSUSBD_GINTEN_EPKIEN_Pos (12) /*!< HSUSBD_T::GINTEN: EPKIEN Position */ +#define HSUSBD_GINTEN_EPKIEN_Msk (0x1ul << HSUSBD_GINTEN_EPKIEN_Pos) /*!< HSUSBD_T::GINTEN: EPKIEN Mask */ + +#define HSUSBD_GINTEN_EPLIEN_Pos (13) /*!< HSUSBD_T::GINTEN: EPLIEN Position */ +#define HSUSBD_GINTEN_EPLIEN_Msk (0x1ul << HSUSBD_GINTEN_EPLIEN_Pos) /*!< HSUSBD_T::GINTEN: EPLIEN Mask */ + +#define HSUSBD_BUSINTSTS_SOFIF_Pos (0) /*!< HSUSBD_T::BUSINTSTS: SOFIF Position */ +#define HSUSBD_BUSINTSTS_SOFIF_Msk (0x1ul << HSUSBD_BUSINTSTS_SOFIF_Pos) /*!< HSUSBD_T::BUSINTSTS: SOFIF Mask */ + +#define HSUSBD_BUSINTSTS_RSTIF_Pos (1) /*!< HSUSBD_T::BUSINTSTS: RSTIF Position */ +#define HSUSBD_BUSINTSTS_RSTIF_Msk (0x1ul << HSUSBD_BUSINTSTS_RSTIF_Pos) /*!< HSUSBD_T::BUSINTSTS: RSTIF Mask */ + +#define HSUSBD_BUSINTSTS_RESUMEIF_Pos (2) /*!< HSUSBD_T::BUSINTSTS: RESUMEIF Position */ +#define HSUSBD_BUSINTSTS_RESUMEIF_Msk (0x1ul << HSUSBD_BUSINTSTS_RESUMEIF_Pos) /*!< HSUSBD_T::BUSINTSTS: RESUMEIF Mask */ + +#define HSUSBD_BUSINTSTS_SUSPENDIF_Pos (3) /*!< HSUSBD_T::BUSINTSTS: SUSPENDIF Position*/ +#define HSUSBD_BUSINTSTS_SUSPENDIF_Msk (0x1ul << HSUSBD_BUSINTSTS_SUSPENDIF_Pos) /*!< HSUSBD_T::BUSINTSTS: SUSPENDIF Mask */ + +#define HSUSBD_BUSINTSTS_HISPDIF_Pos (4) /*!< HSUSBD_T::BUSINTSTS: HISPDIF Position */ +#define HSUSBD_BUSINTSTS_HISPDIF_Msk (0x1ul << HSUSBD_BUSINTSTS_HISPDIF_Pos) /*!< HSUSBD_T::BUSINTSTS: HISPDIF Mask */ + +#define HSUSBD_BUSINTSTS_DMADONEIF_Pos (5) /*!< HSUSBD_T::BUSINTSTS: DMADONEIF Position*/ +#define HSUSBD_BUSINTSTS_DMADONEIF_Msk (0x1ul << HSUSBD_BUSINTSTS_DMADONEIF_Pos) /*!< HSUSBD_T::BUSINTSTS: DMADONEIF Mask */ + +#define HSUSBD_BUSINTSTS_PHYCLKVLDIF_Pos (6) /*!< HSUSBD_T::BUSINTSTS: PHYCLKVLDIF Position*/ +#define HSUSBD_BUSINTSTS_PHYCLKVLDIF_Msk (0x1ul << HSUSBD_BUSINTSTS_PHYCLKVLDIF_Pos) /*!< HSUSBD_T::BUSINTSTS: PHYCLKVLDIF Mask */ + +#define HSUSBD_BUSINTSTS_VBUSDETIF_Pos (8) /*!< HSUSBD_T::BUSINTSTS: VBUSDETIF Position*/ +#define HSUSBD_BUSINTSTS_VBUSDETIF_Msk (0x1ul << HSUSBD_BUSINTSTS_VBUSDETIF_Pos) /*!< HSUSBD_T::BUSINTSTS: VBUSDETIF Mask */ + +#define HSUSBD_BUSINTEN_SOFIEN_Pos (0) /*!< HSUSBD_T::BUSINTEN: SOFIEN Position */ +#define HSUSBD_BUSINTEN_SOFIEN_Msk (0x1ul << HSUSBD_BUSINTEN_SOFIEN_Pos) /*!< HSUSBD_T::BUSINTEN: SOFIEN Mask */ + +#define HSUSBD_BUSINTEN_RSTIEN_Pos (1) /*!< HSUSBD_T::BUSINTEN: RSTIEN Position */ +#define HSUSBD_BUSINTEN_RSTIEN_Msk (0x1ul << HSUSBD_BUSINTEN_RSTIEN_Pos) /*!< HSUSBD_T::BUSINTEN: RSTIEN Mask */ + +#define HSUSBD_BUSINTEN_RESUMEIEN_Pos (2) /*!< HSUSBD_T::BUSINTEN: RESUMEIEN Position */ +#define HSUSBD_BUSINTEN_RESUMEIEN_Msk (0x1ul << HSUSBD_BUSINTEN_RESUMEIEN_Pos) /*!< HSUSBD_T::BUSINTEN: RESUMEIEN Mask */ + +#define HSUSBD_BUSINTEN_SUSPENDIEN_Pos (3) /*!< HSUSBD_T::BUSINTEN: SUSPENDIEN Position*/ +#define HSUSBD_BUSINTEN_SUSPENDIEN_Msk (0x1ul << HSUSBD_BUSINTEN_SUSPENDIEN_Pos) /*!< HSUSBD_T::BUSINTEN: SUSPENDIEN Mask */ + +#define HSUSBD_BUSINTEN_HISPDIEN_Pos (4) /*!< HSUSBD_T::BUSINTEN: HISPDIEN Position */ +#define HSUSBD_BUSINTEN_HISPDIEN_Msk (0x1ul << HSUSBD_BUSINTEN_HISPDIEN_Pos) /*!< HSUSBD_T::BUSINTEN: HISPDIEN Mask */ + +#define HSUSBD_BUSINTEN_DMADONEIEN_Pos (5) /*!< HSUSBD_T::BUSINTEN: DMADONEIEN Position*/ +#define HSUSBD_BUSINTEN_DMADONEIEN_Msk (0x1ul << HSUSBD_BUSINTEN_DMADONEIEN_Pos) /*!< HSUSBD_T::BUSINTEN: DMADONEIEN Mask */ + +#define HSUSBD_BUSINTEN_PHYCLKVLDIEN_Pos (6) /*!< HSUSBD_T::BUSINTEN: PHYCLKVLDIEN Position*/ +#define HSUSBD_BUSINTEN_PHYCLKVLDIEN_Msk (0x1ul << HSUSBD_BUSINTEN_PHYCLKVLDIEN_Pos) /*!< HSUSBD_T::BUSINTEN: PHYCLKVLDIEN Mask */ + +#define HSUSBD_BUSINTEN_VBUSDETIEN_Pos (8) /*!< HSUSBD_T::BUSINTEN: VBUSDETIEN Position*/ +#define HSUSBD_BUSINTEN_VBUSDETIEN_Msk (0x1ul << HSUSBD_BUSINTEN_VBUSDETIEN_Pos) /*!< HSUSBD_T::BUSINTEN: VBUSDETIEN Mask */ + +#define HSUSBD_OPER_RESUMEEN_Pos (0) /*!< HSUSBD_T::OPER: RESUMEEN Position */ +#define HSUSBD_OPER_RESUMEEN_Msk (0x1ul << HSUSBD_OPER_RESUMEEN_Pos) /*!< HSUSBD_T::OPER: RESUMEEN Mask */ + +#define HSUSBD_OPER_HISPDEN_Pos (1) /*!< HSUSBD_T::OPER: HISPDEN Position */ +#define HSUSBD_OPER_HISPDEN_Msk (0x1ul << HSUSBD_OPER_HISPDEN_Pos) /*!< HSUSBD_T::OPER: HISPDEN Mask */ + +#define HSUSBD_OPER_CURSPD_Pos (2) /*!< HSUSBD_T::OPER: CURSPD Position */ +#define HSUSBD_OPER_CURSPD_Msk (0x1ul << HSUSBD_OPER_CURSPD_Pos) /*!< HSUSBD_T::OPER: CURSPD Mask */ + +#define HSUSBD_FRAMECNT_MFRAMECNT_Pos (0) /*!< HSUSBD_T::FRAMECNT: MFRAMECNT Position */ +#define HSUSBD_FRAMECNT_MFRAMECNT_Msk (0x7ul << HSUSBD_FRAMECNT_MFRAMECNT_Pos) /*!< HSUSBD_T::FRAMECNT: MFRAMECNT Mask */ + +#define HSUSBD_FRAMECNT_FRAMECNT_Pos (3) /*!< HSUSBD_T::FRAMECNT: FRAMECNT Position */ +#define HSUSBD_FRAMECNT_FRAMECNT_Msk (0x7fful << HSUSBD_FRAMECNT_FRAMECNT_Pos) /*!< HSUSBD_T::FRAMECNT: FRAMECNT Mask */ + +#define HSUSBD_FADDR_FADDR_Pos (0) /*!< HSUSBD_T::FADDR: FADDR Position */ +#define HSUSBD_FADDR_FADDR_Msk (0x7ful << HSUSBD_FADDR_FADDR_Pos) /*!< HSUSBD_T::FADDR: FADDR Mask */ + +#define HSUSBD_TEST_TESTMODE_Pos (0) /*!< HSUSBD_T::TEST: TESTMODE Position */ +#define HSUSBD_TEST_TESTMODE_Msk (0x7ul << HSUSBD_TEST_TESTMODE_Pos) /*!< HSUSBD_T::TEST: TESTMODE Mask */ + +#define HSUSBD_CEPDAT_DAT_Pos (0) /*!< HSUSBD_T::CEPDAT: DAT Position */ +#define HSUSBD_CEPDAT_DAT_Msk (0xfffffffful << HSUSBD_CEPDAT_DAT_Pos) /*!< HSUSBD_T::CEPDAT: DAT Mask */ + +#define HSUSBD_CEPCTL_NAKCLR_Pos (0) /*!< HSUSBD_T::CEPCTL: NAKCLR Position */ +#define HSUSBD_CEPCTL_NAKCLR_Msk (0x1ul << HSUSBD_CEPCTL_NAKCLR_Pos) /*!< HSUSBD_T::CEPCTL: NAKCLR Mask */ + +#define HSUSBD_CEPCTL_STALLEN_Pos (1) /*!< HSUSBD_T::CEPCTL: STALLEN Position */ +#define HSUSBD_CEPCTL_STALLEN_Msk (0x1ul << HSUSBD_CEPCTL_STALLEN_Pos) /*!< HSUSBD_T::CEPCTL: STALLEN Mask */ + +#define HSUSBD_CEPCTL_ZEROLEN_Pos (2) /*!< HSUSBD_T::CEPCTL: ZEROLEN Position */ +#define HSUSBD_CEPCTL_ZEROLEN_Msk (0x1ul << HSUSBD_CEPCTL_ZEROLEN_Pos) /*!< HSUSBD_T::CEPCTL: ZEROLEN Mask */ + +#define HSUSBD_CEPCTL_FLUSH_Pos (3) /*!< HSUSBD_T::CEPCTL: FLUSH Position */ +#define HSUSBD_CEPCTL_FLUSH_Msk (0x1ul << HSUSBD_CEPCTL_FLUSH_Pos) /*!< HSUSBD_T::CEPCTL: FLUSH Mask */ + +#define HSUSBD_CEPINTEN_SETUPTKIEN_Pos (0) /*!< HSUSBD_T::CEPINTEN: SETUPTKIEN Position*/ +#define HSUSBD_CEPINTEN_SETUPTKIEN_Msk (0x1ul << HSUSBD_CEPINTEN_SETUPTKIEN_Pos) /*!< HSUSBD_T::CEPINTEN: SETUPTKIEN Mask */ + +#define HSUSBD_CEPINTEN_SETUPPKIEN_Pos (1) /*!< HSUSBD_T::CEPINTEN: SETUPPKIEN Position*/ +#define HSUSBD_CEPINTEN_SETUPPKIEN_Msk (0x1ul << HSUSBD_CEPINTEN_SETUPPKIEN_Pos) /*!< HSUSBD_T::CEPINTEN: SETUPPKIEN Mask */ + +#define HSUSBD_CEPINTEN_OUTTKIEN_Pos (2) /*!< HSUSBD_T::CEPINTEN: OUTTKIEN Position */ +#define HSUSBD_CEPINTEN_OUTTKIEN_Msk (0x1ul << HSUSBD_CEPINTEN_OUTTKIEN_Pos) /*!< HSUSBD_T::CEPINTEN: OUTTKIEN Mask */ + +#define HSUSBD_CEPINTEN_INTKIEN_Pos (3) /*!< HSUSBD_T::CEPINTEN: INTKIEN Position */ +#define HSUSBD_CEPINTEN_INTKIEN_Msk (0x1ul << HSUSBD_CEPINTEN_INTKIEN_Pos) /*!< HSUSBD_T::CEPINTEN: INTKIEN Mask */ + +#define HSUSBD_CEPINTEN_PINGIEN_Pos (4) /*!< HSUSBD_T::CEPINTEN: PINGIEN Position */ +#define HSUSBD_CEPINTEN_PINGIEN_Msk (0x1ul << HSUSBD_CEPINTEN_PINGIEN_Pos) /*!< HSUSBD_T::CEPINTEN: PINGIEN Mask */ + +#define HSUSBD_CEPINTEN_TXPKIEN_Pos (5) /*!< HSUSBD_T::CEPINTEN: TXPKIEN Position */ +#define HSUSBD_CEPINTEN_TXPKIEN_Msk (0x1ul << HSUSBD_CEPINTEN_TXPKIEN_Pos) /*!< HSUSBD_T::CEPINTEN: TXPKIEN Mask */ + +#define HSUSBD_CEPINTEN_RXPKIEN_Pos (6) /*!< HSUSBD_T::CEPINTEN: RXPKIEN Position */ +#define HSUSBD_CEPINTEN_RXPKIEN_Msk (0x1ul << HSUSBD_CEPINTEN_RXPKIEN_Pos) /*!< HSUSBD_T::CEPINTEN: RXPKIEN Mask */ + +#define HSUSBD_CEPINTEN_NAKIEN_Pos (7) /*!< HSUSBD_T::CEPINTEN: NAKIEN Position */ +#define HSUSBD_CEPINTEN_NAKIEN_Msk (0x1ul << HSUSBD_CEPINTEN_NAKIEN_Pos) /*!< HSUSBD_T::CEPINTEN: NAKIEN Mask */ + +#define HSUSBD_CEPINTEN_STALLIEN_Pos (8) /*!< HSUSBD_T::CEPINTEN: STALLIEN Position */ +#define HSUSBD_CEPINTEN_STALLIEN_Msk (0x1ul << HSUSBD_CEPINTEN_STALLIEN_Pos) /*!< HSUSBD_T::CEPINTEN: STALLIEN Mask */ + +#define HSUSBD_CEPINTEN_ERRIEN_Pos (9) /*!< HSUSBD_T::CEPINTEN: ERRIEN Position */ +#define HSUSBD_CEPINTEN_ERRIEN_Msk (0x1ul << HSUSBD_CEPINTEN_ERRIEN_Pos) /*!< HSUSBD_T::CEPINTEN: ERRIEN Mask */ + +#define HSUSBD_CEPINTEN_STSDONEIEN_Pos (10) /*!< HSUSBD_T::CEPINTEN: STSDONEIEN Position*/ +#define HSUSBD_CEPINTEN_STSDONEIEN_Msk (0x1ul << HSUSBD_CEPINTEN_STSDONEIEN_Pos) /*!< HSUSBD_T::CEPINTEN: STSDONEIEN Mask */ + +#define HSUSBD_CEPINTEN_BUFFULLIEN_Pos (11) /*!< HSUSBD_T::CEPINTEN: BUFFULLIEN Position*/ +#define HSUSBD_CEPINTEN_BUFFULLIEN_Msk (0x1ul << HSUSBD_CEPINTEN_BUFFULLIEN_Pos) /*!< HSUSBD_T::CEPINTEN: BUFFULLIEN Mask */ + +#define HSUSBD_CEPINTEN_BUFEMPTYIEN_Pos (12) /*!< HSUSBD_T::CEPINTEN: BUFEMPTYIEN Position*/ +#define HSUSBD_CEPINTEN_BUFEMPTYIEN_Msk (0x1ul << HSUSBD_CEPINTEN_BUFEMPTYIEN_Pos) /*!< HSUSBD_T::CEPINTEN: BUFEMPTYIEN Mask */ + +#define HSUSBD_CEPINTSTS_SETUPTKIF_Pos (0) /*!< HSUSBD_T::CEPINTSTS: SETUPTKIF Position*/ +#define HSUSBD_CEPINTSTS_SETUPTKIF_Msk (0x1ul << HSUSBD_CEPINTSTS_SETUPTKIF_Pos) /*!< HSUSBD_T::CEPINTSTS: SETUPTKIF Mask */ + +#define HSUSBD_CEPINTSTS_SETUPPKIF_Pos (1) /*!< HSUSBD_T::CEPINTSTS: SETUPPKIF Position*/ +#define HSUSBD_CEPINTSTS_SETUPPKIF_Msk (0x1ul << HSUSBD_CEPINTSTS_SETUPPKIF_Pos) /*!< HSUSBD_T::CEPINTSTS: SETUPPKIF Mask */ + +#define HSUSBD_CEPINTSTS_OUTTKIF_Pos (2) /*!< HSUSBD_T::CEPINTSTS: OUTTKIF Position */ +#define HSUSBD_CEPINTSTS_OUTTKIF_Msk (0x1ul << HSUSBD_CEPINTSTS_OUTTKIF_Pos) /*!< HSUSBD_T::CEPINTSTS: OUTTKIF Mask */ + +#define HSUSBD_CEPINTSTS_INTKIF_Pos (3) /*!< HSUSBD_T::CEPINTSTS: INTKIF Position */ +#define HSUSBD_CEPINTSTS_INTKIF_Msk (0x1ul << HSUSBD_CEPINTSTS_INTKIF_Pos) /*!< HSUSBD_T::CEPINTSTS: INTKIF Mask */ + +#define HSUSBD_CEPINTSTS_PINGIF_Pos (4) /*!< HSUSBD_T::CEPINTSTS: PINGIF Position */ +#define HSUSBD_CEPINTSTS_PINGIF_Msk (0x1ul << HSUSBD_CEPINTSTS_PINGIF_Pos) /*!< HSUSBD_T::CEPINTSTS: PINGIF Mask */ + +#define HSUSBD_CEPINTSTS_TXPKIF_Pos (5) /*!< HSUSBD_T::CEPINTSTS: TXPKIF Position */ +#define HSUSBD_CEPINTSTS_TXPKIF_Msk (0x1ul << HSUSBD_CEPINTSTS_TXPKIF_Pos) /*!< HSUSBD_T::CEPINTSTS: TXPKIF Mask */ + +#define HSUSBD_CEPINTSTS_RXPKIF_Pos (6) /*!< HSUSBD_T::CEPINTSTS: RXPKIF Position */ +#define HSUSBD_CEPINTSTS_RXPKIF_Msk (0x1ul << HSUSBD_CEPINTSTS_RXPKIF_Pos) /*!< HSUSBD_T::CEPINTSTS: RXPKIF Mask */ + +#define HSUSBD_CEPINTSTS_NAKIF_Pos (7) /*!< HSUSBD_T::CEPINTSTS: NAKIF Position */ +#define HSUSBD_CEPINTSTS_NAKIF_Msk (0x1ul << HSUSBD_CEPINTSTS_NAKIF_Pos) /*!< HSUSBD_T::CEPINTSTS: NAKIF Mask */ + +#define HSUSBD_CEPINTSTS_STALLIF_Pos (8) /*!< HSUSBD_T::CEPINTSTS: STALLIF Position */ +#define HSUSBD_CEPINTSTS_STALLIF_Msk (0x1ul << HSUSBD_CEPINTSTS_STALLIF_Pos) /*!< HSUSBD_T::CEPINTSTS: STALLIF Mask */ + +#define HSUSBD_CEPINTSTS_ERRIF_Pos (9) /*!< HSUSBD_T::CEPINTSTS: ERRIF Position */ +#define HSUSBD_CEPINTSTS_ERRIF_Msk (0x1ul << HSUSBD_CEPINTSTS_ERRIF_Pos) /*!< HSUSBD_T::CEPINTSTS: ERRIF Mask */ + +#define HSUSBD_CEPINTSTS_STSDONEIF_Pos (10) /*!< HSUSBD_T::CEPINTSTS: STSDONEIF Position*/ +#define HSUSBD_CEPINTSTS_STSDONEIF_Msk (0x1ul << HSUSBD_CEPINTSTS_STSDONEIF_Pos) /*!< HSUSBD_T::CEPINTSTS: STSDONEIF Mask */ + +#define HSUSBD_CEPINTSTS_BUFFULLIF_Pos (11) /*!< HSUSBD_T::CEPINTSTS: BUFFULLIF Position*/ +#define HSUSBD_CEPINTSTS_BUFFULLIF_Msk (0x1ul << HSUSBD_CEPINTSTS_BUFFULLIF_Pos) /*!< HSUSBD_T::CEPINTSTS: BUFFULLIF Mask */ + +#define HSUSBD_CEPINTSTS_BUFEMPTYIF_Pos (12) /*!< HSUSBD_T::CEPINTSTS: BUFEMPTYIF Position*/ +#define HSUSBD_CEPINTSTS_BUFEMPTYIF_Msk (0x1ul << HSUSBD_CEPINTSTS_BUFEMPTYIF_Pos) /*!< HSUSBD_T::CEPINTSTS: BUFEMPTYIF Mask */ + +#define HSUSBD_CEPTXCNT_TXCNT_Pos (0) /*!< HSUSBD_T::CEPTXCNT: TXCNT Position */ +#define HSUSBD_CEPTXCNT_TXCNT_Msk (0xfful << HSUSBD_CEPTXCNT_TXCNT_Pos) /*!< HSUSBD_T::CEPTXCNT: TXCNT Mask */ + +#define HSUSBD_CEPRXCNT_RXCNT_Pos (0) /*!< HSUSBD_T::CEPRXCNT: RXCNT Position */ +#define HSUSBD_CEPRXCNT_RXCNT_Msk (0xfful << HSUSBD_CEPRXCNT_RXCNT_Pos) /*!< HSUSBD_T::CEPRXCNT: RXCNT Mask */ + +#define HSUSBD_CEPDATCNT_DATCNT_Pos (0) /*!< HSUSBD_T::CEPDATCNT: DATCNT Position */ +#define HSUSBD_CEPDATCNT_DATCNT_Msk (0xfffful << HSUSBD_CEPDATCNT_DATCNT_Pos) /*!< HSUSBD_T::CEPDATCNT: DATCNT Mask */ + +#define HSUSBD_SETUP1_0_SETUP0_Pos (0) /*!< HSUSBD_T::SETUP1_0: SETUP0 Position */ +#define HSUSBD_SETUP1_0_SETUP0_Msk (0xfful << HSUSBD_SETUP1_0_SETUP0_Pos) /*!< HSUSBD_T::SETUP1_0: SETUP0 Mask */ + +#define HSUSBD_SETUP1_0_SETUP1_Pos (8) /*!< HSUSBD_T::SETUP1_0: SETUP1 Position */ +#define HSUSBD_SETUP1_0_SETUP1_Msk (0xfful << HSUSBD_SETUP1_0_SETUP1_Pos) /*!< HSUSBD_T::SETUP1_0: SETUP1 Mask */ + +#define HSUSBD_SETUP3_2_SETUP2_Pos (0) /*!< HSUSBD_T::SETUP3_2: SETUP2 Position */ +#define HSUSBD_SETUP3_2_SETUP2_Msk (0xfful << HSUSBD_SETUP3_2_SETUP2_Pos) /*!< HSUSBD_T::SETUP3_2: SETUP2 Mask */ + +#define HSUSBD_SETUP3_2_SETUP3_Pos (8) /*!< HSUSBD_T::SETUP3_2: SETUP3 Position */ +#define HSUSBD_SETUP3_2_SETUP3_Msk (0xfful << HSUSBD_SETUP3_2_SETUP3_Pos) /*!< HSUSBD_T::SETUP3_2: SETUP3 Mask */ + +#define HSUSBD_SETUP5_4_SETUP4_Pos (0) /*!< HSUSBD_T::SETUP5_4: SETUP4 Position */ +#define HSUSBD_SETUP5_4_SETUP4_Msk (0xfful << HSUSBD_SETUP5_4_SETUP4_Pos) /*!< HSUSBD_T::SETUP5_4: SETUP4 Mask */ + +#define HSUSBD_SETUP5_4_SETUP5_Pos (8) /*!< HSUSBD_T::SETUP5_4: SETUP5 Position */ +#define HSUSBD_SETUP5_4_SETUP5_Msk (0xfful << HSUSBD_SETUP5_4_SETUP5_Pos) /*!< HSUSBD_T::SETUP5_4: SETUP5 Mask */ + +#define HSUSBD_SETUP7_6_SETUP6_Pos (0) /*!< HSUSBD_T::SETUP7_6: SETUP6 Position */ +#define HSUSBD_SETUP7_6_SETUP6_Msk (0xfful << HSUSBD_SETUP7_6_SETUP6_Pos) /*!< HSUSBD_T::SETUP7_6: SETUP6 Mask */ + +#define HSUSBD_SETUP7_6_SETUP7_Pos (8) /*!< HSUSBD_T::SETUP7_6: SETUP7 Position */ +#define HSUSBD_SETUP7_6_SETUP7_Msk (0xfful << HSUSBD_SETUP7_6_SETUP7_Pos) /*!< HSUSBD_T::SETUP7_6: SETUP7 Mask */ + +#define HSUSBD_CEPBUFST_SADDR_Pos (0) /*!< HSUSBD_T::CEPBUFST: SADDR Position */ +#define HSUSBD_CEPBUFST_SADDR_Msk (0xffful << HSUSBD_CEPBUFST_SADDR_Pos) /*!< HSUSBD_T::CEPBUFST: SADDR Mask */ + +#define HSUSBD_CEPBUFEND_EADDR_Pos (0) /*!< HSUSBD_T::CEPBUFEND: EADDR Position */ +#define HSUSBD_CEPBUFEND_EADDR_Msk (0xffful << HSUSBD_CEPBUFEND_EADDR_Pos) /*!< HSUSBD_T::CEPBUFEND: EADDR Mask */ + +#define HSUSBD_DMACTL_EPNUM_Pos (0) /*!< HSUSBD_T::DMACTL: EPNUM Position */ +#define HSUSBD_DMACTL_EPNUM_Msk (0xful << HSUSBD_DMACTL_EPNUM_Pos) /*!< HSUSBD_T::DMACTL: EPNUM Mask */ + +#define HSUSBD_DMACTL_DMARD_Pos (4) /*!< HSUSBD_T::DMACTL: DMARD Position */ +#define HSUSBD_DMACTL_DMARD_Msk (0x1ul << HSUSBD_DMACTL_DMARD_Pos) /*!< HSUSBD_T::DMACTL: DMARD Mask */ + +#define HSUSBD_DMACTL_DMAEN_Pos (5) /*!< HSUSBD_T::DMACTL: DMAEN Position */ +#define HSUSBD_DMACTL_DMAEN_Msk (0x1ul << HSUSBD_DMACTL_DMAEN_Pos) /*!< HSUSBD_T::DMACTL: DMAEN Mask */ + +#define HSUSBD_DMACTL_SGEN_Pos (6) /*!< HSUSBD_T::DMACTL: SGEN Position */ +#define HSUSBD_DMACTL_SGEN_Msk (0x1ul << HSUSBD_DMACTL_SGEN_Pos) /*!< HSUSBD_T::DMACTL: SGEN Mask */ + +#define HSUSBD_DMACTL_DMARST_Pos (7) /*!< HSUSBD_T::DMACTL: DMARST Position */ +#define HSUSBD_DMACTL_DMARST_Msk (0x1ul << HSUSBD_DMACTL_DMARST_Pos) /*!< HSUSBD_T::DMACTL: DMARST Mask */ + +#define HSUSBD_DMACTL_SVINEP_Pos (8) /*!< HSUSBD_T::DMACTL: SVINEP Position */ +#define HSUSBD_DMACTL_SVINEP_Msk (0x1ul << HSUSBD_DMACTL_SVINEP_Pos) /*!< HSUSBD_T::DMACTL: SVINEP Mask */ + +#define HSUSBD_DMACNT_DMACNT_Pos (0) /*!< HSUSBD_T::DMACNT: DMACNT Position */ +#define HSUSBD_DMACNT_DMACNT_Msk (0xffffful << HSUSBD_DMACNT_DMACNT_Pos) /*!< HSUSBD_T::DMACNT: DMACNT Mask */ + +#define HSUSBD_EPDAT_EPDAT_Pos (0) /*!< HSUSBD_T::EPDAT: EPDAT Position */ +#define HSUSBD_EPDAT_EPDAT_Msk (0xfffffffful << HSUSBD_EPDAT_EPDAT_Pos) /*!< HSUSBD_T::EPDAT: EPDAT Mask */ + +#define HSUSBD_EPINTSTS_BUFFULLIF_Pos (0) /*!< HSUSBD_T::EPINTSTS: BUFFULLIF Position */ +#define HSUSBD_EPINTSTS_BUFFULLIF_Msk (0x1ul << HSUSBD_EPINTSTS_BUFFULLIF_Pos) /*!< HSUSBD_T::EPINTSTS: BUFFULLIF Mask */ + +#define HSUSBD_EPINTSTS_BUFEMPTYIF_Pos (1) /*!< HSUSBD_T::EPINTSTS: BUFEMPTYIF Position*/ +#define HSUSBD_EPINTSTS_BUFEMPTYIF_Msk (0x1ul << HSUSBD_EPINTSTS_BUFEMPTYIF_Pos) /*!< HSUSBD_T::EPINTSTS: BUFEMPTYIF Mask */ + +#define HSUSBD_EPINTSTS_SHORTTXIF_Pos (2) /*!< HSUSBD_T::EPINTSTS: SHORTTXIF Position */ +#define HSUSBD_EPINTSTS_SHORTTXIF_Msk (0x1ul << HSUSBD_EPINTSTS_SHORTTXIF_Pos) /*!< HSUSBD_T::EPINTSTS: SHORTTXIF Mask */ + +#define HSUSBD_EPINTSTS_TXPKIF_Pos (3) /*!< HSUSBD_T::EPINTSTS: TXPKIF Position */ +#define HSUSBD_EPINTSTS_TXPKIF_Msk (0x1ul << HSUSBD_EPINTSTS_TXPKIF_Pos) /*!< HSUSBD_T::EPINTSTS: TXPKIF Mask */ + +#define HSUSBD_EPINTSTS_RXPKIF_Pos (4) /*!< HSUSBD_T::EPINTSTS: RXPKIF Position */ +#define HSUSBD_EPINTSTS_RXPKIF_Msk (0x1ul << HSUSBD_EPINTSTS_RXPKIF_Pos) /*!< HSUSBD_T::EPINTSTS: RXPKIF Mask */ + +#define HSUSBD_EPINTSTS_OUTTKIF_Pos (5) /*!< HSUSBD_T::EPINTSTS: OUTTKIF Position */ +#define HSUSBD_EPINTSTS_OUTTKIF_Msk (0x1ul << HSUSBD_EPINTSTS_OUTTKIF_Pos) /*!< HSUSBD_T::EPINTSTS: OUTTKIF Mask */ + +#define HSUSBD_EPINTSTS_INTKIF_Pos (6) /*!< HSUSBD_T::EPINTSTS: INTKIF Position */ +#define HSUSBD_EPINTSTS_INTKIF_Msk (0x1ul << HSUSBD_EPINTSTS_INTKIF_Pos) /*!< HSUSBD_T::EPINTSTS: INTKIF Mask */ + +#define HSUSBD_EPINTSTS_PINGIF_Pos (7) /*!< HSUSBD_T::EPINTSTS: PINGIF Position */ +#define HSUSBD_EPINTSTS_PINGIF_Msk (0x1ul << HSUSBD_EPINTSTS_PINGIF_Pos) /*!< HSUSBD_T::EPINTSTS: PINGIF Mask */ + +#define HSUSBD_EPINTSTS_NAKIF_Pos (8) /*!< HSUSBD_T::EPINTSTS: NAKIF Position */ +#define HSUSBD_EPINTSTS_NAKIF_Msk (0x1ul << HSUSBD_EPINTSTS_NAKIF_Pos) /*!< HSUSBD_T::EPINTSTS: NAKIF Mask */ + +#define HSUSBD_EPINTSTS_STALLIF_Pos (9) /*!< HSUSBD_T::EPINTSTS: STALLIF Position */ +#define HSUSBD_EPINTSTS_STALLIF_Msk (0x1ul << HSUSBD_EPINTSTS_STALLIF_Pos) /*!< HSUSBD_T::EPINTSTS: STALLIF Mask */ + +#define HSUSBD_EPINTSTS_NYETIF_Pos (10) /*!< HSUSBD_T::EPINTSTS: NYETIF Position */ +#define HSUSBD_EPINTSTS_NYETIF_Msk (0x1ul << HSUSBD_EPINTSTS_NYETIF_Pos) /*!< HSUSBD_T::EPINTSTS: NYETIF Mask */ + +#define HSUSBD_EPINTSTS_ERRIF_Pos (11) /*!< HSUSBD_T::EPINTSTS: ERRIF Position */ +#define HSUSBD_EPINTSTS_ERRIF_Msk (0x1ul << HSUSBD_EPINTSTS_ERRIF_Pos) /*!< HSUSBD_T::EPINTSTS: ERRIF Mask */ + +#define HSUSBD_EPINTSTS_SHORTRXIF_Pos (12) /*!< HSUSBD_T::EPINTSTS: SHORTRXIF Position */ +#define HSUSBD_EPINTSTS_SHORTRXIF_Msk (0x1ul << HSUSBD_EPINTSTS_SHORTRXIF_Pos) /*!< HSUSBD_T::EPINTSTS: SHORTRXIF Mask */ + +#define HSUSBD_EPINTEN_BUFFULLIEN_Pos (0) /*!< HSUSBD_T::EPINTEN: BUFFULLIEN Position */ +#define HSUSBD_EPINTEN_BUFFULLIEN_Msk (0x1ul << HSUSBD_EPINTEN_BUFFULLIEN_Pos) /*!< HSUSBD_T::EPINTEN: BUFFULLIEN Mask */ + +#define HSUSBD_EPINTEN_BUFEMPTYIEN_Pos (1) /*!< HSUSBD_T::EPINTEN: BUFEMPTYIEN Position*/ +#define HSUSBD_EPINTEN_BUFEMPTYIEN_Msk (0x1ul << HSUSBD_EPINTEN_BUFEMPTYIEN_Pos) /*!< HSUSBD_T::EPINTEN: BUFEMPTYIEN Mask */ + +#define HSUSBD_EPINTEN_SHORTTXIEN_Pos (2) /*!< HSUSBD_T::EPINTEN: SHORTTXIEN Position */ +#define HSUSBD_EPINTEN_SHORTTXIEN_Msk (0x1ul << HSUSBD_EPINTEN_SHORTTXIEN_Pos) /*!< HSUSBD_T::EPINTEN: SHORTTXIEN Mask */ + +#define HSUSBD_EPINTEN_TXPKIEN_Pos (3) /*!< HSUSBD_T::EPINTEN: TXPKIEN Position */ +#define HSUSBD_EPINTEN_TXPKIEN_Msk (0x1ul << HSUSBD_EPINTEN_TXPKIEN_Pos) /*!< HSUSBD_T::EPINTEN: TXPKIEN Mask */ + +#define HSUSBD_EPINTEN_RXPKIEN_Pos (4) /*!< HSUSBD_T::EPINTEN: RXPKIEN Position */ +#define HSUSBD_EPINTEN_RXPKIEN_Msk (0x1ul << HSUSBD_EPINTEN_RXPKIEN_Pos) /*!< HSUSBD_T::EPINTEN: RXPKIEN Mask */ + +#define HSUSBD_EPINTEN_OUTTKIEN_Pos (5) /*!< HSUSBD_T::EPINTEN: OUTTKIEN Position */ +#define HSUSBD_EPINTEN_OUTTKIEN_Msk (0x1ul << HSUSBD_EPINTEN_OUTTKIEN_Pos) /*!< HSUSBD_T::EPINTEN: OUTTKIEN Mask */ + +#define HSUSBD_EPINTEN_INTKIEN_Pos (6) /*!< HSUSBD_T::EPINTEN: INTKIEN Position */ +#define HSUSBD_EPINTEN_INTKIEN_Msk (0x1ul << HSUSBD_EPINTEN_INTKIEN_Pos) /*!< HSUSBD_T::EPINTEN: INTKIEN Mask */ + +#define HSUSBD_EPINTEN_PINGIEN_Pos (7) /*!< HSUSBD_T::EPINTEN: PINGIEN Position */ +#define HSUSBD_EPINTEN_PINGIEN_Msk (0x1ul << HSUSBD_EPINTEN_PINGIEN_Pos) /*!< HSUSBD_T::EPINTEN: PINGIEN Mask */ + +#define HSUSBD_EPINTEN_NAKIEN_Pos (8) /*!< HSUSBD_T::EPINTEN: NAKIEN Position */ +#define HSUSBD_EPINTEN_NAKIEN_Msk (0x1ul << HSUSBD_EPINTEN_NAKIEN_Pos) /*!< HSUSBD_T::EPINTEN: NAKIEN Mask */ + +#define HSUSBD_EPINTEN_STALLIEN_Pos (9) /*!< HSUSBD_T::EPINTEN: STALLIEN Position */ +#define HSUSBD_EPINTEN_STALLIEN_Msk (0x1ul << HSUSBD_EPINTEN_STALLIEN_Pos) /*!< HSUSBD_T::EPINTEN: STALLIEN Mask */ + +#define HSUSBD_EPINTEN_NYETIEN_Pos (10) /*!< HSUSBD_T::EPINTEN: NYETIEN Position */ +#define HSUSBD_EPINTEN_NYETIEN_Msk (0x1ul << HSUSBD_EPINTEN_NYETIEN_Pos) /*!< HSUSBD_T::EPINTEN: NYETIEN Mask */ + +#define HSUSBD_EPINTEN_ERRIEN_Pos (11) /*!< HSUSBD_T::EPINTEN: ERRIEN Position */ +#define HSUSBD_EPINTEN_ERRIEN_Msk (0x1ul << HSUSBD_EPINTEN_ERRIEN_Pos) /*!< HSUSBD_T::EPINTEN: ERRIEN Mask */ + +#define HSUSBD_EPINTEN_SHORTRXIEN_Pos (12) /*!< HSUSBD_T::EPINTEN: SHORTRXIEN Position */ +#define HSUSBD_EPINTEN_SHORTRXIEN_Msk (0x1ul << HSUSBD_EPINTEN_SHORTRXIEN_Pos) /*!< HSUSBD_T::EPINTEN: SHORTRXIEN Mask */ + +#define HSUSBD_EPDATCNT_DATCNT_Pos (0) /*!< HSUSBD_T::EPDATCNT: DATCNT Position */ +#define HSUSBD_EPDATCNT_DATCNT_Msk (0xfffful << HSUSBD_EPDATCNT_DATCNT_Pos) /*!< HSUSBD_T::EPDATCNT: DATCNT Mask */ + +#define HSUSBD_EPDATCNT_DMALOOP_Pos (16) /*!< HSUSBD_T::EPDATCNT: DMALOOP Position */ +#define HSUSBD_EPDATCNT_DMALOOP_Msk (0x7ffful << HSUSBD_EPDATCNT_DMALOOP_Pos) /*!< HSUSBD_T::EPDATCNT: DMALOOP Mask */ + +#define HSUSBD_EPRSPCTL_FLUSH_Pos (0) /*!< HSUSBD_T::EPRSPCTL: FLUSH Position */ +#define HSUSBD_EPRSPCTL_FLUSH_Msk (0x1ul << HSUSBD_EPRSPCTL_FLUSH_Pos) /*!< HSUSBD_T::EPRSPCTL: FLUSH Mask */ + +#define HSUSBD_EPRSPCTL_MODE_Pos (1) /*!< HSUSBD_T::EPRSPCTL: MODE Position */ +#define HSUSBD_EPRSPCTL_MODE_Msk (0x3ul << HSUSBD_EPRSPCTL_MODE_Pos) /*!< HSUSBD_T::EPRSPCTL: MODE Mask */ + +#define HSUSBD_EPRSPCTL_TOGGLE_Pos (3) /*!< HSUSBD_T::EPRSPCTL: TOGGLE Position */ +#define HSUSBD_EPRSPCTL_TOGGLE_Msk (0x1ul << HSUSBD_EPRSPCTL_TOGGLE_Pos) /*!< HSUSBD_T::EPRSPCTL: TOGGLE Mask */ + +#define HSUSBD_EPRSPCTL_HALT_Pos (4) /*!< HSUSBD_T::EPRSPCTL: HALT Position */ +#define HSUSBD_EPRSPCTL_HALT_Msk (0x1ul << HSUSBD_EPRSPCTL_HALT_Pos) /*!< HSUSBD_T::EPRSPCTL: HALT Mask */ + +#define HSUSBD_EPRSPCTL_ZEROLEN_Pos (5) /*!< HSUSBD_T::EPRSPCTL: ZEROLEN Position */ +#define HSUSBD_EPRSPCTL_ZEROLEN_Msk (0x1ul << HSUSBD_EPRSPCTL_ZEROLEN_Pos) /*!< HSUSBD_T::EPRSPCTL: ZEROLEN Mask */ + +#define HSUSBD_EPRSPCTL_SHORTTXEN_Pos (6) /*!< HSUSBD_T::EPRSPCTL: SHORTTXEN Position */ +#define HSUSBD_EPRSPCTL_SHORTTXEN_Msk (0x1ul << HSUSBD_EPRSPCTL_SHORTTXEN_Pos) /*!< HSUSBD_T::EPRSPCTL: SHORTTXEN Mask */ + +#define HSUSBD_EPRSPCTL_DISBUF_Pos (7) /*!< HSUSBD_T::EPRSPCTL: DISBUF Position */ +#define HSUSBD_EPRSPCTL_DISBUF_Msk (0x1ul << HSUSBD_EPRSPCTL_DISBUF_Pos) /*!< HSUSBD_T::EPRSPCTL: DISBUF Mask */ + +#define HSUSBD_EPMPS_EPMPS_Pos (0) /*!< HSUSBD_T::EPMPS: EPMPS Position */ +#define HSUSBD_EPMPS_EPMPS_Msk (0x7fful << HSUSBD_EPMPS_EPMPS_Pos) /*!< HSUSBD_T::EPMPS: EPMPS Mask */ + +#define HSUSBD_EPTXCNT_TXCNT_Pos (0) /*!< HSUSBD_T::EPTXCNT: TXCNT Position */ +#define HSUSBD_EPTXCNT_TXCNT_Msk (0x7fful << HSUSBD_EPTXCNT_TXCNT_Pos) /*!< HSUSBD_T::EPTXCNT: TXCNT Mask */ + +#define HSUSBD_EPCFG_EPEN_Pos (0) /*!< HSUSBD_T::EPCFG: EPEN Position */ +#define HSUSBD_EPCFG_EPEN_Msk (0x1ul << HSUSBD_EPCFG_EPEN_Pos) /*!< HSUSBD_T::EPCFG: EPEN Mask */ + +#define HSUSBD_EPCFG_EPTYPE_Pos (1) /*!< HSUSBD_T::EPCFG: EPTYPE Position */ +#define HSUSBD_EPCFG_EPTYPE_Msk (0x3ul << HSUSBD_EPCFG_EPTYPE_Pos) /*!< HSUSBD_T::EPCFG: EPTYPE Mask */ + +#define HSUSBD_EPCFG_EPDIR_Pos (3) /*!< HSUSBD_T::EPCFG: EPDIR Position */ +#define HSUSBD_EPCFG_EPDIR_Msk (0x1ul << HSUSBD_EPCFG_EPDIR_Pos) /*!< HSUSBD_T::EPCFG: EPDIR Mask */ + +#define HSUSBD_EPCFG_EPNUM_Pos (4) /*!< HSUSBD_T::EPCFG: EPNUM Position */ +#define HSUSBD_EPCFG_EPNUM_Msk (0xful << HSUSBD_EPCFG_EPNUM_Pos) /*!< HSUSBD_T::EPCFG: EPNUM Mask */ + +#define HSUSBD_EPBUFST_SADDR_Pos (0) /*!< HSUSBD_T::EPBUFST: SADDR Position */ +#define HSUSBD_EPBUFST_SADDR_Msk (0xffful << HSUSBD_EPBUFST_SADDR_Pos) /*!< HSUSBD_T::EPBUFST: SADDR Mask */ + +#define HSUSBD_EPBUFEND_EADDR_Pos (0) /*!< HSUSBD_T::EPBUFEND: EADDR Position */ +#define HSUSBD_EPBUFEND_EADDR_Msk (0xffful << HSUSBD_EPBUFEND_EADDR_Pos) /*!< HSUSBD_T::EPBUFEND: EADDR Mask */ + +#define HSUSBD_DMAADDR_DMAADDR_Pos (0) /*!< HSUSBD_T::DMAADDR: DMAADDR Position */ +#define HSUSBD_DMAADDR_DMAADDR_Msk (0xfffffffful << HSUSBD_DMAADDR_DMAADDR_Pos) /*!< HSUSBD_T::DMAADDR: DMAADDR Mask */ + +#define HSUSBD_PHYCTL_DPPUEN_Pos (8) /*!< HSUSBD_T::PHYCTL: DPPUEN Position */ +#define HSUSBD_PHYCTL_DPPUEN_Msk (0x1ul << HSUSBD_PHYCTL_DPPUEN_Pos) /*!< HSUSBD_T::PHYCTL: DPPUEN Mask */ + +#define HSUSBD_PHYCTL_PHYEN_Pos (9) /*!< HSUSBD_T::PHYCTL: PHYEN Position */ +#define HSUSBD_PHYCTL_PHYEN_Msk (0x1ul << HSUSBD_PHYCTL_PHYEN_Pos) /*!< HSUSBD_T::PHYCTL: PHYEN Mask */ + +#define HSUSBD_PHYCTL_WKEN_Pos (24) /*!< HSUSBD_T::PHYCTL: WKEN Position */ +#define HSUSBD_PHYCTL_WKEN_Msk (0x1ul << HSUSBD_PHYCTL_WKEN_Pos) /*!< HSUSBD_T::PHYCTL: WKEN Mask */ + +#define HSUSBD_PHYCTL_VBUSDET_Pos (31) /*!< HSUSBD_T::PHYCTL: VBUSDET Position */ +#define HSUSBD_PHYCTL_VBUSDET_Msk (0x1ul << HSUSBD_PHYCTL_VBUSDET_Pos) /*!< HSUSBD_T::PHYCTL: VBUSDET Mask */ + +/**@}*/ /* HSUSBD_CONST */ +/**@}*/ /* end of HSUSBD register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __HSUSBD_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/hsusbh_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/hsusbh_reg.h new file mode 100644 index 00000000000..57cc5d03760 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/hsusbh_reg.h @@ -0,0 +1,653 @@ +/**************************************************************************//** + * @file hsusbh_reg.h + * @version V1.00 + * @brief HSUSBH register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __HSUSBH_REG_H__ +#define __HSUSBH_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup HSUSBH High Speed USB Host Controller (HSUSBH) + Memory Mapped Structure for HSUSBH Controller +@{ */ + +typedef struct +{ + + + /** + * @var HSUSBH_T::EHCVNR + * Offset: 0x00 EHCI Version Number Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |CRLEN |Capability Registers Length + * | | |This register is used as an offset to add to register base to find the beginning of the Operational Register Space. + * |[31:16] |VERSION |Host Controller Interface Version Number + * | | |This is a two-byte register containing a BCD encoding of the EHCI revision number supported by this host controller + * | | |The most significant byte of this register represents a major revision and the least significant byte is the minor revision. + * @var HSUSBH_T::EHCSPR + * Offset: 0x04 EHCI Structural Parameters Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |N_PORTS |Number of Physical Downstream Ports + * | | |This field specifies the number of physical downstream ports implemented on this host controller + * | | |The value of this field determines how many port registers are addressable in the Operational Register Space (see Table 2-8) + * | | |Valid values are in the range of 1H to FH. + * | | |A zero in this field is undefined. + * |[4] |PPC |Port Power Control + * | | |This field indicates whether the host controller implementation includes port power control + * | | |A one in this bit indicates the ports have port power switches + * | | |A zero in this bit indicates the port do not have port power stitches + * | | |The value of this field affects the functionality of the Port Power field in each port status and control register. + * |[11:8] |N_PCC |Number of Ports Per Companion Controller + * | | |This field indicates the number of ports supported per companion host controller + * | | |It is used to indicate the port routing configuration to system software. + * | | |For example, if N_PORTS has a value of 6 and N_CC has a value of 2 then N_PCC could have a value of 3 + * | | |The convention is that the first N_PCC ports are assumed to be routed to companion controller 1, the next N_PCC ports to companion controller 2, etc + * | | |In the previous example, the N_PCC could have been 4, where the first 4 are routed to companion controller 1 and the last two are routed to companion controller 2. + * | | |The number in this field must be consistent with N_PORTS and N_CC. + * |[15:12] |N_CC |Number of Companion Controller + * | | |This field indicates the number of companion controllers associated with this USB 2.0 host controller. + * | | |A zero in this field indicates there are no companion host controllers + * | | |Port-ownership hand-off is not supported + * | | |Only high-speed devices are supported on the host controller root ports. + * | | |A value larger than zero in this field indicates there are companion USB 1.1 host controller(s) + * | | |Port-ownership hand-offs are supported + * | | |High, Full- and Low-speed devices are supported on the host controller root ports. + * @var HSUSBH_T::EHCCPR + * Offset: 0x08 EHCI Capability Parameters Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |AC64 |64-bit Addressing Capability + * | | |0 = Data structure using 32-bit address memory pointers. + * |[1] |PFLF |Programmable Frame List Flag + * | | |0 = System software must use a frame list length of 1024 elements with this EHCI host controller. + * |[2] |ASPC |Asynchronous Schedule Park Capability + * | | |0 = This EHCI host controller doesn't support park feature of high-speed queue heads in the Asynchronous Schedule. + * |[7:4] |IST |Isochronous Scheduling Threshold + * | | |This field indicates, relative to the current position of the executing host controller, where software can reliably update the isochronous schedule. + * | | |When bit [7] is zero, the value of the least significant 3 bits indicates the number of micro-frames a host controller can hold a set of isochronous data structures (one or more) before flushing the state. + * |[15:8] |EECP |EHCI Extended Capabilities Pointer (EECP) + * | | |0 = No extended capabilities are implemented. + * @var HSUSBH_T::UCMDR + * Offset: 0x20 USB Command Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |RUN |Run/Stop (R/W) + * | | |When set to a 1, the Host Controller proceeds with execution of the schedule + * | | |The Host Controller continues execution as long as this bit is set to a 1 + * | | |When this bit is set to 0, the Host Controller completes the current and any actively pipelined transactions on the USB and then halts + * | | |The Host Controller must halt within 16 micro-frames after software clears the Run bit + * | | |The HC Halted bit in the status register indicates when the Host Controller has finished its pending pipelined transactions and has entered the stopped state + * | | |Software must not write a one to this field unless the host controller is in the Halted state (i.e. + * | | |HCHalted in the USBSTS register is a one) + * | | |Doing so will yield undefined results. + * | | |0 = Stop. + * | | |1 = Run. + * |[1] |HCRST |Host Controller Reset (HCRESET) (R/W) + * | | |This control bit is used by software to reset the host controller + * | | |The effects of this on Root Hub registers are similar to a Chip Hardware Reset. + * | | |When software writes a one to this bit, the Host Controller resets its internal pipelines, timers, counters, state machines, etc + * | | |to their initial value + * | | |Any transaction currently in progress on USB is immediately terminated + * | | |A USB reset is not driven on downstream ports. + * | | |All operational registers, including port registers and port state machines are set to their initial values + * | | |Port ownership reverts to the companion host controller(s), with the side effects + * | | |Software must reinitialize the host controller in order to return the host controller to an operational state. + * | | |This bit is set to zero by the Host Controller when the reset process is complete + * | | |Software cannot terminate the reset process early by writing a zero to this register. + * | | |Software should not set this bit to a one when the HCHalted bit in the USBSTS register is a zero + * | | |Attempting to reset an actively running host controller will result in undefined behavior. + * |[3:2] |FLSZ |Frame List Size (R/W or RO) + * | | |This field is R/W only if Programmable Frame List Flag in the HCCPARAMS registers is set to a one + * | | |This field specifies the size of the frame list + * | | |The size the frame list controls which bits in the Frame Index Register should be used for the Frame List Current index + * | | |Values mean: + * | | |00 = 1024 elements (4096 bytes) Default value. + * | | |01 = 512 elements (2048 bytes). + * | | |10 = 256 elements (1024 bytes) u2013 for resource-constrained environment. + * | | |11 = Reserved. + * |[4] |PSEN |Periodic Schedule Enable (R/W) + * | | |This bit controls whether the host controller skips processing the Periodic Schedule. Values mean: + * | | |0 = Do not process the Periodic Schedule. + * | | |1 = Use the PERIODICLISTBASE register to access the Periodic Schedule. + * |[5] |ASEN |Asynchronous Schedule Enable (R/W) + * | | |This bit controls whether the host controller skips processing the Asynchronous Schedule. Values mean: + * | | |0 = Do not process the Asynchronous Schedule. + * | | |1 = Use the ASYNCLISTADDR register to access the Asynchronous Schedule. + * |[6] |IAAD |Interrupt on Asynchronous Advance Doorbell (R/W) + * | | |This bit is used as a doorbell by software to tell the host controller to issue an interrupt the next time it advances asynchronous schedule + * | | |Software must write a 1 to this bit to ring the doorbell. + * | | |When the host controller has evicted all appropriate cached schedule state, it sets the Interrupt on Asynchronous Advance status bit in the USBSTS register + * | | |If the Interrupt on Asynchronous Advance Enable bit in the USBINTR register is a one then the host controller will assert an interrupt at the next interrupt threshold. + * | | |The host controller sets this bit to a zero after it has set the Interrupt on Asynchronous Advance status bit in the USBSTS register to a one. + * | | |Software should not write a one to this bit when the asynchronous schedule is disabled + * | | |Doing so will yield undefined results. + * |[23:16] |ITC |Interrupt Threshold Control (R/W) + * | | |This field is used by system software to select the maximum rate at which the host controller will issue interrupts + * | | |The only valid values are defined below + * | | |If software writes an invalid value to this register, the results are undefined + * | | |Value Maximum Interrupt Interval + * | | |0x00 = Reserved. + * | | |0x01 = 1 micro-frame. + * | | |0x02 = 2 micro-frames. + * | | |0x04 = 4 micro-frames. + * | | |0x08 = 8 micro-frames (default, equates to 1 ms). + * | | |0x10 = 16 micro-frames (2 ms). + * | | |0x20 = 32 micro-frames (4 ms). + * | | |0x40 = 64 micro-frames (8 ms). + * | | |Any other value in this register yields undefined results. + * | | |Software modifications to this bit while HCHalted bit is equal to zero results in undefined behavior. + * @var HSUSBH_T::USTSR + * Offset: 0x24 USB Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |USBINT |USB Interrupt (USBINT) (R/WC) + * | | |The Host Controller sets this bit to 1 on the completion of a USB transaction, which results in the retirement of a Transfer Descriptor that had its IOC bit set. + * | | |The Host Controller also sets this bit to 1 when a short packet is detected (actual number of bytes received was less than the expected number of bytes). + * |[1] |UERRINT |USB Error Interrupt (USBERRINT) (R/WC) + * | | |The Host Controller sets this bit to 1 when completion of a USB transaction results in an error condition (e.g., error counter underflow) + * | | |If the TD on which the error interrupt occurred also had its IOC bit set, both this bit and USBINT bit are set. + * |[2] |PCD |Port Change Detect (R/WC) + * | | |The Host Controller sets this bit to a one when any port for which the Port Owner bit is set to zero has a change bit transition from a zero to a one or a Force Port Resume bit transition from a zero to a one as a result of a J-K transition detected on a suspended port + * | | |This bit will also be set as a result of the Connect Status Change being set to a one after system software has relinquished ownership of a connected port by writing a one to a port's Port Owner bit. + * | | |This bit is allowed to be maintained in the Auxiliary power well + * | | |Alternatively, it is also acceptable that on a D3 to D0 transition of the EHCI HC device, this bit is loaded with the OR of all of the PORTSC change bits (including: Force port resume, over-current change, enable/disable change and connect status change). + * |[3] |FLR |Frame List Rollover (R/WC) + * | | |The Host Controller sets this bit to a one when the Frame List Index rolls over from its maximum value to zero + * | | |The exact value at which the rollover occurs depends on the frame list size + * | | |For example, if the frame list size (as programmed in the Frame List Size field of the USBCMD register) is 1024, the Frame Index Register rolls over every time FRINDEX[13] toggles + * | | |Similarly, if the size is 512, the Host Controller sets this bit to a one every time FRINDEX[12] toggles. + * |[4] |HSERR |Host System Error (R/WC) + * | | |The Host Controller sets this bit to 1 when a serious error occurs during a host system access involving the Host Controller module. + * |[5] |IAA |Interrupt on Asynchronous Advance (R/WC) + * | | |System software can force the host controller to issue an interrupt the next time the host controller advances the asynchronous schedule by writing a one to the Interrupt on Asynchronous Advance Doorbell bit in the USBCMD register + * | | |This status bit indicates the assertion of that interrupt source. + * |[12] |HCHalted |HCHalted (RO) + * | | |This bit is a zero whenever the Run/Stop bit is a one + * | | |The Host Controller sets this bit to one after it has stopped executing as a result of the Run/Stop bit being set to 0, either by software or by the Host Controller hardware (e.g. + * | | |internal error). + * |[13] |RECLA |Reclamation (RO) + * | | |This is a read-only status bit, which is used to detect an empty asynchronous schedule. + * |[14] |PSS |Periodic Schedule Status (RO) + * | | |The bit reports the current real status of the Periodic Schedule + * | | |If this bit is a zero then the status of the Periodic Schedule is disabled + * | | |If this bit is a one then the status of the Periodic Schedule is enabled + * | | |The Host Controller is not required to immediately disable or enable the Periodic Schedule when software transitions the Periodic Schedule Enable bit in the USBCMD register + * | | |When this bit and the Periodic Schedule Enable bit are the same value, the Periodic Schedule is either enabled (1) or disabled (0). + * |[15] |ASS |Asynchronous Schedule Status (RO) + * | | |The bit reports the current real status of the Asynchronous Schedule + * | | |If this bit is a zero then the status of them Asynchronous Schedule is disabled + * | | |If this bit is a one then the status of the Asynchronous Schedule is enabled + * | | |The Host Controller is not required to immediately disable or enable the Asynchronous Schedule when software transitions the Asynchronous Schedule Enable bit in the USBCMD register + * | | |When this bit and the Asynchronous Schedule Enable bit are the same value, the Asynchronous Schedule is either enabled (1) or disabled (0). + * @var HSUSBH_T::UIENR + * Offset: 0x28 USB Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |USBIEN |USB Interrupt Enable or Disable Bit + * | | |When this bit is a one, and the USBINT bit in the USBSTS register is a one, the host controller will issue an interrupt at the next interrupt threshold + * | | |The interrupt is acknowledged by software clearing the USBINT bit. + * | | |0 = USB interrupt Disabled. + * | | |1 = USB interrupt Enabled. + * |[1] |UERRIEN |USB Error Interrupt Enable or Disable Bit + * | | |When this bit is a one, and the USBERRINT bit in the USBSTS register is a one, the host t controller will issue an interrupt at the next interrupt threshold + * | | |The interrupt is acknowledged by software clearing the USBERRINT bit. + * | | |0 = USB Error interrupt Disabled. + * | | |1 = USB Error interrupt Enabled. + * |[2] |PCIEN |Port Change Interrupt Enable or Disable Bit + * | | |When this bit is a one, and the Port Change Detect bit in the USBSTS register is a one, the host controller will issue an interrupt + * | | |The interrupt is acknowledged by software clearing the Port Change Detect bit. + * | | |0 = Port Change interrupt Disabled. + * | | |1 = Port Change interrupt Enabled. + * |[3] |FLREN |Frame List Rollover Enable or Disable Bit + * | | |When this bit is a one, and the Frame List Rollover bit in the USBSTS register is a one, the host controller will issue an interrupt + * | | |The interrupt is acknowledged by software clearing the Frame List Rollover bit. + * | | |0 = Frame List Rollover interrupt Disabled. + * | | |1 = Frame List Rollover interrupt Enabled. + * |[4] |HSERREN |Host System Error Enable or Disable Bit + * | | |When this bit is a one, and the Host System Error Status bit in the USBSTS register is a one, the host controller will issue an interrupt + * | | |The interrupt is acknowledged by software clearing the Host System Error bit. + * | | |0 = Host System Error interrupt Disabled. + * | | |1 = Host System Error interrupt Enabled. + * |[5] |IAAEN |Interrupt on Asynchronous Advance Enable or Disable Bit + * | | |When this bit is a one, and the Interrupt on Asynchronous Advance bit in the USBSTS register is a one, the host controller will issue an interrupt at the next interrupt threshold + * | | |The interrupt is acknowledged by software clearing the Interrupt on Asynchronous Advance bit. + * | | |0 = Interrupt on Asynchronous Advance Disabled. + * | | |1 = Interrupt on Asynchronous Advance Enabled. + * @var HSUSBH_T::UFINDR + * Offset: 0x2C USB Frame Index Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[13:0] |FI |Frame Index + * | | |The value in this register increment at the end of each time frame (e.g. + * | | |micro-frame) + * | | |Bits [N:3] are used for the Frame List current index + * | | |This means that each location of the frame list is accessed 8 times (frames or micro-frames) before moving to the next index + * | | |The following illustrates values of N based on the value of the Frame List Size field in the USBCMD register. + * | | |FLSZ (UCMDR[3:2] Number Elements N + * | | |0x0 1024 12 + * | | |0x1 512 11 + * | | |0x2 256 10 + * | | |0x3 Reserved + * @var HSUSBH_T::UPFLBAR + * Offset: 0x34 USB Periodic Frame List Base Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:12] |BADDR |Base Address + * | | |These bits correspond to memory address signals [31:12], respectively. + * @var HSUSBH_T::UCALAR + * Offset: 0x38 USB Current Asynchronous List Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:5] |LPL |Link Pointer Low (LPL) + * | | |These bits correspond to memory address signals [31:5], respectively + * | | |This field may only reference a Queue Head (QH). + * @var HSUSBH_T::UASSTR + * Offset: 0x3C USB Asynchronous Schedule Sleep Timer Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[11:0] |ASSTMR |Asynchronous Schedule Sleep Timer + * | | |This field defines the AsyncSchedSleepTime of EHCI spec. + * | | |The asynchronous schedule sleep timer is used to control how often the host controller fetches asynchronous schedule list from system memory while the asynchronous schedule is empty. + * | | |The default value of this timer is 12'hBD6 + * | | |Because this timer is implemented in UTMI clock (30MHz) domain, the default sleeping time will be about 100us. + * @var HSUSBH_T::UCFGR + * Offset: 0x60 USB Configure Flag Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CF |Configure Flag (CF) + * | | |Host software sets this bit as the last action in its process of configuring the Host Controller + * | | |This bit controls the default port-routing control logic + * | | |Bit values and side-effects are listed below. + * | | |0 = Port routing control logic default-routes each port to an implementation dependent classic host controller. + * | | |1 = Port routing control logic default-routes all ports to this host controller. + * @var HSUSBH_T::UPSCR[2] + * Offset: 0x64~0x68 USB Port 0~1 Status and Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CCS |Current Connect Status (RO) + * | | |This value reflects the current state of the port, and may not correspond directly to the event that caused the Connect Status Change bit (Bit 1) to be set. + * | | |This field is zero if Port Power is zero. + * | | |0 = No device is present. + * | | |1 = Device is present on port. + * |[1] |CSC |Connect Status Change (R/W) + * | | |Indicates a change has occurred in the port's Current Connect Status + * | | |The host controller sets this bit for all changes to the port device connect status, even if system software has not cleared an existing connect status change + * | | |For example, the insertion status changes twice before system software has cleared the changed condition, hub hardware will be "setting" an already-set bit (i.e., the bit will remain set).Software sets this bit to 0 by writing a 1 to it. + * | | |This field is zero if Port Power is zero. + * | | |0 = No change. + * | | |1 = Change in Current Connect Status. + * |[2] |PE |Port Enabled/Disabled (R/W) + * | | |Ports can only be enabled by the host controller as a part of the reset and enable + * | | |Software cannot enable a port by writing a one to this field + * | | |The host controller will only set this bit to a one when the reset sequence determines that the attached device is a high-speed device. + * | | |Ports can be disabled by either a fault condition (disconnect event or other fault condition) or by host software + * | | |Note that the bit status does not change until the port state actually changes + * | | |There may be a delay in disabling or enabling a port due to other host controller and bus events. + * | | |When the port is disabled (0b) downstream propagation of data is blocked on this port, except for reset. + * | | |This field is zero if Port Power is zero. + * | | |0 = Port Disabled. + * | | |1 = Port Enabled. + * |[3] |PEC |Port Enable/Disable Change (R/WC) + * | | |For the root hub, this bit gets set to a one only when a port is disabled due to the appropriate conditions existing at the EOF2 point (See Chapter 11 of the USB Specification for the definition of a Port Error) + * | | |Software clears this bit by writing a 1 to it. + * | | |This field is zero if Port Power is zero. + * | | |0 = No change. + * | | |1 = Port enabled/disabled status has changed. + * |[4] |OCA |Over-current Active (RO) + * | | |This bit will automatically transition from a one to a zero when the over current condition is removed. + * | | |0 = This port does not have an over-current condition. + * | | |1 = This port currently has an over-current condition. + * |[5] |OCC |Over-current Change (R/WC) + * | | |1 = This bit gets set to a one when there is a change to Over-current Active + * | | |Software clears this bit by writing a one to this bit position. + * |[6] |FPR |Force Port Resume (R/W) + * | | |This functionality defined for manipulating this bit depends on the value of the Suspend bit + * | | |For example, if the port is not suspended (Suspend and Enabled bits are a one) and software transitions this bit to a one, then the effects on the bus are undefined. + * | | |Software sets this bit to a 1 to drive resume signaling + * | | |The Host Controller sets this bit to a 1 if a J-to-K transition is detected while the port is in the Suspend state + * | | |When this bit transitions to a one because a J-to-K transition is detected, the Port Change Detect bit in the USBSTS register is also set to a one + * | | |If software sets this bit to a one, the host controller must not set the Port Change Detect bit. + * | | |Note that when the EHCI controller owns the port, the resume sequence follows the defined sequence documented in the USB Specification Revision 2.0 + * | | |The resume signaling (Full-speed 'K') is driven on the port as long as this bit remains a one + * | | |Software must appropriately time the Resume and set this bit to a zero when the appropriate amount of time has elapsed + * | | |Writing a zero (from one) causes the port to return to high-speed mode (forcing the bus below the port into a high-speed idle) + * | | |This bit will remain a one until the port has switched to the high-speed idle + * | | |The host controller must complete this transition within 2 milliseconds of software setting this bit to a zero. + * | | |This field is zero if Port Power is zero. + * | | |0 = No resume (K-state) detected/driven on port. + * | | |1 = Resume detected/driven on port. + * |[7] |SUSPEND |Suspend (R/W) + * | | |Port Enabled Bit and Suspend bit of this register define the port states as follows: + * | | |Port enable is 0 and suspend is 0 = Disable. + * | | |Port enable is 0 and suspend is 1 = Disable. + * | | |Port enable is 1 and suspend is 0 = Enable. + * | | |Port enable is 1 and suspend is 1 = Suspend. + * | | |When in suspend state, downstream propagation of data is blocked on this port, except for port reset + * | | |The blocking occurs at the end of the current transaction, if a transaction was in progress when this bit was written to 1 + * | | |In the suspend state, the port is sensitive to resume detection + * | | |Note that the bit status does not change until the port is suspended and that there may be a delay in suspending a port if there is a transaction currently in progress on the USB. + * | | |A write of zero to this bit is ignored by the host controller + * | | |The host controller will unconditionally set this bit to a zero when: + * | | |Software sets the Force Port Resume bit to a zero (from a one). + * | | |Software sets the Port Reset bit to a one (from a zero). + * | | |If host software sets this bit to a one when the port is not enabled (i.e. + * | | |Port enabled bit is a zero) the results are undefined. + * | | |This field is zero if Port Power is zero. + * | | |0 = Port not in suspend state. + * | | |1 = Port in suspend state. + * |[8] |PRST |Port Reset (R/W) + * | | |When software writes a one to this bit (from a zero), the bus reset sequence as defined in the USB Specification Revision 2.0 is started + * | | |Software writes a zero to this bit to terminate the bus reset sequence + * | | |Software must keep this bit at a one long enough to ensure the reset sequence, as specified in the USB Specification Revision 2.0, completes + * | | |Note: when software writes this bit to a one, it must also write a zero to the Port Enable bit. + * | | |Note that when software writes a zero to this bit there may be a delay before the bit status changes to a zero + * | | |The bit status will not read as a zero until after the reset has completed + * | | |If the port is in high-speed mode after reset is complete, the host controller will automatically enable this port (e.g. + * | | |set the Port Enable bit to a one) + * | | |A host controller must terminate the reset and stabilize the state of the port within 2 milliseconds of software transitioning this bit from a one to a zero + * | | |For example: if the port detects that the attached device is high-speed during reset, then the host controller must have the port in the enabled state within 2ms of software writing this bit to a zero. + * | | |The HCHalted bit in the USBSTS register should be a zero before software attempts to use this bit + * | | |The host controller may hold Port Reset asserted to a one when the HCHalted bit is a one. + * | | |This field is zero if Port Power is zero. + * | | |0 = Port is not in Reset. + * | | |1 = Port is in Reset. + * |[11:10] |LSTS |Line Status (RO) + * | | |These bits reflect the current logical levels of the D+ (bit 11) and D- (bit 10) signal lines + * | | |These bits are used for detection of low-speed USB devices prior to the port reset and enable sequence + * | | |This field is valid only when the port enable bit is zero and the current connect status bit is set to a one. + * | | |The encoding of the bits are: + * | | |Bits[11:10] USB State Interpretation + * | | |00 = SE0 Not Low-speed device, perform EHCI reset. + * | | |01 = K-state Low-speed device, release ownership of port. + * | | |10 = J-state Not Low-speed device, perform EHCI reset. + * | | |11 = Undefined Not Low-speed device, perform EHCI reset. + * | | |This value of this field is undefined if Port Power is zero. + * |[12] |PP |Port Power (PP) + * | | |Host controller has port power control switches + * | | |This bit represents the Current setting of the switch (0 = off, 1 = on) + * | | |When power is not available on a port (i.e. + * | | |PP equals a 0), the port is nonfunctional and will not report attaches, detaches, etc. + * | | |When an over-current condition is detected on a powered port and PPC is a one, the PP bit in each affected port may be transitioned by the host controller from a 1 to 0 (removing power from the port). + * |[13] |PO |Port Owner (R/W) + * | | |This bit unconditionally goes to a 0b when the Configured bit in the CONFIGFLAG register makes a 0 to 1 transition + * | | |This bit unconditionally goes to 1 whenever the Configured bit is zero. + * | | |System software uses this field to release ownership of the port to a selected host controller (in the event that the attached device is not a high-speed device) + * | | |Software writes a one to this bit when the attached device is not a high-speed device + * | | |A one in this bit means that a companion host controller owns and controls the port. + * |[19:16] |PTC |Port Test Control (R/W) + * | | |When this field is zero, the port is NOT operating in a test mode + * | | |A non-zero value indicates that it is operating in test mode and the specific test mode is indicated by the specific value + * | | |The encoding of the test mode bits are (0x6 ~ 0xF are reserved): + * | | |Bits Test Mode + * | | |0x0 = Test mode not enabled. + * | | |0x1 = Test J_STATE. + * | | |0x2 = Test K_STATE. + * | | |0x3 = Test SE0_NAK. + * | | |0x4 = Test Packet. + * | | |0x5 = Test FORCE_ENABLE. + * @var HSUSBH_T::USBPCR0 + * Offset: 0xC4 USB PHY 0 Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[8] |SUSPEND |Suspend Assertion + * | | |This bit controls the suspend mode of USB PHY 0. + * | | |While PHY was suspended, all circuits of PHY were powered down and outputs are tri-state. + * | | |This bit is 1'b0 in default + * | | |This means the USB PHY 0 is suspended in default + * | | |It is necessary to set this bit 1'b1 to make USB PHY 0 leave suspend mode before doing configuration of USB host. + * | | |0 = USB PHY 0 was suspended. + * | | |1 = USB PHY 0 was not suspended. + * |[11] |CLKVALID |UTMI Clock Valid + * | | |This bit is a flag to indicate if the UTMI clock from USB 2.0 PHY is ready + * | | |S/W program must prevent to write other control registers before this UTMI clock valid flag is active. + * | | |0 = UTMI clock is not valid. + * | | |1 = UTMI clock is valid. + * @var HSUSBH_T::USBPCR1 + * Offset: 0xC8 USB PHY 1 Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[8] |SUSPEND |Suspend Assertion + * | | |This bit controls the suspend mode of USB PHY 1. + * | | |While PHY was suspended, all circuits of PHY were powered down and outputs are tri-state. + * | | |This bit is 1'b0 in default + * | | |This means the USB PHY 0 is suspended in default + * | | |It is necessary to set this bit 1'b1 to make USB PHY 0 leave suspend mode before doing configuration of USB host. + * | | |0 = USB PHY 1 was suspended. + * | | |1 = USB PHY 1 was not suspended. + */ + __I uint32_t EHCVNR; /*!< [0x0000] EHCI Version Number Register */ + __I uint32_t EHCSPR; /*!< [0x0004] EHCI Structural Parameters Register */ + __I uint32_t EHCCPR; /*!< [0x0008] EHCI Capability Parameters Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[5]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t UCMDR; /*!< [0x0020] USB Command Register */ + __IO uint32_t USTSR; /*!< [0x0024] USB Status Register */ + __IO uint32_t UIENR; /*!< [0x0028] USB Interrupt Enable Register */ + __IO uint32_t UFINDR; /*!< [0x002c] USB Frame Index Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE1[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t UPFLBAR; /*!< [0x0034] USB Periodic Frame List Base Address Register */ + __IO uint32_t UCALAR; /*!< [0x0038] USB Current Asynchronous List Address Register */ + __IO uint32_t UASSTR; /*!< [0x003c] USB Asynchronous Schedule Sleep Timer Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE2[8]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t UCFGR; /*!< [0x0060] USB Configure Flag Register */ + __IO uint32_t UPSCR[2]; /*!< [0x0064] ~ [0x0068] USB Port 0 & 1 Status and Control Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE3[22]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t USBPCR0; /*!< [0x00c4] USB PHY 0 Control Register */ + __IO uint32_t USBPCR1; /*!< [0x00c8] USB PHY 1 Control Register */ + +} HSUSBH_T; + +/** + @addtogroup HSUSBH_CONST HSUSBH Bit Field Definition + Constant Definitions for HSUSBH Controller +@{ */ + +#define HSUSBH_EHCVNR_CRLEN_Pos (0) /*!< HSUSBH_T::EHCVNR: CRLEN Position */ +#define HSUSBH_EHCVNR_CRLEN_Msk (0xfful << HSUSBH_EHCVNR_CRLEN_Pos) /*!< HSUSBH_T::EHCVNR: CRLEN Mask */ + +#define HSUSBH_EHCVNR_VERSION_Pos (16) /*!< HSUSBH_T::EHCVNR: VERSION Position */ +#define HSUSBH_EHCVNR_VERSION_Msk (0xfffful << HSUSBH_EHCVNR_VERSION_Pos) /*!< HSUSBH_T::EHCVNR: VERSION Mask */ + +#define HSUSBH_EHCSPR_N_PORTS_Pos (0) /*!< HSUSBH_T::EHCSPR: N_PORTS Position */ +#define HSUSBH_EHCSPR_N_PORTS_Msk (0xful << HSUSBH_EHCSPR_N_PORTS_Pos) /*!< HSUSBH_T::EHCSPR: N_PORTS Mask */ + +#define HSUSBH_EHCSPR_PPC_Pos (4) /*!< HSUSBH_T::EHCSPR: PPC Position */ +#define HSUSBH_EHCSPR_PPC_Msk (0x1ul << HSUSBH_EHCSPR_PPC_Pos) /*!< HSUSBH_T::EHCSPR: PPC Mask */ + +#define HSUSBH_EHCSPR_N_PCC_Pos (8) /*!< HSUSBH_T::EHCSPR: N_PCC Position */ +#define HSUSBH_EHCSPR_N_PCC_Msk (0xful << HSUSBH_EHCSPR_N_PCC_Pos) /*!< HSUSBH_T::EHCSPR: N_PCC Mask */ + +#define HSUSBH_EHCSPR_N_CC_Pos (12) /*!< HSUSBH_T::EHCSPR: N_CC Position */ +#define HSUSBH_EHCSPR_N_CC_Msk (0xful << HSUSBH_EHCSPR_N_CC_Pos) /*!< HSUSBH_T::EHCSPR: N_CC Mask */ + +#define HSUSBH_EHCCPR_AC64_Pos (0) /*!< HSUSBH_T::EHCCPR: AC64 Position */ +#define HSUSBH_EHCCPR_AC64_Msk (0x1ul << HSUSBH_EHCCPR_AC64_Pos) /*!< HSUSBH_T::EHCCPR: AC64 Mask */ + +#define HSUSBH_EHCCPR_PFLF_Pos (1) /*!< HSUSBH_T::EHCCPR: PFLF Position */ +#define HSUSBH_EHCCPR_PFLF_Msk (0x1ul << HSUSBH_EHCCPR_PFLF_Pos) /*!< HSUSBH_T::EHCCPR: PFLF Mask */ + +#define HSUSBH_EHCCPR_ASPC_Pos (2) /*!< HSUSBH_T::EHCCPR: ASPC Position */ +#define HSUSBH_EHCCPR_ASPC_Msk (0x1ul << HSUSBH_EHCCPR_ASPC_Pos) /*!< HSUSBH_T::EHCCPR: ASPC Mask */ + +#define HSUSBH_EHCCPR_IST_Pos (4) /*!< HSUSBH_T::EHCCPR: IST Position */ +#define HSUSBH_EHCCPR_IST_Msk (0xful << HSUSBH_EHCCPR_IST_Pos) /*!< HSUSBH_T::EHCCPR: IST Mask */ + +#define HSUSBH_EHCCPR_EECP_Pos (8) /*!< HSUSBH_T::EHCCPR: EECP Position */ +#define HSUSBH_EHCCPR_EECP_Msk (0xfful << HSUSBH_EHCCPR_EECP_Pos) /*!< HSUSBH_T::EHCCPR: EECP Mask */ + +#define HSUSBH_UCMDR_RUN_Pos (0) /*!< HSUSBH_T::UCMDR: RUN Position */ +#define HSUSBH_UCMDR_RUN_Msk (0x1ul << HSUSBH_UCMDR_RUN_Pos) /*!< HSUSBH_T::UCMDR: RUN Mask */ + +#define HSUSBH_UCMDR_HCRST_Pos (1) /*!< HSUSBH_T::UCMDR: HCRST Position */ +#define HSUSBH_UCMDR_HCRST_Msk (0x1ul << HSUSBH_UCMDR_HCRST_Pos) /*!< HSUSBH_T::UCMDR: HCRST Mask */ + +#define HSUSBH_UCMDR_FLSZ_Pos (2) /*!< HSUSBH_T::UCMDR: FLSZ Position */ +#define HSUSBH_UCMDR_FLSZ_Msk (0x3ul << HSUSBH_UCMDR_FLSZ_Pos) /*!< HSUSBH_T::UCMDR: FLSZ Mask */ + +#define HSUSBH_UCMDR_PSEN_Pos (4) /*!< HSUSBH_T::UCMDR: PSEN Position */ +#define HSUSBH_UCMDR_PSEN_Msk (0x1ul << HSUSBH_UCMDR_PSEN_Pos) /*!< HSUSBH_T::UCMDR: PSEN Mask */ + +#define HSUSBH_UCMDR_ASEN_Pos (5) /*!< HSUSBH_T::UCMDR: ASEN Position */ +#define HSUSBH_UCMDR_ASEN_Msk (0x1ul << HSUSBH_UCMDR_ASEN_Pos) /*!< HSUSBH_T::UCMDR: ASEN Mask */ + +#define HSUSBH_UCMDR_IAAD_Pos (6) /*!< HSUSBH_T::UCMDR: IAAD Position */ +#define HSUSBH_UCMDR_IAAD_Msk (0x1ul << HSUSBH_UCMDR_IAAD_Pos) /*!< HSUSBH_T::UCMDR: IAAD Mask */ + +#define HSUSBH_UCMDR_ITC_Pos (16) /*!< HSUSBH_T::UCMDR: ITC Position */ +#define HSUSBH_UCMDR_ITC_Msk (0xfful << HSUSBH_UCMDR_ITC_Pos) /*!< HSUSBH_T::UCMDR: ITC Mask */ + +#define HSUSBH_USTSR_USBINT_Pos (0) /*!< HSUSBH_T::USTSR: USBINT Position */ +#define HSUSBH_USTSR_USBINT_Msk (0x1ul << HSUSBH_USTSR_USBINT_Pos) /*!< HSUSBH_T::USTSR: USBINT Mask */ + +#define HSUSBH_USTSR_UERRINT_Pos (1) /*!< HSUSBH_T::USTSR: UERRINT Position */ +#define HSUSBH_USTSR_UERRINT_Msk (0x1ul << HSUSBH_USTSR_UERRINT_Pos) /*!< HSUSBH_T::USTSR: UERRINT Mask */ + +#define HSUSBH_USTSR_PCD_Pos (2) /*!< HSUSBH_T::USTSR: PCD Position */ +#define HSUSBH_USTSR_PCD_Msk (0x1ul << HSUSBH_USTSR_PCD_Pos) /*!< HSUSBH_T::USTSR: PCD Mask */ + +#define HSUSBH_USTSR_FLR_Pos (3) /*!< HSUSBH_T::USTSR: FLR Position */ +#define HSUSBH_USTSR_FLR_Msk (0x1ul << HSUSBH_USTSR_FLR_Pos) /*!< HSUSBH_T::USTSR: FLR Mask */ + +#define HSUSBH_USTSR_HSERR_Pos (4) /*!< HSUSBH_T::USTSR: HSERR Position */ +#define HSUSBH_USTSR_HSERR_Msk (0x1ul << HSUSBH_USTSR_HSERR_Pos) /*!< HSUSBH_T::USTSR: HSERR Mask */ + +#define HSUSBH_USTSR_IAA_Pos (5) /*!< HSUSBH_T::USTSR: IAA Position */ +#define HSUSBH_USTSR_IAA_Msk (0x1ul << HSUSBH_USTSR_IAA_Pos) /*!< HSUSBH_T::USTSR: IAA Mask */ + +#define HSUSBH_USTSR_HCHalted_Pos (12) /*!< HSUSBH_T::USTSR: HCHalted Position */ +#define HSUSBH_USTSR_HCHalted_Msk (0x1ul << HSUSBH_USTSR_HCHalted_Pos) /*!< HSUSBH_T::USTSR: HCHalted Mask */ + +#define HSUSBH_USTSR_RECLA_Pos (13) /*!< HSUSBH_T::USTSR: RECLA Position */ +#define HSUSBH_USTSR_RECLA_Msk (0x1ul << HSUSBH_USTSR_RECLA_Pos) /*!< HSUSBH_T::USTSR: RECLA Mask */ + +#define HSUSBH_USTSR_PSS_Pos (14) /*!< HSUSBH_T::USTSR: PSS Position */ +#define HSUSBH_USTSR_PSS_Msk (0x1ul << HSUSBH_USTSR_PSS_Pos) /*!< HSUSBH_T::USTSR: PSS Mask */ + +#define HSUSBH_USTSR_ASS_Pos (15) /*!< HSUSBH_T::USTSR: ASS Position */ +#define HSUSBH_USTSR_ASS_Msk (0x1ul << HSUSBH_USTSR_ASS_Pos) /*!< HSUSBH_T::USTSR: ASS Mask */ + +#define HSUSBH_UIENR_USBIEN_Pos (0) /*!< HSUSBH_T::UIENR: USBIEN Position */ +#define HSUSBH_UIENR_USBIEN_Msk (0x1ul << HSUSBH_UIENR_USBIEN_Pos) /*!< HSUSBH_T::UIENR: USBIEN Mask */ + +#define HSUSBH_UIENR_UERRIEN_Pos (1) /*!< HSUSBH_T::UIENR: UERRIEN Position */ +#define HSUSBH_UIENR_UERRIEN_Msk (0x1ul << HSUSBH_UIENR_UERRIEN_Pos) /*!< HSUSBH_T::UIENR: UERRIEN Mask */ + +#define HSUSBH_UIENR_PCIEN_Pos (2) /*!< HSUSBH_T::UIENR: PCIEN Position */ +#define HSUSBH_UIENR_PCIEN_Msk (0x1ul << HSUSBH_UIENR_PCIEN_Pos) /*!< HSUSBH_T::UIENR: PCIEN Mask */ + +#define HSUSBH_UIENR_FLREN_Pos (3) /*!< HSUSBH_T::UIENR: FLREN Position */ +#define HSUSBH_UIENR_FLREN_Msk (0x1ul << HSUSBH_UIENR_FLREN_Pos) /*!< HSUSBH_T::UIENR: FLREN Mask */ + +#define HSUSBH_UIENR_HSERREN_Pos (4) /*!< HSUSBH_T::UIENR: HSERREN Position */ +#define HSUSBH_UIENR_HSERREN_Msk (0x1ul << HSUSBH_UIENR_HSERREN_Pos) /*!< HSUSBH_T::UIENR: HSERREN Mask */ + +#define HSUSBH_UIENR_IAAEN_Pos (5) /*!< HSUSBH_T::UIENR: IAAEN Position */ +#define HSUSBH_UIENR_IAAEN_Msk (0x1ul << HSUSBH_UIENR_IAAEN_Pos) /*!< HSUSBH_T::UIENR: IAAEN Mask */ + +#define HSUSBH_UFINDR_FI_Pos (0) /*!< HSUSBH_T::UFINDR: FI Position */ +#define HSUSBH_UFINDR_FI_Msk (0x3ffful << HSUSBH_UFINDR_FI_Pos) /*!< HSUSBH_T::UFINDR: FI Mask */ + +#define HSUSBH_UPFLBAR_BADDR_Pos (12) /*!< HSUSBH_T::UPFLBAR: BADDR Position */ +#define HSUSBH_UPFLBAR_BADDR_Msk (0xffffful << HSUSBH_UPFLBAR_BADDR_Pos) /*!< HSUSBH_T::UPFLBAR: BADDR Mask */ + +#define HSUSBH_UCALAR_LPL_Pos (5) /*!< HSUSBH_T::UCALAR: LPL Position */ +#define HSUSBH_UCALAR_LPL_Msk (0x7fffffful << HSUSBH_UCALAR_LPL_Pos) /*!< HSUSBH_T::UCALAR: LPL Mask */ + +#define HSUSBH_UASSTR_ASSTMR_Pos (0) /*!< HSUSBH_T::UASSTR: ASSTMR Position */ +#define HSUSBH_UASSTR_ASSTMR_Msk (0xffful << HSUSBH_UASSTR_ASSTMR_Pos) /*!< HSUSBH_T::UASSTR: ASSTMR Mask */ + +#define HSUSBH_UCFGR_CF_Pos (0) /*!< HSUSBH_T::UCFGR: CF Position */ +#define HSUSBH_UCFGR_CF_Msk (0x1ul << HSUSBH_UCFGR_CF_Pos) /*!< HSUSBH_T::UCFGR: CF Mask */ + +#define HSUSBH_UPSCR_CCS_Pos (0) /*!< HSUSBH_T::UPSCR[2]: CCS Position */ +#define HSUSBH_UPSCR_CCS_Msk (0x1ul << HSUSBH_UPSCR_CCS_Pos) /*!< HSUSBH_T::UPSCR[2]: CCS Mask */ + +#define HSUSBH_UPSCR_CSC_Pos (1) /*!< HSUSBH_T::UPSCR[2]: CSC Position */ +#define HSUSBH_UPSCR_CSC_Msk (0x1ul << HSUSBH_UPSCR_CSC_Pos) /*!< HSUSBH_T::UPSCR[2]: CSC Mask */ + +#define HSUSBH_UPSCR_PE_Pos (2) /*!< HSUSBH_T::UPSCR[2]: PE Position */ +#define HSUSBH_UPSCR_PE_Msk (0x1ul << HSUSBH_UPSCR_PE_Pos) /*!< HSUSBH_T::UPSCR[2]: PE Mask */ + +#define HSUSBH_UPSCR_PEC_Pos (3) /*!< HSUSBH_T::UPSCR[2]: PEC Position */ +#define HSUSBH_UPSCR_PEC_Msk (0x1ul << HSUSBH_UPSCR_PEC_Pos) /*!< HSUSBH_T::UPSCR[2]: PEC Mask */ + +#define HSUSBH_UPSCR_OCA_Pos (4) /*!< HSUSBH_T::UPSCR[2]: OCA Position */ +#define HSUSBH_UPSCR_OCA_Msk (0x1ul << HSUSBH_UPSCR_OCA_Pos) /*!< HSUSBH_T::UPSCR[2]: OCA Mask */ + +#define HSUSBH_UPSCR_OCC_Pos (5) /*!< HSUSBH_T::UPSCR[2]: OCC Position */ +#define HSUSBH_UPSCR_OCC_Msk (0x1ul << HSUSBH_UPSCR_OCC_Pos) /*!< HSUSBH_T::UPSCR[2]: OCC Mask */ + +#define HSUSBH_UPSCR_FPR_Pos (6) /*!< HSUSBH_T::UPSCR[2]: FPR Position */ +#define HSUSBH_UPSCR_FPR_Msk (0x1ul << HSUSBH_UPSCR_FPR_Pos) /*!< HSUSBH_T::UPSCR[2]: FPR Mask */ + +#define HSUSBH_UPSCR_SUSPEND_Pos (7) /*!< HSUSBH_T::UPSCR[2]: SUSPEND Position */ +#define HSUSBH_UPSCR_SUSPEND_Msk (0x1ul << HSUSBH_UPSCR_SUSPEND_Pos) /*!< HSUSBH_T::UPSCR[2]: SUSPEND Mask */ + +#define HSUSBH_UPSCR_PRST_Pos (8) /*!< HSUSBH_T::UPSCR[2]: PRST Position */ +#define HSUSBH_UPSCR_PRST_Msk (0x1ul << HSUSBH_UPSCR_PRST_Pos) /*!< HSUSBH_T::UPSCR[2]: PRST Mask */ + +#define HSUSBH_UPSCR_LSTS_Pos (10) /*!< HSUSBH_T::UPSCR[2]: LSTS Position */ +#define HSUSBH_UPSCR_LSTS_Msk (0x3ul << HSUSBH_UPSCR_LSTS_Pos) /*!< HSUSBH_T::UPSCR[2]: LSTS Mask */ + +#define HSUSBH_UPSCR_PP_Pos (12) /*!< HSUSBH_T::UPSCR[2]: PP Position */ +#define HSUSBH_UPSCR_PP_Msk (0x1ul << HSUSBH_UPSCR_PP_Pos) /*!< HSUSBH_T::UPSCR[2]: PP Mask */ + +#define HSUSBH_UPSCR_PO_Pos (13) /*!< HSUSBH_T::UPSCR[2]: PO Position */ +#define HSUSBH_UPSCR_PO_Msk (0x1ul << HSUSBH_UPSCR_PO_Pos) /*!< HSUSBH_T::UPSCR[2]: PO Mask */ + +#define HSUSBH_UPSCR_PTC_Pos (16) /*!< HSUSBH_T::UPSCR[2]: PTC Position */ +#define HSUSBH_UPSCR_PTC_Msk (0xful << HSUSBH_UPSCR_PTC_Pos) /*!< HSUSBH_T::UPSCR[2]: PTC Mask */ + +#define HSUSBH_USBPCR0_SUSPEND_Pos (8) /*!< HSUSBH_T::USBPCR0: SUSPEND Position */ +#define HSUSBH_USBPCR0_SUSPEND_Msk (0x1ul << HSUSBH_USBPCR0_SUSPEND_Pos) /*!< HSUSBH_T::USBPCR0: SUSPEND Mask */ + +#define HSUSBH_USBPCR0_CLKVALID_Pos (11) /*!< HSUSBH_T::USBPCR0: CLKVALID Position */ +#define HSUSBH_USBPCR0_CLKVALID_Msk (0x1ul << HSUSBH_USBPCR0_CLKVALID_Pos) /*!< HSUSBH_T::USBPCR0: CLKVALID Mask */ + +#define HSUSBH_USBPCR1_SUSPEND_Pos (8) /*!< HSUSBH_T::USBPCR1: SUSPEND Position */ +#define HSUSBH_USBPCR1_SUSPEND_Msk (0x1ul << HSUSBH_USBPCR1_SUSPEND_Pos) /*!< HSUSBH_T::USBPCR1: SUSPEND Mask */ + +/**@}*/ /* HSUSBH_CONST */ +/**@}*/ /* end of HSUSBH register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __HSUSBH_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/i2c_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/i2c_reg.h new file mode 100644 index 00000000000..adbd03fa572 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/i2c_reg.h @@ -0,0 +1,725 @@ +/**************************************************************************//** + * @file i2c_reg.h + * @version V1.00 + * @brief I2C register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __I2C_REG_H__ +#define __I2C_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup I2C Inter-IC Bus Controller(I2C) + Memory Mapped Structure for I2C Controller +@{ */ + +typedef struct +{ + + + /** + * @var I2C_T::CTL0 + * Offset: 0x00 I2C Control Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2] |AA |Assert Acknowledge Control + * | | |When AA =1 prior to address or data is received, an acknowledged (low level to SDA) will be returned during the acknowledge clock pulse on the SCL line when 1.) A slave is acknowledging the address sent from master, 2.) The receiver devices are acknowledging the data sent by transmitter + * | | |When AA=0 prior to address or data received, a Not acknowledged (high level to SDA) will be returned during the acknowledge clock pulse on the SCL line + * |[3] |SI |I2C Interrupt Flag + * | | |When a new I2C state is present in the I2C_STATUS register, the SI flag is set by hardware + * | | |If bit INTEN (I2C_CTL [7]) is set, the I2C interrupt is requested + * | | |SI must be cleared by software + * | | |Clear SI by writing 1 to this bit. + * | | |For ACKMEN is set in slave read mode, the SI flag is set in 8th clock period for user to confirm the acknowledge bit and 9th clock period for user to read the data in the data buffer. + * |[4] |STO |I2C STOP Control + * | | |In Master mode, setting STO to transmit a STOP condition to bus then I2C controller will check the bus condition if a STOP condition is detected + * | | |This bit will be cleared by hardware automatically. + * |[5] |STA |I2C START Control + * | | |Setting STA to logic 1 to enter Master mode, the I2C hardware sends a START or repeat START condition to bus when the bus is free. + * |[6] |I2CEN |I2C Controller Enable Bit + * | | |Set to enable I2C serial function controller + * | | |When I2CEN=1 the I2C serial function enable + * | | |The multi-function pin function must set to SDA, and SCL of I2C function first. + * | | |0 = I2C controller Disabled. + * | | |1 = I2C controller Enabled. + * |[7] |INTEN |Enable Interrupt + * | | |0 = I2C interrupt Disabled. + * | | |1 = I2C interrupt Enabled. + * @var I2C_T::ADDR0 + * Offset: 0x04 I2C Slave Address Register0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |GC |General Call Function + * | | |0 = General Call Function Disabled. + * | | |1 = General Call Function Enabled. + * |[10:1] |ADDR |I2C Address + * | | |The content of this register is irrelevant when I2C is in Master mode + * | | |In the slave mode, the seven most significant bits must be loaded with the chip's own address + * | | |The I2C hardware will react if either of the address is matched. + * | | |Note: When software set 10'h000, the address can not be used. + * @var I2C_T::DAT + * Offset: 0x08 I2C Data Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |DAT |I2C Data + * | | |Bit [7:0] is located with the 8-bit transferred/received data of I2C serial port. + * @var I2C_T::STATUS0 + * Offset: 0x0C I2C Status Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |STATUS |I2C Status + * | | |The three least significant bits are always 0 + * | | |The five most significant bits contain the status code + * | | |There are 28 possible status codes + * | | |When the content of I2C_STATUS is F8H, no serial interrupt is requested + * | | |Others I2C_STATUS values correspond to defined I2C states + * | | |When each of these states is entered, a status interrupt is requested (SI = 1) + * | | |A valid status code is present in I2C_STATUS one cycle after SI is set by hardware and is still present one cycle after SI has been reset by software + * | | |In addition, states 00H stands for a Bus Error + * | | |A Bus Error occurs when a START or STOP condition is present at an illegal position in the formation frame + * | | |Example of illegal position are during the serial transfer of an address byte, a data byte or an acknowledge bit. + * @var I2C_T::CLKDIV + * Offset: 0x10 I2C Clock Divided Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[9:0] |DIVIDER |I2C Clock Divided + * | | |Indicates the I2C clock rate: Data Baud Rate of I2C = (system clock) / (4x (I2C_CLKDIV+1)). + * | | |Note: The minimum value of I2C_CLKDIV is 4. + * @var I2C_T::TOCTL + * Offset: 0x14 I2C Time-out Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |TOIF |Time-out Flag + * | | |This bit is set by hardware when I2C time-out happened and it can interrupt CPU if I2C interrupt enable bit (INTEN) is set to 1. + * | | |Note: Software can write 1 to clear this bit. + * |[1] |TOCDIV4 |Time-out Counter Input Clock Divided by 4 + * | | |When Enabled, The time-out period is extend 4 times. + * | | |0 = Time-out period is extend 4 times Disabled. + * | | |1 = Time-out period is extend 4 times Enabled. + * |[2] |TOCEN |Time-out Counter Enable Bit + * | | |When Enabled, the 14-bit time-out counter will start counting when SI is clear + * | | |Setting flag SI to '1' will reset counter and re-start up counting after SI is cleared. + * | | |0 = Time-out counter Disabled. + * | | |1 = Time-out counter Enabled. + * @var I2C_T::ADDR1 + * Offset: 0x18 I2C Slave Address Register1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |GC |General Call Function + * | | |0 = General Call Function Disabled. + * | | |1 = General Call Function Enabled. + * |[10:1] |ADDR |I2C Address + * | | |The content of this register is irrelevant when I2C is in Master mode + * | | |In the slave mode, the seven most significant bits must be loaded with the chip's own address + * | | |The I2C hardware will react if either of the address is matched. + * | | |Note: When software set 10'h000, the address can not be used. + * @var I2C_T::ADDR2 + * Offset: 0x1C I2C Slave Address Register2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |GC |General Call Function + * | | |0 = General Call Function Disabled. + * | | |1 = General Call Function Enabled. + * |[10:1] |ADDR |I2C Address + * | | |The content of this register is irrelevant when I2C is in Master mode + * | | |In the slave mode, the seven most significant bits must be loaded with the chip's own address + * | | |The I2C hardware will react if either of the address is matched. + * | | |Note: When software set 10'h000, the address can not be used. + * @var I2C_T::ADDR3 + * Offset: 0x20 I2C Slave Address Register3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |GC |General Call Function + * | | |0 = General Call Function Disabled. + * | | |1 = General Call Function Enabled. + * |[10:1] |ADDR |I2C Address + * | | |The content of this register is irrelevant when I2C is in Master mode + * | | |In the slave mode, the seven most significant bits must be loaded with the chip's own address + * | | |The I2C hardware will react if either of the address is matched. + * | | |Note: When software set 10'h000, the address can not be used. + * @var I2C_T::ADDRMSK0 + * Offset: 0x24 I2C Slave Address Mask Register0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[10:1] |ADDRMSK |I2C Address Mask + * | | |0 = Mask Disabled (the received corresponding register bit should be exact the same as address register.). + * | | |1 = Mask Enabled (the received corresponding address bit is don't care.). + * | | |I2C bus controllers support multiple address recognition with four address mask register + * | | |When the bit in the address mask register is set to one, it means the received corresponding address bit is don't-care + * | | |If the bit is set to zero, that means the received corresponding register bit should be exact the same as address register. + * | | |Note: The wake-up function can not use address mask. + * @var I2C_T::ADDRMSK1 + * Offset: 0x28 I2C Slave Address Mask Register1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[10:1] |ADDRMSK |I2C Address Mask + * | | |0 = Mask Disabled (the received corresponding register bit should be exact the same as address register.). + * | | |1 = Mask Enabled (the received corresponding address bit is don't care.). + * | | |I2C bus controllers support multiple address recognition with four address mask register + * | | |When the bit in the address mask register is set to one, it means the received corresponding address bit is don't-care + * | | |If the bit is set to zero, that means the received corresponding register bit should be exact the same as address register. + * | | |Note: The wake-up function can not use address mask. + * @var I2C_T::ADDRMSK2 + * Offset: 0x2C I2C Slave Address Mask Register2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[10:1] |ADDRMSK |I2C Address Mask + * | | |0 = Mask Disabled (the received corresponding register bit should be exact the same as address register.). + * | | |1 = Mask Enabled (the received corresponding address bit is don't care.). + * | | |I2C bus controllers support multiple address recognition with four address mask register + * | | |When the bit in the address mask register is set to one, it means the received corresponding address bit is don't-care + * | | |If the bit is set to zero, that means the received corresponding register bit should be exact the same as address register. + * | | |Note: The wake-up function can not use address mask. + * @var I2C_T::ADDRMSK3 + * Offset: 0x30 I2C Slave Address Mask Register3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[10:1] |ADDRMSK |I2C Address Mask + * | | |0 = Mask Disabled (the received corresponding register bit should be exact the same as address register.). + * | | |1 = Mask Enabled (the received corresponding address bit is don't care.). + * | | |I2C bus controllers support multiple address recognition with four address mask register + * | | |When the bit in the address mask register is set to one, it means the received corresponding address bit is don't-care + * | | |If the bit is set to zero, that means the received corresponding register bit should be exact the same as address register. + * | | |Note: The wake-up function can not use address mask. + * @var I2C_T::WKCTL + * Offset: 0x3C I2C Wake-up Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |WKEN |I2C Wake-up Enable Bit + * | | |0 = I2C wake-up function Disabled. + * | | |1 = I2C wake-up function Enabled. + * |[7] |NHDBUSEN |I2C No Hold BUS Enable Bit + * | | |0 = I2C hold bus after wake-up. + * | | |1 = I2C don't hold bus after wake-up. + * | | |Note: I2C controller could response when WKIF event is not clear, it may cause error data transmitted or received + * | | |If data transmitted or received when WKIF event is not clear, user must reset I2C controller and execute the original operation again. + * @var I2C_T::WKSTS + * Offset: 0x40 I2C Wake-up Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |WKIF |I2C Wake-up Flag + * | | |When chip is woken up from Power-down mode by I2C, this bit is set to 1 + * | | |Software can write 1 to clear this bit. + * |[1] |WKAKDONE |Wakeup Address Frame Acknowledge Bit Done + * | | |0 = The ACK bit cycle of address match frame isn't done. + * | | |1 = The ACK bit cycle of address match frame is done in power-down. + * | | |Note: This bit can't release WKIF. Software can write 1 to clear this bit. + * |[2] |WRSTSWK |Read/Write Status Bit in Address Wakeup Frame + * | | |0 = Write command be record on the address match wakeup frame. + * | | |1 = Read command be record on the address match wakeup frame. + * | | |Note: This bit will be cleared when software can write 1 to WKAKDONE bit. + * @var I2C_T::CTL1 + * Offset: 0x44 I2C Control Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |TXPDMAEN |PDMA Transmit Channel Available + * | | |0 = Transmit PDMA function disable. + * | | |1 = Transmit PDMA function enable. + * |[1] |RXPDMAEN |PDMA Receive Channel Available + * | | |0 = Receive PDMA function disable. + * | | |1 = Receive PDMA function enable. + * |[2] |PDMARST |PDMA Reset + * | | |0 = No effect. + * | | |1 = Reset the I2C request to PDMA. + * |[8] |PDMASTR |PDMA Stretch Bit + * | | |0 = I2C send STOP automatically after PDMA transfer done. (only master TX) + * | | |1 = I2C SCL bus is stretched by hardware after PDMA transfer done if the SI is not cleared + * | | |(only master TX) + * |[9] |ADDR10EN |Address 10-bit Function Enable + * | | |0 = Address match 10-bit function is disabled. + * | | |1 = Address match 10-bit function is enabled. + * @var I2C_T::STATUS1 + * Offset: 0x48 I2C Status Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ADMAT0 |I2C Address 0 Match Status Register + * | | |When address 0 is matched, hardware will inform which address used + * | | |This bit will set to 1, and software can write 1 to clear this bit. + * |[1] |ADMAT1 |I2C Address 1 Match Status Register + * | | |When address 1 is matched, hardware will inform which address used + * | | |This bit will set to 1, and software can write 1 to clear this bit. + * |[2] |ADMAT2 |I2C Address 2 Match Status Register + * | | |When address 2 is matched, hardware will inform which address used + * | | |This bit will set to 1, and software can write 1 to clear this bit. + * |[3] |ADMAT3 |I2C Address 3 Match Status Register + * | | |When address 3 is matched, hardware will inform which address used + * | | |This bit will set to 1, and software can write 1 to clear this bit. + * |[8] |ONBUSY |On Bus Busy + * | | |Indicates that a communication is in progress on the bus + * | | |It is set by hardware when a START condition is detected + * | | |It is cleared by hardware when a STOP condition is detected. + * | | |0 = The bus is IDLE (both SCLK and SDA High). + * | | |1 = The bus is busy. + * | | |Note:This bit is read only. + * @var I2C_T::TMCTL + * Offset: 0x4C I2C Timing Configure Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[8:0] |STCTL |Setup Time Configure Control Register + * | | |This field is used to generate a delay timing between SDA falling edge and SCL rising edge in transmission mode. + * | | |The delay setup time is numbers of peripheral clock = STCTL x PCLK. + * | | |Note: Setup time setting should not make SCL output less than three PCLKs. + * |[24:16] |HTCTL |Hold Time Configure Control Register + * | | |This field is used to generate the delay timing between SCL falling edge and SDA rising edge in transmission mode. + * | | |The delay hold time is numbers of peripheral clock = HTCTL x PCLK. + * @var I2C_T::BUSCTL + * Offset: 0x50 I2C Bus Management Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ACKMEN |Acknowledge Control by Manual + * | | |In order to allow ACK control in slave reception including the command and data, slave byte control mode must be enabled by setting the ACKMEN bit. + * | | |0 = Slave byte control Disabled. + * | | |1 = Slave byte control Enabled + * | | |The 9th bit can response the ACK or NACK according the received data by user + * | | |When the byte is received, stretching the SCLK signal low between the 8th and 9th SCLK pulse. + * | | |Note: If the BMDEN=1 and this bit is enabled, the information of I2C_STATUS will be fixed as 0xF0 in slave receive condition. + * |[1] |PECEN |Packet Error Checking Calculation Enable Bit + * | | |0 = Packet Error Checking Calculation Disabled. + * | | |1 = Packet Error Checking Calculation Enabled. + * | | |Note: When I2C enter power down mode, the bit should be enabled after wake-up if needed PEC calculation. + * |[2] |BMDEN |Bus Management Device Default Address Enable Bit + * | | |0 = Device default address Disable + * | | |When the address 0'b1100001x coming and the both of BMDEN and ACKMEN are enabled, the device responses NACKed + * | | |1 = Device default address Enabled + * | | |When the address 0'b1100001x coming and the both of BMDEN and ACKMEN are enabled, the device responses ACKed. + * |[3] |BMHEN |Bus Management Host Enable Bit + * | | |0 = Host function Disabled. + * | | |1 = Host function Enabled. + * |[4] |ALERTEN |Bus Management Alert Enable Bit + * | | |Device Mode (BMHEN=0). + * | | |0 = Release the BM_ALERT pin high and Alert Response Header disabled: 0001100x followed by NACK if both of BMDEN and ACKMEN are enabled. + * | | |1 = Drive BM_ALERT pin low and Alert Response Address Header enables: 0001100x followed by ACK if both of BMDEN and ACKMEN are enabled. + * | | |Host Mode (BMHEN=1). + * | | |0 = BM_ALERT pin not supported. + * | | |1 = BM_ALERT pin supported. + * |[5] |SCTLOSTS |Suspend/Control Data Output Status + * | | |0 = The output of SUSCON pin is low. + * | | |1 = The output of SUSCON pin is high. + * |[6] |SCTLOEN |Suspend or Control Pin Output Enable Bit + * | | |0 = The SUSCON pin in input. + * | | |1 = The output enable is active on the SUSCON pin. + * |[7] |BUSEN |BUS Enable Bit + * | | |0 = The system management function is Disabled. + * | | |1 = The system management function is Enable. + * | | |Note: When the bit is enabled, the internal 14-bit counter is used to calculate the time out event of clock low condition. + * |[8] |PECTXEN |Packet Error Checking Byte Transmission/Reception + * | | |0 = No PEC transfer. + * | | |1 = PEC transmission is requested. + * | | |Note: This bit has no effect in slave mode when ACKMEN=0. + * |[9] |TIDLE |Timer Check in Idle State + * | | |The BUSTOUT is used to calculate the time-out of clock low in bus active and the idle period in bus Idle + * | | |This bit is used to define which condition is enabled. + * | | |0 = The BUSTOUT is used to calculate the clock low period in bus active. + * | | |1 = The BUSTOUT is used to calculate the IDLE period in bus Idle. + * | | |Note: The BUSY (I2C_BUSSTS[0]) indicate the current bus state. + * |[10] |PECCLR |PEC Clear at Repeat Start + * | | |The calculation of PEC starts when PECEN is set to 1 and it is clear when the STA or STO bit is detected + * | | |This PECCLR bit is used to enable the condition of REPEAT START can clear the PEC calculation. + * | | |0 = The PEC calculation is cleared by "Repeat Start" function is Disabled. + * | | |1 = The PEC calculation is cleared by "Repeat Start"" function is Enabled. + * |[11] |ACKM9SI |Acknowledge Manual Enable Extra SI Interrupt + * | | |0 = There is no SI interrupt in the 9th clock cycle when the BUSEN=1 and ACKMEN=1. + * | | |1 = There is SI interrupt in the 9th clock cycle when the BUSEN=1 and ACKMEN=1. + * |[12] |BCDIEN |Packet Error Checking Byte Count Done Interrupt Enable Bit + * | | |0 = Indicates the byte count done interrupt is Disabled. + * | | |1 = Indicates the byte count done interrupt is Enabled. + * | | |Note: This bit is used in PECEN=1. + * |[13] |PECDIEN |Packet Error Checking Byte Transfer Done Interrupt Enable Bit + * | | |0 = Indicates the PEC transfer done interrupt is Disabled. + * | | |1 = Indicates the PEC transfer done interrupt is Enabled. + * | | |Note: This bit is used in PECEN=1. + * @var I2C_T::BUSTCTL + * Offset: 0x54 I2C Bus Management Timer Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BUSTOEN |Bus Time Out Enable Bit + * | | |0 = Indicates the bus clock low time-out detection is Disabled. + * | | |1 = Indicates the bus clock low time-out detection is Enabled (bus clock is low for more than TTime-out (in BIDLE=0) or high more than TTime-out(in BIDLE =1) + * |[1] |CLKTOEN |Cumulative Clock Low Time Out Enable Bit + * | | |0 = Indicates the cumulative clock low time-out detection is Disabled. + * | | |1 = Indicates the cumulative clock low time-out detection is Enabled. + * | | |For Master, it calculates the period from START to ACK + * | | |For Slave, it calculates the period from START to STOP + * |[2] |BUSTOIEN |Time-out Interrupt Enable Bit + * | | |BUSY =1. + * | | |0 = Indicates the SCLK low time-out interrupt is Disabled. + * | | |1 = Indicates the SCLK low time-out interrupt is Enabled. + * | | |BUSY =0. + * | | |0 = Indicates the bus IDLE time-out interrupt is Disabled. + * | | |1 = Indicates the bus IDLE time-out interrupt is Enabled. + * |[3] |CLKTOIEN |Extended Clock Time Out Interrupt Enable Bit + * | | |0 = Indicates the clock time out interrupt is Disabled. + * | | |1 = Indicates the clock time out interrupt is Enabled. + * |[4] |TORSTEN |Time Out Reset Enable Bit + * | | |0 = Indicates the I2C state machine reset is Disable. + * | | |1 = Indicates the I2C state machine reset is Enable. (The clock and data bus will be released to high) + * @var I2C_T::BUSSTS + * Offset: 0x58 I2C Bus Management Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BUSY |Bus Busy + * | | |Indicates that a communication is in progress on the bus + * | | |It is set by hardware when a START condition is detected + * | | |It is cleared by hardware when a STOP condition is detected + * | | |0 = The bus is IDLE (both SCLK and SDA High). + * | | |1 = The bus is busy. + * |[1] |BCDONE |Byte Count Transmission/Receive Done + * | | |0 = Indicates the byte count transmission/ receive is not finished when the PECEN is set. + * | | |1 = Indicates the byte count transmission/ receive is finished when the PECEN is set. + * | | |Note: Software can write 1 to clear this bit. + * |[2] |PECERR |PEC Error in Reception + * | | |0 = Indicates the PEC value equal the received PEC data packet. + * | | |1 = Indicates the PEC value doesn't match the receive PEC data packet. + * | | |Note: Software can write 1 to clear this bit. + * |[3] |ALERT |SMBus Alert Status + * | | |Device Mode (BMHEN =0). + * | | |0 = Indicates SMBALERT pin state is low. + * | | |1 = Indicates SMBALERT pin state is high. + * | | |Host Mode (BMHEN =1). + * | | |0 = No SMBALERT event. + * | | |1 = Indicates there is SMBALERT event (falling edge) is detected in SMALERT pin when the BMHEN = 1 (SMBus host configuration) and the ALERTEN = 1. + * | | |Note: + * | | |1. The SMBALERT pin is an open-drain pin, the pull-high resistor is must in the system + * | | |2. Software can write 1 to clear this bit. + * |[4] |SCTLDIN |Bus Suspend or Control Signal Input Status + * | | |0 = The input status of SUSCON pin is 0. + * | | |1 = The input status of SUSCON pin is 1. + * |[5] |BUSTO |Bus Time-out Status + * | | |0 = Indicates that there is no any time-out or external clock time-out. + * | | |1 = Indicates that a time-out or external clock time-out occurred. + * | | |In bus busy, the bit indicates the total clock low time-out event occurred otherwise, it indicates the bus idle time-out event occurred. + * | | |Note: Software can write 1 to clear this bit. + * |[6] |CLKTO |Clock Low Cumulate Time-out Status + * | | |0 = Indicates that the cumulative clock low is no any time-out. + * | | |1 = Indicates that the cumulative clock low time-out occurred. + * | | |Note: Software can write 1 to clear this bit. + * |[7] |PECDONE |PEC Byte Transmission/Receive Done + * | | |0 = Indicates the PEC transmission/ receive is not finished when the PECEN is set. + * | | |1 = Indicates the PEC transmission/ receive is finished when the PECEN is set. + * | | |Note: Software can write 1 to clear this bit. + * @var I2C_T::PKTSIZE + * Offset: 0x5C I2C Packet Error Checking Byte Number Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[8:0] |PLDSIZE |Transfer Byte Number + * | | |The transmission or receive byte number in one transaction when the PECEN is set + * | | |The maximum transaction or receive byte is 256 Bytes. + * | | |Notice: The byte number counting includes address, command code, and data frame. + * @var I2C_T::PKTCRC + * Offset: 0x60 I2C Packet Error Checking Byte Value Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |PECCRC |Packet Error Checking Byte Value + * | | |This byte indicates the packet error checking content after transmission or receive byte count by using the C(x) = X8 + X2 + X + 1 + * | | |It is read only. + * @var I2C_T::BUSTOUT + * Offset: 0x64 I2C Bus Management Timer Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |BUSTO |Bus Management Time-out Value + * | | |Indicate the bus time-out value in bus is IDLE or SCLK low. + * | | |Note: If the user wants to revise the value of BUSTOUT, the TORSTEN (I2C_BUSTCTL[4]) bit shall be set to 1 and clear to 0 first in the BUSEN(I2C_BUSCTL[7]) is set. + * @var I2C_T::CLKTOUT + * Offset: 0x68 I2C Bus Management Clock Low Timer Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |CLKTO |Bus Clock Low Timer + * | | |The field is used to configure the cumulative clock extension time-out. + * | | |Note: If the user wants to revise the value of CLKLTOUT, the TORSTEN bit shall be set to 1 and clear to 0 first in the BUSEN is set. + */ + __IO uint32_t CTL0; /*!< [0x0000] I2C Control Register 0 */ + __IO uint32_t ADDR0; /*!< [0x0004] I2C Slave Address Register0 */ + __IO uint32_t DAT; /*!< [0x0008] I2C Data Register */ + __I uint32_t STATUS0; /*!< [0x000c] I2C Status Register 0 */ + __IO uint32_t CLKDIV; /*!< [0x0010] I2C Clock Divided Register */ + __IO uint32_t TOCTL; /*!< [0x0014] I2C Time-out Control Register */ + __IO uint32_t ADDR1; /*!< [0x0018] I2C Slave Address Register1 */ + __IO uint32_t ADDR2; /*!< [0x001c] I2C Slave Address Register2 */ + __IO uint32_t ADDR3; /*!< [0x0020] I2C Slave Address Register3 */ + __IO uint32_t ADDRMSK0; /*!< [0x0024] I2C Slave Address Mask Register0 */ + __IO uint32_t ADDRMSK1; /*!< [0x0028] I2C Slave Address Mask Register1 */ + __IO uint32_t ADDRMSK2; /*!< [0x002c] I2C Slave Address Mask Register2 */ + __IO uint32_t ADDRMSK3; /*!< [0x0030] I2C Slave Address Mask Register3 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[2]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t WKCTL; /*!< [0x003c] I2C Wake-up Control Register */ + __IO uint32_t WKSTS; /*!< [0x0040] I2C Wake-up Status Register */ + __IO uint32_t CTL1; /*!< [0x0044] I2C Control Register 1 */ + __IO uint32_t STATUS1; /*!< [0x0048] I2C Status Register 1 */ + __IO uint32_t TMCTL; /*!< [0x004c] I2C Timing Configure Control Register */ + __IO uint32_t BUSCTL; /*!< [0x0050] I2C Bus Management Control Register */ + __IO uint32_t BUSTCTL; /*!< [0x0054] I2C Bus Management Timer Control Register */ + __IO uint32_t BUSSTS; /*!< [0x0058] I2C Bus Management Status Register */ + __IO uint32_t PKTSIZE; /*!< [0x005c] I2C Packet Error Checking Byte Number Register */ + __I uint32_t PKTCRC; /*!< [0x0060] I2C Packet Error Checking Byte Value Register */ + __IO uint32_t BUSTOUT; /*!< [0x0064] I2C Bus Management Timer Register */ + __IO uint32_t CLKTOUT; /*!< [0x0068] I2C Bus Management Clock Low Timer Register */ + +} I2C_T; + +/** + @addtogroup I2C_CONST I2C Bit Field Definition + Constant Definitions for I2C Controller +@{ */ + +#define I2C_CTL0_AA_Pos (2) /*!< I2C_T::CTL: AA Position */ +#define I2C_CTL0_AA_Msk (0x1ul << I2C_CTL0_AA_Pos) /*!< I2C_T::CTL: AA Mask */ + +#define I2C_CTL0_SI_Pos (3) /*!< I2C_T::CTL: SI Position */ +#define I2C_CTL0_SI_Msk (0x1ul << I2C_CTL0_SI_Pos) /*!< I2C_T::CTL: SI Mask */ + +#define I2C_CTL0_STO_Pos (4) /*!< I2C_T::CTL: STO Position */ +#define I2C_CTL0_STO_Msk (0x1ul << I2C_CTL0_STO_Pos) /*!< I2C_T::CTL: STO Mask */ + +#define I2C_CTL0_STA_Pos (5) /*!< I2C_T::CTL: STA Position */ +#define I2C_CTL0_STA_Msk (0x1ul << I2C_CTL0_STA_Pos) /*!< I2C_T::CTL: STA Mask */ + +#define I2C_CTL0_I2CEN_Pos (6) /*!< I2C_T::CTL: I2CEN Position */ +#define I2C_CTL0_I2CEN_Msk (0x1ul << I2C_CTL0_I2CEN_Pos) /*!< I2C_T::CTL: I2CEN Mask */ + +#define I2C_CTL0_INTEN_Pos (7) /*!< I2C_T::CTL: INTEN Position */ +#define I2C_CTL0_INTEN_Msk (0x1ul << I2C_CTL0_INTEN_Pos) /*!< I2C_T::CTL: INTEN Mask */ + +#define I2C_ADDR0_GC_Pos (0) /*!< I2C_T::ADDR0: GC Position */ +#define I2C_ADDR0_GC_Msk (0x1ul << I2C_ADDR0_GC_Pos) /*!< I2C_T::ADDR0: GC Mask */ + +#define I2C_ADDR0_ADDR_Pos (1) /*!< I2C_T::ADDR0: ADDR Position */ +#define I2C_ADDR0_ADDR_Msk (0x3fful << I2C_ADDR0_ADDR_Pos) /*!< I2C_T::ADDR0: ADDR Mask */ + +#define I2C_DAT_DAT_Pos (0) /*!< I2C_T::DAT: DAT Position */ +#define I2C_DAT_DAT_Msk (0xfful << I2C_DAT_DAT_Pos) /*!< I2C_T::DAT: DAT Mask */ + +#define I2C_STATUS0_STATUS_Pos (0) /*!< I2C_T::STATUS: STATUS Position */ +#define I2C_STATUS0_STATUS_Msk (0xfful << I2C_STATUS_STATUS0_Pos) /*!< I2C_T::STATUS: STATUS Mask */ + +#define I2C_CLKDIV_DIVIDER_Pos (0) /*!< I2C_T::CLKDIV: DIVIDER Position */ +#define I2C_CLKDIV_DIVIDER_Msk (0x3fful << I2C_CLKDIV_DIVIDER_Pos) /*!< I2C_T::CLKDIV: DIVIDER Mask */ + +#define I2C_TOCTL_TOIF_Pos (0) /*!< I2C_T::TOCTL: TOIF Position */ +#define I2C_TOCTL_TOIF_Msk (0x1ul << I2C_TOCTL_TOIF_Pos) /*!< I2C_T::TOCTL: TOIF Mask */ + +#define I2C_TOCTL_TOCDIV4_Pos (1) /*!< I2C_T::TOCTL: TOCDIV4 Position */ +#define I2C_TOCTL_TOCDIV4_Msk (0x1ul << I2C_TOCTL_TOCDIV4_Pos) /*!< I2C_T::TOCTL: TOCDIV4 Mask */ + +#define I2C_TOCTL_TOCEN_Pos (2) /*!< I2C_T::TOCTL: TOCEN Position */ +#define I2C_TOCTL_TOCEN_Msk (0x1ul << I2C_TOCTL_TOCEN_Pos) /*!< I2C_T::TOCTL: TOCEN Mask */ + +#define I2C_ADDR1_GC_Pos (0) /*!< I2C_T::ADDR1: GC Position */ +#define I2C_ADDR1_GC_Msk (0x1ul << I2C_ADDR1_GC_Pos) /*!< I2C_T::ADDR1: GC Mask */ + +#define I2C_ADDR1_ADDR_Pos (1) /*!< I2C_T::ADDR1: ADDR Position */ +#define I2C_ADDR1_ADDR_Msk (0x3fful << I2C_ADDR1_ADDR_Pos) /*!< I2C_T::ADDR1: ADDR Mask */ + +#define I2C_ADDR2_GC_Pos (0) /*!< I2C_T::ADDR2: GC Position */ +#define I2C_ADDR2_GC_Msk (0x1ul << I2C_ADDR2_GC_Pos) /*!< I2C_T::ADDR2: GC Mask */ + +#define I2C_ADDR2_ADDR_Pos (1) /*!< I2C_T::ADDR2: ADDR Position */ +#define I2C_ADDR2_ADDR_Msk (0x3fful << I2C_ADDR2_ADDR_Pos) /*!< I2C_T::ADDR2: ADDR Mask */ + +#define I2C_ADDR3_GC_Pos (0) /*!< I2C_T::ADDR3: GC Position */ +#define I2C_ADDR3_GC_Msk (0x1ul << I2C_ADDR3_GC_Pos) /*!< I2C_T::ADDR3: GC Mask */ + +#define I2C_ADDR3_ADDR_Pos (1) /*!< I2C_T::ADDR3: ADDR Position */ +#define I2C_ADDR3_ADDR_Msk (0x3fful << I2C_ADDR3_ADDR_Pos) /*!< I2C_T::ADDR3: ADDR Mask */ + +#define I2C_ADDRMSK0_ADDRMSK_Pos (1) /*!< I2C_T::ADDRMSK0: ADDRMSK Position */ +#define I2C_ADDRMSK0_ADDRMSK_Msk (0x3fful << I2C_ADDRMSK0_ADDRMSK_Pos) /*!< I2C_T::ADDRMSK0: ADDRMSK Mask */ + +#define I2C_ADDRMSK1_ADDRMSK_Pos (1) /*!< I2C_T::ADDRMSK1: ADDRMSK Position */ +#define I2C_ADDRMSK1_ADDRMSK_Msk (0x3fful << I2C_ADDRMSK1_ADDRMSK_Pos) /*!< I2C_T::ADDRMSK1: ADDRMSK Mask */ + +#define I2C_ADDRMSK2_ADDRMSK_Pos (1) /*!< I2C_T::ADDRMSK2: ADDRMSK Position */ +#define I2C_ADDRMSK2_ADDRMSK_Msk (0x3fful << I2C_ADDRMSK2_ADDRMSK_Pos) /*!< I2C_T::ADDRMSK2: ADDRMSK Mask */ + +#define I2C_ADDRMSK3_ADDRMSK_Pos (1) /*!< I2C_T::ADDRMSK3: ADDRMSK Position */ +#define I2C_ADDRMSK3_ADDRMSK_Msk (0x3fful << I2C_ADDRMSK3_ADDRMSK_Pos) /*!< I2C_T::ADDRMSK3: ADDRMSK Mask */ + +#define I2C_WKCTL_WKEN_Pos (0) /*!< I2C_T::WKCTL: WKEN Position */ +#define I2C_WKCTL_WKEN_Msk (0x1ul << I2C_WKCTL_WKEN_Pos) /*!< I2C_T::WKCTL: WKEN Mask */ + +#define I2C_WKCTL_NHDBUSEN_Pos (7) /*!< I2C_T::WKCTL: NHDBUSEN Position */ +#define I2C_WKCTL_NHDBUSEN_Msk (0x1ul << I2C_WKCTL_NHDBUSEN_Pos) /*!< I2C_T::WKCTL: NHDBUSEN Mask */ + +#define I2C_WKSTS_WKIF_Pos (0) /*!< I2C_T::WKSTS: WKIF Position */ +#define I2C_WKSTS_WKIF_Msk (0x1ul << I2C_WKSTS_WKIF_Pos) /*!< I2C_T::WKSTS: WKIF Mask */ + +#define I2C_WKSTS_WKAKDONE_Pos (1) /*!< I2C_T::WKSTS: WKAKDONE Position */ +#define I2C_WKSTS_WKAKDONE_Msk (0x1ul << I2C_WKSTS_WKAKDONE_Pos) /*!< I2C_T::WKSTS: WKAKDONE Mask */ + +#define I2C_WKSTS_WRSTSWK_Pos (2) /*!< I2C_T::WKSTS: WRSTSWK Position */ +#define I2C_WKSTS_WRSTSWK_Msk (0x1ul << I2C_WKSTS_WRSTSWK_Pos) /*!< I2C_T::WKSTS: WRSTSWK Mask */ + +#define I2C_CTL1_TXPDMAEN_Pos (0) /*!< I2C_T::CTL1: TXPDMAEN Position */ +#define I2C_CTL1_TXPDMAEN_Msk (0x1ul << I2C_CTL1_TXPDMAEN_Pos) /*!< I2C_T::CTL1: TXPDMAEN Mask */ + +#define I2C_CTL1_RXPDMAEN_Pos (1) /*!< I2C_T::CTL1: RXPDMAEN Position */ +#define I2C_CTL1_RXPDMAEN_Msk (0x1ul << I2C_CTL1_RXPDMAEN_Pos) /*!< I2C_T::CTL1: RXPDMAEN Mask */ + +#define I2C_CTL1_PDMARST_Pos (2) /*!< I2C_T::CTL1: PDMARST Position */ +#define I2C_CTL1_PDMARST_Msk (0x1ul << I2C_CTL1_PDMARST_Pos) /*!< I2C_T::CTL1: PDMARST Mask */ + +#define I2C_CTL1_PDMASTR_Pos (8) /*!< I2C_T::CTL1: PDMASTR Position */ +#define I2C_CTL1_PDMASTR_Msk (0x1ul << I2C_CTL1_PDMASTR_Pos) /*!< I2C_T::CTL1: PDMASTR Mask */ + +#define I2C_CTL1_ADDR10EN_Pos (9) /*!< I2C_T::CTL1: ADDR10EN Position */ +#define I2C_CTL1_ADDR10EN_Msk (0x1ul << I2C_CTL1_ADDR10EN_Pos) /*!< I2C_T::CTL1: ADDR10EN Mask */ + +#define I2C_STATUS1_ADMAT0_Pos (0) /*!< I2C_T::STATUS1: ADMAT0 Position */ +#define I2C_STATUS1_ADMAT0_Msk (0x1ul << I2C_STATUS1_ADMAT0_Pos) /*!< I2C_T::STATUS1: ADMAT0 Mask */ + +#define I2C_STATUS1_ADMAT1_Pos (1) /*!< I2C_T::STATUS1: ADMAT1 Position */ +#define I2C_STATUS1_ADMAT1_Msk (0x1ul << I2C_STATUS1_ADMAT1_Pos) /*!< I2C_T::STATUS1: ADMAT1 Mask */ + +#define I2C_STATUS1_ADMAT2_Pos (2) /*!< I2C_T::STATUS1: ADMAT2 Position */ +#define I2C_STATUS1_ADMAT2_Msk (0x1ul << I2C_STATUS1_ADMAT2_Pos) /*!< I2C_T::STATUS1: ADMAT2 Mask */ + +#define I2C_STATUS1_ADMAT3_Pos (3) /*!< I2C_T::STATUS1: ADMAT3 Position */ +#define I2C_STATUS1_ADMAT3_Msk (0x1ul << I2C_STATUS1_ADMAT3_Pos) /*!< I2C_T::STATUS1: ADMAT3 Mask */ + +#define I2C_STATUS1_ONBUSY_Pos (8) /*!< I2C_T::STATUS1: ONBUSY Position */ +#define I2C_STATUS1_ONBUSY_Msk (0x1ul << I2C_STATUS1_ONBUSY_Pos) /*!< I2C_T::STATUS1: ONBUSY Mask */ + +#define I2C_TMCTL_STCTL_Pos (0) /*!< I2C_T::TMCTL: STCTL Position */ +#define I2C_TMCTL_STCTL_Msk (0x1fful << I2C_TMCTL_STCTL_Pos) /*!< I2C_T::TMCTL: STCTL Mask */ + +#define I2C_TMCTL_HTCTL_Pos (16) /*!< I2C_T::TMCTL: HTCTL Position */ +#define I2C_TMCTL_HTCTL_Msk (0x1fful << I2C_TMCTL_HTCTL_Pos) /*!< I2C_T::TMCTL: HTCTL Mask */ + +#define I2C_BUSCTL_ACKMEN_Pos (0) /*!< I2C_T::BUSCTL: ACKMEN Position */ +#define I2C_BUSCTL_ACKMEN_Msk (0x1ul << I2C_BUSCTL_ACKMEN_Pos) /*!< I2C_T::BUSCTL: ACKMEN Mask */ + +#define I2C_BUSCTL_PECEN_Pos (1) /*!< I2C_T::BUSCTL: PECEN Position */ +#define I2C_BUSCTL_PECEN_Msk (0x1ul << I2C_BUSCTL_PECEN_Pos) /*!< I2C_T::BUSCTL: PECEN Mask */ + +#define I2C_BUSCTL_BMDEN_Pos (2) /*!< I2C_T::BUSCTL: BMDEN Position */ +#define I2C_BUSCTL_BMDEN_Msk (0x1ul << I2C_BUSCTL_BMDEN_Pos) /*!< I2C_T::BUSCTL: BMDEN Mask */ + +#define I2C_BUSCTL_BMHEN_Pos (3) /*!< I2C_T::BUSCTL: BMHEN Position */ +#define I2C_BUSCTL_BMHEN_Msk (0x1ul << I2C_BUSCTL_BMHEN_Pos) /*!< I2C_T::BUSCTL: BMHEN Mask */ + +#define I2C_BUSCTL_ALERTEN_Pos (4) /*!< I2C_T::BUSCTL: ALERTEN Position */ +#define I2C_BUSCTL_ALERTEN_Msk (0x1ul << I2C_BUSCTL_ALERTEN_Pos) /*!< I2C_T::BUSCTL: ALERTEN Mask */ + +#define I2C_BUSCTL_SCTLOSTS_Pos (5) /*!< I2C_T::BUSCTL: SCTLOSTS Position */ +#define I2C_BUSCTL_SCTLOSTS_Msk (0x1ul << I2C_BUSCTL_SCTLOSTS_Pos) /*!< I2C_T::BUSCTL: SCTLOSTS Mask */ + +#define I2C_BUSCTL_SCTLOEN_Pos (6) /*!< I2C_T::BUSCTL: SCTLOEN Position */ +#define I2C_BUSCTL_SCTLOEN_Msk (0x1ul << I2C_BUSCTL_SCTLOEN_Pos) /*!< I2C_T::BUSCTL: SCTLOEN Mask */ + +#define I2C_BUSCTL_BUSEN_Pos (7) /*!< I2C_T::BUSCTL: BUSEN Position */ +#define I2C_BUSCTL_BUSEN_Msk (0x1ul << I2C_BUSCTL_BUSEN_Pos) /*!< I2C_T::BUSCTL: BUSEN Mask */ + +#define I2C_BUSCTL_PECTXEN_Pos (8) /*!< I2C_T::BUSCTL: PECTXEN Position */ +#define I2C_BUSCTL_PECTXEN_Msk (0x1ul << I2C_BUSCTL_PECTXEN_Pos) /*!< I2C_T::BUSCTL: PECTXEN Mask */ + +#define I2C_BUSCTL_TIDLE_Pos (9) /*!< I2C_T::BUSCTL: TIDLE Position */ +#define I2C_BUSCTL_TIDLE_Msk (0x1ul << I2C_BUSCTL_TIDLE_Pos) /*!< I2C_T::BUSCTL: TIDLE Mask */ + +#define I2C_BUSCTL_PECCLR_Pos (10) /*!< I2C_T::BUSCTL: PECCLR Position */ +#define I2C_BUSCTL_PECCLR_Msk (0x1ul << I2C_BUSCTL_PECCLR_Pos) /*!< I2C_T::BUSCTL: PECCLR Mask */ + +#define I2C_BUSCTL_ACKM9SI_Pos (11) /*!< I2C_T::BUSCTL: ACKM9SI Position */ +#define I2C_BUSCTL_ACKM9SI_Msk (0x1ul << I2C_BUSCTL_ACKM9SI_Pos) /*!< I2C_T::BUSCTL: ACKM9SI Mask */ + +#define I2C_BUSCTL_BCDIEN_Pos (12) /*!< I2C_T::BUSCTL: BCDIEN Position */ +#define I2C_BUSCTL_BCDIEN_Msk (0x1ul << I2C_BUSCTL_BCDIEN_Pos) /*!< I2C_T::BUSCTL: BCDIEN Mask */ + +#define I2C_BUSCTL_PECDIEN_Pos (13) /*!< I2C_T::BUSCTL: PECDIEN Position */ +#define I2C_BUSCTL_PECDIEN_Msk (0x1ul << I2C_BUSCTL_PECDIEN_Pos) /*!< I2C_T::BUSCTL: PECDIEN Mask */ + +#define I2C_BUSTCTL_BUSTOEN_Pos (0) /*!< I2C_T::BUSTCTL: BUSTOEN Position */ +#define I2C_BUSTCTL_BUSTOEN_Msk (0x1ul << I2C_BUSTCTL_BUSTOEN_Pos) /*!< I2C_T::BUSTCTL: BUSTOEN Mask */ + +#define I2C_BUSTCTL_CLKTOEN_Pos (1) /*!< I2C_T::BUSTCTL: CLKTOEN Position */ +#define I2C_BUSTCTL_CLKTOEN_Msk (0x1ul << I2C_BUSTCTL_CLKTOEN_Pos) /*!< I2C_T::BUSTCTL: CLKTOEN Mask */ + +#define I2C_BUSTCTL_BUSTOIEN_Pos (2) /*!< I2C_T::BUSTCTL: BUSTOIEN Position */ +#define I2C_BUSTCTL_BUSTOIEN_Msk (0x1ul << I2C_BUSTCTL_BUSTOIEN_Pos) /*!< I2C_T::BUSTCTL: BUSTOIEN Mask */ + +#define I2C_BUSTCTL_CLKTOIEN_Pos (3) /*!< I2C_T::BUSTCTL: CLKTOIEN Position */ +#define I2C_BUSTCTL_CLKTOIEN_Msk (0x1ul << I2C_BUSTCTL_CLKTOIEN_Pos) /*!< I2C_T::BUSTCTL: CLKTOIEN Mask */ + +#define I2C_BUSTCTL_TORSTEN_Pos (4) /*!< I2C_T::BUSTCTL: TORSTEN Position */ +#define I2C_BUSTCTL_TORSTEN_Msk (0x1ul << I2C_BUSTCTL_TORSTEN_Pos) /*!< I2C_T::BUSTCTL: TORSTEN Mask */ + +#define I2C_BUSSTS_BUSY_Pos (0) /*!< I2C_T::BUSSTS: BUSY Position */ +#define I2C_BUSSTS_BUSY_Msk (0x1ul << I2C_BUSSTS_BUSY_Pos) /*!< I2C_T::BUSSTS: BUSY Mask */ + +#define I2C_BUSSTS_BCDONE_Pos (1) /*!< I2C_T::BUSSTS: BCDONE Position */ +#define I2C_BUSSTS_BCDONE_Msk (0x1ul << I2C_BUSSTS_BCDONE_Pos) /*!< I2C_T::BUSSTS: BCDONE Mask */ + +#define I2C_BUSSTS_PECERR_Pos (2) /*!< I2C_T::BUSSTS: PECERR Position */ +#define I2C_BUSSTS_PECERR_Msk (0x1ul << I2C_BUSSTS_PECERR_Pos) /*!< I2C_T::BUSSTS: PECERR Mask */ + +#define I2C_BUSSTS_ALERT_Pos (3) /*!< I2C_T::BUSSTS: ALERT Position */ +#define I2C_BUSSTS_ALERT_Msk (0x1ul << I2C_BUSSTS_ALERT_Pos) /*!< I2C_T::BUSSTS: ALERT Mask */ + +#define I2C_BUSSTS_SCTLDIN_Pos (4) /*!< I2C_T::BUSSTS: SCTLDIN Position */ +#define I2C_BUSSTS_SCTLDIN_Msk (0x1ul << I2C_BUSSTS_SCTLDIN_Pos) /*!< I2C_T::BUSSTS: SCTLDIN Mask */ + +#define I2C_BUSSTS_BUSTO_Pos (5) /*!< I2C_T::BUSSTS: BUSTO Position */ +#define I2C_BUSSTS_BUSTO_Msk (0x1ul << I2C_BUSSTS_BUSTO_Pos) /*!< I2C_T::BUSSTS: BUSTO Mask */ + +#define I2C_BUSSTS_CLKTO_Pos (6) /*!< I2C_T::BUSSTS: CLKTO Position */ +#define I2C_BUSSTS_CLKTO_Msk (0x1ul << I2C_BUSSTS_CLKTO_Pos) /*!< I2C_T::BUSSTS: CLKTO Mask */ + +#define I2C_BUSSTS_PECDONE_Pos (7) /*!< I2C_T::BUSSTS: PECDONE Position */ +#define I2C_BUSSTS_PECDONE_Msk (0x1ul << I2C_BUSSTS_PECDONE_Pos) /*!< I2C_T::BUSSTS: PECDONE Mask */ + +#define I2C_PKTSIZE_PLDSIZE_Pos (0) /*!< I2C_T::PKTSIZE: PLDSIZE Position */ +#define I2C_PKTSIZE_PLDSIZE_Msk (0x1fful << I2C_PKTSIZE_PLDSIZE_Pos) /*!< I2C_T::PKTSIZE: PLDSIZE Mask */ + +#define I2C_PKTCRC_PECCRC_Pos (0) /*!< I2C_T::PKTCRC: PECCRC Position */ +#define I2C_PKTCRC_PECCRC_Msk (0xfful << I2C_PKTCRC_PECCRC_Pos) /*!< I2C_T::PKTCRC: PECCRC Mask */ + +#define I2C_BUSTOUT_BUSTO_Pos (0) /*!< I2C_T::BUSTOUT: BUSTO Position */ +#define I2C_BUSTOUT_BUSTO_Msk (0xfful << I2C_BUSTOUT_BUSTO_Pos) /*!< I2C_T::BUSTOUT: BUSTO Mask */ + +#define I2C_CLKTOUT_CLKTO_Pos (0) /*!< I2C_T::CLKTOUT: CLKTO Position */ +#define I2C_CLKTOUT_CLKTO_Msk (0xfful << I2C_CLKTOUT_CLKTO_Pos) /*!< I2C_T::CLKTOUT: CLKTO Mask */ + +/**@}*/ /* I2C_CONST */ +/**@}*/ /* end of I2C register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __I2C_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/i2s_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/i2s_reg.h new file mode 100644 index 00000000000..ed8e34b6c32 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/i2s_reg.h @@ -0,0 +1,707 @@ +/**************************************************************************//** + * @file i2s_reg.h + * @version V1.00 + * @brief I2S register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __I2S_REG_H__ +#define __I2S_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup I2S I2S Interface Controller(I2S) + Memory Mapped Structure for I2S Controller +@{ */ + +typedef struct +{ + + + /** + * @var I2S_T::CTL0 + * Offset: 0x00 I2S Control Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |I2SEN |I2S Controller Enable Control + * | | |0 = I2S controller Disabled. + * | | |1 = I2S controller Enabled. + * |[1] |TXEN |Transmit Enable Control + * | | |0 = Data transmission Disabled. + * | | |1 = Data transmission Enabled. + * |[2] |RXEN |Receive Enable Control + * | | |0 = Data receiving Disabled. + * | | |1 = Data receiving Enabled. + * |[3] |MUTE |Transmit Mute Enable Control + * | | |0 = Transmit data is shifted from buffer. + * | | |1 = Send zero on transmit channel. + * |[5:4] |DATWIDTH |Data Width + * | | |This bit field is used to define the bit-width of data word in each audio channel + * | | |00 = The bit-width of data word is 8-bit. + * | | |01 = The bit-width of data word is 16-bit. + * | | |10 = The bit-width of data word is 24-bit. + * | | |11 = The bit-width of data word is 32-bit. + * |[6] |MONO |Monaural Data Control + * | | |0 = Data is stereo format. + * | | |1 = Data is monaural format. + * | | |Note: when chip records data, RXLCH (I2S_CTL0[23]) indicates which channel data will be saved if monaural format is selected. + * |[7] |ORDER |Stereo Data Order in FIFO + * | | |In 8-bit/16-bit data width, this bit is used to select whether the even or odd channel data is stored in higher byte + * | | |In 24-bit data width, this is used to select the left/right alignment method of audio data which is stored in data memory consisted of 32-bit FIFO entries. + * | | |0 = Even channel data at high byte in 8-bit/16-bit data width. + * | | |LSB of 24-bit audio data in each channel is aligned to right side in 32-bit FIFO entries. + * | | |1 = Even channel data at low byte. + * | | | MSB of 24-bit audio data in each channel is aligned to left side in 32-bit FIFO entries. + * |[8] |SLAVE |Slave Mode Enable Control + * | | |0 = Master mode. + * | | |1 = Slave mode. + * | | |Note: I2S can operate as master or slave + * | | |For Master mode, I2S_BCLK and I2S_LRCLK pins are output mode and send out bit clock to Audio CODEC chip + * | | |In Slave mode, I2S_BCLK and I2S_LRCLK pins are input mode and I2S_BCLK and I2S_LRCLK signals are received from outer Audio CODEC chip. + * |[15] |MCLKEN |Master Clock Enable Control + * | | |If MCLKEN is set to 1, I2S controller will generate master clock on I2S_MCLK pin for external audio devices. + * | | |0 = Master clock Disabled. + * | | |1 = Master clock Enabled. + * |[18] |TXFBCLR |Transmit FIFO Buffer Clear + * | | |0 = No Effect. + * | | |1 = Clear TX FIFO. + * | | |Note1: Write 1 to clear transmit FIFO, internal pointer is reset to FIFO start point, and TXCNT (I2S_STATUS1[12:8]) returns 0 and transmit FIFO becomes empty but data in transmit FIFO is not changed. + * | | |Note2: This bit is clear by hardware automatically, read it return zero. + * |[19] |RXFBCLR |Receive FIFO Buffer Clear + * | | |0 = No Effect. + * | | |1 = Clear RX FIFO. + * | | |Note1: Write 1 to clear receive FIFO, internal pointer is reset to FIFO start point, and RXCNT (I2S_STATUS1[20:16]) returns 0 and receive FIFO becomes empty. + * | | |Note2: This bit is cleared by hardware automatically, read it return zero. + * |[20] |TXPDMAEN |Transmit PDMA Enable Control + * | | |0 = Transmit PDMA function Disabled. + * | | |1 = Transmit PDMA function Enabled. + * |[21] |RXPDMAEN |Receive PDMA Enable Control + * | | |0 = Receiver PDMA function Disabled. + * | | |1 = Receiver PDMA function Enabled. + * |[23] |RXLCH |Receive Left Channel Enable Control + * | | |When monaural format is selected (MONO = 1), I2S will receive channel1 data if RXLCH is set to 0, and receive channel0 data if RXLCH is set to 1. + * | | |0 = Receives channel1 data in MONO mode. + * | | |1 = Receives channel0 data in MONO mode. + * |[26:24] |FORMAT |Data Format Selection + * | | |000 = I2S standard data format. + * | | |001 = I2S with MSB justified. + * | | |010 = I2S with LSB justified. + * | | |011 = Reserved. + * | | |100 = PCM standard data format. + * | | |101 = PCM with MSB justified. + * | | |110 = PCM with LSB justified. + * | | |111 = Reserved. + * |[27] |PCMSYNC |PCM Synchronization Pulse Length Selection + * | | |This bit field is used to select the high pulse length of frame synchronization signal in PCM protocol + * | | |0 = One BCLK period. + * | | |1 = One channel period. + * | | |Note: This bit is only available in master mode + * |[29:28] |CHWIDTH |Channel Width + * | | |This bit fields are used to define the length of audio channel + * | | |If CHWIDTH < DATWIDTH, the hardware will set the real channel length as the bit-width of audio data which is defined by DATWIDTH. + * | | |00 = The bit-width of each audio channel is 8-bit. + * | | |01 = The bit-width of each audio channel is 16-bit. + * | | |10 = The bit-width of each audio channel is 24-bit. + * | | |11 = The bit-width of each audio channel is 32-bit. + * |[31:30] |TDMCHNUM |TDM Channel Number + * | | |This bit fields are used to define the TDM channel number in one audio frame while PCM mode (FORMAT[2] = 1). + * | | |00 = 2 channels in audio frame. + * | | |01 = 4 channels in audio frame. + * | | |10 = 6 channels in audio frame. + * | | |11 = 8 channels in audio frame. + * @var I2S_T::CLKDIV + * Offset: 0x04 I2S Clock Divider Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[5:0] |MCLKDIV |Master Clock Divider + * | | |If chip external crystal frequency is (2xMCLKDIV)*256fs then software can program these bits to generate 256fs clock frequency to audio codec chip + * | | |If MCLKDIV is set to 0, MCLK is the same as external clock input. + * | | |For example, sampling rate is 24 kHz and chip external crystal clock is 12.288 MHz, set MCLKDIV = 1. + * | | |F_MCLK = F_I2SCLK/(2x(MCLKDIV)) (When MCLKDIV is >= 1 ). + * | | |F_MCLK = F_I2SCLK (When MCLKDIV is set to 0 ). + * | | |Note: F_MCLK is the frequency of MCLK, and F_I2SCLK is the frequency of the I2S_CLK + * |[16:8] |BCLKDIV |Bit Clock Divider + * | | |The I2S controller will generate bit clock in Master mode + * | | |Software can program these bit fields to generate sampling rate clock frequency. + * | | |F_BCLK= F_I2SCLK / (2*(BCLKDIV + 1)). + * | | |Note: F_BCLK is the frequency of BCLK and F_I2SCLK is the frequency of I2S_CLK + * @var I2S_T::IEN + * Offset: 0x08 I2S Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |RXUDFIEN |Receive FIFO Underflow Interrupt Enable Control + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * | | |Note: If software reads receive FIFO when it is empty then RXUDIF (I2S_STATUS0[8]) flag is set to 1. + * |[1] |RXOVFIEN |Receive FIFO Overflow Interrupt Enable Control + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * | | |Note: Interrupt occurs if this bit is set to 1 and RXOVIF (I2S_STATUS0[9]) flag is set to 1 + * |[2] |RXTHIEN |Receive FIFO Threshold Level Interrupt Enable Control + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * | | |Note: When data word in receive FIFO is equal or higher than RXTH (I2S_CTL1[19:16]) and the RXTHIF (I2S_STATUS0[10]) bit is set to 1 + * | | |If RXTHIEN bit is enabled, interrupt occur. + * |[8] |TXUDFIEN |Transmit FIFO Underflow Interrupt Enable Control + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * | | |Note: Interrupt occur if this bit is set to 1 and TXUDIF (I2S_STATUS0[16]) flag is set to 1. + * |[9] |TXOVFIEN |Transmit FIFO Overflow Interrupt Enable Control + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * | | |Note: Interrupt occurs if this bit is set to 1 and TXOVIF (I2S_STATUS0[17]) flag is set to 1 + * |[10] |TXTHIEN |Transmit FIFO Threshold Level Interrupt Enable Control + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * | | |Note: Interrupt occurs if this bit is set to 1 and data words in transmit FIFO is less than TXTH (I2S_CTL1[11:8]). + * |[16] |CH0ZCIEN |Channel0 Zero-cross Interrupt Enable Control + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * | | |Note1: Interrupt occurs if this bit is set to 1 and channel0 zero-cross + * | | |Note2: Channel0 also means left audio channel while I2S (FORMAT[2]=0) or 2-channel PCM mode. + * |[17] |CH1ZCIEN |Channel1 Zero-cross Interrupt Enable Control + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * | | |Note1: Interrupt occurs if this bit is set to 1 and channel1 zero-cross + * | | |Note2: Channel1 also means right audio channel while I2S (FORMAT[2]=0) or 2-channel PCM mode. + * |[18] |CH2ZCIEN |Channel2 Zero-cross Interrupt Enable Control + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * | | |Note1: Interrupt occurs if this bit is set to 1 and channel2 zero-cross + * | | |Note2: This bit is available while multi-channel PCM mode and TDMCHNUM (I2S_CTL0[31:30]) = 0x1, 0x2, 0x3. + * |[19] |CH3ZCIEN |Channel3 Zero-cross Interrupt Enable Control + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * | | |Note1: Interrupt occurs if this bit is set to 1 and channel3 zero-cross + * | | |Note2: This bit is available while multi-channel PCM mode and TDMCHNUM (I2S_CTL0[31:30]) = 0x1, 0x2, 0x3. + * |[20] |CH4ZCIEN |Channel4 Zero-cross Interrupt Enable Control + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * | | |Note1: Interrupt occurs if this bit is set to 1 and channel4 zero-cross + * | | |Note2: This bit is available while multi-channel PCM mode and TDMCHNUM (I2S_CTL0[31:30]) = 0x1, 0x2, 0x3. + * |[21] |CH5ZCIEN |Channel5 Zero-cross Interrupt Enable Control + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * | | |Note1: Interrupt occurs if this bit is set to 1 and channel5 zero-cross + * | | |Note2: This bit is available while multi-channel PCM mode and TDMCHNUM (I2S_CTL0[31:30]) = 0x1, 0x2, 0x3. + * |[22] |CH6ZCIEN |Channel6 Zero-cross Interrupt Enable Control + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * | | |Note1: Interrupt occurs if this bit is set to 1 and channel6 zero-cross + * | | |Note2: This bit is available while multi-channel PCM mode and TDMCHNUM (I2S_CTL0[31:30]) = 0x1, 0x2, 0x3. + * |[23] |CH7ZCIEN |Channel7 Zero-cross Interrupt Enable Control + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * | | |Note1: Interrupt occurs if this bit is set to 1 and channel7 zero-cross + * | | |Note2: This bit is available while multi-channel PCM mode and TDMCHNUM (I2S_CTL0[31:30]) = 0x1, 0x2, 0x3. + * @var I2S_T::STATUS0 + * Offset: 0x0C I2S Status Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |I2SINT |I2S Interrupt Flag (Read Only) + * | | |0 = No I2S interrupt. + * | | |1 = I2S interrupt. + * | | |Note: It is wire-OR of I2STXINT and I2SRXINT bits. + * |[1] |I2SRXINT |I2S Receive Interrupt (Read Only) + * | | |0 = No receive interrupt. + * | | |1 = Receive interrupt. + * |[2] |I2STXINT |I2S Transmit Interrupt (Read Only) + * | | |0 = No transmit interrupt. + * | | |1 = Transmit interrupt. + * |[5:3] |DATACH |Transmission Data Channel (Read Only) + * | | |This bit fields are used to indicate which audio channel is current transmit data belong. + * | | |000 = channel0 (means left channel while 2-channel I2S/PCM mode). + * | | |001 = channel1 (means right channel while 2-channel I2S/PCM mode). + * | | |010 = channel2 (available while 4-channel TDM PCM mode). + * | | |011 = channel3 (available while 4-channel TDM PCM mode). + * | | |100 = channel4 (available while 6-channel TDM PCM mode). + * | | |101 = channel5 (available while 6-channel TDM PCM mode). + * | | |110 = channel6 (available while 8-channel TDM PCM mode). + * | | |111 = channel7 (available while 8-channel TDM PCM mode). + * |[8] |RXUDIF |Receive FIFO Underflow Interrupt Flag + * | | |0 = No underflow occur. + * | | |1 = Underflow occur. + * | | |Note1: When receive FIFO is empty, and software reads the receive FIFO again + * | | |This bit will be set to 1, and it indicates underflow situation occurs. + * | | |Note2: Write 1 to clear this bit to zero + * |[9] |RXOVIF |Receive FIFO Overflow Interrupt Flag + * | | |0 = No overflow occur. + * | | |1 = Overflow occur. + * | | |Note1: When receive FIFO is full and receive hardware attempt to write data into receive FIFO then this bit is set to 1, data in 1st buffer is overwrote. + * | | |Note2: Write 1 to clear this bit to 0. + * |[10] |RXTHIF |Receive FIFO Threshold Interrupt Flag (Read Only) + * | | |0 = Data word(s) in FIFO is not higher than threshold level. + * | | |1 = Data word(s) in FIFO is higher than threshold level. + * | | |Note: When data word(s) in receive FIFO is higher than threshold value set in RXTH (I2S_CTL1[19:16]) the RXTHIF bit becomes to 1 + * | | |It keeps at 1 till RXCNT (I2S_STATUS1[20:16]) is not higher than RXTH (I2S_CTL1[19:16]) after software read RXFIFO register. + * |[11] |RXFULL |Receive FIFO Full (Read Only) + * | | |0 = Not full. + * | | |1 = Full. + * | | |Note: This bit reflects data words number in receive FIFO is 16. + * |[12] |RXEMPTY |Receive FIFO Empty (Read Only) + * | | |0 = Not empty. + * | | |1 = Empty. + * | | |Note: This bit reflects data words number in receive FIFO is zero + * |[16] |TXUDIF |Transmit FIFO Underflow Interrupt Flag + * | | |0 = No underflow. + * | | |1 = Underflow. + * | | |Note1: This bit will be set to 1 when shift logic hardware read data from transmitting FIFO and the filling data level in transmitting FIFO is not enough for one audio frame. + * | | |Note2: Write 1 to clear this bit to 0. + * |[17] |TXOVIF |Transmit FIFO Overflow Interrupt Flag + * | | |0 = No overflow. + * | | |1 = Overflow. + * | | |Note1: Write data to transmit FIFO when it is full and this bit set to 1 + * | | |Note2: Write 1 to clear this bit to 0. + * |[18] |TXTHIF |Transmit FIFO Threshold Interrupt Flag (Read Only) + * | | |0 = Data word(s) in FIFO is higher than threshold level. + * | | |1 = Data word(s) in FIFO is equal or lower than threshold level. + * | | |Note: When data word(s) in transmit FIFO is equal or lower than threshold value set in TXTH (I2S_CTL1[11:8]) the TXTHIF bit becomes to 1 + * | | |It keeps at 1 till TXCNT (I2S_STATUS1[12:8]) is higher than TXTH (I2S_CTL1[11:8]) after software write TXFIFO register. + * |[19] |TXFULL |Transmit FIFO Full (Read Only) + * | | |This bit reflect data word number in transmit FIFO is 16 + * | | |0 = Not full. + * | | |1 = Full. + * |[20] |TXEMPTY |Transmit FIFO Empty (Read Only) + * | | |This bit reflect data word number in transmit FIFO is zero + * | | |0 = Not empty. + * | | |1 = Empty. + * |[21] |TXBUSY |Transmit Busy (Read Only) + * | | |0 = Transmit shift buffer is empty. + * | | |1 = Transmit shift buffer is busy. + * | | |Note: This bit is cleared to 0 when all data in transmit FIFO and shift buffer is shifted out + * | | |And set to 1 when 1st data is load to shift buffer + * @var I2S_T::TXFIFO + * Offset: 0x10 I2S Transmit FIFO Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |TXFIFO |Transmit FIFO Bits + * | | |I2S contains 16 words (16x32 bit) data buffer for data transmit + * | | |Write data to this register to prepare data for transmit + * | | |The remaining word number is indicated by TXCNT (I2S_STATUS1[12:8]). + * @var I2S_T::RXFIFO + * Offset: 0x14 I2S Receive FIFO Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |RXFIFO |Receive FIFO Bits + * | | |I2S contains 16 words (16x32 bit) data buffer for data receive + * | | |Read this register to get data in FIFO + * | | |The remaining data word number is indicated by RXCNT (I2S_STATUS1[20:16]). + * @var I2S_T::CTL1 + * Offset: 0x20 I2S Control Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CH0ZCEN |Channel0 Zero-cross Detection Enable Control + * | | |0 = channel0 zero-cross detect Disabled. + * | | |1 = channel0 zero-cross detect Enabled. + * | | |Note1: Channel0 also means left audio channel while I2S (FORMAT[2]=0) or 2-channel PCM mode. + * | | |Note2: If this bit is set to 1, when channel0 data sign bit change or next shift data bits are all zero then CH0ZCIF(I2S_STATUS1[0]) flag is set to 1. + * | | |Note3: If CH0ZCIF Flag is set to 1, the channel0 will be mute. + * |[1] |CH1ZCEN |Channel1 Zero-cross Detect Enable Control + * | | |0 = channel1 zero-cross detect Disabled. + * | | |1 = channel1 zero-cross detect Enabled. + * | | |Note1: Channel1 also means right audio channel while I2S (FORMAT[2]=0) or 2-channel PCM mode. + * | | |Note2: If this bit is set to 1, when channel1 data sign bit change or next shift data bits are all zero then CH1ZCIF(I2S_STATUS1[1]) flag is set to 1. + * | | |Note3: If CH1ZCIF Flag is set to 1, the channel1 will be mute. + * |[2] |CH2ZCEN |Channel2 Zero-cross Detect Enable Control + * | | |0 = channel2 zero-cross detect Disabled. + * | | |1 = channel2 zero-cross detect Enabled. + * | | |Note1: This bit is available while multi-channel PCM mode and TDMCHNUM (I2S_CTL0[31:30]) = 0x1, 0x2, 0x3. + * | | |Note2: If this bit is set to 1, when channel2 data sign bit change or next shift data bits are all zero then CH2ZCIF(I2S_STATUS1[2]) flag is set to 1. + * | | |Note3: If CH2ZCIF Flag is set to 1, the channel2 will be mute. + * |[3] |CH3ZCEN |Channel3 Zero-cross Detect Enable Control + * | | |0 = channel3 zero-cross detect Disabled. + * | | |1 = channel3 zero-cross detect Enabled. + * | | |Note1: This bit is available while multi-channel PCM mode and TDMCHNUM (I2S_CTL0[31:30]) = 0x1, 0x2, 0x3. + * | | |Note2: If this bit is set to 1, when channel3 data sign bit change or next shift data bits are all zero then CH3ZCIF(I2S_STATUS1[3]) flag is set to 1. + * | | |Note3: If CH3ZCIF Flag is set to 1, the channel3 will be mute. + * |[4] |CH4ZCEN |Channel4 Zero-cross Detect Enable Control + * | | |0 = channel4 zero-cross detect Disabled. + * | | |1 = channel4 zero-cross detect Enabled. + * | | |Note1: This bit is available while multi-channel PCM mode and TDMCHNUM (I2S_CTL0[31:30]) = 0x1, 0x2, 0x3. + * | | |Note2: If this bit is set to 1, when channel4 data sign bit change or next shift data bits are all zero then CH4ZCIF(I2S_STATUS1[4]) flag is set to 1. + * | | |Note3: If CH4ZCIF Flag is set to 1, the channel4 will be mute. + * |[5] |CH5ZCEN |Channel5 Zero-cross Detect Enable Control + * | | |0 = channel5 zero-cross detect Disabled. + * | | |1 = channel5 zero-cross detect Enabled. + * | | |Note1: This bit is available while multi-channel PCM mode and TDMCHNUM (I2S_CTL0[31:30]) = 0x1, 0x2, 0x3. + * | | |Note2: If this bit is set to 1, when channel5 data sign bit change or next shift data bits are all zero then CH5ZCIF(I2S_STATUS1[5]) flag is set to 1. + * | | |Note3: If CH5ZCIF Flag is set to 1, the channel5 will be mute. + * |[6] |CH6ZCEN |Channel6 Zero-cross Detect Enable Control + * | | |0 = channel6 zero-cross detect Disabled. + * | | |1 = channel6 zero-cross detect Enabled. + * | | |Note1: This bit is available while multi-channel PCM mode and TDMCHNUM (I2S_CTL0[31:30]) = 0x1, 0x2, 0x3. + * | | |Note2: If this bit is set to 1, when channel6 data sign bit change or next shift data bits are all zero then CH6ZCIF(I2S_STATUS1[6]) flag is set to 1. + * | | |Note3: If CH6ZCIF Flag is set to 1, the channel6 will be mute. + * |[7] |CH7ZCEN |Channel7 Zero-cross Detect Enable Control + * | | |0 = channel7 zero-cross detect Disabled. + * | | |1 = channel7 zero-cross detect Enabled. + * | | |Note1: This bit is available while multi-channel PCM mode and TDMCHNUM (I2S_CTL0[31:30]) = 0x1, 0x2, 0x3. + * | | |Note2: If this bit is set to 1, when channel7 data sign bit change or next shift data bits are all zero then CH7ZCIF (I2S_STATUS1[7]) flag is set to 1. + * | | |Note3: If CH7ZCIF Flag is set to 1, the channel7 will be mute. + * |[11:8] |TXTH |Transmit FIFO Threshold Level + * | | |0000 = 0 data word in transmit FIFO. + * | | |0001 = 1 data word in transmit FIFO. + * | | |0010 = 2 data words in transmit FIFO. + * | | |... + * | | |1110 = 14 data words in transmit FIFO. + * | | |1111 = 15 data words in transmit FIFO. + * | | |Note: If remain data word number in transmit FIFO is the same or less than threshold level then TXTHIF (I2S_STATUS0[18]) flag is set. + * |[19:16] |RXTH |Receive FIFO Threshold Level + * | | |0000 = 1 data word in receive FIFO. + * | | |0001 = 2 data words in receive FIFO. + * | | |0010 = 3 data words in receive FIFO. + * | | |... + * | | |1110 = 15 data words in receive FIFO. + * | | |1111 = 16 data words in receive FIFO. + * | | |Note: When received data word number in receive buffer is greater than threshold level then RXTHIF (I2S_STATUS0[10]) flag is set. + * |[24] |PBWIDTH |Peripheral Bus Data Width Selection + * | | |This bit is used to choice the available data width of APB bus + * | | |It must be set to 1 while PDMA function is enable and it is set to 16-bit transmission mode + * | | |0 = 32 bits data width. + * | | |1 = 16 bits data width. + * | | |Note1: If PBWIDTH=1, the low 16 bits of 32-bit data bus are available. + * | | |Note2: If PBWIDTH=1, the transmitting FIFO level will be increased after two FIFO write operations. + * | | |Note3: If PBWIDTH=1, the receiving FIFO level will be decreased after two FIFO read operations. + * |[25] |PB16ORD |FIFO Read/Write Order in 16-bit Width of Peripheral Bus + * | | |When PBWIDTH = 1, the data FIFO will be increased or decreased by two peripheral bus access + * | | |This bit is used to select the order of FIFO access operations to meet the 32-bit transmitting/receiving FIFO entries. + * | | |0 = Low 16-bit read/write access first. + * | | |1 = High 16-bit read/write access first. + * | | |Note: This bit is available while PBWIDTH = 1. + * @var I2S_T::STATUS1 + * Offset: 0x24 I2S Status Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CH0ZCIF |Channel0 Zero-cross Interrupt Flag + * | | |It indicates channel0 next sample data sign bit is changed or all data bits are zero. + * | | |0 = No zero-cross in channel0. + * | | |1 = Channel0 zero-cross is detected. + * | | |Note1: Write 1 to clear this bit to 0. + * | | |Note2: Channel0 also means left audio channel while I2S (FORMAT[2]=0) or 2-channel PCM mode. + * |[1] |CH1ZCIF |Channel1 Zero-cross Interrupt Flag + * | | |It indicates channel1 next sample data sign bit is changed or all data bits are zero. + * | | |0 = No zero-cross in channel1. + * | | |1 = Channel1 zero-cross is detected. + * | | |Note1: Write 1 to clear this bit to 0. + * | | |Note2: Channel1 also means right audio channel while I2S (FORMAT[2]=0) or 2-channel PCM mode. + * |[2] |CH2ZCIF |Channel2 Zero-cross Interrupt Flag + * | | |It indicates channel2 next sample data sign bit is changed or all data bits are zero. + * | | |0 = No zero-cross in channel2. + * | | |1 = Channel2 zero-cross is detected. + * | | |Note1: Write 1 to clear this bit to 0. + * | | |Note2: This bit is available while multi-channel PCM mode and TDMCHNUM (I2S_CTL0[31:30]) = 0x1, 0x2, 0x3. + * |[3] |CH3ZCIF |Channel3 Zero-cross Interrupt Flag + * | | |It indicates channel3 next sample data sign bit is changed or all data bits are zero. + * | | |0 = No zero-cross in channel3. + * | | |1 = Channel3 zero-cross is detected. + * | | |Note1: Write 1 to clear this bit to 0. + * | | |Note2: This bit is available while multi-channel PCM mode and TDMCHNUM (I2S_CTL0[31:30]) = 0x1, 0x2, 0x3. + * |[4] |CH4ZCIF |Channel4 Zero-cross Interrupt Flag + * | | |It indicates channel4 next sample data sign bit is changed or all data bits are zero. + * | | |0 = No zero-cross in channel4. + * | | |1 = Channel4 zero-cross is detected. + * | | |Note1: Write 1 to clear this bit to 0. + * | | |Note2: This bit is available while multi-channel PCM mode and TDMCHNUM (I2S_CTL0[31:30]) = 0x1, 0x2, 0x3. + * |[5] |CH5ZCIF |Channel5 Zero-cross Interrupt Flag + * | | |It indicates channel5 next sample data sign bit is changed or all data bits are zero. + * | | |0 = No zero-cross in channel5. + * | | |1 = Channel5 zero-cross is detected. + * | | |Note1: Write 1 to clear this bit to 0. + * | | |Note2: This bit is available while multi-channel PCM mode and TDMCHNUM (I2S_CTL0[31:30]) = 0x1, 0x2, 0x3. + * |[6] |CH6ZCIF |Channel6 Zero-cross Interrupt Flag + * | | |It indicates channel6 next sample data sign bit is changed or all data bits are zero. + * | | |0 = No zero-cross in channel6. + * | | |1 = Channel6 zero-cross is detected. + * | | |Note1: Write 1 to clear this bit to 0. + * | | |Note2: This bit is available while multi-channel PCM mode and TDMCHNUM (I2S_CTL0[31:30]) = 0x1, 0x2, 0x3. + * |[7] |CH7ZCIF |Channel7 Zero-cross Interrupt Flag + * | | |It indicates channel7 next sample data sign bit is changed or all data bits are zero. + * | | |0 = No zero-cross in channel7. + * | | |1 = Channel7 zero-cross is detected. + * | | |Note1: Write 1 to clear this bit to 0. + * | | |Note2: This bit is available while multi-channel PCM mode and TDMCHNUM (I2S_CTL0[31:30]) = 0x1, 0x2, 0x3. + * |[12:8] |TXCNT |Transmit FIFO Level (Read Only) + * | | |These bits indicate the number of available entries in transmit FIFO + * | | |00000 = No data. + * | | |00001 = 1 word in transmit FIFO. + * | | |00010 = 2 words in transmit FIFO. + * | | |... + * | | |01110 = 14 words in transmit FIFO. + * | | |01111 = 15 words in transmit FIFO. + * | | |10000 = 16 words in transmit FIFO. + * | | |Others are reserved. + * |[20:16] |RXCNT |Receive FIFO Level (Read Only) + * | | |These bits indicate the number of available entries in receive FIFO + * | | |00000 = No data. + * | | |00001 = 1 word in receive FIFO. + * | | |00010 = 2 words in receive FIFO. + * | | |... + * | | |01110 = 14 words in receive FIFO. + * | | |01111 = 15 words in receive FIFO. + * | | |10000 = 16 words in receive FIFO. + * | | |Others are reserved. + */ + __IO uint32_t CTL0; /*!< [0x0000] I2S Control Register 0 */ + __IO uint32_t CLKDIV; /*!< [0x0004] I2S Clock Divider Register */ + __IO uint32_t IEN; /*!< [0x0008] I2S Interrupt Enable Register */ + __IO uint32_t STATUS0; /*!< [0x000c] I2S Status Register 0 */ + __O uint32_t TXFIFO; /*!< [0x0010] I2S Transmit FIFO Register */ + __I uint32_t RXFIFO; /*!< [0x0014] I2S Receive FIFO Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[2]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t CTL1; /*!< [0x0020] I2S Control Register 1 */ + __IO uint32_t STATUS1; /*!< [0x0024] I2S Status Register 1 */ + +} I2S_T; + +/** + @addtogroup I2S_CONST I2S Bit Field Definition + Constant Definitions for I2S Controller +@{ */ + +#define I2S_CTL0_I2SEN_Pos (0) /*!< I2S_T::CTL0: I2SEN Position */ +#define I2S_CTL0_I2SEN_Msk (0x1ul << I2S_CTL0_I2SEN_Pos) /*!< I2S_T::CTL0: I2SEN Mask */ + +#define I2S_CTL0_TXEN_Pos (1) /*!< I2S_T::CTL0: TXEN Position */ +#define I2S_CTL0_TXEN_Msk (0x1ul << I2S_CTL0_TXEN_Pos) /*!< I2S_T::CTL0: TXEN Mask */ + +#define I2S_CTL0_RXEN_Pos (2) /*!< I2S_T::CTL0: RXEN Position */ +#define I2S_CTL0_RXEN_Msk (0x1ul << I2S_CTL0_RXEN_Pos) /*!< I2S_T::CTL0: RXEN Mask */ + +#define I2S_CTL0_MUTE_Pos (3) /*!< I2S_T::CTL0: MUTE Position */ +#define I2S_CTL0_MUTE_Msk (0x1ul << I2S_CTL0_MUTE_Pos) /*!< I2S_T::CTL0: MUTE Mask */ + +#define I2S_CTL0_DATWIDTH_Pos (4) /*!< I2S_T::CTL0: DATWIDTH Position */ +#define I2S_CTL0_DATWIDTH_Msk (0x3ul << I2S_CTL0_DATWIDTH_Pos) /*!< I2S_T::CTL0: DATWIDTH Mask */ + +#define I2S_CTL0_MONO_Pos (6) /*!< I2S_T::CTL0: MONO Position */ +#define I2S_CTL0_MONO_Msk (0x1ul << I2S_CTL0_MONO_Pos) /*!< I2S_T::CTL0: MONO Mask */ + +#define I2S_CTL0_ORDER_Pos (7) /*!< I2S_T::CTL0: ORDER Position */ +#define I2S_CTL0_ORDER_Msk (0x1ul << I2S_CTL0_ORDER_Pos) /*!< I2S_T::CTL0: ORDER Mask */ + +#define I2S_CTL0_SLAVE_Pos (8) /*!< I2S_T::CTL0: SLAVE Position */ +#define I2S_CTL0_SLAVE_Msk (0x1ul << I2S_CTL0_SLAVE_Pos) /*!< I2S_T::CTL0: SLAVE Mask */ + +#define I2S_CTL0_MCLKEN_Pos (15) /*!< I2S_T::CTL0: MCLKEN Position */ +#define I2S_CTL0_MCLKEN_Msk (0x1ul << I2S_CTL0_MCLKEN_Pos) /*!< I2S_T::CTL0: MCLKEN Mask */ + +#define I2S_CTL0_TXFBCLR_Pos (18) /*!< I2S_T::CTL0: TXFBCLR Position */ +#define I2S_CTL0_TXFBCLR_Msk (0x1ul << I2S_CTL0_TXFBCLR_Pos) /*!< I2S_T::CTL0: TXFBCLR Mask */ + +#define I2S_CTL0_RXFBCLR_Pos (19) /*!< I2S_T::CTL0: RXFBCLR Position */ +#define I2S_CTL0_RXFBCLR_Msk (0x1ul << I2S_CTL0_RXFBCLR_Pos) /*!< I2S_T::CTL0: RXFBCLR Mask */ + +#define I2S_CTL0_TXPDMAEN_Pos (20) /*!< I2S_T::CTL0: TXPDMAEN Position */ +#define I2S_CTL0_TXPDMAEN_Msk (0x1ul << I2S_CTL0_TXPDMAEN_Pos) /*!< I2S_T::CTL0: TXPDMAEN Mask */ + +#define I2S_CTL0_RXPDMAEN_Pos (21) /*!< I2S_T::CTL0: RXPDMAEN Position */ +#define I2S_CTL0_RXPDMAEN_Msk (0x1ul << I2S_CTL0_RXPDMAEN_Pos) /*!< I2S_T::CTL0: RXPDMAEN Mask */ + +#define I2S_CTL0_RXLCH_Pos (23) /*!< I2S_T::CTL0: RXLCH Position */ +#define I2S_CTL0_RXLCH_Msk (0x1ul << I2S_CTL0_RXLCH_Pos) /*!< I2S_T::CTL0: RXLCH Mask */ + +#define I2S_CTL0_FORMAT_Pos (24) /*!< I2S_T::CTL0: FORMAT Position */ +#define I2S_CTL0_FORMAT_Msk (0x7ul << I2S_CTL0_FORMAT_Pos) /*!< I2S_T::CTL0: FORMAT Mask */ + +#define I2S_CTL0_PCMSYNC_Pos (27) /*!< I2S_T::CTL0: PCMSYNC Position */ +#define I2S_CTL0_PCMSYNC_Msk (0x1ul << I2S_CTL0_PCMSYNC_Pos) /*!< I2S_T::CTL0: PCMSYNC Mask */ + +#define I2S_CTL0_CHWIDTH_Pos (28) /*!< I2S_T::CTL0: CHWIDTH Position */ +#define I2S_CTL0_CHWIDTH_Msk (0x3ul << I2S_CTL0_CHWIDTH_Pos) /*!< I2S_T::CTL0: CHWIDTH Mask */ + +#define I2S_CTL0_TDMCHNUM_Pos (30) /*!< I2S_T::CTL0: TDMCHNUM Position */ +#define I2S_CTL0_TDMCHNUM_Msk (0x3ul << I2S_CTL0_TDMCHNUM_Pos) /*!< I2S_T::CTL0: TDMCHNUM Mask */ + +#define I2S_CLKDIV_MCLKDIV_Pos (0) /*!< I2S_T::CLKDIV: MCLKDIV Position */ +#define I2S_CLKDIV_MCLKDIV_Msk (0x3ful << I2S_CLKDIV_MCLKDIV_Pos) /*!< I2S_T::CLKDIV: MCLKDIV Mask */ + +#define I2S_CLKDIV_BCLKDIV_Pos (8) /*!< I2S_T::CLKDIV: BCLKDIV Position */ +#define I2S_CLKDIV_BCLKDIV_Msk (0x1fful << I2S_CLKDIV_BCLKDIV_Pos) /*!< I2S_T::CLKDIV: BCLKDIV Mask */ + +#define I2S_IEN_RXUDFIEN_Pos (0) /*!< I2S_T::IEN: RXUDFIEN Position */ +#define I2S_IEN_RXUDFIEN_Msk (0x1ul << I2S_IEN_RXUDFIEN_Pos) /*!< I2S_T::IEN: RXUDFIEN Mask */ + +#define I2S_IEN_RXOVFIEN_Pos (1) /*!< I2S_T::IEN: RXOVFIEN Position */ +#define I2S_IEN_RXOVFIEN_Msk (0x1ul << I2S_IEN_RXOVFIEN_Pos) /*!< I2S_T::IEN: RXOVFIEN Mask */ + +#define I2S_IEN_RXTHIEN_Pos (2) /*!< I2S_T::IEN: RXTHIEN Position */ +#define I2S_IEN_RXTHIEN_Msk (0x1ul << I2S_IEN_RXTHIEN_Pos) /*!< I2S_T::IEN: RXTHIEN Mask */ + +#define I2S_IEN_TXUDFIEN_Pos (8) /*!< I2S_T::IEN: TXUDFIEN Position */ +#define I2S_IEN_TXUDFIEN_Msk (0x1ul << I2S_IEN_TXUDFIEN_Pos) /*!< I2S_T::IEN: TXUDFIEN Mask */ + +#define I2S_IEN_TXOVFIEN_Pos (9) /*!< I2S_T::IEN: TXOVFIEN Position */ +#define I2S_IEN_TXOVFIEN_Msk (0x1ul << I2S_IEN_TXOVFIEN_Pos) /*!< I2S_T::IEN: TXOVFIEN Mask */ + +#define I2S_IEN_TXTHIEN_Pos (10) /*!< I2S_T::IEN: TXTHIEN Position */ +#define I2S_IEN_TXTHIEN_Msk (0x1ul << I2S_IEN_TXTHIEN_Pos) /*!< I2S_T::IEN: TXTHIEN Mask */ + +#define I2S_IEN_CH0ZCIEN_Pos (16) /*!< I2S_T::IEN: CH0ZCIEN Position */ +#define I2S_IEN_CH0ZCIEN_Msk (0x1ul << I2S_IEN_CH0ZCIEN_Pos) /*!< I2S_T::IEN: CH0ZCIEN Mask */ + +#define I2S_IEN_CH1ZCIEN_Pos (17) /*!< I2S_T::IEN: CH1ZCIEN Position */ +#define I2S_IEN_CH1ZCIEN_Msk (0x1ul << I2S_IEN_CH1ZCIEN_Pos) /*!< I2S_T::IEN: CH1ZCIEN Mask */ + +#define I2S_IEN_CH2ZCIEN_Pos (18) /*!< I2S_T::IEN: CH2ZCIEN Position */ +#define I2S_IEN_CH2ZCIEN_Msk (0x1ul << I2S_IEN_CH2ZCIEN_Pos) /*!< I2S_T::IEN: CH2ZCIEN Mask */ + +#define I2S_IEN_CH3ZCIEN_Pos (19) /*!< I2S_T::IEN: CH3ZCIEN Position */ +#define I2S_IEN_CH3ZCIEN_Msk (0x1ul << I2S_IEN_CH3ZCIEN_Pos) /*!< I2S_T::IEN: CH3ZCIEN Mask */ + +#define I2S_IEN_CH4ZCIEN_Pos (20) /*!< I2S_T::IEN: CH4ZCIEN Position */ +#define I2S_IEN_CH4ZCIEN_Msk (0x1ul << I2S_IEN_CH4ZCIEN_Pos) /*!< I2S_T::IEN: CH4ZCIEN Mask */ + +#define I2S_IEN_CH5ZCIEN_Pos (21) /*!< I2S_T::IEN: CH5ZCIEN Position */ +#define I2S_IEN_CH5ZCIEN_Msk (0x1ul << I2S_IEN_CH5ZCIEN_Pos) /*!< I2S_T::IEN: CH5ZCIEN Mask */ + +#define I2S_IEN_CH6ZCIEN_Pos (22) /*!< I2S_T::IEN: CH6ZCIEN Position */ +#define I2S_IEN_CH6ZCIEN_Msk (0x1ul << I2S_IEN_CH6ZCIEN_Pos) /*!< I2S_T::IEN: CH6ZCIEN Mask */ + +#define I2S_IEN_CH7ZCIEN_Pos (23) /*!< I2S_T::IEN: CH7ZCIEN Position */ +#define I2S_IEN_CH7ZCIEN_Msk (0x1ul << I2S_IEN_CH7ZCIEN_Pos) /*!< I2S_T::IEN: CH7ZCIEN Mask */ + +#define I2S_STATUS0_I2SINT_Pos (0) /*!< I2S_T::STATUS0: I2SINT Position */ +#define I2S_STATUS0_I2SINT_Msk (0x1ul << I2S_STATUS0_I2SINT_Pos) /*!< I2S_T::STATUS0: I2SINT Mask */ + +#define I2S_STATUS0_I2SRXINT_Pos (1) /*!< I2S_T::STATUS0: I2SRXINT Position */ +#define I2S_STATUS0_I2SRXINT_Msk (0x1ul << I2S_STATUS0_I2SRXINT_Pos) /*!< I2S_T::STATUS0: I2SRXINT Mask */ + +#define I2S_STATUS0_I2STXINT_Pos (2) /*!< I2S_T::STATUS0: I2STXINT Position */ +#define I2S_STATUS0_I2STXINT_Msk (0x1ul << I2S_STATUS0_I2STXINT_Pos) /*!< I2S_T::STATUS0: I2STXINT Mask */ + +#define I2S_STATUS0_DATACH_Pos (3) /*!< I2S_T::STATUS0: DATACH Position */ +#define I2S_STATUS0_DATACH_Msk (0x7ul << I2S_STATUS0_DATACH_Pos) /*!< I2S_T::STATUS0: DATACH Mask */ + +#define I2S_STATUS0_RXUDIF_Pos (8) /*!< I2S_T::STATUS0: RXUDIF Position */ +#define I2S_STATUS0_RXUDIF_Msk (0x1ul << I2S_STATUS0_RXUDIF_Pos) /*!< I2S_T::STATUS0: RXUDIF Mask */ + +#define I2S_STATUS0_RXOVIF_Pos (9) /*!< I2S_T::STATUS0: RXOVIF Position */ +#define I2S_STATUS0_RXOVIF_Msk (0x1ul << I2S_STATUS0_RXOVIF_Pos) /*!< I2S_T::STATUS0: RXOVIF Mask */ + +#define I2S_STATUS0_RXTHIF_Pos (10) /*!< I2S_T::STATUS0: RXTHIF Position */ +#define I2S_STATUS0_RXTHIF_Msk (0x1ul << I2S_STATUS0_RXTHIF_Pos) /*!< I2S_T::STATUS0: RXTHIF Mask */ + +#define I2S_STATUS0_RXFULL_Pos (11) /*!< I2S_T::STATUS0: RXFULL Position */ +#define I2S_STATUS0_RXFULL_Msk (0x1ul << I2S_STATUS0_RXFULL_Pos) /*!< I2S_T::STATUS0: RXFULL Mask */ + +#define I2S_STATUS0_RXEMPTY_Pos (12) /*!< I2S_T::STATUS0: RXEMPTY Position */ +#define I2S_STATUS0_RXEMPTY_Msk (0x1ul << I2S_STATUS0_RXEMPTY_Pos) /*!< I2S_T::STATUS0: RXEMPTY Mask */ + +#define I2S_STATUS0_TXUDIF_Pos (16) /*!< I2S_T::STATUS0: TXUDIF Position */ +#define I2S_STATUS0_TXUDIF_Msk (0x1ul << I2S_STATUS0_TXUDIF_Pos) /*!< I2S_T::STATUS0: TXUDIF Mask */ + +#define I2S_STATUS0_TXOVIF_Pos (17) /*!< I2S_T::STATUS0: TXOVIF Position */ +#define I2S_STATUS0_TXOVIF_Msk (0x1ul << I2S_STATUS0_TXOVIF_Pos) /*!< I2S_T::STATUS0: TXOVIF Mask */ + +#define I2S_STATUS0_TXTHIF_Pos (18) /*!< I2S_T::STATUS0: TXTHIF Position */ +#define I2S_STATUS0_TXTHIF_Msk (0x1ul << I2S_STATUS0_TXTHIF_Pos) /*!< I2S_T::STATUS0: TXTHIF Mask */ + +#define I2S_STATUS0_TXFULL_Pos (19) /*!< I2S_T::STATUS0: TXFULL Position */ +#define I2S_STATUS0_TXFULL_Msk (0x1ul << I2S_STATUS0_TXFULL_Pos) /*!< I2S_T::STATUS0: TXFULL Mask */ + +#define I2S_STATUS0_TXEMPTY_Pos (20) /*!< I2S_T::STATUS0: TXEMPTY Position */ +#define I2S_STATUS0_TXEMPTY_Msk (0x1ul << I2S_STATUS0_TXEMPTY_Pos) /*!< I2S_T::STATUS0: TXEMPTY Mask */ + +#define I2S_STATUS0_TXBUSY_Pos (21) /*!< I2S_T::STATUS0: TXBUSY Position */ +#define I2S_STATUS0_TXBUSY_Msk (0x1ul << I2S_STATUS0_TXBUSY_Pos) /*!< I2S_T::STATUS0: TXBUSY Mask */ + +#define I2S_TXFIFO_TXFIFO_Pos (0) /*!< I2S_T::TXFIFO: TXFIFO Position */ +#define I2S_TXFIFO_TXFIFO_Msk (0xfffffffful << I2S_TXFIFO_TXFIFO_Pos) /*!< I2S_T::TXFIFO: TXFIFO Mask */ + +#define I2S_RXFIFO_RXFIFO_Pos (0) /*!< I2S_T::RXFIFO: RXFIFO Position */ +#define I2S_RXFIFO_RXFIFO_Msk (0xfffffffful << I2S_RXFIFO_RXFIFO_Pos) /*!< I2S_T::RXFIFO: RXFIFO Mask */ + +#define I2S_CTL1_CH0ZCEN_Pos (0) /*!< I2S_T::CTL1: CH0ZCEN Position */ +#define I2S_CTL1_CH0ZCEN_Msk (0x1ul << I2S_CTL1_CH0ZCEN_Pos) /*!< I2S_T::CTL1: CH0ZCEN Mask */ + +#define I2S_CTL1_CH1ZCEN_Pos (1) /*!< I2S_T::CTL1: CH1ZCEN Position */ +#define I2S_CTL1_CH1ZCEN_Msk (0x1ul << I2S_CTL1_CH1ZCEN_Pos) /*!< I2S_T::CTL1: CH1ZCEN Mask */ + +#define I2S_CTL1_CH2ZCEN_Pos (2) /*!< I2S_T::CTL1: CH2ZCEN Position */ +#define I2S_CTL1_CH2ZCEN_Msk (0x1ul << I2S_CTL1_CH2ZCEN_Pos) /*!< I2S_T::CTL1: CH2ZCEN Mask */ + +#define I2S_CTL1_CH3ZCEN_Pos (3) /*!< I2S_T::CTL1: CH3ZCEN Position */ +#define I2S_CTL1_CH3ZCEN_Msk (0x1ul << I2S_CTL1_CH3ZCEN_Pos) /*!< I2S_T::CTL1: CH3ZCEN Mask */ + +#define I2S_CTL1_CH4ZCEN_Pos (4) /*!< I2S_T::CTL1: CH4ZCEN Position */ +#define I2S_CTL1_CH4ZCEN_Msk (0x1ul << I2S_CTL1_CH4ZCEN_Pos) /*!< I2S_T::CTL1: CH4ZCEN Mask */ + +#define I2S_CTL1_CH5ZCEN_Pos (5) /*!< I2S_T::CTL1: CH5ZCEN Position */ +#define I2S_CTL1_CH5ZCEN_Msk (0x1ul << I2S_CTL1_CH5ZCEN_Pos) /*!< I2S_T::CTL1: CH5ZCEN Mask */ + +#define I2S_CTL1_CH6ZCEN_Pos (6) /*!< I2S_T::CTL1: CH6ZCEN Position */ +#define I2S_CTL1_CH6ZCEN_Msk (0x1ul << I2S_CTL1_CH6ZCEN_Pos) /*!< I2S_T::CTL1: CH6ZCEN Mask */ + +#define I2S_CTL1_CH7ZCEN_Pos (7) /*!< I2S_T::CTL1: CH7ZCEN Position */ +#define I2S_CTL1_CH7ZCEN_Msk (0x1ul << I2S_CTL1_CH7ZCEN_Pos) /*!< I2S_T::CTL1: CH7ZCEN Mask */ + +#define I2S_CTL1_TXTH_Pos (8) /*!< I2S_T::CTL1: TXTH Position */ +#define I2S_CTL1_TXTH_Msk (0xful << I2S_CTL1_TXTH_Pos) /*!< I2S_T::CTL1: TXTH Mask */ + +#define I2S_CTL1_RXTH_Pos (16) /*!< I2S_T::CTL1: RXTH Position */ +#define I2S_CTL1_RXTH_Msk (0xful << I2S_CTL1_RXTH_Pos) /*!< I2S_T::CTL1: RXTH Mask */ + +#define I2S_CTL1_PBWIDTH_Pos (24) /*!< I2S_T::CTL1: PBWIDTH Position */ +#define I2S_CTL1_PBWIDTH_Msk (0x1ul << I2S_CTL1_PBWIDTH_Pos) /*!< I2S_T::CTL1: PBWIDTH Mask */ + +#define I2S_CTL1_PB16ORD_Pos (25) /*!< I2S_T::CTL1: PB16ORD Position */ +#define I2S_CTL1_PB16ORD_Msk (0x1ul << I2S_CTL1_PB16ORD_Pos) /*!< I2S_T::CTL1: PB16ORD Mask */ + +#define I2S_STATUS1_CH0ZCIF_Pos (0) /*!< I2S_T::STATUS1: CH0ZCIF Position */ +#define I2S_STATUS1_CH0ZCIF_Msk (0x1ul << I2S_STATUS1_CH0ZCIF_Pos) /*!< I2S_T::STATUS1: CH0ZCIF Mask */ + +#define I2S_STATUS1_CH1ZCIF_Pos (1) /*!< I2S_T::STATUS1: CH1ZCIF Position */ +#define I2S_STATUS1_CH1ZCIF_Msk (0x1ul << I2S_STATUS1_CH1ZCIF_Pos) /*!< I2S_T::STATUS1: CH1ZCIF Mask */ + +#define I2S_STATUS1_CH2ZCIF_Pos (2) /*!< I2S_T::STATUS1: CH2ZCIF Position */ +#define I2S_STATUS1_CH2ZCIF_Msk (0x1ul << I2S_STATUS1_CH2ZCIF_Pos) /*!< I2S_T::STATUS1: CH2ZCIF Mask */ + +#define I2S_STATUS1_CH3ZCIF_Pos (3) /*!< I2S_T::STATUS1: CH3ZCIF Position */ +#define I2S_STATUS1_CH3ZCIF_Msk (0x1ul << I2S_STATUS1_CH3ZCIF_Pos) /*!< I2S_T::STATUS1: CH3ZCIF Mask */ + +#define I2S_STATUS1_CH4ZCIF_Pos (4) /*!< I2S_T::STATUS1: CH4ZCIF Position */ +#define I2S_STATUS1_CH4ZCIF_Msk (0x1ul << I2S_STATUS1_CH4ZCIF_Pos) /*!< I2S_T::STATUS1: CH4ZCIF Mask */ + +#define I2S_STATUS1_CH5ZCIF_Pos (5) /*!< I2S_T::STATUS1: CH5ZCIF Position */ +#define I2S_STATUS1_CH5ZCIF_Msk (0x1ul << I2S_STATUS1_CH5ZCIF_Pos) /*!< I2S_T::STATUS1: CH5ZCIF Mask */ + +#define I2S_STATUS1_CH6ZCIF_Pos (6) /*!< I2S_T::STATUS1: CH6ZCIF Position */ +#define I2S_STATUS1_CH6ZCIF_Msk (0x1ul << I2S_STATUS1_CH6ZCIF_Pos) /*!< I2S_T::STATUS1: CH6ZCIF Mask */ + +#define I2S_STATUS1_CH7ZCIF_Pos (7) /*!< I2S_T::STATUS1: CH7ZCIF Position */ +#define I2S_STATUS1_CH7ZCIF_Msk (0x1ul << I2S_STATUS1_CH7ZCIF_Pos) /*!< I2S_T::STATUS1: CH7ZCIF Mask */ + +#define I2S_STATUS1_TXCNT_Pos (8) /*!< I2S_T::STATUS1: TXCNT Position */ +#define I2S_STATUS1_TXCNT_Msk (0x1ful << I2S_STATUS1_TXCNT_Pos) /*!< I2S_T::STATUS1: TXCNT Mask */ + +#define I2S_STATUS1_RXCNT_Pos (16) /*!< I2S_T::STATUS1: RXCNT Position */ +#define I2S_STATUS1_RXCNT_Msk (0x1ful << I2S_STATUS1_RXCNT_Pos) /*!< I2S_T::STATUS1: RXCNT Mask */ + +/**@}*/ /* I2S_CONST */ +/**@}*/ /* end of I2S register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __I2S_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/opa_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/opa_reg.h new file mode 100644 index 00000000000..c28268a8236 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/opa_reg.h @@ -0,0 +1,268 @@ +/**************************************************************************//** + * @file opa_reg.h + * @version V1.00 + * @brief OPA register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __OPA_REG_H__ +#define __OPA_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup OPA OP Amplifier(OPA) + Memory Mapped Structure for OPA Controller +@{ */ + +typedef struct +{ + + + /** + * @var OPA_T::CTL + * Offset: 0x00 OP Amplifier Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |OPEN0 |OP Amplifier 0 Enable Bit + * | | |0 = OP amplifier0 Disabled. + * | | |1 = OP amplifier0 Enabled. + * | | |Note: OP Amplifier 0 output needs wait stable 20u03BCs after OPEN0 is set. + * |[1] |OPEN1 |OP Amplifier 1 Enable Bit + * | | |0 = OP amplifier1 Disabled. + * | | |1 = OP amplifier1 Enabled. + * | | |Note: OP Amplifier 1 output needs wait stable 20u03BCs after OPEN1 is set. + * |[2] |OPEN2 |OP Amplifier 2 Enable Bit + * | | |0 = OP amplifier2 Disabled. + * | | |1 = OP amplifier2 Enabled. + * | | |Note: OP Amplifier 2 output needs wait stable 20u03BCs after OPEN2 is set. + * |[4] |OPDOEN0 |OP Amplifier 0 Schmitt Trigger Non-inverting Buffer Enable Bit + * | | |0 = OP amplifier0 Schmitt Trigger non-invert buffer Disabled. + * | | |1 = OP amplifier0 Schmitt Trigger non-invert buffer Enabled. + * |[5] |OPDOEN1 |OP Amplifier 1 Schmitt Trigger Non-inverting Buffer Enable Bit + * | | |0 = OP amplifier1 Schmitt Trigger non-invert buffer Disabled. + * | | |1 = OP amplifier1 Schmitt Trigger non-invert buffer Enabled. + * |[6] |OPDOEN2 |OP Amplifier 2 Schmitt Trigger Non-inverting Buffer Enable Bit + * | | |0 = OP amplifier2 Schmitt Trigger non-invert buffer Disabled. + * | | |1 = OP amplifier2 Schmitt Trigger non-invert buffer Enabled. + * |[8] |OPDOIEN0 |OP Amplifier 0 Schmitt Trigger Digital Output Interrupt Enable Bit + * | | |0 = OP Amplifier 0 digital output interrupt function Disabled. + * | | |1 = OP Amplifier 0 digital output interrupt function Enabled. + * | | |The OPDOIF0 interrupt flag is set by hardware whenever the OP amplifier 0 Schmitt Trigger non-inverting buffer digital output changes state, in the meanwhile, if OPDOIEN0 is set to 1, a comparator interrupt request is generated. + * |[9] |OPDOIEN1 |OP Amplifier 1 Schmitt Trigger Digital Output Interrupt Enable Bit + * | | |0 = OP Amplifier 1 digital output interrupt function Disabled. + * | | |1 = OP Amplifier 1 digital output interrupt function Enabled. + * | | |OPDOIF1 interrupt flag is set by hardware whenever the OP amplifier 1 Schmitt trigger non-inverting buffer digital output changes state, in the meanwhile, if OPDOIEN1 is set to 1, a comparator interrupt request is generated. + * |[10] |OPDOIEN2 |OP Amplifier 2 Schmitt Trigger Digital Output Interrupt Enable Bit + * | | |0 = OP Amplifier 2 digital output interrupt function Disabled. + * | | |1 = OP Amplifier 2 digital output interrupt function Enabled. + * | | |OPDOIF2 interrupt flag is set by hardware whenever the OP amplifier 2 Schmitt Trigger non-inverting buffer digital output changes state, in the meanwhile, if OPDOIEN2 is set to 1, a comparator interrupt request is generated. + * @var OPA_T::STATUS + * Offset: 0x04 OP Amplifier Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |OPDO0 |OP Amplifier 0 Digital Output + * | | |Synchronized to the APB clock to allow reading by software + * | | |Cleared when the Schmitt Trigger buffer is disabled (OPDOEN0 = 0) + * |[1] |OPDO1 |OP Amplifier 1 Digital Output + * | | |Synchronized to the APB clock to allow reading by software + * | | |Cleared when the Schmitt Trigger buffer is disabled (OPDOEN1 = 0) + * |[2] |OPDO2 |OP Amplifier 2 Digital Output + * | | |Synchronized to the APB clock to allow reading by software + * | | |Cleared when the Schmitt Trigger buffer is disabled (OPDOEN2 = 0) + * |[4] |OPDOIF0 |OP Amplifier 0 Schmitt Trigger Digital Output Interrupt Flag + * | | |OPDOIF0 interrupt flag is set by hardware whenever the OP amplifier 0 Schmitt Trigger non-inverting buffer digital output changes state + * | | |This bit is cleared by writing 1 to it. + * |[5] |OPDOIF1 |OP Amplifier 1 Schmitt Trigger Digital Output Interrupt Flag + * | | |OPDOIF1 interrupt flag is set by hardware whenever the OP amplifier 1 Schmitt Trigger non-inverting buffer digital output changes state + * | | |This bit is cleared by writing 1 to it. + * |[6] |OPDOIF2 |OP Amplifier 2 Schmitt Trigger Digital Output Interrupt Flag + * | | |OPDOIF2 interrupt flag is set by hardware whenever the OP amplifier 2 Schmitt Trigger non-inverting buffer digital output changes state + * | | |This bit is cleared by writing 1 to it. + * @var OPA_T::CALCTL + * Offset: 0x08 OP Amplifier Calibration Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CALTRG0 |OP Amplifier 0 Calibration Trigger Bit + * | | |0 = Stop, hardware auto clear. + * | | |1 = Start. Note: Before enable this bit, it should set OPEN0 in advance. + * |[1] |CALTRG1 |OP Amplifier 1 Calibration Trigger Bit + * | | |0 = Stop, hardware auto clear. + * | | |1 = Start. Note: Before enable this bit, it should set OPEN1 in advance. + * |[2] |CALTRG2 |OP Amplifier 2 Calibration Trigger Bit + * | | |0 = Stop, hardware auto clear. + * | | |1 = Start. Note: Before enable this bit, it should set OPEN2 in advance. + * |[16] |CALRVS0 |OPA0 Calibration Reference Voltage Selection + * | | |0 = VREF is AVDD. + * | | |1 = VREF from high vcm to low vcm. + * |[17] |CALRVS1 |OPA1 Calibration Reference Voltage Selection + * | | |0 = VREF is AVDD. + * | | |1 = VREF from high vcm to low vcm. + * |[18] |CALRVS2 |OPA2 Calibration Reference Voltage Selection + * | | |0 = VREF is AVDD. + * | | |1 = VREF from high vcm to low vcm. + * @var OPA_T::CALST + * Offset: 0x0C OP Amplifier Calibration Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |DONE0 |OP Amplifier 0 Calibration Done Status + * | | |0 = Calibrating. + * | | |1 = Calibration Done. + * |[1] |CALNS0 |OP Amplifier 0 Calibration Result Status for NMOS + * | | |0 = Pass. + * | | |1 = Fail. + * |[2] |CALPS0 |OP Amplifier 0 Calibration Result Status for PMOS + * | | |0 = Pass. + * | | |1 = Fail. + * |[4] |DONE1 |OP Amplifier 1 Calibration Done Status + * | | |0 = Calibrating. + * | | |1 = Calibration Done. + * |[5] |CALNS1 |OP Amplifier 1 Calibration Result Status for NMOS + * | | |0 = Pass. + * | | |1 = Fail. + * |[6] |CALPS1 |OP Amplifier 1 Calibration Result Status for PMOS + * | | |0 = Pass. + * | | |1 = Fail. + * |[8] |DONE2 |OP Amplifier 2 Calibration Done Status + * | | |0 = Calibrating. + * | | |1 = Calibration Done. + * |[9] |CALNS2 |OP Amplifier 2 Calibration Result Status for NMOS + * | | |0 = Pass. + * | | |1 = Fail. + * |[10] |CALPS2 |OP Amplifier 2 Calibration Result Status for PMOS + * | | |0 = Pass. + * | | |1 = Fail. + */ + __IO uint32_t CTL; /*!< [0x0000] OP Amplifier Control Register */ + __IO uint32_t STATUS; /*!< [0x0004] OP Amplifier Status Register */ + __IO uint32_t CALCTL; /*!< [0x0008] OP Amplifier Calibration Control Register */ + __I uint32_t CALST; /*!< [0x000c] OP Amplifier Calibration Status Register */ + +} OPA_T; + +/** + @addtogroup OPA_CONST OPA Bit Field Definition + Constant Definitions for OPA Controller +@{ */ + +#define OPA_CTL_OPEN0_Pos (0) /*!< OPA_T::CTL: OPEN0 Position */ +#define OPA_CTL_OPEN0_Msk (0x1ul << OPA_CTL_OPEN0_Pos) /*!< OPA_T::CTL: OPEN0 Mask */ + +#define OPA_CTL_OPEN1_Pos (1) /*!< OPA_T::CTL: OPEN1 Position */ +#define OPA_CTL_OPEN1_Msk (0x1ul << OPA_CTL_OPEN1_Pos) /*!< OPA_T::CTL: OPEN1 Mask */ + +#define OPA_CTL_OPEN2_Pos (2) /*!< OPA_T::CTL: OPEN2 Position */ +#define OPA_CTL_OPEN2_Msk (0x1ul << OPA_CTL_OPEN2_Pos) /*!< OPA_T::CTL: OPEN2 Mask */ + +#define OPA_CTL_OPDOEN0_Pos (4) /*!< OPA_T::CTL: OPDOEN0 Position */ +#define OPA_CTL_OPDOEN0_Msk (0x1ul << OPA_CTL_OPDOEN0_Pos) /*!< OPA_T::CTL: OPDOEN0 Mask */ + +#define OPA_CTL_OPDOEN1_Pos (5) /*!< OPA_T::CTL: OPDOEN1 Position */ +#define OPA_CTL_OPDOEN1_Msk (0x1ul << OPA_CTL_OPDOEN1_Pos) /*!< OPA_T::CTL: OPDOEN1 Mask */ + +#define OPA_CTL_OPDOEN2_Pos (6) /*!< OPA_T::CTL: OPDOEN2 Position */ +#define OPA_CTL_OPDOEN2_Msk (0x1ul << OPA_CTL_OPDOEN2_Pos) /*!< OPA_T::CTL: OPDOEN2 Mask */ + +#define OPA_CTL_OPDOIEN0_Pos (8) /*!< OPA_T::CTL: OPDOIEN0 Position */ +#define OPA_CTL_OPDOIEN0_Msk (0x1ul << OPA_CTL_OPDOIEN0_Pos) /*!< OPA_T::CTL: OPDOIEN0 Mask */ + +#define OPA_CTL_OPDOIEN1_Pos (9) /*!< OPA_T::CTL: OPDOIEN1 Position */ +#define OPA_CTL_OPDOIEN1_Msk (0x1ul << OPA_CTL_OPDOIEN1_Pos) /*!< OPA_T::CTL: OPDOIEN1 Mask */ + +#define OPA_CTL_OPDOIEN2_Pos (10) /*!< OPA_T::CTL: OPDOIEN2 Position */ +#define OPA_CTL_OPDOIEN2_Msk (0x1ul << OPA_CTL_OPDOIEN2_Pos) /*!< OPA_T::CTL: OPDOIEN2 Mask */ + +#define OPA_STATUS_OPDO0_Pos (0) /*!< OPA_T::STATUS: OPDO0 Position */ +#define OPA_STATUS_OPDO0_Msk (0x1ul << OPA_STATUS_OPDO0_Pos) /*!< OPA_T::STATUS: OPDO0 Mask */ + +#define OPA_STATUS_OPDO1_Pos (1) /*!< OPA_T::STATUS: OPDO1 Position */ +#define OPA_STATUS_OPDO1_Msk (0x1ul << OPA_STATUS_OPDO1_Pos) /*!< OPA_T::STATUS: OPDO1 Mask */ + +#define OPA_STATUS_OPDO2_Pos (2) /*!< OPA_T::STATUS: OPDO2 Position */ +#define OPA_STATUS_OPDO2_Msk (0x1ul << OPA_STATUS_OPDO2_Pos) /*!< OPA_T::STATUS: OPDO2 Mask */ + +#define OPA_STATUS_OPDOIF0_Pos (4) /*!< OPA_T::STATUS: OPDOIF0 Position */ +#define OPA_STATUS_OPDOIF0_Msk (0x1ul << OPA_STATUS_OPDOIF0_Pos) /*!< OPA_T::STATUS: OPDOIF0 Mask */ + +#define OPA_STATUS_OPDOIF1_Pos (5) /*!< OPA_T::STATUS: OPDOIF1 Position */ +#define OPA_STATUS_OPDOIF1_Msk (0x1ul << OPA_STATUS_OPDOIF1_Pos) /*!< OPA_T::STATUS: OPDOIF1 Mask */ + +#define OPA_STATUS_OPDOIF2_Pos (6) /*!< OPA_T::STATUS: OPDOIF2 Position */ +#define OPA_STATUS_OPDOIF2_Msk (0x1ul << OPA_STATUS_OPDOIF2_Pos) /*!< OPA_T::STATUS: OPDOIF2 Mask */ + +#define OPA_CALCTL_CALTRG0_Pos (0) /*!< OPA_T::CALCTL: CALTRG0 Position */ +#define OPA_CALCTL_CALTRG0_Msk (0x1ul << OPA_CALCTL_CALTRG0_Pos) /*!< OPA_T::CALCTL: CALTRG0 Mask */ + +#define OPA_CALCTL_CALTRG1_Pos (1) /*!< OPA_T::CALCTL: CALTRG1 Position */ +#define OPA_CALCTL_CALTRG1_Msk (0x1ul << OPA_CALCTL_CALTRG1_Pos) /*!< OPA_T::CALCTL: CALTRG1 Mask */ + +#define OPA_CALCTL_CALTRG2_Pos (2) /*!< OPA_T::CALCTL: CALTRG2 Position */ +#define OPA_CALCTL_CALTRG2_Msk (0x1ul << OPA_CALCTL_CALTRG2_Pos) /*!< OPA_T::CALCTL: CALTRG2 Mask */ + +#define OPA_CALCTL_CALCLK0_Pos (4) /*!< OPA_T::CALCTL: CALCLK0 Position */ +#define OPA_CALCTL_CALCLK0_Msk (0x3ul << OPA_CALCTL_CALCLK0_Pos) /*!< OPA_T::CALCTL: CALCLK0 Mask */ + +#define OPA_CALCTL_CALCLK1_Pos (6) /*!< OPA_T::CALCTL: CALCLK1 Position */ +#define OPA_CALCTL_CALCLK1_Msk (0x3ul << OPA_CALCTL_CALCLK1_Pos) /*!< OPA_T::CALCTL: CALCLK1 Mask */ + +#define OPA_CALCTL_CALCLK2_Pos (8) /*!< OPA_T::CALCTL: CALCLK2 Position */ +#define OPA_CALCTL_CALCLK2_Msk (0x3ul << OPA_CALCTL_CALCLK2_Pos) /*!< OPA_T::CALCTL: CALCLK2 Mask */ + +#define OPA_CALCTL_CALRVS0_Pos (16) /*!< OPA_T::CALCTL: CALRVS0 Position */ +#define OPA_CALCTL_CALRVS0_Msk (0x1ul << OPA_CALCTL_CALRVS0_Pos) /*!< OPA_T::CALCTL: CALRVS0 Mask */ + +#define OPA_CALCTL_CALRVS1_Pos (17) /*!< OPA_T::CALCTL: CALRVS1 Position */ +#define OPA_CALCTL_CALRVS1_Msk (0x1ul << OPA_CALCTL_CALRVS1_Pos) /*!< OPA_T::CALCTL: CALRVS1 Mask */ + +#define OPA_CALCTL_CALRVS2_Pos (18) /*!< OPA_T::CALCTL: CALRVS2 Position */ +#define OPA_CALCTL_CALRVS2_Msk (0x1ul << OPA_CALCTL_CALRVS2_Pos) /*!< OPA_T::CALCTL: CALRVS2 Mask */ + +#define OPA_CALST_DONE0_Pos (0) /*!< OPA_T::CALST: DONE0 Position */ +#define OPA_CALST_DONE0_Msk (0x1ul << OPA_CALST_DONE0_Pos) /*!< OPA_T::CALST: DONE0 Mask */ + +#define OPA_CALST_CALNS0_Pos (1) /*!< OPA_T::CALST: CALNS0 Position */ +#define OPA_CALST_CALNS0_Msk (0x1ul << OPA_CALST_CALNS0_Pos) /*!< OPA_T::CALST: CALNS0 Mask */ + +#define OPA_CALST_CALPS0_Pos (2) /*!< OPA_T::CALST: CALPS0 Position */ +#define OPA_CALST_CALPS0_Msk (0x1ul << OPA_CALST_CALPS0_Pos) /*!< OPA_T::CALST: CALPS0 Mask */ + +#define OPA_CALST_DONE1_Pos (4) /*!< OPA_T::CALST: DONE1 Position */ +#define OPA_CALST_DONE1_Msk (0x1ul << OPA_CALST_DONE1_Pos) /*!< OPA_T::CALST: DONE1 Mask */ + +#define OPA_CALST_CALNS1_Pos (5) /*!< OPA_T::CALST: CALNS1 Position */ +#define OPA_CALST_CALNS1_Msk (0x1ul << OPA_CALST_CALNS1_Pos) /*!< OPA_T::CALST: CALNS1 Mask */ + +#define OPA_CALST_CALPS1_Pos (6) /*!< OPA_T::CALST: CALPS1 Position */ +#define OPA_CALST_CALPS1_Msk (0x1ul << OPA_CALST_CALPS1_Pos) /*!< OPA_T::CALST: CALPS1 Mask */ + +#define OPA_CALST_DONE2_Pos (8) /*!< OPA_T::CALST: DONE2 Position */ +#define OPA_CALST_DONE2_Msk (0x1ul << OPA_CALST_DONE2_Pos) /*!< OPA_T::CALST: DONE2 Mask */ + +#define OPA_CALST_CALNS2_Pos (9) /*!< OPA_T::CALST: CALNS2 Position */ +#define OPA_CALST_CALNS2_Msk (0x1ul << OPA_CALST_CALNS2_Pos) /*!< OPA_T::CALST: CALNS2 Mask */ + +#define OPA_CALST_CALPS2_Pos (10) /*!< OPA_T::CALST: CALPS2 Position */ +#define OPA_CALST_CALPS2_Msk (0x1ul << OPA_CALST_CALPS2_Pos) /*!< OPA_T::CALST: CALPS2 Mask */ + +/**@}*/ /* OPA_CONST */ +/**@}*/ /* end of OPA register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __OPA_REG_H__ */ + diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/otg_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/otg_reg.h new file mode 100644 index 00000000000..03900262008 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/otg_reg.h @@ -0,0 +1,399 @@ +/**************************************************************************//** + * @file otg_reg.h + * @version V1.00 + * @brief OTG register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __OTG_REG_H__ +#define __OTG_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup OTG USB On-The-Go Controller(OTG) + Memory Mapped Structure for OTG Controller +@{ */ + +typedef struct +{ + + + /** + * @var OTG_T::CTL + * Offset: 0x00 OTG Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |VBUSDROP |Drop VBUS Control + * | | |If user application running on this OTG A-device wants to conserve power, set this bit to drop VBUS + * | | |BUSREQ (OTG_CTL[1]) will be also cleared no matter A-device or B-device. + * | | |0 = Not drop the VBUS. + * | | |1 = Drop the VBUS. + * |[1] |BUSREQ |OTG Bus Request + * | | |If OTG A-device wants to do data transfers via USB bus, setting this bit will drive VBUS high to detect USB device connection + * | | |If user won't use the bus any more, clearing this bit will drop VBUS to save power + * | | |This bit will be cleared when A-device goes to A_wait_vfall state + * | | |This bit will be also cleared if VBUSDROP (OTG_CTL[0]) bit is set or IDSTS (OTG_STATUS[1]) changed. + * | | |If user of an OTG-B Device wants to request VBUS, setting this bit will run SRP protocol + * | | |This bit will be cleared if SRP failure (OTG A-device does not provide VBUS after B-device issues ARP in specified interval, defined in OTG specification) + * | | |This bit will be also cleared if VBUSDROP (OTG_CTL[0]) bit is set IDSTS (OTG_STATUS[1]) changed. + * | | |0 = Not launch VBUS in OTG A-device or not request SRP in OTG B-device. + * | | |1 = Launch VBUS in OTG A-device or request SRP in OTG B-device. + * |[2] |HNPREQEN |OTG HNP Request Enable Bit + * | | |When USB frame as A-device, set this bit when A-device allows to process HNP protocol -- A-device changes role from Host to Peripheral + * | | |This bit will be cleared when OTG state changes from a_suspend to a_peripheral or goes back to a_idle state + * | | |When USB frame as B-device, set this bit after the OTG A-device successfully sends a SetFeature (b_hnp_enable) command to the OTG B-device to start role change -- B-device changes role from Peripheral to Host + * | | |This bit will be cleared when OTG state changes from b_peripheral to b_wait_acon or goes back to b_idle state. + * | | |0 = HNP request Disabled. + * | | |1 = HNP request Enabled (A-device can change role from Host to Peripheral or B-device can change role from Peripheral to Host). + * | | |Note: Refer to OTG specification to get a_suspend, a_peripheral, a_idle and b_idle state. + * |[4] |OTGEN |OTG Function Enable Bit + * | | |User needs to set this bit to enable OTG function while USB frame configured as OTG device + * | | |When USB frame not configured as OTG device, this bit is must be low. + * | | |0= OTG function Disabled. + * | | |1 = OTG function Enabled. + * |[5] |WKEN |OTG ID Pin Wake-up Enable Bit + * | | |0 = OTG ID pin status change wake-up function Disabled. + * | | |1 = OTG ID pin status change wake-up function Enabled. + * @var OTG_T::PHYCTL + * Offset: 0x04 OTG PHY Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |OTGPHYEN |OTG PHY Enable + * | | |When USB frame is configured as OTG-device or ID-dependent, user needs to set this bit before using OTG function + * | | |If device is not configured as OTG-device nor ID-dependent , this bit is "don't care". + * | | |0 = OTG PHY Disabled. + * | | |1 = OTG PHY Enabled. + * |[1] |IDDETEN |ID Detection Enable Bit + * | | |0 = Detect ID pin status Disabled. + * | | |1 = Detect ID pin status Enabled. + * |[4] |VBENPOL |Off-chip USB VBUS Power Switch Enable Polarity + * | | |The OTG controller will enable off-chip USB VBUS power switch to provide VBUS power when need + * | | |A USB_VBUS_EN pin is used to control the off-chip USB VBUS power switch. + * | | |The polarity of enabling off-chip USB VBUS power switch (high active or low active) depends on the selected component + * | | |Set this bit as following according to the polarity of off-chip USB VBUS power switch. + * | | |0 = The off-chip USB VBUS power switch enable is active high. + * | | |1 = The off-chip USB VBUS power switch enable is active low. + * |[5] |VBSTSPOL |Off-chip USB VBUS Power Switch Status Polarity + * | | |The polarity of off-chip USB VBUS power switch valid signal depends on the selected component + * | | |A USB_VBUS_ST pin is used to monitor the valid signal of the off-chip USB VBUS power switch + * | | |Set this bit as following according to the polarity of off-chip USB VBUS power switch. + * | | |0 = The polarity of off-chip USB VBUS power switch valid status is high. + * | | |1 = The polarity of off-chip USB VBUS power switch valid status is low. + * @var OTG_T::INTEN + * Offset: 0x08 OTG Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ROLECHGIEN|Role (Host or Peripheral) Changed Interrupt Enable Bit + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * |[1] |VBEIEN |VBUS Error Interrupt Enable Bit + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * | | |Note: VBUS error means going to a_vbus_err state. Please refer to A-device state diagram in OTG spec. + * |[2] |SRPFIEN |SRP Fail Interrupt Enable Bit + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * |[3] |HNPFIEN |HNP Fail Interrupt Enable Bit + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * |[4] |GOIDLEIEN |OTG Device Goes to IDLE State Interrupt Enable Bit + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * | | |Note: Going to idle state means going to a_idle or b_idle state + * | | |Please refer to A-device state diagram and B-device state diagram in OTG spec. + * |[5] |IDCHGIEN |IDSTS Changed Interrupt Enable Bit + * | | |If this bit is set to 1 and IDSTS (OTG_STATUS[1]) status is changed from high to low or from low to high, a interrupt will be asserted. + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * |[6] |PDEVIEN |Act As Peripheral Interrupt Enable Bit + * | | |If this bit is set to 1 and the device is changed as a peripheral, a interrupt will be asserted. + * | | |0 = This device as a peripheral interrupt Disabled. + * | | |1 = This device as a peripheral interrupt Enabled. + * |[7] |HOSTIEN |Act As Host Interrupt Enable Bit + * | | |If this bit is set to 1 and the device is changed as a host, a interrupt will be asserted. + * | | |0 = This device as a host interrupt Disabled. + * | | |1 = This device as a host interrupt Enabled. + * |[8] |BVLDCHGIEN|B-device Session Valid Status Changed Interrupt Enable Bit + * | | |If this bit is set to 1 and BVLD (OTG_STATUS[3]) status is changed from high to low or from low to high, a interrupt will be asserted. + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * |[9] |AVLDCHGIEN|A-device Session Valid Status Changed Interrupt Enable Bit + * | | |If this bit is set to 1 and AVLD (OTG_STATUS[4]) status is changed from high to low or from low to high, a interrupt will be asserted. + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * |[10] |VBCHGIEN |VBUSVLD Status Changed Interrupt Enable Bit + * | | |If this bit is set to 1 and VBUSVLD (OTG_STATUS[5]) status is changed from high to low or from low to high, a interrupt will be asserted. + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * |[11] |SECHGIEN |SESSEND Status Changed Interrupt Enable Bit + * | | |If this bit is set to 1 and SESSEND (OTG_STATUS[2]) status is changed from high to low or from low to high, a interrupt will be asserted. + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * |[13] |SRPDETIEN |SRP Detected Interrupt Enable Bit + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * @var OTG_T::INTSTS + * Offset: 0x0C OTG Interrupt Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ROLECHGIF |OTG Role Change Interrupt Status + * | | |This flag is set when the role of an OTG device changed from a host to a peripheral, or changed from a peripheral to a host while USB_ID pin status does not change. + * | | |0 = OTG device role not changed. + * | | |1 = OTG device role changed. + * | | |Note: Write 1 to clear this flag. + * |[1] |VBEIF |VBUS Error Interrupt Status + * | | |This bit will be set when voltage on VBUS cannot reach a minimum valid threshold 4.4V within a maximum time of 100ms after OTG A-device starting to drive VBUS high. + * | | |0 = OTG A-device drives VBUS over threshold voltage before this interval expires. + * | | |1 = OTG A-device cannot drive VBUS over threshold voltage before this interval expires. + * | | |Note: Write 1 to clear this flag and recover from the VBUS error state. + * |[2] |SRPFIF |SRP Fail Interrupt Status + * | | |After initiating SRP, an OTG B-device will wait for the OTG A-device to drive VBUS high at least TB_SRP_FAIL minimum, defined in OTG specification + * | | |This flag is set when the OTG B-device does not get VBUS high after this interval. + * | | |0 = OTG B-device gets VBUS high before this interval. + * | | |1 = OTG B-device does not get VBUS high before this interval. + * | | |Note: Write 1 to clear this flag. + * |[3] |HNPFIF |HNP Fail Interrupt Status + * | | |When A-device has granted B-device to be host and USB bus is in SE0 (both USB_D+ and USB_D- low) state, this bit will be set when A-device does not connect after specified interval expires. + * | | |0 = A-device connects to B-device before specified interval expires. + * | | |1 = A-device does not connect to B-device before specified interval expires. + * | | |Note: Write 1 to clear this flag. + * |[4] |GOIDLEIF |OTG Device Goes to IDLE Interrupt Status + * | | |Flag is set if the OTG device transfers from non-idle state to idle state + * | | |The OTG device will be neither a host nor a peripheral. + * | | |0 = OTG device does not go back to idle state (a_idle or b_idle). + * | | |1 = OTG device goes back to idle state(a_idle or b_idle). + * | | |Note 1: Going to idle state means going to a_idle or b_idle state. Please refer to OTG specification. + * | | |Note 2: Write 1 to clear this flag. + * |[5] |IDCHGIF |ID State Change Interrupt Status + * | | |0 = IDSTS (OTG_STATUS[1]) not toggled. + * | | |1 = IDSTS (OTG_STATUS[1]) from high to low or from low to high. + * | | |Note: Write 1 to clear this flag. + * |[6] |PDEVIF |Act As Peripheral Interrupt Status + * | | |0= This device does not act as a peripheral. + * | | |1 = This device acts as a peripheral. + * | | |Note: Write 1 to clear this flag. + * |[7] |HOSTIF |Act As Host Interrupt Status + * | | |0= This device does not act as a host. + * | | |1 = This device acts as a host. + * | | |Note: Write 1 to clear this flag. + * |[8] |BVLDCHGIF |B-device Session Valid State Change Interrupt Status + * | | |0 = BVLD (OTG_STATUS[3]) is not toggled. + * | | |1 = BVLD (OTG_STATUS[3]) from high to low or low to high. + * | | |Note: Write 1 to clear this status. + * |[9] |AVLDCHGIF |A-device Session Valid State Change Interrupt Status + * | | |0 = AVLD (OTG_STATUS[4]) not toggled. + * | | |1 = AVLD (OTG_STATUS[4]) from high to low or low to high. + * | | |Note: Write 1 to clear this status. + * |[10] |VBCHGIF |VBUSVLD State Change Interrupt Status + * | | |0 = VBUSVLD (OTG_STATUS[5]) not toggled. + * | | |1 = VBUSVLD (OTG_STATUS[5]) from high to low or from low to high. + * | | |Note: Write 1 to clear this status. + * |[11] |SECHGIF |SESSEND State Change Interrupt Status + * | | |0 = SESSEND (OTG_STATUS[2]) not toggled. + * | | |1 = SESSEND (OTG_STATUS[2]) from high to low or from low to high. + * | | |Note: Write 1 to clear this flag. + * |[13] |SRPDETIF |SRP Detected Interrupt Status + * | | |0 = SRP not detected. + * | | |1 = SRP detected. + * | | |Note: Write 1 to clear this status. + * @var OTG_T::STATUS + * Offset: 0x10 OTG Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |OVERCUR |over Current Condition + * | | |The voltage on VBUS cannot reach a minimum VBUS valid threshold, 4.4V minimum, within a maximum time of 100ms after OTG A-device drives VBUS high. + * | | |0 = OTG A-device drives VBUS successfully. + * | | |1 = OTG A-device cannot drives VBUS high in this interval. + * |[1] |IDSTS |USB_ID Pin State of Mini-b/Micro-plug + * | | |0 = Mini-A/Micro-A plug is attached. + * | | |1 = Mini-B/Micro-B plug is attached. + * |[2] |SESSEND |Session End Status + * | | |When VBUS voltage is lower than 0.4V, this bit will be set to 1 + * | | |Session end means no meaningful power on VBUS. + * | | |0 = Session is not end. + * | | |1 = Session is end. + * |[3] |BVLD |B-device Session Valid Status + * | | |0 = B-device session is not valid. + * | | |1 = B-device session is valid. + * |[4] |AVLD |A-device Session Valid Status + * | | |0 = A-device session is not valid. + * | | |1 = A-device session is valid. + * |[5] |VBUSVLD |VBUS Valid Status + * | | |When VBUS is larger than 4.7V, this bit will be set to 1. + * | | |0 = VBUS is not valid. + * | | |1 = VBUS is valid. + * |[6] |ASPERI |As Peripheral Status + * | | |When OTG as peripheral, this bit is set. + * | | |0: OTG not as peripheral + * | | |1: OTG as peripheral + * |[7] |ASHOST |As Host Status + * | | |When OTG as Host, this bit is set. + * | | |0: OTG not as Host + * | | |1: OTG as Host + */ + __IO uint32_t CTL; /*!< [0x0000] OTG Control Register */ + __IO uint32_t PHYCTL; /*!< [0x0004] OTG PHY Control Register */ + __IO uint32_t INTEN; /*!< [0x0008] OTG Interrupt Enable Register */ + __IO uint32_t INTSTS; /*!< [0x000c] OTG Interrupt Status Register */ + __I uint32_t STATUS; /*!< [0x0010] OTG Status Register */ + +} OTG_T; + + +/** + @addtogroup OTG_CONST OTG Bit Field Definition + Constant Definitions for OTG Controller +@{ */ + +#define OTG_CTL_VBUSDROP_Pos (0) /*!< OTG_T::CTL: VBUSDROP Position */ +#define OTG_CTL_VBUSDROP_Msk (0x1ul << OTG_CTL_VBUSDROP_Pos) /*!< OTG_T::CTL: VBUSDROP Mask */ + +#define OTG_CTL_BUSREQ_Pos (1) /*!< OTG_T::CTL: BUSREQ Position */ +#define OTG_CTL_BUSREQ_Msk (0x1ul << OTG_CTL_BUSREQ_Pos) /*!< OTG_T::CTL: BUSREQ Mask */ + +#define OTG_CTL_HNPREQEN_Pos (2) /*!< OTG_T::CTL: HNPREQEN Position */ +#define OTG_CTL_HNPREQEN_Msk (0x1ul << OTG_CTL_HNPREQEN_Pos) /*!< OTG_T::CTL: HNPREQEN Mask */ + +#define OTG_CTL_OTGEN_Pos (4) /*!< OTG_T::CTL: OTGEN Position */ +#define OTG_CTL_OTGEN_Msk (0x1ul << OTG_CTL_OTGEN_Pos) /*!< OTG_T::CTL: OTGEN Mask */ + +#define OTG_CTL_WKEN_Pos (5) /*!< OTG_T::CTL: WKEN Position */ +#define OTG_CTL_WKEN_Msk (0x1ul << OTG_CTL_WKEN_Pos) /*!< OTG_T::CTL: WKEN Mask */ + +#define OTG_PHYCTL_OTGPHYEN_Pos (0) /*!< OTG_T::PHYCTL: OTGPHYEN Position */ +#define OTG_PHYCTL_OTGPHYEN_Msk (0x1ul << OTG_PHYCTL_OTGPHYEN_Pos) /*!< OTG_T::PHYCTL: OTGPHYEN Mask */ + +#define OTG_PHYCTL_IDDETEN_Pos (1) /*!< OTG_T::PHYCTL: IDDETEN Position */ +#define OTG_PHYCTL_IDDETEN_Msk (0x1ul << OTG_PHYCTL_IDDETEN_Pos) /*!< OTG_T::PHYCTL: IDDETEN Mask */ + +#define OTG_PHYCTL_VBENPOL_Pos (4) /*!< OTG_T::PHYCTL: VBENPOL Position */ +#define OTG_PHYCTL_VBENPOL_Msk (0x1ul << OTG_PHYCTL_VBENPOL_Pos) /*!< OTG_T::PHYCTL: VBENPOL Mask */ + +#define OTG_PHYCTL_VBSTSPOL_Pos (5) /*!< OTG_T::PHYCTL: VBSTSPOL Position */ +#define OTG_PHYCTL_VBSTSPOL_Msk (0x1ul << OTG_PHYCTL_VBSTSPOL_Pos) /*!< OTG_T::PHYCTL: VBSTSPOL Mask */ + +#define OTG_INTEN_ROLECHGIEN_Pos (0) /*!< OTG_T::INTEN: ROLECHGIEN Position */ +#define OTG_INTEN_ROLECHGIEN_Msk (0x1ul << OTG_INTEN_ROLECHGIEN_Pos) /*!< OTG_T::INTEN: ROLECHGIEN Mask */ + +#define OTG_INTEN_VBEIEN_Pos (1) /*!< OTG_T::INTEN: VBEIEN Position */ +#define OTG_INTEN_VBEIEN_Msk (0x1ul << OTG_INTEN_VBEIEN_Pos) /*!< OTG_T::INTEN: VBEIEN Mask */ + +#define OTG_INTEN_SRPFIEN_Pos (2) /*!< OTG_T::INTEN: SRPFIEN Position */ +#define OTG_INTEN_SRPFIEN_Msk (0x1ul << OTG_INTEN_SRPFIEN_Pos) /*!< OTG_T::INTEN: SRPFIEN Mask */ + +#define OTG_INTEN_HNPFIEN_Pos (3) /*!< OTG_T::INTEN: HNPFIEN Position */ +#define OTG_INTEN_HNPFIEN_Msk (0x1ul << OTG_INTEN_HNPFIEN_Pos) /*!< OTG_T::INTEN: HNPFIEN Mask */ + +#define OTG_INTEN_GOIDLEIEN_Pos (4) /*!< OTG_T::INTEN: GOIDLEIEN Position */ +#define OTG_INTEN_GOIDLEIEN_Msk (0x1ul << OTG_INTEN_GOIDLEIEN_Pos) /*!< OTG_T::INTEN: GOIDLEIEN Mask */ + +#define OTG_INTEN_IDCHGIEN_Pos (5) /*!< OTG_T::INTEN: IDCHGIEN Position */ +#define OTG_INTEN_IDCHGIEN_Msk (0x1ul << OTG_INTEN_IDCHGIEN_Pos) /*!< OTG_T::INTEN: IDCHGIEN Mask */ + +#define OTG_INTEN_PDEVIEN_Pos (6) /*!< OTG_T::INTEN: PDEVIEN Position */ +#define OTG_INTEN_PDEVIEN_Msk (0x1ul << OTG_INTEN_PDEVIEN_Pos) /*!< OTG_T::INTEN: PDEVIEN Mask */ + +#define OTG_INTEN_HOSTIEN_Pos (7) /*!< OTG_T::INTEN: HOSTIEN Position */ +#define OTG_INTEN_HOSTIEN_Msk (0x1ul << OTG_INTEN_HOSTIEN_Pos) /*!< OTG_T::INTEN: HOSTIEN Mask */ + +#define OTG_INTEN_BVLDCHGIEN_Pos (8) /*!< OTG_T::INTEN: BVLDCHGIEN Position */ +#define OTG_INTEN_BVLDCHGIEN_Msk (0x1ul << OTG_INTEN_BVLDCHGIEN_Pos) /*!< OTG_T::INTEN: BVLDCHGIEN Mask */ + +#define OTG_INTEN_AVLDCHGIEN_Pos (9) /*!< OTG_T::INTEN: AVLDCHGIEN Position */ +#define OTG_INTEN_AVLDCHGIEN_Msk (0x1ul << OTG_INTEN_AVLDCHGIEN_Pos) /*!< OTG_T::INTEN: AVLDCHGIEN Mask */ + +#define OTG_INTEN_VBCHGIEN_Pos (10) /*!< OTG_T::INTEN: VBCHGIEN Position */ +#define OTG_INTEN_VBCHGIEN_Msk (0x1ul << OTG_INTEN_VBCHGIEN_Pos) /*!< OTG_T::INTEN: VBCHGIEN Mask */ + +#define OTG_INTEN_SECHGIEN_Pos (11) /*!< OTG_T::INTEN: SECHGIEN Position */ +#define OTG_INTEN_SECHGIEN_Msk (0x1ul << OTG_INTEN_SECHGIEN_Pos) /*!< OTG_T::INTEN: SECHGIEN Mask */ + +#define OTG_INTEN_SRPDETIEN_Pos (13) /*!< OTG_T::INTEN: SRPDETIEN Position */ +#define OTG_INTEN_SRPDETIEN_Msk (0x1ul << OTG_INTEN_SRPDETIEN_Pos) /*!< OTG_T::INTEN: SRPDETIEN Mask */ + +#define OTG_INTSTS_ROLECHGIF_Pos (0) /*!< OTG_T::INTSTS: ROLECHGIF Position */ +#define OTG_INTSTS_ROLECHGIF_Msk (0x1ul << OTG_INTSTS_ROLECHGIF_Pos) /*!< OTG_T::INTSTS: ROLECHGIF Mask */ + +#define OTG_INTSTS_VBEIF_Pos (1) /*!< OTG_T::INTSTS: VBEIF Position */ +#define OTG_INTSTS_VBEIF_Msk (0x1ul << OTG_INTSTS_VBEIF_Pos) /*!< OTG_T::INTSTS: VBEIF Mask */ + +#define OTG_INTSTS_SRPFIF_Pos (2) /*!< OTG_T::INTSTS: SRPFIF Position */ +#define OTG_INTSTS_SRPFIF_Msk (0x1ul << OTG_INTSTS_SRPFIF_Pos) /*!< OTG_T::INTSTS: SRPFIF Mask */ + +#define OTG_INTSTS_HNPFIF_Pos (3) /*!< OTG_T::INTSTS: HNPFIF Position */ +#define OTG_INTSTS_HNPFIF_Msk (0x1ul << OTG_INTSTS_HNPFIF_Pos) /*!< OTG_T::INTSTS: HNPFIF Mask */ + +#define OTG_INTSTS_GOIDLEIF_Pos (4) /*!< OTG_T::INTSTS: GOIDLEIF Position */ +#define OTG_INTSTS_GOIDLEIF_Msk (0x1ul << OTG_INTSTS_GOIDLEIF_Pos) /*!< OTG_T::INTSTS: GOIDLEIF Mask */ + +#define OTG_INTSTS_IDCHGIF_Pos (5) /*!< OTG_T::INTSTS: IDCHGIF Position */ +#define OTG_INTSTS_IDCHGIF_Msk (0x1ul << OTG_INTSTS_IDCHGIF_Pos) /*!< OTG_T::INTSTS: IDCHGIF Mask */ + +#define OTG_INTSTS_PDEVIF_Pos (6) /*!< OTG_T::INTSTS: PDEVIF Position */ +#define OTG_INTSTS_PDEVIF_Msk (0x1ul << OTG_INTSTS_PDEVIF_Pos) /*!< OTG_T::INTSTS: PDEVIF Mask */ + +#define OTG_INTSTS_HOSTIF_Pos (7) /*!< OTG_T::INTSTS: HOSTIF Position */ +#define OTG_INTSTS_HOSTIF_Msk (0x1ul << OTG_INTSTS_HOSTIF_Pos) /*!< OTG_T::INTSTS: HOSTIF Mask */ + +#define OTG_INTSTS_BVLDCHGIF_Pos (8) /*!< OTG_T::INTSTS: BVLDCHGIF Position */ +#define OTG_INTSTS_BVLDCHGIF_Msk (0x1ul << OTG_INTSTS_BVLDCHGIF_Pos) /*!< OTG_T::INTSTS: BVLDCHGIF Mask */ + +#define OTG_INTSTS_AVLDCHGIF_Pos (9) /*!< OTG_T::INTSTS: AVLDCHGIF Position */ +#define OTG_INTSTS_AVLDCHGIF_Msk (0x1ul << OTG_INTSTS_AVLDCHGIF_Pos) /*!< OTG_T::INTSTS: AVLDCHGIF Mask */ + +#define OTG_INTSTS_VBCHGIF_Pos (10) /*!< OTG_T::INTSTS: VBCHGIF Position */ +#define OTG_INTSTS_VBCHGIF_Msk (0x1ul << OTG_INTSTS_VBCHGIF_Pos) /*!< OTG_T::INTSTS: VBCHGIF Mask */ + +#define OTG_INTSTS_SECHGIF_Pos (11) /*!< OTG_T::INTSTS: SECHGIF Position */ +#define OTG_INTSTS_SECHGIF_Msk (0x1ul << OTG_INTSTS_SECHGIF_Pos) /*!< OTG_T::INTSTS: SECHGIF Mask */ + +#define OTG_INTSTS_SRPDETIF_Pos (13) /*!< OTG_T::INTSTS: SRPDETIF Position */ +#define OTG_INTSTS_SRPDETIF_Msk (0x1ul << OTG_INTSTS_SRPDETIF_Pos) /*!< OTG_T::INTSTS: SRPDETIF Mask */ + +#define OTG_STATUS_OVERCUR_Pos (0) /*!< OTG_T::STATUS: OVERCUR Position */ +#define OTG_STATUS_OVERCUR_Msk (0x1ul << OTG_STATUS_OVERCUR_Pos) /*!< OTG_T::STATUS: OVERCUR Mask */ + +#define OTG_STATUS_IDSTS_Pos (1) /*!< OTG_T::STATUS: IDSTS Position */ +#define OTG_STATUS_IDSTS_Msk (0x1ul << OTG_STATUS_IDSTS_Pos) /*!< OTG_T::STATUS: IDSTS Mask */ + +#define OTG_STATUS_SESSEND_Pos (2) /*!< OTG_T::STATUS: SESSEND Position */ +#define OTG_STATUS_SESSEND_Msk (0x1ul << OTG_STATUS_SESSEND_Pos) /*!< OTG_T::STATUS: SESSEND Mask */ + +#define OTG_STATUS_BVLD_Pos (3) /*!< OTG_T::STATUS: BVLD Position */ +#define OTG_STATUS_BVLD_Msk (0x1ul << OTG_STATUS_BVLD_Pos) /*!< OTG_T::STATUS: BVLD Mask */ + +#define OTG_STATUS_AVLD_Pos (4) /*!< OTG_T::STATUS: AVLD Position */ +#define OTG_STATUS_AVLD_Msk (0x1ul << OTG_STATUS_AVLD_Pos) /*!< OTG_T::STATUS: AVLD Mask */ + +#define OTG_STATUS_VBUSVLD_Pos (5) /*!< OTG_T::STATUS: VBUSVLD Position */ +#define OTG_STATUS_VBUSVLD_Msk (0x1ul << OTG_STATUS_VBUSVLD_Pos) /*!< OTG_T::STATUS: VBUSVLD Mask */ + +#define OTG_STATUS_ASPERI_Pos (6) /*!< OTG_T::STATUS: ASPERI Position */ +#define OTG_STATUS_ASPERI_Msk (0x1ul << OTG_STATUS_ASPERI_Pos) /*!< OTG_T::STATUS: ASPERI Mask */ + +#define OTG_STATUS_ASHOST_Pos (7) /*!< OTG_T::STATUS: ASHOST Position */ +#define OTG_STATUS_ASHOST_Msk (0x1ul << OTG_STATUS_ASHOST_Pos) /*!< OTG_T::STATUS: ASHOST Mask */ + +/**@}*/ /* OTG_CONST */ +/**@}*/ /* end of OTG register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __OTG_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/pdma_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/pdma_reg.h new file mode 100644 index 00000000000..a849d6bdcf5 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/pdma_reg.h @@ -0,0 +1,886 @@ +/**************************************************************************//** + * @file pdma_reg.h + * @version V1.00 + * @brief PDMA register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __PDMA_REG_H__ +#define __PDMA_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup PDMA Peripheral Direct Memory Access Controller(PDMA) + Memory Mapped Structure for PDMA Controller +@{ */ + + +typedef struct +{ + + /** + * @var DSCT_T::CTL + * Offset: 0x00 Descriptor Table Control Register of PDMA Channel n. + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |OPMODE |PDMA Operation Mode Selection + * | | |00 = Idle state: Channel is stopped or this table is complete, when PDMA finish channel table task, OPMODE will be cleared to idle state automatically. + * | | |01 = Basic mode: The descriptor table only has one task + * | | |When this task is finished, the PDMA_INTSTS[n] will be asserted. + * | | |10 = Scatter-Gather mode: When operating in this mode, user must give the next descriptor table address in PDMA_DSCT_NEXT register; PDMA controller will ignore this task, then load the next task to execute. + * | | |11 = Reserved. + * | | |Note: Before filling transfer task in the Descriptor Table, user must check if the descriptor table is complete. + * |[2] |TXTYPE |Transfer Type + * | | |0 = Burst transfer type. + * | | |1 = Single transfer type. + * |[6:4] |BURSIZE |Burst Size + * | | |This field is used for peripheral to determine the burst size or used for determine the re-arbitration size. + * | | |000 = 128 Transfers. + * | | |001 = 64 Transfers. + * | | |010 = 32 Transfers. + * | | |011 = 16 Transfers. + * | | |100 = 8 Transfers. + * | | |101 = 4 Transfers. + * | | |110 = 2 Transfers. + * | | |111 = 1 Transfers. + * | | |Note: This field is only useful in burst transfer type. + * |[7] |TBINTDIS |Table Interrupt Disable Bit + * | | |This field can be used to decide whether to enable table interrupt or not + * | | |If the TBINTDIS bit is enabled when PDMA controller finishes transfer task, it will not generates transfer done interrupt. + * | | |0 = Table interrupt Enabled. + * | | |1 = Table interrupt Disabled. + * |[9:8] |SAINC |Source Address Increment + * | | |This field is used to set the source address increment size. + * | | |11 = No increment (fixed address). + * | | |Others = Increment and size is depended on TXWIDTH selection. + * |[11:10] |DAINC |Destination Address Increment + * | | |This field is used to set the destination address increment size. + * | | |11 = No increment (fixed address). + * | | |Others = Increment and size is depended on TXWIDTH selection. + * |[13:12] |TXWIDTH |Transfer Width Selection + * | | |This field is used for transfer width. + * | | |00 = One byte (8 bit) is transferred for every operation. + * | | |01= One half-word (16 bit) is transferred for every operation. + * | | |10 = One word (32-bit) is transferred for every operation. + * | | |11 = Reserved. + * | | |Note: The PDMA transfer source address (PDMA_DSCT_SA) and PDMA transfer destination address (PDMA_DSCT_DA) should be alignment under the TXWIDTH selection + * |[14] |TXACK |Transfer Acknowledge Selection + * | | |0 = transfer ack when transfer done. + * | | |1 = transfer ack when PDMA get transfer data. + * |[15] |STRIDEEN |Stride Mode Enable Bit + * | | |0 = Stride transfer mode Disabled. + * | | |1 = Stride transfer mode Enabled. + * |[31:16] |TXCNT |Transfer Count + * | | |The TXCNT represents the required number of PDMA transfer, the real transfer count is (TXCNT + 1); The maximum transfer count is 16384 , every transfer may be byte, half-word or word that is dependent on TXWIDTH field. + * | | |Note: When PDMA finish each transfer data, this field will be decrease immediately. + * @var DSCT_T::SA + * Offset: 0x04 Source Address Register of PDMA Channel n + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |SA |PDMA Transfer Source Address Register + * | | |This field indicates a 32-bit source address of PDMA controller. + * @var DSCT_T::DA + * Offset: 0x08 Destination Address Register of PDMA Channel n + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |DA |PDMA Transfer Destination Address Register + * | | |This field indicates a 32-bit destination address of PDMA controller. + * @var DSCT_T::NEXT + * Offset: 0x0C Next Scatter-Gather Descriptor Table Offset Address of PDMA Channel n + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |EXENEXT |PDMA Execution Next Descriptor Table Offset + * | | |This field indicates the offset of next descriptor table address of current execution descriptor table in system memory. + * | | |Note: write operation is useless in this field. + * |[31:16] |NEXT |PDMA Next Descriptor Table Offset. + * | | |This field indicates the offset of the next descriptor table address in system memory. + * | | |Write Operation: + * | | |If the system memory based address is 0x2000_0000 (PDMA_SCATBA), and the next descriptor table is start from 0x2000_0100, then this field must fill in 0x0100. + * | | |Read Operation: + * | | |When operating in scatter-gather mode, the last two bits NEXT[1:0] will become reserved, and indicate the first next address of system memory. + * | | |Note1: The descriptor table address must be word boundary. + * | | |Note2: Before filled transfer task in the descriptor table, user must check if the descriptor table is complete. + */ + __IO uint32_t CTL; /*!< [0x0000] Descriptor Table Control Register of PDMA Channel n. */ + __IO uint32_t SA; /*!< [0x0004] Source Address Register of PDMA Channel n */ + __IO uint32_t DA; /*!< [0x0008] Destination Address Register of PDMA Channel n */ + __IO uint32_t NEXT; /*!< [0x000c] First Scatter-Gather Descriptor Table Offset Address of PDMA Channel n */ +} DSCT_T; + + +typedef struct +{ + /** + * @var STRIDE_T::STCR + * Offset: 0x500 Stride Transfer Count Register of PDMA Channel n + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |STC |PDMA Stride Transfer Count + * | | |The 16-bit register defines the stride transfer count of each row. + * @var STRIDE_T::ASOCR + * Offset: 0x504 Address Stride Offset Register of PDMA Channel n + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |SASOL |VDMA Source Address Stride Offset Length + * | | |The 16-bit register defines the source address stride transfer offset count of each row. + * |[31:16] |DASOL |VDMA Destination Address Stride Offset Length + * | | |The 16-bit register defines the destination address stride transfer offset count of each row. + */ + __IO uint32_t STCR; /*!< [0x0500] Stride Transfer Count Register of PDMA Channel 0 */ + __IO uint32_t ASOCR; /*!< [0x0504] Address Stride Offset Register of PDMA Channel 0 */ +} STRIDE_T; + +typedef struct +{ + /** + * @var REPEAT_T::AICTL + * Offset: 0x600 Address Interval Control Register of PDMA Channel n + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |SAICNT |PDMA Source Address Interval Count + * | | |The 16-bit register defines the source address interval count of each row. + * |[31:16] |DAICNT |PDMA Destination Address Interval Count + * | | |The 16-bit register defines the destination address interval count of each row. + * @var REPEAT_T::RCNT + * Offset: 0x604 Repeat Count Register of PDMA Channe n + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |RCNT |PDMA Repeat Count + * | | |The 16-bit register defines the repeat times of block transfer. + */ + __IO uint32_t AICTL; /*!< [0x0600] Address Interval Control Register of PDMA Channel 0 */ + __IO uint32_t RCNT; /*!< [0x0604] Repeat Count Register of PDMA Channel 0 */ +} REPEAT_T; + +typedef struct +{ + + + /** + * @var PDMA_T::CURSCAT + * Offset: 0x100 Current Scatter-Gather Descriptor Table Address of PDMA Channel n + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |CURADDR |PDMA Current Description Address Register (Read Only) + * | | |This field indicates a 32-bit current external description address of PDMA controller. + * | | |Note: This field is read only and only used for Scatter-Gather mode to indicate the current external description address. + * @var PDMA_T::CHCTL + * Offset: 0x400 PDMA Channel Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |CHENn |PDMA Channel Enable Bit + * | | |Set this bit to 1 to enable PDMAn operation. Channel cannot be active if it is not set as enabled. + * | | |0 = PDMA channel [n] Disabled. + * | | |1 = PDMA channel [n] Enabled. + * | | |Note: Set corresponding bit of PDMA_PAUSE or PDMA_CHRST register will also clear this bit. + * @var PDMA_T::PAUSE + * Offset: 0x404 PDMA Transfer Stop Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |PAUSEn |PDMA Transfer Pause Control Register (Write Only) + * | | |User can set PAUSEn bit field to pause the PDMA transfer + * | | |When user sets PAUSEn bit, the PDMA controller will pause the on-going transfer, then clear the channel enable bit CHEN(PDMA_CHCTL [n], n=0,1..7) and clear request active flag + * | | |If re-enable the paused channel again, the remaining transfers will be processed. + * | | |0 = No effect. + * | | |1 = Pause PDMA channel n transfer. + * @var PDMA_T::SWREQ + * Offset: 0x408 PDMA Software Request Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |SWREQn |PDMA Software Request Register (Write Only) + * | | |Set this bit to 1 to generate a software request to PDMA [n]. + * | | |0 = No effect. + * | | |1 = Generate a software request. + * | | |Note1: User can read PDMA_TRGSTS register to know which channel is on active + * | | |Active flag may be triggered by software request or peripheral request. + * | | |Note2: If user does not enable corresponding PDMA channel, the software request will be ignored. + * @var PDMA_T::TRGSTS + * Offset: 0x40C PDMA Channel Request Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |REQSTSn |PDMA Channel Request Status (Read Only) + * | | |This flag indicates whether channel[n] have a request or not, no matter request from software or peripheral + * | | |When PDMA controller finishes channel transfer, this bit will be cleared automatically. + * | | |0 = PDMA Channel n has no request. + * | | |1 = PDMA Channel n has a request. + * | | |Note: If user pauses or resets each PDMA transfer by setting PDMA_PAUSE or PDMA_CHRST register respectively, this bit will be cleared automatically after finishing current transfer. + * @var PDMA_T::PRISET + * Offset: 0x410 PDMA Fixed Priority Setting Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |FPRISETn |PDMA Fixed Priority Setting Register + * | | |Set this bit to 1 to enable fixed priority level. + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Set PDMA channel [n] to fixed priority channel. + * | | |Read Operation: + * | | |0 = Corresponding PDMA channel is round-robin priority. + * | | |1 = Corresponding PDMA channel is fixed priority. + * | | |Note: This field only set to fixed priority, clear fixed priority use PDMA_PRICLR register. + * @var PDMA_T::PRICLR + * Offset: 0x414 PDMA Fixed Priority Clear Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |FPRICLRn |PDMA Fixed Priority Clear Register (Write Only) + * | | |Set this bit to 1 to clear fixed priority level. + * | | |0 = No effect. + * | | |1 = Clear PDMA channel [n] fixed priority setting. + * | | |Note: User can read PDMA_PRISET register to know the channel priority. + * @var PDMA_T::INTEN + * Offset: 0x418 PDMA Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |INTENn |PDMA Interrupt Enable Register + * | | |This field is used for enabling PDMA channel[n] interrupt. + * | | |0 = PDMA channel n interrupt Disabled. + * | | |1 = PDMA channel n interrupt Enabled. + * @var PDMA_T::INTSTS + * Offset: 0x41C PDMA Interrupt Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ABTIF |PDMA Read/Write Target Abort Interrupt Flag (Read-only) + * | | |This bit indicates that PDMA has target abort error; Software can read PDMA_ABTSTS register to find which channel has target abort error. + * | | |0 = No AHB bus ERROR response received. + * | | |1 = AHB bus ERROR response received. + * |[1] |TDIF |Transfer Done Interrupt Flag (Read Only) + * | | |This bit indicates that PDMA controller has finished transmission; User can read PDMA_TDSTS register to indicate which channel finished transfer. + * | | |0 = Not finished yet. + * | | |1 = PDMA channel has finished transmission. + * |[2] |ALIGNF |Transfer Alignment Interrupt Flag (Read Only) + * | | |0 = PDMA channel source address and destination address both follow transfer width setting. + * | | |1 = PDMA channel source address or destination address is not follow transfer width setting. + * |[8] |REQTOF0 |Request Time-out Flag for Channel 0 + * | | |This flag indicates that PDMA controller has waited peripheral request for a period defined by PDMA_TOC0, user can write 1 to clear these bits. + * | | |0 = No request time-out. + * | | |1 = Peripheral request time-out. + * |[9] |REQTOF1 |Request Time-out Flag for Channel 1 + * | | |This flag indicates that PDMA controller has waited peripheral request for a period defined by PDMA_TOC1, user can write 1 to clear these bits. + * | | |0 = No request time-out. + * | | |1 = Peripheral request time-out. + * @var PDMA_T::ABTSTS + * Offset: 0x420 PDMA Channel Read/Write Target Abort Flag Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |ABTIFn |PDMA Read/Write Target Abort Interrupt Status Flag + * | | |This bit indicates which PDMA controller has target abort error; User can write 1 to clear these bits. + * | | |0 = No AHB bus ERROR response received when channel n transfer. + * | | |1 = AHB bus ERROR response received when channel n transfer. + * @var PDMA_T::TDSTS + * Offset: 0x424 PDMA Channel Transfer Done Flag Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |TDIFn |Transfer Done Flag Register + * | | |This bit indicates whether PDMA controller channel transfer has been finished or not, user can write 1 to clear these bits. + * | | |0 = PDMA channel transfer has not finished. + * | | |1 = PDMA channel has finished transmission. + * @var PDMA_T::ALIGN + * Offset: 0x428 PDMA Transfer Alignment Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |ALIGNn |Transfer Alignment Flag Register + * | | |0 = PDMA channel source address and destination address both follow transfer width setting. + * | | |1 = PDMA channel source address or destination address is not follow transfer width setting. + * @var PDMA_T::TACTSTS + * Offset: 0x42C PDMA Transfer Active Flag Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |TXACTFn |Transfer on Active Flag Register (Read Only) + * | | |This bit indicates which PDMA channel is in active. + * | | |0 = PDMA channel is not finished. + * | | |1 = PDMA channel is active. + * @var PDMA_T::TOUTPSC + * Offset: 0x430 PDMA Time-out Prescaler Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2:0] |TOUTPSC0 |PDMA Channel 0 Time-out Clock Source Prescaler Bits + * | | |000 = PDMA channel 0 time-out clock source is HCLK/28. + * | | |001 = PDMA channel 0 time-out clock source is HCLK/29. + * | | |010 = PDMA channel 0 time-out clock source is HCLK/210. + * | | |011 = PDMA channel 0 time-out clock source is HCLK/211. + * | | |100 = PDMA channel 0 time-out clock source is HCLK/212. + * | | |101 = PDMA channel 0 time-out clock source is HCLK/213. + * | | |110 = PDMA channel 0 time-out clock source is HCLK/214. + * | | |111 = PDMA channel 0 time-out clock source is HCLK/215. + * |[6:4] |TOUTPSC1 |PDMA Channel 1 Time-out Clock Source Prescaler Bits + * | | |000 = PDMA channel 1 time-out clock source is HCLK/28. + * | | |001 = PDMA channel 1 time-out clock source is HCLK/29. + * | | |010 = PDMA channel 1 time-out clock source is HCLK/210. + * | | |011 = PDMA channel 1 time-out clock source is HCLK/211. + * | | |100 = PDMA channel 1 time-out clock source is HCLK/212. + * | | |101 = PDMA channel 1 time-out clock source is HCLK/213. + * | | |110 = PDMA channel 1 time-out clock source is HCLK/214. + * | | |111 = PDMA channel 1 time-out clock source is HCLK/215. + * @var PDMA_T::TOUTEN + * Offset: 0x434 PDMA Time-out Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |TOUTENn |PDMA Time-out Enable Bits + * | | |0 = PDMA Channel n time-out function Disable. + * | | |1 = PDMA Channel n time-out function Enable. + * @var PDMA_T::TOUTIEN + * Offset: 0x438 PDMA Time-out Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |TOUTIENn |PDMA Time-out Interrupt Enable Bits + * | | |0 = PDMA Channel n time-out interrupt Disable. + * | | |1 = PDMA Channel n time-out interrupt Enable. + * @var PDMA_T::SCATBA + * Offset: 0x43C PDMA Scatter-Gather Descriptor Table Base Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:16] |SCATBA |PDMA Scatter-gather Descriptor Table Address Register + * | | |In Scatter-Gather mode, this is the base address for calculating the next link - list address + * | | |The next link address equation is + * | | |Next Link Address = PDMA_SCATBA + PDMA_DSCT_NEXT. + * | | |Note: Only useful in Scatter-Gather mode. + * @var PDMA_T::TOC0_1 + * Offset: 0x440 PDMA Time-out Counter Ch1 and Ch0 Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |TOC0 |Time-out Counter for Channel 0 + * | | |This controls the period of time-out function for channel 0 + * | | |The calculation unit is based on 10 kHz clock. + * |[31:16] |TOC1 |Time-out Counter for Channel 1 + * | | |This controls the period of time-out function for channel 1 + * | | |The calculation unit is based on 10 kHz clock. + * @var PDMA_T::CHRST + * Offset: 0x460 PDMA Channel Reset Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |CHnRST |Channel N Reset + * | | |0 = corresponding channel n not reset. + * | | |1 = corresponding channel n is reset. + * @var PDMA_T::REQSEL0_3 + * Offset: 0x480 PDMA Request Source Select Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[6:0] |REQSRC0 |Channel 0 Request Source Selection + * | | |This filed defines which peripheral is connected to PDMA channel 0 + * | | |User can configure the peripheral by setting REQSRC0. + * | | |0 = Disable PDMA peripheral request. + * | | |1 = Reserved. + * | | |2 = Channel connects to USB_TX. + * | | |3 = Channel connects to USB_RX. + * | | |4 = Channel connects to UART0_TX. + * | | |5 = Channel connects to UART0_RX. + * | | |6 = Channel connects to UART1_TX. + * | | |7 = Channel connects to UART1_RX. + * | | |8 = Channel connects to UART2_TX. + * | | |9 = Channel connects to UART2_RX. + * | | |10=Channel connects to UART3_TX. + * | | |11 = Channel connects to UART3_RX. + * | | |12 = Channel connects to UART4_TX. + * | | |13 = Channel connects to UART4_RX. + * | | |14 = Channel connects to UART5_TX. + * | | |15 = Channel connects to UART5_RX. + * | | |16 = Channel connects to USCI0_TX. + * | | |17 = Channel connects to USCI0_RX. + * | | |18 = Channel connects to USCI1_TX. + * | | |19 = Channel connects to USCI1_RX. + * | | |20 = Channel connects to QSPI0_TX. + * | | |21 = Channel connects to QSPI0_RX. + * | | |22 = Channel connects to SPI0_TX. + * | | |23 = Channel connects to SPI0_RX. + * | | |24 = Channel connects to SPI1_TX. + * | | |25 = Channel connects to SPI1_RX. + * | | |26 = Channel connects to SPI2_TX. + * | | |27 = Channel connects to SPI2_RX. + * | | |28 = Channel connects to SPI3_TX. + * | | |29 = Channel connects to SPI3_RX. + * | | |30 = Reserved. + * | | |31 = Reserved. + * | | |32 = Channel connects to EPWM0_P1_RX. + * | | |33 = Channel connects to EPWM0_P2_RX. + * | | |34 = Channel connects to EPWM0_P3_RX. + * | | |35 = Channel connects to EPWM1_P1_RX. + * | | |36 = Channel connects to EPWM1_P2_RX. + * | | |37 = Channel connects to EPWM1_P3_RX. + * | | |38 = Channel connects to I2C0_TX. + * | | |39 = Channel connects to I2C0_RX. + * | | |40 = Channel connects to I2C1_TX. + * | | |41 = Channel connects to I2C1_RX. + * | | |42 = Channel connects to I2C2_TX. + * | | |43 = Channel connects to I2C2_RX. + * | | |44 = Channel connects to I2S0_TX. + * | | |45 = Channel connects to I2S0_RX. + * | | |46 = Channel connects to TMR0. + * | | |47 = Channel connects to TMR1. + * | | |48 = Channel connects to TMR2. + * | | |49 = Channel connects to TMR3. + * | | |50 = Channel connects to ADC_RX. + * | | |51 = Channel connects to DAC0_TX. + * | | |52 = Channel connects to DAC1_TX. + * | | |53 = Channel connects to EPWM0_CH0_TX. + * | | |54 = Channel connects to EPWM0_CH1_TX. + * | | |55 = Channel connects to EPWM0_CH2_TX. + * | | |56 = Channel connects to EPWM0_CH3_TX. + * | | |57 = Channel connects to EPWM0_CH4_TX. + * | | |58 = Channel connects to EPWM0_CH5_TX. + * | | |59 = Channel connects to EPWM1_CH0_TX. + * | | |60 = Channel connects to EPWM1_CH1_TX. + * | | |61 = Channel connects to EPWM1_CH2_TX. + * | | |62 = Channel connects to EPWM1_CH3_TX. + * | | |63 = Channel connects to EPWM1_CH4_TX. + * | | |64 = Channel connects to EPWM1_CH5_TX. + * | | |65 = Channel connects to ETMC_RX. + * | | |Others = Reserved. + * | | |Note 1: A peripheral can't assign to two channels at the same time. + * | | |Note 2: This field is useless when transfer between memory and memory. + * |[14:8] |REQSRC1 |Channel 1 Request Source Selection + * | | |This filed defines which peripheral is connected to PDMA channel 1 + * | | |User can configure the peripheral setting by REQSRC1. + * | | |Note: The channel configuration is the same as REQSRC0 field + * | | |Please refer to the explanation of REQSRC0. + * |[22:16] |REQSRC2 |Channel 2 Request Source Selection + * | | |This filed defines which peripheral is connected to PDMA channel 2 + * | | |User can configure the peripheral setting by REQSRC2. + * | | |Note: The channel configuration is the same as REQSRC0 field + * | | |Please refer to the explanation of REQSRC0. + * |[30:24] |REQSRC3 |Channel 3 Request Source Selection + * | | |This filed defines which peripheral is connected to PDMA channel 3 + * | | |User can configure the peripheral setting by REQSRC3. + * | | |Note: The channel configuration is the same as REQSRC0 field + * | | |Please refer to the explanation of REQSRC0. + * @var PDMA_T::REQSEL4_7 + * Offset: 0x484 PDMA Request Source Select Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[6:0] |REQSRC4 |Channel 4 Request Source Selection + * | | |This filed defines which peripheral is connected to PDMA channel 4 + * | | |User can configure the peripheral setting by REQSRC4. + * | | |Note: The channel configuration is the same as REQSRC0 field + * | | |Please refer to the explanation of REQSRC0. + * |[14:8] |REQSRC5 |Channel 5 Request Source Selection + * | | |This filed defines which peripheral is connected to PDMA channel 5 + * | | |User can configure the peripheral setting by REQSRC5. + * | | |Note: The channel configuration is the same as REQSRC0 field + * | | |Please refer to the explanation of REQSRC0. + * |[22:16] |REQSRC6 |Channel 6 Request Source Selection + * | | |This filed defines which peripheral is connected to PDMA channel 6 + * | | |User can configure the peripheral setting by REQSRC6. + * | | |Note: The channel configuration is the same as REQSRC0 field + * | | |Please refer to the explanation of REQSRC0. + * |[30:24] |REQSRC7 |Channel 7 Request Source Selection + * | | |This filed defines which peripheral is connected to PDMA channel 7 + * | | |User can configure the peripheral setting by REQSRC7. + * | | |Note: The channel configuration is the same as REQSRC0 field + * | | |Please refer to the explanation of REQSRC0. + * @var PDMA_T::REQSEL8_11 + * Offset: 0x488 PDMA Request Source Select Register 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[6:0] |REQSRC8 |Channel 8 Request Source Selection + * | | |This filed defines which peripheral is connected to PDMA channel 8 + * | | |User can configure the peripheral setting by REQSRC8. + * | | |Note: The channel configuration is the same as REQSRC0 field + * | | |Please refer to the explanation of REQSRC0. + * |[14:8] |REQSRC9 |Channel 9 Request Source Selection + * | | |This filed defines which peripheral is connected to PDMA channel 9 + * | | |User can configure the peripheral setting by REQSRC9. + * | | |Note: The channel configuration is the same as REQSRC0 field + * | | |Please refer to the explanation of REQSRC0. + * |[22:16] |REQSRC10 |Channel 10 Request Source Selection + * | | |This filed defines which peripheral is connected to PDMA channel 10 + * | | |User can configure the peripheral setting by REQSRC10. + * | | |Note: The channel configuration is the same as REQSRC0 field + * | | |Please refer to the explanation of REQSRC0. + * |[30:24] |REQSRC11 |Channel 11 Request Source Selection + * | | |This filed defines which peripheral is connected to PDMA channel 11 + * | | |User can configure the peripheral setting by REQSRC11. + * | | |Note: The channel configuration is the same as REQSRC0 field + * | | |Please refer to the explanation of REQSRC0. + * @var PDMA_T::REQSEL12_15 + * Offset: 0x48C PDMA Request Source Select Register 3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[6:0] |REQSRC12 |Channel 12 Request Source Selection + * | | |This filed defines which peripheral is connected to PDMA channel 12 + * | | |User can configure the peripheral setting by REQSRC12. + * | | |Note: The channel configuration is the same as REQSRC0 field + * | | |Please refer to the explanation of REQSRC0. + * |[14:8] |REQSRC13 |Channel 13 Request Source Selection + * | | |This filed defines which peripheral is connected to PDMA channel 13 + * | | |User can configure the peripheral setting by REQSRC13. + * | | |Note: The channel configuration is the same as REQSRC0 field + * | | |Please refer to the explanation of REQSRC0. + * |[22:16] |REQSRC14 |Channel 14 Request Source Selection + * | | |This filed defines which peripheral is connected to PDMA channel 14 + * | | |User can configure the peripheral setting by REQSRC14. + * | | |Note: The channel configuration is the same as REQSRC0 field + * | | |Please refer to the explanation of REQSRC0. + * |[30:24] |REQSRC15 |Channel 15 Request Source Selection + * | | |This filed defines which peripheral is connected to PDMA channel 15 + * | | |User can configure the peripheral setting by REQSRC15. + * | | |Note: The channel configuration is the same as REQSRC0 field + * | | |Please refer to the explanation of REQSRC0. + */ + DSCT_T DSCT[16]; + __I uint32_t CURSCAT[16]; /*!< [0x0100] Current Scatter-Gather Descriptor Table Address of PDMA Channel n */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE1[176]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t CHCTL; /*!< [0x0400] PDMA Channel Control Register */ + __O uint32_t PAUSE; /*!< [0x0404] PDMA Transfer Pause Control Register */ + __O uint32_t SWREQ; /*!< [0x0408] PDMA Software Request Register */ + __I uint32_t TRGSTS; /*!< [0x040c] PDMA Channel Request Status Register */ + __IO uint32_t PRISET; /*!< [0x0410] PDMA Fixed Priority Setting Register */ + __O uint32_t PRICLR; /*!< [0x0414] PDMA Fixed Priority Clear Register */ + __IO uint32_t INTEN; /*!< [0x0418] PDMA Interrupt Enable Register */ + __IO uint32_t INTSTS; /*!< [0x041c] PDMA Interrupt Status Register */ + __IO uint32_t ABTSTS; /*!< [0x0420] PDMA Channel Read/Write Target Abort Flag Register */ + __IO uint32_t TDSTS; /*!< [0x0424] PDMA Channel Transfer Done Flag Register */ + __IO uint32_t ALIGN; /*!< [0x0428] PDMA Transfer Alignment Status Register */ + __I uint32_t TACTSTS; /*!< [0x042c] PDMA Transfer Active Flag Register */ + __IO uint32_t TOUTPSC; /*!< [0x0430] PDMA Time-out Prescaler Register */ + __IO uint32_t TOUTEN; /*!< [0x0434] PDMA Time-out Enable Register */ + __IO uint32_t TOUTIEN; /*!< [0x0438] PDMA Time-out Interrupt Enable Register */ + __IO uint32_t SCATBA; /*!< [0x043c] PDMA Scatter-Gather Descriptor Table Base Address Register */ + __IO uint32_t TOC0_1; /*!< [0x0440] PDMA Time-out Counter Ch1 and Ch0 Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE2[7]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t CHRST; /*!< [0x0460] PDMA Channel Reset Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE3[7]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t REQSEL0_3; /*!< [0x0480] PDMA Request Source Select Register 0 */ + __IO uint32_t REQSEL4_7; /*!< [0x0484] PDMA Request Source Select Register 1 */ + __IO uint32_t REQSEL8_11; /*!< [0x0488] PDMA Request Source Select Register 2 */ + __IO uint32_t REQSEL12_15; /*!< [0x048c] PDMA Request Source Select Register 3 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE4[28]; + /// @endcond //HIDDEN_SYMBOLS + STRIDE_T STRIDE[6]; + /// @cond HIDDEN_SYMBOLS + __IO uint32_t RESERVE5[52]; + /// @endcond //HIDDEN_SYMBOLS + REPEAT_T REPEAT[2]; +} PDMA_T; + +/** + @addtogroup PDMA_CONST PDMA Bit Field Definition + Constant Definitions for PDMA Controller +@{ */ + +#define PDMA_DSCT_CTL_OPMODE_Pos (0) /*!< PDMA_T::DSCT_CTL: OPMODE Position */ +#define PDMA_DSCT_CTL_OPMODE_Msk (0x3ul << PDMA_DSCT_CTL_OPMODE_Pos) /*!< PDMA_T::DSCT_CTL: OPMODE Mask */ + +#define PDMA_DSCT_CTL_TXTYPE_Pos (2) /*!< PDMA_T::DSCT_CTL: TXTYPE Position */ +#define PDMA_DSCT_CTL_TXTYPE_Msk (0x1ul << PDMA_DSCT_CTL_TXTYPE_Pos) /*!< PDMA_T::DSCT_CTL: TXTYPE Mask */ + +#define PDMA_DSCT_CTL_BURSIZE_Pos (4) /*!< PDMA_T::DSCT_CTL: BURSIZE Position */ +#define PDMA_DSCT_CTL_BURSIZE_Msk (0x7ul << PDMA_DSCT_CTL_BURSIZE_Pos) /*!< PDMA_T::DSCT_CTL: BURSIZE Mask */ + +#define PDMA_DSCT_CTL_TBINTDIS_Pos (7) /*!< PDMA_T::DSCT_CTL: TBINTDIS Position */ +#define PDMA_DSCT_CTL_TBINTDIS_Msk (0x1ul << PDMA_DSCT_CTL_TBINTDIS_Pos) /*!< PDMA_T::DSCT_CTL: TBINTDIS Mask */ + +#define PDMA_DSCT_CTL_SAINC_Pos (8) /*!< PDMA_T::DSCT_CTL: SAINC Position */ +#define PDMA_DSCT_CTL_SAINC_Msk (0x3ul << PDMA_DSCT_CTL_SAINC_Pos) /*!< PDMA_T::DSCT_CTL: SAINC Mask */ + +#define PDMA_DSCT_CTL_DAINC_Pos (10) /*!< PDMA_T::DSCT_CTL: DAINC Position */ +#define PDMA_DSCT_CTL_DAINC_Msk (0x3ul << PDMA_DSCT_CTL_DAINC_Pos) /*!< PDMA_T::DSCT_CTL: DAINC Mask */ + +#define PDMA_DSCT_CTL_TXWIDTH_Pos (12) /*!< PDMA_T::DSCT_CTL: TXWIDTH Position */ +#define PDMA_DSCT_CTL_TXWIDTH_Msk (0x3ul << PDMA_DSCT_CTL_TXWIDTH_Pos) /*!< PDMA_T::DSCT_CTL: TXWIDTH Mask */ + +#define PDMA_DSCT_CTL_TXACK_Pos (14) /*!< PDMA_T::DSCT_CTL: TXACK Position */ +#define PDMA_DSCT_CTL_TXACK_Msk (0x1ul << PDMA_DSCT_CTL_TXACK_Pos) /*!< PDMA_T::DSCT_CTL: TXACK Mask */ + +#define PDMA_DSCT_CTL_STRIDEEN_Pos (15) /*!< PDMA_T::DSCT_CTL: STRIDEEN Position */ +#define PDMA_DSCT_CTL_STRIDEEN_Msk (0x1ul << PDMA_DSCT_CTL_STRIDEEN_Pos) /*!< PDMA_T::DSCT_CTL: STRIDEEN Mask */ + +#define PDMA_DSCT_CTL_TXCNT_Pos (16) /*!< PDMA_T::DSCT_CTL: TXCNT Position */ +#define PDMA_DSCT_CTL_TXCNT_Msk (0xfffful << PDMA_DSCT_CTL_TXCNT_Pos) /*!< PDMA_T::DSCT_CTL: TXCNT Mask */ + +#define PDMA_DSCT_SA_SA_Pos (0) /*!< PDMA_T::DSCT_SA: SA Position */ +#define PDMA_DSCT_SA_SA_Msk (0xfffffffful << PDMA_DSCT_SA_SA_Pos) /*!< PDMA_T::DSCT_SA: SA Mask */ + +#define PDMA_DSCT_DA_DA_Pos (0) /*!< PDMA_T::DSCT_DA: DA Position */ +#define PDMA_DSCT_DA_DA_Msk (0xfffffffful << PDMA_DSCT_DA_DA_Pos) /*!< PDMA_T::DSCT_DA: DA Mask */ + +#define PDMA_DSCT_NEXT_NEXT_Pos (0) /*!< PDMA_T::DSCT_NEXT: NEXT Position */ +#define PDMA_DSCT_NEXT_NEXT_Msk (0xfffful << PDMA_DSCT_NEXT_NEXT_Pos) /*!< PDMA_T::DSCT_NEXT: NEXT Mask */ + +#define PDMA_DSCT_NEXT_EXENEXT_Pos (16) /*!< PDMA_T::DSCT_FIRST: NEXT Position */ +#define PDMA_DSCT_NEXT_EXENEXT_Msk (0xfffful << PDMA_DSCT_NEXT_EXENEXT_Pos) /*!< PDMA_T::DSCT_FIRST: NEXT Mask */ + +#define PDMA_CURSCAT_CURADDR_Pos (0) /*!< PDMA_T::CURSCAT: CURADDR Position */ +#define PDMA_CURSCAT_CURADDR_Msk (0xfffffffful << PDMA_CURSCAT_CURADDR_Pos) /*!< PDMA_T::CURSCAT: CURADDR Mask */ + +#define PDMA_CHCTL_CHENn_Pos (0) /*!< PDMA_T::CHCTL: CHENn Position */ +#define PDMA_CHCTL_CHENn_Msk (0xfffful << PDMA_CHCTL_CHENn_Pos) /*!< PDMA_T::CHCTL: CHENn Mask */ + +#define PDMA_PAUSE_PAUSEn_Pos (0) /*!< PDMA_T::PAUSE: PAUSEn Position */ +#define PDMA_PAUSE_PAUSEn_Msk (0xfffful << PDMA_PAUSE_PAUSEn_Pos) /*!< PDMA_T::PAUSE: PAUSEn Mask */ + +#define PDMA_SWREQ_SWREQn_Pos (0) /*!< PDMA_T::SWREQ: SWREQn Position */ +#define PDMA_SWREQ_SWREQn_Msk (0xfffful << PDMA_SWREQ_SWREQn_Pos) /*!< PDMA_T::SWREQ: SWREQn Mask */ + +#define PDMA_TRGSTS_REQSTSn_Pos (0) /*!< PDMA_T::TRGSTS: REQSTSn Position */ +#define PDMA_TRGSTS_REQSTSn_Msk (0xfffful << PDMA_TRGSTS_REQSTSn_Pos) /*!< PDMA_T::TRGSTS: REQSTSn Mask */ + +#define PDMA_PRISET_FPRISETn_Pos (0) /*!< PDMA_T::PRISET: FPRISETn Position */ +#define PDMA_PRISET_FPRISETn_Msk (0xfffful << PDMA_PRISET_FPRISETn_Pos) /*!< PDMA_T::PRISET: FPRISETn Mask */ + +#define PDMA_PRICLR_FPRICLRn_Pos (0) /*!< PDMA_T::PRICLR: FPRICLRn Position */ +#define PDMA_PRICLR_FPRICLRn_Msk (0xfffful << PDMA_PRICLR_FPRICLRn_Pos) /*!< PDMA_T::PRICLR: FPRICLRn Mask */ + +#define PDMA_INTEN_INTENn_Pos (0) /*!< PDMA_T::INTEN: INTENn Position */ +#define PDMA_INTEN_INTENn_Msk (0xfffful << PDMA_INTEN_INTENn_Pos) /*!< PDMA_T::INTEN: INTENn Mask */ + +#define PDMA_INTSTS_ABTIF_Pos (0) /*!< PDMA_T::INTSTS: ABTIF Position */ +#define PDMA_INTSTS_ABTIF_Msk (0x1ul << PDMA_INTSTS_ABTIF_Pos) /*!< PDMA_T::INTSTS: ABTIF Mask */ + +#define PDMA_INTSTS_TDIF_Pos (1) /*!< PDMA_T::INTSTS: TDIF Position */ +#define PDMA_INTSTS_TDIF_Msk (0x1ul << PDMA_INTSTS_TDIF_Pos) /*!< PDMA_T::INTSTS: TDIF Mask */ + +#define PDMA_INTSTS_ALIGNF_Pos (2) /*!< PDMA_T::INTSTS: ALIGNF Position */ +#define PDMA_INTSTS_ALIGNF_Msk (0x1ul << PDMA_INTSTS_ALIGNF_Pos) /*!< PDMA_T::INTSTS: ALIGNF Mask */ + +#define PDMA_INTSTS_REQTOF0_Pos (8) /*!< PDMA_T::INTSTS: REQTOF0 Position */ +#define PDMA_INTSTS_REQTOF0_Msk (0x1ul << PDMA_INTSTS_REQTOF0_Pos) /*!< PDMA_T::INTSTS: REQTOF0 Mask */ + +#define PDMA_INTSTS_REQTOF1_Pos (9) /*!< PDMA_T::INTSTS: REQTOF1 Position */ +#define PDMA_INTSTS_REQTOF1_Msk (0x1ul << PDMA_INTSTS_REQTOF1_Pos) /*!< PDMA_T::INTSTS: REQTOF1 Mask */ + +#define PDMA_ABTSTS_ABTIF0_Pos (0) /*!< PDMA_T::ABTSTS: ABTIF0 Position */ +#define PDMA_ABTSTS_ABTIF0_Msk (0x1ul << PDMA_ABTSTS_ABTIF0_Pos) /*!< PDMA_T::ABTSTS: ABTIF0 Mask */ + +#define PDMA_ABTSTS_ABTIF1_Pos (1) /*!< PDMA_T::ABTSTS: ABTIF1 Position */ +#define PDMA_ABTSTS_ABTIF1_Msk (0x1ul << PDMA_ABTSTS_ABTIF1_Pos) /*!< PDMA_T::ABTSTS: ABTIF1 Mask */ + +#define PDMA_ABTSTS_ABTIF2_Pos (2) /*!< PDMA_T::ABTSTS: ABTIF2 Position */ +#define PDMA_ABTSTS_ABTIF2_Msk (0x1ul << PDMA_ABTSTS_ABTIF2_Pos) /*!< PDMA_T::ABTSTS: ABTIF2 Mask */ + +#define PDMA_ABTSTS_ABTIF3_Pos (3) /*!< PDMA_T::ABTSTS: ABTIF3 Position */ +#define PDMA_ABTSTS_ABTIF3_Msk (0x1ul << PDMA_ABTSTS_ABTIF3_Pos) /*!< PDMA_T::ABTSTS: ABTIF3 Mask */ + +#define PDMA_ABTSTS_ABTIF4_Pos (4) /*!< PDMA_T::ABTSTS: ABTIF4 Position */ +#define PDMA_ABTSTS_ABTIF4_Msk (0x1ul << PDMA_ABTSTS_ABTIF4_Pos) /*!< PDMA_T::ABTSTS: ABTIF4 Mask */ + +#define PDMA_ABTSTS_ABTIF5_Pos (5) /*!< PDMA_T::ABTSTS: ABTIF5 Position */ +#define PDMA_ABTSTS_ABTIF5_Msk (0x1ul << PDMA_ABTSTS_ABTIF5_Pos) /*!< PDMA_T::ABTSTS: ABTIF5 Mask */ + +#define PDMA_ABTSTS_ABTIF6_Pos (6) /*!< PDMA_T::ABTSTS: ABTIF6 Position */ +#define PDMA_ABTSTS_ABTIF6_Msk (0x1ul << PDMA_ABTSTS_ABTIF6_Pos) /*!< PDMA_T::ABTSTS: ABTIF6 Mask */ + +#define PDMA_ABTSTS_ABTIF7_Pos (7) /*!< PDMA_T::ABTSTS: ABTIF7 Position */ +#define PDMA_ABTSTS_ABTIF7_Msk (0x1ul << PDMA_ABTSTS_ABTIF7_Pos) /*!< PDMA_T::ABTSTS: ABTIF7 Mask */ + +#define PDMA_ABTSTS_ABTIF8_Pos (8) /*!< PDMA_T::ABTSTS: ABTIF8 Position */ +#define PDMA_ABTSTS_ABTIF8_Msk (0x1ul << PDMA_ABTSTS_ABTIF8_Pos) /*!< PDMA_T::ABTSTS: ABTIF8 Mask */ + +#define PDMA_ABTSTS_ABTIF9_Pos (9) /*!< PDMA_T::ABTSTS: ABTIF9 Position */ +#define PDMA_ABTSTS_ABTIF9_Msk (0x1ul << PDMA_ABTSTS_ABTIF9_Pos) /*!< PDMA_T::ABTSTS: ABTIF9 Mask */ + +#define PDMA_ABTSTS_ABTIF10_Pos (10) /*!< PDMA_T::ABTSTS: ABTIF10 Position */ +#define PDMA_ABTSTS_ABTIF10_Msk (0x1ul << PDMA_ABTSTS_ABTIF10_Pos) /*!< PDMA_T::ABTSTS: ABTIF10 Mask */ + +#define PDMA_ABTSTS_ABTIF11_Pos (11) /*!< PDMA_T::ABTSTS: ABTIF11 Position */ +#define PDMA_ABTSTS_ABTIF11_Msk (0x1ul << PDMA_ABTSTS_ABTIF11_Pos) /*!< PDMA_T::ABTSTS: ABTIF11 Mask */ + +#define PDMA_ABTSTS_ABTIF12_Pos (12) /*!< PDMA_T::ABTSTS: ABTIF12 Position */ +#define PDMA_ABTSTS_ABTIF12_Msk (0x1ul << PDMA_ABTSTS_ABTIF12_Pos) /*!< PDMA_T::ABTSTS: ABTIF12 Mask */ + +#define PDMA_ABTSTS_ABTIF13_Pos (13) /*!< PDMA_T::ABTSTS: ABTIF13 Position */ +#define PDMA_ABTSTS_ABTIF13_Msk (0x1ul << PDMA_ABTSTS_ABTIF13_Pos) /*!< PDMA_T::ABTSTS: ABTIF13 Mask */ + +#define PDMA_ABTSTS_ABTIF14_Pos (14) /*!< PDMA_T::ABTSTS: ABTIF14 Position */ +#define PDMA_ABTSTS_ABTIF14_Msk (0x1ul << PDMA_ABTSTS_ABTIF14_Pos) /*!< PDMA_T::ABTSTS: ABTIF14 Mask */ + +#define PDMA_ABTSTS_ABTIF15_Pos (15) /*!< PDMA_T::ABTSTS: ABTIF15 Position */ +#define PDMA_ABTSTS_ABTIF15_Msk (0x1ul << PDMA_ABTSTS_ABTIF15_Pos) /*!< PDMA_T::ABTSTS: ABTIF15 Mask */ + +#define PDMA_TDSTS_TDIF0_Pos (0) /*!< PDMA_T::TDSTS: TDIF0 Position */ +#define PDMA_TDSTS_TDIF0_Msk (0x1ul << PDMA_TDSTS_TDIF0_Pos) /*!< PDMA_T::TDSTS: TDIF0 Mask */ + +#define PDMA_TDSTS_TDIF1_Pos (1) /*!< PDMA_T::TDSTS: TDIF1 Position */ +#define PDMA_TDSTS_TDIF1_Msk (0x1ul << PDMA_TDSTS_TDIF1_Pos) /*!< PDMA_T::TDSTS: TDIF1 Mask */ + +#define PDMA_TDSTS_TDIF2_Pos (2) /*!< PDMA_T::TDSTS: TDIF2 Position */ +#define PDMA_TDSTS_TDIF2_Msk (0x1ul << PDMA_TDSTS_TDIF2_Pos) /*!< PDMA_T::TDSTS: TDIF2 Mask */ + +#define PDMA_TDSTS_TDIF3_Pos (3) /*!< PDMA_T::TDSTS: TDIF3 Position */ +#define PDMA_TDSTS_TDIF3_Msk (0x1ul << PDMA_TDSTS_TDIF3_Pos) /*!< PDMA_T::TDSTS: TDIF3 Mask */ + +#define PDMA_TDSTS_TDIF4_Pos (4) /*!< PDMA_T::TDSTS: TDIF4 Position */ +#define PDMA_TDSTS_TDIF4_Msk (0x1ul << PDMA_TDSTS_TDIF4_Pos) /*!< PDMA_T::TDSTS: TDIF4 Mask */ + +#define PDMA_TDSTS_TDIF5_Pos (5) /*!< PDMA_T::TDSTS: TDIF5 Position */ +#define PDMA_TDSTS_TDIF5_Msk (0x1ul << PDMA_TDSTS_TDIF5_Pos) /*!< PDMA_T::TDSTS: TDIF5 Mask */ + +#define PDMA_TDSTS_TDIF6_Pos (6) /*!< PDMA_T::TDSTS: TDIF6 Position */ +#define PDMA_TDSTS_TDIF6_Msk (0x1ul << PDMA_TDSTS_TDIF6_Pos) /*!< PDMA_T::TDSTS: TDIF6 Mask */ + +#define PDMA_TDSTS_TDIF7_Pos (7) /*!< PDMA_T::TDSTS: TDIF7 Position */ +#define PDMA_TDSTS_TDIF7_Msk (0x1ul << PDMA_TDSTS_TDIF7_Pos) /*!< PDMA_T::TDSTS: TDIF7 Mask */ + +#define PDMA_TDSTS_TDIF8_Pos (8) /*!< PDMA_T::TDSTS: TDIF8 Position */ +#define PDMA_TDSTS_TDIF8_Msk (0x1ul << PDMA_TDSTS_TDIF8_Pos) /*!< PDMA_T::TDSTS: TDIF8 Mask */ + +#define PDMA_TDSTS_TDIF9_Pos (9) /*!< PDMA_T::TDSTS: TDIF9 Position */ +#define PDMA_TDSTS_TDIF9_Msk (0x1ul << PDMA_TDSTS_TDIF9_Pos) /*!< PDMA_T::TDSTS: TDIF9 Mask */ + +#define PDMA_TDSTS_TDIF10_Pos (10) /*!< PDMA_T::TDSTS: TDIF10 Position */ +#define PDMA_TDSTS_TDIF10_Msk (0x1ul << PDMA_TDSTS_TDIF10_Pos) /*!< PDMA_T::TDSTS: TDIF10 Mask */ + +#define PDMA_TDSTS_TDIF11_Pos (11) /*!< PDMA_T::TDSTS: TDIF11 Position */ +#define PDMA_TDSTS_TDIF11_Msk (0x1ul << PDMA_TDSTS_TDIF11_Pos) /*!< PDMA_T::TDSTS: TDIF11 Mask */ + +#define PDMA_TDSTS_TDIF12_Pos (12) /*!< PDMA_T::TDSTS: TDIF12 Position */ +#define PDMA_TDSTS_TDIF12_Msk (0x1ul << PDMA_TDSTS_TDIF12_Pos) /*!< PDMA_T::TDSTS: TDIF12 Mask */ + +#define PDMA_TDSTS_TDIF13_Pos (13) /*!< PDMA_T::TDSTS: TDIF13 Position */ +#define PDMA_TDSTS_TDIF13_Msk (0x1ul << PDMA_TDSTS_TDIF13_Pos) /*!< PDMA_T::TDSTS: TDIF13 Mask */ + +#define PDMA_TDSTS_TDIF14_Pos (14) /*!< PDMA_T::TDSTS: TDIF14 Position */ +#define PDMA_TDSTS_TDIF14_Msk (0x1ul << PDMA_TDSTS_TDIF14_Pos) /*!< PDMA_T::TDSTS: TDIF14 Mask */ + +#define PDMA_TDSTS_TDIF15_Pos (15) /*!< PDMA_T::TDSTS: TDIF15 Position */ +#define PDMA_TDSTS_TDIF15_Msk (0x1ul << PDMA_TDSTS_TDIF15_Pos) /*!< PDMA_T::TDSTS: TDIF15 Mask */ + +#define PDMA_ALIGN_ALIGNn_Pos (0) /*!< PDMA_T::ALIGN: ALIGNn Position */ +#define PDMA_ALIGN_ALIGNn_Msk (0xfffful << PDMA_ALIGN_ALIGNn_Pos) /*!< PDMA_T::ALIGN: ALIGNn Mask */ + +#define PDMA_TACTSTS_TXACTFn_Pos (0) /*!< PDMA_T::TACTSTS: TXACTFn Position */ +#define PDMA_TACTSTS_TXACTFn_Msk (0xfffful << PDMA_TACTSTS_TXACTFn_Pos) /*!< PDMA_T::TACTSTS: TXACTFn Mask */ + +#define PDMA_TOUTPSC_TOUTPSC0_Pos (0) /*!< PDMA_T::TOUTPSC: TOUTPSC0 Position */ +#define PDMA_TOUTPSC_TOUTPSC0_Msk (0x7ul << PDMA_TOUTPSC_TOUTPSC0_Pos) /*!< PDMA_T::TOUTPSC: TOUTPSC0 Mask */ + +#define PDMA_TOUTPSC_TOUTPSC1_Pos (4) /*!< PDMA_T::TOUTPSC: TOUTPSC1 Position */ +#define PDMA_TOUTPSC_TOUTPSC1_Msk (0x7ul << PDMA_TOUTPSC_TOUTPSC1_Pos) /*!< PDMA_T::TOUTPSC: TOUTPSC1 Mask */ + +#define PDMA_TOUTEN_TOUTENn_Pos (0) /*!< PDMA_T::TOUTEN: TOUTENn Position */ +#define PDMA_TOUTEN_TOUTENn_Msk (0x3ul << PDMA_TOUTEN_TOUTENn_Pos) /*!< PDMA_T::TOUTEN: TOUTENn Mask */ + +#define PDMA_TOUTIEN_TOUTIENn_Pos (0) /*!< PDMA_T::TOUTIEN: TOUTIENn Position */ +#define PDMA_TOUTIEN_TOUTIENn_Msk (0x3ul << PDMA_TOUTIEN_TOUTIENn_Pos) /*!< PDMA_T::TOUTIEN: TOUTIENn Mask */ + +#define PDMA_SCATBA_SCATBA_Pos (16) /*!< PDMA_T::SCATBA: SCATBA Position */ +#define PDMA_SCATBA_SCATBA_Msk (0xfffful << PDMA_SCATBA_SCATBA_Pos) /*!< PDMA_T::SCATBA: SCATBA Mask */ + +#define PDMA_TOC0_1_TOC0_Pos (0) /*!< PDMA_T::TOC0_1: TOC0 Position */ +#define PDMA_TOC0_1_TOC0_Msk (0xfffful << PDMA_TOC0_1_TOC0_Pos) /*!< PDMA_T::TOC0_1: TOC0 Mask */ + +#define PDMA_TOC0_1_TOC1_Pos (16) /*!< PDMA_T::TOC0_1: TOC1 Position */ +#define PDMA_TOC0_1_TOC1_Msk (0xfffful << PDMA_TOC0_1_TOC1_Pos) /*!< PDMA_T::TOC0_1: TOC1 Mask */ + +#define PDMA_CHRST_CHnRST_Pos (0) /*!< PDMA_T::CHRST: CHnRST Position */ +#define PDMA_CHRST_CHnRST_Msk (0xfffful << PDMA_CHRST_CHnRST_Pos) /*!< PDMA_T::CHRST: CHnRST Mask */ + +#define PDMA_REQSEL0_3_REQSRC0_Pos (0) /*!< PDMA_T::REQSEL0_3: REQSRC0 Position */ +#define PDMA_REQSEL0_3_REQSRC0_Msk (0x7ful << PDMA_REQSEL0_3_REQSRC0_Pos) /*!< PDMA_T::REQSEL0_3: REQSRC0 Mask */ + +#define PDMA_REQSEL0_3_REQSRC1_Pos (8) /*!< PDMA_T::REQSEL0_3: REQSRC1 Position */ +#define PDMA_REQSEL0_3_REQSRC1_Msk (0x7ful << PDMA_REQSEL0_3_REQSRC1_Pos) /*!< PDMA_T::REQSEL0_3: REQSRC1 Mask */ + +#define PDMA_REQSEL0_3_REQSRC2_Pos (16) /*!< PDMA_T::REQSEL0_3: REQSRC2 Position */ +#define PDMA_REQSEL0_3_REQSRC2_Msk (0x7ful << PDMA_REQSEL0_3_REQSRC2_Pos) /*!< PDMA_T::REQSEL0_3: REQSRC2 Mask */ + +#define PDMA_REQSEL0_3_REQSRC3_Pos (24) /*!< PDMA_T::REQSEL0_3: REQSRC3 Position */ +#define PDMA_REQSEL0_3_REQSRC3_Msk (0x7ful << PDMA_REQSEL0_3_REQSRC3_Pos) /*!< PDMA_T::REQSEL0_3: REQSRC3 Mask */ + +#define PDMA_REQSEL4_7_REQSRC4_Pos (0) /*!< PDMA_T::REQSEL4_7: REQSRC4 Position */ +#define PDMA_REQSEL4_7_REQSRC4_Msk (0x7ful << PDMA_REQSEL4_7_REQSRC4_Pos) /*!< PDMA_T::REQSEL4_7: REQSRC4 Mask */ + +#define PDMA_REQSEL4_7_REQSRC5_Pos (8) /*!< PDMA_T::REQSEL4_7: REQSRC5 Position */ +#define PDMA_REQSEL4_7_REQSRC5_Msk (0x7ful << PDMA_REQSEL4_7_REQSRC5_Pos) /*!< PDMA_T::REQSEL4_7: REQSRC5 Mask */ + +#define PDMA_REQSEL4_7_REQSRC6_Pos (16) /*!< PDMA_T::REQSEL4_7: REQSRC6 Position */ +#define PDMA_REQSEL4_7_REQSRC6_Msk (0x7ful << PDMA_REQSEL4_7_REQSRC6_Pos) /*!< PDMA_T::REQSEL4_7: REQSRC6 Mask */ + +#define PDMA_REQSEL4_7_REQSRC7_Pos (24) /*!< PDMA_T::REQSEL4_7: REQSRC7 Position */ +#define PDMA_REQSEL4_7_REQSRC7_Msk (0x7ful << PDMA_REQSEL4_7_REQSRC7_Pos) /*!< PDMA_T::REQSEL4_7: REQSRC7 Mask */ + +#define PDMA_REQSEL8_11_REQSRC8_Pos (0) /*!< PDMA_T::REQSEL8_11: REQSRC8 Position */ +#define PDMA_REQSEL8_11_REQSRC8_Msk (0x7ful << PDMA_REQSEL8_11_REQSRC8_Pos) /*!< PDMA_T::REQSEL8_11: REQSRC8 Mask */ + +#define PDMA_REQSEL8_11_REQSRC9_Pos (8) /*!< PDMA_T::REQSEL8_11: REQSRC9 Position */ +#define PDMA_REQSEL8_11_REQSRC9_Msk (0x7ful << PDMA_REQSEL8_11_REQSRC9_Pos) /*!< PDMA_T::REQSEL8_11: REQSRC9 Mask */ + +#define PDMA_REQSEL8_11_REQSRC10_Pos (16) /*!< PDMA_T::REQSEL8_11: REQSRC10 Position */ +#define PDMA_REQSEL8_11_REQSRC10_Msk (0x7ful << PDMA_REQSEL8_11_REQSRC10_Pos) /*!< PDMA_T::REQSEL8_11: REQSRC10 Mask */ + +#define PDMA_REQSEL8_11_REQSRC11_Pos (24) /*!< PDMA_T::REQSEL8_11: REQSRC11 Position */ +#define PDMA_REQSEL8_11_REQSRC11_Msk (0x7ful << PDMA_REQSEL8_11_REQSRC11_Pos) /*!< PDMA_T::REQSEL8_11: REQSRC11 Mask */ + +#define PDMA_REQSEL12_15_REQSRC12_Pos (0) /*!< PDMA_T::REQSEL12_15: REQSRC12 Position */ +#define PDMA_REQSEL12_15_REQSRC12_Msk (0x7ful << PDMA_REQSEL12_15_REQSRC12_Pos) /*!< PDMA_T::REQSEL12_15: REQSRC12 Mask */ + +#define PDMA_REQSEL12_15_REQSRC13_Pos (8) /*!< PDMA_T::REQSEL12_15: REQSRC13 Position */ +#define PDMA_REQSEL12_15_REQSRC13_Msk (0x7ful << PDMA_REQSEL12_15_REQSRC13_Pos) /*!< PDMA_T::REQSEL12_15: REQSRC13 Mask */ + +#define PDMA_REQSEL12_15_REQSRC14_Pos (16) /*!< PDMA_T::REQSEL12_15: REQSRC14 Position */ +#define PDMA_REQSEL12_15_REQSRC14_Msk (0x7ful << PDMA_REQSEL12_15_REQSRC14_Pos) /*!< PDMA_T::REQSEL12_15: REQSRC14 Mask */ + +#define PDMA_REQSEL12_15_REQSRC15_Pos (24) /*!< PDMA_T::REQSEL12_15: REQSRC15 Position */ +#define PDMA_REQSEL12_15_REQSRC15_Msk (0x7ful << PDMA_REQSEL12_15_REQSRC15_Pos) /*!< PDMA_T::REQSEL12_15: REQSRC15 Mask */ + +#define PDMA_STCRn_STC_Pos (0) /*!< PDMA_T::STCRn: STC Position */ +#define PDMA_STCRn_STC_Msk (0xfffful << PDMA_STCRn_STC_Pos) /*!< PDMA_T::STCRn: STC Mask */ + +#define PDMA_ASOCRn_SASOL_Pos (0) /*!< PDMA_T::ASOCRn: SASOL Position */ +#define PDMA_ASOCRn_SASOL_Msk (0xfffful << PDMA_ASOCRn_SASOL_Pos) /*!< PDMA_T::ASOCRn: SASOL Mask */ + +#define PDMA_ASOCRn_DASOL_Pos (16) /*!< PDMA_T::ASOCRn: DASOL Position */ +#define PDMA_ASOCRn_DASOL_Msk (0xfffful << PDMA_ASOCRn_DASOL_Pos) /*!< PDMA_T::ASOCRn: DASOL Mask */ + +#define PDMA_RCNTn_RCNT_Pos (0) /*!< PDMA_T::RCNTn: RCNT Position */ +#define PDMA_RCNTn_RCNT_Msk (0xfffful << PDMA_STCRn_RCNT_Pos) /*!< PDMA_T::RCNTn: RCNT Mask */ + +#define PDMA_AICTLn_SAICNT_Pos (0) /*!< PDMA_T::AICTLn: SAICNT Position */ +#define PDMA_AICTLn_SAICNT_Msk (0xfffful << PDMA_ASOCRn_SASOL_Pos) /*!< PDMA_T::AICTLn: SAICNT Mask */ + +#define PDMA_AICTLn_DAICNT_Pos (16) /*!< PDMA_T::AICTLn: DAICNT Position */ +#define PDMA_AICTLn_DAICNT_Msk (0xfffful << PDMA_ASOCRn_DASOL_Pos) /*!< PDMA_T::AICTLn: DAICNT Mask */ + +/**@}*/ /* PDMA_CONST */ +/**@}*/ /* end of PDMA register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __PDMA_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/qei_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/qei_reg.h new file mode 100644 index 00000000000..19de07545e2 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/qei_reg.h @@ -0,0 +1,315 @@ +/**************************************************************************//** + * @file qei_reg.h + * @version V1.00 + * @brief QEI register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __QEI_REG_H__ +#define __QEI_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup QEI Quadrature Encoder Interface(QEI) + Memory Mapped Structure for QEI Controller +@{ */ + +typedef struct +{ + + + /** + * @var QEI_T::CNT + * Offset: 0x00 QEI Counter Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |CNT |Quadrature Encoder Interface Counter + * | | |A 32-bit up/down counter + * | | |When an effective phase pulse is detected, this counter is increased by one if the bit DIRF (QEI_STATUS[8]) is one or decreased by one if the bit DIRF(QEI_STATUS[8]) is zero + * | | |This register performs an integrator which count value is proportional to the encoder position + * | | |The pulse counter may be initialized to a predetermined value by one of three events occurs: + * | | |1. Software is written if QEIEN (QEI_CTL[29]) = 0. + * | | |2. Compare-match event if QEIEN(QEI_CTL[29])=1 and QEI is in compare-counting mode. + * | | |3. Index signal change if QEIEN(QEI_CTL[29])=1 and IDXRLDEN (QEI_CTL[27])=1. + * @var QEI_T::CNTHOLD + * Offset: 0x04 QEI Counter Hold Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |CNTHOLD |Quadrature Encoder Interface Counter Hold + * | | |When bit HOLDCNT (QEI_CTL[24]) goes from low to high, the CNT(QEI_CNT[31:0]) is copied into CNTHOLD (QEI_CNTHOLD[31:0]) register. + * @var QEI_T::CNTLATCH + * Offset: 0x08 QEI Counter Index Latch Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |CNTLATCH |Quadrature Encoder Interface Counter Index Latch + * | | |When the IDXF (QEI_STATUS[0]) bit is set, the CNT(QEI_CNT[31:0]) is copied into CNTLATCH (QEI_CNTLATCH[31:0]) register. + * @var QEI_T::CNTCMP + * Offset: 0x0C QEI Counter Compare Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |CNTCMP |Quadrature Encoder Interface Counter Compare + * | | |If the QEI controller is in the compare-counting mode CMPEN (QEI_CTL[28]) =1, when the value of CNT(QEI_CNT[31:0]) matches CNTCMP(QEI_CNTCMP[31:0]), CMPF will be set + * | | |This register is software writable. + * @var QEI_T::CNTMAX + * Offset: 0x14 QEI Pre-set Maximum Count Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |CNTMAX |Quadrature Encoder Interface Preset Maximum Count + * | | |This register value determined by user stores the maximum value which may be the number of the QEI counter for the QEI controller compare-counting mode + * @var QEI_T::CTL + * Offset: 0x18 QEI Controller Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2:0] |NFCLKSEL |Noise Filter Clock Pre-divide Selection + * | | |To determine the sampling frequency of the Noise Filter clock . + * | | |000 = QEI_CLK. + * | | |001 = QEI_CLK/2. + * | | |010 = QEI_CLK/4. + * | | |011 = QEI_CLK/16. + * | | |100 = QEI_CLK/32. + * | | |101 = QEI_CLK/64. + * |[3] |NFDIS |QEI Controller Input Noise Filter Disable Bit + * | | |0 = The noise filter of QEI controller Enabled. + * | | |1 = The noise filter of QEI controller Disabled. + * |[4] |CHAEN |QEA Input to QEI Controller Enable Bit + * | | |0 = QEA input to QEI Controller Disabled. + * | | |1 = QEA input to QEI Controller Enabled. + * |[5] |CHBEN |QEB Input to QEI Controller Enable Bit + * | | |0 = QEB input to QEI Controller Disabled. + * | | |1 = QEB input to QEI Controller Enabled. + * |[6] |IDXEN |IDX Input to QEI Controller Enable Bit + * | | |0 = IDX input to QEI Controller Disabled. + * | | |1 = IDX input to QEI Controller Enabled. + * |[9:8] |MODE |QEI Counting Mode Selection + * | | |There are four quadrature encoder pulse counter operation modes. + * | | |00 = X4 Free-counting Mode. + * | | |01 = X2 Free-counting Mode. + * | | |10 = X4 Compare-counting Mode. + * | | |11 = X2 Compare-counting Mode. + * |[12] |CHAINV |Inverse QEA Input Polarity + * | | |0 = Not inverse QEA input polarity. + * | | |1 = QEA input polarity is inversed to QEI controller. + * |[13] |CHBINV |Inverse QEB Input Polarity + * | | |0 = Not inverse QEB input polarity. + * | | |1 = QEB input polarity is inversed to QEI controller. + * |[14] |IDXINV |Inverse IDX Input Polarity + * | | |0 = Not inverse IDX input polarity. + * | | |1 = IDX input polarity is inversed to QEI controller. + * |[16] |OVUNIEN |OVUNF Trigger QEI Interrupt Enable Bit + * | | |0 = OVUNF can trigger QEI controller interrupt Disabled. + * | | |1 = OVUNF can trigger QEI controller interrupt Enabled. + * |[17] |DIRIEN |DIRCHGF Trigger QEI Interrupt Enable Bit + * | | |0 = DIRCHGF can trigger QEI controller interrupt Disabled. + * | | |1 = DIRCHGF can trigger QEI controller interrupt Enabled. + * |[18] |CMPIEN |CMPF Trigger QEI Interrupt Enable Bit + * | | |0 = CMPF can trigger QEI controller interrupt Disabled. + * | | |1 = CMPF can trigger QEI controller interrupt Enabled. + * |[19] |IDXIEN |IDXF Trigger QEI Interrupt Enable Bit + * | | |0 = The IDXF can trigger QEI interrupt Disabled. + * | | |1 = The IDXF can trigger QEI interrupt Enabled. + * |[20] |HOLDTMR0 |Hold QEI_CNT by Timer 0 + * | | |0 = TIF (TIMER0_INTSTS[0]) has no effect on HOLDCNT. + * | | |1 = A rising edge of bit TIF(TIMER0_INTSTS[0]) in timer 0 sets HOLDCNT to 1. + * |[21] |HOLDTMR1 |Hold QEI_CNT by Timer 1 + * | | |0 = TIF(TIMER1_INTSTS[0]) has no effect on HOLDCNT. + * | | |1 = A rising edge of bit TIF (TIMER1_INTSTS[0]) in timer 1 sets HOLDCNT to 1. + * |[22] |HOLDTMR2 |Hold QEI_CNT by Timer 2 + * | | |0 = TIF(TIMER2_INTSTS[0]) has no effect on HOLDCNT. + * | | |1 = A rising edge of bit TIF(TIMER2_INTSTS[0]) in timer 2 sets HOLDCNT to 1. + * |[23] |HOLDTMR3 |Hold QEI_CNT by Timer 3 + * | | |0 = TIF (TIMER3_INTSTS[0]) has no effect on HOLDCNT. + * | | |1 = A rising edge of bit TIF(TIMER3_INTSTS[0]) in timer 3 sets HOLDCNT to 1. + * |[24] |HOLDCNT |Hold QEI_CNT Control + * | | |When this bit is set from low to high, the CNT(QEI_CNT[31:0]) is copied into CNTHOLD(QEI_CNTHOLD[31:0]) + * | | |This bit may be set by writing 1 to it or Timer0~Timer3 interrupt flag TIF (TIMERx_INTSTS[0]). + * | | |0 = No operation. + * | | |1 = QEI_CNT content is captured and stored in CNTHOLD(QEI_CNTHOLD[31:0]). + * | | |Note: This bit is automatically cleared after QEI_CNTHOLD holds QEI_CNT value. + * |[25] |IDXLATEN |Index Latch QEI_CNT Enable Bit + * | | |If this bit is set to high, the CNT(QEI_CNT[31:0]) content will be latched into CNTLATCH (QEI_CNTLATCH[31:0]) at every rising on signal CHX. + * | | |0 = The index signal latch QEI counter function Disabled. + * | | |1 = The index signal latch QEI counter function Enabled. + * |[27] |IDXRLDEN |Index Trigger QEI_CNT Reload Enable Bit + * | | |When this bit is high and a rising edge comes on signal CHX, the CNT(QEI_CNT[31:0]) will be reset to zero if the counter is in up-counting type (DIRF(QEI_STATUS[8]) = 1); while the CNT(QEI_CNT[31:0]) will be reloaded with CNTMAX (QEI_CNTMAX[31:0]) content if the counter is in down-counting type (DIRF(QEI_STATUS[8]) = 0). + * | | |0 = Reload function Disabled. + * | | |1 = QEI_CNT re-initialized by Index signal Enabled. + * |[28] |CMPEN |The Compare Function Enable Bit + * | | |The compare function in QEI controller is to compare the dynamic counting QEI_CNT with the compare register CNTCMP( QEI_CNTCMP[31:0]), if CNT(QEI_CNT[31:0]) reaches CNTCMP( QEI_CNTCMP[31:0]), the flag CMPF will be set. + * | | |0 = Compare function Disabled. + * | | |1 = Compare function Enabled. + * |[29] |QEIEN |Quadrature Encoder Interface Controller Enable Bit + * | | |0 = QEI controller function Disabled. + * | | |1 = QEI controller function Enabled. + * @var QEI_T::STATUS + * Offset: 0x2C QEI Controller Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |IDXF |IDX Detected Flag + * | | |When the QEI controller detects a rising edge on signal CHX it will set flag IDXF to high. + * | | |0 = No rising edge detected on signal CHX. + * | | |1 = A rising edge occurs on signal CHX. + * | | |Note: This bit is only cleared by writing 1 to it. + * |[1] |CMPF |Compare-match Flag + * | | |If the QEI compare function is enabled, the flag is set by hardware while QEI counter up or down counts and reach to the CNTCMP(QEI_CNTCMP[31:0]). + * | | |0 = QEI counter does not match with CNTCMP(QEI_CNTCMP[31:0]). + * | | |1 = QEI counter counts to the same as CNTCMP(QEI_CNTCMP[31:0]). + * | | |Note: This bit is only cleared by writing 1 to it. + * |[2] |OVUNF |QEI Counter Overflow or Underflow Flag + * | | |Flag is set by hardware while CNT(QEI_CNT[31:0]) overflows from 0xFFFF_FFFF to zero in free-counting mode or from the CNTMAX (QEI_CNTMAX[31:0]) to zero in compare-counting mode + * | | |Similarly, the flag is set while QEI counter underflows from zero to 0xFFFF_FFFF or CNTMAX (QEI_CNTMAX[31:0]). + * | | |0 = No overflow or underflow occurs in QEI counter. + * | | |1 = QEI counter occurs counting overflow or underflow. + * | | |Note: This bit is only cleared by writing 1 to it. + * |[3] |DIRCHGF |Direction Change Flag + * | | |Flag is set by hardware while QEI counter counting direction is changed. + * | | |Software can clear this bit by writing 1 to it. + * | | |0 = No change in QEI counter counting direction. + * | | |1 = QEI counter counting direction is changed. + * | | |Note: This bit is only cleared by writing 1 to it. + * |[8] |DIRF |QEI Counter Counting Direction Indication + * | | |0 = QEI Counter is in down-counting. + * | | |1 = QEI Counter is in up-counting. + * | | |Note: This bit is set/reset by hardware according to the phase detection between CHA and CHB. + */ + __IO uint32_t CNT; /*!< [0x0000] QEI Counter Register */ + __IO uint32_t CNTHOLD; /*!< [0x0004] QEI Counter Hold Register */ + __IO uint32_t CNTLATCH; /*!< [0x0008] QEI Counter Index Latch Register */ + __IO uint32_t CNTCMP; /*!< [0x000c] QEI Counter Compare Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t CNTMAX; /*!< [0x0014] QEI Pre-set Maximum Count Register */ + __IO uint32_t CTL; /*!< [0x0018] QEI Controller Control Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE1[4]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t STATUS; /*!< [0x002c] QEI Controller Status Register */ + +} QEI_T; + +/** + @addtogroup QEI_CONST QEI Bit Field Definition + Constant Definitions for QEI Controller +@{ */ + +#define QEI_CNT_CNT_Pos (0) /*!< QEI_T::CNT: CNT Position */ +#define QEI_CNT_CNT_Msk (0xfffffffful << QEI_CNT_CNT_Pos) /*!< QEI_T::CNT: CNT Mask */ + +#define QEI_CNTHOLD_CNTHOLD_Pos (0) /*!< QEI_T::CNTHOLD: CNTHOLD Position */ +#define QEI_CNTHOLD_CNTHOLD_Msk (0xfffffffful << QEI_CNTHOLD_CNTHOLD_Pos) /*!< QEI_T::CNTHOLD: CNTHOLD Mask */ + +#define QEI_CNTLATCH_CNTLATCH_Pos (0) /*!< QEI_T::CNTLATCH: CNTLATCH Position */ +#define QEI_CNTLATCH_CNTLATCH_Msk (0xfffffffful << QEI_CNTLATCH_CNTLATCH_Pos) /*!< QEI_T::CNTLATCH: CNTLATCH Mask */ + +#define QEI_CNTCMP_CNTCMP_Pos (0) /*!< QEI_T::CNTCMP: CNTCMP Position */ +#define QEI_CNTCMP_CNTCMP_Msk (0xfffffffful << QEI_CNTCMP_CNTCMP_Pos) /*!< QEI_T::CNTCMP: CNTCMP Mask */ + +#define QEI_CNTMAX_CNTMAX_Pos (0) /*!< QEI_T::CNTMAX: CNTMAX Position */ +#define QEI_CNTMAX_CNTMAX_Msk (0xfffffffful << QEI_CNTMAX_CNTMAX_Pos) /*!< QEI_T::CNTMAX: CNTMAX Mask */ + +#define QEI_CTL_NFCLKSEL_Pos (0) /*!< QEI_T::CTL: NFCLKSEL Position */ +#define QEI_CTL_NFCLKSEL_Msk (0x7ul << QEI_CTL_NFCLKSEL_Pos) /*!< QEI_T::CTL: NFCLKSEL Mask */ + +#define QEI_CTL_NFDIS_Pos (3) /*!< QEI_T::CTL: NFDIS Position */ +#define QEI_CTL_NFDIS_Msk (0x1ul << QEI_CTL_NFDIS_Pos) /*!< QEI_T::CTL: NFDIS Mask */ + +#define QEI_CTL_CHAEN_Pos (4) /*!< QEI_T::CTL: CHAEN Position */ +#define QEI_CTL_CHAEN_Msk (0x1ul << QEI_CTL_CHAEN_Pos) /*!< QEI_T::CTL: CHAEN Mask */ + +#define QEI_CTL_CHBEN_Pos (5) /*!< QEI_T::CTL: CHBEN Position */ +#define QEI_CTL_CHBEN_Msk (0x1ul << QEI_CTL_CHBEN_Pos) /*!< QEI_T::CTL: CHBEN Mask */ + +#define QEI_CTL_IDXEN_Pos (6) /*!< QEI_T::CTL: IDXEN Position */ +#define QEI_CTL_IDXEN_Msk (0x1ul << QEI_CTL_IDXEN_Pos) /*!< QEI_T::CTL: IDXEN Mask */ + +#define QEI_CTL_MODE_Pos (8) /*!< QEI_T::CTL: MODE Position */ +#define QEI_CTL_MODE_Msk (0x3ul << QEI_CTL_MODE_Pos) /*!< QEI_T::CTL: MODE Mask */ + +#define QEI_CTL_CHAINV_Pos (12) /*!< QEI_T::CTL: CHAINV Position */ +#define QEI_CTL_CHAINV_Msk (0x1ul << QEI_CTL_CHAINV_Pos) /*!< QEI_T::CTL: CHAINV Mask */ + +#define QEI_CTL_CHBINV_Pos (13) /*!< QEI_T::CTL: CHBINV Position */ +#define QEI_CTL_CHBINV_Msk (0x1ul << QEI_CTL_CHBINV_Pos) /*!< QEI_T::CTL: CHBINV Mask */ + +#define QEI_CTL_IDXINV_Pos (14) /*!< QEI_T::CTL: IDXINV Position */ +#define QEI_CTL_IDXINV_Msk (0x1ul << QEI_CTL_IDXINV_Pos) /*!< QEI_T::CTL: IDXINV Mask */ + +#define QEI_CTL_OVUNIEN_Pos (16) /*!< QEI_T::CTL: OVUNIEN Position */ +#define QEI_CTL_OVUNIEN_Msk (0x1ul << QEI_CTL_OVUNIEN_Pos) /*!< QEI_T::CTL: OVUNIEN Mask */ + +#define QEI_CTL_DIRIEN_Pos (17) /*!< QEI_T::CTL: DIRIEN Position */ +#define QEI_CTL_DIRIEN_Msk (0x1ul << QEI_CTL_DIRIEN_Pos) /*!< QEI_T::CTL: DIRIEN Mask */ + +#define QEI_CTL_CMPIEN_Pos (18) /*!< QEI_T::CTL: CMPIEN Position */ +#define QEI_CTL_CMPIEN_Msk (0x1ul << QEI_CTL_CMPIEN_Pos) /*!< QEI_T::CTL: CMPIEN Mask */ + +#define QEI_CTL_IDXIEN_Pos (19) /*!< QEI_T::CTL: IDXIEN Position */ +#define QEI_CTL_IDXIEN_Msk (0x1ul << QEI_CTL_IDXIEN_Pos) /*!< QEI_T::CTL: IDXIEN Mask */ + +#define QEI_CTL_HOLDTMR0_Pos (20) /*!< QEI_T::CTL: HOLDTMR0 Position */ +#define QEI_CTL_HOLDTMR0_Msk (0x1ul << QEI_CTL_HOLDTMR0_Pos) /*!< QEI_T::CTL: HOLDTMR0 Mask */ + +#define QEI_CTL_HOLDTMR1_Pos (21) /*!< QEI_T::CTL: HOLDTMR1 Position */ +#define QEI_CTL_HOLDTMR1_Msk (0x1ul << QEI_CTL_HOLDTMR1_Pos) /*!< QEI_T::CTL: HOLDTMR1 Mask */ + +#define QEI_CTL_HOLDTMR2_Pos (22) /*!< QEI_T::CTL: HOLDTMR2 Position */ +#define QEI_CTL_HOLDTMR2_Msk (0x1ul << QEI_CTL_HOLDTMR2_Pos) /*!< QEI_T::CTL: HOLDTMR2 Mask */ + +#define QEI_CTL_HOLDTMR3_Pos (23) /*!< QEI_T::CTL: HOLDTMR3 Position */ +#define QEI_CTL_HOLDTMR3_Msk (0x1ul << QEI_CTL_HOLDTMR3_Pos) /*!< QEI_T::CTL: HOLDTMR3 Mask */ + +#define QEI_CTL_HOLDCNT_Pos (24) /*!< QEI_T::CTL: HOLDCNT Position */ +#define QEI_CTL_HOLDCNT_Msk (0x1ul << QEI_CTL_HOLDCNT_Pos) /*!< QEI_T::CTL: HOLDCNT Mask */ + +#define QEI_CTL_IDXLATEN_Pos (25) /*!< QEI_T::CTL: IDXLATEN Position */ +#define QEI_CTL_IDXLATEN_Msk (0x1ul << QEI_CTL_IDXLATEN_Pos) /*!< QEI_T::CTL: IDXLATEN Mask */ + +#define QEI_CTL_IDXRLDEN_Pos (27) /*!< QEI_T::CTL: IDXRLDEN Position */ +#define QEI_CTL_IDXRLDEN_Msk (0x1ul << QEI_CTL_IDXRLDEN_Pos) /*!< QEI_T::CTL: IDXRLDEN Mask */ + +#define QEI_CTL_CMPEN_Pos (28) /*!< QEI_T::CTL: CMPEN Position */ +#define QEI_CTL_CMPEN_Msk (0x1ul << QEI_CTL_CMPEN_Pos) /*!< QEI_T::CTL: CMPEN Mask */ + +#define QEI_CTL_QEIEN_Pos (29) /*!< QEI_T::CTL: QEIEN Position */ +#define QEI_CTL_QEIEN_Msk (0x1ul << QEI_CTL_QEIEN_Pos) /*!< QEI_T::CTL: QEIEN Mask */ + +#define QEI_STATUS_IDXF_Pos (0) /*!< QEI_T::STATUS: IDXF Position */ +#define QEI_STATUS_IDXF_Msk (0x1ul << QEI_STATUS_IDXF_Pos) /*!< QEI_T::STATUS: IDXF Mask */ + +#define QEI_STATUS_CMPF_Pos (1) /*!< QEI_T::STATUS: CMPF Position */ +#define QEI_STATUS_CMPF_Msk (0x1ul << QEI_STATUS_CMPF_Pos) /*!< QEI_T::STATUS: CMPF Mask */ + +#define QEI_STATUS_OVUNF_Pos (2) /*!< QEI_T::STATUS: OVUNF Position */ +#define QEI_STATUS_OVUNF_Msk (0x1ul << QEI_STATUS_OVUNF_Pos) /*!< QEI_T::STATUS: OVUNF Mask */ + +#define QEI_STATUS_DIRCHGF_Pos (3) /*!< QEI_T::STATUS: DIRCHGF Position */ +#define QEI_STATUS_DIRCHGF_Msk (0x1ul << QEI_STATUS_DIRCHGF_Pos) /*!< QEI_T::STATUS: DIRCHGF Mask */ + +#define QEI_STATUS_DIRF_Pos (8) /*!< QEI_T::STATUS: DIRF Position */ +#define QEI_STATUS_DIRF_Msk (0x1ul << QEI_STATUS_DIRF_Pos) /*!< QEI_T::STATUS: DIRF Mask */ + +/**@}*/ /* QEI_CONST */ +/**@}*/ /* end of QEI register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __QEI_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/qspi_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/qspi_reg.h new file mode 100644 index 00000000000..890fe5c78de --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/qspi_reg.h @@ -0,0 +1,592 @@ +/**************************************************************************//** + * @file qspi_reg.h + * @version V1.00 + * @brief QSPI register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __QSPI_REG_H__ +#define __QSPI_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup QSPI Serial Peripheral Interface Controller(QSPI) + Memory Mapped Structure for QSPI Controller +@{ */ + +typedef struct +{ + + + /** + * @var QSPI_T::CTL + * Offset: 0x00 QSPI Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |QSPIEN |QSPI Transfer Control Enable Bit + * | | |In Master mode, the transfer will start when there is data in the FIFO buffer after this bit is set to 1 + * | | |In Slave mode, this device is ready to receive data when this bit is set to 1. + * | | |0 = Transfer control Disabled. + * | | |1 = Transfer control Enabled. + * | | |Note: Before changing the configurations of QSPIx_CTL, QSPIx_CLKDIV, QSPIx_SSCTL and QSPIx_FIFOCTL registers, user shall clear the QSPIEN (QSPIx_CTL[0]) and confirm the QSPIENSTS (QSPIx_STATUS[15]) is 0. + * |[1] |RXNEG |Receive on Negative Edge + * | | |0 = Received data input signal is latched on the rising edge of QSPI bus clock. + * | | |1 = Received data input signal is latched on the falling edge of QSPI bus clock. + * |[2] |TXNEG |Transmit on Negative Edge + * | | |0 = Transmitted data output signal is changed on the rising edge of QSPI bus clock. + * | | |1 = Transmitted data output signal is changed on the falling edge of QSPI bus clock. + * |[3] |CLKPOL |Clock Polarity + * | | |0 = QSPI bus clock is idle low. + * | | |1 = QSPI bus clock is idle high. + * |[7:4] |SUSPITV |Suspend Interval (Master Only) + * | | |The four bits provide configurable suspend interval between two successive transmit/receive transaction in a transfer + * | | |The definition of the suspend interval is the interval between the last clock edge of the preceding transaction word and the first clock edge of the following transaction word + * | | |The default value is 0x3 + * | | |The period of the suspend interval is obtained according to the following equation. + * | | |(SUSPITV[3:0] + 0.5) * period of QSPICLK clock cycle + * | | |Example: + * | | |SUSPITV = 0x0 .... 0.5 QSPICLK clock cycle. + * | | |SUSPITV = 0x1 .... 1.5 QSPICLK clock cycle. + * | | |..... + * | | |SUSPITV = 0xE .... 14.5 QSPICLK clock cycle. + * | | |SUSPITV = 0xF .... 15.5 QSPICLK clock cycle. + * |[12:8] |DWIDTH |Data Width + * | | |This field specifies how many bits can be transmitted / received in one transaction + * | | |The minimum bit length is 8 bits and can up to 32 bits. + * | | |DWIDTH = 0x08 .... 8 bits. + * | | |DWIDTH = 0x09 .... 9 bits. + * | | |..... + * | | |DWIDTH = 0x1F .... 31 bits. + * | | |DWIDTH = 0x00 .... 32 bits. + * |[13] |LSB |Send LSB First + * | | |0 = The MSB, which bit of transmit/receive register depends on the setting of DWIDTH, is transmitted/received first. + * | | |1 = The LSB, bit 0 of the QSPI TX register, is sent first to the QSPI data output pin, and the first bit received from the QSPI data input pin will be put in the LSB position of the RX register (bit 0 of QSPI_RX). + * |[14] |HALFDPX |QSPI Half-duplex Transfer Enable Bit + * | | |This bit is used to select full-duplex or half-duplex for QSPI transfer + * | | |The bit field DATDIR (QSPIx_CTL[20]) can be used to set the data direction in half-duplex transfer. + * | | |0 = QSPI operates in full-duplex transfer. + * | | |1 = QSPI operates in half-duplex transfer. + * |[15] |RXONLY |Receive-only Mode Enable Bit (Master Only) + * | | |This bit field is only available in Master mode + * | | |In receive-only mode, QSPI Master will generate QSPI bus clock continuously for receiving data bit from QSPI slave device and assert the BUSY status. + * | | |0 = Receive-only mode Disabled. + * | | |1 = Receive-only mode Enabled. + * |[16] |TWOBIT |2-bit Transfer Mode Enable Bit (Only Supported in QSPI0) + * | | |0 = 2-Bit Transfer mode Disabled. + * | | |1 = 2-Bit Transfer mode Enabled. + * | | |Note: When 2-Bit Transfer mode is enabled, the first serial transmitted bit data is from the first FIFO buffer data, and the 2nd serial transmitted bit data is from the second FIFO buffer data + * | | |As the same as transmitted function, the first received bit data is stored into the first FIFO buffer and the 2nd received bit data is stored into the second FIFO buffer at the same time. + * |[17] |UNITIEN |Unit Transfer Interrupt Enable Bit + * | | |0 = QSPI unit transfer interrupt Disabled. + * | | |1 = QSPI unit transfer interrupt Enabled. + * |[18] |SLAVE |Slave Mode Control + * | | |0 = Master mode. + * | | |1 = Slave mode. + * |[19] |REORDER |Byte Reorder Function Enable Bit + * | | |0 = Byte Reorder function Disabled. + * | | |1 = Byte Reorder function Enabled + * | | |A byte suspend interval will be inserted among each byte + * | | |The period of the byte suspend interval depends on the setting of SUSPITV. + * | | |Note: Byte Reorder function is only available if DWIDTH is defined as 16, 24, and 32 bits. + * |[20] |DATDIR |Data Port Direction Control + * | | |This bit is used to select the data input/output direction in half-duplex transfer and Dual/Quad transfer + * | | |0 = QSPI data is input direction. + * | | |1 = QSPI data is output direction. + * |[21] |DUALIOEN |Dual I/O Mode Enable Bit (Only Supported in QSPI0) + * | | |0 = Dual I/O mode Disabled. + * | | |1 = Dual I/O mode Enabled. + * |[22] |QUADIOEN |Quad I/O Mode Enable Bit (Only Supported in QSPI0) + * | | |0 = Quad I/O mode Disabled. + * | | |1 = Quad I/O mode Enabled. + * @var QSPI_T::CLKDIV + * Offset: 0x04 QSPI Clock Divider Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[8:0] |DIVIDER |Clock Divider + * | | |The value in this field is the frequency divider for generating the peripheral clock, fspi_eclk, and the QSPI bus clock of QSPI Master + * | | |The frequency is obtained according to the following equation. + * | | |where + * | | |is the peripheral clock source, which is defined in the clock control register, CLK_CLKSEL2. + * @var QSPI_T::SSCTL + * Offset: 0x08 QSPI Slave Select Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SS |Slave Selection Control (Master Only) + * | | |If AUTOSS bit is cleared to 0, + * | | |0 = set the QSPIx_SS line to inactive state. + * | | |1 = set the QSPIx_SS line to active state. + * | | |If the AUTOSS bit is set to 1, + * | | |0 = Keep the QSPIx_SS line at inactive state. + * | | |1 = QSPIx_SS line will be automatically driven to active state for the duration of data transfer, and will be driven to inactive state for the rest of the time + * | | |The active state of QSPIx_SS is specified in SSACTPOL (QSPIx_SSCTL[2]). + * |[2] |SSACTPOL |Slave Selection Active Polarity + * | | |This bit defines the active polarity of slave selection signal (QSPIx_SS). + * | | |0 = The slave selection signal QSPIx_SS is active low. + * | | |1 = The slave selection signal QSPIx_SS is active high. + * |[3] |AUTOSS |Automatic Slave Selection Function Enable Bit (Master Only) + * | | |0 = Automatic slave selection function Disabled + * | | |Slave selection signal will be asserted/de-asserted according to SS (QSPIx_SSCTL[0]). + * | | |1 = Automatic slave selection function Enabled. + * |[4] |SLV3WIRE |Slave 3-wire Mode Enable Bit (Only Supported in QSPI0) + * | | |Slave 3-wire mode is only available in QSPI0 + * | | |In Slave 3-wire mode, the QSPI controller can work with 3-wire interface including QSPI0_CLK, QSPI0_MISO and QSPI0_MOSI pins. + * | | |0 = 4-wire bi-direction interface. + * | | |1 = 3-wire bi-direction interface. + * |[5] |SLVTOIEN |Slave Mode Time-out Interrupt Enable Bit (Only Supported in QSPI0) + * | | |0 = Slave mode time-out interrupt Disabled. + * | | |1 = Slave mode time-out interrupt Enabled. + * |[6] |SLVTORST |Slave Mode Time-out Reset Control (Only Supported in QSPI0) + * | | |0 = When Slave mode time-out event occurs, the TX and RX control circuit will not be reset. + * | | |1 = When Slave mode time-out event occurs, the TX and RX control circuit will be reset by hardware. + * |[8] |SLVBEIEN |Slave Mode Bit Count Error Interrupt Enable Bit + * | | |0 = Slave mode bit count error interrupt Disabled. + * | | |1 = Slave mode bit count error interrupt Enabled. + * |[9] |SLVURIEN |Slave Mode TX Under Run Interrupt Enable Bit + * | | |0 = Slave mode TX under run interrupt Disabled. + * | | |1 = Slave mode TX under run interrupt Enabled. + * |[12] |SSACTIEN |Slave Select Active Interrupt Enable Bit + * | | |0 = Slave select active interrupt Disabled. + * | | |1 = Slave select active interrupt Enabled. + * |[13] |SSINAIEN |Slave Select Inactive Interrupt Enable Bit + * | | |0 = Slave select inactive interrupt Disabled. + * | | |1 = Slave select inactive interrupt Enabled. + * |[31:16] |SLVTOCNT |Slave Mode Time-out Period (Only Supported in QSPI0) + * | | |In Slave mode, these bits indicate the time-out period when there is bus clock input during slave select active + * | | |The clock source of the time-out counter is Slave peripheral clock + * | | |If the value is 0, it indicates the slave mode time-out function is disabled. + * @var QSPI_T::PDMACTL + * Offset: 0x0C QSPI PDMA Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |TXPDMAEN |Transmit PDMA Enable Bit + * | | |0 = Transmit PDMA function Disabled. + * | | |1 = Transmit PDMA function Enabled. + * | | |Note: In QSPI Master mode with full duplex transfer, if both TX and RX PDMA functions are enabled, RX PDMA function cannot be enabled prior to TX PDMA function + * | | |User can enable TX PDMA function firstly or enable both functions simultaneously. + * |[1] |RXPDMAEN |Receive PDMA Enable Bit + * | | |0 = Receive PDMA function Disabled. + * | | |1 = Receive PDMA function Enabled. + * |[2] |PDMARST |PDMA Reset + * | | |0 = No effect. + * | | |1 = Reset the PDMA control logic of the QSPI controller. This bit will be automatically cleared to 0. + * @var QSPI_T::FIFOCTL + * Offset: 0x10 QSPI FIFO Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |RXRST |Receive Reset + * | | |0 = No effect. + * | | |1 = Reset receive FIFO pointer and receive circuit + * | | |The RXFULL bit will be cleared to 0 and the RXEMPTY bit will be set to 1 + * | | |This bit will be cleared to 0 by hardware about 3 system clock cycles + 2 peripheral clock cycles after it is set to 1 + * | | |User can read TXRXRST (QSPIx_STATUS[23]) to check if reset is accomplished or not. + * |[1] |TXRST |Transmit Reset + * | | |0 = No effect. + * | | |1 = Reset transmit FIFO pointer and transmit circuit + * | | |The TXFULL bit will be cleared to 0 and the TXEMPTY bit will be set to 1 + * | | |This bit will be cleared to 0 by hardware about 3 system clock cycles + 2 peripheral clock cycles after it is set to 1 + * | | |User can read TXRXRST (QSPIx_STATUS[23]) to check if reset is accomplished or not. + * | | |Note: If TX underflow event occurs in QSPI Slave mode, this bit can be used to make QSPI return to idle state. + * |[2] |RXTHIEN |Receive FIFO Threshold Interrupt Enable Bit + * | | |0 = RX FIFO threshold interrupt Disabled. + * | | |1 = RX FIFO threshold interrupt Enabled. + * |[3] |TXTHIEN |Transmit FIFO Threshold Interrupt Enable Bit + * | | |0 = TX FIFO threshold interrupt Disabled. + * | | |1 = TX FIFO threshold interrupt Enabled. + * |[4] |RXTOIEN |Slave Receive Time-out Interrupt Enable Bit + * | | |0 = Receive time-out interrupt Disabled. + * | | |1 = Receive time-out interrupt Enabled. + * |[5] |RXOVIEN |Receive FIFO Overrun Interrupt Enable Bit + * | | |0 = Receive FIFO overrun interrupt Disabled. + * | | |1 = Receive FIFO overrun interrupt Enabled. + * |[6] |TXUFPOL |TX Underflow Data Polarity + * | | |0 = The QSPI data out is keep 0 if there is TX underflow event in Slave mode. + * | | |1 = The QSPI data out is keep 1 if there is TX underflow event in Slave mode. + * | | |Note: + * | | |1. The TX underflow event occurs if there is no any data in TX FIFO when the slave selection signal is active. + * | | |2. When TX underflow event occurs, QSPIx_MISO pin state will be determined by this setting even though TX FIFO is not empty afterward + * | | |Data stored in TX FIFO will be sent through QSPIx_MISO pin in the next transfer frame. + * |[7] |TXUFIEN |TX Underflow Interrupt Enable Bit + * | | |When TX underflow event occurs in Slave mode, TXUFIF (QSPIx_STATUS[19]) will be set to 1 + * | | |This bit is used to enable the TX underflow interrupt. + * | | |0 = Slave TX underflow interrupt Disabled. + * | | |1 = Slave TX underflow interrupt Enabled. + * |[8] |RXFBCLR |Receive FIFO Buffer Clear + * | | |0 = No effect. + * | | |1 = Clear receive FIFO pointer + * | | |The RXFULL bit will be cleared to 0 and the RXEMPTY bit will be set to 1 + * | | |This bit will be cleared to 0 by hardware about 1 system clock after it is set to 1. + * | | |Note: The RX shift register will not be cleared. + * |[9] |TXFBCLR |Transmit FIFO Buffer Clear + * | | |0 = No effect. + * | | |1 = Clear transmit FIFO pointer + * | | |The TXFULL bit will be cleared to 0 and the TXEMPTY bit will be set to 1 + * | | |This bit will be cleared to 0 by hardware about 1 system clock after it is set to 1. + * | | |Note: The TX shift register will not be cleared. + * |[26:24] |RXTH |Receive FIFO Threshold + * | | |If the valid data count of the receive FIFO buffer is larger than the RXTH setting, the RXTHIF bit will be set to 1, else the RXTHIF bit will be cleared to 0 + * |[30:28] |TXTH |Transmit FIFO Threshold + * | | |If the valid data count of the transmit FIFO buffer is less than or equal to the TXTH setting, the TXTHIF bit will be set to 1, else the TXTHIF bit will be cleared to 0 + * @var QSPI_T::STATUS + * Offset: 0x14 QSPI Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BUSY |Busy Status (Read Only) + * | | |0 = QSPI controller is in idle state. + * | | |1 = QSPI controller is in busy state. + * | | |The following listing are the bus busy conditions: + * | | |a. QSPIx_CTL[0] = 1 and TXEMPTY = 0. + * | | |b + * | | |For QSPI Master mode, QSPIx_CTL[0] = 1 and TXEMPTY = 1 but the current transaction is not finished yet. + * | | |c. For QSPI Master mode, QSPIx_CTL[0] = 1 and RXONLY = 1. + * | | |d + * | | |For QSPI Slave mode, the QSPIx_CTL[0] = 1 and there is serial clock input into the QSPI core logic when slave select is active. + * | | |For QSPI Slave mode, the QSPIx_CTL[0] = 1 and the transmit buffer or transmit shift register is not empty even if the slave select is inactive. + * |[1] |UNITIF |Unit Transfer Interrupt Flag + * | | |0 = No transaction has been finished since this bit was cleared to 0. + * | | |1 = QSPI controller has finished one unit transfer. + * | | |Note: This bit will be cleared by writing 1 to it. + * |[2] |SSACTIF |Slave Select Active Interrupt Flag + * | | |0 = Slave select active interrupt was cleared or not occurred. + * | | |1 = Slave select active interrupt event occurred. + * | | |Note: Only available in Slave mode. This bit will be cleared by writing 1 to it. + * |[3] |SSINAIF |Slave Select Inactive Interrupt Flag + * | | |0 = Slave select inactive interrupt was cleared or not occurred. + * | | |1 = Slave select inactive interrupt event occurred. + * | | |Note: Only available in Slave mode. This bit will be cleared by writing 1 to it. + * |[4] |SSLINE |Slave Select Line Bus Status (Read Only) + * | | |0 = The slave select line status is 0. + * | | |1 = The slave select line status is 1. + * | | |Note: This bit is only available in Slave mode + * | | |If SSACTPOL (QSPIx_SSCTL[2]) is set 0, and the SSLINE is 1, the QSPI slave select is in inactive status. + * |[5] |SLVTOIF |Slave Time-out Interrupt Flag (Only Supported in QSPI0) + * | | |When the slave select is active and the value of SLVTOCNT is not 0, as the bus clock is detected, the slave time-out counter in QSPI controller logic will be started + * | | |When the value of time-out counter is greater than or equal to the value of SLVTOCNT (QSPI_SSCTL[31:16]) before one transaction is done, the slave time-out interrupt event will be asserted. + * | | |0 = Slave time-out is not active. + * | | |1 = Slave time-out is active. + * | | |Note: This bit will be cleared by writing 1 to it. + * |[6] |SLVBEIF |Slave Mode Bit Count Error Interrupt Flag + * | | |In Slave mode, when the slave select line goes to inactive state, if bit counter is mismatch with DWIDTH, this interrupt flag will be set to 1. + * | | |0 = No Slave mode bit count error event. + * | | |1 = Slave mode bit count error event occurs. + * | | |Note: If the slave select active but there is no any bus clock input, the SLVBEIF also active when the slave select goes to inactive state + * | | |This bit will be cleared by writing 1 to it. + * |[7] |SLVURIF |Slave Mode TX Under Run Interrupt Flag + * | | |In Slave mode, if TX underflow event occurs and the slave select line goes to inactive state, this interrupt flag will be set to 1. + * | | |0 = No Slave TX under run event. + * | | |1 = Slave TX under run event occurs. + * | | |Note: This bit will be cleared by writing 1 to it. + * |[8] |RXEMPTY |Receive FIFO Buffer Empty Indicator (Read Only) + * | | |0 = Receive FIFO buffer is not empty. + * | | |1 = Receive FIFO buffer is empty. + * |[9] |RXFULL |Receive FIFO Buffer Full Indicator (Read Only) + * | | |0 = Receive FIFO buffer is not full. + * | | |1 = Receive FIFO buffer is full. + * |[10] |RXTHIF |Receive FIFO Threshold Interrupt Flag (Read Only) + * | | |0 = The valid data count within the receive FIFO buffer is smaller than or equal to the setting value of RXTH. + * | | |1 = The valid data count within the receive FIFO buffer is larger than the setting value of RXTH. + * |[11] |RXOVIF |Receive FIFO Overrun Interrupt Flag + * | | |When the receive FIFO buffer is full, the follow-up data will be dropped and this bit will be set to 1. + * | | |0 = No FIFO is overrun. + * | | |1 = Receive FIFO is overrun. + * | | |Note: This bit will be cleared by writing 1 to it. + * |[12] |RXTOIF |Receive Time-out Interrupt Flag + * | | |0 = No receive FIFO time-out event. + * | | |1 = Receive FIFO buffer is not empty and no read operation on receive FIFO buffer over 64 QSPI peripheral clock periods in Master mode or over 576 QSPI peripheral clock periods in Slave mode + * | | |When the received FIFO buffer is read by software, the time-out status will be cleared automatically. + * | | |Note: This bit will be cleared by writing 1 to it. + * |[15] |QSPIENSTS |QSPI Enable Status (Read Only) + * | | |0 = The QSPI controller is disabled. + * | | |1 = The QSPI controller is enabled. + * | | |Note: The QSPI peripheral clock is asynchronous with the system clock + * | | |In order to make sure the QSPI control logic is disabled, this bit indicates the real status of QSPI controller. + * |[16] |TXEMPTY |Transmit FIFO Buffer Empty Indicator (Read Only) + * | | |0 = Transmit FIFO buffer is not empty. + * | | |1 = Transmit FIFO buffer is empty. + * |[17] |TXFULL |Transmit FIFO Buffer Full Indicator (Read Only) + * | | |0 = Transmit FIFO buffer is not full. + * | | |1 = Transmit FIFO buffer is full. + * |[18] |TXTHIF |Transmit FIFO Threshold Interrupt Flag (Read Only) + * | | |0 = The valid data count within the transmit FIFO buffer is larger than the setting value of TXTH. + * | | |1 = The valid data count within the transmit FIFO buffer is less than or equal to the setting value of TXTH. + * |[19] |TXUFIF |TX Underflow Interrupt Flag + * | | |When the TX underflow event occurs, this bit will be set to 1, the state of data output pin depends on the setting of TXUFPOL. + * | | |0 = No effect. + * | | |1 = No data in Transmit FIFO and TX shift register when the slave selection signal is active. + * | | |Note 1: This bit will be cleared by writing 1 to it. + * | | |Note 2: If reset slave's transmission circuit when slave selection signal is active, this flag will be set to 1 after 2 peripheral clock cycles + 3 system clock cycles since the reset operation is done. + * |[23] |TXRXRST |TX or RX Reset Status (Read Only) + * | | |0 = The reset function of TXRST or RXRST is done. + * | | |1 = Doing the reset function of TXRST or RXRST. + * | | |Note: Both the reset operations of TXRST and RXRST need 3 system clock cycles + 2 peripheral clock cycles + * | | |User can check the status of this bit to monitor the reset function is doing or done. + * |[27:24] |RXCNT |Receive FIFO Data Count (Read Only) + * | | |This bit field indicates the valid data count of receive FIFO buffer. + * |[31:28] |TXCNT |Transmit FIFO Data Count (Read Only) + * | | |This bit field indicates the valid data count of transmit FIFO buffer. + * @var QSPI_T::TX + * Offset: 0x20 QSPI Data Transmit Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |TX |Data Transmit Register + * | | |The data transmit registers pass through the transmitted data into the 4-level transmit FIFO buffers + * | | |The number of valid bits depends on the setting of DWIDTH (QSPIx_CTL[12:8]) in SPI mode. + * | | |In SPI mode, if DWIDTH is set to 0x08, the bits TX[7:0] will be transmitted + * | | |If DWIDTH is set to 0x00 , the QSPI controller will perform a 32-bit transfer. + * | | |If WDWIDTH is set as 0x0, 0x1, or 0x3, all bits of this field are valid + * | | |Note: In Master mode, QSPI controller will start to transfer the QSPI bus clock after 1 APB clock and 6 peripheral clock cycles after user writes to this register. + * @var QSPI_T::RX + * Offset: 0x30 QSPI Data Receive Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |RX |Data Receive Register + * | | |There are 4-level FIFO buffers in this controller + * | | |The data receive register holds the data received from QSPI data input pin + * | | |This is a read only register. + */ + __IO uint32_t CTL; /*!< [0x0000] QSPI Control Register */ + __IO uint32_t CLKDIV; /*!< [0x0004] QSPI Clock Divider Register */ + __IO uint32_t SSCTL; /*!< [0x0008] QSPI Slave Select Control Register */ + __IO uint32_t PDMACTL; /*!< [0x000c] QSPI PDMA Control Register */ + __IO uint32_t FIFOCTL; /*!< [0x0010] QSPI FIFO Control Register */ + __IO uint32_t STATUS; /*!< [0x0014] QSPI Status Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[2]; + /// @endcond //HIDDEN_SYMBOLS + __O uint32_t TX; /*!< [0x0020] QSPI Data Transmit Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE1[3]; + /// @endcond //HIDDEN_SYMBOLS + __I uint32_t RX; /*!< [0x0030] QSPI Data Receive Register */ + +} QSPI_T; + +/** + @addtogroup QSPI_CONST QSPI Bit Field Definition + Constant Definitions for QSPI Controller +@{ */ + +#define QSPI_CTL_QSPIEN_Pos (0) /*!< QSPI_T::CTL: QSPIEN Position */ +#define QSPI_CTL_QSPIEN_Msk (0x1ul << QSPI_CTL_QSPIEN_Pos) /*!< QSPI_T::CTL: QSPIEN Mask */ + +#define QSPI_CTL_RXNEG_Pos (1) /*!< QSPI_T::CTL: RXNEG Position */ +#define QSPI_CTL_RXNEG_Msk (0x1ul << QSPI_CTL_RXNEG_Pos) /*!< QSPI_T::CTL: RXNEG Mask */ + +#define QSPI_CTL_TXNEG_Pos (2) /*!< QSPI_T::CTL: TXNEG Position */ +#define QSPI_CTL_TXNEG_Msk (0x1ul << QSPI_CTL_TXNEG_Pos) /*!< QSPI_T::CTL: TXNEG Mask */ + +#define QSPI_CTL_CLKPOL_Pos (3) /*!< QSPI_T::CTL: CLKPOL Position */ +#define QSPI_CTL_CLKPOL_Msk (0x1ul << QSPI_CTL_CLKPOL_Pos) /*!< QSPI_T::CTL: CLKPOL Mask */ + +#define QSPI_CTL_SUSPITV_Pos (4) /*!< QSPI_T::CTL: SUSPITV Position */ +#define QSPI_CTL_SUSPITV_Msk (0xful << QSPI_CTL_SUSPITV_Pos) /*!< QSPI_T::CTL: SUSPITV Mask */ + +#define QSPI_CTL_DWIDTH_Pos (8) /*!< QSPI_T::CTL: DWIDTH Position */ +#define QSPI_CTL_DWIDTH_Msk (0x1ful << QSPI_CTL_DWIDTH_Pos) /*!< QSPI_T::CTL: DWIDTH Mask */ + +#define QSPI_CTL_LSB_Pos (13) /*!< QSPI_T::CTL: LSB Position */ +#define QSPI_CTL_LSB_Msk (0x1ul << QSPI_CTL_LSB_Pos) /*!< QSPI_T::CTL: LSB Mask */ + +#define QSPI_CTL_HALFDPX_Pos (14) /*!< QSPI_T::CTL: HALFDPX Position */ +#define QSPI_CTL_HALFDPX_Msk (0x1ul << QSPI_CTL_HALFDPX_Pos) /*!< QSPI_T::CTL: HALFDPX Mask */ + +#define QSPI_CTL_RXONLY_Pos (15) /*!< QSPI_T::CTL: RXONLY Position */ +#define QSPI_CTL_RXONLY_Msk (0x1ul << QSPI_CTL_RXONLY_Pos) /*!< QSPI_T::CTL: RXONLY Mask */ + +#define QSPI_CTL_TWOBIT_Pos (16) /*!< QSPI_T::CTL: TWOBIT Position */ +#define QSPI_CTL_TWOBIT_Msk (0x1ul << QSPI_CTL_TWOBIT_Pos) /*!< QSPI_T::CTL: TWOBIT Mask */ + +#define QSPI_CTL_UNITIEN_Pos (17) /*!< QSPI_T::CTL: UNITIEN Position */ +#define QSPI_CTL_UNITIEN_Msk (0x1ul << QSPI_CTL_UNITIEN_Pos) /*!< QSPI_T::CTL: UNITIEN Mask */ + +#define QSPI_CTL_SLAVE_Pos (18) /*!< QSPI_T::CTL: SLAVE Position */ +#define QSPI_CTL_SLAVE_Msk (0x1ul << QSPI_CTL_SLAVE_Pos) /*!< QSPI_T::CTL: SLAVE Mask */ + +#define QSPI_CTL_REORDER_Pos (19) /*!< QSPI_T::CTL: REORDER Position */ +#define QSPI_CTL_REORDER_Msk (0x1ul << QSPI_CTL_REORDER_Pos) /*!< QSPI_T::CTL: REORDER Mask */ + +#define QSPI_CTL_DATDIR_Pos (20) /*!< QSPI_T::CTL: DATDIR Position */ +#define QSPI_CTL_DATDIR_Msk (0x1ul << QSPI_CTL_DATDIR_Pos) /*!< QSPI_T::CTL: DATDIR Mask */ + +#define QSPI_CTL_DUALIOEN_Pos (21) /*!< QSPI_T::CTL: DUALIOEN Position */ +#define QSPI_CTL_DUALIOEN_Msk (0x1ul << QSPI_CTL_DUALIOEN_Pos) /*!< QSPI_T::CTL: DUALIOEN Mask */ + +#define QSPI_CTL_QUADIOEN_Pos (22) /*!< QSPI_T::CTL: QUADIOEN Position */ +#define QSPI_CTL_QUADIOEN_Msk (0x1ul << QSPI_CTL_QUADIOEN_Pos) /*!< QSPI_T::CTL: QUADIOEN Mask */ + +#define QSPI_CLKDIV_DIVIDER_Pos (0) /*!< QSPI_T::CLKDIV: DIVIDER Position */ +#define QSPI_CLKDIV_DIVIDER_Msk (0x1fful << QSPI_CLKDIV_DIVIDER_Pos) /*!< QSPI_T::CLKDIV: DIVIDER Mask */ + +#define QSPI_SSCTL_SS_Pos (0) /*!< QSPI_T::SSCTL: SS Position */ +#define QSPI_SSCTL_SS_Msk (0x1ul << QSPI_SSCTL_SS_Pos) /*!< QSPI_T::SSCTL: SS Mask */ + +#define QSPI_SSCTL_SSACTPOL_Pos (2) /*!< QSPI_T::SSCTL: SSACTPOL Position */ +#define QSPI_SSCTL_SSACTPOL_Msk (0x1ul << QSPI_SSCTL_SSACTPOL_Pos) /*!< QSPI_T::SSCTL: SSACTPOL Mask */ + +#define QSPI_SSCTL_AUTOSS_Pos (3) /*!< QSPI_T::SSCTL: AUTOSS Position */ +#define QSPI_SSCTL_AUTOSS_Msk (0x1ul << QSPI_SSCTL_AUTOSS_Pos) /*!< QSPI_T::SSCTL: AUTOSS Mask */ + +#define QSPI_SSCTL_SLV3WIRE_Pos (4) /*!< QSPI_T::SSCTL: SLV3WIRE Position */ +#define QSPI_SSCTL_SLV3WIRE_Msk (0x1ul << QSPI_SSCTL_SLV3WIRE_Pos) /*!< QSPI_T::SSCTL: SLV3WIRE Mask */ + +#define QSPI_SSCTL_SLVTOIEN_Pos (5) /*!< QSPI_T::SSCTL: SLVTOIEN Position */ +#define QSPI_SSCTL_SLVTOIEN_Msk (0x1ul << QSPI_SSCTL_SLVTOIEN_Pos) /*!< QSPI_T::SSCTL: SLVTOIEN Mask */ + +#define QSPI_SSCTL_SLVTORST_Pos (6) /*!< QSPI_T::SSCTL: SLVTORST Position */ +#define QSPI_SSCTL_SLVTORST_Msk (0x1ul << QSPI_SSCTL_SLVTORST_Pos) /*!< QSPI_T::SSCTL: SLVTORST Mask */ + +#define QSPI_SSCTL_SLVBEIEN_Pos (8) /*!< QSPI_T::SSCTL: SLVBEIEN Position */ +#define QSPI_SSCTL_SLVBEIEN_Msk (0x1ul << QSPI_SSCTL_SLVBEIEN_Pos) /*!< QSPI_T::SSCTL: SLVBEIEN Mask */ + +#define QSPI_SSCTL_SLVURIEN_Pos (9) /*!< QSPI_T::SSCTL: SLVURIEN Position */ +#define QSPI_SSCTL_SLVURIEN_Msk (0x1ul << QSPI_SSCTL_SLVURIEN_Pos) /*!< QSPI_T::SSCTL: SLVURIEN Mask */ + +#define QSPI_SSCTL_SSACTIEN_Pos (12) /*!< QSPI_T::SSCTL: SSACTIEN Position */ +#define QSPI_SSCTL_SSACTIEN_Msk (0x1ul << QSPI_SSCTL_SSACTIEN_Pos) /*!< QSPI_T::SSCTL: SSACTIEN Mask */ + +#define QSPI_SSCTL_SSINAIEN_Pos (13) /*!< QSPI_T::SSCTL: SSINAIEN Position */ +#define QSPI_SSCTL_SSINAIEN_Msk (0x1ul << QSPI_SSCTL_SSINAIEN_Pos) /*!< QSPI_T::SSCTL: SSINAIEN Mask */ + +#define QSPI_SSCTL_SLVTOCNT_Pos (16) /*!< QSPI_T::SSCTL: SLVTOCNT Position */ +#define QSPI_SSCTL_SLVTOCNT_Msk (0xfffful << QSPI_SSCTL_SLVTOCNT_Pos) /*!< QSPI_T::SSCTL: SLVTOCNT Mask */ + +#define QSPI_PDMACTL_TXPDMAEN_Pos (0) /*!< QSPI_T::PDMACTL: TXPDMAEN Position */ +#define QSPI_PDMACTL_TXPDMAEN_Msk (0x1ul << QSPI_PDMACTL_TXPDMAEN_Pos) /*!< QSPI_T::PDMACTL: TXPDMAEN Mask */ + +#define QSPI_PDMACTL_RXPDMAEN_Pos (1) /*!< QSPI_T::PDMACTL: RXPDMAEN Position */ +#define QSPI_PDMACTL_RXPDMAEN_Msk (0x1ul << QSPI_PDMACTL_RXPDMAEN_Pos) /*!< QSPI_T::PDMACTL: RXPDMAEN Mask */ + +#define QSPI_PDMACTL_PDMARST_Pos (2) /*!< QSPI_T::PDMACTL: PDMARST Position */ +#define QSPI_PDMACTL_PDMARST_Msk (0x1ul << QSPI_PDMACTL_PDMARST_Pos) /*!< QSPI_T::PDMACTL: PDMARST Mask */ + +#define QSPI_FIFOCTL_RXRST_Pos (0) /*!< QSPI_T::FIFOCTL: RXRST Position */ +#define QSPI_FIFOCTL_RXRST_Msk (0x1ul << QSPI_FIFOCTL_RXRST_Pos) /*!< QSPI_T::FIFOCTL: RXRST Mask */ + +#define QSPI_FIFOCTL_TXRST_Pos (1) /*!< QSPI_T::FIFOCTL: TXRST Position */ +#define QSPI_FIFOCTL_TXRST_Msk (0x1ul << QSPI_FIFOCTL_TXRST_Pos) /*!< QSPI_T::FIFOCTL: TXRST Mask */ + +#define QSPI_FIFOCTL_RXTHIEN_Pos (2) /*!< QSPI_T::FIFOCTL: RXTHIEN Position */ +#define QSPI_FIFOCTL_RXTHIEN_Msk (0x1ul << QSPI_FIFOCTL_RXTHIEN_Pos) /*!< QSPI_T::FIFOCTL: RXTHIEN Mask */ + +#define QSPI_FIFOCTL_TXTHIEN_Pos (3) /*!< QSPI_T::FIFOCTL: TXTHIEN Position */ +#define QSPI_FIFOCTL_TXTHIEN_Msk (0x1ul << QSPI_FIFOCTL_TXTHIEN_Pos) /*!< QSPI_T::FIFOCTL: TXTHIEN Mask */ + +#define QSPI_FIFOCTL_RXTOIEN_Pos (4) /*!< QSPI_T::FIFOCTL: RXTOIEN Position */ +#define QSPI_FIFOCTL_RXTOIEN_Msk (0x1ul << QSPI_FIFOCTL_RXTOIEN_Pos) /*!< QSPI_T::FIFOCTL: RXTOIEN Mask */ + +#define QSPI_FIFOCTL_RXOVIEN_Pos (5) /*!< QSPI_T::FIFOCTL: RXOVIEN Position */ +#define QSPI_FIFOCTL_RXOVIEN_Msk (0x1ul << QSPI_FIFOCTL_RXOVIEN_Pos) /*!< QSPI_T::FIFOCTL: RXOVIEN Mask */ + +#define QSPI_FIFOCTL_TXUFPOL_Pos (6) /*!< QSPI_T::FIFOCTL: TXUFPOL Position */ +#define QSPI_FIFOCTL_TXUFPOL_Msk (0x1ul << QSPI_FIFOCTL_TXUFPOL_Pos) /*!< QSPI_T::FIFOCTL: TXUFPOL Mask */ + +#define QSPI_FIFOCTL_TXUFIEN_Pos (7) /*!< QSPI_T::FIFOCTL: TXUFIEN Position */ +#define QSPI_FIFOCTL_TXUFIEN_Msk (0x1ul << QSPI_FIFOCTL_TXUFIEN_Pos) /*!< QSPI_T::FIFOCTL: TXUFIEN Mask */ + +#define QSPI_FIFOCTL_RXFBCLR_Pos (8) /*!< QSPI_T::FIFOCTL: RXFBCLR Position */ +#define QSPI_FIFOCTL_RXFBCLR_Msk (0x1ul << QSPI_FIFOCTL_RXFBCLR_Pos) /*!< QSPI_T::FIFOCTL: RXFBCLR Mask */ + +#define QSPI_FIFOCTL_TXFBCLR_Pos (9) /*!< QSPI_T::FIFOCTL: TXFBCLR Position */ +#define QSPI_FIFOCTL_TXFBCLR_Msk (0x1ul << QSPI_FIFOCTL_TXFBCLR_Pos) /*!< QSPI_T::FIFOCTL: TXFBCLR Mask */ + +#define QSPI_FIFOCTL_RXTH_Pos (24) /*!< QSPI_T::FIFOCTL: RXTH Position */ +#define QSPI_FIFOCTL_RXTH_Msk (0x7ul << QSPI_FIFOCTL_RXTH_Pos) /*!< QSPI_T::FIFOCTL: RXTH Mask */ + +#define QSPI_FIFOCTL_TXTH_Pos (28) /*!< QSPI_T::FIFOCTL: TXTH Position */ +#define QSPI_FIFOCTL_TXTH_Msk (0x7ul << QSPI_FIFOCTL_TXTH_Pos) /*!< QSPI_T::FIFOCTL: TXTH Mask */ + +#define QSPI_STATUS_BUSY_Pos (0) /*!< QSPI_T::STATUS: BUSY Position */ +#define QSPI_STATUS_BUSY_Msk (0x1ul << QSPI_STATUS_BUSY_Pos) /*!< QSPI_T::STATUS: BUSY Mask */ + +#define QSPI_STATUS_UNITIF_Pos (1) /*!< QSPI_T::STATUS: UNITIF Position */ +#define QSPI_STATUS_UNITIF_Msk (0x1ul << QSPI_STATUS_UNITIF_Pos) /*!< QSPI_T::STATUS: UNITIF Mask */ + +#define QSPI_STATUS_SSACTIF_Pos (2) /*!< QSPI_T::STATUS: SSACTIF Position */ +#define QSPI_STATUS_SSACTIF_Msk (0x1ul << QSPI_STATUS_SSACTIF_Pos) /*!< QSPI_T::STATUS: SSACTIF Mask */ + +#define QSPI_STATUS_SSINAIF_Pos (3) /*!< QSPI_T::STATUS: SSINAIF Position */ +#define QSPI_STATUS_SSINAIF_Msk (0x1ul << QSPI_STATUS_SSINAIF_Pos) /*!< QSPI_T::STATUS: SSINAIF Mask */ + +#define QSPI_STATUS_SSLINE_Pos (4) /*!< QSPI_T::STATUS: SSLINE Position */ +#define QSPI_STATUS_SSLINE_Msk (0x1ul << QSPI_STATUS_SSLINE_Pos) /*!< QSPI_T::STATUS: SSLINE Mask */ + +#define QSPI_STATUS_SLVTOIF_Pos (5) /*!< QSPI_T::STATUS: SLVTOIF Position */ +#define QSPI_STATUS_SLVTOIF_Msk (0x1ul << QSPI_STATUS_SLVTOIF_Pos) /*!< QSPI_T::STATUS: SLVTOIF Mask */ + +#define QSPI_STATUS_SLVBEIF_Pos (6) /*!< QSPI_T::STATUS: SLVBEIF Position */ +#define QSPI_STATUS_SLVBEIF_Msk (0x1ul << QSPI_STATUS_SLVBEIF_Pos) /*!< QSPI_T::STATUS: SLVBEIF Mask */ + +#define QSPI_STATUS_SLVURIF_Pos (7) /*!< QSPI_T::STATUS: SLVURIF Position */ +#define QSPI_STATUS_SLVURIF_Msk (0x1ul << QSPI_STATUS_SLVURIF_Pos) /*!< QSPI_T::STATUS: SLVURIF Mask */ + +#define QSPI_STATUS_RXEMPTY_Pos (8) /*!< QSPI_T::STATUS: RXEMPTY Position */ +#define QSPI_STATUS_RXEMPTY_Msk (0x1ul << QSPI_STATUS_RXEMPTY_Pos) /*!< QSPI_T::STATUS: RXEMPTY Mask */ + +#define QSPI_STATUS_RXFULL_Pos (9) /*!< QSPI_T::STATUS: RXFULL Position */ +#define QSPI_STATUS_RXFULL_Msk (0x1ul << QSPI_STATUS_RXFULL_Pos) /*!< QSPI_T::STATUS: RXFULL Mask */ + +#define QSPI_STATUS_RXTHIF_Pos (10) /*!< QSPI_T::STATUS: RXTHIF Position */ +#define QSPI_STATUS_RXTHIF_Msk (0x1ul << QSPI_STATUS_RXTHIF_Pos) /*!< QSPI_T::STATUS: RXTHIF Mask */ + +#define QSPI_STATUS_RXOVIF_Pos (11) /*!< QSPI_T::STATUS: RXOVIF Position */ +#define QSPI_STATUS_RXOVIF_Msk (0x1ul << QSPI_STATUS_RXOVIF_Pos) /*!< QSPI_T::STATUS: RXOVIF Mask */ + +#define QSPI_STATUS_RXTOIF_Pos (12) /*!< QSPI_T::STATUS: RXTOIF Position */ +#define QSPI_STATUS_RXTOIF_Msk (0x1ul << QSPI_STATUS_RXTOIF_Pos) /*!< QSPI_T::STATUS: RXTOIF Mask */ + +#define QSPI_STATUS_QSPIENSTS_Pos (15) /*!< QSPI_T::STATUS: QSPIENSTS Position */ +#define QSPI_STATUS_QSPIENSTS_Msk (0x1ul << QSPI_STATUS_QSPIENSTS_Pos) /*!< QSPI_T::STATUS: QSPIENSTS Mask */ + +#define QSPI_STATUS_TXEMPTY_Pos (16) /*!< QSPI_T::STATUS: TXEMPTY Position */ +#define QSPI_STATUS_TXEMPTY_Msk (0x1ul << QSPI_STATUS_TXEMPTY_Pos) /*!< QSPI_T::STATUS: TXEMPTY Mask */ + +#define QSPI_STATUS_TXFULL_Pos (17) /*!< QSPI_T::STATUS: TXFULL Position */ +#define QSPI_STATUS_TXFULL_Msk (0x1ul << QSPI_STATUS_TXFULL_Pos) /*!< QSPI_T::STATUS: TXFULL Mask */ + +#define QSPI_STATUS_TXTHIF_Pos (18) /*!< QSPI_T::STATUS: TXTHIF Position */ +#define QSPI_STATUS_TXTHIF_Msk (0x1ul << QSPI_STATUS_TXTHIF_Pos) /*!< QSPI_T::STATUS: TXTHIF Mask */ + +#define QSPI_STATUS_TXUFIF_Pos (19) /*!< QSPI_T::STATUS: TXUFIF Position */ +#define QSPI_STATUS_TXUFIF_Msk (0x1ul << QSPI_STATUS_TXUFIF_Pos) /*!< QSPI_T::STATUS: TXUFIF Mask */ + +#define QSPI_STATUS_TXRXRST_Pos (23) /*!< QSPI_T::STATUS: TXRXRST Position */ +#define QSPI_STATUS_TXRXRST_Msk (0x1ul << QSPI_STATUS_TXRXRST_Pos) /*!< QSPI_T::STATUS: TXRXRST Mask */ + +#define QSPI_STATUS_RXCNT_Pos (24) /*!< QSPI_T::STATUS: RXCNT Position */ +#define QSPI_STATUS_RXCNT_Msk (0xful << QSPI_STATUS_RXCNT_Pos) /*!< QSPI_T::STATUS: RXCNT Mask */ + +#define QSPI_STATUS_TXCNT_Pos (28) /*!< QSPI_T::STATUS: TXCNT Position */ +#define QSPI_STATUS_TXCNT_Msk (0xful << QSPI_STATUS_TXCNT_Pos) /*!< QSPI_T::STATUS: TXCNT Mask */ + +#define QSPI_TX_TX_Pos (0) /*!< QSPI_T::TX: TX Position */ +#define QSPI_TX_TX_Msk (0xfffffffful << QSPI_TX_TX_Pos) /*!< QSPI_T::TX: TX Mask */ + +#define QSPI_RX_RX_Pos (0) /*!< QSPI_T::RX: RX Position */ +#define QSPI_RX_RX_Msk (0xfffffffful << QSPI_RX_RX_Pos) /*!< QSPI_T::RX: RX Mask */ + + +/**@}*/ /* QSPI_CONST */ +/**@}*/ /* end of QSPI register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __QSPI_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/rtc_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/rtc_reg.h new file mode 100644 index 00000000000..644d8e48566 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/rtc_reg.h @@ -0,0 +1,1274 @@ +/**************************************************************************//** + * @file rtc_reg.h + * @version V1.00 + * @brief RTC register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __RTC_REG_H__ +#define __RTC_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup RTC Real Time Clock Controller(RTC) + Memory Mapped Structure for RTC Controller +@{ */ + +typedef struct +{ + + + /** + * @var RTC_T::INIT + * Offset: 0x00 RTC Initiation Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |INIT_ACTIVE|RTC Active Status (Read Only) + * | | |0 = RTC is at reset state. + * | | |1 = RTC is at normal active state. + * |[31:1] |INIT |RTC Initiation (Write Only) + * | | |When RTC block is powered on, RTC is at reset state + * | | |User has to write a number (0xa5eb1357) to INIT to make RTC leaving reset state + * | | |Once the INIT is written as 0xa5eb1357, the RTC will be in un-reset state permanently. + * | | |The INIT is a write-only field and read value will be always 0. + * @var RTC_T::RWEN + * Offset: 0x04 RTC Access Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[16] |RWENF |RTC Register Access Enable Flag (Read Only) + * | | |0 = RTC register read/write Disabled. + * | | |1 = RTC register read/write Enabled. + * | | |Note: RWENF will be mask to 0 during RTCBUSY is 1, and first turn on RTCCKEN (CLK_APBCLK[1]) also. + * |[24] |RTCBUSY |RTC Write Busy Flag + * | | |This bit indicates RTC registers are writable or not. + * | | |0: RTC registers are writable. + * | | |1: RTC registers can't write, RTC under Busy Status. + * | | |Note: RTCBUSY flag will be set when execute write RTC register command exceed 6 times within 1120 PCLK cycles. + * @var RTC_T::FREQADJ + * Offset: 0x08 RTC Frequency Compensation Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[21:0] |FREQADJ |Frequency Compensation Register (M480) + * | | |User must to get actual LXT frequency for RTC application. + * | | |FCR = 0x200000 * (32768 / LXT frequency). + * | | |Note: This formula is suitable only when RTC clock source is from LXT, RTCSEL (CLK_CLKSEL3[8]) is 0. + * |[5:0] |FRACTION |Fraction Part (M480LD) + * | | |Formula: FRACTION = (fraction part of detected value) X 64. + * | | |Note: Digit in FCR must be expressed as hexadecimal number. + * |[12:8] |INTEGER |Integer Part (M480LD) + * | | |00000 = Integer part of detected value is 32752. + * | | |00001 = Integer part of detected value is 32753. + * | | |00010 = Integer part of detected value is 32754. + * | | |00011 = Integer part of detected value is 32755. + * | | |00100 = Integer part of detected value is 32756. + * | | |00101 = Integer part of detected value is 32757. + * | | |00110 = Integer part of detected value is 32758. + * | | |00111 = Integer part of detected value is 32759. + * | | |01000 = Integer part of detected value is 32760. + * | | |01001 = Integer part of detected value is 32761. + * | | |01010 = Integer part of detected value is 32762. + * | | |01011 = Integer part of detected value is 32763. + * | | |01100 = Integer part of detected value is 32764. + * | | |01101 = Integer part of detected value is 32765. + * | | |01110 = Integer part of detected value is 32766. + * | | |01111 = Integer part of detected value is 32767. + * | | |10000 = Integer part of detected value is 32768. + * | | |10001 = Integer part of detected value is 32769. + * | | |10010 = Integer part of detected value is 32770. + * | | |10011 = Integer part of detected value is 32771. + * | | |10100 = Integer part of detected value is 32772. + * | | |10101 = Integer part of detected value is 32773. + * | | |10110 = Integer part of detected value is 32774. + * | | |10111 = Integer part of detected value is 32775. + * | | |11000 = Integer part of detected value is 32776. + * | | |11001 = Integer part of detected value is 32777. + * | | |11010 = Integer part of detected value is 32778. + * | | |11011 = Integer part of detected value is 32779. + * | | |11100 = Integer part of detected value is 32780. + * | | |11101 = Integer part of detected value is 32781. + * | | |11110 = Integer part of detected value is 32782. + * | | |11111 = Integer part of detected value is 32783. + * |[31] |FCR_BUSY |Frequency Compensation Register Write Operation Busy (Read Only) (M480LD) + * | | |0 = The new register write operation is acceptable. + * | | |1 = The last write operation is in progress and new register write operation prohibited. + * | | |Note: This bit is only used when DYN_COMP_EN(RTC_CLKFMT[16]) enabled. + * @var RTC_T::TIME + * Offset: 0x0C RTC Time Loading Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |SEC |1-Sec Time Digit (0~9) + * |[6:4] |TENSEC |10-Sec Time Digit (0~5) + * |[11:8] |MIN |1-Min Time Digit (0~9) + * |[14:12] |TENMIN |10-Min Time Digit (0~5) + * |[19:16] |HR |1-Hour Time Digit (0~9) + * |[21:20] |TENHR |10-Hour Time Digit (0~2) + * | | |When RTC runs as 12-hour time scale mode, RTC_TIME[21] (the high bit of TENHR[1:0]) means AM/PM indication + * | | |(If RTC_TIME[21] is 1, it indicates PM time message). + * @var RTC_T::CAL + * Offset: 0x10 RTC Calendar Loading Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |DAY |1-Day Calendar Digit (0~9) + * |[5:4] |TENDAY |10-Day Calendar Digit (0~3) + * |[11:8] |MON |1-Month Calendar Digit (0~9) + * |[12] |TENMON |10-Month Calendar Digit (0~1) + * |[19:16] |YEAR |1-Year Calendar Digit (0~9) + * |[23:20] |TENYEAR |10-Year Calendar Digit (0~9) + * @var RTC_T::CLKFMT + * Offset: 0x14 RTC Time Scale Selection Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |24HEN |24-hour / 12-hour Time Scale Selection + * | | |Indicates that RTC_TIME and RTC_TALM are in 24-hour time scale or 12-hour time scale + * | | |0 = 12-hour time scale with AM and PM indication selected. + * | | |1 = 24-hour time scale selected. + * @var RTC_T::WEEKDAY + * Offset: 0x18 RTC Day of the Week Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2:0] |WEEKDAY |Day of the Week Register + * | | |000 = Sunday. + * | | |001 = Monday. + * | | |010 = Tuesday. + * | | |011 = Wednesday. + * | | |100 = Thursday. + * | | |101 = Friday. + * | | |110 = Saturday. + * | | |111 = Reserved. + * @var RTC_T::TALM + * Offset: 0x1C RTC Time Alarm Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |SEC |1-Sec Time Digit of Alarm Setting (0~9) + * |[6:4] |TENSEC |10-Sec Time Digit of Alarm Setting (0~5) + * |[11:8] |MIN |1-Min Time Digit of Alarm Setting (0~9) + * |[14:12] |TENMIN |10-Min Time Digit of Alarm Setting (0~5) + * |[19:16] |HR |1-Hour Time Digit of Alarm Setting (0~9) + * |[21:20] |TENHR |10-Hour Time Digit of Alarm Setting (0~2) + * | | |When RTC runs as 12-hour time scale mode, RTC_TIME[21] (the high bit of TENHR[1:0]) means AM/PM indication + * | | |(If RTC_TIME[21] is 1, it indicates PM time message). + * @var RTC_T::CALM + * Offset: 0x20 RTC Calendar Alarm Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |DAY |1-Day Calendar Digit of Alarm Setting (0~9) + * |[5:4] |TENDAY |10-Day Calendar Digit of Alarm Setting (0~3) + * |[11:8] |MON |1-Month Calendar Digit of Alarm Setting (0~9) + * |[12] |TENMON |10-Month Calendar Digit of Alarm Setting (0~1) + * |[19:16] |YEAR |1-Year Calendar Digit of Alarm Setting (0~9) + * |[23:20] |TENYEAR |10-Year Calendar Digit of Alarm Setting (0~9) + * @var RTC_T::LEAPYEAR + * Offset: 0x24 RTC Leap Year Indicator Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |LEAPYEAR |Leap Year Indication Register (Read Only) + * | | |0 = This year is not a leap year. + * | | |1 = This year is leap year. + * @var RTC_T::INTEN + * Offset: 0x28 RTC Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ALMIEN |Alarm Interrupt Enable Bit + * | | |Set ALMIEN to 1 can also enable chip wake-up function when RTC alarm interrupt event is generated. + * | | |0 = RTC Alarm interrupt Disabled. + * | | |1 = RTC Alarm interrupt Enabled. + * |[1] |TICKIEN |Time Tick Interrupt Enable Bit + * | | |Set TICKIEN to 1 can also enable chip wake-up function when RTC tick interrupt event is generated. + * | | |0 = RTC Time Tick interrupt Disabled. + * | | |1 = RTC Time Tick interrupt Enabled. + * |[8] |TAMP0IEN |Tamper 0 Interrupt Enable Bit + * | | |Set TAMP0IEN to 1 can also enable chip wake-up function when tamper 0 interrupt event is generated. + * | | |0 = Tamper 0 interrupt Disabled. + * | | |1 = Tamper 0 interrupt Enabled. + * |[9] |TAMP1IEN |Tamper 1 or Pair 0 Interrupt Enable Bit + * | | |Set TAMP1IEN to 1 can also enable chip wake-up function when tamper 1 interrupt event is generated. + * | | |0 = Tamper 1 or Pair 0 interrupt Disabled. + * | | |1 = Tamper 1 or Pair 0 interrupt Enabled. + * |[10] |TAMP2IEN |Tamper 2 Interrupt Enable Bit + * | | |Set TAMP2IEN to 1 can also enable chip wake-up function when tamper 2 interrupt event is generated. + * | | |0 = Tamper 2 interrupt Disabled. + * | | |1 = Tamper 2 interrupt Enabled. + * |[11] |TAMP3IEN |Tamper 3 or Pair 1 Interrupt Enable Bit + * | | |Set TAMP3IEN to 1 can also enable chip wake-up function when tamper 3 interrupt event is generated. + * | | |0 = Tamper 3 or Pair 1 interrupt Disabled. + * | | |1 = Tamper 3 or Pair 1 interrupt Enabled. + * |[12] |TAMP4IEN |Tamper 4 Interrupt Enable Bit + * | | |Set TAMP4IEN to 1 can also enable chip wake-up function when tamper 4 interrupt event is generated. + * | | |0 = Tamper 4 interrupt Disabled. + * | | |1 = Tamper 4 interrupt Enabled. + * |[13] |TAMP5IEN |Tamper 5 or Pair 2 Interrupt Enable Bit + * | | |Set TAMP5IEN to 1 can also enable chip wake-up function when tamper 5 interrupt event is generated. + * | | |0 = Tamper 5 or Pair 2 interrupt Disabled. + * | | |1 = Tamper 5 or Pair 2 interrupt Enabled. + * @var RTC_T::INTSTS + * Offset: 0x2C RTC Interrupt Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ALMIF |RTC Alarm Interrupt Flag + * | | |0 = Alarm condition is not matched. + * | | |1 = Alarm condition is matched. + * | | |Note: Write 1 to clear this bit. + * |[1] |TICKIF |RTC Time Tick Interrupt Flag + * | | |0 = Tick condition does not occur. + * | | |1 = Tick condition occur. + * | | |Note: Write 1 to clear this bit. + * |[8] |TAMP0IF |Tamper 0 Interrupt Flag + * | | |This bit is set when TAMP0_PIN detected level non-equal TAMP0LV (RTC_TAMPCTL[9]). + * | | |0 = No Tamper 0 interrupt flag is generated. + * | | |1 = Tamper 0 interrupt flag is generated. + * | | |Note1: Write 1 to clear this bit. + * | | |Note2: Clear all TAPMxIF will clear RTC_TAMPTIME and RTC_TAMPCAL automatically. + * |[9] |TAMP1IF |Tamper 1 or Pair 0 Interrupt Flag + * | | |This bit is set when TAMP1_PIN detected level non-equal TAMP1LV (RTC_TAMPCTL[13]) + * | | |or TAMP0_PIN and TAMP1_PIN disconnected during DYNPR0EN (RTC_TAMPCTL[15]) is activated. + * | | |0 = No Tamper 1 or Pair 0 interrupt flag is generated. + * | | |1 = Tamper 1 or Pair 0 interrupt flag is generated. + * | | |Note1: Write 1 to clear this bit. + * | | |Note2: Clear all TAPMxIF will clear RTC_TAMPTIME and RTC_TAMPCAL automatically. + * |[10] |TAMP2IF |Tamper 2 Interrupt Flag + * | | |This bit is set when TAMP2_PIN detected level non-equal TAMP2LV (RTC_TAMPCTL[17]). + * | | |0 = No Tamper 2 interrupt flag is generated. + * | | |1 = Tamper 2 interrupt flag is generated. + * | | |Note1: Write 1 to clear this bit. + * | | |Note2: Clear all TAPMxIF will clear RTC_TAMPTIME and RTC_TAMPCAL automatically. + * |[11] |TAMP3IF |Tamper 3 or Pair 1 Interrupt Flag + * | | |This bit is set when TAMP3_PIN detected level non-equal TAMP3LV (RTC_TAMPCTL[21]) + * | | |or TAMP2_PIN and TAMP3_PIN disconnected during DYNPR1EN (RTC_TAMPCTL[23]) is activated + * | | |or TAMP0_PIN and TAMP3_PIN disconnected during DYNPR1EN (RTC_TAMPCTL[23]) and DYN1ISS (RTC_TAMPCTL[0]) are activated. + * | | |0 = No Tamper 3 or Pair 1 interrupt flag is generated. + * | | |1 = Tamper 3 or Pair 1 interrupt flag is generated. + * | | |Note1: Write 1 to clear this bit. + * | | |Note2: Clear all TAPMxIF will clear RTC_TAMPTIME and RTC_TAMPCAL automatically. + * |[12] |TAMP4IF |Tamper 4 Interrupt Flag + * | | |This bit is set when TAMP4_PIN detected level non-equal TAMP4LV (RTC_TAMPCTL[25]). + * | | |0 = No Tamper 4 interrupt flag is generated. + * | | |1 = Tamper 4 interrupt flag is generated. + * | | |Note1: Write 1 to clear this bit. + * | | |Note2: Clear all TAPMxIF will clear RTC_TAMPTIME and RTC_TAMPCAL automatically. + * |[13] |TAMP5IF |Tamper 5 or Pair 2 Interrupt Flag + * | | |This bit is set when TAMP5_PIN detected level non-equal TAMP5LV (RTC_TAMPCTL[29]) + * | | |or TAMP4_PIN and TAMP5_PIN disconnected during DYNPR2EN (RTC_TAMPCTL[31]) is activated + * | | |or TAMP0_PIN and TAMP5_PIN disconnected during DYNPR2EN (RTC_TAMPCTL[31]) and DYN2ISS (RTC_TAMPCTL[1]) are activated. + * | | |0 = No Tamper 5 or Pair 2 interrupt flag is generated. + * | | |1 = Tamper 5 or Pair 2 interrupt flag is generated. + * | | |Note1: Write 1 to clear this bit. + * | | |Note2: Clear all TAPMxIF will clear RTC_TAMPTIME and RTC_TAMPCAL automatically. + * @var RTC_T::TICK + * Offset: 0x30 RTC Time Tick Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2:0] |TICK |Time Tick Register + * | | |These bits are used to select RTC time tick period for Periodic Time Tick Interrupt request. + * | | |000 = Time tick is 1 second. + * | | |001 = Time tick is 1/2 second. + * | | |010 = Time tick is 1/4 second. + * | | |011 = Time tick is 1/8 second. + * | | |100 = Time tick is 1/16 second. + * | | |101 = Time tick is 1/32 second. + * | | |110 = Time tick is 1/64 second. + * | | |111 = Time tick is 1/128 second. + * | | |Note: This register can be read back after the RTC register access enable bit RWENF (RTC_RWEN[16]) is active. + * @var RTC_T::TAMSK + * Offset: 0x34 RTC Time Alarm Mask Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |MSEC |Mask 1-Sec Time Digit of Alarm Setting (0~9) + * |[1] |MTENSEC |Mask 10-Sec Time Digit of Alarm Setting (0~5) + * |[2] |MMIN |Mask 1-Min Time Digit of Alarm Setting (0~9) + * |[3] |MTENMIN |Mask 10-Min Time Digit of Alarm Setting (0~5) + * |[4] |MHR |Mask 1-Hour Time Digit of Alarm Setting (0~9) + * |[5] |MTENHR |Mask 10-Hour Time Digit of Alarm Setting (0~2) + * @var RTC_T::CAMSK + * Offset: 0x38 RTC Calendar Alarm Mask Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |MDAY |Mask 1-Day Calendar Digit of Alarm Setting (0~9) + * |[1] |MTENDAY |Mask 10-Day Calendar Digit of Alarm Setting (0~3) + * |[2] |MMON |Mask 1-Month Calendar Digit of Alarm Setting (0~9) + * |[3] |MTENMON |Mask 10-Month Calendar Digit of Alarm Setting (0~1) + * |[4] |MYEAR |Mask 1-Year Calendar Digit of Alarm Setting (0~9) + * |[5] |MTENYEAR |Mask 10-Year Calendar Digit of Alarm Setting (0~9) + * @var RTC_T::SPRCTL + * Offset: 0x3C RTC Spare Functional Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2] |SPRRWEN |Spare Register Enable Bit + * | | |0 = Spare register is Disabled. + * | | |1 = Spare register is Enabled. + * | | |Note: When spare register is disabled, RTC_SPR0 ~ RTC_SPR19 cannot be accessed. + * |[5] |SPRCSTS |SPR Clear Flag + * | | |This bit indicates if the RTC_SPR0 ~RTC_SPR19 content is cleared when specify tamper event is detected. + * | | |0 = Spare register content is not cleared. + * | | |1 = Spare register content is cleared. + * | | |Writes 1 to clear this bit. + * | | |Note: This bit keep 1 when RTC_INTSTS[13:8] not equal zero. + * @var RTC_T::SPR[20] + * Offset: 0x40 ~ 0x8C RTC Spare Register 0 ~ 19 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |SPARE |Spare Register + * | | |This field is used to store back-up information defined by user. + * | | |This field will be cleared by hardware automatically once a tamper pin event is detected. + * | | |Before storing back-up information in to RTC_SPRx register, + * | | |user should check REWNF (RTC_RWEN[16]) is enabled. + * @var RTC_T::LXTCTL + * Offset: 0x100 RTC 32.768 kHz Oscillator Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2:1] |GAIN |Oscillator Gain Option + * | | |User can select oscillator gain according to crystal external loading and operating temperature range + * | | |The larger gain value corresponding to stronger driving capability and higher power consumption. + * | | |00 = L0 mode. + * | | |01 = L1 mode. + * | | |10 = L2 mode. + * | | |11 = L3 mode. + * @var RTC_T::GPIOCTL0 + * Offset: 0x104 RTC GPIO Control 0 Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |OPMODE0 |IO Operation Mode + * | | |00 = PF.4 is input only mode, without pull-up resistor. + * | | |01 = PF.4 is output push pull mode. + * | | |10 = PF.4 is open drain mode. + * | | |11 = PF.4 is quasi-bidirectional mode with internal pull up. + * |[2] |DOUT0 |IO Output Data + * | | |0 = PF.4 output low. + * | | |1 = PF.4 output high. + * |[3] |CTLSEL0 |IO Pin State Backup Selection + * | | |When low speed 32 kHz oscillator is disabled, PF.4 pin (X32KO pin) can be used as GPIO function + * | | |User can program CTLSEL0 to decide PF.4 I/O function is controlled by system power domain GPIO module or + * | | |VBAT power domain RTC_GPIOCTL0 control register. + * | | |0 = PF.4 pin I/O function is controlled by GPIO module. + * | | |Hardware auto becomes CTLSEL0 = 1 when system power is turned off. + * | | |1 = PF.4 pin I/O function is controlled by VBAT power domain. + * | | |PF.4 pin function and I/O status are controlled by OPMODE0[1:0] and DOUT0 after CTLSEL0 is set to 1. + * | | |Note: CTLSEL0 will automatically be set by hardware to 1 when system power is off and INIT[0] (RTC_INIT[0]) is 1. + * |[5:4] |PUSEL0 |IO Pull-up and Pull-down Enable + * | | |Determine PF.4 I/O pull-up or pull-down. + * | | |00 = PF.4 pull-up and pull-up disable. + * | | |01 = PF.4 pull-down enable. + * | | |10 = PF.4 pull-up enable. + * | | |11 = PF.4 pull-up and pull-up disable. + * | | |Note: + * | | |Basically, the pull-up control and pull-down control has following behavior limitation. + * | | |The independent pull-up control register only valid when OPMODE0 set as input tri-state and open-drain mode. + * | | |The independent pull-down control register only valid when OPMODE0 set as input tri-state mode. + * |[9:8] |OPMODE1 |IO Operation Mode + * | | |00 = PF.5 is input only mode, without pull-up resistor. + * | | |01 = PF.5 is output push pull mode. + * | | |10 = PF.5 is open drain mode. + * | | |11 = PF.5 is quasi-bidirectional mode with internal pull up. + * |[10] |DOUT1 |IO Output Data + * | | |0 = PF.5 output low. + * | | |1 = PF.5 output high. + * |[11] |CTLSEL1 |IO Pin State Backup Selection + * | | |When low speed 32 kHz oscillator is disabled, PF.5 pin (X32KI pin) can be used as GPIO function + * | | |User can program CTLSEL1 to decide PF.5 I/O function is controlled by system power domain GPIO module or + * | | |VBAT power domain RTC_GPIOCTL0 control register. + * | | |0 = PF.5 pin I/O function is controlled by GPIO module. + * | | |Hardware auto becomes CTLSEL1 = 1 when system power is turned off. + * | | |1 = PF.5 pin I/O function is controlled by VBAT power domain. + * | | |PF.5 pin function and I/O status are controlled by OPMODE1[1:0] and DOUT1 after CTLSEL1 is set to 1. + * | | |Note: CTLSEL1 will automatically be set by hardware to 1 when system power is off and INIT[0] (RTC_INIT[0]) is 1. + * |[13:12] |PUSEL1 |IO Pull-up and Pull-down Enable + * | | |Determine PF.5 I/O pull-up or pull-down. + * | | |00 = PF.5 pull-up and pull-up disable. + * | | |01 = PF.5 pull-down enable. + * | | |10 = PF.5 pull-up enable. + * | | |11 = PF.5 pull-up and pull-up disable. + * | | |Note: + * | | |Basically, the pull-up control and pull-down control has following behavior limitation. + * | | |The independent pull-up control register only valid when OPMODE1 set as input tri-state and open-drain mode. + * | | |The independent pull-down control register only valid when OPMODE1 set as input tri-state mode. + * |[17:16] |OPMODE2 |IO Operation Mode + * | | |00 = PF.6 is input only mode, without pull-up resistor. + * | | |01 = PF.6 is output push pull mode. + * | | |10 = PF.6 is open drain mode. + * | | |11 = PF.6 is quasi-bidirectional mode with internal pull up. + * |[18] |DOUT2 |IO Output Data + * | | |0 = PF.6 output low. + * | | |1 = PF.6 output high. + * |[19] |CTLSEL2 |IO Pin State Backup Selection + * | | |When TAMP0EN is disabled, PF.6 pin (TAMPER0 pin) can be used as GPIO function + * | | |User can program CTLSEL2 to decide PF.6 I/O function is controlled by system power domain GPIO module or + * | | |VBAT power domain RTC_GPIOCTL0 control register. + * | | |0 = PF.6 pin I/O function is controlled by GPIO module. + * | | |Hardware auto becomes CTLSEL2 = 1 when system power is turned off. + * | | |1 = PF.6 pin I/O function is controlled by VBAT power domain. + * | | |PF.6 pin function and I/O status are controlled by OPMODE2[1:0] and DOUT2 after CTLSEL2 is set to 1. + * | | |Note: CTLSEL2 will automatically be set by hardware to 1 when system power is off and INIT[0] (RTC_INIT[0]) is 1. + * |[21:20] |PUSEL2 |IO Pull-up and Pull-down Enable + * | | |Determine PF.6 I/O pull-up or pull-down. + * | | |00 = PF.6 pull-up and pull-up disable. + * | | |01 = PF.6 pull-down enable. + * | | |10 = PF.6 pull-up enable. + * | | |11 = PF.6 pull-up and pull-up disable. + * | | |Note1: + * | | |Basically, the pull-up control and pull-down control has following behavior limitation. + * | | |The independent pull-up control register only valid when OPMODE2 set as input tri-state and open-drain mode. + * | | |The independent pull-down control register only valid when OPMODE2 set as input tri-state mode. + * |[25:24] |OPMODE3 |IO Operation Mode + * | | |00 = PF.7 is input only mode, without pull-up resistor. + * | | |01 = PF.7 is output push pull mode. + * | | |10 = PF.7 is open drain mode. + * | | |11 = PF.7 is quasi-bidirectional mode. + * |[26] |DOUT3 |IO Output Data + * | | |0 = PF.7 output low. + * | | |1 = PF.7 output high. + * |[27] |CTLSEL3 |IO Pin State Backup Selection + * | | |When TAMP1EN is disabled, PF.7 pin (TAMPER1 pin) can be used as GPIO function + * | | |User can program CTLSEL3 to decide PF.7 I/O function is controlled by system power domain GPIO module or + * | | |VBAT power domain RTC_GPIOCTL0 control register. + * | | |0 = PF.7 pin I/O function is controlled by GPIO module. + * | | |Hardware auto becomes CTLSEL3 = 1 when system power is turned off. + * | | |1 = PF.7 pin I/O function is controlled by VBAT power domain. + * | | |PF.7 pin function and I/O status are controlled by OPMODE3[1:0] and DOUT3 after CTLSEL3 is set to 1. + * | | |Note: CTLSEL3 will automatically be set by hardware to 1 when system power is off and RTC_INIT[0] (RTC Active Status) is 1. + * |[29:28] |PUSEL3 |IO Pull-up and Pull-down Enable + * | | |Determine PF.7 I/O pull-up or pull-down. + * | | |00 = PF.7 pull-up and pull-down disable. + * | | |01 = PF.7 pull-down enable. + * | | |10 = PF.7 pull-up enable. + * | | |11 = PF.7 pull-up and pull-down disable. + * | | |Note: + * | | |Basically, the pull-up control and pull-down control has following behavior limitation. + * | | |The independent pull-up control register only valid when OPMODE3 set as input tri-state and open-drain mode. + * | | |The independent pull-down control register only valid when OPMODE3 set as input tri-state mode. + * @var RTC_T::GPIOCTL1 + * Offset: 0x108 RTC GPIO Control 1 Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |OPMODE4 |IO Operation Mode + * | | |00 = PF.8 is input only mode, without pull-up resistor. + * | | |01 = PF.8 is output push pull mode. + * | | |10 = PF.8 is open drain mode. + * | | |11 = PF.8 is quasi-bidirectional mode. + * |[2] |DOUT4 |IO Output Data + * | | |0 = PF.8 output low. + * | | |1 = PF.8 output high. + * |[3] |CTLSEL4 |IO Pin State Backup Selection + * | | |When TAMP2EN is disabled, PF.8 pin (TAMPER2 pin) can be used as GPIO function + * | | |User can program CTLSEL4 to decide PF.8 I/O function is controlled by system power domain GPIO module or + * | | |VBAT power domain RTC_GPIOCTL1 control register. + * | | |0 = PF.8 pin I/O function is controlled by GPIO module. + * | | |Hardware auto becomes CTLSEL4 = 1 when system power is turned off. + * | | |1 = PF.8 pin I/O function is controlled by VBAT power domain. + * | | |PF.8 pin function and I/O status are controlled by OPMODE4[1:0] and DOUT4 after CTLSEL4 is set to 1. + * | | |Note: CTLSEL4 will automatically be set by hardware to 1 when system power is off and RTC_INIT[0] (RTC Active Status) is 1. + * |[5:4] |PUSEL4 |IO Pull-up and Pull-down Enable + * | | |Determine PF.8 I/O pull-up or pull-down. + * | | |00 = PF.8 pull-up and pull-down disable. + * | | |01 = PF.8 pull-down enable. + * | | |10 = PF.8 pull-up enable. + * | | |11 = PF.8 pull-up and pull-down disable. + * | | |Note: + * | | |Basically, the pull-up control and pull-down control has following behavior limitation. + * | | |The independent pull-up control register only valid when OPMODE4 set as input tri-state and open-drain mode. + * | | |The independent pull-down control register only valid when OPMODE4 set as input tri-state mode. + * |[9:8] |OPMODE5 |IO Operation Mode + * | | |00 = PF.9 is input only mode, without pull-up resistor. + * | | |01 = PF.9 is output push pull mode. + * | | |10 = PF.9 is open drain mode. + * | | |11 = PF.9 is quasi-bidirectional mode. + * |[10] |DOUT5 |IO Output Data + * | | |0 = PF.9 output low. + * | | |1 = PF.9 output high. + * |[11] |CTLSEL5 |IO Pin State Backup Selection + * | | |When TAMP3EN is disabled, PF.9 pin (TAMPER3 pin) can be used as GPIO function + * | | |User can program CTLSEL5 to decide PF.9 I/O function is controlled by system power domain GPIO module or + * | | |VBAT power domain RTC_GPIOCTL1 control register. + * | | |0 = PF.9 pin I/O function is controlled by GPIO module. + * | | |Hardware auto becomes CTLSEL5 = 1 when system power is turned off. + * | | |1 = PF.9 pin I/O function is controlled by VBAT power domain. + * | | |PF.9 pin function and I/O status are controlled by OPMODE5[1:0] and DOUT5 after CTLSEL5 is set to 1. + * | | |Note: CTLSEL5 will automatically be set by hardware to 1 when system power is off and INIT[0] (RTC_INIT[0]) is 1. + * |[13:12] |PUSEL5 |IO Pull-up and Pull-down Enable + * | | |Determine PF.9 I/O pull-up or pull-down. + * | | |00 = PF.9 pull-up and pull-down disable. + * | | |01 = PF.9 pull-down enable. + * | | |10 = PF.9 pull-up enable. + * | | |11 = PF.9 pull-up and pull-down disable. + * | | |Note: + * | | |Basically, the pull-up control and pull-down control has following behavior limitation. + * | | |The independent pull-up control register only valid when OPMODE5 set as input tri-state and open-drain mode. + * | | |The independent pull-down control register only valid when OPMODE5 set as input tri-state mode. + * |[17:16] |OPMODE6 |IO Operation Mode + * | | |00 = PF.10 is input only mode, without pull-up resistor. + * | | |01 = PF.10 is output push pull mode. + * | | |10 = PF.10 is open drain mode. + * | | |11 = PF.10 is quasi-bidirectional mode. + * |[18] |DOUT6 |IO Output Data + * | | |0 = PF.10 output low. + * | | |1 = PF.10 output high. + * |[19] |CTLSEL6 |IO Pin State Backup Selection + * | | |When TAMP4EN is disabled, PF.10 pin (TAMPER4 pin) can be used as GPIO function + * | | |User can program CTLSEL6 to decide PF.10 I/O function is controlled by system power domain GPIO module or + * | | |VBAT power domain RTC_GPIOCTL1 control register. + * | | |0 = PF.10 pin I/O function is controlled by GPIO module. + * | | |Hardware auto becomes CTLSEL6 = 1 when system power is turned off. + * | | |1 = PF.10 pin I/O function is controlled by VBAT power domain. + * | | |PF.10 pin function and I/O status are controlled by OPMODE6[1:0] and DOUT6 after CTLSEL6 is set to 1. + * | | |Note: CTLSEL6 will automatically be set by hardware to 1 when system power is off and INIT[0] (RTC_INIT[0]) is 1. + * |[21:20] |PUSEL6 |IO Pull-up and Pull-down Enable + * | | |Determine PF.10 I/O pull-up or pull-down. + * | | |00 = PF.10 pull-up and pull-down disable. + * | | |01 = PF.10 pull-down enable. + * | | |10 = PF.10 pull-up enable. + * | | |11 = PF.10 pull-up and pull-down disable. + * | | |Note: + * | | |Basically, the pull-up control and pull-down control has following behavior limitation. + * | | |The independent pull-up control register only valid when OPMODE6 set as input tri-state and open-drain mode. + * | | |The independent pull-down control register only valid when OPMODE6 set as input tri-state mode. + * |[25:24] |OPMODE7 |IO Operation Mode + * | | |00 = PF.11 is input only mode, without pull-up resistor. + * | | |01 = PF.11 is output push pull mode. + * | | |10 = PF.11 is open drain mode. + * | | |11 = PF.11 is quasi-bidirectional mode. + * |[26] |DOUT7 |IO Output Data + * | | |0 = PF.11 output low. + * | | |1 = PF.11 output high. + * |[27] |CTLSEL7 |IO Pin State Backup Selection + * | | |When TAMP5EN is disabled, PF.11 pin (TAMPER5 pin) can be used as GPIO function + * | | |User can program CTLSEL7 to decide PF.11 I/O function is controlled by system power domain GPIO module or + * | | |VBAT power domain RTC_GPIOCTL1 control register. + * | | |0 = PF.11 pin I/O function is controlled by GPIO module. + * | | |Hardware auto becomes CTLSEL7 = 1 when system power is turned off. + * | | |1 = PF.11 pin I/O function is controlled by VBAT power domain. + * | | |PF.11 pin function and I/O status are controlled by OPMODE7[1:0] and DOUT7 after CTLSEL7 is set to 1. + * | | |Note: CTLSEL7 will automatically be set by hardware to 1 when system power is off and INIT[0] (RTC_INIT[0]) is 1. + * |[29:28] |PUSEL7 |IO Pull-up and Pull-down Enable + * | | |Determine PF.11 I/O pull-up or pull-down. + * | | |00 = PF.11 pull-up and pull-down disable. + * | | |01 = PF.11 pull-down enable. + * | | |10 = PF.11 pull-up enable. + * | | |11 = PF.11 pull-up and pull-down disable. + * | | |Note: + * | | |Basically, the pull-up control and pull-down control has following behavior limitation. + * | | |The independent pull-up control register only valid when OPMODE7 set as input tri-state and open-drain mode. + * | | |The independent pull-down control register only valid when OPMODE7 set as input tri-state mode. + * @var RTC_T::DSTCTL + * Offset: 0x110 RTC Daylight Saving Time Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ADDHR |Add 1 Hour + * | | |0 = No effect. + * | | |1 = Indicates RTC hour digit has been added one hour for summer time change. + * |[1] |SUBHR |Subtract 1 Hour + * | | |0 = No effect. + * | | |1 = Indicates RTC hour digit has been subtracted one hour for winter time change. + * |[2] |DSBAK |Daylight Saving Back + * | | |0= Normal mode. + * | | |1= Daylight saving mode. + * @var RTC_T::TAMPCTL + * Offset: 0x120 RTC Tamper Pin Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |DYN1ISS |Dynamic Pair 1 Input Source Select + * | | |This bit determine Tamper 3 input is from Tamper 2 or Tamper 0 in dynamic mode. + * | | |0 = Tamper input is from Tamper 2. + * | | |1 = Tamper input is from Tamper 0. + * | | |Note: This bit has effect only when DYNPR1EN (RTC_TAMPCTL[16]) and DYNPR0EN (RTC_TAMPCTL[15]) are set + * |[1] |DYN2ISS |Dynamic Pair 2 Input Source Select + * | | |This bit determine Tamper 5 input is from Tamper 4 or Tamper 0 in dynamic mode. + * | | |0 = Tamper input is from Tamper 4. + * | | |1 = Tamper input is from Tamper 0. + * | | |Note: This bit has effect only when DYNPR2EN (RTC_TAMPCTL[24]) and DYNPR0EN (RTC_TAMPCTL[15]) are set + * |[3:2] |DYNSRC |Dynamic Reference Pattern + * | | |This fields determine the new reference pattern when current pattern run out in dynamic pair mode. + * | | |00 or 10 = The new reference pattern is generated by random number generator when the reference pattern run out. + * | | |01 = The new reference pattern is repeated previous random value when the reference pattern run out. + * | | |11 = The new reference pattern is repeated from SEED (RTC_TAMPSEED[31:0]) when the reference pattern run out. + * | | |Note: After revise this bit, the SEEDRLD (RTC_TAMPCTL[4]) should be set. + * |[4] |SEEDRLD |Reload New Seed for PRNG Engine + * | | |Setting this bit, the tamper configuration will be reload. + * | | |0 = Generating key based on the current seed. + * | | |1 = Reload new seed. + * | | |Note: Before set this bit, the tamper configuration should be set to complete. + * |[7:5] |DYNRATE |Dynamic Change Rate + * | | |This item is choice the dynamic tamper output change rate. + * | | |000 = 210 * RTC_CLK. + * | | |001 = 211 * RTC_CLK. + * | | |010 = 212 * RTC_CLK. + * | | |011 = 213 * RTC_CLK. + * | | |100 = 214 * RTC_CLK. + * | | |101 = 215 * RTC_CLK. + * | | |110 = 216 * RTC_CLK. + * | | |111 = 217 * RTC_CLK. + * | | |Note: After revise this field, set SEEDRLD (RTC_TAMPCTL[4]) can reload change rate immediately. + * |[8] |TAMP0EN |Tamper0 Detect Enable Bit + * | | |0 = Tamper 0 detect Disabled. + * | | |1 = Tamper 0 detect Enabled. + * | | |Note1: The reference is RTC-clock . Tamper detector need sync 2 ~ 3 RTC-clock. + * |[9] |TAMP0LV |Tamper 0 Level + * | | |This bit depend on level attribute of tamper pin for static tamper detection. + * | | |0 = Detect voltage level is low. + * | | |1 = Detect voltage level is high. + * |[10] |TAMP0DBEN |Tamper 0 De-bounce Enable Bit + * | | |0 = Tamper 0 de-bounce Disabled. + * | | |1 = Tamper 0 de-bounce Enabled. + * |[12] |TAMP1EN |Tamper 1 Detect Enable Bit + * | | |0 = Tamper 1 detect Disabled. + * | | |1 = Tamper 1 detect Enabled. + * | | |Note1: The reference is RTC-clock . Tamper detector need sync 2 ~ 3 RTC-clock. + * |[13] |TAMP1LV |Tamper 1 Level + * | | |This bit depend on level attribute of tamper pin for static tamper detection. + * | | |0 = Detect voltage level is low. + * | | |1 = Detect voltage level is high. + * |[14] |TAMP1DBEN |Tamper 1 De-bounce Enable Bit + * | | |0 = Tamper 1 de-bounce Disabled. + * | | |1 = Tamper 1 de-bounce Enabled. + * |[15] |DYNPR0EN |Dynamic Pair 0 Enable Bit + * | | |0 = Static detect. + * | | |1 = Dynamic detect. + * |[16] |TAMP2EN |Tamper 2 Detect Enable Bit + * | | |0 = Tamper 2 detect Disabled. + * | | |1 = Tamper 2 detect Enabled. + * | | |Note1: The reference is RTC-clock . Tamper detector need sync 2 ~ 3 RTC-clock. + * |[17] |TAMP2LV |Tamper 2 Level + * | | |This bit depend on level attribute of tamper pin for static tamper detection. + * | | |0 = Detect voltage level is low. + * | | |1 = Detect voltage level is high. + * |[18] |TAMP2DBEN |Tamper 2 De-bounce Enable Bit + * | | |0 = Tamper 2 de-bounce Disabled. + * | | |1 = Tamper 2 de-bounce Enabled. + * |[20] |TAMP3EN |Tamper 3 Detect Enable Bit + * | | |0 = Tamper 3 detect Disabled. + * | | |1 = Tamper 3 detect Enabled. + * | | |Note1: The reference is RTC-clock . Tamper detector need sync 2 ~ 3 RTC-clock. + * |[21] |TAMP3LV |Tamper 3 Level + * | | |This bit depend on level attribute of tamper pin for static tamper detection. + * | | |0 = Detect voltage level is low. + * | | |1 = Detect voltage level is high. + * |[22] |TAMP3DBEN |Tamper 3 De-bounce Enable Bit + * | | |0 = Tamper 3 de-bounce Disabled. + * | | |1 = Tamper 3 de-bounce Enabled. + * |[23] |DYNPR1EN |Dynamic Pair 1 Enable Bit + * | | |0 = Static detect. + * | | |1 = Dynamic detect. + * |[24] |TAMP4EN |Tamper4 Detect Enable Bit + * | | |0 = Tamper 4 detect Disabled. + * | | |1 = Tamper 4 detect Enabled. + * | | |Note1: The reference is RTC-clock . Tamper detector need sync 2 ~ 3 RTC-clock. + * |[25] |TAMP4LV |Tamper 4 Level + * | | |This bit depends on level attribute of tamper pin for static tamper detection. + * | | |0 = Detect voltage level is low. + * | | |1 = Detect voltage level is high. + * |[26] |TAMP4DBEN |Tamper 4 De-bounce Enable Bit + * | | |0 = Tamper 4 de-bounce Disabled. + * | | |1 = Tamper 4 de-bounce Enabled. + * |[28] |TAMP5EN |Tamper 5 Detect Enable Bit + * | | |0 = Tamper 5 detect Disabled. + * | | |1 = Tamper 5 detect Enabled. + * | | |Note1: The reference is RTC-clock . Tamper detector need sync 2 ~ 3 RTC-clock. + * |[29] |TAMP5LV |Tamper 5 Level + * | | |This bit depend on level attribute of tamper pin for static tamper detection. + * | | |0 = Detect voltage level is low. + * | | |1 = Detect voltage level is high. + * |[30] |TAMP5DBEN |Tamper 5 De-bounce Enable Bit + * | | |0 = Tamper 5 de-bounce Disabled. + * | | |1 = Tamper 5 de-bounce Enabled. + * |[31] |DYNPR2EN |Dynamic Pair 2 Enable Bit + * | | |0 = Static detect. + * | | |1 = Dynamic detect. + * @var RTC_T::TAMPSEED + * Offset: 0x128 RTC Tamper Dynamic Seed Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |SEED |Seed Value + * @var RTC_T::TAMPTIME + * Offset: 0x130 RTC Tamper Time Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |SEC |1-Sec Time Digit of TAMPER Time (0~9) + * |[6:4] |TENSEC |10-Sec Time Digit of TAMPER Time (0~5) + * |[11:8] |MIN |1-Min Time Digit of TAMPER Time (0~9) + * |[14:12] |TENMIN |10-Min Time Digit of TAMPER Time (0~5) + * |[19:16] |HR |1-Hour Time Digit of TAMPER Time (0~9) + * |[21:20] |TENHR |10-Hour Time Digit of TAMPER Time (0~2) + * | | |Note: 24-hour time scale only. + * @var RTC_T::TAMPCAL + * Offset: 0x134 RTC Tamper Calendar Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |DAY |1-Day Calendar Digit of TAMPER Calendar (0~9) + * |[5:4] |TENDAY |10-Day Calendar Digit of TAMPER Calendar (0~3) + * |[11:8] |MON |1-Month Calendar Digit of TAMPER Calendar (0~9) + * |[12] |TENMON |10-Month Calendar Digit of TAMPER Calendar (0~1) + * |[19:16] |YEAR |1-Year Calendar Digit of TAMPER Calendar (0~9) + * |[23:20] |TENYEAR |10-Year Calendar Digit of TAMPER Calendar (0~9) + */ + __IO uint32_t INIT; /*!< [0x0000] RTC Initiation Register */ + __IO uint32_t RWEN; /*!< [0x0004] RTC Access Enable Register */ + __IO uint32_t FREQADJ; /*!< [0x0008] RTC Frequency Compensation Register */ + __IO uint32_t TIME; /*!< [0x000c] RTC Time Loading Register */ + __IO uint32_t CAL; /*!< [0x0010] RTC Calendar Loading Register */ + __IO uint32_t CLKFMT; /*!< [0x0014] RTC Time Scale Selection Register */ + __IO uint32_t WEEKDAY; /*!< [0x0018] RTC Day of the Week Register */ + __IO uint32_t TALM; /*!< [0x001c] RTC Time Alarm Register */ + __IO uint32_t CALM; /*!< [0x0020] RTC Calendar Alarm Register */ + __I uint32_t LEAPYEAR; /*!< [0x0024] RTC Leap Year Indicator Register */ + __IO uint32_t INTEN; /*!< [0x0028] RTC Interrupt Enable Register */ + __IO uint32_t INTSTS; /*!< [0x002c] RTC Interrupt Status Register */ + __IO uint32_t TICK; /*!< [0x0030] RTC Time Tick Register */ + __IO uint32_t TAMSK; /*!< [0x0034] RTC Time Alarm Mask Register */ + __IO uint32_t CAMSK; /*!< [0x0038] RTC Calendar Alarm Mask Register */ + __IO uint32_t SPRCTL; /*!< [0x003c] RTC Spare Functional Control Register */ + __IO uint32_t SPR[20]; /*!< [0x0040] ~ [0x008c] RTC Spare Register 0 ~ 19 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[28]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t LXTCTL; /*!< [0x0100] RTC 32.768 kHz Oscillator Control Register */ + __IO uint32_t GPIOCTL0; /*!< [0x0104] RTC GPIO Control 0 Register */ + __IO uint32_t GPIOCTL1; /*!< [0x0108] RTC GPIO Control 1 Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE1[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t DSTCTL; /*!< [0x0110] RTC Daylight Saving Time Control Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE2[3]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t TAMPCTL; /*!< [0x0120] RTC Tamper Pin Control Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE3[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t TAMPSEED; /*!< [0x0128] RTC Tamper Dynamic Seed Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE4[1]; + /// @endcond //HIDDEN_SYMBOLS + __I uint32_t TAMPTIME; /*!< [0x0130] RTC Tamper Time Register */ + __I uint32_t TAMPCAL; /*!< [0x0134] RTC Tamper Calendar Register */ + +} RTC_T; + +/** + @addtogroup RTC_CONST RTC Bit Field Definition + Constant Definitions for RTC Controller +@{ */ + +#define RTC_INIT_ACTIVE_Pos (0) /*!< RTC_T::INIT: INIT_ACTIVE Position */ +#define RTC_INIT_ACTIVE_Msk (0x1ul << RTC_INIT_ACTIVE_Pos) /*!< RTC_T::INIT: INIT_ACTIVE Mask */ + +#define RTC_INIT_INIT_Pos (1) /*!< RTC_T::INIT: INIT Position */ +#define RTC_INIT_INIT_Msk (0x7ffffffful << RTC_INIT_INIT_Pos) /*!< RTC_T::INIT: INIT Mask */ + +#define RTC_RWEN_RWENF_Pos (16) /*!< RTC_T::RWEN: RWENF Position */ +#define RTC_RWEN_RWENF_Msk (0x1ul << RTC_RWEN_RWENF_Pos) /*!< RTC_T::RWEN: RWENF Mask */ + +#define RTC_RWEN_RTCBUSY_Pos (24) /*!< RTC_T::RWEN: RTCBUSY Position */ +#define RTC_RWEN_RTCBUSY_Msk (0x1ul << RTC_RWEN_RTCBUSY_Pos) /*!< RTC_T::RWEN: RTCBUSY Mask */ + +#define RTC_FREQADJ_FREQADJ_Pos (0) /*!< RTC_T::FREQADJ: FREQADJ Position */ +#define RTC_FREQADJ_FREQADJ_Msk (0x3ffffful << RTC_FREQADJ_FREQADJ_Pos) /*!< RTC_T::FREQADJ: FREQADJ Mask */ + +#define RTC_FREQADJ_FRACTION_Pos (0) /*!< RTC_T::FREQADJ: FRACTION Position */ +#define RTC_FREQADJ_FRACTION_Msk (0x3ful << RTC_FREQADJ_FRACTION_Pos) /*!< RTC_T::FREQADJ: FRACTION Mask */ + +#define RTC_FREQADJ_INTEGER_Pos (8) /*!< RTC_T::FREQADJ: INTEGER Position */ +#define RTC_FREQADJ_INTEGER_Msk (0x1ful << RTC_FREQADJ_INTEGER_Pos) /*!< RTC_T::FREQADJ: INTEGER Mask */ + +#define RTC_FREQADJ_FCR_BUSY_Pos (31) /*!< RTC_T::FREQADJ: FCR_BUSY Position */ +#define RTC_FREQADJ_FCR_BUSY_Msk (0x1ul << RTC_FREQADJ_FCR_BUSY_Pos) /*!< RTC_T::FREQADJ: FCR_BUSY Mask */ + +#define RTC_TIME_SEC_Pos (0) /*!< RTC_T::TIME: SEC Position */ +#define RTC_TIME_SEC_Msk (0xful << RTC_TIME_SEC_Pos) /*!< RTC_T::TIME: SEC Mask */ + +#define RTC_TIME_TENSEC_Pos (4) /*!< RTC_T::TIME: TENSEC Position */ +#define RTC_TIME_TENSEC_Msk (0x7ul << RTC_TIME_TENSEC_Pos) /*!< RTC_T::TIME: TENSEC Mask */ + +#define RTC_TIME_MIN_Pos (8) /*!< RTC_T::TIME: MIN Position */ +#define RTC_TIME_MIN_Msk (0xful << RTC_TIME_MIN_Pos) /*!< RTC_T::TIME: MIN Mask */ + +#define RTC_TIME_TENMIN_Pos (12) /*!< RTC_T::TIME: TENMIN Position */ +#define RTC_TIME_TENMIN_Msk (0x7ul << RTC_TIME_TENMIN_Pos) /*!< RTC_T::TIME: TENMIN Mask */ + +#define RTC_TIME_HR_Pos (16) /*!< RTC_T::TIME: HR Position */ +#define RTC_TIME_HR_Msk (0xful << RTC_TIME_HR_Pos) /*!< RTC_T::TIME: HR Mask */ + +#define RTC_TIME_TENHR_Pos (20) /*!< RTC_T::TIME: TENHR Position */ +#define RTC_TIME_TENHR_Msk (0x3ul << RTC_TIME_TENHR_Pos) /*!< RTC_T::TIME: TENHR Mask */ + +#define RTC_CAL_DAY_Pos (0) /*!< RTC_T::CAL: DAY Position */ +#define RTC_CAL_DAY_Msk (0xful << RTC_CAL_DAY_Pos) /*!< RTC_T::CAL: DAY Mask */ + +#define RTC_CAL_TENDAY_Pos (4) /*!< RTC_T::CAL: TENDAY Position */ +#define RTC_CAL_TENDAY_Msk (0x3ul << RTC_CAL_TENDAY_Pos) /*!< RTC_T::CAL: TENDAY Mask */ + +#define RTC_CAL_MON_Pos (8) /*!< RTC_T::CAL: MON Position */ +#define RTC_CAL_MON_Msk (0xful << RTC_CAL_MON_Pos) /*!< RTC_T::CAL: MON Mask */ + +#define RTC_CAL_TENMON_Pos (12) /*!< RTC_T::CAL: TENMON Position */ +#define RTC_CAL_TENMON_Msk (0x1ul << RTC_CAL_TENMON_Pos) /*!< RTC_T::CAL: TENMON Mask */ + +#define RTC_CAL_YEAR_Pos (16) /*!< RTC_T::CAL: YEAR Position */ +#define RTC_CAL_YEAR_Msk (0xful << RTC_CAL_YEAR_Pos) /*!< RTC_T::CAL: YEAR Mask */ + +#define RTC_CAL_TENYEAR_Pos (20) /*!< RTC_T::CAL: TENYEAR Position */ +#define RTC_CAL_TENYEAR_Msk (0xful << RTC_CAL_TENYEAR_Pos) /*!< RTC_T::CAL: TENYEAR Mask */ + +#define RTC_CLKFMT_24HEN_Pos (0) /*!< RTC_T::CLKFMT: 24HEN Position */ +#define RTC_CLKFMT_24HEN_Msk (0x1ul << RTC_CLKFMT_24HEN_Pos) /*!< RTC_T::CLKFMT: 24HEN Mask */ + +#define RTC_WEEKDAY_WEEKDAY_Pos (0) /*!< RTC_T::WEEKDAY: WEEKDAY Position */ +#define RTC_WEEKDAY_WEEKDAY_Msk (0x7ul << RTC_WEEKDAY_WEEKDAY_Pos) /*!< RTC_T::WEEKDAY: WEEKDAY Mask */ + +#define RTC_TALM_SEC_Pos (0) /*!< RTC_T::TALM: SEC Position */ +#define RTC_TALM_SEC_Msk (0xful << RTC_TALM_SEC_Pos) /*!< RTC_T::TALM: SEC Mask */ + +#define RTC_TALM_TENSEC_Pos (4) /*!< RTC_T::TALM: TENSEC Position */ +#define RTC_TALM_TENSEC_Msk (0x7ul << RTC_TALM_TENSEC_Pos) /*!< RTC_T::TALM: TENSEC Mask */ + +#define RTC_TALM_MIN_Pos (8) /*!< RTC_T::TALM: MIN Position */ +#define RTC_TALM_MIN_Msk (0xful << RTC_TALM_MIN_Pos) /*!< RTC_T::TALM: MIN Mask */ + +#define RTC_TALM_TENMIN_Pos (12) /*!< RTC_T::TALM: TENMIN Position */ +#define RTC_TALM_TENMIN_Msk (0x7ul << RTC_TALM_TENMIN_Pos) /*!< RTC_T::TALM: TENMIN Mask */ + +#define RTC_TALM_HR_Pos (16) /*!< RTC_T::TALM: HR Position */ +#define RTC_TALM_HR_Msk (0xful << RTC_TALM_HR_Pos) /*!< RTC_T::TALM: HR Mask */ + +#define RTC_TALM_TENHR_Pos (20) /*!< RTC_T::TALM: TENHR Position */ +#define RTC_TALM_TENHR_Msk (0x3ul << RTC_TALM_TENHR_Pos) /*!< RTC_T::TALM: TENHR Mask */ + +#define RTC_CALM_DAY_Pos (0) /*!< RTC_T::CALM: DAY Position */ +#define RTC_CALM_DAY_Msk (0xful << RTC_CALM_DAY_Pos) /*!< RTC_T::CALM: DAY Mask */ + +#define RTC_CALM_TENDAY_Pos (4) /*!< RTC_T::CALM: TENDAY Position */ +#define RTC_CALM_TENDAY_Msk (0x3ul << RTC_CALM_TENDAY_Pos) /*!< RTC_T::CALM: TENDAY Mask */ + +#define RTC_CALM_MON_Pos (8) /*!< RTC_T::CALM: MON Position */ +#define RTC_CALM_MON_Msk (0xful << RTC_CALM_MON_Pos) /*!< RTC_T::CALM: MON Mask */ + +#define RTC_CALM_TENMON_Pos (12) /*!< RTC_T::CALM: TENMON Position */ +#define RTC_CALM_TENMON_Msk (0x1ul << RTC_CALM_TENMON_Pos) /*!< RTC_T::CALM: TENMON Mask */ + +#define RTC_CALM_YEAR_Pos (16) /*!< RTC_T::CALM: YEAR Position */ +#define RTC_CALM_YEAR_Msk (0xful << RTC_CALM_YEAR_Pos) /*!< RTC_T::CALM: YEAR Mask */ + +#define RTC_CALM_TENYEAR_Pos (20) /*!< RTC_T::CALM: TENYEAR Position */ +#define RTC_CALM_TENYEAR_Msk (0xful << RTC_CALM_TENYEAR_Pos) /*!< RTC_T::CALM: TENYEAR Mask */ + +#define RTC_LEAPYEAR_LEAPYEAR_Pos (0) /*!< RTC_T::LEAPYEAR: LEAPYEAR Position */ +#define RTC_LEAPYEAR_LEAPYEAR_Msk (0x1ul << RTC_LEAPYEAR_LEAPYEAR_Pos) /*!< RTC_T::LEAPYEAR: LEAPYEAR Mask */ + +#define RTC_INTEN_ALMIEN_Pos (0) /*!< RTC_T::INTEN: ALMIEN Position */ +#define RTC_INTEN_ALMIEN_Msk (0x1ul << RTC_INTEN_ALMIEN_Pos) /*!< RTC_T::INTEN: ALMIEN Mask */ + +#define RTC_INTEN_TICKIEN_Pos (1) /*!< RTC_T::INTEN: TICKIEN Position */ +#define RTC_INTEN_TICKIEN_Msk (0x1ul << RTC_INTEN_TICKIEN_Pos) /*!< RTC_T::INTEN: TICKIEN Mask */ + +#define RTC_INTEN_TAMP0IEN_Pos (8) /*!< RTC_T::INTEN: TAMP0IEN Position */ +#define RTC_INTEN_TAMP0IEN_Msk (0x1ul << RTC_INTEN_TAMP0IEN_Pos) /*!< RTC_T::INTEN: TAMP0IEN Mask */ + +#define RTC_INTEN_TAMP1IEN_Pos (9) /*!< RTC_T::INTEN: TAMP1IEN Position */ +#define RTC_INTEN_TAMP1IEN_Msk (0x1ul << RTC_INTEN_TAMP1IEN_Pos) /*!< RTC_T::INTEN: TAMP1IEN Mask */ + +#define RTC_INTEN_TAMP2IEN_Pos (10) /*!< RTC_T::INTEN: TAMP2IEN Position */ +#define RTC_INTEN_TAMP2IEN_Msk (0x1ul << RTC_INTEN_TAMP2IEN_Pos) /*!< RTC_T::INTEN: TAMP2IEN Mask */ + +#define RTC_INTEN_TAMP3IEN_Pos (11) /*!< RTC_T::INTEN: TAMP3IEN Position */ +#define RTC_INTEN_TAMP3IEN_Msk (0x1ul << RTC_INTEN_TAMP3IEN_Pos) /*!< RTC_T::INTEN: TAMP3IEN Mask */ + +#define RTC_INTEN_TAMP4IEN_Pos (12) /*!< RTC_T::INTEN: TAMP4IEN Position */ +#define RTC_INTEN_TAMP4IEN_Msk (0x1ul << RTC_INTEN_TAMP4IEN_Pos) /*!< RTC_T::INTEN: TAMP4IEN Mask */ + +#define RTC_INTEN_TAMP5IEN_Pos (13) /*!< RTC_T::INTEN: TAMP5IEN Position */ +#define RTC_INTEN_TAMP5IEN_Msk (0x1ul << RTC_INTEN_TAMP5IEN_Pos) /*!< RTC_T::INTEN: TAMP5IEN Mask */ + +#define RTC_INTSTS_ALMIF_Pos (0) /*!< RTC_T::INTSTS: ALMIF Position */ +#define RTC_INTSTS_ALMIF_Msk (0x1ul << RTC_INTSTS_ALMIF_Pos) /*!< RTC_T::INTSTS: ALMIF Mask */ + +#define RTC_INTSTS_TICKIF_Pos (1) /*!< RTC_T::INTSTS: TICKIF Position */ +#define RTC_INTSTS_TICKIF_Msk (0x1ul << RTC_INTSTS_TICKIF_Pos) /*!< RTC_T::INTSTS: TICKIF Mask */ + +#define RTC_INTSTS_TAMP0IF_Pos (8) /*!< RTC_T::INTSTS: TAMP0IF Position */ +#define RTC_INTSTS_TAMP0IF_Msk (0x1ul << RTC_INTSTS_TAMP0IF_Pos) /*!< RTC_T::INTSTS: TAMP0IF Mask */ + +#define RTC_INTSTS_TAMP1IF_Pos (9) /*!< RTC_T::INTSTS: TAMP1IF Position */ +#define RTC_INTSTS_TAMP1IF_Msk (0x1ul << RTC_INTSTS_TAMP1IF_Pos) /*!< RTC_T::INTSTS: TAMP1IF Mask */ + +#define RTC_INTSTS_TAMP2IF_Pos (10) /*!< RTC_T::INTSTS: TAMP2IF Position */ +#define RTC_INTSTS_TAMP2IF_Msk (0x1ul << RTC_INTSTS_TAMP2IF_Pos) /*!< RTC_T::INTSTS: TAMP2IF Mask */ + +#define RTC_INTSTS_TAMP3IF_Pos (11) /*!< RTC_T::INTSTS: TAMP3IF Position */ +#define RTC_INTSTS_TAMP3IF_Msk (0x1ul << RTC_INTSTS_TAMP3IF_Pos) /*!< RTC_T::INTSTS: TAMP3IF Mask */ + +#define RTC_INTSTS_TAMP4IF_Pos (12) /*!< RTC_T::INTSTS: TAMP4IF Position */ +#define RTC_INTSTS_TAMP4IF_Msk (0x1ul << RTC_INTSTS_TAMP4IF_Pos) /*!< RTC_T::INTSTS: TAMP4IF Mask */ + +#define RTC_INTSTS_TAMP5IF_Pos (13) /*!< RTC_T::INTSTS: TAMP5IF Position */ +#define RTC_INTSTS_TAMP5IF_Msk (0x1ul << RTC_INTSTS_TAMP5IF_Pos) /*!< RTC_T::INTSTS: TAMP5IF Mask */ + +#define RTC_TICK_TICK_Pos (0) /*!< RTC_T::TICK: TICK Position */ +#define RTC_TICK_TICK_Msk (0x7ul << RTC_TICK_TICK_Pos) /*!< RTC_T::TICK: TICK Mask */ + +#define RTC_TAMSK_MSEC_Pos (0) /*!< RTC_T::TAMSK: MSEC Position */ +#define RTC_TAMSK_MSEC_Msk (0x1ul << RTC_TAMSK_MSEC_Pos) /*!< RTC_T::TAMSK: MSEC Mask */ + +#define RTC_TAMSK_MTENSEC_Pos (1) /*!< RTC_T::TAMSK: MTENSEC Position */ +#define RTC_TAMSK_MTENSEC_Msk (0x1ul << RTC_TAMSK_MTENSEC_Pos) /*!< RTC_T::TAMSK: MTENSEC Mask */ + +#define RTC_TAMSK_MMIN_Pos (2) /*!< RTC_T::TAMSK: MMIN Position */ +#define RTC_TAMSK_MMIN_Msk (0x1ul << RTC_TAMSK_MMIN_Pos) /*!< RTC_T::TAMSK: MMIN Mask */ + +#define RTC_TAMSK_MTENMIN_Pos (3) /*!< RTC_T::TAMSK: MTENMIN Position */ +#define RTC_TAMSK_MTENMIN_Msk (0x1ul << RTC_TAMSK_MTENMIN_Pos) /*!< RTC_T::TAMSK: MTENMIN Mask */ + +#define RTC_TAMSK_MHR_Pos (4) /*!< RTC_T::TAMSK: MHR Position */ +#define RTC_TAMSK_MHR_Msk (0x1ul << RTC_TAMSK_MHR_Pos) /*!< RTC_T::TAMSK: MHR Mask */ + +#define RTC_TAMSK_MTENHR_Pos (5) /*!< RTC_T::TAMSK: MTENHR Position */ +#define RTC_TAMSK_MTENHR_Msk (0x1ul << RTC_TAMSK_MTENHR_Pos) /*!< RTC_T::TAMSK: MTENHR Mask */ + +#define RTC_CAMSK_MDAY_Pos (0) /*!< RTC_T::CAMSK: MDAY Position */ +#define RTC_CAMSK_MDAY_Msk (0x1ul << RTC_CAMSK_MDAY_Pos) /*!< RTC_T::CAMSK: MDAY Mask */ + +#define RTC_CAMSK_MTENDAY_Pos (1) /*!< RTC_T::CAMSK: MTENDAY Position */ +#define RTC_CAMSK_MTENDAY_Msk (0x1ul << RTC_CAMSK_MTENDAY_Pos) /*!< RTC_T::CAMSK: MTENDAY Mask */ + +#define RTC_CAMSK_MMON_Pos (2) /*!< RTC_T::CAMSK: MMON Position */ +#define RTC_CAMSK_MMON_Msk (0x1ul << RTC_CAMSK_MMON_Pos) /*!< RTC_T::CAMSK: MMON Mask */ + +#define RTC_CAMSK_MTENMON_Pos (3) /*!< RTC_T::CAMSK: MTENMON Position */ +#define RTC_CAMSK_MTENMON_Msk (0x1ul << RTC_CAMSK_MTENMON_Pos) /*!< RTC_T::CAMSK: MTENMON Mask */ + +#define RTC_CAMSK_MYEAR_Pos (4) /*!< RTC_T::CAMSK: MYEAR Position */ +#define RTC_CAMSK_MYEAR_Msk (0x1ul << RTC_CAMSK_MYEAR_Pos) /*!< RTC_T::CAMSK: MYEAR Mask */ + +#define RTC_CAMSK_MTENYEAR_Pos (5) /*!< RTC_T::CAMSK: MTENYEAR Position */ +#define RTC_CAMSK_MTENYEAR_Msk (0x1ul << RTC_CAMSK_MTENYEAR_Pos) /*!< RTC_T::CAMSK: MTENYEAR Mask */ + +#define RTC_SPRCTL_SPRRWEN_Pos (2) /*!< RTC_T::SPRCTL: SPRRWEN Position */ +#define RTC_SPRCTL_SPRRWEN_Msk (0x1ul << RTC_SPRCTL_SPRRWEN_Pos) /*!< RTC_T::SPRCTL: SPRRWEN Mask */ + +#define RTC_SPRCTL_SPRCSTS_Pos (5) /*!< RTC_T::SPRCTL: SPRCSTS Position */ +#define RTC_SPRCTL_SPRCSTS_Msk (0x1ul << RTC_SPRCTL_SPRCSTS_Pos) /*!< RTC_T::SPRCTL: SPRCSTS Mask */ + +#define RTC_SPR0_SPARE_Pos (0) /*!< RTC_T::SPR0: SPARE Position */ +#define RTC_SPR0_SPARE_Msk (0xfffffffful << RTC_SPR0_SPARE_Pos) /*!< RTC_T::SPR0: SPARE Mask */ + +#define RTC_SPR1_SPARE_Pos (0) /*!< RTC_T::SPR1: SPARE Position */ +#define RTC_SPR1_SPARE_Msk (0xfffffffful << RTC_SPR1_SPARE_Pos) /*!< RTC_T::SPR1: SPARE Mask */ + +#define RTC_SPR2_SPARE_Pos (0) /*!< RTC_T::SPR2: SPARE Position */ +#define RTC_SPR2_SPARE_Msk (0xfffffffful << RTC_SPR2_SPARE_Pos) /*!< RTC_T::SPR2: SPARE Mask */ + +#define RTC_SPR3_SPARE_Pos (0) /*!< RTC_T::SPR3: SPARE Position */ +#define RTC_SPR3_SPARE_Msk (0xfffffffful << RTC_SPR3_SPARE_Pos) /*!< RTC_T::SPR3: SPARE Mask */ + +#define RTC_SPR4_SPARE_Pos (0) /*!< RTC_T::SPR4: SPARE Position */ +#define RTC_SPR4_SPARE_Msk (0xfffffffful << RTC_SPR4_SPARE_Pos) /*!< RTC_T::SPR4: SPARE Mask */ + +#define RTC_SPR5_SPARE_Pos (0) /*!< RTC_T::SPR5: SPARE Position */ +#define RTC_SPR5_SPARE_Msk (0xfffffffful << RTC_SPR5_SPARE_Pos) /*!< RTC_T::SPR5: SPARE Mask */ + +#define RTC_SPR6_SPARE_Pos (0) /*!< RTC_T::SPR6: SPARE Position */ +#define RTC_SPR6_SPARE_Msk (0xfffffffful << RTC_SPR6_SPARE_Pos) /*!< RTC_T::SPR6: SPARE Mask */ + +#define RTC_SPR7_SPARE_Pos (0) /*!< RTC_T::SPR7: SPARE Position */ +#define RTC_SPR7_SPARE_Msk (0xfffffffful << RTC_SPR7_SPARE_Pos) /*!< RTC_T::SPR7: SPARE Mask */ + +#define RTC_SPR8_SPARE_Pos (0) /*!< RTC_T::SPR8: SPARE Position */ +#define RTC_SPR8_SPARE_Msk (0xfffffffful << RTC_SPR8_SPARE_Pos) /*!< RTC_T::SPR8: SPARE Mask */ + +#define RTC_SPR9_SPARE_Pos (0) /*!< RTC_T::SPR9: SPARE Position */ +#define RTC_SPR9_SPARE_Msk (0xfffffffful << RTC_SPR9_SPARE_Pos) /*!< RTC_T::SPR9: SPARE Mask */ + +#define RTC_SPR10_SPARE_Pos (0) /*!< RTC_T::SPR10: SPARE Position */ +#define RTC_SPR10_SPARE_Msk (0xfffffffful << RTC_SPR10_SPARE_Pos) /*!< RTC_T::SPR10: SPARE Mask */ + +#define RTC_SPR11_SPARE_Pos (0) /*!< RTC_T::SPR11: SPARE Position */ +#define RTC_SPR11_SPARE_Msk (0xfffffffful << RTC_SPR11_SPARE_Pos) /*!< RTC_T::SPR11: SPARE Mask */ + +#define RTC_SPR12_SPARE_Pos (0) /*!< RTC_T::SPR12: SPARE Position */ +#define RTC_SPR12_SPARE_Msk (0xfffffffful << RTC_SPR12_SPARE_Pos) /*!< RTC_T::SPR12: SPARE Mask */ + +#define RTC_SPR13_SPARE_Pos (0) /*!< RTC_T::SPR13: SPARE Position */ +#define RTC_SPR13_SPARE_Msk (0xfffffffful << RTC_SPR13_SPARE_Pos) /*!< RTC_T::SPR13: SPARE Mask */ + +#define RTC_SPR14_SPARE_Pos (0) /*!< RTC_T::SPR14: SPARE Position */ +#define RTC_SPR14_SPARE_Msk (0xfffffffful << RTC_SPR14_SPARE_Pos) /*!< RTC_T::SPR14: SPARE Mask */ + +#define RTC_SPR15_SPARE_Pos (0) /*!< RTC_T::SPR15: SPARE Position */ +#define RTC_SPR15_SPARE_Msk (0xfffffffful << RTC_SPR15_SPARE_Pos) /*!< RTC_T::SPR15: SPARE Mask */ + +#define RTC_SPR16_SPARE_Pos (0) /*!< RTC_T::SPR16: SPARE Position */ +#define RTC_SPR16_SPARE_Msk (0xfffffffful << RTC_SPR16_SPARE_Pos) /*!< RTC_T::SPR16: SPARE Mask */ + +#define RTC_SPR17_SPARE_Pos (0) /*!< RTC_T::SPR17: SPARE Position */ +#define RTC_SPR17_SPARE_Msk (0xfffffffful << RTC_SPR17_SPARE_Pos) /*!< RTC_T::SPR17: SPARE Mask */ + +#define RTC_SPR18_SPARE_Pos (0) /*!< RTC_T::SPR18: SPARE Position */ +#define RTC_SPR18_SPARE_Msk (0xfffffffful << RTC_SPR18_SPARE_Pos) /*!< RTC_T::SPR18: SPARE Mask */ + +#define RTC_SPR19_SPARE_Pos (0) /*!< RTC_T::SPR19: SPARE Position */ +#define RTC_SPR19_SPARE_Msk (0xfffffffful << RTC_SPR19_SPARE_Pos) /*!< RTC_T::SPR19: SPARE Mask */ + +#define RTC_LXTCTL_GAIN_Pos (1) /*!< RTC_T::LXTCTL: GAIN Position */ +#define RTC_LXTCTL_GAIN_Msk (0x3ul << RTC_LXTCTL_GAIN_Pos) /*!< RTC_T::LXTCTL: GAIN Mask */ + +#define RTC_GPIOCTL0_OPMODE0_Pos (0) /*!< RTC_T::GPIOCTL0: OPMODE0 Position */ +#define RTC_GPIOCTL0_OPMODE0_Msk (0x3ul << RTC_GPIOCTL0_OPMODE0_Pos) /*!< RTC_T::GPIOCTL0: OPMODE0 Mask */ + +#define RTC_GPIOCTL0_DOUT0_Pos (2) /*!< RTC_T::GPIOCTL0: DOUT0 Position */ +#define RTC_GPIOCTL0_DOUT0_Msk (0x1ul << RTC_GPIOCTL0_DOUT0_Pos) /*!< RTC_T::GPIOCTL0: DOUT0 Mask */ + +#define RTC_GPIOCTL0_CTLSEL0_Pos (3) /*!< RTC_T::GPIOCTL0: CTLSEL0 Position */ +#define RTC_GPIOCTL0_CTLSEL0_Msk (0x1ul << RTC_GPIOCTL0_CTLSEL0_Pos) /*!< RTC_T::GPIOCTL0: CTLSEL0 Mask */ + +#define RTC_GPIOCTL0_PUSEL0_Pos (4) /*!< RTC_T::GPIOCTL0: PUSEL0 Position */ +#define RTC_GPIOCTL0_PUSEL0_Msk (0x3ul << RTC_GPIOCTL0_PUSEL0_Pos) /*!< RTC_T::GPIOCTL0: PUSEL0 Mask */ + +#define RTC_GPIOCTL0_OPMODE1_Pos (8) /*!< RTC_T::GPIOCTL0: OPMODE1 Position */ +#define RTC_GPIOCTL0_OPMODE1_Msk (0x3ul << RTC_GPIOCTL0_OPMODE1_Pos) /*!< RTC_T::GPIOCTL0: OPMODE1 Mask */ + +#define RTC_GPIOCTL0_DOUT1_Pos (10) /*!< RTC_T::GPIOCTL0: DOUT1 Position */ +#define RTC_GPIOCTL0_DOUT1_Msk (0x1ul << RTC_GPIOCTL0_DOUT1_Pos) /*!< RTC_T::GPIOCTL0: DOUT1 Mask */ + +#define RTC_GPIOCTL0_CTLSEL1_Pos (11) /*!< RTC_T::GPIOCTL0: CTLSEL1 Position */ +#define RTC_GPIOCTL0_CTLSEL1_Msk (0x1ul << RTC_GPIOCTL0_CTLSEL1_Pos) /*!< RTC_T::GPIOCTL0: CTLSEL1 Mask */ + +#define RTC_GPIOCTL0_PUSEL1_Pos (12) /*!< RTC_T::GPIOCTL0: PUSEL1 Position */ +#define RTC_GPIOCTL0_PUSEL1_Msk (0x3ul << RTC_GPIOCTL0_PUSEL1_Pos) /*!< RTC_T::GPIOCTL0: PUSEL1 Mask */ + +#define RTC_GPIOCTL0_OPMODE2_Pos (16) /*!< RTC_T::GPIOCTL0: OPMODE2 Position */ +#define RTC_GPIOCTL0_OPMODE2_Msk (0x3ul << RTC_GPIOCTL0_OPMODE2_Pos) /*!< RTC_T::GPIOCTL0: OPMODE2 Mask */ + +#define RTC_GPIOCTL0_DOUT2_Pos (18) /*!< RTC_T::GPIOCTL0: DOUT2 Position */ +#define RTC_GPIOCTL0_DOUT2_Msk (0x1ul << RTC_GPIOCTL0_DOUT2_Pos) /*!< RTC_T::GPIOCTL0: DOUT2 Mask */ + +#define RTC_GPIOCTL0_CTLSEL2_Pos (19) /*!< RTC_T::GPIOCTL0: CTLSEL2 Position */ +#define RTC_GPIOCTL0_CTLSEL2_Msk (0x1ul << RTC_GPIOCTL0_CTLSEL2_Pos) /*!< RTC_T::GPIOCTL0: CTLSEL2 Mask */ + +#define RTC_GPIOCTL0_PUSEL2_Pos (20) /*!< RTC_T::GPIOCTL0: PUSEL2 Position */ +#define RTC_GPIOCTL0_PUSEL2_Msk (0x3ul << RTC_GPIOCTL0_PUSEL2_Pos) /*!< RTC_T::GPIOCTL0: PUSEL2 Mask */ + +#define RTC_GPIOCTL0_OPMODE3_Pos (24) /*!< RTC_T::GPIOCTL0: OPMODE3 Position */ +#define RTC_GPIOCTL0_OPMODE3_Msk (0x3ul << RTC_GPIOCTL0_OPMODE3_Pos) /*!< RTC_T::GPIOCTL0: OPMODE3 Mask */ + +#define RTC_GPIOCTL0_DOUT3_Pos (26) /*!< RTC_T::GPIOCTL0: DOUT3 Position */ +#define RTC_GPIOCTL0_DOUT3_Msk (0x1ul << RTC_GPIOCTL0_DOUT3_Pos) /*!< RTC_T::GPIOCTL0: DOUT3 Mask */ + +#define RTC_GPIOCTL0_CTLSEL3_Pos (27) /*!< RTC_T::GPIOCTL0: CTLSEL3 Position */ +#define RTC_GPIOCTL0_CTLSEL3_Msk (0x1ul << RTC_GPIOCTL0_CTLSEL3_Pos) /*!< RTC_T::GPIOCTL0: CTLSEL3 Mask */ + +#define RTC_GPIOCTL0_PUSEL3_Pos (28) /*!< RTC_T::GPIOCTL0: PUSEL3 Position */ +#define RTC_GPIOCTL0_PUSEL3_Msk (0x3ul << RTC_GPIOCTL0_PUSEL3_Pos) /*!< RTC_T::GPIOCTL0: PUSEL3 Mask */ + +#define RTC_GPIOCTL1_OPMODE4_Pos (0) /*!< RTC_T::GPIOCTL1: OPMODE4 Position */ +#define RTC_GPIOCTL1_OPMODE4_Msk (0x3ul << RTC_GPIOCTL1_OPMODE4_Pos) /*!< RTC_T::GPIOCTL1: OPMODE4 Mask */ + +#define RTC_GPIOCTL1_DOUT4_Pos (2) /*!< RTC_T::GPIOCTL1: DOUT4 Position */ +#define RTC_GPIOCTL1_DOUT4_Msk (0x1ul << RTC_GPIOCTL1_DOUT4_Pos) /*!< RTC_T::GPIOCTL1: DOUT4 Mask */ + +#define RTC_GPIOCTL1_CTLSEL4_Pos (3) /*!< RTC_T::GPIOCTL1: CTLSEL4 Position */ +#define RTC_GPIOCTL1_CTLSEL4_Msk (0x1ul << RTC_GPIOCTL1_CTLSEL4_Pos) /*!< RTC_T::GPIOCTL1: CTLSEL4 Mask */ + +#define RTC_GPIOCTL1_PUSEL4_Pos (4) /*!< RTC_T::GPIOCTL1: PUSEL4 Position */ +#define RTC_GPIOCTL1_PUSEL4_Msk (0x3ul << RTC_GPIOCTL1_PUSEL4_Pos) /*!< RTC_T::GPIOCTL1: PUSEL4 Mask */ + +#define RTC_GPIOCTL1_OPMODE5_Pos (8) /*!< RTC_T::GPIOCTL1: OPMODE5 Position */ +#define RTC_GPIOCTL1_OPMODE5_Msk (0x3ul << RTC_GPIOCTL1_OPMODE5_Pos) /*!< RTC_T::GPIOCTL1: OPMODE5 Mask */ + +#define RTC_GPIOCTL1_DOUT5_Pos (10) /*!< RTC_T::GPIOCTL1: DOUT5 Position */ +#define RTC_GPIOCTL1_DOUT5_Msk (0x1ul << RTC_GPIOCTL1_DOUT5_Pos) /*!< RTC_T::GPIOCTL1: DOUT5 Mask */ + +#define RTC_GPIOCTL1_CTLSEL5_Pos (11) /*!< RTC_T::GPIOCTL1: CTLSEL5 Position */ +#define RTC_GPIOCTL1_CTLSEL5_Msk (0x1ul << RTC_GPIOCTL1_CTLSEL5_Pos) /*!< RTC_T::GPIOCTL1: CTLSEL5 Mask */ + +#define RTC_GPIOCTL1_PUSEL5_Pos (12) /*!< RTC_T::GPIOCTL1: PUSEL5 Position */ +#define RTC_GPIOCTL1_PUSEL5_Msk (0x3ul << RTC_GPIOCTL1_PUSEL5_Pos) /*!< RTC_T::GPIOCTL1: PUSEL5 Mask */ + +#define RTC_GPIOCTL1_OPMODE6_Pos (16) /*!< RTC_T::GPIOCTL1: OPMODE6 Position */ +#define RTC_GPIOCTL1_OPMODE6_Msk (0x3ul << RTC_GPIOCTL1_OPMODE6_Pos) /*!< RTC_T::GPIOCTL1: OPMODE6 Mask */ + +#define RTC_GPIOCTL1_DOUT6_Pos (18) /*!< RTC_T::GPIOCTL1: DOUT6 Position */ +#define RTC_GPIOCTL1_DOUT6_Msk (0x1ul << RTC_GPIOCTL1_DOUT6_Pos) /*!< RTC_T::GPIOCTL1: DOUT6 Mask */ + +#define RTC_GPIOCTL1_CTLSEL6_Pos (19) /*!< RTC_T::GPIOCTL1: CTLSEL6 Position */ +#define RTC_GPIOCTL1_CTLSEL6_Msk (0x1ul << RTC_GPIOCTL1_CTLSEL6_Pos) /*!< RTC_T::GPIOCTL1: CTLSEL6 Mask */ + +#define RTC_GPIOCTL1_PUSEL6_Pos (20) /*!< RTC_T::GPIOCTL1: PUSEL6 Position */ +#define RTC_GPIOCTL1_PUSEL6_Msk (0x3ul << RTC_GPIOCTL1_PUSEL6_Pos) /*!< RTC_T::GPIOCTL1: PUSEL6 Mask */ + +#define RTC_GPIOCTL1_OPMODE7_Pos (24) /*!< RTC_T::GPIOCTL1: OPMODE7 Position */ +#define RTC_GPIOCTL1_OPMODE7_Msk (0x3ul << RTC_GPIOCTL1_OPMODE7_Pos) /*!< RTC_T::GPIOCTL1: OPMODE7 Mask */ + +#define RTC_GPIOCTL1_DOUT7_Pos (26) /*!< RTC_T::GPIOCTL1: DOUT7 Position */ +#define RTC_GPIOCTL1_DOUT7_Msk (0x1ul << RTC_GPIOCTL1_DOUT7_Pos) /*!< RTC_T::GPIOCTL1: DOUT7 Mask */ + +#define RTC_GPIOCTL1_CTLSEL7_Pos (27) /*!< RTC_T::GPIOCTL1: CTLSEL7 Position */ +#define RTC_GPIOCTL1_CTLSEL7_Msk (0x1ul << RTC_GPIOCTL1_CTLSEL7_Pos) /*!< RTC_T::GPIOCTL1: CTLSEL7 Mask */ + +#define RTC_GPIOCTL1_PUSEL7_Pos (28) /*!< RTC_T::GPIOCTL1: PUSEL7 Position */ +#define RTC_GPIOCTL1_PUSEL7_Msk (0x3ul << RTC_GPIOCTL1_PUSEL7_Pos) /*!< RTC_T::GPIOCTL1: PUSEL7 Mask */ + +#define RTC_DSTCTL_ADDHR_Pos (0) /*!< RTC_T::DSTCTL: ADDHR Position */ +#define RTC_DSTCTL_ADDHR_Msk (0x1ul << RTC_DSTCTL_ADDHR_Pos) /*!< RTC_T::DSTCTL: ADDHR Mask */ + +#define RTC_DSTCTL_SUBHR_Pos (1) /*!< RTC_T::DSTCTL: SUBHR Position */ +#define RTC_DSTCTL_SUBHR_Msk (0x1ul << RTC_DSTCTL_SUBHR_Pos) /*!< RTC_T::DSTCTL: SUBHR Mask */ + +#define RTC_DSTCTL_DSBAK_Pos (2) /*!< RTC_T::DSTCTL: DSBAK Position */ +#define RTC_DSTCTL_DSBAK_Msk (0x1ul << RTC_DSTCTL_DSBAK_Pos) /*!< RTC_T::DSTCTL: DSBAK Mask */ + +#define RTC_TAMPCTL_DYN1ISS_Pos (0) /*!< RTC_T::TAMPCTL: DYN1ISS Position */ +#define RTC_TAMPCTL_DYN1ISS_Msk (0x1ul << RTC_TAMPCTL_DYN1ISS_Pos) /*!< RTC_T::TAMPCTL: DYN1ISS Mask */ + +#define RTC_TAMPCTL_DYN2ISS_Pos (1) /*!< RTC_T::TAMPCTL: DYN2ISS Position */ +#define RTC_TAMPCTL_DYN2ISS_Msk (0x1ul << RTC_TAMPCTL_DYN2ISS_Pos) /*!< RTC_T::TAMPCTL: DYN2ISS Mask */ + +#define RTC_TAMPCTL_DYNSRC_Pos (2) /*!< RTC_T::TAMPCTL: DYNSRC Position */ +#define RTC_TAMPCTL_DYNSRC_Msk (0x3ul << RTC_TAMPCTL_DYNSRC_Pos) /*!< RTC_T::TAMPCTL: DYNSRC Mask */ + +#define RTC_TAMPCTL_SEEDRLD_Pos (4) /*!< RTC_T::TAMPCTL: SEEDRLD Position */ +#define RTC_TAMPCTL_SEEDRLD_Msk (0x1ul << RTC_TAMPCTL_SEEDRLD_Pos) /*!< RTC_T::TAMPCTL: SEEDRLD Mask */ + +#define RTC_TAMPCTL_DYNRATE_Pos (5) /*!< RTC_T::TAMPCTL: DYNRATE Position */ +#define RTC_TAMPCTL_DYNRATE_Msk (0x7ul << RTC_TAMPCTL_DYNRATE_Pos) /*!< RTC_T::TAMPCTL: DYNRATE Mask */ + +#define RTC_TAMPCTL_TAMP0EN_Pos (8) /*!< RTC_T::TAMPCTL: TAMP0EN Position */ +#define RTC_TAMPCTL_TAMP0EN_Msk (0x1ul << RTC_TAMPCTL_TAMP0EN_Pos) /*!< RTC_T::TAMPCTL: TAMP0EN Mask */ + +#define RTC_TAMPCTL_TAMP0LV_Pos (9) /*!< RTC_T::TAMPCTL: TAMP0LV Position */ +#define RTC_TAMPCTL_TAMP0LV_Msk (0x1ul << RTC_TAMPCTL_TAMP0LV_Pos) /*!< RTC_T::TAMPCTL: TAMP0LV Mask */ + +#define RTC_TAMPCTL_TAMP0DBEN_Pos (10) /*!< RTC_T::TAMPCTL: TAMP0DBEN Position */ +#define RTC_TAMPCTL_TAMP0DBEN_Msk (0x1ul << RTC_TAMPCTL_TAMP0DBEN_Pos) /*!< RTC_T::TAMPCTL: TAMP0DBEN Mask */ + +#define RTC_TAMPCTL_TAMP1EN_Pos (12) /*!< RTC_T::TAMPCTL: TAMP1EN Position */ +#define RTC_TAMPCTL_TAMP1EN_Msk (0x1ul << RTC_TAMPCTL_TAMP1EN_Pos) /*!< RTC_T::TAMPCTL: TAMP1EN Mask */ + +#define RTC_TAMPCTL_TAMP1LV_Pos (13) /*!< RTC_T::TAMPCTL: TAMP1LV Position */ +#define RTC_TAMPCTL_TAMP1LV_Msk (0x1ul << RTC_TAMPCTL_TAMP1LV_Pos) /*!< RTC_T::TAMPCTL: TAMP1LV Mask */ + +#define RTC_TAMPCTL_TAMP1DBEN_Pos (14) /*!< RTC_T::TAMPCTL: TAMP1DBEN Position */ +#define RTC_TAMPCTL_TAMP1DBEN_Msk (0x1ul << RTC_TAMPCTL_TAMP1DBEN_Pos) /*!< RTC_T::TAMPCTL: TAMP1DBEN Mask */ + +#define RTC_TAMPCTL_DYNPR0EN_Pos (15) /*!< RTC_T::TAMPCTL: DYNPR0EN Position */ +#define RTC_TAMPCTL_DYNPR0EN_Msk (0x1ul << RTC_TAMPCTL_DYNPR0EN_Pos) /*!< RTC_T::TAMPCTL: DYNPR0EN Mask */ + +#define RTC_TAMPCTL_TAMP2EN_Pos (16) /*!< RTC_T::TAMPCTL: TAMP2EN Position */ +#define RTC_TAMPCTL_TAMP2EN_Msk (0x1ul << RTC_TAMPCTL_TAMP2EN_Pos) /*!< RTC_T::TAMPCTL: TAMP2EN Mask */ + +#define RTC_TAMPCTL_TAMP2LV_Pos (17) /*!< RTC_T::TAMPCTL: TAMP2LV Position */ +#define RTC_TAMPCTL_TAMP2LV_Msk (0x1ul << RTC_TAMPCTL_TAMP2LV_Pos) /*!< RTC_T::TAMPCTL: TAMP2LV Mask */ + +#define RTC_TAMPCTL_TAMP2DBEN_Pos (18) /*!< RTC_T::TAMPCTL: TAMP2DBEN Position */ +#define RTC_TAMPCTL_TAMP2DBEN_Msk (0x1ul << RTC_TAMPCTL_TAMP2DBEN_Pos) /*!< RTC_T::TAMPCTL: TAMP2DBEN Mask */ + +#define RTC_TAMPCTL_TAMP3EN_Pos (20) /*!< RTC_T::TAMPCTL: TAMP3EN Position */ +#define RTC_TAMPCTL_TAMP3EN_Msk (0x1ul << RTC_TAMPCTL_TAMP3EN_Pos) /*!< RTC_T::TAMPCTL: TAMP3EN Mask */ + +#define RTC_TAMPCTL_TAMP3LV_Pos (21) /*!< RTC_T::TAMPCTL: TAMP3LV Position */ +#define RTC_TAMPCTL_TAMP3LV_Msk (0x1ul << RTC_TAMPCTL_TAMP3LV_Pos) /*!< RTC_T::TAMPCTL: TAMP3LV Mask */ + +#define RTC_TAMPCTL_TAMP3DBEN_Pos (22) /*!< RTC_T::TAMPCTL: TAMP3DBEN Position */ +#define RTC_TAMPCTL_TAMP3DBEN_Msk (0x1ul << RTC_TAMPCTL_TAMP3DBEN_Pos) /*!< RTC_T::TAMPCTL: TAMP3DBEN Mask */ + +#define RTC_TAMPCTL_DYNPR1EN_Pos (23) /*!< RTC_T::TAMPCTL: DYNPR1EN Position */ +#define RTC_TAMPCTL_DYNPR1EN_Msk (0x1ul << RTC_TAMPCTL_DYNPR1EN_Pos) /*!< RTC_T::TAMPCTL: DYNPR1EN Mask */ + +#define RTC_TAMPCTL_TAMP4EN_Pos (24) /*!< RTC_T::TAMPCTL: TAMP4EN Position */ +#define RTC_TAMPCTL_TAMP4EN_Msk (0x1ul << RTC_TAMPCTL_TAMP4EN_Pos) /*!< RTC_T::TAMPCTL: TAMP4EN Mask */ + +#define RTC_TAMPCTL_TAMP4LV_Pos (25) /*!< RTC_T::TAMPCTL: TAMP4LV Position */ +#define RTC_TAMPCTL_TAMP4LV_Msk (0x1ul << RTC_TAMPCTL_TAMP4LV_Pos) /*!< RTC_T::TAMPCTL: TAMP4LV Mask */ + +#define RTC_TAMPCTL_TAMP4DBEN_Pos (26) /*!< RTC_T::TAMPCTL: TAMP4DBEN Position */ +#define RTC_TAMPCTL_TAMP4DBEN_Msk (0x1ul << RTC_TAMPCTL_TAMP4DBEN_Pos) /*!< RTC_T::TAMPCTL: TAMP4DBEN Mask */ + +#define RTC_TAMPCTL_TAMP5EN_Pos (28) /*!< RTC_T::TAMPCTL: TAMP5EN Position */ +#define RTC_TAMPCTL_TAMP5EN_Msk (0x1ul << RTC_TAMPCTL_TAMP5EN_Pos) /*!< RTC_T::TAMPCTL: TAMP5EN Mask */ + +#define RTC_TAMPCTL_TAMP5LV_Pos (29) /*!< RTC_T::TAMPCTL: TAMP5LV Position */ +#define RTC_TAMPCTL_TAMP5LV_Msk (0x1ul << RTC_TAMPCTL_TAMP5LV_Pos) /*!< RTC_T::TAMPCTL: TAMP5LV Mask */ + +#define RTC_TAMPCTL_TAMP5DBEN_Pos (30) /*!< RTC_T::TAMPCTL: TAMP5DBEN Position */ +#define RTC_TAMPCTL_TAMP5DBEN_Msk (0x1ul << RTC_TAMPCTL_TAMP5DBEN_Pos) /*!< RTC_T::TAMPCTL: TAMP5DBEN Mask */ + +#define RTC_TAMPCTL_DYNPR2EN_Pos (31) /*!< RTC_T::TAMPCTL: DYNPR2EN Position */ +#define RTC_TAMPCTL_DYNPR2EN_Msk (0x1ul << RTC_TAMPCTL_DYNPR2EN_Pos) /*!< RTC_T::TAMPCTL: DYNPR2EN Mask */ + +#define RTC_TAMPSEED_SEED_Pos (0) /*!< RTC_T::TAMPSEED: SEED Position */ +#define RTC_TAMPSEED_SEED_Msk (0xfffffffful << RTC_TAMPSEED_SEED_Pos) /*!< RTC_T::TAMPSEED: SEED Mask */ + +#define RTC_TAMPTIME_SEC_Pos (0) /*!< RTC_T::TAMPTIME: SEC Position */ +#define RTC_TAMPTIME_SEC_Msk (0xful << RTC_TAMPTIME_SEC_Pos) /*!< RTC_T::TAMPTIME: SEC Mask */ + +#define RTC_TAMPTIME_TENSEC_Pos (4) /*!< RTC_T::TAMPTIME: TENSEC Position */ +#define RTC_TAMPTIME_TENSEC_Msk (0x7ul << RTC_TAMPTIME_TENSEC_Pos) /*!< RTC_T::TAMPTIME: TENSEC Mask */ + +#define RTC_TAMPTIME_MIN_Pos (8) /*!< RTC_T::TAMPTIME: MIN Position */ +#define RTC_TAMPTIME_MIN_Msk (0xful << RTC_TAMPTIME_MIN_Pos) /*!< RTC_T::TAMPTIME: MIN Mask */ + +#define RTC_TAMPTIME_TENMIN_Pos (12) /*!< RTC_T::TAMPTIME: TENMIN Position */ +#define RTC_TAMPTIME_TENMIN_Msk (0x7ul << RTC_TAMPTIME_TENMIN_Pos) /*!< RTC_T::TAMPTIME: TENMIN Mask */ + +#define RTC_TAMPTIME_HR_Pos (16) /*!< RTC_T::TAMPTIME: HR Position */ +#define RTC_TAMPTIME_HR_Msk (0xful << RTC_TAMPTIME_HR_Pos) /*!< RTC_T::TAMPTIME: HR Mask */ + +#define RTC_TAMPTIME_TENHR_Pos (20) /*!< RTC_T::TAMPTIME: TENHR Position */ +#define RTC_TAMPTIME_TENHR_Msk (0x3ul << RTC_TAMPTIME_TENHR_Pos) /*!< RTC_T::TAMPTIME: TENHR Mask */ + +#define RTC_TAMPCAL_DAY_Pos (0) /*!< RTC_T::TAMPCAL: DAY Position */ +#define RTC_TAMPCAL_DAY_Msk (0xful << RTC_TAMPCAL_DAY_Pos) /*!< RTC_T::TAMPCAL: DAY Mask */ + +#define RTC_TAMPCAL_TENDAY_Pos (4) /*!< RTC_T::TAMPCAL: TENDAY Position */ +#define RTC_TAMPCAL_TENDAY_Msk (0x3ul << RTC_TAMPCAL_TENDAY_Pos) /*!< RTC_T::TAMPCAL: TENDAY Mask */ + +#define RTC_TAMPCAL_MON_Pos (8) /*!< RTC_T::TAMPCAL: MON Position */ +#define RTC_TAMPCAL_MON_Msk (0xful << RTC_TAMPCAL_MON_Pos) /*!< RTC_T::TAMPCAL: MON Mask */ + +#define RTC_TAMPCAL_TENMON_Pos (12) /*!< RTC_T::TAMPCAL: TENMON Position */ +#define RTC_TAMPCAL_TENMON_Msk (0x1ul << RTC_TAMPCAL_TENMON_Pos) /*!< RTC_T::TAMPCAL: TENMON Mask */ + +#define RTC_TAMPCAL_YEAR_Pos (16) /*!< RTC_T::TAMPCAL: YEAR Position */ +#define RTC_TAMPCAL_YEAR_Msk (0xful << RTC_TAMPCAL_YEAR_Pos) /*!< RTC_T::TAMPCAL: YEAR Mask */ + +#define RTC_TAMPCAL_TENYEAR_Pos (20) /*!< RTC_T::TAMPCAL: TENYEAR Position */ +#define RTC_TAMPCAL_TENYEAR_Msk (0xful << RTC_TAMPCAL_TENYEAR_Pos) /*!< RTC_T::TAMPCAL: TENYEAR Mask */ + + +/**@}*/ /* RTC_CONST */ +/**@}*/ /* end of RTC register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __RTC_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/sc_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/sc_reg.h new file mode 100644 index 00000000000..af930b950d1 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/sc_reg.h @@ -0,0 +1,1019 @@ +/**************************************************************************//** + * @file sc_reg.h + * @version V1.00 + * @brief SC register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __SC_REG_H__ +#define __SC_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup SC Smart Card Host Interface Controller(SC) + Memory Mapped Structure for SC Controller +@{ */ + +typedef struct +{ + + + /** + * @var SC_T::DAT + * Offset: 0x00 SC Receive/Transmit Holding Buffer Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |DAT |Receive/Transmit Holding Buffer + * | | |Write Operation: + * | | |By writing data to DAT, the SC will send out an 8-bit data. + * | | |Note: If SCEN (SCn_CTL[0]) is not enabled, DAT cannot be programmed. + * | | |Read Operation: + * | | |By reading DAT, the SC will return an 8-bit received data. + * @var SC_T::CTL + * Offset: 0x04 SC Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SCEN |SC Controller Enable Bit + * | | |Set this bit to 1 to enable SC operation. If this bit is cleared, + * | | |0 = SC will force all transition to IDLE state. + * | | |1 = SC controller is enabled and all function can work correctly. + * | | |Note1: SCEN must be set to 1 before filling in other SC registers, or smart card will not work properly. + * |[1] |RXOFF |RX Transition Disable Control Bit + * | | |This bit is used for disable Rx transition function. + * | | |0 = The receiver Enabled. + * | | |1 = The receiver Disabled. + * | | |Note1: If AUTOCEN (SCn_CTL[3]) is enabled, this field is ignored. + * |[2] |TXOFF |TX Transition Disable Control Bit + * | | |This bit is used for disable Tx transition function. + * | | |0 = The transceiver Enabled. + * | | |1 = The transceiver Disabled. + * |[3] |AUTOCEN |Auto Convention Enable Bit + * | | |This bit is used for enable auto convention function. + * | | |0 = Auto-convention Disabled. + * | | |1 = Auto-convention Enabled. + * | | |If user enables auto convention function, the setting step must be done before Answer to Reset (ATR) + * | | |state and the first data must be 0x3B or 0x3F. + * | | |After hardware received first data and stored it at buffer, hardware will decided the convention and + * | | |change the CONSEL (SCn_CTL[5:4]) bits automatically when received first data is 0x3B or 0x3F. + * | | |If received first byte is 0x3B, TS is direct convention, CONSEL (SCn_CTL[5:4]) will be set to 00 + * | | |automatically, otherwise the TS is inverse convention, and CONSEL (SCn_CTL[5:4]) will be set to 11. + * | | |If the first data is not 0x3B or 0x3F, hardware will set ACERRIF (SCn_INTSTS[10]) and generate an + * | | |interrupt to CPU when ACERRIEN (SCn_INTEN[10]) is enabled. + * |[5:4] |CONSEL |Convention Selection + * | | |00 = Direct convention. + * | | |01 = Reserved. + * | | |10 = Reserved. + * | | |11 = Inverse convention. + * | | |Note: If AUTOCEN (SCn_CTL[3]) is enabled, this field is ignored. + * |[7:6] |RXTRGLV |Rx Buffer Trigger Level + * | | |When the number of bytes in the receiving buffer equals the RXTRGLV, the RDAIF will be set + * | | |If RDAIEN (SCn_INTEN[0]) is enabled, an interrupt will be generated to CPU. + * | | |00 = Rx Buffer Trigger Level with 01 bytes. + * | | |01 = Rx Buffer Trigger Level with 02 bytes. + * | | |10 = Rx Buffer Trigger Level with 03 bytes. + * | | |11 = Reserved. + * |[12:8] |BGT |Block Guard Time (BGT) + * | | |Block guard time means the minimum interval between the leading edges of two consecutive characters + * | | |between different transfer directions + * | | |This field indicates the counter for the bit length of block guard time + * | | |According to ISO 7816-3, in T = 0 mode, user must fill 15 (real block guard time = 16.5) to this + * | | |field; in T = 1 mode, user must fill 21 (real block guard time = 22.5) to it. + * | | |Note: The real block guard time is BGT + 1. + * |[14:13] |TMRSEL |Timer Channel Selection + * | | |00 = All internal timer function Disabled. + * | | |11 = Internal 24 bit timer and two 8 bit timers Enabled + * | | |User can configure them by setting SCn_TMRCTL0[23:0], SCn_TMRCTL1[7:0] and SCn_TMRCTL2[7:0]. + * | | |Other configurations are reserved + * |[15] |NSB |Stop Bit Length + * | | |This field indicates the length of stop bit. + * | | |0 = The stop bit length is 2 ETU. + * | | |1= The stop bit length is 1 ETU. + * | | |Note1: The default stop bit length is 2. SC and UART adopts NSB to program the stop bit length. + * | | |Note2: In UART mode, RX can receive the data sequence in 1 stop bit or 2 stop bits with NSB is set to 0. + * |[18:16] |RXRTY |RX Error Retry Count Number + * | | |This field indicates the maximum number of receiver retries that are allowed when parity error has occurred. + * | | |Note1: The real retry number is RXRTY + 1, so 8 is the maximum retry number. + * | | |Note2: This field cannot be changed when RXRTYEN enabled + * | | |The change flow is to disable RXRTYEN first and then fill in new retry value. + * |[19] |RXRTYEN |RX Error Retry Enable Bit + * | | |This bit enables receiver retry function when parity error has occurred. + * | | |0 = RX error retry function Disabled. + * | | |1 = RX error retry function Enabled. + * | | |Note: User must fill in the RXRTY value before enabling this bit. + * |[22:20] |TXRTY |TX Error Retry Count Number + * | | |This field indicates the maximum number of transmitter retries that are allowed when parity + * | | |error has occurred. + * | | |Note1: The real retry number is TXRTY + 1, so 8 is the maximum retry number. + * | | |Note2: This field cannot be changed when TXRTYEN enabled + * | | |The change flow is to disable TXRTYEN first and then fill in new retry value. + * |[23] |TXRTYEN |TX Error Retry Enable Bit + * | | |This bit enables transmitter retry function when parity error has occurred. + * | | |0 = TX error retry function Disabled. + * | | |1 = TX error retry function Enabled. + * |[25:24] |CDDBSEL |Card Detect De-bounce Selection + * | | |This field indicates the card detect de-bounce selection. + * | | |00 = De-bounce sample card insert once per 384 (128 * 3) SC module clocks and de-bounce + * | | |sample card removal once per 128 SC module clocks. + * | | |Other configurations are reserved. + * |[26] |CDLV |Card Detect Level Selection + * | | |0 = When hardware detects the card detect pin (SCn_CD) from high to low, it indicates a card is detected. + * | | |1 = When hardware detects the card detect pin (SCn_CD) from low to high, it indicates a card is detected. + * | | |Note: User must select card detect level before Smart Card controller enabled. + * |[30] |SYNC |SYNC Flag Indicator (Read Only) + * | | |Due to synchronization, user should check this bit before writing a new value to RXRTY and TXRTY fields. + * | | |0 = Synchronizing is completion, user can write new data to RXRTY and TXRTY. + * | | |1 = Last value is synchronizing. + * @var SC_T::ALTCTL + * Offset: 0x08 SC Alternate Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |TXRST |TX Software Reset + * | | |When TXRST is set, all the bytes in the transmit buffer and TX internal state machine will be cleared. + * | | |0 = No effect. + * | | |1 = Reset the TX internal state machine and pointers. + * | | |Note: This bit will be auto cleared after reset is complete. + * |[1] |RXRST |Rx Software Reset + * | | |When RXRST is set, all the bytes in the receive buffer and Rx internal state machine will be cleared. + * | | |0 = No effect. + * | | |1 = Reset the Rx internal state machine and pointers. + * | | |Note: This bit will be auto cleared after reset is complete. + * |[2] |DACTEN |Deactivation Sequence Generator Enable Bit + * | | |This bit enables SC controller to initiate the card by deactivation sequence. + * | | |0 = No effect. + * | | |1 = Deactivation sequence generator Enabled. + * | | |Note1: When the deactivation sequence completed, this bit will be cleared automatically and + * | | |the INITIF (SCn_INTSTS[8]) will be set to 1. + * | | |Note2: This field will be cleared by TXRST (SCn_ALTCTL[0]) and RXRST (SCn_ALTCTL[1]) + * | | |Thus, do not fill in this bit DACTEN, TXRST and RXRST at the same time. + * | | |Note3: If SCEN (SCn_CTL[0]) is not enabled, this filed cannot be programmed. + * |[3] |ACTEN |Activation Sequence Generator Enable Bit + * | | |This bit enables SC controller to initiate the card by activation sequence. + * | | |0 = No effect. + * | | |1 = Activation sequence generator Enabled. + * | | |Note1: When the activation sequence completed, this bit will be cleared automatically and the + * | | |INITIF (SCn_INTSTS[8]) will be set to 1. + * | | |Note2: This field will be cleared by TXRST (SCn_ALTCTL[0]) and RXRST (SCn_ALTCTL[1]) + * | | |Thus, do not fill in this bit ACTEN, TXRST and RXRST at the same time. + * | | |Note3: If SCEN (SCn_CTL[0]) is not enabled, this filed cannot be programmed. + * | | |Note4: During the activation sequence, RX is disabled automatically and can not receive data + * | | |After the activation sequence completion, RXOFF (SCn_CTL[1]) keeps the state before hardware activation. + * |[4] |WARSTEN |Warm Reset Sequence Generator Enable Bit + * | | |This bit enables SC controller to initiate the card by warm reset sequence. + * | | |0 = No effect. + * | | |1 = Warm reset sequence generator Enabled. + * | | |Note1: When the warm reset sequence completed, this bit will be cleared automatically and the + * | | |INITIF (SCn_INTSTS[8]) will be set to 1. + * | | |Note2: This field will be cleared by TXRST (SCn_ALTCTL[0]) and RXRST (SCn_ALTCTL[1]) + * | | |Thus, do not fill in this bit WARSTEN, TXRST and RXRST at the same time. + * | | |Note3: If SCEN (SCn_CTL[0]) is not enabled, this filed cannot be programmed. + * | | |Note4: During the warm reset sequence, RX is disabled automatically and can not receive data + * | | |After the warm reset sequence completion, RXOFF (SCn_CTL[1]) keeps the state before perform + * | | |warm reset sequence. + * |[5] |CNTEN0 |Internal Timer0 Start Enable Bit + * | | |This bit enables Timer 0 to start counting + * | | |User can fill 0 to stop it and set 1 to reload and count + * | | |The counter unit is ETU base. + * | | |0 = Stops counting. + * | | |1 = Start counting. + * | | |Note1: This field is used for internal 24 bit timer when TMRSEL (SCn_CTL[14:13]) is 11 only. + * | | |Note2: If the operation mode is not in auto-reload mode (SCn_TMRCTL0[26] = 0), this bit will + * | | |be auto-cleared by hardware. + * | | |Note3: If SCEN (SCn_CTL[0]) is not enabled, this filed cannot be programmed. + * |[6] |CNTEN1 |Internal Timer1 Start Enable Bit + * | | |This bit enables Timer 1 to start counting + * | | |User can fill 0 to stop it and set 1 to reload and count + * | | |The counter unit is ETU base. + * | | |0 = Stops counting. + * | | |1 = Start counting. + * | | |Note1: This field is used for internal 8 bit timer when TMRSEL(SCn_CTL[14:13]) is 11 only + * | | |Do not fill CNTEN1 when TMRSEL (SCn_CTL[14:13]) is not equal to 11. + * | | |Note2: If the operation mode is not in auto-reload mode (SCn_TMRCTL1[26] = 0), this bit will + * | | |be auto-cleared by hardware. + * | | |Note3: If SCEN (SCn_CTL[0]) is not enabled, this filed cannot be programmed. + * |[7] |CNTEN2 |Internal Timer2 Start Enable Bit + * | | |This bit enables Timer 2 to start counting + * | | |User can fill 0 to stop it and set 1 to reload and count + * | | |The counter unit is ETU base. + * | | |0 = Stops counting. + * | | |1 = Start counting. + * | | |Note1: This field is used for internal 8 bit timer when TMRSEL (SCn_CTL[14:13]) is 11 only + * | | |Do not fill in CNTEN2 when TMRSEL (SCn_CTL[14:13]) is not equal to 11. + * | | |Note2: If the operation mode is not in auto-reload mode (SCn_TMRCTL2[26] = 0), this bit will + * | | |be auto-cleared by hardware. + * | | |Note3: If SCEN (SCn_CTL[0]) is not enabled, this filed cannot be programmed. + * |[9:8] |INITSEL |Initial Timing Selection + * | | |This fields indicates the initial timing of hardware activation, warm-reset or deactivation. + * | | |The unit of initial timing is SC module clock. + * | | |Activation: refer to SC Activation Sequence in Figure 7.17-54. + * | | |Warm-reset: refer to Warm-Reset Sequence in Figure 7.17-5. + * | | |Deactivation: refer to Deactivation Sequence in Figure 7.17-56. + * | | |Note: When set activation and warm reset in Timer0 operation mode 0011, it may have deviation + * | | |at most 128 SC module clock cycles. + * |[11] |ADACEN |Auto Deactivation When Card Removal + * | | |This bit is used for enable hardware auto deactivation when smart card is removed. + * | | |0 = Auto deactivation Disabled. + * | | |1 = Auto deactivation Enabled. + * | | |Note: When the card is removed, hardware will stop any process and then do deactivation sequence + * | | |if this bit is set + * | | |If auto deactivation process completes, hardware will set INITIF (SCn_INTSTS[8]) also. + * |[12] |RXBGTEN |Receiver Block Guard Time Function Enable Bit + * | | |This bit enables the receiver block guard time function. + * | | |0 = Receiver block guard time function Disabled. + * | | |1 = Receiver block guard time function Enabled. + * |[13] |ACTSTS0 |Internal Timer0 Active Status (Read Only) + * | | |This bit indicates the timer counter status of timer0. + * | | |0 = Timer0 is not active. + * | | |1 = Timer0 is active. + * | | |Note: Timer0 is active does not always mean timer0 is counting the CNT (SCn_TMRCTL0[23:0]). + * |[14] |ACTSTS1 |Internal Timer1 Active Status (Read Only) + * | | |This bit indicates the timer counter status of timer1. + * | | |0 = Timer1 is not active. + * | | |1 = Timer1 is active. + * | | |Note: Timer1 is active does not always mean timer1 is counting the CNT (SCn_TMRCTL1[7:0]). + * |[15] |ACTSTS2 |Internal Timer2 Active Status (Read Only) + * | | |This bit indicates the timer counter status of timer2. + * | | |0 = Timer2 is not active. + * | | |1 = Timer2 is active. + * | | |Note: Timer2 is active does not always mean timer2 is counting the CNT (SCn_TMRCTL2[7:0]). + * |[31] |SYNC |SYNC Flag Indicator (Read Only) + * | | |Due to synchronization, user should check this bit when writing a new value to SCn_ALTCTL register. + * | | |0 = Synchronizing is completion, user can write new data to SCn_ALTCTL register. + * | | |1 = Last value is synchronizing. + * @var SC_T::EGT + * Offset: 0x0C SC Extra Guard Time Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |EGT |Extra Guard Time + * | | |This field indicates the extra guard time value. + * | | |Note: The extra guard time unit is ETU base. + * @var SC_T::RXTOUT + * Offset: 0x10 SC Receive Buffer Time-out Counter Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[8:0] |RFTM |SC Receiver FIFO Time-out Counter + * | | |The time-out down counter resets and starts counting whenever the RX buffer received a new data + * | | |Once the counter decrease to 1 and no new data is received or CPU does not read data by + * | | |reading SCn_DAT, a receiver time-out flag RBTOIF (SCn_INTSTS[9]) will be set, and hardware will + * | | |generate an interrupt to CPU when RBTOIEN (SCn_INTEN[9]) is enabled. + * | | |Note1: The counter unit is ETU based and the interval of time-out is RFTM + 0.5. + * | | |Note2: Filling in all 0 to this field indicates to disable this function. + * @var SC_T::ETUCTL + * Offset: 0x14 SC Element Time Unit Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[11:0] |ETURDIV |ETU Rate Divider + * | | |The field is used for ETU clock rate divider. + * | | |The real ETU is ETURDIV + 1. + * | | |Note: User can configure this field, but this field must be greater than 0x04. + * @var SC_T::INTEN + * Offset: 0x18 SC Interrupt Enable Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |RDAIEN |Receive Data Reach Interrupt Enable Bit + * | | |This field is used to enable received data reaching trigger level RXTRGLV (SCn_CTL[7:6]) interrupt. + * | | |0 = Receive data reach trigger level interrupt Disabled. + * | | |1 = Receive data reach trigger level interrupt Enabled. + * |[1] |TBEIEN |Transmit Buffer Empty Interrupt Enable Bit + * | | |This field is used to enable transmit buffer empty interrupt. + * | | |0 = Transmit buffer empty interrupt Disabled. + * | | |1 = Transmit buffer empty interrupt Enabled. + * |[2] |TERRIEN |Transfer Error Interrupt Enable Bit + * | | |This field is used to enable transfer error interrupt + * | | |The transfer error states is at SCn_STATUS register which includes receiver break error + * | | |BEF (SCn_STATUS[6]), frame error FEF (SCn_STATUS[5]), parity error PEF (SCn_STATUS[4]), receive + * | | |buffer overflow error RXOV (SCn_STATUS[0]), transmit buffer overflow error TXOV (SCn_STATUS[8]), + * | | |receiver retry over limit error RXOVERR (SCn_STATUS[22]) and transmitter retry over limit error + * | | |TXOVERR (SCn_STATUS[30]). + * | | |0 = Transfer error interrupt Disabled. + * | | |1 = Transfer error interrupt Enabled. + * |[3] |TMR0IEN |Timer0 Interrupt Enable Bit + * | | |This field is used to enable Timer0 interrupt function. + * | | |0 = Timer0 interrupt Disabled. + * | | |1 = Timer0 interrupt Enabled. + * |[4] |TMR1IEN |Timer1 Interrupt Enable Bit + * | | |This field is used to enable the Timer1 interrupt function. + * | | |0 = Timer1 interrupt Disabled. + * | | |1 = Timer1 interrupt Enabled. + * |[5] |TMR2IEN |Timer2 Interrupt Enable Bit + * | | |This field is used to enable Timer2 interrupt function. + * | | |0 = Timer2 interrupt Disabled. + * | | |1 = Timer2 interrupt Enabled. + * |[6] |BGTIEN |Block Guard Time Interrupt Enable Bit + * | | |This field is used to enable block guard time interrupt in receive direction. + * | | |0 = Block guard time interrupt Disabled. + * | | |1 = Block guard time interrupt Enabled. + * | | |Note: This bit is valid only for receive direction block guard time. + * |[7] |CDIEN |Card Detect Interrupt Enable Bit + * | | |This field is used to enable card detect interrupt + * | | |The card detect status is CDPINSTS (SCn_STATUS[13]). + * | | |0 = Card detect interrupt Disabled. + * | | |1 = Card detect interrupt Enabled. + * |[8] |INITIEN |Initial End Interrupt Enable Bit + * | | |This field is used to enable activation (ACTEN (SCn_ALTCTL[3] = 1)), deactivation + * | | |(DACTEN (SCn_ALTCTL[2] = 1)) and warm reset (WARSTEN (SCn_ALTCTL [4])) sequence complete interrupt. + * | | |0 = Initial end interrupt Disabled. + * | | |1 = Initial end interrupt Enabled. + * |[9] |RXTOIEN |Receiver Buffer Time-out Interrupt Enable Bit + * | | |This field is used to enable receiver buffer time-out interrupt. + * | | |0 = Receiver buffer time-out interrupt Disabled. + * | | |1 = Receiver buffer time-out interrupt Enabled. + * |[10] |ACERRIEN |Auto Convention Error Interrupt Enable Bit + * | | |This field is used to enable auto-convention error interrupt. + * | | |0 = Auto-convention error interrupt Disabled. + * | | |1 = Auto-convention error interrupt Enabled. + * @var SC_T::INTSTS + * Offset: 0x1C SC Interrupt Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |RDAIF |Receive Data Reach Interrupt Status Flag (Read Only) + * | | |This field is used for received data reaching trigger level RXTRGLV (SCn_CTL[7:6]) interrupt status flag. + * | | |0 = Number of receive buffer is less than RXTRGLV setting. + * | | |1 = Number of receive buffer data equals the RXTRGLV setting. + * | | |Note: This bit is read only + * | | |If user reads data from SCn_DAT and receiver buffer data byte number is less than RXTRGLV, + * | | |this bit will be cleared automatically. + * |[1] |TBEIF |Transmit Buffer Empty Interrupt Status Flag (Read Only) + * | | |This field is used for transmit buffer empty interrupt status flag. + * | | |0 = Transmit buffer is not empty. + * | | |1 = Transmit buffer is empty. + * | | |Note: This bit is read only + * | | |If user wants to clear this bit, user must write data to DAT (SCn_DAT[7:0]) and then this bit + * | | |will be cleared automatically. + * |[2] |TERRIF |Transfer Error Interrupt Status Flag + * | | |This field is used for transfer error interrupt status flag + * | | |The transfer error states is at SCn_STATUS register which includes receiver break error + * | | |BEF (SCn_STATUS[6]), frame error FEF (SCn_STATUS[5], parity error PEF (SCn_STATUS[4] and receive + * | | |buffer overflow error RXOV (SCn_STATUS[0]), transmit buffer overflow error TXOV (SCn_STATUS[8]), + * | | |receiver retry over limit error RXOVERR (SCn_STATUS[22] or transmitter retry over limit error + * | | |TXOVERR (SCn_STATUS[30]). + * | | |0 = Transfer error interrupt did not occur. + * | | |1 = Transfer error interrupt occurred. + * | | |Note1: This field is the status flag of BEF, FEF, PEF, RXOV, TXOV, RXOVERR or TXOVERR. + * | | |Note2: This bit can be cleared by writing 1 to it. + * |[3] |TMR0IF |Timer0 Interrupt Status Flag + * | | |This field is used for Timer0 interrupt status flag. + * | | |0 = Timer0 interrupt did not occur. + * | | |1 = Timer0 interrupt occurred. + * | | |Note: This bit can be cleared by writing 1 to it. + * |[4] |TMR1IF |Timer1 Interrupt Status Flag + * | | |This field is used for Timer1 interrupt status flag. + * | | |0 = Timer1 interrupt did not occur. + * | | |1 = Timer1 interrupt occurred. + * | | |Note: This bit can be cleared by writing 1 to it. + * |[5] |TMR2IF |Timer2 Interrupt Status Flag + * | | |This field is used for Timer2 interrupt status flag. + * | | |0 = Timer2 interrupt did not occur. + * | | |1 = Timer2 interrupt occurred. + * | | |Note: This bit can be cleared by writing 1 to it. + * |[6] |BGTIF |Block Guard Time Interrupt Status Flag + * | | |This field is used for indicate block guard time interrupt status flag in receive direction. + * | | |0 = Block guard time interrupt did not occur. + * | | |1 = Block guard time interrupt occurred. + * | | |Note1: This bit is valid only when RXBGTEN (SCn_ALTCTL[12]) is enabled. + * | | |Note2: This bit can be cleared by writing 1 to it. + * |[7] |CDIF |Card Detect Interrupt Status Flag (Read Only) + * | | |This field is used for card detect interrupt status flag + * | | |The card detect status is CINSERT (SCn_STATUS[12]) and CREMOVE (SCn_STATUS[11]). + * | | |0 = Card detect event did not occur. + * | | |1 = Card detect event occurred. + * | | |Note: This bit is read only, user must to clear CINSERT or CREMOVE status to clear it. + * |[8] |INITIF |Initial End Interrupt Status Flag + * | | |This field is used for activation (ACTEN (SCn_ALTCTL[3])), deactivation (DACTEN (SCn_ALTCTL[2])) + * | | |and warm reset (WARSTEN (SCn_ALTCTL[4])) sequence interrupt status flag. + * | | |0 = Initial sequence is not complete. + * | | |1 = Initial sequence is completed. + * | | |Note: This bit can be cleared by writing 1 to it. + * |[9] |RXTOIF |Receive Buffer Time-out Interrupt Status Flag (Read Only) + * | | |This field is used for indicate receive buffer time-out interrupt status flag. + * | | |0 = Receive buffer time-out interrupt did not occur. + * | | |1 = Receive buffer time-out interrupt occurred. + * | | |Note: This bit is read only, user must read all receive buffer remaining data by reading SCn_DAT + * | | |register to clear it. + * |[10] |ACERRIF |Auto Convention Error Interrupt Status Flag + * | | |This field indicates auto convention sequence error. + * | | |0 = Received TS at ATR state is 0x3B or 0x3F. + * | | |1 = Received TS at ATR state is neither 0x3B nor 0x3F. + * | | |Note: This bit can be cleared by writing 1 to it. + * @var SC_T::STATUS + * Offset: 0x20 SC Transfer Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |RXOV |Receive Overflow Error Status Flag + * | | |This bit is set when Rx buffer overflow. + * | | |0 = Rx buffer is not overflow. + * | | |1 = Rx buffer is overflow when the number of received bytes is greater than Rx buffer size (4 bytes). + * | | |Note: This bit can be cleared by writing 1 to it. + * |[1] |RXEMPTY |Receive Buffer Empty Status Flag (Read Only) + * | | |This bit indicates Rx buffer empty or not. + * | | |0 = Rx buffer is not empty. + * | | |1 = Rx buffer is empty, it means the last byte of Rx buffer has read from DAT (SCn_DAT[7:0]) by CPU. + * |[2] |RXFULL |Receive Buffer Full Status Flag (Read Only) + * | | |This bit indicates Rx buffer full or not. + * | | |0 = Rx buffer count is less than 4. + * | | |1 = Rx buffer count equals to 4. + * |[4] |PEF |Receiver Parity Error Status Flag + * | | |This bit is set to logic 1 whenever the received character does not have a valid parity bit. + * | | |0 = Receiver parity error flag did not occur. + * | | |1 = Receiver parity error flag occurred. + * | | |Note1: This bit can be cleared by writing 1 to it. + * | | |Note2: If CPU sets receiver retries function by setting RXRTYEN (SCn_CTL[19]), hardware will not + * | | |set this flag. + * |[5] |FEF |Receiver Frame Error Status Flag + * | | |This bit is set to logic 1 whenever the received character does not have a valid stop bit (that is, + * | | |the stop bit following the last data bit or parity bit is detected as logic 0). + * | | |0 = Receiver frame error flag did not occur. + * | | |1 = Receiver frame error flag occurred. + * | | |Note1: This bit can be cleared by writing 1 to it. + * | | |Note2: If CPU sets receiver retries function by setting RXRTYEN (SCn_CTL[19]), hardware will not + * | | |set this flag. + * |[6] |BEF |Receiver Break Error Status Flag + * | | |This bit is set to logic 1 whenever the received data input (Rx) held in the spacing state + * | | |(logic 0) is longer than a full word transmission time (that is, the total time of start bit + + * | | |data bits + parity bit + stop bit). + * | | |0 = Receiver break error flag did not occur. + * | | |1 = Receiver break error flag occurred. + * | | |Note1: This bit can be cleared by writing 1 to it. + * | | |Note2: If CPU sets receiver retries function by setting RXRTYEN (SCn_CTL[19]), hardware will not set + * | | |this flag. + * |[8] |TXOV |Transmit Overflow Error Interrupt Status Flag + * | | |This bit is set when Tx buffer overflow. + * | | |0 = Tx buffer is not overflow. + * | | |1 = Tx buffer is overflow when Tx buffer is full and an additional write operation to DAT (SCn_DAT[7:0]). + * | | |Note: This bit can be cleared by writing 1 to it. + * |[9] |TXEMPTY |Transmit Buffer Empty Status Flag (Read Only) + * | | |This bit indicates TX buffer empty or not. + * | | |0 = Tx buffer is not empty. + * | | |1 = Tx buffer is empty, it means the last byte of Tx buffer has been transferred to Transmitter + * | | |Shift Register. + * | | |Note: This bit will be cleared when writing data into DAT (SCn_DAT[7:0]). + * |[10] |TXFULL |Transmit Buffer Full Status Flag (Read Only) + * | | |This bit indicates Tx buffer full or not. + * | | |0 = Tx buffer count is less than 4. + * | | |1 = Tx buffer count equals to 4. + * |[11] |CREMOVE |Card Removal Status of SCn_CD Pin + * | | |This bit is set whenever card has been removal. + * | | |0 = No effect. + * | | |1 = Card removed. + * | | |Note1: This bit can be cleared by writing 1 to it. + * | | |Note2: Card detect function will start after SCEN (SCn_CTL[0]) set. + * |[12] |CINSERT |Card Insert Status of SCn_CD Pin + * | | |This bit is set whenever card has been inserted. + * | | |0 = No effect. + * | | |1 = Card insert. + * | | |Note1: This bit can be cleared by writing 1 to it. + * | | |Note2: The card detect function will start after SCEN (SCn_CTL[0]) set. + * |[13] |CDPINSTS |Card Detect Pin Status (Read Only) + * | | |This bit is the pin status of SCn_CD. + * | | |0 = The SCn_CD pin state at low. + * | | |1 = The SCn_CD pin state at high. + * |[18:16] |RXPOINT |Receive Buffer Pointer Status (Read Only) + * | | |This field indicates the Rx buffer pointer status + * | | |When SC controller receives one byte from external device, RXPOINT increases one + * | | |When one byte of Rx buffer is read by CPU, RXPOINT decreases one. + * |[21] |RXRERR |Receiver Retry Error + * | | |This bit is used for receiver error retry and set by hardware. + * | | |0 = No Rx retry transfer. + * | | |1 = Rx has any error and retries transfer. + * | | |Note1: This bit can be cleared by writing 1 to it. + * | | |Note2 This bit is a flag and cannot generate any interrupt to CPU. + * | | |Note3: If CPU enables receiver retries function by setting RXRTYEN (SCn_CTL[19]), + * | | |hardware will not set this flag. + * |[22] |RXOVERR |Receiver over Retry Error + * | | |This bit is used for receiver retry counts over than retry number limitation. + * | | |0 = Receiver retries counts is not over than RXRTY (SCn_CTL[18:16]) + 1. + * | | |1 = Receiver retries counts over than RXRTY (SCn_CTL[18:16]) + 1. + * | | |Note1: This bit can be cleared by writing 1 to it. + * | | |Note2: If CPU enables receiver retries function by setting RXRTYEN (SCn_CTL[19]), hardware + * | | |will not set this flag. + * |[23] |RXACT |Receiver in Active Status Flag (Read Only) + * | | |This bit indicates Rx transfer status. + * | | |0 = This bit is cleared automatically when Rx transfer is finished. + * | | |1 = This bit is set by hardware when Rx transfer is in active. + * | | |Note: This bit is read only. + * |[26:24] |TXPOINT |Transmit Buffer Pointer Status (Read Only) + * | | |This field indicates the Tx buffer pointer status + * | | |When CPU writes data into SCn_DAT, TXPOINT increases one + * | | |When one byte of Tx buffer is transferred to transmitter shift register, TXPOINT decreases one. + * |[29] |TXRERR |Transmitter Retry Error + * | | |This bit is used for indicate transmitter error retry and set by hardware. + * | | |0 = No Tx retry transfer. + * | | |1 = Tx has any error and retries transfer. + * | | |Note1: This bit can be cleared by writing 1 to it. + * | | |Note2: This bit is a flag and cannot generate any interrupt to CPU. + * |[30] |TXOVERR |Transmitter over Retry Error + * | | |This bit is used for transmitter retry counts over than retry number limitation. + * | | |0 = Transmitter retries counts is not over than TXRTY (SCn_CTL[22:20]) + 1. + * | | |1 = Transmitter retries counts over than TXRTY (SCn_CTL[22:20]) + 1. + * | | |Note: This bit can be cleared by writing 1 to it. + * |[31] |TXACT |Transmit in Active Status Flag (Read Only) + * | | |This bit indicates Tx transmit status. + * | | |0 = This bit is cleared automatically when Tx transfer is finished or the last byte transmission + * | | |has completed. + * | | |1 = Transmit is active and this bit is set by hardware when Tx transfer is in active and the STOP + * | | |bit of the last byte has not been transmitted. + * | | |Note: This bit is read only. + * @var SC_T::PINCTL + * Offset: 0x24 SC Pin Control State Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |PWREN |SCn_PWR Pin Signal + * | | |User can set PWRINV (SCn_PINCTL[11]) and PWREN (SCn_PINCTL[0]) to decide SCn_PWR pin is in high or low level. + * | | |Write this field to drive SCn_PWR pin + * | | |Refer PWRINV (SCn_PINCTL[11]) description for programming SCn_PWR pin voltage level. + * | | |Read this field to get SCn_PWR signal status. + * | | |0 = SCn_PWR signal status is low. + * | | |1 = SCn_PWR signal status is high. + * | | |Note: When operating at activation, warm reset or deactivation mode, this bit will be changed automatically. + * | | |Thus, do not fill in this field when operating in these modes. + * |[1] |RSTEN |SCn_RST Pin Signal + * | | |User can set RSTEN (SCn_PINCTL[1]) to decide SCn_RST pin is in high or low level. + * | | |Write this field to drive SCn_RST pin. + * | | |0 = Drive SCn_RST pin to low. + * | | |1 = Drive SCn_RST pin to high. + * | | |Read this field to get SCn_RST signal status. + * | | |0 = SCn_RST signal status is low. + * | | |1 = SCn_RST signal status is high. + * | | |Note: When operating at activation, warm reset or deactivation mode, this bit will be changed automatically. + * | | |Thus, do not fill in this field when operating in these modes. + * |[6] |CLKKEEP |SC Clock Enable Bit + * | | |0 = SC clock generation Disabled. + * | | |1 = SC clock always keeps free running. + * | | |Note: When operating in activation, warm reset or deactivation mode, this bit will be changed automatically. + * | | |Thus, do not fill in this field when operating in these modes. + * |[9] |SCDATA |SCn_DATA Pin Signal + * | | |This bit is the signal status of SCn_DATA but user can drive SCn_DATA pin to high or low by setting this bit. + * | | |0 = Drive SCn_DATA pin to low. + * | | |1 = Drive SCn_DATA pin to high. + * | | |Read this field to get SCn_DATA signal status. + * | | |0 = SCn_DATA signal status is low. + * | | |1 = SCn_DATA signal status is high. + * | | |Note: When SC is at activation, warm reset or deactivation mode, this bit will be changed automatically. + * | | |Thus, do not fill in this field when SC is in these modes. + * |[11] |PWRINV |SCn_PWR Pin Inverse + * | | |This bit is used for inverse the SCn_PWR pin. + * | | |There are four kinds of combination for SCn_PWR pin setting by PWRINV (SCn_PINCTL[11]) and PWREN (SCn_PINCTL[0]). + * | | |PWRINV is 0 and PWREN is 0, SCn_PWR pin is 0. + * | | |PWRINV is 0 and PWREN is 1, SCn_PWR pin is 1. + * | | |PWRINV is 1 and PWREN is 0, SCn_PWR pin is 1. + * | | |PWRINV is 1 and PWREN is 1, SCn_PWR pin is 0. + * | | |Note: User must select PWRINV (SCn_PINCTL[11]) before smart card is enabled by SCEN (SCn_CTL[0]). + * |[16] |DATASTS |SCn_DATA Pin Status (Read Only) + * | | |This bit is the pin status of SCn_DATA. + * | | |0 = The SCn_DATA pin status is low. + * | | |1 = The SCn_DATA pin status is high. + * |[17] |PWRSTS |SCn_PWR Pin Status (Read Only) + * | | |This bit is the pin status of SCn_PWR. + * | | |0 = SCn_PWR pin to low. + * | | |1 = SCn_PWR pin to high. + * |[18] |RSTSTS |SCn_RST Pin Status (Read Only) + * | | |This bit is the pin status of SCn_RST. + * | | |0 = SCn_RST pin is low. + * | | |1 = SCn_RST pin is high. + * |[30] |SYNC |SYNC Flag Indicator (Read Only) + * | | |Due to synchronization, user should check this bit when writing a new value to SCn_PINCTL register. + * | | |0 = Synchronizing is completion, user can write new data to SCn_PINCTL register. + * | | |1 = Last value is synchronizing. + * @var SC_T::TMRCTL0 + * Offset: 0x28 SC Internal Timer0 Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:0] |CNT |Timer0 Counter Value + * | | |This field indicates the internal Timer0 counter values. + * | | |Note: Unit of Timer0 counter is ETU base. + * |[27:24] |OPMODE |Timer0 Operation Mode Selection + * | | |This field indicates the internal 24-bit Timer0 operation selection. + * | | |Refer to Table 7.17-3 for programming Timer0. + * |[31] |SYNC |SYNC Flag Indicator (Read Only) + * | | |Due to synchronization, user should check this bit when writing a new value to the SCn_TMRCTL0 register. + * | | |0 = Synchronizing is completion, user can write new data to SCn_TMRCTL0 register. + * | | |1 = Last value is synchronizing. + * @var SC_T::TMRCTL1 + * Offset: 0x2C SC Internal Timer1 Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |CNT |Timer 1 Counter Value + * | | |This field indicates the internal Timer1 counter values. + * | | |Note: Unit of Timer1 counter is ETU base. + * |[27:24] |OPMODE |Timer 1 Operation Mode Selection + * | | |This field indicates the internal 8-bit Timer1 operation selection. + * | | |Refer to Table 7.17-3 for programming Timer1. + * |[31] |SYNC |SYNC Flag Indicator (Read Only) + * | | |Due to synchronization, software should check this bit when writing a new value to SCn_TMRCTL1 register. + * | | |0 = Synchronizing is completion, user can write new data to SCn_TMRCTL1 register. + * | | |1 = Last value is synchronizing. + * @var SC_T::TMRCTL2 + * Offset: 0x30 SC Internal Timer2 Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |CNT |Timer 2 Counter Value + * | | |This field indicates the internal Timer2 counter values. + * | | |Note: Unit of Timer2 counter is ETU base. + * |[27:24] |OPMODE |Timer 2 Operation Mode Selection + * | | |This field indicates the internal 8-bit Timer2 operation selection + * | | |Refer to Table 7.17-3 for programming Timer2. + * |[31] |SYNC |SYNC Flag Indicator (Read Only) + * | | |Due to synchronization, user should check this bit when writing a new value to SCn_TMRCTL2 register. + * | | |0 = Synchronizing is completion, user can write new data to SCn_TMRCTL2 register. + * | | |1 = Last value is synchronizing. + * @var SC_T::UARTCTL + * Offset: 0x34 SC UART Mode Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |UARTEN |UART Mode Enable Bit + * | | |Sets this bit to enable UART mode function. + * | | |0 = Smart Card mode. + * | | |1 = UART mode. + * | | |Note1: When operating in UART mode, user must set CONSEL (SCn_CTL[5:4]) = 00 and AUTOCEN (SCn_CTL[3]) = 0. + * | | |Note2: When operating in Smart Card mode, user must set UARTEN (SCn_UARTCTL[0]) = 0. + * | | |Note3: When UART mode is enabled, hardware will generate a reset to reset FIFO and internal state machine. + * |[5:4] |WLS |Word Length Selection + * | | |This field is used for select UART data length. + * | | |00 = Word length is 8 bits. + * | | |01 = Word length is 7 bits. + * | | |10 = Word length is 6 bits. + * | | |11 = Word length is 5 bits. + * | | |Note: In smart card mode, this WLS must be '00'. + * |[6] |PBOFF |Parity Bit Disable Control + * | | |Sets this bit is used for disable parity check function. + * | | |0 = Parity bit is generated or checked between the last data word bit and stop bit of the serial data. + * | | |1 = Parity bit is not generated (transmitting data) or checked (receiving data) during transfer. + * | | |Note: In smart card mode, this field must be '0' (default setting is with parity bit). + * |[7] |OPE |Odd Parity Enable Bit + * | | |This is used for odd/even parity selection. + * | | |0 = Even number of logic 1's are transmitted or check the data word and parity bits in receiving mode. + * | | |1 = Odd number of logic 1's are transmitted or check the data word and parity bits in receiving mode. + * | | |Note: This bit has effect only when PBOFF bit is '0'. + * @var SC_T::ACTCTL + * Offset: 0x4C SC Activation Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[4:0] |T1EXT |T1 Extend Time of Hardware Activation + * | | |This field provide the configurable cycles to extend the activation time T1 period. + * | | |The cycle scaling factor is 2048. + * | | |Extend cycles = (filled value * 2048) cycles. + * | | |Refer to SC activation sequence in Figure 7.17-4. + * | | |For example, + * | | |SCLK = 4MHz, each cycle = 0.25us,. + * | | |Filled 20 to this field + * | | |Extend time = 20 * 2048 * 0.25us = 10.24 ms. + * | | |Note: Setting 0 to this field conforms to the protocol ISO/IEC 7816-3 + */ + __IO uint32_t DAT; /*!< [0x0000] SC Receive/Transmit Holding Buffer Register */ + __IO uint32_t CTL; /*!< [0x0004] SC Control Register */ + __IO uint32_t ALTCTL; /*!< [0x0008] SC Alternate Control Register */ + __IO uint32_t EGT; /*!< [0x000c] SC Extra Guard Time Register */ + __IO uint32_t RXTOUT; /*!< [0x0010] SC Receive Buffer Time-out Counter Register */ + __IO uint32_t ETUCTL; /*!< [0x0014] SC Element Time Unit Control Register */ + __IO uint32_t INTEN; /*!< [0x0018] SC Interrupt Enable Control Register */ + __IO uint32_t INTSTS; /*!< [0x001c] SC Interrupt Status Register */ + __IO uint32_t STATUS; /*!< [0x0020] SC Transfer Status Register */ + __IO uint32_t PINCTL; /*!< [0x0024] SC Pin Control State Register */ + __IO uint32_t TMRCTL0; /*!< [0x0028] SC Internal Timer0 Control Register */ + __IO uint32_t TMRCTL1; /*!< [0x002c] SC Internal Timer1 Control Register */ + __IO uint32_t TMRCTL2; /*!< [0x0030] SC Internal Timer2 Control Register */ + __IO uint32_t UARTCTL; /*!< [0x0034] SC UART Mode Control Register */ + /** @cond HIDDEN_SYMBOLS */ + __I uint32_t RESERVE0[5]; + /** @endcond */ + __IO uint32_t ACTCTL; /*!< [0x004c] SC Activation Control Register */ + +} SC_T; + +/** + @addtogroup SC_CONST SC Bit Field Definition + Constant Definitions for SC Controller +@{ */ + +#define SC_DAT_DAT_Pos (0) /*!< SC_T::DAT: DAT Position */ +#define SC_DAT_DAT_Msk (0xfful << SC_DAT_DAT_Pos) /*!< SC_T::DAT: DAT Mask */ + +#define SC_CTL_SCEN_Pos (0) /*!< SC_T::CTL: SCEN Position */ +#define SC_CTL_SCEN_Msk (0x1ul << SC_CTL_SCEN_Pos) /*!< SC_T::CTL: SCEN Mask */ + +#define SC_CTL_RXOFF_Pos (1) /*!< SC_T::CTL: RXOFF Position */ +#define SC_CTL_RXOFF_Msk (0x1ul << SC_CTL_RXOFF_Pos) /*!< SC_T::CTL: RXOFF Mask */ + +#define SC_CTL_TXOFF_Pos (2) /*!< SC_T::CTL: TXOFF Position */ +#define SC_CTL_TXOFF_Msk (0x1ul << SC_CTL_TXOFF_Pos) /*!< SC_T::CTL: TXOFF Mask */ + +#define SC_CTL_AUTOCEN_Pos (3) /*!< SC_T::CTL: AUTOCEN Position */ +#define SC_CTL_AUTOCEN_Msk (0x1ul << SC_CTL_AUTOCEN_Pos) /*!< SC_T::CTL: AUTOCEN Mask */ + +#define SC_CTL_CONSEL_Pos (4) /*!< SC_T::CTL: CONSEL Position */ +#define SC_CTL_CONSEL_Msk (0x3ul << SC_CTL_CONSEL_Pos) /*!< SC_T::CTL: CONSEL Mask */ + +#define SC_CTL_RXTRGLV_Pos (6) /*!< SC_T::CTL: RXTRGLV Position */ +#define SC_CTL_RXTRGLV_Msk (0x3ul << SC_CTL_RXTRGLV_Pos) /*!< SC_T::CTL: RXTRGLV Mask */ + +#define SC_CTL_BGT_Pos (8) /*!< SC_T::CTL: BGT Position */ +#define SC_CTL_BGT_Msk (0x1ful << SC_CTL_BGT_Pos) /*!< SC_T::CTL: BGT Mask */ + +#define SC_CTL_TMRSEL_Pos (13) /*!< SC_T::CTL: TMRSEL Position */ +#define SC_CTL_TMRSEL_Msk (0x3ul << SC_CTL_TMRSEL_Pos) /*!< SC_T::CTL: TMRSEL Mask */ + +#define SC_CTL_NSB_Pos (15) /*!< SC_T::CTL: NSB Position */ +#define SC_CTL_NSB_Msk (0x1ul << SC_CTL_NSB_Pos) /*!< SC_T::CTL: NSB Mask */ + +#define SC_CTL_RXRTY_Pos (16) /*!< SC_T::CTL: RXRTY Position */ +#define SC_CTL_RXRTY_Msk (0x7ul << SC_CTL_RXRTY_Pos) /*!< SC_T::CTL: RXRTY Mask */ + +#define SC_CTL_RXRTYEN_Pos (19) /*!< SC_T::CTL: RXRTYEN Position */ +#define SC_CTL_RXRTYEN_Msk (0x1ul << SC_CTL_RXRTYEN_Pos) /*!< SC_T::CTL: RXRTYEN Mask */ + +#define SC_CTL_TXRTY_Pos (20) /*!< SC_T::CTL: TXRTY Position */ +#define SC_CTL_TXRTY_Msk (0x7ul << SC_CTL_TXRTY_Pos) /*!< SC_T::CTL: TXRTY Mask */ + +#define SC_CTL_TXRTYEN_Pos (23) /*!< SC_T::CTL: TXRTYEN Position */ +#define SC_CTL_TXRTYEN_Msk (0x1ul << SC_CTL_TXRTYEN_Pos) /*!< SC_T::CTL: TXRTYEN Mask */ + +#define SC_CTL_CDDBSEL_Pos (24) /*!< SC_T::CTL: CDDBSEL Position */ +#define SC_CTL_CDDBSEL_Msk (0x3ul << SC_CTL_CDDBSEL_Pos) /*!< SC_T::CTL: CDDBSEL Mask */ + +#define SC_CTL_CDLV_Pos (26) /*!< SC_T::CTL: CDLV Position */ +#define SC_CTL_CDLV_Msk (0x1ul << SC_CTL_CDLV_Pos) /*!< SC_T::CTL: CDLV Mask */ + +#define SC_CTL_SYNC_Pos (30) /*!< SC_T::CTL: SYNC Position */ +#define SC_CTL_SYNC_Msk (0x1ul << SC_CTL_SYNC_Pos) /*!< SC_T::CTL: SYNC Mask */ + +#define SC_ALTCTL_TXRST_Pos (0) /*!< SC_T::ALTCTL: TXRST Position */ +#define SC_ALTCTL_TXRST_Msk (0x1ul << SC_ALTCTL_TXRST_Pos) /*!< SC_T::ALTCTL: TXRST Mask */ + +#define SC_ALTCTL_RXRST_Pos (1) /*!< SC_T::ALTCTL: RXRST Position */ +#define SC_ALTCTL_RXRST_Msk (0x1ul << SC_ALTCTL_RXRST_Pos) /*!< SC_T::ALTCTL: RXRST Mask */ + +#define SC_ALTCTL_DACTEN_Pos (2) /*!< SC_T::ALTCTL: DACTEN Position */ +#define SC_ALTCTL_DACTEN_Msk (0x1ul << SC_ALTCTL_DACTEN_Pos) /*!< SC_T::ALTCTL: DACTEN Mask */ + +#define SC_ALTCTL_ACTEN_Pos (3) /*!< SC_T::ALTCTL: ACTEN Position */ +#define SC_ALTCTL_ACTEN_Msk (0x1ul << SC_ALTCTL_ACTEN_Pos) /*!< SC_T::ALTCTL: ACTEN Mask */ + +#define SC_ALTCTL_WARSTEN_Pos (4) /*!< SC_T::ALTCTL: WARSTEN Position */ +#define SC_ALTCTL_WARSTEN_Msk (0x1ul << SC_ALTCTL_WARSTEN_Pos) /*!< SC_T::ALTCTL: WARSTEN Mask */ + +#define SC_ALTCTL_CNTEN0_Pos (5) /*!< SC_T::ALTCTL: CNTEN0 Position */ +#define SC_ALTCTL_CNTEN0_Msk (0x1ul << SC_ALTCTL_CNTEN0_Pos) /*!< SC_T::ALTCTL: CNTEN0 Mask */ + +#define SC_ALTCTL_CNTEN1_Pos (6) /*!< SC_T::ALTCTL: CNTEN1 Position */ +#define SC_ALTCTL_CNTEN1_Msk (0x1ul << SC_ALTCTL_CNTEN1_Pos) /*!< SC_T::ALTCTL: CNTEN1 Mask */ + +#define SC_ALTCTL_CNTEN2_Pos (7) /*!< SC_T::ALTCTL: CNTEN2 Position */ +#define SC_ALTCTL_CNTEN2_Msk (0x1ul << SC_ALTCTL_CNTEN2_Pos) /*!< SC_T::ALTCTL: CNTEN2 Mask */ + +#define SC_ALTCTL_INITSEL_Pos (8) /*!< SC_T::ALTCTL: INITSEL Position */ +#define SC_ALTCTL_INITSEL_Msk (0x3ul << SC_ALTCTL_INITSEL_Pos) /*!< SC_T::ALTCTL: INITSEL Mask */ + +#define SC_ALTCTL_ADACEN_Pos (11) /*!< SC_T::ALTCTL: ADACEN Position */ +#define SC_ALTCTL_ADACEN_Msk (0x1ul << SC_ALTCTL_ADACEN_Pos) /*!< SC_T::ALTCTL: ADACEN Mask */ + +#define SC_ALTCTL_RXBGTEN_Pos (12) /*!< SC_T::ALTCTL: RXBGTEN Position */ +#define SC_ALTCTL_RXBGTEN_Msk (0x1ul << SC_ALTCTL_RXBGTEN_Pos) /*!< SC_T::ALTCTL: RXBGTEN Mask */ + +#define SC_ALTCTL_ACTSTS0_Pos (13) /*!< SC_T::ALTCTL: ACTSTS0 Position */ +#define SC_ALTCTL_ACTSTS0_Msk (0x1ul << SC_ALTCTL_ACTSTS0_Pos) /*!< SC_T::ALTCTL: ACTSTS0 Mask */ + +#define SC_ALTCTL_ACTSTS1_Pos (14) /*!< SC_T::ALTCTL: ACTSTS1 Position */ +#define SC_ALTCTL_ACTSTS1_Msk (0x1ul << SC_ALTCTL_ACTSTS1_Pos) /*!< SC_T::ALTCTL: ACTSTS1 Mask */ + +#define SC_ALTCTL_ACTSTS2_Pos (15) /*!< SC_T::ALTCTL: ACTSTS2 Position */ +#define SC_ALTCTL_ACTSTS2_Msk (0x1ul << SC_ALTCTL_ACTSTS2_Pos) /*!< SC_T::ALTCTL: ACTSTS2 Mask */ + +#define SC_ALTCTL_SYNC_Pos (31) /*!< SC_T::ALTCTL: SYNC Position */ +#define SC_ALTCTL_SYNC_Msk (0x1ul << SC_ALTCTL_SYNC_Pos) /*!< SC_T::ALTCTL: SYNC Mask */ + +#define SC_EGT_EGT_Pos (0) /*!< SC_T::EGT: EGT Position */ +#define SC_EGT_EGT_Msk (0xfful << SC_EGT_EGT_Pos) /*!< SC_T::EGT: EGT Mask */ + +#define SC_RXTOUT_RFTM_Pos (0) /*!< SC_T::RXTOUT: RFTM Position */ +#define SC_RXTOUT_RFTM_Msk (0x1fful << SC_RXTOUT_RFTM_Pos) /*!< SC_T::RXTOUT: RFTM Mask */ + +#define SC_ETUCTL_ETURDIV_Pos (0) /*!< SC_T::ETUCTL: ETURDIV Position */ +#define SC_ETUCTL_ETURDIV_Msk (0xffful << SC_ETUCTL_ETURDIV_Pos) /*!< SC_T::ETUCTL: ETURDIV Mask */ + +#define SC_INTEN_RDAIEN_Pos (0) /*!< SC_T::INTEN: RDAIEN Position */ +#define SC_INTEN_RDAIEN_Msk (0x1ul << SC_INTEN_RDAIEN_Pos) /*!< SC_T::INTEN: RDAIEN Mask */ + +#define SC_INTEN_TBEIEN_Pos (1) /*!< SC_T::INTEN: TBEIEN Position */ +#define SC_INTEN_TBEIEN_Msk (0x1ul << SC_INTEN_TBEIEN_Pos) /*!< SC_T::INTEN: TBEIEN Mask */ + +#define SC_INTEN_TERRIEN_Pos (2) /*!< SC_T::INTEN: TERRIEN Position */ +#define SC_INTEN_TERRIEN_Msk (0x1ul << SC_INTEN_TERRIEN_Pos) /*!< SC_T::INTEN: TERRIEN Mask */ + +#define SC_INTEN_TMR0IEN_Pos (3) /*!< SC_T::INTEN: TMR0IEN Position */ +#define SC_INTEN_TMR0IEN_Msk (0x1ul << SC_INTEN_TMR0IEN_Pos) /*!< SC_T::INTEN: TMR0IEN Mask */ + +#define SC_INTEN_TMR1IEN_Pos (4) /*!< SC_T::INTEN: TMR1IEN Position */ +#define SC_INTEN_TMR1IEN_Msk (0x1ul << SC_INTEN_TMR1IEN_Pos) /*!< SC_T::INTEN: TMR1IEN Mask */ + +#define SC_INTEN_TMR2IEN_Pos (5) /*!< SC_T::INTEN: TMR2IEN Position */ +#define SC_INTEN_TMR2IEN_Msk (0x1ul << SC_INTEN_TMR2IEN_Pos) /*!< SC_T::INTEN: TMR2IEN Mask */ + +#define SC_INTEN_BGTIEN_Pos (6) /*!< SC_T::INTEN: BGTIEN Position */ +#define SC_INTEN_BGTIEN_Msk (0x1ul << SC_INTEN_BGTIEN_Pos) /*!< SC_T::INTEN: BGTIEN Mask */ + +#define SC_INTEN_CDIEN_Pos (7) /*!< SC_T::INTEN: CDIEN Position */ +#define SC_INTEN_CDIEN_Msk (0x1ul << SC_INTEN_CDIEN_Pos) /*!< SC_T::INTEN: CDIEN Mask */ + +#define SC_INTEN_INITIEN_Pos (8) /*!< SC_T::INTEN: INITIEN Position */ +#define SC_INTEN_INITIEN_Msk (0x1ul << SC_INTEN_INITIEN_Pos) /*!< SC_T::INTEN: INITIEN Mask */ + +#define SC_INTEN_RXTOIEN_Pos (9) /*!< SC_T::INTEN: RXTOIEN Position */ +#define SC_INTEN_RXTOIEN_Msk (0x1ul << SC_INTEN_RXTOIEN_Pos) /*!< SC_T::INTEN: RXTOIEN Mask */ + +#define SC_INTEN_ACERRIEN_Pos (10) /*!< SC_T::INTEN: ACERRIEN Position */ +#define SC_INTEN_ACERRIEN_Msk (0x1ul << SC_INTEN_ACERRIEN_Pos) /*!< SC_T::INTEN: ACERRIEN Mask */ + +#define SC_INTSTS_RDAIF_Pos (0) /*!< SC_T::INTSTS: RDAIF Position */ +#define SC_INTSTS_RDAIF_Msk (0x1ul << SC_INTSTS_RDAIF_Pos) /*!< SC_T::INTSTS: RDAIF Mask */ + +#define SC_INTSTS_TBEIF_Pos (1) /*!< SC_T::INTSTS: TBEIF Position */ +#define SC_INTSTS_TBEIF_Msk (0x1ul << SC_INTSTS_TBEIF_Pos) /*!< SC_T::INTSTS: TBEIF Mask */ + +#define SC_INTSTS_TERRIF_Pos (2) /*!< SC_T::INTSTS: TERRIF Position */ +#define SC_INTSTS_TERRIF_Msk (0x1ul << SC_INTSTS_TERRIF_Pos) /*!< SC_T::INTSTS: TERRIF Mask */ + +#define SC_INTSTS_TMR0IF_Pos (3) /*!< SC_T::INTSTS: TMR0IF Position */ +#define SC_INTSTS_TMR0IF_Msk (0x1ul << SC_INTSTS_TMR0IF_Pos) /*!< SC_T::INTSTS: TMR0IF Mask */ + +#define SC_INTSTS_TMR1IF_Pos (4) /*!< SC_T::INTSTS: TMR1IF Position */ +#define SC_INTSTS_TMR1IF_Msk (0x1ul << SC_INTSTS_TMR1IF_Pos) /*!< SC_T::INTSTS: TMR1IF Mask */ + +#define SC_INTSTS_TMR2IF_Pos (5) /*!< SC_T::INTSTS: TMR2IF Position */ +#define SC_INTSTS_TMR2IF_Msk (0x1ul << SC_INTSTS_TMR2IF_Pos) /*!< SC_T::INTSTS: TMR2IF Mask */ + +#define SC_INTSTS_BGTIF_Pos (6) /*!< SC_T::INTSTS: BGTIF Position */ +#define SC_INTSTS_BGTIF_Msk (0x1ul << SC_INTSTS_BGTIF_Pos) /*!< SC_T::INTSTS: BGTIF Mask */ + +#define SC_INTSTS_CDIF_Pos (7) /*!< SC_T::INTSTS: CDIF Position */ +#define SC_INTSTS_CDIF_Msk (0x1ul << SC_INTSTS_CDIF_Pos) /*!< SC_T::INTSTS: CDIF Mask */ + +#define SC_INTSTS_INITIF_Pos (8) /*!< SC_T::INTSTS: INITIF Position */ +#define SC_INTSTS_INITIF_Msk (0x1ul << SC_INTSTS_INITIF_Pos) /*!< SC_T::INTSTS: INITIF Mask */ + +#define SC_INTSTS_RXTOIF_Pos (9) /*!< SC_T::INTSTS: RXTOIF Position */ +#define SC_INTSTS_RXTOIF_Msk (0x1ul << SC_INTSTS_RXTOIF_Pos) /*!< SC_T::INTSTS: RXTOIF Mask */ + +#define SC_INTSTS_ACERRIF_Pos (10) /*!< SC_T::INTSTS: ACERRIF Position */ +#define SC_INTSTS_ACERRIF_Msk (0x1ul << SC_INTSTS_ACERRIF_Pos) /*!< SC_T::INTSTS: ACERRIF Mask */ + +#define SC_STATUS_RXOV_Pos (0) /*!< SC_T::STATUS: RXOV Position */ +#define SC_STATUS_RXOV_Msk (0x1ul << SC_STATUS_RXOV_Pos) /*!< SC_T::STATUS: RXOV Mask */ + +#define SC_STATUS_RXEMPTY_Pos (1) /*!< SC_T::STATUS: RXEMPTY Position */ +#define SC_STATUS_RXEMPTY_Msk (0x1ul << SC_STATUS_RXEMPTY_Pos) /*!< SC_T::STATUS: RXEMPTY Mask */ + +#define SC_STATUS_RXFULL_Pos (2) /*!< SC_T::STATUS: RXFULL Position */ +#define SC_STATUS_RXFULL_Msk (0x1ul << SC_STATUS_RXFULL_Pos) /*!< SC_T::STATUS: RXFULL Mask */ + +#define SC_STATUS_PEF_Pos (4) /*!< SC_T::STATUS: PEF Position */ +#define SC_STATUS_PEF_Msk (0x1ul << SC_STATUS_PEF_Pos) /*!< SC_T::STATUS: PEF Mask */ + +#define SC_STATUS_FEF_Pos (5) /*!< SC_T::STATUS: FEF Position */ +#define SC_STATUS_FEF_Msk (0x1ul << SC_STATUS_FEF_Pos) /*!< SC_T::STATUS: FEF Mask */ + +#define SC_STATUS_BEF_Pos (6) /*!< SC_T::STATUS: BEF Position */ +#define SC_STATUS_BEF_Msk (0x1ul << SC_STATUS_BEF_Pos) /*!< SC_T::STATUS: BEF Mask */ + +#define SC_STATUS_TXOV_Pos (8) /*!< SC_T::STATUS: TXOV Position */ +#define SC_STATUS_TXOV_Msk (0x1ul << SC_STATUS_TXOV_Pos) /*!< SC_T::STATUS: TXOV Mask */ + +#define SC_STATUS_TXEMPTY_Pos (9) /*!< SC_T::STATUS: TXEMPTY Position */ +#define SC_STATUS_TXEMPTY_Msk (0x1ul << SC_STATUS_TXEMPTY_Pos) /*!< SC_T::STATUS: TXEMPTY Mask */ + +#define SC_STATUS_TXFULL_Pos (10) /*!< SC_T::STATUS: TXFULL Position */ +#define SC_STATUS_TXFULL_Msk (0x1ul << SC_STATUS_TXFULL_Pos) /*!< SC_T::STATUS: TXFULL Mask */ + +#define SC_STATUS_CREMOVE_Pos (11) /*!< SC_T::STATUS: CREMOVE Position */ +#define SC_STATUS_CREMOVE_Msk (0x1ul << SC_STATUS_CREMOVE_Pos) /*!< SC_T::STATUS: CREMOVE Mask */ + +#define SC_STATUS_CINSERT_Pos (12) /*!< SC_T::STATUS: CINSERT Position */ +#define SC_STATUS_CINSERT_Msk (0x1ul << SC_STATUS_CINSERT_Pos) /*!< SC_T::STATUS: CINSERT Mask */ + +#define SC_STATUS_CDPINSTS_Pos (13) /*!< SC_T::STATUS: CDPINSTS Position */ +#define SC_STATUS_CDPINSTS_Msk (0x1ul << SC_STATUS_CDPINSTS_Pos) /*!< SC_T::STATUS: CDPINSTS Mask */ + +#define SC_STATUS_RXPOINT_Pos (16) /*!< SC_T::STATUS: RXPOINT Position */ +#define SC_STATUS_RXPOINT_Msk (0x7ul << SC_STATUS_RXPOINT_Pos) /*!< SC_T::STATUS: RXPOINT Mask */ + +#define SC_STATUS_RXRERR_Pos (21) /*!< SC_T::STATUS: RXRERR Position */ +#define SC_STATUS_RXRERR_Msk (0x1ul << SC_STATUS_RXRERR_Pos) /*!< SC_T::STATUS: RXRERR Mask */ + +#define SC_STATUS_RXOVERR_Pos (22) /*!< SC_T::STATUS: RXOVERR Position */ +#define SC_STATUS_RXOVERR_Msk (0x1ul << SC_STATUS_RXOVERR_Pos) /*!< SC_T::STATUS: RXOVERR Mask */ + +#define SC_STATUS_RXACT_Pos (23) /*!< SC_T::STATUS: RXACT Position */ +#define SC_STATUS_RXACT_Msk (0x1ul << SC_STATUS_RXACT_Pos) /*!< SC_T::STATUS: RXACT Mask */ + +#define SC_STATUS_TXPOINT_Pos (24) /*!< SC_T::STATUS: TXPOINT Position */ +#define SC_STATUS_TXPOINT_Msk (0x7ul << SC_STATUS_TXPOINT_Pos) /*!< SC_T::STATUS: TXPOINT Mask */ + +#define SC_STATUS_TXRERR_Pos (29) /*!< SC_T::STATUS: TXRERR Position */ +#define SC_STATUS_TXRERR_Msk (0x1ul << SC_STATUS_TXRERR_Pos) /*!< SC_T::STATUS: TXRERR Mask */ + +#define SC_STATUS_TXOVERR_Pos (30) /*!< SC_T::STATUS: TXOVERR Position */ +#define SC_STATUS_TXOVERR_Msk (0x1ul << SC_STATUS_TXOVERR_Pos) /*!< SC_T::STATUS: TXOVERR Mask */ + +#define SC_STATUS_TXACT_Pos (31) /*!< SC_T::STATUS: TXACT Position */ +#define SC_STATUS_TXACT_Msk (0x1ul << SC_STATUS_TXACT_Pos) /*!< SC_T::STATUS: TXACT Mask */ + +#define SC_PINCTL_PWREN_Pos (0) /*!< SC_T::PINCTL: PWREN Position */ +#define SC_PINCTL_PWREN_Msk (0x1ul << SC_PINCTL_PWREN_Pos) /*!< SC_T::PINCTL: PWREN Mask */ + +#define SC_PINCTL_RSTEN_Pos (1) /*!< SC_T::PINCTL: RSTEN Position */ +#define SC_PINCTL_RSTEN_Msk (0x1ul << SC_PINCTL_RSTEN_Pos) /*!< SC_T::PINCTL: RSTEN Mask */ + +#define SC_PINCTL_CLKKEEP_Pos (6) /*!< SC_T::PINCTL: CLKKEEP Position */ +#define SC_PINCTL_CLKKEEP_Msk (0x1ul << SC_PINCTL_CLKKEEP_Pos) /*!< SC_T::PINCTL: CLKKEEP Mask */ + +#define SC_PINCTL_SCDATA_Pos (9) /*!< SC_T::PINCTL: SCDATA Position */ +#define SC_PINCTL_SCDATA_Msk (0x1ul << SC_PINCTL_SCDATA_Pos) /*!< SC_T::PINCTL: SCDATA Mask */ + +#define SC_PINCTL_PWRINV_Pos (11) /*!< SC_T::PINCTL: PWRINV Position */ +#define SC_PINCTL_PWRINV_Msk (0x1ul << SC_PINCTL_PWRINV_Pos) /*!< SC_T::PINCTL: PWRINV Mask */ + +#define SC_PINCTL_DATASTS_Pos (16) /*!< SC_T::PINCTL: DATASTS Position */ +#define SC_PINCTL_DATASTS_Msk (0x1ul << SC_PINCTL_DATASTS_Pos) /*!< SC_T::PINCTL: DATASTS Mask */ + +#define SC_PINCTL_PWRSTS_Pos (17) /*!< SC_T::PINCTL: PWRSTS Position */ +#define SC_PINCTL_PWRSTS_Msk (0x1ul << SC_PINCTL_PWRSTS_Pos) /*!< SC_T::PINCTL: PWRSTS Mask */ + +#define SC_PINCTL_RSTSTS_Pos (18) /*!< SC_T::PINCTL: RSTSTS Position */ +#define SC_PINCTL_RSTSTS_Msk (0x1ul << SC_PINCTL_RSTSTS_Pos) /*!< SC_T::PINCTL: RSTSTS Mask */ + +#define SC_PINCTL_SYNC_Pos (30) /*!< SC_T::PINCTL: SYNC Position */ +#define SC_PINCTL_SYNC_Msk (0x1ul << SC_PINCTL_SYNC_Pos) /*!< SC_T::PINCTL: SYNC Mask */ + +#define SC_TMRCTL0_CNT_Pos (0) /*!< SC_T::TMRCTL0: CNT Position */ +#define SC_TMRCTL0_CNT_Msk (0xfffffful << SC_TMRCTL0_CNT_Pos) /*!< SC_T::TMRCTL0: CNT Mask */ + +#define SC_TMRCTL0_OPMODE_Pos (24) /*!< SC_T::TMRCTL0: OPMODE Position */ +#define SC_TMRCTL0_OPMODE_Msk (0xful << SC_TMRCTL0_OPMODE_Pos) /*!< SC_T::TMRCTL0: OPMODE Mask */ + +#define SC_TMRCTL0_SYNC_Pos (31) /*!< SC_T::TMRCTL0: SYNC Position */ +#define SC_TMRCTL0_SYNC_Msk (0x1ul << SC_TMRCTL0_SYNC_Pos) /*!< SC_T::TMRCTL0: SYNC Mask */ + +#define SC_TMRCTL1_CNT_Pos (0) /*!< SC_T::TMRCTL1: CNT Position */ +#define SC_TMRCTL1_CNT_Msk (0xfful << SC_TMRCTL1_CNT_Pos) /*!< SC_T::TMRCTL1: CNT Mask */ + +#define SC_TMRCTL1_OPMODE_Pos (24) /*!< SC_T::TMRCTL1: OPMODE Position */ +#define SC_TMRCTL1_OPMODE_Msk (0xful << SC_TMRCTL1_OPMODE_Pos) /*!< SC_T::TMRCTL1: OPMODE Mask */ + +#define SC_TMRCTL1_SYNC_Pos (31) /*!< SC_T::TMRCTL1: SYNC Position */ +#define SC_TMRCTL1_SYNC_Msk (0x1ul << SC_TMRCTL1_SYNC_Pos) /*!< SC_T::TMRCTL1: SYNC Mask */ + +#define SC_TMRCTL2_CNT_Pos (0) /*!< SC_T::TMRCTL2: CNT Position */ +#define SC_TMRCTL2_CNT_Msk (0xfful << SC_TMRCTL2_CNT_Pos) /*!< SC_T::TMRCTL2: CNT Mask */ + +#define SC_TMRCTL2_OPMODE_Pos (24) /*!< SC_T::TMRCTL2: OPMODE Position */ +#define SC_TMRCTL2_OPMODE_Msk (0xful << SC_TMRCTL2_OPMODE_Pos) /*!< SC_T::TMRCTL2: OPMODE Mask */ + +#define SC_TMRCTL2_SYNC_Pos (31) /*!< SC_T::TMRCTL2: SYNC Position */ +#define SC_TMRCTL2_SYNC_Msk (0x1ul << SC_TMRCTL2_SYNC_Pos) /*!< SC_T::TMRCTL2: SYNC Mask */ + +#define SC_UARTCTL_UARTEN_Pos (0) /*!< SC_T::UARTCTL: UARTEN Position */ +#define SC_UARTCTL_UARTEN_Msk (0x1ul << SC_UARTCTL_UARTEN_Pos) /*!< SC_T::UARTCTL: UARTEN Mask */ + +#define SC_UARTCTL_WLS_Pos (4) /*!< SC_T::UARTCTL: WLS Position */ +#define SC_UARTCTL_WLS_Msk (0x3ul << SC_UARTCTL_WLS_Pos) /*!< SC_T::UARTCTL: WLS Mask */ + +#define SC_UARTCTL_PBOFF_Pos (6) /*!< SC_T::UARTCTL: PBOFF Position */ +#define SC_UARTCTL_PBOFF_Msk (0x1ul << SC_UARTCTL_PBOFF_Pos) /*!< SC_T::UARTCTL: PBOFF Mask */ + +#define SC_UARTCTL_OPE_Pos (7) /*!< SC_T::UARTCTL: OPE Position */ +#define SC_UARTCTL_OPE_Msk (0x1ul << SC_UARTCTL_OPE_Pos) /*!< SC_T::UARTCTL: OPE Mask */ + +#define SC_ACTCTL_T1EXT_Pos (0) /*!< SC_T::ACTCTL: T1EXT Position */ +#define SC_ACTCTL_T1EXT_Msk (0x1ful << SC_ACTCTL_T1EXT_Pos) /*!< SC_T::ACTCTL: T1EXT Mask */ + +/**@}*/ /* SC_CONST */ +/**@}*/ /* end of SC register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __SC_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/sdh_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/sdh_reg.h new file mode 100644 index 00000000000..56f42e82005 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/sdh_reg.h @@ -0,0 +1,541 @@ +/**************************************************************************//** + * @file sdh_reg.h + * @version V1.00 + * @brief SDH register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __SDH_REG_H__ +#define __SDH_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup SDH SD Card Host Interface(SDH) + Memory Mapped Structure for SDH Controller +@{ */ + +typedef struct +{ + + /** + * @var SDH_T::FB + * Offset: 0x00~0x7C Shared Buffer (FIFO) + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |BUFFER |Shared Buffer + * | | |Buffer for DMA transfer + * @var SDH_T::DMACTL + * Offset: 0x400 DMA Control and Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |DMAEN |DMA Engine Enable Bit + * | | |0 = DMA Disabled. + * | | |1 = DMA Enabled. + * | | |If this bit is cleared, DMA will ignore all requests from SD host and force bus master into IDLE state. + * | | |Note: If target abort is occurred, DMAEN will be cleared. + * |[1] |DMARST |Software Engine Reset + * | | |0 = No effect. + * | | |1 = Reset internal state machine and pointers + * | | |The contents of control register will not be cleared + * | | |This bit will auto be cleared after few clock cycles. + * | | |Note: The software reset DMA related registers. + * |[3] |SGEN |Scatter-gather Function Enable Bit + * | | |0 = Scatter-gather function Disabled (DMA will treat the starting address in DMASAR as starting pointer of a single block memory). + * | | |1 = Scatter-gather function Enabled (DMA will treat the starting address in DMASAR as a starting address of Physical Address Descriptor (PAD) table + * | | |The format of these Pads' will be described later). + * |[9] |DMABUSY |DMA Transfer Is in Progress + * | | |This bit indicates if SD Host is granted and doing DMA transfer or not. + * | | |0 = DMA transfer is not in progress. + * | | |1 = DMA transfer is in progress. + * @var SDH_T::DMASA + * Offset: 0x408 DMA Transfer Starting Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ORDER |Determined to the PAD Table Fetching Is in Order or Out of Order + * | | |0 = PAD table is fetched in order. + * | | |1 = PAD table is fetched out of order. + * | | |Note: the bit0 is valid in scatter-gather mode when SGEN = 1. + * |[31:1] |DMASA |DMA Transfer Starting Address + * | | |This field pads 0 as least significant bit indicates a 32-bit starting address of system memory (SRAM) for DMA to retrieve or fill in data. + * | | |If DMA is not in normal mode, this field will be interpreted as a starting address of Physical Address Descriptor (PAD) table. + * | | |Note: Starting address of the SRAM must be word aligned, for example, 0x0000_0000, 0x0000_0004. + * @var SDH_T::DMABCNT + * Offset: 0x40C DMA Transfer Byte Count Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[25:0] |BCNT |DMA Transfer Byte Count (Read Only) + * | | |This field indicates the remained byte count of DMA transfer + * | | |The value of this field is valid only when DMA is busy; otherwise, it is 0. + * @var SDH_T::DMAINTEN + * Offset: 0x410 DMA Interrupt Enable Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ABORTIEN |DMA Read/Write Target Abort Interrupt Enable Bit + * | | |0 = Target abort interrupt generation Disabled during DMA transfer. + * | | |1 = Target abort interrupt generation Enabled during DMA transfer. + * |[1] |WEOTIEN |Wrong EOT Encountered Interrupt Enable Bit + * | | |0 = Interrupt generation Disabled when wrong EOT is encountered. + * | | |1 = Interrupt generation Enabled when wrong EOT is encountered. + * @var SDH_T::DMAINTSTS + * Offset: 0x414 DMA Interrupt Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ABORTIF |DMA Read/Write Target Abort Interrupt Flag + * | | |0 = No bus ERROR response received. + * | | |1 = Bus ERROR response received. + * | | |Note1: This bit is read only, but can be cleared by writing '1' to it. + * | | |Note2: When DMA's bus master received ERROR response, it means that target abort is happened + * | | |DMA will stop transfer and respond this event and then go to IDLE state + * | | |When target abort occurred or WEOTIF is set, software must reset DMA and SD host, and then transfer those data again. + * |[1] |WEOTIF |Wrong EOT Encountered Interrupt Flag + * | | |When DMA Scatter-Gather function is enabled, and EOT of the descriptor is encountered before DMA transfer finished (that means the total sector count of all PAD is less than the sector count of SD host), this bit will be set. + * | | |0 = No EOT encountered before DMA transfer finished. + * | | |1 = EOT encountered before DMA transfer finished. + * | | |Note: This bit is read only, but can be cleared by writing '1' to it. + * @var SDH_T::GCTL + * Offset: 0x800 Global Control and Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |GCTLRST |Software Engine Reset + * | | |0 = No effect. + * | | |1 = Reset SD host + * | | |The contents of control register will not be cleared + * | | |This bit will auto cleared after reset complete. + * |[1] |SDEN |Secure Digital Functionality Enable Bit + * | | |0 = SD functionality disabled. + * | | |1 = SD functionality enabled. + * @var SDH_T::GINTEN + * Offset: 0x804 Global Interrupt Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |DTAIEN |DMA READ/WRITE Target Abort Interrupt Enable Bit + * | | |0 = DMA READ/WRITE target abort interrupt generation disabled. + * | | |1 = DMA READ/WRITE target abort interrupt generation enabled. + * @var SDH_T::GINTSTS + * Offset: 0x808 Global Interrupt Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |DTAIF |DMA READ/WRITE Target Abort Interrupt Flag (Read Only) + * | | |This bit indicates DMA received an ERROR response from internal AHB bus during DMA read/write operation + * | | |When Target Abort is occurred, please reset all engine. + * | | |0 = No bus ERROR response received. + * | | |1 = Bus ERROR response received. + * | | |Note: This bit is read only, but can be cleared by writing '1' to it. + * @var SDH_T::CTL + * Offset: 0x820 SD Control and Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |COEN |Command Output Enable Bit + * | | |0 = No effect. (Please use DMARST (SDH_CTL [0]) to clear this bit.) + * | | |1 = Enabled, SD host will output a command to SD card. + * | | |Note: When operation is finished, this bit will be cleared automatically, so don't write 0 to this bit (the controller will be abnormal). + * |[1] |RIEN |Response Input Enable Bit + * | | |0 = No effect. (Please use DMARST (SDH_CTL [0]) to clear this bit.) + * | | |1 = Enabled, SD host will wait to receive a response from SD card. + * | | |Note: When operation is finished, this bit will be cleared automatically, so don't write 0 to this bit (the controller will be abnormal). + * |[2] |DIEN |Data Input Enable Bit + * | | |0 = No effect. (Please use DMARST (SDH_CTL [0]) to clear this bit.) + * | | |1 = Enabled, SD host will wait to receive block data and the CRC16 value from SD card. + * | | |Note: When operation is finished, this bit will be cleared automatically, so don't write 0 to this bit (the controller will be abnormal). + * |[3] |DOEN |Data Output Enable Bit + * | | |0 = No effect. (Please use DMARST (SDH_CTL [0]) to clear this bit.) + * | | |1 = Enabled, SD host will transfer block data and the CRC16 value to SD card. + * | | |Note: When operation is finished, this bit will be cleared automatically, so don't write 0 to this bit (the controller will be abnormal). + * |[4] |R2EN |Response R2 Input Enable Bit + * | | |0 = No effect. (Please use DMARST (SDH_CTL [0]) to clear this bit.) + * | | |1 = Enabled, SD host will wait to receive a response R2 from SD card and store the response data into DMC's flash buffer (exclude CRC7). + * | | |Note: When operation is finished, this bit will be cleared automatically, so don't write 0 to this bit (the controller will be abnormal). + * |[5] |CLK74OEN |Initial 74 Clock Cycles Output Enable Bit + * | | |0 = No effect. (Please use DMARST (SDH_CTL [0]) to clear this bit.) + * | | |1 = Enabled, SD host will output 74 clock cycles to SD card. + * | | |Note: When operation is finished, this bit will be cleared automatically, so don't write 0 to this bit (the controller will be abnormal). + * |[6] |CLK8OEN |Generating 8 Clock Cycles Output Enable Bit + * | | |0 = No effect. (Please use DMARST (SDH_CTL [0]) to clear this bit.) + * | | |1 = Enabled, SD host will output 8 clock cycles. + * | | |Note: When operation is finished, this bit will be cleared automatically, so don't write 0 to this bit (the controller will be abnormal). + * |[7] |CLKKEEP |SD Clock Enable Control + * | | |0 = SD host decided when to output clock and when to disable clock output automatically. + * | | |1 = SD clock always keeps free running. + * |[13:8] |CMDCODE |SD Command Code + * | | |This register contains the SD command code (0x00 - 0x3F). + * |[14] |CTLRST |Software Engine Reset + * | | |0 = No effect. + * | | |1 = Reset the internal state machine and counters + * | | |The contents of control register will not be cleared (but RIEN, DIEN, DOEN and R2_EN will be cleared) + * | | |This bit will be auto cleared after few clock cycles. + * |[15] |DBW |SD Data Bus Width (for 1-bit / 4-bit Selection) + * | | |0 = Data bus width is 1-bit. + * | | |1 = Data bus width is 4-bit. + * |[23:16] |BLKCNT |Block Counts to Be Transferred or Received + * | | |This field contains the block counts for data-in and data-out transfer + * | | |For READ_MULTIPLE_BLOCK and WRITE_MULTIPLE_BLOCK command, software can use this function to accelerate data transfer and improve performance + * | | |Don't fill 0x0 to this field. + * | | |Note: For READ_MULTIPLE_BLOCK and WRITE_MULTIPLE_BLOCK command, the actual total length is BLKCNT * (BLKLEN +1). + * |[27:24] |SDNWR |NWR Parameter for Block Write Operation + * | | |This value indicates the NWR parameter for data block write operation in SD clock counts + * | | |The actual clock cycle will be SDNWR+1. + * @var SDH_T::CMDARG + * Offset: 0x824 SD Command Argument Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |ARGUMENT |SD Command Argument + * | | |This register contains a 32-bit value specifies the argument of SD command from host controller to SD card + * | | |Before trigger COEN (SDH_CTL [0]), software should fill argument in this field. + * @var SDH_T::INTEN + * Offset: 0x828 SD Interrupt Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BLKDIEN |Block Transfer Done Interrupt Enable Bit + * | | |0 = BLKDIF (SDH_INTEN[0]) trigger interrupt Disable. + * | | |1 = BLKDIF (SDH_INTEN[0]) trigger interrupt Enabled. + * |[1] |CRCIEN |CRC7, CRC16 and CRC Status Error Interrupt Enable Bit + * | | |0 = CRCIF (SDH_INTEN[1]) trigger interrupt Disable. + * | | |1 = CRCIF (SDH_INTEN[1]) trigger interrupt Enabled. + * |[8] |CDIEN |SD Card Detection Interrupt Enable Bit + * | | |Enable/Disable interrupts generation of SD controller when card is inserted or removed. + * | | |0 = CDIF (SDH_INTEN[8]) trigger interrupt Disable. + * | | |1 = CDIF (SDH_INTEN[8]) trigger interrupt Enabled. + * |[12] |RTOIEN |Response Time-out Interrupt Enable Bit + * | | |Enable/Disable interrupts generation of SD controller when receiving response or R2 time-out + * | | |Time-out value is specified at TOUT register. + * | | |0 = RTOIF (SDH_INTEN[12]) trigger interrupt Disabled. + * | | |1 = RTOIF (SDH_INTEN[12]) trigger interrupt Enabled. + * |[13] |DITOIEN |Data Input Time-out Interrupt Enable Bit + * | | |Enable/Disable interrupts generation of SD controller when data input time-out + * | | |Time-out value is specified at TOUT register. + * | | |0 = DITOIF (SDH_INTEN[13]) trigger interrupt Disabled. + * | | |1 = DITOIF (SDH_INTEN[13]) trigger interrupt Enabled. + * |[14] |WKIEN |Wake-up Signal Generating Enable Bit + * | | |Enable/Disable wake-up signal generating of SD host when current using SD card issues an interrupt (wake-up) via DAT [1] to host. + * | | |0 = SD Card interrupt to wake-up chip Disabled. + * | | |1 = SD Card interrupt to wake-up chip Enabled. + * |[30] |CDSRC |SD Card Detect Source Selection + * | | |0 = From SD card's DAT3 pin. + * | | |Host need clock to got data on pin DAT3 + * | | |Please make sure CLKKEEP (SDH_CTL[7]) is 1 in order to generate free running clock for DAT3 pin. + * | | |1 = From GPIO pin. + * @var SDH_T::INTSTS + * Offset: 0x82C SD Interrupt Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BLKDIF |Block Transfer Done Interrupt Flag (Read Only) + * | | |This bit indicates that SD host has finished all data-in or data-out block transfer + * | | |If there is a CRC16 error or incorrect CRC status during multiple block data transfer, the transfer will be broken and this bit will also be set. + * | | |0 = Not finished yet. + * | | |1 = Done. + * | | |Note: This bit is read only, but can be cleared by writing '1' to it. + * |[1] |CRCIF |CRC7, CRC16 and CRC Status Error Interrupt Flag (Read Only) + * | | |This bit indicates that SD host has occurred CRC error during response in, data-in or data-out (CRC status error) transfer + * | | |When CRC error is occurred, software should reset SD engine + * | | |Some response (ex + * | | |R3) doesn't have CRC7 information with it; SD host will still calculate CRC7, get CRC error and set this flag + * | | |In this condition, software should ignore CRC error and clears this bit manually. + * | | |0 = No CRC error is occurred. + * | | |1 = CRC error is occurred. + * | | |Note: This bit is read only, but can be cleared by writing '1' to it. + * |[2] |CRC7 |CRC7 Check Status (Read Only) + * | | |SD host will check CRC7 correctness during each response in + * | | |If that response does not contain CRC7 information (ex + * | | |R3), then software should turn off CRCIEN (SDH_INTEN[1]) and ignore this bit. + * | | |0 = Fault. + * | | |1 = OK. + * |[3] |CRC16 |CRC16 Check Status of Data-in Transfer (Read Only) + * | | |SD host will check CRC16 correctness after data-in transfer. + * | | |0 = Fault. + * | | |1 = OK. + * |[6:4] |CRCSTS |CRC Status Value of Data-out Transfer (Read Only) + * | | |SD host will record CRC status of data-out transfer + * | | |Software could use this value to identify what type of error is during data-out transfer. + * | | |010 = Positive CRC status. + * | | |101 = Negative CRC status. + * | | |111 = SD card programming error occurs. + * |[7] |DAT0STS |DAT0 Pin Status of Current Selected SD Port (Read Only) + * | | |This bit is the DAT0 pin status of current selected SD port. + * |[8] |CDIF |SD Card Detection Interrupt Flag (Read Only) + * | | |This bit indicates that SD card is inserted or removed + * | | |Only when CDIEN (SDH_INTEN[8]) is set to 1, this bit is active. + * | | |0 = No card is inserted or removed. + * | | |1 = There is a card inserted in or removed from SD. + * | | |Note: This bit is read only, but can be cleared by writing '1' to it. + * |[12] |RTOIF |Response Time-out Interrupt Flag (Read Only) + * | | |This bit indicates that SD host counts to time-out value when receiving response or R2 (waiting start bit). + * | | |0 = Not time-out. + * | | |1 = Response time-out. + * | | |Note: This bit is read only, but can be cleared by writing '1' to it. + * |[13] |DITOIF |Data Input Time-out Interrupt Flag (Read Only) + * | | |This bit indicates that SD host counts to time-out value when receiving data (waiting start bit). + * | | |0 = Not time-out. + * | | |1 = Data input time-out. + * | | |Note: This bit is read only, but can be cleared by writing '1' to it. + * |[16] |CDSTS |Card Detect Status of SD (Read Only) + * | | |This bit indicates the card detect pin status of SD, and is used for card detection + * | | |When there is a card inserted in or removed from SD, software should check this bit to confirm if there is really a card insertion or removal. + * | | |If CDSRC (SDH_INTEN[30]) = 0, to select DAT3 for card detection:. + * | | |0 = Card removed. + * | | |1 = Card inserted. + * | | |If CDSRC (SDH_INTEN[30]) = 1, to select GPIO for card detection:. + * | | |0 = Card inserted. + * | | |1 = Card removed. + * |[18] |DAT1STS |DAT1 Pin Status of SD Port (Read Only) + * | | |This bit indicates the DAT1 pin status of SD port. + * @var SDH_T::RESP0 + * Offset: 0x830 SD Receiving Response Token Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |RESPTK0 |SD Receiving Response Token 0 + * | | |SD host controller will receive a response token for getting a reply from SD card when RIEN (SDH_CTL[1]) is set + * | | |This field contains response bit 47-16 of the response token. + * @var SDH_T::RESP1 + * Offset: 0x834 SD Receiving Response Token Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |RESPTK1 |SD Receiving Response Token 1 + * | | |SD host controller will receive a response token for getting a reply from SD card when RIEN (SDH_CTL[1]) is set + * | | |This register contains the bit 15-8 of the response token. + * @var SDH_T::BLEN + * Offset: 0x838 SD Block Length Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[10:0] |BLKLEN |SD BLOCK LENGTH in Byte Unit + * | | |An 11-bit value specifies the SD transfer byte count of a block + * | | |The actual byte count is equal to BLKLEN+1. + * | | |Note: The default SD block length is 512 bytes + * @var SDH_T::TOUT + * Offset: 0x83C SD Response/Data-in Time-out Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:0] |TOUT |SD Response/Data-in Time-out Value + * | | |A 24-bit value specifies the time-out counts of response and data input + * | | |SD host controller will wait start bit of response or data-in until this value reached + * | | |The time period depends on SD engine clock frequency + * | | |Do not write a small number into this field, or you may never get response or data due to time-out. + * | | |Note: Filling 0x0 into this field will disable hardware time-out function. + */ + + __IO uint32_t FB[32]; /*!< Shared Buffer (FIFO) */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[224]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t DMACTL; /*!< [0x0400] DMA Control and Status Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE1[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t DMASA; /*!< [0x0408] DMA Transfer Starting Address Register */ + __I uint32_t DMABCNT; /*!< [0x040c] DMA Transfer Byte Count Register */ + __IO uint32_t DMAINTEN; /*!< [0x0410] DMA Interrupt Enable Control Register */ + __IO uint32_t DMAINTSTS; /*!< [0x0414] DMA Interrupt Status Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE2[250]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t GCTL; /*!< [0x0800] Global Control and Status Register */ + __IO uint32_t GINTEN; /*!< [0x0804] Global Interrupt Control Register */ + __I uint32_t GINTSTS; /*!< [0x0808] Global Interrupt Status Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE3[5]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t CTL; /*!< [0x0820] SD Control and Status Register */ + __IO uint32_t CMDARG; /*!< [0x0824] SD Command Argument Register */ + __IO uint32_t INTEN; /*!< [0x0828] SD Interrupt Control Register */ + __IO uint32_t INTSTS; /*!< [0x082c] SD Interrupt Status Register */ + __I uint32_t RESP0; /*!< [0x0830] SD Receiving Response Token Register 0 */ + __I uint32_t RESP1; /*!< [0x0834] SD Receiving Response Token Register 1 */ + __IO uint32_t BLEN; /*!< [0x0838] SD Block Length Register */ + __IO uint32_t TOUT; /*!< [0x083c] SD Response/Data-in Time-out Register */ + +} SDH_T; + + +/** + @addtogroup SDH_CONST SDH Bit Field Definition + Constant Definitions for SDH Controller +@{ */ + +#define SDH_DMACTL_DMAEN_Pos (0) /*!< SDH_T::DMACTL: DMAEN Position */ +#define SDH_DMACTL_DMAEN_Msk (0x1ul << SDH_DMACTL_DMAEN_Pos) /*!< SDH_T::DMACTL: DMAEN Mask */ + +#define SDH_DMACTL_DMARST_Pos (1) /*!< SDH_T::DMACTL: DMARST Position */ +#define SDH_DMACTL_DMARST_Msk (0x1ul << SDH_DMACTL_DMARST_Pos) /*!< SDH_T::DMACTL: DMARST Mask */ + +#define SDH_DMACTL_SGEN_Pos (3) /*!< SDH_T::DMACTL: SGEN Position */ +#define SDH_DMACTL_SGEN_Msk (0x1ul << SDH_DMACTL_SGEN_Pos) /*!< SDH_T::DMACTL: SGEN Mask */ + +#define SDH_DMACTL_DMABUSY_Pos (9) /*!< SDH_T::DMACTL: DMABUSY Position */ +#define SDH_DMACTL_DMABUSY_Msk (0x1ul << SDH_DMACTL_DMABUSY_Pos) /*!< SDH_T::DMACTL: DMABUSY Mask */ + +#define SDH_DMASA_ORDER_Pos (0) /*!< SDH_T::DMASA: ORDER Position */ +#define SDH_DMASA_ORDER_Msk (0x1ul << SDH_DMASA_ORDER_Pos) /*!< SDH_T::DMASA: ORDER Mask */ + +#define SDH_DMASA_DMASA_Pos (1) /*!< SDH_T::DMASA: DMASA Position */ +#define SDH_DMASA_DMASA_Msk (0x7ffffffful << SDH_DMASA_DMASA_Pos) /*!< SDH_T::DMASA: DMASA Mask */ + +#define SDH_DMABCNT_BCNT_Pos (0) /*!< SDH_T::DMABCNT: BCNT Position */ +#define SDH_DMABCNT_BCNT_Msk (0x3fffffful << SDH_DMABCNT_BCNT_Pos) /*!< SDH_T::DMABCNT: BCNT Mask */ + +#define SDH_DMAINTEN_ABORTIEN_Pos (0) /*!< SDH_T::DMAINTEN: ABORTIEN Position */ +#define SDH_DMAINTEN_ABORTIEN_Msk (0x1ul << SDH_DMAINTEN_ABORTIEN_Pos) /*!< SDH_T::DMAINTEN: ABORTIEN Mask */ + +#define SDH_DMAINTEN_WEOTIEN_Pos (1) /*!< SDH_T::DMAINTEN: WEOTIEN Position */ +#define SDH_DMAINTEN_WEOTIEN_Msk (0x1ul << SDH_DMAINTEN_WEOTIEN_Pos) /*!< SDH_T::DMAINTEN: WEOTIEN Mask */ + +#define SDH_DMAINTSTS_ABORTIF_Pos (0) /*!< SDH_T::DMAINTSTS: ABORTIF Position */ +#define SDH_DMAINTSTS_ABORTIF_Msk (0x1ul << SDH_DMAINTSTS_ABORTIF_Pos) /*!< SDH_T::DMAINTSTS: ABORTIF Mask */ + +#define SDH_DMAINTSTS_WEOTIF_Pos (1) /*!< SDH_T::DMAINTSTS: WEOTIF Position */ +#define SDH_DMAINTSTS_WEOTIF_Msk (0x1ul << SDH_DMAINTSTS_WEOTIF_Pos) /*!< SDH_T::DMAINTSTS: WEOTIF Mask */ + +#define SDH_GCTL_GCTLRST_Pos (0) /*!< SDH_T::GCTL: GCTLRST Position */ +#define SDH_GCTL_GCTLRST_Msk (0x1ul << SDH_GCTL_GCTLRST_Pos) /*!< SDH_T::GCTL: GCTLRST Mask */ + +#define SDH_GCTL_SDEN_Pos (1) /*!< SDH_T::GCTL: SDEN Position */ +#define SDH_GCTL_SDEN_Msk (0x1ul << SDH_GCTL_SDEN_Pos) /*!< SDH_T::GCTL: SDEN Mask */ + +#define SDH_GINTEN_DTAIEN_Pos (0) /*!< SDH_T::GINTEN: DTAIEN Position */ +#define SDH_GINTEN_DTAIEN_Msk (0x1ul << SDH_GINTEN_DTAIEN_Pos) /*!< SDH_T::GINTEN: DTAIEN Mask */ + +#define SDH_GINTSTS_DTAIF_Pos (0) /*!< SDH_T::GINTSTS: DTAIF Position */ +#define SDH_GINTSTS_DTAIF_Msk (0x1ul << SDH_GINTSTS_DTAIF_Pos) /*!< SDH_T::GINTSTS: DTAIF Mask */ + +#define SDH_CTL_COEN_Pos (0) /*!< SDH_T::CTL: COEN Position */ +#define SDH_CTL_COEN_Msk (0x1ul << SDH_CTL_COEN_Pos) /*!< SDH_T::CTL: COEN Mask */ + +#define SDH_CTL_RIEN_Pos (1) /*!< SDH_T::CTL: RIEN Position */ +#define SDH_CTL_RIEN_Msk (0x1ul << SDH_CTL_RIEN_Pos) /*!< SDH_T::CTL: RIEN Mask */ + +#define SDH_CTL_DIEN_Pos (2) /*!< SDH_T::CTL: DIEN Position */ +#define SDH_CTL_DIEN_Msk (0x1ul << SDH_CTL_DIEN_Pos) /*!< SDH_T::CTL: DIEN Mask */ + +#define SDH_CTL_DOEN_Pos (3) /*!< SDH_T::CTL: DOEN Position */ +#define SDH_CTL_DOEN_Msk (0x1ul << SDH_CTL_DOEN_Pos) /*!< SDH_T::CTL: DOEN Mask */ + +#define SDH_CTL_R2EN_Pos (4) /*!< SDH_T::CTL: R2EN Position */ +#define SDH_CTL_R2EN_Msk (0x1ul << SDH_CTL_R2EN_Pos) /*!< SDH_T::CTL: R2EN Mask */ + +#define SDH_CTL_CLK74OEN_Pos (5) /*!< SDH_T::CTL: CLK74OEN Position */ +#define SDH_CTL_CLK74OEN_Msk (0x1ul << SDH_CTL_CLK74OEN_Pos) /*!< SDH_T::CTL: CLK74OEN Mask */ + +#define SDH_CTL_CLK8OEN_Pos (6) /*!< SDH_T::CTL: CLK8OEN Position */ +#define SDH_CTL_CLK8OEN_Msk (0x1ul << SDH_CTL_CLK8OEN_Pos) /*!< SDH_T::CTL: CLK8OEN Mask */ + +#define SDH_CTL_CLKKEEP_Pos (7) /*!< SDH_T::CTL: CLKKEEP Position */ +#define SDH_CTL_CLKKEEP_Msk (0x1ul << SDH_CTL_CLKKEEP_Pos) /*!< SDH_T::CTL: CLKKEEP Mask */ + +#define SDH_CTL_CMDCODE_Pos (8) /*!< SDH_T::CTL: CMDCODE Position */ +#define SDH_CTL_CMDCODE_Msk (0x3ful << SDH_CTL_CMDCODE_Pos) /*!< SDH_T::CTL: CMDCODE Mask */ + +#define SDH_CTL_CTLRST_Pos (14) /*!< SDH_T::CTL: CTLRST Position */ +#define SDH_CTL_CTLRST_Msk (0x1ul << SDH_CTL_CTLRST_Pos) /*!< SDH_T::CTL: CTLRST Mask */ + +#define SDH_CTL_DBW_Pos (15) /*!< SDH_T::CTL: DBW Position */ +#define SDH_CTL_DBW_Msk (0x1ul << SDH_CTL_DBW_Pos) /*!< SDH_T::CTL: DBW Mask */ + +#define SDH_CTL_BLKCNT_Pos (16) /*!< SDH_T::CTL: BLKCNT Position */ +#define SDH_CTL_BLKCNT_Msk (0xfful << SDH_CTL_BLKCNT_Pos) /*!< SDH_T::CTL: BLKCNT Mask */ + +#define SDH_CTL_SDNWR_Pos (24) /*!< SDH_T::CTL: SDNWR Position */ +#define SDH_CTL_SDNWR_Msk (0xful << SDH_CTL_SDNWR_Pos) /*!< SDH_T::CTL: SDNWR Mask */ + +#define SDH_CMDARG_ARGUMENT_Pos (0) /*!< SDH_T::CMDARG: ARGUMENT Position */ +#define SDH_CMDARG_ARGUMENT_Msk (0xfffffffful << SDH_CMDARG_ARGUMENT_Pos) /*!< SDH_T::CMDARG: ARGUMENT Mask */ + +#define SDH_INTEN_BLKDIEN_Pos (0) /*!< SDH_T::INTEN: BLKDIEN Position */ +#define SDH_INTEN_BLKDIEN_Msk (0x1ul << SDH_INTEN_BLKDIEN_Pos) /*!< SDH_T::INTEN: BLKDIEN Mask */ + +#define SDH_INTEN_CRCIEN_Pos (1) /*!< SDH_T::INTEN: CRCIEN Position */ +#define SDH_INTEN_CRCIEN_Msk (0x1ul << SDH_INTEN_CRCIEN_Pos) /*!< SDH_T::INTEN: CRCIEN Mask */ + +#define SDH_INTEN_CDIEN_Pos (8) /*!< SDH_T::INTEN: CDIEN Position */ +#define SDH_INTEN_CDIEN_Msk (0x1ul << SDH_INTEN_CDIEN_Pos) /*!< SDH_T::INTEN: CDIEN Mask */ + +#define SDH_INTEN_RTOIEN_Pos (12) /*!< SDH_T::INTEN: RTOIEN Position */ +#define SDH_INTEN_RTOIEN_Msk (0x1ul << SDH_INTEN_RTOIEN_Pos) /*!< SDH_T::INTEN: RTOIEN Mask */ + +#define SDH_INTEN_DITOIEN_Pos (13) /*!< SDH_T::INTEN: DITOIEN Position */ +#define SDH_INTEN_DITOIEN_Msk (0x1ul << SDH_INTEN_DITOIEN_Pos) /*!< SDH_T::INTEN: DITOIEN Mask */ + +#define SDH_INTEN_WKIEN_Pos (14) /*!< SDH_T::INTEN: WKIEN Position */ +#define SDH_INTEN_WKIEN_Msk (0x1ul << SDH_INTEN_WKIEN_Pos) /*!< SDH_T::INTEN: WKIEN Mask */ + +#define SDH_INTEN_CDSRC_Pos (30) /*!< SDH_T::INTEN: CDSRC Position */ +#define SDH_INTEN_CDSRC_Msk (0x1ul << SDH_INTEN_CDSRC_Pos) /*!< SDH_T::INTEN: CDSRC Mask */ + +#define SDH_INTSTS_BLKDIF_Pos (0) /*!< SDH_T::INTSTS: BLKDIF Position */ +#define SDH_INTSTS_BLKDIF_Msk (0x1ul << SDH_INTSTS_BLKDIF_Pos) /*!< SDH_T::INTSTS: BLKDIF Mask */ + +#define SDH_INTSTS_CRCIF_Pos (1) /*!< SDH_T::INTSTS: CRCIF Position */ +#define SDH_INTSTS_CRCIF_Msk (0x1ul << SDH_INTSTS_CRCIF_Pos) /*!< SDH_T::INTSTS: CRCIF Mask */ + +#define SDH_INTSTS_CRC7_Pos (2) /*!< SDH_T::INTSTS: CRC7 Position */ +#define SDH_INTSTS_CRC7_Msk (0x1ul << SDH_INTSTS_CRC7_Pos) /*!< SDH_T::INTSTS: CRC7 Mask */ + +#define SDH_INTSTS_CRC16_Pos (3) /*!< SDH_T::INTSTS: CRC16 Position */ +#define SDH_INTSTS_CRC16_Msk (0x1ul << SDH_INTSTS_CRC16_Pos) /*!< SDH_T::INTSTS: CRC16 Mask */ + +#define SDH_INTSTS_CRCSTS_Pos (4) /*!< SDH_T::INTSTS: CRCSTS Position */ +#define SDH_INTSTS_CRCSTS_Msk (0x7ul << SDH_INTSTS_CRCSTS_Pos) /*!< SDH_T::INTSTS: CRCSTS Mask */ + +#define SDH_INTSTS_DAT0STS_Pos (7) /*!< SDH_T::INTSTS: DAT0STS Position */ +#define SDH_INTSTS_DAT0STS_Msk (0x1ul << SDH_INTSTS_DAT0STS_Pos) /*!< SDH_T::INTSTS: DAT0STS Mask */ + +#define SDH_INTSTS_CDIF_Pos (8) /*!< SDH_T::INTSTS: CDIF Position */ +#define SDH_INTSTS_CDIF_Msk (0x1ul << SDH_INTSTS_CDIF_Pos) /*!< SDH_T::INTSTS: CDIF Mask */ + +#define SDH_INTSTS_RTOIF_Pos (12) /*!< SDH_T::INTSTS: RTOIF Position */ +#define SDH_INTSTS_RTOIF_Msk (0x1ul << SDH_INTSTS_RTOIF_Pos) /*!< SDH_T::INTSTS: RTOIF Mask */ + +#define SDH_INTSTS_DITOIF_Pos (13) /*!< SDH_T::INTSTS: DITOIF Position */ +#define SDH_INTSTS_DITOIF_Msk (0x1ul << SDH_INTSTS_DITOIF_Pos) /*!< SDH_T::INTSTS: DITOIF Mask */ + +#define SDH_INTSTS_CDSTS_Pos (16) /*!< SDH_T::INTSTS: CDSTS Position */ +#define SDH_INTSTS_CDSTS_Msk (0x1ul << SDH_INTSTS_CDSTS_Pos) /*!< SDH_T::INTSTS: CDSTS Mask */ + +#define SDH_INTSTS_DAT1STS_Pos (18) /*!< SDH_T::INTSTS: DAT1STS Position */ +#define SDH_INTSTS_DAT1STS_Msk (0x1ul << SDH_INTSTS_DAT1STS_Pos) /*!< SDH_T::INTSTS: DAT1STS Mask */ + +#define SDH_RESP0_RESPTK0_Pos (0) /*!< SDH_T::RESP0: RESPTK0 Position */ +#define SDH_RESP0_RESPTK0_Msk (0xfffffffful << SDH_RESP0_RESPTK0_Pos) /*!< SDH_T::RESP0: RESPTK0 Mask */ + +#define SDH_RESP1_RESPTK1_Pos (0) /*!< SDH_T::RESP1: RESPTK1 Position */ +#define SDH_RESP1_RESPTK1_Msk (0xfful << SDH_RESP1_RESPTK1_Pos) /*!< SDH_T::RESP1: RESPTK1 Mask */ + +#define SDH_BLEN_BLKLEN_Pos (0) /*!< SDH_T::BLEN: BLKLEN Position */ +#define SDH_BLEN_BLKLEN_Msk (0x7fful << SDH_BLEN_BLKLEN_Pos) /*!< SDH_T::BLEN: BLKLEN Mask */ + +#define SDH_TOUT_TOUT_Pos (0) /*!< SDH_T::TOUT: TOUT Position */ +#define SDH_TOUT_TOUT_Msk (0xfffffful << SDH_TOUT_TOUT_Pos) /*!< SDH_T::TOUT: TOUT Mask */ + +/**@}*/ /* SDH_CONST */ +/**@}*/ /* end of SDH register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __SDH_REG_H__ */ + diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/spi_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/spi_reg.h new file mode 100644 index 00000000000..9bb647fe144 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/spi_reg.h @@ -0,0 +1,800 @@ +/**************************************************************************//** + * @file spi_reg.h + * @version V1.00 + * @brief SPI register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __SPI_REG_H__ +#define __SPI_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup SPI Serial Peripheral Interface Controller(SPI) + Memory Mapped Structure for SPI Controller +@{ */ + +typedef struct +{ + + + /** + * @var SPI_T::CTL + * Offset: 0x00 SPI Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SPIEN |SPI Transfer Control Enable Bit + * | | |In Master mode, the transfer will start when there is data in the FIFO buffer after this bit is set to 1 + * | | |In Slave mode, this device is ready to receive data when this bit is set to 1. + * | | |0 = Transfer control Disabled. + * | | |1 = Transfer control Enabled. + * | | |Note: Before changing the configurations of SPIx_CTL, SPIx_CLKDIV, SPIx_SSCTL and SPIx_FIFOCTL registers, user shall clear the SPIEN (SPIx_CTL[0]) and confirm the SPIENSTS (SPIx_STATUS[15]) is 0. + * |[1] |RXNEG |Receive on Negative Edge + * | | |0 = Received data input signal is latched on the rising edge of SPI bus clock. + * | | |1 = Received data input signal is latched on the falling edge of SPI bus clock. + * |[2] |TXNEG |Transmit on Negative Edge + * | | |0 = Transmitted data output signal is changed on the rising edge of SPI bus clock. + * | | |1 = Transmitted data output signal is changed on the falling edge of SPI bus clock. + * |[3] |CLKPOL |Clock Polarity + * | | |0 = SPI bus clock is idle low. + * | | |1 = SPI bus clock is idle high. + * |[7:4] |SUSPITV |Suspend Interval (Master Only) + * | | |The four bits provide configurable suspend interval between two successive transmit/receive transaction in a transfer + * | | |The definition of the suspend interval is the interval between the last clock edge of the preceding transaction word and the first clock edge of the following transaction word + * | | |The default value is 0x3 + * | | |The period of the suspend interval is obtained according to the following equation. + * | | |(SUSPITV[3:0] + 0.5) * period of SPICLK clock cycle + * | | |Example: + * | | |SUSPITV = 0x0 .... 0.5 SPICLK clock cycle. + * | | |SUSPITV = 0x1 .... 1.5 SPICLK clock cycle. + * | | |..... + * | | |SUSPITV = 0xE .... 14.5 SPICLK clock cycle. + * | | |SUSPITV = 0xF .... 15.5 SPICLK clock cycle. + * |[12:8] |DWIDTH |Data Width + * | | |This field specifies how many bits can be transmitted / received in one transaction + * | | |The minimum bit length is 8 bits and can up to 32 bits. + * | | |DWIDTH = 0x08 .... 8 bits. + * | | |DWIDTH = 0x09 .... 9 bits. + * | | |..... + * | | |DWIDTH = 0x1F .... 31 bits. + * | | |DWIDTH = 0x00 .... 32 bits. + * | | |Note: For SPI1~SPI4, this bit field will decide the depth of TX/RX FIFO configuration in SPI mode + * | | |Therefore, changing this bit field will clear TX/RX FIFO by hardware automatically in SPI1~SPI4. + * |[13] |LSB |Send LSB First + * | | |0 = The MSB, which bit of transmit/receive register depends on the setting of DWIDTH, is transmitted/received first. + * | | |1 = The LSB, bit 0 of the SPI TX register, is sent first to the SPI data output pin, and the first bit received from the SPI data input pin will be put in the LSB position of the RX register (bit 0 of SPI_RX). + * |[14] |HALFDPX |SPI Half-duplex Transfer Enable Bit + * | | |This bit is used to select full-duplex or half-duplex for SPI transfer + * | | |The bit field DATDIR (SPIx_CTL[20]) can be used to set the data direction in half-duplex transfer. + * | | |0 = SPI operates in full-duplex transfer. + * | | |1 = SPI operates in half-duplex transfer. + * |[15] |RXONLY |Receive-only Mode Enable Bit (Master Only) + * | | |This bit field is only available in Master mode + * | | |In receive-only mode, SPI Master will generate SPI bus clock continuously for receiving data bit from SPI slave device and assert the BUSY status. + * | | |0 = Receive-only mode Disabled. + * | | |1 = Receive-only mode Enabled. + * |[17] |UNITIEN |Unit Transfer Interrupt Enable Bit + * | | |0 = SPI unit transfer interrupt Disabled. + * | | |1 = SPI unit transfer interrupt Enabled. + * |[18] |SLAVE |Slave Mode Control + * | | |0 = Master mode. + * | | |1 = Slave mode. + * |[19] |REORDER |Byte Reorder Function Enable Bit + * | | |0 = Byte Reorder function Disabled. + * | | |1 = Byte Reorder function Enabled + * | | |A byte suspend interval will be inserted among each byte + * | | |The period of the byte suspend interval depends on the setting of SUSPITV. + * | | |Note: Byte Reorder function is only available if DWIDTH is defined as 16, 24, and 32 bits. + * |[20] |DATDIR |Data Port Direction Control + * | | |This bit is used to select the data input/output direction in half-duplex transfer and Dual/Quad transfer + * | | |0 = SPI data is input direction. + * | | |1 = SPI data is output direction. + * @var SPI_T::CLKDIV + * Offset: 0x04 SPI Clock Divider Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[8:0] |DIVIDER |Clock Divider + * | | |The value in this field is the frequency divider for generating the peripheral clock, fspi_eclk, and the SPI bus clock of SPI Master + * | | |The frequency is obtained according to the following equation. + * | | |where + * | | |is the peripheral clock source, which is defined in the clock control register, CLK_CLKSEL2. + * | | |Note: Not supported in I2S mode. + * @var SPI_T::SSCTL + * Offset: 0x08 SPI Slave Select Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SS |Slave Selection Control (Master Only) + * | | |If AUTOSS bit is cleared to 0, + * | | |0 = set the SPIx_SS line to inactive state. + * | | |1 = set the SPIx_SS line to active state. + * | | |If the AUTOSS bit is set to 1, + * | | |0 = Keep the SPIx_SS line at inactive state. + * | | |1 = SPIx_SS line will be automatically driven to active state for the duration of data transfer, and will be driven to inactive state for the rest of the time + * | | |The active state of SPIx_SS is specified in SSACTPOL (SPIx_SSCTL[2]). + * |[2] |SSACTPOL |Slave Selection Active Polarity + * | | |This bit defines the active polarity of slave selection signal (SPIx_SS). + * | | |0 = The slave selection signal SPIx_SS is active low. + * | | |1 = The slave selection signal SPIx_SS is active high. + * |[3] |AUTOSS |Automatic Slave Selection Function Enable Bit (Master Only) + * | | |0 = Automatic slave selection function Disabled + * | | |Slave selection signal will be asserted/de-asserted according to SS (SPIx_SSCTL[0]). + * | | |1 = Automatic slave selection function Enabled. + * |[8] |SLVBEIEN |Slave Mode Bit Count Error Interrupt Enable Bit + * | | |0 = Slave mode bit count error interrupt Disabled. + * | | |1 = Slave mode bit count error interrupt Enabled. + * |[9] |SLVURIEN |Slave Mode TX Under Run Interrupt Enable Bit + * | | |0 = Slave mode TX under run interrupt Disabled. + * | | |1 = Slave mode TX under run interrupt Enabled. + * |[12] |SSACTIEN |Slave Select Active Interrupt Enable Bit + * | | |0 = Slave select active interrupt Disabled. + * | | |1 = Slave select active interrupt Enabled. + * |[13] |SSINAIEN |Slave Select Inactive Interrupt Enable Bit + * | | |0 = Slave select inactive interrupt Disabled. + * | | |1 = Slave select inactive interrupt Enabled. + * @var SPI_T::PDMACTL + * Offset: 0x0C SPI PDMA Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |TXPDMAEN |Transmit PDMA Enable Bit + * | | |0 = Transmit PDMA function Disabled. + * | | |1 = Transmit PDMA function Enabled. + * | | |Note: In SPI Master mode with full duplex transfer, if both TX and RX PDMA functions are enabled, RX PDMA function cannot be enabled prior to TX PDMA function + * | | |User can enable TX PDMA function firstly or enable both functions simultaneously. + * |[1] |RXPDMAEN |Receive PDMA Enable Bit + * | | |0 = Receive PDMA function Disabled. + * | | |1 = Receive PDMA function Enabled. + * |[2] |PDMARST |PDMA Reset + * | | |0 = No effect. + * | | |1 = Reset the PDMA control logic of the SPI controller. This bit will be automatically cleared to 0. + * @var SPI_T::FIFOCTL + * Offset: 0x10 SPI FIFO Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |RXRST |Receive Reset + * | | |0 = No effect. + * | | |1 = Reset receive FIFO pointer and receive circuit + * | | |The RXFULL bit will be cleared to 0 and the RXEMPTY bit will be set to 1 + * | | |This bit will be cleared to 0 by hardware about 3 system clock cycles + 2 peripheral clock cycles after it is set to 1 + * | | |User can read TXRXRST (SPIx_STATUS[23]) to check if reset is accomplished or not. + * |[1] |TXRST |Transmit Reset + * | | |0 = No effect. + * | | |1 = Reset transmit FIFO pointer and transmit circuit + * | | |The TXFULL bit will be cleared to 0 and the TXEMPTY bit will be set to 1 + * | | |This bit will be cleared to 0 by hardware about 3 system clock cycles + 2 peripheral clock cycles after it is set to 1 + * | | |User can read TXRXRST (SPIx_STATUS[23]) to check if reset is accomplished or not. + * | | |Note: If TX underflow event occurs in SPI Slave mode, this bit can be used to make SPI return to idle state. + * |[2] |RXTHIEN |Receive FIFO Threshold Interrupt Enable Bit + * | | |0 = RX FIFO threshold interrupt Disabled. + * | | |1 = RX FIFO threshold interrupt Enabled. + * |[3] |TXTHIEN |Transmit FIFO Threshold Interrupt Enable Bit + * | | |0 = TX FIFO threshold interrupt Disabled. + * | | |1 = TX FIFO threshold interrupt Enabled. + * |[4] |RXTOIEN |Slave Receive Time-out Interrupt Enable Bit + * | | |0 = Receive time-out interrupt Disabled. + * | | |1 = Receive time-out interrupt Enabled. + * |[5] |RXOVIEN |Receive FIFO Overrun Interrupt Enable Bit + * | | |0 = Receive FIFO overrun interrupt Disabled. + * | | |1 = Receive FIFO overrun interrupt Enabled. + * |[6] |TXUFPOL |TX Underflow Data Polarity + * | | |0 = The SPI data out is keep 0 if there is TX underflow event in Slave mode. + * | | |1 = The SPI data out is keep 1 if there is TX underflow event in Slave mode. + * | | |Note: + * | | |1. The TX underflow event occurs if there is no any data in TX FIFO when the slave selection signal is active. + * | | |2. This bit should be set as 0 in I2S mode. + * | | |3. When TX underflow event occurs, SPIx_MISO pin state will be determined by this setting even though TX FIFO is not empty afterward + * | | |Data stored in TX FIFO will be sent through SPIx_MISO pin in the next transfer frame. + * |[7] |TXUFIEN |TX Underflow Interrupt Enable Bit + * | | |When TX underflow event occurs in Slave mode, TXUFIF (SPIx_STATUS[19]) will be set to 1 + * | | |This bit is used to enable the TX underflow interrupt. + * | | |0 = Slave TX underflow interrupt Disabled. + * | | |1 = Slave TX underflow interrupt Enabled. + * |[8] |RXFBCLR |Receive FIFO Buffer Clear + * | | |0 = No effect. + * | | |1 = Clear receive FIFO pointer + * | | |The RXFULL bit will be cleared to 0 and the RXEMPTY bit will be set to 1 + * | | |This bit will be cleared to 0 by hardware about 1 system clock after it is set to 1. + * | | |Note: The RX shift register will not be cleared. + * |[9] |TXFBCLR |Transmit FIFO Buffer Clear + * | | |0 = No effect. + * | | |1 = Clear transmit FIFO pointer + * | | |The TXFULL bit will be cleared to 0 and the TXEMPTY bit will be set to 1 + * | | |This bit will be cleared to 0 by hardware about 1 system clock after it is set to 1. + * | | |Note: The TX shift register will not be cleared. + * |[26:24] |RXTH |Receive FIFO Threshold + * | | |If the valid data count of the receive FIFO buffer is larger than the RXTH setting, the RXTHIF bit will be set to 1, else the RXTHIF bit will be cleared to 0 + * | | |For SPI1~SPI4, the MSB of this bit field is only meaningful while SPI mode 8~16 bits of data length. + * |[30:28] |TXTH |Transmit FIFO Threshold + * | | |If the valid data count of the transmit FIFO buffer is less than or equal to the TXTH setting, the TXTHIF bit will be set to 1, else the TXTHIF bit will be cleared to 0 + * | | |For SPI1~SPI4, the MSB of this bit field is only meaningful while SPI mode 8~16 bits of data length + * @var SPI_T::STATUS + * Offset: 0x14 SPI Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BUSY |Busy Status (Read Only) + * | | |0 = SPI controller is in idle state. + * | | |1 = SPI controller is in busy state. + * | | |The following listing are the bus busy conditions: + * | | |a. SPIx_CTL[0] = 1 and TXEMPTY = 0. + * | | |b + * | | |For SPI Master mode, SPIx_CTL[0] = 1 and TXEMPTY = 1 but the current transaction is not finished yet. + * | | |c. For SPI Master mode, SPIx_CTL[0] = 1 and RXONLY = 1. + * | | |d + * | | |For SPI Slave mode, the SPIx_CTL[0] = 1 and there is serial clock input into the SPI core logic when slave select is active. + * | | |For SPI Slave mode, the SPIx_CTL[0] = 1 and the transmit buffer or transmit shift register is not empty even if the slave select is inactive. + * |[1] |UNITIF |Unit Transfer Interrupt Flag + * | | |0 = No transaction has been finished since this bit was cleared to 0. + * | | |1 = SPI controller has finished one unit transfer. + * | | |Note: This bit will be cleared by writing 1 to it. + * |[2] |SSACTIF |Slave Select Active Interrupt Flag + * | | |0 = Slave select active interrupt was cleared or not occurred. + * | | |1 = Slave select active interrupt event occurred. + * | | |Note: Only available in Slave mode. This bit will be cleared by writing 1 to it. + * |[3] |SSINAIF |Slave Select Inactive Interrupt Flag + * | | |0 = Slave select inactive interrupt was cleared or not occurred. + * | | |1 = Slave select inactive interrupt event occurred. + * | | |Note: Only available in Slave mode. This bit will be cleared by writing 1 to it. + * |[4] |SSLINE |Slave Select Line Bus Status (Read Only) + * | | |0 = The slave select line status is 0. + * | | |1 = The slave select line status is 1. + * | | |Note: This bit is only available in Slave mode + * | | |If SSACTPOL (SPIx_SSCTL[2]) is set 0, and the SSLINE is 1, the SPI slave select is in inactive status. + * |[6] |SLVBEIF |Slave Mode Bit Count Error Interrupt Flag + * | | |In Slave mode, when the slave select line goes to inactive state, if bit counter is mismatch with DWIDTH, this interrupt flag will be set to 1. + * | | |0 = No Slave mode bit count error event. + * | | |1 = Slave mode bit count error event occurs. + * | | |Note: If the slave select active but there is no any bus clock input, the SLVBEIF also active when the slave select goes to inactive state + * | | |This bit will be cleared by writing 1 to it. + * |[7] |SLVURIF |Slave Mode TX Under Run Interrupt Flag + * | | |In Slave mode, if TX underflow event occurs and the slave select line goes to inactive state, this interrupt flag will be set to 1. + * | | |0 = No Slave TX under run event. + * | | |1 = Slave TX under run event occurs. + * | | |Note: This bit will be cleared by writing 1 to it. + * |[8] |RXEMPTY |Receive FIFO Buffer Empty Indicator (Read Only) + * | | |0 = Receive FIFO buffer is not empty. + * | | |1 = Receive FIFO buffer is empty. + * |[9] |RXFULL |Receive FIFO Buffer Full Indicator (Read Only) + * | | |0 = Receive FIFO buffer is not full. + * | | |1 = Receive FIFO buffer is full. + * |[10] |RXTHIF |Receive FIFO Threshold Interrupt Flag (Read Only) + * | | |0 = The valid data count within the receive FIFO buffer is smaller than or equal to the setting value of RXTH. + * | | |1 = The valid data count within the receive FIFO buffer is larger than the setting value of RXTH. + * |[11] |RXOVIF |Receive FIFO Overrun Interrupt Flag + * | | |When the receive FIFO buffer is full, the follow-up data will be dropped and this bit will be set to 1. + * | | |0 = No FIFO is overrun. + * | | |1 = Receive FIFO is overrun. + * | | |Note: This bit will be cleared by writing 1 to it. + * |[12] |RXTOIF |Receive Time-out Interrupt Flag + * | | |0 = No receive FIFO time-out event. + * | | |1 = Receive FIFO buffer is not empty and no read operation on receive FIFO buffer over 64 SPI peripheral clock periods in Master mode or over 576 SPI peripheral clock periods in Slave mode + * | | |When the received FIFO buffer is read by software, the time-out status will be cleared automatically. + * | | |Note: This bit will be cleared by writing 1 to it. + * |[15] |SPIENSTS |SPI Enable Status (Read Only) + * | | |0 = The SPI controller is disabled. + * | | |1 = The SPI controller is enabled. + * | | |Note: The SPI peripheral clock is asynchronous with the system clock + * | | |In order to make sure the SPI control logic is disabled, this bit indicates the real status of SPI controller. + * |[16] |TXEMPTY |Transmit FIFO Buffer Empty Indicator (Read Only) + * | | |0 = Transmit FIFO buffer is not empty. + * | | |1 = Transmit FIFO buffer is empty. + * |[17] |TXFULL |Transmit FIFO Buffer Full Indicator (Read Only) + * | | |0 = Transmit FIFO buffer is not full. + * | | |1 = Transmit FIFO buffer is full. + * |[18] |TXTHIF |Transmit FIFO Threshold Interrupt Flag (Read Only) + * | | |0 = The valid data count within the transmit FIFO buffer is larger than the setting value of TXTH. + * | | |1 = The valid data count within the transmit FIFO buffer is less than or equal to the setting value of TXTH. + * |[19] |TXUFIF |TX Underflow Interrupt Flag + * | | |When the TX underflow event occurs, this bit will be set to 1, the state of data output pin depends on the setting of TXUFPOL. + * | | |0 = No effect. + * | | |1 = No data in Transmit FIFO and TX shift register when the slave selection signal is active. + * | | |Note 1: This bit will be cleared by writing 1 to it. + * | | |Note 2: If reset slave's transmission circuit when slave selection signal is active, this flag will be set to 1 after 2 peripheral clock cycles + 3 system clock cycles since the reset operation is done. + * |[23] |TXRXRST |TX or RX Reset Status (Read Only) + * | | |0 = The reset function of TXRST or RXRST is done. + * | | |1 = Doing the reset function of TXRST or RXRST. + * | | |Note: Both the reset operations of TXRST and RXRST need 3 system clock cycles + 2 peripheral clock cycles + * | | |User can check the status of this bit to monitor the reset function is doing or done. + * |[27:24] |RXCNT |Receive FIFO Data Count (Read Only) + * | | |This bit field indicates the valid data count of receive FIFO buffer. + * |[31:28] |TXCNT |Transmit FIFO Data Count (Read Only) + * | | |This bit field indicates the valid data count of transmit FIFO buffer. + * @var SPI_T::TX + * Offset: 0x20 SPI Data Transmit Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |TX |Data Transmit Register + * | | |The data transmit registers pass through the transmitted data into the 4-level transmit FIFO buffers + * | | |The number of valid bits depends on the setting of DWIDTH (SPIx_CTL[12:8]) in SPI mode or WDWIDTH (SPIx_I2SCTL[5:4]) in I2S mode. + * | | |In SPI mode, if DWIDTH is set to 0x08, the bits TX[7:0] will be transmitted + * | | |If DWIDTH is set to 0x00 , the SPI controller will perform a 32-bit transfer. + * | | |In I2S mode, if WDWIDTH (SPIx_I2SCTL[5:4]) is set to 0x2, the data width of audio channel is 24-bit and corresponding to TX[23:0] + * | | |If WDWIDTH is set as 0x0, 0x1, or 0x3, all bits of this field are valid and referred to the data arrangement in I2S mode FIFO operation section + * | | |Note: In Master mode, SPI controller will start to transfer the SPI bus clock after 1 APB clock and 6 peripheral clock cycles after user writes to this register. + * @var SPI_T::RX + * Offset: 0x30 SPI Data Receive Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |RX |Data Receive Register + * | | |There are 4-level FIFO buffers in this controller + * | | |The data receive register holds the data received from SPI data input pin + * | | |If the RXEMPTY (SPIx_STATUS[8] or SPIx_I2SSTS[8]) is not set to 1, the receive FIFO buffers can be accessed through software by reading this register + * | | |This is a read only register. + * @var SPI_T::I2SCTL + * Offset: 0x60 I2S Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |I2SEN |I2S Controller Enable Bit + * | | |0 = Disabled I2S mode. + * | | |1 = Enabled I2S mode. + * | | |Note: + * | | |1. If enable this bit, I2Sx_BCLK will start to output in Master mode. + * | | |2 + * | | |Before changing the configurations of SPIx_I2SCTL, SPIx_I2SCLK, and SPIx_FIFOCTL registers, user shall clear the I2SEN (SPIx_I2SCTL[0]) and confirm the I2SENSTS (SPIx_I2SSTS[15]) is 0. + * |[1] |TXEN |Transmit Enable Bit + * | | |0 = Data transmit Disabled. + * | | |1 = Data transmit Enabled. + * |[2] |RXEN |Receive Enable Bit + * | | |0 = Data receive Disabled. + * | | |1 = Data receive Enabled. + * |[3] |MUTE |Transmit Mute Enable Bit + * | | |0 = Transmit data is shifted from buffer. + * | | |1 = Transmit channel zero. + * |[5:4] |WDWIDTH |Word Width + * | | |00 = data size is 8-bit. + * | | |01 = data size is 16-bit. + * | | |10 = data size is 24-bit. + * | | |11 = data size is 32-bit. + * |[6] |MONO |Monaural Data + * | | |0 = Data is stereo format. + * | | |1 = Data is monaural format. + * |[7] |ORDER |Stereo Data Order in FIFO + * | | |0 = Left channel data at high byte. + * | | |1 = Left channel data at low byte. + * |[8] |SLAVE |Slave Mode + * | | |I2S can operate as master or slave + * | | |For Master mode, I2Sx_BCLK and I2Sx_LRCLK pins are output mode and send bit clock from NuMicro M480 series to audio CODEC chip + * | | |In Slave mode, I2Sx_BCLK and I2Sx_LRCLK pins are input mode and I2Sx_BCLK and I2Sx_LRCLK signals are received from outer audio CODEC chip. + * | | |0 = Master mode. + * | | |1 = Slave mode. + * |[15] |MCLKEN |Master Clock Enable Bit + * | | |If MCLKEN is set to 1, I2S controller will generate master clock on SPIx_I2SMCLK pin for external audio devices. + * | | |0 = Master clock Disabled. + * | | |1 = Master clock Enabled. + * |[16] |RZCEN |Right Channel Zero Cross Detection Enable Bit + * | | |If this bit is set to 1, when right channel data sign bit change or next shift data bits are all 0 then RZCIF flag in SPIx_I2SSTS register is set to 1 + * | | |This function is only available in transmit operation. + * | | |0 = Right channel zero cross detection Disabled. + * | | |1 = Right channel zero cross detection Enabled. + * |[17] |LZCEN |Left Channel Zero Cross Detection Enable Bit + * | | |If this bit is set to 1, when left channel data sign bit changes or next shift data bits are all 0 then LZCIF flag in SPIx_I2SSTS register is set to 1 + * | | |This function is only available in transmit operation. + * | | |0 = Left channel zero cross detection Disabled. + * | | |1 = Left channel zero cross detection Enabled. + * |[23] |RXLCH |Receive Left Channel Enable Bit + * | | |When monaural format is selected (MONO = 1), I2S controller will receive right channel data if RXLCH is set to 0, and receive left channel data if RXLCH is set to 1. + * | | |0 = Receive right channel data in Mono mode. + * | | |1 = Receive left channel data in Mono mode. + * |[24] |RZCIEN |Right Channel Zero Cross Interrupt Enable Bit + * | | |Interrupt occurs if this bit is set to 1 and right channel zero cross event occurs. + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * |[25] |LZCIEN |Left Channel Zero Cross Interrupt Enable Bit + * | | |Interrupt occurs if this bit is set to 1 and left channel zero cross event occurs. + * | | |0 = Interrupt Disabled. + * | | |1 = Interrupt Enabled. + * |[29:28] |FORMAT |Data Format Selection + * | | |00 = I2S data format. + * | | |01 = MSB justified data format. + * | | |10 = PCM mode A. + * | | |11 = PCM mode B. + * @var SPI_T::I2SCLK + * Offset: 0x64 I2S Clock Divider Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[6:0] |MCLKDIV |Master Clock Divider + * | | |If MCLKEN is set to 1, I2S controller will generate master clock for external audio devices + * | | |The frequency of master clock, fMCLK, is determined by the following expressions: + * | | |If MCLKDIV >= 1,. + * | | |If MCLKDIV = 0,. + * | | |where + * | | |is the frequency of I2S peripheral clock source, which is defined in the clock control register CLK_CLKSEL2 + * | | |In general, the master clock rate is 256 times sampling clock rate. + * |[17:8] |BCLKDIV |Bit Clock Divider + * | | |The I2S controller will generate bit clock in Master mode + * | | |The clock frequency of bit clock , fBCLK, is determined by the following expression: + * | | |where + * | | |is the frequency of I2S peripheral clock source, which is defined in the clock control register CLK_CLKSEL2. + * | | |In I2S Slave mode, this field is used to define the frequency of peripheral clock and it's determined by . + * | | |The peripheral clock frequency in I2S Slave mode must be equal to or faster than 6 times of input bit clock. + * @var SPI_T::I2SSTS + * Offset: 0x68 I2S Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[4] |RIGHT |Right Channel (Read Only) + * | | |This bit indicates the current transmit data is belong to which channel. + * | | |0 = Left channel. + * | | |1 = Right channel. + * |[8] |RXEMPTY |Receive FIFO Buffer Empty Indicator (Read Only) + * | | |0 = Receive FIFO buffer is not empty. + * | | |1 = Receive FIFO buffer is empty. + * |[9] |RXFULL |Receive FIFO Buffer Full Indicator (Read Only) + * | | |0 = Receive FIFO buffer is not full. + * | | |1 = Receive FIFO buffer is full. + * |[10] |RXTHIF |Receive FIFO Threshold Interrupt Flag (Read Only) + * | | |0 = The valid data count within the receive FIFO buffer is smaller than or equal to the setting value of RXTH. + * | | |1 = The valid data count within the receive FIFO buffer is larger than the setting value of RXTH. + * | | |Note: If RXTHIEN = 1 and RXTHIF = 1, the SPI/I2S controller will generate a SPI interrupt request. + * |[11] |RXOVIF |Receive FIFO Overrun Interrupt Flag + * | | |When the receive FIFO buffer is full, the follow-up data will be dropped and this bit will be set to 1. + * | | |Note: This bit will be cleared by writing 1 to it. + * |[12] |RXTOIF |Receive Time-out Interrupt Flag + * | | |0 = No receive FIFO time-out event. + * | | |1 = Receive FIFO buffer is not empty and no read operation on receive FIFO buffer over 64 SPI peripheral clock period in Master mode or over 576 SPI peripheral clock period in Slave mode + * | | |When the received FIFO buffer is read by software, the time-out status will be cleared automatically. + * | | |Note: This bit will be cleared by writing 1 to it. + * |[15] |I2SENSTS |I2S Enable Status (Read Only) + * | | |0 = The SPI/I2S control logic is disabled. + * | | |1 = The SPI/I2S control logic is enabled. + * | | |Note: The SPI peripheral clock is asynchronous with the system clock + * | | |In order to make sure the SPI/I2S control logic is disabled, this bit indicates the real status of SPI/I2S control logic for user. + * |[16] |TXEMPTY |Transmit FIFO Buffer Empty Indicator (Read Only) + * | | |0 = Transmit FIFO buffer is not empty. + * | | |1 = Transmit FIFO buffer is empty. + * |[17] |TXFULL |Transmit FIFO Buffer Full Indicator (Read Only) + * | | |0 = Transmit FIFO buffer is not full. + * | | |1 = Transmit FIFO buffer is full. + * |[18] |TXTHIF |Transmit FIFO Threshold Interrupt Flag (Read Only) + * | | |0 = The valid data count within the transmit FIFO buffer is larger than the setting value of TXTH. + * | | |1 = The valid data count within the transmit FIFO buffer is less than or equal to the setting value of TXTH. + * | | |Note: If TXTHIEN = 1 and TXTHIF = 1, the SPI/I2S controller will generate a SPI interrupt request. + * |[19] |TXUFIF |Transmit FIFO Underflow Interrupt Flag + * | | |When the transmit FIFO buffer is empty and there is no datum written into the FIFO buffer, if there is more bus clock input, this bit will be set to 1. + * | | |Note: This bit will be cleared by writing 1 to it. + * |[20] |RZCIF |Right Channel Zero Cross Interrupt Flag + * | | |0 = No zero cross event occurred on right channel. + * | | |1 = Zero cross event occurred on right channel. + * |[21] |LZCIF |Left Channel Zero Cross Interrupt Flag + * | | |0 = No zero cross event occurred on left channel. + * | | |1 = Zero cross event occurred on left channel. + * |[23] |TXRXRST |TX or RX Reset Status (Read Only) + * | | |0 = The reset function of TXRST or RXRST is done. + * | | |1 = Doing the reset function of TXRST or RXRST. + * | | |Note: Both the reset operations of TXRST and RXRST need 3 system clock cycles + 2 peripheral clock cycles + * | | |User can check the status of this bit to monitor the reset function is doing or done. + * |[26:24] |RXCNT |Receive FIFO Data Count (Read Only) + * | | |This bit field indicates the valid data count of receive FIFO buffer. + * |[30:28] |TXCNT |Transmit FIFO Data Count (Read Only) + * | | |This bit field indicates the valid data count of transmit FIFO buffer. + */ + __IO uint32_t CTL; /*!< [0x0000] SPI Control Register */ + __IO uint32_t CLKDIV; /*!< [0x0004] SPI Clock Divider Register */ + __IO uint32_t SSCTL; /*!< [0x0008] SPI Slave Select Control Register */ + __IO uint32_t PDMACTL; /*!< [0x000c] SPI PDMA Control Register */ + __IO uint32_t FIFOCTL; /*!< [0x0010] SPI FIFO Control Register */ + __IO uint32_t STATUS; /*!< [0x0014] SPI Status Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[2]; + /// @endcond //HIDDEN_SYMBOLS + __O uint32_t TX; /*!< [0x0020] SPI Data Transmit Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE1[3]; + /// @endcond //HIDDEN_SYMBOLS + __I uint32_t RX; /*!< [0x0030] SPI Data Receive Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE2[11]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t I2SCTL; /*!< [0x0060] I2S Control Register */ + __IO uint32_t I2SCLK; /*!< [0x0064] I2S Clock Divider Control Register */ + __IO uint32_t I2SSTS; /*!< [0x0068] I2S Status Register */ + +} SPI_T; + +/** + @addtogroup SPI_CONST SPI Bit Field Definition + Constant Definitions for SPI Controller +@{ */ + +#define SPI_CTL_SPIEN_Pos (0) /*!< SPI_T::CTL: SPIEN Position */ +#define SPI_CTL_SPIEN_Msk (0x1ul << SPI_CTL_SPIEN_Pos) /*!< SPI_T::CTL: SPIEN Mask */ + +#define SPI_CTL_RXNEG_Pos (1) /*!< SPI_T::CTL: RXNEG Position */ +#define SPI_CTL_RXNEG_Msk (0x1ul << SPI_CTL_RXNEG_Pos) /*!< SPI_T::CTL: RXNEG Mask */ + +#define SPI_CTL_TXNEG_Pos (2) /*!< SPI_T::CTL: TXNEG Position */ +#define SPI_CTL_TXNEG_Msk (0x1ul << SPI_CTL_TXNEG_Pos) /*!< SPI_T::CTL: TXNEG Mask */ + +#define SPI_CTL_CLKPOL_Pos (3) /*!< SPI_T::CTL: CLKPOL Position */ +#define SPI_CTL_CLKPOL_Msk (0x1ul << SPI_CTL_CLKPOL_Pos) /*!< SPI_T::CTL: CLKPOL Mask */ + +#define SPI_CTL_SUSPITV_Pos (4) /*!< SPI_T::CTL: SUSPITV Position */ +#define SPI_CTL_SUSPITV_Msk (0xful << SPI_CTL_SUSPITV_Pos) /*!< SPI_T::CTL: SUSPITV Mask */ + +#define SPI_CTL_DWIDTH_Pos (8) /*!< SPI_T::CTL: DWIDTH Position */ +#define SPI_CTL_DWIDTH_Msk (0x1ful << SPI_CTL_DWIDTH_Pos) /*!< SPI_T::CTL: DWIDTH Mask */ + +#define SPI_CTL_LSB_Pos (13) /*!< SPI_T::CTL: LSB Position */ +#define SPI_CTL_LSB_Msk (0x1ul << SPI_CTL_LSB_Pos) /*!< SPI_T::CTL: LSB Mask */ + +#define SPI_CTL_HALFDPX_Pos (14) /*!< SPI_T::CTL: HALFDPX Position */ +#define SPI_CTL_HALFDPX_Msk (0x1ul << SPI_CTL_HALFDPX_Pos) /*!< SPI_T::CTL: HALFDPX Mask */ + +#define SPI_CTL_RXONLY_Pos (15) /*!< SPI_T::CTL: RXONLY Position */ +#define SPI_CTL_RXONLY_Msk (0x1ul << SPI_CTL_RXONLY_Pos) /*!< SPI_T::CTL: RXONLY Mask */ + +#define SPI_CTL_UNITIEN_Pos (17) /*!< SPI_T::CTL: UNITIEN Position */ +#define SPI_CTL_UNITIEN_Msk (0x1ul << SPI_CTL_UNITIEN_Pos) /*!< SPI_T::CTL: UNITIEN Mask */ + +#define SPI_CTL_SLAVE_Pos (18) /*!< SPI_T::CTL: SLAVE Position */ +#define SPI_CTL_SLAVE_Msk (0x1ul << SPI_CTL_SLAVE_Pos) /*!< SPI_T::CTL: SLAVE Mask */ + +#define SPI_CTL_REORDER_Pos (19) /*!< SPI_T::CTL: REORDER Position */ +#define SPI_CTL_REORDER_Msk (0x1ul << SPI_CTL_REORDER_Pos) /*!< SPI_T::CTL: REORDER Mask */ + +#define SPI_CTL_DATDIR_Pos (20) /*!< SPI_T::CTL: DATDIR Position */ +#define SPI_CTL_DATDIR_Msk (0x1ul << SPI_CTL_DATDIR_Pos) /*!< SPI_T::CTL: DATDIR Mask */ + +#define SPI_CLKDIV_DIVIDER_Pos (0) /*!< SPI_T::CLKDIV: DIVIDER Position */ +#define SPI_CLKDIV_DIVIDER_Msk (0x1fful << SPI_CLKDIV_DIVIDER_Pos) /*!< SPI_T::CLKDIV: DIVIDER Mask */ + +#define SPI_SSCTL_SS_Pos (0) /*!< SPI_T::SSCTL: SS Position */ +#define SPI_SSCTL_SS_Msk (0x1ul << SPI_SSCTL_SS_Pos) /*!< SPI_T::SSCTL: SS Mask */ + +#define SPI_SSCTL_SSACTPOL_Pos (2) /*!< SPI_T::SSCTL: SSACTPOL Position */ +#define SPI_SSCTL_SSACTPOL_Msk (0x1ul << SPI_SSCTL_SSACTPOL_Pos) /*!< SPI_T::SSCTL: SSACTPOL Mask */ + +#define SPI_SSCTL_AUTOSS_Pos (3) /*!< SPI_T::SSCTL: AUTOSS Position */ +#define SPI_SSCTL_AUTOSS_Msk (0x1ul << SPI_SSCTL_AUTOSS_Pos) /*!< SPI_T::SSCTL: AUTOSS Mask */ + +#define SPI_SSCTL_SLVBEIEN_Pos (8) /*!< SPI_T::SSCTL: SLVBEIEN Position */ +#define SPI_SSCTL_SLVBEIEN_Msk (0x1ul << SPI_SSCTL_SLVBEIEN_Pos) /*!< SPI_T::SSCTL: SLVBEIEN Mask */ + +#define SPI_SSCTL_SLVURIEN_Pos (9) /*!< SPI_T::SSCTL: SLVURIEN Position */ +#define SPI_SSCTL_SLVURIEN_Msk (0x1ul << SPI_SSCTL_SLVURIEN_Pos) /*!< SPI_T::SSCTL: SLVURIEN Mask */ + +#define SPI_SSCTL_SSACTIEN_Pos (12) /*!< SPI_T::SSCTL: SSACTIEN Position */ +#define SPI_SSCTL_SSACTIEN_Msk (0x1ul << SPI_SSCTL_SSACTIEN_Pos) /*!< SPI_T::SSCTL: SSACTIEN Mask */ + +#define SPI_SSCTL_SSINAIEN_Pos (13) /*!< SPI_T::SSCTL: SSINAIEN Position */ +#define SPI_SSCTL_SSINAIEN_Msk (0x1ul << SPI_SSCTL_SSINAIEN_Pos) /*!< SPI_T::SSCTL: SSINAIEN Mask */ + +#define SPI_SSCTL_SLVTOCNT_Pos (16) /*!< SPI_T::SSCTL: SLVTOCNT Position */ +#define SPI_SSCTL_SLVTOCNT_Msk (0xfffful << SPI_SSCTL_SLVTOCNT_Pos) /*!< SPI_T::SSCTL: SLVTOCNT Mask */ + +#define SPI_PDMACTL_TXPDMAEN_Pos (0) /*!< SPI_T::PDMACTL: TXPDMAEN Position */ +#define SPI_PDMACTL_TXPDMAEN_Msk (0x1ul << SPI_PDMACTL_TXPDMAEN_Pos) /*!< SPI_T::PDMACTL: TXPDMAEN Mask */ + +#define SPI_PDMACTL_RXPDMAEN_Pos (1) /*!< SPI_T::PDMACTL: RXPDMAEN Position */ +#define SPI_PDMACTL_RXPDMAEN_Msk (0x1ul << SPI_PDMACTL_RXPDMAEN_Pos) /*!< SPI_T::PDMACTL: RXPDMAEN Mask */ + +#define SPI_PDMACTL_PDMARST_Pos (2) /*!< SPI_T::PDMACTL: PDMARST Position */ +#define SPI_PDMACTL_PDMARST_Msk (0x1ul << SPI_PDMACTL_PDMARST_Pos) /*!< SPI_T::PDMACTL: PDMARST Mask */ + +#define SPI_FIFOCTL_RXRST_Pos (0) /*!< SPI_T::FIFOCTL: RXRST Position */ +#define SPI_FIFOCTL_RXRST_Msk (0x1ul << SPI_FIFOCTL_RXRST_Pos) /*!< SPI_T::FIFOCTL: RXRST Mask */ + +#define SPI_FIFOCTL_TXRST_Pos (1) /*!< SPI_T::FIFOCTL: TXRST Position */ +#define SPI_FIFOCTL_TXRST_Msk (0x1ul << SPI_FIFOCTL_TXRST_Pos) /*!< SPI_T::FIFOCTL: TXRST Mask */ + +#define SPI_FIFOCTL_RXTHIEN_Pos (2) /*!< SPI_T::FIFOCTL: RXTHIEN Position */ +#define SPI_FIFOCTL_RXTHIEN_Msk (0x1ul << SPI_FIFOCTL_RXTHIEN_Pos) /*!< SPI_T::FIFOCTL: RXTHIEN Mask */ + +#define SPI_FIFOCTL_TXTHIEN_Pos (3) /*!< SPI_T::FIFOCTL: TXTHIEN Position */ +#define SPI_FIFOCTL_TXTHIEN_Msk (0x1ul << SPI_FIFOCTL_TXTHIEN_Pos) /*!< SPI_T::FIFOCTL: TXTHIEN Mask */ + +#define SPI_FIFOCTL_RXTOIEN_Pos (4) /*!< SPI_T::FIFOCTL: RXTOIEN Position */ +#define SPI_FIFOCTL_RXTOIEN_Msk (0x1ul << SPI_FIFOCTL_RXTOIEN_Pos) /*!< SPI_T::FIFOCTL: RXTOIEN Mask */ + +#define SPI_FIFOCTL_RXOVIEN_Pos (5) /*!< SPI_T::FIFOCTL: RXOVIEN Position */ +#define SPI_FIFOCTL_RXOVIEN_Msk (0x1ul << SPI_FIFOCTL_RXOVIEN_Pos) /*!< SPI_T::FIFOCTL: RXOVIEN Mask */ + +#define SPI_FIFOCTL_TXUFPOL_Pos (6) /*!< SPI_T::FIFOCTL: TXUFPOL Position */ +#define SPI_FIFOCTL_TXUFPOL_Msk (0x1ul << SPI_FIFOCTL_TXUFPOL_Pos) /*!< SPI_T::FIFOCTL: TXUFPOL Mask */ + +#define SPI_FIFOCTL_TXUFIEN_Pos (7) /*!< SPI_T::FIFOCTL: TXUFIEN Position */ +#define SPI_FIFOCTL_TXUFIEN_Msk (0x1ul << SPI_FIFOCTL_TXUFIEN_Pos) /*!< SPI_T::FIFOCTL: TXUFIEN Mask */ + +#define SPI_FIFOCTL_RXFBCLR_Pos (8) /*!< SPI_T::FIFOCTL: RXFBCLR Position */ +#define SPI_FIFOCTL_RXFBCLR_Msk (0x1ul << SPI_FIFOCTL_RXFBCLR_Pos) /*!< SPI_T::FIFOCTL: RXFBCLR Mask */ + +#define SPI_FIFOCTL_TXFBCLR_Pos (9) /*!< SPI_T::FIFOCTL: TXFBCLR Position */ +#define SPI_FIFOCTL_TXFBCLR_Msk (0x1ul << SPI_FIFOCTL_TXFBCLR_Pos) /*!< SPI_T::FIFOCTL: TXFBCLR Mask */ + +#define SPI_FIFOCTL_RXTH_Pos (24) /*!< SPI_T::FIFOCTL: RXTH Position */ +#define SPI_FIFOCTL_RXTH_Msk (0x7ul << SPI_FIFOCTL_RXTH_Pos) /*!< SPI_T::FIFOCTL: RXTH Mask */ + +#define SPI_FIFOCTL_TXTH_Pos (28) /*!< SPI_T::FIFOCTL: TXTH Position */ +#define SPI_FIFOCTL_TXTH_Msk (0x7ul << SPI_FIFOCTL_TXTH_Pos) /*!< SPI_T::FIFOCTL: TXTH Mask */ + +#define SPI_STATUS_BUSY_Pos (0) /*!< SPI_T::STATUS: BUSY Position */ +#define SPI_STATUS_BUSY_Msk (0x1ul << SPI_STATUS_BUSY_Pos) /*!< SPI_T::STATUS: BUSY Mask */ + +#define SPI_STATUS_UNITIF_Pos (1) /*!< SPI_T::STATUS: UNITIF Position */ +#define SPI_STATUS_UNITIF_Msk (0x1ul << SPI_STATUS_UNITIF_Pos) /*!< SPI_T::STATUS: UNITIF Mask */ + +#define SPI_STATUS_SSACTIF_Pos (2) /*!< SPI_T::STATUS: SSACTIF Position */ +#define SPI_STATUS_SSACTIF_Msk (0x1ul << SPI_STATUS_SSACTIF_Pos) /*!< SPI_T::STATUS: SSACTIF Mask */ + +#define SPI_STATUS_SSINAIF_Pos (3) /*!< SPI_T::STATUS: SSINAIF Position */ +#define SPI_STATUS_SSINAIF_Msk (0x1ul << SPI_STATUS_SSINAIF_Pos) /*!< SPI_T::STATUS: SSINAIF Mask */ + +#define SPI_STATUS_SSLINE_Pos (4) /*!< SPI_T::STATUS: SSLINE Position */ +#define SPI_STATUS_SSLINE_Msk (0x1ul << SPI_STATUS_SSLINE_Pos) /*!< SPI_T::STATUS: SSLINE Mask */ + +#define SPI_STATUS_SLVBEIF_Pos (6) /*!< SPI_T::STATUS: SLVBEIF Position */ +#define SPI_STATUS_SLVBEIF_Msk (0x1ul << SPI_STATUS_SLVBEIF_Pos) /*!< SPI_T::STATUS: SLVBEIF Mask */ + +#define SPI_STATUS_SLVURIF_Pos (7) /*!< SPI_T::STATUS: SLVURIF Position */ +#define SPI_STATUS_SLVURIF_Msk (0x1ul << SPI_STATUS_SLVURIF_Pos) /*!< SPI_T::STATUS: SLVURIF Mask */ + +#define SPI_STATUS_RXEMPTY_Pos (8) /*!< SPI_T::STATUS: RXEMPTY Position */ +#define SPI_STATUS_RXEMPTY_Msk (0x1ul << SPI_STATUS_RXEMPTY_Pos) /*!< SPI_T::STATUS: RXEMPTY Mask */ + +#define SPI_STATUS_RXFULL_Pos (9) /*!< SPI_T::STATUS: RXFULL Position */ +#define SPI_STATUS_RXFULL_Msk (0x1ul << SPI_STATUS_RXFULL_Pos) /*!< SPI_T::STATUS: RXFULL Mask */ + +#define SPI_STATUS_RXTHIF_Pos (10) /*!< SPI_T::STATUS: RXTHIF Position */ +#define SPI_STATUS_RXTHIF_Msk (0x1ul << SPI_STATUS_RXTHIF_Pos) /*!< SPI_T::STATUS: RXTHIF Mask */ + +#define SPI_STATUS_RXOVIF_Pos (11) /*!< SPI_T::STATUS: RXOVIF Position */ +#define SPI_STATUS_RXOVIF_Msk (0x1ul << SPI_STATUS_RXOVIF_Pos) /*!< SPI_T::STATUS: RXOVIF Mask */ + +#define SPI_STATUS_RXTOIF_Pos (12) /*!< SPI_T::STATUS: RXTOIF Position */ +#define SPI_STATUS_RXTOIF_Msk (0x1ul << SPI_STATUS_RXTOIF_Pos) /*!< SPI_T::STATUS: RXTOIF Mask */ + +#define SPI_STATUS_SPIENSTS_Pos (15) /*!< SPI_T::STATUS: SPIENSTS Position */ +#define SPI_STATUS_SPIENSTS_Msk (0x1ul << SPI_STATUS_SPIENSTS_Pos) /*!< SPI_T::STATUS: SPIENSTS Mask */ + +#define SPI_STATUS_TXEMPTY_Pos (16) /*!< SPI_T::STATUS: TXEMPTY Position */ +#define SPI_STATUS_TXEMPTY_Msk (0x1ul << SPI_STATUS_TXEMPTY_Pos) /*!< SPI_T::STATUS: TXEMPTY Mask */ + +#define SPI_STATUS_TXFULL_Pos (17) /*!< SPI_T::STATUS: TXFULL Position */ +#define SPI_STATUS_TXFULL_Msk (0x1ul << SPI_STATUS_TXFULL_Pos) /*!< SPI_T::STATUS: TXFULL Mask */ + +#define SPI_STATUS_TXTHIF_Pos (18) /*!< SPI_T::STATUS: TXTHIF Position */ +#define SPI_STATUS_TXTHIF_Msk (0x1ul << SPI_STATUS_TXTHIF_Pos) /*!< SPI_T::STATUS: TXTHIF Mask */ + +#define SPI_STATUS_TXUFIF_Pos (19) /*!< SPI_T::STATUS: TXUFIF Position */ +#define SPI_STATUS_TXUFIF_Msk (0x1ul << SPI_STATUS_TXUFIF_Pos) /*!< SPI_T::STATUS: TXUFIF Mask */ + +#define SPI_STATUS_TXRXRST_Pos (23) /*!< SPI_T::STATUS: TXRXRST Position */ +#define SPI_STATUS_TXRXRST_Msk (0x1ul << SPI_STATUS_TXRXRST_Pos) /*!< SPI_T::STATUS: TXRXRST Mask */ + +#define SPI_STATUS_RXCNT_Pos (24) /*!< SPI_T::STATUS: RXCNT Position */ +#define SPI_STATUS_RXCNT_Msk (0xful << SPI_STATUS_RXCNT_Pos) /*!< SPI_T::STATUS: RXCNT Mask */ + +#define SPI_STATUS_TXCNT_Pos (28) /*!< SPI_T::STATUS: TXCNT Position */ +#define SPI_STATUS_TXCNT_Msk (0xful << SPI_STATUS_TXCNT_Pos) /*!< SPI_T::STATUS: TXCNT Mask */ + +#define SPI_TX_TX_Pos (0) /*!< SPI_T::TX: TX Position */ +#define SPI_TX_TX_Msk (0xfffffffful << SPI_TX_TX_Pos) /*!< SPI_T::TX: TX Mask */ + +#define SPI_RX_RX_Pos (0) /*!< SPI_T::RX: RX Position */ +#define SPI_RX_RX_Msk (0xfffffffful << SPI_RX_RX_Pos) /*!< SPI_T::RX: RX Mask */ + +#define SPI_I2SCTL_I2SEN_Pos (0) /*!< SPI_T::I2SCTL: I2SEN Position */ +#define SPI_I2SCTL_I2SEN_Msk (0x1ul << SPI_I2SCTL_I2SEN_Pos) /*!< SPI_T::I2SCTL: I2SEN Mask */ + +#define SPI_I2SCTL_TXEN_Pos (1) /*!< SPI_T::I2SCTL: TXEN Position */ +#define SPI_I2SCTL_TXEN_Msk (0x1ul << SPI_I2SCTL_TXEN_Pos) /*!< SPI_T::I2SCTL: TXEN Mask */ + +#define SPI_I2SCTL_RXEN_Pos (2) /*!< SPI_T::I2SCTL: RXEN Position */ +#define SPI_I2SCTL_RXEN_Msk (0x1ul << SPI_I2SCTL_RXEN_Pos) /*!< SPI_T::I2SCTL: RXEN Mask */ + +#define SPI_I2SCTL_MUTE_Pos (3) /*!< SPI_T::I2SCTL: MUTE Position */ +#define SPI_I2SCTL_MUTE_Msk (0x1ul << SPI_I2SCTL_MUTE_Pos) /*!< SPI_T::I2SCTL: MUTE Mask */ + +#define SPI_I2SCTL_WDWIDTH_Pos (4) /*!< SPI_T::I2SCTL: WDWIDTH Position */ +#define SPI_I2SCTL_WDWIDTH_Msk (0x3ul << SPI_I2SCTL_WDWIDTH_Pos) /*!< SPI_T::I2SCTL: WDWIDTH Mask */ + +#define SPI_I2SCTL_MONO_Pos (6) /*!< SPI_T::I2SCTL: MONO Position */ +#define SPI_I2SCTL_MONO_Msk (0x1ul << SPI_I2SCTL_MONO_Pos) /*!< SPI_T::I2SCTL: MONO Mask */ + +#define SPI_I2SCTL_ORDER_Pos (7) /*!< SPI_T::I2SCTL: ORDER Position */ +#define SPI_I2SCTL_ORDER_Msk (0x1ul << SPI_I2SCTL_ORDER_Pos) /*!< SPI_T::I2SCTL: ORDER Mask */ + +#define SPI_I2SCTL_SLAVE_Pos (8) /*!< SPI_T::I2SCTL: SLAVE Position */ +#define SPI_I2SCTL_SLAVE_Msk (0x1ul << SPI_I2SCTL_SLAVE_Pos) /*!< SPI_T::I2SCTL: SLAVE Mask */ + +#define SPI_I2SCTL_MCLKEN_Pos (15) /*!< SPI_T::I2SCTL: MCLKEN Position */ +#define SPI_I2SCTL_MCLKEN_Msk (0x1ul << SPI_I2SCTL_MCLKEN_Pos) /*!< SPI_T::I2SCTL: MCLKEN Mask */ + +#define SPI_I2SCTL_RZCEN_Pos (16) /*!< SPI_T::I2SCTL: RZCEN Position */ +#define SPI_I2SCTL_RZCEN_Msk (0x1ul << SPI_I2SCTL_RZCEN_Pos) /*!< SPI_T::I2SCTL: RZCEN Mask */ + +#define SPI_I2SCTL_LZCEN_Pos (17) /*!< SPI_T::I2SCTL: LZCEN Position */ +#define SPI_I2SCTL_LZCEN_Msk (0x1ul << SPI_I2SCTL_LZCEN_Pos) /*!< SPI_T::I2SCTL: LZCEN Mask */ + +#define SPI_I2SCTL_RXLCH_Pos (23) /*!< SPI_T::I2SCTL: RXLCH Position */ +#define SPI_I2SCTL_RXLCH_Msk (0x1ul << SPI_I2SCTL_RXLCH_Pos) /*!< SPI_T::I2SCTL: RXLCH Mask */ + +#define SPI_I2SCTL_RZCIEN_Pos (24) /*!< SPI_T::I2SCTL: RZCIEN Position */ +#define SPI_I2SCTL_RZCIEN_Msk (0x1ul << SPI_I2SCTL_RZCIEN_Pos) /*!< SPI_T::I2SCTL: RZCIEN Mask */ + +#define SPI_I2SCTL_LZCIEN_Pos (25) /*!< SPI_T::I2SCTL: LZCIEN Position */ +#define SPI_I2SCTL_LZCIEN_Msk (0x1ul << SPI_I2SCTL_LZCIEN_Pos) /*!< SPI_T::I2SCTL: LZCIEN Mask */ + +#define SPI_I2SCTL_FORMAT_Pos (28) /*!< SPI_T::I2SCTL: FORMAT Position */ +#define SPI_I2SCTL_FORMAT_Msk (0x3ul << SPI_I2SCTL_FORMAT_Pos) /*!< SPI_T::I2SCTL: FORMAT Mask */ + +#define SPI_I2SCLK_MCLKDIV_Pos (0) /*!< SPI_T::I2SCLK: MCLKDIV Position */ +#define SPI_I2SCLK_MCLKDIV_Msk (0x7ful << SPI_I2SCLK_MCLKDIV_Pos) /*!< SPI_T::I2SCLK: MCLKDIV Mask */ + +#define SPI_I2SCLK_BCLKDIV_Pos (8) /*!< SPI_T::I2SCLK: BCLKDIV Position */ +#define SPI_I2SCLK_BCLKDIV_Msk (0x3fful << SPI_I2SCLK_BCLKDIV_Pos) /*!< SPI_T::I2SCLK: BCLKDIV Mask */ + +#define SPI_I2SSTS_RIGHT_Pos (4) /*!< SPI_T::I2SSTS: RIGHT Position */ +#define SPI_I2SSTS_RIGHT_Msk (0x1ul << SPI_I2SSTS_RIGHT_Pos) /*!< SPI_T::I2SSTS: RIGHT Mask */ + +#define SPI_I2SSTS_RXEMPTY_Pos (8) /*!< SPI_T::I2SSTS: RXEMPTY Position */ +#define SPI_I2SSTS_RXEMPTY_Msk (0x1ul << SPI_I2SSTS_RXEMPTY_Pos) /*!< SPI_T::I2SSTS: RXEMPTY Mask */ + +#define SPI_I2SSTS_RXFULL_Pos (9) /*!< SPI_T::I2SSTS: RXFULL Position */ +#define SPI_I2SSTS_RXFULL_Msk (0x1ul << SPI_I2SSTS_RXFULL_Pos) /*!< SPI_T::I2SSTS: RXFULL Mask */ + +#define SPI_I2SSTS_RXTHIF_Pos (10) /*!< SPI_T::I2SSTS: RXTHIF Position */ +#define SPI_I2SSTS_RXTHIF_Msk (0x1ul << SPI_I2SSTS_RXTHIF_Pos) /*!< SPI_T::I2SSTS: RXTHIF Mask */ + +#define SPI_I2SSTS_RXOVIF_Pos (11) /*!< SPI_T::I2SSTS: RXOVIF Position */ +#define SPI_I2SSTS_RXOVIF_Msk (0x1ul << SPI_I2SSTS_RXOVIF_Pos) /*!< SPI_T::I2SSTS: RXOVIF Mask */ + +#define SPI_I2SSTS_RXTOIF_Pos (12) /*!< SPI_T::I2SSTS: RXTOIF Position */ +#define SPI_I2SSTS_RXTOIF_Msk (0x1ul << SPI_I2SSTS_RXTOIF_Pos) /*!< SPI_T::I2SSTS: RXTOIF Mask */ + +#define SPI_I2SSTS_I2SENSTS_Pos (15) /*!< SPI_T::I2SSTS: I2SENSTS Position */ +#define SPI_I2SSTS_I2SENSTS_Msk (0x1ul << SPI_I2SSTS_I2SENSTS_Pos) /*!< SPI_T::I2SSTS: I2SENSTS Mask */ + +#define SPI_I2SSTS_TXEMPTY_Pos (16) /*!< SPI_T::I2SSTS: TXEMPTY Position */ +#define SPI_I2SSTS_TXEMPTY_Msk (0x1ul << SPI_I2SSTS_TXEMPTY_Pos) /*!< SPI_T::I2SSTS: TXEMPTY Mask */ + +#define SPI_I2SSTS_TXFULL_Pos (17) /*!< SPI_T::I2SSTS: TXFULL Position */ +#define SPI_I2SSTS_TXFULL_Msk (0x1ul << SPI_I2SSTS_TXFULL_Pos) /*!< SPI_T::I2SSTS: TXFULL Mask */ + +#define SPI_I2SSTS_TXTHIF_Pos (18) /*!< SPI_T::I2SSTS: TXTHIF Position */ +#define SPI_I2SSTS_TXTHIF_Msk (0x1ul << SPI_I2SSTS_TXTHIF_Pos) /*!< SPI_T::I2SSTS: TXTHIF Mask */ + +#define SPI_I2SSTS_TXUFIF_Pos (19) /*!< SPI_T::I2SSTS: TXUFIF Position */ +#define SPI_I2SSTS_TXUFIF_Msk (0x1ul << SPI_I2SSTS_TXUFIF_Pos) /*!< SPI_T::I2SSTS: TXUFIF Mask */ + +#define SPI_I2SSTS_RZCIF_Pos (20) /*!< SPI_T::I2SSTS: RZCIF Position */ +#define SPI_I2SSTS_RZCIF_Msk (0x1ul << SPI_I2SSTS_RZCIF_Pos) /*!< SPI_T::I2SSTS: RZCIF Mask */ + +#define SPI_I2SSTS_LZCIF_Pos (21) /*!< SPI_T::I2SSTS: LZCIF Position */ +#define SPI_I2SSTS_LZCIF_Msk (0x1ul << SPI_I2SSTS_LZCIF_Pos) /*!< SPI_T::I2SSTS: LZCIF Mask */ + +#define SPI_I2SSTS_TXRXRST_Pos (23) /*!< SPI_T::I2SSTS: TXRXRST Position */ +#define SPI_I2SSTS_TXRXRST_Msk (0x1ul << SPI_I2SSTS_TXRXRST_Pos) /*!< SPI_T::I2SSTS: TXRXRST Mask */ + +#define SPI_I2SSTS_RXCNT_Pos (24) /*!< SPI_T::I2SSTS: RXCNT Position */ +#define SPI_I2SSTS_RXCNT_Msk (0x7ul << SPI_I2SSTS_RXCNT_Pos) /*!< SPI_T::I2SSTS: RXCNT Mask */ + +#define SPI_I2SSTS_TXCNT_Pos (28) /*!< SPI_T::I2SSTS: TXCNT Position */ +#define SPI_I2SSTS_TXCNT_Msk (0x7ul << SPI_I2SSTS_TXCNT_Pos) /*!< SPI_T::I2SSTS: TXCNT Mask */ + +/**@}*/ /* SPI_CONST */ +/**@}*/ /* end of SPI register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __SPI_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/spim_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/spim_reg.h new file mode 100644 index 00000000000..59a9a343f18 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/spim_reg.h @@ -0,0 +1,557 @@ +/**************************************************************************//** + * @file spim_reg.h + * @version V1.00 + * @brief SPIM register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __SPIM_REG_H__ +#define __SPIM_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup SPIM Serial Peripheral Interface Controller Master Mode (SPIM) + Memory Mapped Structure for SPIM Controller +@{ */ + +typedef struct +{ + + + /** + * @var SPIM_T::CTL0 + * Offset: 0x00 Control and Status Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CIPHOFF |Cipher Disable Control + * | | |0 = Cipher function Enabled. + * | | |1 = Cipher function Disabled. + * | | |Note1: If there is not any KEY1(SPIM_KEY1[31:0]) or KEY2(SPIM_KEY2[31:0]) (KEY1 is 0x0000_0000 or KEY2 is 0x0000_0000), the cipher function will be disabled automatically. + * | | |Note2: When CIPHOFF(SPIM_CTL0[0]) is 0, both of KEY1(SPIM_KEY1[31:0]) and KEY2(SPIM_KEY2[31:0]) do not equal to 0x0000_0000 (i.e. + * | | |KEY1 != 0x0000_0000 and KEY2 != 0x0000_0000), cipher encryption/decryption is enabled. + * | | |Note3 : When cipher encryption/decryption is enabled, please set DESELTIM (SPIM_DMMCTL[20:16]) >= 0x10. + * | | |When cipher encryption/decryption is disabled, please set DESELTIM(SPIM_DMMCTL[20:16]) >= 0x8. + * |[2] |BALEN |Balance the AHB Control Time Between Cipher Enable and Disable Control + * | | |When cipher is enabled, the AHB control signal will delay some time caused by the encoding or decoding calculation + * | | |Therefore, if set BALEN to 1, it will make the AHB signal processing time with cipher disabled be equal to that with cipher enabled. + * | | |Note: Only useful when cipher is disabled. + * |[5] |B4ADDREN |4-byte Address Mode Enable Control + * | | |0 = 4-byte address mode is disabled, and 3-byte address mode is enabled. + * | | |1 = 4-byte address mode is enabled. + * | | |Note: Used for DMA write mode, DMA read mode, and DMM mode. + * |[6] |IEN |Interrupt Enable Control + * | | |0 = SPIM Interrupt Disabled. + * | | |1 = SPIM Interrupt Enabled. + * |[7] |IF |Interrupt Flag + * | | |(1) Write Operation : + * | | |0 = No effect. + * | | |1 = Write 1 to clear. + * | | |(2) Read Operation : + * | | |0 = The transfer has not finished yet. + * | | |1 = The transfer has done. + * |[12:8] |DWIDTH |Transmit/Receive Bit Length + * | | |This specifies how many bits are transmitted/received in one transmit/receive transaction. + * | | |0x7 = 8 bits. + * | | |0xF = 16 bits. + * | | |0x17 = 24 bits. + * | | |0x1F = 32 bits. + * | | |Others = Incorrect transfer result. + * | | |Note1: Only used for normal I/O mode. + * | | |Note2: Only 8, 16, 24, and 32 bits are allowed. Other bit length will result in incorrect transfer. + * |[14:13] |BURSTNUM |Transmit/Receive Burst Number + * | | |This field specifies how many transmit/receive transactions should be executed continuously in one transfer. + * | | |0x0 = Only one transmit/receive transaction will be executed in one transfer. + * | | |0x1 = Two successive transmit/receive transactions will be executed in one transfer. + * | | |0x2 = Three successive transmit/receive transactions will be executed in one transfer. + * | | |0x3 = Four successive transmit/receive transactions will be executed in one transfer. + * | | |Note: Only used for normal I/O Mode. + * |[15] |QDIODIR |SPI Interface Direction Select for Quad/Dual Mode + * | | |0 = Interface signals are input. + * | | |1 = Interface signals are output. + * | | |Note: Only used for normal I/O mode. + * |[19:16] |SUSPITV |Suspend Interval + * | | |These four bits provide the configuration of suspend interval between two successive transmit/receive transactions in a transfer + * | | |The default value is 0x00 + * | | |When BURSTNUM = 00, setting this field has no effect on transfer + * | | |The desired interval is obtained according to the following equation (from the last falling edge of current SPI clock to the first rising edge of next SPI clock): + * | | | (SUSPITV+2)*period of AHB clock + * | | | 0x0 = 2 AHB clock cycles. + * | | | 0x1 = 3 AHB clock cycles. + * | | | ...... + * | | | 0xE = 16 AHB clock cycles. + * | | | 0xF = 17 AHB clock cycles. + * | | | Note: Only used for normal I/O mode. + * |[21:20] |BITMODE |SPI Interface Bit Mode + * | | |0x0 = Standard mode. + * | | |0x1 = Dual mode. + * | | |0x2 = Quad mode. + * | | |0x3 = Reserved. + * | | |Note: Only used for normal I/O mode. + * |[23:22] |OPMODE |SPI Function Operation Mode + * | | |0x0 = Normal I/O mode. (Note1) (Note3) + * | | |0x1 = DMA write mode. (Note2) (Note3) + * | | |0x2 = DMA read mode. (Note3) + * | | |0x3 = Direct Memory Mapping mode (DMM mode) (Default). (Note4) + * | | |Note1 : After user uses Normal I/O mode of SPI flash controller to program the content of external SPI flash, please set CDINVAL(SPIM_CTL1[3]) to 0x1 (Set all cache data to be invalid). + * | | |Note2 : In DMA write mode, hardware will send just one page program command per operation + * | | |Users must take care of cross-page cases + * | | |After user uses DMA write mode of SPI flash controller to program the content of external SPI flash, please set CDINVAL(SPIM_CTL1[3]) to 0x1 (Set all cache data to be invalid). + * | | |Note3 : For external SPI flash with 32 MB, access address range of external SPI flash address is from 0x00000000 to 0x01FFFFFF when user uses Normal I/O mode, DMA write mode, and DMA read mode to write/read external SPI flash data + * | | |Please user check size of used SPI flash component to know access address range of external SPI flash. + * | | |Note4 : For external SPI flash with 32 MB, access address range of external SPI flash address is from 0x08000000 to 0x09FFFFFF when user uses Direct Memory mapping mode (DMM mode) to read external SPI flash data + * | | |Please user check size of used SPI flash component to know access address range of external SPI flash. + * |[31:24] |CMDCODE |Page Program Command Code (Note4) + * | | |(1) 0x02 = Page program (Used for DMA Write mode). + * | | |(2) 0x32 = Quad page program with TYPE_1 program flow (Used for DMA Write mode). (Note3) + * | | |(3) 0x38 = Quad page program with TYPE_2 program flow (Used for DMA Write mode). (Note3) + * | | |(4) 0x40 = Quad page program with TYPE_3 program flow (Used for DMA Write mode). (Note3) + * | | |The Others = Reserved. + * | | |Read Command Code : + * | | |(1) 0x03 = Standard Read (Used for DMA Read/DMM mode). + * | | |(2) 0x0B = Fast Read (Used for DMA Read/DMM mode). + * | | |The fast read command code "0x0B" is similar to command code of standard read "0x03" except it can operate at highest possible frequency + * | | |(Note2) + * | | |(3) 0x3B = Fast Read Dual Output (Used for DMA Read/DMM mode). + * | | |(4) 0xBB = Fast Read Dual I/O (Used for DMA Read/DMM mode). + * | | |The fast read dual I/O command code "0xBB" is similar to command code of fast read dual output "0x3B" but with capability to input the address bits two bits per clock + * | | |(Note2) + * | | |(5) 0xEB = Fast quad read (Used for DMA Read/DMM mode). + * | | |(6) 0xE7 = Word quad read (Used for DMA Read/DMM mode). + * | | |The command code of word quad read "0xE7" is similar to command code of fast quad read "0xEB" except that the lowest address bit must equal to 0 and the number of dummy cycles is less than fast quad read + * | | |(Note2) + * | | |(7) 0x0D = DTR/DDR Fast read (Used for DMA Read/DMM mode). + * | | |(8) 0xBD = DTR/DDR dual read (Used for DMA Read/DMM mode). + * | | |(9) 0xED = DTR/DDR quad read (Used for DMA Read/DMM mode). + * | | |The Others command codes are Reserved. + * | | |The DTR/DDR read commands "0x0D,0xBD,0xED" improves throughput by transferring address and data on both the falling and rising edge of SPI flash clock (SPIM_CLK) + * | | |It is similar to those commands "0x0B, 0xBB, 0xEB" but allows transfer of address and data on rising edge and falling edge of SPI flash output clock + * | | |(Note2) + * | | |Note1: Quad mode of SPI Flash must be enabled first by normal I/O mode before using quad page program/quad read commands. + * | | |Note2: See SPI flash specifications for support items. + * | | |Note3: For TYPE_1, TYPE_2, and TYPE_3 of page program command code, refer to Figure 7.19-3, Figure 7.19-4, and Figure 7.19-5. + * | | |Note4: Please disable "continuous read mode" and "burst wrap mode" before DMA write mode of SPI flash controller is used to program data of external SPI flash + * | | |After user uses DMA write mode of SPI flash controller to program the content of external SPI flash, please set CDINVAL(SPIM_CTL1[3]) to 0x1 (Set all cache data to be invalid). + * @var SPIM_T::CTL1 + * Offset: 0x04 Control Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SPIMEN |Go and Busy Status + * | | |(1) Write Operation : + * | | |0 = No effect. + * | | |1 = Start the transfer + * | | |This bit remains set during the transfer and is automatically cleared after transfer finished. + * | | |(2) Read Operation : + * | | |0 = The transfer has done. + * | | |1 = The transfer has not finished yet. + * | | |Note: All registers should be set before writing 1 to the SPIMEN bit + * | | |When a transfer is in progress, you should not write to any register of this peripheral. + * |[1] |CACHEOFF |Cache Memory Function Disable Control + * | | |0 = Cache memory function enable. (Default value) + * | | |1 = Cache memory function disable. + * | | |Note: When CCM mode is enabled, the cache function will be disable by hardware automatically + * | | |When CCM mode is disabled, the cache function can be enable or disable by user. + * |[2] |CCMEN |CCM (Core Coupled Memory) Mode Enable Control + * | | |0 = CCM mode disable. (Default value) + * | | |1 = CCM mode enable. + * | | |Note1: When CCM mode is enabled, the cache function will be disable by hardware automatically + * | | |When CCM mode is disabled, the cache function can be enabled or disabled by user. + * | | |Note2: When CCM mode is disabled, user accesses the core coupled memory by bus master + * | | |In this case, the SPI flash controller will send error response via HRESP bus signal to bus master. + * | | |Note3: When CCM mode needs to be enabled, user sets CCMEN to 1 and needs to read this register to show the current hardware status + * | | |When reading data of CCMEN is 1, MCU can start to read data from CCM memory space or write data to CCM memory space. + * |[3] |CDINVAL |Cache Data Invalid Enable Control + * | | |(1) Write Operation: + * | | |0 = No effect. + * | | |1 = Set all cache data to be invalid. This bit is cleared by hardware automatically. + * | | |(2) Read Operation : No effect + * | | |Note: When SPI flash memory is page erasing or whole flash erasing, please set CDINVAL to 0x1 + * | | |After user uses normal I/O mode or DMA write mode of SPI flash controller to program or erase the content of external SPI flash, please set CDINVAL to 0x1. + * |[4] |SS |Slave Select Active Enable Control + * | | |0 = SPIM_SS is in active level. + * | | |1 = SPIM_SS is in inactive level (Default). + * | | |Note: This interface can only drive one device/slave at a given time + * | | |Therefore, the slave selects of the selected device must be set to its active level before starting any read or write transfer + * | | |Functional description of SSACTPOL(SPIM_CTL1[5]) and SS is shown in Table 2. + * |[5] |SSACTPOL |Slave Select Active Level + * | | |It defines the active level of device/slave select signal (SPIM_SS), and we show in Table 2. + * | | |0 = The SPIM_SS slave select signal is active low. + * | | |1 = The SPIM_SS slave select signal is active high. + * |[11:8] |IDLETIME |Idle Time Interval + * | | |In DMM mode, IDLETIME is set to control the minimum idle time between two SPI Flash accesses. + * | | |Minimum idle time = (IDLETIME + 1) * AHB clock cycle time. + * | | |Note1: Only used for DMM mode. + * | | |Note2 : AHB clock cycle time = 1/AHB clock frequency. + * |[31:16] |DIVIDER |Clock Divider Register + * | | |The value in this field is the frequency divider of the AHB clock (HCLK) to generate the serial SPI output clock "SCLK" on the output SPIM_CLK pin + * | | |The desired frequency is obtained according to the following equation: + * | | |Note1: When set DIVIDER to zero, the frequency of SPIM_CLK will be equal to the frequency of HCLK. + * | | |Note2: SCLK is serial SPI output clock. + * | | |Note3: Please check the specification of the used SPI flash component to decide the frequency of SPI flash clock. + * | | |Note4: For DTR/DDR read commands "0x0D, 0xBD, 0xED", the setting values of DIVIDER are only 1,2,4,8,16,32,..., where n = 0,1,2,3,4, ... + * @var SPIM_T::RXCLKDLY + * Offset: 0x0C RX Clock Delay Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |DWDELSEL |SPI flash deselect time interval of DMA write mode + * | | |For DMA write mode only + * | | |This register sets the deselect time interval of SPI flash (i.e. + * | | |time interval of inactive level of SPIM_SS) when SPI flash controller operates on DMA write mode + * | | |(Note1) + * | | |Deselect time interval of DMA write mode = (DWDELSEL + 1) * AHB clock cycle time (Note2). + * | | |Note1: Please user check the used external SPI flash component to set this register value + * | | |In general case, the deselect time interval of SPI flash is greater than 50 ns when SPI flash performs the program operation. + * | | |Note2: AHB clock cycle time = 1/AHB clock frequency. + * |[18:16] |RDDLYSEL |Sampling Clock Delay Selection for Received Data + * | | |For Normal I/O mode, DMA read mode, DMA write mode, and direct memory mapping mode + * | | |Determine the number of inserted delay cycles + * | | |Used to adjust the sampling clock of received data to latch the correct data. + * | | |0x0 : No delay. (Default Value) + * | | |0x1 : Delay 1 SPI flash clock. + * | | |0x2 : Delay 2 SPI flash clocks. + * | | |0x3 : Delay 3 SPI flash clocks. + * | | |... + * | | |0x7 : Delay 7 SPI flash clocks + * | | |Note : We can use manufacturer id or device id of external SPI flash component to determine the correct setting value of RDDLYSEL, and we give example as follows. + * | | |For example, manufacturer id and device id of external SPI flash for some vendor are 0xEF and 0x1234 separately + * | | |Firstly, we set RDDLYSEL to 0x0, and use read manufacturer id/device id command to read the manufacturer id of external SPI flash by using normal I/O mode (the manufacturer id is 0xEF (1110_1111) in this example). + * | | |If manufacturer id which reads from external SPI flash is 0xF7 (1111_0111), it denotes that manufacturer id is shifted the right by 1 bit and most significant bit (MSB) of manufacturer id is assigned to 1 + * | | |According to manufacturer id reads from external SPI flash, we need to set RDDLYSEL to 0x1 to receive SPI flash data correctly. + * |[20] |RDEDGE |Sampling Clock Edge Selection for Received Data + * | | |For Normal I/O mode, DMA read mode, DMA write mode, and direct memory mapping mode + * | | |0 : Use SPI input clock rising edge to sample received data. (Default Value) + * | | |1 : Use SPI input clock falling edge to sample received data. + * @var SPIM_T::RX[4] + * Offset: 0x10 ~ 0x1C Data Receive Register 0 ~ 3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |RXDAT |Data Receive Register + * | | |The Data Receive Registers hold the received data of the last executed transfer. + * | | |Number of valid RX registers is specified in SPIM_CTL0[BURSTNUM] + * | | |If BURSTNUM > 0, received data are held in the most significant RXDAT register first. + * | | |Number of valid-bit is specified in SPIM_CTL0[DWIDTH] + * | | |If DWIDTH is 16, 24, or 32, received data are held in the least significant byte of RXDAT register first. + * | | |In a byte, received data are held in the most significant bit of RXDAT register first. + * | | |Example 1: If SPIM_CTL0[BURSTNUM] = 0x3 and SPIM_CTL1[DWIDTH] = 0x17, received data will be held in the order SPIM_RX3[23:0], SPIM_RX2[23:0], SPIM_RX1[23:0], SPIM_RX0[23:0]. + * | | |Example 2: If SPIM_CTL0[BURSTNUM = 0x0 and SPIM_CTL0[DWIDTH] = 0x17, received data will be held in the order SPIM_RX0[7:0], SPIM_RX0[15:8], SPIM_RX0[23:16]. + * | | |Example 3: If SPIM_CTL0[BURSTNUM = 0x0 and SPIM_CTL0[DWIDTH] = 0x07, received data will be held in the order SPIM_RX0[7], SPIM_RX0[6], ..., + * | | |SPIM_RX0[0]. + * @var SPIM_T::TX[4] + * Offset: 0x20 ~ 0x2C Data Transmit Register 0 ~ 3 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |TXDAT |Data Transmit Register + * | | |The Data Transmit Registers hold the data to be transmitted in next transfer. + * | | |Number of valid TXDAT registers is specified in SPIM_CTL0[BURSTNUM] + * | | |If BURSTNUM > 0, data are transmitted in the most significant TXDAT register first. + * | | |Number of valid-bit is specified in SPIM_CTL0[DWIDTH] + * | | |If DWIDTH is 16, 24, or 32, data are transmitted in the least significant byte of TXDAT register first. + * | | |In a byte, data are transmitted in the most significant bit of TXDAT register first. + * | | |Example 1: If SPIM_CTL0[BURSTNUM] = 0x3 and SPIM_CTL1[DWIDTH] = 0x17, data will be transmitted in the order SPIM_TX3[23:0], SPIM_TX2[23:0], SPIM_TX1[23:0], SPIM_TX0[23:0] in next transfer. + * | | |Example 2: If SPIM_CTL0[BURSTNUM] = 0x0 and SPIM_CTL0[DWIDTH] = 0x17, data will be transmitted in the order SPIM_TX0[7:0], SPIM_TX0[15:8], SPIM_TX0[23:16] in next transfer. + * | | |Example 3: If SPIM_CTL0[BURSTNUM] = 0x0 and SPIM_CTL0[DWIDTH] = 0x07, data will be transmitted in the order SPIM_TX0[7], SPIM_TX0[6], ..., + * | | |SPIM_TX0[0] in next transfer. + * @var SPIM_T::SRAMADDR + * Offset: 0x30 SRAM Memory Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |ADDR |SRAM Memory Address + * | | |For DMA Read mode, this is the destination address for DMA transfer. + * | | |For DMA Write mode, this is the source address for DMA transfer. + * | | |Note: This address must be word-aligned. + * @var SPIM_T::DMACNT + * Offset: 0x34 DMA Transfer Byte Count Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:0] |DMACNT |DMA Transfer Byte Count Register + * | | |It indicates the transfer length for DMA process. + * | | |Note1: The unit for counting is byte. + * | | |Note2: The number must be the multiple of 4. + * | | |Note3: Please check specification of used SPI flash to know maximum byte length of page program. + * @var SPIM_T::FADDR + * Offset: 0x38 SPI Flash Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |ADDR |SPI Flash Address Register + * | | |For DMA Read mode, this is the source address for DMA transfer. + * | | |For DMA Write mode, this is the destination address for DMA transfer. + * | | |Note 1 : This address must be word-aligned. + * | | |Note 2 : For external SPI flash with 32 MB, the value of this SPI flash address register "ADDR" is from 0x00000000 to 0x01FFFFFF when user uses DMA write mode and DMA read mode to write/read external SPI flash data + * | | |Please user check size of used SPI flash component to know access address range of external SPI flash. + * @var SPIM_T::KEY1 + * Offset: 0x3C Cipher Key1 Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY1 |Cipher Key1 Register + * | | |This is the KEY1 data for cipher function. + * | | |Note1: If there is not any KEY1(SPIM_KEY1[31:0]) or KEY2(SPIM_KEY2[31:0]) (KEY1 is 0x0000_0000 or KEY2 is 0x0000_0000), the cipher function will be disabled automatically. + * | | |Note2: When CIPHOFF(SPIM_CTL0[0]) is 0, both of KEY1(SPIM_KEY1[31:0]) and KEY2(SPIM_KEY2[31:0]) do not equal to 0x0000_0000 (i.e. + * | | |KEY1 != 0x0000_0000 and KEY2 != 0x0000_0000), cipher encryption/decryption is enabled. + * @var SPIM_T::KEY2 + * Offset: 0x40 Cipher Key2 Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |KEY2 |Cipher Key2 Register + * | | |This is the KEY2 data for cipher function. + * | | |Note1: If there is not any KEY1(SPIM_KEY1[31:0]) or KEY2(SPIM_KEY2[31:0]) (KEY1 is 0x0000_0000 or KEY2 is 0x0000_0000), the cipher function will be disabled automatically. + * | | |Note2: When CIPHOFF(SPIM_CTL0[0]) is 0, both of KEY1(SPIM_KEY1[31:0]) and KEY2(SPIM_KEY2[31:0]) do not equal to 0x0000_0000 (i.e. + * | | |KEY1 != 0x0000_0000 and KEY2 != 0x0000_0000), cipher encryption/decryption is enabled. + * @var SPIM_T::DMMCTL + * Offset: 0x44 Direct Memory Mapping Mode Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:8] |CRMDAT |Mode bits data for Continuous Read Mode (or performance enhance mode) (Default value = 0) + * | | |Only for direct memory mapping mode + * | | |Set the mode bits data for continuous read mode (or performance enhance mode). + * | | |When we set this mode bits currently (Note1) and set CREN(SPIM_DMMCTL[25]), this reduces the command phase by eight clocks and allows the read address to be immediately entered after SPIM_SS asserted to active + * | | |(Note1) + * | | |Note1 : Please check the used SPI flash specification to know the setting value of this mode bits data, and different SPI flash vendor may use different setting values. + * | | |Note2 : CRMDAT needs to used with CREN(SPIM_DMMCTL[25]). + * |[20:16] |DESELTIM |SPI Flash Deselect Time + * | | |Only for direct memory mapping mode + * | | |Set the minimum time width of SPI flash deselect time (i.e. + * | | |Minimum SPIM_SS deselect time), and we show in Figure 7.19-8. + * | | |(1) Cache function disable : + * | | |Minimum time width of SPIM_SS deselect time = (DESELTIM + 1) * AHB clock cycle time. + * | | |(2) Cache function enable : + * | | |Minimum time width of SPIM_SS deselect time = (DESELTIM + 4) * AHB clock cycle time. + * | | |Note1 : AHB clock cycle time = 1/AHB clock frequency. + * | | |Note2 : When cipher encryption/decryption is enabled, please set this register value >= 0x10 + * | | |When cipher encryption/decryption is disabled, please set this register value >= 0x8. + * | | |Note3 : Please check the used SPI flash specification to know the setting value of this register, and different SPI flash vendor may use different setting values. + * |[24] |BWEN |16 bytes Burst Wrap Mode Enable Control Register (Default value = 0) + * | | |Only for WINBOND SPI flash, direct memory mapping mode, Cache enable, and read command code "0xEB, and 0xE7" + * | | |0 = Burst Wrap Mode Disable. (Default) + * | | |1 = Burst Wrap Mode Enable. + * | | |In direct memory mapping mode, both of quad read commands "0xEB" and "0xE7" support burst wrap mode for cache application and performance enhance + * | | |For cache application, the burst wrap mode can be used to fill the cache line quickly (In this SPI flash controller, we use cache data line with 16 bytes size) + * | | |For performance enhance with direct memory mapping mode and cache enable, when cache data is miss, the burst wrap mode can let MCU get the required SPI flash data quickly. + * |[25] |CREN |Continuous Read Mode Enable Control + * | | |Only for direct memory mapping mode, read command codes 0xBB, 0xEB, 0xE7, 0x0D, 0xBD, 0xED (Note2) + * | | |0 = Continuous Read Mode Disable. (Default) + * | | |1 = Continuous Read Mode Enable. + * | | |For read operations of SPI flash, commands of fast read quad I/O (0xEB), word read quad I/O (0xE7 in Winbond SPI flash), fast read dual I/O (0xBB), DTR/DDR fast read (0x0D), DTR/DDR fast read dual I/O (0xBD), and DTR/DDR fast read quad I/O (0xED) can further reduce command overhead through setting the "continuous read mode" bits (8 bits) after the input address data. + * | | |Note: When user uses function of continuous read mode and sets USETEN (SPIM_CTL2[16]) to 1, CRMDAT(SPIM_DMMCTL[15:8]) must be set by used SPI flash specifications + * | | |When user uses function of continuous read mode and sets USETEN(SPIM_CTL2[16]) to 0, CRMDAT(SPIM_DMMCTL[15:8]) is set by default value of WINBOND SPI flash. + * |[26] |UACTSCLK |User Sets SPI Flash Active SCLK Time + * | | |Only for direct memory mapping mode, DMA write mode, and DMA read mode + * | | |0 = According to DIVIDER(SPIM_CTL1[31:16]), ACTSCLKT(SPIM_DMMCTL[31:28]) is set by hardware automatically + * | | |(Default value) + * | | |1 = Set ACTSCLKT(SPIM_DMMCTL[31:28]) by user manually. + * | | |When user wants to set ACTSCLKT(SPIM_DMMCTL[31:28]) manually, please set UACTSCLK to 1. + * |[31:28] |ACTSCLKT |SPI Flash Active SCLK Time + * | | |Only for direct memory mapping mode, DMA write mode, and DMA read mode + * | | |This register sets time interval between SPIM SS active edge and the position edge of the first serial SPI output clock, and we show in Figure 7.19-8. + * | | |(1) ACTSCLKT = 0 (function disable) :. + * | | |Time interval = 1 AHB clock cycle time. + * | | |(2) ACTSCLKT != 0 (function enable) : + * | | |Time interval = (ACTSCLKT + 3) * AHB clock cycle time. + * | | |Note1 : AHB clock cycle time = 1/AHB clock frequency. + * | | |Note2 : SCLK is SPI output clock + * | | |Note3 : Please check the used SPI flash specification to know the setting value of this register, and different SPI flash vendor may use different setting values. + * @var SPIM_T::CTL2 + * Offset: 0x48 Control Register 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[16] |USETEN |User Set Value Enable Control + * | | |Only for direct memory mapping mode and DMA read mode with read commands 0x03,0x0B,0x3B,0xBB,0xEB,0xE7 + * | | |0 = Hardware circuit of SPI flash controller will use the following default values of DCNUM(SPIM_CTL2[28:24]) and CRMDAT(SPIM_DMMCTL[15:8]) to configure SPI flash operations automatically. + * | | |Dummy cycle number (DCNUM) : + * | | |Dummy cycle number for read command 0x03 : 0x0 + * | | |Dummy cycle number for read command 0x0B : 0x8 + * | | |Dummy cycle number for read command 0x3B : 0x8 + * | | |Dummy cycle number for read command 0xBB : 0x0 + * | | |Dummy cycle number for read command 0xEB : 0x4 + * | | |Dummy cycle number for read command 0xE7 : 0x2 + * | | |Mode bits data for continuous read mode (CRMDAT) : 0x20 + * | | |1 = If DCNUM(SPIM_CTL2[28:24]) and CRMDAT(SPIM_DMMCTL[15:8]) are not set as above default values, user must set USETEN to 0x1, DCNUM(SPIM_CTL2[28:24]) and CRMDAT(SPIM_DMMCTL[15:8]) to configure SPI flash operations manually. + * | | |For DTR/DDR command codes 0x0D, 0xBD, and 0xED, please set USETEN to 0x1. + * |[20] |DTRMPOFF |Mode Phase OFF for DTR/DDR Command Codes 0x0D, 0xBD, and 0xED + * | | |Only for direct memory mapping mode and DMA read mode (Note1) + * | | |0 = mode cycle number (or performance enhance cycle number) does not equal to 0x0 in DTR/DDR read command codes 0x0D, 0xBD, and 0xED. + * | | |1 = mode cycle number (or performance enhance cycle number) equals to 0x0 in DTR/DDR read command codes 0x0D, 0xBD, and 0xED. + * | | |Note1 : Please check the used SPI flash specification to know the mode cycle number (or performance enhance cycle number) for DTR/DDR command codes 0x0D, 0xBD, and 0xED. + * |[28:24] |DCNUM |Dummy Cycle Number + * | | |Only for direct memory mapping mode and DMA read mode (Note1) + * | | |Set number of dummy cycles + * | | |(1) For non-DTR/non-DDR command codes 0x03, 0x0B, 0x3B, 0xBB, 0xEB, and 0xE7 : + * | | |When read command code do not need any dummy cycles (i.e. + * | | |dummy cycle number = 0x0), user must set DCNUM to 0x0. + * | | |For command code 0xBB, if both mode cycle number (or performance enhance cycle number) and dummy cycle number do not equal to 0x0 simultaneously, user must set DCNUM to "mode cycle number + dummy cycle number" by used SPI flash specification. + * | | |For command code 0xBB, if there is only dummy cycle number (i.e. + * | | |dummy cycle number != 0x0 and mode cycle number = 0x0 (or performance enhance cycle number = 0x0)), user set DCNUM to dummy cycle number by used SPI flash specification. + * | | |For command codes 0x0B, 0x3B, 0xEB, and 0xE7, user only set DCNUM to dummy cycle number by used SPI flash specification. + * | | |(2) For DTR/DDR command codes 0x0D, 0xBD, and 0xED : + * | | |user sets DCNUM to dummy cycle number and DTRMPOFF(SPIM_CTL2[20]) by used SPI flash specification. + * | | |Note1 : Number of dummy cycles depends on the frequency of SPI output clock, SPI flash vendor, and read command types + * | | |Please check the used SPI flash specification to know the setting value of this number of dummy cycles. + */ + __IO uint32_t CTL0; /*!< [0x0000] Control and Status Register 0 */ + __IO uint32_t CTL1; /*!< [0x0004] Control Register 1 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t RXCLKDLY; /*!< [0x000c] RX Clock Delay Control Register */ + __I uint32_t RX[4]; /*!< [0x0010] ~ [0x001C] Data Receive Register 0~3 */ + __IO uint32_t TX[4]; /*!< [0x0020] ~ [0x002C] Data Transmit Register 0~3 */ + __IO uint32_t SRAMADDR; /*!< [0x0030] SRAM Memory Address Register */ + __IO uint32_t DMACNT; /*!< [0x0034] DMA Transfer Byte Count Register */ + __IO uint32_t FADDR; /*!< [0x0038] SPI Flash Address Register */ + __O uint32_t KEY1; /*!< [0x003c] Cipher Key1 Register */ + __O uint32_t KEY2; /*!< [0x0040] Cipher Key2 Register */ + __IO uint32_t DMMCTL; /*!< [0x0044] Direct Memory Mapping Mode Control Register */ + __IO uint32_t CTL2; /*!< [0x0048] Control Register 2 */ + +} SPIM_T; + +/** + @addtogroup SPIM_CONST SPIM Bit Field Definition + Constant Definitions for SPIM Controller +@{ */ + +#define SPIM_CTL0_CIPHOFF_Pos (0) /*!< SPIM_T::CTL0: CIPHOFF Position */ +#define SPIM_CTL0_CIPHOFF_Msk (0x1ul << SPIM_CTL0_CIPHOFF_Pos) /*!< SPIM_T::CTL0: CIPHOFF Mask */ + +#define SPIM_CTL0_BALEN_Pos (2) /*!< SPIM_T::CTL0: BALEN Position */ +#define SPIM_CTL0_BALEN_Msk (0x1ul << SPIM_CTL0_BALEN_Pos) /*!< SPIM_T::CTL0: BALEN Mask */ + +#define SPIM_CTL0_B4ADDREN_Pos (5) /*!< SPIM_T::CTL0: B4ADDREN Position */ +#define SPIM_CTL0_B4ADDREN_Msk (0x1ul << SPIM_CTL0_B4ADDREN_Pos) /*!< SPIM_T::CTL0: B4ADDREN Mask */ + +#define SPIM_CTL0_IEN_Pos (6) /*!< SPIM_T::CTL0: IEN Position */ +#define SPIM_CTL0_IEN_Msk (0x1ul << SPIM_CTL0_IEN_Pos) /*!< SPIM_T::CTL0: IEN Mask */ + +#define SPIM_CTL0_IF_Pos (7) /*!< SPIM_T::CTL0: IF Position */ +#define SPIM_CTL0_IF_Msk (0x1ul << SPIM_CTL0_IF_Pos) /*!< SPIM_T::CTL0: IF Mask */ + +#define SPIM_CTL0_DWIDTH_Pos (8) /*!< SPIM_T::CTL0: DWIDTH Position */ +#define SPIM_CTL0_DWIDTH_Msk (0x1ful << SPIM_CTL0_DWIDTH_Pos) /*!< SPIM_T::CTL0: DWIDTH Mask */ + +#define SPIM_CTL0_BURSTNUM_Pos (13) /*!< SPIM_T::CTL0: BURSTNUM Position */ +#define SPIM_CTL0_BURSTNUM_Msk (0x3ul << SPIM_CTL0_BURSTNUM_Pos) /*!< SPIM_T::CTL0: BURSTNUM Mask */ + +#define SPIM_CTL0_QDIODIR_Pos (15) /*!< SPIM_T::CTL0: QDIODIR Position */ +#define SPIM_CTL0_QDIODIR_Msk (0x1ul << SPIM_CTL0_QDIODIR_Pos) /*!< SPIM_T::CTL0: QDIODIR Mask */ + +#define SPIM_CTL0_SUSPITV_Pos (16) /*!< SPIM_T::CTL0: SUSPITV Position */ +#define SPIM_CTL0_SUSPITV_Msk (0xful << SPIM_CTL0_SUSPITV_Pos) /*!< SPIM_T::CTL0: SUSPITV Mask */ + +#define SPIM_CTL0_BITMODE_Pos (20) /*!< SPIM_T::CTL0: BITMODE Position */ +#define SPIM_CTL0_BITMODE_Msk (0x3ul << SPIM_CTL0_BITMODE_Pos) /*!< SPIM_T::CTL0: BITMODE Mask */ + +#define SPIM_CTL0_OPMODE_Pos (22) /*!< SPIM_T::CTL0: OPMODE Position */ +#define SPIM_CTL0_OPMODE_Msk (0x3ul << SPIM_CTL0_OPMODE_Pos) /*!< SPIM_T::CTL0: OPMODE Mask */ + +#define SPIM_CTL0_CMDCODE_Pos (24) /*!< SPIM_T::CTL0: CMDCODE Position */ +#define SPIM_CTL0_CMDCODE_Msk (0xfful << SPIM_CTL0_CMDCODE_Pos) /*!< SPIM_T::CTL0: CMDCODE Mask */ + +#define SPIM_CTL1_SPIMEN_Pos (0) /*!< SPIM_T::CTL1: SPIMEN Position */ +#define SPIM_CTL1_SPIMEN_Msk (0x1ul << SPIM_CTL1_SPIMEN_Pos) /*!< SPIM_T::CTL1: SPIMEN Mask */ + +#define SPIM_CTL1_CACHEOFF_Pos (1) /*!< SPIM_T::CTL1: CACHEOFF Position */ +#define SPIM_CTL1_CACHEOFF_Msk (0x1ul << SPIM_CTL1_CACHEOFF_Pos) /*!< SPIM_T::CTL1: CACHEOFF Mask */ + +#define SPIM_CTL1_CCMEN_Pos (2) /*!< SPIM_T::CTL1: CCMEN Position */ +#define SPIM_CTL1_CCMEN_Msk (0x1ul << SPIM_CTL1_CCMEN_Pos) /*!< SPIM_T::CTL1: CCMEN Mask */ + +#define SPIM_CTL1_CDINVAL_Pos (3) /*!< SPIM_T::CTL1: CDINVAL Position */ +#define SPIM_CTL1_CDINVAL_Msk (0x1ul << SPIM_CTL1_CDINVAL_Pos) /*!< SPIM_T::CTL1: CDINVAL Mask */ + +#define SPIM_CTL1_SS_Pos (4) /*!< SPIM_T::CTL1: SS Position */ +#define SPIM_CTL1_SS_Msk (0x1ul << SPIM_CTL1_SS_Pos) /*!< SPIM_T::CTL1: SS Mask */ + +#define SPIM_CTL1_SSACTPOL_Pos (5) /*!< SPIM_T::CTL1: SSACTPOL Position */ +#define SPIM_CTL1_SSACTPOL_Msk (0x1ul << SPIM_CTL1_SSACTPOL_Pos) /*!< SPIM_T::CTL1: SSACTPOL Mask */ + +#define SPIM_CTL1_IDLETIME_Pos (8) /*!< SPIM_T::CTL1: IDLETIME Position */ +#define SPIM_CTL1_IDLETIME_Msk (0xful << SPIM_CTL1_IDLETIME_Pos) /*!< SPIM_T::CTL1: IDLETIME Mask */ + +#define SPIM_CTL1_DIVIDER_Pos (16) /*!< SPIM_T::CTL1: DIVIDER Position */ +#define SPIM_CTL1_DIVIDER_Msk (0xfffful << SPIM_CTL1_DIVIDER_Pos) /*!< SPIM_T::CTL1: DIVIDER Mask */ + +#define SPIM_RXCLKDLY_DWDELSEL_Pos (0) /*!< SPIM_T::RXCLKDLY: DWDELSEL Position */ +#define SPIM_RXCLKDLY_DWDELSEL_Msk (0xfful << SPIM_RXCLKDLY_DWDELSEL_Pos) /*!< SPIM_T::RXCLKDLY: DWDELSEL Mask */ + +#define SPIM_RXCLKDLY_RDDLYSEL_Pos (16) /*!< SPIM_T::RXCLKDLY: RDDLYSEL Position */ +#define SPIM_RXCLKDLY_RDDLYSEL_Msk (0x7ul << SPIM_RXCLKDLY_RDDLYSEL_Pos) /*!< SPIM_T::RXCLKDLY: RDDLYSEL Mask */ + +#define SPIM_RXCLKDLY_RDEDGE_Pos (20) /*!< SPIM_T::RXCLKDLY: RDEDGE Position */ +#define SPIM_RXCLKDLY_RDEDGE_Msk (0x1ul << SPIM_RXCLKDLY_RDEDGE_Pos) /*!< SPIM_T::RXCLKDLY: RDEDGE Mask */ + +#define SPIM_RX_RXDAT_Pos (0) /*!< SPIM_T::RX[4]: RXDAT Position */ +#define SPIM_RX_RXDAT_Msk (0xfffffffful << SPIM_RX_RXDAT_Pos) /*!< SPIM_T::RX[4]: RXDAT Mask */ + +#define SPIM_TX_TXDAT_Pos (0) /*!< SPIM_T::TX[4]: TXDAT Position */ +#define SPIM_TX_TXDAT_Msk (0xfffffffful << SPIM_TX_TXDAT_Pos) /*!< SPIM_T::TX[4]: TXDAT Mask */ + +#define SPIM_SRAMADDR_ADDR_Pos (0) /*!< SPIM_T::SRAMADDR: ADDR Position */ +#define SPIM_SRAMADDR_ADDR_Msk (0xfffffffful << SPIM_SRAMADDR_ADDR_Pos) /*!< SPIM_T::SRAMADDR: ADDR Mask */ + +#define SPIM_DMACNT_DMACNT_Pos (0) /*!< SPIM_T::DMACNT: DMACNT Position */ +#define SPIM_DMACNT_DMACNT_Msk (0xfffffful << SPIM_DMACNT_DMACNT_Pos) /*!< SPIM_T::DMACNT: DMACNT Mask */ + +#define SPIM_FADDR_ADDR_Pos (0) /*!< SPIM_T::FADDR: ADDR Position */ +#define SPIM_FADDR_ADDR_Msk (0xfffffffful << SPIM_FADDR_ADDR_Pos) /*!< SPIM_T::FADDR: ADDR Mask */ + +#define SPIM_KEY1_KEY1_Pos (0) /*!< SPIM_T::KEY1: KEY1 Position */ +#define SPIM_KEY1_KEY1_Msk (0xfffffffful << SPIM_KEY1_KEY1_Pos) /*!< SPIM_T::KEY1: KEY1 Mask */ + +#define SPIM_KEY2_KEY2_Pos (0) /*!< SPIM_T::KEY2: KEY2 Position */ +#define SPIM_KEY2_KEY2_Msk (0xfffffffful << SPIM_KEY2_KEY2_Pos) /*!< SPIM_T::KEY2: KEY2 Mask */ + +#define SPIM_DMMCTL_CRMDAT_Pos (8) /*!< SPIM_T::DMMCTL: CRMDAT Position */ +#define SPIM_DMMCTL_CRMDAT_Msk (0xfful << SPIM_DMMCTL_CRMDAT_Pos) /*!< SPIM_T::DMMCTL: CRMDAT Mask */ + +#define SPIM_DMMCTL_DESELTIM_Pos (16) /*!< SPIM_T::DMMCTL: DESELTIM Position */ +#define SPIM_DMMCTL_DESELTIM_Msk (0x1ful << SPIM_DMMCTL_DESELTIM_Pos) /*!< SPIM_T::DMMCTL: DESELTIM Mask */ + +#define SPIM_DMMCTL_BWEN_Pos (24) /*!< SPIM_T::DMMCTL: BWEN Position */ +#define SPIM_DMMCTL_BWEN_Msk (0x1ul << SPIM_DMMCTL_BWEN_Pos) /*!< SPIM_T::DMMCTL: BWEN Mask */ + +#define SPIM_DMMCTL_CREN_Pos (25) /*!< SPIM_T::DMMCTL: CREN Position */ +#define SPIM_DMMCTL_CREN_Msk (0x1ul << SPIM_DMMCTL_CREN_Pos) /*!< SPIM_T::DMMCTL: CREN Mask */ + +#define SPIM_DMMCTL_UACTSCLK_Pos (26) /*!< SPIM_T::DMMCTL: UACTSCLK Position */ +#define SPIM_DMMCTL_UACTSCLK_Msk (0x1ul << SPIM_DMMCTL_UACTSCLK_Pos) /*!< SPIM_T::DMMCTL: UACTSCLK Mask */ + +#define SPIM_DMMCTL_ACTSCLKT_Pos (28) /*!< SPIM_T::DMMCTL: ACTSCLKT Position */ +#define SPIM_DMMCTL_ACTSCLKT_Msk (0xful << SPIM_DMMCTL_ACTSCLKT_Pos) /*!< SPIM_T::DMMCTL: ACTSCLKT Mask */ + +#define SPIM_CTL2_USETEN_Pos (16) /*!< SPIM_T::CTL2: USETEN Position */ +#define SPIM_CTL2_USETEN_Msk (0x1ul << SPIM_CTL2_USETEN_Pos) /*!< SPIM_T::CTL2: USETEN Mask */ + +#define SPIM_CTL2_DTRMPOFF_Pos (20) /*!< SPIM_T::CTL2: DTRMPOFF Position */ +#define SPIM_CTL2_DTRMPOFF_Msk (0x1ul << SPIM_CTL2_DTRMPOFF_Pos) /*!< SPIM_T::CTL2: DTRMPOFF Mask */ + +#define SPIM_CTL2_DCNUM_Pos (24) /*!< SPIM_T::CTL2: DCNUM Position */ +#define SPIM_CTL2_DCNUM_Msk (0x1ful << SPIM_CTL2_DCNUM_Pos) /*!< SPIM_T::CTL2: DCNUM Mask */ + +/**@}*/ /* SPIM_CONST */ +/**@}*/ /* end of SPIM register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __SPIM_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/sys_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/sys_reg.h new file mode 100644 index 00000000000..2bf3288d245 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/sys_reg.h @@ -0,0 +1,3662 @@ +/**************************************************************************//** + * @file sys_reg.h + * @version V1.00 + * @brief SYS register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __SYS_REG_H__ +#define __SYS_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup SYS System Manger Controller(SYS) + Memory Mapped Structure for SYS Controller +@{ */ + +typedef struct +{ + + + /** + * @var SYS_T::PDID + * Offset: 0x00 Part Device Identification Number Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |PDID |Part Device Identification Number (Read Only) + * | | |This register reflects device part number code + * | | |Software can read this register to identify which device is used. + * @var SYS_T::RSTSTS + * Offset: 0x04 System Reset Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |PORF |POR Reset Flag + * | | |The POR reset flag is set by the "Reset Signal" from the Power-on Reset (POR) Controller or bit CHIPRST (SYS_IPRST0[0]) to indicate the previous reset source. + * | | |0 = No reset from POR or CHIPRST. + * | | |1 = Power-on Reset (POR) or CHIPRST had issued the reset signal to reset the system. + * | | |Note: Write 1 to clear this bit to 0. + * |[1] |PINRF |NRESET Pin Reset Flag + * | | |The nRESET pin reset flag is set by the "Reset Signal" from the nRESET Pin to indicate the previous reset source. + * | | |0 = No reset from nRESET pin. + * | | |1 = Pin nRESET had issued the reset signal to reset the system. + * | | |Note: Write 1 to clear this bit to 0. + * |[2] |WDTRF |WDT Reset Flag + * | | |The WDT reset flag is set by the "Reset Signal" from the Watchdog Timer or Window Watchdog Timer to indicate the previous reset source. + * | | |0 = No reset from watchdog timer or window watchdog timer. + * | | |1 = The watchdog timer or window watchdog timer had issued the reset signal to reset the system. + * | | |Note1: Write 1 to clear this bit to 0. + * | | |Note2: Watchdog Timer register RSTF(WDT_CTL[2]) bit is set if the system has been reset by WDT time-out reset + * | | |Window Watchdog Timer register WWDTRF(WWDT_STATUS[1]) bit is set if the system has been reset by WWDT time-out reset. + * |[3] |LVRF |LVR Reset Flag + * | | |The LVR reset flag is set by the "Reset Signal" from the Low Voltage Reset Controller to indicate the previous reset source. + * | | |0 = No reset from LVR. + * | | |1 = LVR controller had issued the reset signal to reset the system. + * | | |Note: Write 1 to clear this bit to 0. + * |[4] |BODRF |BOD Reset Flag + * | | |The BOD reset flag is set by the "Reset Signal" from the Brown-Out Detector to indicate the previous reset source. + * | | |0 = No reset from BOD. + * | | |1 = The BOD had issued the reset signal to reset the system. + * | | |Note: Write 1 to clear this bit to 0. + * |[5] |SYSRF |System Reset Flag + * | | |The system reset flag is set by the "Reset Signal" from the Cortex-M4 Core to indicate the previous reset source. + * | | |0 = No reset from Cortex-M4. + * | | |1 = The Cortex-M4 had issued the reset signal to reset the system by writing 1 to the bit SYSRESETREQ(AIRCR[2], Application Interrupt and Reset Control Register, address = 0xE000ED0C) in system control registers of Cortex-M4 core. + * | | |Note: Write 1 to clear this bit to 0. + * |[7] |CPURF |CPU Reset Flag + * | | |The CPU reset flag is set by hardware if software writes CPURST (SYS_IPRST0[1]) 1 to reset Cortex-M4 Core and Flash Memory Controller (FMC). + * | | |0 = No reset from CPU. + * | | |1 = The Cortex-M4 Core and FMC are reset by software setting CPURST to 1. + * | | |Note: Write to clear this bit to 0. + * |[8] |CPULKRF |CPU Lock-up Reset Flag + * | | |0 = No reset from CPU lock-up happened. + * | | |1 = The Cortex-M4 lock-up happened and chip is reset. + * | | |Note: Write 1 to clear this bit to 0. + * | | |Note2: When CPU lock-up happened under ICE is connected, This flag will set to 1 but chip will not reset. + * @var SYS_T::IPRST0 + * Offset: 0x08 Peripheral Reset Control Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CHIPRST |Chip One-shot Reset (Write Protect) + * | | |Setting this bit will reset the whole chip, including Processor core and all peripherals, and this bit will automatically return to 0 after the 2 clock cycles. + * | | |The CHIPRST is same as the POR reset, all the chip controllers is reset and the chip setting from flash are also reload. + * | | |About the difference between CHIPRST and SYSRESETREQ(AIRCR[2]), please refer to section 6.2.2 + * | | |0 = Chip normal operation. + * | | |1 = Chip one-shot reset. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[1] |CPURST |Processor Core One-shot Reset (Write Protect) + * | | |Setting this bit will only reset the processor core and Flash Memory Controller(FMC), and this bit will automatically return to 0 after the 2 clock cycles. + * | | |0 = Processor core normal operation. + * | | |1 = Processor core one-shot reset. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[2] |PDMARST |PDMA Controller Reset (Write Protect) + * | | |Setting this bit to 1 will generate a reset signal to the PDMA + * | | |User needs to set this bit to 0 to release from reset state. + * | | |0 = PDMA controller normal operation. + * | | |1 = PDMA controller reset. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[3] |EBIRST |EBI Controller Reset (Write Protect) + * | | |Set this bit to 1 will generate a reset signal to the EBI + * | | |User needs to set this bit to 0 to release from the reset state. + * | | |0 = EBI controller normal operation. + * | | |1 = EBI controller reset. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[5] |EMACRST |EMAC Controller Reset (Write Protect) + * | | |Setting this bit to 1 will generate a reset signal to the EMAC controller + * | | |User needs to set this bit to 0 to release from the reset state. + * | | |0 = EMAC controller normal operation. + * | | |1 = EMAC controller reset. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[6] |SDH0RST |SDHOST0 Controller Reset (Write Protect) + * | | |Setting this bit to 1 will generate a reset signal to the SDHOST0 controller + * | | |User needs to set this bit to 0 to release from the reset state. + * | | |0 = SDHOST0 controller normal operation. + * | | |1 = SDHOST0 controller reset. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[7] |CRCRST |CRC Calculation Controller Reset (Write Protect) + * | | |Set this bit to 1 will generate a reset signal to the CRC calculation controller + * | | |User needs to set this bit to 0 to release from the reset state. + * | | |0 = CRC calculation controller normal operation. + * | | |1 = CRC calculation controller reset. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[8] |CCAPRST |CCAP Controller Reset (Write Protect) + * | | |Set this bit to 1 will generate a reset signal to the CCAP controller. + * | | |User needs to set this bit to 0 to release from the reset state. + * | | |0 = CCAP controller normal operation. + * | | |1 = CCAP controller reset. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[10] |HSUSBDRST |HSUSBD Controller Reset (Write Protect) + * | | |Setting this bit to 1 will generate a reset signal to the HSUSBD controller + * | | |User needs to set this bit to 0 to release from the reset state. + * | | |0 = HSUSBD controller normal operation. + * | | |1 = HSUSBD controller reset. + * |[12] |CRPTRST |CRYPTO Controller Reset (Write Protect) + * | | |Setting this bit to 1 will generate a reset signal to the CRYPTO controller + * | | |User needs to set this bit to 0 to release from the reset state. + * | | |0 = CRYPTO controller normal operation. + * | | |1 = CRYPTO controller reset. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[14] |SPIMRST |SPIM Controller Reset + * | | |Setting this bit to 1 will generate a reset signal to the SPIM controller + * | | |User needs to set this bit to 0 to release from the reset state. + * | | |0 = SPIM controller normal operation. + * | | |1 = SPIM controller reset. + * |[16] |USBHRST |USBH Controller Reset (Write Protect) + * | | |Set this bit to 1 will generate a reset signal to the USBH controller + * | | |User needs to set this bit to 0 to release from the reset state. + * | | |0 = USBH controller normal operation. + * | | |1 = USBH controller reset. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[17] |SDH1RST |SDHOST1 Controller Reset (Write Protect) + * | | |Setting this bit to 1 will generate a reset signal to the SDHOST1 controller + * | | |User needs to set this bit to 0 to release from the reset state. + * | | |0 = SDHOST1 controller normal operation. + * | | |1 = SDHOST1 controller reset. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * @var SYS_T::IPRST1 + * Offset: 0x0C Peripheral Reset Control Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1] |GPIORST |GPIO Controller Reset + * | | |0 = GPIO controller normal operation. + * | | |1 = GPIO controller reset. + * |[2] |TMR0RST |Timer0 Controller Reset + * | | |0 = Timer0 controller normal operation. + * | | |1 = Timer0 controller reset. + * |[3] |TMR1RST |Timer1 Controller Reset + * | | |0 = Timer1 controller normal operation. + * | | |1 = Timer1 controller reset. + * |[4] |TMR2RST |Timer2 Controller Reset + * | | |0 = Timer2 controller normal operation. + * | | |1 = Timer2 controller reset. + * |[5] |TMR3RST |Timer3 Controller Reset + * | | |0 = Timer3 controller normal operation. + * | | |1 = Timer3 controller reset. + * |[7] |ACMP01RST |Analog Comparator 0/1 Controller Reset + * | | |0 = Analog Comparator 0/1 controller normal operation. + * | | |1 = Analog Comparator 0/1 controller reset. + * |[8] |I2C0RST |I2C0 Controller Reset + * | | |0 = I2C0 controller normal operation. + * | | |1 = I2C0 controller reset. + * |[9] |I2C1RST |I2C1 Controller Reset + * | | |0 = I2C1 controller normal operation. + * | | |1 = I2C1 controller reset. + * |[10] |I2C2RST |I2C2 Controller Reset + * | | |0 = I2C2 controller normal operation. + * | | |1 = I2C2 controller reset. + * |[12] |QSPI0RST |QSPI0 Controller Reset + * | | |0 = QSPI0 controller normal operation. + * | | |1 = QSPI0 controller reset. + * |[13] |SPI0RST |SPI0 Controller Reset + * | | |0 = SPI0 controller normal operation. + * | | |1 = SPI0 controller reset. + * |[14] |SPI1RST |SPI1 Controller Reset + * | | |0 = SPI1 controller normal operation. + * | | |1 = SPI1 controller reset. + * |[15] |SPI2RST |SPI2 Controller Reset + * | | |0 = SPI2 controller normal operation. + * | | |1 = SPI2 controller reset. + * |[16] |UART0RST |UART0 Controller Reset + * | | |0 = UART0 controller normal operation. + * | | |1 = UART0 controller reset. + * |[17] |UART1RST |UART1 Controller Reset + * | | |0 = UART1 controller normal operation. + * | | |1 = UART1 controller reset. + * |[18] |UART2RST |UART2 Controller Reset + * | | |0 = UART2 controller normal operation. + * | | |1 = UART2 controller reset. + * |[19] |UART3RST |UART3 Controller Reset + * | | |0 = UART3 controller normal operation. + * | | |1 = UART3 controller reset. + * |[20] |UART4RST |UART4 Controller Reset + * | | |0 = UART4 controller normal operation. + * | | |1 = UART4 controller reset. + * |[21] |UART5RST |UART5 Controller Reset + * | | |0 = UART5 controller normal operation. + * | | |1 = UART5 controller reset. + * |[24] |CAN0RST |CAN0 Controller Reset + * | | |0 = CAN0 controller normal operation. + * | | |1 = CAN0 controller reset. + * |[25] |CAN1RST |CAN1 Controller Reset + * | | |0 = CAN1 controller normal operation. + * | | |1 = CAN1 controller reset. + * |[27] |USBDRST |USBD Controller Reset + * | | |0 = USBD controller normal operation. + * | | |1 = USBD controller reset. + * |[28] |EADCRST |EADC Controller Reset + * | | |0 = EADC controller normal operation. + * | | |1 = EADC controller reset. + * |[29] |I2S0RST |I2S0 Controller Reset + * | | |0 = I2S0 controller normal operation. + * | | |1 = I2S0 controller reset. + * @var SYS_T::IPRST2 + * Offset: 0x10 Peripheral Reset Control Register 2 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SC0RST |SC0 Controller Reset + * | | |0 = SC0 controller normal operation. + * | | |1 = SC0 controller reset. + * |[1] |SC1RST |SC1 Controller Reset + * | | |0 = SC1 controller normal operation. + * | | |1 = SC1 controller reset. + * |[2] |SC2RST |SC2 Controller Reset + * | | |0 = SC2 controller normal operation. + * | | |1 = SC2 controller reset. + * |[6] |SPI3RST |SPI3 Controller Reset + * | | |0 = SPI3 controller normal operation. + * | | |1 = SPI3 controller reset. + * |[8] |USCI0RST |USCI0 Controller Reset + * | | |0 = USCI0 controller normal operation. + * | | |1 = USCI0 controller reset. + * |[9] |USCI1RST |USCI1 Controller Reset + * | | |0 = USCI1 controller normal operation. + * | | |1 = USCI1 controller reset. + * |[12] |DACRST |DAC Controller Reset + * | | |0 = DAC controller normal operation. + * | | |1 = DAC controller reset. + * |[16] |EPWM0RST |EPWM0 Controller Reset + * | | |0 = EPWM0 controller normal operation. + * | | |1 = EPWM0 controller reset. + * |[17] |EPWM1RST |EPWM1 Controller Reset + * | | |0 = EPWM1 controller normal operation. + * | | |1 = EPWM1 controller reset. + * |[18] |BPWM0RST |BPWM0 Controller Reset + * | | |0 = BPWM0 controller normal operation. + * | | |1 = BPWM0 controller reset. + * |[19] |BPWM1RST |BPWM1 Controller Reset + * | | |0 = BPWM1 controller normal operation. + * | | |1 = BPWM1 controller reset. + * |[22] |QEI0RST |QEI0 Controller Reset + * | | |0 = QEI0 controller normal operation. + * | | |1 = QEI0 controller reset. + * |[23] |QEI1RST |QEI1 Controller Reset + * | | |0 = QEI1 controller normal operation. + * | | |1 = QEI1 controller reset. + * |[26] |ECAP0RST |ECAP0 Controller Reset + * | | |0 = ECAP0 controller normal operation. + * | | |1 = ECAP0 controller reset. + * |[27] |ECAP1RST |ECAP1 Controller Reset + * | | |0 = ECAP1 controller normal operation. + * | | |1 = ECAP1 controller reset. + * |[28] |CAN2RST |CAN2 Controller Reset + * | | |0 = CAN2 controller normal operation. + * | | |1 = CAN2 controller reset. + * |[30] |OPARST |OP Amplifier (OPA) Controller Reset + * | | |0 = OPA controller normal operation. + * | | |1 = OPA controller reset. + * @var SYS_T::BODCTL + * Offset: 0x18 Brown-Out Detector Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BODEN |Brown-out Detector Enable Bit (Write Protect) + * | | |The default value is set by flash controller user configuration register CBODEN(CONFIG0 [19]). + * | | |0 = Brown-out Detector function Disabled. + * | | |1 = Brown-out Detector function Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[3] |BODRSTEN |Brown-out Reset Enable Bit (Write Protect) + * | | |The default value is set by flash controller user configuration register CBORST(CONFIG0[20]) bit . + * | | |0 = Brown-out INTERRUPT function Enabled. + * | | |1 = Brown-out RESET function Enabled. + * | | |Note1: + * | | |While the Brown-out Detector function is enabled (BODEN high) and BOD reset function is enabled (BODRSTEN high), BOD will assert a signal to reset chip when the detected voltage is lower than the threshold (BODOUT high). + * | | |While the BOD function is enabled (BODEN high) and BOD interrupt function is enabled (BODRSTEN low), BOD will assert an interrupt if BODOUT is high + * | | |BOD interrupt will keep till to the BODEN set to 0 + * | | |BOD interrupt can be blocked by disabling the NVIC BOD interrupt or disabling BOD function (set BODEN low). + * | | |Note2: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[4] |BODIF |Brown-out Detector Interrupt Flag + * | | |0 = Brown-out Detector does not detect any voltage draft at VDD down through or up through the voltage of BODVL setting. + * | | |1 = When Brown-out Detector detects the VDD is dropped down through the voltage of BODVL setting or the VDD is raised up through the voltage of BODVL setting, this bit is set to 1 and the brown-out interrupt is requested if brown-out interrupt is enabled. + * | | |Note: Write 1 to clear this bit to 0. + * |[5] |BODLPM |Brown-out Detector Low Power Mode (Write Protect) + * | | |0 = BOD operate in normal mode (default). + * | | |1 = BOD Low Power mode Enabled. + * | | |Note1: The BOD consumes about 100uA in normal mode, the low power mode can reduce the current to about 1/10 but slow the BOD response. + * | | |Note2: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[6] |BODOUT |Brown-out Detector Output Status + * | | |0 = Brown-out Detector output status is 0. + * | | |It means the detected voltage is higher than BODVL setting or BODEN is 0. + * | | |1 = Brown-out Detector output status is 1. + * | | |It means the detected voltage is lower than BODVL setting + * | | |If the BODEN is 0, BOD function disabled , this bit always responds 0000. + * |[7] |LVREN |Low Voltage Reset Enable Bit (Write Protect) + * | | |The LVR function resets the chip when the input power voltage is lower than LVR circuit setting + * | | |LVR function is enabled by default. + * | | |0 = Low Voltage Reset function Disabled. + * | | |1 = Low Voltage Reset function Enabled. + * | | |Note1: After enabling the bit, the LVR function will be active with 100us delay for LVR output stable (default). + * | | |Note2: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[10:8] |BODDGSEL |Brown-out Detector Output De-glitch Time Select (Write Protect) + * | | |000 = BOD output is sampled by RC10K clock. + * | | |001 = 4 system clock (HCLK). + * | | |010 = 8 system clock (HCLK). + * | | |011 = 16 system clock (HCLK). + * | | |100 = 32 system clock (HCLK). + * | | |101 = 64 system clock (HCLK). + * | | |110 = 128 system clock (HCLK). + * | | |111 = 256 system clock (HCLK). + * | | |Note: These bits are write protected. Refer to the SYS_REGLCTL register. + * |[14:12] |LVRDGSEL |LVR Output De-glitch Time Select (Write Protect) + * | | |000 = Without de-glitch function. + * | | |001 = 4 system clock (HCLK). + * | | |010 = 8 system clock (HCLK). + * | | |011 = 16 system clock (HCLK). + * | | |100 = 32 system clock (HCLK). + * | | |101 = 64 system clock (HCLK). + * | | |110 = 128 system clock (HCLK). + * | | |111 = 256 system clock (HCLK). + * | | |Note: These bits are write protected. Refer to the SYS_REGLCTL register. + * |[18:16] |BODVL |Brown-out Detector Threshold Voltage Selection (Write Protect) + * | | |The default value is set by flash controller user configuration register CBOV (CONFIG0 [23:21]). + * | | |000 = Brown-Out Detector threshold voltage is 1.6V. + * | | |001 = Brown-Out Detector threshold voltage is 1.8V. + * | | |010 = Brown-Out Detector threshold voltage is 2.0V. + * | | |011 = Brown-Out Detector threshold voltage is 2.2V. + * | | |100 = Brown-Out Detector threshold voltage is 2.4V. + * | | |101 = Brown-Out Detector threshold voltage is 2.6V. + * | | |110 = Brown-Out Detector threshold voltage is 2.8V. + * | | |111 = Brown-Out Detector threshold voltage is 3.0V. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * @var SYS_T::IVSCTL + * Offset: 0x1C Internal Voltage Source Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |VTEMPEN |Temperature Sensor Enable Bit + * | | |This bit is used to enable/disable temperature sensor function. + * | | |0 = Temperature sensor function Disabled (default). + * | | |1 = Temperature sensor function Enabled. + * | | |Note: After this bit is set to 1, the value of temperature sensor output can be obtained through GPC.9. + * |[1] |VBATUGEN |VBAT Unity Gain Buffer Enable Bit + * | | |This bit is used to enable/disable VBAT unity gain buffer function. + * | | |0 = VBAT unity gain buffer function Disabled (default). + * | | |1 = VBAT unity gain buffer function Enabled. + * | | |Note: After this bit is set to 1, the value of VBAT unity gain buffer output voltage can be obtained from ADC conversion result + * @var SYS_T::PORCTL + * Offset: 0x24 Power-On-Reset Controller Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |POROFF |Power-on Reset Enable Bit (Write Protect) + * | | |When powered on, the POR circuit generates a reset signal to reset the whole chip function, but noise on the power may cause the POR active again + * | | |User can disable internal POR circuit to avoid unpredictable noise to cause chip reset by writing 0x5AA5 to this field. + * | | |The POR function will be active again when this field is set to another value or chip is reset by other reset source, including: + * | | |nRESET, Watchdog, LVR reset, BOD reset, ICE reset command and the software-chip reset function. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * @var SYS_T::VREFCTL + * Offset: 0x28 VREF Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[4:0] |VREFCTL |VREF Control Bits (Write Protect) + * | | |00000 = VREF is from external pin. + * | | |00011 = VREF is internal 1.6V. + * | | |00111 = VREF is internal 2.0V. + * | | |01011 = VREF is internal 2.5V. + * | | |01111 = VREF is internal 3.0V. + * | | |Others = Reserved. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[7:6] |PRELOAD_SEL|Pre-load Timing Selection. + * | | |00 = pre-load time is 60us for 0.1uF Capacitor. + * | | |01 = pre-load time is 310us for 1uF Capacitor. + * | | |10 = pre-load time is 1270us for 4.7uF Capacitor. + * | | |11 = pre-load time is 2650us for 10uF Capacitor. + * @var SYS_T::USBPHY + * Offset: 0x2C USB PHY Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |USBROLE |USB Role Option (Write Protect) + * | | |These two bits are used to select the role of USB. + * | | |00 = Standard USB Device mode. + * | | |01 = Standard USB Host mode. + * | | |10 = ID dependent mode. + * | | |11 = Reserved. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[2] |SBO |Note: This bit must always be kept 1. If set to 0, the result is unpredictable + * |[8] |USBEN |USB PHY Enable (Write Protect) + * | | |This bit is used to enable/disable USB PHY. + * | | |0 = USB PHY Disabled. + * | | |1 = USB PHY Enabled. + * |[17:16] |HSUSBROLE |HSUSB Role Option (Write Protect) + * | | |These two bits are used to select the role of HSUSB + * | | |00 = Standard HSUSB Device mode. + * | | |01 = Standard HSUSB Host mode. + * | | |10 = ID dependent mode. + * | | |11 = Reserved. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[24] |HSUSBEN |HSUSB PHY Enable (Write Protect) + * | | |This bit is used to enable/disable HSUSB PHY. + * | | |0 = HSUSB PHY Disabled. + * | | |1 = HSUSB PHY Enabled. + * |[25] |HSUSBACT |HSUSB PHY Active Control + * | | |This bit is used to control HSUSB PHY at reset state or active state. + * | | |0 = HSUSB PHY at reset state. + * | | |1 = HSUSB PHY at active state. + * | | |Note: After set HSUSBEN (SYS_USBPHY[24]) to enable HSUSB PHY, user should keep HSUSB PHY at reset mode at lease 10uS before changing to active mode. + * @var SYS_T::GPA_MFPL + * Offset: 0x30 GPIOA Low Byte Multiple Function Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |PA0MFP |PA.0 Multi-function Pin Selection + * |[7:4] |PA1MFP |PA.1 Multi-function Pin Selection + * |[11:8] |PA2MFP |PA.2 Multi-function Pin Selection + * |[15:12] |PA3MFP |PA.3 Multi-function Pin Selection + * |[19:16] |PA4MFP |PA.4 Multi-function Pin Selection + * |[23:20] |PA5MFP |PA.5 Multi-function Pin Selection + * |[27:24] |PA6MFP |PA.6 Multi-function Pin Selection + * |[31:28] |PA7MFP |PA.7 Multi-function Pin Selection + * @var SYS_T::GPA_MFPH + * Offset: 0x34 GPIOA High Byte Multiple Function Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |PA8MFP |PA.8 Multi-function Pin Selection + * |[7:4] |PA9MFP |PA.9 Multi-function Pin Selection + * |[11:8] |PA10MFP |PA.10 Multi-function Pin Selection + * |[15:12] |PA11MFP |PA.11 Multi-function Pin Selection + * |[19:16] |PA12MFP |PA.12 Multi-function Pin Selection + * |[23:20] |PA13MFP |PA.13 Multi-function Pin Selection + * |[27:24] |PA14MFP |PA.14 Multi-function Pin Selection + * |[31:28] |PA15MFP |PA.15 Multi-function Pin Selection + * @var SYS_T::GPB_MFPL + * Offset: 0x38 GPIOB Low Byte Multiple Function Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |PB0MFP |PB.0 Multi-function Pin Selection + * |[7:4] |PB1MFP |PB.1 Multi-function Pin Selection + * |[11:8] |PB2MFP |PB.2 Multi-function Pin Selection + * |[15:12] |PB3MFP |PB.3 Multi-function Pin Selection + * |[19:16] |PB4MFP |PB.4 Multi-function Pin Selection + * |[23:20] |PB5MFP |PB.5 Multi-function Pin Selection + * |[27:24] |PB6MFP |PB.6 Multi-function Pin Selection + * |[31:28] |PB7MFP |PB.7 Multi-function Pin Selection + * @var SYS_T::GPB_MFPH + * Offset: 0x3C GPIOB High Byte Multiple Function Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |PB8MFP |PB.8 Multi-function Pin Selection + * |[7:4] |PB9MFP |PB.9 Multi-function Pin Selection + * |[11:8] |PB10MFP |PB.10 Multi-function Pin Selection + * |[15:12] |PB11MFP |PB.11 Multi-function Pin Selection + * |[19:16] |PB12MFP |PB.12 Multi-function Pin Selection + * |[23:20] |PB13MFP |PB.13 Multi-function Pin Selection + * |[27:24] |PB14MFP |PB.14 Multi-function Pin Selection + * |[31:28] |PB15MFP |PB.15 Multi-function Pin Selection + * @var SYS_T::GPC_MFPL + * Offset: 0x40 GPIOC Low Byte Multiple Function Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |PC0MFP |PC.0 Multi-function Pin Selection + * |[7:4] |PC1MFP |PC.1 Multi-function Pin Selection + * |[11:8] |PC2MFP |PC.2 Multi-function Pin Selection + * |[15:12] |PC3MFP |PC.3 Multi-function Pin Selection + * |[19:16] |PC4MFP |PC.4 Multi-function Pin Selection + * |[23:20] |PC5MFP |PC.5 Multi-function Pin Selection + * |[27:24] |PC6MFP |PC.6 Multi-function Pin Selection + * |[31:28] |PC7MFP |PC.7 Multi-function Pin Selection + * @var SYS_T::GPC_MFPH + * Offset: 0x44 GPIOC High Byte Multiple Function Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |PC8MFP |PC.8 Multi-function Pin Selection + * |[7:4] |PC9MFP |PC.9 Multi-function Pin Selection + * |[11:8] |PC10MFP |PC.10 Multi-function Pin Selection + * |[15:12] |PC11MFP |PC.11 Multi-function Pin Selection + * |[19:16] |PC12MFP |PC.12 Multi-function Pin Selection + * |[23:20] |PC13MFP |PC.13 Multi-function Pin Selection + * |[27:24] |PC14MFP |PC.14 Multi-function Pin Selection + * |[31:28] |PC15MFP |PC.15 Multi-function Pin Selection + * @var SYS_T::GPD_MFPL + * Offset: 0x48 GPIOD Low Byte Multiple Function Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |PD0MFP |PD.0 Multi-function Pin Selection + * |[7:4] |PD1MFP |PD.1 Multi-function Pin Selection + * |[11:8] |PD2MFP |PD.2 Multi-function Pin Selection + * |[15:12] |PD3MFP |PD.3 Multi-function Pin Selection + * |[19:16] |PD4MFP |PD.4 Multi-function Pin Selection + * |[23:20] |PD5MFP |PD.5 Multi-function Pin Selection + * |[27:24] |PD6MFP |PD.6 Multi-function Pin Selection + * |[31:28] |PD7MFP |PD.7 Multi-function Pin Selection + * @var SYS_T::GPD_MFPH + * Offset: 0x4C GPIOD High Byte Multiple Function Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |PD8MFP |PD.8 Multi-function Pin Selection + * |[7:4] |PD9MFP |PD.9 Multi-function Pin Selection + * |[11:8] |PD10MFP |PD.10 Multi-function Pin Selection + * |[15:12] |PD11MFP |PD.11 Multi-function Pin Selection + * |[19:16] |PD12MFP |PD.12 Multi-function Pin Selection + * |[23:20] |PD13MFP |PD.13 Multi-function Pin Selection + * |[27:24] |PD14MFP |PD.14 Multi-function Pin Selection + * |[31:28] |PD15MFP |PD.15 Multi-function Pin Selection + * @var SYS_T::GPE_MFPL + * Offset: 0x50 GPIOE Low Byte Multiple Function Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |PE0MFP |PE.0 Multi-function Pin Selection + * |[7:4] |PE1MFP |PE.1 Multi-function Pin Selection + * |[11:8] |PE2MFP |PE.2 Multi-function Pin Selection + * |[15:12] |PE3MFP |PE.3 Multi-function Pin Selection + * |[19:16] |PE4MFP |PE.4 Multi-function Pin Selection + * |[23:20] |PE5MFP |PE.5 Multi-function Pin Selection + * |[27:24] |PE6MFP |PE.6 Multi-function Pin Selection + * |[31:28] |PE7MFP |PE.7 Multi-function Pin Selection + * @var SYS_T::GPE_MFPH + * Offset: 0x54 GPIOE High Byte Multiple Function Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |PE8MFP |PE.8 Multi-function Pin Selection + * |[7:4] |PE9MFP |PE.9 Multi-function Pin Selection + * |[11:8] |PE10MFP |PE.10 Multi-function Pin Selection + * |[15:12] |PE11MFP |PE.11 Multi-function Pin Selection + * |[19:16] |PE12MFP |PE.12 Multi-function Pin Selection + * |[23:20] |PE13MFP |PE.13 Multi-function Pin Selection + * |[27:24] |PE14MFP |PE.14 Multi-function Pin Selection + * |[31:28] |PE15MFP |PE.15 Multi-function Pin Selection + * @var SYS_T::GPF_MFPL + * Offset: 0x58 GPIOF Low Byte Multiple Function Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |PF0MFP |PF.0 Multi-function Pin Selection + * |[7:4] |PF1MFP |PF.1 Multi-function Pin Selection + * |[11:8] |PF2MFP |PF.2 Multi-function Pin Selection + * |[15:12] |PF3MFP |PF.3 Multi-function Pin Selection + * |[19:16] |PF4MFP |PF.4 Multi-function Pin Selection + * |[23:20] |PF5MFP |PF.5 Multi-function Pin Selection + * |[27:24] |PF6MFP |PF.6 Multi-function Pin Selection + * |[31:28] |PF7MFP |PF.7 Multi-function Pin Selection + * @var SYS_T::GPF_MFPH + * Offset: 0x5C GPIOF High Byte Multiple Function Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |PF8MFP |PF.8 Multi-function Pin Selection + * |[7:4] |PF9MFP |PF.9 Multi-function Pin Selection + * |[11:8] |PF10MFP |PF.10 Multi-function Pin Selection + * |[15:12] |PF11MFP |PF.11 Multi-function Pin Selection + * |[19:16] |PF12MFP |PF.12 Multi-function Pin Selection + * |[23:20] |PF13MFP |PF.13 Multi-function Pin Selection + * |[27:24] |PF14MFP |PF.14 Multi-function Pin Selection + * |[31:28] |PF15MFP |PF.15 Multi-function Pin Selection + * @var SYS_T::GPG_MFPL + * Offset: 0x60 GPIOG Low Byte Multiple Function Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |PG0MFP |PG.0 Multi-function Pin Selection + * |[7:4] |PG1MFP |PG.1 Multi-function Pin Selection + * |[11:8] |PG2MFP |PG.2 Multi-function Pin Selection + * |[15:12] |PG3MFP |PG.3 Multi-function Pin Selection + * |[19:16] |PG4MFP |PG.4 Multi-function Pin Selection + * |[23:20] |PG5MFP |PG.5 Multi-function Pin Selection + * |[27:24] |PG6MFP |PG.6 Multi-function Pin Selection + * |[31:28] |PG7MFP |PG.7 Multi-function Pin Selection + * @var SYS_T::GPG_MFPH + * Offset: 0x64 GPIOG High Byte Multiple Function Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |PG8MFP |PG.8 Multi-function Pin Selection + * |[7:4] |PG9MFP |PG.9 Multi-function Pin Selection + * |[11:8] |PG10MFP |PG.10 Multi-function Pin Selection + * |[15:12] |PG11MFP |PG.11 Multi-function Pin Selection + * |[19:16] |PG12MFP |PG.12 Multi-function Pin Selection + * |[23:20] |PG13MFP |PG.13 Multi-function Pin Selection + * |[27:24] |PG14MFP |PG.14 Multi-function Pin Selection + * |[31:28] |PG15MFP |PG.15 Multi-function Pin Selection + * @var SYS_T::GPH_MFPL + * Offset: 0x68 GPIOH Low Byte Multiple Function Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |PH0MFP |PH.0 Multi-function Pin Selection + * |[7:4] |PH1MFP |PH.1 Multi-function Pin Selection + * |[11:8] |PH2MFP |PH.2 Multi-function Pin Selection + * |[15:12] |PH3MFP |PH.3 Multi-function Pin Selection + * |[19:16] |PH4MFP |PH.4 Multi-function Pin Selection + * |[23:20] |PH5MFP |PH.5 Multi-function Pin Selection + * |[27:24] |PH6MFP |PH.6 Multi-function Pin Selection + * |[31:28] |PH7MFP |PH.7 Multi-function Pin Selection + * @var SYS_T::GPH_MFPH + * Offset: 0x6C GPIOH High Byte Multiple Function Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |PH8MFP |PH.8 Multi-function Pin Selection + * |[7:4] |PH9MFP |PH.9 Multi-function Pin Selection + * |[11:8] |PH10MFP |PH.10 Multi-function Pin Selection + * |[15:12] |PH11MFP |PH.11 Multi-function Pin Selection + * |[19:16] |PH12MFP |PH.12 Multi-function Pin Selection + * |[23:20] |PH13MFP |PH.13 Multi-function Pin Selection + * |[27:24] |PH14MFP |PH.14 Multi-function Pin Selection + * |[31:28] |PH15MFP |PH.15 Multi-function Pin Selection + * @var SYS_T::GPA_MFOS + * Offset: 0x80 GPIOA Multiple Function Output Select Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |MFOS0 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[1] |MFOS1 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[2] |MFOS2 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[3] |MFOS3 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[4] |MFOS4 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[5] |MFOS5 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[6] |MFOS6 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[7] |MFOS7 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[8] |MFOS8 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[9] |MFOS9 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[10] |MFOS10 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[11] |MFOS11 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[12] |MFOS12 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[13] |MFOS13 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[14] |MFOS14 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[15] |MFOS15 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * @var SYS_T::GPB_MFOS + * Offset: 0x84 GPIOB Multiple Function Output Select Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |MFOS0 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[1] |MFOS1 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[2] |MFOS2 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[3] |MFOS3 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[4] |MFOS4 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[5] |MFOS5 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[6] |MFOS6 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[7] |MFOS7 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[8] |MFOS8 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[9] |MFOS9 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[10] |MFOS10 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[11] |MFOS11 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[12] |MFOS12 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[13] |MFOS13 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[14] |MFOS14 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[15] |MFOS15 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * @var SYS_T::GPC_MFOS + * Offset: 0x88 GPIOC Multiple Function Output Select Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |MFOS0 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[1] |MFOS1 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[2] |MFOS2 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[3] |MFOS3 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[4] |MFOS4 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[5] |MFOS5 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[6] |MFOS6 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[7] |MFOS7 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[8] |MFOS8 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[9] |MFOS9 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[10] |MFOS10 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[11] |MFOS11 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[12] |MFOS12 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[13] |MFOS13 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[14] |MFOS14 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[15] |MFOS15 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * @var SYS_T::GPD_MFOS + * Offset: 0x8C GPIOD Multiple Function Output Select Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |MFOS0 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[1] |MFOS1 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[2] |MFOS2 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[3] |MFOS3 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[4] |MFOS4 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[5] |MFOS5 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[6] |MFOS6 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[7] |MFOS7 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[8] |MFOS8 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[9] |MFOS9 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[10] |MFOS10 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[11] |MFOS11 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[12] |MFOS12 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[13] |MFOS13 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[14] |MFOS14 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[15] |MFOS15 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * @var SYS_T::GPE_MFOS + * Offset: 0x90 GPIOE Multiple Function Output Select Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |MFOS0 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[1] |MFOS1 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[2] |MFOS2 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[3] |MFOS3 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[4] |MFOS4 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[5] |MFOS5 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[6] |MFOS6 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[7] |MFOS7 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[8] |MFOS8 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[9] |MFOS9 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[10] |MFOS10 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[11] |MFOS11 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[12] |MFOS12 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[13] |MFOS13 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[14] |MFOS14 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[15] |MFOS15 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * @var SYS_T::GPF_MFOS + * Offset: 0x94 GPIOF Multiple Function Output Select Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |MFOS0 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[1] |MFOS1 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[2] |MFOS2 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[3] |MFOS3 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[4] |MFOS4 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[5] |MFOS5 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[6] |MFOS6 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[7] |MFOS7 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[8] |MFOS8 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[9] |MFOS9 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[10] |MFOS10 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[11] |MFOS11 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[12] |MFOS12 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[13] |MFOS13 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[14] |MFOS14 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[15] |MFOS15 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * @var SYS_T::GPG_MFOS + * Offset: 0x98 GPIOG Multiple Function Output Select Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |MFOS0 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[1] |MFOS1 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[2] |MFOS2 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[3] |MFOS3 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[4] |MFOS4 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[5] |MFOS5 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[6] |MFOS6 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[7] |MFOS7 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[8] |MFOS8 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[9] |MFOS9 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[10] |MFOS10 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[11] |MFOS11 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[12] |MFOS12 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[13] |MFOS13 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[14] |MFOS14 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[15] |MFOS15 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * @var SYS_T::GPH_MFOS + * Offset: 0x9C GPIOH Multiple Function Output Select Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |MFOS0 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[1] |MFOS1 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[2] |MFOS2 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[3] |MFOS3 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[4] |MFOS4 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[5] |MFOS5 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[6] |MFOS6 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[7] |MFOS7 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[8] |MFOS8 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[9] |MFOS9 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[10] |MFOS10 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[11] |MFOS11 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[12] |MFOS12 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[13] |MFOS13 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[14] |MFOS14 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * |[15] |MFOS15 |GPIOA-H Pin[n] Multiple Function Pin Output Mode Select + * | | |This bit used to select multiple function pin output mode type for Px.n pin + * | | |0 = Multiple function pin output mode type is Push-pull mode. + * | | |1 = Multiple function pin output mode type is Open-drain mode. + * | | |Note: + * | | |Max. n=15 for port A/B/E/G. + * | | |Max. n=14 for port C/D. + * | | |Max. n=11 for port F/H. + * @var SYS_T::SRAM_INTCTL + * Offset: 0xC0 System SRAM Interrupt Enable Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |PERRIEN |SRAM Parity Check Error Interrupt Enable Bit + * | | |0 = SRAM parity check error interrupt Disabled. + * | | |1 = SRAM parity check error interrupt Enabled. + * @var SYS_T::SRAM_STATUS + * Offset: 0xC4 System SRAM Parity Error Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |PERRIF |SRAM Parity Check Error Flag + * | | |This bit indicates the System SRAM parity error occurred. Write 1 to clear this to 0. + * | | |0 = No System SRAM parity error. + * | | |1 = System SRAM parity error occur. + * @var SYS_T::SRAM_ERRADDR + * Offset: 0xC8 System SRAM Parity Check Error Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |ERRADDR |System SRAM Parity Error Address + * | | |This register shows system SRAM parity error byte address. + * @var SYS_T::SRAM_BISTCTL + * Offset: 0xD0 System SRAM BIST Test Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SRBIST0 |SRAM Bank0 BIST Enable Bit (Write Protect) + * | | |This bit enables BIST test for SRAM bank0. + * | | |0 = system SRAM bank0 BIST Disabled. + * | | |1 = system SRAM bank0 BIST Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[1] |SRBIST1 |SRAM Bank1 BIST Enable Bit (Write Protect) + * | | |This bit enables BIST test for SRAM bank1. + * | | |0 = system SRAM bank1 BIST Disabled. + * | | |1 = system SRAM bank1 BIST Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[2] |CRBIST |CACHE BIST Enable Bit (Write Protect) + * | | |This bit enables BIST test for CACHE RAM + * | | |0 = system CACHE BIST Disabled. + * | | |1 = system CACHE BIST Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[3] |CANBIST |CAN BIST Enable Bit (Write Protect) + * | | |This bit enables BIST test for CAN RAM + * | | |0 = system CAN BIST Disabled. + * | | |1 = system CAN BIST Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[4] |USBBIST |USB BIST Enable Bit (Write Protect) + * | | |This bit enables BIST test for USB RAM + * | | |0 = system USB BIST Disabled. + * | | |1 = system USB BIST Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[5] |SPIMBIST |SPIM BIST Enable Bit (Write Protect) + * | | |This bit enables BIST test for SPIM RAM + * | | |0 = system SPIM BIST Disabled. + * | | |1 = system SPIM BIST Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[6] |EMCBIST |EMC BIST Enable Bit (Write Protect) + * | | |This bit enables BIST test for EMC RAM + * | | |0 = system EMC BIST Disabled. + * | | |1 = system EMC BIST Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[7] |PDMABIST |PDMA BIST Enable Bit (Write Protect) + * | | |This bit enables BIST test for PDMA RAM + * | | |0 = system PDMA BIST Disabled. + * | | |1 = system PDMA BIST Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[8] |HSUSBDBIST|HSUSBD BIST Enable Bit (Write Protect) + * | | |This bit enables BIST test for HSUSBD RAM + * | | |0 = system HSUSBD BIST Disabled. + * | | |1 = system HSUSBD BIST Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[9] |HSUSBHBIST|HSUSBH BIST Enable Bit (Write Protect) + * | | |This bit enables BIST test for HSUSBH RAM + * | | |0 = system HSUSBH BIST Disabled. + * | | |1 = system HSUSBH BIST Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[16] |SRB0S0 |SRAM Bank0 Section 0 BIST Select (Write Protect) + * | | |This bit define if the first 16KB section of SRAM bank0 is selected or not when doing bist test. + * | | |0 = SRAM bank0 section 0 is deselected when doing bist test. + * | | |1 = SRAM bank0 section 0 is selected when doing bist test. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * | | |Note: At least one section of SRAM bank0 should be selected when doing SRAM bank0 bist test. + * |[17] |SRB0S1 |SRAM Bank0 Section 1 BIST Select (Write Protect) + * | | |This bit define if the second 16KB section of SRAM bank0 is selected or not when doing bist test. + * | | |0 = SRAM bank0 section 1 is deselected when doing bist test. + * | | |1 = SRAM bank0 section 1 is selected when doing bist test. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * | | |Note: At least one section of SRAM bank0 should be selected when doing SRAM bank0 bist test. + * |[18] |SRB1S0 |SRAM Bank1 Section 0 BIST Select (Write Protect) + * | | |This bit define if the first 16KB section of SRAM bank1 is selected or not when doing bist test. + * | | |0 = SRAM bank1 first 16KB section is deselected when doing bist test. + * | | |1 = SRAM bank1 first 16KB section is selected when doing bist test. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * | | |Note: At least one section of SRAM bank1 should be selected when doing SRAM bank1 bist test. + * |[19] |SRB1S1 |SRAM Bank1 Section 1 BIST Select (Write Protect) + * | | |This bit define if the second 16KB section of SRAM bank1 is selected or not when doing bist test. + * | | |0 = SRAM bank1 second 16KB section is deselected when doing bist test. + * | | |1 = SRAM bank1 second 16KB section is selected when doing bist test. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * | | |Note: At least one section of SRAM bank1 should be selected when doing SRAM bank1 bist test. + * |[20] |SRB1S2 |SRAM Bank1 Section 0 BIST Select (Write Protect) + * | | |This bit define if the third 16KB section of SRAM bank1 is selected or not when doing bist test. + * | | |0 = SRAM bank1 third 16KB section is deselected when doing bist test. + * | | |1 = SRAM bank1 third 16KB section is selected when doing bist test. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * | | |Note: At least one section of SRAM bank1 should be selected when doing SRAM bank1 bist test. + * |[21] |SRB1S3 |SRAM Bank1 Section 1 BIST Select (Write Protect) + * | | |This bit define if the fourth 16KB section of SRAM bank1 is selected or not when doing bist test. + * | | |0 = SRAM bank1 fourth 16KB section is deselected when doing bist test. + * | | |1 = SRAM bank1 fourth 16KB section is selected when doing bist test. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * | | |Note: At least one section of SRAM bank1 should be selected when doing SRAM bank1 bist test. + * |[22] |SRB1S4 |SRAM Bank1 Section 0 BIST Select (Write Protect) + * | | |This bit define if the fifth 16KB section of SRAM bank1 is selected or not when doing bist test. + * | | |0 = SRAM bank1 fifth 16KB section is deselected when doing bist test. + * | | |1 = SRAM bank1 fifth 16KB section is selected when doing bist test. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * | | |Note: At least one section of SRAM bank1 should be selected when doing SRAM bank1 bist test. + * |[23] |SRB1S5 |SRAM Bank1 Section 1 BIST Select (Write Protect) + * | | |This bit define if the sixth 16KB section of SRAM bank1 is selected or not when doing bist test. + * | | |0 = SRAM bank1 sixth 16KB section is deselected when doing bist test. + * | | |1 = SRAM bank1 sixth 16KB section is selected when doing bist test. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * | | |Note: At least one section of SRAM bank1 should be selected when doing SRAM bank1 bist test. + * @var SYS_T::SRAM_BISTSTS + * Offset: 0xD4 System SRAM BIST Test Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SRBISTEF0 |1st System SRAM BIST Fail Flag + * | | |0 = 1st system SRAM BIST test pass. + * | | |1 = 1st system SRAM BIST test fail. + * |[1] |SRBISTEF1 |2nd System SRAM BIST Fail Flag + * | | |0 = 2nd system SRAM BIST test pass. + * | | |1 = 2nd system SRAM BIST test fail. + * |[2] |CRBISTEF |CACHE SRAM BIST Fail Flag + * | | |0 = System CACHE RAM BIST test pass. + * | | |1 = System CACHE RAM BIST test fail. + * |[3] |CANBEF |CAN SRAM BIST Fail Flag + * | | |0 = CAN SRAM BIST test pass. + * | | |1 = CAN SRAM BIST test fail. + * |[4] |USBBEF |USB SRAM BIST Fail Flag + * | | |0 = USB SRAM BIST test pass. + * | | |1 = USB SRAM BIST test fail. + * |[16] |SRBEND0 |1st SRAM BIST Test Finish + * | | |0 = 1st system SRAM BIST active. + * | | |1 =1st system SRAM BIST finish. + * |[17] |SRBEND1 |2nd SRAM BIST Test Finish + * | | |0 = 2nd system SRAM BIST is active. + * | | |1 = 2nd system SRAM BIST finish. + * |[18] |CRBEND |CACHE SRAM BIST Test Finish + * | | |0 = System CACHE RAM BIST is active. + * | | |1 = System CACHE RAM BIST test finish. + * |[19] |CANBEND |CAN SRAM BIST Test Finish + * | | |0 = CAN SRAM BIST is active. + * | | |1 = CAN SRAM BIST test finish. + * |[20] |USBBEND |USB SRAM BIST Test Finish + * | | |0 = USB SRAM BIST is active. + * | | |1 = USB SRAM BIST test finish. + * @var SYS_T::HIRCTCTL + * Offset: 0xE4 HIRC48M Trim Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |FREQSEL |Trim Frequency Selection + * | | |This field indicates the target frequency of 48 MHz internal high speed RC oscillator (HIRC) auto trim. + * | | |During auto trim operation, if clock error detected with CESTOPEN is set to 1 or trim retry limitation count reached, this field will be cleared to 00 automatically. + * | | |00 = Disable HIRC auto trim function. + * | | |01 = Enable HIRC auto trim function and trim HIRC to 48 MHz. + * | | |10 = Reserved.. + * | | |11 = Reserved. + * |[5:4] |LOOPSEL |Trim Calculation Loop Selection + * | | |This field defines that trim value calculation is based on how many reference clocks. + * | | |00 = Trim value calculation is based on average difference in 4 clocks of reference clock. + * | | |01 = Trim value calculation is based on average difference in 8 clocks of reference clock. + * | | |10 = Trim value calculation is based on average difference in 16 clocks of reference clock. + * | | |11 = Trim value calculation is based on average difference in 32 clocks of reference clock. + * | | |Note: For example, if LOOPSEL is set as 00, auto trim circuit will calculate trim value based on the average frequency difference in 4 clocks of reference clock. + * |[7:6] |RETRYCNT |Trim Value Update Limitation Count + * | | |This field defines that how many times the auto trim circuit will try to update the HIRC trim value before the frequency of HIRC locked. + * | | |Once the HIRC locked, the internal trim value update counter will be reset. + * | | |If the trim value update counter reached this limitation value and frequency of HIRC still doesn't lock, the auto trim operation will be disabled and FREQSEL will be cleared to 00. + * | | |00 = Trim retry count limitation is 64 loops. + * | | |01 = Trim retry count limitation is 128 loops. + * | | |10 = Trim retry count limitation is 256 loops. + * | | |11 = Trim retry count limitation is 512 loops. + * |[8] |CESTOPEN |Clock Error Stop Enable Bit + * | | |0 = The trim operation is keep going if clock is inaccuracy. + * | | |1 = The trim operation is stopped if clock is inaccuracy. + * |[9] |BOUNDEN |Boundary Enable Bit + * | | |0 = Boundary function is disable. + * | | |1 = Boundary function is enable. + * |[10] |REFCKSEL |Reference Clock Selection + * | | |0 = HIRC trim reference from external 32.768 kHz crystal oscillator. + * | | |1 = HIRC trim reference from internal USB synchronous mode. + * | | |Note: HIRC trim reference clock is 20Khz in test mode. + * |[20:16 |BOUNDARY |Boundary Selection + * | | |Fill the boundary range from 0x1 to 0x31, 0x0 is reserved. + * | | |Note1: This field is effective only when the BOUNDEN(SYS_HIRCTRIMCTL[9]) is enable. + * @var SYS_T::HIRCTIEN + * Offset: 0xE8 HIRC48M Trim Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1] |TFAILIEN |Trim Failure Interrupt Enable Bit + * | | |This bit controls if an interrupt will be triggered while HIRC trim value update limitation count reached and HIRC frequency still not locked on target frequency set by FREQSEL(SYS_HIRCTCTL[1:0]). + * | | |If this bit is high and TFAILIF(SYS_HIRCTISTS[1]) is set during auto trim operation, an interrupt will be triggered to notify that HIRC trim value update limitation count was reached. + * | | |0 = Disable TFAILIF(SYS_HIRCTISTS[1]) status to trigger an interrupt to CPU. + * | | |1 = Enable TFAILIF(SYS_HIRCTISTS[1]) status to trigger an interrupt to CPU. + * |[2] |CLKEIEN |Clock Error Interrupt Enable Bit + * | | |This bit controls if CPU would get an interrupt while clock is inaccuracy during auto trim operation. + * | | |If this bit is set to1, and CLKERRIF(SYS_HIRCTISTS[2]) is set during auto trim operation, an interrupt will be triggered to notify the clock frequency is inaccuracy. + * | | |0 = Disable CLKERRIF(SYS_HIRCTISTS[2]) status to trigger an interrupt to CPU. + * | | |1 = Enable CLKERRIF(SYS_HIRCTISTS[2]) status to trigger an interrupt to CPU. + * @var SYS_T::HIRCTISTS + * Offset: 0xEC HIRC48M Trim Interrupt Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |FREQLOCK |HIRC Frequency Lock Status + * | | |This bit indicates the HIRC frequency is locked. + * | | |This is a status bit and doesn't trigger any interrupt + * | | |Write 1 to clear this to 0 + * | | |This bit will be set automatically, if the frequency is lock and the RC_TRIM is enabled. + * | | |0 = The internal high-speed oscillator frequency doesn't lock at 48 MHz yet. + * | | |1 = The internal high-speed oscillator frequency locked at 48 MHz. + * |[1] |TFAILIF |Trim Failure Interrupt Status + * | | |This bit indicates that HIRC trim value update limitation count reached and the HIRC clock frequency still doesn't be locked + * | | |Once this bit is set, the auto trim operation stopped and FREQSEL(SYS_HIRCTCTL[1:0]) will be cleared to 00 by hardware automatically. + * | | |If this bit is set and TFAILIEN(SYS_HIRCTIEN[1]) is high, an interrupt will be triggered to notify that HIRC trim value update limitation count was reached + * | | |Write 1 to clear this to 0. + * | | |0 = Trim value update limitation count does not reach. + * | | |1 = Trim value update limitation count reached and HIRC frequency still not locked. + * |[2] |CLKERRIF |Clock Error Interrupt Status + * | | |When the frequency of 32.768 kHz external low speed crystal oscillator (LXT) or 48MHz internal high speed RC oscillator (HIRC) is shift larger to unreasonable value, this bit will be set and to be an indicate that clock frequency is inaccuracy. + * | | |Once this bit is set to 1, the auto trim operation stopped and FREQSEL(SYS_HIRCTCL[1:0]) will be cleared to 00 by hardware automatically if CESTOPEN(SYS_HIRCTCTL[8]) is set to 1. + * | | |If this bit is set and CLKEIEN(SYS_HIRCTIEN[2]) is high, an interrupt will be triggered to notify the clock frequency is inaccuracy. + * | | |Write 1 to clear this to 0. + * | | |0 = Clock frequency is accurate. + * | | |1 = Clock frequency is inaccurate. + * |[3] |OVBDIF |Over Boundary Status + * | | |When the over boundary function is set, if there occurs the over boundary condition, this flag will be set. + * | | |Note1: Write 1 to clear this flag. + * | | |Note2: This function is only supported in M48xGC/M48xG8. + * | | |0 = Over boundary condition did not occur. + * | | |1 = Over boundary condition occurred. + * @var SYS_T::IRCTCTL + * Offset: 0xF0 HIRC Trim Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |FREQSEL |Trim Frequency Selection + * | | |This field indicates the target frequency of 12 MHz internal high speed RC oscillator (HIRC) auto trim. + * | | |During auto trim operation, if clock error detected with CESTOPEN is set to 1 or trim retry limitation count reached, this field will be cleared to 00 automatically. + * | | |00 = Disable HIRC auto trim function. + * | | |01 = Enable HIRC auto trim function and trim HIRC to 12 MHz. + * | | |10 = Reserved.. + * | | |11 = Reserved. + * |[5:4] |LOOPSEL |Trim Calculation Loop Selection + * | | |This field defines that trim value calculation is based on how many reference clocks. + * | | |00 = Trim value calculation is based on average difference in 4 clocks of reference clock. + * | | |01 = Trim value calculation is based on average difference in 8 clocks of reference clock. + * | | |10 = Trim value calculation is based on average difference in 16 clocks of reference clock. + * | | |11 = Trim value calculation is based on average difference in 32 clocks of reference clock. + * | | |Note: For example, if LOOPSEL is set as 00, auto trim circuit will calculate trim value based on the average frequency difference in 4 clocks of reference clock. + * |[7:6] |RETRYCNT |Trim Value Update Limitation Count + * | | |This field defines that how many times the auto trim circuit will try to update the HIRC trim value before the frequency of HIRC locked. + * | | |Once the HIRC locked, the internal trim value update counter will be reset. + * | | |If the trim value update counter reached this limitation value and frequency of HIRC still doesn't lock, the auto trim operation will be disabled and FREQSEL will be cleared to 00. + * | | |00 = Trim retry count limitation is 64 loops. + * | | |01 = Trim retry count limitation is 128 loops. + * | | |10 = Trim retry count limitation is 256 loops. + * | | |11 = Trim retry count limitation is 512 loops. + * |[8] |CESTOPEN |Clock Error Stop Enable Bit + * | | |0 = The trim operation is keep going if clock is inaccuracy. + * | | |1 = The trim operation is stopped if clock is inaccuracy. + * |[10] |REFCKSEL |Reference Clock Selection + * | | |0 = HIRC trim reference from external 32.768 kHz crystal oscillator. + * | | |1 = HIRC trim reference from internal USB synchronous mode. + * | | |Note: HIRC trim reference clock is 20Khz in test mode. + * @var SYS_T::IRCTIEN + * Offset: 0xF4 HIRC Trim Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1] |TFAILIEN |Trim Failure Interrupt Enable Bit + * | | |This bit controls if an interrupt will be triggered while HIRC trim value update limitation count reached and HIRC frequency still not locked on target frequency set by FREQSEL(SYS_IRCTCTL[1:0]). + * | | |If this bit is high and TFAILIF(SYS_IRCTISTS[1]) is set during auto trim operation, an interrupt will be triggered to notify that HIRC trim value update limitation count was reached. + * | | |0 = Disable TFAILIF(SYS_IRCTISTS[1]) status to trigger an interrupt to CPU. + * | | |1 = Enable TFAILIF(SYS_IRCTISTS[1]) status to trigger an interrupt to CPU. + * |[2] |CLKEIEN |Clock Error Interrupt Enable Bit + * | | |This bit controls if CPU would get an interrupt while clock is inaccuracy during auto trim operation. + * | | |If this bit is set to1, and CLKERRIF(SYS_IRCTISTS[2]) is set during auto trim operation, an interrupt will be triggered to notify the clock frequency is inaccuracy. + * | | |0 = Disable CLKERRIF(SYS_IRCTISTS[2]) status to trigger an interrupt to CPU. + * | | |1 = Enable CLKERRIF(SYS_IRCTISTS[2]) status to trigger an interrupt to CPU. + * @var SYS_T::IRCTISTS + * Offset: 0xF8 HIRC Trim Interrupt Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |FREQLOCK |HIRC Frequency Lock Status + * | | |This bit indicates the HIRC frequency is locked. + * | | |This is a status bit and doesn't trigger any interrupt + * | | |Write 1 to clear this to 0 + * | | |This bit will be set automatically, if the frequency is lock and the RC_TRIM is enabled. + * | | |0 = The internal high-speed oscillator frequency doesn't lock at 12 MHz yet. + * | | |1 = The internal high-speed oscillator frequency locked at 12 MHz. + * |[1] |TFAILIF |Trim Failure Interrupt Status + * | | |This bit indicates that HIRC trim value update limitation count reached and the HIRC clock frequency still doesn't be locked + * | | |Once this bit is set, the auto trim operation stopped and FREQSEL(SYS_IRCTCTL[1:0]) will be cleared to 00 by hardware automatically. + * | | |If this bit is set and TFAILIEN(SYS_IRCTIEN[1]) is high, an interrupt will be triggered to notify that HIRC trim value update limitation count was reached + * | | |Write 1 to clear this to 0. + * | | |0 = Trim value update limitation count does not reach. + * | | |1 = Trim value update limitation count reached and HIRC frequency still not locked. + * |[2] |CLKERRIF |Clock Error Interrupt Status + * | | |When the frequency of 32.768 kHz external low speed crystal oscillator (LXT) or 12MHz internal high speed RC oscillator (HIRC) is shift larger to unreasonable value, this bit will be set and to be an indicate that clock frequency is inaccuracy. + * | | |Once this bit is set to 1, the auto trim operation stopped and FREQSEL(SYS_IRCTCL[1:0]) will be cleared to 00 by hardware automatically if CESTOPEN(SYS_IRCTCTL[8]) is set to 1. + * | | |If this bit is set and CLKEIEN(SYS_IRCTIEN[2]) is high, an interrupt will be triggered to notify the clock frequency is inaccuracy. + * | | |Write 1 to clear this to 0. + * | | |0 = Clock frequency is accurate. + * | | |1 = Clock frequency is inaccurate. + * @var SYS_T::REGLCTL + * Offset: 0x100 Register Lock Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |REGLCTL |Register Lock Control Code + * | | |Some registers have write-protection function + * | | |Writing these registers have to disable the protected function by writing the sequence value "59h", "16h", "88h" to this field. + * | | |After this sequence is completed, the REGLCTL bit will be set to 1 and write-protection registers can be normal write. + * | | |Register Lock Control Code + * | | |0 = Write-protection Enabled for writing protected registers + * | | |Any write to the protected register is ignored. + * | | |1 = Write-protection Disabled for writing protected registers. + * @var SYS_T::PORDISAN + * Offset: 0x1EC Analog POR Disable Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |POROFFAN |Power-on Reset Enable Bit (Write Protect) + * | | |After powered on, User can turn off internal analog POR circuit to save power by writing 0x5AA5 to this field. + * | | |The analog POR circuit will be active again when this field is set to another value or chip is reset by other reset source, including: + * | | |nRESET, Watchdog, LVR reset, BOD reset, ICE reset command and the software-chip reset function. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * @var SYS_T::PLCTL + * Offset: 0x1F8 Power Level Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |PLSEL |Power Level Select(Write Protect) + * | | |00 = Power level is PL0. + * | | |01 = Power level is PL1. + * | | |Others = Reserved. + * |[21:16] |LVSSTEP |LDO Voltage Scaling Step(Write Protect) + * | | |The LVSSTEP value is LDO voltage rising step. + * | | |Core voltage scaling voltage step = (LVSSTEP + 1) * 10mV. + * |[31:24] |LVSPRD |LDO Voltage Scaling Period(Write Protect) + * | | |The LVSPRD value is the period of each LDO voltage rising step. + * | | |LDO voltage scaling period = (LVSPRD + 1) * 1us. + * @var SYS_T::PLSTS + * Offset: 0x1FC Power Level Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |PLCBUSY |Power Level Change Busy Bit (Read Only) + * | | |This bit is set by hardware when core voltage is changing + * | | |After core voltage change is completed, this bit will be cleared automatically by hardware. + * | | |0 = Core voltage change is completed. + * | | |1 = Core voltage change is ongoing. + * |[9:8] |PLSTATUS |Power Level Status (Read Only) + * | | |00 = Power level is PL0. + * | | |01 = Power level is PL1. + * | | |Others = Reserved. + * @var SYS_T::AHBMCTL + * Offset: 0x400 AHB Bus Matrix Priority Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |INTACTEN |Highest AHB Bus Priority of Cortex M4 Core Enable Bit (Write Protect) + * | | |Enable Cortex-M4 Core With Highest AHB Bus Priority In AHB Bus Matrix + * | | |0 = Run robin mode. + * | | |1 = Cortex-M4 CPU with highest bus priority when interrupt occurred. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + */ + __I uint32_t PDID; /*!< [0x0000] Part Device Identification Number Register */ + __IO uint32_t RSTSTS; /*!< [0x0004] System Reset Status Register */ + __IO uint32_t IPRST0; /*!< [0x0008] Peripheral Reset Control Register 0 */ + __IO uint32_t IPRST1; /*!< [0x000c] Peripheral Reset Control Register 1 */ + __IO uint32_t IPRST2; /*!< [0x0010] Peripheral Reset Control Register 2 */ + /** @cond HIDDEN_SYMBOLS */ + __I uint32_t RESERVE0[1]; + /** @endcond */ + __IO uint32_t BODCTL; /*!< [0x0018] Brown-Out Detector Control Register */ + __IO uint32_t IVSCTL; /*!< [0x001c] Internal Voltage Source Control Register */ + /** @cond HIDDEN_SYMBOLS */ + __I uint32_t RESERVE1[1]; + /** @endcond */ + __IO uint32_t PORCTL; /*!< [0x0024] Power-On-Reset Controller Register */ + __IO uint32_t VREFCTL; /*!< [0x0028] VREF Control Register */ + __IO uint32_t USBPHY; /*!< [0x002c] USB PHY Control Register */ + __IO uint32_t GPA_MFPL; /*!< [0x0030] GPIOA Low Byte Multiple Function Control Register */ + __IO uint32_t GPA_MFPH; /*!< [0x0034] GPIOA High Byte Multiple Function Control Register */ + __IO uint32_t GPB_MFPL; /*!< [0x0038] GPIOB Low Byte Multiple Function Control Register */ + __IO uint32_t GPB_MFPH; /*!< [0x003c] GPIOB High Byte Multiple Function Control Register */ + __IO uint32_t GPC_MFPL; /*!< [0x0040] GPIOC Low Byte Multiple Function Control Register */ + __IO uint32_t GPC_MFPH; /*!< [0x0044] GPIOC High Byte Multiple Function Control Register */ + __IO uint32_t GPD_MFPL; /*!< [0x0048] GPIOD Low Byte Multiple Function Control Register */ + __IO uint32_t GPD_MFPH; /*!< [0x004c] GPIOD High Byte Multiple Function Control Register */ + __IO uint32_t GPE_MFPL; /*!< [0x0050] GPIOE Low Byte Multiple Function Control Register */ + __IO uint32_t GPE_MFPH; /*!< [0x0054] GPIOE High Byte Multiple Function Control Register */ + __IO uint32_t GPF_MFPL; /*!< [0x0058] GPIOF Low Byte Multiple Function Control Register */ + __IO uint32_t GPF_MFPH; /*!< [0x005c] GPIOF High Byte Multiple Function Control Register */ + __IO uint32_t GPG_MFPL; /*!< [0x0060] GPIOG Low Byte Multiple Function Control Register */ + __IO uint32_t GPG_MFPH; /*!< [0x0064] GPIOG High Byte Multiple Function Control Register */ + __IO uint32_t GPH_MFPL; /*!< [0x0068] GPIOH Low Byte Multiple Function Control Register */ + __IO uint32_t GPH_MFPH; /*!< [0x006c] GPIOH High Byte Multiple Function Control Register */ + /** @cond HIDDEN_SYMBOLS */ + __I uint32_t RESERVE2[4]; + /** @endcond */ + __IO uint32_t GPA_MFOS; /*!< [0x0080] GPIOA Multiple Function Output Select Register */ + __IO uint32_t GPB_MFOS; /*!< [0x0084] GPIOB Multiple Function Output Select Register */ + __IO uint32_t GPC_MFOS; /*!< [0x0088] GPIOC Multiple Function Output Select Register */ + __IO uint32_t GPD_MFOS; /*!< [0x008c] GPIOD Multiple Function Output Select Register */ + __IO uint32_t GPE_MFOS; /*!< [0x0090] GPIOE Multiple Function Output Select Register */ + __IO uint32_t GPF_MFOS; /*!< [0x0094] GPIOF Multiple Function Output Select Register */ + __IO uint32_t GPG_MFOS; /*!< [0x0098] GPIOG Multiple Function Output Select Register */ + __IO uint32_t GPH_MFOS; /*!< [0x009c] GPIOH Multiple Function Output Select Register */ + /** @cond HIDDEN_SYMBOLS */ + __I uint32_t RESERVE3[8]; + /** @endcond */ + __IO uint32_t SRAM_INTCTL; /*!< [0x00c0] System SRAM Interrupt Enable Control Register */ + __IO uint32_t SRAM_STATUS; /*!< [0x00c4] System SRAM Parity Error Status Register */ + __I uint32_t SRAM_ERRADDR; /*!< [0x00c8] System SRAM Parity Check Error Address Register */ + /** @cond HIDDEN_SYMBOLS */ + __I uint32_t RESERVE4[1]; + /** @endcond */ + __IO uint32_t SRAM_BISTCTL; /*!< [0x00d0] System SRAM BIST Test Control Register */ + __I uint32_t SRAM_BISTSTS; /*!< [0x00d4] System SRAM BIST Test Status Register */ + /** @cond HIDDEN_SYMBOLS */ + __I uint32_t RESERVE5[3]; + /** @endcond */ + __IO uint32_t HIRCTCTL; /*!< [0x00e4] HIRC48M Trim Control Register */ + __IO uint32_t HIRCTIEN; /*!< [0x00e8] HIRC48M Trim Interrupt Enable Register */ + __IO uint32_t HIRCTISTS; /*!< [0x00ec] HIRC48M Trim Interrupt Status Register */ + __IO uint32_t IRCTCTL; /*!< [0x00f0] HIRC Trim Control Register */ + __IO uint32_t IRCTIEN; /*!< [0x00f4] HIRC Trim Interrupt Enable Register */ + __IO uint32_t IRCTISTS; /*!< [0x00f8] HIRC Trim Interrupt Status Register */ + /** @cond HIDDEN_SYMBOLS */ + __I uint32_t RESERVE6[1]; + /** @endcond */ + __IO uint32_t REGLCTL; /*!< [0x0100] Register Lock Control Register */ + /** @cond HIDDEN_SYMBOLS */ + __I uint32_t RESERVE7[58]; + /** @endcond */ + __IO uint32_t PORDISAN; /*!< [0x01ec] Analog POR Disable Control Register */ + /** @cond HIDDEN_SYMBOLS */ + __I uint32_t RESERVE8; + /** @endcond */ + __I uint32_t CSERVER; /*!< [0x01f4] Chip Series Version Register */ + __IO uint32_t PLCTL; /*!< [0x01f8] Power Level Control Register */ + __I uint32_t PLSTS; /*!< [0x01fc] Power Level Status Register */ + /** @cond HIDDEN_SYMBOLS */ + __I uint32_t RESERVE9[128]; + /** @endcond */ + __IO uint32_t AHBMCTL; /*!< [0x0400] AHB Bus Matrix Priority Control Register */ + +} SYS_T; + +/** + @addtogroup SYS_CONST SYS Bit Field Definition + Constant Definitions for SYS Controller +@{ */ + +#define SYS_PDID_PDID_Pos (0) /*!< SYS_T::PDID: PDID Position */ +#define SYS_PDID_PDID_Msk (0xfffffffful << SYS_PDID_PDID_Pos) /*!< SYS_T::PDID: PDID Mask */ + +#define SYS_RSTSTS_PORF_Pos (0) /*!< SYS_T::RSTSTS: PORF Position */ +#define SYS_RSTSTS_PORF_Msk (0x1ul << SYS_RSTSTS_PORF_Pos) /*!< SYS_T::RSTSTS: PORF Mask */ + +#define SYS_RSTSTS_PINRF_Pos (1) /*!< SYS_T::RSTSTS: PINRF Position */ +#define SYS_RSTSTS_PINRF_Msk (0x1ul << SYS_RSTSTS_PINRF_Pos) /*!< SYS_T::RSTSTS: PINRF Mask */ + +#define SYS_RSTSTS_WDTRF_Pos (2) /*!< SYS_T::RSTSTS: WDTRF Position */ +#define SYS_RSTSTS_WDTRF_Msk (0x1ul << SYS_RSTSTS_WDTRF_Pos) /*!< SYS_T::RSTSTS: WDTRF Mask */ + +#define SYS_RSTSTS_LVRF_Pos (3) /*!< SYS_T::RSTSTS: LVRF Position */ +#define SYS_RSTSTS_LVRF_Msk (0x1ul << SYS_RSTSTS_LVRF_Pos) /*!< SYS_T::RSTSTS: LVRF Mask */ + +#define SYS_RSTSTS_BODRF_Pos (4) /*!< SYS_T::RSTSTS: BODRF Position */ +#define SYS_RSTSTS_BODRF_Msk (0x1ul << SYS_RSTSTS_BODRF_Pos) /*!< SYS_T::RSTSTS: BODRF Mask */ + +#define SYS_RSTSTS_SYSRF_Pos (5) /*!< SYS_T::RSTSTS: SYSRF Position */ +#define SYS_RSTSTS_SYSRF_Msk (0x1ul << SYS_RSTSTS_SYSRF_Pos) /*!< SYS_T::RSTSTS: SYSRF Mask */ + +#define SYS_RSTSTS_CPURF_Pos (7) /*!< SYS_T::RSTSTS: CPURF Position */ +#define SYS_RSTSTS_CPURF_Msk (0x1ul << SYS_RSTSTS_CPURF_Pos) /*!< SYS_T::RSTSTS: CPURF Mask */ + +#define SYS_RSTSTS_CPULKRF_Pos (8) /*!< SYS_T::RSTSTS: CPULKRF Position */ +#define SYS_RSTSTS_CPULKRF_Msk (0x1ul << SYS_RSTSTS_CPULKRF_Pos) /*!< SYS_T::RSTSTS: CPULKRF Mask */ + +#define SYS_IPRST0_CHIPRST_Pos (0) /*!< SYS_T::IPRST0: CHIPRST Position */ +#define SYS_IPRST0_CHIPRST_Msk (0x1ul << SYS_IPRST0_CHIPRST_Pos) /*!< SYS_T::IPRST0: CHIPRST Mask */ + +#define SYS_IPRST0_CPURST_Pos (1) /*!< SYS_T::IPRST0: CPURST Position */ +#define SYS_IPRST0_CPURST_Msk (0x1ul << SYS_IPRST0_CPURST_Pos) /*!< SYS_T::IPRST0: CPURST Mask */ + +#define SYS_IPRST0_PDMARST_Pos (2) /*!< SYS_T::IPRST0: PDMARST Position */ +#define SYS_IPRST0_PDMARST_Msk (0x1ul << SYS_IPRST0_PDMARST_Pos) /*!< SYS_T::IPRST0: PDMARST Mask */ + +#define SYS_IPRST0_EBIRST_Pos (3) /*!< SYS_T::IPRST0: EBIRST Position */ +#define SYS_IPRST0_EBIRST_Msk (0x1ul << SYS_IPRST0_EBIRST_Pos) /*!< SYS_T::IPRST0: EBIRST Mask */ + +#define SYS_IPRST0_EMACRST_Pos (5) /*!< SYS_T::IPRST0: EMACRST Position */ +#define SYS_IPRST0_EMACRST_Msk (0x1ul << SYS_IPRST0_EMACRST_Pos) /*!< SYS_T::IPRST0: EMACRST Mask */ + +#define SYS_IPRST0_SDH0RST_Pos (6) /*!< SYS_T::IPRST0: SDH0RST Position */ +#define SYS_IPRST0_SDH0RST_Msk (0x1ul << SYS_IPRST0_SDH0RST_Pos) /*!< SYS_T::IPRST0: SDH0RST Mask */ + +#define SYS_IPRST0_CRCRST_Pos (7) /*!< SYS_T::IPRST0: CRCRST Position */ +#define SYS_IPRST0_CRCRST_Msk (0x1ul << SYS_IPRST0_CRCRST_Pos) /*!< SYS_T::IPRST0: CRCRST Mask */ + +#define SYS_IPRST0_CCAPRST_Pos (8) /*!< SYS_T::IPRST0: CCAPRST Position */ +#define SYS_IPRST0_CCAPRST_Msk (0x1ul << SYS_IPRST0_CCAPRST_Pos) /*!< SYS_T::IPRST0: CCAPRST Mask */ + +#define SYS_IPRST0_HSUSBDRST_Pos (10) /*!< SYS_T::IPRST0: HSUSBDRST Position */ +#define SYS_IPRST0_HSUSBDRST_Msk (0x1ul << SYS_IPRST0_HSUSBDRST_Pos) /*!< SYS_T::IPRST0: HSUSBDRST Mask */ + +#define SYS_IPRST0_CRPTRST_Pos (12) /*!< SYS_T::IPRST0: CRPTRST Position */ +#define SYS_IPRST0_CRPTRST_Msk (0x1ul << SYS_IPRST0_CRPTRST_Pos) /*!< SYS_T::IPRST0: CRPTRST Mask */ + +#define SYS_IPRST0_SPIMRST_Pos (14) /*!< SYS_T::IPRST0: SPIMRST Position */ +#define SYS_IPRST0_SPIMRST_Msk (0x1ul << SYS_IPRST0_SPIMRST_Pos) /*!< SYS_T::IPRST0: SPIMRST Mask */ + +#define SYS_IPRST0_USBHRST_Pos (16) /*!< SYS_T::IPRST0: USBHRST Position */ +#define SYS_IPRST0_USBHRST_Msk (0x1ul << SYS_IPRST0_USBHRST_Pos) /*!< SYS_T::IPRST0: USBHRST Mask */ + +#define SYS_IPRST0_SDH1RST_Pos (17) /*!< SYS_T::IPRST0: SDH1RST Position */ +#define SYS_IPRST0_SDH1RST_Msk (0x1ul << SYS_IPRST0_SDH1RST_Pos) /*!< SYS_T::IPRST0: SDH1RST Mask */ + +#define SYS_IPRST1_GPIORST_Pos (1) /*!< SYS_T::IPRST1: GPIORST Position */ +#define SYS_IPRST1_GPIORST_Msk (0x1ul << SYS_IPRST1_GPIORST_Pos) /*!< SYS_T::IPRST1: GPIORST Mask */ + +#define SYS_IPRST1_TMR0RST_Pos (2) /*!< SYS_T::IPRST1: TMR0RST Position */ +#define SYS_IPRST1_TMR0RST_Msk (0x1ul << SYS_IPRST1_TMR0RST_Pos) /*!< SYS_T::IPRST1: TMR0RST Mask */ + +#define SYS_IPRST1_TMR1RST_Pos (3) /*!< SYS_T::IPRST1: TMR1RST Position */ +#define SYS_IPRST1_TMR1RST_Msk (0x1ul << SYS_IPRST1_TMR1RST_Pos) /*!< SYS_T::IPRST1: TMR1RST Mask */ + +#define SYS_IPRST1_TMR2RST_Pos (4) /*!< SYS_T::IPRST1: TMR2RST Position */ +#define SYS_IPRST1_TMR2RST_Msk (0x1ul << SYS_IPRST1_TMR2RST_Pos) /*!< SYS_T::IPRST1: TMR2RST Mask */ + +#define SYS_IPRST1_TMR3RST_Pos (5) /*!< SYS_T::IPRST1: TMR3RST Position */ +#define SYS_IPRST1_TMR3RST_Msk (0x1ul << SYS_IPRST1_TMR3RST_Pos) /*!< SYS_T::IPRST1: TMR3RST Mask */ + +#define SYS_IPRST1_ACMP01RST_Pos (7) /*!< SYS_T::IPRST1: ACMP01RST Position */ +#define SYS_IPRST1_ACMP01RST_Msk (0x1ul << SYS_IPRST1_ACMP01RST_Pos) /*!< SYS_T::IPRST1: ACMP01RST Mask */ + +#define SYS_IPRST1_I2C0RST_Pos (8) /*!< SYS_T::IPRST1: I2C0RST Position */ +#define SYS_IPRST1_I2C0RST_Msk (0x1ul << SYS_IPRST1_I2C0RST_Pos) /*!< SYS_T::IPRST1: I2C0RST Mask */ + +#define SYS_IPRST1_I2C1RST_Pos (9) /*!< SYS_T::IPRST1: I2C1RST Position */ +#define SYS_IPRST1_I2C1RST_Msk (0x1ul << SYS_IPRST1_I2C1RST_Pos) /*!< SYS_T::IPRST1: I2C1RST Mask */ + +#define SYS_IPRST1_I2C2RST_Pos (10) /*!< SYS_T::IPRST1: I2C2RST Position */ +#define SYS_IPRST1_I2C2RST_Msk (0x1ul << SYS_IPRST1_I2C2RST_Pos) /*!< SYS_T::IPRST1: I2C2RST Mask */ + +#define SYS_IPRST1_QSPI0RST_Pos (12) /*!< SYS_T::IPRST1: QSPI0RST Position */ +#define SYS_IPRST1_QSPI0RST_Msk (0x1ul << SYS_IPRST1_QSPI0RST_Pos) /*!< SYS_T::IPRST1: QSPI0RST Mask */ + +#define SYS_IPRST1_SPI0RST_Pos (13) /*!< SYS_T::IPRST1: SPI0RST Position */ +#define SYS_IPRST1_SPI0RST_Msk (0x1ul << SYS_IPRST1_SPI0RST_Pos) /*!< SYS_T::IPRST1: SPI0RST Mask */ + +#define SYS_IPRST1_SPI1RST_Pos (14) /*!< SYS_T::IPRST1: SPI1RST Position */ +#define SYS_IPRST1_SPI1RST_Msk (0x1ul << SYS_IPRST1_SPI1RST_Pos) /*!< SYS_T::IPRST1: SPI1RST Mask */ + +#define SYS_IPRST1_SPI2RST_Pos (15) /*!< SYS_T::IPRST1: SPI2RST Position */ +#define SYS_IPRST1_SPI2RST_Msk (0x1ul << SYS_IPRST1_SPI2RST_Pos) /*!< SYS_T::IPRST1: SPI2RST Mask */ + +#define SYS_IPRST1_UART0RST_Pos (16) /*!< SYS_T::IPRST1: UART0RST Position */ +#define SYS_IPRST1_UART0RST_Msk (0x1ul << SYS_IPRST1_UART0RST_Pos) /*!< SYS_T::IPRST1: UART0RST Mask */ + +#define SYS_IPRST1_UART1RST_Pos (17) /*!< SYS_T::IPRST1: UART1RST Position */ +#define SYS_IPRST1_UART1RST_Msk (0x1ul << SYS_IPRST1_UART1RST_Pos) /*!< SYS_T::IPRST1: UART1RST Mask */ + +#define SYS_IPRST1_UART2RST_Pos (18) /*!< SYS_T::IPRST1: UART2RST Position */ +#define SYS_IPRST1_UART2RST_Msk (0x1ul << SYS_IPRST1_UART2RST_Pos) /*!< SYS_T::IPRST1: UART2RST Mask */ + +#define SYS_IPRST1_UART3RST_Pos (19) /*!< SYS_T::IPRST1: UART3RST Position */ +#define SYS_IPRST1_UART3RST_Msk (0x1ul << SYS_IPRST1_UART3RST_Pos) /*!< SYS_T::IPRST1: UART3RST Mask */ + +#define SYS_IPRST1_UART4RST_Pos (20) /*!< SYS_T::IPRST1: UART4RST Position */ +#define SYS_IPRST1_UART4RST_Msk (0x1ul << SYS_IPRST1_UART4RST_Pos) /*!< SYS_T::IPRST1: UART4RST Mask */ + +#define SYS_IPRST1_UART5RST_Pos (21) /*!< SYS_T::IPRST1: UART5RST Position */ +#define SYS_IPRST1_UART5RST_Msk (0x1ul << SYS_IPRST1_UART5RST_Pos) /*!< SYS_T::IPRST1: UART5RST Mask */ + +#define SYS_IPRST1_UART6RST_Pos (22) /*!< SYS_T::IPRST1: UART6RST Position */ +#define SYS_IPRST1_UART6RST_Msk (0x1ul << SYS_IPRST1_UART6RST_Pos) /*!< SYS_T::IPRST1: UART6RST Mask */ + +#define SYS_IPRST1_UART7RST_Pos (23) /*!< SYS_T::IPRST1: UART7RST Position */ +#define SYS_IPRST1_UART7RST_Msk (0x1ul << SYS_IPRST1_UART7RST_Pos) /*!< SYS_T::IPRST1: UART7RST Mask */ + +#define SYS_IPRST1_CAN0RST_Pos (24) /*!< SYS_T::IPRST1: CAN0RST Position */ +#define SYS_IPRST1_CAN0RST_Msk (0x1ul << SYS_IPRST1_CAN0RST_Pos) /*!< SYS_T::IPRST1: CAN0RST Mask */ + +#define SYS_IPRST1_CAN1RST_Pos (25) /*!< SYS_T::IPRST1: CAN1RST Position */ +#define SYS_IPRST1_CAN1RST_Msk (0x1ul << SYS_IPRST1_CAN1RST_Pos) /*!< SYS_T::IPRST1: CAN1RST Mask */ + +#define SYS_IPRST1_OTGRST_Pos (26) /*!< SYS_T::IPRST1: OTGRST Position */ +#define SYS_IPRST1_OTGRST_Msk (0x1ul << SYS_IPRST1_OTGRST_Pos) /*!< SYS_T::IPRST1: OTGRST Mask */ + +#define SYS_IPRST1_USBDRST_Pos (27) /*!< SYS_T::IPRST1: USBDRST Position */ +#define SYS_IPRST1_USBDRST_Msk (0x1ul << SYS_IPRST1_USBDRST_Pos) /*!< SYS_T::IPRST1: USBDRST Mask */ + +#define SYS_IPRST1_EADCRST_Pos (28) /*!< SYS_T::IPRST1: EADCRST Position */ +#define SYS_IPRST1_EADCRST_Msk (0x1ul << SYS_IPRST1_EADCRST_Pos) /*!< SYS_T::IPRST1: EADCRST Mask */ + +#define SYS_IPRST1_I2S0RST_Pos (29) /*!< SYS_T::IPRST1: I2S0RST Position */ +#define SYS_IPRST1_I2S0RST_Msk (0x1ul << SYS_IPRST1_I2S0RST_Pos) /*!< SYS_T::IPRST1: I2S0RST Mask */ + +#define SYS_IPRST1_HSOTGRST_Pos (30) /*!< SYS_T::IPRST1: HSOTGRST Position */ +#define SYS_IPRST1_HSOTGRST_Msk (0x1ul << SYS_IPRST1_HSOTGRST_Pos) /*!< SYS_T::IPRST1: HSOTGRST Mask */ + +#define SYS_IPRST1_TRNGRST_Pos (31) /*!< SYS_T::IPRST1: TRNGRST Position */ +#define SYS_IPRST1_TRNGRST_Msk (0x1ul << SYS_IPRST1_TRNGRST_Pos) /*!< SYS_T::IPRST1: TRNGRST Mask */ + +#define SYS_IPRST2_SC0RST_Pos (0) /*!< SYS_T::IPRST2: SC0RST Position */ +#define SYS_IPRST2_SC0RST_Msk (0x1ul << SYS_IPRST2_SC0RST_Pos) /*!< SYS_T::IPRST2: SC0RST Mask */ + +#define SYS_IPRST2_SC1RST_Pos (1) /*!< SYS_T::IPRST2: SC1RST Position */ +#define SYS_IPRST2_SC1RST_Msk (0x1ul << SYS_IPRST2_SC1RST_Pos) /*!< SYS_T::IPRST2: SC1RST Mask */ + +#define SYS_IPRST2_SC2RST_Pos (2) /*!< SYS_T::IPRST2: SC2RST Position */ +#define SYS_IPRST2_SC2RST_Msk (0x1ul << SYS_IPRST2_SC2RST_Pos) /*!< SYS_T::IPRST2: SC2RST Mask */ + +#define SYS_IPRST2_QSPI1RST_Pos (4) /*!< SYS_T::IPRST2: QSPI1RST Position */ +#define SYS_IPRST2_QSPI1RST_Msk (0x1ul << SYS_IPRST2_QSPI1RST_Pos) /*!< SYS_T::IPRST2: QSPI1RST Mask */ + +#define SYS_IPRST2_SPI3RST_Pos (6) /*!< SYS_T::IPRST2: SPI3RST Position */ +#define SYS_IPRST2_SPI3RST_Msk (0x1ul << SYS_IPRST2_SPI3RST_Pos) /*!< SYS_T::IPRST2: SPI3RST Mask */ + +#define SYS_IPRST2_USCI0RST_Pos (8) /*!< SYS_T::IPRST2: USCI0RST Position */ +#define SYS_IPRST2_USCI0RST_Msk (0x1ul << SYS_IPRST2_USCI0RST_Pos) /*!< SYS_T::IPRST2: USCI0RST Mask */ + +#define SYS_IPRST2_USCI1RST_Pos (9) /*!< SYS_T::IPRST2: USCI1RST Position */ +#define SYS_IPRST2_USCI1RST_Msk (0x1ul << SYS_IPRST2_USCI1RST_Pos) /*!< SYS_T::IPRST2: USCI1RST Mask */ + +#define SYS_IPRST2_DACRST_Pos (12) /*!< SYS_T::IPRST2: DACRST Position */ +#define SYS_IPRST2_DACRST_Msk (0x1ul << SYS_IPRST2_DACRST_Pos) /*!< SYS_T::IPRST2: DACRST Mask */ + +#define SYS_IPRST2_EPWM0RST_Pos (16) /*!< SYS_T::IPRST2: EPWM0RST Position */ +#define SYS_IPRST2_EPWM0RST_Msk (0x1ul << SYS_IPRST2_EPWM0RST_Pos) /*!< SYS_T::IPRST2: EPWM0RST Mask */ + +#define SYS_IPRST2_EPWM1RST_Pos (17) /*!< SYS_T::IPRST2: EPWM1RST Position */ +#define SYS_IPRST2_EPWM1RST_Msk (0x1ul << SYS_IPRST2_EPWM1RST_Pos) /*!< SYS_T::IPRST2: EPWM1RST Mask */ + +#define SYS_IPRST2_BPWM0RST_Pos (18) /*!< SYS_T::IPRST2: BPWM0RST Position */ +#define SYS_IPRST2_BPWM0RST_Msk (0x1ul << SYS_IPRST2_BPWM0RST_Pos) /*!< SYS_T::IPRST2: BPWM0RST Mask */ + +#define SYS_IPRST2_BPWM1RST_Pos (19) /*!< SYS_T::IPRST2: BPWM1RST Position */ +#define SYS_IPRST2_BPWM1RST_Msk (0x1ul << SYS_IPRST2_BPWM1RST_Pos) /*!< SYS_T::IPRST2: BPWM1RST Mask */ + +#define SYS_IPRST2_QEI0RST_Pos (22) /*!< SYS_T::IPRST2: QEI0RST Position */ +#define SYS_IPRST2_QEI0RST_Msk (0x1ul << SYS_IPRST2_QEI0RST_Pos) /*!< SYS_T::IPRST2: QEI0RST Mask */ + +#define SYS_IPRST2_QEI1RST_Pos (23) /*!< SYS_T::IPRST2: QEI1RST Position */ +#define SYS_IPRST2_QEI1RST_Msk (0x1ul << SYS_IPRST2_QEI1RST_Pos) /*!< SYS_T::IPRST2: QEI1RST Mask */ + +#define SYS_IPRST2_ECAP0RST_Pos (26) /*!< SYS_T::IPRST2: ECAP0RST Position */ +#define SYS_IPRST2_ECAP0RST_Msk (0x1ul << SYS_IPRST2_ECAP0RST_Pos) /*!< SYS_T::IPRST2: ECAP0RST Mask */ + +#define SYS_IPRST2_ECAP1RST_Pos (27) /*!< SYS_T::IPRST2: ECAP1RST Position */ +#define SYS_IPRST2_ECAP1RST_Msk (0x1ul << SYS_IPRST2_ECAP1RST_Pos) /*!< SYS_T::IPRST2: ECAP1RST Mask */ + +#define SYS_IPRST2_CAN2RST_Pos (28) /*!< SYS_T::IPRST2: CAN2RST Position */ +#define SYS_IPRST2_CAN2RST_Msk (0x1ul << SYS_IPRST2_CAN2RST_Pos) /*!< SYS_T::IPRST2: CAN2RST Mask */ + +#define SYS_IPRST2_OPARST_Pos (30) /*!< SYS_T::IPRST2: OPARST Position */ +#define SYS_IPRST2_OPARST_Msk (0x1ul << SYS_IPRST2_OPARST_Pos) /*!< SYS_T::IPRST2: OPARST Mask */ + +#define SYS_IPRST2_EADC1RST_Pos (31) /*!< SYS_T::IPRST2: EADC1RST Position */ +#define SYS_IPRST2_EADC1RST_Msk (0x1ul << SYS_IPRST2_EADC1RST_Pos) /*!< SYS_T::IPRST2: EADC1RST Mask */ + +#define SYS_BODCTL_BODEN_Pos (0) /*!< SYS_T::BODCTL: BODEN Position */ +#define SYS_BODCTL_BODEN_Msk (0x1ul << SYS_BODCTL_BODEN_Pos) /*!< SYS_T::BODCTL: BODEN Mask */ + +#define SYS_BODCTL_BODRSTEN_Pos (3) /*!< SYS_T::BODCTL: BODRSTEN Position */ +#define SYS_BODCTL_BODRSTEN_Msk (0x1ul << SYS_BODCTL_BODRSTEN_Pos) /*!< SYS_T::BODCTL: BODRSTEN Mask */ + +#define SYS_BODCTL_BODIF_Pos (4) /*!< SYS_T::BODCTL: BODIF Position */ +#define SYS_BODCTL_BODIF_Msk (0x1ul << SYS_BODCTL_BODIF_Pos) /*!< SYS_T::BODCTL: BODIF Mask */ + +#define SYS_BODCTL_BODLPM_Pos (5) /*!< SYS_T::BODCTL: BODLPM Position */ +#define SYS_BODCTL_BODLPM_Msk (0x1ul << SYS_BODCTL_BODLPM_Pos) /*!< SYS_T::BODCTL: BODLPM Mask */ + +#define SYS_BODCTL_BODOUT_Pos (6) /*!< SYS_T::BODCTL: BODOUT Position */ +#define SYS_BODCTL_BODOUT_Msk (0x1ul << SYS_BODCTL_BODOUT_Pos) /*!< SYS_T::BODCTL: BODOUT Mask */ + +#define SYS_BODCTL_LVREN_Pos (7) /*!< SYS_T::BODCTL: LVREN Position */ +#define SYS_BODCTL_LVREN_Msk (0x1ul << SYS_BODCTL_LVREN_Pos) /*!< SYS_T::BODCTL: LVREN Mask */ + +#define SYS_BODCTL_BODDGSEL_Pos (8) /*!< SYS_T::BODCTL: BODDGSEL Position */ +#define SYS_BODCTL_BODDGSEL_Msk (0x7ul << SYS_BODCTL_BODDGSEL_Pos) /*!< SYS_T::BODCTL: BODDGSEL Mask */ + +#define SYS_BODCTL_LVRDGSEL_Pos (12) /*!< SYS_T::BODCTL: LVRDGSEL Position */ +#define SYS_BODCTL_LVRDGSEL_Msk (0x7ul << SYS_BODCTL_LVRDGSEL_Pos) /*!< SYS_T::BODCTL: LVRDGSEL Mask */ + +#define SYS_BODCTL_BODVL_Pos (16) /*!< SYS_T::BODCTL: BODVL Position */ +#define SYS_BODCTL_BODVL_Msk (0x7ul << SYS_BODCTL_BODVL_Pos) /*!< SYS_T::BODCTL: BODVL Mask */ + +#define SYS_IVSCTL_VTEMPEN_Pos (0) /*!< SYS_T::IVSCTL: VTEMPEN Position */ +#define SYS_IVSCTL_VTEMPEN_Msk (0x1ul << SYS_IVSCTL_VTEMPEN_Pos) /*!< SYS_T::IVSCTL: VTEMPEN Mask */ + +#define SYS_IVSCTL_VBATUGEN_Pos (1) /*!< SYS_T::IVSCTL: VBATUGEN Position */ +#define SYS_IVSCTL_VBATUGEN_Msk (0x1ul << SYS_IVSCTL_VBATUGEN_Pos) /*!< SYS_T::IVSCTL: VBATUGEN Mask */ + +#define SYS_PORCTL_POROFF_Pos (0) /*!< SYS_T::PORCTL: POROFF Position */ +#define SYS_PORCTL_POROFF_Msk (0xfffful << SYS_PORCTL_POROFF_Pos) /*!< SYS_T::PORCTL: POROFF Mask */ + +#define SYS_VREFCTL_VREFCTL_Pos (0) /*!< SYS_T::VREFCTL: VREFCTL Position */ +#define SYS_VREFCTL_VREFCTL_Msk (0x1ful << SYS_VREFCTL_VREFCTL_Pos) /*!< SYS_T::VREFCTL: VREFCTL Mask */ + +#define SYS_VREFCTL_PRELOAD_SEL_Pos (6) /*!< SYS_T::VREFCTL: PRELOAD_SEL Position */ +#define SYS_VREFCTL_PRELOAD_SEL_Msk (0x3ul << SYS_VREFCTL_PRELOAD_SEL_Pos) /*!< SYS_T::VREFCTL: PRELOAD_SEL Mask */ + +#define SYS_USBPHY_USBROLE_Pos (0) /*!< SYS_T::USBPHY: USBROLE Position */ +#define SYS_USBPHY_USBROLE_Msk (0x3ul << SYS_USBPHY_USBROLE_Pos) /*!< SYS_T::USBPHY: USBROLE Mask */ + +#define SYS_USBPHY_SBO_Pos (2) /*!< SYS_T::USBPHY: SBO Position */ +#define SYS_USBPHY_SBO_Msk (0x1ul << SYS_USBPHY_SBO_Pos) /*!< SYS_T::USBPHY: SBO Mask */ + +#define SYS_USBPHY_USBEN_Pos (8) /*!< SYS_T::USBPHY: USBEN Position */ +#define SYS_USBPHY_USBEN_Msk (0x1ul << SYS_USBPHY_USBEN_Pos) /*!< SYS_T::USBPHY: USBEN Mask */ + +#define SYS_USBPHY_HSUSBROLE_Pos (16) /*!< SYS_T::USBPHY: HSUSBROLE Position */ +#define SYS_USBPHY_HSUSBROLE_Msk (0x3ul << SYS_USBPHY_HSUSBROLE_Pos) /*!< SYS_T::USBPHY: HSUSBROLE Mask */ + +#define SYS_USBPHY_HSUSBEN_Pos (24) /*!< SYS_T::USBPHY: HSUSBEN Position */ +#define SYS_USBPHY_HSUSBEN_Msk (0x1ul << SYS_USBPHY_HSUSBEN_Pos) /*!< SYS_T::USBPHY: HSUSBEN Mask */ + +#define SYS_USBPHY_HSUSBACT_Pos (25) /*!< SYS_T::USBPHY: HSUSBACT Position */ +#define SYS_USBPHY_HSUSBACT_Msk (0x1ul << SYS_USBPHY_HSUSBACT_Pos) /*!< SYS_T::USBPHY: HSUSBACT Mask */ + +#define SYS_GPA_MFPL_PA0MFP_Pos (0) /*!< SYS_T::GPA_MFPL: PA0MFP Position */ +#define SYS_GPA_MFPL_PA0MFP_Msk (0xful << SYS_GPA_MFPL_PA0MFP_Pos) /*!< SYS_T::GPA_MFPL: PA0MFP Mask */ + +#define SYS_GPA_MFPL_PA1MFP_Pos (4) /*!< SYS_T::GPA_MFPL: PA1MFP Position */ +#define SYS_GPA_MFPL_PA1MFP_Msk (0xful << SYS_GPA_MFPL_PA1MFP_Pos) /*!< SYS_T::GPA_MFPL: PA1MFP Mask */ + +#define SYS_GPA_MFPL_PA2MFP_Pos (8) /*!< SYS_T::GPA_MFPL: PA2MFP Position */ +#define SYS_GPA_MFPL_PA2MFP_Msk (0xful << SYS_GPA_MFPL_PA2MFP_Pos) /*!< SYS_T::GPA_MFPL: PA2MFP Mask */ + +#define SYS_GPA_MFPL_PA3MFP_Pos (12) /*!< SYS_T::GPA_MFPL: PA3MFP Position */ +#define SYS_GPA_MFPL_PA3MFP_Msk (0xful << SYS_GPA_MFPL_PA3MFP_Pos) /*!< SYS_T::GPA_MFPL: PA3MFP Mask */ + +#define SYS_GPA_MFPL_PA4MFP_Pos (16) /*!< SYS_T::GPA_MFPL: PA4MFP Position */ +#define SYS_GPA_MFPL_PA4MFP_Msk (0xful << SYS_GPA_MFPL_PA4MFP_Pos) /*!< SYS_T::GPA_MFPL: PA4MFP Mask */ + +#define SYS_GPA_MFPL_PA5MFP_Pos (20) /*!< SYS_T::GPA_MFPL: PA5MFP Position */ +#define SYS_GPA_MFPL_PA5MFP_Msk (0xful << SYS_GPA_MFPL_PA5MFP_Pos) /*!< SYS_T::GPA_MFPL: PA5MFP Mask */ + +#define SYS_GPA_MFPL_PA6MFP_Pos (24) /*!< SYS_T::GPA_MFPL: PA6MFP Position */ +#define SYS_GPA_MFPL_PA6MFP_Msk (0xful << SYS_GPA_MFPL_PA6MFP_Pos) /*!< SYS_T::GPA_MFPL: PA6MFP Mask */ + +#define SYS_GPA_MFPL_PA7MFP_Pos (28) /*!< SYS_T::GPA_MFPL: PA7MFP Position */ +#define SYS_GPA_MFPL_PA7MFP_Msk (0xful << SYS_GPA_MFPL_PA7MFP_Pos) /*!< SYS_T::GPA_MFPL: PA7MFP Mask */ + +#define SYS_GPA_MFPH_PA8MFP_Pos (0) /*!< SYS_T::GPA_MFPH: PA8MFP Position */ +#define SYS_GPA_MFPH_PA8MFP_Msk (0xful << SYS_GPA_MFPH_PA8MFP_Pos) /*!< SYS_T::GPA_MFPH: PA8MFP Mask */ + +#define SYS_GPA_MFPH_PA9MFP_Pos (4) /*!< SYS_T::GPA_MFPH: PA9MFP Position */ +#define SYS_GPA_MFPH_PA9MFP_Msk (0xful << SYS_GPA_MFPH_PA9MFP_Pos) /*!< SYS_T::GPA_MFPH: PA9MFP Mask */ + +#define SYS_GPA_MFPH_PA10MFP_Pos (8) /*!< SYS_T::GPA_MFPH: PA10MFP Position */ +#define SYS_GPA_MFPH_PA10MFP_Msk (0xful << SYS_GPA_MFPH_PA10MFP_Pos) /*!< SYS_T::GPA_MFPH: PA10MFP Mask */ + +#define SYS_GPA_MFPH_PA11MFP_Pos (12) /*!< SYS_T::GPA_MFPH: PA11MFP Position */ +#define SYS_GPA_MFPH_PA11MFP_Msk (0xful << SYS_GPA_MFPH_PA11MFP_Pos) /*!< SYS_T::GPA_MFPH: PA11MFP Mask */ + +#define SYS_GPA_MFPH_PA12MFP_Pos (16) /*!< SYS_T::GPA_MFPH: PA12MFP Position */ +#define SYS_GPA_MFPH_PA12MFP_Msk (0xful << SYS_GPA_MFPH_PA12MFP_Pos) /*!< SYS_T::GPA_MFPH: PA12MFP Mask */ + +#define SYS_GPA_MFPH_PA13MFP_Pos (20) /*!< SYS_T::GPA_MFPH: PA13MFP Position */ +#define SYS_GPA_MFPH_PA13MFP_Msk (0xful << SYS_GPA_MFPH_PA13MFP_Pos) /*!< SYS_T::GPA_MFPH: PA13MFP Mask */ + +#define SYS_GPA_MFPH_PA14MFP_Pos (24) /*!< SYS_T::GPA_MFPH: PA14MFP Position */ +#define SYS_GPA_MFPH_PA14MFP_Msk (0xful << SYS_GPA_MFPH_PA14MFP_Pos) /*!< SYS_T::GPA_MFPH: PA14MFP Mask */ + +#define SYS_GPA_MFPH_PA15MFP_Pos (28) /*!< SYS_T::GPA_MFPH: PA15MFP Position */ +#define SYS_GPA_MFPH_PA15MFP_Msk (0xful << SYS_GPA_MFPH_PA15MFP_Pos) /*!< SYS_T::GPA_MFPH: PA15MFP Mask */ + +#define SYS_GPB_MFPL_PB0MFP_Pos (0) /*!< SYS_T::GPB_MFPL: PB0MFP Position */ +#define SYS_GPB_MFPL_PB0MFP_Msk (0xful << SYS_GPB_MFPL_PB0MFP_Pos) /*!< SYS_T::GPB_MFPL: PB0MFP Mask */ + +#define SYS_GPB_MFPL_PB1MFP_Pos (4) /*!< SYS_T::GPB_MFPL: PB1MFP Position */ +#define SYS_GPB_MFPL_PB1MFP_Msk (0xful << SYS_GPB_MFPL_PB1MFP_Pos) /*!< SYS_T::GPB_MFPL: PB1MFP Mask */ + +#define SYS_GPB_MFPL_PB2MFP_Pos (8) /*!< SYS_T::GPB_MFPL: PB2MFP Position */ +#define SYS_GPB_MFPL_PB2MFP_Msk (0xful << SYS_GPB_MFPL_PB2MFP_Pos) /*!< SYS_T::GPB_MFPL: PB2MFP Mask */ + +#define SYS_GPB_MFPL_PB3MFP_Pos (12) /*!< SYS_T::GPB_MFPL: PB3MFP Position */ +#define SYS_GPB_MFPL_PB3MFP_Msk (0xful << SYS_GPB_MFPL_PB3MFP_Pos) /*!< SYS_T::GPB_MFPL: PB3MFP Mask */ + +#define SYS_GPB_MFPL_PB4MFP_Pos (16) /*!< SYS_T::GPB_MFPL: PB4MFP Position */ +#define SYS_GPB_MFPL_PB4MFP_Msk (0xful << SYS_GPB_MFPL_PB4MFP_Pos) /*!< SYS_T::GPB_MFPL: PB4MFP Mask */ + +#define SYS_GPB_MFPL_PB5MFP_Pos (20) /*!< SYS_T::GPB_MFPL: PB5MFP Position */ +#define SYS_GPB_MFPL_PB5MFP_Msk (0xful << SYS_GPB_MFPL_PB5MFP_Pos) /*!< SYS_T::GPB_MFPL: PB5MFP Mask */ + +#define SYS_GPB_MFPL_PB6MFP_Pos (24) /*!< SYS_T::GPB_MFPL: PB6MFP Position */ +#define SYS_GPB_MFPL_PB6MFP_Msk (0xful << SYS_GPB_MFPL_PB6MFP_Pos) /*!< SYS_T::GPB_MFPL: PB6MFP Mask */ + +#define SYS_GPB_MFPL_PB7MFP_Pos (28) /*!< SYS_T::GPB_MFPL: PB7MFP Position */ +#define SYS_GPB_MFPL_PB7MFP_Msk (0xful << SYS_GPB_MFPL_PB7MFP_Pos) /*!< SYS_T::GPB_MFPL: PB7MFP Mask */ + +#define SYS_GPB_MFPH_PB8MFP_Pos (0) /*!< SYS_T::GPB_MFPH: PB8MFP Position */ +#define SYS_GPB_MFPH_PB8MFP_Msk (0xful << SYS_GPB_MFPH_PB8MFP_Pos) /*!< SYS_T::GPB_MFPH: PB8MFP Mask */ + +#define SYS_GPB_MFPH_PB9MFP_Pos (4) /*!< SYS_T::GPB_MFPH: PB9MFP Position */ +#define SYS_GPB_MFPH_PB9MFP_Msk (0xful << SYS_GPB_MFPH_PB9MFP_Pos) /*!< SYS_T::GPB_MFPH: PB9MFP Mask */ + +#define SYS_GPB_MFPH_PB10MFP_Pos (8) /*!< SYS_T::GPB_MFPH: PB10MFP Position */ +#define SYS_GPB_MFPH_PB10MFP_Msk (0xful << SYS_GPB_MFPH_PB10MFP_Pos) /*!< SYS_T::GPB_MFPH: PB10MFP Mask */ + +#define SYS_GPB_MFPH_PB11MFP_Pos (12) /*!< SYS_T::GPB_MFPH: PB11MFP Position */ +#define SYS_GPB_MFPH_PB11MFP_Msk (0xful << SYS_GPB_MFPH_PB11MFP_Pos) /*!< SYS_T::GPB_MFPH: PB11MFP Mask */ + +#define SYS_GPB_MFPH_PB12MFP_Pos (16) /*!< SYS_T::GPB_MFPH: PB12MFP Position */ +#define SYS_GPB_MFPH_PB12MFP_Msk (0xful << SYS_GPB_MFPH_PB12MFP_Pos) /*!< SYS_T::GPB_MFPH: PB12MFP Mask */ + +#define SYS_GPB_MFPH_PB13MFP_Pos (20) /*!< SYS_T::GPB_MFPH: PB13MFP Position */ +#define SYS_GPB_MFPH_PB13MFP_Msk (0xful << SYS_GPB_MFPH_PB13MFP_Pos) /*!< SYS_T::GPB_MFPH: PB13MFP Mask */ + +#define SYS_GPB_MFPH_PB14MFP_Pos (24) /*!< SYS_T::GPB_MFPH: PB14MFP Position */ +#define SYS_GPB_MFPH_PB14MFP_Msk (0xful << SYS_GPB_MFPH_PB14MFP_Pos) /*!< SYS_T::GPB_MFPH: PB14MFP Mask */ + +#define SYS_GPB_MFPH_PB15MFP_Pos (28) /*!< SYS_T::GPB_MFPH: PB15MFP Position */ +#define SYS_GPB_MFPH_PB15MFP_Msk (0xful << SYS_GPB_MFPH_PB15MFP_Pos) /*!< SYS_T::GPB_MFPH: PB15MFP Mask */ + +#define SYS_GPC_MFPL_PC0MFP_Pos (0) /*!< SYS_T::GPC_MFPL: PC0MFP Position */ +#define SYS_GPC_MFPL_PC0MFP_Msk (0xful << SYS_GPC_MFPL_PC0MFP_Pos) /*!< SYS_T::GPC_MFPL: PC0MFP Mask */ + +#define SYS_GPC_MFPL_PC1MFP_Pos (4) /*!< SYS_T::GPC_MFPL: PC1MFP Position */ +#define SYS_GPC_MFPL_PC1MFP_Msk (0xful << SYS_GPC_MFPL_PC1MFP_Pos) /*!< SYS_T::GPC_MFPL: PC1MFP Mask */ + +#define SYS_GPC_MFPL_PC2MFP_Pos (8) /*!< SYS_T::GPC_MFPL: PC2MFP Position */ +#define SYS_GPC_MFPL_PC2MFP_Msk (0xful << SYS_GPC_MFPL_PC2MFP_Pos) /*!< SYS_T::GPC_MFPL: PC2MFP Mask */ + +#define SYS_GPC_MFPL_PC3MFP_Pos (12) /*!< SYS_T::GPC_MFPL: PC3MFP Position */ +#define SYS_GPC_MFPL_PC3MFP_Msk (0xful << SYS_GPC_MFPL_PC3MFP_Pos) /*!< SYS_T::GPC_MFPL: PC3MFP Mask */ + +#define SYS_GPC_MFPL_PC4MFP_Pos (16) /*!< SYS_T::GPC_MFPL: PC4MFP Position */ +#define SYS_GPC_MFPL_PC4MFP_Msk (0xful << SYS_GPC_MFPL_PC4MFP_Pos) /*!< SYS_T::GPC_MFPL: PC4MFP Mask */ + +#define SYS_GPC_MFPL_PC5MFP_Pos (20) /*!< SYS_T::GPC_MFPL: PC5MFP Position */ +#define SYS_GPC_MFPL_PC5MFP_Msk (0xful << SYS_GPC_MFPL_PC5MFP_Pos) /*!< SYS_T::GPC_MFPL: PC5MFP Mask */ + +#define SYS_GPC_MFPL_PC6MFP_Pos (24) /*!< SYS_T::GPC_MFPL: PC6MFP Position */ +#define SYS_GPC_MFPL_PC6MFP_Msk (0xful << SYS_GPC_MFPL_PC6MFP_Pos) /*!< SYS_T::GPC_MFPL: PC6MFP Mask */ + +#define SYS_GPC_MFPL_PC7MFP_Pos (28) /*!< SYS_T::GPC_MFPL: PC7MFP Position */ +#define SYS_GPC_MFPL_PC7MFP_Msk (0xful << SYS_GPC_MFPL_PC7MFP_Pos) /*!< SYS_T::GPC_MFPL: PC7MFP Mask */ + +#define SYS_GPC_MFPH_PC8MFP_Pos (0) /*!< SYS_T::GPC_MFPH: PC8MFP Position */ +#define SYS_GPC_MFPH_PC8MFP_Msk (0xful << SYS_GPC_MFPH_PC8MFP_Pos) /*!< SYS_T::GPC_MFPH: PC8MFP Mask */ + +#define SYS_GPC_MFPH_PC9MFP_Pos (4) /*!< SYS_T::GPC_MFPH: PC9MFP Position */ +#define SYS_GPC_MFPH_PC9MFP_Msk (0xful << SYS_GPC_MFPH_PC9MFP_Pos) /*!< SYS_T::GPC_MFPH: PC9MFP Mask */ + +#define SYS_GPC_MFPH_PC10MFP_Pos (8) /*!< SYS_T::GPC_MFPH: PC10MFP Position */ +#define SYS_GPC_MFPH_PC10MFP_Msk (0xful << SYS_GPC_MFPH_PC10MFP_Pos) /*!< SYS_T::GPC_MFPH: PC10MFP Mask */ + +#define SYS_GPC_MFPH_PC11MFP_Pos (12) /*!< SYS_T::GPC_MFPH: PC11MFP Position */ +#define SYS_GPC_MFPH_PC11MFP_Msk (0xful << SYS_GPC_MFPH_PC11MFP_Pos) /*!< SYS_T::GPC_MFPH: PC11MFP Mask */ + +#define SYS_GPC_MFPH_PC12MFP_Pos (16) /*!< SYS_T::GPC_MFPH: PC12MFP Position */ +#define SYS_GPC_MFPH_PC12MFP_Msk (0xful << SYS_GPC_MFPH_PC12MFP_Pos) /*!< SYS_T::GPC_MFPH: PC12MFP Mask */ + +#define SYS_GPC_MFPH_PC13MFP_Pos (20) /*!< SYS_T::GPC_MFPH: PC13MFP Position */ +#define SYS_GPC_MFPH_PC13MFP_Msk (0xful << SYS_GPC_MFPH_PC13MFP_Pos) /*!< SYS_T::GPC_MFPH: PC13MFP Mask */ + +#define SYS_GPC_MFPH_PC14MFP_Pos (24) /*!< SYS_T::GPC_MFPH: PC14MFP Position */ +#define SYS_GPC_MFPH_PC14MFP_Msk (0xful << SYS_GPC_MFPH_PC14MFP_Pos) /*!< SYS_T::GPC_MFPH: PC14MFP Mask */ + +#define SYS_GPC_MFPH_PC15MFP_Pos (28) /*!< SYS_T::GPC_MFPH: PC15MFP Position */ +#define SYS_GPC_MFPH_PC15MFP_Msk (0xful << SYS_GPC_MFPH_PC15MFP_Pos) /*!< SYS_T::GPC_MFPH: PC15MFP Mask */ + +#define SYS_GPD_MFPL_PD0MFP_Pos (0) /*!< SYS_T::GPD_MFPL: PD0MFP Position */ +#define SYS_GPD_MFPL_PD0MFP_Msk (0xful << SYS_GPD_MFPL_PD0MFP_Pos) /*!< SYS_T::GPD_MFPL: PD0MFP Mask */ + +#define SYS_GPD_MFPL_PD1MFP_Pos (4) /*!< SYS_T::GPD_MFPL: PD1MFP Position */ +#define SYS_GPD_MFPL_PD1MFP_Msk (0xful << SYS_GPD_MFPL_PD1MFP_Pos) /*!< SYS_T::GPD_MFPL: PD1MFP Mask */ + +#define SYS_GPD_MFPL_PD2MFP_Pos (8) /*!< SYS_T::GPD_MFPL: PD2MFP Position */ +#define SYS_GPD_MFPL_PD2MFP_Msk (0xful << SYS_GPD_MFPL_PD2MFP_Pos) /*!< SYS_T::GPD_MFPL: PD2MFP Mask */ + +#define SYS_GPD_MFPL_PD3MFP_Pos (12) /*!< SYS_T::GPD_MFPL: PD3MFP Position */ +#define SYS_GPD_MFPL_PD3MFP_Msk (0xful << SYS_GPD_MFPL_PD3MFP_Pos) /*!< SYS_T::GPD_MFPL: PD3MFP Mask */ + +#define SYS_GPD_MFPL_PD4MFP_Pos (16) /*!< SYS_T::GPD_MFPL: PD4MFP Position */ +#define SYS_GPD_MFPL_PD4MFP_Msk (0xful << SYS_GPD_MFPL_PD4MFP_Pos) /*!< SYS_T::GPD_MFPL: PD4MFP Mask */ + +#define SYS_GPD_MFPL_PD5MFP_Pos (20) /*!< SYS_T::GPD_MFPL: PD5MFP Position */ +#define SYS_GPD_MFPL_PD5MFP_Msk (0xful << SYS_GPD_MFPL_PD5MFP_Pos) /*!< SYS_T::GPD_MFPL: PD5MFP Mask */ + +#define SYS_GPD_MFPL_PD6MFP_Pos (24) /*!< SYS_T::GPD_MFPL: PD6MFP Position */ +#define SYS_GPD_MFPL_PD6MFP_Msk (0xful << SYS_GPD_MFPL_PD6MFP_Pos) /*!< SYS_T::GPD_MFPL: PD6MFP Mask */ + +#define SYS_GPD_MFPL_PD7MFP_Pos (28) /*!< SYS_T::GPD_MFPL: PD7MFP Position */ +#define SYS_GPD_MFPL_PD7MFP_Msk (0xful << SYS_GPD_MFPL_PD7MFP_Pos) /*!< SYS_T::GPD_MFPL: PD7MFP Mask */ + +#define SYS_GPD_MFPH_PD8MFP_Pos (0) /*!< SYS_T::GPD_MFPH: PD8MFP Position */ +#define SYS_GPD_MFPH_PD8MFP_Msk (0xful << SYS_GPD_MFPH_PD8MFP_Pos) /*!< SYS_T::GPD_MFPH: PD8MFP Mask */ + +#define SYS_GPD_MFPH_PD9MFP_Pos (4) /*!< SYS_T::GPD_MFPH: PD9MFP Position */ +#define SYS_GPD_MFPH_PD9MFP_Msk (0xful << SYS_GPD_MFPH_PD9MFP_Pos) /*!< SYS_T::GPD_MFPH: PD9MFP Mask */ + +#define SYS_GPD_MFPH_PD10MFP_Pos (8) /*!< SYS_T::GPD_MFPH: PD10MFP Position */ +#define SYS_GPD_MFPH_PD10MFP_Msk (0xful << SYS_GPD_MFPH_PD10MFP_Pos) /*!< SYS_T::GPD_MFPH: PD10MFP Mask */ + +#define SYS_GPD_MFPH_PD11MFP_Pos (12) /*!< SYS_T::GPD_MFPH: PD11MFP Position */ +#define SYS_GPD_MFPH_PD11MFP_Msk (0xful << SYS_GPD_MFPH_PD11MFP_Pos) /*!< SYS_T::GPD_MFPH: PD11MFP Mask */ + +#define SYS_GPD_MFPH_PD12MFP_Pos (16) /*!< SYS_T::GPD_MFPH: PD12MFP Position */ +#define SYS_GPD_MFPH_PD12MFP_Msk (0xful << SYS_GPD_MFPH_PD12MFP_Pos) /*!< SYS_T::GPD_MFPH: PD12MFP Mask */ + +#define SYS_GPD_MFPH_PD13MFP_Pos (20) /*!< SYS_T::GPD_MFPH: PD13MFP Position */ +#define SYS_GPD_MFPH_PD13MFP_Msk (0xful << SYS_GPD_MFPH_PD13MFP_Pos) /*!< SYS_T::GPD_MFPH: PD13MFP Mask */ + +#define SYS_GPD_MFPH_PD14MFP_Pos (24) /*!< SYS_T::GPD_MFPH: PD14MFP Position */ +#define SYS_GPD_MFPH_PD14MFP_Msk (0xful << SYS_GPD_MFPH_PD14MFP_Pos) /*!< SYS_T::GPD_MFPH: PD14MFP Mask */ + +#define SYS_GPD_MFPH_PD15MFP_Pos (28) /*!< SYS_T::GPD_MFPH: PD15MFP Position */ +#define SYS_GPD_MFPH_PD15MFP_Msk (0xful << SYS_GPD_MFPH_PD15MFP_Pos) /*!< SYS_T::GPD_MFPH: PD15MFP Mask */ + +#define SYS_GPE_MFPL_PE0MFP_Pos (0) /*!< SYS_T::GPE_MFPL: PE0MFP Position */ +#define SYS_GPE_MFPL_PE0MFP_Msk (0xful << SYS_GPE_MFPL_PE0MFP_Pos) /*!< SYS_T::GPE_MFPL: PE0MFP Mask */ + +#define SYS_GPE_MFPL_PE1MFP_Pos (4) /*!< SYS_T::GPE_MFPL: PE1MFP Position */ +#define SYS_GPE_MFPL_PE1MFP_Msk (0xful << SYS_GPE_MFPL_PE1MFP_Pos) /*!< SYS_T::GPE_MFPL: PE1MFP Mask */ + +#define SYS_GPE_MFPL_PE2MFP_Pos (8) /*!< SYS_T::GPE_MFPL: PE2MFP Position */ +#define SYS_GPE_MFPL_PE2MFP_Msk (0xful << SYS_GPE_MFPL_PE2MFP_Pos) /*!< SYS_T::GPE_MFPL: PE2MFP Mask */ + +#define SYS_GPE_MFPL_PE3MFP_Pos (12) /*!< SYS_T::GPE_MFPL: PE3MFP Position */ +#define SYS_GPE_MFPL_PE3MFP_Msk (0xful << SYS_GPE_MFPL_PE3MFP_Pos) /*!< SYS_T::GPE_MFPL: PE3MFP Mask */ + +#define SYS_GPE_MFPL_PE4MFP_Pos (16) /*!< SYS_T::GPE_MFPL: PE4MFP Position */ +#define SYS_GPE_MFPL_PE4MFP_Msk (0xful << SYS_GPE_MFPL_PE4MFP_Pos) /*!< SYS_T::GPE_MFPL: PE4MFP Mask */ + +#define SYS_GPE_MFPL_PE5MFP_Pos (20) /*!< SYS_T::GPE_MFPL: PE5MFP Position */ +#define SYS_GPE_MFPL_PE5MFP_Msk (0xful << SYS_GPE_MFPL_PE5MFP_Pos) /*!< SYS_T::GPE_MFPL: PE5MFP Mask */ + +#define SYS_GPE_MFPL_PE6MFP_Pos (24) /*!< SYS_T::GPE_MFPL: PE6MFP Position */ +#define SYS_GPE_MFPL_PE6MFP_Msk (0xful << SYS_GPE_MFPL_PE6MFP_Pos) /*!< SYS_T::GPE_MFPL: PE6MFP Mask */ + +#define SYS_GPE_MFPL_PE7MFP_Pos (28) /*!< SYS_T::GPE_MFPL: PE7MFP Position */ +#define SYS_GPE_MFPL_PE7MFP_Msk (0xful << SYS_GPE_MFPL_PE7MFP_Pos) /*!< SYS_T::GPE_MFPL: PE7MFP Mask */ + +#define SYS_GPE_MFPH_PE8MFP_Pos (0) /*!< SYS_T::GPE_MFPH: PE8MFP Position */ +#define SYS_GPE_MFPH_PE8MFP_Msk (0xful << SYS_GPE_MFPH_PE8MFP_Pos) /*!< SYS_T::GPE_MFPH: PE8MFP Mask */ + +#define SYS_GPE_MFPH_PE9MFP_Pos (4) /*!< SYS_T::GPE_MFPH: PE9MFP Position */ +#define SYS_GPE_MFPH_PE9MFP_Msk (0xful << SYS_GPE_MFPH_PE9MFP_Pos) /*!< SYS_T::GPE_MFPH: PE9MFP Mask */ + +#define SYS_GPE_MFPH_PE10MFP_Pos (8) /*!< SYS_T::GPE_MFPH: PE10MFP Position */ +#define SYS_GPE_MFPH_PE10MFP_Msk (0xful << SYS_GPE_MFPH_PE10MFP_Pos) /*!< SYS_T::GPE_MFPH: PE10MFP Mask */ + +#define SYS_GPE_MFPH_PE11MFP_Pos (12) /*!< SYS_T::GPE_MFPH: PE11MFP Position */ +#define SYS_GPE_MFPH_PE11MFP_Msk (0xful << SYS_GPE_MFPH_PE11MFP_Pos) /*!< SYS_T::GPE_MFPH: PE11MFP Mask */ + +#define SYS_GPE_MFPH_PE12MFP_Pos (16) /*!< SYS_T::GPE_MFPH: PE12MFP Position */ +#define SYS_GPE_MFPH_PE12MFP_Msk (0xful << SYS_GPE_MFPH_PE12MFP_Pos) /*!< SYS_T::GPE_MFPH: PE12MFP Mask */ + +#define SYS_GPE_MFPH_PE13MFP_Pos (20) /*!< SYS_T::GPE_MFPH: PE13MFP Position */ +#define SYS_GPE_MFPH_PE13MFP_Msk (0xful << SYS_GPE_MFPH_PE13MFP_Pos) /*!< SYS_T::GPE_MFPH: PE13MFP Mask */ + +#define SYS_GPE_MFPH_PE14MFP_Pos (24) /*!< SYS_T::GPE_MFPH: PE14MFP Position */ +#define SYS_GPE_MFPH_PE14MFP_Msk (0xful << SYS_GPE_MFPH_PE14MFP_Pos) /*!< SYS_T::GPE_MFPH: PE14MFP Mask */ + +#define SYS_GPE_MFPH_PE15MFP_Pos (28) /*!< SYS_T::GPE_MFPH: PE15MFP Position */ +#define SYS_GPE_MFPH_PE15MFP_Msk (0xful << SYS_GPE_MFPH_PE15MFP_Pos) /*!< SYS_T::GPE_MFPH: PE15MFP Mask */ + +#define SYS_GPF_MFPL_PF0MFP_Pos (0) /*!< SYS_T::GPF_MFPL: PF0MFP Position */ +#define SYS_GPF_MFPL_PF0MFP_Msk (0xful << SYS_GPF_MFPL_PF0MFP_Pos) /*!< SYS_T::GPF_MFPL: PF0MFP Mask */ + +#define SYS_GPF_MFPL_PF1MFP_Pos (4) /*!< SYS_T::GPF_MFPL: PF1MFP Position */ +#define SYS_GPF_MFPL_PF1MFP_Msk (0xful << SYS_GPF_MFPL_PF1MFP_Pos) /*!< SYS_T::GPF_MFPL: PF1MFP Mask */ + +#define SYS_GPF_MFPL_PF2MFP_Pos (8) /*!< SYS_T::GPF_MFPL: PF2MFP Position */ +#define SYS_GPF_MFPL_PF2MFP_Msk (0xful << SYS_GPF_MFPL_PF2MFP_Pos) /*!< SYS_T::GPF_MFPL: PF2MFP Mask */ + +#define SYS_GPF_MFPL_PF3MFP_Pos (12) /*!< SYS_T::GPF_MFPL: PF3MFP Position */ +#define SYS_GPF_MFPL_PF3MFP_Msk (0xful << SYS_GPF_MFPL_PF3MFP_Pos) /*!< SYS_T::GPF_MFPL: PF3MFP Mask */ + +#define SYS_GPF_MFPL_PF4MFP_Pos (16) /*!< SYS_T::GPF_MFPL: PF4MFP Position */ +#define SYS_GPF_MFPL_PF4MFP_Msk (0xful << SYS_GPF_MFPL_PF4MFP_Pos) /*!< SYS_T::GPF_MFPL: PF4MFP Mask */ + +#define SYS_GPF_MFPL_PF5MFP_Pos (20) /*!< SYS_T::GPF_MFPL: PF5MFP Position */ +#define SYS_GPF_MFPL_PF5MFP_Msk (0xful << SYS_GPF_MFPL_PF5MFP_Pos) /*!< SYS_T::GPF_MFPL: PF5MFP Mask */ + +#define SYS_GPF_MFPL_PF6MFP_Pos (24) /*!< SYS_T::GPF_MFPL: PF6MFP Position */ +#define SYS_GPF_MFPL_PF6MFP_Msk (0xful << SYS_GPF_MFPL_PF6MFP_Pos) /*!< SYS_T::GPF_MFPL: PF6MFP Mask */ + +#define SYS_GPF_MFPL_PF7MFP_Pos (28) /*!< SYS_T::GPF_MFPL: PF7MFP Position */ +#define SYS_GPF_MFPL_PF7MFP_Msk (0xful << SYS_GPF_MFPL_PF7MFP_Pos) /*!< SYS_T::GPF_MFPL: PF7MFP Mask */ + +#define SYS_GPF_MFPH_PF8MFP_Pos (0) /*!< SYS_T::GPF_MFPH: PF8MFP Position */ +#define SYS_GPF_MFPH_PF8MFP_Msk (0xful << SYS_GPF_MFPH_PF8MFP_Pos) /*!< SYS_T::GPF_MFPH: PF8MFP Mask */ + +#define SYS_GPF_MFPH_PF9MFP_Pos (4) /*!< SYS_T::GPF_MFPH: PF9MFP Position */ +#define SYS_GPF_MFPH_PF9MFP_Msk (0xful << SYS_GPF_MFPH_PF9MFP_Pos) /*!< SYS_T::GPF_MFPH: PF9MFP Mask */ + +#define SYS_GPF_MFPH_PF10MFP_Pos (8) /*!< SYS_T::GPF_MFPH: PF10MFP Position */ +#define SYS_GPF_MFPH_PF10MFP_Msk (0xful << SYS_GPF_MFPH_PF10MFP_Pos) /*!< SYS_T::GPF_MFPH: PF10MFP Mask */ + +#define SYS_GPF_MFPH_PF11MFP_Pos (12) /*!< SYS_T::GPF_MFPH: PF11MFP Position */ +#define SYS_GPF_MFPH_PF11MFP_Msk (0xful << SYS_GPF_MFPH_PF11MFP_Pos) /*!< SYS_T::GPF_MFPH: PF11MFP Mask */ + +#define SYS_GPF_MFPH_PF12MFP_Pos (16) /*!< SYS_T::GPF_MFPH: PF12MFP Position */ +#define SYS_GPF_MFPH_PF12MFP_Msk (0xful << SYS_GPF_MFPH_PF12MFP_Pos) /*!< SYS_T::GPF_MFPH: PF12MFP Mask */ + +#define SYS_GPF_MFPH_PF13MFP_Pos (20) /*!< SYS_T::GPF_MFPH: PF13MFP Position */ +#define SYS_GPF_MFPH_PF13MFP_Msk (0xful << SYS_GPF_MFPH_PF13MFP_Pos) /*!< SYS_T::GPF_MFPH: PF13MFP Mask */ + +#define SYS_GPF_MFPH_PF14MFP_Pos (24) /*!< SYS_T::GPF_MFPH: PF14MFP Position */ +#define SYS_GPF_MFPH_PF14MFP_Msk (0xful << SYS_GPF_MFPH_PF14MFP_Pos) /*!< SYS_T::GPF_MFPH: PF14MFP Mask */ + +#define SYS_GPF_MFPH_PF15MFP_Pos (28) /*!< SYS_T::GPF_MFPH: PF15MFP Position */ +#define SYS_GPF_MFPH_PF15MFP_Msk (0xful << SYS_GPF_MFPH_PF15MFP_Pos) /*!< SYS_T::GPF_MFPH: PF15MFP Mask */ + +#define SYS_GPG_MFPL_PG0MFP_Pos (0) /*!< SYS_T::GPG_MFPL: PG0MFP Position */ +#define SYS_GPG_MFPL_PG0MFP_Msk (0xful << SYS_GPG_MFPL_PG0MFP_Pos) /*!< SYS_T::GPG_MFPL: PG0MFP Mask */ + +#define SYS_GPG_MFPL_PG1MFP_Pos (4) /*!< SYS_T::GPG_MFPL: PG1MFP Position */ +#define SYS_GPG_MFPL_PG1MFP_Msk (0xful << SYS_GPG_MFPL_PG1MFP_Pos) /*!< SYS_T::GPG_MFPL: PG1MFP Mask */ + +#define SYS_GPG_MFPL_PG2MFP_Pos (8) /*!< SYS_T::GPG_MFPL: PG2MFP Position */ +#define SYS_GPG_MFPL_PG2MFP_Msk (0xful << SYS_GPG_MFPL_PG2MFP_Pos) /*!< SYS_T::GPG_MFPL: PG2MFP Mask */ + +#define SYS_GPG_MFPL_PG3MFP_Pos (12) /*!< SYS_T::GPG_MFPL: PG3MFP Position */ +#define SYS_GPG_MFPL_PG3MFP_Msk (0xful << SYS_GPG_MFPL_PG3MFP_Pos) /*!< SYS_T::GPG_MFPL: PG3MFP Mask */ + +#define SYS_GPG_MFPL_PG4MFP_Pos (16) /*!< SYS_T::GPG_MFPL: PG4MFP Position */ +#define SYS_GPG_MFPL_PG4MFP_Msk (0xful << SYS_GPG_MFPL_PG4MFP_Pos) /*!< SYS_T::GPG_MFPL: PG4MFP Mask */ + +#define SYS_GPG_MFPL_PG5MFP_Pos (20) /*!< SYS_T::GPG_MFPL: PG5MFP Position */ +#define SYS_GPG_MFPL_PG5MFP_Msk (0xful << SYS_GPG_MFPL_PG5MFP_Pos) /*!< SYS_T::GPG_MFPL: PG5MFP Mask */ + +#define SYS_GPG_MFPL_PG6MFP_Pos (24) /*!< SYS_T::GPG_MFPL: PG6MFP Position */ +#define SYS_GPG_MFPL_PG6MFP_Msk (0xful << SYS_GPG_MFPL_PG6MFP_Pos) /*!< SYS_T::GPG_MFPL: PG6MFP Mask */ + +#define SYS_GPG_MFPL_PG7MFP_Pos (28) /*!< SYS_T::GPG_MFPL: PG7MFP Position */ +#define SYS_GPG_MFPL_PG7MFP_Msk (0xful << SYS_GPG_MFPL_PG7MFP_Pos) /*!< SYS_T::GPG_MFPL: PG7MFP Mask */ + +#define SYS_GPG_MFPH_PG8MFP_Pos (0) /*!< SYS_T::GPG_MFPH: PG8MFP Position */ +#define SYS_GPG_MFPH_PG8MFP_Msk (0xful << SYS_GPG_MFPH_PG8MFP_Pos) /*!< SYS_T::GPG_MFPH: PG8MFP Mask */ + +#define SYS_GPG_MFPH_PG9MFP_Pos (4) /*!< SYS_T::GPG_MFPH: PG9MFP Position */ +#define SYS_GPG_MFPH_PG9MFP_Msk (0xful << SYS_GPG_MFPH_PG9MFP_Pos) /*!< SYS_T::GPG_MFPH: PG9MFP Mask */ + +#define SYS_GPG_MFPH_PG10MFP_Pos (8) /*!< SYS_T::GPG_MFPH: PG10MFP Position */ +#define SYS_GPG_MFPH_PG10MFP_Msk (0xful << SYS_GPG_MFPH_PG10MFP_Pos) /*!< SYS_T::GPG_MFPH: PG10MFP Mask */ + +#define SYS_GPG_MFPH_PG11MFP_Pos (12) /*!< SYS_T::GPG_MFPH: PG11MFP Position */ +#define SYS_GPG_MFPH_PG11MFP_Msk (0xful << SYS_GPG_MFPH_PG11MFP_Pos) /*!< SYS_T::GPG_MFPH: PG11MFP Mask */ + +#define SYS_GPG_MFPH_PG12MFP_Pos (16) /*!< SYS_T::GPG_MFPH: PG12MFP Position */ +#define SYS_GPG_MFPH_PG12MFP_Msk (0xful << SYS_GPG_MFPH_PG12MFP_Pos) /*!< SYS_T::GPG_MFPH: PG12MFP Mask */ + +#define SYS_GPG_MFPH_PG13MFP_Pos (20) /*!< SYS_T::GPG_MFPH: PG13MFP Position */ +#define SYS_GPG_MFPH_PG13MFP_Msk (0xful << SYS_GPG_MFPH_PG13MFP_Pos) /*!< SYS_T::GPG_MFPH: PG13MFP Mask */ + +#define SYS_GPG_MFPH_PG14MFP_Pos (24) /*!< SYS_T::GPG_MFPH: PG14MFP Position */ +#define SYS_GPG_MFPH_PG14MFP_Msk (0xful << SYS_GPG_MFPH_PG14MFP_Pos) /*!< SYS_T::GPG_MFPH: PG14MFP Mask */ + +#define SYS_GPG_MFPH_PG15MFP_Pos (28) /*!< SYS_T::GPG_MFPH: PG15MFP Position */ +#define SYS_GPG_MFPH_PG15MFP_Msk (0xful << SYS_GPG_MFPH_PG15MFP_Pos) /*!< SYS_T::GPG_MFPH: PG15MFP Mask */ + +#define SYS_GPH_MFPL_PH0MFP_Pos (0) /*!< SYS_T::GPH_MFPL: PH0MFP Position */ +#define SYS_GPH_MFPL_PH0MFP_Msk (0xful << SYS_GPH_MFPL_PH0MFP_Pos) /*!< SYS_T::GPH_MFPL: PH0MFP Mask */ + +#define SYS_GPH_MFPL_PH1MFP_Pos (4) /*!< SYS_T::GPH_MFPL: PH1MFP Position */ +#define SYS_GPH_MFPL_PH1MFP_Msk (0xful << SYS_GPH_MFPL_PH1MFP_Pos) /*!< SYS_T::GPH_MFPL: PH1MFP Mask */ + +#define SYS_GPH_MFPL_PH2MFP_Pos (8) /*!< SYS_T::GPH_MFPL: PH2MFP Position */ +#define SYS_GPH_MFPL_PH2MFP_Msk (0xful << SYS_GPH_MFPL_PH2MFP_Pos) /*!< SYS_T::GPH_MFPL: PH2MFP Mask */ + +#define SYS_GPH_MFPL_PH3MFP_Pos (12) /*!< SYS_T::GPH_MFPL: PH3MFP Position */ +#define SYS_GPH_MFPL_PH3MFP_Msk (0xful << SYS_GPH_MFPL_PH3MFP_Pos) /*!< SYS_T::GPH_MFPL: PH3MFP Mask */ + +#define SYS_GPH_MFPL_PH4MFP_Pos (16) /*!< SYS_T::GPH_MFPL: PH4MFP Position */ +#define SYS_GPH_MFPL_PH4MFP_Msk (0xful << SYS_GPH_MFPL_PH4MFP_Pos) /*!< SYS_T::GPH_MFPL: PH4MFP Mask */ + +#define SYS_GPH_MFPL_PH5MFP_Pos (20) /*!< SYS_T::GPH_MFPL: PH5MFP Position */ +#define SYS_GPH_MFPL_PH5MFP_Msk (0xful << SYS_GPH_MFPL_PH5MFP_Pos) /*!< SYS_T::GPH_MFPL: PH5MFP Mask */ + +#define SYS_GPH_MFPL_PH6MFP_Pos (24) /*!< SYS_T::GPH_MFPL: PH6MFP Position */ +#define SYS_GPH_MFPL_PH6MFP_Msk (0xful << SYS_GPH_MFPL_PH6MFP_Pos) /*!< SYS_T::GPH_MFPL: PH6MFP Mask */ + +#define SYS_GPH_MFPL_PH7MFP_Pos (28) /*!< SYS_T::GPH_MFPL: PH7MFP Position */ +#define SYS_GPH_MFPL_PH7MFP_Msk (0xful << SYS_GPH_MFPL_PH7MFP_Pos) /*!< SYS_T::GPH_MFPL: PH7MFP Mask */ + +#define SYS_GPH_MFPH_PH8MFP_Pos (0) /*!< SYS_T::GPH_MFPH: PH8MFP Position */ +#define SYS_GPH_MFPH_PH8MFP_Msk (0xful << SYS_GPH_MFPH_PH8MFP_Pos) /*!< SYS_T::GPH_MFPH: PH8MFP Mask */ + +#define SYS_GPH_MFPH_PH9MFP_Pos (4) /*!< SYS_T::GPH_MFPH: PH9MFP Position */ +#define SYS_GPH_MFPH_PH9MFP_Msk (0xful << SYS_GPH_MFPH_PH9MFP_Pos) /*!< SYS_T::GPH_MFPH: PH9MFP Mask */ + +#define SYS_GPH_MFPH_PH10MFP_Pos (8) /*!< SYS_T::GPH_MFPH: PH10MFP Position */ +#define SYS_GPH_MFPH_PH10MFP_Msk (0xful << SYS_GPH_MFPH_PH10MFP_Pos) /*!< SYS_T::GPH_MFPH: PH10MFP Mask */ + +#define SYS_GPH_MFPH_PH11MFP_Pos (12) /*!< SYS_T::GPH_MFPH: PH11MFP Position */ +#define SYS_GPH_MFPH_PH11MFP_Msk (0xful << SYS_GPH_MFPH_PH11MFP_Pos) /*!< SYS_T::GPH_MFPH: PH11MFP Mask */ + +#define SYS_GPH_MFPH_PH12MFP_Pos (16) /*!< SYS_T::GPH_MFPH: PH12MFP Position */ +#define SYS_GPH_MFPH_PH12MFP_Msk (0xful << SYS_GPH_MFPH_PH12MFP_Pos) /*!< SYS_T::GPH_MFPH: PH12MFP Mask */ + +#define SYS_GPH_MFPH_PH13MFP_Pos (20) /*!< SYS_T::GPH_MFPH: PH13MFP Position */ +#define SYS_GPH_MFPH_PH13MFP_Msk (0xful << SYS_GPH_MFPH_PH13MFP_Pos) /*!< SYS_T::GPH_MFPH: PH13MFP Mask */ + +#define SYS_GPH_MFPH_PH14MFP_Pos (24) /*!< SYS_T::GPH_MFPH: PH14MFP Position */ +#define SYS_GPH_MFPH_PH14MFP_Msk (0xful << SYS_GPH_MFPH_PH14MFP_Pos) /*!< SYS_T::GPH_MFPH: PH14MFP Mask */ + +#define SYS_GPH_MFPH_PH15MFP_Pos (28) /*!< SYS_T::GPH_MFPH: PH15MFP Position */ +#define SYS_GPH_MFPH_PH15MFP_Msk (0xful << SYS_GPH_MFPH_PH15MFP_Pos) /*!< SYS_T::GPH_MFPH: PH15MFP Mask */ + +#define SYS_GPA_MFOS_MFOS0_Pos (0) /*!< SYS_T::GPA_MFOS: MFOS0 Position */ +#define SYS_GPA_MFOS_MFOS0_Msk (0x1ul << SYS_GPA_MFOS_MFOS0_Pos) /*!< SYS_T::GPA_MFOS: MFOS0 Mask */ + +#define SYS_GPA_MFOS_MFOS1_Pos (1) /*!< SYS_T::GPA_MFOS: MFOS1 Position */ +#define SYS_GPA_MFOS_MFOS1_Msk (0x1ul << SYS_GPA_MFOS_MFOS1_Pos) /*!< SYS_T::GPA_MFOS: MFOS1 Mask */ + +#define SYS_GPA_MFOS_MFOS2_Pos (2) /*!< SYS_T::GPA_MFOS: MFOS2 Position */ +#define SYS_GPA_MFOS_MFOS2_Msk (0x1ul << SYS_GPA_MFOS_MFOS2_Pos) /*!< SYS_T::GPA_MFOS: MFOS2 Mask */ + +#define SYS_GPA_MFOS_MFOS3_Pos (3) /*!< SYS_T::GPA_MFOS: MFOS3 Position */ +#define SYS_GPA_MFOS_MFOS3_Msk (0x1ul << SYS_GPA_MFOS_MFOS3_Pos) /*!< SYS_T::GPA_MFOS: MFOS3 Mask */ + +#define SYS_GPA_MFOS_MFOS4_Pos (4) /*!< SYS_T::GPA_MFOS: MFOS4 Position */ +#define SYS_GPA_MFOS_MFOS4_Msk (0x1ul << SYS_GPA_MFOS_MFOS4_Pos) /*!< SYS_T::GPA_MFOS: MFOS4 Mask */ + +#define SYS_GPA_MFOS_MFOS5_Pos (5) /*!< SYS_T::GPA_MFOS: MFOS5 Position */ +#define SYS_GPA_MFOS_MFOS5_Msk (0x1ul << SYS_GPA_MFOS_MFOS5_Pos) /*!< SYS_T::GPA_MFOS: MFOS5 Mask */ + +#define SYS_GPA_MFOS_MFOS6_Pos (6) /*!< SYS_T::GPA_MFOS: MFOS6 Position */ +#define SYS_GPA_MFOS_MFOS6_Msk (0x1ul << SYS_GPA_MFOS_MFOS6_Pos) /*!< SYS_T::GPA_MFOS: MFOS6 Mask */ + +#define SYS_GPA_MFOS_MFOS7_Pos (7) /*!< SYS_T::GPA_MFOS: MFOS7 Position */ +#define SYS_GPA_MFOS_MFOS7_Msk (0x1ul << SYS_GPA_MFOS_MFOS7_Pos) /*!< SYS_T::GPA_MFOS: MFOS7 Mask */ + +#define SYS_GPA_MFOS_MFOS8_Pos (8) /*!< SYS_T::GPA_MFOS: MFOS8 Position */ +#define SYS_GPA_MFOS_MFOS8_Msk (0x1ul << SYS_GPA_MFOS_MFOS8_Pos) /*!< SYS_T::GPA_MFOS: MFOS8 Mask */ + +#define SYS_GPA_MFOS_MFOS9_Pos (9) /*!< SYS_T::GPA_MFOS: MFOS9 Position */ +#define SYS_GPA_MFOS_MFOS9_Msk (0x1ul << SYS_GPA_MFOS_MFOS9_Pos) /*!< SYS_T::GPA_MFOS: MFOS9 Mask */ + +#define SYS_GPA_MFOS_MFOS10_Pos (10) /*!< SYS_T::GPA_MFOS: MFOS10 Position */ +#define SYS_GPA_MFOS_MFOS10_Msk (0x1ul << SYS_GPA_MFOS_MFOS10_Pos) /*!< SYS_T::GPA_MFOS: MFOS10 Mask */ + +#define SYS_GPA_MFOS_MFOS11_Pos (11) /*!< SYS_T::GPA_MFOS: MFOS11 Position */ +#define SYS_GPA_MFOS_MFOS11_Msk (0x1ul << SYS_GPA_MFOS_MFOS11_Pos) /*!< SYS_T::GPA_MFOS: MFOS11 Mask */ + +#define SYS_GPA_MFOS_MFOS12_Pos (12) /*!< SYS_T::GPA_MFOS: MFOS12 Position */ +#define SYS_GPA_MFOS_MFOS12_Msk (0x1ul << SYS_GPA_MFOS_MFOS12_Pos) /*!< SYS_T::GPA_MFOS: MFOS12 Mask */ + +#define SYS_GPA_MFOS_MFOS13_Pos (13) /*!< SYS_T::GPA_MFOS: MFOS13 Position */ +#define SYS_GPA_MFOS_MFOS13_Msk (0x1ul << SYS_GPA_MFOS_MFOS13_Pos) /*!< SYS_T::GPA_MFOS: MFOS13 Mask */ + +#define SYS_GPA_MFOS_MFOS14_Pos (14) /*!< SYS_T::GPA_MFOS: MFOS14 Position */ +#define SYS_GPA_MFOS_MFOS14_Msk (0x1ul << SYS_GPA_MFOS_MFOS14_Pos) /*!< SYS_T::GPA_MFOS: MFOS14 Mask */ + +#define SYS_GPA_MFOS_MFOS15_Pos (15) /*!< SYS_T::GPA_MFOS: MFOS15 Position */ +#define SYS_GPA_MFOS_MFOS15_Msk (0x1ul << SYS_GPA_MFOS_MFOS15_Pos) /*!< SYS_T::GPA_MFOS: MFOS15 Mask */ + +#define SYS_GPB_MFOS_MFOS0_Pos (0) /*!< SYS_T::GPB_MFOS: MFOS0 Position */ +#define SYS_GPB_MFOS_MFOS0_Msk (0x1ul << SYS_GPB_MFOS_MFOS0_Pos) /*!< SYS_T::GPB_MFOS: MFOS0 Mask */ + +#define SYS_GPB_MFOS_MFOS1_Pos (1) /*!< SYS_T::GPB_MFOS: MFOS1 Position */ +#define SYS_GPB_MFOS_MFOS1_Msk (0x1ul << SYS_GPB_MFOS_MFOS1_Pos) /*!< SYS_T::GPB_MFOS: MFOS1 Mask */ + +#define SYS_GPB_MFOS_MFOS2_Pos (2) /*!< SYS_T::GPB_MFOS: MFOS2 Position */ +#define SYS_GPB_MFOS_MFOS2_Msk (0x1ul << SYS_GPB_MFOS_MFOS2_Pos) /*!< SYS_T::GPB_MFOS: MFOS2 Mask */ + +#define SYS_GPB_MFOS_MFOS3_Pos (3) /*!< SYS_T::GPB_MFOS: MFOS3 Position */ +#define SYS_GPB_MFOS_MFOS3_Msk (0x1ul << SYS_GPB_MFOS_MFOS3_Pos) /*!< SYS_T::GPB_MFOS: MFOS3 Mask */ + +#define SYS_GPB_MFOS_MFOS4_Pos (4) /*!< SYS_T::GPB_MFOS: MFOS4 Position */ +#define SYS_GPB_MFOS_MFOS4_Msk (0x1ul << SYS_GPB_MFOS_MFOS4_Pos) /*!< SYS_T::GPB_MFOS: MFOS4 Mask */ + +#define SYS_GPB_MFOS_MFOS5_Pos (5) /*!< SYS_T::GPB_MFOS: MFOS5 Position */ +#define SYS_GPB_MFOS_MFOS5_Msk (0x1ul << SYS_GPB_MFOS_MFOS5_Pos) /*!< SYS_T::GPB_MFOS: MFOS5 Mask */ + +#define SYS_GPB_MFOS_MFOS6_Pos (6) /*!< SYS_T::GPB_MFOS: MFOS6 Position */ +#define SYS_GPB_MFOS_MFOS6_Msk (0x1ul << SYS_GPB_MFOS_MFOS6_Pos) /*!< SYS_T::GPB_MFOS: MFOS6 Mask */ + +#define SYS_GPB_MFOS_MFOS7_Pos (7) /*!< SYS_T::GPB_MFOS: MFOS7 Position */ +#define SYS_GPB_MFOS_MFOS7_Msk (0x1ul << SYS_GPB_MFOS_MFOS7_Pos) /*!< SYS_T::GPB_MFOS: MFOS7 Mask */ + +#define SYS_GPB_MFOS_MFOS8_Pos (8) /*!< SYS_T::GPB_MFOS: MFOS8 Position */ +#define SYS_GPB_MFOS_MFOS8_Msk (0x1ul << SYS_GPB_MFOS_MFOS8_Pos) /*!< SYS_T::GPB_MFOS: MFOS8 Mask */ + +#define SYS_GPB_MFOS_MFOS9_Pos (9) /*!< SYS_T::GPB_MFOS: MFOS9 Position */ +#define SYS_GPB_MFOS_MFOS9_Msk (0x1ul << SYS_GPB_MFOS_MFOS9_Pos) /*!< SYS_T::GPB_MFOS: MFOS9 Mask */ + +#define SYS_GPB_MFOS_MFOS10_Pos (10) /*!< SYS_T::GPB_MFOS: MFOS10 Position */ +#define SYS_GPB_MFOS_MFOS10_Msk (0x1ul << SYS_GPB_MFOS_MFOS10_Pos) /*!< SYS_T::GPB_MFOS: MFOS10 Mask */ + +#define SYS_GPB_MFOS_MFOS11_Pos (11) /*!< SYS_T::GPB_MFOS: MFOS11 Position */ +#define SYS_GPB_MFOS_MFOS11_Msk (0x1ul << SYS_GPB_MFOS_MFOS11_Pos) /*!< SYS_T::GPB_MFOS: MFOS11 Mask */ + +#define SYS_GPB_MFOS_MFOS12_Pos (12) /*!< SYS_T::GPB_MFOS: MFOS12 Position */ +#define SYS_GPB_MFOS_MFOS12_Msk (0x1ul << SYS_GPB_MFOS_MFOS12_Pos) /*!< SYS_T::GPB_MFOS: MFOS12 Mask */ + +#define SYS_GPB_MFOS_MFOS13_Pos (13) /*!< SYS_T::GPB_MFOS: MFOS13 Position */ +#define SYS_GPB_MFOS_MFOS13_Msk (0x1ul << SYS_GPB_MFOS_MFOS13_Pos) /*!< SYS_T::GPB_MFOS: MFOS13 Mask */ + +#define SYS_GPB_MFOS_MFOS14_Pos (14) /*!< SYS_T::GPB_MFOS: MFOS14 Position */ +#define SYS_GPB_MFOS_MFOS14_Msk (0x1ul << SYS_GPB_MFOS_MFOS14_Pos) /*!< SYS_T::GPB_MFOS: MFOS14 Mask */ + +#define SYS_GPB_MFOS_MFOS15_Pos (15) /*!< SYS_T::GPB_MFOS: MFOS15 Position */ +#define SYS_GPB_MFOS_MFOS15_Msk (0x1ul << SYS_GPB_MFOS_MFOS15_Pos) /*!< SYS_T::GPB_MFOS: MFOS15 Mask */ + +#define SYS_GPC_MFOS_MFOS0_Pos (0) /*!< SYS_T::GPC_MFOS: MFOS0 Position */ +#define SYS_GPC_MFOS_MFOS0_Msk (0x1ul << SYS_GPC_MFOS_MFOS0_Pos) /*!< SYS_T::GPC_MFOS: MFOS0 Mask */ + +#define SYS_GPC_MFOS_MFOS1_Pos (1) /*!< SYS_T::GPC_MFOS: MFOS1 Position */ +#define SYS_GPC_MFOS_MFOS1_Msk (0x1ul << SYS_GPC_MFOS_MFOS1_Pos) /*!< SYS_T::GPC_MFOS: MFOS1 Mask */ + +#define SYS_GPC_MFOS_MFOS2_Pos (2) /*!< SYS_T::GPC_MFOS: MFOS2 Position */ +#define SYS_GPC_MFOS_MFOS2_Msk (0x1ul << SYS_GPC_MFOS_MFOS2_Pos) /*!< SYS_T::GPC_MFOS: MFOS2 Mask */ + +#define SYS_GPC_MFOS_MFOS3_Pos (3) /*!< SYS_T::GPC_MFOS: MFOS3 Position */ +#define SYS_GPC_MFOS_MFOS3_Msk (0x1ul << SYS_GPC_MFOS_MFOS3_Pos) /*!< SYS_T::GPC_MFOS: MFOS3 Mask */ + +#define SYS_GPC_MFOS_MFOS4_Pos (4) /*!< SYS_T::GPC_MFOS: MFOS4 Position */ +#define SYS_GPC_MFOS_MFOS4_Msk (0x1ul << SYS_GPC_MFOS_MFOS4_Pos) /*!< SYS_T::GPC_MFOS: MFOS4 Mask */ + +#define SYS_GPC_MFOS_MFOS5_Pos (5) /*!< SYS_T::GPC_MFOS: MFOS5 Position */ +#define SYS_GPC_MFOS_MFOS5_Msk (0x1ul << SYS_GPC_MFOS_MFOS5_Pos) /*!< SYS_T::GPC_MFOS: MFOS5 Mask */ + +#define SYS_GPC_MFOS_MFOS6_Pos (6) /*!< SYS_T::GPC_MFOS: MFOS6 Position */ +#define SYS_GPC_MFOS_MFOS6_Msk (0x1ul << SYS_GPC_MFOS_MFOS6_Pos) /*!< SYS_T::GPC_MFOS: MFOS6 Mask */ + +#define SYS_GPC_MFOS_MFOS7_Pos (7) /*!< SYS_T::GPC_MFOS: MFOS7 Position */ +#define SYS_GPC_MFOS_MFOS7_Msk (0x1ul << SYS_GPC_MFOS_MFOS7_Pos) /*!< SYS_T::GPC_MFOS: MFOS7 Mask */ + +#define SYS_GPC_MFOS_MFOS8_Pos (8) /*!< SYS_T::GPC_MFOS: MFOS8 Position */ +#define SYS_GPC_MFOS_MFOS8_Msk (0x1ul << SYS_GPC_MFOS_MFOS8_Pos) /*!< SYS_T::GPC_MFOS: MFOS8 Mask */ + +#define SYS_GPC_MFOS_MFOS9_Pos (9) /*!< SYS_T::GPC_MFOS: MFOS9 Position */ +#define SYS_GPC_MFOS_MFOS9_Msk (0x1ul << SYS_GPC_MFOS_MFOS9_Pos) /*!< SYS_T::GPC_MFOS: MFOS9 Mask */ + +#define SYS_GPC_MFOS_MFOS10_Pos (10) /*!< SYS_T::GPC_MFOS: MFOS10 Position */ +#define SYS_GPC_MFOS_MFOS10_Msk (0x1ul << SYS_GPC_MFOS_MFOS10_Pos) /*!< SYS_T::GPC_MFOS: MFOS10 Mask */ + +#define SYS_GPC_MFOS_MFOS11_Pos (11) /*!< SYS_T::GPC_MFOS: MFOS11 Position */ +#define SYS_GPC_MFOS_MFOS11_Msk (0x1ul << SYS_GPC_MFOS_MFOS11_Pos) /*!< SYS_T::GPC_MFOS: MFOS11 Mask */ + +#define SYS_GPC_MFOS_MFOS12_Pos (12) /*!< SYS_T::GPC_MFOS: MFOS12 Position */ +#define SYS_GPC_MFOS_MFOS12_Msk (0x1ul << SYS_GPC_MFOS_MFOS12_Pos) /*!< SYS_T::GPC_MFOS: MFOS12 Mask */ + +#define SYS_GPC_MFOS_MFOS13_Pos (13) /*!< SYS_T::GPC_MFOS: MFOS13 Position */ +#define SYS_GPC_MFOS_MFOS13_Msk (0x1ul << SYS_GPC_MFOS_MFOS13_Pos) /*!< SYS_T::GPC_MFOS: MFOS13 Mask */ + +#define SYS_GPC_MFOS_MFOS14_Pos (14) /*!< SYS_T::GPC_MFOS: MFOS14 Position */ +#define SYS_GPC_MFOS_MFOS14_Msk (0x1ul << SYS_GPC_MFOS_MFOS14_Pos) /*!< SYS_T::GPC_MFOS: MFOS14 Mask */ + +#define SYS_GPC_MFOS_MFOS15_Pos (15) /*!< SYS_T::GPC_MFOS: MFOS15 Position */ +#define SYS_GPC_MFOS_MFOS15_Msk (0x1ul << SYS_GPC_MFOS_MFOS15_Pos) /*!< SYS_T::GPC_MFOS: MFOS15 Mask */ + +#define SYS_GPD_MFOS_MFOS0_Pos (0) /*!< SYS_T::GPD_MFOS: MFOS0 Position */ +#define SYS_GPD_MFOS_MFOS0_Msk (0x1ul << SYS_GPD_MFOS_MFOS0_Pos) /*!< SYS_T::GPD_MFOS: MFOS0 Mask */ + +#define SYS_GPD_MFOS_MFOS1_Pos (1) /*!< SYS_T::GPD_MFOS: MFOS1 Position */ +#define SYS_GPD_MFOS_MFOS1_Msk (0x1ul << SYS_GPD_MFOS_MFOS1_Pos) /*!< SYS_T::GPD_MFOS: MFOS1 Mask */ + +#define SYS_GPD_MFOS_MFOS2_Pos (2) /*!< SYS_T::GPD_MFOS: MFOS2 Position */ +#define SYS_GPD_MFOS_MFOS2_Msk (0x1ul << SYS_GPD_MFOS_MFOS2_Pos) /*!< SYS_T::GPD_MFOS: MFOS2 Mask */ + +#define SYS_GPD_MFOS_MFOS3_Pos (3) /*!< SYS_T::GPD_MFOS: MFOS3 Position */ +#define SYS_GPD_MFOS_MFOS3_Msk (0x1ul << SYS_GPD_MFOS_MFOS3_Pos) /*!< SYS_T::GPD_MFOS: MFOS3 Mask */ + +#define SYS_GPD_MFOS_MFOS4_Pos (4) /*!< SYS_T::GPD_MFOS: MFOS4 Position */ +#define SYS_GPD_MFOS_MFOS4_Msk (0x1ul << SYS_GPD_MFOS_MFOS4_Pos) /*!< SYS_T::GPD_MFOS: MFOS4 Mask */ + +#define SYS_GPD_MFOS_MFOS5_Pos (5) /*!< SYS_T::GPD_MFOS: MFOS5 Position */ +#define SYS_GPD_MFOS_MFOS5_Msk (0x1ul << SYS_GPD_MFOS_MFOS5_Pos) /*!< SYS_T::GPD_MFOS: MFOS5 Mask */ + +#define SYS_GPD_MFOS_MFOS6_Pos (6) /*!< SYS_T::GPD_MFOS: MFOS6 Position */ +#define SYS_GPD_MFOS_MFOS6_Msk (0x1ul << SYS_GPD_MFOS_MFOS6_Pos) /*!< SYS_T::GPD_MFOS: MFOS6 Mask */ + +#define SYS_GPD_MFOS_MFOS7_Pos (7) /*!< SYS_T::GPD_MFOS: MFOS7 Position */ +#define SYS_GPD_MFOS_MFOS7_Msk (0x1ul << SYS_GPD_MFOS_MFOS7_Pos) /*!< SYS_T::GPD_MFOS: MFOS7 Mask */ + +#define SYS_GPD_MFOS_MFOS8_Pos (8) /*!< SYS_T::GPD_MFOS: MFOS8 Position */ +#define SYS_GPD_MFOS_MFOS8_Msk (0x1ul << SYS_GPD_MFOS_MFOS8_Pos) /*!< SYS_T::GPD_MFOS: MFOS8 Mask */ + +#define SYS_GPD_MFOS_MFOS9_Pos (9) /*!< SYS_T::GPD_MFOS: MFOS9 Position */ +#define SYS_GPD_MFOS_MFOS9_Msk (0x1ul << SYS_GPD_MFOS_MFOS9_Pos) /*!< SYS_T::GPD_MFOS: MFOS9 Mask */ + +#define SYS_GPD_MFOS_MFOS10_Pos (10) /*!< SYS_T::GPD_MFOS: MFOS10 Position */ +#define SYS_GPD_MFOS_MFOS10_Msk (0x1ul << SYS_GPD_MFOS_MFOS10_Pos) /*!< SYS_T::GPD_MFOS: MFOS10 Mask */ + +#define SYS_GPD_MFOS_MFOS11_Pos (11) /*!< SYS_T::GPD_MFOS: MFOS11 Position */ +#define SYS_GPD_MFOS_MFOS11_Msk (0x1ul << SYS_GPD_MFOS_MFOS11_Pos) /*!< SYS_T::GPD_MFOS: MFOS11 Mask */ + +#define SYS_GPD_MFOS_MFOS12_Pos (12) /*!< SYS_T::GPD_MFOS: MFOS12 Position */ +#define SYS_GPD_MFOS_MFOS12_Msk (0x1ul << SYS_GPD_MFOS_MFOS12_Pos) /*!< SYS_T::GPD_MFOS: MFOS12 Mask */ + +#define SYS_GPD_MFOS_MFOS13_Pos (13) /*!< SYS_T::GPD_MFOS: MFOS13 Position */ +#define SYS_GPD_MFOS_MFOS13_Msk (0x1ul << SYS_GPD_MFOS_MFOS13_Pos) /*!< SYS_T::GPD_MFOS: MFOS13 Mask */ + +#define SYS_GPD_MFOS_MFOS14_Pos (14) /*!< SYS_T::GPD_MFOS: MFOS14 Position */ +#define SYS_GPD_MFOS_MFOS14_Msk (0x1ul << SYS_GPD_MFOS_MFOS14_Pos) /*!< SYS_T::GPD_MFOS: MFOS14 Mask */ + +#define SYS_GPD_MFOS_MFOS15_Pos (15) /*!< SYS_T::GPD_MFOS: MFOS15 Position */ +#define SYS_GPD_MFOS_MFOS15_Msk (0x1ul << SYS_GPD_MFOS_MFOS15_Pos) /*!< SYS_T::GPD_MFOS: MFOS15 Mask */ + +#define SYS_GPE_MFOS_MFOS0_Pos (0) /*!< SYS_T::GPE_MFOS: MFOS0 Position */ +#define SYS_GPE_MFOS_MFOS0_Msk (0x1ul << SYS_GPE_MFOS_MFOS0_Pos) /*!< SYS_T::GPE_MFOS: MFOS0 Mask */ + +#define SYS_GPE_MFOS_MFOS1_Pos (1) /*!< SYS_T::GPE_MFOS: MFOS1 Position */ +#define SYS_GPE_MFOS_MFOS1_Msk (0x1ul << SYS_GPE_MFOS_MFOS1_Pos) /*!< SYS_T::GPE_MFOS: MFOS1 Mask */ + +#define SYS_GPE_MFOS_MFOS2_Pos (2) /*!< SYS_T::GPE_MFOS: MFOS2 Position */ +#define SYS_GPE_MFOS_MFOS2_Msk (0x1ul << SYS_GPE_MFOS_MFOS2_Pos) /*!< SYS_T::GPE_MFOS: MFOS2 Mask */ + +#define SYS_GPE_MFOS_MFOS3_Pos (3) /*!< SYS_T::GPE_MFOS: MFOS3 Position */ +#define SYS_GPE_MFOS_MFOS3_Msk (0x1ul << SYS_GPE_MFOS_MFOS3_Pos) /*!< SYS_T::GPE_MFOS: MFOS3 Mask */ + +#define SYS_GPE_MFOS_MFOS4_Pos (4) /*!< SYS_T::GPE_MFOS: MFOS4 Position */ +#define SYS_GPE_MFOS_MFOS4_Msk (0x1ul << SYS_GPE_MFOS_MFOS4_Pos) /*!< SYS_T::GPE_MFOS: MFOS4 Mask */ + +#define SYS_GPE_MFOS_MFOS5_Pos (5) /*!< SYS_T::GPE_MFOS: MFOS5 Position */ +#define SYS_GPE_MFOS_MFOS5_Msk (0x1ul << SYS_GPE_MFOS_MFOS5_Pos) /*!< SYS_T::GPE_MFOS: MFOS5 Mask */ + +#define SYS_GPE_MFOS_MFOS6_Pos (6) /*!< SYS_T::GPE_MFOS: MFOS6 Position */ +#define SYS_GPE_MFOS_MFOS6_Msk (0x1ul << SYS_GPE_MFOS_MFOS6_Pos) /*!< SYS_T::GPE_MFOS: MFOS6 Mask */ + +#define SYS_GPE_MFOS_MFOS7_Pos (7) /*!< SYS_T::GPE_MFOS: MFOS7 Position */ +#define SYS_GPE_MFOS_MFOS7_Msk (0x1ul << SYS_GPE_MFOS_MFOS7_Pos) /*!< SYS_T::GPE_MFOS: MFOS7 Mask */ + +#define SYS_GPE_MFOS_MFOS8_Pos (8) /*!< SYS_T::GPE_MFOS: MFOS8 Position */ +#define SYS_GPE_MFOS_MFOS8_Msk (0x1ul << SYS_GPE_MFOS_MFOS8_Pos) /*!< SYS_T::GPE_MFOS: MFOS8 Mask */ + +#define SYS_GPE_MFOS_MFOS9_Pos (9) /*!< SYS_T::GPE_MFOS: MFOS9 Position */ +#define SYS_GPE_MFOS_MFOS9_Msk (0x1ul << SYS_GPE_MFOS_MFOS9_Pos) /*!< SYS_T::GPE_MFOS: MFOS9 Mask */ + +#define SYS_GPE_MFOS_MFOS10_Pos (10) /*!< SYS_T::GPE_MFOS: MFOS10 Position */ +#define SYS_GPE_MFOS_MFOS10_Msk (0x1ul << SYS_GPE_MFOS_MFOS10_Pos) /*!< SYS_T::GPE_MFOS: MFOS10 Mask */ + +#define SYS_GPE_MFOS_MFOS11_Pos (11) /*!< SYS_T::GPE_MFOS: MFOS11 Position */ +#define SYS_GPE_MFOS_MFOS11_Msk (0x1ul << SYS_GPE_MFOS_MFOS11_Pos) /*!< SYS_T::GPE_MFOS: MFOS11 Mask */ + +#define SYS_GPE_MFOS_MFOS12_Pos (12) /*!< SYS_T::GPE_MFOS: MFOS12 Position */ +#define SYS_GPE_MFOS_MFOS12_Msk (0x1ul << SYS_GPE_MFOS_MFOS12_Pos) /*!< SYS_T::GPE_MFOS: MFOS12 Mask */ + +#define SYS_GPE_MFOS_MFOS13_Pos (13) /*!< SYS_T::GPE_MFOS: MFOS13 Position */ +#define SYS_GPE_MFOS_MFOS13_Msk (0x1ul << SYS_GPE_MFOS_MFOS13_Pos) /*!< SYS_T::GPE_MFOS: MFOS13 Mask */ + +#define SYS_GPE_MFOS_MFOS14_Pos (14) /*!< SYS_T::GPE_MFOS: MFOS14 Position */ +#define SYS_GPE_MFOS_MFOS14_Msk (0x1ul << SYS_GPE_MFOS_MFOS14_Pos) /*!< SYS_T::GPE_MFOS: MFOS14 Mask */ + +#define SYS_GPE_MFOS_MFOS15_Pos (15) /*!< SYS_T::GPE_MFOS: MFOS15 Position */ +#define SYS_GPE_MFOS_MFOS15_Msk (0x1ul << SYS_GPE_MFOS_MFOS15_Pos) /*!< SYS_T::GPE_MFOS: MFOS15 Mask */ + +#define SYS_GPF_MFOS_MFOS0_Pos (0) /*!< SYS_T::GPF_MFOS: MFOS0 Position */ +#define SYS_GPF_MFOS_MFOS0_Msk (0x1ul << SYS_GPF_MFOS_MFOS0_Pos) /*!< SYS_T::GPF_MFOS: MFOS0 Mask */ + +#define SYS_GPF_MFOS_MFOS1_Pos (1) /*!< SYS_T::GPF_MFOS: MFOS1 Position */ +#define SYS_GPF_MFOS_MFOS1_Msk (0x1ul << SYS_GPF_MFOS_MFOS1_Pos) /*!< SYS_T::GPF_MFOS: MFOS1 Mask */ + +#define SYS_GPF_MFOS_MFOS2_Pos (2) /*!< SYS_T::GPF_MFOS: MFOS2 Position */ +#define SYS_GPF_MFOS_MFOS2_Msk (0x1ul << SYS_GPF_MFOS_MFOS2_Pos) /*!< SYS_T::GPF_MFOS: MFOS2 Mask */ + +#define SYS_GPF_MFOS_MFOS3_Pos (3) /*!< SYS_T::GPF_MFOS: MFOS3 Position */ +#define SYS_GPF_MFOS_MFOS3_Msk (0x1ul << SYS_GPF_MFOS_MFOS3_Pos) /*!< SYS_T::GPF_MFOS: MFOS3 Mask */ + +#define SYS_GPF_MFOS_MFOS4_Pos (4) /*!< SYS_T::GPF_MFOS: MFOS4 Position */ +#define SYS_GPF_MFOS_MFOS4_Msk (0x1ul << SYS_GPF_MFOS_MFOS4_Pos) /*!< SYS_T::GPF_MFOS: MFOS4 Mask */ + +#define SYS_GPF_MFOS_MFOS5_Pos (5) /*!< SYS_T::GPF_MFOS: MFOS5 Position */ +#define SYS_GPF_MFOS_MFOS5_Msk (0x1ul << SYS_GPF_MFOS_MFOS5_Pos) /*!< SYS_T::GPF_MFOS: MFOS5 Mask */ + +#define SYS_GPF_MFOS_MFOS6_Pos (6) /*!< SYS_T::GPF_MFOS: MFOS6 Position */ +#define SYS_GPF_MFOS_MFOS6_Msk (0x1ul << SYS_GPF_MFOS_MFOS6_Pos) /*!< SYS_T::GPF_MFOS: MFOS6 Mask */ + +#define SYS_GPF_MFOS_MFOS7_Pos (7) /*!< SYS_T::GPF_MFOS: MFOS7 Position */ +#define SYS_GPF_MFOS_MFOS7_Msk (0x1ul << SYS_GPF_MFOS_MFOS7_Pos) /*!< SYS_T::GPF_MFOS: MFOS7 Mask */ + +#define SYS_GPF_MFOS_MFOS8_Pos (8) /*!< SYS_T::GPF_MFOS: MFOS8 Position */ +#define SYS_GPF_MFOS_MFOS8_Msk (0x1ul << SYS_GPF_MFOS_MFOS8_Pos) /*!< SYS_T::GPF_MFOS: MFOS8 Mask */ + +#define SYS_GPF_MFOS_MFOS9_Pos (9) /*!< SYS_T::GPF_MFOS: MFOS9 Position */ +#define SYS_GPF_MFOS_MFOS9_Msk (0x1ul << SYS_GPF_MFOS_MFOS9_Pos) /*!< SYS_T::GPF_MFOS: MFOS9 Mask */ + +#define SYS_GPF_MFOS_MFOS10_Pos (10) /*!< SYS_T::GPF_MFOS: MFOS10 Position */ +#define SYS_GPF_MFOS_MFOS10_Msk (0x1ul << SYS_GPF_MFOS_MFOS10_Pos) /*!< SYS_T::GPF_MFOS: MFOS10 Mask */ + +#define SYS_GPF_MFOS_MFOS11_Pos (11) /*!< SYS_T::GPF_MFOS: MFOS11 Position */ +#define SYS_GPF_MFOS_MFOS11_Msk (0x1ul << SYS_GPF_MFOS_MFOS11_Pos) /*!< SYS_T::GPF_MFOS: MFOS11 Mask */ + +#define SYS_GPF_MFOS_MFOS12_Pos (12) /*!< SYS_T::GPF_MFOS: MFOS12 Position */ +#define SYS_GPF_MFOS_MFOS12_Msk (0x1ul << SYS_GPF_MFOS_MFOS12_Pos) /*!< SYS_T::GPF_MFOS: MFOS12 Mask */ + +#define SYS_GPF_MFOS_MFOS13_Pos (13) /*!< SYS_T::GPF_MFOS: MFOS13 Position */ +#define SYS_GPF_MFOS_MFOS13_Msk (0x1ul << SYS_GPF_MFOS_MFOS13_Pos) /*!< SYS_T::GPF_MFOS: MFOS13 Mask */ + +#define SYS_GPF_MFOS_MFOS14_Pos (14) /*!< SYS_T::GPF_MFOS: MFOS14 Position */ +#define SYS_GPF_MFOS_MFOS14_Msk (0x1ul << SYS_GPF_MFOS_MFOS14_Pos) /*!< SYS_T::GPF_MFOS: MFOS14 Mask */ + +#define SYS_GPF_MFOS_MFOS15_Pos (15) /*!< SYS_T::GPF_MFOS: MFOS15 Position */ +#define SYS_GPF_MFOS_MFOS15_Msk (0x1ul << SYS_GPF_MFOS_MFOS15_Pos) /*!< SYS_T::GPF_MFOS: MFOS15 Mask */ + +#define SYS_GPG_MFOS_MFOS0_Pos (0) /*!< SYS_T::GPG_MFOS: MFOS0 Position */ +#define SYS_GPG_MFOS_MFOS0_Msk (0x1ul << SYS_GPG_MFOS_MFOS0_Pos) /*!< SYS_T::GPG_MFOS: MFOS0 Mask */ + +#define SYS_GPG_MFOS_MFOS1_Pos (1) /*!< SYS_T::GPG_MFOS: MFOS1 Position */ +#define SYS_GPG_MFOS_MFOS1_Msk (0x1ul << SYS_GPG_MFOS_MFOS1_Pos) /*!< SYS_T::GPG_MFOS: MFOS1 Mask */ + +#define SYS_GPG_MFOS_MFOS2_Pos (2) /*!< SYS_T::GPG_MFOS: MFOS2 Position */ +#define SYS_GPG_MFOS_MFOS2_Msk (0x1ul << SYS_GPG_MFOS_MFOS2_Pos) /*!< SYS_T::GPG_MFOS: MFOS2 Mask */ + +#define SYS_GPG_MFOS_MFOS3_Pos (3) /*!< SYS_T::GPG_MFOS: MFOS3 Position */ +#define SYS_GPG_MFOS_MFOS3_Msk (0x1ul << SYS_GPG_MFOS_MFOS3_Pos) /*!< SYS_T::GPG_MFOS: MFOS3 Mask */ + +#define SYS_GPG_MFOS_MFOS4_Pos (4) /*!< SYS_T::GPG_MFOS: MFOS4 Position */ +#define SYS_GPG_MFOS_MFOS4_Msk (0x1ul << SYS_GPG_MFOS_MFOS4_Pos) /*!< SYS_T::GPG_MFOS: MFOS4 Mask */ + +#define SYS_GPG_MFOS_MFOS5_Pos (5) /*!< SYS_T::GPG_MFOS: MFOS5 Position */ +#define SYS_GPG_MFOS_MFOS5_Msk (0x1ul << SYS_GPG_MFOS_MFOS5_Pos) /*!< SYS_T::GPG_MFOS: MFOS5 Mask */ + +#define SYS_GPG_MFOS_MFOS6_Pos (6) /*!< SYS_T::GPG_MFOS: MFOS6 Position */ +#define SYS_GPG_MFOS_MFOS6_Msk (0x1ul << SYS_GPG_MFOS_MFOS6_Pos) /*!< SYS_T::GPG_MFOS: MFOS6 Mask */ + +#define SYS_GPG_MFOS_MFOS7_Pos (7) /*!< SYS_T::GPG_MFOS: MFOS7 Position */ +#define SYS_GPG_MFOS_MFOS7_Msk (0x1ul << SYS_GPG_MFOS_MFOS7_Pos) /*!< SYS_T::GPG_MFOS: MFOS7 Mask */ + +#define SYS_GPG_MFOS_MFOS8_Pos (8) /*!< SYS_T::GPG_MFOS: MFOS8 Position */ +#define SYS_GPG_MFOS_MFOS8_Msk (0x1ul << SYS_GPG_MFOS_MFOS8_Pos) /*!< SYS_T::GPG_MFOS: MFOS8 Mask */ + +#define SYS_GPG_MFOS_MFOS9_Pos (9) /*!< SYS_T::GPG_MFOS: MFOS9 Position */ +#define SYS_GPG_MFOS_MFOS9_Msk (0x1ul << SYS_GPG_MFOS_MFOS9_Pos) /*!< SYS_T::GPG_MFOS: MFOS9 Mask */ + +#define SYS_GPG_MFOS_MFOS10_Pos (10) /*!< SYS_T::GPG_MFOS: MFOS10 Position */ +#define SYS_GPG_MFOS_MFOS10_Msk (0x1ul << SYS_GPG_MFOS_MFOS10_Pos) /*!< SYS_T::GPG_MFOS: MFOS10 Mask */ + +#define SYS_GPG_MFOS_MFOS11_Pos (11) /*!< SYS_T::GPG_MFOS: MFOS11 Position */ +#define SYS_GPG_MFOS_MFOS11_Msk (0x1ul << SYS_GPG_MFOS_MFOS11_Pos) /*!< SYS_T::GPG_MFOS: MFOS11 Mask */ + +#define SYS_GPG_MFOS_MFOS12_Pos (12) /*!< SYS_T::GPG_MFOS: MFOS12 Position */ +#define SYS_GPG_MFOS_MFOS12_Msk (0x1ul << SYS_GPG_MFOS_MFOS12_Pos) /*!< SYS_T::GPG_MFOS: MFOS12 Mask */ + +#define SYS_GPG_MFOS_MFOS13_Pos (13) /*!< SYS_T::GPG_MFOS: MFOS13 Position */ +#define SYS_GPG_MFOS_MFOS13_Msk (0x1ul << SYS_GPG_MFOS_MFOS13_Pos) /*!< SYS_T::GPG_MFOS: MFOS13 Mask */ + +#define SYS_GPG_MFOS_MFOS14_Pos (14) /*!< SYS_T::GPG_MFOS: MFOS14 Position */ +#define SYS_GPG_MFOS_MFOS14_Msk (0x1ul << SYS_GPG_MFOS_MFOS14_Pos) /*!< SYS_T::GPG_MFOS: MFOS14 Mask */ + +#define SYS_GPG_MFOS_MFOS15_Pos (15) /*!< SYS_T::GPG_MFOS: MFOS15 Position */ +#define SYS_GPG_MFOS_MFOS15_Msk (0x1ul << SYS_GPG_MFOS_MFOS15_Pos) /*!< SYS_T::GPG_MFOS: MFOS15 Mask */ + +#define SYS_GPH_MFOS_MFOS0_Pos (0) /*!< SYS_T::GPH_MFOS: MFOS0 Position */ +#define SYS_GPH_MFOS_MFOS0_Msk (0x1ul << SYS_GPH_MFOS_MFOS0_Pos) /*!< SYS_T::GPH_MFOS: MFOS0 Mask */ + +#define SYS_GPH_MFOS_MFOS1_Pos (1) /*!< SYS_T::GPH_MFOS: MFOS1 Position */ +#define SYS_GPH_MFOS_MFOS1_Msk (0x1ul << SYS_GPH_MFOS_MFOS1_Pos) /*!< SYS_T::GPH_MFOS: MFOS1 Mask */ + +#define SYS_GPH_MFOS_MFOS2_Pos (2) /*!< SYS_T::GPH_MFOS: MFOS2 Position */ +#define SYS_GPH_MFOS_MFOS2_Msk (0x1ul << SYS_GPH_MFOS_MFOS2_Pos) /*!< SYS_T::GPH_MFOS: MFOS2 Mask */ + +#define SYS_GPH_MFOS_MFOS3_Pos (3) /*!< SYS_T::GPH_MFOS: MFOS3 Position */ +#define SYS_GPH_MFOS_MFOS3_Msk (0x1ul << SYS_GPH_MFOS_MFOS3_Pos) /*!< SYS_T::GPH_MFOS: MFOS3 Mask */ + +#define SYS_GPH_MFOS_MFOS4_Pos (4) /*!< SYS_T::GPH_MFOS: MFOS4 Position */ +#define SYS_GPH_MFOS_MFOS4_Msk (0x1ul << SYS_GPH_MFOS_MFOS4_Pos) /*!< SYS_T::GPH_MFOS: MFOS4 Mask */ + +#define SYS_GPH_MFOS_MFOS5_Pos (5) /*!< SYS_T::GPH_MFOS: MFOS5 Position */ +#define SYS_GPH_MFOS_MFOS5_Msk (0x1ul << SYS_GPH_MFOS_MFOS5_Pos) /*!< SYS_T::GPH_MFOS: MFOS5 Mask */ + +#define SYS_GPH_MFOS_MFOS6_Pos (6) /*!< SYS_T::GPH_MFOS: MFOS6 Position */ +#define SYS_GPH_MFOS_MFOS6_Msk (0x1ul << SYS_GPH_MFOS_MFOS6_Pos) /*!< SYS_T::GPH_MFOS: MFOS6 Mask */ + +#define SYS_GPH_MFOS_MFOS7_Pos (7) /*!< SYS_T::GPH_MFOS: MFOS7 Position */ +#define SYS_GPH_MFOS_MFOS7_Msk (0x1ul << SYS_GPH_MFOS_MFOS7_Pos) /*!< SYS_T::GPH_MFOS: MFOS7 Mask */ + +#define SYS_GPH_MFOS_MFOS8_Pos (8) /*!< SYS_T::GPH_MFOS: MFOS8 Position */ +#define SYS_GPH_MFOS_MFOS8_Msk (0x1ul << SYS_GPH_MFOS_MFOS8_Pos) /*!< SYS_T::GPH_MFOS: MFOS8 Mask */ + +#define SYS_GPH_MFOS_MFOS9_Pos (9) /*!< SYS_T::GPH_MFOS: MFOS9 Position */ +#define SYS_GPH_MFOS_MFOS9_Msk (0x1ul << SYS_GPH_MFOS_MFOS9_Pos) /*!< SYS_T::GPH_MFOS: MFOS9 Mask */ + +#define SYS_GPH_MFOS_MFOS10_Pos (10) /*!< SYS_T::GPH_MFOS: MFOS10 Position */ +#define SYS_GPH_MFOS_MFOS10_Msk (0x1ul << SYS_GPH_MFOS_MFOS10_Pos) /*!< SYS_T::GPH_MFOS: MFOS10 Mask */ + +#define SYS_GPH_MFOS_MFOS11_Pos (11) /*!< SYS_T::GPH_MFOS: MFOS11 Position */ +#define SYS_GPH_MFOS_MFOS11_Msk (0x1ul << SYS_GPH_MFOS_MFOS11_Pos) /*!< SYS_T::GPH_MFOS: MFOS11 Mask */ + +#define SYS_GPH_MFOS_MFOS12_Pos (12) /*!< SYS_T::GPH_MFOS: MFOS12 Position */ +#define SYS_GPH_MFOS_MFOS12_Msk (0x1ul << SYS_GPH_MFOS_MFOS12_Pos) /*!< SYS_T::GPH_MFOS: MFOS12 Mask */ + +#define SYS_GPH_MFOS_MFOS13_Pos (13) /*!< SYS_T::GPH_MFOS: MFOS13 Position */ +#define SYS_GPH_MFOS_MFOS13_Msk (0x1ul << SYS_GPH_MFOS_MFOS13_Pos) /*!< SYS_T::GPH_MFOS: MFOS13 Mask */ + +#define SYS_GPH_MFOS_MFOS14_Pos (14) /*!< SYS_T::GPH_MFOS: MFOS14 Position */ +#define SYS_GPH_MFOS_MFOS14_Msk (0x1ul << SYS_GPH_MFOS_MFOS14_Pos) /*!< SYS_T::GPH_MFOS: MFOS14 Mask */ + +#define SYS_GPH_MFOS_MFOS15_Pos (15) /*!< SYS_T::GPH_MFOS: MFOS15 Position */ +#define SYS_GPH_MFOS_MFOS15_Msk (0x1ul << SYS_GPH_MFOS_MFOS15_Pos) /*!< SYS_T::GPH_MFOS: MFOS15 Mask */ + +#define SYS_SRAM_INTCTL_PERRIEN_Pos (0) /*!< SYS_T::SRAM_INTCTL: PERRIEN Position */ +#define SYS_SRAM_INTCTL_PERRIEN_Msk (0x1ul << SYS_SRAM_INTCTL_PERRIEN_Pos) /*!< SYS_T::SRAM_INTCTL: PERRIEN Mask */ + +#define SYS_SRAM_STATUS_PERRIF_Pos (0) /*!< SYS_T::SRAM_STATUS: PERRIF Position */ +#define SYS_SRAM_STATUS_PERRIF_Msk (0x1ul << SYS_SRAM_STATUS_PERRIF_Pos) /*!< SYS_T::SRAM_STATUS: PERRIF Mask */ + +#define SYS_SRAM_ERRADDR_ERRADDR_Pos (0) /*!< SYS_T::SRAM_ERRADDR: ERRADDR Position */ +#define SYS_SRAM_ERRADDR_ERRADDR_Msk (0xfffffffful << SYS_SRAM_ERRADDR_ERRADDR_Pos) /*!< SYS_T::SRAM_ERRADDR: ERRADDR Mask */ + +#define SYS_SRAM_BISTCTL_SRBIST0_Pos (0) /*!< SYS_T::SRAM_BISTCTL: SRBIST0 Position */ +#define SYS_SRAM_BISTCTL_SRBIST0_Msk (0x1ul << SYS_SRAM_BISTCTL_SRBIST0_Pos) /*!< SYS_T::SRAM_BISTCTL: SRBIST0 Mask */ + +#define SYS_SRAM_BISTCTL_SRBIST1_Pos (1) /*!< SYS_T::SRAM_BISTCTL: SRBIST1 Position */ +#define SYS_SRAM_BISTCTL_SRBIST1_Msk (0x1ul << SYS_SRAM_BISTCTL_SRBIST1_Pos) /*!< SYS_T::SRAM_BISTCTL: SRBIST1 Mask */ + +#define SYS_SRAM_BISTCTL_CRBIST_Pos (2) /*!< SYS_T::SRAM_BISTCTL: CRBIST Position */ +#define SYS_SRAM_BISTCTL_CRBIST_Msk (0x1ul << SYS_SRAM_BISTCTL_CRBIST_Pos) /*!< SYS_T::SRAM_BISTCTL: CRBIST Mask */ + +#define SYS_SRAM_BISTCTL_CANBIST_Pos (3) /*!< SYS_T::SRAM_BISTCTL: CANBIST Position */ +#define SYS_SRAM_BISTCTL_CANBIST_Msk (0x1ul << SYS_SRAM_BISTCTL_CANBIST_Pos) /*!< SYS_T::SRAM_BISTCTL: CANBIST Mask */ + +#define SYS_SRAM_BISTCTL_USBBIST_Pos (4) /*!< SYS_T::SRAM_BISTCTL: USBBIST Position */ +#define SYS_SRAM_BISTCTL_USBBIST_Msk (0x1ul << SYS_SRAM_BISTCTL_USBBIST_Pos) /*!< SYS_T::SRAM_BISTCTL: USBBIST Mask */ + +#define SYS_SRAM_BISTCTL_SPIMBIST_Pos (5) /*!< SYS_T::SRAM_BISTCTL: SPIMBIST Position */ +#define SYS_SRAM_BISTCTL_SPIMBIST_Msk (0x1ul << SYS_SRAM_BISTCTL_SPIMBIST_Pos) /*!< SYS_T::SRAM_BISTCTL: SPIMBIST Mask */ + +#define SYS_SRAM_BISTCTL_EMCBIST_Pos (6) /*!< SYS_T::SRAM_BISTCTL: EMCBIST Position */ +#define SYS_SRAM_BISTCTL_EMCBIST_Msk (0x1ul << SYS_SRAM_BISTCTL_EMCBIST_Pos) /*!< SYS_T::SRAM_BISTCTL: EMCBIST Mask */ + +#define SYS_SRAM_BISTCTL_PDMABIST_Pos (7) /*!< SYS_T::SRAM_BISTCTL: PDMABIST Position */ +#define SYS_SRAM_BISTCTL_PDMABIST_Msk (0x1ul << SYS_SRAM_BISTCTL_PDMABIST_Pos) /*!< SYS_T::SRAM_BISTCTL: PDMABIST Mask */ + +#define SYS_SRAM_BISTCTL_HSUSBDBIST_Pos (8) /*!< SYS_T::SRAM_BISTCTL: HSUSBDBIST Position*/ +#define SYS_SRAM_BISTCTL_HSUSBDBIST_Msk (0x1ul << SYS_SRAM_BISTCTL_HSUSBDBIST_Pos) /*!< SYS_T::SRAM_BISTCTL: HSUSBDBIST Mask */ + +#define SYS_SRAM_BISTCTL_HSUSBHBIST_Pos (9) /*!< SYS_T::SRAM_BISTCTL: HSUSBHBIST Position*/ +#define SYS_SRAM_BISTCTL_HSUSBHBIST_Msk (0x1ul << SYS_SRAM_BISTCTL_HSUSBHBIST_Pos) /*!< SYS_T::SRAM_BISTCTL: HSUSBHBIST Mask */ + +#define SYS_SRAM_BISTCTL_SRB0S0_Pos (16) /*!< SYS_T::SRAM_BISTCTL: SRB0S0 Position */ +#define SYS_SRAM_BISTCTL_SRB0S0_Msk (0x1ul << SYS_SRAM_BISTCTL_SRB0S0_Pos) /*!< SYS_T::SRAM_BISTCTL: SRB0S0 Mask */ + +#define SYS_SRAM_BISTCTL_SRB0S1_Pos (17) /*!< SYS_T::SRAM_BISTCTL: SRB0S1 Position */ +#define SYS_SRAM_BISTCTL_SRB0S1_Msk (0x1ul << SYS_SRAM_BISTCTL_SRB0S1_Pos) /*!< SYS_T::SRAM_BISTCTL: SRB0S1 Mask */ + +#define SYS_SRAM_BISTCTL_SRB1S0_Pos (18) /*!< SYS_T::SRAM_BISTCTL: SRB1S0 Position */ +#define SYS_SRAM_BISTCTL_SRB1S0_Msk (0x1ul << SYS_SRAM_BISTCTL_SRB1S0_Pos) /*!< SYS_T::SRAM_BISTCTL: SRB1S0 Mask */ + +#define SYS_SRAM_BISTCTL_SRB1S1_Pos (19) /*!< SYS_T::SRAM_BISTCTL: SRB1S1 Position */ +#define SYS_SRAM_BISTCTL_SRB1S1_Msk (0x1ul << SYS_SRAM_BISTCTL_SRB1S1_Pos) /*!< SYS_T::SRAM_BISTCTL: SRB1S1 Mask */ + +#define SYS_SRAM_BISTCTL_SRB1S2_Pos (20) /*!< SYS_T::SRAM_BISTCTL: SRB1S2 Position */ +#define SYS_SRAM_BISTCTL_SRB1S2_Msk (0x1ul << SYS_SRAM_BISTCTL_SRB1S2_Pos) /*!< SYS_T::SRAM_BISTCTL: SRB1S2 Mask */ + +#define SYS_SRAM_BISTCTL_SRB1S3_Pos (21) /*!< SYS_T::SRAM_BISTCTL: SRB1S3 Position */ +#define SYS_SRAM_BISTCTL_SRB1S3_Msk (0x1ul << SYS_SRAM_BISTCTL_SRB1S3_Pos) /*!< SYS_T::SRAM_BISTCTL: SRB1S3 Mask */ + +#define SYS_SRAM_BISTCTL_SRB1S4_Pos (22) /*!< SYS_T::SRAM_BISTCTL: SRB1S4 Position */ +#define SYS_SRAM_BISTCTL_SRB1S4_Msk (0x1ul << SYS_SRAM_BISTCTL_SRB1S4_Pos) /*!< SYS_T::SRAM_BISTCTL: SRB1S4 Mask */ + +#define SYS_SRAM_BISTCTL_SRB1S5_Pos (23) /*!< SYS_T::SRAM_BISTCTL: SRB1S5 Position */ +#define SYS_SRAM_BISTCTL_SRB1S5_Msk (0x1ul << SYS_SRAM_BISTCTL_SRB1S5_Pos) /*!< SYS_T::SRAM_BISTCTL: SRB1S5 Mask */ + +#define SYS_SRAM_BISTSTS_SRBISTEF0_Pos (0) /*!< SYS_T::SRAM_BISTSTS: SRBISTEF0 Position*/ +#define SYS_SRAM_BISTSTS_SRBISTEF0_Msk (0x1ul << SYS_SRAM_BISTSTS_SRBISTEF0_Pos) /*!< SYS_T::SRAM_BISTSTS: SRBISTEF0 Mask */ + +#define SYS_SRAM_BISTSTS_SRBISTEF1_Pos (1) /*!< SYS_T::SRAM_BISTSTS: SRBISTEF1 Position*/ +#define SYS_SRAM_BISTSTS_SRBISTEF1_Msk (0x1ul << SYS_SRAM_BISTSTS_SRBISTEF1_Pos) /*!< SYS_T::SRAM_BISTSTS: SRBISTEF1 Mask */ + +#define SYS_SRAM_BISTSTS_CRBISTEF_Pos (2) /*!< SYS_T::SRAM_BISTSTS: CRBISTEF Position */ +#define SYS_SRAM_BISTSTS_CRBISTEF_Msk (0x1ul << SYS_SRAM_BISTSTS_CRBISTEF_Pos) /*!< SYS_T::SRAM_BISTSTS: CRBISTEF Mask */ + +#define SYS_SRAM_BISTSTS_CANBEF_Pos (3) /*!< SYS_T::SRAM_BISTSTS: CANBEF Position */ +#define SYS_SRAM_BISTSTS_CANBEF_Msk (0x1ul << SYS_SRAM_BISTSTS_CANBEF_Pos) /*!< SYS_T::SRAM_BISTSTS: CANBEF Mask */ + +#define SYS_SRAM_BISTSTS_USBBEF_Pos (4) /*!< SYS_T::SRAM_BISTSTS: USBBEF Position */ +#define SYS_SRAM_BISTSTS_USBBEF_Msk (0x1ul << SYS_SRAM_BISTSTS_USBBEF_Pos) /*!< SYS_T::SRAM_BISTSTS: USBBEF Mask */ + +#define SYS_SRAM_BISTSTS_SRBEND0_Pos (16) /*!< SYS_T::SRAM_BISTSTS: SRBEND0 Position */ +#define SYS_SRAM_BISTSTS_SRBEND0_Msk (0x1ul << SYS_SRAM_BISTSTS_SRBEND0_Pos) /*!< SYS_T::SRAM_BISTSTS: SRBEND0 Mask */ + +#define SYS_SRAM_BISTSTS_SRBEND1_Pos (17) /*!< SYS_T::SRAM_BISTSTS: SRBEND1 Position */ +#define SYS_SRAM_BISTSTS_SRBEND1_Msk (0x1ul << SYS_SRAM_BISTSTS_SRBEND1_Pos) /*!< SYS_T::SRAM_BISTSTS: SRBEND1 Mask */ + +#define SYS_SRAM_BISTSTS_CRBEND_Pos (18) /*!< SYS_T::SRAM_BISTSTS: CRBEND Position */ +#define SYS_SRAM_BISTSTS_CRBEND_Msk (0x1ul << SYS_SRAM_BISTSTS_CRBEND_Pos) /*!< SYS_T::SRAM_BISTSTS: CRBEND Mask */ + +#define SYS_SRAM_BISTSTS_CANBEND_Pos (19) /*!< SYS_T::SRAM_BISTSTS: CANBEND Position */ +#define SYS_SRAM_BISTSTS_CANBEND_Msk (0x1ul << SYS_SRAM_BISTSTS_CANBEND_Pos) /*!< SYS_T::SRAM_BISTSTS: CANBEND Mask */ + +#define SYS_SRAM_BISTSTS_USBBEND_Pos (20) /*!< SYS_T::SRAM_BISTSTS: USBBEND Position */ +#define SYS_SRAM_BISTSTS_USBBEND_Msk (0x1ul << SYS_SRAM_BISTSTS_USBBEND_Pos) /*!< SYS_T::SRAM_BISTSTS: USBBEND Mask */ + +#define SYS_HIRCTCTL_FREQSEL_Pos (0) /*!< SYS_T::HIRCTCTL: FREQSEL Position */ +#define SYS_HIRCTCTL_FREQSEL_Msk (0x3ul << SYS_HIRCTCTL_FREQSEL_Pos) /*!< SYS_T::HIRCTCTL: FREQSEL Mask */ + +#define SYS_HIRCTCTL_LOOPSEL_Pos (4) /*!< SYS_T::HIRCTCTL: LOOPSEL Position */ +#define SYS_HIRCTCTL_LOOPSEL_Msk (0x3ul << SYS_HIRCTCTL_LOOPSEL_Pos) /*!< SYS_T::HIRCTCTL: LOOPSEL Mask */ + +#define SYS_HIRCTCTL_RETRYCNT_Pos (6) /*!< SYS_T::HIRCTCTL: RETRYCNT Position */ +#define SYS_HIRCTCTL_RETRYCNT_Msk (0x3ul << SYS_HIRCTCTL_RETRYCNT_Pos) /*!< SYS_T::HIRCTCTL: RETRYCNT Mask */ + +#define SYS_HIRCTCTL_CESTOPEN_Pos (8) /*!< SYS_T::HIRCTCTL: CESTOPEN Position */ +#define SYS_HIRCTCTL_CESTOPEN_Msk (0x1ul << SYS_HIRCTCTL_CESTOPEN_Pos) /*!< SYS_T::HIRCTCTL: CESTOPEN Mask */ + +#define SYS_HIRCTCTL_BOUNDEN_Pos (9) /*!< SYS_T::HIRCTCTL: BOUNDEN Position */ +#define SYS_HIRCTCTL_BOUNDEN_Msk (0x1ul << SYS_HIRCTCTL_BOUNDEN_Pos) /*!< SYS_T::HIRCTCTL: BOUNDEN Mask */ + +#define SYS_HIRCTCTL_REFCKSEL_Pos (10) /*!< SYS_T::HIRCTCTL: REFCKSEL Position */ +#define SYS_HIRCTCTL_REFCKSEL_Msk (0x1ul << SYS_HIRCTCTL_REFCKSEL_Pos) /*!< SYS_T::HIRCTCTL: REFCKSEL Mask */ + +#define SYS_HIRCTCTL_BOUNDARY_Pos (16) /*!< SYS_T::HIRCTCTL: BOUNDARY Position */ +#define SYS_HIRCTCTL_BOUNDARY_Msk (0x1ful << SYS_HIRCTCTL_BOUNDARY_Pos) /*!< SYS_T::HIRCTCTL: BOUNDARY Mask */ + +#define SYS_HIRCTIEN_TFAILIEN_Pos (1) /*!< SYS_T::HIRCTIEN: TFAILIEN Position */ +#define SYS_HIRCTIEN_TFAILIEN_Msk (0x1ul << SYS_HIRCTIEN_TFAILIEN_Pos) /*!< SYS_T::HIRCTIEN: TFAILIEN Mask */ + +#define SYS_HIRCTIEN_CLKEIEN_Pos (2) /*!< SYS_T::HIRCTIEN: CLKEIEN Position */ +#define SYS_HIRCTIEN_CLKEIEN_Msk (0x1ul << SYS_HIRCTIEN_CLKEIEN_Pos) /*!< SYS_T::HIRCTIEN: CLKEIEN Mask */ + +#define SYS_HIRCTISTS_FREQLOCK_Pos (0) /*!< SYS_T::HIRCTISTS: FREQLOCK Position */ +#define SYS_HIRCTISTS_FREQLOCK_Msk (0x1ul << SYS_HIRCTISTS_FREQLOCK_Pos) /*!< SYS_T::HIRCTISTS: FREQLOCK Mask */ + +#define SYS_HIRCTISTS_TFAILIF_Pos (1) /*!< SYS_T::HIRCTISTS: TFAILIF Position */ +#define SYS_HIRCTISTS_TFAILIF_Msk (0x1ul << SYS_HIRCTISTS_TFAILIF_Pos) /*!< SYS_T::HIRCTISTS: TFAILIF Mask */ + +#define SYS_HIRCTISTS_CLKERRIF_Pos (2) /*!< SYS_T::HIRCTISTS: CLKERRIF Position */ +#define SYS_HIRCTISTS_CLKERRIF_Msk (0x1ul << SYS_HIRCTISTS_CLKERRIF_Pos) /*!< SYS_T::HIRCTISTS: CLKERRIF Mask */ + +#define SYS_HIRCTISTS_OVBDIF_Pos (3) /*!< SYS_T::HIRCTISTS: OVBDIF Position */ +#define SYS_HIRCTISTS_OVBDIF_Msk (0x1ul << SYS_HIRCTISTS_OVBDIF_Pos) /*!< SYS_T::HIRCTISTS: OVBDIF Mask */ + +#define SYS_IRCTCTL_FREQSEL_Pos (0) /*!< SYS_T::IRCTCTL: FREQSEL Position */ +#define SYS_IRCTCTL_FREQSEL_Msk (0x3ul << SYS_IRCTCTL_FREQSEL_Pos) /*!< SYS_T::IRCTCTL: FREQSEL Mask */ + +#define SYS_IRCTCTL_LOOPSEL_Pos (4) /*!< SYS_T::IRCTCTL: LOOPSEL Position */ +#define SYS_IRCTCTL_LOOPSEL_Msk (0x3ul << SYS_IRCTCTL_LOOPSEL_Pos) /*!< SYS_T::IRCTCTL: LOOPSEL Mask */ + +#define SYS_IRCTCTL_RETRYCNT_Pos (6) /*!< SYS_T::IRCTCTL: RETRYCNT Position */ +#define SYS_IRCTCTL_RETRYCNT_Msk (0x3ul << SYS_IRCTCTL_RETRYCNT_Pos) /*!< SYS_T::IRCTCTL: RETRYCNT Mask */ + +#define SYS_IRCTCTL_CESTOPEN_Pos (8) /*!< SYS_T::IRCTCTL: CESTOPEN Position */ +#define SYS_IRCTCTL_CESTOPEN_Msk (0x1ul << SYS_IRCTCTL_CESTOPEN_Pos) /*!< SYS_T::IRCTCTL: CESTOPEN Mask */ + +#define SYS_IRCTCTL_REFCKSEL_Pos (10) /*!< SYS_T::IRCTCTL: REFCKSEL Position */ +#define SYS_IRCTCTL_REFCKSEL_Msk (0x1ul << SYS_IRCTCTL_REFCKSEL_Pos) /*!< SYS_T::IRCTCTL: REFCKSEL Mask */ + +#define SYS_IRCTIEN_TFAILIEN_Pos (1) /*!< SYS_T::IRCTIEN: TFAILIEN Position */ +#define SYS_IRCTIEN_TFAILIEN_Msk (0x1ul << SYS_IRCTIEN_TFAILIEN_Pos) /*!< SYS_T::IRCTIEN: TFAILIEN Mask */ + +#define SYS_IRCTIEN_CLKEIEN_Pos (2) /*!< SYS_T::IRCTIEN: CLKEIEN Position */ +#define SYS_IRCTIEN_CLKEIEN_Msk (0x1ul << SYS_IRCTIEN_CLKEIEN_Pos) /*!< SYS_T::IRCTIEN: CLKEIEN Mask */ + +#define SYS_IRCTISTS_FREQLOCK_Pos (0) /*!< SYS_T::IRCTISTS: FREQLOCK Position */ +#define SYS_IRCTISTS_FREQLOCK_Msk (0x1ul << SYS_IRCTISTS_FREQLOCK_Pos) /*!< SYS_T::IRCTISTS: FREQLOCK Mask */ + +#define SYS_IRCTISTS_TFAILIF_Pos (1) /*!< SYS_T::IRCTISTS: TFAILIF Position */ +#define SYS_IRCTISTS_TFAILIF_Msk (0x1ul << SYS_IRCTISTS_TFAILIF_Pos) /*!< SYS_T::IRCTISTS: TFAILIF Mask */ + +#define SYS_IRCTISTS_CLKERRIF_Pos (2) /*!< SYS_T::IRCTISTS: CLKERRIF Position */ +#define SYS_IRCTISTS_CLKERRIF_Msk (0x1ul << SYS_IRCTISTS_CLKERRIF_Pos) /*!< SYS_T::IRCTISTS: CLKERRIF Mask */ + +#define SYS_REGLCTL_REGLCTL_Pos (0) /*!< SYS_T::REGLCTL: REGLCTL Position */ +#define SYS_REGLCTL_REGLCTL_Msk (0x1ul << SYS_REGLCTL_REGLCTL_Pos) /*!< SYS_T::REGLCTL: REGLCTL Mask */ + +#define SYS_PORDISAN_POROFFAN_Pos (0) /*!< SYS_T::PORDISAN: POROFFAN Position */ +#define SYS_PORDISAN_POROFFAN_Msk (0xfffful << SYS_PORDISAN_POROFFAN_Pos) /*!< SYS_T::PORDISAN: POROFFAN Mask */ + +#define SYS_CSERVER_VERSION_Pos (0) /*!< SYS_T::CSERVER: VERSION Position */ +#define SYS_CSERVER_VERSION_Msk (0xfful << SYS_CSERVER_VERSION_Pos) /*!< SYS_T::CSERVER: VERSION Mask */ + +#define SYS_PLCTL_PLSEL_Pos (0) /*!< SYS_T::PLCTL: PLSEL Position */ +#define SYS_PLCTL_PLSEL_Msk (0x3ul << SYS_PLCTL_PLSEL_Pos) /*!< SYS_T::PLCTL: PLSEL Mask */ + +#define SYS_PLCTL_LVSSTEP_Pos (16) /*!< SYS_T::PLCTL: LVSSTEP Position */ +#define SYS_PLCTL_LVSSTEP_Msk (0x3ful << SYS_PLCTL_LVSSTEP_Pos) /*!< SYS_T::PLCTL: LVSSTEP Mask */ + +#define SYS_PLCTL_LVSPRD_Pos (24) /*!< SYS_T::PLCTL: LVSPRD Position */ +#define SYS_PLCTL_LVSPRD_Msk (0xfful << SYS_PLCTL_LVSPRD_Pos) /*!< SYS_T::PLCTL: LVSPRD Mask */ + +#define SYS_PLSTS_PLCBUSY_Pos (0) /*!< SYS_T::PLSTS: PLCBUSY Position */ +#define SYS_PLSTS_PLCBUSY_Msk (0x1ul << SYS_PLSTS_PLCBUSY_Pos) /*!< SYS_T::PLSTS: PLCBUSY Mask */ + +#define SYS_PLSTS_PLSTATUS_Pos (8) /*!< SYS_T::PLSTS: PLSTATUS Position */ +#define SYS_PLSTS_PLSTATUS_Msk (0x3ul << SYS_PLSTS_PLSTATUS_Pos) /*!< SYS_T::PLSTS: PLSTATUS Mask */ + +#define SYS_AHBMCTL_INTACTEN_Pos (0) /*!< SYS_T::AHBMCTL: INTACTEN Position */ +#define SYS_AHBMCTL_INTACTEN_Msk (0x1ul << SYS_AHBMCTL_INTACTEN_Pos) /*!< SYS_T::AHBMCTL: INTACTEN Mask */ + +/**@}*/ /* SYS_CONST */ +/**@}*/ /* end of SYS register group */ + +/** + @addtogroup NMI NMI Controller (NMI) + Memory Mapped Structure for NMI Controller +@{ */ + +typedef struct +{ + + + /** + * @var NMI_T::NMIEN + * Offset: 0x00 NMI Source Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BODOUT |BOD NMI Source Enable (Write Protect) + * | | |0 = BOD NMI source Disabled. + * | | |1 = BOD NMI source Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[1] |IRC_INT |IRC TRIM NMI Source Enable (Write Protect) + * | | |0 = IRC TRIM NMI source Disabled. + * | | |1 = IRC TRIM NMI source Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[2] |PWRWU_INT |Power-down Mode Wake-up NMI Source Enable (Write Protect) + * | | |0 = Power-down mode wake-up NMI source Disabled. + * | | |1 = Power-down mode wake-up NMI source Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[3] |SRAM_PERR |SRAM Parity Check NMI Source Enable (Write Protect) + * | | |0 = SRAM parity check error NMI source Disabled. + * | | |1 = SRAM parity check error NMI source Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[4] |CLKFAIL |Clock Fail Detected and IRC Auto Trim Interrupt NMI Source Enable (Write Protect) + * | | |0 = Clock fail detected and IRC Auto Trim interrupt NMI source Disabled. + * | | |1 = Clock fail detected and IRC Auto Trim interrupt NMI source Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[6] |RTC_INT |RTC NMI Source Enable (Write Protect) + * | | |0 = RTC NMI source Disabled. + * | | |1 = RTC NMI source Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[7] |TAMPER_INT|TAMPER_INT NMI Source Enable (Write Protect) + * | | |0 = Backup register tamper detected NMI source Disabled. + * | | |1 = Backup register tamper detected NMI source Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[8] |EINT0 |External Interrupt From PA.6 or PB.5 Pin NMI Source Enable (Write Protect) + * | | |0 = External interrupt from PA.6 or PB.5 pin NMI source Disabled. + * | | |1 = External interrupt from PA.6 or PB.5 pin NMI source Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[9] |EINT1 |External Interrupt From PA.7, PB.4 or PD.15 Pin NMI Source Enable (Write Protect) + * | | |0 = External interrupt from PA.7, PB.4 or PD.15 pin NMI source Disabled. + * | | |1 = External interrupt from PA.7, PB.4 or PD.15 pin NMI source Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[10] |EINT2 |External Interrupt From PB.3 or PC.6 Pin NMI Source Enable (Write Protect) + * | | |0 = External interrupt from PB.3 or PC.6 pin NMI source Disabled. + * | | |1 = External interrupt from PB.3 or PC.6 pin NMI source Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[11] |EINT3 |External Interrupt From PB.2 or PC.7 Pin NMI Source Enable (Write Protect) + * | | |0 = External interrupt from PB.2 or PC.7 pin NMI source Disabled. + * | | |1 = External interrupt from PB.2 or PC.7 pin NMI source Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[12] |EINT4 |External Interrupt From PA.8, PB.6 or PF.15 Pin NMI Source Enable (Write Protect) + * | | |0 = External interrupt from PA.8, PB.6 or PF.15 pin NMI source Disabled. + * | | |1 = External interrupt from PA.8, PB.6 or PF.15 pin NMI source Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[13] |EINT5 |External Interrupt From PB.7 or PF.14 Pin NMI Source Enable (Write Protect) + * | | |0 = External interrupt from PB.7 or PF.14 pin NMI source Disabled. + * | | |1 = External interrupt from PB.7 or PF.14 pin NMI source Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[14] |UART0_INT |UART0 NMI Source Enable (Write Protect) + * | | |0 = UART0 NMI source Disabled. + * | | |1 = UART0 NMI source Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[15] |UART1_INT |UART1 NMI Source Enable (Write Protect) + * | | |0 = UART1 NMI source Disabled. + * | | |1 = UART1 NMI source Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * @var NMI_T::NMISTS + * Offset: 0x04 NMI Source Interrupt Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BODOUT |BOD Interrupt Flag (Read Only) + * | | |0 = BOD interrupt is deasserted. + * | | |1 = BOD interrupt is asserted. + * |[1] |IRC_INT |IRC TRIM Interrupt Flag (Read Only) + * | | |0 = HIRC TRIM interrupt is deasserted. + * | | |1 = HIRC TRIM interrupt is asserted. + * |[2] |PWRWU_INT |Power-down Mode Wake-up Interrupt Flag (Read Only) + * | | |0 = Power-down mode wake-up interrupt is deasserted. + * | | |1 = Power-down mode wake-up interrupt is asserted. + * |[3] |SRAM_PERR |SRAM ParityCheck Error Interrupt Flag (Read Only) + * | | |0 = SRAM parity check error interrupt is deasserted. + * | | |1 = SRAM parity check error interrupt is asserted. + * |[4] |CLKFAIL |Clock Fail Detected or IRC Auto Trim Interrupt Flag (Read Only) + * | | |0 = Clock fail detected or IRC Auto Trim interrupt is deasserted. + * | | |1 = Clock fail detected or IRC Auto Trim interrupt is asserted. + * |[6] |RTC_INT |RTC Interrupt Flag (Read Only) + * | | |0 = RTC interrupt is deasserted. + * | | |1 = RTC interrupt is asserted. + * |[7] |TAMPER_INT|TAMPER_INT Interrupt Flag (Read Only) + * | | |0 = Backup register tamper detected interrupt is deasserted. + * | | |1 = Backup register tamper detected interrupt is asserted. + * |[8] |EINT0 |External Interrupt From PA.6 or PB.5 Pin Interrupt Flag (Read Only) + * | | |0 = External Interrupt from PA.6 or PB.5 interrupt is deasserted. + * | | |1 = External Interrupt from PA.6 or PB.5 interrupt is asserted. + * |[9] |EINT1 |External Interrupt From PA.7, PB.4 or PD.15 Pin Interrupt Flag (Read Only) + * | | |0 = External Interrupt from PA.7, PB.4 or PD.15 interrupt is deasserted. + * | | |1 = External Interrupt from PA.7, PB.4 or PD.15 interrupt is asserted. + * |[10] |EINT2 |External Interrupt From PB.3 or PC.6 Pin Interrupt Flag (Read Only) + * | | |0 = External Interrupt from PB.3 or PC.6 interrupt is deasserted. + * | | |1 = External Interrupt from PB.3 or PC.6 interrupt is asserted. + * |[11] |EINT3 |External Interrupt From PB.2 or PC.7 Pin Interrupt Flag (Read Only) + * | | |0 = External Interrupt from PB.2 or PC.7 interrupt is deasserted. + * | | |1 = External Interrupt from PB.2 or PC.7 interrupt is asserted. + * |[12] |EINT4 |External Interrupt From PA.8, PB.6 or PF.15 Pin Interrupt Flag (Read Only) + * | | |0 = External Interrupt from PA.8, PB.6 or PF.15 interrupt is deasserted. + * | | |1 = External Interrupt from PA.8, PB.6 or PF.15 interrupt is asserted. + * |[13] |EINT5 |External Interrupt From PB.7 or PF.14 Pin Interrupt Flag (Read Only) + * | | |0 = External Interrupt from PB.7 or PF.14 interrupt is deasserted. + * | | |1 = External Interrupt from PB.7 or PF.14 interrupt is asserted. + * |[14] |UART0_INT |UART0 Interrupt Flag (Read Only) + * | | |0 = UART1 interrupt is deasserted. + * | | |1 = UART1 interrupt is asserted. + * |[15] |UART1_INT |UART1 Interrupt Flag (Read Only) + * | | |0 = UART1 interrupt is deasserted. + * | | |1 = UART1 interrupt is asserted. + */ + __IO uint32_t NMIEN; /*!< [0x0000] NMI Source Interrupt Enable Register */ + __I uint32_t NMISTS; /*!< [0x0004] NMI Source Interrupt Status Register */ + +} NMI_T; + +/** + @addtogroup NMI_CONST NMI Bit Field Definition + Constant Definitions for NMI Controller +@{ */ + +#define NMI_NMIEN_BODOUT_Pos (0) /*!< NMI_T::NMIEN: BODOUT Position */ +#define NMI_NMIEN_BODOUT_Msk (0x1ul << NMI_NMIEN_BODOUT_Pos) /*!< NMI_T::NMIEN: BODOUT Mask */ + +#define NMI_NMIEN_IRC_INT_Pos (1) /*!< NMI_T::NMIEN: IRC_INT Position */ +#define NMI_NMIEN_IRC_INT_Msk (0x1ul << NMI_NMIEN_IRC_INT_Pos) /*!< NMI_T::NMIEN: IRC_INT Mask */ + +#define NMI_NMIEN_PWRWU_INT_Pos (2) /*!< NMI_T::NMIEN: PWRWU_INT Position */ +#define NMI_NMIEN_PWRWU_INT_Msk (0x1ul << NMI_NMIEN_PWRWU_INT_Pos) /*!< NMI_T::NMIEN: PWRWU_INT Mask */ + +#define NMI_NMIEN_SRAM_PERR_Pos (3) /*!< NMI_T::NMIEN: SRAM_PERR Position */ +#define NMI_NMIEN_SRAM_PERR_Msk (0x1ul << NMI_NMIEN_SRAM_PERR_Pos) /*!< NMI_T::NMIEN: SRAM_PERR Mask */ + +#define NMI_NMIEN_CLKFAIL_Pos (4) /*!< NMI_T::NMIEN: CLKFAIL Position */ +#define NMI_NMIEN_CLKFAIL_Msk (0x1ul << NMI_NMIEN_CLKFAIL_Pos) /*!< NMI_T::NMIEN: CLKFAIL Mask */ + +#define NMI_NMIEN_RTC_INT_Pos (6) /*!< NMI_T::NMIEN: RTC_INT Position */ +#define NMI_NMIEN_RTC_INT_Msk (0x1ul << NMI_NMIEN_RTC_INT_Pos) /*!< NMI_T::NMIEN: RTC_INT Mask */ + +#define NMI_NMIEN_TAMPER_INT_Pos (7) /*!< NMI_T::NMIEN: TAMPER_INT Position */ +#define NMI_NMIEN_TAMPER_INT_Msk (0x1ul << NMI_NMIEN_TAMPER_INT_Pos) /*!< NMI_T::NMIEN: TAMPER_INT Mask */ + +#define NMI_NMIEN_EINT0_Pos (8) /*!< NMI_T::NMIEN: EINT0 Position */ +#define NMI_NMIEN_EINT0_Msk (0x1ul << NMI_NMIEN_EINT0_Pos) /*!< NMI_T::NMIEN: EINT0 Mask */ + +#define NMI_NMIEN_EINT1_Pos (9) /*!< NMI_T::NMIEN: EINT1 Position */ +#define NMI_NMIEN_EINT1_Msk (0x1ul << NMI_NMIEN_EINT1_Pos) /*!< NMI_T::NMIEN: EINT1 Mask */ + +#define NMI_NMIEN_EINT2_Pos (10) /*!< NMI_T::NMIEN: EINT2 Position */ +#define NMI_NMIEN_EINT2_Msk (0x1ul << NMI_NMIEN_EINT2_Pos) /*!< NMI_T::NMIEN: EINT2 Mask */ + +#define NMI_NMIEN_EINT3_Pos (11) /*!< NMI_T::NMIEN: EINT3 Position */ +#define NMI_NMIEN_EINT3_Msk (0x1ul << NMI_NMIEN_EINT3_Pos) /*!< NMI_T::NMIEN: EINT3 Mask */ + +#define NMI_NMIEN_EINT4_Pos (12) /*!< NMI_T::NMIEN: EINT4 Position */ +#define NMI_NMIEN_EINT4_Msk (0x1ul << NMI_NMIEN_EINT4_Pos) /*!< NMI_T::NMIEN: EINT4 Mask */ + +#define NMI_NMIEN_EINT5_Pos (13) /*!< NMI_T::NMIEN: EINT5 Position */ +#define NMI_NMIEN_EINT5_Msk (0x1ul << NMI_NMIEN_EINT5_Pos) /*!< NMI_T::NMIEN: EINT5 Mask */ + +#define NMI_NMIEN_UART0_INT_Pos (14) /*!< NMI_T::NMIEN: UART0_INT Position */ +#define NMI_NMIEN_UART0_INT_Msk (0x1ul << NMI_NMIEN_UART0_INT_Pos) /*!< NMI_T::NMIEN: UART0_INT Mask */ + +#define NMI_NMIEN_UART1_INT_Pos (15) /*!< NMI_T::NMIEN: UART1_INT Position */ +#define NMI_NMIEN_UART1_INT_Msk (0x1ul << NMI_NMIEN_UART1_INT_Pos) /*!< NMI_T::NMIEN: UART1_INT Mask */ + +#define NMI_NMISTS_BODOUT_Pos (0) /*!< NMI_T::NMISTS: BODOUT Position */ +#define NMI_NMISTS_BODOUT_Msk (0x1ul << NMI_NMISTS_BODOUT_Pos) /*!< NMI_T::NMISTS: BODOUT Mask */ + +#define NMI_NMISTS_IRC_INT_Pos (1) /*!< NMI_T::NMISTS: IRC_INT Position */ +#define NMI_NMISTS_IRC_INT_Msk (0x1ul << NMI_NMISTS_IRC_INT_Pos) /*!< NMI_T::NMISTS: IRC_INT Mask */ + +#define NMI_NMISTS_PWRWU_INT_Pos (2) /*!< NMI_T::NMISTS: PWRWU_INT Position */ +#define NMI_NMISTS_PWRWU_INT_Msk (0x1ul << NMI_NMISTS_PWRWU_INT_Pos) /*!< NMI_T::NMISTS: PWRWU_INT Mask */ + +#define NMI_NMISTS_SRAM_PERR_Pos (3) /*!< NMI_T::NMISTS: SRAM_PERR Position */ +#define NMI_NMISTS_SRAM_PERR_Msk (0x1ul << NMI_NMISTS_SRAM_PERR_Pos) /*!< NMI_T::NMISTS: SRAM_PERR Mask */ + +#define NMI_NMISTS_CLKFAIL_Pos (4) /*!< NMI_T::NMISTS: CLKFAIL Position */ +#define NMI_NMISTS_CLKFAIL_Msk (0x1ul << NMI_NMISTS_CLKFAIL_Pos) /*!< NMI_T::NMISTS: CLKFAIL Mask */ + +#define NMI_NMISTS_RTC_INT_Pos (6) /*!< NMI_T::NMISTS: RTC_INT Position */ +#define NMI_NMISTS_RTC_INT_Msk (0x1ul << NMI_NMISTS_RTC_INT_Pos) /*!< NMI_T::NMISTS: RTC_INT Mask */ + +#define NMI_NMISTS_TAMPER_INT_Pos (7) /*!< NMI_T::NMISTS: TAMPER_INT Position */ +#define NMI_NMISTS_TAMPER_INT_Msk (0x1ul << NMI_NMISTS_TAMPER_INT_Pos) /*!< NMI_T::NMISTS: TAMPER_INT Mask */ + +#define NMI_NMISTS_EINT0_Pos (8) /*!< NMI_T::NMISTS: EINT0 Position */ +#define NMI_NMISTS_EINT0_Msk (0x1ul << NMI_NMISTS_EINT0_Pos) /*!< NMI_T::NMISTS: EINT0 Mask */ + +#define NMI_NMISTS_EINT1_Pos (9) /*!< NMI_T::NMISTS: EINT1 Position */ +#define NMI_NMISTS_EINT1_Msk (0x1ul << NMI_NMISTS_EINT1_Pos) /*!< NMI_T::NMISTS: EINT1 Mask */ + +#define NMI_NMISTS_EINT2_Pos (10) /*!< NMI_T::NMISTS: EINT2 Position */ +#define NMI_NMISTS_EINT2_Msk (0x1ul << NMI_NMISTS_EINT2_Pos) /*!< NMI_T::NMISTS: EINT2 Mask */ + +#define NMI_NMISTS_EINT3_Pos (11) /*!< NMI_T::NMISTS: EINT3 Position */ +#define NMI_NMISTS_EINT3_Msk (0x1ul << NMI_NMISTS_EINT3_Pos) /*!< NMI_T::NMISTS: EINT3 Mask */ + +#define NMI_NMISTS_EINT4_Pos (12) /*!< NMI_T::NMISTS: EINT4 Position */ +#define NMI_NMISTS_EINT4_Msk (0x1ul << NMI_NMISTS_EINT4_Pos) /*!< NMI_T::NMISTS: EINT4 Mask */ + +#define NMI_NMISTS_EINT5_Pos (13) /*!< NMI_T::NMISTS: EINT5 Position */ +#define NMI_NMISTS_EINT5_Msk (0x1ul << NMI_NMISTS_EINT5_Pos) /*!< NMI_T::NMISTS: EINT5 Mask */ + +#define NMI_NMISTS_UART0_INT_Pos (14) /*!< NMI_T::NMISTS: UART0_INT Position */ +#define NMI_NMISTS_UART0_INT_Msk (0x1ul << NMI_NMISTS_UART0_INT_Pos) /*!< NMI_T::NMISTS: UART0_INT Mask */ + +#define NMI_NMISTS_UART1_INT_Pos (15) /*!< NMI_T::NMISTS: UART1_INT Position */ +#define NMI_NMISTS_UART1_INT_Msk (0x1ul << NMI_NMISTS_UART1_INT_Pos) /*!< NMI_T::NMISTS: UART1_INT Mask */ + +/**@}*/ /* NMI_CONST */ +/**@}*/ /* end of NMI register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __SYS_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/system_M480.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/system_M480.h new file mode 100644 index 00000000000..fe12ac2f5fe --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/system_M480.h @@ -0,0 +1,76 @@ +/**************************************************************************//** + * @file system_M480.h + * @version V1.00 + * @brief CMSIS Cortex-M4 Core Peripheral Access Layer Header File for M480 + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. +*****************************************************************************/ + +#ifndef __SYSTEM_M480_H__ +#define __SYSTEM_M480_H__ + +#ifdef __cplusplus +extern "C" { +#endif + +#include + + +/*---------------------------------------------------------------------------- + Define clocks + *----------------------------------------------------------------------------*/ + +#ifndef __HSI +#define __HSI (12000000UL) /*!< PLL default output is 50MHz */ +#endif + +#ifndef __HXT +#define __HXT (12000000UL) /*!< External Crystal Clock Frequency */ +#endif + +#ifndef __LXT +#define __LXT (32768UL) /*!< External Crystal Clock Frequency 32.768KHz */ +#endif + +#define __HIRC (12000000UL) /*!< Internal 12M RC Oscillator Frequency */ +#define __LIRC (10000UL) /*!< Internal 10K RC Oscillator Frequency */ +#define __SYS_OSC_CLK ( ___HSI) /* Main oscillator frequency */ + + +#define __SYSTEM_CLOCK (1UL*__HXT) + +extern uint32_t SystemCoreClock; /*!< System Clock Frequency (Core Clock) */ +extern uint32_t CyclesPerUs; /*!< Cycles per micro second */ +extern uint32_t PllClock; /*!< PLL Output Clock Frequency */ + + +/** + * Initialize the system + * + * @param none + * @return none + * + * @brief Setup the micro controller system. + * Initialize the System and update the SystemCoreClock variable. + */ +extern void SystemInit (void); + +/** + * Update SystemCoreClock variable + * + * @param none + * @return none + * + * @brief Updates the SystemCoreClock with current core Clock + * retrieved from cpu registers. + */ +extern void SystemCoreClockUpdate (void); + +#ifdef __cplusplus +} +#endif + +#endif /* __SYSTEM_M480_H__ */ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/timer_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/timer_reg.h new file mode 100644 index 00000000000..7c3b4acdac6 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/timer_reg.h @@ -0,0 +1,1094 @@ +/**************************************************************************//** + * @file timer_reg.h + * @version V1.00 + * @brief TIMER register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __TIMER_REG_H__ +#define __TIMER_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup TIMER Timer Controller(TIMER) + Memory Mapped Structure for TIMER Controller +@{ */ + +typedef struct +{ + + + /** + * @var TIMER_T::CTL + * Offset: 0x00 Timer Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |PSC |Prescale Counter + * | | |Timer input clock or event source is divided by (PSC+1) before it is fed to the timer up counter + * | | |If this field is 0 (PSC = 0), then there is no scaling. + * | | |Note: Update prescale counter value will reset internal 8-bit prescale counter and 24-bit up counter value. + * |[19] |INTRGEN |Inter-timer Trigger Mode Enable Control + * | | |Setting this bit will enable the inter-timer trigger capture function. + * | | |The Timer0/2 will be in event counter mode and counting with external clock source or event + * | | |Also, Timer1/3 will be in trigger-counting mode of capture function. + * | | |0 = Inter-Timer Trigger Capture mode Disabled. + * | | |1 = Inter-Timer Trigger Capture mode Enabled. + * | | |Note: For Timer1/3, this bit is ignored and the read back value is always 0. + * |[20] |PERIOSEL |Periodic Mode Behavior Selection Enable Bit + * | | |0 = The behavior selection in periodic mode is Disabled. + * | | |When user updates CMPDAT while timer is running in periodic mode, + * | | |CNT will be reset to default value. + * | | |1 = The behavior selection in periodic mode is Enabled. + * | | |When user update CMPDAT while timer is running in periodic mode, the limitations as bellows list, + * | | |If updated CMPDAT value > CNT, CMPDAT will be updated and CNT keep running continually. + * | | |If updated CMPDAT value = CNT, timer time-out interrupt will be asserted immediately. + * | | |If updated CMPDAT value < CNT, CNT will be reset to default value. + * |[21] |TGLPINSEL |Toggle-output Pin Select + * | | |0 = Toggle mode output to TMx (Timer Event Counter Pin). + * | | |1 = Toggle mode output to TMx_EXT (Timer External Capture Pin). + * |[22] |CAPSRC |Capture Pin Source Selection + * | | |0 = Capture Function source is from TMx_EXT (x= 0~3) pin. + * | | |1 = Capture Function source is from internal ACMP output signal + * | | |User can set ACMPSSEL (TIMERx_EXTCTL[8]) to decide which internal ACMP output signal as timer capture source. + * |[23] |WKEN |Wake-up Function Enable Bit + * | | |If this bit is set to 1, while timer interrupt flag TIF (TIMERx_INTSTS[0]) is 1 and INTEN (TIMERx_CTL[29]) is enabled, the timer interrupt signal will generate a wake-up trigger event to CPU. + * | | |0 = Wake-up function Disabled if timer interrupt signal generated. + * | | |1 = Wake-up function Enabled if timer interrupt signal generated. + * |[24] |EXTCNTEN |Event Counter Mode Enable Bit + * | | |This bit is for external counting pin function enabled. + * | | |0 = Event counter mode Disabled. + * | | |1 = Event counter mode Enabled. + * | | |Note: When timer is used as an event counter, this bit should be set to 1 and select PCLK as timer clock source. + * |[25] |ACTSTS |Timer Active Status Bit (Read Only) + * | | |This bit indicates the 24-bit up counter status. + * | | |0 = 24-bit up counter is not active. + * | | |1 = 24-bit up counter is active. + * | | |Note: This bit may active when CNT 0 transition to CNT 1. + * |[28:27] |OPMODE |Timer Counting Mode Select + * | | |00 = The Timer controller is operated in One-shot mode. + * | | |01 = The Timer controller is operated in Periodic mode. + * | | |10 = The Timer controller is operated in Toggle-output mode. + * | | |11 = The Timer controller is operated in Continuous Counting mode. + * |[29] |INTEN |Timer Interrupt Enable Bit + * | | |0 = Timer time-out interrupt Disabled. + * | | |1 = Timer time-out interrupt Enabled. + * | | |Note: If this bit is enabled, when the timer time-out interrupt flag TIF is set to 1, the timer interrupt signal is generated and inform to CPU. + * |[30] |CNTEN |Timer Counting Enable Bit + * | | |0 = Stops/Suspends counting. + * | | |1 = Starts counting. + * | | |Note1: In stop status, and then set CNTEN to 1 will enable the 24-bit up counter to keep counting from the last stop counting value. + * | | |Note2: This bit is auto-cleared by hardware in one-shot mode (TIMER_CTL[28:27] = 00) when the timer time-out interrupt flag TIF (TIMERx_INTSTS[0]) is generated. + * | | |Note3: Set enable/disable this bit needs 2 * TMR_CLK period to become active, user can read ACTSTS (TIMERx_CTL[25]) to check enable/disable command is completed or not. + * |[31] |ICEDEBUG |ICE Debug Mode Acknowledge Disable Control (Write Protect) + * | | |0 = ICE debug mode acknowledgement effects TIMER counting. + * | | |TIMER counter will be held while CPU is held by ICE. + * | | |1 = ICE debug mode acknowledgement Disabled. + * | | |TIMER counter will keep going no matter CPU is held by ICE or not. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * @var TIMER_T::CMP + * Offset: 0x04 Timer Comparator Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:0] |CMPDAT |Timer Comparator Value + * | | |CMPDAT is a 24-bit compared value register + * | | |When the internal 24-bit up counter value is equal to CMPDAT value, the TIF (TIMERx_INTSTS[0] Timer Interrupt Flag) will set to 1. + * | | |Time-out period = (Period of timer clock input) * (8-bit PSC + 1) * (24-bit CMPDAT). + * | | |Note1: Never write 0x0 or 0x1 in CMPDAT field, or the core will run into unknown state. + * | | |Note2: When timer is operating at continuous counting mode, the 24-bit up counter will keep counting continuously even if user writes a new value into CMPDAT field + * | | |But if timer is operating at other modes, the 24-bit up counter will restart counting from 0 and using newest CMPDAT value to be the timer compared value while user writes a new value into CMPDAT field. + * @var TIMER_T::INTSTS + * Offset: 0x08 Timer Interrupt Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |TIF |Timer Interrupt Flag + * | | |This bit indicates the interrupt flag status of Timer while 24-bit timer up counter CNT (TIMERx_CNT[23:0]) value reaches to CMPDAT (TIMERx_CMP[23:0]) value. + * | | |0 = No effect. + * | | |1 = CNT value matches the CMPDAT value. + * | | |Note: This bit is cleared by writing 1 to it. + * |[1] |TWKF |Timer Wake-up Flag + * | | |This bit indicates the interrupt wake-up flag status of timer. + * | | |0 = Timer does not cause CPU wake-up. + * | | |1 = CPU wake-up from Idle or Power-down mode if timer time-out interrupt signal generated. + * | | |Note: This bit is cleared by writing 1 to it. + * @var TIMER_T::CNT + * Offset: 0x0C Timer Data Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:0] |CNT |Timer Data Register + * | | |Read operation. + * | | |Read this register to get CNT value. For example: + * | | |If EXTCNTEN (TIMERx_CTL[24] ) is 0, user can read CNT value for getting current 24-bit counter value. + * | | |If EXTCNTEN (TIMERx_CTL[24] ) is 1, user can read CNT value for getting current 24-bit event input counter value. + * | | |Write operation. + * | | |Writing any value to this register will reset current CNT value to 0 and reload internal 8-bit prescale counter. + * |[31] |RSTACT |Timer Data Register Reset Active (Read Only) + * | | |This bit indicates if the counter reset operation active. + * | | |When user writes this CNT register, timer starts to reset its internal 24-bit timer up-counter to 0 and reload 8-bit pre-scale counter + * | | |At the same time, timer set this flag to 1 to indicate the counter reset operation is in progress + * | | |Once the counter reset operation done, timer clear this bit to 0 automatically. + * | | |0 = Reset operation is done. + * | | |1 = Reset operation triggered by writing TIMERx_CNT is in progress. + * | | |Note: This bit is read only. + * @var TIMER_T::CAP + * Offset: 0x10 Timer Capture Data Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[23:0] |CAPDAT |Timer Capture Data Register + * | | |When CAPEN (TIMERx_EXTCTL[3]) bit is set, CAPFUNCS (TIMERx_EXTCTL[4]) bit is 0, and a transition on TMx_EXT pin matched the CAPEDGE (TIMERx_EXTCTL[14:12]) setting, CAPIF (TIMERx_EINTSTS[0]) will set to 1 and the current timer counter value CNT (TIMERx_CNT[23:0]) will be auto-loaded into this CAPDAT field. + * @var TIMER_T::EXTCTL + * Offset: 0x14 Timer External Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CNTPHASE |Timer External Count Phase + * | | |This bit indicates the detection phase of external counting pin TMx (x= 0~3). + * | | |0 = A falling edge of external counting pin will be counted. + * | | |1 = A rising edge of external counting pin will be counted. + * |[3] |CAPEN |Timer External Capture Pin Enable Bit + * | | |This bit enables the TMx_EXT capture pin input function. + * | | |0 =TMx_EXT (x= 0~3) pin Disabled. + * | | |1 =TMx_EXT (x= 0~3) pin Enabled. + * |[4] |CAPFUNCS |Capture Function Selection + * | | |0 = External Capture Mode Enabled. + * | | |1 = External Reset Mode Enabled. + * | | |Note1: When CAPFUNCS is 0, transition on TMx_EXT (x= 0~3) pin is using to save current 24-bit timer counter value (CNT value) to CAPDAT field. + * | | |Note2: When CAPFUNCS is 1, transition on TMx_EXT (x= 0~3) pin is using to save current 24-bit timer counter value (CNT value) to CAPDAT field then CNT value will be reset immediately. + * |[5] |CAPIEN |Timer External Capture Interrupt Enable Bit + * | | |0 = TMx_EXT (x= 0~3) pin detection Interrupt Disabled. + * | | |1 = TMx_EXT (x= 0~3) pin detection Interrupt Enabled. + * | | |Note: CAPIEN is used to enable timer external interrupt + * | | |If CAPIEN enabled, timer will rise an interrupt when CAPIF (TIMERx_EINTSTS[0]) is 1. + * | | |For example, while CAPIEN = 1, CAPEN = 1, and CAPEDGE = 00, a 1 to 0 transition on the TMx_EXT pin will cause the CAPIF to be set then the interrupt signal is generated and sent to NVIC to inform CPU. + * |[6] |CAPDBEN |Timer External Capture Pin De-bounce Enable Bit + * | | |0 = TMx_EXT (x= 0~3) pin de-bounce or ACMP output de-bounce Disabled. + * | | |1 = TMx_EXT (x= 0~3) pin de-bounce or ACMP output de-bounce Enabled. + * | | |Note: If this bit is enabled, the edge detection of TMx_EXT pin or ACMP output is detected with de-bounce circuit. + * |[7] |CNTDBEN |Timer Counter Pin De-bounce Enable Bit + * | | |0 = TMx (x= 0~3) pin de-bounce Disabled. + * | | |1 = TMx (x= 0~3) pin de-bounce Enabled. + * | | |Note: If this bit is enabled, the edge detection of TMx pin is detected with de-bounce circuit. + * |[8:10] |ICAPSEL |Internal Capture Source Select + * | | |000 = Capture Function source is from internal ACMP0 output signal. + * | | |001 = Capture Function source is from internal ACMP1 output signal. + * | | |010 = Capture Function source is from HXT. + * | | |011 = Capture Function source is from LXT. + * | | |100 = Capture Function source is from HIRC. + * | | |101 = Capture Function source is from LIRC. + * | | |110 = Reserved. + * | | |111 = Reserved. + * | | |Note: these bits only available when CAPSRC (TIMERx_CTL[22]) is 1. + * |[14:12] |CAPEDGE |Timer External Capture Pin Edge Detect + * | | |When first capture event is generated, the CNT (TIMERx_CNT[23:0]) will be reset to 0 and first CAPDAT (TIMERx_CAP[23:0]) should be to 0. + * | | |000 = Capture event occurred when detect falling edge transfer on TMx_EXT (x= 0~3) pin. + * | | |001 = Capture event occurred when detect rising edge transfer on TMx_EXT (x= 0~3) pin. + * | | |010 = Capture event occurred when detect both falling and rising edge transfer on TMx_EXT (x= 0~3) pin, and first capture event occurred at falling edge transfer. + * | | |011 = Capture event occurred when detect both rising and falling edge transfer on TMx_EXT (x= 0~3) pin, and first capture event occurred at rising edge transfer.. + * | | |110 = First capture event occurred at falling edge, follows capture events are at rising edge transfer on TMx_EXT (x= 0~3) pin. + * | | |111 = First capture event occurred at rising edge, follows capture events are at falling edge transfer on TMx_EXT (x= 0~3) pin. + * | | |100, 101 = Reserved. + * |[16] |ECNTSSEL |Event Counter Source Selection to Trigger Event Counter Function + * | | |0 = Event Counter input source is from TMx (x= 0~3) pin. + * | | |1 = Event Counter input source is from USB internal SOF output signal. + * |[31:28] |CAPDIVSCL |Timer Capture Source Divider + * | | |This bits indicate the divide scale for capture source divider + * | | |0000 = Capture source/1. + * | | |0001 = Capture source/2. + * | | |0010 = Capture source/4. + * | | |0011 = Capture source/8. + * | | |0100 = Capture source/16. + * | | |0101 = Capture source/32. + * | | |0110 = Capture source/64. + * | | |0111 = Capture source/128. + * | | |1000 = Capture source/256. + * | | |1001~1111 = Reserved. + * | | |Note: Sets INTERCAPSEL (TIMERx_EXTCTL[10:8]) and CAPSRC (TIMERx_CTL[22]) to select capture source. * @var TIMER_T::EINTSTS + * Offset: 0x18 Timer External Interrupt Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CAPIF |Timer External Capture Interrupt Flag + * | | |This bit indicates the timer external capture interrupt flag status. + * | | |0 = TMx_EXT (x= 0~3) pin interrupt did not occur. + * | | |1 = TMx_EXT (x= 0~3) pin interrupt occurred. + * | | |Note1: This bit is cleared by writing 1 to it. + * | | |Note2: When CAPEN (TIMERx_EXTCTL[3]) bit is set, CAPFUNCS (TIMERx_EXTCTL[4]) bit is 0, and a transition on TMx_EXT (x= 0~3) pin matched the CAPEDGE (TIMERx_EXTCTL[2:1]) setting, this bit will set to 1 by hardware. + * | | |Note3: There is a new incoming capture event detected before CPU clearing the CAPIF status + * | | |If the above condition occurred, the Timer will keep register TIMERx_CAP unchanged and drop the new capture value. + * @var TIMER_T::TRGCTL + * Offset: 0x1C Timer Trigger Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |TRGSSEL |Trigger Source Select Bit + * | | |This bit is used to select internal trigger source is form timer time-out interrupt signal or + * | | |capture interrupt signal. + * | | |0 = Time-out interrupt signal is used to internal trigger EPWM, BPWM, PDMA, DAC, and EADC. + * | | |1 = Capture interrupt signal is used to internal trigger EPWM, BPWM, PDMA, DAC, and EADC. + * |[1] |TRGEPWM |Trigger EPWM and BPWM Enable Bit + * | | |If this bit is set to 1, each timer time-out event or capture event can be as EPWM and BPWM counter clock source. + * | | |0 = Timer interrupt trigger EPWM and BPWM Disabled. + * | | |1 = Timer interrupt trigger EPWM and BPWM Enabled. + * | | |Note: If TRGSSEL (TIMERx_TRGCTL[0]) = 0, time-out interrupt signal as EPWM and BPWM counter clock source. + * | | |If TRGSSEL (TIMERx_TRGCTL[0]) = 1, capture interrupt signal as EPWM counter clock source. + * |[2] |TRGEADC |Trigger EADC Enable Bit + * | | |If this bit is set to 1, each timer time-out event or capture event can be triggered EADC conversion. + * | | |0 = Timer interrupt trigger EADC Disabled. + * | | |1 = Timer interrupt trigger EADC Enabled. + * | | |Note: If TRGSSEL (TIMERx_TRGCTL[0]) = 0, time-out interrupt signal will trigger EADC conversion. + * | | |If TRGSSEL (TIMERx_TRGCTL[0]) = 1, capture interrupt signal will trigger EADC conversion. + * |[3] |TRGDAC |Trigger DAC Enable Bit + * | | |If this bit is set to 1, timer time-out interrupt or capture interrupt can be triggered DAC. + * | | |0 = Timer interrupt trigger DAC Disabled. + * | | |1 = Timer interrupt trigger DAC Enabled. + * | | |Note: If TRGSSEL (TIMERx_TRGCTL[0]) = 0, time-out interrupt signal will trigger DAC. + * | | |If TRGSSEL (TIMERx_TRGCTL[0]) = 1, capture interrupt signal will trigger DAC. + * |[4] |TRGPDMA |Trigger PDMA Enable Bit + * | | |If this bit is set to 1, each timer time-out event or capture event can be triggered PDMA transfer. + * | | |0 = Timer interrupt trigger PDMA Disabled. + * | | |1 = Timer interrupt trigger PDMA Enabled. + * | | |Note: If TRGSSEL (TIMERx_TRGCTL[0]) = 0, time-out interrupt signal will trigger PDMA transfer. + * | | |If TRGSSEL (TIMERx_TRGCTL[0]) = 1, capture interrupt signal will trigger PDMA transfer. + * @var TIMER_T::ALTCTL + * Offset: 0x20 Timer Alternative Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |FUNCSEL |Function Selection + * | | |0 = Timer controller is used as timer function. + * | | |1 = Timer controller is used as PWM function. + * | | |Note: When timer is used as PWM, the clock source of time controller will be forced to PCLKx automatically. + * @var TIMER_T::PWMCTL + * Offset: 0x40 Timer PWM Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CNTEN |PWM Counter Enable Bit + * | | |0 = PWM counter and clock prescale Stop Running. + * | | |1 = PWM counter and clock prescale Start Running. + * |[2:1] |CNTTYPE |PWM Counter Behavior Type + * | | |00 = Up count type. + * | | |01 = Down count type. + * | | |10 = Up-down count type. + * | | |11 = Reserved. + * |[3] |CNTMODE |PWM Counter Mode + * | | |0 = Auto-reload mode. + * | | |1 = One-shot mode. + * |[8] |CTRLD |Center Re-load + * | | |In up-down count type, PERIOD will load to PBUF when current PWM period is completed always and CMP will load to CMPBUF at the center point of current period. + * |[9] |IMMLDEN |Immediately Load Enable Bit + * | | |0 = PERIOD will load to PBUF when current PWM period is completed no matter CTRLD is enabled/disabled + * | | |If CTRLD is disabled, CMP will load to CMPBUF when current PWM period is completed; if CTRLD is enabled in up-down count type, CMP will load to CMPBUF at the center point of current period. + * | | |1 = PERIOD/CMP will load to PBUF/CMPBUF immediately when user update PERIOD/CMP. + * | | |Note: If IMMLDEN is enabled, CTRLD will be invalid. + * |[16] |OUTMODE |PWM Output Mode + * | | |This bit controls the output mode of corresponding PWM channel. + * | | |0 = PWM independent mode. + * | | |1 = PWM complementary mode. + * |[30] |DBGHALT |ICE Debug Mode Counter Halt (Write Protect) + * | | |If debug mode counter halt is enabled, PWM counter will keep current value until exit ICE debug mode. + * | | |0 = ICE debug mode counter halt disable. + * | | |1 = ICE debug mode counter halt enable. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[31] |DBGTRIOFF |ICE Debug Mode Acknowledge Disable Bit (Write Protect) + * | | |0 = ICE debug mode acknowledgement effects PWM output. + * | | |PWM output pin will be forced as tri-state while ICE debug mode acknowledged. + * | | |1 = ICE debug mode acknowledgement disabled. + * | | |PWM output pin will keep output no matter ICE debug mode acknowledged or not. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * @var TIMER_T::PWMCLKSRC + * Offset: 0x44 Timer PWM Counter Clock Source Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2:0] |CLKSRC |PWM Counter Clock Source Select + * | | |The PWM counter clock source can be selected from TMRx_CLK or internal timer time-out or capture event. + * | | |000 = TMRx_CLK. + * | | |001 = Internal TIMER0 time-out or capture event. + * | | |010 = Internal TIMER1 time-out or capture event. + * | | |011 = Internal TIMER2 time-out or capture event. + * | | |100 = Internal TIMER3 time-out or capture event. + * | | |Others = Reserved. + * | | |Note: If TIMER0 PWM function is enabled, the PWM counter clock source can be selected from TMR0_CLK, TIMER1 interrupt events, TIMER2 interrupt events, or TIMER3 interrupt events. + * @var TIMER_T::PWMCLKPSC + * Offset: 0x48 Timer PWM Counter Clock Pre-scale Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[11:0] |CLKPSC |PWM Counter Clock Pre-scale + * | | |The active clock of PWM counter is decided by counter clock prescale and divided by (CLKPSC + 1) + * | | |If CLKPSC is 0, then there is no scaling in PWM counter clock source. + * @var TIMER_T::PWMCNTCLR + * Offset: 0x4C Timer PWM Clear Counter Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CNTCLR |Clear PWM Counter Control Bit + * | | |It is automatically cleared by hardware. + * | | |0 = No effect. + * | | |1 = Clear 16-bit PWM counter to 0x10000 in up and up-down count type and reset counter value to PERIOD in down count type. + * @var TIMER_T::PWMPERIOD + * Offset: 0x50 Timer PWM Period Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |PERIOD |PWM Period Register + * | | |In up count type: PWM counter counts from 0 to PERIOD, and restarts from 0. + * | | |In down count type: PWM counter counts from PERIOD to 0, and restarts from PERIOD. + * | | |In up-down count type: PWM counter counts from 0 to PERIOD, then decrements to 0 and repeats again. + * | | |In up and down count type: + * | | |PWM period time = (PERIOD + 1) * (CLKPSC + 1) * TMRx_PWMCLK. + * | | |In up-down count type: + * | | |PWM period time = 2 * PERIOD * (CLKPSC+ 1) * TMRx_PWMCLK. + * | | |Note: User should take care DIRF (TIMERx_PWMCNT[16]) bit in up/down/up-down count type to monitor current counter direction in each count type. + * @var TIMER_T::PWMCMPDAT + * Offset: 0x54 Timer PWM Comparator Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |CMP |PWM Comparator Register + * | | |PWM CMP is used to compare with PWM CNT to generate PWM output waveform, interrupt events and trigger ADC to start convert. + * @var TIMER_T::PWMDTCTL + * Offset: 0x58 Timer PWM Dead-Time Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[11:0] |DTCNT |Dead-time Counter (Write Protect) + * | | |The dead-time can be calculated from the following two formulas: + * | | |Dead-time = (DTCNT[11:0] + 1) * TMRx_PWMCLK, if DTCKSEL is 0. + * | | |Dead-time = (DTCNT[11:0] + 1) * TMRx_PWMCLK * (CLKPSC + 1), if DTCKSEL is 1. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[16] |DTEN |Enable Dead-time Insertion for PWMx_CH0 and PWMx_CH1 (Write Protect) + * | | |Dead-time insertion function is only active when PWM complementary mode is enabled + * | | |If dead- time insertion is inactive, the outputs of PWMx_CH0 and PWMx_CH1 are complementary without any delay. + * | | |0 = Dead-time insertion Disabled on the pin pair. + * | | |1 = Dead-time insertion Enabled on the pin pair. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[24] |DTCKSEL |Dead-time Clock Select (Write Protect) + * | | |0 = Dead-time clock source from TMRx_PWMCLK without counter clock prescale. + * | | |1 = Dead-time clock source from TMRx_PWMCLK with counter clock prescale. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * @var TIMER_T::PWMCNT + * Offset: 0x5C Timer PWM Counter Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |CNT |PWM Counter Value Register (Read Only) + * | | |User can monitor CNT to know the current counter value in 16-bit period counter. + * |[16] |DIRF |PWM Counter Direction Indicator Flag (Read Only) + * | | |0 = Counter is active in down count. + * | | |1 = Counter is active up count. + * @var TIMER_T::PWMMSKEN + * Offset: 0x60 Timer PWM Output Mask Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |MSKEN0 |PWMx_CH0 Output Mask Enable Bit + * | | |The PWMx_CH0 output signal will be masked when this bit is enabled + * | | |The PWMx_CH0 will output MSKDAT0 (TIMER_PWMMSK[0]) data. + * | | |0 = PWMx_CH0 output signal is non-masked. + * | | |1 = PWMx_CH0 output signal is masked and output MSKDAT0 data. + * |[1] |MSKEN1 |PWMx_CH1 Output Mask Enable Bit + * | | |The PWMx_CH1 output signal will be masked when this bit is enabled + * | | |The PWMx_CH1 will output MSKDAT1 (TIMER_PWMMSK[1]) data. + * | | |0 = PWMx_CH1 output signal is non-masked. + * | | |1 = PWMx_CH1 output signal is masked and output MSKDAT1 data. + * @var TIMER_T::PWMMSK + * Offset: 0x64 Timer PWM Output Mask Data Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |MSKDAT0 |PWMx_CH0 Output Mask Data Control Bit + * | | |This bit is used to control the output state of PWMx_CH0 pin when PWMx_CH0 output mask function is enabled (MSKEN0 = 1). + * | | |0 = Output logic Low to PWMx_CH0. + * | | |1 = Output logic High to PWMx_CH0. + * |[1] |MSKDAT1 |PWMx_CH1 Output Mask Data Control Bit + * | | |This bit is used to control the output state of PWMx_CH1 pin when PWMx_CH1 output mask function is enabled (MSKEN1 = 1). + * | | |0 = Output logic Low to PWMx_CH1. + * | | |1 = Output logic High to PWMx_CH1. + * @var TIMER_T::PWMBNF + * Offset: 0x68 Timer PWM Brake Pin Noise Filter Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BRKNFEN |Brake Pin Noise Filter Enable Bit + * | | |0 = Pin noise filter detect of PWMx_BRAKEy Disabled. + * | | |1 = Pin noise filter detect of PWMx_BRAKEy Enabled. + * |[3:1] |BRKNFSEL |Brake Pin Noise Filter Clock Selection + * | | |000 = Noise filter clock is PCLKx. + * | | |001 = Noise filter clock is PCLKx/2. + * | | |010 = Noise filter clock is PCLKx/4. + * | | |011 = Noise filter clock is PCLKx/8. + * | | |100 = Noise filter clock is PCLKx/16. + * | | |101 = Noise filter clock is PCLKx/32. + * | | |110 = Noise filter clock is PCLKx/64. + * | | |111 = Noise filter clock is PCLKx/128. + * |[6:4] |BRKFCNT |Brake Pin Noise Filter Count + * | | |The fields is used to control the active noise filter sample time. + * | | |Once noise filter sample time = (Period time of BRKDBCS) * BRKFCNT. + * |[7] |BRKPINV |Brake Pin Detection Control Bit + * | | |0 = Brake pin event will be detected if PWMx_BRAKEy pin status transfer from low to high in edge-detect, or pin status is high in level-detect. + * | | |1 = Brake pin event will be detected if PWMx_BRAKEy pin status transfer from high to low in edge-detect, or pin status is low in level-detect . + * |[17:16] |BKPINSRC |Brake Pin Source Select + * | | |00 = Brake pin source comes from PWM0_BRAKE0 pin. + * | | |01 = Brake pin source comes from PWM0_BRAKE1 pin. + * | | |10 = Brake pin source comes from PWM1_BRAKE0 pin. + * | | |11 = Brake pin source comes from PWM1_BRAKE1 pin. + * @var TIMER_T::PWMFAILBRK + * Offset: 0x6C Timer PWM System Fail Brake Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CSSBRKEN |Clock Security System Detection Trigger PWM Brake Function Enable Bit + * | | |0 = Brake Function triggered by clock fail detection Disabled. + * | | |1 = Brake Function triggered by clock fail detection Enabled. + * |[1] |BODBRKEN |Brown-out Detection Trigger PWM Brake Function Enable Bit + * | | |0 = Brake Function triggered by BOD event Disabled. + * | | |1 = Brake Function triggered by BOD event Enabled. + * |[2] |RAMBRKEN |SRAM Parity Error Detection Trigger PWM Brake Function Enable Bit + * | | |0 = Brake Function triggered by SRAM parity error detection Disabled. + * | | |1 = Brake Function triggered by SRAM parity error detection Enabled. + * |[3] |CORBRKEN |Core Lockup Detection Trigger PWM Brake Function Enable Bit + * | | |0 = Brake Function triggered by core lockup event Disabled. + * | | |1 = Brake Function triggered by core lockup event Enabled. + * @var TIMER_T::PWMBRKCTL + * Offset: 0x70 Timer PWM Brake Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CPO0EBEN |Enable Internal ACMP0_O Digital Output As Edge-detect Brake Source (Write Protect) + * | | |0 = Internal ACMP0_O signal as edge-detect brake source Disabled. + * | | |1 = Internal ACMP0_O signal as edge-detect brake source Enabled. + * | | |Note1: Only internal ACMP0_O signal from low to high will be detected as brake event. + * | | |Note2: This register is write protected. Refer toSYS_REGLCTL register. + * |[1] |CPO1EBEN |Enable Internal ACMP1_O Digital Output As Edge-detect Brake Source (Write Protect) + * | | |0 = Internal ACMP1_O signal as edge-detect brake source Disabled. + * | | |1 = Internal ACMP1_O signal as edge-detect brake source Enabled. + * | | |Note1: Only internal ACMP1_O signal from low to high will be detected as brake event. + * | | |Note2: This register is write protected. Refer toSYS_REGLCTL register. + * |[4] |BRKPEEN |Enable TM_BRAKEx Pin As Edge-detect Brake Source (Write Protect) + * | | |0 = PWMx_BRAKEy pin event as edge-detect brake source Disabled. + * | | |1 = PWMx_BRAKEy pin event as edge-detect brake source Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[7] |SYSEBEN |Enable System Fail As Edge-detect Brake Source (Write Protect) + * | | |0 = System fail condition as edge-detect brake source Disabled. + * | | |1 = System fail condition as edge-detect brake source Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[8] |CPO0LBEN |Enable Internal ACMP0_O Digital Output As Level-detect Brake Source (Write Protect) + * | | |0 = Internal ACMP0_O signal as level-detect brake source Disabled. + * | | |1 = Internal ACMP0_O signal as level-detect brake source Enabled. + * | | |Note1: Only internal ACMP0_O signal from low to high will be detected as brake event. + * | | |Note2: This register is write protected. Refer toSYS_REGLCTL register. + * |[9] |CPO1LBEN |Enable Internal ACMP1_O Digital Output As Level-detect Brake Source (Write Protect) + * | | |0 = Internal ACMP1_O signal as level-detect brake source Disabled. + * | | |1 = Internal ACMP1_O signal as level-detect brake source Enabled. + * | | |Note1: Only internal ACMP1_O signal from low to high will be detected as brake event. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[12] |BRKPLEN |Enable TM_BRAKEx Pin As Level-detect Brake Source (Write Protect) + * | | |0 = PWMx_BRAKEy pin event as level-detect brake source Disabled. + * | | |1 = PWMx_BRAKEy pin event as level-detect brake source Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[15] |SYSLBEN |Enable System Fail As Level-detect Brake Source (Write Protect) + * | | |0 = System fail condition as level-detect brake source Disabled. + * | | |1 = System fail condition as level-detect brake source Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[17:16] |BRKAEVEN |PWM Brake Action Select for PWMx_CH0 (Write Protect) + * | | |00 = PWMx_BRAKEy brake event will not affect PWMx_CH0 output. + * | | |01 = PWMx_CH0 output tri-state when PWMx_BRAKEy brake event happened. + * | | |10 = PWMx_CH0 output low level when PWMx_BRAKEy brake event happened. + * | | |11 = PWMx_CH0 output high level when PWMx_BRAKEy brake event happened. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[19:18] |BRKAODD |PWM Brake Action Select for PWMx_CH1 (Write Protect) + * | | |00 = PWMx_BRAKEy brake event will not affect PWMx_CH1 output. + * | | |01 = PWMx_CH1 output tri-state when PWMx_BRAKEy brake event happened. + * | | |10 = PWMx_CH1 output low level when PWMx_BRAKEy brake event happened. + * | | |11 = PWMx_CH1 output high level when PWMx_BRAKEy brake event happened. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * @var TIMER_T::PWMPOLCTL + * Offset: 0x74 Timer PWM Pin Output Polar Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |PINV0 |PWMx_CH0 Output Pin Polar Control Bit + * | | |The bit is used to control polarity state of PWMx_CH0 output pin. + * | | |0 = PWMx_CH0 output pin polar inverse Disabled. + * | | |1 = PWMx_CH0 output pin polar inverse Enabled. + * |[1] |PINV1 |PWMx_CH1 Output Pin Polar Control Bit + * | | |The bit is used to control polarity state of PWMx_CH1 output pin. + * | | |0 = PWMx_CH1 output pin polar inverse Disabled. + * | | |1 = PWMx_CH1 output pin polar inverse Enabled. + * @var TIMER_T::PWMPOEN + * Offset: 0x78 Timer PWM Pin Output Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |POEN0 |PWMx_CH0 Output Pin Enable Bit + * | | |0 = PWMx_CH0 pin at tri-state mode. + * | | |1 = PWMx_CH0 pin in output mode. + * |[1] |POEN1 |PWMx_CH1 Output Pin Enable Bit + * | | |0 = PWMx_CH1 pin at tri-state mode. + * | | |1 = PWMx_CH1 pin in output mode. + * @var TIMER_T::PWMSWBRK + * Offset: 0x7C Timer PWM Software Trigger Brake Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BRKETRG |Software Trigger Edge-detect Brake Source (Write Only) (Write Protect) + * | | |Write 1 to this bit will trigger PWM edge-detect brake source, then BRKEIF0 and BRKEIF1 will set to 1 automatically in TIMERx_PWMINTSTS1 register. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[8] |BRKLTRG |Software Trigger Level-detect Brake Source (Write Only) (Write Protect) + * | | |Write 1 to this bit will trigger PWM level-detect brake source, then BRKLIF0 and BRKLIF1 will set to 1 automatically in TIMERx_PWMINTSTS1 register. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * @var TIMER_T::PWMINTEN0 + * Offset: 0x80 Timer PWM Interrupt Enable Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ZIEN |PWM Zero Point Interrupt Enable Bit + * | | |0 = Zero point interrupt Disabled. + * | | |1 = Zero point interrupt Enabled. + * |[1] |PIEN |PWM Period Point Interrupt Enable Bit + * | | |0 = Period point interrupt Disabled. + * | | |1 = Period point interrupt Enabled. + * | | |Note: When in up-down count type, period point means the center point of current PWM period. + * |[2] |CMPUIEN |PWM Compare Up Count Interrupt Enable Bit + * | | |0 = Compare up count interrupt Disabled. + * | | |1 = Compare up count interrupt Enabled. + * |[3] |CMPDIEN |PWM Compare Down Count Interrupt Enable Bit + * | | |0 = Compare down count interrupt Disabled. + * | | |1 = Compare down count interrupt Enabled. + * @var TIMER_T::PWMINTEN1 + * Offset: 0x84 Timer PWM Interrupt Enable Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BRKEIEN |PWM Edge-detect Brake Interrupt Enable (Write Protect) + * | | |0 = PWM edge-detect brake interrupt Disabled. + * | | |1 = PWM edge-detect brake interrupt Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * |[8] |BRKLIEN |PWM Level-detect Brake Interrupt Enable (Write Protect) + * | | |0 = PWM level-detect brake interrupt Disabled. + * | | |1 = PWM level-detect brake interrupt Enabled. + * | | |Note: This register is write protected. Refer toSYS_REGLCTL register. + * @var TIMER_T::PWMINTSTS0 + * Offset: 0x88 Timer PWM Interrupt Status Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ZIF |PWM Zero Point Interrupt Flag + * | | |This bit is set by hardware when TIMERx_PWM counter reaches zero. + * | | |Note: This bit is cleared by writing 1 to it. + * |[1] |PIF |PWM Period Point Interrupt Flag + * | | |This bit is set by hardware when TIMERx_PWM counter reaches PERIOD. + * | | |Note1: When in up-down count type, PIF flag means the center point flag of current PWM period. + * | | |Note2: This bit is cleared by writing 1 to it. + * |[2] |CMPUIF |PWM Compare Up Count Interrupt Flag + * | | |This bit is set by hardware when TIMERx_PWM counter in up count direction and reaches CMP. + * | | |Note1: If CMP equal to PERIOD, there is no CMPUIF flag in up count type and up-down count type. + * | | |Note2: This bit is cleared by writing 1 to it. + * |[3] |CMPDIF |PWM Compare Down Count Interrupt Flag + * | | |This bit is set by hardware when TIMERx_PWM counter in down count direction and reaches CMP. + * | | |Note1: If CMP equal to PERIOD, there is no CMPDIF flag in down count type. + * | | |Note2: This bit is cleared by writing 1 to it. + * @var TIMER_T::PWMINTSTS1 + * Offset: 0x8C Timer PWM Interrupt Status Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BRKEIF0 |Edge-detect Brake Interrupt Flag on PWMx_CH0 (Write Protect) + * | | |0 = PWMx_CH0 edge-detect brake event do not happened. + * | | |1 = PWMx_CH0 edge-detect brake event happened. + * | | |Note1: This bit is cleared by writing 1 to it. + * | | |Note2: This register is write protected. Refer toSYS_REGLCTL register. + * |[1] |BRKEIF1 |Edge-detect Brake Interrupt Flag PWMx_CH1 (Write Protect) + * | | |0 = PWMx_CH1 edge-detect brake event do not happened. + * | | |1 = PWMx_CH1 edge-detect brake event happened. + * | | |Note1: This bit is cleared by writing 1 to it. + * | | |Note2: This register is write protected. Refer toSYS_REGLCTL register. + * |[8] |BRKLIF0 |Level-detect Brake Interrupt Flag on PWMx_CH0 (Write Protect) + * | | |0 = PWMx_CH0 level-detect brake event do not happened. + * | | |1 = PWMx_CH0 level-detect brake event happened. + * | | |Note1: This bit is cleared by writing 1 to it. + * | | |Note2: This register is write protected. Refer toSYS_REGLCTL register. + * |[9] |BRKLIF1 |Level-detect Brake Interrupt Flag on PWMx_CH1 (Write Protect) + * | | |0 = PWMx_CH1 level-detect brake event do not happened. + * | | |1 = PWMx_CH1 level-detect brake event happened. + * | | |Note1: This bit is cleared by writing 1 to it. + * | | |Note2: This register is write protected. Refer toSYS_REGLCTL register. + * |[16] |BRKESTS0 |Edge -detect Brake Status of PWMx_CH0 (Read Only) + * | | |0 = PWMx_CH0 edge-detect brake state is released. + * | | |1 = PWMx_CH0 at edge-detect brake state. + * | | |Note: User can set BRKEIF0 1 to clear BRKEIF0 flag and PWMx_CH0 will release brake state when current PWM period finished and resume PWMx_CH0 output waveform start from next full PWM period. + * |[17] |BRKESTS1 |Edge-detect Brake Status of PWMx_CH1 (Read Only) + * | | |0 = PWMx_CH1 edge-detect brake state is released. + * | | |1 = PWMx_CH1 at edge-detect brake state. + * | | |Note: User can set BRKEIF1 1 to clear BRKEIF1 flag and PWMx_CH1 will release brake state when current PWM period finished and resume PWMx_CH1 output waveform start from next full PWM period. + * |[24] |BRKLSTS0 |Level-detect Brake Status of PWMx_CH0 (Read Only) + * | | |0 = PWMx_CH0 level-detect brake state is released. + * | | |1 = PWMx_CH0 at level-detect brake state. + * | | |Note: If TIMERx_PWM level-detect brake source has released, both PWMx_CH0 and PWMx_CH1 will release brake state when current PWM period finished and resume PWMx_CH0 and PWMx_CH1 output waveform start from next full PWM period. + * |[25] |BRKLSTS1 |Level-detect Brake Status of PWMx_CH1 (Read Only) + * | | |0 = PWMx_CH1 level-detect brake state is released. + * | | |1 = PWMx_CH1 at level-detect brake state. + * | | |Note: If TIMERx_PWM level-detect brake source has released, both PWMx_CH0 and PWMx_CH1 will release brake state when current PWM period finished and resume PWMx_CH0 and PWMx_CH1 output waveform start from next full PWM period. + * @var TIMER_T::PWMEADCTS + * Offset: 0x90 Timer PWM ADC Trigger Source Select Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2:0] |TRGSEL |PWM Counter Event Source Select to Trigger EADC Conversion + * | | |000 = Trigger EADC conversion at zero point (ZIF). + * | | |001 = Trigger EADC conversion at period point (PIF). + * | | |010 = Trigger EADC conversion at zero or period point (ZIF or PIF). + * | | |011 = Trigger EADC conversion at compare up count point (CMPUIF). + * | | |100 = Trigger EADC conversion at compare down count point (CMPDIF). + * | | |Others = Reserved. + * |[7] |TRGEN |PWM Counter Event Trigger EADC Conversion Enable Bit + * | | |0 = PWM counter event trigger EADC conversion Disabled. + * | | |1 = PWM counter event trigger EADC conversion Enabled. + * @var TIMER_T::PWMSCTL + * Offset: 0x94 Timer PWM Synchronous Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |SYNCMODE |PWM Synchronous Mode Enable Select + * | | |00 = PWM synchronous function Disabled. + * | | |01 = PWM synchronous counter start function Enabled. + * | | |10 = Reserved. + * | | |11 = PWM synchronous counter clear function Enabled. + * |[8] |SYNCSRC |PWM Synchronous Counter Start/Clear Source Select + * | | |0 = Counter synchronous start/clear by trigger TIMER0_PWMSTRG STRGEN. + * | | |1 = Counter synchronous start/clear by trigger TIMER2_PWMSTRG STRGEN. + * | | |Note1: If TIMER0/1/2/3 PWM counter synchronous source are from TIMER0, TIMER0_PWMSCTL[8], TIMER1_PWMSCTL[8], TIMER2_PWMSCTL[8] and TIMER3_PWMSCTL[8] should be 0. + * | | |Note2: If TIMER0/1/ PWM counter synchronous source are from TIMER0, TIMER0_PWMSCTL[8] and TIMER1_PWMSCTL[8] should be set 0, and TIMER2/3/ PWM counter synchronous source are from TIMER2, TIME2_PWMSCTL[8] and TIMER3_PWMSCTL[8] should be set 1. + * @var TIMER_T::PWMSTRG + * Offset: 0x98 Timer PWM Synchronous Trigger Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |STRGEN |PWM Counter Synchronous Trigger Enable Bit (Write Only) + * | | |PMW counter synchronous function is used to make selected PWM channels (include TIMER0/1/2/3 PWM, TIMER0/1 PWM and TIMER2/3 PWM) start counting or clear counter at the same time according to TIMERx_PWMSCTL setting. + * | | |Note: This bit is only available in TIMER0 and TIMER2. + * @var TIMER_T::PWMSTATUS + * Offset: 0x9C Timer PWM Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CNTMAXF |PWM Counter Equal to 0xFFFF Flag + * | | |0 = Indicates the PWM counter value never reached its maximum value 0xFFFF. + * | | |1 = Indicates the PWM counter value has reached its maximum value. + * | | |Note: This bit is cleared by writing 1 to it. + * |[16] |EADCTRGF |Trigger EADC Start Conversion Flag + * | | |0 = PWM counter event trigger EADC start conversion is not occurred. + * | | |1 = PWM counter event trigger EADC start conversion has occurred. + * | | |Note: This bit is cleared by writing 1 to it. + * @var TIMER_T::PWMPBUF + * Offset: 0xA0 Timer PWM Period Buffer Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |PBUF |PWM Period Buffer Register (Read Only) + * | | |Used as PERIOD active register. + * @var TIMER_T::PWMCMPBUF + * Offset: 0xA4 Timer PWM Comparator Buffer Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |CMPBUF |PWM Comparator Buffer Register (Read Only) + * | | |Used as CMP active register. + */ + __IO uint32_t CTL; /*!< [0x0000] Timer Control Register */ + __IO uint32_t CMP; /*!< [0x0004] Timer Comparator Register */ + __IO uint32_t INTSTS; /*!< [0x0008] Timer Interrupt Status Register */ + __IO uint32_t CNT; /*!< [0x000c] Timer Data Register */ + __I uint32_t CAP; /*!< [0x0010] Timer Capture Data Register */ + __IO uint32_t EXTCTL; /*!< [0x0014] Timer External Control Register */ + __IO uint32_t EINTSTS; /*!< [0x0018] Timer External Interrupt Status Register */ + __IO uint32_t TRGCTL; /*!< [0x001c] Timer Trigger Control Register */ + __IO uint32_t ALTCTL; /*!< [0x0020] Timer Alternative Control Register */ + /** @cond HIDDEN_SYMBOLS */ + __I uint32_t RESERVE0[7]; + /** @endcond */ + __IO uint32_t PWMCTL; /*!< [0x0040] Timer PWM Control Register */ + __IO uint32_t PWMCLKSRC; /*!< [0x0044] Timer PWM Counter Clock Source Register */ + __IO uint32_t PWMCLKPSC; /*!< [0x0048] Timer PWM Counter Clock Pre-scale Register */ + __IO uint32_t PWMCNTCLR; /*!< [0x004c] Timer PWM Clear Counter Register */ + __IO uint32_t PWMPERIOD; /*!< [0x0050] Timer PWM Period Register */ + __IO uint32_t PWMCMPDAT; /*!< [0x0054] Timer PWM Comparator Register */ + __IO uint32_t PWMDTCTL; /*!< [0x0058] Timer PWM Dead-Time Control Register */ + __I uint32_t PWMCNT; /*!< [0x005c] Timer PWM Counter Register */ + __IO uint32_t PWMMSKEN; /*!< [0x0060] Timer PWM Output Mask Enable Register */ + __IO uint32_t PWMMSK; /*!< [0x0064] Timer PWM Output Mask Data Control Register */ + __IO uint32_t PWMBNF; /*!< [0x0068] Timer PWM Brake Pin Noise Filter Register */ + __IO uint32_t PWMFAILBRK; /*!< [0x006c] Timer PWM System Fail Brake Control Register */ + __IO uint32_t PWMBRKCTL; /*!< [0x0070] Timer PWM Brake Control Register */ + __IO uint32_t PWMPOLCTL; /*!< [0x0074] Timer PWM Pin Output Polar Control Register */ + __IO uint32_t PWMPOEN; /*!< [0x0078] Timer PWM Pin Output Enable Register */ + __O uint32_t PWMSWBRK; /*!< [0x007c] Timer PWM Software Trigger Brake Control Register */ + __IO uint32_t PWMINTEN0; /*!< [0x0080] Timer PWM Interrupt Enable Register 0 */ + __IO uint32_t PWMINTEN1; /*!< [0x0084] Timer PWM Interrupt Enable Register 1 */ + __IO uint32_t PWMINTSTS0; /*!< [0x0088] Timer PWM Interrupt Status Register 0 */ + __IO uint32_t PWMINTSTS1; /*!< [0x008c] Timer PWM Interrupt Status Register 1 */ + __IO uint32_t PWMEADCTS; /*!< [0x0090] Timer PWM EADC Trigger Source Select Register */ + __IO uint32_t PWMSCTL; /*!< [0x0094] Timer PWM Synchronous Control Register */ + __O uint32_t PWMSTRG; /*!< [0x0098] Timer PWM Synchronous Trigger Register */ + __IO uint32_t PWMSTATUS; /*!< [0x009c] Timer PWM Status Register */ + __I uint32_t PWMPBUF; /*!< [0x00a0] Timer PWM Period Buffer Register */ + __I uint32_t PWMCMPBUF; /*!< [0x00a4] Timer PWM Comparator Buffer Register */ + +} TIMER_T; + +/** + @addtogroup TIMER_CONST TIMER Bit Field Definition + Constant Definitions for TIMER Controller +@{ */ + +#define TIMER_CTL_PSC_Pos (0) /*!< TIMER_T::CTL: PSC Position */ +#define TIMER_CTL_PSC_Msk (0xfful << TIMER_CTL_PSC_Pos) /*!< TIMER_T::CTL: PSC Mask */ + +#define TIMER_CTL_INTRGEN_Pos (19) /*!< TIMER_T::CTL: INTRGEN Position */ +#define TIMER_CTL_INTRGEN_Msk (0x1ul << TIMER_CTL_INTRGEN_Pos) /*!< TIMER_T::CTL: INTRGEN Mask */ + +#define TIMER_CTL_PERIOSEL_Pos (20) /*!< TIMER_T::CTL: PERIOSEL Position */ +#define TIMER_CTL_PERIOSEL_Msk (0x1ul << TIMER_CTL_PERIOSEL_Pos) /*!< TIMER_T::CTL: PERIOSEL Mask */ + +#define TIMER_CTL_TGLPINSEL_Pos (21) /*!< TIMER_T::CTL: TGLPINSEL Position */ +#define TIMER_CTL_TGLPINSEL_Msk (0x1ul << TIMER_CTL_TGLPINSEL_Pos) /*!< TIMER_T::CTL: TGLPINSEL Mask */ + +#define TIMER_CTL_CAPSRC_Pos (22) /*!< TIMER_T::CTL: CAPSRC Position */ +#define TIMER_CTL_CAPSRC_Msk (0x1ul << TIMER_CTL_CAPSRC_Pos) /*!< TIMER_T::CTL: CAPSRC Mask */ + +#define TIMER_CTL_WKEN_Pos (23) /*!< TIMER_T::CTL: WKEN Position */ +#define TIMER_CTL_WKEN_Msk (0x1ul << TIMER_CTL_WKEN_Pos) /*!< TIMER_T::CTL: WKEN Mask */ + +#define TIMER_CTL_EXTCNTEN_Pos (24) /*!< TIMER_T::CTL: EXTCNTEN Position */ +#define TIMER_CTL_EXTCNTEN_Msk (0x1ul << TIMER_CTL_EXTCNTEN_Pos) /*!< TIMER_T::CTL: EXTCNTEN Mask */ + +#define TIMER_CTL_ACTSTS_Pos (25) /*!< TIMER_T::CTL: ACTSTS Position */ +#define TIMER_CTL_ACTSTS_Msk (0x1ul << TIMER_CTL_ACTSTS_Pos) /*!< TIMER_T::CTL: ACTSTS Mask */ + +#define TIMER_CTL_OPMODE_Pos (27) /*!< TIMER_T::CTL: OPMODE Position */ +#define TIMER_CTL_OPMODE_Msk (0x3ul << TIMER_CTL_OPMODE_Pos) /*!< TIMER_T::CTL: OPMODE Mask */ + +#define TIMER_CTL_INTEN_Pos (29) /*!< TIMER_T::CTL: INTEN Position */ +#define TIMER_CTL_INTEN_Msk (0x1ul << TIMER_CTL_INTEN_Pos) /*!< TIMER_T::CTL: INTEN Mask */ + +#define TIMER_CTL_CNTEN_Pos (30) /*!< TIMER_T::CTL: CNTEN Position */ +#define TIMER_CTL_CNTEN_Msk (0x1ul << TIMER_CTL_CNTEN_Pos) /*!< TIMER_T::CTL: CNTEN Mask */ + +#define TIMER_CTL_ICEDEBUG_Pos (31) /*!< TIMER_T::CTL: ICEDEBUG Position */ +#define TIMER_CTL_ICEDEBUG_Msk (0x1ul << TIMER_CTL_ICEDEBUG_Pos) /*!< TIMER_T::CTL: ICEDEBUG Mask */ + +#define TIMER_CMP_CMPDAT_Pos (0) /*!< TIMER_T::CMP: CMPDAT Position */ +#define TIMER_CMP_CMPDAT_Msk (0xfffffful << TIMER_CMP_CMPDAT_Pos) /*!< TIMER_T::CMP: CMPDAT Mask */ + +#define TIMER_INTSTS_TIF_Pos (0) /*!< TIMER_T::INTSTS: TIF Position */ +#define TIMER_INTSTS_TIF_Msk (0x1ul << TIMER_INTSTS_TIF_Pos) /*!< TIMER_T::INTSTS: TIF Mask */ + +#define TIMER_INTSTS_TWKF_Pos (1) /*!< TIMER_T::INTSTS: TWKF Position */ +#define TIMER_INTSTS_TWKF_Msk (0x1ul << TIMER_INTSTS_TWKF_Pos) /*!< TIMER_T::INTSTS: TWKF Mask */ + +#define TIMER_CNT_CNT_Pos (0) /*!< TIMER_T::CNT: CNT Position */ +#define TIMER_CNT_CNT_Msk (0xfffffful << TIMER_CNT_CNT_Pos) /*!< TIMER_T::CNT: CNT Mask */ + +#define TIMER_CNT_RSTACT_Pos (31) /*!< TIMER_T::CNT: RSTACT Position */ +#define TIMER_CNT_RSTACT_Msk (0x1ul << TIMER_CNT_RSTACT_Pos) /*!< TIMER_T::CNT: RSTACT Mask */ + +#define TIMER_CAP_CAPDAT_Pos (0) /*!< TIMER_T::CAP: CAPDAT Position */ +#define TIMER_CAP_CAPDAT_Msk (0xfffffful << TIMER_CAP_CAPDAT_Pos) /*!< TIMER_T::CAP: CAPDAT Mask */ + +#define TIMER_EXTCTL_CNTPHASE_Pos (0) /*!< TIMER_T::EXTCTL: CNTPHASE Position */ +#define TIMER_EXTCTL_CNTPHASE_Msk (0x1ul << TIMER_EXTCTL_CNTPHASE_Pos) /*!< TIMER_T::EXTCTL: CNTPHASE Mask */ + +#define TIMER_EXTCTL_CAPEN_Pos (3) /*!< TIMER_T::EXTCTL: CAPEN Position */ +#define TIMER_EXTCTL_CAPEN_Msk (0x1ul << TIMER_EXTCTL_CAPEN_Pos) /*!< TIMER_T::EXTCTL: CAPEN Mask */ + +#define TIMER_EXTCTL_CAPFUNCS_Pos (4) /*!< TIMER_T::EXTCTL: CAPFUNCS Position */ +#define TIMER_EXTCTL_CAPFUNCS_Msk (0x1ul << TIMER_EXTCTL_CAPFUNCS_Pos) /*!< TIMER_T::EXTCTL: CAPFUNCS Mask */ + +#define TIMER_EXTCTL_CAPIEN_Pos (5) /*!< TIMER_T::EXTCTL: CAPIEN Position */ +#define TIMER_EXTCTL_CAPIEN_Msk (0x1ul << TIMER_EXTCTL_CAPIEN_Pos) /*!< TIMER_T::EXTCTL: CAPIEN Mask */ + +#define TIMER_EXTCTL_CAPDBEN_Pos (6) /*!< TIMER_T::EXTCTL: CAPDBEN Position */ +#define TIMER_EXTCTL_CAPDBEN_Msk (0x1ul << TIMER_EXTCTL_CAPDBEN_Pos) /*!< TIMER_T::EXTCTL: CAPDBEN Mask */ + +#define TIMER_EXTCTL_CNTDBEN_Pos (7) /*!< TIMER_T::EXTCTL: CNTDBEN Position */ +#define TIMER_EXTCTL_CNTDBEN_Msk (0x1ul << TIMER_EXTCTL_CNTDBEN_Pos) /*!< TIMER_T::EXTCTL: CNTDBEN Mask */ + +#define TIMER_EXTCTL_ICAPSEL_Pos (8) /*!< TIMER_T::EXTCTL: ICAPSEL Position */ +#define TIMER_EXTCTL_ICAPSEL_Msk (0x7ul << TIMER_EXTCTL_ICAPSEL_Pos) /*!< TIMER_T::EXTCTL: ICAPSEL Mask */ + +#define TIMER_EXTCTL_CAPEDGE_Pos (12) /*!< TIMER_T::EXTCTL: CAPEDGE Position */ +#define TIMER_EXTCTL_CAPEDGE_Msk (0x7ul << TIMER_EXTCTL_CAPEDGE_Pos) /*!< TIMER_T::EXTCTL: CAPEDGE Mask */ + +#define TIMER_EXTCTL_ECNTSSEL_Pos (16) /*!< TIMER_T::EXTCTL: ECNTSSEL Position */ +#define TIMER_EXTCTL_ECNTSSEL_Msk (0x1ul << TIMER_EXTCTL_ECNTSSEL_Pos) /*!< TIMER_T::EXTCTL: ECNTSSEL Mask */ + +#define TIMER_EXTCTL_CAPDIVSCL_Pos (28) /*!< TIMER_T::EXTCTL: CAPDIVSCL Position */ +#define TIMER_EXTCTL_CAPDIVSCL_Msk (0xful << TIMER_EXTCTL_CAPDIVSCL_Pos) /*!< TIMER_T::EXTCTL: CAPDIVSCL Mask */ + +#define TIMER_EINTSTS_CAPIF_Pos (0) /*!< TIMER_T::EINTSTS: CAPIF Position */ +#define TIMER_EINTSTS_CAPIF_Msk (0x1ul << TIMER_EINTSTS_CAPIF_Pos) /*!< TIMER_T::EINTSTS: CAPIF Mask */ + +#define TIMER_TRGCTL_TRGSSEL_Pos (0) /*!< TIMER_T::TRGCTL: TRGSSEL Position */ +#define TIMER_TRGCTL_TRGSSEL_Msk (0x1ul << TIMER_TRGCTL_TRGSSEL_Pos) /*!< TIMER_T::TRGCTL: TRGSSEL Mask */ + +#define TIMER_TRGCTL_TRGEPWM_Pos (1) /*!< TIMER_T::TRGCTL: TRGEPWM Position */ +#define TIMER_TRGCTL_TRGEPWM_Msk (0x1ul << TIMER_TRGCTL_TRGEPWM_Pos) /*!< TIMER_T::TRGCTL: TRGEPWM Mask */ + +#define TIMER_TRGCTL_TRGEADC_Pos (2) /*!< TIMER_T::TRGCTL: TRGEADC Position */ +#define TIMER_TRGCTL_TRGEADC_Msk (0x1ul << TIMER_TRGCTL_TRGEADC_Pos) /*!< TIMER_T::TRGCTL: TRGEADC Mask */ + +#define TIMER_TRGCTL_TRGDAC_Pos (3) /*!< TIMER_T::TRGCTL: TRGDAC Position */ +#define TIMER_TRGCTL_TRGDAC_Msk (0x1ul << TIMER_TRGCTL_TRGDAC_Pos) /*!< TIMER_T::TRGCTL: TRGDAC Mask */ + +#define TIMER_TRGCTL_TRGPDMA_Pos (4) /*!< TIMER_T::TRGCTL: TRGPDMA Position */ +#define TIMER_TRGCTL_TRGPDMA_Msk (0x1ul << TIMER_TRGCTL_TRGPDMA_Pos) /*!< TIMER_T::TRGCTL: TRGPDMA Mask */ + +#define TIMER_ALTCTL_FUNCSEL_Pos (0) /*!< TIMER_T::ALTCTL: FUNCSEL Position */ +#define TIMER_ALTCTL_FUNCSEL_Msk (0x1ul << TIMER_ALTCTL_FUNCSEL_Pos) /*!< TIMER_T::ALTCTL: FUNCSEL Mask */ + +#define TIMER_PWMCTL_CNTEN_Pos (0) /*!< TIMER_T::PWMCTL: CNTEN Position */ +#define TIMER_PWMCTL_CNTEN_Msk (0x1ul << TIMER_PWMCTL_CNTEN_Pos) /*!< TIMER_T::PWMCTL: CNTEN Mask */ + +#define TIMER_PWMCTL_CNTTYPE_Pos (1) /*!< TIMER_T::PWMCTL: CNTTYPE Position */ +#define TIMER_PWMCTL_CNTTYPE_Msk (0x3ul << TIMER_PWMCTL_CNTTYPE_Pos) /*!< TIMER_T::PWMCTL: CNTTYPE Mask */ + +#define TIMER_PWMCTL_CNTMODE_Pos (3) /*!< TIMER_T::PWMCTL: CNTMODE Position */ +#define TIMER_PWMCTL_CNTMODE_Msk (0x1ul << TIMER_PWMCTL_CNTMODE_Pos) /*!< TIMER_T::PWMCTL: CNTMODE Mask */ + +#define TIMER_PWMCTL_CTRLD_Pos (8) /*!< TIMER_T::PWMCTL: CTRLD Position */ +#define TIMER_PWMCTL_CTRLD_Msk (0x1ul << TIMER_PWMCTL_CTRLD_Pos) /*!< TIMER_T::PWMCTL: CTRLD Mask */ + +#define TIMER_PWMCTL_IMMLDEN_Pos (9) /*!< TIMER_T::PWMCTL: IMMLDEN Position */ +#define TIMER_PWMCTL_IMMLDEN_Msk (0x1ul << TIMER_PWMCTL_IMMLDEN_Pos) /*!< TIMER_T::PWMCTL: IMMLDEN Mask */ + +#define TIMER_PWMCTL_OUTMODE_Pos (16) /*!< TIMER_T::PWMCTL: OUTMODE Position */ +#define TIMER_PWMCTL_OUTMODE_Msk (0x1ul << TIMER_PWMCTL_OUTMODE_Pos) /*!< TIMER_T::PWMCTL: OUTMODE Mask */ + +#define TIMER_PWMCTL_DBGHALT_Pos (30) /*!< TIMER_T::PWMCTL: DBGHALT Position */ +#define TIMER_PWMCTL_DBGHALT_Msk (0x1ul << TIMER_PWMCTL_DBGHALT_Pos) /*!< TIMER_T::PWMCTL: DBGHALT Mask */ + +#define TIMER_PWMCTL_DBGTRIOFF_Pos (31) /*!< TIMER_T::PWMCTL: DBGTRIOFF Position */ +#define TIMER_PWMCTL_DBGTRIOFF_Msk (0x1ul << TIMER_PWMCTL_DBGTRIOFF_Pos) /*!< TIMER_T::PWMCTL: DBGTRIOFF Mask */ + +#define TIMER_PWMCLKSRC_CLKSRC_Pos (0) /*!< TIMER_T::PWMCLKSRC: CLKSRC Position */ +#define TIMER_PWMCLKSRC_CLKSRC_Msk (0x7ul << TIMER_PWMCLKSRC_CLKSRC_Pos) /*!< TIMER_T::PWMCLKSRC: CLKSRC Mask */ + +#define TIMER_PWMCLKPSC_CLKPSC_Pos (0) /*!< TIMER_T::PWMCLKPSC: CLKPSC Position */ +#define TIMER_PWMCLKPSC_CLKPSC_Msk (0xffful << TIMER_PWMCLKPSC_CLKPSC_Pos) /*!< TIMER_T::PWMCLKPSC: CLKPSC Mask */ + +#define TIMER_PWMCNTCLR_CNTCLR_Pos (0) /*!< TIMER_T::PWMCNTCLR: CNTCLR Position */ +#define TIMER_PWMCNTCLR_CNTCLR_Msk (0x1ul << TIMER_PWMCNTCLR_CNTCLR_Pos) /*!< TIMER_T::PWMCNTCLR: CNTCLR Mask */ + +#define TIMER_PWMPERIOD_PERIOD_Pos (0) /*!< TIMER_T::PWMPERIOD: PERIOD Position */ +#define TIMER_PWMPERIOD_PERIOD_Msk (0xfffful << TIMER_PWMPERIOD_PERIOD_Pos) /*!< TIMER_T::PWMPERIOD: PERIOD Mask */ + +#define TIMER_PWMCMPDAT_CMP_Pos (0) /*!< TIMER_T::PWMCMPDAT: CMP Position */ +#define TIMER_PWMCMPDAT_CMP_Msk (0xfffful << TIMER_PWMCMPDAT_CMP_Pos) /*!< TIMER_T::PWMCMPDAT: CMP Mask */ + +#define TIMER_PWMDTCTL_DTCNT_Pos (0) /*!< TIMER_T::PWMDTCTL: DTCNT Position */ +#define TIMER_PWMDTCTL_DTCNT_Msk (0xffful << TIMER_PWMDTCTL_DTCNT_Pos) /*!< TIMER_T::PWMDTCTL: DTCNT Mask */ + +#define TIMER_PWMDTCTL_DTEN_Pos (16) /*!< TIMER_T::PWMDTCTL: DTEN Position */ +#define TIMER_PWMDTCTL_DTEN_Msk (0x1ul << TIMER_PWMDTCTL_DTEN_Pos) /*!< TIMER_T::PWMDTCTL: DTEN Mask */ + +#define TIMER_PWMDTCTL_DTCKSEL_Pos (24) /*!< TIMER_T::PWMDTCTL: DTCKSEL Position */ +#define TIMER_PWMDTCTL_DTCKSEL_Msk (0x1ul << TIMER_PWMDTCTL_DTCKSEL_Pos) /*!< TIMER_T::PWMDTCTL: DTCKSEL Mask */ + +#define TIMER_PWMCNT_CNT_Pos (0) /*!< TIMER_T::PWMCNT: CNT Position */ +#define TIMER_PWMCNT_CNT_Msk (0xfffful << TIMER_PWMCNT_CNT_Pos) /*!< TIMER_T::PWMCNT: CNT Mask */ + +#define TIMER_PWMCNT_DIRF_Pos (16) /*!< TIMER_T::PWMCNT: DIRF Position */ +#define TIMER_PWMCNT_DIRF_Msk (0x1ul << TIMER_PWMCNT_DIRF_Pos) /*!< TIMER_T::PWMCNT: DIRF Mask */ + +#define TIMER_PWMMSKEN_MSKEN0_Pos (0) /*!< TIMER_T::PWMMSKEN: MSKEN0 Position */ +#define TIMER_PWMMSKEN_MSKEN0_Msk (0x1ul << TIMER_PWMMSKEN_MSKEN0_Pos) /*!< TIMER_T::PWMMSKEN: MSKEN0 Mask */ + +#define TIMER_PWMMSKEN_MSKEN1_Pos (1) /*!< TIMER_T::PWMMSKEN: MSKEN1 Position */ +#define TIMER_PWMMSKEN_MSKEN1_Msk (0x1ul << TIMER_PWMMSKEN_MSKEN1_Pos) /*!< TIMER_T::PWMMSKEN: MSKEN1 Mask */ + +#define TIMER_PWMMSK_MSKDAT0_Pos (0) /*!< TIMER_T::PWMMSK: MSKDAT0 Position */ +#define TIMER_PWMMSK_MSKDAT0_Msk (0x1ul << TIMER_PWMMSK_MSKDAT0_Pos) /*!< TIMER_T::PWMMSK: MSKDAT0 Mask */ + +#define TIMER_PWMMSK_MSKDAT1_Pos (1) /*!< TIMER_T::PWMMSK: MSKDAT1 Position */ +#define TIMER_PWMMSK_MSKDAT1_Msk (0x1ul << TIMER_PWMMSK_MSKDAT1_Pos) /*!< TIMER_T::PWMMSK: MSKDAT1 Mask */ + +#define TIMER_PWMBNF_BRKNFEN_Pos (0) /*!< TIMER_T::PWMBNF: BRKNFEN Position */ +#define TIMER_PWMBNF_BRKNFEN_Msk (0x1ul << TIMER_PWMBNF_BRKNFEN_Pos) /*!< TIMER_T::PWMBNF: BRKNFEN Mask */ + +#define TIMER_PWMBNF_BRKNFSEL_Pos (1) /*!< TIMER_T::PWMBNF: BRKNFSEL Position */ +#define TIMER_PWMBNF_BRKNFSEL_Msk (0x7ul << TIMER_PWMBNF_BRKNFSEL_Pos) /*!< TIMER_T::PWMBNF: BRKNFSEL Mask */ + +#define TIMER_PWMBNF_BRKFCNT_Pos (4) /*!< TIMER_T::PWMBNF: BRKFCNT Position */ +#define TIMER_PWMBNF_BRKFCNT_Msk (0x7ul << TIMER_PWMBNF_BRKFCNT_Pos) /*!< TIMER_T::PWMBNF: BRKFCNT Mask */ + +#define TIMER_PWMBNF_BRKPINV_Pos (7) /*!< TIMER_T::PWMBNF: BRKPINV Position */ +#define TIMER_PWMBNF_BRKPINV_Msk (0x1ul << TIMER_PWMBNF_BRKPINV_Pos) /*!< TIMER_T::PWMBNF: BRKPINV Mask */ + +#define TIMER_PWMBNF_BKPINSRC_Pos (16) /*!< TIMER_T::PWMBNF: BKPINSRC Position */ +#define TIMER_PWMBNF_BKPINSRC_Msk (0x3ul << TIMER_PWMBNF_BKPINSRC_Pos) /*!< TIMER_T::PWMBNF: BKPINSRC Mask */ + +#define TIMER_PWMFAILBRK_CSSBRKEN_Pos (0) /*!< TIMER_T::PWMFAILBRK: CSSBRKEN Position */ +#define TIMER_PWMFAILBRK_CSSBRKEN_Msk (0x1ul << TIMER_PWMFAILBRK_CSSBRKEN_Pos) /*!< TIMER_T::PWMFAILBRK: CSSBRKEN Mask */ + +#define TIMER_PWMFAILBRK_BODBRKEN_Pos (1) /*!< TIMER_T::PWMFAILBRK: BODBRKEN Position */ +#define TIMER_PWMFAILBRK_BODBRKEN_Msk (0x1ul << TIMER_PWMFAILBRK_BODBRKEN_Pos) /*!< TIMER_T::PWMFAILBRK: BODBRKEN Mask */ + +#define TIMER_PWMFAILBRK_RAMBRKEN_Pos (2) /*!< TIMER_T::PWMFAILBRK: RAMBRKEN Position */ +#define TIMER_PWMFAILBRK_RAMBRKEN_Msk (0x1ul << TIMER_PWMFAILBRK_RAMBRKEN_Pos) /*!< TIMER_T::PWMFAILBRK: RAMBRKEN Mask */ + +#define TIMER_PWMFAILBRK_CORBRKEN_Pos (3) /*!< TIMER_T::PWMFAILBRK: CORBRKEN Position */ +#define TIMER_PWMFAILBRK_CORBRKEN_Msk (0x1ul << TIMER_PWMFAILBRK_CORBRKEN_Pos) /*!< TIMER_T::PWMFAILBRK: CORBRKEN Mask */ + +#define TIMER_PWMBRKCTL_CPO0EBEN_Pos (0) /*!< TIMER_T::PWMBRKCTL: CPO0EBEN Position */ +#define TIMER_PWMBRKCTL_CPO0EBEN_Msk (0x1ul << TIMER_PWMBRKCTL_CPO0EBEN_Pos) /*!< TIMER_T::PWMBRKCTL: CPO0EBEN Mask */ + +#define TIMER_PWMBRKCTL_CPO1EBEN_Pos (1) /*!< TIMER_T::PWMBRKCTL: CPO1EBEN Position */ +#define TIMER_PWMBRKCTL_CPO1EBEN_Msk (0x1ul << TIMER_PWMBRKCTL_CPO1EBEN_Pos) /*!< TIMER_T::PWMBRKCTL: CPO1EBEN Mask */ + +#define TIMER_PWMBRKCTL_BRKPEEN_Pos (4) /*!< TIMER_T::PWMBRKCTL: BRKPEEN Position */ +#define TIMER_PWMBRKCTL_BRKPEEN_Msk (0x1ul << TIMER_PWMBRKCTL_BRKPEEN_Pos) /*!< TIMER_T::PWMBRKCTL: BRKPEEN Mask */ + +#define TIMER_PWMBRKCTL_SYSEBEN_Pos (7) /*!< TIMER_T::PWMBRKCTL: SYSEBEN Position */ +#define TIMER_PWMBRKCTL_SYSEBEN_Msk (0x1ul << TIMER_PWMBRKCTL_SYSEBEN_Pos) /*!< TIMER_T::PWMBRKCTL: SYSEBEN Mask */ + +#define TIMER_PWMBRKCTL_CPO0LBEN_Pos (8) /*!< TIMER_T::PWMBRKCTL: CPO0LBEN Position */ +#define TIMER_PWMBRKCTL_CPO0LBEN_Msk (0x1ul << TIMER_PWMBRKCTL_CPO0LBEN_Pos) /*!< TIMER_T::PWMBRKCTL: CPO0LBEN Mask */ + +#define TIMER_PWMBRKCTL_CPO1LBEN_Pos (9) /*!< TIMER_T::PWMBRKCTL: CPO1LBEN Position */ +#define TIMER_PWMBRKCTL_CPO1LBEN_Msk (0x1ul << TIMER_PWMBRKCTL_CPO1LBEN_Pos) /*!< TIMER_T::PWMBRKCTL: CPO1LBEN Mask */ + +#define TIMER_PWMBRKCTL_BRKPLEN_Pos (12) /*!< TIMER_T::PWMBRKCTL: BRKPLEN Position */ +#define TIMER_PWMBRKCTL_BRKPLEN_Msk (0x1ul << TIMER_PWMBRKCTL_BRKPLEN_Pos) /*!< TIMER_T::PWMBRKCTL: BRKPLEN Mask */ + +#define TIMER_PWMBRKCTL_SYSLBEN_Pos (15) /*!< TIMER_T::PWMBRKCTL: SYSLBEN Position */ +#define TIMER_PWMBRKCTL_SYSLBEN_Msk (0x1ul << TIMER_PWMBRKCTL_SYSLBEN_Pos) /*!< TIMER_T::PWMBRKCTL: SYSLBEN Mask */ + +#define TIMER_PWMBRKCTL_BRKAEVEN_Pos (16) /*!< TIMER_T::PWMBRKCTL: BRKAEVEN Position */ +#define TIMER_PWMBRKCTL_BRKAEVEN_Msk (0x3ul << TIMER_PWMBRKCTL_BRKAEVEN_Pos) /*!< TIMER_T::PWMBRKCTL: BRKAEVEN Mask */ + +#define TIMER_PWMBRKCTL_BRKAODD_Pos (18) /*!< TIMER_T::PWMBRKCTL: BRKAODD Position */ +#define TIMER_PWMBRKCTL_BRKAODD_Msk (0x3ul << TIMER_PWMBRKCTL_BRKAODD_Pos) /*!< TIMER_T::PWMBRKCTL: BRKAODD Mask */ + +#define TIMER_PWMPOLCTL_PINV0_Pos (0) /*!< TIMER_T::PWMPOLCTL: PINV0 Position */ +#define TIMER_PWMPOLCTL_PINV0_Msk (0x1ul << TIMER_PWMPOLCTL_PINV0_Pos) /*!< TIMER_T::PWMPOLCTL: PINV0 Mask */ + +#define TIMER_PWMPOLCTL_PINV1_Pos (1) /*!< TIMER_T::PWMPOLCTL: PINV1 Position */ +#define TIMER_PWMPOLCTL_PINV1_Msk (0x1ul << TIMER_PWMPOLCTL_PINV1_Pos) /*!< TIMER_T::PWMPOLCTL: PINV1 Mask */ + +#define TIMER_PWMPOEN_POEN0_Pos (0) /*!< TIMER_T::PWMPOEN: POEN0 Position */ +#define TIMER_PWMPOEN_POEN0_Msk (0x1ul << TIMER_PWMPOEN_POEN0_Pos) /*!< TIMER_T::PWMPOEN: POEN0 Mask */ + +#define TIMER_PWMPOEN_POEN1_Pos (1) /*!< TIMER_T::PWMPOEN: POEN1 Position */ +#define TIMER_PWMPOEN_POEN1_Msk (0x1ul << TIMER_PWMPOEN_POEN1_Pos) /*!< TIMER_T::PWMPOEN: POEN1 Mask */ + +#define TIMER_PWMSWBRK_BRKETRG_Pos (0) /*!< TIMER_T::PWMSWBRK: BRKETRG Position */ +#define TIMER_PWMSWBRK_BRKETRG_Msk (0x1ul << TIMER_PWMSWBRK_BRKETRG_Pos) /*!< TIMER_T::PWMSWBRK: BRKETRG Mask */ + +#define TIMER_PWMSWBRK_BRKLTRG_Pos (8) /*!< TIMER_T::PWMSWBRK: BRKLTRG Position */ +#define TIMER_PWMSWBRK_BRKLTRG_Msk (0x1ul << TIMER_PWMSWBRK_BRKLTRG_Pos) /*!< TIMER_T::PWMSWBRK: BRKLTRG Mask */ + +#define TIMER_PWMINTEN0_ZIEN_Pos (0) /*!< TIMER_T::PWMINTEN0: ZIEN Position */ +#define TIMER_PWMINTEN0_ZIEN_Msk (0x1ul << TIMER_PWMINTEN0_ZIEN_Pos) /*!< TIMER_T::PWMINTEN0: ZIEN Mask */ + +#define TIMER_PWMINTEN0_PIEN_Pos (1) /*!< TIMER_T::PWMINTEN0: PIEN Position */ +#define TIMER_PWMINTEN0_PIEN_Msk (0x1ul << TIMER_PWMINTEN0_PIEN_Pos) /*!< TIMER_T::PWMINTEN0: PIEN Mask */ + +#define TIMER_PWMINTEN0_CMPUIEN_Pos (2) /*!< TIMER_T::PWMINTEN0: CMPUIEN Position */ +#define TIMER_PWMINTEN0_CMPUIEN_Msk (0x1ul << TIMER_PWMINTEN0_CMPUIEN_Pos) /*!< TIMER_T::PWMINTEN0: CMPUIEN Mask */ + +#define TIMER_PWMINTEN0_CMPDIEN_Pos (3) /*!< TIMER_T::PWMINTEN0: CMPDIEN Position */ +#define TIMER_PWMINTEN0_CMPDIEN_Msk (0x1ul << TIMER_PWMINTEN0_CMPDIEN_Pos) /*!< TIMER_T::PWMINTEN0: CMPDIEN Mask */ + +#define TIMER_PWMINTEN1_BRKEIEN_Pos (0) /*!< TIMER_T::PWMINTEN1: BRKEIEN Position */ +#define TIMER_PWMINTEN1_BRKEIEN_Msk (0x1ul << TIMER_PWMINTEN1_BRKEIEN_Pos) /*!< TIMER_T::PWMINTEN1: BRKEIEN Mask */ + +#define TIMER_PWMINTEN1_BRKLIEN_Pos (8) /*!< TIMER_T::PWMINTEN1: BRKLIEN Position */ +#define TIMER_PWMINTEN1_BRKLIEN_Msk (0x1ul << TIMER_PWMINTEN1_BRKLIEN_Pos) /*!< TIMER_T::PWMINTEN1: BRKLIEN Mask */ + +#define TIMER_PWMINTSTS0_ZIF_Pos (0) /*!< TIMER_T::PWMINTSTS0: ZIF Position */ +#define TIMER_PWMINTSTS0_ZIF_Msk (0x1ul << TIMER_PWMINTSTS0_ZIF_Pos) /*!< TIMER_T::PWMINTSTS0: ZIF Mask */ + +#define TIMER_PWMINTSTS0_PIF_Pos (1) /*!< TIMER_T::PWMINTSTS0: PIF Position */ +#define TIMER_PWMINTSTS0_PIF_Msk (0x1ul << TIMER_PWMINTSTS0_PIF_Pos) /*!< TIMER_T::PWMINTSTS0: PIF Mask */ + +#define TIMER_PWMINTSTS0_CMPUIF_Pos (2) /*!< TIMER_T::PWMINTSTS0: CMPUIF Position */ +#define TIMER_PWMINTSTS0_CMPUIF_Msk (0x1ul << TIMER_PWMINTSTS0_CMPUIF_Pos) /*!< TIMER_T::PWMINTSTS0: CMPUIF Mask */ + +#define TIMER_PWMINTSTS0_CMPDIF_Pos (3) /*!< TIMER_T::PWMINTSTS0: CMPDIF Position */ +#define TIMER_PWMINTSTS0_CMPDIF_Msk (0x1ul << TIMER_PWMINTSTS0_CMPDIF_Pos) /*!< TIMER_T::PWMINTSTS0: CMPDIF Mask */ + +#define TIMER_PWMINTSTS1_BRKEIF0_Pos (0) /*!< TIMER_T::PWMINTSTS1: BRKEIF0 Position */ +#define TIMER_PWMINTSTS1_BRKEIF0_Msk (0x1ul << TIMER_PWMINTSTS1_BRKEIF0_Pos) /*!< TIMER_T::PWMINTSTS1: BRKEIF0 Mask */ + +#define TIMER_PWMINTSTS1_BRKEIF1_Pos (1) /*!< TIMER_T::PWMINTSTS1: BRKEIF1 Position */ +#define TIMER_PWMINTSTS1_BRKEIF1_Msk (0x1ul << TIMER_PWMINTSTS1_BRKEIF1_Pos) /*!< TIMER_T::PWMINTSTS1: BRKEIF1 Mask */ + +#define TIMER_PWMINTSTS1_BRKLIF0_Pos (8) /*!< TIMER_T::PWMINTSTS1: BRKLIF0 Position */ +#define TIMER_PWMINTSTS1_BRKLIF0_Msk (0x1ul << TIMER_PWMINTSTS1_BRKLIF0_Pos) /*!< TIMER_T::PWMINTSTS1: BRKLIF0 Mask */ + +#define TIMER_PWMINTSTS1_BRKLIF1_Pos (9) /*!< TIMER_T::PWMINTSTS1: BRKLIF1 Position */ +#define TIMER_PWMINTSTS1_BRKLIF1_Msk (0x1ul << TIMER_PWMINTSTS1_BRKLIF1_Pos) /*!< TIMER_T::PWMINTSTS1: BRKLIF1 Mask */ + +#define TIMER_PWMINTSTS1_BRKESTS0_Pos (16) /*!< TIMER_T::PWMINTSTS1: BRKESTS0 Position */ +#define TIMER_PWMINTSTS1_BRKESTS0_Msk (0x1ul << TIMER_PWMINTSTS1_BRKESTS0_Pos) /*!< TIMER_T::PWMINTSTS1: BRKESTS0 Mask */ + +#define TIMER_PWMINTSTS1_BRKESTS1_Pos (17) /*!< TIMER_T::PWMINTSTS1: BRKESTS1 Position */ +#define TIMER_PWMINTSTS1_BRKESTS1_Msk (0x1ul << TIMER_PWMINTSTS1_BRKESTS1_Pos) /*!< TIMER_T::PWMINTSTS1: BRKESTS1 Mask */ + +#define TIMER_PWMINTSTS1_BRKLSTS0_Pos (24) /*!< TIMER_T::PWMINTSTS1: BRKLSTS0 Position */ +#define TIMER_PWMINTSTS1_BRKLSTS0_Msk (0x1ul << TIMER_PWMINTSTS1_BRKLSTS0_Pos) /*!< TIMER_T::PWMINTSTS1: BRKLSTS0 Mask */ + +#define TIMER_PWMINTSTS1_BRKLSTS1_Pos (25) /*!< TIMER_T::PWMINTSTS1: BRKLSTS1 Position */ +#define TIMER_PWMINTSTS1_BRKLSTS1_Msk (0x1ul << TIMER_PWMINTSTS1_BRKLSTS1_Pos) /*!< TIMER_T::PWMINTSTS1: BRKLSTS1 Mask */ + +#define TIMER_PWMEADCTS_TRGSEL_Pos (0) /*!< TIMER_T::PWMEADCTS: TRGSEL Position */ +#define TIMER_PWMEADCTS_TRGSEL_Msk (0x7ul << TIMER_PWMEADCTS_TRGSEL_Pos) /*!< TIMER_T::PWMEADCTS: TRGSEL Mask */ + +#define TIMER_PWMEADCTS_TRGEN_Pos (7) /*!< TIMER_T::PWMEADCTS: TRGEN Position */ +#define TIMER_PWMEADCTS_TRGEN_Msk (0x1ul << TIMER_PWMEADCTS_TRGEN_Pos) /*!< TIMER_T::PWMEADCTS: TRGEN Mask */ + +#define TIMER_PWMSCTL_SYNCMODE_Pos (0) /*!< TIMER_T::PWMSCTL: SYNCMODE Position */ +#define TIMER_PWMSCTL_SYNCMODE_Msk (0x3ul << TIMER_PWMSCTL_SYNCMODE_Pos) /*!< TIMER_T::PWMSCTL: SYNCMODE Mask */ + +#define TIMER_PWMSCTL_SYNCSRC_Pos (8) /*!< TIMER_T::PWMSCTL: SYNCSRC Position */ +#define TIMER_PWMSCTL_SYNCSRC_Msk (0x1ul << TIMER_PWMSCTL_SYNCSRC_Pos) /*!< TIMER_T::PWMSCTL: SYNCSRC Mask */ + +#define TIMER_PWMSTRG_STRGEN_Pos (0) /*!< TIMER_T::PWMSTRG: STRGEN Position */ +#define TIMER_PWMSTRG_STRGEN_Msk (0x1ul << TIMER_PWMSTRG_STRGEN_Pos) /*!< TIMER_T::PWMSTRG: STRGEN Mask */ + +#define TIMER_PWMSTATUS_CNTMAXF_Pos (0) /*!< TIMER_T::PWMSTATUS: CNTMAXF Position */ +#define TIMER_PWMSTATUS_CNTMAXF_Msk (0x1ul << TIMER_PWMSTATUS_CNTMAXF_Pos) /*!< TIMER_T::PWMSTATUS: CNTMAXF Mask */ + +#define TIMER_PWMSTATUS_EADCTRGF_Pos (16) /*!< TIMER_T::PWMSTATUS: EADCTRGF Position */ +#define TIMER_PWMSTATUS_EADCTRGF_Msk (0x1ul << TIMER_PWMSTATUS_EADCTRGF_Pos) /*!< TIMER_T::PWMSTATUS: EADCTRGF Mask */ + +#define TIMER_PWMPBUF_PBUF_Pos (0) /*!< TIMER_T::PWMPBUF: PBUF Position */ +#define TIMER_PWMPBUF_PBUF_Msk (0xfffful << TIMER_PWMPBUF_PBUF_Pos) /*!< TIMER_T::PWMPBUF: PBUF Mask */ + +#define TIMER_PWMCMPBUF_CMPBUF_Pos (0) /*!< TIMER_T::PWMCMPBUF: CMPBUF Position */ +#define TIMER_PWMCMPBUF_CMPBUF_Msk (0xfffful << TIMER_PWMCMPBUF_CMPBUF_Pos) /*!< TIMER_T::PWMCMPBUF: CMPBUF Mask */ + +/**@}*/ /* TIMER_CONST */ +/**@}*/ /* end of TIMER register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __TIMER_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/trng_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/trng_reg.h new file mode 100644 index 00000000000..ede3dfa65ba --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/trng_reg.h @@ -0,0 +1,138 @@ +/**************************************************************************//** + * @file trng_reg.h + * @version V1.00 + * @brief TRNG register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __TRNG_REG_H__ +#define __TRNG_REG_H__ + +/** @addtogroup REGISTER Control Register + + @{ + +*/ + +/*---------------------- True Random Number Generator -------------------------*/ +/** + @addtogroup TRNG True Random Number Generator(TRNG) + Memory Mapped Structure for TRNG Controller +@{ */ + +typedef struct +{ + + + /** + * @var TRNG_T::CTL + * Offset: 0x00 TRNG Control Register and Status + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |TRNGEN |Random Number Generator Enable Bit + * | | |This bit can be set to 1 only after ACT (TRNG_ACT[7]) bit was set to 1 and READY (TRNG_CTL[7]) bit became 1. + * | | |0 = TRNG disabled. + * | | |1 = TRNG enabled. + * | | |Note: TRNGEN is an enable bit of digital part + * | | |When TRNG is not required to generate random number, TRNGEN bit and ACT (TRNG_ACT[7]) bit should be set to 0 to reduce power consumption. + * |[1] |DVIF |Data Valid (Read Only) + * | | |0 = Data is not valid. Reading from RNGD returns 0x00000000. + * | | |1 = Data is valid. A valid random number can be read form RNGD. + * | | |This bit is cleared to u20180u2019 by read TRNG_DATA. + * |[5:2] |CLKP |Clock Prescaler + * | | |The CLKP is the peripheral clock frequency range for the selected value , the CLKP must higher than or equal to the actual peripheral clock frequency (for correct random bit generation) + * | | |To change the CLKP contents, first set TRNGEN bit to 0 and then change CLKP; finally, set TRNGEN bit to 1 to re-enable the TRNG module. + * | | |0000 = 80 ~ 100 MHz. + * | | |0001 = 60 ~ 80 MHz. + * | | |0010 = 50 ~60 MHz. + * | | |0011 = 40 ~50 MHz. + * | | |0100 = 30 ~40 MHz. + * | | |0101 = 25 ~30 MHz. + * | | |0110 = 20 ~25 MHz. + * | | |0111 = 15 ~20 MHz. + * | | |1000 = 12 ~15 MHz. + * | | |1001 = 9 ~12 MHz. + * | | |1010 = 7 ~9 MHz. + * | | |1011 = 6 ~7 MHz. + * | | |1100 = 5 ~6 MHz. + * | | |1101 = 4 ~5 MHz. + * | | |1111 = Reserved. + * |[6] |DVIEN |Data Valid Interrupt Enable Bit + * | | |0 = Interrupt disabled.. + * | | |1 = Interrupt enabled. + * |[7] |READY |Random Number Generator Ready (Read Only) + * | | |After ACT (TRNG_ACT[7]) bit is set, the READY bit become to 1 after a delay of 90us~120us. + * | | |0 = RNG is not ready or was not activated. + * | | |1 = RNG is ready to be enabled.. + * |[31:8] |Reversed |Reversed + * @var TRNG_T::DATA + * Offset: 0x04 TRNG Data Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |DATA |Random Number Generator Data (Read Only) + * | | |The DATA store the random number generated by TRNG and can be read only once. + * @var TRNG_T::ACT + * Offset: 0x0C TRNG Activation Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[6:0] |VER |TRNG Version + * | | |TRNG version number is dependent on TRNG module. + * | | |0x02:(Current Version Number) + * |[7] |ACT |Random Number Generator Activation + * | | |After enable the ACT bit, it will active the TRNG module and wait the READY (TRNG_CTL[7]) bit to become 1. + * | | |0 = TRNG inactive. + * | | |1 = TRNG active. + * | | |Note: ACT is an enable bit of analog part + * | | |When TRNG is not required to generate random number, TRNGEN (TRNG_CTL[0]) bit and ACT bit should be set to 0 to reduce power consumption. + */ + __IO uint32_t CTL; /*!< [0x0000] TRNG Control Register and Status */ + __I uint32_t DATA; /*!< [0x0004] TRNG Data Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t ACT; /*!< [0x000c] TRNG Activation Register */ + +} TRNG_T; + +/** + @addtogroup TRNG_CONST TRNG Bit Field Definition + Constant Definitions for TRNG Controller +@{ */ + +#define TRNG_CTL_TRNGEN_Pos (0) /*!< TRNG_T::CTL: TRNGEN Position */ +#define TRNG_CTL_TRNGEN_Msk (0x1ul << TRNG_CTL_TRNGEN_Pos) /*!< TRNG_T::CTL: TRNGEN Mask */ + +#define TRNG_CTL_DVIF_Pos (1) /*!< TRNG_T::CTL: DVIF Position */ +#define TRNG_CTL_DVIF_Msk (0x1ul << TRNG_CTL_DVIF_Pos) /*!< TRNG_T::CTL: DVIF Mask */ + +#define TRNG_CTL_CLKP_Pos (2) /*!< TRNG_T::CTL: CLKP Position */ +#define TRNG_CTL_CLKP_Msk (0xful << TRNG_CTL_CLKP_Pos) /*!< TRNG_T::CTL: CLKP Mask */ + +#define TRNG_CTL_DVIEN_Pos (6) /*!< TRNG_T::CTL: DVIEN Position */ +#define TRNG_CTL_DVIEN_Msk (0x1ul << TRNG_CTL_DVIEN_Pos) /*!< TRNG_T::CTL: DVIEN Mask */ + +#define TRNG_CTL_READY_Pos (7) /*!< TRNG_T::CTL: READY Position */ +#define TRNG_CTL_READY_Msk (0x1ul << TRNG_CTL_READY_Pos) /*!< TRNG_T::CTL: READY Mask */ + +#define TRNG_CTL_Reversed_Pos (8) /*!< TRNG_T::CTL: Reversed Position */ +#define TRNG_CTL_Reversed_Msk (0xfffffful << TRNG_CTL_Reversed_Pos) /*!< TRNG_T::CTL: Reversed Mask */ + +#define TRNG_DATA_DATA_Pos (0) /*!< TRNG_T::DATA: DATA Position */ +#define TRNG_DATA_DATA_Msk (0xfful << TRNG_DATA_DATA_Pos) /*!< TRNG_T::DATA: DATA Mask */ + +#define TRNG_ACT_VER_Pos (0) /*!< TRNG_T::ACT: VER Position */ +#define TRNG_ACT_VER_Msk (0x7ful << TRNG_ACT_VER_Pos) /*!< TRNG_T::ACT: VER Mask */ + +#define TRNG_ACT_ACT_Pos (7) /*!< TRNG_T::ACT: ACT Position */ +#define TRNG_ACT_ACT_Msk (0x1ul << TRNG_ACT_ACT_Pos) /*!< TRNG_T::ACT: ACT Mask */ + +/**@}*/ /* TRNG_CONST */ +/**@}*/ /* end of TRNG register group */ +/**@}*/ /* end of REGISTER group */ + + +#endif /* __TRNG_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/uart_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/uart_reg.h new file mode 100644 index 00000000000..3524551a7a1 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/uart_reg.h @@ -0,0 +1,1273 @@ +/**************************************************************************//** + * @file uart_reg.h + * @version V1.00 + * @brief UART register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __UART_REG_H__ +#define __UART_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup UART Universal Asynchronous Receiver/Transmitter Controller(UART) + Memory Mapped Structure for UART Controller +@{ */ + +typedef struct +{ + + + /** + * @var UART_T::DAT + * Offset: 0x00 UART Receive/Transmit Buffer Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |DAT |Data Receive/Transmit Buffer + * | | |Write Operation: + * | | |By writing one byte to this register, the data byte will be stored in transmitter FIFO + * | | |The UART controller will send out the data stored in transmitter FIFO top location through the UART_TXD. + * | | |Read Operation: + * | | |By reading this register, the UART controller will return an 8-bit data received from receiver FIFO. + * |[8] |PARITY |Parity Bit Receive/Transmit Buffer + * | | |Write Operation: + * | | |By writing to this bit, the parity bit will be stored in transmitter FIFO + * | | |If PBE (UART_LINE[3]) and PSS (UART_LINE[7]) are set, + * | | |the UART controller will send out this bit follow the DAT (UART_DAT[7:0]) through the UART_TXD. + * | | |Read Operation: + * | | |If PBE (UART_LINE[3]) and PSS (UART_LINE[7]) are enabled, the parity bit can be read by this bit. + * | | |Note: This bit has effect only when PBE (UART_LINE[3]) and PSS (UART_LINE[7]) are set. + * @var UART_T::INTEN + * Offset: 0x04 UART Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |RDAIEN |Receive Data Available Interrupt Enable Bit + * | | |0 = Receive data available interrupt Disabled. + * | | |1 = Receive data available interrupt Enabled. + * |[1] |THREIEN |Transmit Holding Register Empty Interrupt Enable Bit + * | | |0 = Transmit holding register empty interrupt Disabled. + * | | |1 = Transmit holding register empty interrupt Enabled. + * |[2] |RLSIEN |Receive Line Status Interrupt Enable Bit + * | | |0 = Receive Line Status interrupt Disabled. + * | | |1 = Receive Line Status interrupt Enabled. + * |[3] |MODEMIEN |Modem Status Interrupt Enable Bit + * | | |0 = Modem status interrupt Disabled. + * | | |1 = Modem status interrupt Enabled. + * |[4] |RXTOIEN |RX Time-out Interrupt Enable Bit + * | | |0 = RX time-out interrupt Disabled. + * | | |1 = RX time-out interrupt Enabled. + * |[5] |BUFERRIEN |Buffer Error Interrupt Enable Bit + * | | |0 = Buffer error interrupt Disabled. + * | | |1 = Buffer error interrupt Enabled. + * |[6] |WKIEN |Wake-up Interrupt Enable Bit + * | | |0 = Wake-up Interrupt Disabled. + * | | |1 = Wake-up Interrupt Enabled. + * |[8] |LINIEN |LIN Bus Interrupt Enable Bit + * | | |0 = LIN bus interrupt Disabled. + * | | |1 = LIN bus interrupt Enabled. + * | | |Note: This bit is used for LIN function mode. + * |[11] |TOCNTEN |Receive Buffer Time-out Counter Enable Bit + * | | |0 = Receive Buffer Time-out counter Disabled. + * | | |1 = Receive Buffer Time-out counter Enabled. + * |[12] |ATORTSEN |nRTS Auto-flow Control Enable Bit + * | | |0 = nRTS auto-flow control Disabled. + * | | |1 = nRTS auto-flow control Enabled. + * | | |Note: When nRTS auto-flow is enabled, if the number of bytes in the RX FIFO equals the RTSTRGLV (UART_FIFO[19:16]), the UART will de-assert nRTS signal. + * |[13] |ATOCTSEN |nCTS Auto-flow Control Enable Bit + * | | |0 = nCTS auto-flow control Disabled. + * | | |1 = nCTS auto-flow control Enabled. + * | | |Note: When nCTS auto-flow is enabled, the UART will send data to external device if nCTS input assert (UART will not send data to device until nCTS is asserted). + * |[14] |TXPDMAEN |TX PDMA Enable Bit + * | | |This bit can enable or disable TX PDMA service. + * | | |0 = TX PDMA Disabled. + * | | |1 = TX PDMA Enabled. + * | | |Note: If RLSIEN (UART_INTEN[2]) is enabled and HWRLSINT (UART_INTSTS[26]) is set to 1, the RLS (Receive Line Status) Interrupt is caused + * | | |If RLS interrupt is caused by Break Error Flag BIF(UART_FIFOSTS[6]), Frame Error Flag FEF(UART_FIFO[5]) or Parity Error Flag PEF(UART_FIFOSTS[4]) , UART PDMA transmit request operation is stop + * | | |Clear Break Error Flag BIF or Frame Error Flag FEF or Parity Error Flag PEF by writing '1' to corresponding BIF, FEF and PEF to make UART PDMA transmit request operation continue. + * |[15] |RXPDMAEN |RX PDMA Enable Bit + * | | |This bit can enable or disable RX PDMA service. + * | | |0 = RX PDMA Disabled. + * | | |1 = RX PDMA Enabled. + * | | |Note: If RLSIEN (UART_INTEN[2]) is enabled and HWRLSINT (UART_INTSTS[26]) is set to 1, the RLS (Receive Line Status) Interrupt is caused + * | | |If RLS interrupt is caused by Break Error Flag BIF(UART_FIFOSTS[6]), Frame Error Flag FEF(UART_FIFO[5]) or Parity Error Flag PEF(UART_FIFOSTS[4]) , UART PDMA receive request operation is stop + * | | |Clear Break Error Flag BIF or Frame Error Flag FEF or Parity Error Flag PEF by writing '1' to corresponding BIF, FEF and PEF to make UART PDMA receive request operation continue. + * |[18] |ABRIEN |Auto-baud Rate Interrupt Enable Bit + * | | |0 = Auto-baud rate interrupt Disabled. + * | | |1 = Auto-baud rate interrupt Enabled. + * |[22] |TXENDIEN |Transmitter Empty Interrupt Enable Bit + * | | |If TXENDIEN (UART_INTEN[22]) is enabled, the Transmitter Empty interrupt TXENDINT (UART_INTSTS[30]) will be generated when TXENDIF (UART_INTSTS[22]) is set (TX FIFO (UART_DAT) is empty and the STOP bit of the last byte has been transmitted). + * | | |0 = Transmitter empty interrupt Disabled. + * | | |1 = Transmitter empty interrupt Enabled. + * @var UART_T::FIFO + * Offset: 0x08 UART FIFO Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1] |RXRST |RX Field Software Reset + * | | |When RXRST (UART_FIFO[1]) is set, all the byte in the receiver FIFO and RX internal state machine are cleared. + * | | |0 = No effect. + * | | |1 = Reset the RX internal state machine and pointers. + * | | |Note1: This bit will automatically clear at least 3 UART peripheral clock cycles. + * | | |Note2: Before setting this bit, it should wait for the RXIDLE (UART_FIFOSTS[29]) be set. + * |[2] |TXRST |TX Field Software Reset + * | | |When TXRST (UART_FIFO[2]) is set, all the byte in the transmit FIFO and TX internal state machine are cleared. + * | | |0 = No effect. + * | | |1 = Reset the TX internal state machine and pointers. + * | | |Note1: This bit will automatically clear at least 3 UART peripheral clock cycles. + * | | |Note2: Before setting this bit, it should wait for the TXEMPTYF (UART_FIFOSTS[28]) be set. + * |[7:4] |RFITL |RX FIFO Interrupt Trigger Level + * | | |When the number of bytes in the receive FIFO equals the RFITL, the RDAIF (UART_INTSTS[0]) will be set (if RDAIEN (UART_INTEN [0]) enabled, and an interrupt will be generated). + * | | |0000 = RX FIFO Interrupt Trigger Level is 1 byte. + * | | |0001 = RX FIFO Interrupt Trigger Level is 4 bytes. + * | | |0010 = RX FIFO Interrupt Trigger Level is 8 bytes. + * | | |0011 = RX FIFO Interrupt Trigger Level is 14 bytes. + * | | |Others = Reserved. + * |[8] |RXOFF |Receiver Disable Bit + * | | |The receiver is disabled or not (set 1 to disable receiver). + * | | |0 = Receiver Enabled. + * | | |1 = Receiver Disabled. + * | | |Note: This bit is used for RS-485 Normal Multi-drop mode + * | | |It should be programmed before RS485NMM (UART_ALTCTL [8]) is programmed. + * |[19:16] |RTSTRGLV |nRTS Trigger Level for Auto-flow Control Use + * | | |0000 = nRTS Trigger Level is 1 byte. + * | | |0001 = nRTS Trigger Level is 4 bytes. + * | | |0010 = nRTS Trigger Level is 8 bytes. + * | | |0011 = nRTS Trigger Level is 14 bytes. + * | | |Others = Reserved. + * | | |Note: This field is used for auto nRTS flow control. + * @var UART_T::LINE + * Offset: 0x0C UART Line Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |WLS |Word Length Selection + * | | |This field sets UART word length. + * | | |00 = 5 bits. + * | | |01 = 6 bits. + * | | |10 = 7 bits. + * | | |11 = 8 bits. + * |[2] |NSB |Number of 'STOP Bit' + * | | |0 = One 'STOP bit' is generated in the transmitted data. + * | | |1 = When select 5-bit word length, 1.5 'STOP bit' is generated in the transmitted data + * | | |When select 6-, 7- and 8-bit word length, 2 'STOP bit' is generated in the transmitted data. + * |[3] |PBE |Parity Bit Enable Bit + * | | |0 = Parity bit generated Disabled. + * | | |1 = Parity bit generated Enabled. + * | | |Note: Parity bit is generated on each outgoing character and is checked on each incoming data. + * |[4] |EPE |Even Parity Enable Bit + * | | |0 = Odd number of logic '1's is transmitted and checked in each word. + * | | |1 = Even number of logic '1's is transmitted and checked in each word. + * | | |Note: This bit has effect only when PBE (UART_LINE[3]) is set. + * |[5] |SPE |Stick Parity Enable Bit + * | | |0 = Stick parity Disabled. + * | | |1 = Stick parity Enabled. + * | | |Note: If PBE (UART_LINE[3]) and EPE (UART_LINE[4]) are logic 1, the parity bit is transmitted and checked as logic 0 + * | | |If PBE (UART_LINE[3]) is 1 and EPE (UART_LINE[4]) is 0 then the parity bit is transmitted and checked as 1. + * |[6] |BCB |Break Control Bit + * | | |0 = Break Control Disabled. + * | | |1 = Break Control Enabled. + * | | |Note: When this bit is set to logic 1, the transmitted serial data output (TX) is forced to the Spacing State (logic 0) + * | | |This bit acts only on TX line and has no effect on the transmitter logic. + * |[7] |PSS |Parity Bit Source Selection + * | | |The parity bit can be selected to be generated and checked automatically or by software. + * | | |0 = Parity bit is generated by EPE (UART_LINE[4]) and SPE (UART_LINE[5]) setting and checked automatically. + * | | |1 = Parity bit generated and checked by software. + * | | |Note1: This bit has effect only when PBE (UART_LINE[3]) is set. + * | | |Note2: If PSS is 0, the parity bit is transmitted and checked automatically + * | | |If PSS is 1, the transmitted parity bit value can be determined by writing PARITY (UART_DAT[8]) and the parity bit can be read by reading PARITY (UART_DAT[8]). + * |[8] |TXDINV |TX Data Inverted + * | | |0 = Transmitted data signal inverted Disabled. + * | | |1 = Transmitted data signal inverted Enabled. + * | | |Note1: Before setting this bit, TXRXDIS (UART_FUNCSEL[3]) should be set then waited for TXRXACT (UART_FIFOSTS[31]) is cleared + * | | |When the configuration is done, cleared TXRXDIS (UART_FUNCSEL[3]) to activate UART controller. + * | | |Note2: This bit is valid when FUNCSEL (UART_FUNCSEL[1:0]) is select UART, LIN or RS485 function. + * |[9] |RXDINV |RX Data Inverted + * | | |0 = Received data signal inverted Disabled. + * | | |1 = Received data signal inverted Enabled. + * | | |Note1: Before setting this bit, TXRXDIS (UART_FUNCSEL[3]) should be set then waited for TXRXACT (UART_FIFOSTS[31]) is cleared + * | | |When the configuration is done, cleared TXRXDIS (UART_FUNCSEL[3]) to activate UART controller. + * | | |Note2: This bit is valid when FUNCSEL (UART_FUNCSEL[1:0]) is select UART, LIN or RS485 function. + * @var UART_T::MODEM + * Offset: 0x10 UART Modem Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1] |RTS |nRTS (Request-to-send) Signal Control + * | | |This bit is direct control internal nRTS signal active or not, and then drive the nRTS pin output with RTSACTLV bit configuration. + * | | |0 = nRTS signal is active. + * | | |1 = nRTS signal is inactive. + * | | |Note1: This nRTS signal control bit is not effective when nRTS auto-flow control is enabled in UART function mode. + * | | |Note2: This nRTS signal control bit is not effective when RS-485 auto direction mode (AUD) is enabled in RS-485 function mode. + * |[9] |RTSACTLV |nRTS Pin Active Level + * | | |This bit defines the active level state of nRTS pin output. + * | | |0 = nRTS pin output is high level active. + * | | |1 = nRTS pin output is low level active. (Default) + * | | |Note1: Before setting this bit, TXRXDIS (UART_FUNCSEL[3]) should be set then waited for TXRXACT (UART_FIFOSTS[31]) is cleared + * | | |When the configuration is done, cleared TXRXDIS (UART_FUNCSEL[3]) to activate UART controller. + * |[13] |RTSSTS |nRTS Pin Status (Read Only) + * | | |This bit mirror from nRTS pin output of voltage logic status. + * | | |0 = nRTS pin output is low level voltage logic state. + * | | |1 = nRTS pin output is high level voltage logic state. + * @var UART_T::MODEMSTS + * Offset: 0x14 UART Modem Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CTSDETF |Detect nCTS State Change Flag + * | | |This bit is set whenever nCTS input has change state, and it will generate Modem interrupt to CPU when MODEMIEN (UART_INTEN [3]) is set to 1. + * | | |0 = nCTS input has not change state. + * | | |1 = nCTS input has change state. + * | | |Note: This bit can be cleared by writing '1' to it. + * |[4] |CTSSTS |nCTS Pin Status (Read Only) + * | | |This bit mirror from nCTS pin input of voltage logic status. + * | | |0 = nCTS pin input is low level voltage logic state. + * | | |1 = nCTS pin input is high level voltage logic state. + * | | |Note: This bit echoes when UART controller peripheral clock is enabled, and nCTS multi-function port is selected. + * |[8] |CTSACTLV |nCTS Pin Active Level + * | | |This bit defines the active level state of nCTS pin input. + * | | |0 = nCTS pin input is high level active. + * | | |1 = nCTS pin input is low level active. (Default) + * | | |Note: Before setting this bit, TXRXDIS (UART_FUNCSEL[3]) should be set then waited for TXRXACT (UART_FIFOSTS[31]) is cleared + * | | |When the configuration is done, cleared TXRXDIS (UART_FUNCSEL[3]) to activate UART controller. + * @var UART_T::FIFOSTS + * Offset: 0x18 UART FIFO Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |RXOVIF |RX Overflow Error Interrupt Flag + * | | |This bit is set when RX FIFO overflow. + * | | |If the number of bytes of received data is greater than RX_FIFO (UART_DAT) size 16 bytes, this bit will be set. + * | | |0 = RX FIFO is not overflow. + * | | |1 = RX FIFO is overflow. + * | | |Note: This bit can be cleared by writing '1' to it. + * |[1] |ABRDIF |Auto-baud Rate Detect Interrupt Flag + * | | |This bit is set to logic '1' when auto-baud rate detect function is finished. + * | | |0 = Auto-baud rate detect function is not finished. + * | | |1 = Auto-baud rate detect function is finished. + * | | |Note: This bit can be cleared by writing '1' to it. + * |[2] |ABRDTOIF |Auto-baud Rate Detect Time-out Interrupt Flag + * | | |This bit is set to logic '1' in Auto-baud Rate Detect mode when the baud rate counter is overflow. + * | | |0 = Auto-baud rate counter is underflow. + * | | |1 = Auto-baud rate counter is overflow. + * | | |Note: This bit can be cleared by writing '1' to it. + * |[3] |ADDRDETF |RS-485 Address Byte Detect Flag + * | | |0 = Receiver detects a data that is not an address bit (bit 9 ='0'). + * | | |1 = Receiver detects a data that is an address bit (bit 9 ='1'). + * | | |Note1: This field is used for RS-485 function mode and ADDRDEN (UART_ALTCTL[15]) is set to 1 to enable Address detection mode. + * | | |Note2: This bit can be cleared by writing '1' to it. + * |[4] |PEF |Parity Error Flag + * | | |This bit is set to logic 1 whenever the received character does not have a valid 'parity bit'. + * | | |0 = No parity error is generated. + * | | |1 = Parity error is generated. + * | | |Note: This bit can be cleared by writing '1' to it. + * |[5] |FEF |Framing Error Flag + * | | |This bit is set to logic 1 whenever the received character does not have a valid 'stop bit' + * | | |(that is, the stop bit following the last data bit or parity bit is detected as logic 0). + * | | |0 = No framing error is generated. + * | | |1 = Framing error is generated. + * | | |Note: This bit can be cleared by writing '1' to it. + * |[6] |BIF |Break Interrupt Flag + * | | |This bit is set to logic 1 whenever the received data input (RX) is held in the 'spacing state' (logic 0) + * | | |for longer than a full word transmission time (that is, the total time of start bit + data bits + parity + stop bits). + * | | |0 = No Break interrupt is generated. + * | | |1 = Break interrupt is generated. + * | | |Note: This bit can be cleared by writing '1' to it. + * |[13:8] |RXPTR |RX FIFO Pointer (Read Only) + * | | |This field indicates the RX FIFO Buffer Pointer + * | | |When UART receives one byte from external device, RXPTR increases one + * | | |When one byte of RX FIFO is read by CPU, RXPTR decreases one. + * | | |The Maximum value shown in RXPTR is 15 + * | | |When the using level of RX FIFO Buffer equal to 16, the RXFULL bit is set to 1 and RXPTR will show 0 + * | | |As one byte of RX FIFO is read by CPU, the RXFULL bit is cleared to 0 and RXPTR will show 15 + * |[14] |RXEMPTY |Receiver FIFO Empty (Read Only) + * | | |This bit initiate RX FIFO empty or not. + * | | |0 = RX FIFO is not empty. + * | | |1 = RX FIFO is empty. + * | | |Note: When the last byte of RX FIFO has been read by CPU, hardware sets this bit high + * | | |It will be cleared when UART receives any new data. + * |[15] |RXFULL |Receiver FIFO Full (Read Only) + * | | |This bit initiates RX FIFO full or not. + * | | |0 = RX FIFO is not full. + * | | |1 = RX FIFO is full. + * | | |Note: This bit is set when the number of usage in RX FIFO Buffer is equal to 16, otherwise it is cleared by hardware. + * |[21:16] |TXPTR |TX FIFO Pointer (Read Only) + * | | |This field indicates the TX FIFO Buffer Pointer + * | | |When CPU writes one byte into UART_DAT, TXPTR increases one + * | | |When one byte of TX FIFO is transferred to Transmitter Shift Register, TXPTR decreases one. + * | | |The Maximum value shown in TXPTR is 15 + * | | |When the using level of TX FIFO Buffer equal to 16, the TXFULL bit is set to 1 and TXPTR will show 0 + * | | |As one byte of TX FIFO is transferred to Transmitter Shift Register, the TXFULL bit is cleared to 0 and TXPTR will show 15 + * |[22] |TXEMPTY |Transmitter FIFO Empty (Read Only) + * | | |This bit indicates TX FIFO empty or not. + * | | |0 = TX FIFO is not empty. + * | | |1 = TX FIFO is empty. + * | | |Note: When the last byte of TX FIFO has been transferred to Transmitter Shift Register, hardware sets this bit high + * | | |It will be cleared when writing data into UART_DAT (TX FIFO not empty). + * |[23] |TXFULL |Transmitter FIFO Full (Read Only) + * | | |This bit indicates TX FIFO full or not. + * | | |0 = TX FIFO is not full. + * | | |1 = TX FIFO is full. + * | | |Note: This bit is set when the number of usage in TX FIFO Buffer is equal to 16, otherwise it is cleared by hardware. + * |[24] |TXOVIF |TX Overflow Error Interrupt Flag + * | | |If TX FIFO (UART_DAT) is full, an additional write to UART_DAT will cause this bit to logic 1. + * | | |0 = TX FIFO is not overflow. + * | | |1 = TX FIFO is overflow. + * | | |Note: This bit can be cleared by writing '1' to it. + * |[28] |TXEMPTYF |Transmitter Empty Flag (Read Only) + * | | |This bit is set by hardware when TX FIFO (UART_DAT) is empty and the STOP bit of the last byte has been transmitted. + * | | |0 = TX FIFO is not empty or the STOP bit of the last byte has been not transmitted. + * | | |1 = TX FIFO is empty and the STOP bit of the last byte has been transmitted. + * | | |Note: This bit is cleared automatically when TX FIFO is not empty or the last byte transmission has not completed. + * |[29] |RXIDLE |RX Idle Status (Read Only) + * | | |This bit is set by hardware when RX is idle. + * | | |0 = RX is busy. + * | | |1 = RX is idle. (Default) + * |[31] |TXRXACT |TX and RX Active Status (Read Only) + * | | |This bit indicates TX and RX are active or inactive. + * | | |0 = TX and RX are inactive. + * | | |1 = TX and RX are active. (Default) + * | | |Note: When TXRXDIS (UART_FUNCSEL[3]) is set and both TX and RX are in idle state, this bit is cleared + * | | |The UART controller can not transmit or receive data at this moment + * | | |Otherwise this bit is set. + * @var UART_T::INTSTS + * Offset: 0x1C UART Interrupt Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |RDAIF |Receive Data Available Interrupt Flag + * | | |When the number of bytes in the RX FIFO equals the RFITL then the RDAIF(UART_INTSTS[0]) will be set + * | | |If RDAIEN (UART_INTEN [0]) is enabled, the RDA interrupt will be generated. + * | | |0 = No RDA interrupt flag is generated. + * | | |1 = RDA interrupt flag is generated. + * | | |Note: This bit is read only and it will be cleared when the number of unread bytes of RX FIFO drops below the threshold level (RFITL(UART_FIFO[7:4]). + * |[1] |THREIF |Transmit Holding Register Empty Interrupt Flag + * | | |This bit is set when the last data of TX FIFO is transferred to Transmitter Shift Register + * | | |If THREIEN (UART_INTEN[1]) is enabled, the THRE interrupt will be generated. + * | | |0 = No THRE interrupt flag is generated. + * | | |1 = THRE interrupt flag is generated. + * | | |Note: This bit is read only and it will be cleared when writing data into UART_DAT (TX FIFO not empty). + * |[2] |RLSIF |Receive Line Interrupt Flag (Read Only) + * | | |This bit is set when the RX receive data have parity error, frame error or break error (at least one of 3 bits, BIF(UART_FIFOSTS[6]), FEF(UART_FIFOSTS[5]) and PEF(UART_FIFOSTS[4]), is set) + * | | |If RLSIEN (UART_INTEN [2]) is enabled, the RLS interrupt will be generated. + * | | |0 = No RLS interrupt flag is generated. + * | | |1 = RLS interrupt flag is generated. + * | | |Note1: In RS-485 function mode, this field is set include "receiver detect and received address byte character (bit9 = '1') bit" + * | | |At the same time, the bit of ADDRDETF (UART_FIFOSTS[3]) is also set. + * | | |Note2: This bit is read only and reset to 0 when all bits of BIF (UART_FIFOSTS[6]), FEF(UART_FIFOSTS[5]) and PEF(UART_FIFOSTS[4]) are cleared. + * | | |Note3: In RS-485 function mode, this bit is read only and reset to 0 when all bits of BIF (UART_FIFOSTS[6]) , FEF(UART_FIFOSTS[5]), PEF(UART_FIFOSTS[4]) and ADDRDETF (UART_FIFOSTS[3]) are cleared. + * |[3] |MODEMIF |MODEM Interrupt Flag (Read Only) + * | | |This bit is set when the nCTS pin has state change (CTSDETF (UART_MODEMSTS[0]) = 1) + * | | |If MODEMIEN (UART_INTEN [3]) is enabled, the Modem interrupt will be generated. + * | | |0 = No Modem interrupt flag is generated. + * | | |1 = Modem interrupt flag is generated. + * | | |Note: This bit is read only and reset to 0 when bit CTSDETF is cleared by a write 1 on CTSDETF(UART_MODEMSTS[0]). + * |[4] |RXTOIF |RX Time-out Interrupt Flag (Read Only) + * | | |This bit is set when the RX FIFO is not empty and no activities occurred in the RX FIFO and the time-out counter equal to TOIC (UART_TOUT[7:0]) + * | | |If RXTOIEN (UART_INTEN [4]) is enabled, the RX time-out interrupt will be generated. + * | | |0 = No RX time-out interrupt flag is generated. + * | | |1 = RX time-out interrupt flag is generated. + * | | |Note: This bit is read only and user can read UART_DAT (RX is in active) to clear it. + * |[5] |BUFERRIF |Buffer Error Interrupt Flag (Read Only) + * | | |This bit is set when the TX FIFO or RX FIFO overflows (TXOVIF (UART_FIFOSTS[24]) or RXOVIF (UART_FIFOSTS[0]) is set) + * | | |When BUFERRIF (UART_INTSTS[5]) is set, the transfer is not correct + * | | |If BUFERRIEN (UART_INTEN [5]) is enabled, the buffer error interrupt will be generated. + * | | |0 = No buffer error interrupt flag is generated. + * | | |1 = Buffer error interrupt flag is generated. + * | | |Note: This bit is cleared if both of RXOVIF(UART_FIFOSTS[0]) and TXOVIF(UART_FIFOSTS[24]) are cleared to 0 by writing 1 to RXOVIF(UART_FIFOSTS[0]) and TXOVIF(UART_FIFOSTS[24]). + * |[6] |WKIF |UART Wake-up Interrupt Flag (Read Only) + * | | |This bit is set when TOUTWKF (UART_WKSTS[4]), RS485WKF (UART_WKSTS[3]), RFRTWKF (UART_WKSTS[2]), DATWKF (UART_WKSTS[1]) or CTSWKF(UART_WKSTS[0]) is set to 1. + * | | |0 = No UART wake-up interrupt flag is generated. + * | | |1 = UART wake-up interrupt flag is generated. + * | | |Note: This bit is cleared if all of TOUTWKF, RS485WKF, RFRTWKF, DATWKF and CTSWKF are cleared to 0 by writing 1 to the corresponding interrupt flag. + * |[7] |LINIF |LIN Bus Interrupt Flag + * | | |This bit is set when LIN slave header detect (SLVHDETF (UART_LINSTS[0] = 1)), LIN break detect (BRKDETF(UART_LINSTS[8]=1)), bit error detect (BITEF(UART_LINSTS[9]=1)), LIN slave ID parity error (SLVIDPEF(UART_LINSTS[2] = 1)) or LIN slave header error detect (SLVHEF (UART_LINSTS[1])) + * | | |If LINIEN (UART_INTEN [8]) is enabled the LIN interrupt will be generated. + * | | |0 = None of SLVHDETF, BRKDETF, BITEF, SLVIDPEF and SLVHEF is generated. + * | | |1 = At least one of SLVHDETF, BRKDETF, BITEF, SLVIDPEF and SLVHEF is generated. + * | | |Note: This bit is cleared when SLVHDETF(UART_LINSTS[0]), BRKDETF(UART_LINSTS[8]), BITEF(UART_LINSTS[9]), SLVIDPEF (UART_LINSTS[2]) and SLVHEF(UART_LINSTS[1]) all are cleared and software writing '1' to LINIF(UART_INTSTS[7]). + * |[8] |RDAINT |Receive Data Available Interrupt Indicator (Read Only) + * | | |This bit is set if RDAIEN (UART_INTEN[0]) and RDAIF (UART_INTSTS[0]) are both set to 1. + * | | |0 = No RDA interrupt is generated. + * | | |1 = RDA interrupt is generated. + * |[9] |THREINT |Transmit Holding Register Empty Interrupt Indicator (Read Only) + * | | |This bit is set if THREIEN (UART_INTEN[1]) and THREIF(UART_INTSTS[1]) are both set to 1. + * | | |0 = No THRE interrupt is generated. + * | | |1 = THRE interrupt is generated. + * |[10] |RLSINT |Receive Line Status Interrupt Indicator (Read Only) + * | | |This bit is set if RLSIEN (UART_INTEN[2]) and RLSIF(UART_INTSTS[2]) are both set to 1. + * | | |0 = No RLS interrupt is generated. + * | | |1 = RLS interrupt is generated. + * |[11] |MODEMINT |MODEM Status Interrupt Indicator (Read Only) + * | | |This bit is set if MODEMIEN(UART_INTEN[3]) and MODEMIF(UART_INTSTS[3]) are both set to 1 + * | | |0 = No Modem interrupt is generated. + * | | |1 = Modem interrupt is generated. + * |[12] |RXTOINT |RX Time-out Interrupt Indicator (Read Only) + * | | |This bit is set if RXTOIEN (UART_INTEN[4]) and RXTOIF(UART_INTSTS[4]) are both set to 1. + * | | |0 = No RX time-out interrupt is generated. + * | | |1 = RX time-out interrupt is generated. + * |[13] |BUFERRINT |Buffer Error Interrupt Indicator (Read Only) + * | | |This bit is set if BUFERRIEN(UART_INTEN[5]) and BUFERRIF(UART_ INTSTS[5]) are both set to 1. + * | | |0 = No buffer error interrupt is generated. + * | | |1 = Buffer error interrupt is generated. + * |[14] |WKINT |UART Wake-up Interrupt Indicator (Read Only) + * | | |This bit is set if WKIEN (UART_INTEN[6]) and WKIF (UART_INTSTS[6]) are both set to 1. + * | | |0 = No UART wake-up interrupt is generated. + * | | |1 = UART wake-up interrupt is generated. + * |[15] |LININT |LIN Bus Interrupt Indicator (Read Only) + * | | |This bit is set if LINIEN (UART_INTEN[8]) and LINIF(UART_INTSTS[7]) are both set to 1. + * | | |0 = No LIN Bus interrupt is generated. + * | | |1 = The LIN Bus interrupt is generated. + * |[18] |HWRLSIF |PDMA Mode Receive Line Status Flag (Read Only) + * | | |This bit is set when the RX receive data have parity error, frame error or break error (at least one of 3 bits, BIF (UART_FIFOSTS[6]), FEF (UART_FIFOSTS[5]) and PEF (UART_FIFOSTS[4]) is set) + * | | |If RLSIEN (UART_INTEN [2]) is enabled, the RLS interrupt will be generated. + * | | |0 = No RLS interrupt flag is generated in PDMA mode. + * | | |1 = RLS interrupt flag is generated in PDMA mode. + * | | |Note1: In RS-485 function mode, this field include "receiver detect any address byte received address byte character (bit9 = '1') bit". + * | | |Note2: In UART function mode, this bit is read only and reset to 0 when all bits of BIF(UART_FIFOSTS[6]) , FEF(UART_FIFOSTS[5]) and PEF(UART_FIFOSTS[4]) are cleared. + * | | |Note3: In RS-485 function mode, this bit is read only and reset to 0 when all bits of BIF(UART_FIFOSTS[6]), FEF(UART_FIFOSTS[5]), PEF(UART_FIFOSTS[4]) and ADDRDETF (UART_FIFOSTS[3]) are cleared + * |[19] |HWMODIF |PDMA Mode MODEM Interrupt Flag (Read Only) + * | | |This bit is set when the nCTS pin has state change (CTSDETF (UART_MODEMSTS [0] =1)) + * | | |If MODEMIEN (UART_INTEN [3]) is enabled, the Modem interrupt will be generated. + * | | |0 = No Modem interrupt flag is generated in PDMA mode. + * | | |1 = Modem interrupt flag is generated in PDMA mode. + * | | |Note: This bit is read only and reset to 0 when the bit CTSDETF (UART_MODEMSTS[0]) is cleared by writing 1 on CTSDETF (UART_MODEMSTS [0]). + * |[20] |HWTOIF |PDMA Mode RX Time-out Interrupt Flag (Read Only) + * | | |This bit is set when the RX FIFO is not empty and no activities occurred in the RX FIFO and the time-out counter equal to TOIC (UART_TOUT[7:0]) + * | | |If RXTOIEN (UART_INTEN [4]) is enabled, the RX time-out interrupt will be generated . + * | | |0 = No RX time-out interrupt flag is generated in PDMA mode. + * | | |1 = RX time-out interrupt flag is generated in PDMA mode. + * | | |Note: This bit is read only and user can read UART_DAT (RX is in active) to clear it. + * |[21] |HWBUFEIF |PDMA Mode Buffer Error Interrupt Flag (Read Only) + * | | |This bit is set when the TX or RX FIFO overflows (TXOVIF (UART_FIFOSTS [24]) or RXOVIF (UART_FIFOSTS[0]) is set) + * | | |When BUFERRIF (UART_INTSTS[5]) is set, the transfer maybe is not correct + * | | |If BUFERRIEN (UART_INTEN [5]) is enabled, the buffer error interrupt will be generated. + * | | |0 = No buffer error interrupt flag is generated in PDMA mode. + * | | |1 = Buffer error interrupt flag is generated in PDMA mode. + * | | |Note: This bit is cleared when both TXOVIF (UART_FIFOSTS[24]]) and RXOVIF (UART_FIFOSTS[0]) are cleared. + * |[22] |TXENDIF |Transmitter Empty Interrupt Flag + * | | |This bit is set when TX FIFO (UART_DAT) is empty and the STOP bit of the last byte has been transmitted (TXEMPTYF (UART_FIFOSTS[28]) is set) + * | | |If TXENDIEN (UART_INTEN[22]) is enabled, the Transmitter Empty interrupt will be generated. + * | | |0 = No transmitter empty interrupt flag is generated. + * | | |1 = Transmitter empty interrupt flag is generated. + * | | |Note: This bit is cleared automatically when TX FIFO is not empty or the last byte transmission has not completed. + * |[26] |HWRLSINT |PDMA Mode Receive Line Status Interrupt Indicator (Read Only) + * | | |This bit is set if RLSIEN (UART_INTEN[2]) and HWRLSIF(UART_INTSTS[18]) are both set to 1. + * | | |0 = No RLS interrupt is generated in PDMA mode. + * | | |1 = RLS interrupt is generated in PDMA mode. + * |[27] |HWMODINT |PDMA Mode MODEM Status Interrupt Indicator (Read Only) + * | | |This bit is set if MODEMIEN (UART_INTEN[3]) and HWMODIF(UART_INTSTS[19]) are both set to 1. + * | | |0 = No Modem interrupt is generated in PDMA mode. + * | | |1 = Modem interrupt is generated in PDMA mode. + * |[28] |HWTOINT |PDMA Mode RX Time-out Interrupt Indicator (Read Only) + * | | |This bit is set if RXTOIEN (UART_INTEN[4]) and HWTOIF(UART_INTSTS[20]) are both set to 1. + * | | |0 = No RX time-out interrupt is generated in PDMA mode. + * | | |1 = RX time-out interrupt is generated in PDMA mode. + * |[29] |HWBUFEINT |PDMA Mode Buffer Error Interrupt Indicator (Read Only) + * | | |This bit is set if BUFERRIEN (UART_INTEN[5]) and HWBUFEIF (UART_INTSTS[21]) are both set to 1. + * | | |0 = No buffer error interrupt is generated in PDMA mode. + * | | |1 = Buffer error interrupt is generated in PDMA mode. + * |[30] |TXENDINT |Transmitter Empty Interrupt Indicator (Read Only) + * | | |This bit is set if TXENDIEN (UART_INTEN[22]) and TXENDIF(UART_INTSTS[22]) are both set to 1. + * | | |0 = No Transmitter Empty interrupt is generated. + * | | |1 = Transmitter Empty interrupt is generated. + * |[31] |ABRINT |Auto-baud Rate Interrupt Indicator (Read Only) + * | | |This bit is set if ABRIEN (UART_INTEN[18]) and ABRIF (UART_ALTCTL[17]) are both set to 1. + * | | |0 = No Auto-baud Rate interrupt is generated. + * | | |1 = The Auto-baud Rate interrupt is generated. + * @var UART_T::TOUT + * Offset: 0x20 UART Time-out Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |TOIC |Time-out Interrupt Comparator + * | | |The time-out counter resets and starts counting (the counting clock = baud rate) whenever the RX FIFO receives a new data word if time out counter is enabled by setting TOCNTEN (UART_INTEN[11]) + * | | |Once the content of time-out counter is equal to that of time-out interrupt comparator (TOIC (UART_TOUT[7:0])), a receiver time-out interrupt (RXTOINT(UART_INTSTS[12])) is generated if RXTOIEN (UART_INTEN [4]) enabled + * | | |A new incoming data word or RX FIFO empty will clear RXTOIF (UART_INTSTS[4]) + * | | |In order to avoid receiver time-out interrupt generation immediately during one character is being received, TOIC value should be set between 40 and 255 + * | | |So, for example, if TOIC is set with 40, the time-out interrupt is generated after four characters are not received when 1 stop bit and no parity check is set for UART transfer. + * |[15:8] |DLY |TX Delay Time Value + * | | |This field is used to programming the transfer delay time between the last stop bit and next start bit + * | | |The unit is bit time. + * @var UART_T::BAUD + * Offset: 0x24 UART Baud Rate Divider Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |BRD |Baud Rate Divider + * | | |The field indicates the baud rate divider + * | | |This filed is used in baud rate calculation + * | | |The detail description is shown in Table 7.15-4. + * |[27:24] |EDIVM1 |Extra Divider for BAUD Rate Mode 1 + * | | |This field is used for baud rate calculation in mode 1 and has no effect for baud rate calculation in mode 0 and mode 2 + * | | |The detail description is shown in Table 7.15-4 + * |[28] |BAUDM0 |BAUD Rate Mode Selection Bit 0 + * | | |This bit is baud rate mode selection bit 0 + * | | |UART provides three baud rate calculation modes + * | | |This bit combines with BAUDM1 (UART_BAUD[29]) to select baud rate calculation mode + * | | |The detail description is shown in Table 7.15-4. + * |[29] |BAUDM1 |BAUD Rate Mode Selection Bit 1 + * | | |This bit is baud rate mode selection bit 1 + * | | |UART provides three baud rate calculation modes + * | | |This bit combines with BAUDM0 (UART_BAUD[28]) to select baud rate calculation mode + * | | |The detail description is shown in Table 7.15-4. + * | | |Note: In IrDA mode must be operated in mode 0. + * @var UART_T::IRDA + * Offset: 0x28 UART IrDA Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1] |TXEN |IrDA Receiver/Transmitter Selection Enable Bit + * | | |0 = IrDA Transmitter Disabled and Receiver Enabled. (Default) + * | | |1 = IrDA Transmitter Enabled and Receiver Disabled. + * |[5] |TXINV |IrDA Inverse Transmitting Output Signal + * | | |0 = None inverse transmitting signal. (Default). + * | | |1 = Inverse transmitting output signal. + * | | |Note1: Before setting this bit, TXRXDIS (UART_FUNCSEL[3]) should be set then waited for TXRXACT (UART_FIFOSTS[31]) is cleared + * | | |When the configuration is done, cleared TXRXDIS (UART_FUNCSEL[3]) to activate UART controller. + * | | |Note2: This bit is valid when FUNCSEL (UART_FUNCSEL[1:0]) is select IrDA function. + * |[6] |RXINV |IrDA Inverse Receive Input Signal + * | | |0 = None inverse receiving input signal. + * | | |1 = Inverse receiving input signal. (Default) + * | | |Note1: Before setting this bit, TXRXDIS (UART_FUNCSEL[3]) should be set then waited for TXRXACT (UART_FIFOSTS[31]) is cleared + * | | |When the configuration is done, cleared TXRXDIS (UART_FUNCSEL[3]) to activate UART controller. + * | | |Note2: This bit is valid when FUNCSEL (UART_FUNCSEL[1:0]) is select IrDA function. + * @var UART_T::ALTCTL + * Offset: 0x2C UART Alternate Control/Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |BRKFL |UART LIN Break Field Length + * | | |This field indicates a 4-bit LIN TX break field count. + * | | |Note1: This break field length is BRKFL + 1. + * | | |Note2: According to LIN spec, the reset value is 0xC (break field length = 13). + * |[6] |LINRXEN |LIN RX Enable Bit + * | | |0 = LIN RX mode Disabled. + * | | |1 = LIN RX mode Enabled. + * |[7] |LINTXEN |LIN TX Break Mode Enable Bit + * | | |0 = LIN TX Break mode Disabled. + * | | |1 = LIN TX Break mode Enabled. + * | | |Note: When TX break field transfer operation finished, this bit will be cleared automatically. + * |[8] |RS485NMM |RS-485 Normal Multi-drop Operation Mode (NMM) + * | | |0 = RS-485 Normal Multi-drop Operation mode (NMM) Disabled. + * | | |1 = RS-485 Normal Multi-drop Operation mode (NMM) Enabled. + * | | |Note: It cannot be active with RS-485_AAD operation mode. + * |[9] |RS485AAD |RS-485 Auto Address Detection Operation Mode (AAD) + * | | |0 = RS-485 Auto Address Detection Operation mode (AAD) Disabled. + * | | |1 = RS-485 Auto Address Detection Operation mode (AAD) Enabled. + * | | |Note: It cannot be active with RS-485_NMM operation mode. + * |[10] |RS485AUD |RS-485 Auto Direction Function (AUD) + * | | |0 = RS-485 Auto Direction Operation function (AUD) Disabled. + * | | |1 = RS-485 Auto Direction Operation function (AUD) Enabled. + * | | |Note: It can be active with RS-485_AAD or RS-485_NMM operation mode. + * |[15] |ADDRDEN |RS-485 Address Detection Enable Bit + * | | |This bit is used to enable RS-485 Address Detection mode. + * | | |0 = Address detection mode Disabled. + * | | |1 = Address detection mode Enabled. + * | | |Note: This bit is used for RS-485 any operation mode. + * |[17] |ABRIF |Auto-baud Rate Interrupt Flag (Read Only) + * | | |This bit is set when auto-baud rate detection function finished or the auto-baud rate counter was overflow and if ABRIEN(UART_INTEN [18]) is set then the auto-baud rate interrupt will be generated. + * | | |0 = No auto-baud rate interrupt flag is generated. + * | | |1 = Auto-baud rate interrupt flag is generated. + * | | |Note: This bit is read only, but it can be cleared by writing '1' to ABRDTOIF (UART_FIFOSTS[2]) and ABRDIF(UART_FIFOSTS[1]) + * |[18] |ABRDEN |Auto-baud Rate Detect Enable Bit + * | | |0 = Auto-baud rate detect function Disabled. + * | | |1 = Auto-baud rate detect function Enabled. + * | | |Note : This bit is cleared automatically after auto-baud detection is finished. + * |[20:19] |ABRDBITS |Auto-baud Rate Detect Bit Length + * | | |00 = 1-bit time from Start bit to the 1st rising edge. The input pattern shall be 0x01. + * | | |01 = 2-bit time from Start bit to the 1st rising edge. The input pattern shall be 0x02. + * | | |10 = 4-bit time from Start bit to the 1st rising edge. The input pattern shall be 0x08. + * | | |11 = 8-bit time from Start bit to the 1st rising edge. The input pattern shall be 0x80. + * | | |Note : The calculation of bit number includes the START bit. + * |[31:24] |ADDRMV |Address Match Value + * | | |This field contains the RS-485 address match values. + * | | |Note: This field is used for RS-485 auto address detection mode. + * @var UART_T::FUNCSEL + * Offset: 0x30 UART Function Select Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |FUNCSEL |Function Select + * | | |00 = UART function. + * | | |01 = LIN function. + * | | |10 = IrDA function. + * | | |11 = RS-485 function. + * |[3] |TXRXDIS |TX and RX Disable Bit + * | | |Setting this bit can disable TX and RX. + * | | |0 = TX and RX Enabled. + * | | |1 = TX and RX Disabled. + * | | |Note: The TX and RX will not disable immediately when this bit is set + * | | |The TX and RX complete current task before disable TX and RX + * | | |When TX and RX disable, the TXRXACT (UART_FIFOSTS[31]) is cleared. + * @var UART_T::LINCTL + * Offset: 0x34 UART LIN Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SLVEN |LIN Slave Mode Enable Bit + * | | |0 = LIN slave mode Disabled. + * | | |1 = LIN slave mode Enabled. + * |[1] |SLVHDEN |LIN Slave Header Detection Enable Bit + * | | |0 = LIN slave header detection Disabled. + * | | |1 = LIN slave header detection Enabled. + * | | |Note1: This bit only valid when in LIN slave mode (SLVEN (UART_LINCTL[0]) = 1). + * | | |Note2: In LIN function mode, when detect header field (break + sync + frame ID), SLVHDETF (UART_LINSTS [0]) flag will be asserted + * | | |If the LINIEN (UART_INTEN[8]) = 1, an interrupt will be generated. + * |[2] |SLVAREN |LIN Slave Automatic Resynchronization Mode Enable Bit + * | | |0 = LIN automatic resynchronization Disabled. + * | | |1 = LIN automatic resynchronization Enabled. + * | | |Note1: This bit only valid when in LIN slave mode (SLVEN (UART_LINCTL[0]) = 1). + * | | |Note2: When operation in Automatic Resynchronization mode, the baud rate setting must be mode2 (BAUDM1 (UART_BAUD [29]) and BAUDM0 (UART_BAUD [28]) must be 1). + * | | |Note3: The control and interactions of this field are explained in 7.15.5.9 (Slave mode with automatic resynchronization). + * |[3] |SLVDUEN |LIN Slave Divider Update Method Enable Bit + * | | |0 = UART_BAUD updated is written by software (if no automatic resynchronization update occurs at the same time). + * | | |1 = UART_BAUD is updated at the next received character + * | | |User must set the bit before checksum reception. + * | | |Note1: This bit only valid when in LIN slave mode (SLVEN (UART_LINCTL[0]) = 1). + * | | |Note2: This bit used for LIN Slave Automatic Resynchronization mode + * | | |(for Non-Automatic Resynchronization mode, this bit should be kept cleared) + * | | |Note3: The control and interactions of this field are explained in 7.15.5.9 (Slave mode with automatic resynchronization). + * |[4] |MUTE |LIN Mute Mode Enable Bit + * | | |0 = LIN mute mode Disabled. + * | | |1 = LIN mute mode Enabled. + * | | |Note: The exit from mute mode condition and each control and interactions of this field are explained in 7.15.5.9 (LIN slave mode). + * |[8] |SENDH |LIN TX Send Header Enable Bit + * | | |The LIN TX header can be break field or 'break and sync field' or 'break, sync and frame ID field', it is depend on setting HSEL (UART_LINCTL[23:22]). + * | | |0 = Send LIN TX header Disabled. + * | | |1 = Send LIN TX header Enabled. + * | | |Note1: This bit is shadow bit of LINTXEN (UART_ALTCTL [7]); user can read/write it by setting LINTXEN (UART_ALTCTL [7]) or SENDH (UART_LINCTL [8]). + * | | |Note2: When transmitter header field (it may be 'break' or 'break + sync' or 'break + sync + frame ID' selected by HSEL (UART_LINCTL[23:22]) field) transfer operation finished, this bit will be cleared automatically. + * |[9] |IDPEN |LIN ID Parity Enable Bit + * | | |0 = LIN frame ID parity Disabled. + * | | |1 = LIN frame ID parity Enabled. + * | | |Note1: This bit can be used for LIN master to sending header field (SENDH (UART_LINCTL[8])) = 1 and HSEL (UART_LINCTL[23:22]) = 10 or be used for enable LIN slave received frame ID parity checked. + * | | |Note2: This bit is only used when the operation header transmitter is in HSEL (UART_LINCTL[23:22]) = 10 + * |[10] |BRKDETEN |LIN Break Detection Enable Bit + * | | |When detect consecutive dominant greater than 11 bits, and are followed by a delimiter character, the BRKDETF (UART_LINSTS[8]) flag is set at the end of break field + * | | |If the LINIEN (UART_INTEN [8])=1, an interrupt will be generated. + * | | |0 = LIN break detection Disabled . + * | | |1 = LIN break detection Enabled. + * |[11] |LINRXOFF |LIN Receiver Disable Bit + * | | |If the receiver is enabled (LINRXOFF (UART_LINCTL[11] ) = 0), all received byte data will be accepted and stored in the RX FIFO, and if the receiver is disabled (LINRXOFF (UART_LINCTL[11] = 1), all received byte data will be ignore. + * | | |0 = LIN receiver Enabled. + * | | |1 = LIN receiver Disabled. + * | | |Note: This bit is only valid when operating in LIN function mode (FUNCSEL (UART_FUNCSEL[1:0]) = 01). + * |[12] |BITERREN |Bit Error Detect Enable Bit + * | | |0 = Bit error detection function Disabled. + * | | |1 = Bit error detection function Enabled. + * | | |Note: In LIN function mode, when occur bit error, the BITEF (UART_LINSTS[9]) flag will be asserted + * | | |If the LINIEN (UART_INTEN[8]) = 1, an interrupt will be generated. + * |[19:16] |BRKFL |LIN Break Field Length + * | | |This field indicates a 4-bit LIN TX break field count. + * | | |Note1: These registers are shadow registers of BRKFL (UART_ALTCTL[3:0]), User can read/write it by setting BRKFL (UART_ALTCTL[3:0]) or BRKFL (UART_LINCTL[19:16]). + * | | |Note2: This break field length is BRKFL + 1. + * | | |Note3: According to LIN spec, the reset value is 12 (break field length = 13). + * |[21:20] |BSL |LIN Break/Sync Delimiter Length + * | | |00 = The LIN break/sync delimiter length is 1-bit time. + * | | |01 = The LIN break/sync delimiter length is 2-bit time. + * | | |10 = The LIN break/sync delimiter length is 3-bit time. + * | | |11 = The LIN break/sync delimiter length is 4-bit time. + * | | |Note: This bit used for LIN master to sending header field. + * |[23:22] |HSEL |LIN Header Select + * | | |00 = The LIN header includes 'break field'. + * | | |01 = The LIN header includes 'break field' and 'sync field'. + * | | |10 = The LIN header includes 'break field', 'sync field' and 'frame ID field'. + * | | |11 = Reserved. + * | | |Note: This bit is used to master mode for LIN to send header field (SENDH (UART_LINCTL [8]) = 1) or used to slave to indicates exit from mute mode condition (MUTE (UART_LINCTL[4] = 1). + * |[31:24] |PID |LIN PID Bits + * | | |This field contains the LIN frame ID value when in LIN function mode, the frame ID parity can be generated by software or hardware depends on IDPEN (UART_LINCTL[9]) = 1. + * | | |If the parity generated by hardware, user fill ID0~ID5 (PID [29:24] ), hardware will calculate P0 (PID[30]) and P1 (PID[31]), otherwise user must filled frame ID and parity in this field. + * | | |Note1: User can fill any 8-bit value to this field and the bit 24 indicates ID0 (LSB first). + * | | |Note2: This field can be used for LIN master mode or slave mode. + * @var UART_T::LINSTS + * Offset: 0x38 UART LIN Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SLVHDETF |LIN Slave Header Detection Flag + * | | |This bit is set by hardware when a LIN header is detected in LIN slave mode and be cleared by writing 1 to it. + * | | |0 = LIN header not detected. + * | | |1 = LIN header detected (break + sync + frame ID). + * | | |Note1: This bit can be cleared by writing 1 to it. + * | | |Note2: This bit is only valid when in LIN slave mode (SLVEN (UART_LINCTL [0]) = 1) and enable LIN slave header detection function (SLVHDEN (UART_LINCTL [1])). + * | | |Note3: When enable ID parity check IDPEN (UART_LINCTL [9]), if hardware detect complete header ('break + sync + frame ID'), the SLVHDETF will be set whether the frame ID correct or not. + * |[1] |SLVHEF |LIN Slave Header Error Flag + * | | |This bit is set by hardware when a LIN header error is detected in LIN slave mode and be cleared by writing 1 to it + * | | |The header errors include 'break delimiter is too short (less than 0.5 bit time)', 'frame error in sync field or Identifier field', + * | | |'sync field data is not 0x55 in Non-Automatic Resynchronization mode', 'sync field deviation error with Automatic Resynchronization mode', + * | | |'sync field measure time-out with Automatic Resynchronization mode' and 'LIN header reception time-out'. + * | | |0 = LIN header error not detected. + * | | |1 = LIN header error detected. + * | | |Note1: This bit can be cleared by writing 1 to it. + * | | |Note2: This bit is only valid when UART is operated in LIN slave mode (SLVEN (UART_LINCTL [0]) = 1) and + * | | |enables LIN slave header detection function (SLVHDEN (UART_LINCTL [1])). + * |[2] |SLVIDPEF |LIN Slave ID Parity Error Flag + * | | |This bit is set by hardware when receipted frame ID parity is not correct. + * | | |0 = No active. + * | | |1 = Receipted frame ID parity is not correct. + * | | |Note1: This bit can be cleared by writing 1 to it. + * | | |Note2: This bit is only valid when in LIN slave mode (SLVEN (UART_LINCTL [0])= 1) and enable LIN frame ID parity check function IDPEN (UART_LINCTL [9]). + * |[3] |SLVSYNCF |LIN Slave Sync Field + * | | |This bit indicates that the LIN sync field is being analyzed in Automatic Resynchronization mode + * | | |When the receiver header have some error been detect, user must reset the internal circuit to re-search new frame header by writing 1 to this bit. + * | | |0 = The current character is not at LIN sync state. + * | | |1 = The current character is at LIN sync state. + * | | |Note1: This bit is only valid when in LIN Slave mode (SLVEN(UART_LINCTL[0]) = 1). + * | | |Note2: This bit can be cleared by writing 1 to it. + * | | |Note3: When writing 1 to it, hardware will reload the initial baud rate and re-search a new frame header. + * |[8] |BRKDETF |LIN Break Detection Flag + * | | |This bit is set by hardware when a break is detected and be cleared by writing 1 to it through software. + * | | |0 = LIN break not detected. + * | | |1 = LIN break detected. + * | | |Note1: This bit can be cleared by writing 1 to it. + * | | |Note2: This bit is only valid when LIN break detection function is enabled (BRKDETEN (UART_LINCTL[10]) =1). + * |[9] |BITEF |Bit Error Detect Status Flag + * | | |At TX transfer state, hardware will monitor the bus state, if the input pin (UART_RXD) state not equals to the output pin (UART_TXD) state, BITEF (UART_LINSTS[9]) will be set. + * | | |When occur bit error, if the LINIEN (UART_INTEN[8]) = 1, an interrupt will be generated. + * | | |0 = Bit error not detected. + * | | |1 = Bit error detected. + * | | |Note1: This bit can be cleared by writing 1 to it. + * | | |Note2: This bit is only valid when enable bit error detection function (BITERREN (UART_LINCTL [12]) = 1). + * @var UART_T::BRCOMP + * Offset: 0x3C UART Baud Rate Compensation Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[8:0] |BRCOMP |Baud Rate Compensation Patten + * | | |These 9-bits are used to define the relative bit is compensated or not. + * | | |BRCOMP[7:0] is used to define the compensation of UART_DAT[7:0] and BRCOM[8] is used to define the parity bit. + * |[31] |BRCOMPDEC |Baud Rate Compensation Decrease + * | | |0 = Positive (increase one module clock) compensation for each compensated bit. + * | | |1 = Negative (decrease one module clock) compensation for each compensated bit. + * @var UART_T::WKCTL + * Offset: 0x40 UART Wake-up Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |WKCTSEN |nCTS Wake-up Enable Bit + * | | |0 = nCTS Wake-up system function Disabled. + * | | |1 = nCTS Wake-up system function Enabled, when the system is in Power-down mode, an external. + * | | |nCTS change will wake-up system from Power-down mode. + * |[1] |WKDATEN |Incoming Data Wake-up Enable Bit + * | | |0 = Incoming data wake-up system function Disabled. + * | | |1 = Incoming data wake-up system function Enabled, when the system is in Power-down mode,. + * | | |incoming data will wake-up system from Power-down mode. + * |[2] |WKRFRTEN |Received Data FIFO Reached Threshold Wake-up Enable Bit + * | | |0 = Received Data FIFO reached threshold wake-up system function Disabled. + * | | |1 = Received Data FIFO reached threshold wake-up system function Enabled, when the system is. + * | | |in Power-down mode, Received Data FIFO reached threshold will wake-up system from + * | | |Power-down mode. + * |[3] |WKRS485EN |RS-485 Address Match (AAD Mode) Wake-up Enable Bit + * | | |0 = RS-485 Address Match (AAD mode) wake-up system function Disabled. + * | | |1 = RS-485 Address Match (AAD mode) wake-up system function Enabled, when the system is in. + * | | |Power-down mode, RS-485 Address Match will wake-up system from Power-down mode. + * | | |Note: This bit is used for RS-485 Auto Address Detection (AAD) mode in RS-485 function mode + * | | |and ADDRDEN (UART_ALTCTL[15]) is set to 1. + * |[4] |WKTOUTEN |Received Data FIFO Reached Threshold Time-out Wake-up Enable Bit + * | | |0 = Received Data FIFO reached threshold time-out wake-up system function Disabled. + * | | |1 = Received Data FIFO reached threshold time-out wake-up system function Enabled, when the. + * | | |system is in Power-down mode, Received Data FIFO reached threshold time-out will wake-up + * | | |system from Power-down mode. + * | | |Note: It is suggest the function is enabled when the WKRFRTEN (UART_WKCTL[2]) is set to 1. + * @var UART_T::WKSTS + * Offset: 0x44 UART Wake-up Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CTSWKF |nCTS Wake-up Flag + * | | |This bit is set if chip wake-up from power-down state by nCTS wake-up. + * | | |0 = Chip stays in power-down state. + * | | |1 = Chip wake-up from power-down state by nCTS wake-up. + * | | |Note1: If WKCTSEN (UART_WKCTL[0]) is enabled, the nCTS wake-up cause this bit is set to '1'. + * | | |Note2: This bit can be cleared by writing '1' to it. + * |[1] |DATWKF |Incoming Data Wake-up Flag + * | | |This bit is set if chip wake-up from power-down state by data wake-up. + * | | |0 = Chip stays in power-down state. + * | | |1 = Chip wake-up from power-down state by Incoming Data wake-up. + * | | |Note1: If WKDATEN (UART_WKCTL[1]) is enabled, the Incoming Data wake-up cause this bit is set to '1'. + * | | |Note2: This bit can be cleared by writing '1' to it. + * |[2] |RFRTWKF |Received Data FIFO Reached Threshold Wake-up Flag + * | | |This bit is set if chip wake-up from power-down state by Received Data FIFO reached threshold + * | | |wake-up . + * | | |0 = Chip stays in power-down state. + * | | |1 = Chip wake-up from power-down state by Received Data FIFO Reached Threshold wake-up. + * | | |Note1: If WKRFRTEN (UART_WKCTL[2]) is enabled, the Received Data FIFO Reached Threshold wake-up cause this bit is set to '1'. + * | | |Note2: This bit can be cleared by writing '1' to it. + * |[3] |RS485WKF |RS-485 Address Match (AAD Mode) Wake-up Flag + * | | |This bit is set if chip wake-up from power-down state by RS-485 Address Match (AAD mode). + * | | |0 = Chip stays in power-down state. + * | | |1 = Chip wake-up from power-down state by RS-485 Address Match (AAD mode) wake-up. + * | | |Note1: If WKRS485EN (UART_WKCTL[3]) is enabled, the RS-485 Address Match (AAD mode) wake-up cause this bit is set to '1'. + * | | |Note2: This bit can be cleared by writing '1' to it. + * |[4] |TOUTWKF |Received Data FIFO Threshold Time-out Wake-up Flag + * | | |This bit is set if chip wake-up from power-down state by Received Data FIFO Threshold Time-out + * | | |wake-up. + * | | |0 = Chip stays in power-down state. + * | | |1 = Chip wake-up from power-down state by Received Data FIFO reached threshold time-out. + * | | |wake-up. + * | | |Note1: If WKTOUTEN (UART_WKCTL[4]) is enabled, the Received Data FIFO reached threshold time-out wake-up cause this bit is set to '1'. + * | | |Note2: This bit can be cleared by writing '1' to it. + * @var UART_T::DWKCOMP + * Offset: 0x48 UART Incoming Data Wake-up Compensation Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |STCOMP |Start Bit Compensation Value + * | | |These bits field indicate how many clock cycle selected by UART_CLK do the UART controller can get the 1st bit (start bit) when the device is wake-up from power-down mode. + * | | |Note: It is valid only when WKDATEN (UART_WKCTL[1]) is set. + */ + __IO uint32_t DAT; /*!< [0x0000] UART Receive/Transmit Buffer Register */ + __IO uint32_t INTEN; /*!< [0x0004] UART Interrupt Enable Register */ + __IO uint32_t FIFO; /*!< [0x0008] UART FIFO Control Register */ + __IO uint32_t LINE; /*!< [0x000c] UART Line Control Register */ + __IO uint32_t MODEM; /*!< [0x0010] UART Modem Control Register */ + __IO uint32_t MODEMSTS; /*!< [0x0014] UART Modem Status Register */ + __IO uint32_t FIFOSTS; /*!< [0x0018] UART FIFO Status Register */ + __IO uint32_t INTSTS; /*!< [0x001c] UART Interrupt Status Register */ + __IO uint32_t TOUT; /*!< [0x0020] UART Time-out Register */ + __IO uint32_t BAUD; /*!< [0x0024] UART Baud Rate Divider Register */ + __IO uint32_t IRDA; /*!< [0x0028] UART IrDA Control Register */ + __IO uint32_t ALTCTL; /*!< [0x002c] UART Alternate Control/Status Register */ + __IO uint32_t FUNCSEL; /*!< [0x0030] UART Function Select Register */ + __IO uint32_t LINCTL; /*!< [0x0034] UART LIN Control Register */ + __IO uint32_t LINSTS; /*!< [0x0038] UART LIN Status Register */ + __IO uint32_t BRCOMP; /*!< [0x003c] UART Baud Rate Compensation Register */ + __IO uint32_t WKCTL; /*!< [0x0040] UART Wake-up Control Register */ + __IO uint32_t WKSTS; /*!< [0x0044] UART Wake-up Status Register */ + __IO uint32_t DWKCOMP; /*!< [0x0048] UART Incoming Data Wake-up Compensation Register */ + +} UART_T; + +/** + @addtogroup UART_CONST UART Bit Field Definition + Constant Definitions for UART Controller +@{ */ + +#define UART_DAT_DAT_Pos (0) /*!< UART_T::DAT: DAT Position */ +#define UART_DAT_DAT_Msk (0xfful << UART_DAT_DAT_Pos) /*!< UART_T::DAT: DAT Mask */ + +#define UART_DAT_PARITY_Pos (8) /*!< UART_T::DAT: PARITY Position */ +#define UART_DAT_PARITY_Msk (0x1ul << UART_DAT_PARITY_Pos) /*!< UART_T::DAT: PARITY Mask */ + +#define UART_INTEN_RDAIEN_Pos (0) /*!< UART_T::INTEN: RDAIEN Position */ +#define UART_INTEN_RDAIEN_Msk (0x1ul << UART_INTEN_RDAIEN_Pos) /*!< UART_T::INTEN: RDAIEN Mask */ + +#define UART_INTEN_THREIEN_Pos (1) /*!< UART_T::INTEN: THREIEN Position */ +#define UART_INTEN_THREIEN_Msk (0x1ul << UART_INTEN_THREIEN_Pos) /*!< UART_T::INTEN: THREIEN Mask */ + +#define UART_INTEN_RLSIEN_Pos (2) /*!< UART_T::INTEN: RLSIEN Position */ +#define UART_INTEN_RLSIEN_Msk (0x1ul << UART_INTEN_RLSIEN_Pos) /*!< UART_T::INTEN: RLSIEN Mask */ + +#define UART_INTEN_MODEMIEN_Pos (3) /*!< UART_T::INTEN: MODEMIEN Position */ +#define UART_INTEN_MODEMIEN_Msk (0x1ul << UART_INTEN_MODEMIEN_Pos) /*!< UART_T::INTEN: MODEMIEN Mask */ + +#define UART_INTEN_RXTOIEN_Pos (4) /*!< UART_T::INTEN: RXTOIEN Position */ +#define UART_INTEN_RXTOIEN_Msk (0x1ul << UART_INTEN_RXTOIEN_Pos) /*!< UART_T::INTEN: RXTOIEN Mask */ + +#define UART_INTEN_BUFERRIEN_Pos (5) /*!< UART_T::INTEN: BUFERRIEN Position */ +#define UART_INTEN_BUFERRIEN_Msk (0x1ul << UART_INTEN_BUFERRIEN_Pos) /*!< UART_T::INTEN: BUFERRIEN Mask */ + +#define UART_INTEN_WKIEN_Pos (6) /*!< UART_T::INTEN: WKIEN Position */ +#define UART_INTEN_WKIEN_Msk (0x1ul << UART_INTEN_WKIEN_Pos) /*!< UART_T::INTEN: WKIEN Mask */ + +#define UART_INTEN_LINIEN_Pos (8) /*!< UART_T::INTEN: LINIEN Position */ +#define UART_INTEN_LINIEN_Msk (0x1ul << UART_INTEN_LINIEN_Pos) /*!< UART_T::INTEN: LINIEN Mask */ + +#define UART_INTEN_TOCNTEN_Pos (11) /*!< UART_T::INTEN: TOCNTEN Position */ +#define UART_INTEN_TOCNTEN_Msk (0x1ul << UART_INTEN_TOCNTEN_Pos) /*!< UART_T::INTEN: TOCNTEN Mask */ + +#define UART_INTEN_ATORTSEN_Pos (12) /*!< UART_T::INTEN: ATORTSEN Position */ +#define UART_INTEN_ATORTSEN_Msk (0x1ul << UART_INTEN_ATORTSEN_Pos) /*!< UART_T::INTEN: ATORTSEN Mask */ + +#define UART_INTEN_ATOCTSEN_Pos (13) /*!< UART_T::INTEN: ATOCTSEN Position */ +#define UART_INTEN_ATOCTSEN_Msk (0x1ul << UART_INTEN_ATOCTSEN_Pos) /*!< UART_T::INTEN: ATOCTSEN Mask */ + +#define UART_INTEN_TXPDMAEN_Pos (14) /*!< UART_T::INTEN: TXPDMAEN Position */ +#define UART_INTEN_TXPDMAEN_Msk (0x1ul << UART_INTEN_TXPDMAEN_Pos) /*!< UART_T::INTEN: TXPDMAEN Mask */ + +#define UART_INTEN_RXPDMAEN_Pos (15) /*!< UART_T::INTEN: RXPDMAEN Position */ +#define UART_INTEN_RXPDMAEN_Msk (0x1ul << UART_INTEN_RXPDMAEN_Pos) /*!< UART_T::INTEN: RXPDMAEN Mask */ + +#define UART_INTEN_ABRIEN_Pos (18) /*!< UART_T::INTEN: ABRIEN Position */ +#define UART_INTEN_ABRIEN_Msk (0x1ul << UART_INTEN_ABRIEN_Pos) /*!< UART_T::INTEN: ABRIEN Mask */ + +#define UART_INTEN_TXENDIEN_Pos (22) /*!< UART_T::INTEN: TXENDIEN Position */ +#define UART_INTEN_TXENDIEN_Msk (0x1ul << UART_INTEN_TXENDIEN_Pos) /*!< UART_T::INTEN: TXENDIEN Mask */ + +#define UART_FIFO_RXRST_Pos (1) /*!< UART_T::FIFO: RXRST Position */ +#define UART_FIFO_RXRST_Msk (0x1ul << UART_FIFO_RXRST_Pos) /*!< UART_T::FIFO: RXRST Mask */ + +#define UART_FIFO_TXRST_Pos (2) /*!< UART_T::FIFO: TXRST Position */ +#define UART_FIFO_TXRST_Msk (0x1ul << UART_FIFO_TXRST_Pos) /*!< UART_T::FIFO: TXRST Mask */ + +#define UART_FIFO_RFITL_Pos (4) /*!< UART_T::FIFO: RFITL Position */ +#define UART_FIFO_RFITL_Msk (0xful << UART_FIFO_RFITL_Pos) /*!< UART_T::FIFO: RFITL Mask */ + +#define UART_FIFO_RXOFF_Pos (8) /*!< UART_T::FIFO: RXOFF Position */ +#define UART_FIFO_RXOFF_Msk (0x1ul << UART_FIFO_RXOFF_Pos) /*!< UART_T::FIFO: RXOFF Mask */ + +#define UART_FIFO_RTSTRGLV_Pos (16) /*!< UART_T::FIFO: RTSTRGLV Position */ +#define UART_FIFO_RTSTRGLV_Msk (0xful << UART_FIFO_RTSTRGLV_Pos) /*!< UART_T::FIFO: RTSTRGLV Mask */ + +#define UART_LINE_WLS_Pos (0) /*!< UART_T::LINE: WLS Position */ +#define UART_LINE_WLS_Msk (0x3ul << UART_LINE_WLS_Pos) /*!< UART_T::LINE: WLS Mask */ + +#define UART_LINE_NSB_Pos (2) /*!< UART_T::LINE: NSB Position */ +#define UART_LINE_NSB_Msk (0x1ul << UART_LINE_NSB_Pos) /*!< UART_T::LINE: NSB Mask */ + +#define UART_LINE_PBE_Pos (3) /*!< UART_T::LINE: PBE Position */ +#define UART_LINE_PBE_Msk (0x1ul << UART_LINE_PBE_Pos) /*!< UART_T::LINE: PBE Mask */ + +#define UART_LINE_EPE_Pos (4) /*!< UART_T::LINE: EPE Position */ +#define UART_LINE_EPE_Msk (0x1ul << UART_LINE_EPE_Pos) /*!< UART_T::LINE: EPE Mask */ + +#define UART_LINE_SPE_Pos (5) /*!< UART_T::LINE: SPE Position */ +#define UART_LINE_SPE_Msk (0x1ul << UART_LINE_SPE_Pos) /*!< UART_T::LINE: SPE Mask */ + +#define UART_LINE_BCB_Pos (6) /*!< UART_T::LINE: BCB Position */ +#define UART_LINE_BCB_Msk (0x1ul << UART_LINE_BCB_Pos) /*!< UART_T::LINE: BCB Mask */ + +#define UART_LINE_PSS_Pos (7) /*!< UART_T::LINE: PSS Position */ +#define UART_LINE_PSS_Msk (0x1ul << UART_LINE_PSS_Pos) /*!< UART_T::LINE: PSS Mask */ + +#define UART_LINE_TXDINV_Pos (8) /*!< UART_T::LINE: TXDINV Position */ +#define UART_LINE_TXDINV_Msk (0x1ul << UART_LINE_TXDINV_Pos) /*!< UART_T::LINE: TXDINV Mask */ + +#define UART_LINE_RXDINV_Pos (9) /*!< UART_T::LINE: RXDINV Position */ +#define UART_LINE_RXDINV_Msk (0x1ul << UART_LINE_RXDINV_Pos) /*!< UART_T::LINE: RXDINV Mask */ + +#define UART_MODEM_RTS_Pos (1) /*!< UART_T::MODEM: RTS Position */ +#define UART_MODEM_RTS_Msk (0x1ul << UART_MODEM_RTS_Pos) /*!< UART_T::MODEM: RTS Mask */ + +#define UART_MODEM_RTSACTLV_Pos (9) /*!< UART_T::MODEM: RTSACTLV Position */ +#define UART_MODEM_RTSACTLV_Msk (0x1ul << UART_MODEM_RTSACTLV_Pos) /*!< UART_T::MODEM: RTSACTLV Mask */ + +#define UART_MODEM_RTSSTS_Pos (13) /*!< UART_T::MODEM: RTSSTS Position */ +#define UART_MODEM_RTSSTS_Msk (0x1ul << UART_MODEM_RTSSTS_Pos) /*!< UART_T::MODEM: RTSSTS Mask */ + +#define UART_MODEMSTS_CTSDETF_Pos (0) /*!< UART_T::MODEMSTS: CTSDETF Position */ +#define UART_MODEMSTS_CTSDETF_Msk (0x1ul << UART_MODEMSTS_CTSDETF_Pos) /*!< UART_T::MODEMSTS: CTSDETF Mask */ + +#define UART_MODEMSTS_CTSSTS_Pos (4) /*!< UART_T::MODEMSTS: CTSSTS Position */ +#define UART_MODEMSTS_CTSSTS_Msk (0x1ul << UART_MODEMSTS_CTSSTS_Pos) /*!< UART_T::MODEMSTS: CTSSTS Mask */ + +#define UART_MODEMSTS_CTSACTLV_Pos (8) /*!< UART_T::MODEMSTS: CTSACTLV Position */ +#define UART_MODEMSTS_CTSACTLV_Msk (0x1ul << UART_MODEMSTS_CTSACTLV_Pos) /*!< UART_T::MODEMSTS: CTSACTLV Mask */ + +#define UART_FIFOSTS_RXOVIF_Pos (0) /*!< UART_T::FIFOSTS: RXOVIF Position */ +#define UART_FIFOSTS_RXOVIF_Msk (0x1ul << UART_FIFOSTS_RXOVIF_Pos) /*!< UART_T::FIFOSTS: RXOVIF Mask */ + +#define UART_FIFOSTS_ABRDIF_Pos (1) /*!< UART_T::FIFOSTS: ABRDIF Position */ +#define UART_FIFOSTS_ABRDIF_Msk (0x1ul << UART_FIFOSTS_ABRDIF_Pos) /*!< UART_T::FIFOSTS: ABRDIF Mask */ + +#define UART_FIFOSTS_ABRDTOIF_Pos (2) /*!< UART_T::FIFOSTS: ABRDTOIF Position */ +#define UART_FIFOSTS_ABRDTOIF_Msk (0x1ul << UART_FIFOSTS_ABRDTOIF_Pos) /*!< UART_T::FIFOSTS: ABRDTOIF Mask */ + +#define UART_FIFOSTS_ADDRDETF_Pos (3) /*!< UART_T::FIFOSTS: ADDRDETF Position */ +#define UART_FIFOSTS_ADDRDETF_Msk (0x1ul << UART_FIFOSTS_ADDRDETF_Pos) /*!< UART_T::FIFOSTS: ADDRDETF Mask */ + +#define UART_FIFOSTS_PEF_Pos (4) /*!< UART_T::FIFOSTS: PEF Position */ +#define UART_FIFOSTS_PEF_Msk (0x1ul << UART_FIFOSTS_PEF_Pos) /*!< UART_T::FIFOSTS: PEF Mask */ + +#define UART_FIFOSTS_FEF_Pos (5) /*!< UART_T::FIFOSTS: FEF Position */ +#define UART_FIFOSTS_FEF_Msk (0x1ul << UART_FIFOSTS_FEF_Pos) /*!< UART_T::FIFOSTS: FEF Mask */ + +#define UART_FIFOSTS_BIF_Pos (6) /*!< UART_T::FIFOSTS: BIF Position */ +#define UART_FIFOSTS_BIF_Msk (0x1ul << UART_FIFOSTS_BIF_Pos) /*!< UART_T::FIFOSTS: BIF Mask */ + +#define UART_FIFOSTS_RXPTR_Pos (8) /*!< UART_T::FIFOSTS: RXPTR Position */ +#define UART_FIFOSTS_RXPTR_Msk (0x3ful << UART_FIFOSTS_RXPTR_Pos) /*!< UART_T::FIFOSTS: RXPTR Mask */ + +#define UART_FIFOSTS_RXEMPTY_Pos (14) /*!< UART_T::FIFOSTS: RXEMPTY Position */ +#define UART_FIFOSTS_RXEMPTY_Msk (0x1ul << UART_FIFOSTS_RXEMPTY_Pos) /*!< UART_T::FIFOSTS: RXEMPTY Mask */ + +#define UART_FIFOSTS_RXFULL_Pos (15) /*!< UART_T::FIFOSTS: RXFULL Position */ +#define UART_FIFOSTS_RXFULL_Msk (0x1ul << UART_FIFOSTS_RXFULL_Pos) /*!< UART_T::FIFOSTS: RXFULL Mask */ + +#define UART_FIFOSTS_TXPTR_Pos (16) /*!< UART_T::FIFOSTS: TXPTR Position */ +#define UART_FIFOSTS_TXPTR_Msk (0x3ful << UART_FIFOSTS_TXPTR_Pos) /*!< UART_T::FIFOSTS: TXPTR Mask */ + +#define UART_FIFOSTS_TXEMPTY_Pos (22) /*!< UART_T::FIFOSTS: TXEMPTY Position */ +#define UART_FIFOSTS_TXEMPTY_Msk (0x1ul << UART_FIFOSTS_TXEMPTY_Pos) /*!< UART_T::FIFOSTS: TXEMPTY Mask */ + +#define UART_FIFOSTS_TXFULL_Pos (23) /*!< UART_T::FIFOSTS: TXFULL Position */ +#define UART_FIFOSTS_TXFULL_Msk (0x1ul << UART_FIFOSTS_TXFULL_Pos) /*!< UART_T::FIFOSTS: TXFULL Mask */ + +#define UART_FIFOSTS_TXOVIF_Pos (24) /*!< UART_T::FIFOSTS: TXOVIF Position */ +#define UART_FIFOSTS_TXOVIF_Msk (0x1ul << UART_FIFOSTS_TXOVIF_Pos) /*!< UART_T::FIFOSTS: TXOVIF Mask */ + +#define UART_FIFOSTS_TXEMPTYF_Pos (28) /*!< UART_T::FIFOSTS: TXEMPTYF Position */ +#define UART_FIFOSTS_TXEMPTYF_Msk (0x1ul << UART_FIFOSTS_TXEMPTYF_Pos) /*!< UART_T::FIFOSTS: TXEMPTYF Mask */ + +#define UART_FIFOSTS_RXIDLE_Pos (29) /*!< UART_T::FIFOSTS: RXIDLE Position */ +#define UART_FIFOSTS_RXIDLE_Msk (0x1ul << UART_FIFOSTS_RXIDLE_Pos) /*!< UART_T::FIFOSTS: RXIDLE Mask */ + +#define UART_FIFOSTS_TXRXACT_Pos (31) /*!< UART_T::FIFOSTS: TXRXACT Position */ +#define UART_FIFOSTS_TXRXACT_Msk (0x1ul << UART_FIFOSTS_TXRXACT_Pos) /*!< UART_T::FIFOSTS: TXRXACT Mask */ + +#define UART_INTSTS_RDAIF_Pos (0) /*!< UART_T::INTSTS: RDAIF Position */ +#define UART_INTSTS_RDAIF_Msk (0x1ul << UART_INTSTS_RDAIF_Pos) /*!< UART_T::INTSTS: RDAIF Mask */ + +#define UART_INTSTS_THREIF_Pos (1) /*!< UART_T::INTSTS: THREIF Position */ +#define UART_INTSTS_THREIF_Msk (0x1ul << UART_INTSTS_THREIF_Pos) /*!< UART_T::INTSTS: THREIF Mask */ + +#define UART_INTSTS_RLSIF_Pos (2) /*!< UART_T::INTSTS: RLSIF Position */ +#define UART_INTSTS_RLSIF_Msk (0x1ul << UART_INTSTS_RLSIF_Pos) /*!< UART_T::INTSTS: RLSIF Mask */ + +#define UART_INTSTS_MODEMIF_Pos (3) /*!< UART_T::INTSTS: MODEMIF Position */ +#define UART_INTSTS_MODEMIF_Msk (0x1ul << UART_INTSTS_MODEMIF_Pos) /*!< UART_T::INTSTS: MODEMIF Mask */ + +#define UART_INTSTS_RXTOIF_Pos (4) /*!< UART_T::INTSTS: RXTOIF Position */ +#define UART_INTSTS_RXTOIF_Msk (0x1ul << UART_INTSTS_RXTOIF_Pos) /*!< UART_T::INTSTS: RXTOIF Mask */ + +#define UART_INTSTS_BUFERRIF_Pos (5) /*!< UART_T::INTSTS: BUFERRIF Position */ +#define UART_INTSTS_BUFERRIF_Msk (0x1ul << UART_INTSTS_BUFERRIF_Pos) /*!< UART_T::INTSTS: BUFERRIF Mask */ + +#define UART_INTSTS_WKIF_Pos (6) /*!< UART_T::INTSTS: WKIF Position */ +#define UART_INTSTS_WKIF_Msk (0x1ul << UART_INTSTS_WKIF_Pos) /*!< UART_T::INTSTS: WKIF Mask */ + +#define UART_INTSTS_LINIF_Pos (7) /*!< UART_T::INTSTS: LINIF Position */ +#define UART_INTSTS_LINIF_Msk (0x1ul << UART_INTSTS_LINIF_Pos) /*!< UART_T::INTSTS: LINIF Mask */ + +#define UART_INTSTS_RDAINT_Pos (8) /*!< UART_T::INTSTS: RDAINT Position */ +#define UART_INTSTS_RDAINT_Msk (0x1ul << UART_INTSTS_RDAINT_Pos) /*!< UART_T::INTSTS: RDAINT Mask */ + +#define UART_INTSTS_THREINT_Pos (9) /*!< UART_T::INTSTS: THREINT Position */ +#define UART_INTSTS_THREINT_Msk (0x1ul << UART_INTSTS_THREINT_Pos) /*!< UART_T::INTSTS: THREINT Mask */ + +#define UART_INTSTS_RLSINT_Pos (10) /*!< UART_T::INTSTS: RLSINT Position */ +#define UART_INTSTS_RLSINT_Msk (0x1ul << UART_INTSTS_RLSINT_Pos) /*!< UART_T::INTSTS: RLSINT Mask */ + +#define UART_INTSTS_MODEMINT_Pos (11) /*!< UART_T::INTSTS: MODEMINT Position */ +#define UART_INTSTS_MODEMINT_Msk (0x1ul << UART_INTSTS_MODEMINT_Pos) /*!< UART_T::INTSTS: MODEMINT Mask */ + +#define UART_INTSTS_RXTOINT_Pos (12) /*!< UART_T::INTSTS: RXTOINT Position */ +#define UART_INTSTS_RXTOINT_Msk (0x1ul << UART_INTSTS_RXTOINT_Pos) /*!< UART_T::INTSTS: RXTOINT Mask */ + +#define UART_INTSTS_BUFERRINT_Pos (13) /*!< UART_T::INTSTS: BUFERRINT Position */ +#define UART_INTSTS_BUFERRINT_Msk (0x1ul << UART_INTSTS_BUFERRINT_Pos) /*!< UART_T::INTSTS: BUFERRINT Mask */ + +#define UART_INTSTS_WKINT_Pos (14) /*!< UART_T::INTSTS: WKINT Position */ +#define UART_INTSTS_WKINT_Msk (0x1ul << UART_INTSTS_WKINT_Pos) /*!< UART_T::INTSTS: WKINT Mask */ + +#define UART_INTSTS_LININT_Pos (15) /*!< UART_T::INTSTS: LININT Position */ +#define UART_INTSTS_LININT_Msk (0x1ul << UART_INTSTS_LININT_Pos) /*!< UART_T::INTSTS: LININT Mask */ + +#define UART_INTSTS_HWRLSIF_Pos (18) /*!< UART_T::INTSTS: HWRLSIF Position */ +#define UART_INTSTS_HWRLSIF_Msk (0x1ul << UART_INTSTS_HWRLSIF_Pos) /*!< UART_T::INTSTS: HWRLSIF Mask */ + +#define UART_INTSTS_HWMODIF_Pos (19) /*!< UART_T::INTSTS: HWMODIF Position */ +#define UART_INTSTS_HWMODIF_Msk (0x1ul << UART_INTSTS_HWMODIF_Pos) /*!< UART_T::INTSTS: HWMODIF Mask */ + +#define UART_INTSTS_HWTOIF_Pos (20) /*!< UART_T::INTSTS: HWTOIF Position */ +#define UART_INTSTS_HWTOIF_Msk (0x1ul << UART_INTSTS_HWTOIF_Pos) /*!< UART_T::INTSTS: HWTOIF Mask */ + +#define UART_INTSTS_HWBUFEIF_Pos (21) /*!< UART_T::INTSTS: HWBUFEIF Position */ +#define UART_INTSTS_HWBUFEIF_Msk (0x1ul << UART_INTSTS_HWBUFEIF_Pos) /*!< UART_T::INTSTS: HWBUFEIF Mask */ + +#define UART_INTSTS_TXENDIF_Pos (22) /*!< UART_T::INTSTS: TXENDIF Position */ +#define UART_INTSTS_TXENDIF_Msk (0x1ul << UART_INTSTS_TXENDIF_Pos) /*!< UART_T::INTSTS: TXENDIF Mask */ + +#define UART_INTSTS_HWRLSINT_Pos (26) /*!< UART_T::INTSTS: HWRLSINT Position */ +#define UART_INTSTS_HWRLSINT_Msk (0x1ul << UART_INTSTS_HWRLSINT_Pos) /*!< UART_T::INTSTS: HWRLSINT Mask */ + +#define UART_INTSTS_HWMODINT_Pos (27) /*!< UART_T::INTSTS: HWMODINT Position */ +#define UART_INTSTS_HWMODINT_Msk (0x1ul << UART_INTSTS_HWMODINT_Pos) /*!< UART_T::INTSTS: HWMODINT Mask */ + +#define UART_INTSTS_HWTOINT_Pos (28) /*!< UART_T::INTSTS: HWTOINT Position */ +#define UART_INTSTS_HWTOINT_Msk (0x1ul << UART_INTSTS_HWTOINT_Pos) /*!< UART_T::INTSTS: HWTOINT Mask */ + +#define UART_INTSTS_HWBUFEINT_Pos (29) /*!< UART_T::INTSTS: HWBUFEINT Position */ +#define UART_INTSTS_HWBUFEINT_Msk (0x1ul << UART_INTSTS_HWBUFEINT_Pos) /*!< UART_T::INTSTS: HWBUFEINT Mask */ + +#define UART_INTSTS_TXENDINT_Pos (30) /*!< UART_T::INTSTS: TXENDINT Position */ +#define UART_INTSTS_TXENDINT_Msk (0x1ul << UART_INTSTS_TXENDINT_Pos) /*!< UART_T::INTSTS: TXENDINT Mask */ + +#define UART_INTSTS_ABRINT_Pos (31) /*!< UART_T::INTSTS: ABRINT Position */ +#define UART_INTSTS_ABRINT_Msk (0x1ul << UART_INTSTS_ABRINT_Pos) /*!< UART_T::INTSTS: ABRINT Mask */ + +#define UART_TOUT_TOIC_Pos (0) /*!< UART_T::TOUT: TOIC Position */ +#define UART_TOUT_TOIC_Msk (0xfful << UART_TOUT_TOIC_Pos) /*!< UART_T::TOUT: TOIC Mask */ + +#define UART_TOUT_DLY_Pos (8) /*!< UART_T::TOUT: DLY Position */ +#define UART_TOUT_DLY_Msk (0xfful << UART_TOUT_DLY_Pos) /*!< UART_T::TOUT: DLY Mask */ + +#define UART_BAUD_BRD_Pos (0) /*!< UART_T::BAUD: BRD Position */ +#define UART_BAUD_BRD_Msk (0xfffful << UART_BAUD_BRD_Pos) /*!< UART_T::BAUD: BRD Mask */ + +#define UART_BAUD_EDIVM1_Pos (24) /*!< UART_T::BAUD: EDIVM1 Position */ +#define UART_BAUD_EDIVM1_Msk (0xful << UART_BAUD_EDIVM1_Pos) /*!< UART_T::BAUD: EDIVM1 Mask */ + +#define UART_BAUD_BAUDM0_Pos (28) /*!< UART_T::BAUD: BAUDM0 Position */ +#define UART_BAUD_BAUDM0_Msk (0x1ul << UART_BAUD_BAUDM0_Pos) /*!< UART_T::BAUD: BAUDM0 Mask */ + +#define UART_BAUD_BAUDM1_Pos (29) /*!< UART_T::BAUD: BAUDM1 Position */ +#define UART_BAUD_BAUDM1_Msk (0x1ul << UART_BAUD_BAUDM1_Pos) /*!< UART_T::BAUD: BAUDM1 Mask */ + +#define UART_IRDA_TXEN_Pos (1) /*!< UART_T::IRDA: TXEN Position */ +#define UART_IRDA_TXEN_Msk (0x1ul << UART_IRDA_TXEN_Pos) /*!< UART_T::IRDA: TXEN Mask */ + +#define UART_IRDA_TXINV_Pos (5) /*!< UART_T::IRDA: TXINV Position */ +#define UART_IRDA_TXINV_Msk (0x1ul << UART_IRDA_TXINV_Pos) /*!< UART_T::IRDA: TXINV Mask */ + +#define UART_IRDA_RXINV_Pos (6) /*!< UART_T::IRDA: RXINV Position */ +#define UART_IRDA_RXINV_Msk (0x1ul << UART_IRDA_RXINV_Pos) /*!< UART_T::IRDA: RXINV Mask */ + +#define UART_ALTCTL_BRKFL_Pos (0) /*!< UART_T::ALTCTL: BRKFL Position */ +#define UART_ALTCTL_BRKFL_Msk (0xful << UART_ALTCTL_BRKFL_Pos) /*!< UART_T::ALTCTL: BRKFL Mask */ + +#define UART_ALTCTL_LINRXEN_Pos (6) /*!< UART_T::ALTCTL: LINRXEN Position */ +#define UART_ALTCTL_LINRXEN_Msk (0x1ul << UART_ALTCTL_LINRXEN_Pos) /*!< UART_T::ALTCTL: LINRXEN Mask */ + +#define UART_ALTCTL_LINTXEN_Pos (7) /*!< UART_T::ALTCTL: LINTXEN Position */ +#define UART_ALTCTL_LINTXEN_Msk (0x1ul << UART_ALTCTL_LINTXEN_Pos) /*!< UART_T::ALTCTL: LINTXEN Mask */ + +#define UART_ALTCTL_RS485NMM_Pos (8) /*!< UART_T::ALTCTL: RS485NMM Position */ +#define UART_ALTCTL_RS485NMM_Msk (0x1ul << UART_ALTCTL_RS485NMM_Pos) /*!< UART_T::ALTCTL: RS485NMM Mask */ + +#define UART_ALTCTL_RS485AAD_Pos (9) /*!< UART_T::ALTCTL: RS485AAD Position */ +#define UART_ALTCTL_RS485AAD_Msk (0x1ul << UART_ALTCTL_RS485AAD_Pos) /*!< UART_T::ALTCTL: RS485AAD Mask */ + +#define UART_ALTCTL_RS485AUD_Pos (10) /*!< UART_T::ALTCTL: RS485AUD Position */ +#define UART_ALTCTL_RS485AUD_Msk (0x1ul << UART_ALTCTL_RS485AUD_Pos) /*!< UART_T::ALTCTL: RS485AUD Mask */ + +#define UART_ALTCTL_ADDRDEN_Pos (15) /*!< UART_T::ALTCTL: ADDRDEN Position */ +#define UART_ALTCTL_ADDRDEN_Msk (0x1ul << UART_ALTCTL_ADDRDEN_Pos) /*!< UART_T::ALTCTL: ADDRDEN Mask */ + +#define UART_ALTCTL_ABRIF_Pos (17) /*!< UART_T::ALTCTL: ABRIF Position */ +#define UART_ALTCTL_ABRIF_Msk (0x1ul << UART_ALTCTL_ABRIF_Pos) /*!< UART_T::ALTCTL: ABRIF Mask */ + +#define UART_ALTCTL_ABRDEN_Pos (18) /*!< UART_T::ALTCTL: ABRDEN Position */ +#define UART_ALTCTL_ABRDEN_Msk (0x1ul << UART_ALTCTL_ABRDEN_Pos) /*!< UART_T::ALTCTL: ABRDEN Mask */ + +#define UART_ALTCTL_ABRDBITS_Pos (19) /*!< UART_T::ALTCTL: ABRDBITS Position */ +#define UART_ALTCTL_ABRDBITS_Msk (0x3ul << UART_ALTCTL_ABRDBITS_Pos) /*!< UART_T::ALTCTL: ABRDBITS Mask */ + +#define UART_ALTCTL_ADDRMV_Pos (24) /*!< UART_T::ALTCTL: ADDRMV Position */ +#define UART_ALTCTL_ADDRMV_Msk (0xfful << UART_ALTCTL_ADDRMV_Pos) /*!< UART_T::ALTCTL: ADDRMV Mask */ + +#define UART_FUNCSEL_FUNCSEL_Pos (0) /*!< UART_T::FUNCSEL: FUNCSEL Position */ +#define UART_FUNCSEL_FUNCSEL_Msk (0x3ul << UART_FUNCSEL_FUNCSEL_Pos) /*!< UART_T::FUNCSEL: FUNCSEL Mask */ + +#define UART_FUNCSEL_TXRXDIS_Pos (3) /*!< UART_T::FUNCSEL: TXRXDIS Position */ +#define UART_FUNCSEL_TXRXDIS_Msk (0x1ul << UART_FUNCSEL_TXRXDIS_Pos) /*!< UART_T::FUNCSEL: TXRXDIS Mask */ + +#define UART_LINCTL_SLVEN_Pos (0) /*!< UART_T::LINCTL: SLVEN Position */ +#define UART_LINCTL_SLVEN_Msk (0x1ul << UART_LINCTL_SLVEN_Pos) /*!< UART_T::LINCTL: SLVEN Mask */ + +#define UART_LINCTL_SLVHDEN_Pos (1) /*!< UART_T::LINCTL: SLVHDEN Position */ +#define UART_LINCTL_SLVHDEN_Msk (0x1ul << UART_LINCTL_SLVHDEN_Pos) /*!< UART_T::LINCTL: SLVHDEN Mask */ + +#define UART_LINCTL_SLVAREN_Pos (2) /*!< UART_T::LINCTL: SLVAREN Position */ +#define UART_LINCTL_SLVAREN_Msk (0x1ul << UART_LINCTL_SLVAREN_Pos) /*!< UART_T::LINCTL: SLVAREN Mask */ + +#define UART_LINCTL_SLVDUEN_Pos (3) /*!< UART_T::LINCTL: SLVDUEN Position */ +#define UART_LINCTL_SLVDUEN_Msk (0x1ul << UART_LINCTL_SLVDUEN_Pos) /*!< UART_T::LINCTL: SLVDUEN Mask */ + +#define UART_LINCTL_MUTE_Pos (4) /*!< UART_T::LINCTL: MUTE Position */ +#define UART_LINCTL_MUTE_Msk (0x1ul << UART_LINCTL_MUTE_Pos) /*!< UART_T::LINCTL: MUTE Mask */ + +#define UART_LINCTL_SENDH_Pos (8) /*!< UART_T::LINCTL: SENDH Position */ +#define UART_LINCTL_SENDH_Msk (0x1ul << UART_LINCTL_SENDH_Pos) /*!< UART_T::LINCTL: SENDH Mask */ + +#define UART_LINCTL_IDPEN_Pos (9) /*!< UART_T::LINCTL: IDPEN Position */ +#define UART_LINCTL_IDPEN_Msk (0x1ul << UART_LINCTL_IDPEN_Pos) /*!< UART_T::LINCTL: IDPEN Mask */ + +#define UART_LINCTL_BRKDETEN_Pos (10) /*!< UART_T::LINCTL: BRKDETEN Position */ +#define UART_LINCTL_BRKDETEN_Msk (0x1ul << UART_LINCTL_BRKDETEN_Pos) /*!< UART_T::LINCTL: BRKDETEN Mask */ + +#define UART_LINCTL_LINRXOFF_Pos (11) /*!< UART_T::LINCTL: LINRXOFF Position */ +#define UART_LINCTL_LINRXOFF_Msk (0x1ul << UART_LINCTL_LINRXOFF_Pos) /*!< UART_T::LINCTL: LINRXOFF Mask */ + +#define UART_LINCTL_BITERREN_Pos (12) /*!< UART_T::LINCTL: BITERREN Position */ +#define UART_LINCTL_BITERREN_Msk (0x1ul << UART_LINCTL_BITERREN_Pos) /*!< UART_T::LINCTL: BITERREN Mask */ + +#define UART_LINCTL_BRKFL_Pos (16) /*!< UART_T::LINCTL: BRKFL Position */ +#define UART_LINCTL_BRKFL_Msk (0xful << UART_LINCTL_BRKFL_Pos) /*!< UART_T::LINCTL: BRKFL Mask */ + +#define UART_LINCTL_BSL_Pos (20) /*!< UART_T::LINCTL: BSL Position */ +#define UART_LINCTL_BSL_Msk (0x3ul << UART_LINCTL_BSL_Pos) /*!< UART_T::LINCTL: BSL Mask */ + +#define UART_LINCTL_HSEL_Pos (22) /*!< UART_T::LINCTL: HSEL Position */ +#define UART_LINCTL_HSEL_Msk (0x3ul << UART_LINCTL_HSEL_Pos) /*!< UART_T::LINCTL: HSEL Mask */ + +#define UART_LINCTL_PID_Pos (24) /*!< UART_T::LINCTL: PID Position */ +#define UART_LINCTL_PID_Msk (0xfful << UART_LINCTL_PID_Pos) /*!< UART_T::LINCTL: PID Mask */ + +#define UART_LINSTS_SLVHDETF_Pos (0) /*!< UART_T::LINSTS: SLVHDETF Position */ +#define UART_LINSTS_SLVHDETF_Msk (0x1ul << UART_LINSTS_SLVHDETF_Pos) /*!< UART_T::LINSTS: SLVHDETF Mask */ + +#define UART_LINSTS_SLVHEF_Pos (1) /*!< UART_T::LINSTS: SLVHEF Position */ +#define UART_LINSTS_SLVHEF_Msk (0x1ul << UART_LINSTS_SLVHEF_Pos) /*!< UART_T::LINSTS: SLVHEF Mask */ + +#define UART_LINSTS_SLVIDPEF_Pos (2) /*!< UART_T::LINSTS: SLVIDPEF Position */ +#define UART_LINSTS_SLVIDPEF_Msk (0x1ul << UART_LINSTS_SLVIDPEF_Pos) /*!< UART_T::LINSTS: SLVIDPEF Mask */ + +#define UART_LINSTS_SLVSYNCF_Pos (3) /*!< UART_T::LINSTS: SLVSYNCF Position */ +#define UART_LINSTS_SLVSYNCF_Msk (0x1ul << UART_LINSTS_SLVSYNCF_Pos) /*!< UART_T::LINSTS: SLVSYNCF Mask */ + +#define UART_LINSTS_BRKDETF_Pos (8) /*!< UART_T::LINSTS: BRKDETF Position */ +#define UART_LINSTS_BRKDETF_Msk (0x1ul << UART_LINSTS_BRKDETF_Pos) /*!< UART_T::LINSTS: BRKDETF Mask */ + +#define UART_LINSTS_BITEF_Pos (9) /*!< UART_T::LINSTS: BITEF Position */ +#define UART_LINSTS_BITEF_Msk (0x1ul << UART_LINSTS_BITEF_Pos) /*!< UART_T::LINSTS: BITEF Mask */ + +#define UART_BRCOMP_BRCOMP_Pos (0) /*!< UART_T::BRCOMP: BRCOMP Position */ +#define UART_BRCOMP_BRCOMP_Msk (0x1fful << UART_BRCOMP_BRCOMP_Pos) /*!< UART_T::BRCOMP: BRCOMP Mask */ + +#define UART_BRCOMP_BRCOMPDEC_Pos (31) /*!< UART_T::BRCOMP: BRCOMPDEC Position */ +#define UART_BRCOMP_BRCOMPDEC_Msk (0x1ul << UART_BRCOMP_BRCOMPDEC_Pos) /*!< UART_T::BRCOMP: BRCOMPDEC Mask */ + +#define UART_WKCTL_WKCTSEN_Pos (0) /*!< UART_T::WKCTL: WKCTSEN Position */ +#define UART_WKCTL_WKCTSEN_Msk (0x1ul << UART_WKCTL_WKCTSEN_Pos) /*!< UART_T::WKCTL: WKCTSEN Mask */ + +#define UART_WKCTL_WKDATEN_Pos (1) /*!< UART_T::WKCTL: WKDATEN Position */ +#define UART_WKCTL_WKDATEN_Msk (0x1ul << UART_WKCTL_WKDATEN_Pos) /*!< UART_T::WKCTL: WKDATEN Mask */ + +#define UART_WKCTL_WKRFRTEN_Pos (2) /*!< UART_T::WKCTL: WKRFRTEN Position */ +#define UART_WKCTL_WKRFRTEN_Msk (0x1ul << UART_WKCTL_WKRFRTEN_Pos) /*!< UART_T::WKCTL: WKRFRTEN Mask */ + +#define UART_WKCTL_WKRS485EN_Pos (3) /*!< UART_T::WKCTL: WKRS485EN Position */ +#define UART_WKCTL_WKRS485EN_Msk (0x1ul << UART_WKCTL_WKRS485EN_Pos) /*!< UART_T::WKCTL: WKRS485EN Mask */ + +#define UART_WKCTL_WKTOUTEN_Pos (4) /*!< UART_T::WKCTL: WKTOUTEN Position */ +#define UART_WKCTL_WKTOUTEN_Msk (0x1ul << UART_WKCTL_WKTOUTEN_Pos) /*!< UART_T::WKCTL: WKTOUTEN Mask */ + +#define UART_WKSTS_CTSWKF_Pos (0) /*!< UART_T::WKSTS: CTSWKF Position */ +#define UART_WKSTS_CTSWKF_Msk (0x1ul << UART_WKSTS_CTSWKF_Pos) /*!< UART_T::WKSTS: CTSWKF Mask */ + +#define UART_WKSTS_DATWKF_Pos (1) /*!< UART_T::WKSTS: DATWKF Position */ +#define UART_WKSTS_DATWKF_Msk (0x1ul << UART_WKSTS_DATWKF_Pos) /*!< UART_T::WKSTS: DATWKF Mask */ + +#define UART_WKSTS_RFRTWKF_Pos (2) /*!< UART_T::WKSTS: RFRTWKF Position */ +#define UART_WKSTS_RFRTWKF_Msk (0x1ul << UART_WKSTS_RFRTWKF_Pos) /*!< UART_T::WKSTS: RFRTWKF Mask */ + +#define UART_WKSTS_RS485WKF_Pos (3) /*!< UART_T::WKSTS: RS485WKF Position */ +#define UART_WKSTS_RS485WKF_Msk (0x1ul << UART_WKSTS_RS485WKF_Pos) /*!< UART_T::WKSTS: RS485WKF Mask */ + +#define UART_WKSTS_TOUTWKF_Pos (4) /*!< UART_T::WKSTS: TOUTWKF Position */ +#define UART_WKSTS_TOUTWKF_Msk (0x1ul << UART_WKSTS_TOUTWKF_Pos) /*!< UART_T::WKSTS: TOUTWKF Mask */ + +#define UART_DWKCOMP_STCOMP_Pos (0) /*!< UART_T::DWKCOMP: STCOMP Position */ +#define UART_DWKCOMP_STCOMP_Msk (0xfffful << UART_DWKCOMP_STCOMP_Pos) /*!< UART_T::DWKCOMP: STCOMP Mask */ + +/**@}*/ /* UART_CONST */ +/**@}*/ /* end of UART register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __UART_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/ui2c_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/ui2c_reg.h new file mode 100644 index 00000000000..04222bcf978 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/ui2c_reg.h @@ -0,0 +1,583 @@ +/**************************************************************************//** + * @file ui2c_reg.h + * @version V1.00 + * @brief UI2C register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __UI2C_REG_H__ +#define __UI2C_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup UI2C I2C Mode of USCI Controller(UI2C) + Memory Mapped Structure for UI2C Controller +@{ */ + +typedef struct +{ + + + /** + * @var UI2C_T::CTL + * Offset: 0x00 USCI Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2:0] |FUNMODE |Function Mode + * | | |This bit field selects the protocol for this USCI controller + * | | |Selecting a protocol that is not available or a reserved combination disables the USCI + * | | |When switching between two protocols, the USCI has to be disabled before selecting a new protocol + * | | |Simultaneously, the USCI will be reset when user write 000 to FUNMODE. + * | | |000 = The USCI is disabled. All protocol related state machines are set to idle state. + * | | |001 = The SPI protocol is selected. + * | | |010 = The UART protocol is selected. + * | | |100 = The I2C protocol is selected. + * | | |Note: Other bit combinations are reserved. + * @var UI2C_T::BRGEN + * Offset: 0x08 USCI Baud Rate Generator Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |RCLKSEL |Reference Clock Source Selection + * | | |This bit selects the source signal of reference clock (fREF_CLK). + * | | |0 = Peripheral device clock fPCLK. + * | | |1 = Reserved. + * |[1] |PTCLKSEL |Protocol Clock Source Selection + * | | |This bit selects the source signal of protocol clock (fPROT_CLK). + * | | |0 = Reference clock fREF_CLK. + * | | |1 = fREF_CLK2 (its frequency is half of fREF_CLK). + * |[3:2] |SPCLKSEL |Sample Clock Source Selection + * | | |This bit field used for the clock source selection of a sample clock (fSAMP_CLK) for the protocol processor. + * | | |00 = fSAMP_CLK = fDIV_CLK. + * | | |01 = fSAMP_CLK = fPROT_CLK. + * | | |10 = fSAMP_CLK = fSCLK. + * | | |11 = fSAMP_CLK = fREF_CLK. + * |[4] |TMCNTEN |Time Measurement Counter Enable Bit + * | | |This bit enables the 10-bit timing measurement counter. + * | | |0 = Time measurement counter is Disabled. + * | | |1 = Time measurement counter is Enabled. + * |[5] |TMCNTSRC |Time Measurement Counter Clock Source Selection + * | | |0 = Time measurement counter with fPROT_CLK. + * | | |1 = Time measurement counter with fDIV_CLK. + * |[9:8] |PDSCNT |Pre-divider for Sample Counter + * | | |This bit field defines the divide ratio of the clock division from sample clock fSAMP_CLK + * | | |The divided frequency fPDS_CNT = fSAMP_CLK / (PDSCNT+1). + * |[14:10] |DSCNT |Denominator for Sample Counter + * | | |This bit field defines the divide ratio of the sample clock fSAMP_CLK. + * | | |The divided frequency fDS_CNT = fPDS_CNT / (DSCNT+1). + * | | |Note: The maximum value of DSCNT is 0xF on UART mode and suggest to set over 4 to confirm the receiver data is sampled in right value + * |[25:16] |CLKDIV |Clock Divider + * | | |This bit field defines the ratio between the protocol clock frequency fPROT_CLK and the clock divider frequency fDIV_CLK (fDIV_CLK = fPROT_CLK / (CLKDIV+1) ). + * | | |Note: In UART function, it can be updated by hardware in the 4th falling edge of the input data 0x55 when the auto baud rate function (ABREN(USCI_PROTCTL[6])) is enabled + * | | |The revised value is the average bit time between bit 5 and bit 6 + * | | |The user can use revised CLKDIV and new BRDETITV (USCI_PROTCTL[24:16]) to calculate the precise baud rate. + * @var UI2C_T::LINECTL + * Offset: 0x2C USCI Line Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |LSB |LSB First Transmission Selection + * | | |0 = The MSB, which bit of transmit/receive data buffer depends on the setting of DWIDTH, is transmitted/received first. + * | | |1 = The LSB, the bit 0 of data buffer, will be transmitted/received first. + * |[11:8] |DWIDTH |Word Length of Transmission + * | | |This bit field defines the data word length (amount of bits) for reception and transmission + * | | |The data word is always right-aligned in the data buffer + * | | |USCI support word length from 4 to 16 bits. + * | | |0x0: The data word contains 16 bits located at bit positions [15:0]. + * | | |0x1: Reserved. + * | | |0x2: Reserved. + * | | |0x3: Reserved. + * | | |0x4: The data word contains 4 bits located at bit positions [3:0]. + * | | |0x5: The data word contains 5 bits located at bit positions [4:0]. + * | | |... + * | | |0xF: The data word contains 15 bits located at bit positions [14:0]. + * | | |Note: In UART protocol, the length can be configured as 6~13 bits + * | | |And in I2C protocol, the length fixed as 8 bits. + * @var UI2C_T::TXDAT + * Offset: 0x30 USCI Transmit Data Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |TXDAT |Transmit Data + * | | |Software can use this bit field to write 16-bit transmit data for transmission. + * @var UI2C_T::RXDAT + * Offset: 0x34 USCI Receive Data Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |RXDAT |Received Data + * | | |This bit field monitors the received data which stored in receive data buffer. + * | | |Note 1: In I2C protocol, RXDAT[12:8] indicate the different transmission conditions which defined in I2C. + * | | |Note 2: In UART protocol, RXDAT[15:13] indicate the same frame status of BREAK, FRMERR and PARITYERR (USCI_PROTSTS[7:5]). + * @var UI2C_T::DEVADDR0 + * Offset: 0x44 USCI Device Address Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[9:0] |DEVADDR |Device Address + * | | |In I2C protocol, this bit field contains the programmed slave address + * | | |If the first received address byte are 1111 0AAXB, the AA bits are compared to the bits DEVADDR[9:8] to check for address match, where the X is R/W bit + * | | |Then the second address byte is also compared to DEVADDR[7:0]. + * | | |Note 1: The DEVADDR [9:7] must be set 3'b000 when I2C operating in 7-bit address mode. + * | | |Note 2: When software set 10'h000, the address can not be used. + * @var UI2C_T::DEVADDR1 + * Offset: 0x48 USCI Device Address Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[9:0] |DEVADDR |Device Address + * | | |In I2C protocol, this bit field contains the programmed slave address + * | | |If the first received address byte are 1111 0AAXB, the AA bits are compared to the bits DEVADDR[9:8] to check for address match, where the X is R/W bit + * | | |Then the second address byte is also compared to DEVADDR[7:0]. + * | | |Note 1: The DEVADDR [9:7] must be set 3'000 when I2C operating in 7-bit address mode. + * | | |Note 2: When software set 10'h000, the address can not be used. + * @var UI2C_T::ADDRMSK0 + * Offset: 0x4C USCI Device Address Mask Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[9:0] |ADDRMSK |USCI Device Address Mask + * | | |0 = Mask Disabled (the received corresponding register bit should be exact the same as address register.). + * | | |1 = Mask Enabled (the received corresponding address bit is don't care.). + * | | |USCI support multiple address recognition with two address mask register + * | | |When the bit in the address mask register is set to one, it means the received corresponding address bit is don't-care + * | | |If the bit is set to zero, that means the received corresponding register bit should be exact the same as address register. + * | | |Note: The wake-up function can not use address mask. + * @var UI2C_T::ADDRMSK1 + * Offset: 0x50 USCI Device Address Mask Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[9:0] |ADDRMSK |USCI Device Address Mask + * | | |0 = Mask Disabled (the received corresponding register bit should be exact the same as address register.). + * | | |1 = Mask Enabled (the received corresponding address bit is don't care.). + * | | |USCI support multiple address recognition with two address mask register + * | | |When the bit in the address mask register is set to one, it means the received corresponding address bit is don't-care + * | | |If the bit is set to zero, that means the received corresponding register bit should be exact the same as address register. + * | | |Note: The wake-up function can not use address mask. + * @var UI2C_T::WKCTL + * Offset: 0x54 USCI Wake-up Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |WKEN |Wake-up Enable Bit + * | | |0 = Wake-up function Disabled. + * | | |1 = Wake-up function Enabled. + * |[1] |WKADDREN |Wake-up Address Match Enable Bit + * | | |0 = The chip is woken up according data toggle. + * | | |1 = The chip is woken up according address match. + * @var UI2C_T::WKSTS + * Offset: 0x58 USCI Wake-up Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |WKF |Wake-up Flag + * | | |When chip is woken up from Power-down mode, this bit is set to 1 + * | | |Software can write 1 to clear this bit. + * @var UI2C_T::PROTCTL + * Offset: 0x5C USCI Protocol Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |GCFUNC |General Call Function + * | | |0 = General Call Function Disabled. + * | | |1 = General Call Function Enabled. + * |[1] |AA |Assert Acknowledge Control + * | | |When AA=1 prior to address or data received, an acknowledged (low level to SDA) will be returned during the acknowledge clock pulse on the SCL line when 1.) A slave is acknowledging the address sent from master, 2.) The receiver devices are acknowledging the data sent by transmitter + * | | |When AA=0 prior to address or data received, a Not acknowledged (high level to SDA) will be returned during the acknowledge clock pulse on the SCL line. + * |[2] |STO |I2C STOP Control + * | | |In Master mode, setting STO to transmit a STOP condition to bus then I2C hardware will check the bus condition if a STOP condition is detected this bit will be cleared by hardware automatically + * | | |In a slave mode, setting STO resets I2C hardware to the defined "not addressed" slave mode when bus error (USCI_PROTSTS.ERRIF = 1). + * |[3] |STA |I2C START Control + * | | |Setting STA to logic 1 to enter Master mode, the I2C hardware sends a START or repeat START condition to bus when the bus is free. + * |[4] |ADDR10EN |Address 10-bit Function Enable Bit + * | | |0 = Address match 10 bit function is disabled. + * | | |1 = Address match 10 bit function is enabled. + * |[5] |PTRG |I2C Protocol Trigger (Write Only) + * | | |When a new state is present in the USCI_PROTSTS register, if the related interrupt enable bits are set, the I2C interrupt is requested + * | | |It must write one by software to this bit after the related interrupt flags are set to 1 and the I2C protocol function will go ahead until the STOP is active or the PROTEN is disabled. + * | | |0 = I2C's stretch disabled and the I2C protocol function will go ahead. + * | | |1 = I2C's stretch active. + * |[8] |SCLOUTEN |SCL Output Enable Bit + * | | |This bit enables monitor pulling SCL to low + * | | |This monitor will pull SCL to low until it has had time to respond to an I2C interrupt. + * | | |0 = SCL output will be forced high due to open drain mechanism. + * | | |1 = I2C module may act as a slave peripheral just like in normal operation, the I2C holds the clock line low until it has had time to clear I2C interrupt. + * |[9] |MONEN |Monitor Mode Enable Bit + * | | |This bit enables monitor mode + * | | |In monitor mode the SDA output will be put in high impedance mode + * | | |This prevents the I2C module from outputting data of any kind (including ACK) onto the I2C data bus. + * | | |0 = The monitor mode is disabled. + * | | |1 = The monitor mode is enabled. + * | | |Note: Depending on the state of the SCLOUTEN bit, the SCL output may be also forced high, preventing the module from having control over the I2C clock line. + * |[25:16] |TOCNT |Time-out Clock Cycle + * | | |This bit field indicates how many clock cycle selected by TMCNTSRC (USCI_BRGEN [5]) when each interrupt flags are clear + * | | |The time-out is enable when TOCNT bigger than 0. + * | | |Note: The TMCNTSRC (USCI_BRGEN [5]) must be set zero on I2C mode. + * |[31] |PROTEN |I2C Protocol Enable Bit + * | | |0 = I2C Protocol disable. + * | | |1 = I2C Protocol enable. + * @var UI2C_T::PROTIEN + * Offset: 0x60 USCI Protocol Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |TOIEN |Time-out Interrupt Enable Control + * | | |In I2C protocol, this bit enables the interrupt generation in case of a time-out event. + * | | |0 = The time-out interrupt is disabled. + * | | |1 = The time-out interrupt is enabled. + * |[1] |STARIEN |Start Condition Received Interrupt Enable Control + * | | |This bit enables the generation of a protocol interrupt if a start condition is detected. + * | | |0 = The start condition interrupt is disabled. + * | | |1 = The start condition interrupt is enabled. + * |[2] |STORIEN |Stop Condition Received Interrupt Enable Control + * | | |This bit enables the generation of a protocol interrupt if a stop condition is detected. + * | | |0 = The stop condition interrupt is disabled. + * | | |1 = The stop condition interrupt is enabled. + * |[3] |NACKIEN |Non - Acknowledge Interrupt Enable Control + * | | |This bit enables the generation of a protocol interrupt if a non - acknowledge is detected by a master. + * | | |0 = The non - acknowledge interrupt is disabled. + * | | |1 = The non - acknowledge interrupt is enabled. + * |[4] |ARBLOIEN |Arbitration Lost Interrupt Enable Control + * | | |This bit enables the generation of a protocol interrupt if an arbitration lost event is detected. + * | | |0 = The arbitration lost interrupt is disabled. + * | | |1 = The arbitration lost interrupt is enabled. + * |[5] |ERRIEN |Error Interrupt Enable Control + * | | |This bit enables the generation of a protocol interrupt if an I2C error condition is detected (indicated by ERR (USCI_PROTSTS [16])). + * | | |0 = The error interrupt is disabled. + * | | |1 = The error interrupt is enabled. + * |[6] |ACKIEN |Acknowledge Interrupt Enable Control + * | | |This bit enables the generation of a protocol interrupt if an acknowledge is detected by a master. + * | | |0 = The acknowledge interrupt is disabled. + * | | |1 = The acknowledge interrupt is enabled. + * @var UI2C_T::PROTSTS + * Offset: 0x64 USCI Protocol Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[5] |TOIF |Time-out Interrupt Flag + * | | |0 = A time-out interrupt status has not occurred. + * | | |1 = A time-out interrupt status has occurred. + * | | |Note: It is cleared by software writing one into this bit + * |[6] |ONBUSY |On Bus Busy + * | | |Indicates that a communication is in progress on the bus + * | | |It is set by hardware when a START condition is detected + * | | |It is cleared by hardware when a STOP condition is detected + * | | |0 = The bus is IDLE (both SCLK and SDA High). + * | | |1 = The bus is busy. + * |[8] |STARIF |Start Condition Received Interrupt Flag + * | | |This bit indicates that a start condition or repeated start condition has been detected on master mode + * | | |However, this bit also indicates that a repeated start condition has been detected on slave mode. + * | | |A protocol interrupt can be generated if USCI_PROTCTL.STARIEN = 1. + * | | |0 = A start condition has not yet been detected. + * | | |1 = A start condition has been detected. + * | | |It is cleared by software writing one into this bit + * |[9] |STORIF |Stop Condition Received Interrupt Flag + * | | |This bit indicates that a stop condition has been detected on the I2C bus lines + * | | |A protocol interrupt can be generated if USCI_PROTCTL.STORIEN = 1. + * | | |0 = A stop condition has not yet been detected. + * | | |1 = A stop condition has been detected. + * | | |It is cleared by software writing one into this bit + * | | |Note: This bit is set when slave RX mode. + * |[10] |NACKIF |Non - Acknowledge Received Interrupt Flag + * | | |This bit indicates that a non - acknowledge has been received in master mode + * | | |A protocol interrupt can be generated if USCI_PROTCTL.NACKIEN = 1. + * | | |0 = A non - acknowledge has not been received. + * | | |1 = A non - acknowledge has been received. + * | | |It is cleared by software writing one into this bit + * |[11] |ARBLOIF |Arbitration Lost Interrupt Flag + * | | |This bit indicates that an arbitration has been lost + * | | |A protocol interrupt can be generated if USCI_PROTCTL.ARBLOIEN = 1. + * | | |0 = An arbitration has not been lost. + * | | |1 = An arbitration has been lost. + * | | |It is cleared by software writing one into this bit + * |[12] |ERRIF |Error Interrupt Flag + * | | |This bit indicates that a Bus Error occurs when a START or STOP condition is present at an illegal position in the formation frame + * | | |Example of illegal position are during the serial transfer of an address byte, a data byte or an acknowledge bit + * | | |A protocol interrupt can be generated if USCI_PROTCTL.ERRIEN = 1. + * | | |0 = An I2C error has not been detected. + * | | |1 = An I2C error has been detected. + * | | |It is cleared by software writing one into this bit + * | | |Note: This bit is set when slave mode, user must write one into STO register to the defined "not addressed" slave mode. + * |[13] |ACKIF |Acknowledge Received Interrupt Flag + * | | |This bit indicates that an acknowledge has been received in master mode + * | | |A protocol interrupt can be generated if USCI_PROTCTL.ACKIEN = 1. + * | | |0 = An acknowledge has not been received. + * | | |1 = An acknowledge has been received. + * | | |It is cleared by software writing one into this bit + * |[14] |SLASEL |Slave Select Status + * | | |This bit indicates that this device has been selected as slave. + * | | |0 = The device is not selected as slave. + * | | |1 = The device is selected as slave. + * | | |Note: This bit has no interrupt signal, and it will be cleared automatically by hardware. + * |[15] |SLAREAD |Slave Read Request Status + * | | |This bit indicates that a slave read request has been detected. + * | | |0 = A slave R/W bit is 1 has not been detected. + * | | |1 = A slave R/W bit is 1 has been detected. + * | | |Note: This bit has no interrupt signal, and it will be cleared automatically by hardware. + * |[16] |WKAKDONE |Wakeup Address Frame Acknowledge Bit Done + * | | |0 = The ACK bit cycle of address match frame isn't done. + * | | |1 = The ACK bit cycle of address match frame is done in power-down. + * | | |Note: This bit can't release when WKUPIF is set. + * |[17] |WRSTSWK |Read/Write Status Bit in Address Wakeup Frame + * | | |0 = Write command be record on the address match wakeup frame. + * | | |1 = Read command be record on the address match wakeup frame. + * |[18] |BUSHANG |Bus Hang-up + * | | |This bit indicates bus hang-up status + * | | |There is 4-bit counter count when SCL hold high and refer fSAMP_CLK + * | | |The hang-up counter will count to overflow and set this bit when SDA is low + * | | |The counter will be reset by falling edge of SCL signal. + * | | |0 = The bus is normal status for transmission. + * | | |1 = The bus is hang-up status for transmission. + * | | |Note: This bit has no interrupt signal, and it will be cleared automatically by hardware when a START condition is present. + * |[19] |ERRARBLO |Error Arbitration Lost + * | | |This bit indicates bus arbitration lost due to bigger noise which is can't be filtered by input processor + * | | |The I2C can send start condition when ERRARBLO is set + * | | |Thus this bit doesn't be cared on slave mode. + * | | |0 = The bus is normal status for transmission. + * | | |1 = The bus is error arbitration lost status for transmission. + * | | |Note: This bit has no interrupt signal, and it will be cleared automatically by hardware when a START condition is present. + * @var UI2C_T::ADMAT + * Offset: 0x88 I2C Slave Match Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |ADMAT0 |USCI Address 0 Match Status Register + * | | |When address 0 is matched, hardware will inform which address used + * | | |This bit will set to 1, and software can write 1 to clear this bit. + * |[1] |ADMAT1 |USCI Address 1 Match Status Register + * | | |When address 1 is matched, hardware will inform which address used + * | | |This bit will set to 1, and software can write 1 to clear this bit. + * @var UI2C_T::TMCTL + * Offset: 0x8C I2C Timing Configure Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[8:0] |STCTL |Setup Time Configure Control Register + * | | |This field is used to generate a delay timing between SDA edge and SCL rising edge in transmission mode. + * | | |The delay setup time is numbers of peripheral clock = STCTL x fPCLK. + * |[24:16] |HTCTL |Hold Time Configure Control Register + * | | |This field is used to generate the delay timing between SCL falling edge SDA edge in + * | | |transmission mode. + * | | |The delay hold time is numbers of peripheral clock = HTCTL x fPCLK. + */ + __IO uint32_t CTL; /*!< [0x0000] USCI Control Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t BRGEN; /*!< [0x0008] USCI Baud Rate Generator Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE1[8]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t LINECTL; /*!< [0x002c] USCI Line Control Register */ + __O uint32_t TXDAT; /*!< [0x0030] USCI Transmit Data Register */ + __I uint32_t RXDAT; /*!< [0x0034] USCI Receive Data Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE2[3]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t DEVADDR0; /*!< [0x0044] USCI Device Address Register 0 */ + __IO uint32_t DEVADDR1; /*!< [0x0048] USCI Device Address Register 1 */ + __IO uint32_t ADDRMSK0; /*!< [0x004c] USCI Device Address Mask Register 0 */ + __IO uint32_t ADDRMSK1; /*!< [0x0050] USCI Device Address Mask Register 1 */ + __IO uint32_t WKCTL; /*!< [0x0054] USCI Wake-up Control Register */ + __IO uint32_t WKSTS; /*!< [0x0058] USCI Wake-up Status Register */ + __IO uint32_t PROTCTL; /*!< [0x005c] USCI Protocol Control Register */ + __IO uint32_t PROTIEN; /*!< [0x0060] USCI Protocol Interrupt Enable Register */ + __IO uint32_t PROTSTS; /*!< [0x0064] USCI Protocol Status Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE3[8]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t ADMAT; /*!< [0x0088] I2C Slave Match Address Register */ + __IO uint32_t TMCTL; /*!< [0x008c] I2C Timing Configure Control Register */ + +} UI2C_T; + +/** + @addtogroup UI2C_CONST UI2C Bit Field Definition + Constant Definitions for UI2C Controller +@{ */ + +#define UI2C_CTL_FUNMODE_Pos (0) /*!< UI2C_T::CTL: FUNMODE Position */ +#define UI2C_CTL_FUNMODE_Msk (0x7ul << UI2C_CTL_FUNMODE_Pos) /*!< UI2C_T::CTL: FUNMODE Mask */ + +#define UI2C_BRGEN_RCLKSEL_Pos (0) /*!< UI2C_T::BRGEN: RCLKSEL Position */ +#define UI2C_BRGEN_RCLKSEL_Msk (0x1ul << UI2C_BRGEN_RCLKSEL_Pos) /*!< UI2C_T::BRGEN: RCLKSEL Mask */ + +#define UI2C_BRGEN_PTCLKSEL_Pos (1) /*!< UI2C_T::BRGEN: PTCLKSEL Position */ +#define UI2C_BRGEN_PTCLKSEL_Msk (0x1ul << UI2C_BRGEN_PTCLKSEL_Pos) /*!< UI2C_T::BRGEN: PTCLKSEL Mask */ + +#define UI2C_BRGEN_SPCLKSEL_Pos (2) /*!< UI2C_T::BRGEN: SPCLKSEL Position */ +#define UI2C_BRGEN_SPCLKSEL_Msk (0x3ul << UI2C_BRGEN_SPCLKSEL_Pos) /*!< UI2C_T::BRGEN: SPCLKSEL Mask */ + +#define UI2C_BRGEN_TMCNTEN_Pos (4) /*!< UI2C_T::BRGEN: TMCNTEN Position */ +#define UI2C_BRGEN_TMCNTEN_Msk (0x1ul << UI2C_BRGEN_TMCNTEN_Pos) /*!< UI2C_T::BRGEN: TMCNTEN Mask */ + +#define UI2C_BRGEN_TMCNTSRC_Pos (5) /*!< UI2C_T::BRGEN: TMCNTSRC Position */ +#define UI2C_BRGEN_TMCNTSRC_Msk (0x1ul << UI2C_BRGEN_TMCNTSRC_Pos) /*!< UI2C_T::BRGEN: TMCNTSRC Mask */ + +#define UI2C_BRGEN_PDSCNT_Pos (8) /*!< UI2C_T::BRGEN: PDSCNT Position */ +#define UI2C_BRGEN_PDSCNT_Msk (0x3ul << UI2C_BRGEN_PDSCNT_Pos) /*!< UI2C_T::BRGEN: PDSCNT Mask */ + +#define UI2C_BRGEN_DSCNT_Pos (10) /*!< UI2C_T::BRGEN: DSCNT Position */ +#define UI2C_BRGEN_DSCNT_Msk (0x1ful << UI2C_BRGEN_DSCNT_Pos) /*!< UI2C_T::BRGEN: DSCNT Mask */ + +#define UI2C_BRGEN_CLKDIV_Pos (16) /*!< UI2C_T::BRGEN: CLKDIV Position */ +#define UI2C_BRGEN_CLKDIV_Msk (0x3fful << UI2C_BRGEN_CLKDIV_Pos) /*!< UI2C_T::BRGEN: CLKDIV Mask */ + +#define UI2C_LINECTL_LSB_Pos (0) /*!< UI2C_T::LINECTL: LSB Position */ +#define UI2C_LINECTL_LSB_Msk (0x1ul << UI2C_LINECTL_LSB_Pos) /*!< UI2C_T::LINECTL: LSB Mask */ + +#define UI2C_LINECTL_DWIDTH_Pos (8) /*!< UI2C_T::LINECTL: DWIDTH Position */ +#define UI2C_LINECTL_DWIDTH_Msk (0xful << UI2C_LINECTL_DWIDTH_Pos) /*!< UI2C_T::LINECTL: DWIDTH Mask */ + +#define UI2C_TXDAT_TXDAT_Pos (0) /*!< UI2C_T::TXDAT: TXDAT Position */ +#define UI2C_TXDAT_TXDAT_Msk (0xfffful << UI2C_TXDAT_TXDAT_Pos) /*!< UI2C_T::TXDAT: TXDAT Mask */ + +#define UI2C_RXDAT_RXDAT_Pos (0) /*!< UI2C_T::RXDAT: RXDAT Position */ +#define UI2C_RXDAT_RXDAT_Msk (0xfffful << UI2C_RXDAT_RXDAT_Pos) /*!< UI2C_T::RXDAT: RXDAT Mask */ + +#define UI2C_DEVADDR0_DEVADDR_Pos (0) /*!< UI2C_T::DEVADDR0: DEVADDR Position */ +#define UI2C_DEVADDR0_DEVADDR_Msk (0x3fful << UI2C_DEVADDR0_DEVADDR_Pos) /*!< UI2C_T::DEVADDR0: DEVADDR Mask */ + +#define UI2C_DEVADDR1_DEVADDR_Pos (0) /*!< UI2C_T::DEVADDR1: DEVADDR Position */ +#define UI2C_DEVADDR1_DEVADDR_Msk (0x3fful << UI2C_DEVADDR1_DEVADDR_Pos) /*!< UI2C_T::DEVADDR1: DEVADDR Mask */ + +#define UI2C_ADDRMSK0_ADDRMSK_Pos (0) /*!< UI2C_T::ADDRMSK0: ADDRMSK Position */ +#define UI2C_ADDRMSK0_ADDRMSK_Msk (0x3fful << UI2C_ADDRMSK0_ADDRMSK_Pos) /*!< UI2C_T::ADDRMSK0: ADDRMSK Mask */ + +#define UI2C_ADDRMSK1_ADDRMSK_Pos (0) /*!< UI2C_T::ADDRMSK1: ADDRMSK Position */ +#define UI2C_ADDRMSK1_ADDRMSK_Msk (0x3fful << UI2C_ADDRMSK1_ADDRMSK_Pos) /*!< UI2C_T::ADDRMSK1: ADDRMSK Mask */ + +#define UI2C_WKCTL_WKEN_Pos (0) /*!< UI2C_T::WKCTL: WKEN Position */ +#define UI2C_WKCTL_WKEN_Msk (0x1ul << UI2C_WKCTL_WKEN_Pos) /*!< UI2C_T::WKCTL: WKEN Mask */ + +#define UI2C_WKCTL_WKADDREN_Pos (1) /*!< UI2C_T::WKCTL: WKADDREN Position */ +#define UI2C_WKCTL_WKADDREN_Msk (0x1ul << UI2C_WKCTL_WKADDREN_Pos) /*!< UI2C_T::WKCTL: WKADDREN Mask */ + +#define UI2C_WKSTS_WKF_Pos (0) /*!< UI2C_T::WKSTS: WKF Position */ +#define UI2C_WKSTS_WKF_Msk (0x1ul << UI2C_WKSTS_WKF_Pos) /*!< UI2C_T::WKSTS: WKF Mask */ + +#define UI2C_PROTCTL_GCFUNC_Pos (0) /*!< UI2C_T::PROTCTL: GCFUNC Position */ +#define UI2C_PROTCTL_GCFUNC_Msk (0x1ul << UI2C_PROTCTL_GCFUNC_Pos) /*!< UI2C_T::PROTCTL: GCFUNC Mask */ + +#define UI2C_PROTCTL_AA_Pos (1) /*!< UI2C_T::PROTCTL: AA Position */ +#define UI2C_PROTCTL_AA_Msk (0x1ul << UI2C_PROTCTL_AA_Pos) /*!< UI2C_T::PROTCTL: AA Mask */ + +#define UI2C_PROTCTL_STO_Pos (2) /*!< UI2C_T::PROTCTL: STO Position */ +#define UI2C_PROTCTL_STO_Msk (0x1ul << UI2C_PROTCTL_STO_Pos) /*!< UI2C_T::PROTCTL: STO Mask */ + +#define UI2C_PROTCTL_STA_Pos (3) /*!< UI2C_T::PROTCTL: STA Position */ +#define UI2C_PROTCTL_STA_Msk (0x1ul << UI2C_PROTCTL_STA_Pos) /*!< UI2C_T::PROTCTL: STA Mask */ + +#define UI2C_PROTCTL_ADDR10EN_Pos (4) /*!< UI2C_T::PROTCTL: ADDR10EN Position */ +#define UI2C_PROTCTL_ADDR10EN_Msk (0x1ul << UI2C_PROTCTL_ADDR10EN_Pos) /*!< UI2C_T::PROTCTL: ADDR10EN Mask */ + +#define UI2C_PROTCTL_PTRG_Pos (5) /*!< UI2C_T::PROTCTL: PTRG Position */ +#define UI2C_PROTCTL_PTRG_Msk (0x1ul << UI2C_PROTCTL_PTRG_Pos) /*!< UI2C_T::PROTCTL: PTRG Mask */ + +#define UI2C_PROTCTL_SCLOUTEN_Pos (8) /*!< UI2C_T::PROTCTL: SCLOUTEN Position */ +#define UI2C_PROTCTL_SCLOUTEN_Msk (0x1ul << UI2C_PROTCTL_SCLOUTEN_Pos) /*!< UI2C_T::PROTCTL: SCLOUTEN Mask */ + +#define UI2C_PROTCTL_MONEN_Pos (9) /*!< UI2C_T::PROTCTL: MONEN Position */ +#define UI2C_PROTCTL_MONEN_Msk (0x1ul << UI2C_PROTCTL_MONEN_Pos) /*!< UI2C_T::PROTCTL: MONEN Mask */ + +#define UI2C_PROTCTL_TOCNT_Pos (16) /*!< UI2C_T::PROTCTL: TOCNT Position */ +#define UI2C_PROTCTL_TOCNT_Msk (0x3fful << UI2C_PROTCTL_TOCNT_Pos) /*!< UI2C_T::PROTCTL: TOCNT Mask */ + +#define UI2C_PROTCTL_PROTEN_Pos (31) /*!< UI2C_T::PROTCTL: PROTEN Position */ +#define UI2C_PROTCTL_PROTEN_Msk (0x1ul << UI2C_PROTCTL_PROTEN_Pos) /*!< UI2C_T::PROTCTL: PROTEN Mask */ + +#define UI2C_PROTIEN_TOIEN_Pos (0) /*!< UI2C_T::PROTIEN: TOIEN Position */ +#define UI2C_PROTIEN_TOIEN_Msk (0x1ul << UI2C_PROTIEN_TOIEN_Pos) /*!< UI2C_T::PROTIEN: TOIEN Mask */ + +#define UI2C_PROTIEN_STARIEN_Pos (1) /*!< UI2C_T::PROTIEN: STARIEN Position */ +#define UI2C_PROTIEN_STARIEN_Msk (0x1ul << UI2C_PROTIEN_STARIEN_Pos) /*!< UI2C_T::PROTIEN: STARIEN Mask */ + +#define UI2C_PROTIEN_STORIEN_Pos (2) /*!< UI2C_T::PROTIEN: STORIEN Position */ +#define UI2C_PROTIEN_STORIEN_Msk (0x1ul << UI2C_PROTIEN_STORIEN_Pos) /*!< UI2C_T::PROTIEN: STORIEN Mask */ + +#define UI2C_PROTIEN_NACKIEN_Pos (3) /*!< UI2C_T::PROTIEN: NACKIEN Position */ +#define UI2C_PROTIEN_NACKIEN_Msk (0x1ul << UI2C_PROTIEN_NACKIEN_Pos) /*!< UI2C_T::PROTIEN: NACKIEN Mask */ + +#define UI2C_PROTIEN_ARBLOIEN_Pos (4) /*!< UI2C_T::PROTIEN: ARBLOIEN Position */ +#define UI2C_PROTIEN_ARBLOIEN_Msk (0x1ul << UI2C_PROTIEN_ARBLOIEN_Pos) /*!< UI2C_T::PROTIEN: ARBLOIEN Mask */ + +#define UI2C_PROTIEN_ERRIEN_Pos (5) /*!< UI2C_T::PROTIEN: ERRIEN Position */ +#define UI2C_PROTIEN_ERRIEN_Msk (0x1ul << UI2C_PROTIEN_ERRIEN_Pos) /*!< UI2C_T::PROTIEN: ERRIEN Mask */ + +#define UI2C_PROTIEN_ACKIEN_Pos (6) /*!< UI2C_T::PROTIEN: ACKIEN Position */ +#define UI2C_PROTIEN_ACKIEN_Msk (0x1ul << UI2C_PROTIEN_ACKIEN_Pos) /*!< UI2C_T::PROTIEN: ACKIEN Mask */ + +#define UI2C_PROTSTS_TOIF_Pos (5) /*!< UI2C_T::PROTSTS: TOIF Position */ +#define UI2C_PROTSTS_TOIF_Msk (0x1ul << UI2C_PROTSTS_TOIF_Pos) /*!< UI2C_T::PROTSTS: TOIF Mask */ + +#define UI2C_PROTSTS_ONBUSY_Pos (6) /*!< UI2C_T::PROTSTS: ONBUSY Position */ +#define UI2C_PROTSTS_ONBUSY_Msk (0x1ul << UI2C_PROTSTS_ONBUSY_Pos) /*!< UI2C_T::PROTSTS: ONBUSY Mask */ + +#define UI2C_PROTSTS_STARIF_Pos (8) /*!< UI2C_T::PROTSTS: STARIF Position */ +#define UI2C_PROTSTS_STARIF_Msk (0x1ul << UI2C_PROTSTS_STARIF_Pos) /*!< UI2C_T::PROTSTS: STARIF Mask */ + +#define UI2C_PROTSTS_STORIF_Pos (9) /*!< UI2C_T::PROTSTS: STORIF Position */ +#define UI2C_PROTSTS_STORIF_Msk (0x1ul << UI2C_PROTSTS_STORIF_Pos) /*!< UI2C_T::PROTSTS: STORIF Mask */ + +#define UI2C_PROTSTS_NACKIF_Pos (10) /*!< UI2C_T::PROTSTS: NACKIF Position */ +#define UI2C_PROTSTS_NACKIF_Msk (0x1ul << UI2C_PROTSTS_NACKIF_Pos) /*!< UI2C_T::PROTSTS: NACKIF Mask */ + +#define UI2C_PROTSTS_ARBLOIF_Pos (11) /*!< UI2C_T::PROTSTS: ARBLOIF Position */ +#define UI2C_PROTSTS_ARBLOIF_Msk (0x1ul << UI2C_PROTSTS_ARBLOIF_Pos) /*!< UI2C_T::PROTSTS: ARBLOIF Mask */ + +#define UI2C_PROTSTS_ERRIF_Pos (12) /*!< UI2C_T::PROTSTS: ERRIF Position */ +#define UI2C_PROTSTS_ERRIF_Msk (0x1ul << UI2C_PROTSTS_ERRIF_Pos) /*!< UI2C_T::PROTSTS: ERRIF Mask */ + +#define UI2C_PROTSTS_ACKIF_Pos (13) /*!< UI2C_T::PROTSTS: ACKIF Position */ +#define UI2C_PROTSTS_ACKIF_Msk (0x1ul << UI2C_PROTSTS_ACKIF_Pos) /*!< UI2C_T::PROTSTS: ACKIF Mask */ + +#define UI2C_PROTSTS_SLASEL_Pos (14) /*!< UI2C_T::PROTSTS: SLASEL Position */ +#define UI2C_PROTSTS_SLASEL_Msk (0x1ul << UI2C_PROTSTS_SLASEL_Pos) /*!< UI2C_T::PROTSTS: SLASEL Mask */ + +#define UI2C_PROTSTS_SLAREAD_Pos (15) /*!< UI2C_T::PROTSTS: SLAREAD Position */ +#define UI2C_PROTSTS_SLAREAD_Msk (0x1ul << UI2C_PROTSTS_SLAREAD_Pos) /*!< UI2C_T::PROTSTS: SLAREAD Mask */ + +#define UI2C_PROTSTS_WKAKDONE_Pos (16) /*!< UI2C_T::PROTSTS: WKAKDONE Position */ +#define UI2C_PROTSTS_WKAKDONE_Msk (0x1ul << UI2C_PROTSTS_WKAKDONE_Pos) /*!< UI2C_T::PROTSTS: WKAKDONE Mask */ + +#define UI2C_PROTSTS_WRSTSWK_Pos (17) /*!< UI2C_T::PROTSTS: WRSTSWK Position */ +#define UI2C_PROTSTS_WRSTSWK_Msk (0x1ul << UI2C_PROTSTS_WRSTSWK_Pos) /*!< UI2C_T::PROTSTS: WRSTSWK Mask */ + +#define UI2C_PROTSTS_BUSHANG_Pos (18) /*!< UI2C_T::PROTSTS: BUSHANG Position */ +#define UI2C_PROTSTS_BUSHANG_Msk (0x1ul << UI2C_PROTSTS_BUSHANG_Pos) /*!< UI2C_T::PROTSTS: BUSHANG Mask */ + +#define UI2C_PROTSTS_ERRARBLO_Pos (19) /*!< UI2C_T::PROTSTS: ERRARBLO Position */ +#define UI2C_PROTSTS_ERRARBLO_Msk (0x1ul << UI2C_PROTSTS_ERRARBLO_Pos) /*!< UI2C_T::PROTSTS: ERRARBLO Mask */ + +#define UI2C_ADMAT_ADMAT0_Pos (0) /*!< UI2C_T::ADMAT: ADMAT0 Position */ +#define UI2C_ADMAT_ADMAT0_Msk (0x1ul << UI2C_ADMAT_ADMAT0_Pos) /*!< UI2C_T::ADMAT: ADMAT0 Mask */ + +#define UI2C_ADMAT_ADMAT1_Pos (1) /*!< UI2C_T::ADMAT: ADMAT1 Position */ +#define UI2C_ADMAT_ADMAT1_Msk (0x1ul << UI2C_ADMAT_ADMAT1_Pos) /*!< UI2C_T::ADMAT: ADMAT1 Mask */ + +#define UI2C_TMCTL_STCTL_Pos (0) /*!< UI2C_T::TMCTL: STCTL Position */ +#define UI2C_TMCTL_STCTL_Msk (0x1fful << UI2C_TMCTL_STCTL_Pos) /*!< UI2C_T::TMCTL: STCTL Mask */ + +#define UI2C_TMCTL_HTCTL_Pos (16) /*!< UI2C_T::TMCTL: HTCTL Position */ +#define UI2C_TMCTL_HTCTL_Msk (0x1fful << UI2C_TMCTL_HTCTL_Pos) /*!< UI2C_T::TMCTL: HTCTL Mask */ + +/**@}*/ /* UI2C_CONST */ +/**@}*/ /* end of UI2C register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __UI2C_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/usbd_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/usbd_reg.h new file mode 100644 index 00000000000..5638db70e6e --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/usbd_reg.h @@ -0,0 +1,649 @@ +/**************************************************************************//** + * @file usbd_reg.h + * @version V1.00 + * @brief USBD register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __USBD_REG_H__ +#define __USBD_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup USBD USB Device Controller(USBD) + Memory Mapped Structure for USBD Controller +@{ */ + +typedef struct +{ + + /** + * @var USBD_EP_T::BUFSEG + * Offset: 0x000 Endpoint n Buffer Segmentation Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[8:3] |BUFSEG |Endpoint Buffer Segmentation + * | | |It is used to indicate the offset address for each endpoint with the USB SRAM starting address The effective starting address of the endpoint is + * | | |USBD_SRAM address + { BUFSEG, 3'b000} + * | | |Where the USBD_SRAM address = USBD_BA+0x100h. + * | | |Refer to the section 7.29.5.7 for the endpoint SRAM structure and its description. + * @var USBD_EP_T::MXPLD + * Offset: 0x004 Endpoint n Maximal Payload Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[8:0] |MXPLD |Maximal Payload + * | | |Define the data length which is transmitted to host (IN token) or the actual data length which is received from the host (OUT token) + * | | |It also used to indicate that the endpoint is ready to be transmitted in IN token or received in OUT token. + * | | |(1) When the register is written by CPU, + * | | |For IN token, the value of MXPLD is used to define the data length to be transmitted and indicate the data buffer is ready. + * | | |For OUT token, it means that the controller is ready to receive data from the host and the value of MXPLD is the maximal data length comes from host. + * | | |(2) When the register is read by CPU, + * | | |For IN token, the value of MXPLD is indicated by the data length be transmitted to host + * | | |For OUT token, the value of MXPLD is indicated the actual data length receiving from host. + * | | |Note: Once MXPLD is written, the data packets will be transmitted/received immediately after IN/OUT token arrived. + * @var USBD_EP_T::CFG + * Offset: 0x008 Endpoint n Configuration Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |EPNUM |Endpoint Number + * | | |These bits are used to define the endpoint number of the current endpoint + * |[4] |ISOCH |Isochronous Endpoint + * | | |This bit is used to set the endpoint as Isochronous endpoint, no handshake. + * | | |0 = No Isochronous endpoint. + * | | |1 = Isochronous endpoint. + * |[6:5] |STATE |Endpoint STATE + * | | |00 = Endpoint is Disabled. + * | | |01 = Out endpoint. + * | | |10 = IN endpoint. + * | | |11 = Undefined. + * |[7] |DSQSYNC |Data Sequence Synchronization + * | | |0 = DATA0 PID. + * | | |1 = DATA1 PID. + * | | |Note: It is used to specify the DATA0 or DATA1 PID in the following IN token transaction + * | | |hardware will toggle automatically in IN token base on the bit. + * |[9] |CSTALL |Clear STALL Response + * | | |0 = Disable the device to clear the STALL handshake in setup stage. + * | | |1 = Clear the device to response STALL handshake in setup stage. + * @var USBD_EP_T::CFGP + * Offset: 0x00C Endpoint n Set Stall and Clear In/Out Ready Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CLRRDY |Clear Ready + * | | |When the USBD_MXPLDx register is set by user, it means that the endpoint is ready to transmit or receive data + * | | |If the user wants to disable this transaction before the transaction start, users can set this bit to 1 to disable it and it is auto clear to 0. + * | | |For IN token, write '1' to clear the IN token had ready to transmit the data to USB. + * | | |For OUT token, write '1' to clear the OUT token had ready to receive the data from USB. + * | | |This bit is write 1 only and is always 0 when it is read back. + * |[1] |SSTALL |Set STALL + * | | |0 = Disable the device to response STALL. + * | | |1 = Set the device to respond STALL automatically. + */ + __IO uint32_t BUFSEG; /*!< [0x0000] Endpoint n Buffer Segmentation Register */ + __IO uint32_t MXPLD; /*!< [0x0004] Endpoint n Maximal Payload Register */ + __IO uint32_t CFG; /*!< [0x0008] Endpoint n Configuration Register */ + __IO uint32_t CFGP; /*!< [0x000c] Endpoint n Set Stall and Clear In/Out Ready Control Register */ + +} USBD_EP_T; + +typedef struct +{ + + + /** + * @var USBD_T::INTEN + * Offset: 0x00 USB Device Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BUSIEN |Bus Event Interrupt Enable Bit + * | | |0 = BUS event interrupt Disabled. + * | | |1 = BUS event interrupt Enabled. + * |[1] |USBIEN |USB Event Interrupt Enable Bit + * | | |0 = USB event interrupt Disabled. + * | | |1 = USB event interrupt Enabled. + * |[2] |VBDETIEN |VBUS Detection Interrupt Enable Bit + * | | |0 = VBUS detection Interrupt Disabled. + * | | |1 = VBUS detection Interrupt Enabled. + * |[3] |NEVWKIEN |USB No-event-wake-up Interrupt Enable Bit + * | | |0 = No-event-wake-up Interrupt Disabled. + * | | |1 = No-event-wake-up Interrupt Enabled. + * |[4] |SOFIEN |Start of Frame Interrupt Enable Bit + * | | |0 = SOF Interrupt Disabled. + * | | |1 = SOF Interrupt Enabled. + * |[8] |WKEN |Wake-up Function Enable Bit + * | | |0 = USB wake-up function Disabled. + * | | |1 = USB wake-up function Enabled. + * |[15] |INNAKEN |Active NAK Function and Its Status in IN Token + * | | |0 = When device responds NAK after receiving IN token, IN NAK status will not be updated to USBD_EPSTS0 and USBD_EPSTS1register, so that the USB interrupt event will not be asserted. + * | | |1 = IN NAK status will be updated to USBD_EPSTS0 and USBD_EPSTS1 register and the USB interrupt event will be asserted, when the device responds NAK after receiving IN token. + * @var USBD_T::INTSTS + * Offset: 0x04 USB Device Interrupt Event Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |BUSIF |BUS Interrupt Status + * | | |The BUS event means that there is one of the suspense or the resume function in the bus. + * | | |0 = No BUS event occurred. + * | | |1 = Bus event occurred; check USBD_ATTR[3:0] to know which kind of bus event was occurred, cleared by write 1 to USBD_INTSTS[0]. + * |[1] |USBIF |USB Event Interrupt Status + * | | |The USB event includes the SETUP Token, IN Token, OUT ACK, ISO IN, or ISO OUT events in the bus. + * | | |0 = No USB event occurred. + * | | |1 = USB event occurred, check EPSTS0~5[2:0] to know which kind of USB event was occurred, cleared by write 1 to USBD_INTSTS[1] or EPSTS0~11 and SETUP (USBD_INTSTS[31]). + * |[2] |VBDETIF |VBUS Detection Interrupt Status + * | | |0 = There is not attached/detached event in the USB. + * | | |1 = There is attached/detached event in the USB bus and it is cleared by write 1 to USBD_INTSTS[2]. + * |[3] |NEVWKIF |No-event-wake-up Interrupt Status + * | | |0 = NEVWK event does not occur. + * | | |1 = No-event-wake-up event occurred, cleared by write 1 to USBD_INTSTS[3]. + * |[4] |SOFIF |Start of Frame Interrupt Status + * | | |0 = SOF event does not occur. + * | | |1 = SOF event occurred, cleared by write 1 to USBD_INTSTS[4]. + * |[16] |EPEVT0 |Endpoint 0's USB Event Status + * | | |0 = No event occurred in endpoint 0. + * | | |1 = USB event occurred on Endpoint 0, check USBD_EPSTS0[3:0] to know which kind of USB event was occurred, cleared by write 1 to USBD_INTSTS[16] or USBD_INTSTS[1]. + * |[17] |EPEVT1 |Endpoint 1's USB Event Status + * | | |0 = No event occurred in endpoint 1. + * | | |1 = USB event occurred on Endpoint 1, check USBD_EPSTS0[7:4] to know which kind of USB event was occurred, cleared by write 1 to USBD_INTSTS[17] or USBD_INTSTS[1]. + * |[18] |EPEVT2 |Endpoint 2's USB Event Status + * | | |0 = No event occurred in endpoint 2. + * | | |1 = USB event occurred on Endpoint 2, check USBD_EPSTS0[11:8] to know which kind of USB event was occurred, cleared by write 1 to USBD_INTSTS[18] or USBD_INTSTS[1]. + * |[19] |EPEVT3 |Endpoint 3's USB Event Status + * | | |0 = No event occurred in endpoint 3. + * | | |1 = USB event occurred on Endpoint 3, check USBD_EPSTS0[15:12] to know which kind of USB event was occurred, cleared by write 1 to USBD_INTSTS[19] or USBD_INTSTS[1]. + * |[20] |EPEVT4 |Endpoint 4's USB Event Status + * | | |0 = No event occurred in endpoint 4. + * | | |1 = USB event occurred on Endpoint 4, check USBD_EPSTS0[19:16] to know which kind of USB event was occurred, cleared by write 1 to USBD_INTSTS[20] or USBD_INTSTS[1]. + * |[21] |EPEVT5 |Endpoint 5's USB Event Status + * | | |0 = No event occurred in endpoint 5. + * | | |1 = USB event occurred on Endpoint 5, check USBD_EPSTS0[23:20] to know which kind of USB event was occurred, cleared by write 1 to USBD_INTSTS[21] or USBD_INTSTS[1]. + * |[22] |EPEVT6 |Endpoint 6's USB Event Status + * | | |0 = No event occurred in endpoint 6. + * | | |1 = USB event occurred on Endpoint 6, check USBD_EPSTS0[27:24] to know which kind of USB event was occurred, cleared by write 1 to USBD_INTSTS[22] or USBD_INTSTS[1]. + * |[23] |EPEVT7 |Endpoint 7's USB Event Status + * | | |0 = No event occurred in endpoint 7. + * | | |1 = USB event occurred on Endpoint 7, check USBD_EPSTS0[31:28] to know which kind of USB event was occurred, cleared by write 1 to USBD_INTSTS[23] or USBD_INTSTS[1]. + * |[24] |EPEVT8 |Endpoint 8's USB Event Status + * | | |0 = No event occurred in endpoint 8. + * | | |1 = USB event occurred on Endpoint 8, check USBD_EPSTS1[3 :0] to know which kind of USB event was occurred, cleared by write 1 to USBD_INTSTS[24] or USBD_INTSTS[1]. + * |[25] |EPEVT9 |Endpoint 9's USB Event Status + * | | |0 = No event occurred in endpoint 9. + * | | |1 = USB event occurred on Endpoint 9, check USBD_EPSTS1[7 :4] to know which kind of USB event was occurred, cleared by write 1 to USBD_INTSTS[25] or USBD_INTSTS[1]. + * |[26] |EPEVT10 |Endpoint 10's USB Event Status + * | | |0 = No event occurred in endpoint 10. + * | | |1 = USB event occurred on Endpoint 10, check USBD_EPSTS1[11 :8] to know which kind of USB event was occurred, cleared by write 1 to USBD_INTSTS[26] or USBD_INTSTS[1]. + * |[27] |EPEVT11 |Endpoint 11's USB Event Status + * | | |0 = No event occurred in endpoint 11. + * | | |1 = USB event occurred on Endpoint 11, check USBD_EPSTS1[ 15:12] to know which kind of USB event was occurred, cleared by write 1 to USBD_INTSTS[27] or USBD_INTSTS[1]. + * |[31] |SETUP |Setup Event Status + * | | |0 = No Setup event. + * | | |1 = Setup event occurred, cleared by write 1 to USBD_INTSTS[31]. + * @var USBD_T::FADDR + * Offset: 0x08 USB Device Function Address Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[6:0] |FADDR |USB Device Function Address + * @var USBD_T::EPSTS + * Offset: 0x0C USB Device Endpoint Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7] |OV |Overrun + * | | |It indicates that the received data is over the maximum payload number or not. + * | | |0 = No overrun. + * | | |1 = Out Data is more than the Max Payload in MXPLD register or the Setup Data is more than 8 Bytes. + * @var USBD_T::ATTR + * Offset: 0x10 USB Device Bus Status and Attribution Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |USBRST |USB Reset Status + * | | |0 = Bus no reset. + * | | |1 = Bus reset when SE0 (single-ended 0) more than 2.5us. + * | | |Note: This bit is read only. + * |[1] |SUSPEND |Suspend Status + * | | |0 = Bus no suspend. + * | | |1 = Bus idle more than 3ms, either cable is plugged off or host is sleeping. + * | | |Note: This bit is read only. + * |[2] |RESUME |Resume Status + * | | |0 = No bus resume. + * | | |1 = Resume from suspend. + * | | |Note: This bit is read only. + * |[3] |TOUT |Time-out Status + * | | |0 = No time-out. + * | | |1 = No Bus response more than 18 bits time. + * | | |Note: This bit is read only. + * |[4] |PHYEN |PHY Transceiver Function Enable Bit + * | | |0 = PHY transceiver function Disabled. + * | | |1 = PHY transceiver function Enabled. + * |[5] |RWAKEUP |Remote Wake-up + * | | |0 = Release the USB bus from K state. + * | | |1 = Force USB bus to K (USB_D+ low, USB_D-: high) state, used for remote wake-up. + * |[7] |USBEN |USB Controller Enable Bit + * | | |0 = USB Controller Disabled. + * | | |1 = USB Controller Enabled. + * |[8] |DPPUEN |Pull-up Resistor on USB_DP Enable Bit + * | | |0 = Pull-up resistor in USB_D+ bus Disabled. + * | | |1 = Pull-up resistor in USB_D+ bus Active. + * |[10] |BYTEM |CPU Access USB SRAM Size Mode Selection + * | | |0 = Word mode: The size of the transfer from CPU to USB SRAM can be Word only. + * | | |1 = Byte mode: The size of the transfer from CPU to USB SRAM can be Byte only. + * |[11] |LPMACK |LPM Token Acknowledge Enable Bit + * | | |The NYET/ACK will be returned only on a successful LPM transaction if no errors in both the EXT token and the LPM token and a valid bLinkState = 0001 (L1) is received, else ERROR and STALL will be returned automatically, respectively. + * | | |0= the valid LPM Token will be NYET. + * | | |1= the valid LPM Token will be ACK. + * |[12] |L1SUSPEND |LPM L1 Suspend + * | | |0 = Bus no L1 state suspend. + * | | |1 = This bit is set by the hardware when LPM command to enter the L1 state is successfully received and acknowledged. + * | | |Note: This bit is read only. + * |[13] |L1RESUME |LPM L1 Resume + * | | |0 = Bus no LPM L1 state resume. + * | | |1 = LPM L1 state Resume from LPM L1 state suspend. + * | | |Note: This bit is read only. + * @var USBD_T::VBUSDET + * Offset: 0x14 USB Device VBUS Detection Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |VBUSDET |Device VBUS Detection + * | | |0 = Controller is not attached to the USB host. + * | | |1 = Controller is attached to the USB host. + * @var USBD_T::STBUFSEG + * Offset: 0x18 SETUP Token Buffer Segmentation Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[8:3] |STBUFSEG |SETUP Token Buffer Segmentation + * | | |It is used to indicate the offset address for the SETUP token with the USB Device SRAM starting address The effective starting address is + * | | |USBD_SRAM address + {STBUFSEG, 3'b000} + * | | |Where the USBD_SRAM address = USBD_BA+0x100h. + * | | |Note: It is used for SETUP token only. + * @var USBD_T::EPSTS0 + * Offset: 0x20 USB Device Endpoint Status Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[03:00] |EPSTS0 |Endpoint 0 Status + * | | |These bits are used to indicate the current status of this endpoint + * | | |0000 = In ACK. + * | | |0001 = In NAK. + * | | |0010 = Out Packet Data0 ACK. + * | | |0011 = Setup ACK. + * | | |0110 = Out Packet Data1 ACK. + * | | |0111 = Isochronous transfer end. + * |[07:04] |EPSTS1 |Endpoint 1 Status + * | | |These bits are used to indicate the current status of this endpoint + * | | |0000 = In ACK. + * | | |0001 = In NAK. + * | | |0010 = Out Packet Data0 ACK. + * | | |0011 = Setup ACK. + * | | |0110 = Out Packet Data1 ACK. + * | | |0111 = Isochronous transfer end. + * |[11:08] |EPSTS2 |Endpoint 2 Status + * | | |These bits are used to indicate the current status of this endpoint + * | | |0000 = In ACK. + * | | |0001 = In NAK. + * | | |0010 = Out Packet Data0 ACK. + * | | |0011 = Setup ACK. + * | | |0110 = Out Packet Data1 ACK. + * | | |0111 = Isochronous transfer end. + * |[15:12] |EPSTS3 |Endpoint 3 Status + * | | |These bits are used to indicate the current status of this endpoint + * | | |0000 = In ACK. + * | | |0001 = In NAK. + * | | |0010 = Out Packet Data0 ACK. + * | | |0011 = Setup ACK. + * | | |0110 = Out Packet Data1 ACK. + * | | |0111 = Isochronous transfer end. + * |[19:16] |EPSTS4 |Endpoint 4 Status + * | | |These bits are used to indicate the current status of this endpoint + * | | |0000 = In ACK. + * | | |0001 = In NAK. + * | | |0010 = Out Packet Data0 ACK. + * | | |0011 = Setup ACK. + * | | |0110 = Out Packet Data1 ACK. + * | | |0111 = Isochronous transfer end. + * |[23:20] |EPSTS5 |Endpoint 5 Status + * | | |These bits are used to indicate the current status of this endpoint + * | | |0000 = In ACK. + * | | |0001 = In NAK. + * | | |0010 = Out Packet Data0 ACK. + * | | |0011 = Setup ACK. + * | | |0110 = Out Packet Data1 ACK. + * | | |0111 = Isochronous transfer end. + * |[27:24] |EPSTS6 |Endpoint 6 Status + * | | |These bits are used to indicate the current status of this endpoint + * | | |0000 = In ACK. + * | | |0001 = In NAK. + * | | |0010 = Out Packet Data0 ACK. + * | | |0011 = Setup ACK. + * | | |0110 = Out Packet Data1 ACK. + * | | |0111 = Isochronous transfer end. + * |[31:28] |EPSTS7 |Endpoint 7 Status + * | | |These bits are used to indicate the current status of this endpoint + * | | |0000 = In ACK. + * | | |0001 = In NAK. + * | | |0010 = Out Packet Data0 ACK. + * | | |0011 = Setup ACK. + * | | |0110 = Out Packet Data1 ACK. + * | | |0111 = Isochronous transfer end. + * @var USBD_T::EPSTS1 + * Offset: 0x24 USB Device Endpoint Status Register 1 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |EPSTS8 |Endpoint 8 Status + * | | |These bits are used to indicate the current status of this endpoint + * | | |0000 = In ACK. + * | | |0001 = In NAK. + * | | |0010 = Out Packet Data0 ACK. + * | | |0011 = Setup ACK. + * | | |0110 = Out Packet Data1 ACK. + * | | |0111 = Isochronous transfer end. + * |[7:4] |EPSTS9 |Endpoint 9 Status + * | | |These bits are used to indicate the current status of this endpoint + * | | |0000 = In ACK. + * | | |0001 = In NAK. + * | | |0010 = Out Packet Data0 ACK. + * | | |0011 = Setup ACK. + * | | |0110 = Out Packet Data1 ACK. + * | | |0111 = Isochronous transfer end. + * |[11:8] |EPSTS10 |Endpoint 10 Status + * | | |These bits are used to indicate the current status of this endpoint + * | | |0000 = In ACK. + * | | |0001 = In NAK. + * | | |0010 = Out Packet Data0 ACK. + * | | |0011 = Setup ACK. + * | | |0110 = Out Packet Data1 ACK. + * | | |0111 = Isochronous transfer end. + * |[15:12] |EPSTS11 |Endpoint 11 Status + * | | |These bits are used to indicate the current status of this endpoint + * | | |0000 = In ACK. + * | | |0001 = In NAK. + * | | |0010 = Out Packet Data0 ACK. + * | | |0011 = Setup ACK. + * | | |0110 = Out Packet Data1 ACK. + * | | |0111 = Isochronous transfer end. + * @var USBD_T::LPMATTR + * Offset: 0x88 USB LPM Attribution Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[3:0] |LPMLINKSTS|LPM Link State + * | | |These bits contain the bLinkState received with last ACK LPM Token + * |[7:4] |LPMBESL |LPM Best Effort Service Latency + * | | |These bits contain the BESL value received with last ACK LPM Token + * |[8] |LPMRWAKUP |LPM Remote Wakeup + * | | |This bit contains the bRemoteWake value received with last ACK LPM Token + * @var USBD_T::FN + * Offset: 0x8C USB Frame number Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[10:0] |FN |Frame Number + * | | |These bits contain the 11-bits frame number in the last received SOF packet. + * @var USBD_T::SE0 + * Offset: 0x90 USB Device Drive SE0 Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SE0 |Drive Single Ended Zero in USB Bus + * | | |The Single Ended Zero (SE0) is when both lines (USB_D+ and USB_D-) are being pulled low. + * | | |0 = Normal operation. + * | | |1 = Force USB PHY transceiver to drive SE0. + */ + + __IO uint32_t INTEN; /*!< [0x0000] USB Device Interrupt Enable Register */ + __IO uint32_t INTSTS; /*!< [0x0004] USB Device Interrupt Event Status Register */ + __IO uint32_t FADDR; /*!< [0x0008] USB Device Function Address Register */ + __I uint32_t EPSTS; /*!< [0x000c] USB Device Endpoint Status Register */ + __IO uint32_t ATTR; /*!< [0x0010] USB Device Bus Status and Attribution Register */ + __I uint32_t VBUSDET; /*!< [0x0014] USB Device VBUS Detection Register */ + __IO uint32_t STBUFSEG; /*!< [0x0018] SETUP Token Buffer Segmentation Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[1]; + /// @endcond //HIDDEN_SYMBOLS + __I uint32_t EPSTS0; /*!< [0x0020] USB Device Endpoint Status Register 0 */ + __I uint32_t EPSTS1; /*!< [0x0024] USB Device Endpoint Status Register 1 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE1[24]; + /// @endcond //HIDDEN_SYMBOLS + __I uint32_t LPMATTR; /*!< [0x0088] USB LPM Attribution Register */ + __I uint32_t FN; /*!< [0x008c] USB Frame number Register */ + __IO uint32_t SE0; /*!< [0x0090] USB Device Drive SE0 Control Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE2[283]; + /// @endcond //HIDDEN_SYMBOLS + USBD_EP_T EP[12]; /*!< [0x500~0x5bc] USB End Point 0 ~ 11 Configuration Register */ + +} USBD_T; + + +/** + @addtogroup USBD_CONST USBD Bit Field Definition + Constant Definitions for USBD Controller +@{ */ + +#define USBD_INTEN_BUSIEN_Pos (0) /*!< USBD_T::INTEN: BUSIEN Position */ +#define USBD_INTEN_BUSIEN_Msk (0x1ul << USBD_INTEN_BUSIEN_Pos) /*!< USBD_T::INTEN: BUSIEN Mask */ + +#define USBD_INTEN_USBIEN_Pos (1) /*!< USBD_T::INTEN: USBIEN Position */ +#define USBD_INTEN_USBIEN_Msk (0x1ul << USBD_INTEN_USBIEN_Pos) /*!< USBD_T::INTEN: USBIEN Mask */ + +#define USBD_INTEN_VBDETIEN_Pos (2) /*!< USBD_T::INTEN: VBDETIEN Position */ +#define USBD_INTEN_VBDETIEN_Msk (0x1ul << USBD_INTEN_VBDETIEN_Pos) /*!< USBD_T::INTEN: VBDETIEN Mask */ + +#define USBD_INTEN_NEVWKIEN_Pos (3) /*!< USBD_T::INTEN: NEVWKIEN Position */ +#define USBD_INTEN_NEVWKIEN_Msk (0x1ul << USBD_INTEN_NEVWKIEN_Pos) /*!< USBD_T::INTEN: NEVWKIEN Mask */ + +#define USBD_INTEN_SOFIEN_Pos (4) /*!< USBD_T::INTEN: SOFIEN Position */ +#define USBD_INTEN_SOFIEN_Msk (0x1ul << USBD_INTEN_SOFIEN_Pos) /*!< USBD_T::INTEN: SOFIEN Mask */ + +#define USBD_INTEN_WKEN_Pos (8) /*!< USBD_T::INTEN: WKEN Position */ +#define USBD_INTEN_WKEN_Msk (0x1ul << USBD_INTEN_WKEN_Pos) /*!< USBD_T::INTEN: WKEN Mask */ + +#define USBD_INTEN_INNAKEN_Pos (15) /*!< USBD_T::INTEN: INNAKEN Position */ +#define USBD_INTEN_INNAKEN_Msk (0x1ul << USBD_INTEN_INNAKEN_Pos) /*!< USBD_T::INTEN: INNAKEN Mask */ + +#define USBD_INTSTS_BUSIF_Pos (0) /*!< USBD_T::INTSTS: BUSIF Position */ +#define USBD_INTSTS_BUSIF_Msk (0x1ul << USBD_INTSTS_BUSIF_Pos) /*!< USBD_T::INTSTS: BUSIF Mask */ + +#define USBD_INTSTS_USBIF_Pos (1) /*!< USBD_T::INTSTS: USBIF Position */ +#define USBD_INTSTS_USBIF_Msk (0x1ul << USBD_INTSTS_USBIF_Pos) /*!< USBD_T::INTSTS: USBIF Mask */ + +#define USBD_INTSTS_VBDETIF_Pos (2) /*!< USBD_T::INTSTS: VBDETIF Position */ +#define USBD_INTSTS_VBDETIF_Msk (0x1ul << USBD_INTSTS_VBDETIF_Pos) /*!< USBD_T::INTSTS: VBDETIF Mask */ + +#define USBD_INTSTS_NEVWKIF_Pos (3) /*!< USBD_T::INTSTS: NEVWKIF Position */ +#define USBD_INTSTS_NEVWKIF_Msk (0x1ul << USBD_INTSTS_NEVWKIF_Pos) /*!< USBD_T::INTSTS: NEVWKIF Mask */ + +#define USBD_INTSTS_SOFIF_Pos (4) /*!< USBD_T::INTSTS: SOFIF Position */ +#define USBD_INTSTS_SOFIF_Msk (0x1ul << USBD_INTSTS_SOFIF_Pos) /*!< USBD_T::INTSTS: SOFIF Mask */ + +#define USBD_INTSTS_EPEVT0_Pos (16) /*!< USBD_T::INTSTS: EPEVT0 Position */ +#define USBD_INTSTS_EPEVT0_Msk (0x1ul << USBD_INTSTS_EPEVT0_Pos) /*!< USBD_T::INTSTS: EPEVT0 Mask */ + +#define USBD_INTSTS_EPEVT1_Pos (17) /*!< USBD_T::INTSTS: EPEVT1 Position */ +#define USBD_INTSTS_EPEVT1_Msk (0x1ul << USBD_INTSTS_EPEVT1_Pos) /*!< USBD_T::INTSTS: EPEVT1 Mask */ + +#define USBD_INTSTS_EPEVT2_Pos (18) /*!< USBD_T::INTSTS: EPEVT2 Position */ +#define USBD_INTSTS_EPEVT2_Msk (0x1ul << USBD_INTSTS_EPEVT2_Pos) /*!< USBD_T::INTSTS: EPEVT2 Mask */ + +#define USBD_INTSTS_EPEVT3_Pos (19) /*!< USBD_T::INTSTS: EPEVT3 Position */ +#define USBD_INTSTS_EPEVT3_Msk (0x1ul << USBD_INTSTS_EPEVT3_Pos) /*!< USBD_T::INTSTS: EPEVT3 Mask */ + +#define USBD_INTSTS_EPEVT4_Pos (20) /*!< USBD_T::INTSTS: EPEVT4 Position */ +#define USBD_INTSTS_EPEVT4_Msk (0x1ul << USBD_INTSTS_EPEVT4_Pos) /*!< USBD_T::INTSTS: EPEVT4 Mask */ + +#define USBD_INTSTS_EPEVT5_Pos (21) /*!< USBD_T::INTSTS: EPEVT5 Position */ +#define USBD_INTSTS_EPEVT5_Msk (0x1ul << USBD_INTSTS_EPEVT5_Pos) /*!< USBD_T::INTSTS: EPEVT5 Mask */ + +#define USBD_INTSTS_EPEVT6_Pos (22) /*!< USBD_T::INTSTS: EPEVT6 Position */ +#define USBD_INTSTS_EPEVT6_Msk (0x1ul << USBD_INTSTS_EPEVT6_Pos) /*!< USBD_T::INTSTS: EPEVT6 Mask */ + +#define USBD_INTSTS_EPEVT7_Pos (23) /*!< USBD_T::INTSTS: EPEVT7 Position */ +#define USBD_INTSTS_EPEVT7_Msk (0x1ul << USBD_INTSTS_EPEVT7_Pos) /*!< USBD_T::INTSTS: EPEVT7 Mask */ + +#define USBD_INTSTS_EPEVT8_Pos (24) /*!< USBD_T::INTSTS: EPEVT8 Position */ +#define USBD_INTSTS_EPEVT8_Msk (0x1ul << USBD_INTSTS_EPEVT8_Pos) /*!< USBD_T::INTSTS: EPEVT8 Mask */ + +#define USBD_INTSTS_EPEVT9_Pos (25) /*!< USBD_T::INTSTS: EPEVT9 Position */ +#define USBD_INTSTS_EPEVT9_Msk (0x1ul << USBD_INTSTS_EPEVT9_Pos) /*!< USBD_T::INTSTS: EPEVT9 Mask */ + +#define USBD_INTSTS_EPEVT10_Pos (26) /*!< USBD_T::INTSTS: EPEVT10 Position */ +#define USBD_INTSTS_EPEVT10_Msk (0x1ul << USBD_INTSTS_EPEVT10_Pos) /*!< USBD_T::INTSTS: EPEVT10 Mask */ + +#define USBD_INTSTS_EPEVT11_Pos (27) /*!< USBD_T::INTSTS: EPEVT11 Position */ +#define USBD_INTSTS_EPEVT11_Msk (0x1ul << USBD_INTSTS_EPEVT11_Pos) /*!< USBD_T::INTSTS: EPEVT11 Mask */ + +#define USBD_INTSTS_SETUP_Pos (31) /*!< USBD_T::INTSTS: SETUP Position */ +#define USBD_INTSTS_SETUP_Msk (0x1ul << USBD_INTSTS_SETUP_Pos) /*!< USBD_T::INTSTS: SETUP Mask */ + +#define USBD_FADDR_FADDR_Pos (0) /*!< USBD_T::FADDR: FADDR Position */ +#define USBD_FADDR_FADDR_Msk (0x7ful << USBD_FADDR_FADDR_Pos) /*!< USBD_T::FADDR: FADDR Mask */ + +#define USBD_EPSTS_OV_Pos (7) /*!< USBD_T::EPSTS: OV Position */ +#define USBD_EPSTS_OV_Msk (0x1ul << USBD_EPSTS_OV_Pos) /*!< USBD_T::EPSTS: OV Mask */ + +#define USBD_ATTR_USBRST_Pos (0) /*!< USBD_T::ATTR: USBRST Position */ +#define USBD_ATTR_USBRST_Msk (0x1ul << USBD_ATTR_USBRST_Pos) /*!< USBD_T::ATTR: USBRST Mask */ + +#define USBD_ATTR_SUSPEND_Pos (1) /*!< USBD_T::ATTR: SUSPEND Position */ +#define USBD_ATTR_SUSPEND_Msk (0x1ul << USBD_ATTR_SUSPEND_Pos) /*!< USBD_T::ATTR: SUSPEND Mask */ + +#define USBD_ATTR_RESUME_Pos (2) /*!< USBD_T::ATTR: RESUME Position */ +#define USBD_ATTR_RESUME_Msk (0x1ul << USBD_ATTR_RESUME_Pos) /*!< USBD_T::ATTR: RESUME Mask */ + +#define USBD_ATTR_TOUT_Pos (3) /*!< USBD_T::ATTR: TOUT Position */ +#define USBD_ATTR_TOUT_Msk (0x1ul << USBD_ATTR_TOUT_Pos) /*!< USBD_T::ATTR: TOUT Mask */ + +#define USBD_ATTR_PHYEN_Pos (4) /*!< USBD_T::ATTR: PHYEN Position */ +#define USBD_ATTR_PHYEN_Msk (0x1ul << USBD_ATTR_PHYEN_Pos) /*!< USBD_T::ATTR: PHYEN Mask */ + +#define USBD_ATTR_RWAKEUP_Pos (5) /*!< USBD_T::ATTR: RWAKEUP Position */ +#define USBD_ATTR_RWAKEUP_Msk (0x1ul << USBD_ATTR_RWAKEUP_Pos) /*!< USBD_T::ATTR: RWAKEUP Mask */ + +#define USBD_ATTR_USBEN_Pos (7) /*!< USBD_T::ATTR: USBEN Position */ +#define USBD_ATTR_USBEN_Msk (0x1ul << USBD_ATTR_USBEN_Pos) /*!< USBD_T::ATTR: USBEN Mask */ + +#define USBD_ATTR_DPPUEN_Pos (8) /*!< USBD_T::ATTR: DPPUEN Position */ +#define USBD_ATTR_DPPUEN_Msk (0x1ul << USBD_ATTR_DPPUEN_Pos) /*!< USBD_T::ATTR: DPPUEN Mask */ + +#define USBD_ATTR_BYTEM_Pos (10) /*!< USBD_T::ATTR: BYTEM Position */ +#define USBD_ATTR_BYTEM_Msk (0x1ul << USBD_ATTR_BYTEM_Pos) /*!< USBD_T::ATTR: BYTEM Mask */ + +#define USBD_ATTR_LPMACK_Pos (11) /*!< USBD_T::ATTR: LPMACK Position */ +#define USBD_ATTR_LPMACK_Msk (0x1ul << USBD_ATTR_LPMACK_Pos) /*!< USBD_T::ATTR: LPMACK Mask */ + +#define USBD_ATTR_L1SUSPEND_Pos (12) /*!< USBD_T::ATTR: L1SUSPEND Position */ +#define USBD_ATTR_L1SUSPEND_Msk (0x1ul << USBD_ATTR_L1SUSPEND_Pos) /*!< USBD_T::ATTR: L1SUSPEND Mask */ + +#define USBD_ATTR_L1RESUME_Pos (13) /*!< USBD_T::ATTR: L1RESUME Position */ +#define USBD_ATTR_L1RESUME_Msk (0x1ul << USBD_ATTR_L1RESUME_Pos) /*!< USBD_T::ATTR: L1RESUME Mask */ + +#define USBD_VBUSDET_VBUSDET_Pos (0) /*!< USBD_T::VBUSDET: VBUSDET Position */ +#define USBD_VBUSDET_VBUSDET_Msk (0x1ul << USBD_VBUSDET_VBUSDET_Pos) /*!< USBD_T::VBUSDET: VBUSDET Mask */ + +#define USBD_STBUFSEG_STBUFSEG_Pos (3) /*!< USBD_T::STBUFSEG: STBUFSEG Position */ +#define USBD_STBUFSEG_STBUFSEG_Msk (0x3ful << USBD_STBUFSEG_STBUFSEG_Pos) /*!< USBD_T::STBUFSEG: STBUFSEG Mask */ + +#define USBD_EPSTS0_EPSTS0_Pos (0) /*!< USBD_T::EPSTS0: EPSTS0 Position */ +#define USBD_EPSTS0_EPSTS0_Msk (0xful << USBD_EPSTS0_EPSTS0_Pos) /*!< USBD_T::EPSTS0: EPSTS0 Mask */ + +#define USBD_EPSTS0_EPSTS1_Pos (4) /*!< USBD_T::EPSTS0: EPSTS1 Position */ +#define USBD_EPSTS0_EPSTS1_Msk (0xful << USBD_EPSTS0_EPSTS1_Pos) /*!< USBD_T::EPSTS0: EPSTS1 Mask */ + +#define USBD_EPSTS0_EPSTS2_Pos (8) /*!< USBD_T::EPSTS0: EPSTS2 Position */ +#define USBD_EPSTS0_EPSTS2_Msk (0xful << USBD_EPSTS0_EPSTS2_Pos) /*!< USBD_T::EPSTS0: EPSTS2 Mask */ + +#define USBD_EPSTS0_EPSTS3_Pos (12) /*!< USBD_T::EPSTS0: EPSTS3 Position */ +#define USBD_EPSTS0_EPSTS3_Msk (0xful << USBD_EPSTS0_EPSTS3_Pos) /*!< USBD_T::EPSTS0: EPSTS3 Mask */ + +#define USBD_EPSTS0_EPSTS4_Pos (16) /*!< USBD_T::EPSTS0: EPSTS4 Position */ +#define USBD_EPSTS0_EPSTS4_Msk (0xful << USBD_EPSTS0_EPSTS4_Pos) /*!< USBD_T::EPSTS0: EPSTS4 Mask */ + +#define USBD_EPSTS0_EPSTS5_Pos (20) /*!< USBD_T::EPSTS0: EPSTS5 Position */ +#define USBD_EPSTS0_EPSTS5_Msk (0xful << USBD_EPSTS0_EPSTS5_Pos) /*!< USBD_T::EPSTS0: EPSTS5 Mask */ + +#define USBD_EPSTS0_EPSTS6_Pos (24) /*!< USBD_T::EPSTS0: EPSTS6 Position */ +#define USBD_EPSTS0_EPSTS6_Msk (0xful << USBD_EPSTS0_EPSTS6_Pos) /*!< USBD_T::EPSTS0: EPSTS6 Mask */ + +#define USBD_EPSTS0_EPSTS7_Pos (28) /*!< USBD_T::EPSTS0: EPSTS7 Position */ +#define USBD_EPSTS0_EPSTS7_Msk (0xful << USBD_EPSTS0_EPSTS7_Pos) /*!< USBD_T::EPSTS0: EPSTS7 Mask */ + +#define USBD_EPSTS1_EPSTS8_Pos (0) /*!< USBD_T::EPSTS1: EPSTS8 Position */ +#define USBD_EPSTS1_EPSTS8_Msk (0xful << USBD_EPSTS1_EPSTS8_Pos) /*!< USBD_T::EPSTS1: EPSTS8 Mask */ + +#define USBD_EPSTS1_EPSTS9_Pos (4) /*!< USBD_T::EPSTS1: EPSTS9 Position */ +#define USBD_EPSTS1_EPSTS9_Msk (0xful << USBD_EPSTS1_EPSTS9_Pos) /*!< USBD_T::EPSTS1: EPSTS9 Mask */ + +#define USBD_EPSTS1_EPSTS10_Pos (8) /*!< USBD_T::EPSTS1: EPSTS10 Position */ +#define USBD_EPSTS1_EPSTS10_Msk (0xful << USBD_EPSTS1_EPSTS10_Pos) /*!< USBD_T::EPSTS1: EPSTS10 Mask */ + +#define USBD_EPSTS1_EPSTS11_Pos (12) /*!< USBD_T::EPSTS1: EPSTS11 Position */ +#define USBD_EPSTS1_EPSTS11_Msk (0xful << USBD_EPSTS1_EPSTS11_Pos) /*!< USBD_T::EPSTS1: EPSTS11 Mask */ + +#define USBD_LPMATTR_LPMLINKSTS_Pos (0) /*!< USBD_T::LPMATTR: LPMLINKSTS Position */ +#define USBD_LPMATTR_LPMLINKSTS_Msk (0xful << USBD_LPMATTR_LPMLINKSTS_Pos) /*!< USBD_T::LPMATTR: LPMLINKSTS Mask */ + +#define USBD_LPMATTR_LPMBESL_Pos (4) /*!< USBD_T::LPMATTR: LPMBESL Position */ +#define USBD_LPMATTR_LPMBESL_Msk (0xful << USBD_LPMATTR_LPMBESL_Pos) /*!< USBD_T::LPMATTR: LPMBESL Mask */ + +#define USBD_LPMATTR_LPMRWAKUP_Pos (8) /*!< USBD_T::LPMATTR: LPMRWAKUP Position */ +#define USBD_LPMATTR_LPMRWAKUP_Msk (0x1ul << USBD_LPMATTR_LPMRWAKUP_Pos) /*!< USBD_T::LPMATTR: LPMRWAKUP Mask */ + +#define USBD_FN_FN_Pos (0) /*!< USBD_T::FN: FN Position */ +#define USBD_FN_FN_Msk (0x7fful << USBD_FN_FN_Pos) /*!< USBD_T::FN: FN Mask */ + +#define USBD_SE0_SE0_Pos (0) /*!< USBD_T::SE0: SE0 Position */ +#define USBD_SE0_SE0_Msk (0x1ul << USBD_SE0_SE0_Pos) /*!< USBD_T::SE0: SE0 Mask */ + +#define USBD_BUFSEG_BUFSEG_Pos (3) /*!< USBD_EP_T::BUFSEG: BUFSEG Position */ +#define USBD_BUFSEG_BUFSEG_Msk (0x3ful << USBD_BUFSEG_BUFSEG_Pos) /*!< USBD_EP_T::BUFSEG: BUFSEG Mask */ + +#define USBD_MXPLD_MXPLD_Pos (0) /*!< USBD_EP_T::MXPLD: MXPLD Position */ +#define USBD_MXPLD_MXPLD_Msk (0x1fful << USBD_MXPLD_MXPLD_Pos) /*!< USBD_EP_T::MXPLD: MXPLD Mask */ + +#define USBD_CFG_EPNUM_Pos (0) /*!< USBD_EP_T::CFG: EPNUM Position */ +#define USBD_CFG_EPNUM_Msk (0xful << USBD_CFG_EPNUM_Pos) /*!< USBD_EP_T::CFG: EPNUM Mask */ + +#define USBD_CFG_ISOCH_Pos (4) /*!< USBD_EP_T::CFG: ISOCH Position */ +#define USBD_CFG_ISOCH_Msk (0x1ul << USBD_CFG_ISOCH_Pos) /*!< USBD_EP_T::CFG: ISOCH Mask */ + +#define USBD_CFG_STATE_Pos (5) /*!< USBD_EP_T::CFG: STATE Position */ +#define USBD_CFG_STATE_Msk (0x3ul << USBD_CFG_STATE_Pos) /*!< USBD_EP_T::CFG: STATE Mask */ + +#define USBD_CFG_DSQSYNC_Pos (7) /*!< USBD_EP_T::CFG: DSQSYNC Position */ +#define USBD_CFG_DSQSYNC_Msk (0x1ul << USBD_CFG_DSQSYNC_Pos) /*!< USBD_EP_T::CFG: DSQSYNC Mask */ + +#define USBD_CFG_CSTALL_Pos (9) /*!< USBD_EP_T::CFG: CSTALL Position */ +#define USBD_CFG_CSTALL_Msk (0x1ul << USBD_CFG_CSTALL_Pos) /*!< USBD_EP_T::CFG: CSTALL Mask */ + +#define USBD_CFGP_CLRRDY_Pos (0) /*!< USBD_EP_T::CFGP: CLRRDY Position */ +#define USBD_CFGP_CLRRDY_Msk (0x1ul << USBD_CFGP_CLRRDY_Pos) /*!< USBD_EP_T::CFGP: CLRRDY Mask */ + +#define USBD_CFGP_SSTALL_Pos (1) /*!< USBD_EP_T::CFGP: SSTALL Position */ +#define USBD_CFGP_SSTALL_Msk (0x1ul << USBD_CFGP_SSTALL_Pos) /*!< USBD_EP_T::CFGP: SSTALL Mask */ + +/**@}*/ /* USBD_CONST */ +/**@}*/ /* end of USBD register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __USBD_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/usbh_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/usbh_reg.h new file mode 100644 index 00000000000..01dcffeaf70 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/usbh_reg.h @@ -0,0 +1,797 @@ +/**************************************************************************//** + * @file usbh_reg.h + * @version V1.00 + * @brief USBH register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __USBH_REG_H__ +#define __USBH_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup USBH USB Host Controller(USBH) + Memory Mapped Structure for USBH Controller +@{ */ + +typedef struct +{ + + /** + * @var USBH_T::HcRevision + * Offset: 0x00 Host Controller Revision Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |REV |Revision Number + * | | |Indicates the Open HCI Specification revision number implemented by the Hardware + * | | |Host Controller supports 1.1 specification. + * | | |(X.Y = XYh). + * @var USBH_T::HcControl + * Offset: 0x04 Host Controller Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |CBSR |Control Bulk Service Ratio + * | | |This specifies the service ratio between Control and Bulk EDs + * | | |Before processing any of the non-periodic lists, HC must compare the ratio specified with its internal count on how many nonempty Control EDs have been processed, in determining whether to continue serving another Control ED or switching to Bulk EDs + * | | |The internal count will be retained when crossing the frame boundary + * | | |In case of reset, HCD is responsible for restoring this + * | | |Value. + * | | |00 = Number of Control EDs over Bulk EDs served is 1:1. + * | | |01 = Number of Control EDs over Bulk EDs served is 2:1. + * | | |10 = Number of Control EDs over Bulk EDs served is 3:1. + * | | |11 = Number of Control EDs over Bulk EDs served is 4:1. + * |[2] |PLE |Periodic List Enable Bit + * | | |When set, this bit enables processing of the Periodic (interrupt and isochronous) list + * | | |The Host Controller checks this bit prior to attempting any periodic transfers in a frame. + * | | |0 = Processing of the Periodic (Interrupt and Isochronous) list after next SOF (Start-Of-Frame) Disabled. + * | | |1 = Processing of the Periodic (Interrupt and Isochronous) list in the next frame Enabled. + * | | |Note: To enable the processing of the Isochronous list, user has to set both PLE and IE (HcControl[3]) high. + * |[3] |IE |Isochronous List Enable Bit + * | | |Both ISOEn and PLE (HcControl[2]) high enables Host Controller to process the Isochronous list + * | | |Either ISOEn or PLE (HcControl[2]) is low disables Host Controller to process the Isochronous list. + * | | |0 = Processing of the Isochronous list after next SOF (Start-Of-Frame) Disabled. + * | | |1 = Processing of the Isochronous list in the next frame Enabled, if the PLE (HcControl[2]) is high, too. + * |[4] |CLE |Control List Enable Bit + * | | |0 = Processing of the Control list after next SOF (Start-Of-Frame) Disabled. + * | | |1 = Processing of the Control list in the next frame Enabled. + * |[5] |BLE |Bulk List Enable Bit + * | | |0 = Processing of the Bulk list after next SOF (Start-Of-Frame) Disabled. + * | | |1 = Processing of the Bulk list in the next frame Enabled. + * |[7:6] |HCFS |Host Controller Functional State + * | | |This field sets the Host Controller state + * | | |The Controller may force a state change from USBSUSPEND to USBRESUME after detecting resume signaling from a downstream port + * | | |States are: + * | | |00 = USBSUSPEND. + * | | |01 = USBOPERATIONAL. + * | | |10 = USBRESUME. + * | | |11 = USBRESET. + * @var USBH_T::HcCommandStatus + * Offset: 0x08 Host Controller Command Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |HCR |Host Controller Reset + * | | |This bit is set to initiate the software reset of Host Controller + * | | |This bit is cleared by the Host Controller, upon completed of the reset operation. + * | | |This bit, when set, didn't reset the Root Hub and no subsequent reset signaling be asserted to its downstream ports. + * | | |0 = Host Controller is not in software reset state. + * | | |1 = Host Controller is in software reset state. + * |[1] |CLF |Control List Filled + * | | |Set high to indicate there is an active TD on the Control List + * | | |It may be set by either software or the Host Controller and cleared by the Host Controller each time it begins processing the head of the Control List. + * | | |0 = No active TD found or Host Controller begins to process the head of the Control list. + * | | |1 = An active TD added or found on the Control list. + * |[2] |BLF |Bulk List Filled + * | | |Set high to indicate there is an active TD on the Bulk list + * | | |This bit may be set by either software or the Host Controller and cleared by the Host Controller each time it begins processing the head of the Bulk list. + * | | |0 = No active TD found or Host Controller begins to process the head of the Bulk list. + * | | |1 = An active TD added or found on the Bulk list. + * |[17:16] |SOC |Schedule Overrun Count + * | | |These bits are incremented on each scheduling overrun error + * | | |It is initialized to 00b and wraps around at 11b + * | | |This will be incremented when a scheduling overrun is detected even if SO (HcInterruptStatus[0]) has already been set. + * @var USBH_T::HcInterruptStatus + * Offset: 0x0C Host Controller Interrupt Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SO |Scheduling Overrun + * | | |Set when the List Processor determines a Schedule Overrun has occurred. + * | | |0 = Schedule Overrun didn't occur. + * | | |1 = Schedule Overrun has occurred. + * |[1] |WDH |Write Back Done Head + * | | |Set after the Host Controller has written HcDoneHead to HccaDoneHead + * | | |Further updates of the HccaDoneHead will not occur until this bit has been cleared. + * | | |0 =.Host Controller didn't update HccaDoneHead. + * | | |1 =.Host Controller has written HcDoneHead to HccaDoneHead. + * |[2] |SF |Start of Frame + * | | |Set when the Frame Management functional block signals a 'Start of Frame' event + * | | |Host Control generates a SOF token at the same time. + * | | |0 =.Not the start of a frame. + * | | |1 =.Indicate the start of a frame and Host Controller generates a SOF token. + * |[3] |RD |Resume Detected + * | | |Set when Host Controller detects resume signaling on a downstream port. + * | | |0 = No resume signaling detected on a downstream port. + * | | |1 = Resume signaling detected on a downstream port. + * |[5] |FNO |Frame Number Overflow + * | | |This bit is set when bit 15 of Frame Number changes from 1 to 0 or from 0 to 1. + * | | |0 = The bit 15 of Frame Number didn't change. + * | | |1 = The bit 15 of Frame Number changes from 1 to 0 or from 0 to 1. + * |[6] |RHSC |Root Hub Status Change + * | | |This bit is set when the content of HcRhStatus or the content of HcRhPortStatus register has changed. + * | | |0 = The content of HcRhStatus and the content of HcRhPortStatus register didn't change. + * | | |1 = The content of HcRhStatus or the content of HcRhPortStatus register has changed. + * @var USBH_T::HcInterruptEnable + * Offset: 0x10 Host Controller Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SO |Scheduling Overrun Enable Bit + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Interrupt generation due to SO (HcInterruptStatus[0]) Enabled. + * | | |Read Operation: + * | | |0 = Interrupt generation due to SO (HcInterruptStatus[0]) Disabled. + * | | |1 = Interrupt generation due to SO (HcInterruptStatus[0]) Enabled. + * |[1] |WDH |Write Back Done Head Enable Bit + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Interrupt generation due to WDH (HcInterruptStatus[1]) Enabled. + * | | |Read Operation: + * | | |0 = Interrupt generation due to WDH (HcInterruptStatus[1]) Disabled. + * | | |1 = Interrupt generation due to WDH (HcInterruptStatus[1]) Enabled. + * |[2] |SF |Start of Frame Enable Bit + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Interrupt generation due to SF (HcInterruptStatus[2]) Enabled. + * | | |Read Operation: + * | | |0 = Interrupt generation due to SF (HcInterruptStatus[2]) Disabled. + * | | |1 = Interrupt generation due to SF (HcInterruptStatus[2]) Enabled. + * |[3] |RD |Resume Detected Enable Bit + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Interrupt generation due to RD (HcInterruptStatus[3]) Enabled. + * | | |Read Operation: + * | | |0 = Interrupt generation due to RD (HcInterruptStatus[3]) Disabled. + * | | |1 = Interrupt generation due to RD (HcInterruptStatus[3]) Enabled. + * |[5] |FNO |Frame Number Overflow Enable Bit + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Interrupt generation due to FNO (HcInterruptStatus[5]) Enabled. + * | | |Read Operation: + * | | |0 = Interrupt generation due to FNO (HcInterruptStatus[5]) Disabled. + * | | |1 = Interrupt generation due to FNO (HcInterruptStatus[5]) Enabled. + * |[6] |RHSC |Root Hub Status Change Enable Bit + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Interrupt generation due to RHSC (HcInterruptStatus[6]) Enabled. + * | | |Read Operation: + * | | |0 = Interrupt generation due to RHSC (HcInterruptStatus[6]) Disabled. + * | | |1 = Interrupt generation due to RHSC (HcInterruptStatus[6]) Enabled. + * |[31] |MIE |Master Interrupt Enable Bit + * | | |This bit is a global interrupt enable + * | | |A write of '1' allows interrupts to be enabled via the specific enable bits listed above. + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Interrupt generation due to RHSC (HcInterruptStatus[6]), FNO (HcInterruptStatus[5]), RD (HcInterruptStatus[3]), SF (HcInterruptStatus[2]), WDH (HcInterruptStatus[1]) or SO (HcInterruptStatus[0]) Enabled if the corresponding bit in HcInterruptEnable is high. + * | | |Read Operation: + * | | |0 = Interrupt generation due to RHSC (HcInterruptStatus[6]), FNO (HcInterruptStatus[5]), RD (HcInterruptStatus[3]), SF (HcInterruptStatus[2]), WDH (HcInterruptStatus[1]) or SO (HcInterruptStatus[0]) Disabled even if the corresponding bit in HcInterruptEnable is high. + * | | |1 = Interrupt generation due to RHSC (HcInterruptStatus[6]), FNO (HcInterruptStatus[5]), RD (HcInterruptStatus[3]), SF (HcInterruptStatus[2]), WDH (HcInterruptStatus[1]) or SO (HcInterruptStatus[0]) Enabled if the corresponding bit in HcInterruptEnable is high. + * @var USBH_T::HcInterruptDisable + * Offset: 0x14 Host Controller Interrupt Disable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SO |Scheduling Overrun Disable Bit + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Interrupt generation due to SO (HcInterruptStatus[0]) Disabled. + * | | |Read Operation: + * | | |0 = Interrupt generation due to SO (HcInterruptStatus[0]) Disabled. + * | | |1 = Interrupt generation due to SO (HcInterruptStatus[0]) Enabled. + * |[1] |WDH |Write Back Done Head Disable Bit + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Interrupt generation due to WDH (HcInterruptStatus[1]) Disabled. + * | | |Read Operation: + * | | |0 = Interrupt generation due to WDH (HcInterruptStatus[1]) Disabled. + * | | |1 = Interrupt generation due to WDH (HcInterruptStatus[1]) Enabled. + * |[2] |SF |Start of Frame Disable Bit + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Interrupt generation due to SF (HcInterruptStatus[2]) Disabled. + * | | |Read Operation: + * | | |0 = Interrupt generation due to SF (HcInterruptStatus[2]) Disabled. + * | | |1 = Interrupt generation due to SF (HcInterruptStatus[2]) Enabled. + * |[3] |RD |Resume Detected Disable Bit + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Interrupt generation due to RD (HcInterruptStatus[3]) Disabled. + * | | |Read Operation: + * | | |0 = Interrupt generation due to RD (HcInterruptStatus[3]) Disabled. + * | | |1 = Interrupt generation due to RD (HcInterruptStatus[3]) Enabled. + * |[5] |FNO |Frame Number Overflow Disable Bit + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Interrupt generation due to FNO (HcInterruptStatus[5]) Disabled. + * | | |Read Operation: + * | | |0 = Interrupt generation due to FNO (HcInterruptStatus[5]) Disabled. + * | | |1 = Interrupt generation due to FNO (HcInterruptStatus[5]) Enabled. + * |[6] |RHSC |Root Hub Status Change Disable Bit + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Interrupt generation due to RHSC (HcInterruptStatus[6]) Disabled. + * | | |Read Operation: + * | | |0 = Interrupt generation due to RHSC (HcInterruptStatus[6]) Disabled. + * | | |1 = Interrupt generation due to RHSC (HcInterruptStatus[6]) Enabled. + * |[31] |MIE |Master Interrupt Disable Bit + * | | |Global interrupt disable. Writing '1' to disable all interrupts. + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Interrupt generation due to RHSC (HcInterruptStatus[6]), FNO (HcInterruptStatus[5]), RD (HcInterruptStatus[3]), SF (HcInterruptStatus[2]), WDH (HcInterruptStatus[1]) or SO (HcInterruptStatus[0]) Disabled if the corresponding bit in HcInterruptEnable is high. + * | | |Read Operation: + * | | |0 = Interrupt generation due to RHSC (HcInterruptStatus[6]), FNO (HcInterruptStatus[5]), RD (HcInterruptStatus[3]), SF (HcInterruptStatus[2]), WDH (HcInterruptStatus[1]) or SO (HcInterruptStatus[0]) Disabled even if the corresponding bit in HcInterruptEnable is high. + * | | |1 = Interrupt generation due to RHSC (HcInterruptStatus[6]), FNO (HcInterruptStatus[5]), RD (HcInterruptStatus[3]), SF (HcInterruptStatus[2]), WDH (HcInterruptStatus[1]) or SO (HcInterruptStatus[0]) Enabled if the corresponding bit in HcInterruptEnable is high. + * @var USBH_T::HcHCCA + * Offset: 0x18 Host Controller Communication Area Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:8] |HCCA |Host Controller Communication Area + * | | |Pointer to indicate base address of the Host Controller Communication Area (HCCA). + * @var USBH_T::HcPeriodCurrentED + * Offset: 0x1C Host Controller Period Current ED Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:4] |PCED |Periodic Current ED + * | | |Pointer to indicate physical address of the current Isochronous or Interrupt Endpoint Descriptor. + * @var USBH_T::HcControlHeadED + * Offset: 0x20 Host Controller Control Head ED Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:4] |CHED |Control Head ED + * | | |Pointer to indicate physical address of the first Endpoint Descriptor of the Control list. + * @var USBH_T::HcControlCurrentED + * Offset: 0x24 Host Controller Control Current ED Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:4] |CCED |Control Current Head ED + * | | |Pointer to indicate the physical address of the current Endpoint Descriptor of the Control list. + * @var USBH_T::HcBulkHeadED + * Offset: 0x28 Host Controller Bulk Head ED Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:4] |BHED |Bulk Head ED + * | | |Pointer to indicate the physical address of the first Endpoint Descriptor of the Bulk list. + * @var USBH_T::HcBulkCurrentED + * Offset: 0x2C Host Controller Bulk Current ED Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:4] |BCED |Bulk Current Head ED + * | | |Pointer to indicate the physical address of the current endpoint of the Bulk list. + * @var USBH_T::HcDoneHead + * Offset: 0x30 Host Controller Done Head Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:4] |DH |Done Head + * | | |Pointer to indicate the physical address of the last completed Transfer Descriptor that was added to the Done queue. + * @var USBH_T::HcFmInterval + * Offset: 0x34 Host Controller Frame Interval Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[13:0] |FI |Frame Interval + * | | |This field specifies the length of a frame as (bit times - 1) + * | | |For 12,000 bit times in a frame, a value of 11,999 is stored here. + * |[30:16] |FSMPS |FS Largest Data Packet + * | | |This field specifies a value that is loaded into the Largest Data Packet Counter at the beginning of each frame. + * |[31] |FIT |Frame Interval Toggle + * | | |This bit is toggled by Host Controller Driver when it loads a new value into FI (HcFmInterval[13:0]). + * | | |0 = Host Controller Driver didn't load new value into FI (HcFmInterval[13:0]). + * | | |1 = Host Controller Driver loads a new value into FI (HcFmInterval[13:0]). + * @var USBH_T::HcFmRemaining + * Offset: 0x38 Host Controller Frame Remaining Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[13:0] |FR |Frame Remaining + * | | |When the Host Controller is in the USBOPERATIONAL state, this 14-bit field decrements each 12 MHz clock period + * | | |When the count reaches 0, (end of frame) the counter reloads with Frame Interval + * | | |In addition, the counter loads when the Host Controller transitions into USBOPERATIONAL. + * |[31] |FRT |Frame Remaining Toggle + * | | |This bit is loaded from the FIT (HcFmInterval[31]) whenever FR (HcFmRemaining[13:0]) reaches 0. + * @var USBH_T::HcFmNumber + * Offset: 0x3C Host Controller Frame Number Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |FN |Frame Number + * | | |This 16-bit incrementing counter field is incremented coincident with the re-load of FR (HcFmRemaining[13:0]) + * | | |The count rolls over from 'FFFFh' to '0h.' + * @var USBH_T::HcPeriodicStart + * Offset: 0x40 Host Controller Periodic Start Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[13:0] |PS |Periodic Start + * | | |This field contains a value used by the List Processor to determine where in a frame the Periodic List processing must begin. + * @var USBH_T::HcLSThreshold + * Offset: 0x44 Host Controller Low-speed Threshold Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[11:0] |LST |Low-speed Threshold + * | | |This field contains a value which is compared to the FR (HcFmRemaining[13:0]) field prior to initiating a Low-speed transaction + * | | |The transaction is started only if FR (HcFmRemaining[13:0]) >= this field + * | | |The value is calculated by Host Controller Driver with the consideration of transmission and setup overhead. + * @var USBH_T::HcRhDescriptorA + * Offset: 0x48 Host Controller Root Hub Descriptor A Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7:0] |NDP |Number Downstream Ports + * | | |USB host control supports two downstream ports and only one port is available in this series of chip. + * |[8] |PSM |Power Switching Mode + * | | |This bit is used to specify how the power switching of the Root Hub ports is controlled. + * | | |0 = Global Switching. + * | | |1 = Individual Switching. + * |[11] |OCPM |over Current Protection Mode + * | | |This bit describes how the over current status for the Root Hub ports reported + * | | |This bit is only valid when NOCP (HcRhDescriptorA[12]) is cleared. + * | | |0 = Global Over current. + * | | |1 = Individual Over current. + * |[12] |NOCP |No over Current Protection + * | | |This bit describes how the over current status for the Root Hub ports reported. + * | | |0 = Over current status is reported. + * | | |1 = Over current status is not reported. + * @var USBH_T::HcRhDescriptorB + * Offset: 0x4C Host Controller Root Hub Descriptor B Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:16] |PPCM |Port Power Control Mask + * | | |Global power switching + * | | |This field is only valid if PowerSwitchingMode is set (individual port switching) + * | | |When set, the port only responds to individual port power switching commands (Set/ClearPortPower) + * | | |When cleared, the port only responds to global power switching commands (Set/ClearGlobalPower). + * | | |0 = Port power controlled by global power switching. + * | | |1 = Port power controlled by port power switching. + * | | |Note: PPCM[15:2] and PPCM[0] are reserved. + * @var USBH_T::HcRhStatus + * Offset: 0x50 Host Controller Root Hub Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |LPS |Clear Global Power + * | | |In global power mode (PSM (HcRhDescriptorA[8]) = 0), this bit is written to one to clear all ports' power. + * | | |This bit always read as zero. + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Clear global power. + * |[1] |OCI |over Current Indicator + * | | |This bit reflects the state of the over current status pin + * | | |This field is only valid if NOCP (HcRhDesA[12]) and OCPM (HcRhDesA[11]) are cleared. + * | | |0 = No over current condition. + * | | |1 = Over current condition. + * |[15] |DRWE |Device Remote Wakeup Enable Bit + * | | |This bit controls if port's Connect Status Change as a remote wake-up event. + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Connect Status Change as a remote wake-up event Enabled. + * | | |Read Operation: + * | | |0 = Connect Status Change as a remote wake-up event Disabled. + * | | |1 = Connect Status Change as a remote wake-up event Enabled. + * |[16] |LPSC |Set Global Power + * | | |In global power mode (PSM (HcRhDescriptorA[8]) = 0), this bit is written to one to enable power to all ports. + * | | |This bit always read as zero. + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Set global power. + * |[17] |OCIC |over Current Indicator Change + * | | |This bit is set by hardware when a change has occurred in OCI (HcRhStatus[1]). + * | | |Write 1 to clear this bit to zero. + * | | |0 = OCI (HcRhStatus[1]) didn't change. + * | | |1 = OCI (HcRhStatus[1]) change. + * |[31] |CRWE |Clear Remote Wake-up Enable Bit + * | | |This bit is use to clear DRWE (HcRhStatus[15]). + * | | |This bit always read as zero. + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Clear DRWE (HcRhStatus[15]). + * @var USBH_T::HcRhPortStatus[2] + * Offset: 0x54 Host Controller Root Hub Port Status + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |CCS |CurrentConnectStatus (Read) or ClearPortEnable Bit (Write) + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Clear port enable. + * | | |Read Operation: + * | | |0 = No device connected. + * | | |1 = Device connected. + * |[1] |PES |Port Enable Status + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Set port enable. + * | | |Read Operation: + * | | |0 = Port Disabled. + * | | |1 = Port Enabled. + * |[2] |PSS |Port Suspend Status + * | | |This bit indicates the port is suspended + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Set port suspend. + * | | |Read Operation: + * | | |0 = Port is not suspended. + * | | |1 = Port is selectively suspended. + * |[3] |POCI |Port over Current Indicator (Read) or Clear Port Suspend (Write) + * | | |This bit reflects the state of the over current status pin dedicated to this port + * | | |This field is only valid if NOCP (HcRhDescriptorA[12]) is cleared and OCPM (HcRhDescriptorA[11]) is set. + * | | |This bit is also used to initiate the selective result sequence for the port. + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Clear port suspend. + * | | |Read Operation: + * | | |0 = No over current condition. + * | | |1 = Over current condition. + * |[4] |PRS |Port Reset Status + * | | |This bit reflects the reset state of the port. + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Set port reset. + * | | |Read Operation + * | | |0 = Port reset signal is not active. + * | | |1 = Port reset signal is active. + * |[8] |PPS |Port Power Status + * | | |This bit reflects the power state of the port regardless of the power switching mode. + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Port Power Enabled. + * | | |Read Operation: + * | | |0 = Port power is Disabled. + * | | |1 = Port power is Enabled. + * |[9] |LSDA |Low Speed Device Attached (Read) or Clear Port Power (Write) + * | | |This bit defines the speed (and bud idle) of the attached device + * | | |It is only valid when CCS (HcRhPortStatus1[0]) is set. + * | | |This bit is also used to clear port power. + * | | |Write Operation: + * | | |0 = No effect. + * | | |1 = Clear PPS (HcRhPortStatus1[8]). + * | | |Read Operation: + * | | |0 = Full Speed device. + * | | |1 = Low-speed device. + * |[16] |CSC |Connect Status Change + * | | |This bit indicates connect or disconnect event has been detected (CCS (HcRhPortStatus1[0]) changed). + * | | |Write 1 to clear this bit to zero. + * | | |0 = No connect/disconnect event (CCS (HcRhPortStatus1[0]) didn't change). + * | | |1 = Hardware detection of connect/disconnect event (CCS (HcRhPortStatus1[0]) changed). + * |[17] |PESC |Port Enable Status Change + * | | |This bit indicates that the port has been disabled (PES (HcRhPortStatus1[1]) cleared) due to a hardware event. + * | | |Write 1 to clear this bit to zero. + * | | |0 = PES (HcRhPortStatus1[1]) didn't change. + * | | |1 = PES (HcRhPortStatus1[1]) changed. + * |[18] |PSSC |Port Suspend Status Change + * | | |This bit indicates the completion of the selective resume sequence for the port. + * | | |Write 1 to clear this bit to zero. + * | | |0 = Port resume is not completed. + * | | |1 = Port resume completed. + * |[19] |OCIC |Port over Current Indicator Change + * | | |This bit is set when POCI (HcRhPortStatus1[3]) changes. + * | | |Write 1 to clear this bit to zero. + * | | |0 = POCI (HcRhPortStatus1[3]) didn't change. + * | | |1 = POCI (HcRhPortStatus1[3]) changes. + * |[20] |PRSC |Port Reset Status Change + * | | |This bit indicates that the port reset signal has completed. + * | | |Write 1 to clear this bit to zero. + * | | |0 = Port reset is not complete. + * | | |1 = Port reset is complete. + * @var USBH_T::HcPhyControl + * Offset: 0x200 Host Controller PHY Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[27] |STBYEN |USB Transceiver Standby Enable Bit + * | | |This bit controls if USB transceiver could enter the standby mode to reduce power consumption. + * | | |0 = The USB transceiver would never enter the standby mode. + * | | |1 = The USB transceiver will enter standby mode while port is in power off state (port power is inactive). + * @var USBH_T::HcMiscControl + * Offset: 0x204 Host Controller Miscellaneous Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1] |ABORT |AHB Bus ERROR Response + * | | |This bit indicates there is an ERROR response received in AHB bus. + * | | |0 = No ERROR response received. + * | | |1 = ERROR response received. + * |[3] |OCAL |over Current Active Low + * | | |This bit controls the polarity of over current flag from external power IC. + * | | |0 = Over current flag is high active. + * | | |1 = Over current flag is low active. + * |[16] |DPRT1 |Disable Port 1 + * | | |This bit controls if the connection between USB host controller and transceiver of port 1 is disabled + * | | |If the connection is disabled, the USB host controller will not recognize any event of USB bus. + * | | |Set this bit high, the transceiver of port 1 will also be forced into the standby mode no matter what USB host controller operation is. + * | | |0 = The connection between USB host controller and transceiver of port 1 Enabled. + * | | |1 = The connection between USB host controller and transceiver of port 1 Disabled and the transceiver of port 1 will also be forced into the standby mode. + */ + __I uint32_t HcRevision; /*!< [0x0000] Host Controller Revision Register */ + __IO uint32_t HcControl; /*!< [0x0004] Host Controller Control Register */ + __IO uint32_t HcCommandStatus; /*!< [0x0008] Host Controller Command Status Register */ + __IO uint32_t HcInterruptStatus; /*!< [0x000c] Host Controller Interrupt Status Register */ + __IO uint32_t HcInterruptEnable; /*!< [0x0010] Host Controller Interrupt Enable Register */ + __IO uint32_t HcInterruptDisable; /*!< [0x0014] Host Controller Interrupt Disable Register */ + __IO uint32_t HcHCCA; /*!< [0x0018] Host Controller Communication Area Register */ + __IO uint32_t HcPeriodCurrentED; /*!< [0x001c] Host Controller Period Current ED Register */ + __IO uint32_t HcControlHeadED; /*!< [0x0020] Host Controller Control Head ED Register */ + __IO uint32_t HcControlCurrentED; /*!< [0x0024] Host Controller Control Current ED Register */ + __IO uint32_t HcBulkHeadED; /*!< [0x0028] Host Controller Bulk Head ED Register */ + __IO uint32_t HcBulkCurrentED; /*!< [0x002c] Host Controller Bulk Current ED Register */ + __IO uint32_t HcDoneHead; /*!< [0x0030] Host Controller Done Head Register */ + __IO uint32_t HcFmInterval; /*!< [0x0034] Host Controller Frame Interval Register */ + __I uint32_t HcFmRemaining; /*!< [0x0038] Host Controller Frame Remaining Register */ + __I uint32_t HcFmNumber; /*!< [0x003c] Host Controller Frame Number Register */ + __IO uint32_t HcPeriodicStart; /*!< [0x0040] Host Controller Periodic Start Register */ + __IO uint32_t HcLSThreshold; /*!< [0x0044] Host Controller Low-speed Threshold Register */ + __IO uint32_t HcRhDescriptorA; /*!< [0x0048] Host Controller Root Hub Descriptor A Register */ + __IO uint32_t HcRhDescriptorB; /*!< [0x004c] Host Controller Root Hub Descriptor B Register */ + __IO uint32_t HcRhStatus; /*!< [0x0050] Host Controller Root Hub Status Register */ + __IO uint32_t HcRhPortStatus[2]; /*!< [0x0054] Host Controller Root Hub Port Status [1] */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[105]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t HcPhyControl; /*!< [0x0200] Host Controller PHY Control Register */ + __IO uint32_t HcMiscControl; /*!< [0x0204] Host Controller Miscellaneous Control Register */ + +} USBH_T; + +/** + @addtogroup USBH_CONST USBH Bit Field Definition + Constant Definitions for USBH Controller +@{ */ + +#define USBH_HcRevision_REV_Pos (0) /*!< USBH_T::HcRevision: REV Position */ +#define USBH_HcRevision_REV_Msk (0xfful << USBH_HcRevision_REV_Pos) /*!< USBH_T::HcRevision: REV Mask */ + +#define USBH_HcControl_CBSR_Pos (0) /*!< USBH_T::HcControl: CBSR Position */ +#define USBH_HcControl_CBSR_Msk (0x3ul << USBH_HcControl_CBSR_Pos) /*!< USBH_T::HcControl: CBSR Mask */ + +#define USBH_HcControl_PLE_Pos (2) /*!< USBH_T::HcControl: PLE Position */ +#define USBH_HcControl_PLE_Msk (0x1ul << USBH_HcControl_PLE_Pos) /*!< USBH_T::HcControl: PLE Mask */ + +#define USBH_HcControl_IE_Pos (3) /*!< USBH_T::HcControl: IE Position */ +#define USBH_HcControl_IE_Msk (0x1ul << USBH_HcControl_IE_Pos) /*!< USBH_T::HcControl: IE Mask */ + +#define USBH_HcControl_CLE_Pos (4) /*!< USBH_T::HcControl: CLE Position */ +#define USBH_HcControl_CLE_Msk (0x1ul << USBH_HcControl_CLE_Pos) /*!< USBH_T::HcControl: CLE Mask */ + +#define USBH_HcControl_BLE_Pos (5) /*!< USBH_T::HcControl: BLE Position */ +#define USBH_HcControl_BLE_Msk (0x1ul << USBH_HcControl_BLE_Pos) /*!< USBH_T::HcControl: BLE Mask */ + +#define USBH_HcControl_HCFS_Pos (6) /*!< USBH_T::HcControl: HCFS Position */ +#define USBH_HcControl_HCFS_Msk (0x3ul << USBH_HcControl_HCFS_Pos) /*!< USBH_T::HcControl: HCFS Mask */ + +#define USBH_HcCommandStatus_HCR_Pos (0) /*!< USBH_T::HcCommandStatus: HCR Position */ +#define USBH_HcCommandStatus_HCR_Msk (0x1ul << USBH_HcCommandStatus_HCR_Pos) /*!< USBH_T::HcCommandStatus: HCR Mask */ + +#define USBH_HcCommandStatus_CLF_Pos (1) /*!< USBH_T::HcCommandStatus: CLF Position */ +#define USBH_HcCommandStatus_CLF_Msk (0x1ul << USBH_HcCommandStatus_CLF_Pos) /*!< USBH_T::HcCommandStatus: CLF Mask */ + +#define USBH_HcCommandStatus_BLF_Pos (2) /*!< USBH_T::HcCommandStatus: BLF Position */ +#define USBH_HcCommandStatus_BLF_Msk (0x1ul << USBH_HcCommandStatus_BLF_Pos) /*!< USBH_T::HcCommandStatus: BLF Mask */ + +#define USBH_HcCommandStatus_SOC_Pos (16) /*!< USBH_T::HcCommandStatus: SOC Position */ +#define USBH_HcCommandStatus_SOC_Msk (0x3ul << USBH_HcCommandStatus_SOC_Pos) /*!< USBH_T::HcCommandStatus: SOC Mask */ + +#define USBH_HcInterruptStatus_SO_Pos (0) /*!< USBH_T::HcInterruptStatus: SO Position */ +#define USBH_HcInterruptStatus_SO_Msk (0x1ul << USBH_HcInterruptStatus_SO_Pos) /*!< USBH_T::HcInterruptStatus: SO Mask */ + +#define USBH_HcInterruptStatus_WDH_Pos (1) /*!< USBH_T::HcInterruptStatus: WDH Position*/ +#define USBH_HcInterruptStatus_WDH_Msk (0x1ul << USBH_HcInterruptStatus_WDH_Pos) /*!< USBH_T::HcInterruptStatus: WDH Mask */ + +#define USBH_HcInterruptStatus_SF_Pos (2) /*!< USBH_T::HcInterruptStatus: SF Position */ +#define USBH_HcInterruptStatus_SF_Msk (0x1ul << USBH_HcInterruptStatus_SF_Pos) /*!< USBH_T::HcInterruptStatus: SF Mask */ + +#define USBH_HcInterruptStatus_RD_Pos (3) /*!< USBH_T::HcInterruptStatus: RD Position */ +#define USBH_HcInterruptStatus_RD_Msk (0x1ul << USBH_HcInterruptStatus_RD_Pos) /*!< USBH_T::HcInterruptStatus: RD Mask */ + +#define USBH_HcInterruptStatus_FNO_Pos (5) /*!< USBH_T::HcInterruptStatus: FNO Position*/ +#define USBH_HcInterruptStatus_FNO_Msk (0x1ul << USBH_HcInterruptStatus_FNO_Pos) /*!< USBH_T::HcInterruptStatus: FNO Mask */ + +#define USBH_HcInterruptStatus_RHSC_Pos (6) /*!< USBH_T::HcInterruptStatus: RHSC Position*/ +#define USBH_HcInterruptStatus_RHSC_Msk (0x1ul << USBH_HcInterruptStatus_RHSC_Pos) /*!< USBH_T::HcInterruptStatus: RHSC Mask */ + +#define USBH_HcInterruptEnable_SO_Pos (0) /*!< USBH_T::HcInterruptEnable: SO Position */ +#define USBH_HcInterruptEnable_SO_Msk (0x1ul << USBH_HcInterruptEnable_SO_Pos) /*!< USBH_T::HcInterruptEnable: SO Mask */ + +#define USBH_HcInterruptEnable_WDH_Pos (1) /*!< USBH_T::HcInterruptEnable: WDH Position*/ +#define USBH_HcInterruptEnable_WDH_Msk (0x1ul << USBH_HcInterruptEnable_WDH_Pos) /*!< USBH_T::HcInterruptEnable: WDH Mask */ + +#define USBH_HcInterruptEnable_SF_Pos (2) /*!< USBH_T::HcInterruptEnable: SF Position */ +#define USBH_HcInterruptEnable_SF_Msk (0x1ul << USBH_HcInterruptEnable_SF_Pos) /*!< USBH_T::HcInterruptEnable: SF Mask */ + +#define USBH_HcInterruptEnable_RD_Pos (3) /*!< USBH_T::HcInterruptEnable: RD Position */ +#define USBH_HcInterruptEnable_RD_Msk (0x1ul << USBH_HcInterruptEnable_RD_Pos) /*!< USBH_T::HcInterruptEnable: RD Mask */ + +#define USBH_HcInterruptEnable_FNO_Pos (5) /*!< USBH_T::HcInterruptEnable: FNO Position*/ +#define USBH_HcInterruptEnable_FNO_Msk (0x1ul << USBH_HcInterruptEnable_FNO_Pos) /*!< USBH_T::HcInterruptEnable: FNO Mask */ + +#define USBH_HcInterruptEnable_RHSC_Pos (6) /*!< USBH_T::HcInterruptEnable: RHSC Position*/ +#define USBH_HcInterruptEnable_RHSC_Msk (0x1ul << USBH_HcInterruptEnable_RHSC_Pos) /*!< USBH_T::HcInterruptEnable: RHSC Mask */ + +#define USBH_HcInterruptEnable_MIE_Pos (31) /*!< USBH_T::HcInterruptEnable: MIE Position*/ +#define USBH_HcInterruptEnable_MIE_Msk (0x1ul << USBH_HcInterruptEnable_MIE_Pos) /*!< USBH_T::HcInterruptEnable: MIE Mask */ + +#define USBH_HcInterruptDisable_SO_Pos (0) /*!< USBH_T::HcInterruptDisable: SO Position*/ +#define USBH_HcInterruptDisable_SO_Msk (0x1ul << USBH_HcInterruptDisable_SO_Pos) /*!< USBH_T::HcInterruptDisable: SO Mask */ + +#define USBH_HcInterruptDisable_WDH_Pos (1) /*!< USBH_T::HcInterruptDisable: WDH Position*/ +#define USBH_HcInterruptDisable_WDH_Msk (0x1ul << USBH_HcInterruptDisable_WDH_Pos) /*!< USBH_T::HcInterruptDisable: WDH Mask */ + +#define USBH_HcInterruptDisable_SF_Pos (2) /*!< USBH_T::HcInterruptDisable: SF Position*/ +#define USBH_HcInterruptDisable_SF_Msk (0x1ul << USBH_HcInterruptDisable_SF_Pos) /*!< USBH_T::HcInterruptDisable: SF Mask */ + +#define USBH_HcInterruptDisable_RD_Pos (3) /*!< USBH_T::HcInterruptDisable: RD Position*/ +#define USBH_HcInterruptDisable_RD_Msk (0x1ul << USBH_HcInterruptDisable_RD_Pos) /*!< USBH_T::HcInterruptDisable: RD Mask */ + +#define USBH_HcInterruptDisable_FNO_Pos (5) /*!< USBH_T::HcInterruptDisable: FNO Position*/ +#define USBH_HcInterruptDisable_FNO_Msk (0x1ul << USBH_HcInterruptDisable_FNO_Pos) /*!< USBH_T::HcInterruptDisable: FNO Mask */ + +#define USBH_HcInterruptDisable_RHSC_Pos (6) /*!< USBH_T::HcInterruptDisable: RHSC Position*/ +#define USBH_HcInterruptDisable_RHSC_Msk (0x1ul << USBH_HcInterruptDisable_RHSC_Pos) /*!< USBH_T::HcInterruptDisable: RHSC Mask */ + +#define USBH_HcInterruptDisable_MIE_Pos (31) /*!< USBH_T::HcInterruptDisable: MIE Position*/ +#define USBH_HcInterruptDisable_MIE_Msk (0x1ul << USBH_HcInterruptDisable_MIE_Pos) /*!< USBH_T::HcInterruptDisable: MIE Mask */ + +#define USBH_HcHCCA_HCCA_Pos (8) /*!< USBH_T::HcHCCA: HCCA Position */ +#define USBH_HcHCCA_HCCA_Msk (0xfffffful << USBH_HcHCCA_HCCA_Pos) /*!< USBH_T::HcHCCA: HCCA Mask */ + +#define USBH_HcPeriodCurrentED_PCED_Pos (4) /*!< USBH_T::HcPeriodCurrentED: PCED Position*/ +#define USBH_HcPeriodCurrentED_PCED_Msk (0xffffffful << USBH_HcPeriodCurrentED_PCED_Pos) /*!< USBH_T::HcPeriodCurrentED: PCED Mask */ + +#define USBH_HcControlHeadED_CHED_Pos (4) /*!< USBH_T::HcControlHeadED: CHED Position */ +#define USBH_HcControlHeadED_CHED_Msk (0xffffffful << USBH_HcControlHeadED_CHED_Pos) /*!< USBH_T::HcControlHeadED: CHED Mask */ + +#define USBH_HcControlCurrentED_CCED_Pos (4) /*!< USBH_T::HcControlCurrentED: CCED Position*/ +#define USBH_HcControlCurrentED_CCED_Msk (0xffffffful << USBH_HcControlCurrentED_CCED_Pos) /*!< USBH_T::HcControlCurrentED: CCED Mask */ + +#define USBH_HcBulkHeadED_BHED_Pos (4) /*!< USBH_T::HcBulkHeadED: BHED Position */ +#define USBH_HcBulkHeadED_BHED_Msk (0xffffffful << USBH_HcBulkHeadED_BHED_Pos) /*!< USBH_T::HcBulkHeadED: BHED Mask */ + +#define USBH_HcBulkCurrentED_BCED_Pos (4) /*!< USBH_T::HcBulkCurrentED: BCED Position */ +#define USBH_HcBulkCurrentED_BCED_Msk (0xffffffful << USBH_HcBulkCurrentED_BCED_Pos) /*!< USBH_T::HcBulkCurrentED: BCED Mask */ + +#define USBH_HcDoneHead_DH_Pos (4) /*!< USBH_T::HcDoneHead: DH Position */ +#define USBH_HcDoneHead_DH_Msk (0xffffffful << USBH_HcDoneHead_DH_Pos) /*!< USBH_T::HcDoneHead: DH Mask */ + +#define USBH_HcFmInterval_FI_Pos (0) /*!< USBH_T::HcFmInterval: FI Position */ +#define USBH_HcFmInterval_FI_Msk (0x3ffful << USBH_HcFmInterval_FI_Pos) /*!< USBH_T::HcFmInterval: FI Mask */ + +#define USBH_HcFmInterval_FSMPS_Pos (16) /*!< USBH_T::HcFmInterval: FSMPS Position */ +#define USBH_HcFmInterval_FSMPS_Msk (0x7ffful << USBH_HcFmInterval_FSMPS_Pos) /*!< USBH_T::HcFmInterval: FSMPS Mask */ + +#define USBH_HcFmInterval_FIT_Pos (31) /*!< USBH_T::HcFmInterval: FIT Position */ +#define USBH_HcFmInterval_FIT_Msk (0x1ul << USBH_HcFmInterval_FIT_Pos) /*!< USBH_T::HcFmInterval: FIT Mask */ + +#define USBH_HcFmRemaining_FR_Pos (0) /*!< USBH_T::HcFmRemaining: FR Position */ +#define USBH_HcFmRemaining_FR_Msk (0x3ffful << USBH_HcFmRemaining_FR_Pos) /*!< USBH_T::HcFmRemaining: FR Mask */ + +#define USBH_HcFmRemaining_FRT_Pos (31) /*!< USBH_T::HcFmRemaining: FRT Position */ +#define USBH_HcFmRemaining_FRT_Msk (0x1ul << USBH_HcFmRemaining_FRT_Pos) /*!< USBH_T::HcFmRemaining: FRT Mask */ + +#define USBH_HcFmNumber_FN_Pos (0) /*!< USBH_T::HcFmNumber: FN Position */ +#define USBH_HcFmNumber_FN_Msk (0xfffful << USBH_HcFmNumber_FN_Pos) /*!< USBH_T::HcFmNumber: FN Mask */ + +#define USBH_HcPeriodicStart_PS_Pos (0) /*!< USBH_T::HcPeriodicStart: PS Position */ +#define USBH_HcPeriodicStart_PS_Msk (0x3ffful << USBH_HcPeriodicStart_PS_Pos) /*!< USBH_T::HcPeriodicStart: PS Mask */ + +#define USBH_HcLSThreshold_LST_Pos (0) /*!< USBH_T::HcLSThreshold: LST Position */ +#define USBH_HcLSThreshold_LST_Msk (0xffful << USBH_HcLSThreshold_LST_Pos) /*!< USBH_T::HcLSThreshold: LST Mask */ + +#define USBH_HcRhDescriptorA_NDP_Pos (0) /*!< USBH_T::HcRhDescriptorA: NDP Position */ +#define USBH_HcRhDescriptorA_NDP_Msk (0xfful << USBH_HcRhDescriptorA_NDP_Pos) /*!< USBH_T::HcRhDescriptorA: NDP Mask */ + +#define USBH_HcRhDescriptorA_PSM_Pos (8) /*!< USBH_T::HcRhDescriptorA: PSM Position */ +#define USBH_HcRhDescriptorA_PSM_Msk (0x1ul << USBH_HcRhDescriptorA_PSM_Pos) /*!< USBH_T::HcRhDescriptorA: PSM Mask */ + +#define USBH_HcRhDescriptorA_OCPM_Pos (11) /*!< USBH_T::HcRhDescriptorA: OCPM Position */ +#define USBH_HcRhDescriptorA_OCPM_Msk (0x1ul << USBH_HcRhDescriptorA_OCPM_Pos) /*!< USBH_T::HcRhDescriptorA: OCPM Mask */ + +#define USBH_HcRhDescriptorA_NOCP_Pos (12) /*!< USBH_T::HcRhDescriptorA: NOCP Position */ +#define USBH_HcRhDescriptorA_NOCP_Msk (0x1ul << USBH_HcRhDescriptorA_NOCP_Pos) /*!< USBH_T::HcRhDescriptorA: NOCP Mask */ + +#define USBH_HcRhDescriptorB_PPCM_Pos (16) /*!< USBH_T::HcRhDescriptorB: PPCM Position */ +#define USBH_HcRhDescriptorB_PPCM_Msk (0xfffful << USBH_HcRhDescriptorB_PPCM_Pos) /*!< USBH_T::HcRhDescriptorB: PPCM Mask */ + +#define USBH_HcRhStatus_LPS_Pos (0) /*!< USBH_T::HcRhStatus: LPS Position */ +#define USBH_HcRhStatus_LPS_Msk (0x1ul << USBH_HcRhStatus_LPS_Pos) /*!< USBH_T::HcRhStatus: LPS Mask */ + +#define USBH_HcRhStatus_OCI_Pos (1) /*!< USBH_T::HcRhStatus: OCI Position */ +#define USBH_HcRhStatus_OCI_Msk (0x1ul << USBH_HcRhStatus_OCI_Pos) /*!< USBH_T::HcRhStatus: OCI Mask */ + +#define USBH_HcRhStatus_DRWE_Pos (15) /*!< USBH_T::HcRhStatus: DRWE Position */ +#define USBH_HcRhStatus_DRWE_Msk (0x1ul << USBH_HcRhStatus_DRWE_Pos) /*!< USBH_T::HcRhStatus: DRWE Mask */ + +#define USBH_HcRhStatus_LPSC_Pos (16) /*!< USBH_T::HcRhStatus: LPSC Position */ +#define USBH_HcRhStatus_LPSC_Msk (0x1ul << USBH_HcRhStatus_LPSC_Pos) /*!< USBH_T::HcRhStatus: LPSC Mask */ + +#define USBH_HcRhStatus_OCIC_Pos (17) /*!< USBH_T::HcRhStatus: OCIC Position */ +#define USBH_HcRhStatus_OCIC_Msk (0x1ul << USBH_HcRhStatus_OCIC_Pos) /*!< USBH_T::HcRhStatus: OCIC Mask */ + +#define USBH_HcRhStatus_CRWE_Pos (31) /*!< USBH_T::HcRhStatus: CRWE Position */ +#define USBH_HcRhStatus_CRWE_Msk (0x1ul << USBH_HcRhStatus_CRWE_Pos) /*!< USBH_T::HcRhStatus: CRWE Mask */ + +#define USBH_HcRhPortStatus_CCS_Pos (0) /*!< USBH_T::HcRhPortStatus1: CCS Position */ +#define USBH_HcRhPortStatus_CCS_Msk (0x1ul << USBH_HcRhPortStatus_CCS_Pos) /*!< USBH_T::HcRhPortStatus1: CCS Mask */ + +#define USBH_HcRhPortStatus_PES_Pos (1) /*!< USBH_T::HcRhPortStatus1: PES Position */ +#define USBH_HcRhPortStatus_PES_Msk (0x1ul << USBH_HcRhPortStatus_PES_Pos) /*!< USBH_T::HcRhPortStatus1: PES Mask */ + +#define USBH_HcRhPortStatus_PSS_Pos (2) /*!< USBH_T::HcRhPortStatus1: PSS Position */ +#define USBH_HcRhPortStatus_PSS_Msk (0x1ul << USBH_HcRhPortStatus_PSS_Pos) /*!< USBH_T::HcRhPortStatus1: PSS Mask */ + +#define USBH_HcRhPortStatus_POCI_Pos (3) /*!< USBH_T::HcRhPortStatus1: POCI Position */ +#define USBH_HcRhPortStatus_POCI_Msk (0x1ul << USBH_HcRhPortStatus_POCI_Pos) /*!< USBH_T::HcRhPortStatus1: POCI Mask */ + +#define USBH_HcRhPortStatus_PRS_Pos (4) /*!< USBH_T::HcRhPortStatus1: PRS Position */ +#define USBH_HcRhPortStatus_PRS_Msk (0x1ul << USBH_HcRhPortStatus_PRS_Pos) /*!< USBH_T::HcRhPortStatus1: PRS Mask */ + +#define USBH_HcRhPortStatus_PPS_Pos (8) /*!< USBH_T::HcRhPortStatus1: PPS Position */ +#define USBH_HcRhPortStatus_PPS_Msk (0x1ul << USBH_HcRhPortStatus_PPS_Pos) /*!< USBH_T::HcRhPortStatus1: PPS Mask */ + +#define USBH_HcRhPortStatus_LSDA_Pos (9) /*!< USBH_T::HcRhPortStatus1: LSDA Position */ +#define USBH_HcRhPortStatus_LSDA_Msk (0x1ul << USBH_HcRhPortStatus_LSDA_Pos) /*!< USBH_T::HcRhPortStatus1: LSDA Mask */ + +#define USBH_HcRhPortStatus_CSC_Pos (16) /*!< USBH_T::HcRhPortStatus1: CSC Position */ +#define USBH_HcRhPortStatus_CSC_Msk (0x1ul << USBH_HcRhPortStatus_CSC_Pos) /*!< USBH_T::HcRhPortStatus1: CSC Mask */ + +#define USBH_HcRhPortStatus_PESC_Pos (17) /*!< USBH_T::HcRhPortStatus1: PESC Position */ +#define USBH_HcRhPortStatus_PESC_Msk (0x1ul << USBH_HcRhPortStatus_PESC_Pos) /*!< USBH_T::HcRhPortStatus1: PESC Mask */ + +#define USBH_HcRhPortStatus_PSSC_Pos (18) /*!< USBH_T::HcRhPortStatus1: PSSC Position */ +#define USBH_HcRhPortStatus_PSSC_Msk (0x1ul << USBH_HcRhPortStatus_PSSC_Pos) /*!< USBH_T::HcRhPortStatus1: PSSC Mask */ + +#define USBH_HcRhPortStatus_OCIC_Pos (19) /*!< USBH_T::HcRhPortStatus1: OCIC Position */ +#define USBH_HcRhPortStatus_OCIC_Msk (0x1ul << USBH_HcRhPortStatus_OCIC_Pos) /*!< USBH_T::HcRhPortStatus1: OCIC Mask */ + +#define USBH_HcRhPortStatus_PRSC_Pos (20) /*!< USBH_T::HcRhPortStatus1: PRSC Position */ +#define USBH_HcRhPortStatus_PRSC_Msk (0x1ul << USBH_HcRhPortStatus_PRSC_Pos) /*!< USBH_T::HcRhPortStatus1: PRSC Mask */ + +#define USBH_HcPhyControl_STBYEN_Pos (27) /*!< USBH_T::HcPhyControl: STBYEN Position */ +#define USBH_HcPhyControl_STBYEN_Msk (0x1ul << USBH_HcPhyControl_STBYEN_Pos) /*!< USBH_T::HcPhyControl: STBYEN Mask */ + +#define USBH_HcMiscControl_ABORT_Pos (1) /*!< USBH_T::HcMiscControl: ABORT Position */ +#define USBH_HcMiscControl_ABORT_Msk (0x1ul << USBH_HcMiscControl_ABORT_Pos) /*!< USBH_T::HcMiscControl: ABORT Mask */ + +#define USBH_HcMiscControl_OCAL_Pos (3) /*!< USBH_T::HcMiscControl: OCAL Position */ +#define USBH_HcMiscControl_OCAL_Msk (0x1ul << USBH_HcMiscControl_OCAL_Pos) /*!< USBH_T::HcMiscControl: OCAL Mask */ + +#define USBH_HcMiscControl_DPRT1_Pos (16) /*!< USBH_T::HcMiscControl: DPRT1 Position */ +#define USBH_HcMiscControl_DPRT1_Msk (0x1ul << USBH_HcMiscControl_DPRT1_Pos) /*!< USBH_T::HcMiscControl: DPRT1 Mask */ + +/**@}*/ /* USBH_CONST */ +/**@}*/ /* end of USBH register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __USBH_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/uspi_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/uspi_reg.h new file mode 100644 index 00000000000..d9a2d3077a3 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/uspi_reg.h @@ -0,0 +1,677 @@ +/**************************************************************************//** + * @file uspi_reg.h + * @version V1.00 + * @brief USPI register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __USPI_REG_H__ +#define __USPI_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup USPI SPI Mode of USCI Controller(USPI) + Memory Mapped Structure for USPI Controller +@{ */ + +typedef struct +{ + + + /** + * @var USPI_T::CTL + * Offset: 0x00 USCI Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2:0] |FUNMODE |Function Mode + * | | |This bit field selects the protocol for this USCI controller + * | | |Selecting a protocol that is not available or a reserved combination disables the USCI + * | | |When switching between two protocols, the USCI has to be disabled before selecting a new protocol + * | | |Simultaneously, the USCI will be reset when user write 000 to FUNMODE. + * | | |000 = The USCI is disabled. All protocol related state machines are set to idle state. + * | | |001 = The SPI protocol is selected. + * | | |010 = The UART protocol is selected. + * | | |100 = The I2C protocol is selected. + * | | |Note: Other bit combinations are reserved. + * @var USPI_T::INTEN + * Offset: 0x04 USCI Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1] |TXSTIEN |Transmit Start Interrupt Enable Bit + * | | |This bit enables the interrupt generation in case of a transmit start event. + * | | |0 = The transmit start interrupt is disabled. + * | | |1 = The transmit start interrupt is enabled. + * |[2] |TXENDIEN |Transmit End Interrupt Enable Bit + * | | |This bit enables the interrupt generation in case of a transmit finish event. + * | | |0 = The transmit finish interrupt is disabled. + * | | |1 = The transmit finish interrupt is enabled. + * |[3] |RXSTIEN |Receive Start Interrupt Enable Bit + * | | |This bit enables the interrupt generation in case of a receive start event. + * | | |0 = The receive start interrupt is disabled. + * | | |1 = The receive start interrupt is enabled. + * |[4] |RXENDIEN |Receive End Interrupt Enable Bit + * | | |This bit enables the interrupt generation in case of a receive finish event. + * | | |0 = The receive end interrupt is disabled. + * | | |1 = The receive end interrupt is enabled. + * @var USPI_T::BRGEN + * Offset: 0x08 USCI Baud Rate Generator Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |RCLKSEL |Reference Clock Source Selection + * | | |This bit selects the source of reference clock (fREF_CLK). + * | | |0 = Peripheral device clock fPCLK. + * | | |1 = Reserved. + * |[1] |PTCLKSEL |Protocol Clock Source Selection + * | | |This bit selects the source of protocol clock (fPROT_CLK). + * | | |0 = Reference clock fREF_CLK. + * | | |1 = fREF_CLK2 (its frequency is half of fREF_CLK). + * |[3:2] |SPCLKSEL |Sample Clock Source Selection + * | | |This bit field used for the clock source selection of sample clock (fSAMP_CLK) for the protocol processor. + * | | |00 = fDIV_CLK. + * | | |01 = fPROT_CLK. + * | | |10 = fSCLK. + * | | |11 = fREF_CLK. + * |[4] |TMCNTEN |Time Measurement Counter Enable Bit + * | | |This bit enables the 10-bit timing measurement counter. + * | | |0 = Time measurement counter is Disabled. + * | | |1 = Time measurement counter is Enabled. + * |[5] |TMCNTSRC |Time Measurement Counter Clock Source Selection + * | | |0 = Time measurement counter with fPROT_CLK. + * | | |1 = Time measurement counter with fDIV_CLK. + * |[25:16] |CLKDIV |Clock Divider + * | | |This bit field defines the ratio between the protocol clock frequency fPROT_CLK and the clock divider frequency fDIV_CLK (fDIV_CLK = fPROT_CLK / (CLKDIV+1) ). + * | | |Note: In UART function, it can be updated by hardware in the 4th falling edge of the input data 0x55 when the auto baud rate function (ABREN(USPI_PROTCTL[6])) is enabled + * | | |The revised value is the average bit time between bit 5 and bit 6 + * | | |The user can use revised CLKDIV and new BRDETITV (USPI_PROTCTL[24:16]) to calculate the precise baud rate. + * @var USPI_T::DATIN0 + * Offset: 0x10 USCI Input Data Signal Configuration Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SYNCSEL |Input Signal Synchronization Selection + * | | |This bit selects if the un-synchronized input signal (with optionally inverted) or the synchronized (and optionally filtered) signal can be used as input for the data shift unit. + * | | |0 = The un-synchronized signal can be taken as input for the data shift unit. + * | | |1 = The synchronized signal can be taken as input for the data shift unit. + * | | |Note: In SPI protocol, we suggest this bit should be set as 0. + * |[2] |ININV |Input Signal Inverse Selection + * | | |This bit defines the inverter enable of the input asynchronous signal. + * | | |0 = The un-synchronized input signal will not be inverted. + * | | |1 = The un-synchronized input signal will be inverted. + * | | |Note: In SPI protocol, we suggest this bit should be set as 0. + * @var USPI_T::CTLIN0 + * Offset: 0x20 USCI Input Control Signal Configuration Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SYNCSEL |Input Synchronization Signal Selection + * | | |This bit selects if the un-synchronized input signal (with optionally inverted) or the synchronized (and optionally filtered) signal can be used as input for the data shift unit. + * | | |0 = The un-synchronized signal can be taken as input for the data shift unit. + * | | |1 = The synchronized signal can be taken as input for the data shift unit. + * | | |Note: In SPI protocol, we suggest this bit should be set as 0. + * |[2] |ININV |Input Signal Inverse Selection + * | | |This bit defines the inverter enable of the input asynchronous signal. + * | | |0 = The un-synchronized input signal will not be inverted. + * | | |1 = The un-synchronized input signal will be inverted. + * @var USPI_T::CLKIN + * Offset: 0x28 USCI Input Clock Signal Configuration Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SYNCSEL |Input Synchronization Signal Selection + * | | |This bit selects if the un-synchronized input signal or the synchronized (and optionally filtered) signal can be used as input for the data shift unit. + * | | |0 = The un-synchronized signal can be taken as input for the data shift unit. + * | | |1 = The synchronized signal can be taken as input for the data shift unit. + * | | |Note: In SPI protocol, we suggest this bit should be set as 0. + * @var USPI_T::LINECTL + * Offset: 0x2C USCI Line Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |LSB |LSB First Transmission Selection + * | | |0 = The MSB, which bit of transmit/receive data buffer depends on the setting of DWIDTH, is transmitted/received first. + * | | |1 = The LSB, the bit 0 of data buffer, will be transmitted/received first. + * |[5] |DATOINV |Data Output Inverse Selection + * | | |This bit defines the relation between the internal shift data value and the output data signal of USCIx_DAT0/1 pin. + * | | |0 = Data output level is not inverted. + * | | |1 = Data output level is inverted. + * |[7] |CTLOINV |Control Signal Output Inverse Selection + * | | |This bit defines the relation between the internal control signal and the output control signal. + * | | |0 = No effect. + * | | |1 = The control signal will be inverted before its output. + * | | |Note: The control signal has different definitions in different protocol + * | | |In SPI protocol, the control signal means slave select signal + * |[11:8] |DWIDTH |Word Length of Transmission + * | | |This bit field defines the data word length (amount of bits) for reception and transmission + * | | |The data word is always right-aligned in the data buffer + * | | |USCI support word length from 4 to 16 bits. + * | | |0x0: The data word contains 16 bits located at bit positions [15:0]. + * | | |0x1: Reserved. + * | | |0x2: Reserved. + * | | |0x3: Reserved. + * | | |0x4: The data word contains 4 bits located at bit positions [3:0]. + * | | |0x5: The data word contains 5 bits located at bit positions [4:0]. + * | | |... + * | | |0xF: The data word contains 15 bits located at bit positions [14:0]. + * @var USPI_T::TXDAT + * Offset: 0x30 USCI Transmit Data Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |TXDAT |Transmit Data + * | | |Software can use this bit field to write 16-bit transmit data for transmission + * | | |In order to avoid overwriting the transmit data, user have to check TXEMPTY (USPI_BUFSTS[8]) status before writing transmit data into this bit field. + * |[16] |PORTDIR |Port Direction Control + * | | |This bit field is only available while USCI operates in SPI protocol (FUNMODE = 0x1) with half-duplex transfer + * | | |It is used to define the direction of the data port pin + * | | |When software writes USPI_TXDAT register, the transmit data and its port direction are settled simultaneously. + * | | |0 = The data pin is configured as output mode. + * | | |1 = The data pin is configured as input mode. + * @var USPI_T::RXDAT + * Offset: 0x34 USCI Receive Data Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |RXDAT |Received Data + * | | |This bit field monitors the received data which stored in receive data buffer. + * @var USPI_T::BUFCTL + * Offset: 0x38 USCI Transmit/Receive Buffer Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[6] |TXUDRIEN |Slave Transmit Under Run Interrupt Enable Bit + * | | |0 = Transmit under-run interrupt Disabled. + * | | |1 = Transmit under-run interrupt Enabled. + * |[7] |TXCLR |Clear Transmit Buffer + * | | |0 = No effect. + * | | |1 = The transmit buffer is cleared + * | | |Should only be used while the buffer is not taking part in data traffic. + * | | |Note: It is cleared automatically after one PCLK cycle. + * |[14] |RXOVIEN |Receive Buffer Overrun Interrupt Enable Bit + * | | |0 = Receive overrun interrupt Disabled. + * | | |1 = Receive overrun interrupt Enabled. + * |[15] |RXCLR |Clear Receive Buffer + * | | |0 = No effect. + * | | |1 = The receive buffer is cleared + * | | |Should only be used while the buffer is not taking part in data traffic. + * | | |Note: It is cleared automatically after one PCLK cycle. + * |[16] |TXRST |Transmit Reset + * | | |0 = No effect. + * | | |1 = Reset the transmit-related counters, state machine, and the content of transmit shift register and data buffer. + * | | |Note: It is cleared automatically after one PCLK cycle. + * |[17] |RXRST |Receive Reset + * | | |0 = No effect. + * | | |1 = Reset the receive-related counters, state machine, and the content of receive shift register and data buffer. + * | | |Note: It is cleared automatically after one PCLK cycle. + * @var USPI_T::BUFSTS + * Offset: 0x3C USCI Transmit/Receive Buffer Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |RXEMPTY |Receive Buffer Empty Indicator + * | | |0 = Receive buffer is not empty. + * | | |1 = Receive buffer is empty. + * |[1] |RXFULL |Receive Buffer Full Indicator + * | | |0 = Receive buffer is not full. + * | | |1 = Receive buffer is full. + * |[3] |RXOVIF |Receive Buffer Over-run Interrupt Status + * | | |This bit indicates that a receive buffer overrun event has been detected + * | | |If RXOVIEN (USPI_BUFCTL[14]) is enabled, the corresponding interrupt request is activated + * | | |It is cleared by software writes 1 to this bit. + * | | |0 = A receive buffer overrun event has not been detected. + * | | |1 = A receive buffer overrun event has been detected. + * |[8] |TXEMPTY |Transmit Buffer Empty Indicator + * | | |0 = Transmit buffer is not empty. + * | | |1 = Transmit buffer is empty and available for the next transmission datum. + * |[9] |TXFULL |Transmit Buffer Full Indicator + * | | |0 = Transmit buffer is not full. + * | | |1 = Transmit buffer is full. + * |[11] |TXUDRIF |Transmit Buffer Under-run Interrupt Status + * | | |This bit indicates that a transmit buffer under-run event has been detected + * | | |If enabled by TXUDRIEN (USPI_BUFCTL[6]), the corresponding interrupt request is activated + * | | |It is cleared by software writes 1 to this bit + * | | |0 = A transmit buffer under-run event has not been detected. + * | | |1 = A transmit buffer under-run event has been detected. + * @var USPI_T::PDMACTL + * Offset: 0x40 USCI PDMA Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |PDMARST |PDMA Reset + * | | |0 = No effect. + * | | |1 = Reset the USCI's PDMA control logic. This bit will be cleared to 0 automatically. + * |[1] |TXPDMAEN |PDMA Transmit Channel Available + * | | |0 = Transmit PDMA function Disabled. + * | | |1 = Transmit PDMA function Enabled. + * |[2] |RXPDMAEN |PDMA Receive Channel Available + * | | |0 = Receive PDMA function Disabled. + * | | |1 = Receive PDMA function Enabled. + * |[3] |PDMAEN |PDMA Mode Enable Bit + * | | |0 = PDMA function Disabled. + * | | |1 = PDMA function Enabled. + * | | |Notice: The I2C is not supporting PDMA function. + * @var USPI_T::WKCTL + * Offset: 0x54 USCI Wake-up Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |WKEN |Wake-up Enable Bit + * | | |0 = Wake-up function Disabled. + * | | |1 = Wake-up function Enabled. + * |[1] |WKADDREN |Wake-up Address Match Enable Bit + * | | |0 = The chip is woken up according data toggle. + * | | |1 = The chip is woken up according address match. + * |[2] |PDBOPT |Power Down Blocking Option + * | | |0 = If user attempts to enter Power-down mode by executing WFI while the protocol is in transferring, MCU will stop the transfer and enter Power-down mode immediately. + * | | |1 = If user attempts to enter Power-down mode by executing WFI while the protocol is in transferring, the on-going transfer will not be stopped and MCU will enter idle mode immediately. + * @var USPI_T::WKSTS + * Offset: 0x58 USCI Wake-up Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |WKF |Wake-up Flag + * | | |When chip is woken up from Power-down mode, this bit is set to 1 + * | | |Software can write 1 to clear this bit. + * @var USPI_T::PROTCTL + * Offset: 0x5C USCI Protocol Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SLAVE |Slave Mode Selection + * | | |0 = Master mode. + * | | |1 = Slave mode. + * |[1] |SLV3WIRE |Slave 3-wire Mode Selection (Slave Only) + * | | |The SPI protocol can work with 3-wire interface (without slave select signal) in Slave mode. + * | | |0 = 4-wire bi-direction interface. + * | | |1 = 3-wire bi-direction interface. + * |[2] |SS |Slave Select Control (Master Only) + * | | |If AUTOSS bit is cleared, setting this bit to 1 will set the slave select signal to active state, and setting this bit to 0 will set the slave select signal back to inactive state. + * | | |If the AUTOSS function is enabled (AUTOSS = 1), the setting value of this bit will not affect the current state of slave select signal. + * | | |Note: In SPI protocol, the internal slave select signal is active high. + * |[3] |AUTOSS |Automatic Slave Select Function Enable (Master Only) + * | | |0 = Slave select signal will be controlled by the setting value of SS (USPI_PROTCTL[2]) bit. + * | | |1 = Slave select signal will be generated automatically + * | | |The slave select signal will be asserted by the SPI controller when transmit/receive is started, and will be de-asserted after each transmit/receive is finished. + * |[7:6] |SCLKMODE |Serial Bus Clock Mode + * | | |This bit field defines the SCLK idle status, data transmit, and data receive edge. + * | | |MODE0 = The idle state of SPI clock is low level + * | | |Data is transmitted with falling edge and received with rising edge. + * | | |MODE1 = The idle state of SPI clock is low level + * | | |Data is transmitted with rising edge and received with falling edge. + * | | |MODE2 = The idle state of SPI clock is high level + * | | |Data is transmitted with rising edge and received with falling edge. + * | | |MODE3 = The idle state of SPI clock is high level + * | | |Data is transmitted with falling edge and received with rising edge. + * |[11:8] |SUSPITV |Suspend Interval (Master Only) + * | | |This bit field provides the configurable suspend interval between two successive transmit/receive transaction in a transfer + * | | |The definition of the suspend interval is the interval between the last clock edge of the preceding transaction word and the first clock edge of the following transaction word + * | | |The default value is 0x3 + * | | |The period of the suspend interval is obtained according to the following equation. + * | | |(SUSPITV[3:0] + 0.5) * period of SPI_CLK clock cycle + * | | |Example: + * | | |SUSPITV = 0x0 ... 0.5 SPI_CLK clock cycle. + * | | |SUSPITV = 0x1 ... 1.5 SPI_CLK clock cycle. + * | | |..... + * | | |SUSPITV = 0xE ... 14.5 SPI_CLK clock cycle. + * | | |SUSPITV = 0xF ... 15.5 SPI_CLK clock cycle. + * |[14:12] |TSMSEL |Transmit Data Mode Selection + * | | |This bit field describes how receive and transmit data is shifted in and out. + * | | |TSMSEL = 000b: Full-duplex SPI. + * | | |TSMSEL = 100b: Half-duplex SPI. + * | | |Other values are reserved. + * | | |Note: Changing the value of this bit field will produce the TXRST and RXRST to clear the TX/RX data buffer automatically. + * |[25:16] |SLVTOCNT |Slave Mode Time-out Period (Slave Only) + * | | |In Slave mode, this bit field is used for Slave time-out period + * | | |This bit field indicates how many clock periods (selected by TMCNTSRC, USPI_BRGEN[5]) between the two edges of input SCLK will assert the Slave time-out event + * | | |Writing 0x0 into this bit field will disable the Slave time-out function. + * | | |Example: Assume SLVTOCNT is 0x0A and TMCNTSRC (USPI_BRGEN[5]) is 1, it means the time-out event will occur if the state of SPI bus clock pin is not changed more than (10+1) periods of fDIV_CLK. + * |[28] |TXUDRPOL |Transmit Under-run Data Polarity (for Slave) + * | | |This bit defines the transmitting data level when no data is available for transferring. + * | | |0 = The output data level is 0 if TX under run event occurs. + * | | |1 = The output data level is 1 if TX under run event occurs. + * |[31] |PROTEN |SPI Protocol Enable Bit + * | | |0 = SPI Protocol Disabled. + * | | |1 = SPI Protocol Enabled. + * @var USPI_T::PROTIEN + * Offset: 0x60 USCI Protocol Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SSINAIEN |Slave Select Inactive Interrupt Enable Control + * | | |This bit enables/disables the generation of a slave select interrupt if the slave select changes to inactive. + * | | |0 = Slave select inactive interrupt generation Disabled. + * | | |1 = Slave select inactive interrupt generation Enabled. + * |[1] |SSACTIEN |Slave Select Active Interrupt Enable Control + * | | |This bit enables/disables the generation of a slave select interrupt if the slave select changes to active. + * | | |0 = Slave select active interrupt generation Disabled. + * | | |1 = Slave select active interrupt generation Enabled. + * |[2] |SLVTOIEN |Slave Time-out Interrupt Enable Control + * | | |In SPI protocol, this bit enables the interrupt generation in case of a Slave time-out event. + * | | |0 = The Slave time-out interrupt Disabled. + * | | |1 = The Slave time-out interrupt Enabled. + * |[3] |SLVBEIEN |Slave Mode Bit Count Error Interrupt Enable Control + * | | |If data transfer is terminated by slave time-out or slave select inactive event in Slave mode, so that the transmit/receive data bit count does not match the setting of DWIDTH (USPI_LINECTL[11:8]) + * | | |Bit count error event occurs. + * | | |0 = The Slave mode bit count error interrupt Disabled. + * | | |1 = The Slave mode bit count error interrupt Enabled. + * @var USPI_T::PROTSTS + * Offset: 0x64 USCI Protocol Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1] |TXSTIF |Transmit Start Interrupt Flag + * | | |0 = Transmit start event does not occur. + * | | |1 = Transmit start event occurs. + * | | |Note: It is cleared by software writes 1 to this bit + * |[2] |TXENDIF |Transmit End Interrupt Flag + * | | |0 = Transmit end event does not occur. + * | | |1 = Transmit end event occurs. + * | | |Note: It is cleared by software writes 1 to this bit + * |[3] |RXSTIF |Receive Start Interrupt Flag + * | | |0 = Receive start event does not occur. + * | | |1 = Receive start event occurs. + * | | |Note: It is cleared by software writes 1 to this bit + * |[4] |RXENDIF |Receive End Interrupt Flag + * | | |0 = Receive end event does not occur. + * | | |1 = Receive end event occurs. + * | | |Note: It is cleared by software writes 1 to this bit + * |[5] |SLVTOIF |Slave Time-out Interrupt Flag (for Slave Only) + * | | |0 = Slave time-out event does not occur. + * | | |1 = Slave time-out event occurs. + * | | |Note: It is cleared by software writes 1 to this bit + * |[6] |SLVBEIF |Slave Bit Count Error Interrupt Flag (for Slave Only) + * | | |0 = Slave bit count error event does not occur. + * | | |1 = Slave bit count error event occurs. + * | | |Note: It is cleared by software writes 1 to this bit. + * |[8] |SSINAIF |Slave Select Inactive Interrupt Flag (for Slave Only) + * | | |This bit indicates that the internal slave select signal has changed to inactive + * | | |It is cleared by software writes 1 to this bit + * | | |0 = The slave select signal has not changed to inactive. + * | | |1 = The slave select signal has changed to inactive. + * | | |Note: The internal slave select signal is active high. + * |[9] |SSACTIF |Slave Select Active Interrupt Flag (for Slave Only) + * | | |This bit indicates that the internal slave select signal has changed to active + * | | |It is cleared by software writes one to this bit + * | | |0 = The slave select signal has not changed to active. + * | | |1 = The slave select signal has changed to active. + * | | |Note: The internal slave select signal is active high. + * |[16] |SSLINE |Slave Select Line Bus Status (Read Only) + * | | |This bit is only available in Slave mode + * | | |It used to monitor the current status of the input slave select signal on the bus. + * | | |0 = The slave select line status is 0. + * | | |1 = The slave select line status is 1. + * |[17] |BUSY |Busy Status (Read Only) + * | | |0 = SPI is in idle state. + * | | |1 = SPI is in busy state. + * | | |The following listing are the bus busy conditions: + * | | |a. USPI_PROTCTL[31] = 1 and the TXEMPTY = 0. + * | | |b. For SPI Master mode, the TXEMPTY = 1 but the current transaction is not finished yet. + * | | |c. For SPI Slave mode, the USPI_PROTCTL[31] = 1 and there is serial clock input into the SPI core logic when slave select is active. + * | | |d. For SPI Slave mode, the USPI_PROTCTL[31] = 1 and the transmit buffer or transmit shift register is not empty even if the slave select is inactive. + * |[18] |SLVUDR |Slave Mode Transmit Under-run Status (Read Only) + * | | |In Slave mode, if there is no available transmit data in buffer while transmit data shift out caused by input serial bus clock, this status flag will be set to 1 + * | | |This bit indicates whether the current shift-out data of word transmission is switched to TXUDRPOL (USPI_PROTCTL[28]) or not. + * | | |0 = Slave transmit under-run event does not occur. + * | | |1 = Slave transmit under-run event occurs. + */ + __IO uint32_t CTL; /*!< [0x0000] USCI Control Register */ + __IO uint32_t INTEN; /*!< [0x0004] USCI Interrupt Enable Register */ + __IO uint32_t BRGEN; /*!< [0x0008] USCI Baud Rate Generator Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t DATIN0; /*!< [0x0010] USCI Input Data Signal Configuration Register 0 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE1[3]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t CTLIN0; /*!< [0x0020] USCI Input Control Signal Configuration Register 0 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE2[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t CLKIN; /*!< [0x0028] USCI Input Clock Signal Configuration Register */ + __IO uint32_t LINECTL; /*!< [0x002c] USCI Line Control Register */ + __O uint32_t TXDAT; /*!< [0x0030] USCI Transmit Data Register */ + __I uint32_t RXDAT; /*!< [0x0034] USCI Receive Data Register */ + __IO uint32_t BUFCTL; /*!< [0x0038] USCI Transmit/Receive Buffer Control Register */ + __IO uint32_t BUFSTS; /*!< [0x003c] USCI Transmit/Receive Buffer Status Register */ + __IO uint32_t PDMACTL; /*!< [0x0040] USCI PDMA Control Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE3[4]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t WKCTL; /*!< [0x0054] USCI Wake-up Control Register */ + __IO uint32_t WKSTS; /*!< [0x0058] USCI Wake-up Status Register */ + __IO uint32_t PROTCTL; /*!< [0x005c] USCI Protocol Control Register */ + __IO uint32_t PROTIEN; /*!< [0x0060] USCI Protocol Interrupt Enable Register */ + __IO uint32_t PROTSTS; /*!< [0x0064] USCI Protocol Status Register */ + +} USPI_T; + +/** + @addtogroup USPI_CONST USPI Bit Field Definition + Constant Definitions for USPI Controller +@{ */ + +#define USPI_CTL_FUNMODE_Pos (0) /*!< USPI_T::CTL: FUNMODE Position */ +#define USPI_CTL_FUNMODE_Msk (0x7ul << USPI_CTL_FUNMODE_Pos) /*!< USPI_T::CTL: FUNMODE Mask */ + +#define USPI_INTEN_TXSTIEN_Pos (1) /*!< USPI_T::INTEN: TXSTIEN Position */ +#define USPI_INTEN_TXSTIEN_Msk (0x1ul << USPI_INTEN_TXSTIEN_Pos) /*!< USPI_T::INTEN: TXSTIEN Mask */ + +#define USPI_INTEN_TXENDIEN_Pos (2) /*!< USPI_T::INTEN: TXENDIEN Position */ +#define USPI_INTEN_TXENDIEN_Msk (0x1ul << USPI_INTEN_TXENDIEN_Pos) /*!< USPI_T::INTEN: TXENDIEN Mask */ + +#define USPI_INTEN_RXSTIEN_Pos (3) /*!< USPI_T::INTEN: RXSTIEN Position */ +#define USPI_INTEN_RXSTIEN_Msk (0x1ul << USPI_INTEN_RXSTIEN_Pos) /*!< USPI_T::INTEN: RXSTIEN Mask */ + +#define USPI_INTEN_RXENDIEN_Pos (4) /*!< USPI_T::INTEN: RXENDIEN Position */ +#define USPI_INTEN_RXENDIEN_Msk (0x1ul << USPI_INTEN_RXENDIEN_Pos) /*!< USPI_T::INTEN: RXENDIEN Mask */ + +#define USPI_BRGEN_RCLKSEL_Pos (0) /*!< USPI_T::BRGEN: RCLKSEL Position */ +#define USPI_BRGEN_RCLKSEL_Msk (0x1ul << USPI_BRGEN_RCLKSEL_Pos) /*!< USPI_T::BRGEN: RCLKSEL Mask */ + +#define USPI_BRGEN_PTCLKSEL_Pos (1) /*!< USPI_T::BRGEN: PTCLKSEL Position */ +#define USPI_BRGEN_PTCLKSEL_Msk (0x1ul << USPI_BRGEN_PTCLKSEL_Pos) /*!< USPI_T::BRGEN: PTCLKSEL Mask */ + +#define USPI_BRGEN_SPCLKSEL_Pos (2) /*!< USPI_T::BRGEN: SPCLKSEL Position */ +#define USPI_BRGEN_SPCLKSEL_Msk (0x3ul << USPI_BRGEN_SPCLKSEL_Pos) /*!< USPI_T::BRGEN: SPCLKSEL Mask */ + +#define USPI_BRGEN_TMCNTEN_Pos (4) /*!< USPI_T::BRGEN: TMCNTEN Position */ +#define USPI_BRGEN_TMCNTEN_Msk (0x1ul << USPI_BRGEN_TMCNTEN_Pos) /*!< USPI_T::BRGEN: TMCNTEN Mask */ + +#define USPI_BRGEN_TMCNTSRC_Pos (5) /*!< USPI_T::BRGEN: TMCNTSRC Position */ +#define USPI_BRGEN_TMCNTSRC_Msk (0x1ul << USPI_BRGEN_TMCNTSRC_Pos) /*!< USPI_T::BRGEN: TMCNTSRC Mask */ + +#define USPI_BRGEN_CLKDIV_Pos (16) /*!< USPI_T::BRGEN: CLKDIV Position */ +#define USPI_BRGEN_CLKDIV_Msk (0x3fful << USPI_BRGEN_CLKDIV_Pos) /*!< USPI_T::BRGEN: CLKDIV Mask */ + +#define USPI_DATIN0_SYNCSEL_Pos (0) /*!< USPI_T::DATIN0: SYNCSEL Position */ +#define USPI_DATIN0_SYNCSEL_Msk (0x1ul << USPI_DATIN0_SYNCSEL_Pos) /*!< USPI_T::DATIN0: SYNCSEL Mask */ + +#define USPI_DATIN0_ININV_Pos (2) /*!< USPI_T::DATIN0: ININV Position */ +#define USPI_DATIN0_ININV_Msk (0x1ul << USPI_DATIN0_ININV_Pos) /*!< USPI_T::DATIN0: ININV Mask */ + +#define USPI_CTLIN0_SYNCSEL_Pos (0) /*!< USPI_T::CTLIN0: SYNCSEL Position */ +#define USPI_CTLIN0_SYNCSEL_Msk (0x1ul << USPI_CTLIN0_SYNCSEL_Pos) /*!< USPI_T::CTLIN0: SYNCSEL Mask */ + +#define USPI_CTLIN0_ININV_Pos (2) /*!< USPI_T::CTLIN0: ININV Position */ +#define USPI_CTLIN0_ININV_Msk (0x1ul << USPI_CTLIN0_ININV_Pos) /*!< USPI_T::CTLIN0: ININV Mask */ + +#define USPI_CLKIN_SYNCSEL_Pos (0) /*!< USPI_T::CLKIN: SYNCSEL Position */ +#define USPI_CLKIN_SYNCSEL_Msk (0x1ul << USPI_CLKIN_SYNCSEL_Pos) /*!< USPI_T::CLKIN: SYNCSEL Mask */ + +#define USPI_LINECTL_LSB_Pos (0) /*!< USPI_T::LINECTL: LSB Position */ +#define USPI_LINECTL_LSB_Msk (0x1ul << USPI_LINECTL_LSB_Pos) /*!< USPI_T::LINECTL: LSB Mask */ + +#define USPI_LINECTL_DATOINV_Pos (5) /*!< USPI_T::LINECTL: DATOINV Position */ +#define USPI_LINECTL_DATOINV_Msk (0x1ul << USPI_LINECTL_DATOINV_Pos) /*!< USPI_T::LINECTL: DATOINV Mask */ + +#define USPI_LINECTL_CTLOINV_Pos (7) /*!< USPI_T::LINECTL: CTLOINV Position */ +#define USPI_LINECTL_CTLOINV_Msk (0x1ul << USPI_LINECTL_CTLOINV_Pos) /*!< USPI_T::LINECTL: CTLOINV Mask */ + +#define USPI_LINECTL_DWIDTH_Pos (8) /*!< USPI_T::LINECTL: DWIDTH Position */ +#define USPI_LINECTL_DWIDTH_Msk (0xful << USPI_LINECTL_DWIDTH_Pos) /*!< USPI_T::LINECTL: DWIDTH Mask */ + +#define USPI_TXDAT_TXDAT_Pos (0) /*!< USPI_T::TXDAT: TXDAT Position */ +#define USPI_TXDAT_TXDAT_Msk (0xfffful << USPI_TXDAT_TXDAT_Pos) /*!< USPI_T::TXDAT: TXDAT Mask */ + +#define USPI_TXDAT_PORTDIR_Pos (16) /*!< USPI_T::TXDAT: PORTDIR Position */ +#define USPI_TXDAT_PORTDIR_Msk (0x1ul << USPI_TXDAT_PORTDIR_Pos) /*!< USPI_T::TXDAT: PORTDIR Mask */ + +#define USPI_RXDAT_RXDAT_Pos (0) /*!< USPI_T::RXDAT: RXDAT Position */ +#define USPI_RXDAT_RXDAT_Msk (0xfffful << USPI_RXDAT_RXDAT_Pos) /*!< USPI_T::RXDAT: RXDAT Mask */ + +#define USPI_BUFCTL_TXUDRIEN_Pos (6) /*!< USPI_T::BUFCTL: TXUDRIEN Position */ +#define USPI_BUFCTL_TXUDRIEN_Msk (0x1ul << USPI_BUFCTL_TXUDRIEN_Pos) /*!< USPI_T::BUFCTL: TXUDRIEN Mask */ + +#define USPI_BUFCTL_TXCLR_Pos (7) /*!< USPI_T::BUFCTL: TXCLR Position */ +#define USPI_BUFCTL_TXCLR_Msk (0x1ul << USPI_BUFCTL_TXCLR_Pos) /*!< USPI_T::BUFCTL: TXCLR Mask */ + +#define USPI_BUFCTL_RXOVIEN_Pos (14) /*!< USPI_T::BUFCTL: RXOVIEN Position */ +#define USPI_BUFCTL_RXOVIEN_Msk (0x1ul << USPI_BUFCTL_RXOVIEN_Pos) /*!< USPI_T::BUFCTL: RXOVIEN Mask */ + +#define USPI_BUFCTL_RXCLR_Pos (15) /*!< USPI_T::BUFCTL: RXCLR Position */ +#define USPI_BUFCTL_RXCLR_Msk (0x1ul << USPI_BUFCTL_RXCLR_Pos) /*!< USPI_T::BUFCTL: RXCLR Mask */ + +#define USPI_BUFCTL_TXRST_Pos (16) /*!< USPI_T::BUFCTL: TXRST Position */ +#define USPI_BUFCTL_TXRST_Msk (0x1ul << USPI_BUFCTL_TXRST_Pos) /*!< USPI_T::BUFCTL: TXRST Mask */ + +#define USPI_BUFCTL_RXRST_Pos (17) /*!< USPI_T::BUFCTL: RXRST Position */ +#define USPI_BUFCTL_RXRST_Msk (0x1ul << USPI_BUFCTL_RXRST_Pos) /*!< USPI_T::BUFCTL: RXRST Mask */ + +#define USPI_BUFSTS_RXEMPTY_Pos (0) /*!< USPI_T::BUFSTS: RXEMPTY Position */ +#define USPI_BUFSTS_RXEMPTY_Msk (0x1ul << USPI_BUFSTS_RXEMPTY_Pos) /*!< USPI_T::BUFSTS: RXEMPTY Mask */ + +#define USPI_BUFSTS_RXFULL_Pos (1) /*!< USPI_T::BUFSTS: RXFULL Position */ +#define USPI_BUFSTS_RXFULL_Msk (0x1ul << USPI_BUFSTS_RXFULL_Pos) /*!< USPI_T::BUFSTS: RXFULL Mask */ + +#define USPI_BUFSTS_RXOVIF_Pos (3) /*!< USPI_T::BUFSTS: RXOVIF Position */ +#define USPI_BUFSTS_RXOVIF_Msk (0x1ul << USPI_BUFSTS_RXOVIF_Pos) /*!< USPI_T::BUFSTS: RXOVIF Mask */ + +#define USPI_BUFSTS_TXEMPTY_Pos (8) /*!< USPI_T::BUFSTS: TXEMPTY Position */ +#define USPI_BUFSTS_TXEMPTY_Msk (0x1ul << USPI_BUFSTS_TXEMPTY_Pos) /*!< USPI_T::BUFSTS: TXEMPTY Mask */ + +#define USPI_BUFSTS_TXFULL_Pos (9) /*!< USPI_T::BUFSTS: TXFULL Position */ +#define USPI_BUFSTS_TXFULL_Msk (0x1ul << USPI_BUFSTS_TXFULL_Pos) /*!< USPI_T::BUFSTS: TXFULL Mask */ + +#define USPI_BUFSTS_TXUDRIF_Pos (11) /*!< USPI_T::BUFSTS: TXUDRIF Position */ +#define USPI_BUFSTS_TXUDRIF_Msk (0x1ul << USPI_BUFSTS_TXUDRIF_Pos) /*!< USPI_T::BUFSTS: TXUDRIF Mask */ + +#define USPI_PDMACTL_PDMARST_Pos (0) /*!< USPI_T::PDMACTL: PDMARST Position */ +#define USPI_PDMACTL_PDMARST_Msk (0x1ul << USPI_PDMACTL_PDMARST_Pos) /*!< USPI_T::PDMACTL: PDMARST Mask */ + +#define USPI_PDMACTL_TXPDMAEN_Pos (1) /*!< USPI_T::PDMACTL: TXPDMAEN Position */ +#define USPI_PDMACTL_TXPDMAEN_Msk (0x1ul << USPI_PDMACTL_TXPDMAEN_Pos) /*!< USPI_T::PDMACTL: TXPDMAEN Mask */ + +#define USPI_PDMACTL_RXPDMAEN_Pos (2) /*!< USPI_T::PDMACTL: RXPDMAEN Position */ +#define USPI_PDMACTL_RXPDMAEN_Msk (0x1ul << USPI_PDMACTL_RXPDMAEN_Pos) /*!< USPI_T::PDMACTL: RXPDMAEN Mask */ + +#define USPI_PDMACTL_PDMAEN_Pos (3) /*!< USPI_T::PDMACTL: PDMAEN Position */ +#define USPI_PDMACTL_PDMAEN_Msk (0x1ul << USPI_PDMACTL_PDMAEN_Pos) /*!< USPI_T::PDMACTL: PDMAEN Mask */ + +#define USPI_WKCTL_WKEN_Pos (0) /*!< USPI_T::WKCTL: WKEN Position */ +#define USPI_WKCTL_WKEN_Msk (0x1ul << USPI_WKCTL_WKEN_Pos) /*!< USPI_T::WKCTL: WKEN Mask */ + +#define USPI_WKCTL_WKADDREN_Pos (1) /*!< USPI_T::WKCTL: WKADDREN Position */ +#define USPI_WKCTL_WKADDREN_Msk (0x1ul << USPI_WKCTL_WKADDREN_Pos) /*!< USPI_T::WKCTL: WKADDREN Mask */ + +#define USPI_WKCTL_PDBOPT_Pos (2) /*!< USPI_T::WKCTL: PDBOPT Position */ +#define USPI_WKCTL_PDBOPT_Msk (0x1ul << USPI_WKCTL_PDBOPT_Pos) /*!< USPI_T::WKCTL: PDBOPT Mask */ + +#define USPI_WKSTS_WKF_Pos (0) /*!< USPI_T::WKSTS: WKF Position */ +#define USPI_WKSTS_WKF_Msk (0x1ul << USPI_WKSTS_WKF_Pos) /*!< USPI_T::WKSTS: WKF Mask */ + +#define USPI_PROTCTL_SLAVE_Pos (0) /*!< USPI_T::PROTCTL: SLAVE Position */ +#define USPI_PROTCTL_SLAVE_Msk (0x1ul << USPI_PROTCTL_SLAVE_Pos) /*!< USPI_T::PROTCTL: SLAVE Mask */ + +#define USPI_PROTCTL_SLV3WIRE_Pos (1) /*!< USPI_T::PROTCTL: SLV3WIRE Position */ +#define USPI_PROTCTL_SLV3WIRE_Msk (0x1ul << USPI_PROTCTL_SLV3WIRE_Pos) /*!< USPI_T::PROTCTL: SLV3WIRE Mask */ + +#define USPI_PROTCTL_SS_Pos (2) /*!< USPI_T::PROTCTL: SS Position */ +#define USPI_PROTCTL_SS_Msk (0x1ul << USPI_PROTCTL_SS_Pos) /*!< USPI_T::PROTCTL: SS Mask */ + +#define USPI_PROTCTL_AUTOSS_Pos (3) /*!< USPI_T::PROTCTL: AUTOSS Position */ +#define USPI_PROTCTL_AUTOSS_Msk (0x1ul << USPI_PROTCTL_AUTOSS_Pos) /*!< USPI_T::PROTCTL: AUTOSS Mask */ + +#define USPI_PROTCTL_SCLKMODE_Pos (6) /*!< USPI_T::PROTCTL: SCLKMODE Position */ +#define USPI_PROTCTL_SCLKMODE_Msk (0x3ul << USPI_PROTCTL_SCLKMODE_Pos) /*!< USPI_T::PROTCTL: SCLKMODE Mask */ + +#define USPI_PROTCTL_SUSPITV_Pos (8) /*!< USPI_T::PROTCTL: SUSPITV Position */ +#define USPI_PROTCTL_SUSPITV_Msk (0xful << USPI_PROTCTL_SUSPITV_Pos) /*!< USPI_T::PROTCTL: SUSPITV Mask */ + +#define USPI_PROTCTL_TSMSEL_Pos (12) /*!< USPI_T::PROTCTL: TSMSEL Position */ +#define USPI_PROTCTL_TSMSEL_Msk (0x7ul << USPI_PROTCTL_TSMSEL_Pos) /*!< USPI_T::PROTCTL: TSMSEL Mask */ + +#define USPI_PROTCTL_SLVTOCNT_Pos (16) /*!< USPI_T::PROTCTL: SLVTOCNT Position */ +#define USPI_PROTCTL_SLVTOCNT_Msk (0x3fful << USPI_PROTCTL_SLVTOCNT_Pos) /*!< USPI_T::PROTCTL: SLVTOCNT Mask */ + +#define USPI_PROTCTL_TXUDRPOL_Pos (28) /*!< USPI_T::PROTCTL: TXUDRPOL Position */ +#define USPI_PROTCTL_TXUDRPOL_Msk (0x1ul << USPI_PROTCTL_TXUDRPOL_Pos) /*!< USPI_T::PROTCTL: TXUDRPOL Mask */ + +#define USPI_PROTCTL_PROTEN_Pos (31) /*!< USPI_T::PROTCTL: PROTEN Position */ +#define USPI_PROTCTL_PROTEN_Msk (0x1ul << USPI_PROTCTL_PROTEN_Pos) /*!< USPI_T::PROTCTL: PROTEN Mask */ + +#define USPI_PROTIEN_SSINAIEN_Pos (0) /*!< USPI_T::PROTIEN: SSINAIEN Position */ +#define USPI_PROTIEN_SSINAIEN_Msk (0x1ul << USPI_PROTIEN_SSINAIEN_Pos) /*!< USPI_T::PROTIEN: SSINAIEN Mask */ + +#define USPI_PROTIEN_SSACTIEN_Pos (1) /*!< USPI_T::PROTIEN: SSACTIEN Position */ +#define USPI_PROTIEN_SSACTIEN_Msk (0x1ul << USPI_PROTIEN_SSACTIEN_Pos) /*!< USPI_T::PROTIEN: SSACTIEN Mask */ + +#define USPI_PROTIEN_SLVTOIEN_Pos (2) /*!< USPI_T::PROTIEN: SLVTOIEN Position */ +#define USPI_PROTIEN_SLVTOIEN_Msk (0x1ul << USPI_PROTIEN_SLVTOIEN_Pos) /*!< USPI_T::PROTIEN: SLVTOIEN Mask */ + +#define USPI_PROTIEN_SLVBEIEN_Pos (3) /*!< USPI_T::PROTIEN: SLVBEIEN Position */ +#define USPI_PROTIEN_SLVBEIEN_Msk (0x1ul << USPI_PROTIEN_SLVBEIEN_Pos) /*!< USPI_T::PROTIEN: SLVBEIEN Mask */ + +#define USPI_PROTSTS_TXSTIF_Pos (1) /*!< USPI_T::PROTSTS: TXSTIF Position */ +#define USPI_PROTSTS_TXSTIF_Msk (0x1ul << USPI_PROTSTS_TXSTIF_Pos) /*!< USPI_T::PROTSTS: TXSTIF Mask */ + +#define USPI_PROTSTS_TXENDIF_Pos (2) /*!< USPI_T::PROTSTS: TXENDIF Position */ +#define USPI_PROTSTS_TXENDIF_Msk (0x1ul << USPI_PROTSTS_TXENDIF_Pos) /*!< USPI_T::PROTSTS: TXENDIF Mask */ + +#define USPI_PROTSTS_RXSTIF_Pos (3) /*!< USPI_T::PROTSTS: RXSTIF Position */ +#define USPI_PROTSTS_RXSTIF_Msk (0x1ul << USPI_PROTSTS_RXSTIF_Pos) /*!< USPI_T::PROTSTS: RXSTIF Mask */ + +#define USPI_PROTSTS_RXENDIF_Pos (4) /*!< USPI_T::PROTSTS: RXENDIF Position */ +#define USPI_PROTSTS_RXENDIF_Msk (0x1ul << USPI_PROTSTS_RXENDIF_Pos) /*!< USPI_T::PROTSTS: RXENDIF Mask */ + +#define USPI_PROTSTS_SLVTOIF_Pos (5) /*!< USPI_T::PROTSTS: SLVTOIF Position */ +#define USPI_PROTSTS_SLVTOIF_Msk (0x1ul << USPI_PROTSTS_SLVTOIF_Pos) /*!< USPI_T::PROTSTS: SLVTOIF Mask */ + +#define USPI_PROTSTS_SLVBEIF_Pos (6) /*!< USPI_T::PROTSTS: SLVBEIF Position */ +#define USPI_PROTSTS_SLVBEIF_Msk (0x1ul << USPI_PROTSTS_SLVBEIF_Pos) /*!< USPI_T::PROTSTS: SLVBEIF Mask */ + +#define USPI_PROTSTS_SSINAIF_Pos (8) /*!< USPI_T::PROTSTS: SSINAIF Position */ +#define USPI_PROTSTS_SSINAIF_Msk (0x1ul << USPI_PROTSTS_SSINAIF_Pos) /*!< USPI_T::PROTSTS: SSINAIF Mask */ + +#define USPI_PROTSTS_SSACTIF_Pos (9) /*!< USPI_T::PROTSTS: SSACTIF Position */ +#define USPI_PROTSTS_SSACTIF_Msk (0x1ul << USPI_PROTSTS_SSACTIF_Pos) /*!< USPI_T::PROTSTS: SSACTIF Mask */ + +#define USPI_PROTSTS_SSLINE_Pos (16) /*!< USPI_T::PROTSTS: SSLINE Position */ +#define USPI_PROTSTS_SSLINE_Msk (0x1ul << USPI_PROTSTS_SSLINE_Pos) /*!< USPI_T::PROTSTS: SSLINE Mask */ + +#define USPI_PROTSTS_BUSY_Pos (17) /*!< USPI_T::PROTSTS: BUSY Position */ +#define USPI_PROTSTS_BUSY_Msk (0x1ul << USPI_PROTSTS_BUSY_Pos) /*!< USPI_T::PROTSTS: BUSY Mask */ + +#define USPI_PROTSTS_SLVUDR_Pos (18) /*!< USPI_T::PROTSTS: SLVUDR Position */ +#define USPI_PROTSTS_SLVUDR_Msk (0x1ul << USPI_PROTSTS_SLVUDR_Pos) /*!< USPI_T::PROTSTS: SLVUDR Mask */ + +/**@}*/ /* USPI_CONST */ +/**@}*/ /* end of USPI register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __USPI_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/uuart_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/uuart_reg.h new file mode 100644 index 00000000000..3ebce1d6f31 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/uuart_reg.h @@ -0,0 +1,679 @@ +/**************************************************************************//** + * @file uuart_reg.h + * @version V1.00 + * @brief UUART register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __UUART_REG_H__ +#define __UUART_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup UUART UART Mode of USCI Controller(UUART) + Memory Mapped Structure for UUART Controller +@{ */ + +typedef struct +{ + + + /** + * @var UUART_T::CTL + * Offset: 0x00 USCI Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[2:0] |FUNMODE |Function Mode + * | | |This bit field selects the protocol for this USCI controller + * | | |Selecting a protocol that is not available or a reserved combination disables the USCI + * | | |When switching between two protocols, the USCI has to be disabled before selecting a new protocol + * | | |Simultaneously, the USCI will be reset when user write 000 to FUNMODE. + * | | |000 = The USCI is disabled. All protocol related state machines are set to idle state. + * | | |001 = The SPI protocol is selected. + * | | |010 = The UART protocol is selected. + * | | |100 = The I2C protocol is selected. + * | | |Note: Other bit combinations are reserved. + * @var UUART_T::INTEN + * Offset: 0x04 USCI Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1] |TXSTIEN |Transmit Start Interrupt Enable Bit + * | | |This bit enables the interrupt generation in case of a transmit start event. + * | | |0 = The transmit start interrupt is disabled. + * | | |1 = The transmit start interrupt is enabled. + * |[2] |TXENDIEN |Transmit End Interrupt Enable Bit + * | | |This bit enables the interrupt generation in case of a transmit finish event. + * | | |0 = The transmit finish interrupt is disabled. + * | | |1 = The transmit finish interrupt is enabled. + * |[3] |RXSTIEN |Receive Start Interrupt Enable BIt + * | | |This bit enables the interrupt generation in case of a receive start event. + * | | |0 = The receive start interrupt is disabled. + * | | |1 = The receive start interrupt is enabled. + * |[4] |RXENDIEN |Receive End Interrupt Enable Bit + * | | |This bit enables the interrupt generation in case of a receive finish event. + * | | |0 = The receive end interrupt is disabled. + * | | |1 = The receive end interrupt is enabled. + * @var UUART_T::BRGEN + * Offset: 0x08 USCI Baud Rate Generator Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |RCLKSEL |Reference Clock Source Selection + * | | |This bit selects the source signal of reference clock (fREF_CLK). + * | | |0 = Peripheral device clock fPCLK. + * | | |1 = Reserved. + * |[1] |PTCLKSEL |Protocol Clock Source Selection + * | | |This bit selects the source signal of protocol clock (fPROT_CLK). + * | | |0 = Reference clock fREF_CLK. + * | | |1 = fREF_CLK2 (its frequency is half of fREF_CLK). + * |[3:2] |SPCLKSEL |Sample Clock Source Selection + * | | |This bit field used for the clock source selection of a sample clock (fSAMP_CLK) for the protocol processor. + * | | |00 = fSAMP_CLK = fDIV_CLK. + * | | |01 = fSAMP_CLK = fPROT_CLK. + * | | |10 = fSAMP_CLK = fSCLK. + * | | |11 = fSAMP_CLK = fREF_CLK. + * |[4] |TMCNTEN |Timing Measurement Counter Enable Bit + * | | |This bit enables the 10-bit timing measurement counter. + * | | |0 = Timing measurement counter is Disabled. + * | | |1 = Timing measurement counter is Enabled. + * |[5] |TMCNTSRC |Timing Measurement Counter Clock Source Selection + * | | |0 = Timing measurement counter with fPROT_CLK. + * | | |1 = Timing measurement counter with fDIV_CLK. + * |[9:8] |PDSCNT |Pre-divider for Sample Counter + * | | |This bit field defines the divide ratio of the clock division from sample clock fSAMP_CLK + * | | |The divided frequency fPDS_CNT = fSAMP_CLK / (PDSCNT+1). + * |[14:10] |DSCNT |Denominator for Sample Counter + * | | |This bit field defines the divide ratio of the sample clock fSAMP_CLK. + * | | |The divided frequency fDS_CNT = fPDS_CNT / (DSCNT+1). + * | | |Note: The maximum value of DSCNT is 0xF on UART mode and suggest to set over 4 to confirm the receiver data is sampled in right value + * |[25:16] |CLKDIV |Clock Divider + * | | |This bit field defines the ratio between the protocol clock frequency fPROT_CLK and + * | | |the clock divider frequency fDIV_CLK (fDIV_CLK = fPROT_CLK / (CLKDIV+1) ). + * | | |Note: In UART function, it can be updated by hardware in the 4th falling edge of the input data 0x55 + * | | |when the auto baud rate function (ABREN(USCI_PROTCTL[6])) is enabled + * | | |The revised value is the average bit time between bit 5 and bit 6 + * | | |The user can use revised CLKDIV and new BRDETITV (USCI_PROTCTL[24:16]) to calculate the precise baud rate. + * @var UUART_T::DATIN0 + * Offset: 0x10 USCI Input Data Signal Configuration Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SYNCSEL |Input Signal Synchronization Selection + * | | |This bit selects if the un-synchronized input signal (with optionally inverted) or + * | | |the synchronized (and optionally filtered) signal can be used as input for the data shift unit. + * | | |0 = The un-synchronized signal can be taken as input for the data shift unit. + * | | |1 = The synchronized signal can be taken as input for the data shift unit. + * |[2] |ININV |Input Signal Inverse Selection + * | | |This bit defines the inverter enable of the input asynchronous signal. + * | | |0 = The un-synchronized input signal will not be inverted. + * | | |1 = The un-synchronized input signal will be inverted. + * |[4:3] |EDGEDET |Input Signal Edge Detection Mode + * | | |This bit field selects which edge actives the trigger event of input data signal. + * | | |00 = The trigger event activation is disabled. + * | | |01 = A rising edge activates the trigger event of input data signal. + * | | |10 = A falling edge activates the trigger event of input data signal. + * | | |11 = Both edges activate the trigger event of input data signal. + * | | |Note: In UART function mode, it is suggested to set this bit field as 10. + * @var UUART_T::CTLIN0 + * Offset: 0x20 USCI Input Control Signal Configuration Register 0 + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SYNCSEL |Input Synchronization Signal Selection + * | | |This bit selects if the un-synchronized input signal (with optionally inverted) or + * | | |the synchronized (and optionally filtered) signal can be used as input for the data shift unit. + * | | |0 = The un-synchronized signal can be taken as input for the data shift unit. + * | | |1 = The synchronized signal can be taken as input for the data shift unit. + * |[2] |ININV |Input Signal Inverse Selection + * | | |This bit defines the inverter enable of the input asynchronous signal. + * | | |0 = The un-synchronized input signal will not be inverted. + * | | |1 = The un-synchronized input signal will be inverted. + * @var UUART_T::CLKIN + * Offset: 0x28 USCI Input Clock Signal Configuration Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |SYNCSEL |Input Synchronization Signal Selection + * | | |This bit selects if the un-synchronized input signal or + * | | |the synchronized (and optionally filtered) signal can be used as input for the data shift unit. + * | | |0 = The un-synchronized signal can be taken as input for the data shift unit. + * | | |1 = The synchronized signal can be taken as input for the data shift unit. + * @var UUART_T::LINECTL + * Offset: 0x2C USCI Line Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |LSB |LSB First Transmission Selection + * | | |0 = The MSB, which bit of transmit/receive data buffer depends on the setting of DWIDTH, is transmitted/received first. + * | | |1 = The LSB, the bit 0 of data buffer, will be transmitted/received first. + * |[5] |DATOINV |Data Output Inverse Selection + * | | |This bit defines the relation between the internal shift data value and the output data signal of USCIx_DAT1 pin. + * | | |0 = The value of USCIx_DAT1 is equal to the data shift register. + * | | |1 = The value of USCIx_DAT1 is the inversion of data shift register. + * |[7] |CTLOINV |Control Signal Output Inverse Selection + * | | |This bit defines the relation between the internal control signal and the output control signal. + * | | |0 = No effect. + * | | |1 = The control signal will be inverted before its output. + * | | |Note: In UART protocol, the control signal means nRTS signal. + * |[11:8] |DWIDTH |Word Length of Transmission + * | | |This bit field defines the data word length (amount of bits) for reception and transmission + * | | |The data word is always right-aligned in the data buffer + * | | |USCI support word length from 4 to 16 bits. + * | | |0x0: The data word contains 16 bits located at bit positions [15:0]. + * | | |0x1: Reserved. + * | | |0x2: Reserved. + * | | |0x3: Reserved. + * | | |0x4: The data word contains 4 bits located at bit positions [3:0]. + * | | |0x5: The data word contains 5 bits located at bit positions [4:0]. + * | | |.. + * | | |0xF: The data word contains 15 bits located at bit positions [14:0]. + * | | |Note: In UART protocol, the length can be configured as 6~13 bits. + * @var UUART_T::TXDAT + * Offset: 0x30 USCI Transmit Data Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |TXDAT |Transmit Data + * | | |Software can use this bit field to write 16-bit transmit data for transmission. + * @var UUART_T::RXDAT + * Offset: 0x34 USCI Receive Data Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[15:0] |RXDAT |Received Data + * | | |This bit field monitors the received data which stored in receive data buffer. + * | | |Note: RXDAT[15:13] indicate the same frame status of BREAK, FRMERR and PARITYERR (USCI_PROTSTS[7:5]). + * @var UUART_T::BUFCTL + * Offset: 0x38 USCI Transmit/Receive Buffer Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[7] |TXCLR |Clear Transmit Buffer + * | | |0 = No effect. + * | | |1 = The transmit buffer is cleared (filling level is cleared and output pointer is set to input pointer value) + * | | |Should only be used while the buffer is not taking part in data traffic. + * | | |Note: It is cleared automatically after one PCLK cycle. + * |[14] |RXOVIEN |Receive Buffer Overrun Error Interrupt Enable Control + * | | |0 = Receive overrun interrupt Disabled. + * | | |1 = Receive overrun interrupt Enabled. + * |[15] |RXCLR |Clear Receive Buffer + * | | |0 = No effect. + * | | |1 = The receive buffer is cleared (filling level is cleared and output pointer is set to input pointer value) + * | | |Should only be used while the buffer is not taking part in data traffic. + * | | |Note: It is cleared automatically after one PCLK cycle. + * |[16] |TXRST |Transmit Reset + * | | |0 = No effect. + * | | |1 = Reset the transmit-related counters, state machine, and the content of transmit shift register and data buffer. + * | | |Note: It is cleared automatically after one PCLK cycle. + * |[17] |RXRST |Receive Reset + * | | |0 = No effect. + * | | |1 = Reset the receive-related counters, state machine, and the content of receive shift register and data buffer. + * | | |Note 1: It is cleared automatically after one PCLK cycle. + * | | |Note 2: It is suggest to check the RXBUSY (USCI_PROTSTS[10]) before this bit will be set to 1. + * @var UUART_T::BUFSTS + * Offset: 0x3C USCI Transmit/Receive Buffer Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |RXEMPTY |Receive Buffer Empty Indicator + * | | |0 = Receive buffer is not empty. + * | | |1 = Receive buffer is empty. + * |[1] |RXFULL |Receive Buffer Full Indicator + * | | |0 = Receive buffer is not full. + * | | |1 = Receive buffer is full. + * |[3] |RXOVIF |Receive Buffer Over-run Error Interrupt Status + * | | |This bit indicates that a receive buffer overrun error event has been detected + * | | |If RXOVIEN (USCI_BUFCTL[14]) is enabled, the corresponding interrupt request is activated + * | | |It is cleared by software writes 1 to this bit. + * | | |0 = A receive buffer overrun error event has not been detected. + * | | |1 = A receive buffer overrun error event has been detected. + * |[8] |TXEMPTY |Transmit Buffer Empty Indicator + * | | |0 = Transmit buffer is not empty. + * | | |1 = Transmit buffer is empty. + * |[9] |TXFULL |Transmit Buffer Full Indicator + * | | |0 = Transmit buffer is not full. + * | | |1 = Transmit buffer is full. + * @var UUART_T::PDMACTL + * Offset: 0x40 USCI PDMA Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |PDMARST |PDMA Reset + * | | |0 = No effect. + * | | |1 = Reset the USCI's PDMA control logic. This bit will be cleared to 0 automatically. + * |[1] |TXPDMAEN |PDMA Transmit Channel Available + * | | |0 = Transmit PDMA function Disabled. + * | | |1 = Transmit PDMA function Enabled. + * |[2] |RXPDMAEN |PDMA Receive Channel Available + * | | |0 = Receive PDMA function Disabled. + * | | |1 = Receive PDMA function Enabled. + * |[3] |PDMAEN |PDMA Mode Enable Bit + * | | |0 = PDMA function Disabled. + * | | |1 = PDMA function Enabled. + * @var UUART_T::WKCTL + * Offset: 0x54 USCI Wake-up Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |WKEN |Wake-up Enable Bit + * | | |0 = Wake-up function Disabled. + * | | |1 = Wake-up function Enabled. + * |[2] |PDBOPT |Power Down Blocking Option + * | | |0 = If user attempts to enter Power-down mode by executing WFI while the protocol is in transferring, MCU will stop the transfer and enter Power-down mode immediately. + * | | |1 = If user attempts to enter Power-down mode by executing WFI while the protocol is in transferring, the on-going transfer will not be stopped and MCU will enter idle mode immediately. + * @var UUART_T::WKSTS + * Offset: 0x58 USCI Wake-up Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |WKF |Wake-up Flag + * | | |When chip is woken up from Power-down mode, this bit is set to 1 + * | | |Software can write 1 to clear this bit. + * @var UUART_T::PROTCTL + * Offset: 0x5C USCI Protocol Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |STOPB |Stop Bits + * | | |This bit defines the number of stop bits in an UART frame. + * | | |0 = The number of stop bits is 1. + * | | |1 = The number of stop bits is 2. + * |[1] |PARITYEN |Parity Enable Bit + * | | |This bit defines the parity bit is enabled in an UART frame. + * | | |0 = The parity bit Disabled. + * | | |1 = The parity bit Enabled. + * |[2] |EVENPARITY|Even Parity Enable Bit + * | | |0 = Odd number of logic 1's is transmitted and checked in each word. + * | | |1 = Even number of logic 1's is transmitted and checked in each word. + * | | |Note: This bit has effect only when PARITYEN is set. + * |[3] |RTSAUTOEN |nRTS Auto-flow Control Enable Bit + * | | |When nRTS auto-flow is enabled, if the receiver buffer is full (RXFULL (USCI_BUFSTS[1] = 1'b1)), the UART will de-assert nRTS signal. + * | | |0 = nRTS auto-flow control Disabled. + * | | |1 = nRTS auto-flow control Enabled. + * | | |Note: This bit has effect only when the RTSAUDIREN is not set. + * |[4] |CTSAUTOEN |nCTS Auto-flow Control Enable Bit + * | | |When nCTS auto-flow is enabled, the UART will send data to external device when nCTS input assert (UART will not send data to device if nCTS input is dis-asserted). + * | | |0 = nCTS auto-flow control Disabled. + * | | |1 = nCTS auto-flow control Enabled. + * |[5] |RTSAUDIREN|nRTS Auto Direction Enable Bit + * | | |When nRTS auto direction is enabled, if the transmitted bytes in the TX buffer is empty, the UART asserted nRTS signal automatically. + * | | |0 = nRTS auto direction control Disabled. + * | | |1 = nRTS auto direction control Enabled. + * | | |Note 1: This bit is used for nRTS auto direction control for RS485. + * | | |Note 2: This bit has effect only when the RTSAUTOEN is not set. + * |[6] |ABREN |Auto-baud Rate Detect Enable Bit + * | | |0 = Auto-baud rate detect function Disabled. + * | | |1 = Auto-baud rate detect function Enabled. + * | | |Note: When the auto - baud rate detect operation finishes, hardware will clear this bit + * | | |The associated interrupt ABRDETIF (USCI_PROTST[9]) will be generated (If ARBIEN (USCI_PROTIEN [1]) is enabled). + * |[9] |DATWKEN |Data Wake-up Mode Enable Bit + * | | |0 = Data wake-up mode Disabled. + * | | |1 = Data wake-up mode Enabled. + * |[10] |CTSWKEN |nCTS Wake-up Mode Enable Bit + * | | |0 = nCTS wake-up mode Disabled. + * | | |1 = nCTS wake-up mode Enabled. + * |[14:11] |WAKECNT |Wake-up Counter + * | | |These bits field indicate how many clock cycle selected by fPDS_CNT do the slave can get the 1st bit (start bit) when the device is wake-up from Power-down mode. + * |[24:16] |BRDETITV |Baud Rate Detection Interval + * | | |This bit fields indicate how many clock cycle selected by TMCNTSRC (USCI_BRGEN [5]) does the slave calculates the baud rate in one bits + * | | |The order of the bus shall be 1 and 0 step by step (e.g. the input data pattern shall be 0x55) + * | | |The user can read the value to know the current input baud rate of the bus whenever the ABRDETIF (USCI_PROTCTL[9]) is set. + * | | |Note: This bit can be cleared to 0 by software writing '0' to the BRDETITV. + * |[26] |STICKEN |Stick Parity Enable Bit + * | | |0 = Stick parity Disabled. + * | | |1 = Stick parity Enabled. + * | | |Note: Refer to RS-485 Support section for detail information. + * |[29] |BCEN |Transmit Break Control Enable Bit + * | | |0 = Transmit Break Control Disabled. + * | | |1 = Transmit Break Control Enabled. + * | | |Note: When this bit is set to logic 1, the serial data output (TX) is forced to the Spacing State (logic 0) + * | | |This bit acts only on TX line and has no effect on the transmitter logic. + * |[31] |PROTEN |UART Protocol Enable Bit + * | | |0 = UART Protocol Disabled. + * | | |1 = UART Protocol Enabled. + * @var UUART_T::PROTIEN + * Offset: 0x60 USCI Protocol Interrupt Enable Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1] |ABRIEN |Auto-baud Rate Interrupt Enable Bit + * | | |0 = Auto-baud rate interrupt Disabled. + * | | |1 = Auto-baud rate interrupt Enabled. + * |[2] |RLSIEN |Receive Line Status Interrupt Enable Bit + * | | |0 = Receive line status interrupt Disabled. + * | | |1 = Receive line status interrupt Enabled. + * | | |Note: USCI_PROTSTS[7:5] indicates the current interrupt event for receive line status interrupt. + * @var UUART_T::PROTSTS + * Offset: 0x64 USCI Protocol Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1] |TXSTIF |Transmit Start Interrupt Flag + * | | |0 = A transmit start interrupt status has not occurred. + * | | |1 = A transmit start interrupt status has occurred. + * | | |Note 1: It is cleared by software writing one into this bit. + * | | |Note 2: Used for user to load next transmit data when there is no data in transmit buffer. + * |[2] |TXENDIF |Transmit End Interrupt Flag + * | | |0 = A transmit end interrupt status has not occurred. + * | | |1 = A transmit end interrupt status has occurred. + * | | |Note: It is cleared by software writing one into this bit. + * |[3] |RXSTIF |Receive Start Interrupt Flag + * | | |0 = A receive start interrupt status has not occurred. + * | | |1 = A receive start interrupt status has occurred. + * | | |Note: It is cleared by software writing one into this bit. + * |[4] |RXENDIF |Receive End Interrupt Flag + * | | |0 = A receive finish interrupt status has not occurred. + * | | |1 = A receive finish interrupt status has occurred. + * | | |Note: It is cleared by software writing one into this bit. + * |[5] |PARITYERR |Parity Error Flag + * | | |This bit is set to logic 1 whenever the received character does not have a valid 'parity bit'. + * | | |0 = No parity error is generated. + * | | |1 = Parity error is generated. + * | | |Note: This bit can be cleared by write '1' among the BREAK, FRMERR and PARITYERR bits. + * |[6] |FRMERR |Framing Error Flag + * | | |This bit is set to logic 1 whenever the received character does not have a valid 'stop bit' + * | | |(that is, the stop bit following the last data bit or parity bit is detected as logic 0). + * | | |0 = No framing error is generated. + * | | |1 = Framing error is generated. + * | | |Note: This bit can be cleared by write '1' among the BREAK, FRMERR and PARITYERR bits. + * |[7] |BREAK |Break Flag + * | | |This bit is set to logic 1 whenever the received data input (RX) is held in the 'spacing state' + * | | |(logic 0) for longer than a full word transmission time (that is, the total time of start bit + data bits + parity + stop bits). + * | | |0 = No Break is generated. + * | | |1 = Break is generated in the receiver bus. + * | | |Note: This bit can be cleared by write '1' among the BREAK, FRMERR and PARITYERR bits. + * |[9] |ABRDETIF |Auto-baud Rate Interrupt Flag + * | | |This bit is set when auto-baud rate detection is done among the falling edge of the input data + * | | |If the ABRIEN (USCI_PROTCTL[6]) is set, the auto-baud rate interrupt will be generated + * | | |This bit can be set 4 times when the input data pattern is 0x55 and it is cleared before the next falling edge of the input bus. + * | | |0 = Auto-baud rate detect function is not done. + * | | |1 = One Bit auto-baud rate detect function is done. + * | | |Note: This bit can be cleared by writing '1' to it. + * |[10] |RXBUSY |RX Bus Status Flag (Read Only) + * | | |This bit indicates the busy status of the receiver. + * | | |0 = The receiver is Idle. + * | | |1 = The receiver is BUSY. + * |[11] |ABERRSTS |Auto-baud Rate Error Status + * | | |This bit is set when auto-baud rate detection counter overrun + * | | |When the auto-baud rate counter overrun, the user shall revise the CLKDIV (USCI_BRGEN[25:16]) value and + * | | |enable ABREN (USCI_PROTCTL[6]) to detect the correct baud rate again. + * | | |0 = Auto-baud rate detect counter is not overrun. + * | | |1 = Auto-baud rate detect counter is overrun. + * | | |Note 1: This bit is set at the same time of ABRDETIF. + * | | |Note 2: This bit can be cleared by writing '1' to ABRDETIF or ABERRSTS. + * |[16] |CTSSYNCLV |nCTS Synchronized Level Status (Read Only) + * | | |This bit used to indicate the current status of the internal synchronized nCTS signal. + * | | |0 = The internal synchronized nCTS is low. + * | | |1 = The internal synchronized nCTS is high. + * |[17] |CTSLV |nCTS Pin Status (Read Only) + * | | |This bit used to monitor the current status of nCTS pin input. + * | | |0 = nCTS pin input is low level voltage logic state. + * | | |1 = nCTS pin input is high level voltage logic state. + */ + __IO uint32_t CTL; /*!< [0x0000] USCI Control Register */ + __IO uint32_t INTEN; /*!< [0x0004] USCI Interrupt Enable Register */ + __IO uint32_t BRGEN; /*!< [0x0008] USCI Baud Rate Generator Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE0[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t DATIN0; /*!< [0x0010] USCI Input Data Signal Configuration Register 0 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE1[3]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t CTLIN0; /*!< [0x0020] USCI Input Control Signal Configuration Register 0 */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE2[1]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t CLKIN; /*!< [0x0028] USCI Input Clock Signal Configuration Register */ + __IO uint32_t LINECTL; /*!< [0x002c] USCI Line Control Register */ + __IO uint32_t TXDAT; /*!< [0x0030] USCI Transmit Data Register */ + __IO uint32_t RXDAT; /*!< [0x0034] USCI Receive Data Register */ + __IO uint32_t BUFCTL; /*!< [0x0038] USCI Transmit/Receive Buffer Control Register */ + __IO uint32_t BUFSTS; /*!< [0x003c] USCI Transmit/Receive Buffer Status Register */ + __IO uint32_t PDMACTL; /*!< [0x0040] USCI PDMA Control Register */ + /// @cond HIDDEN_SYMBOLS + __I uint32_t RESERVE3[4]; + /// @endcond //HIDDEN_SYMBOLS + __IO uint32_t WKCTL; /*!< [0x0054] USCI Wake-up Control Register */ + __IO uint32_t WKSTS; /*!< [0x0058] USCI Wake-up Status Register */ + __IO uint32_t PROTCTL; /*!< [0x005c] USCI Protocol Control Register */ + __IO uint32_t PROTIEN; /*!< [0x0060] USCI Protocol Interrupt Enable Register */ + __IO uint32_t PROTSTS; /*!< [0x0064] USCI Protocol Status Register */ + +} UUART_T; + +/** + @addtogroup UUART_CONST UUART Bit Field Definition + Constant Definitions for UUART Controller +@{ */ + +#define UUART_CTL_FUNMODE_Pos (0) /*!< UUART_T::CTL: FUNMODE Position */ +#define UUART_CTL_FUNMODE_Msk (0x7ul << UUART_CTL_FUNMODE_Pos) /*!< UUART_T::CTL: FUNMODE Mask */ + +#define UUART_INTEN_TXSTIEN_Pos (1) /*!< UUART_T::INTEN: TXSTIEN Position */ +#define UUART_INTEN_TXSTIEN_Msk (0x1ul << UUART_INTEN_TXSTIEN_Pos) /*!< UUART_T::INTEN: TXSTIEN Mask */ + +#define UUART_INTEN_TXENDIEN_Pos (2) /*!< UUART_T::INTEN: TXENDIEN Position */ +#define UUART_INTEN_TXENDIEN_Msk (0x1ul << UUART_INTEN_TXENDIEN_Pos) /*!< UUART_T::INTEN: TXENDIEN Mask */ + +#define UUART_INTEN_RXSTIEN_Pos (3) /*!< UUART_T::INTEN: RXSTIEN Position */ +#define UUART_INTEN_RXSTIEN_Msk (0x1ul << UUART_INTEN_RXSTIEN_Pos) /*!< UUART_T::INTEN: RXSTIEN Mask */ + +#define UUART_INTEN_RXENDIEN_Pos (4) /*!< UUART_T::INTEN: RXENDIEN Position */ +#define UUART_INTEN_RXENDIEN_Msk (0x1ul << UUART_INTEN_RXENDIEN_Pos) /*!< UUART_T::INTEN: RXENDIEN Mask */ + +#define UUART_BRGEN_RCLKSEL_Pos (0) /*!< UUART_T::BRGEN: RCLKSEL Position */ +#define UUART_BRGEN_RCLKSEL_Msk (0x1ul << UUART_BRGEN_RCLKSEL_Pos) /*!< UUART_T::BRGEN: RCLKSEL Mask */ + +#define UUART_BRGEN_PTCLKSEL_Pos (1) /*!< UUART_T::BRGEN: PTCLKSEL Position */ +#define UUART_BRGEN_PTCLKSEL_Msk (0x1ul << UUART_BRGEN_PTCLKSEL_Pos) /*!< UUART_T::BRGEN: PTCLKSEL Mask */ + +#define UUART_BRGEN_SPCLKSEL_Pos (2) /*!< UUART_T::BRGEN: SPCLKSEL Position */ +#define UUART_BRGEN_SPCLKSEL_Msk (0x3ul << UUART_BRGEN_SPCLKSEL_Pos) /*!< UUART_T::BRGEN: SPCLKSEL Mask */ + +#define UUART_BRGEN_TMCNTEN_Pos (4) /*!< UUART_T::BRGEN: TMCNTEN Position */ +#define UUART_BRGEN_TMCNTEN_Msk (0x1ul << UUART_BRGEN_TMCNTEN_Pos) /*!< UUART_T::BRGEN: TMCNTEN Mask */ + +#define UUART_BRGEN_TMCNTSRC_Pos (5) /*!< UUART_T::BRGEN: TMCNTSRC Position */ +#define UUART_BRGEN_TMCNTSRC_Msk (0x1ul << UUART_BRGEN_TMCNTSRC_Pos) /*!< UUART_T::BRGEN: TMCNTSRC Mask */ + +#define UUART_BRGEN_PDSCNT_Pos (8) /*!< UUART_T::BRGEN: PDSCNT Position */ +#define UUART_BRGEN_PDSCNT_Msk (0x3ul << UUART_BRGEN_PDSCNT_Pos) /*!< UUART_T::BRGEN: PDSCNT Mask */ + +#define UUART_BRGEN_DSCNT_Pos (10) /*!< UUART_T::BRGEN: DSCNT Position */ +#define UUART_BRGEN_DSCNT_Msk (0x1ful << UUART_BRGEN_DSCNT_Pos) /*!< UUART_T::BRGEN: DSCNT Mask */ + +#define UUART_BRGEN_CLKDIV_Pos (16) /*!< UUART_T::BRGEN: CLKDIV Position */ +#define UUART_BRGEN_CLKDIV_Msk (0x3fful << UUART_BRGEN_CLKDIV_Pos) /*!< UUART_T::BRGEN: CLKDIV Mask */ + +#define UUART_DATIN0_SYNCSEL_Pos (0) /*!< UUART_T::DATIN0: SYNCSEL Position */ +#define UUART_DATIN0_SYNCSEL_Msk (0x1ul << UUART_DATIN0_SYNCSEL_Pos) /*!< UUART_T::DATIN0: SYNCSEL Mask */ + +#define UUART_DATIN0_ININV_Pos (2) /*!< UUART_T::DATIN0: ININV Position */ +#define UUART_DATIN0_ININV_Msk (0x1ul << UUART_DATIN0_ININV_Pos) /*!< UUART_T::DATIN0: ININV Mask */ + +#define UUART_DATIN0_EDGEDET_Pos (3) /*!< UUART_T::DATIN0: EDGEDET Position */ +#define UUART_DATIN0_EDGEDET_Msk (0x3ul << UUART_DATIN0_EDGEDET_Pos) /*!< UUART_T::DATIN0: EDGEDET Mask */ + +#define UUART_CTLIN0_SYNCSEL_Pos (0) /*!< UUART_T::CTLIN0: SYNCSEL Position */ +#define UUART_CTLIN0_SYNCSEL_Msk (0x1ul << UUART_CTLIN0_SYNCSEL_Pos) /*!< UUART_T::CTLIN0: SYNCSEL Mask */ + +#define UUART_CTLIN0_ININV_Pos (2) /*!< UUART_T::CTLIN0: ININV Position */ +#define UUART_CTLIN0_ININV_Msk (0x1ul << UUART_CTLIN0_ININV_Pos) /*!< UUART_T::CTLIN0: ININV Mask */ + +#define UUART_CLKIN_SYNCSEL_Pos (0) /*!< UUART_T::CLKIN: SYNCSEL Position */ +#define UUART_CLKIN_SYNCSEL_Msk (0x1ul << UUART_CLKIN_SYNCSEL_Pos) /*!< UUART_T::CLKIN: SYNCSEL Mask */ + +#define UUART_LINECTL_LSB_Pos (0) /*!< UUART_T::LINECTL: LSB Position */ +#define UUART_LINECTL_LSB_Msk (0x1ul << UUART_LINECTL_LSB_Pos) /*!< UUART_T::LINECTL: LSB Mask */ + +#define UUART_LINECTL_DATOINV_Pos (5) /*!< UUART_T::LINECTL: DATOINV Position */ +#define UUART_LINECTL_DATOINV_Msk (0x1ul << UUART_LINECTL_DATOINV_Pos) /*!< UUART_T::LINECTL: DATOINV Mask */ + +#define UUART_LINECTL_CTLOINV_Pos (7) /*!< UUART_T::LINECTL: CTLOINV Position */ +#define UUART_LINECTL_CTLOINV_Msk (0x1ul << UUART_LINECTL_CTLOINV_Pos) /*!< UUART_T::LINECTL: CTLOINV Mask */ + +#define UUART_LINECTL_DWIDTH_Pos (8) /*!< UUART_T::LINECTL: DWIDTH Position */ +#define UUART_LINECTL_DWIDTH_Msk (0xful << UUART_LINECTL_DWIDTH_Pos) /*!< UUART_T::LINECTL: DWIDTH Mask */ + +#define UUART_TXDAT_TXDAT_Pos (0) /*!< UUART_T::TXDAT: TXDAT Position */ +#define UUART_TXDAT_TXDAT_Msk (0xfffful << UUART_TXDAT_TXDAT_Pos) /*!< UUART_T::TXDAT: TXDAT Mask */ + +#define UUART_RXDAT_RXDAT_Pos (0) /*!< UUART_T::RXDAT: RXDAT Position */ +#define UUART_RXDAT_RXDAT_Msk (0xfffful << UUART_RXDAT_RXDAT_Pos) /*!< UUART_T::RXDAT: RXDAT Mask */ + +#define UUART_BUFCTL_TXCLR_Pos (7) /*!< UUART_T::BUFCTL: TXCLR Position */ +#define UUART_BUFCTL_TXCLR_Msk (0x1ul << UUART_BUFCTL_TXCLR_Pos) /*!< UUART_T::BUFCTL: TXCLR Mask */ + +#define UUART_BUFCTL_RXOVIEN_Pos (14) /*!< UUART_T::BUFCTL: RXOVIEN Position */ +#define UUART_BUFCTL_RXOVIEN_Msk (0x1ul << UUART_BUFCTL_RXOVIEN_Pos) /*!< UUART_T::BUFCTL: RXOVIEN Mask */ + +#define UUART_BUFCTL_RXCLR_Pos (15) /*!< UUART_T::BUFCTL: RXCLR Position */ +#define UUART_BUFCTL_RXCLR_Msk (0x1ul << UUART_BUFCTL_RXCLR_Pos) /*!< UUART_T::BUFCTL: RXCLR Mask */ + +#define UUART_BUFCTL_TXRST_Pos (16) /*!< UUART_T::BUFCTL: TXRST Position */ +#define UUART_BUFCTL_TXRST_Msk (0x1ul << UUART_BUFCTL_TXRST_Pos) /*!< UUART_T::BUFCTL: TXRST Mask */ + +#define UUART_BUFCTL_RXRST_Pos (17) /*!< UUART_T::BUFCTL: RXRST Position */ +#define UUART_BUFCTL_RXRST_Msk (0x1ul << UUART_BUFCTL_RXRST_Pos) /*!< UUART_T::BUFCTL: RXRST Mask */ + +#define UUART_BUFSTS_RXEMPTY_Pos (0) /*!< UUART_T::BUFSTS: RXEMPTY Position */ +#define UUART_BUFSTS_RXEMPTY_Msk (0x1ul << UUART_BUFSTS_RXEMPTY_Pos) /*!< UUART_T::BUFSTS: RXEMPTY Mask */ + +#define UUART_BUFSTS_RXFULL_Pos (1) /*!< UUART_T::BUFSTS: RXFULL Position */ +#define UUART_BUFSTS_RXFULL_Msk (0x1ul << UUART_BUFSTS_RXFULL_Pos) /*!< UUART_T::BUFSTS: RXFULL Mask */ + +#define UUART_BUFSTS_RXOVIF_Pos (3) /*!< UUART_T::BUFSTS: RXOVIF Position */ +#define UUART_BUFSTS_RXOVIF_Msk (0x1ul << UUART_BUFSTS_RXOVIF_Pos) /*!< UUART_T::BUFSTS: RXOVIF Mask */ + +#define UUART_BUFSTS_TXEMPTY_Pos (8) /*!< UUART_T::BUFSTS: TXEMPTY Position */ +#define UUART_BUFSTS_TXEMPTY_Msk (0x1ul << UUART_BUFSTS_TXEMPTY_Pos) /*!< UUART_T::BUFSTS: TXEMPTY Mask */ + +#define UUART_BUFSTS_TXFULL_Pos (9) /*!< UUART_T::BUFSTS: TXFULL Position */ +#define UUART_BUFSTS_TXFULL_Msk (0x1ul << UUART_BUFSTS_TXFULL_Pos) /*!< UUART_T::BUFSTS: TXFULL Mask */ + +#define UUART_PDMACTL_PDMARST_Pos (0) /*!< UUART_T::PDMACTL: PDMARST Position */ +#define UUART_PDMACTL_PDMARST_Msk (0x1ul << UUART_PDMACTL_PDMARST_Pos) /*!< UUART_T::PDMACTL: PDMARST Mask */ + +#define UUART_PDMACTL_TXPDMAEN_Pos (1) /*!< UUART_T::PDMACTL: TXPDMAEN Position */ +#define UUART_PDMACTL_TXPDMAEN_Msk (0x1ul << UUART_PDMACTL_TXPDMAEN_Pos) /*!< UUART_T::PDMACTL: TXPDMAEN Mask */ + +#define UUART_PDMACTL_RXPDMAEN_Pos (2) /*!< UUART_T::PDMACTL: RXPDMAEN Position */ +#define UUART_PDMACTL_RXPDMAEN_Msk (0x1ul << UUART_PDMACTL_RXPDMAEN_Pos) /*!< UUART_T::PDMACTL: RXPDMAEN Mask */ + +#define UUART_PDMACTL_PDMAEN_Pos (3) /*!< UUART_T::PDMACTL: PDMAEN Position */ +#define UUART_PDMACTL_PDMAEN_Msk (0x1ul << UUART_PDMACTL_PDMAEN_Pos) /*!< UUART_T::PDMACTL: PDMAEN Mask */ + +#define UUART_WKCTL_WKEN_Pos (0) /*!< UUART_T::WKCTL: WKEN Position */ +#define UUART_WKCTL_WKEN_Msk (0x1ul << UUART_WKCTL_WKEN_Pos) /*!< UUART_T::WKCTL: WKEN Mask */ + +#define UUART_WKCTL_PDBOPT_Pos (2) /*!< UUART_T::WKCTL: PDBOPT Position */ +#define UUART_WKCTL_PDBOPT_Msk (0x1ul << UUART_WKCTL_PDBOPT_Pos) /*!< UUART_T::WKCTL: PDBOPT Mask */ + +#define UUART_WKSTS_WKF_Pos (0) /*!< UUART_T::WKSTS: WKF Position */ +#define UUART_WKSTS_WKF_Msk (0x1ul << UUART_WKSTS_WKF_Pos) /*!< UUART_T::WKSTS: WKF Mask */ + +#define UUART_PROTCTL_STOPB_Pos (0) /*!< UUART_T::PROTCTL: STOPB Position */ +#define UUART_PROTCTL_STOPB_Msk (0x1ul << UUART_PROTCTL_STOPB_Pos) /*!< UUART_T::PROTCTL: STOPB Mask */ + +#define UUART_PROTCTL_PARITYEN_Pos (1) /*!< UUART_T::PROTCTL: PARITYEN Position */ +#define UUART_PROTCTL_PARITYEN_Msk (0x1ul << UUART_PROTCTL_PARITYEN_Pos) /*!< UUART_T::PROTCTL: PARITYEN Mask */ + +#define UUART_PROTCTL_EVENPARITY_Pos (2) /*!< UUART_T::PROTCTL: EVENPARITY Position */ +#define UUART_PROTCTL_EVENPARITY_Msk (0x1ul << UUART_PROTCTL_EVENPARITY_Pos) /*!< UUART_T::PROTCTL: EVENPARITY Mask */ + +#define UUART_PROTCTL_RTSAUTOEN_Pos (3) /*!< UUART_T::PROTCTL: RTSAUTOEN Position */ +#define UUART_PROTCTL_RTSAUTOEN_Msk (0x1ul << UUART_PROTCTL_RTSAUTOEN_Pos) /*!< UUART_T::PROTCTL: RTSAUTOEN Mask */ + +#define UUART_PROTCTL_CTSAUTOEN_Pos (4) /*!< UUART_T::PROTCTL: CTSAUTOEN Position */ +#define UUART_PROTCTL_CTSAUTOEN_Msk (0x1ul << UUART_PROTCTL_CTSAUTOEN_Pos) /*!< UUART_T::PROTCTL: CTSAUTOEN Mask */ + +#define UUART_PROTCTL_RTSAUDIREN_Pos (5) /*!< UUART_T::PROTCTL: RTSAUDIREN Position */ +#define UUART_PROTCTL_RTSAUDIREN_Msk (0x1ul << UUART_PROTCTL_RTSAUDIREN_Pos) /*!< UUART_T::PROTCTL: RTSAUDIREN Mask */ + +#define UUART_PROTCTL_ABREN_Pos (6) /*!< UUART_T::PROTCTL: ABREN Position */ +#define UUART_PROTCTL_ABREN_Msk (0x1ul << UUART_PROTCTL_ABREN_Pos) /*!< UUART_T::PROTCTL: ABREN Mask */ + +#define UUART_PROTCTL_DATWKEN_Pos (9) /*!< UUART_T::PROTCTL: DATWKEN Position */ +#define UUART_PROTCTL_DATWKEN_Msk (0x1ul << UUART_PROTCTL_DATWKEN_Pos) /*!< UUART_T::PROTCTL: DATWKEN Mask */ + +#define UUART_PROTCTL_CTSWKEN_Pos (10) /*!< UUART_T::PROTCTL: CTSWKEN Position */ +#define UUART_PROTCTL_CTSWKEN_Msk (0x1ul << UUART_PROTCTL_CTSWKEN_Pos) /*!< UUART_T::PROTCTL: CTSWKEN Mask */ + +#define UUART_PROTCTL_WAKECNT_Pos (11) /*!< UUART_T::PROTCTL: WAKECNT Position */ +#define UUART_PROTCTL_WAKECNT_Msk (0xful << UUART_PROTCTL_WAKECNT_Pos) /*!< UUART_T::PROTCTL: WAKECNT Mask */ + +#define UUART_PROTCTL_BRDETITV_Pos (16) /*!< UUART_T::PROTCTL: BRDETITV Position */ +#define UUART_PROTCTL_BRDETITV_Msk (0x1fful << UUART_PROTCTL_BRDETITV_Pos) /*!< UUART_T::PROTCTL: BRDETITV Mask */ + +#define UUART_PROTCTL_STICKEN_Pos (26) /*!< UUART_T::PROTCTL: STICKEN Position */ +#define UUART_PROTCTL_STICKEN_Msk (0x1ul << UUART_PROTCTL_STICKEN_Pos) /*!< UUART_T::PROTCTL: STICKEN Mask */ + +#define UUART_PROTCTL_BCEN_Pos (29) /*!< UUART_T::PROTCTL: BCEN Position */ +#define UUART_PROTCTL_BCEN_Msk (0x1ul << UUART_PROTCTL_BCEN_Pos) /*!< UUART_T::PROTCTL: BCEN Mask */ + +#define UUART_PROTCTL_PROTEN_Pos (31) /*!< UUART_T::PROTCTL: PROTEN Position */ +#define UUART_PROTCTL_PROTEN_Msk (0x1ul << UUART_PROTCTL_PROTEN_Pos) /*!< UUART_T::PROTCTL: PROTEN Mask */ + +#define UUART_PROTIEN_ABRIEN_Pos (1) /*!< UUART_T::PROTIEN: ABRIEN Position */ +#define UUART_PROTIEN_ABRIEN_Msk (0x1ul << UUART_PROTIEN_ABRIEN_Pos) /*!< UUART_T::PROTIEN: ABRIEN Mask */ + +#define UUART_PROTIEN_RLSIEN_Pos (2) /*!< UUART_T::PROTIEN: RLSIEN Position */ +#define UUART_PROTIEN_RLSIEN_Msk (0x1ul << UUART_PROTIEN_RLSIEN_Pos) /*!< UUART_T::PROTIEN: RLSIEN Mask */ + +#define UUART_PROTSTS_TXSTIF_Pos (1) /*!< UUART_T::PROTSTS: TXSTIF Position */ +#define UUART_PROTSTS_TXSTIF_Msk (0x1ul << UUART_PROTSTS_TXSTIF_Pos) /*!< UUART_T::PROTSTS: TXSTIF Mask */ + +#define UUART_PROTSTS_TXENDIF_Pos (2) /*!< UUART_T::PROTSTS: TXENDIF Position */ +#define UUART_PROTSTS_TXENDIF_Msk (0x1ul << UUART_PROTSTS_TXENDIF_Pos) /*!< UUART_T::PROTSTS: TXENDIF Mask */ + +#define UUART_PROTSTS_RXSTIF_Pos (3) /*!< UUART_T::PROTSTS: RXSTIF Position */ +#define UUART_PROTSTS_RXSTIF_Msk (0x1ul << UUART_PROTSTS_RXSTIF_Pos) /*!< UUART_T::PROTSTS: RXSTIF Mask */ + +#define UUART_PROTSTS_RXENDIF_Pos (4) /*!< UUART_T::PROTSTS: RXENDIF Position */ +#define UUART_PROTSTS_RXENDIF_Msk (0x1ul << UUART_PROTSTS_RXENDIF_Pos) /*!< UUART_T::PROTSTS: RXENDIF Mask */ + +#define UUART_PROTSTS_PARITYERR_Pos (5) /*!< UUART_T::PROTSTS: PARITYERR Position */ +#define UUART_PROTSTS_PARITYERR_Msk (0x1ul << UUART_PROTSTS_PARITYERR_Pos) /*!< UUART_T::PROTSTS: PARITYERR Mask */ + +#define UUART_PROTSTS_FRMERR_Pos (6) /*!< UUART_T::PROTSTS: FRMERR Position */ +#define UUART_PROTSTS_FRMERR_Msk (0x1ul << UUART_PROTSTS_FRMERR_Pos) /*!< UUART_T::PROTSTS: FRMERR Mask */ + +#define UUART_PROTSTS_BREAK_Pos (7) /*!< UUART_T::PROTSTS: BREAK Position */ +#define UUART_PROTSTS_BREAK_Msk (0x1ul << UUART_PROTSTS_BREAK_Pos) /*!< UUART_T::PROTSTS: BREAK Mask */ + +#define UUART_PROTSTS_ABRDETIF_Pos (9) /*!< UUART_T::PROTSTS: ABRDETIF Position */ +#define UUART_PROTSTS_ABRDETIF_Msk (0x1ul << UUART_PROTSTS_ABRDETIF_Pos) /*!< UUART_T::PROTSTS: ABRDETIF Mask */ + +#define UUART_PROTSTS_RXBUSY_Pos (10) /*!< UUART_T::PROTSTS: RXBUSY Position */ +#define UUART_PROTSTS_RXBUSY_Msk (0x1ul << UUART_PROTSTS_RXBUSY_Pos) /*!< UUART_T::PROTSTS: RXBUSY Mask */ + +#define UUART_PROTSTS_ABERRSTS_Pos (11) /*!< UUART_T::PROTSTS: ABERRSTS Position */ +#define UUART_PROTSTS_ABERRSTS_Msk (0x1ul << UUART_PROTSTS_ABERRSTS_Pos) /*!< UUART_T::PROTSTS: ABERRSTS Mask */ + +#define UUART_PROTSTS_CTSSYNCLV_Pos (16) /*!< UUART_T::PROTSTS: CTSSYNCLV Position */ +#define UUART_PROTSTS_CTSSYNCLV_Msk (0x1ul << UUART_PROTSTS_CTSSYNCLV_Pos) /*!< UUART_T::PROTSTS: CTSSYNCLV Mask */ + +#define UUART_PROTSTS_CTSLV_Pos (17) /*!< UUART_T::PROTSTS: CTSLV Position */ +#define UUART_PROTSTS_CTSLV_Msk (0x1ul << UUART_PROTSTS_CTSLV_Pos) /*!< UUART_T::PROTSTS: CTSLV Mask */ + +/**@}*/ /* UUART_CONST */ +/**@}*/ /* end of UUART register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __UUART_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/wdt_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/wdt_reg.h new file mode 100644 index 00000000000..2bead168677 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/wdt_reg.h @@ -0,0 +1,183 @@ +/**************************************************************************//** + * @file wdt_reg.h + * @version V1.00 + * @brief WDT register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __WDT_REG_H__ +#define __WDT_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup WDT Watch Dog Timer Controller(WDT) + Memory Mapped Structure for WDT Controller +@{ */ + +typedef struct +{ + + + /** + * @var WDT_T::CTL + * Offset: 0x00 WDT Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |RSTCNT |Reset WDT Up Counter (Write Protect) + * | | |0 = No effect. + * | | |1 = Reset the internal 18-bit WDT up counter value. + * | | |Note1: This bit is write protected. Refer to the SYS_REGLCTL register. + * | | |Note2: This bit will be automatically cleared by hardware. + * |[1] |RSTEN |WDT Time-out Reset Enable Control (Write Protect) + * | | |Setting this bit will enable the WDT time-out reset function If the WDT up counter value has not been cleared after the specific WDT reset delay period expires. + * | | |0 = WDT time-out reset function Disabled. + * | | |1 = WDT time-out reset function Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[2] |RSTF |WDT Time-out Reset Flag + * | | |This bit indicates the system has been reset by WDT time-out reset or not. + * | | |0 = WDT time-out reset did not occur. + * | | |1 = WDT time-out reset occurred. + * | | |Note: This bit is cleared by writing 1 to it. + * |[3] |IF |WDT Time-out Interrupt Flag + * | | |This bit will set to 1 while WDT up counter value reaches the selected WDT time-out interval + * | | |0 = WDT time-out interrupt did not occur. + * | | |1 = WDT time-out interrupt occurred. + * | | |Note: This bit is cleared by writing 1 to it. + * |[4] |WKEN |WDT Time-out Wake-up Function Control (Write Protect) + * | | |If this bit is set to 1, while WDT time-out interrupt flag IF (WDT_CTL[3]) is generated to 1 and interrupt enable bit INTEN (WDT_CTL[6]) is enabled, the WDT time-out interrupt signal will generate a wake-up trigger event to chip. + * | | |0 = Wake-up trigger event Disabled if WDT time-out interrupt signal generated. + * | | |1 = Wake-up trigger event Enabled if WDT time-out interrupt signal generated. + * | | |Note1: This bit is write protected. Refer to the SYS_REGLCTL register. + * | | |Note2: Chip can be woken-up by WDT time-out interrupt signal generated only if WDT clock source is selected to 10 kHz internal low speed RC oscillator (LIRC) or LXT. + * |[5] |WKF |WDT Time-out Wake-up Flag (Write Protect) + * | | |This bit indicates the interrupt wake-up flag status of WDT + * | | |0 = WDT does not cause chip wake-up. + * | | |1 = Chip wake-up from Idle or Power-down mode if WDT time-out interrupt signal generated. + * | | |Note1: This bit is write protected. Refer to the SYS_REGLCTL register. + * | | |Note2: This bit is cleared by writing 1 to it. + * |[6] |INTEN |WDT Time-out Interrupt Enable Control (Write Protect) + * | | |If this bit is enabled, the WDT time-out interrupt signal is generated and inform to CPU. + * | | |0 = WDT time-out interrupt Disabled. + * | | |1 = WDT time-out interrupt Enabled. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[7] |WDTEN |WDT Enable Control (Write Protect) + * | | |0 = WDT Disabled (This action will reset the internal up counter value). + * | | |1 = WDT Enabled. + * | | |Note1: This bit is write protected. Refer to the SYS_REGLCTL register. + * | | |Note2: If CWDTEN[2:0] (combined by Config0[31] and Config0[4:3]) bits is not configure to 111, this bit is forced as 1 and user cannot change this bit to 0. + * |[10:8] |TOUTSEL |WDT Time-out Interval Selection (Write Protect) + * | | |These three bits select the time-out interval period for the WDT. + * | | |000 = 24 * WDT_CLK. + * | | |001 = 26 * WDT_CLK. + * | | |010 = 28 * WDT_CLK. + * | | |011 = 210 * WDT_CLK. + * | | |100 = 212 * WDT_CLK. + * | | |101 = 214 * WDT_CLK. + * | | |110 = 216 * WDT_CLK. + * | | |111 = 218 * WDT_CLK. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * |[30] |SYNC |WDT Enable Control SYNC Flag Indicator (Read Only) + * | | |If user execute enable/disable WDTEN (WDT_CTL[7]), this flag can be indicated enable/disable WDTEN function is completed or not. + * | | |0 = Set WDTEN bit is completed. + * | | |1 = Set WDTEN bit is synchronizing and not become active yet.. + * | | |Note: Perform enable or disable WDTEN bit needs 2 * WDT_CLK period to become active. + * |[31] |ICEDEBUG |ICE Debug Mode Acknowledge Disable Control (Write Protect) + * | | |0 = ICE debug mode acknowledgement affects WDT counting. + * | | |WDT up counter will be held while CPU is held by ICE. + * | | |1 = ICE debug mode acknowledgement Disabled. + * | | |WDT up counter will keep going no matter CPU is held by ICE or not. + * | | |Note: This bit is write protected. Refer to the SYS_REGLCTL register. + * @var WDT_T::ALTCTL + * Offset: 0x04 WDT Alternative Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[1:0] |RSTDSEL |WDT Reset Delay Selection (Write Protect) + * | | |When WDT time-out happened, user has a time named WDT Reset Delay Period to clear WDT counter by setting RSTCNT (WDT_CTL[0]) to prevent WDT time-out reset happened + * | | |User can select a suitable setting of RSTDSEL for different WDT Reset Delay Period. + * | | |00 = WDT Reset Delay Period is 1026 * WDT_CLK. + * | | |01 = WDT Reset Delay Period is 130 * WDT_CLK. + * | | |10 = WDT Reset Delay Period is 18 * WDT_CLK. + * | | |11 = WDT Reset Delay Period is 3 * WDT_CLK. + * | | |Note1: This bit is write protected. Refer to the SYS_REGLCTL register. + * | | |Note2: This register will be reset to 0 if WDT time-out reset happened. + * @var WDT_T::RSTCNT + * Offset: 0x08 WDT Reset Counter Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |RSTCNT |WDT Reset Counter Register + * | | |Writing 0x00005AA5 to this field will reset the internal 18-bit WDT up counter value to 0. + * | | |Note: Perform RSTCNT to reset counter needs 2 * WDT_CLK period to become active. + * | | |Note: RSTCNT (WDT_CTL[0]) bit is a write protected bit + * | | |RSTCNT (WDT_RSTCNT[31:0]) bits are not write protected. + */ + __IO uint32_t CTL; /*!< [0x0000] WDT Control Register */ + __IO uint32_t ALTCTL; /*!< [0x0004] WDT Alternative Control Register */ + __O uint32_t RSTCNT; /*!< [0x0008] WDT Reset Counter Register */ + +} WDT_T; + +/** + @addtogroup WDT_CONST WDT Bit Field Definition + Constant Definitions for WDT Controller +@{ */ + +#define WDT_CTL_RSTCNT_Pos (0) /*!< WDT_T::CTL: RSTCNT Position */ +#define WDT_CTL_RSTCNT_Msk (0x1ul << WDT_CTL_RSTCNT_Pos) /*!< WDT_T::CTL: RSTCNT Mask */ + +#define WDT_CTL_RSTEN_Pos (1) /*!< WDT_T::CTL: RSTEN Position */ +#define WDT_CTL_RSTEN_Msk (0x1ul << WDT_CTL_RSTEN_Pos) /*!< WDT_T::CTL: RSTEN Mask */ + +#define WDT_CTL_RSTF_Pos (2) /*!< WDT_T::CTL: RSTF Position */ +#define WDT_CTL_RSTF_Msk (0x1ul << WDT_CTL_RSTF_Pos) /*!< WDT_T::CTL: RSTF Mask */ + +#define WDT_CTL_IF_Pos (3) /*!< WDT_T::CTL: IF Position */ +#define WDT_CTL_IF_Msk (0x1ul << WDT_CTL_IF_Pos) /*!< WDT_T::CTL: IF Mask */ + +#define WDT_CTL_WKEN_Pos (4) /*!< WDT_T::CTL: WKEN Position */ +#define WDT_CTL_WKEN_Msk (0x1ul << WDT_CTL_WKEN_Pos) /*!< WDT_T::CTL: WKEN Mask */ + +#define WDT_CTL_WKF_Pos (5) /*!< WDT_T::CTL: WKF Position */ +#define WDT_CTL_WKF_Msk (0x1ul << WDT_CTL_WKF_Pos) /*!< WDT_T::CTL: WKF Mask */ + +#define WDT_CTL_INTEN_Pos (6) /*!< WDT_T::CTL: INTEN Position */ +#define WDT_CTL_INTEN_Msk (0x1ul << WDT_CTL_INTEN_Pos) /*!< WDT_T::CTL: INTEN Mask */ + +#define WDT_CTL_WDTEN_Pos (7) /*!< WDT_T::CTL: WDTEN Position */ +#define WDT_CTL_WDTEN_Msk (0x1ul << WDT_CTL_WDTEN_Pos) /*!< WDT_T::CTL: WDTEN Mask */ + +#define WDT_CTL_TOUTSEL_Pos (8) /*!< WDT_T::CTL: TOUTSEL Position */ +#define WDT_CTL_TOUTSEL_Msk (0x7ul << WDT_CTL_TOUTSEL_Pos) /*!< WDT_T::CTL: TOUTSEL Mask */ + +#define WDT_CTL_SYNC_Pos (30) /*!< WDT_T::CTL: SYNC Position */ +#define WDT_CTL_SYNC_Msk (0x1ul << WDT_CTL_SYNC_Pos) /*!< WDT_T::CTL: SYNC Mask */ + +#define WDT_CTL_ICEDEBUG_Pos (31) /*!< WDT_T::CTL: ICEDEBUG Position */ +#define WDT_CTL_ICEDEBUG_Msk (0x1ul << WDT_CTL_ICEDEBUG_Pos) /*!< WDT_T::CTL: ICEDEBUG Mask */ + +#define WDT_ALTCTL_RSTDSEL_Pos (0) /*!< WDT_T::ALTCTL: RSTDSEL Position */ +#define WDT_ALTCTL_RSTDSEL_Msk (0x3ul << WDT_ALTCTL_RSTDSEL_Pos) /*!< WDT_T::ALTCTL: RSTDSEL Mask */ + +#define WDT_RSTCNT_RSTCNT_Pos (0) /*!< WDT_T::RSTCNT: RSTCNT Position */ +#define WDT_RSTCNT_RSTCNT_Msk (0xfffffffful << WDT_RSTCNT_RSTCNT_Pos) /*!< WDT_T::RSTCNT: RSTCNT Mask */ + +/**@}*/ /* WDT_CONST */ +/**@}*/ /* end of WDT register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __WDT_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/wwdt_reg.h b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/wwdt_reg.h new file mode 100644 index 00000000000..67f5748826a --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Include/wwdt_reg.h @@ -0,0 +1,149 @@ +/**************************************************************************//** + * @file wwdt_reg.h + * @version V1.00 + * @brief WWDT register definition header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __WWDT_REG_H__ +#define __WWDT_REG_H__ + +#if defined ( __CC_ARM ) +#pragma anon_unions +#endif + +/** + @addtogroup REGISTER Control Register + @{ +*/ + +/** + @addtogroup WWDT Window Watchdog Timer(WWDT) + Memory Mapped Structure for WWDT Controller +@{ */ + +typedef struct +{ + + + /** + * @var WWDT_T::RLDCNT + * Offset: 0x00 WWDT Reload Counter Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[31:0] |RLDCNT |WWDT Reload Counter Register + * | | |Writing 0x00005AA5 to this register will reload the WWDT counter value to 0x3F. + * | | |Note: User can only write WWDT_RLDCNT register to reload WWDT counter value when current WWDT counter value between 0 and CMPDAT (WWDT_CTL[21:16]) + * | | |If user writes WWDT_RLDCNT when current WWDT counter value is larger than CMPDAT , WWDT reset signal will generate immediately. + * @var WWDT_T::CTL + * Offset: 0x04 WWDT Control Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |WWDTEN |WWDT Enable Control Bit + * | | |Set this bit to enable WWDT counter counting. + * | | |0 = WWDT counter is stopped. + * | | |1 = WWDT counter is starting counting. + * |[1] |INTEN |WWDT Interrupt Enable Control Bit + * | | |If this bit is enabled, the WWDT counter compare match interrupt signal is generated and inform to CPU. + * | | |0 = WWDT counter compare match interrupt Disabled. + * | | |1 = WWDT counter compare match interrupt Enabled. + * |[11:8] |PSCSEL |WWDT Counter Prescale Period Selection + * | | |0000 = Pre-scale is 1; Max time-out period is 1 * 64 * WWDT_CLK. + * | | |0001 = Pre-scale is 2; Max time-out period is 2 * 64 * WWDT_CLK. + * | | |0010 = Pre-scale is 4; Max time-out period is 4 * 64 * WWDT_CLK. + * | | |0011 = Pre-scale is 8; Max time-out period is 8 * 64 * WWDT_CLK. + * | | |0100 = Pre-scale is 16; Max time-out period is 16 * 64 * WWDT_CLK. + * | | |0101 = Pre-scale is 32; Max time-out period is 32 * 64 * WWDT_CLK. + * | | |0110 = Pre-scale is 64; Max time-out period is 64 * 64 * WWDT_CLK. + * | | |0111 = Pre-scale is 128; Max time-out period is 128 * 64 * WWDT_CLK. + * | | |1000 = Pre-scale is 192; Max time-out period is 192 * 64 * WWDT_CLK. + * | | |1001 = Pre-scale is 256; Max time-out period is 256 * 64 * WWDT_CLK. + * | | |1010 = Pre-scale is 384; Max time-out period is 384 * 64 * WWDT_CLK. + * | | |1011 = Pre-scale is 512; Max time-out period is 512 * 64 * WWDT_CLK. + * | | |1100 = Pre-scale is 768; Max time-out period is 768 * 64 * WWDT_CLK. + * | | |1101 = Pre-scale is 1024; Max time-out period is 1024 * 64 * WWDT_CLK. + * | | |1110 = Pre-scale is 1536; Max time-out period is 1536 * 64 * WWDT_CLK. + * | | |1111 = Pre-scale is 2048; Max time-out period is 2048 * 64 * WWDT_CLK. + * |[21:16] |CMPDAT |WWDT Window Compare Register + * | | |Set this register to adjust the valid reload window. + * | | |Note: User can only write WWDT_RLDCNT register to reload WWDT counter value when current WWDT counter value between 0 and CMPDAT + * | | |If user writes WWDT_RLDCNT register when current WWDT counter value larger than CMPDAT, WWDT reset signal will generate immediately. + * |[31] |ICEDEBUG |ICE Debug Mode Acknowledge Disable Control + * | | |0 = ICE debug mode acknowledgement effects WWDT counting. + * | | |WWDT down counter will be held while CPU is held by ICE. + * | | |1 = ICE debug mode acknowledgement Disabled. + * | | |WWDT down counter will keep going no matter CPU is held by ICE or not. + * @var WWDT_T::STATUS + * Offset: 0x08 WWDT Status Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[0] |WWDTIF |WWDT Compare Match Interrupt Flag + * | | |This bit indicates the interrupt flag status of WWDT while WWDT counter value matches CMPDAT (WWDT_CTL[21:16]). + * | | |0 = No effect. + * | | |1 = WWDT counter value matches CMPDAT. + * | | |Note: This bit is cleared by writing 1 to it. + * |[1] |WWDTRF |WWDT Timer-out Reset Flag + * | | |This bit indicates the system has been reset by WWDT time-out reset or not. + * | | |0 = WWDT time-out reset did not occur. + * | | |1 = WWDT time-out reset occurred. + * | | |Note: This bit is cleared by writing 1 to it. + * @var WWDT_T::CNT + * Offset: 0x0C WWDT Counter Value Register + * --------------------------------------------------------------------------------------------------- + * |Bits |Field |Descriptions + * | :----: | :----: | :---- | + * |[5:0] |CNTDAT |WWDT Counter Value + * | | |CNTDAT will be updated continuously to monitor 6-bit WWDT down counter value. + */ + __O uint32_t RLDCNT; /*!< [0x0000] WWDT Reload Counter Register */ + __IO uint32_t CTL; /*!< [0x0004] WWDT Control Register */ + __IO uint32_t STATUS; /*!< [0x0008] WWDT Status Register */ + __I uint32_t CNT; /*!< [0x000c] WWDT Counter Value Register */ + +} WWDT_T; + +/** + @addtogroup WWDT_CONST WWDT Bit Field Definition + Constant Definitions for WWDT Controller +@{ */ + +#define WWDT_RLDCNT_RLDCNT_Pos (0) /*!< WWDT_T::RLDCNT: RLDCNT Position */ +#define WWDT_RLDCNT_RLDCNT_Msk (0xfffffffful << WWDT_RLDCNT_RLDCNT_Pos) /*!< WWDT_T::RLDCNT: RLDCNT Mask */ + +#define WWDT_CTL_WWDTEN_Pos (0) /*!< WWDT_T::CTL: WWDTEN Position */ +#define WWDT_CTL_WWDTEN_Msk (0x1ul << WWDT_CTL_WWDTEN_Pos) /*!< WWDT_T::CTL: WWDTEN Mask */ + +#define WWDT_CTL_INTEN_Pos (1) /*!< WWDT_T::CTL: INTEN Position */ +#define WWDT_CTL_INTEN_Msk (0x1ul << WWDT_CTL_INTEN_Pos) /*!< WWDT_T::CTL: INTEN Mask */ + +#define WWDT_CTL_PSCSEL_Pos (8) /*!< WWDT_T::CTL: PSCSEL Position */ +#define WWDT_CTL_PSCSEL_Msk (0xful << WWDT_CTL_PSCSEL_Pos) /*!< WWDT_T::CTL: PSCSEL Mask */ + +#define WWDT_CTL_CMPDAT_Pos (16) /*!< WWDT_T::CTL: CMPDAT Position */ +#define WWDT_CTL_CMPDAT_Msk (0x3ful << WWDT_CTL_CMPDAT_Pos) /*!< WWDT_T::CTL: CMPDAT Mask */ + +#define WWDT_CTL_ICEDEBUG_Pos (31) /*!< WWDT_T::CTL: ICEDEBUG Position */ +#define WWDT_CTL_ICEDEBUG_Msk (0x1ul << WWDT_CTL_ICEDEBUG_Pos) /*!< WWDT_T::CTL: ICEDEBUG Mask */ + +#define WWDT_STATUS_WWDTIF_Pos (0) /*!< WWDT_T::STATUS: WWDTIF Position */ +#define WWDT_STATUS_WWDTIF_Msk (0x1ul << WWDT_STATUS_WWDTIF_Pos) /*!< WWDT_T::STATUS: WWDTIF Mask */ + +#define WWDT_STATUS_WWDTRF_Pos (1) /*!< WWDT_T::STATUS: WWDTRF Position */ +#define WWDT_STATUS_WWDTRF_Msk (0x1ul << WWDT_STATUS_WWDTRF_Pos) /*!< WWDT_T::STATUS: WWDTRF Mask */ + +#define WWDT_CNT_CNTDAT_Pos (0) /*!< WWDT_T::CNT: CNTDAT Position */ +#define WWDT_CNT_CNTDAT_Msk (0x3ful << WWDT_CNT_CNTDAT_Pos) /*!< WWDT_T::CNT: CNTDAT Mask */ + +/**@}*/ /* WWDT_CONST */ +/**@}*/ /* end of WWDT register group */ +/**@}*/ /* end of REGISTER group */ + +#if defined ( __CC_ARM ) +#pragma no_anon_unions +#endif + +#endif /* __WWDT_REG_H__ */ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Source/ARM/startup_M480.s b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Source/ARM/startup_M480.s new file mode 100644 index 00000000000..3e31df75cb5 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Source/ARM/startup_M480.s @@ -0,0 +1,514 @@ +;/****************************************************************************** +; * @file startup_M480.s +; * @version V1.00 +; * @brief CMSIS Cortex-M4 Core Device Startup File for M480 +; * +; * @copyright (C) 2017 Nuvoton Technology Corp. All rights reserved. +;*****************************************************************************/ +;/* +;//-------- <<< Use Configuration Wizard in Context Menu >>> ------------------ +;*/ + + +; Stack Configuration +; Stack Size (in Bytes) <0x0-0xFFFFFFFF:8> +; + + IF :LNOT: :DEF: Stack_Size +Stack_Size EQU 0x00000800 + ENDIF + + AREA STACK, NOINIT, READWRITE, ALIGN=3 +Stack_Mem SPACE Stack_Size +__initial_sp + + +; Heap Configuration +; Heap Size (in Bytes) <0x0-0xFFFFFFFF:8> +; + + IF :LNOT: :DEF: Heap_Size +Heap_Size EQU 0x00000100 + ENDIF + + AREA HEAP, NOINIT, READWRITE, ALIGN=3 +__heap_base +Heap_Mem SPACE Heap_Size +__heap_limit + + + PRESERVE8 + THUMB + + +; Vector Table Mapped to Address 0 at Reset + + AREA RESET, DATA, READONLY + EXPORT __Vectors + EXPORT __Vectors_End + EXPORT __Vectors_Size + +__Vectors DCD __initial_sp ; Top of Stack + DCD Reset_Handler ; Reset Handler + DCD NMI_Handler ; NMI Handler + DCD HardFault_Handler ; Hard Fault Handler + DCD MemManage_Handler ; MPU Fault Handler + DCD BusFault_Handler ; Bus Fault Handler + DCD UsageFault_Handler ; Usage Fault Handler + DCD 0 ; Reserved + DCD 0 ; Reserved + DCD 0 ; Reserved + DCD 0 ; Reserved + DCD SVC_Handler ; SVCall Handler + DCD DebugMon_Handler ; Debug Monitor Handler + DCD 0 ; Reserved + DCD PendSV_Handler ; PendSV Handler + DCD SysTick_Handler ; SysTick Handler + + ; External Interrupts + DCD BOD_IRQHandler ; 0: Brown Out detection + DCD IRC_IRQHandler ; 1: Internal RC + DCD PWRWU_IRQHandler ; 2: Power down wake up + DCD RAMPE_IRQHandler ; 3: RAM parity error + DCD CKFAIL_IRQHandler ; 4: Clock detection fail + DCD Default_Handler ; 5: Reserved + DCD RTC_IRQHandler ; 6: Real Time Clock + DCD TAMPER_IRQHandler ; 7: Tamper detection + DCD WDT_IRQHandler ; 8: Watchdog timer + DCD WWDT_IRQHandler ; 9: Window watchdog timer + DCD EINT0_IRQHandler ; 10: External Input 0 + DCD EINT1_IRQHandler ; 11: External Input 1 + DCD EINT2_IRQHandler ; 12: External Input 2 + DCD EINT3_IRQHandler ; 13: External Input 3 + DCD EINT4_IRQHandler ; 14: External Input 4 + DCD EINT5_IRQHandler ; 15: External Input 5 + DCD GPA_IRQHandler ; 16: GPIO Port A + DCD GPB_IRQHandler ; 17: GPIO Port B + DCD GPC_IRQHandler ; 18: GPIO Port C + DCD GPD_IRQHandler ; 19: GPIO Port D + DCD GPE_IRQHandler ; 20: GPIO Port E + DCD GPF_IRQHandler ; 21: GPIO Port F + DCD QSPI0_IRQHandler ; 22: QSPI0 + DCD SPI0_IRQHandler ; 23: SPI0 + DCD BRAKE0_IRQHandler ; 24: + DCD EPWM0P0_IRQHandler ; 25: + DCD EPWM0P1_IRQHandler ; 26: + DCD EPWM0P2_IRQHandler ; 27: + DCD BRAKE1_IRQHandler ; 28: + DCD EPWM1P0_IRQHandler ; 29: + DCD EPWM1P1_IRQHandler ; 30: + DCD EPWM1P2_IRQHandler ; 31: + DCD TMR0_IRQHandler ; 32: Timer 0 + DCD TMR1_IRQHandler ; 33: Timer 1 + DCD TMR2_IRQHandler ; 34: Timer 2 + DCD TMR3_IRQHandler ; 35: Timer 3 + DCD UART0_IRQHandler ; 36: UART0 + DCD UART1_IRQHandler ; 37: UART1 + DCD I2C0_IRQHandler ; 38: I2C0 + DCD I2C1_IRQHandler ; 39: I2C1 + DCD PDMA_IRQHandler ; 40: Peripheral DMA + DCD DAC_IRQHandler ; 41: DAC + DCD EADC00_IRQHandler ; 42: EADC0 interrupt source 0 + DCD EADC01_IRQHandler ; 43: EADC0 interrupt source 1 + DCD ACMP01_IRQHandler ; 44: ACMP0 and ACMP1 + DCD Default_Handler ; 45: Reserved + DCD EADC02_IRQHandler ; 46: EADC0 interrupt source 2 + DCD EADC03_IRQHandler ; 47: EADC0 interrupt source 3 + DCD UART2_IRQHandler ; 48: UART2 + DCD UART3_IRQHandler ; 49: UART3 + DCD QSPI1_IRQHandler ; 50: QSPI1 + DCD SPI1_IRQHandler ; 51: SPI1 + DCD SPI2_IRQHandler ; 52: SPI2 + DCD USBD_IRQHandler ; 53: USB device + DCD OHCI_IRQHandler ; 54: OHCI + DCD USBOTG_IRQHandler ; 55: USB OTG + DCD CAN0_IRQHandler ; 56: CAN0 + DCD CAN1_IRQHandler ; 57: CAN1 + DCD SC0_IRQHandler ; 58: + DCD SC1_IRQHandler ; 59: + DCD SC2_IRQHandler ; 60: + DCD Default_Handler ; 61: + DCD SPI3_IRQHandler ; 62: SPI3 + DCD Default_Handler ; 63: + DCD SDH0_IRQHandler ; 64: SDH0 + DCD USBD20_IRQHandler ; 65: USBD20 + DCD EMAC_TX_IRQHandler ; 66: EMAC_TX + DCD EMAC_RX_IRQHandler ; 67: EMAX_RX + DCD I2S0_IRQHandler ; 68: I2S0 + DCD Default_Handler ; 69: ToDo: Add description to this Interrupt + DCD OPA0_IRQHandler ; 70: OPA0 + DCD CRYPTO_IRQHandler ; 71: CRYPTO + DCD GPG_IRQHandler ; 72: + DCD EINT6_IRQHandler ; 73: + DCD UART4_IRQHandler ; 74: UART4 + DCD UART5_IRQHandler ; 75: UART5 + DCD USCI0_IRQHandler ; 76: USCI0 + DCD USCI1_IRQHandler ; 77: USCI1 + DCD BPWM0_IRQHandler ; 78: BPWM0 + DCD BPWM1_IRQHandler ; 79: BPWM1 + DCD SPIM_IRQHandler ; 80: SPIM + DCD CCAP_IRQHandler ; 81: CCAP + DCD I2C2_IRQHandler ; 82: I2C2 + DCD Default_Handler ; 83: + DCD QEI0_IRQHandler ; 84: QEI0 + DCD QEI1_IRQHandler ; 85: QEI1 + DCD ECAP0_IRQHandler ; 86: ECAP0 + DCD ECAP1_IRQHandler ; 87: ECAP1 + DCD GPH_IRQHandler ; 88: + DCD EINT7_IRQHandler ; 89: + DCD SDH1_IRQHandler ; 90: SDH1 + DCD Default_Handler ; 91: + DCD EHCI_IRQHandler ; 92: EHCI + DCD USBOTG20_IRQHandler ; 93: + DCD Default_Handler ; 94: + DCD Default_Handler ; 95: + DCD Default_Handler ; 96: + DCD Default_Handler ; 97: + DCD Default_Handler ; 98: + DCD Default_Handler ; 99: + DCD Default_Handler ; 100: + DCD TRNG_IRQHandler ; 101: TRNG + DCD UART6_IRQHandler ; 102: UART6 + DCD UART7_IRQHandler ; 103: UART7 + DCD EADC10_IRQHandler ; 104: EADC1 interrupt source 0 + DCD EADC11_IRQHandler ; 105: EADC1 interrupt source 1 + DCD EADC12_IRQHandler ; 106: EADC1 interrupt source 2 + DCD EADC13_IRQHandler ; 107: EADC1 interrupt source 3 + DCD CAN2_IRQHandler ; 108: CAN2 + + +__Vectors_End + +__Vectors_Size EQU __Vectors_End - __Vectors + + AREA |.text|, CODE, READONLY + + +; Reset Handler + +Reset_Handler PROC + EXPORT Reset_Handler [WEAK] + IMPORT SystemInit + IMPORT __main + + ; Unlock Register + LDR R0, =0x40000100 + LDR R1, =0x59 + STR R1, [R0] + LDR R1, =0x16 + STR R1, [R0] + LDR R1, =0x88 + STR R1, [R0] + + IF :LNOT: :DEF: ENABLE_SPIM_CACHE + LDR R0, =0x40000200 ; R0 = Clock Controller Register Base Address + LDR R1, [R0,#0x4] ; R1 = 0x40000204 (AHBCLK) + ORR R1, R1, #0x4000 + STR R1, [R0,#0x4] ; CLK->AHBCLK |= CLK_AHBCLK_SPIMCKEN_Msk; + + LDR R0, =0x40007000 ; R0 = SPIM Register Base Address + LDR R1, [R0,#4] ; R1 = SPIM->CTL1 + ORR R1, R1,#2 ; R1 |= SPIM_CTL1_CACHEOFF_Msk + STR R1, [R0,#4] ; _SPIM_DISABLE_CACHE() + LDR R1, [R0,#4] ; R1 = SPIM->CTL1 + ORR R1, R1, #4 ; R1 |= SPIM_CTL1_CCMEN_Msk + STR R1, [R0,#4] ; _SPIM_ENABLE_CCM() + ENDIF + + LDR R0, =SystemInit + BLX R0 + + ; Init POR + ; LDR R2, =0x40000024 + ; LDR R1, =0x00005AA5 + ; STR R1, [R2] + + ; Lock + LDR R0, =0x40000100 + LDR R1, =0 + STR R1, [R0] + + LDR R0, =__main + BX R0 + + ENDP + + +; Dummy Exception Handlers (infinite loops which can be modified) + +NMI_Handler PROC + EXPORT NMI_Handler [WEAK] + B . + ENDP +HardFault_Handler\ + PROC + EXPORT HardFault_Handler [WEAK] + B . + ENDP +MemManage_Handler\ + PROC + EXPORT MemManage_Handler [WEAK] + B . + ENDP +BusFault_Handler\ + PROC + EXPORT BusFault_Handler [WEAK] + B . + ENDP +UsageFault_Handler\ + PROC + EXPORT UsageFault_Handler [WEAK] + B . + ENDP +SVC_Handler PROC + EXPORT SVC_Handler [WEAK] + B . + ENDP +DebugMon_Handler\ + PROC + EXPORT DebugMon_Handler [WEAK] + B . + ENDP +PendSV_Handler\ + PROC + EXPORT PendSV_Handler [WEAK] + B . + ENDP +SysTick_Handler\ + PROC + EXPORT SysTick_Handler [WEAK] + B . + ENDP + +Default_Handler PROC + + EXPORT BOD_IRQHandler [WEAK] + EXPORT IRC_IRQHandler [WEAK] + EXPORT PWRWU_IRQHandler [WEAK] + EXPORT RAMPE_IRQHandler [WEAK] + EXPORT CKFAIL_IRQHandler [WEAK] + EXPORT RTC_IRQHandler [WEAK] + EXPORT TAMPER_IRQHandler [WEAK] + EXPORT WDT_IRQHandler [WEAK] + EXPORT WWDT_IRQHandler [WEAK] + EXPORT EINT0_IRQHandler [WEAK] + EXPORT EINT1_IRQHandler [WEAK] + EXPORT EINT2_IRQHandler [WEAK] + EXPORT EINT3_IRQHandler [WEAK] + EXPORT EINT4_IRQHandler [WEAK] + EXPORT EINT5_IRQHandler [WEAK] + EXPORT GPA_IRQHandler [WEAK] + EXPORT GPB_IRQHandler [WEAK] + EXPORT GPC_IRQHandler [WEAK] + EXPORT GPD_IRQHandler [WEAK] + EXPORT GPE_IRQHandler [WEAK] + EXPORT GPF_IRQHandler [WEAK] + EXPORT QSPI0_IRQHandler [WEAK] + EXPORT SPI0_IRQHandler [WEAK] + EXPORT BRAKE0_IRQHandler [WEAK] + EXPORT EPWM0P0_IRQHandler [WEAK] + EXPORT EPWM0P1_IRQHandler [WEAK] + EXPORT EPWM0P2_IRQHandler [WEAK] + EXPORT BRAKE1_IRQHandler [WEAK] + EXPORT EPWM1P0_IRQHandler [WEAK] + EXPORT EPWM1P1_IRQHandler [WEAK] + EXPORT EPWM1P2_IRQHandler [WEAK] + EXPORT TMR0_IRQHandler [WEAK] + EXPORT TMR1_IRQHandler [WEAK] + EXPORT TMR2_IRQHandler [WEAK] + EXPORT TMR3_IRQHandler [WEAK] + EXPORT UART0_IRQHandler [WEAK] + EXPORT UART1_IRQHandler [WEAK] + EXPORT I2C0_IRQHandler [WEAK] + EXPORT I2C1_IRQHandler [WEAK] + EXPORT PDMA_IRQHandler [WEAK] + EXPORT DAC_IRQHandler [WEAK] + EXPORT EADC00_IRQHandler [WEAK] + EXPORT EADC01_IRQHandler [WEAK] + EXPORT ACMP01_IRQHandler [WEAK] + EXPORT EADC02_IRQHandler [WEAK] + EXPORT EADC03_IRQHandler [WEAK] + EXPORT UART2_IRQHandler [WEAK] + EXPORT UART3_IRQHandler [WEAK] + EXPORT QSPI1_IRQHandler [WEAK] + EXPORT SPI1_IRQHandler [WEAK] + EXPORT SPI2_IRQHandler [WEAK] + EXPORT USBD_IRQHandler [WEAK] + EXPORT OHCI_IRQHandler [WEAK] + EXPORT USBOTG_IRQHandler [WEAK] + EXPORT CAN0_IRQHandler [WEAK] + EXPORT CAN1_IRQHandler [WEAK] + EXPORT SC0_IRQHandler [WEAK] + EXPORT SC1_IRQHandler [WEAK] + EXPORT SC2_IRQHandler [WEAK] + EXPORT SPI3_IRQHandler [WEAK] + EXPORT SDH0_IRQHandler [WEAK] + EXPORT USBD20_IRQHandler [WEAK] + EXPORT EMAC_TX_IRQHandler [WEAK] + EXPORT EMAC_RX_IRQHandler [WEAK] + EXPORT I2S0_IRQHandler [WEAK] + EXPORT OPA0_IRQHandler [WEAK] + EXPORT CRYPTO_IRQHandler [WEAK] + EXPORT GPG_IRQHandler [WEAK] + EXPORT EINT6_IRQHandler [WEAK] + EXPORT UART4_IRQHandler [WEAK] + EXPORT UART5_IRQHandler [WEAK] + EXPORT USCI0_IRQHandler [WEAK] + EXPORT USCI1_IRQHandler [WEAK] + EXPORT BPWM0_IRQHandler [WEAK] + EXPORT BPWM1_IRQHandler [WEAK] + EXPORT SPIM_IRQHandler [WEAK] + EXPORT CCAP_IRQHandler [WEAK] + EXPORT I2C2_IRQHandler [WEAK] + EXPORT QEI0_IRQHandler [WEAK] + EXPORT QEI1_IRQHandler [WEAK] + EXPORT ECAP0_IRQHandler [WEAK] + EXPORT ECAP1_IRQHandler [WEAK] + EXPORT GPH_IRQHandler [WEAK] + EXPORT EINT7_IRQHandler [WEAK] + EXPORT SDH1_IRQHandler [WEAK] + EXPORT EHCI_IRQHandler [WEAK] + EXPORT USBOTG20_IRQHandler [WEAK] + EXPORT TRNG_IRQHandler [WEAK] + EXPORT UART6_IRQHandler [WEAK] + EXPORT UART7_IRQHandler [WEAK] + EXPORT EADC10_IRQHandler [WEAK] + EXPORT EADC11_IRQHandler [WEAK] + EXPORT EADC12_IRQHandler [WEAK] + EXPORT EADC13_IRQHandler [WEAK] + EXPORT CAN2_IRQHandler [WEAK] + +Default__IRQHandler +BOD_IRQHandler +IRC_IRQHandler +PWRWU_IRQHandler +RAMPE_IRQHandler +CKFAIL_IRQHandler +RTC_IRQHandler +TAMPER_IRQHandler +WDT_IRQHandler +WWDT_IRQHandler +EINT0_IRQHandler +EINT1_IRQHandler +EINT2_IRQHandler +EINT3_IRQHandler +EINT4_IRQHandler +EINT5_IRQHandler +GPA_IRQHandler +GPB_IRQHandler +GPC_IRQHandler +GPD_IRQHandler +GPE_IRQHandler +GPF_IRQHandler +QSPI0_IRQHandler +SPI0_IRQHandler +BRAKE0_IRQHandler +EPWM0P0_IRQHandler +EPWM0P1_IRQHandler +EPWM0P2_IRQHandler +BRAKE1_IRQHandler +EPWM1P0_IRQHandler +EPWM1P1_IRQHandler +EPWM1P2_IRQHandler +TMR0_IRQHandler +TMR1_IRQHandler +TMR2_IRQHandler +TMR3_IRQHandler +UART0_IRQHandler +UART1_IRQHandler +I2C0_IRQHandler +I2C1_IRQHandler +PDMA_IRQHandler +DAC_IRQHandler +EADC00_IRQHandler +EADC01_IRQHandler +ACMP01_IRQHandler +EADC02_IRQHandler +EADC03_IRQHandler +UART2_IRQHandler +UART3_IRQHandler +QSPI1_IRQHandler +SPI1_IRQHandler +SPI2_IRQHandler +USBD_IRQHandler +OHCI_IRQHandler +USBOTG_IRQHandler +CAN0_IRQHandler +CAN1_IRQHandler +SC0_IRQHandler +SC1_IRQHandler +SC2_IRQHandler +SPI3_IRQHandler +SDH0_IRQHandler +USBD20_IRQHandler +EMAC_TX_IRQHandler +EMAC_RX_IRQHandler +I2S0_IRQHandler +OPA0_IRQHandler +CRYPTO_IRQHandler +GPG_IRQHandler +EINT6_IRQHandler +UART4_IRQHandler +UART5_IRQHandler +USCI0_IRQHandler +USCI1_IRQHandler +BPWM0_IRQHandler +BPWM1_IRQHandler +SPIM_IRQHandler +CCAP_IRQHandler +I2C2_IRQHandler +QEI0_IRQHandler +QEI1_IRQHandler +ECAP0_IRQHandler +ECAP1_IRQHandler +GPH_IRQHandler +EINT7_IRQHandler +SDH1_IRQHandler +EHCI_IRQHandler +USBOTG20_IRQHandler +TRNG_IRQHandler +UART6_IRQHandler +UART7_IRQHandler +EADC10_IRQHandler +EADC11_IRQHandler +EADC12_IRQHandler +EADC13_IRQHandler +CAN2_IRQHandler + + + + B . + ENDP + + + ALIGN + + +; User Initial Stack & Heap + + IF :DEF:__MICROLIB + + EXPORT __initial_sp + EXPORT __heap_base + EXPORT __heap_limit + + ELSE + + IMPORT __use_two_region_memory + EXPORT __user_initial_stackheap + +__user_initial_stackheap PROC + LDR R0, = Heap_Mem + LDR R1, =(Stack_Mem + Stack_Size) + LDR R2, = (Heap_Mem + Heap_Size) + LDR R3, = Stack_Mem + BX LR + ENDP + + ALIGN + + ENDIF + + + END +;/*** (C) COPYRIGHT 2017 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Source/GCC/startup_M480.S b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Source/GCC/startup_M480.S new file mode 100644 index 00000000000..a4eb650ee2c --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Source/GCC/startup_M480.S @@ -0,0 +1,375 @@ +/****************************************************************************//** + * @file startup_M480.S + * @version V1.00 + * @brief CMSIS Cortex-M4 Core Device Startup File for M480 + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ + .syntax unified + .cpu cortex-m4 + .fpu softvfp + .thumb + +.global g_pfnVectors +.global Default_Handler + +/* start address for the initialization values of the .data section. +defined in linker script */ +.word _sidata +/* start address for the .data section. defined in linker script */ +.word _sdata +/* end address for the .data section. defined in linker script */ +.word _edata +/* start address for the .bss section. defined in linker script */ +.word _sbss +/* end address for the .bss section. defined in linker script */ +.word _ebss + +/** + * @brief This is the code that gets called when the processor first + * starts execution following a reset event. Only the absolutely + * necessary set is performed, after which the application + * supplied main() routine is called. + * @param None + * @retval : None +*/ + + .section .text.Reset_Handler + .weak Reset_Handler + .type Reset_Handler, %function +Reset_Handler: + + // Unlock Register + ldr r0, =0x40000100 + ldr r1, =0x59 + str r1, [r0] + ldr r1, =0x16 + str r1, [r0] + ldr r1, =0x88 + str r1, [r0] + +#ifndef ENABLE_SPIM_CACHE + ldr r0, =0x40000200 // R0 = Clock Controller Register Base Address + ldr r1, [r0,#0x4] // R1 = 0x40000204 (AHBCLK) + orr r1, r1, #0x4000 + str r1, [r0,#0x4] // CLK->AHBCLK |= CLK_AHBCLK_SPIMCKEN_Msk// + + ldr r0, =0x40007000 // R0 = SPIM Register Base Address + ldr r1, [r0,#4] // R1 = SPIM->CTL1 + orr r1, r1,#2 // R1 |= SPIM_CTL1_CACHEOFF_Msk + str r1, [r0,#4] // _SPIM_DISABLE_CACHE() + ldr r1, [r0,#4] // R1 = SPIM->CTL1 + orr r1, r1, #4 // R1 |= SPIM_CTL1_CCMEN_Msk + str r1, [r0,#4] // _SPIM_ENABLE_CCM() +#endif + +#ifndef __NO_SYSTEM_INIT + bl SystemInit +#endif + + // Lock + ldr r0, =0x40000100 + ldr r1, =0 + str r1, [r0] + +/* Copy the data segment initializers from flash to SRAM */ + movs r1, #0 + b LoopCopyDataInit + +CopyDataInit: + ldr r3, =_sidata + ldr r3, [r3, r1] + str r3, [r0, r1] + adds r1, r1, #4 + +LoopCopyDataInit: + ldr r0, =_sdata + ldr r3, =_edata + adds r2, r0, r1 + cmp r2, r3 + bcc CopyDataInit + ldr r2, =_sbss + b LoopFillZerobss +/* Zero fill the bss segment. */ +FillZerobss: + movs r3, #0 + str r3, [r2], #4 + +LoopFillZerobss: + ldr r3, = _ebss + cmp r2, r3 + bcc FillZerobss + +/* Call the application's entry point.*/ + bl entry + bx lr +.size Reset_Handler, .-Reset_Handler + +/** + * @brief This is the code that gets called when the processor receives an + * unexpected interrupt. This simply enters an infinite loop, preserving + * the system state for examination by a debugger. + * @param None + * @retval None +*/ + .section .text.Default_Handler,"ax",%progbits +Default_Handler: +Infinite_Loop: + b Infinite_Loop + .size Default_Handler, .-Default_Handler +/****************************************************************************** +* +* The minimal vector table for a Cortex M4. Note that the proper constructs +* must be placed on this to ensure that it ends up at physical address +* 0x0000.0000. +* +******************************************************************************/ + .section .isr_vector,"a",%progbits + .type g_pfnVectors, %object + .size g_pfnVectors, .-g_pfnVectors + + +g_pfnVectors: + .word _estack // Top of Stack + .word Reset_Handler // Reset Handler + .word NMI_Handler // NMI Handler + .word HardFault_Handler // Hard Fault Handler + .word MemManage_Handler // MPU Fault Handler + .word BusFault_Handler // Bus Fault Handler + .word UsageFault_Handler // Usage Fault Handler + .word 0 // Reserved + .word 0 // DCDReserved + .word 0 // Reserved + .word 0 // Reserved + .word SVC_Handler // SVCall Handler + .word DebugMon_Handler // Debug Monitor Handler + .word 0 // Reserved + .word PendSV_Handler // PendSV Handler + .word SysTick_Handler // SysTick Handler + + // External Interrupts + .word BOD_IRQHandler /* 0: BOD */ + .word IRC_IRQHandler /* 1: IRC */ + .word PWRWU_IRQHandler /* 2: PWRWU */ + .word RAMPE_IRQHandler /* 3: RAMPE */ + .word CKFAIL_IRQHandler /* 4: CKFAIL */ + .word 0 /* 5: Reserved */ + .word RTC_IRQHandler /* 6: RTC */ + .word TAMPER_IRQHandler /* 7: TAMPER */ + .word WDT_IRQHandler /* 8: WDT */ + .word WWDT_IRQHandler /* 9: WWDT */ + .word EINT0_IRQHandler /* 10: EINT0 */ + .word EINT1_IRQHandler /* 11: EINT1 */ + .word EINT2_IRQHandler /* 12: EINT2 */ + .word EINT3_IRQHandler /* 13: EINT3 */ + .word EINT4_IRQHandler /* 14: EINT4 */ + .word EINT5_IRQHandler /* 15: EINT5 */ + .word GPA_IRQHandler /* 16: GPA */ + .word GPB_IRQHandler /* 17: GPB */ + .word GPC_IRQHandler /* 18: GPC */ + .word GPD_IRQHandler /* 19: GPD */ + .word GPE_IRQHandler /* 20: GPE */ + .word GPF_IRQHandler /* 21: GPF */ + .word QSPI0_IRQHandler /* 22: QSPI0 */ + .word SPI0_IRQHandler /* 23: SPI0 */ + .word BRAKE0_IRQHandler /* 24: BRAKE0 */ + .word EPWM0P0_IRQHandler /* 25: EPWM0P0 */ + .word EPWM0P1_IRQHandler /* 26: EPWM0P1 */ + .word EPWM0P2_IRQHandler /* 27: EPWM0P2 */ + .word BRAKE1_IRQHandler /* 28: BRAKE1 */ + .word EPWM1P0_IRQHandler /* 29: EPWM1P0 */ + .word EPWM1P1_IRQHandler /* 30: EPWM1P1 */ + .word EPWM1P2_IRQHandler /* 31: EPWM1P2 */ + .word TMR0_IRQHandler /* 32: TIMER0 */ + .word TMR1_IRQHandler /* 33: TIMER1 */ + .word TMR2_IRQHandler /* 34: TIMER2 */ + .word TMR3_IRQHandler /* 35: TIMER3 */ + .word UART0_IRQHandler /* 36: UART0 */ + .word UART1_IRQHandler /* 37: UART1 */ + .word I2C0_IRQHandler /* 38: I2C0 */ + .word I2C1_IRQHandler /* 39: I2C1 */ + .word PDMA_IRQHandler /* 40: PDMA */ + .word DAC_IRQHandler /* 41: DAC */ + .word EADC00_IRQHandler /* 42: EADC00 */ + .word EADC01_IRQHandler /* 43: EADC01 */ + .word ACMP01_IRQHandler /* 44: ACMP */ + .word 0 /* 45: Reserved */ + .word EADC02_IRQHandler /* 46: EADC02 */ + .word EADC03_IRQHandler /* 47: EADC03 */ + .word UART2_IRQHandler /* 48: UART2 */ + .word UART3_IRQHandler /* 49: UART3 */ + .word QSPI1_IRQHandler /* 50: QSPI1 */ + .word SPI1_IRQHandler /* 51: SPI1 */ + .word SPI2_IRQHandler /* 52: SPI2 */ + .word USBD_IRQHandler /* 53: USBD */ + .word OHCI_IRQHandler /* 54: OHCI */ + .word USBOTG_IRQHandler /* 55: OTG */ + .word CAN0_IRQHandler /* 56: CAN0 */ + .word CAN1_IRQHandler /* 57: CAN1 */ + .word SC0_IRQHandler /* 58: SC0 */ + .word SC1_IRQHandler /* 59: SC1 */ + .word SC2_IRQHandler /* 60: SC2 */ + .word 0 /* 61: Reserved */ + .word SPI3_IRQHandler /* 62: SPI3 */ + .word 0 /* 63: Reserved */ + .word SDH0_IRQHandler /* 64: SDH0 */ + .word USBD20_IRQHandler /* 65: HSUSBD */ + .word EMAC_TX_IRQHandler /* 66: EMAC_TX */ + .word EMAC_RX_IRQHandler /* 67: EMAC_RX */ + .word I2S0_IRQHandler /* 68: I2S */ + .word 0 /* 69: Reserved */ + .word OPA0_IRQHandler /* 70: OPA */ + .word CRYPTO_IRQHandler /* 71: CRYPTO */ + .word GPG_IRQHandler /* 72: GPG */ + .word EINT6_IRQHandler /* 73: EINT6 */ + .word UART4_IRQHandler /* 74: UART4 */ + .word UART5_IRQHandler /* 75: UART5 */ + .word USCI0_IRQHandler /* 76: USCI0 */ + .word USCI1_IRQHandler /* 77: USCI1 */ + .word BPWM0_IRQHandler /* 78: BPWM0 */ + .word BPWM1_IRQHandler /* 79: BPWM1 */ + .word SPIM_IRQHandler /* 80: SPIM */ + .word CCAP_IRQHandler /* 81: CCAP */ + .word I2C2_IRQHandler /* 82: I2C2 */ + .word 0 /* 83: Reserved */ + .word QEI0_IRQHandler /* 84: QEI0 */ + .word QEI1_IRQHandler /* 85: QEI1 */ + .word ECAP0_IRQHandler /* 86: ECAP0 */ + .word ECAP1_IRQHandler /* 87: ECAP1 */ + .word GPH_IRQHandler /* 88: GPH */ + .word EINT7_IRQHandler /* 89: EINT7 */ + .word SDH1_IRQHandler /* 90: SDH1 */ + .word 0 /* 91: Reserved */ + .word EHCI_IRQHandler /* 92: EHCI */ + .word USBOTG20_IRQHandler /* 93: HSOTG */ + .word 0 /* 94: Reserved */ + .word 0 /* 95: Reserved */ + .word 0 /* 96: Reserved */ + .word 0 /* 97: Reserved */ + .word 0 /* 98: Reserved */ + .word 0 /* 99: Reserved */ + .word 0 /* 100: Reserved */ + .word TRNG_IRQHandler /* 101: TRNG */ + .word UART6_IRQHandler /* 102: UART6 */ + .word UART7_IRQHandler /* 103: UART7 */ + .word EADC10_IRQHandler /* 104: EADC10 */ + .word EADC11_IRQHandler /* 105: EADC11 */ + .word EADC12_IRQHandler /* 106: EADC12 */ + .word EADC13_IRQHandler /* 107: EADC13 */ + .word CAN2_IRQHandler /* 108: CAN2 */ + + +/* Macro to define default handlers. Default handler + * will be weak symbol and just dead loops. They can be + * overwritten by other handlers */ + .macro def_irq_handler handler_name + .weak \handler_name + .set \handler_name, Default_Handler + .endm + + def_irq_handler NMI_Handler + def_irq_handler HardFault_Handler + def_irq_handler MemManage_Handler + def_irq_handler BusFault_Handler + def_irq_handler UsageFault_Handler + def_irq_handler SVC_Handler + def_irq_handler DebugMon_Handler + def_irq_handler PendSV_Handler + def_irq_handler SysTick_Handler + + def_irq_handler BOD_IRQHandler + def_irq_handler IRC_IRQHandler + def_irq_handler PWRWU_IRQHandler + def_irq_handler RAMPE_IRQHandler + def_irq_handler CKFAIL_IRQHandler + def_irq_handler RTC_IRQHandler + def_irq_handler TAMPER_IRQHandler + def_irq_handler WDT_IRQHandler + def_irq_handler WWDT_IRQHandler + def_irq_handler EINT0_IRQHandler + def_irq_handler EINT1_IRQHandler + def_irq_handler EINT2_IRQHandler + def_irq_handler EINT3_IRQHandler + def_irq_handler EINT4_IRQHandler + def_irq_handler EINT5_IRQHandler + def_irq_handler GPA_IRQHandler + def_irq_handler GPB_IRQHandler + def_irq_handler GPC_IRQHandler + def_irq_handler GPD_IRQHandler + def_irq_handler GPE_IRQHandler + def_irq_handler GPF_IRQHandler + def_irq_handler QSPI0_IRQHandler + def_irq_handler SPI0_IRQHandler + def_irq_handler BRAKE0_IRQHandler + def_irq_handler EPWM0P0_IRQHandler + def_irq_handler EPWM0P1_IRQHandler + def_irq_handler EPWM0P2_IRQHandler + def_irq_handler BRAKE1_IRQHandler + def_irq_handler EPWM1P0_IRQHandler + def_irq_handler EPWM1P1_IRQHandler + def_irq_handler EPWM1P2_IRQHandler + def_irq_handler TMR0_IRQHandler + def_irq_handler TMR1_IRQHandler + def_irq_handler TMR2_IRQHandler + def_irq_handler TMR3_IRQHandler + def_irq_handler UART0_IRQHandler + def_irq_handler UART1_IRQHandler + def_irq_handler I2C0_IRQHandler + def_irq_handler I2C1_IRQHandler + def_irq_handler PDMA_IRQHandler + def_irq_handler DAC_IRQHandler + def_irq_handler EADC00_IRQHandler + def_irq_handler EADC01_IRQHandler + def_irq_handler ACMP01_IRQHandler + def_irq_handler EADC02_IRQHandler + def_irq_handler EADC03_IRQHandler + def_irq_handler UART2_IRQHandler + def_irq_handler UART3_IRQHandler + def_irq_handler QSPI1_IRQHandler + def_irq_handler SPI1_IRQHandler + def_irq_handler SPI2_IRQHandler + def_irq_handler USBD_IRQHandler + def_irq_handler OHCI_IRQHandler + def_irq_handler USBOTG_IRQHandler + def_irq_handler CAN0_IRQHandler + def_irq_handler CAN1_IRQHandler + def_irq_handler SC0_IRQHandler + def_irq_handler SC1_IRQHandler + def_irq_handler SC2_IRQHandler + def_irq_handler SPI3_IRQHandler + def_irq_handler SDH0_IRQHandler + def_irq_handler USBD20_IRQHandler + def_irq_handler EMAC_TX_IRQHandler + def_irq_handler EMAC_RX_IRQHandler + def_irq_handler I2S0_IRQHandler + def_irq_handler OPA0_IRQHandler + def_irq_handler CRYPTO_IRQHandler + def_irq_handler GPG_IRQHandler + def_irq_handler EINT6_IRQHandler + def_irq_handler UART4_IRQHandler + def_irq_handler UART5_IRQHandler + def_irq_handler USCI0_IRQHandler + def_irq_handler USCI1_IRQHandler + def_irq_handler BPWM0_IRQHandler + def_irq_handler BPWM1_IRQHandler + def_irq_handler SPIM_IRQHandler + def_irq_handler CCAP_IRQHandler + def_irq_handler I2C2_IRQHandler + def_irq_handler QEI0_IRQHandler + def_irq_handler QEI1_IRQHandler + def_irq_handler ECAP0_IRQHandler + def_irq_handler ECAP1_IRQHandler + def_irq_handler GPH_IRQHandler + def_irq_handler EINT7_IRQHandler + def_irq_handler SDH1_IRQHandler + def_irq_handler EHCI_IRQHandler + def_irq_handler USBOTG20_IRQHandler + def_irq_handler TRNG_IRQHandler + def_irq_handler UART6_IRQHandler + def_irq_handler UART7_IRQHandler + def_irq_handler EADC10_IRQHandler + def_irq_handler EADC11_IRQHandler + def_irq_handler EADC12_IRQHandler + def_irq_handler EADC13_IRQHandler + def_irq_handler CAN2_IRQHandler diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Source/IAR/startup_M480.s b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Source/IAR/startup_M480.s new file mode 100644 index 00000000000..9aa379a7584 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Source/IAR/startup_M480.s @@ -0,0 +1,451 @@ +;/****************************************************************************** +; * @file startup_M480.s +; * @version V1.00 +; * @brief CMSIS Cortex-M4 Core Device Startup File for M480 +; * +; * @copyright (C) 2016 Nuvoton Technology Corp. All rights reserved. +;*****************************************************************************/ + + MODULE ?cstartup + + ;; Forward declaration of sections. + SECTION CSTACK:DATA:NOROOT(3) + + SECTION .intvec:CODE:NOROOT(2) + + EXTERN __iar_program_start + EXTERN HardFault_Handler + EXTERN SystemInit + PUBLIC __vector_table + PUBLIC __vector_table_0x1c + PUBLIC __Vectors + PUBLIC __Vectors_End + PUBLIC __Vectors_Size + + DATA + +__vector_table + DCD sfe(CSTACK) + DCD Reset_Handler + + DCD NMI_Handler + DCD HardFault_Handler + DCD MemManage_Handler + DCD BusFault_Handler + DCD UsageFault_Handler +__vector_table_0x1c + DCD 0 + DCD 0 + DCD 0 + DCD 0 + DCD SVC_Handler + DCD DebugMon_Handler + DCD 0 + DCD PendSV_Handler + DCD SysTick_Handler + + ; External Interrupts + DCD BOD_IRQHandler ; 0: Brown Out detection + DCD IRC_IRQHandler ; 1: Internal RC + DCD PWRWU_IRQHandler ; 2: Power down wake up + DCD RAMPE_IRQHandler ; 3: RAM parity error + DCD CKFAIL_IRQHandler ; 4: Clock detection fail + DCD Default_Handler ; 5: Reserved + DCD RTC_IRQHandler ; 6: Real Time Clock + DCD TAMPER_IRQHandler ; 7: Tamper detection + DCD WDT_IRQHandler ; 8: Watchdog timer + DCD WWDT_IRQHandler ; 9: Window watchdog timer + DCD EINT0_IRQHandler ; 10: External Input 0 + DCD EINT1_IRQHandler ; 11: External Input 1 + DCD EINT2_IRQHandler ; 12: External Input 2 + DCD EINT3_IRQHandler ; 13: External Input 3 + DCD EINT4_IRQHandler ; 14: External Input 4 + DCD EINT5_IRQHandler ; 15: External Input 5 + DCD GPA_IRQHandler ; 16: GPIO Port A + DCD GPB_IRQHandler ; 17: GPIO Port B + DCD GPC_IRQHandler ; 18: GPIO Port C + DCD GPD_IRQHandler ; 19: GPIO Port D + DCD GPE_IRQHandler ; 20: GPIO Port E + DCD GPF_IRQHandler ; 21: GPIO Port F + DCD QSPI0_IRQHandler ; 22: QSPI0 + DCD SPI0_IRQHandler ; 23: SPI0 + DCD BRAKE0_IRQHandler ; 24: + DCD PWM0P0_IRQHandler ; 25: + DCD PWM0P1_IRQHandler ; 26: + DCD PWM0P2_IRQHandler ; 27: + DCD BRAKE1_IRQHandler ; 28: + DCD PWM1P0_IRQHandler ; 29: + DCD PWM1P1_IRQHandler ; 30: + DCD PWM1P2_IRQHandler ; 31: + DCD TMR0_IRQHandler ; 32: Timer 0 + DCD TMR1_IRQHandler ; 33: Timer 1 + DCD TMR2_IRQHandler ; 34: Timer 2 + DCD TMR3_IRQHandler ; 35: Timer 3 + DCD UART0_IRQHandler ; 36: UART0 + DCD UART1_IRQHandler ; 37: UART1 + DCD I2C0_IRQHandler ; 38: I2C0 + DCD I2C1_IRQHandler ; 39: I2C1 + DCD PDMA_IRQHandler ; 40: Peripheral DMA + DCD DAC_IRQHandler ; 41: DAC + DCD EADC00_IRQHandler ; 42: EADC0 interrupt source 0 + DCD EADC01_IRQHandler ; 43: EADC0 interrupt source 1 + DCD ACMP01_IRQHandler ; 44: ACMP0 and ACMP1 + DCD Default_Handler ; 45: Reserved + DCD EADC02_IRQHandler ; 46: EADC0 interrupt source 2 + DCD EADC03_IRQHandler ; 47: EADC0 interrupt source 3 + DCD UART2_IRQHandler ; 48: UART2 + DCD UART3_IRQHandler ; 49: UART3 + DCD QSPI1_IRQHandler ; 50: QSPI1 + DCD SPI1_IRQHandler ; 51: SPI1 + DCD SPI2_IRQHandler ; 52: SPI2 + DCD USBD_IRQHandler ; 53: USB device + DCD OHCI_IRQHandler ; 54: OHCI + DCD USBOTG_IRQHandler ; 55: USB OTG + DCD CAN0_IRQHandler ; 56: CAN0 + DCD CAN1_IRQHandler ; 57: CAN1 + DCD SC0_IRQHandler ; 58: + DCD SC1_IRQHandler ; 59: + DCD SC2_IRQHandler ; 60: + DCD Default_Handler ; 61: + DCD SPI3_IRQHandler ; 62: SPI3 + DCD Default_Handler ; 63: + DCD SDH0_IRQHandler ; 64: SDH0 + DCD USBD20_IRQHandler ; 65: USBD20 + DCD EMAC_TX_IRQHandler ; 66: EMAC_TX + DCD EMAC_RX_IRQHandler ; 67: EMAX_RX + DCD I2S0_IRQHandler ; 68: I2S0 + DCD Default_Handler ; 69: ToDo: Add description to this Interrupt + DCD OPA0_IRQHandler ; 70: OPA0 + DCD CRYPTO_IRQHandler ; 71: CRYPTO + DCD GPG_IRQHandler ; 72: + DCD EINT6_IRQHandler ; 73: + DCD UART4_IRQHandler ; 74: UART4 + DCD UART5_IRQHandler ; 75: UART5 + DCD USCI0_IRQHandler ; 76: USCI0 + DCD USCI1_IRQHandler ; 77: USCI1 + DCD BPWM0_IRQHandler ; 78: BPWM0 + DCD BPWM1_IRQHandler ; 79: BPWM1 + DCD SPIM_IRQHandler ; 80: SPIM + DCD CCAP_IRQHandler ; 81: CCAP + DCD I2C2_IRQHandler ; 82: I2C2 + DCD Default_Handler ; 83: + DCD QEI0_IRQHandler ; 84: QEI0 + DCD QEI1_IRQHandler ; 85: QEI1 + DCD ECAP0_IRQHandler ; 86: ECAP0 + DCD ECAP1_IRQHandler ; 87: ECAP1 + DCD GPH_IRQHandler ; 88: + DCD EINT7_IRQHandler ; 89: + DCD SDH1_IRQHandler ; 90: SDH1 + DCD Default_Handler ; 91: + DCD EHCI_IRQHandler ; 92: EHCI + DCD USBOTG20_IRQHandler ; 93: + DCD Default_Handler ; 94: + DCD Default_Handler ; 95: + DCD Default_Handler ; 96: + DCD Default_Handler ; 97: + DCD Default_Handler ; 98: + DCD Default_Handler ; 99: + DCD Default_Handler ; 100: + DCD TRNG_IRQHandler ; 101: TRNG + DCD UART6_IRQHandler ; 102: UART6 + DCD UART7_IRQHandler ; 103: UART7 + DCD EADC10_IRQHandler ; 104: EADC1 interrupt source 0 + DCD EADC11_IRQHandler ; 105: EADC1 interrupt source 1 + DCD EADC12_IRQHandler ; 106: EADC1 interrupt source 2 + DCD EADC13_IRQHandler ; 107: EADC1 interrupt source 3 + DCD CAN2_IRQHandler ; 108: CAN2 +__Vectors_End + +__Vectors EQU __vector_table +__Vectors_Size EQU __Vectors_End - __Vectors + + +;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; +;; +;; Default interrupt handlers. +;; + THUMB + + PUBWEAK Reset_Handler + SECTION .text:CODE:REORDER:NOROOT(2) +Reset_Handler + ; Unlock Register + LDR R0, =0x40000100 + LDR R1, =0x59 + STR R1, [R0] + LDR R1, =0x16 + STR R1, [R0] + LDR R1, =0x88 + STR R1, [R0] + + #ifndef ENABLE_SPIM_CACHE + LDR R0, =0x40000200 ; R0 = Clock Controller Register Base Address + LDR R1, [R0,#0x4] ; R1 = 0x40000204 (AHBCLK) + ORR R1, R1, #0x4000 + STR R1, [R0,#0x4] ; CLK->AHBCLK |= CLK_AHBCLK_SPIMCKEN_Msk; + + LDR R0, =0x40007000 ; R0 = SPIM Register Base Address + LDR R1, [R0,#4] ; R1 = SPIM->CTL1 + ORR R1, R1,#2 ; R1 |= SPIM_CTL1_CACHEOFF_Msk + STR R1, [R0,#4] ; _SPIM_DISABLE_CACHE() + LDR R1, [R0,#4] ; R1 = SPIM->CTL1 + ORR R1, R1, #4 ; R1 |= SPIM_CTL1_CCMEN_Msk + STR R1, [R0,#4] ; _SPIM_ENABLE_CCM() + #endif + + LDR R0, =SystemInit + BLX R0 + + ; Init POR + ; LDR R2, =0x40000024 + ; LDR R1, =0x00005AA5 + ; STR R1, [R2] + + ; Lock register + LDR R0, =0x40000100 + MOVS R1, #0 + STR R1, [R0] + + LDR R0, =__iar_program_start + BX R0 + + PUBWEAK NMI_Handler + SECTION .text:CODE:REORDER:NOROOT(1) +NMI_Handler + B NMI_Handler + + PUBWEAK MemManage_Handler + SECTION .text:CODE:REORDER:NOROOT(1) +MemManage_Handler + B MemManage_Handler + + PUBWEAK BusFault_Handler + SECTION .text:CODE:REORDER:NOROOT(1) +BusFault_Handler + B BusFault_Handler + + PUBWEAK UsageFault_Handler + SECTION .text:CODE:REORDER:NOROOT(1) +UsageFault_Handler + B UsageFault_Handler + + PUBWEAK SVC_Handler + SECTION .text:CODE:REORDER:NOROOT(1) +SVC_Handler + B SVC_Handler + + PUBWEAK DebugMon_Handler + SECTION .text:CODE:REORDER:NOROOT(1) +DebugMon_Handler + B DebugMon_Handler + + PUBWEAK PendSV_Handler + SECTION .text:CODE:REORDER:NOROOT(1) +PendSV_Handler + B PendSV_Handler + + PUBWEAK SysTick_Handler + SECTION .text:CODE:REORDER:NOROOT(1) +SysTick_Handler + B SysTick_Handler + + PUBWEAK BOD_IRQHandler + PUBWEAK IRC_IRQHandler + PUBWEAK PWRWU_IRQHandler + PUBWEAK RAMPE_IRQHandler + PUBWEAK CKFAIL_IRQHandler + PUBWEAK RTC_IRQHandler + PUBWEAK TAMPER_IRQHandler + PUBWEAK WDT_IRQHandler + PUBWEAK WWDT_IRQHandler + PUBWEAK EINT0_IRQHandler + PUBWEAK EINT1_IRQHandler + PUBWEAK EINT2_IRQHandler + PUBWEAK EINT3_IRQHandler + PUBWEAK EINT4_IRQHandler + PUBWEAK EINT5_IRQHandler + PUBWEAK GPA_IRQHandler + PUBWEAK GPB_IRQHandler + PUBWEAK GPC_IRQHandler + PUBWEAK GPD_IRQHandler + PUBWEAK GPE_IRQHandler + PUBWEAK GPF_IRQHandler + PUBWEAK QSPI0_IRQHandler + PUBWEAK SPI0_IRQHandler + PUBWEAK BRAKE0_IRQHandler + PUBWEAK PWM0P0_IRQHandler + PUBWEAK PWM0P1_IRQHandler + PUBWEAK PWM0P2_IRQHandler + PUBWEAK BRAKE1_IRQHandler + PUBWEAK PWM1P0_IRQHandler + PUBWEAK PWM1P1_IRQHandler + PUBWEAK PWM1P2_IRQHandler + PUBWEAK TMR0_IRQHandler + PUBWEAK TMR1_IRQHandler + PUBWEAK TMR2_IRQHandler + PUBWEAK TMR3_IRQHandler + PUBWEAK UART0_IRQHandler + PUBWEAK UART1_IRQHandler + PUBWEAK I2C0_IRQHandler + PUBWEAK I2C1_IRQHandler + PUBWEAK PDMA_IRQHandler + PUBWEAK DAC_IRQHandler + PUBWEAK EADC00_IRQHandler + PUBWEAK EADC01_IRQHandler + PUBWEAK ACMP01_IRQHandler + PUBWEAK EADC02_IRQHandler + PUBWEAK EADC03_IRQHandler + PUBWEAK UART2_IRQHandler + PUBWEAK UART3_IRQHandler + PUBWEAK QSPI1_IRQHandler + PUBWEAK SPI1_IRQHandler + PUBWEAK SPI2_IRQHandler + PUBWEAK USBD_IRQHandler + PUBWEAK OHCI_IRQHandler + PUBWEAK USBOTG_IRQHandler + PUBWEAK CAN0_IRQHandler + PUBWEAK CAN1_IRQHandler + PUBWEAK SC0_IRQHandler + PUBWEAK SC1_IRQHandler + PUBWEAK SC2_IRQHandler + PUBWEAK SPI3_IRQHandler + PUBWEAK SDH0_IRQHandler + PUBWEAK USBD20_IRQHandler + PUBWEAK EMAC_TX_IRQHandler + PUBWEAK EMAC_RX_IRQHandler + PUBWEAK I2S0_IRQHandler + PUBWEAK OPA0_IRQHandler + PUBWEAK CRYPTO_IRQHandler + PUBWEAK GPG_IRQHandler + PUBWEAK EINT6_IRQHandler + PUBWEAK UART4_IRQHandler + PUBWEAK UART5_IRQHandler + PUBWEAK USCI0_IRQHandler + PUBWEAK USCI1_IRQHandler + PUBWEAK BPWM0_IRQHandler + PUBWEAK BPWM1_IRQHandler + PUBWEAK SPIM_IRQHandler + PUBWEAK CCAP_IRQHandler + PUBWEAK I2C2_IRQHandler + PUBWEAK QEI0_IRQHandler + PUBWEAK QEI1_IRQHandler + PUBWEAK ECAP0_IRQHandler + PUBWEAK ECAP1_IRQHandler + PUBWEAK GPH_IRQHandler + PUBWEAK EINT7_IRQHandler + PUBWEAK SDH1_IRQHandler + PUBWEAK EHCI_IRQHandler + PUBWEAK USBOTG20_IRQHandler + PUBWEAK TRNG_IRQHandler + PUBWEAK UART6_IRQHandler + PUBWEAK UART7_IRQHandler + PUBWEAK EADC10_IRQHandler + PUBWEAK EADC11_IRQHandler + PUBWEAK EADC12_IRQHandler + PUBWEAK EADC13_IRQHandler + PUBWEAK CAN2_IRQHandler + SECTION .text:CODE:REORDER:NOROOT(1) + +BOD_IRQHandler +IRC_IRQHandler +PWRWU_IRQHandler +RAMPE_IRQHandler +CKFAIL_IRQHandler +RTC_IRQHandler +TAMPER_IRQHandler +WDT_IRQHandler +WWDT_IRQHandler +EINT0_IRQHandler +EINT1_IRQHandler +EINT2_IRQHandler +EINT3_IRQHandler +EINT4_IRQHandler +EINT5_IRQHandler +GPA_IRQHandler +GPB_IRQHandler +GPC_IRQHandler +GPD_IRQHandler +GPE_IRQHandler +GPF_IRQHandler +QSPI0_IRQHandler +SPI0_IRQHandler +BRAKE0_IRQHandler +PWM0P0_IRQHandler +PWM0P1_IRQHandler +PWM0P2_IRQHandler +BRAKE1_IRQHandler +PWM1P0_IRQHandler +PWM1P1_IRQHandler +PWM1P2_IRQHandler +TMR0_IRQHandler +TMR1_IRQHandler +TMR2_IRQHandler +TMR3_IRQHandler +UART0_IRQHandler +UART1_IRQHandler +I2C0_IRQHandler +I2C1_IRQHandler +PDMA_IRQHandler +DAC_IRQHandler +EADC00_IRQHandler +EADC01_IRQHandler +ACMP01_IRQHandler +EADC02_IRQHandler +EADC03_IRQHandler +UART2_IRQHandler +UART3_IRQHandler +QSPI1_IRQHandler +SPI1_IRQHandler +SPI2_IRQHandler +USBD_IRQHandler +OHCI_IRQHandler +USBOTG_IRQHandler +CAN0_IRQHandler +CAN1_IRQHandler +SC0_IRQHandler +SC1_IRQHandler +SC2_IRQHandler +SPI3_IRQHandler +SDH0_IRQHandler +USBD20_IRQHandler +EMAC_TX_IRQHandler +EMAC_RX_IRQHandler +I2S0_IRQHandler +OPA0_IRQHandler +CRYPTO_IRQHandler +GPG_IRQHandler +EINT6_IRQHandler +UART4_IRQHandler +UART5_IRQHandler +USCI0_IRQHandler +USCI1_IRQHandler +BPWM0_IRQHandler +BPWM1_IRQHandler +SPIM_IRQHandler +CCAP_IRQHandler +I2C2_IRQHandler +QEI0_IRQHandler +QEI1_IRQHandler +ECAP0_IRQHandler +ECAP1_IRQHandler +GPH_IRQHandler +EINT7_IRQHandler +SDH1_IRQHandler +EHCI_IRQHandler +USBOTG20_IRQHandler +TRNG_IRQHandler +UART6_IRQHandler +UART7_IRQHandler +EADC10_IRQHandler +EADC11_IRQHandler +EADC12_IRQHandler +EADC13_IRQHandler +CAN2_IRQHandler +Default_Handler + B Default_Handler + + + + + END +;/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Source/system_M480.c b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Source/system_M480.c new file mode 100644 index 00000000000..76573a4a3e4 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/Nuvoton/M480/Source/system_M480.c @@ -0,0 +1,110 @@ +/**************************************************************************//** + * @file system_M480.c + * @version V1.000 + * @brief CMSIS Cortex-M4 Core Peripheral Access Layer Source File for M480 + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2017-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ + +#include "NuMicro.h" + + +/*---------------------------------------------------------------------------- + DEFINES + *----------------------------------------------------------------------------*/ + + +/*---------------------------------------------------------------------------- + Clock Variable definitions + *----------------------------------------------------------------------------*/ +uint32_t SystemCoreClock = __SYSTEM_CLOCK; /*!< System Clock Frequency (Core Clock)*/ +uint32_t CyclesPerUs = (__HSI / 1000000UL); /* Cycles per micro second */ +uint32_t PllClock = __HSI; /*!< PLL Output Clock Frequency */ +uint32_t gau32ClkSrcTbl[] = {__HXT, __LXT, 0UL, __LIRC, 0UL, 0UL, 0UL, __HIRC}; + +/*---------------------------------------------------------------------------- + Clock functions + *----------------------------------------------------------------------------*/ +void SystemCoreClockUpdate (void) /* Get Core Clock Frequency */ +{ + uint32_t u32Freq, u32ClkSrc; + uint32_t u32HclkDiv; + + /* Update PLL Clock */ + PllClock = CLK_GetPLLClockFreq(); + + u32ClkSrc = CLK->CLKSEL0 & CLK_CLKSEL0_HCLKSEL_Msk; + + if(u32ClkSrc == CLK_CLKSEL0_HCLKSEL_PLL) + { + /* Use PLL clock */ + u32Freq = PllClock; + } + else + { + /* Use the clock sources directly */ + u32Freq = gau32ClkSrcTbl[u32ClkSrc]; + } + + u32HclkDiv = (CLK->CLKDIV0 & CLK_CLKDIV0_HCLKDIV_Msk) + 1UL; + + /* Update System Core Clock */ + SystemCoreClock = u32Freq / u32HclkDiv; + + + //if(SystemCoreClock == 0) + // __BKPT(0); + + CyclesPerUs = (SystemCoreClock + 500000UL) / 1000000UL; +} + +/** + * @brief Set PF.2 and PF.3 to input mode + * @param None + * @return None + * @details GPIO default state could be configured as input or quasi through user config. + * To use HXT, PF.2 and PF.3 must not set as quasi mode. This function changes + * PF.2 and PF.3 to input mode no matter which mode they are working at. + */ +static __INLINE void HXTInit(void) +{ + PF->MODE &= ~(GPIO_MODE_MODE2_Msk | GPIO_MODE_MODE3_Msk); + +} + +/** + * @brief Initialize the System + * + * @param none + * @return none + */ +void SystemInit (void) +{ + /* Add your system initialize code here. + Do not use global variables because this function is called before + reaching pre-main. RW section maybe overwritten afterwards. */ + + + /* FPU settings ------------------------------------------------------------*/ +#if (__FPU_PRESENT == 1U) && (__FPU_USED == 1U) + SCB->CPACR |= ((3UL << 10*2) | /* set CP10 Full Access */ + (3UL << 11*2) ); /* set CP11 Full Access */ +#endif + + /* Set access cycle for CPU @ 192MHz */ + FMC->CYCCTL = (FMC->CYCCTL & ~FMC_CYCCTL_CYCLE_Msk) | (8 << FMC_CYCCTL_CYCLE_Pos); + /* Configure power down bias, must set 1 before entering power down mode. + So set it at the very beginning */ + CLK->LDOCTL |= CLK_LDOCTL_PDBIASEN_Msk; + /* Hand over the control of PF.4~11 I/O function from RTC module to GPIO module */ + CLK->APBCLK0 |= CLK_APBCLK0_RTCCKEN_Msk; + RTC->GPIOCTL0 &= ~(RTC_GPIOCTL0_CTLSEL0_Msk | RTC_GPIOCTL0_CTLSEL1_Msk | + RTC_GPIOCTL0_CTLSEL2_Msk | RTC_GPIOCTL0_CTLSEL3_Msk); + RTC->GPIOCTL1 &= ~(RTC_GPIOCTL1_CTLSEL4_Msk | RTC_GPIOCTL1_CTLSEL5_Msk | + RTC_GPIOCTL1_CTLSEL6_Msk | RTC_GPIOCTL1_CTLSEL7_Msk); + CLK->APBCLK0 &= ~CLK_APBCLK0_RTCCKEN_Msk; + HXTInit(); + +} +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/Device/SConscript b/bsp/nuvoton/libraries/m480/Device/SConscript new file mode 100644 index 00000000000..26e69fb8240 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/Device/SConscript @@ -0,0 +1,25 @@ +import rtconfig +Import('RTT_ROOT') +from building import * + +# get current directory +cwd = GetCurrentDir() + +# The set of source files associated with this SConscript file. +src = Split(""" +Nuvoton/M480/Source/system_M480.c +""") + +# add for startup script +if rtconfig.CROSS_TOOL == 'gcc': + src = src + ['Nuvoton/M480/Source/GCC/startup_M480.S'] +elif rtconfig.CROSS_TOOL == 'keil': + src = src + ['Nuvoton/M480/Source/ARM/startup_M480.s'] +elif rtconfig.CROSS_TOOL == 'iar': + src = src + ['Nuvoton/M480/Source/IAR/startup_M480.s'] + +path = [cwd + '/Nuvoton/M480/Include',] + +group = DefineGroup('m480_device', src, depend = [''], CPPPATH = path) + +Return('group') diff --git a/bsp/nuvoton/libraries/m480/README.md b/bsp/nuvoton/libraries/m480/README.md new file mode 100644 index 00000000000..e64b8733212 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/README.md @@ -0,0 +1,49 @@ +# M480 Series + +## Supported drivers + +| Peripheral | rt_device_class_type | Device name | +| ------ | ---- | :------: | +| BPWM | RT_Device_Class_Miscellaneous (PWM) | ***bpwm[0-1]*** | +| BPWM (Capture function)| RT_Device_Class_Miscellaneous (Input capture) | ***bpwm[0-1]i[0-5]*** | +| CAN | RT_Device_Class_CAN | ***can[0-1]*** | +| CLK | RT_Device_Class_PM | ***pm*** | +| CRC | RT_Device_Class_Miscellaneous (HW Crypto) | ***hwcryto*** | +| CRYPTO | RT_Device_Class_Miscellaneous (HW Crypto) | ***hwcryto*** | +| EADC | RT_Device_Class_Miscellaneous (ADC) | ***eadc[0-1]*** | +| EBI | N/A | ***N/A*** | +| ECAP | RT_Device_Class_Miscellaneous (Input capture) | ***ecap[0-1]i[0-2]*** | +| EMAC | RT_Device_Class_NetIf | ***e0*** | +| EPWM | RT_Device_Class_Miscellaneous (PWM) | ***epwm[0-1]*** | +| EPWM (Capture function) | RT_Device_Class_Miscellaneous (Input capture) | ***epwm[0-1]i[0-5]*** | +| FMC | FAL | ***N/A*** | +| GPIO | RT_Device_Class_Miscellaneous (Pin) | ***gpio*** | +| GPIO | RT_Device_Class_I2CBUS | ***softi2c0[0-1]*** | +| HSOTG | RT_Device_Class_USBHost/RT_Device_Class_USBDevice | ***N/A*** | +| HSUSBD | RT_Device_Class_USBDevice | ***usbd*** | +| I2C | RT_Device_Class_I2CBUS | ***i2c[0-2]*** | +| I2S | RT_Device_Class_Sound/RT_Device_Class_Pipe | ***sound0*** | +| PDMA | N/A | ***N/A*** | +| QEI | RT_Device_Class_Miscellaneous (Pulse encoder) | ***qei[0-1]*** | +| QSPI | RT_Device_Class_SPIBUS | ***qspi[0-1]*** | +| RTC | RT_Device_Class_RTC | ***rtc*** | +| SC (UART function) | RT_Device_Class_Char | ***scuart[0-2]*** | +| SDH | RT_Device_Class_Block | ***sdh[0-1]*** | +| SPI | RT_Device_Class_SPIBUS | ***spi[0-3]*** | +| SPI (I2S function) | RT_Device_Class_Sound/RT_Device_Class_Pipe | ***spii2s[0-3]*** | +| TIMER | RT_Device_Class_Timer | ***timer[0-3]*** | +| TIMER (Capture function) | RT_Device_Class_Miscellaneous (Input capture) | ***timer[0-3]i0*** | +| TIMER (PWM function) | RT_Device_Class_Miscellaneous (PWM) | ***tpwm[0-3]*** | +| TRNG | RT_Device_Class_Miscellaneous (HW Crypto) | ***hwcryto*** | +| UART | RT_Device_Class_Char | ***uart[0-7]*** | +| USBD | RT_Device_Class_USBDevice | ***usbd*** | +| USBH, HSUSBH | RT_Device_Class_USBHost | ***usbh*** | +| USCI (I2C function) | RT_Device_Class_I2CBUS | ***ui2c[0-1]*** | +| USCI (SPI function) | RT_Device_Class_SPIBUS | ***uspi[0-1]*** | +| USCI (UART function) | RT_Device_Class_Char | ***uuart[0-1]*** | +| WDT | RT_Device_Class_Miscellaneous (Watchdog) | ***wdt*** | + +## Resources +* [Download M480 TRM][1] + + [1]: https://www.nuvoton.com/resource-download.jsp?tp_GUID=DA05-M480 diff --git a/bsp/nuvoton/libraries/m480/SConscript b/bsp/nuvoton/libraries/m480/SConscript new file mode 100644 index 00000000000..4c815c49b83 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/SConscript @@ -0,0 +1,15 @@ +# RT-Thread building script for bridge + +import os +from building import * + +cwd = GetCurrentDir() +objs = [] +list = os.listdir(cwd) + +for d in list: + path = os.path.join(cwd, d) + if os.path.isfile(os.path.join(path, 'SConscript')): + objs = objs + SConscript(os.path.join(d, 'SConscript')) + +Return('objs') diff --git a/bsp/nuvoton/libraries/m480/StdDriver/SConscript b/bsp/nuvoton/libraries/m480/StdDriver/SConscript new file mode 100644 index 00000000000..e9e9a339e37 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/SConscript @@ -0,0 +1,26 @@ +# RT-Thread building script for component +Import('rtconfig') +from building import * + +cwd = GetCurrentDir() +src = [] +libs = [''] +libpath = [cwd + '/lib'] +cpppath = [cwd + '/inc'] + +if GetDepend('BSP_USE_STDDRIVER_SOURCE'): + src = Glob('*src/*.c') + Glob('src/*.cpp') + group = DefineGroup('m480_stddriver', src, depend = [''], CPPPATH = cpppath) +else: + if rtconfig.CROSS_TOOL == 'keil': + if GetOption('target') == 'mdk4': + libs += ['libstddriver_keil4'] + if GetOption('target') == 'mdk5': + libs += ['libstddriver_keil'] + elif rtconfig.CROSS_TOOL == 'gcc': + libs += ['libstddriver_gcc'] + else: + libs += ['libstddriver_iar'] + group = DefineGroup('m480_stddriver', src, depend = [''], CPPPATH = cpppath, LIBS = libs, LIBPATH = libpath) + +Return('group') diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_acmp.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_acmp.h new file mode 100644 index 00000000000..23db060037d --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_acmp.h @@ -0,0 +1,415 @@ +/**************************************************************************//** + * @file ACMP.h + * @version V1.00 + * @brief M480 Series ACMP Driver Header File + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + ******************************************************************************/ +#ifndef __NU_ACMP_H__ +#define __NU_ACMP_H__ + + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + + +/** @addtogroup ACMP_Driver ACMP Driver + @{ +*/ + + +/** @addtogroup ACMP_EXPORTED_CONSTANTS ACMP Exported Constants + @{ +*/ + + + +/*---------------------------------------------------------------------------------------------------------*/ +/* ACMP_CTL constant definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define ACMP_CTL_FILTSEL_OFF (0UL << ACMP_CTL_FILTSEL_Pos) /*!< ACMP_CTL setting for filter function disabled. \hideinitializer */ +#define ACMP_CTL_FILTSEL_1PCLK (1UL << ACMP_CTL_FILTSEL_Pos) /*!< ACMP_CTL setting for 1 PCLK filter count. \hideinitializer */ +#define ACMP_CTL_FILTSEL_2PCLK (2UL << ACMP_CTL_FILTSEL_Pos) /*!< ACMP_CTL setting for 2 PCLK filter count. \hideinitializer */ +#define ACMP_CTL_FILTSEL_4PCLK (3UL << ACMP_CTL_FILTSEL_Pos) /*!< ACMP_CTL setting for 4 PCLK filter count. \hideinitializer */ +#define ACMP_CTL_FILTSEL_8PCLK (4UL << ACMP_CTL_FILTSEL_Pos) /*!< ACMP_CTL setting for 8 PCLK filter count. \hideinitializer */ +#define ACMP_CTL_FILTSEL_16PCLK (5UL << ACMP_CTL_FILTSEL_Pos) /*!< ACMP_CTL setting for 16 PCLK filter count. \hideinitializer */ +#define ACMP_CTL_FILTSEL_32PCLK (6UL << ACMP_CTL_FILTSEL_Pos) /*!< ACMP_CTL setting for 32 PCLK filter count. \hideinitializer */ +#define ACMP_CTL_FILTSEL_64PCLK (7UL << ACMP_CTL_FILTSEL_Pos) /*!< ACMP_CTL setting for 64 PCLK filter count. \hideinitializer */ +#define ACMP_CTL_INTPOL_RF (0UL << ACMP_CTL_INTPOL_Pos) /*!< ACMP_CTL setting for selecting rising edge and falling edge as interrupt condition. \hideinitializer */ +#define ACMP_CTL_INTPOL_R (1UL << ACMP_CTL_INTPOL_Pos) /*!< ACMP_CTL setting for selecting rising edge as interrupt condition. \hideinitializer */ +#define ACMP_CTL_INTPOL_F (2UL << ACMP_CTL_INTPOL_Pos) /*!< ACMP_CTL setting for selecting falling edge as interrupt condition. \hideinitializer */ +#define ACMP_CTL_POSSEL_P0 (0UL << ACMP_CTL_POSSEL_Pos) /*!< ACMP_CTL setting for selecting ACMPx_P0 pin as the source of ACMP V+. \hideinitializer */ +#define ACMP_CTL_POSSEL_P1 (1UL << ACMP_CTL_POSSEL_Pos) /*!< ACMP_CTL setting for selecting ACMPx_P1 pin as the source of ACMP V+. \hideinitializer */ +#define ACMP_CTL_POSSEL_P2 (2UL << ACMP_CTL_POSSEL_Pos) /*!< ACMP_CTL setting for selecting ACMPx_P2 pin as the source of ACMP V+. \hideinitializer */ +#define ACMP_CTL_POSSEL_P3 (3UL << ACMP_CTL_POSSEL_Pos) /*!< ACMP_CTL setting for selecting ACMPx_P3 pin as the source of ACMP V+. \hideinitializer */ +#define ACMP_CTL_NEGSEL_PIN (0UL << ACMP_CTL_NEGSEL_Pos) /*!< ACMP_CTL setting for selecting the voltage of ACMP negative input pin as the source of ACMP V-. \hideinitializer */ +#define ACMP_CTL_NEGSEL_CRV (1UL << ACMP_CTL_NEGSEL_Pos) /*!< ACMP_CTL setting for selecting internal comparator reference voltage as the source of ACMP V-. \hideinitializer */ +#define ACMP_CTL_NEGSEL_VBG (2UL << ACMP_CTL_NEGSEL_Pos) /*!< ACMP_CTL setting for selecting internal Band-gap voltage as the source of ACMP V-. \hideinitializer */ +#define ACMP_CTL_NEGSEL_DAC (3UL << ACMP_CTL_NEGSEL_Pos) /*!< ACMP_CTL setting for selecting DAC output voltage as the source of ACMP V-. \hideinitializer */ +#define ACMP_CTL_HYSTERESIS_30MV (3UL << ACMP_CTL_HYSSEL_Pos) /*!< ACMP_CTL setting for enabling the hysteresis function at 30mV. \hideinitializer */ +#define ACMP_CTL_HYSTERESIS_20MV (2UL << ACMP_CTL_HYSSEL_Pos) /*!< ACMP_CTL setting for enabling the hysteresis function at 20mV. \hideinitializer */ +#define ACMP_CTL_HYSTERESIS_10MV (1UL << ACMP_CTL_HYSSEL_Pos) /*!< ACMP_CTL setting for enabling the hysteresis function at 10mV. \hideinitializer */ +#define ACMP_CTL_HYSTERESIS_DISABLE (0UL << ACMP_CTL_HYSSEL_Pos) /*!< ACMP_CTL setting for disabling the hysteresis function. \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* ACMP_VREF constant definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define ACMP_VREF_CRVSSEL_VDDA (0UL << ACMP_VREF_CRVSSEL_Pos) /*!< ACMP_VREF setting for selecting analog supply voltage VDDA as the CRV source voltage \hideinitializer */ +#define ACMP_VREF_CRVSSEL_INTVREF (1UL << ACMP_VREF_CRVSSEL_Pos) /*!< ACMP_VREF setting for selecting internal reference voltage as the CRV source voltage \hideinitializer */ + + +/*@}*/ /* end of group ACMP_EXPORTED_CONSTANTS */ + + +/** @addtogroup ACMP_EXPORTED_FUNCTIONS ACMP Exported Functions + @{ +*/ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Define Macros and functions */ +/*---------------------------------------------------------------------------------------------------------*/ + + +/** + * @brief This macro is used to enable output inverse function + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @return None + * @details This macro will set ACMPOINV bit of ACMP_CTL register to enable output inverse function. + * \hideinitializer + */ +#define ACMP_ENABLE_OUTPUT_INVERSE(acmp, u32ChNum) ((acmp)->CTL[(u32ChNum)] |= ACMP_CTL_ACMPOINV_Msk) + +/** + * @brief This macro is used to disable output inverse function + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @return None + * @details This macro will clear ACMPOINV bit of ACMP_CTL register to disable output inverse function. + * \hideinitializer + */ +#define ACMP_DISABLE_OUTPUT_INVERSE(acmp, u32ChNum) ((acmp)->CTL[(u32ChNum)] &= ~ACMP_CTL_ACMPOINV_Msk) + +/** + * @brief This macro is used to select ACMP negative input source + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @param[in] u32Src is comparator negative input selection. Including: + * - \ref ACMP_CTL_NEGSEL_PIN + * - \ref ACMP_CTL_NEGSEL_CRV + * - \ref ACMP_CTL_NEGSEL_VBG + * - \ref ACMP_CTL_NEGSEL_DAC + * @return None + * @details This macro will set NEGSEL (ACMP_CTL[5:4]) to determine the source of negative input. + * \hideinitializer + */ +#define ACMP_SET_NEG_SRC(acmp, u32ChNum, u32Src) ((acmp)->CTL[(u32ChNum)] = ((acmp)->CTL[(u32ChNum)] & ~ACMP_CTL_NEGSEL_Msk) | (u32Src)) + +/** + * @brief This macro is used to enable hysteresis function and set hysteresis to 30mV + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @return None + * \hideinitializer + */ +#define ACMP_ENABLE_HYSTERESIS(acmp, u32ChNum) ((acmp)->CTL[(u32ChNum)] |= ACMP_CTL_HYSTERESIS_30MV) + +/** + * @brief This macro is used to disable hysteresis function + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @return None + * @details This macro will clear HYSEL bits of ACMP_CTL register to disable hysteresis function. + * \hideinitializer + */ +#define ACMP_DISABLE_HYSTERESIS(acmp, u32ChNum) ((acmp)->CTL[(u32ChNum)] &= ~ACMP_CTL_HYSSEL_Msk) + +/** + * @brief This macro is used to select hysteresis level + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @param[in] u32HysSel The hysteresis function option. Including: + * - \ref ACMP_CTL_HYSTERESIS_30MV + * - \ref ACMP_CTL_HYSTERESIS_20MV + * - \ref ACMP_CTL_HYSTERESIS_10MV + * - \ref ACMP_CTL_HYSTERESIS_DISABLE + * \hideinitializer + * @return None + */ +#define ACMP_CONFIG_HYSTERESIS(acmp, u32ChNum, u32HysSel) ((acmp)->CTL[(u32ChNum)] = ((acmp)->CTL[(u32ChNum)] & ~ACMP_CTL_HYSSEL_Msk) | (u32HysSel)) + +/** + * @brief This macro is used to enable interrupt + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @return None + * @details This macro will set ACMPIE bit of ACMP_CTL register to enable interrupt function. + * If wake-up function is enabled, the wake-up interrupt will be enabled as well. + * \hideinitializer + */ +#define ACMP_ENABLE_INT(acmp, u32ChNum) ((acmp)->CTL[(u32ChNum)] |= ACMP_CTL_ACMPIE_Msk) + +/** + * @brief This macro is used to disable interrupt + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @return None + * @details This macro will clear ACMPIE bit of ACMP_CTL register to disable interrupt function. + * \hideinitializer + */ +#define ACMP_DISABLE_INT(acmp, u32ChNum) ((acmp)->CTL[(u32ChNum)] &= ~ACMP_CTL_ACMPIE_Msk) + +/** + * @brief This macro is used to enable ACMP + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @return None + * @details This macro will set ACMPEN bit of ACMP_CTL register to enable analog comparator. + * \hideinitializer + */ +#define ACMP_ENABLE(acmp, u32ChNum) ((acmp)->CTL[(u32ChNum)] |= ACMP_CTL_ACMPEN_Msk) + +/** + * @brief This macro is used to disable ACMP + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @return None + * @details This macro will clear ACMPEN bit of ACMP_CTL register to disable analog comparator. + * \hideinitializer + */ +#define ACMP_DISABLE(acmp, u32ChNum) ((acmp)->CTL[(u32ChNum)] &= ~ACMP_CTL_ACMPEN_Msk) + +/** + * @brief This macro is used to get ACMP output value + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @return ACMP output value + * @details This macro will return the ACMP output value. + * \hideinitializer + */ +#define ACMP_GET_OUTPUT(acmp, u32ChNum) (((acmp)->STATUS & (ACMP_STATUS_ACMPO0_Msk<<((u32ChNum))))?1:0) + +/** + * @brief This macro is used to get ACMP interrupt flag + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @return ACMP interrupt occurred (1) or not (0) + * @details This macro will return the ACMP interrupt flag. + * \hideinitializer + */ +#define ACMP_GET_INT_FLAG(acmp, u32ChNum) (((acmp)->STATUS & (ACMP_STATUS_ACMPIF0_Msk<<((u32ChNum))))?1:0) + +/** + * @brief This macro is used to clear ACMP interrupt flag + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @return None + * @details This macro will write 1 to ACMPIFn bit of ACMP_STATUS register to clear interrupt flag. + * \hideinitializer + */ +#define ACMP_CLR_INT_FLAG(acmp, u32ChNum) ((acmp)->STATUS = (ACMP_STATUS_ACMPIF0_Msk<<((u32ChNum)))) + +/** + * @brief This macro is used to clear ACMP wake-up interrupt flag + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @return None + * @details This macro will write 1 to WKIFn bit of ACMP_STATUS register to clear interrupt flag. + * \hideinitializer + */ +#define ACMP_CLR_WAKEUP_INT_FLAG(acmp, u32ChNum) ((acmp)->STATUS = (ACMP_STATUS_WKIF0_Msk<<((u32ChNum)))) + +/** + * @brief This macro is used to enable ACMP wake-up function + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @return None + * @details This macro will set WKEN (ACMP_CTL[16]) to enable ACMP wake-up function. + * \hideinitializer + */ +#define ACMP_ENABLE_WAKEUP(acmp, u32ChNum) ((acmp)->CTL[(u32ChNum)] |= ACMP_CTL_WKEN_Msk) + +/** + * @brief This macro is used to disable ACMP wake-up function + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @return None + * @details This macro will clear WKEN (ACMP_CTL[16]) to disable ACMP wake-up function. + * \hideinitializer + */ +#define ACMP_DISABLE_WAKEUP(acmp, u32ChNum) ((acmp)->CTL[(u32ChNum)] &= ~ACMP_CTL_WKEN_Msk) + +/** + * @brief This macro is used to select ACMP positive input pin + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @param[in] u32Pin Comparator positive pin selection. Including: + * - \ref ACMP_CTL_POSSEL_P0 + * - \ref ACMP_CTL_POSSEL_P1 + * - \ref ACMP_CTL_POSSEL_P2 + * - \ref ACMP_CTL_POSSEL_P3 + * @return None + * @details This macro will set POSSEL (ACMP_CTL[7:6]) to determine the comparator positive input pin. + * \hideinitializer + */ +#define ACMP_SELECT_P(acmp, u32ChNum, u32Pin) ((acmp)->CTL[(u32ChNum)] = ((acmp)->CTL[(u32ChNum)] & ~ACMP_CTL_POSSEL_Msk) | (u32Pin)) + +/** + * @brief This macro is used to enable ACMP filter function + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @return None + * @details This macro will set OUTSEL (ACMP_CTL[12]) to enable output filter function. + * \hideinitializer + */ +#define ACMP_ENABLE_FILTER(acmp, u32ChNum) ((acmp)->CTL[(u32ChNum)] |= ACMP_CTL_OUTSEL_Msk) + +/** + * @brief This macro is used to disable ACMP filter function + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @return None + * @details This macro will clear OUTSEL (ACMP_CTL[12]) to disable output filter function. + * \hideinitializer + */ +#define ACMP_DISABLE_FILTER(acmp, u32ChNum) ((acmp)->CTL[(u32ChNum)] &= ~ACMP_CTL_OUTSEL_Msk) + +/** + * @brief This macro is used to set ACMP filter function + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @param[in] u32Cnt is comparator filter count setting. + * - \ref ACMP_CTL_FILTSEL_OFF + * - \ref ACMP_CTL_FILTSEL_1PCLK + * - \ref ACMP_CTL_FILTSEL_2PCLK + * - \ref ACMP_CTL_FILTSEL_4PCLK + * - \ref ACMP_CTL_FILTSEL_8PCLK + * - \ref ACMP_CTL_FILTSEL_16PCLK + * - \ref ACMP_CTL_FILTSEL_32PCLK + * - \ref ACMP_CTL_FILTSEL_64PCLK + * @return None + * @details When ACMP output filter function is enabled, the output sampling count is determined by FILTSEL (ACMP_CTL[15:13]). + * \hideinitializer + */ +#define ACMP_SET_FILTER(acmp, u32ChNum, u32Cnt) ((acmp)->CTL[(u32ChNum)] = ((acmp)->CTL[(u32ChNum)] & ~ACMP_CTL_FILTSEL_Msk) | (u32Cnt)) + +/** + * @brief This macro is used to select comparator reference voltage + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32Level The comparator reference voltage setting. + * The formula is: + * comparator reference voltage = CRV source voltage x (1/6 + u32Level/24) + * The range of u32Level is 0 ~ 15. + * @return None + * @details When CRV is selected as ACMP negative input source, the CRV level is determined by CRVCTL (ACMP_VREF[3:0]). + * \hideinitializer + */ +#define ACMP_CRV_SEL(acmp, u32Level) ((acmp)->VREF = ((acmp)->VREF & ~ACMP_VREF_CRVCTL_Msk) | ((u32Level)<VREF = ((acmp)->VREF & ~ACMP_VREF_CRVSSEL_Msk) | (u32Src)) + +/** + * @brief This macro is used to select ACMP interrupt condition + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @param[in] u32Cond Comparator interrupt condition selection. Including: + * - \ref ACMP_CTL_INTPOL_RF + * - \ref ACMP_CTL_INTPOL_R + * - \ref ACMP_CTL_INTPOL_F + * @return None + * @details The ACMP output interrupt condition can be rising edge, falling edge or any edge. + * \hideinitializer + */ +#define ACMP_SELECT_INT_COND(acmp, u32ChNum, u32Cond) ((acmp)->CTL[(u32ChNum)] = ((acmp)->CTL[(u32ChNum)] & ~ACMP_CTL_INTPOL_Msk) | (u32Cond)) + +/** + * @brief This macro is used to enable ACMP window latch mode + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @return None + * @details This macro will set WLATEN (ACMP_CTL[17]) to enable ACMP window latch mode. + * When ACMP0/1_WLAT pin is at high level, ACMPO0/1 passes through window latch + * block; when ACMP0/1_WLAT pin is at low level, the output of window latch block, + * WLATOUT, is frozen. + * \hideinitializer + */ +#define ACMP_ENABLE_WINDOW_LATCH(acmp, u32ChNum) ((acmp)->CTL[(u32ChNum)] |= ACMP_CTL_WLATEN_Msk) + +/** + * @brief This macro is used to disable ACMP window latch mode + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @return None + * @details This macro will clear WLATEN (ACMP_CTL[17]) to disable ACMP window latch mode. + * \hideinitializer + */ +#define ACMP_DISABLE_WINDOW_LATCH(acmp, u32ChNum) ((acmp)->CTL[(u32ChNum)] &= ~ACMP_CTL_WLATEN_Msk) + +/** + * @brief This macro is used to enable ACMP window compare mode + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @return None + * @details This macro will set WCMPSEL (ACMP_CTL[18]) to enable ACMP window compare mode. + * When window compare mode is enabled, user can connect the specific analog voltage + * source to either the positive inputs of both comparators or the negative inputs of + * both comparators. The upper bound and lower bound of the designated range are + * determined by the voltages applied to the other inputs of both comparators. If the + * output of a comparator is low and the other comparator outputs high, which means two + * comparators implies the upper and lower bound. User can directly monitor a specific + * analog voltage source via ACMPWO (ACMP_STATUS[16]). + * \hideinitializer + */ +#define ACMP_ENABLE_WINDOW_COMPARE(acmp, u32ChNum) ((acmp)->CTL[(u32ChNum)] |= ACMP_CTL_WCMPSEL_Msk) + +/** + * @brief This macro is used to disable ACMP window compare mode + * @param[in] acmp The pointer of the specified ACMP module + * @param[in] u32ChNum The ACMP number + * @return None + * @details This macro will clear WCMPSEL (ACMP_CTL[18]) to disable ACMP window compare mode. + * \hideinitializer + */ +#define ACMP_DISABLE_WINDOW_COMPARE(acmp, u32ChNum) ((acmp)->CTL[(u32ChNum)] &= ~ACMP_CTL_WCMPSEL_Msk) + + + + +/* Function prototype declaration */ +void ACMP_Open(ACMP_T *acmp, uint32_t u32ChNum, uint32_t u32NegSrc, uint32_t u32HysSel); +void ACMP_Close(ACMP_T *acmp, uint32_t u32ChNum); + + + +/*@}*/ /* end of group ACMP_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group ACMP_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + + +#endif /* __NU_ACMP_H__ */ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_bpwm.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_bpwm.h new file mode 100644 index 00000000000..04e65f601a5 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_bpwm.h @@ -0,0 +1,361 @@ +/**************************************************************************//** + * @file nu_bpwm.h + * @version V1.00 + * @brief M480 series PWM driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __NU_BPWM_H__ +#define __NU_BPWM_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup BPWM_Driver BPWM Driver + @{ +*/ + +/** @addtogroup BPWM_EXPORTED_CONSTANTS BPWM Exported Constants + @{ +*/ +#define BPWM_CHANNEL_NUM (6) /*!< BPWM channel number \hideinitializer */ +#define BPWM_CH_0_MASK (0x1UL) /*!< BPWM channel 0 mask \hideinitializer */ +#define BPWM_CH_1_MASK (0x2UL) /*!< BPWM channel 1 mask \hideinitializer */ +#define BPWM_CH_2_MASK (0x4UL) /*!< BPWM channel 2 mask \hideinitializer */ +#define BPWM_CH_3_MASK (0x8UL) /*!< BPWM channel 3 mask \hideinitializer */ +#define BPWM_CH_4_MASK (0x10UL) /*!< BPWM channel 4 mask \hideinitializer */ +#define BPWM_CH_5_MASK (0x20UL) /*!< BPWM channel 5 mask \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Counter Type Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define BPWM_UP_COUNTER (0UL) /*!< Up counter type \hideinitializer */ +#define BPWM_DOWN_COUNTER (1UL) /*!< Down counter type \hideinitializer */ +#define BPWM_UP_DOWN_COUNTER (2UL) /*!< Up-Down counter type \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Aligned Type Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define BPWM_EDGE_ALIGNED (1UL) /*!< BPWM working in edge aligned type(down count) \hideinitializer */ +#define BPWM_CENTER_ALIGNED (2UL) /*!< BPWM working in center aligned type \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Output Level Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define BPWM_OUTPUT_NOTHING (0UL) /*!< BPWM output nothing \hideinitializer */ +#define BPWM_OUTPUT_LOW (1UL) /*!< BPWM output low \hideinitializer */ +#define BPWM_OUTPUT_HIGH (2UL) /*!< BPWM output high \hideinitializer */ +#define BPWM_OUTPUT_TOGGLE (3UL) /*!< BPWM output toggle \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Synchronous Start Function Control Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define BPWM_SSCTL_SSRC_PWM0 (0UL<SSCTL = ((bpwm)->SSCTL & ~BPWM_SSCTL_SSRC_Msk) | (u32SyncSrc) | BPWM_SSCTL_SSEN0_Msk) + +/** + * @brief Disable timer synchronous start counting function of specified channel(s) + * @param[in] bpwm The pointer of the specified BPWM module + * @param[in] u32ChannelMask Combination of enabled channels. This parameter is not used. + * @return None + * @details This macro is used to disable timer synchronous start counting function of specified channel(s). + * @note All channels share channel 0's setting. + * \hideinitializer + */ +#define BPWM_DISABLE_TIMER_SYNC(bpwm, u32ChannelMask) ((bpwm)->SSCTL &= ~BPWM_SSCTL_SSEN0_Msk) + +/** + * @brief This macro enable BPWM counter synchronous start counting function. + * @param[in] bpwm The pointer of the specified BPWM module + * @return None + * @details This macro is used to make selected BPWM0 and BPWM1 channel(s) start counting at the same time. + * To configure synchronous start counting channel(s) by BPWM_ENABLE_TIMER_SYNC() and BPWM_DISABLE_TIMER_SYNC(). + * \hideinitializer + */ +#define BPWM_TRIGGER_SYNC_START(bpwm) ((bpwm)->SSTRG = BPWM_SSTRG_CNTSEN_Msk) + +/** + * @brief This macro enable output inverter of specified channel(s) + * @param[in] bpwm The pointer of the specified BPWM module + * @param[in] u32ChannelMask Combination of enabled channels. Each bit corresponds to a channel + * Bit 0 represents channel 0, bit 1 represents channel 1... + * @return None + * \hideinitializer + */ +#define BPWM_ENABLE_OUTPUT_INVERTER(bpwm, u32ChannelMask) ((bpwm)->POLCTL = (u32ChannelMask)) + +/** + * @brief This macro get captured rising data + * @param[in] bpwm The pointer of the specified BPWM module + * @param[in] u32ChannelNum BPWM channel number. Valid values are between 0~5 + * @return None + * \hideinitializer + */ +#define BPWM_GET_CAPTURE_RISING_DATA(bpwm, u32ChannelNum) ((bpwm)->CAPDAT[(u32ChannelNum)].RCAPDAT) + +/** + * @brief This macro get captured falling data + * @param[in] bpwm The pointer of the specified BPWM module + * @param[in] u32ChannelNum BPWM channel number. Valid values are between 0~5 + * @return None + * \hideinitializer + */ +#define BPWM_GET_CAPTURE_FALLING_DATA(bpwm, u32ChannelNum) ((bpwm)->CAPDAT[(u32ChannelNum)].FCAPDAT) + +/** + * @brief This macro mask output logic to high or low + * @param[in] bpwm The pointer of the specified BPWM module + * @param[in] u32ChannelMask Combination of enabled channels. Each bit corresponds to a channel + * Bit 0 represents channel 0, bit 1 represents channel 1... + * @param[in] u32LevelMask Output logic to high or low + * @return None + * @details This macro is used to mask output logic to high or low of specified channel(s). + * @note If u32ChannelMask parameter is 0, then mask function will be disabled. + * \hideinitializer + */ +#define BPWM_MASK_OUTPUT(bpwm, u32ChannelMask, u32LevelMask) \ + { \ + (bpwm)->MSKEN = (u32ChannelMask); \ + (bpwm)->MSK = (u32LevelMask); \ + } + +/** + * @brief This macro set the prescaler of all channels + * @param[in] bpwm The pointer of the specified BPWM module + * @param[in] u32ChannelNum BPWM channel number. This parameter is not used. + * @param[in] u32Prescaler Clock prescaler of specified channel. Valid values are between 1 ~ 0xFFF + * @return None + * \hideinitializer + */ +#define BPWM_SET_PRESCALER(bpwm, u32ChannelNum, u32Prescaler) ((bpwm)->CLKPSC = (u32Prescaler)) + +/** + * @brief This macro set the duty of the selected channel + * @param[in] bpwm The pointer of the specified BPWM module + * @param[in] u32ChannelNum BPWM channel number. Valid values are between 0~5 + * @param[in] u32CMR Duty of specified channel. Valid values are between 0~0xFFFF + * @return None + * @note This new setting will take effect on next BPWM period + * \hideinitializer + */ +#define BPWM_SET_CMR(bpwm, u32ChannelNum, u32CMR) ((bpwm)->CMPDAT[(u32ChannelNum)] = (u32CMR)) + +/** + * @brief This macro get the duty of the selected channel + * @param[in] bpwm The pointer of the specified BPWM module + * @param[in] u32ChannelNum BPWM channel number. Valid values are between 0~5 + * @return None + * \hideinitializer + */ +#define BPWM_GET_CMR(bpwm, u32ChannelNum) ((bpwm)->CMPDAT[(u32ChannelNum)]) + +/** + * @brief This macro set the period of all channels + * @param[in] bpwm The pointer of the specified BPWM module + * @param[in] u32ChannelNum BPWM channel number. This parameter is not used. + * @param[in] u32CNR Period of specified channel. Valid values are between 0~0xFFFF + * @return None + * @note This new setting will take effect on next BPWM period + * @note BPWM counter will stop if period length set to 0 + * \hideinitializer + */ +#define BPWM_SET_CNR(bpwm, u32ChannelNum, u32CNR) ((bpwm)->PERIOD = (u32CNR)) + +/** + * @brief This macro get the period of all channels + * @param[in] bpwm The pointer of the specified BPWM module + * @param[in] u32ChannelNum BPWM channel number. This parameter is not used. + * @return None + * \hideinitializer + */ +#define BPWM_GET_CNR(bpwm, u32ChannelNum) ((bpwm)->PERIOD) + +/** + * @brief This macro set the BPWM aligned type + * @param[in] bpwm The pointer of the specified BPWM module + * @param[in] u32ChannelMask Combination of enabled channels. This parameter is not used. + * @param[in] u32AlignedType BPWM aligned type, valid values are: + * - \ref BPWM_EDGE_ALIGNED + * - \ref BPWM_CENTER_ALIGNED + * @return None + * @note All channels share channel 0's setting. + * \hideinitializer + */ +#define BPWM_SET_ALIGNED_TYPE(bpwm, u32ChannelMask, u32AlignedType) ((bpwm)->CTL1 = (u32AlignedType)) + +/** + * @brief Clear counter of channel 0 + * @param[in] bpwm The pointer of the specified BPWM module + * @param[in] u32ChannelMask Combination of enabled channels. This parameter is not used. + * @return None + * @details This macro is used to clear counter of channel 0 + * \hideinitializer + */ +#define BPWM_CLR_COUNTER(bpwm, u32ChannelMask) ((bpwm)->CNTCLR = (BPWM_CNTCLR_CNTCLR0_Msk)) + +/** + * @brief Set output level at zero, compare up, period(center) and compare down of specified channel(s) + * @param[in] bpwm The pointer of the specified BPWM module + * @param[in] u32ChannelMask Combination of enabled channels. Each bit corresponds to a channel + * Bit 0 represents channel 0, bit 1 represents channel 1... + * @param[in] u32ZeroLevel output level at zero point, valid values are: + * - \ref BPWM_OUTPUT_NOTHING + * - \ref BPWM_OUTPUT_LOW + * - \ref BPWM_OUTPUT_HIGH + * - \ref BPWM_OUTPUT_TOGGLE + * @param[in] u32CmpUpLevel output level at compare up point, valid values are: + * - \ref BPWM_OUTPUT_NOTHING + * - \ref BPWM_OUTPUT_LOW + * - \ref BPWM_OUTPUT_HIGH + * - \ref BPWM_OUTPUT_TOGGLE + * @param[in] u32PeriodLevel output level at period(center) point, valid values are: + * - \ref BPWM_OUTPUT_NOTHING + * - \ref BPWM_OUTPUT_LOW + * - \ref BPWM_OUTPUT_HIGH + * - \ref BPWM_OUTPUT_TOGGLE + * @param[in] u32CmpDownLevel output level at compare down point, valid values are: + * - \ref BPWM_OUTPUT_NOTHING + * - \ref BPWM_OUTPUT_LOW + * - \ref BPWM_OUTPUT_HIGH + * - \ref BPWM_OUTPUT_TOGGLE + * @return None + * @details This macro is used to Set output level at zero, compare up, period(center) and compare down of specified channel(s) + * \hideinitializer + */ +#define BPWM_SET_OUTPUT_LEVEL(bpwm, u32ChannelMask, u32ZeroLevel, u32CmpUpLevel, u32PeriodLevel, u32CmpDownLevel) \ + do{ \ + int i; \ + for(i = 0; i < 6; i++) { \ + if((u32ChannelMask) & (1 << i)) { \ + (bpwm)->WGCTL0 = (((bpwm)->WGCTL0 & ~(3UL << (2 * i))) | ((u32ZeroLevel) << (2 * i))); \ + (bpwm)->WGCTL0 = (((bpwm)->WGCTL0 & ~(3UL << (BPWM_WGCTL0_PRDPCTLn_Pos + (2 * i)))) | ((u32PeriodLevel) << (BPWM_WGCTL0_PRDPCTLn_Pos + (2 * i)))); \ + (bpwm)->WGCTL1 = (((bpwm)->WGCTL1 & ~(3UL << (2 * i))) | ((u32CmpUpLevel) << (2 * i))); \ + (bpwm)->WGCTL1 = (((bpwm)->WGCTL1 & ~(3UL << (BPWM_WGCTL1_CMPDCTLn_Pos + (2 * i)))) | ((u32CmpDownLevel) << (BPWM_WGCTL1_CMPDCTLn_Pos + (2 * i)))); \ + } \ + } \ + }while(0) + + +/*---------------------------------------------------------------------------------------------------------*/ +/* Define BPWM functions prototype */ +/*---------------------------------------------------------------------------------------------------------*/ +uint32_t BPWM_ConfigCaptureChannel(BPWM_T *bpwm, uint32_t u32ChannelNum, uint32_t u32UnitTimeNsec, uint32_t u32CaptureEdge); +uint32_t BPWM_ConfigOutputChannel(BPWM_T *bpwm, uint32_t u32ChannelNum, uint32_t u32Frequency, uint32_t u32DutyCycle); +void BPWM_Start(BPWM_T *bpwm, uint32_t u32ChannelMask); +void BPWM_Stop(BPWM_T *bpwm, uint32_t u32ChannelMask); +void BPWM_ForceStop(BPWM_T *bpwm, uint32_t u32ChannelMask); +void BPWM_EnableADCTrigger(BPWM_T *bpwm, uint32_t u32ChannelNum, uint32_t u32Condition); +void BPWM_DisableADCTrigger(BPWM_T *bpwm, uint32_t u32ChannelNum); +void BPWM_ClearADCTriggerFlag(BPWM_T *bpwm, uint32_t u32ChannelNum, uint32_t u32Condition); +uint32_t BPWM_GetADCTriggerFlag(BPWM_T *bpwm, uint32_t u32ChannelNum); +void BPWM_EnableCapture(BPWM_T *bpwm, uint32_t u32ChannelMask); +void BPWM_DisableCapture(BPWM_T *bpwm, uint32_t u32ChannelMask); +void BPWM_EnableOutput(BPWM_T *bpwm, uint32_t u32ChannelMask); +void BPWM_DisableOutput(BPWM_T *bpwm, uint32_t u32ChannelMask); +void BPWM_EnableCaptureInt(BPWM_T *bpwm, uint32_t u32ChannelNum, uint32_t u32Edge); +void BPWM_DisableCaptureInt(BPWM_T *bpwm, uint32_t u32ChannelNum, uint32_t u32Edge); +void BPWM_ClearCaptureIntFlag(BPWM_T *bpwm, uint32_t u32ChannelNum, uint32_t u32Edge); +uint32_t BPWM_GetCaptureIntFlag(BPWM_T *bpwm, uint32_t u32ChannelNum); +void BPWM_EnableDutyInt(BPWM_T *bpwm, uint32_t u32ChannelNum, uint32_t u32IntDutyType); +void BPWM_DisableDutyInt(BPWM_T *bpwm, uint32_t u32ChannelNum); +void BPWM_ClearDutyIntFlag(BPWM_T *bpwm, uint32_t u32ChannelNum); +uint32_t BPWM_GetDutyIntFlag(BPWM_T *bpwm, uint32_t u32ChannelNum); +void BPWM_EnablePeriodInt(BPWM_T *bpwm, uint32_t u32ChannelNum, uint32_t u32IntPeriodType); +void BPWM_DisablePeriodInt(BPWM_T *bpwm, uint32_t u32ChannelNum); +void BPWM_ClearPeriodIntFlag(BPWM_T *bpwm, uint32_t u32ChannelNum); +uint32_t BPWM_GetPeriodIntFlag(BPWM_T *bpwm, uint32_t u32ChannelNum); +void BPWM_EnableZeroInt(BPWM_T *bpwm, uint32_t u32ChannelNum); +void BPWM_DisableZeroInt(BPWM_T *bpwm, uint32_t u32ChannelNum); +void BPWM_ClearZeroIntFlag(BPWM_T *bpwm, uint32_t u32ChannelNum); +uint32_t BPWM_GetZeroIntFlag(BPWM_T *bpwm, uint32_t u32ChannelNum); +void BPWM_EnableLoadMode(BPWM_T *bpwm, uint32_t u32ChannelNum, uint32_t u32LoadMode); +void BPWM_DisableLoadMode(BPWM_T *bpwm, uint32_t u32ChannelNum, uint32_t u32LoadMode); +void BPWM_SetClockSource(BPWM_T *bpwm, uint32_t u32ChannelNum, uint32_t u32ClkSrcSel); +uint32_t BPWM_GetWrapAroundFlag(BPWM_T *bpwm, uint32_t u32ChannelNum); +void BPWM_ClearWrapAroundFlag(BPWM_T *bpwm, uint32_t u32ChannelNum); + + +/*@}*/ /* end of group BPWM_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group BPWM_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_BPWM_H__ */ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_can.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_can.h new file mode 100644 index 00000000000..cfc1c1fd163 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_can.h @@ -0,0 +1,192 @@ +/**************************************************************************//** + * @file nu_can.h + * @version V2.00 + * @brief M480 Series CAN Driver Header File + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + ******************************************************************************/ +#ifndef __NU_CAN_H__ +#define __NU_CAN_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup CAN_Driver CAN Driver + @{ +*/ + +/** @addtogroup CAN_EXPORTED_CONSTANTS CAN Exported Constants + @{ +*/ +/*---------------------------------------------------------------------------------------------------------*/ +/* CAN Test Mode Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define CAN_NORMAL_MODE 0ul /*!< CAN select normal mode \hideinitializer */ +#define CAN_BASIC_MODE 1ul /*!< CAN select basic mode \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Message ID Type Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define CAN_STD_ID 0ul /*!< CAN select standard ID \hideinitializer */ +#define CAN_EXT_ID 1ul /*!< CAN select extended ID \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Message Frame Type Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define CAN_REMOTE_FRAME 0ul /*!< CAN frame select remote frame \hideinitializer */ +#define CAN_DATA_FRAME 1ul /*!< CAN frame select data frame \hideinitializer */ + +/*@}*/ /* end of group CAN_EXPORTED_CONSTANTS */ + + +/** @addtogroup CAN_EXPORTED_STRUCTS CAN Exported Structs + @{ +*/ +/** + * @details CAN message structure + */ +typedef struct +{ + uint32_t IdType; /*!< ID type */ + uint32_t FrameType; /*!< Frame type */ + uint32_t Id; /*!< Message ID */ + uint8_t DLC; /*!< Data length */ + uint8_t Data[8]; /*!< Data */ +} STR_CANMSG_T; + +/** + * @details CAN mask message structure + */ +typedef struct +{ + uint8_t u8Xtd; /*!< Extended ID */ + uint8_t u8Dir; /*!< Direction */ + uint32_t u32Id; /*!< Message ID */ + uint8_t u8IdType; /*!< ID type*/ +} STR_CANMASK_T; + +/*@}*/ /* end of group CAN_EXPORTED_STRUCTS */ + +/** @cond HIDDEN_SYMBOLS */ +#define MSG(id) (id) +/** @endcond HIDDEN_SYMBOLS */ + +/** @addtogroup CAN_EXPORTED_FUNCTIONS CAN Exported Functions + @{ +*/ + +/** + * @brief Get interrupt status. + * + * @param[in] can The base address of can module. + * + * @return CAN module status register value. + * + * @details Status Interrupt is generated by bits BOff (CAN_STATUS[7]), EWarn (CAN_STATUS[6]), + * EPass (CAN_STATUS[5]), RxOk (CAN_STATUS[4]), TxOk (CAN_STATUS[3]), and LEC (CAN_STATUS[2:0]). + * \hideinitializer + */ +#define CAN_GET_INT_STATUS(can) ((can)->STATUS) + +/** + * @brief Get specified interrupt pending status. + * + * @param[in] can The base address of can module. + * + * @return The source of the interrupt. + * + * @details If several interrupts are pending, the CAN Interrupt Register will point to the pending interrupt + * with the highest priority, disregarding their chronological order. + * \hideinitializer + */ +#define CAN_GET_INT_PENDING_STATUS(can) ((can)->IIDR) + +/** + * @brief Disable wake-up function. + * + * @param[in] can The base address of can module. + * + * @return None + * + * @details The macro is used to disable wake-up function. + * \hideinitializer + */ +#define CAN_DISABLE_WAKEUP(can) ((can)->WU_EN = 0ul) + +/** + * @brief Enable wake-up function. + * + * @param[in] can The base address of can module. + * + * @return None + * + * @details User can wake-up system when there is a falling edge in the CAN_Rx pin. + * \hideinitializer + */ +#define CAN_ENABLE_WAKEUP(can) ((can)->WU_EN = CAN_WU_EN_WAKUP_EN_Msk) + +/** + * @brief Get specified Message Object new data into bit value. + * + * @param[in] can The base address of can module. + * @param[in] u32MsgNum Specified Message Object number, valid value are from 0 to 31. + * + * @return Specified Message Object new data into bit value. + * + * @details The NewDat bit (CAN_IFn_MCON[15]) of a specific Message Object can be set/reset by the software through the IFn Message Interface Registers + * or by the Message Handler after reception of a Data Frame or after a successful transmission. + * \hideinitializer + */ +#define CAN_GET_NEW_DATA_IN_BIT(can, u32MsgNum) ((u32MsgNum) < 16 ? (can)->NDAT1 & (1 << (u32MsgNum)) : (can)->NDAT2 & (1 << ((u32MsgNum)-16))) + + +/*---------------------------------------------------------------------------------------------------------*/ +/* Define CAN functions prototype */ +/*---------------------------------------------------------------------------------------------------------*/ +uint32_t CAN_SetBaudRate(CAN_T *tCAN, uint32_t u32BaudRate); +uint32_t CAN_Open(CAN_T *tCAN, uint32_t u32BaudRate, uint32_t u32Mode); +void CAN_Close(CAN_T *tCAN); +void CAN_CLR_INT_PENDING_BIT(CAN_T *tCAN, uint8_t u32MsgNum); +void CAN_EnableInt(CAN_T *tCAN, uint32_t u32Mask); +void CAN_DisableInt(CAN_T *tCAN, uint32_t u32Mask); +int32_t CAN_Transmit(CAN_T *tCAN, uint32_t u32MsgNum, STR_CANMSG_T* pCanMsg); +int32_t CAN_Receive(CAN_T *tCAN, uint32_t u32MsgNum, STR_CANMSG_T* pCanMsg); +int32_t CAN_SetMultiRxMsg(CAN_T *tCAN, uint32_t u32MsgNum, uint32_t u32MsgCount, uint32_t u32IDType, uint32_t u32ID); +int32_t CAN_SetRxMsg(CAN_T *tCAN, uint32_t u32MsgNum, uint32_t u32IDType, uint32_t u32ID); +int32_t CAN_SetRxMsgAndMsk(CAN_T *tCAN, uint32_t u32MsgNum, uint32_t u32IDType, uint32_t u32ID, uint32_t u32IDMask); +int32_t CAN_SetTxMsg(CAN_T *tCAN, uint32_t u32MsgNum, STR_CANMSG_T* pCanMsg); +int32_t CAN_TriggerTxMsg(CAN_T *tCAN, uint32_t u32MsgNum); +int32_t CAN_BasicSendMsg(CAN_T *tCAN, STR_CANMSG_T* pCanMsg); +int32_t CAN_BasicReceiveMsg(CAN_T *tCAN, STR_CANMSG_T* pCanMsg); +void CAN_EnterInitMode(CAN_T *tCAN, uint8_t u8Mask); +void CAN_EnterTestMode(CAN_T *tCAN, uint8_t u8TestMask); +void CAN_LeaveTestMode(CAN_T *tCAN); +uint32_t CAN_GetCANBitRate(CAN_T *tCAN); +uint32_t CAN_IsNewDataReceived(CAN_T *tCAN, uint8_t u8MsgObj); +void CAN_LeaveInitMode(CAN_T *tCAN); +int32_t CAN_SetRxMsgObjAndMsk(CAN_T *tCAN, uint8_t u8MsgObj, uint8_t u8idType, uint32_t u32id, uint32_t u32idmask, uint8_t u8singleOrFifoLast); +int32_t CAN_SetRxMsgObj(CAN_T *tCAN, uint8_t u8MsgObj, uint8_t u8idType, uint32_t u32id, uint8_t u8singleOrFifoLast); +void CAN_WaitMsg(CAN_T *tCAN); +int32_t CAN_ReadMsgObj(CAN_T *tCAN, uint8_t u8MsgObj, uint8_t u8Release, STR_CANMSG_T* pCanMsg); + +/*@}*/ /* end of group CAN_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group CAN_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /*__NU_CAN_H__ */ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_ccap.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_ccap.h new file mode 100644 index 00000000000..edae144eb97 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_ccap.h @@ -0,0 +1,167 @@ +/**************************************************************************//** + * @file nu_ccap.h + * @version V1.00 + * @brief M480 Series CCAP Driver Header File + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + ******************************************************************************/ +#ifndef __NU_CCAP_H__ +#define __NU_CCAP_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup CCAP_Driver CCAP Driver + @{ +*/ + +/** @addtogroup CCAP_EXPORTED_CONSTANTS CCAP Exported Constants + @{ +*/ + +/*---------------------------------------------------------------------------------------------------------*/ +/* CTL constant definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define CCAP_CTL_CCAPEN (1ul<CTL & CCAP_CTL_CCAPEN_Msk)?0:1) + +/** + * @brief Clear CCAP flag + * + * @param[in] u32IntMask interrupt flags settings. It could be + * - \ref CCAP_INT_VINTF_Msk + * - \ref CCAP_INT_MEINTF_Msk + * - \ref CCAP_INT_ADDRMINTF_Msk + * - \ref CCAP_INT_MDINTF_Msk + * + * @return TRUE(Enable) or FALSE(Disable) + * + * @details Clear Image Capture Interface interrupt flag + * \hideinitializer + */ +#define CCAP_CLR_INT_FLAG(u32IntMask) (CCAP->INT |=u32IntMask) + +/** + * @brief Get CCAP Interrupt status + * + * @return TRUE(Enable) or FALSE(Disable) + * + * @details Get Image Capture Interface interrupt status. + * \hideinitializer + */ +#define CCAP_GET_INT_STS() (CCAP->INT) + +void CCAP_Open(uint32_t u32InFormat, uint32_t u32OutFormet); +void CCAP_SetCroppingWindow(uint32_t u32VStart,uint32_t u32HStart, uint32_t u32Height, uint32_t u32Width); +void CCAP_SetPacketBuf(uint32_t u32Address ); +void CCAP_Close(void); +void CCAP_EnableInt(uint32_t u32IntMask); +void CCAP_DisableInt(uint32_t u32IntMask); +void CCAP_Start(void); +void CCAP_Stop(uint32_t u32FrameComplete); +void CCAP_SetPacketScaling(uint32_t u32VNumerator, uint32_t u32VDenominator, uint32_t u32HNumerator, uint32_t u32HDenominator); +void CCAP_SetPacketStride(uint32_t u32Stride ); +void CCAP_EnableMono(uint32_t u32Interface); +void CCAP_DisableMono(void); +void CCAP_EnableLumaYOne(uint32_t u32th); +void CCAP_DisableLumaYOne(void); + +/*@}*/ /* end of group CCAP_EXPORTED_FUNCTIONS */ + + + +/*@}*/ /* end of group CCAP_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif //__NU_CCAP_H__ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_clk.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_clk.h new file mode 100644 index 00000000000..9dc88b552d8 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_clk.h @@ -0,0 +1,714 @@ +/**************************************************************************//** + * @file CLK.h + * @version V1.0 + * @brief M480 Series CLK Driver Header File + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + ******************************************************************************/ +#ifndef __NU_CLK_H__ +#define __NU_CLK_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup CLK_Driver CLK Driver + @{ +*/ + +/** @addtogroup CLK_EXPORTED_CONSTANTS CLK Exported Constants + @{ +*/ + + +#define FREQ_25MHZ 25000000UL /*!< 25 MHz \hideinitializer */ +#define FREQ_50MHZ 50000000UL /*!< 50 MHz \hideinitializer */ +#define FREQ_72MHZ 72000000UL /*!< 72 MHz \hideinitializer */ +#define FREQ_80MHZ 80000000UL /*!< 80 MHz \hideinitializer */ +#define FREQ_100MHZ 100000000UL /*!< 100 MHz \hideinitializer */ +#define FREQ_125MHZ 125000000UL /*!< 125 MHz \hideinitializer */ +#define FREQ_160MHZ 160000000UL /*!< 160 MHz \hideinitializer */ +#define FREQ_192MHZ 192000000UL /*!< 192 MHz \hideinitializer */ +#define FREQ_200MHZ 200000000UL /*!< 200 MHz \hideinitializer */ +#define FREQ_250MHZ 250000000UL /*!< 250 MHz \hideinitializer */ +#define FREQ_500MHZ 500000000UL /*!< 500 MHz \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* CLKSEL0 constant definitions. (Write-protection) */ +/*---------------------------------------------------------------------------------------------------------*/ +#define CLK_CLKSEL0_HCLKSEL_HXT (0x0UL << CLK_CLKSEL0_HCLKSEL_Pos) /*!< Select HCLK clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL0_HCLKSEL_LXT (0x1UL << CLK_CLKSEL0_HCLKSEL_Pos) /*!< Select HCLK clock source from low speed crystal \hideinitializer */ +#define CLK_CLKSEL0_HCLKSEL_PLL (0x2UL << CLK_CLKSEL0_HCLKSEL_Pos) /*!< Select HCLK clock source from PLL \hideinitializer */ +#define CLK_CLKSEL0_HCLKSEL_LIRC (0x3UL << CLK_CLKSEL0_HCLKSEL_Pos) /*!< Select HCLK clock source from low speed oscillator \hideinitializer */ +#define CLK_CLKSEL0_HCLKSEL_HIRC (0x7UL << CLK_CLKSEL0_HCLKSEL_Pos) /*!< Select HCLK clock source from high speed oscillator \hideinitializer */ + +#define CLK_CLKSEL0_STCLKSEL_HXT (0x0UL << CLK_CLKSEL0_STCLKSEL_Pos) /*!< Select SysTick clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL0_STCLKSEL_LXT (0x1UL << CLK_CLKSEL0_STCLKSEL_Pos) /*!< Select SysTick clock source from low speed crystal \hideinitializer */ +#define CLK_CLKSEL0_STCLKSEL_HXT_DIV2 (0x2UL << CLK_CLKSEL0_STCLKSEL_Pos) /*!< Select SysTick clock source from HXT/2 \hideinitializer */ +#define CLK_CLKSEL0_STCLKSEL_HCLK_DIV2 (0x3UL << CLK_CLKSEL0_STCLKSEL_Pos) /*!< Select SysTick clock source from HCLK/2 \hideinitializer */ +#define CLK_CLKSEL0_STCLKSEL_HIRC_DIV2 (0x7UL << CLK_CLKSEL0_STCLKSEL_Pos) /*!< Select SysTick clock source from HIRC/2 \hideinitializer */ +#define CLK_CLKSEL0_STCLKSEL_HCLK (0x01UL << SysTick_CTRL_CLKSOURCE_Pos) /*!< Select SysTick clock source from HCLK \hideinitializer */ + +#define CLK_CLKSEL0_CCAPSEL_HXT (0x0UL << CLK_CLKSEL0_CCAPSEL_Pos) /*!< Select CCAP clock source from HXT \hideinitializer */ +#define CLK_CLKSEL0_CCAPSEL_PLL (0x1UL << CLK_CLKSEL0_CCAPSEL_Pos) /*!< Select CCAP clock source from PLL \hideinitializer */ +#define CLK_CLKSEL0_CCAPSEL_HCLK (0x2UL << CLK_CLKSEL0_CCAPSEL_Pos) /*!< Select CCAP clock source from HCLK \hideinitializer */ +#define CLK_CLKSEL0_CCAPSEL_HIRC (0x3UL << CLK_CLKSEL0_CCAPSEL_Pos) /*!< Select CCAP clock source from HIRC \hideinitializer */ + + +#if(0) +#define CLK_CLKSEL0_PCLK0DIV1 (0x0UL << CLK_CLKSEL0_PCLK0SEL_Pos) /*!< Select PCLK0 clock source from HCLK \hideinitializer */ +#define CLK_CLKSEL0_PCLK0DIV2 (0x1UL << CLK_CLKSEL0_PCLK0SEL_Pos) /*!< Select PCLK0 clock source from 1/2 HCLK \hideinitializer */ + +#define CLK_CLKSEL0_PCLK1DIV1 (0x0UL << CLK_CLKSEL0_PCLK1SEL_Pos) /*!< Select PCLK1 clock source from HCLK \hideinitializer */ +#define CLK_CLKSEL0_PCLK1DIV2 (0x1UL << CLK_CLKSEL0_PCLK1SEL_Pos) /*!< Select PCLK1 clock source from 1/2 HCLK \hideinitializer */ +#endif + +#define CLK_CLKSEL0_CCAPSEL_HXT (0x0UL << CLK_CLKSEL0_CCAPSEL_Pos) /*!< Select CCAP clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL0_CCAPSEL_PLL (0x1UL << CLK_CLKSEL0_CCAPSEL_Pos) /*!< Select CCAP clock source from PLL \hideinitializer */ +#define CLK_CLKSEL0_CCAPSEL_HIRC (0x3UL << CLK_CLKSEL0_CCAPSEL_Pos) /*!< Select CCAP clock source from high speed oscillator \hideinitializer */ +#define CLK_CLKSEL0_CCAPSEL_HCLK (0x2UL << CLK_CLKSEL0_CCAPSEL_Pos) /*!< Select CCAP clock source from HCLK \hideinitializer */ + +#define CLK_CLKSEL0_SDH0SEL_HXT (0x0UL << CLK_CLKSEL0_SDH0SEL_Pos) /*!< Select SDH0 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL0_SDH0SEL_PLL (0x1UL << CLK_CLKSEL0_SDH0SEL_Pos) /*!< Select SDH0 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL0_SDH0SEL_HIRC (0x3UL << CLK_CLKSEL0_SDH0SEL_Pos) /*!< Select SDH0 clock source from high speed oscillator \hideinitializer */ +#define CLK_CLKSEL0_SDH0SEL_HCLK (0x2UL << CLK_CLKSEL0_SDH0SEL_Pos) /*!< Select SDH0 clock source from HCLK \hideinitializer */ + +#define CLK_CLKSEL0_SDH1SEL_HXT (0x0UL << CLK_CLKSEL0_SDH1SEL_Pos) /*!< Select SDH1 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL0_SDH1SEL_PLL (0x1UL << CLK_CLKSEL0_SDH1SEL_Pos) /*!< Select SDH1 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL0_SDH1SEL_HIRC (0x3UL << CLK_CLKSEL0_SDH1SEL_Pos) /*!< Select SDH1 clock source from high speed oscillator \hideinitializer */ +#define CLK_CLKSEL0_SDH1SEL_HCLK (0x2UL << CLK_CLKSEL0_SDH1SEL_Pos) /*!< Select SDH1 clock source from HCLK \hideinitializer */ + +#define CLK_CLKSEL0_USBSEL_RC48M (0x0UL << CLK_CLKSEL0_USBSEL_Pos) /*!< Select USB clock source from RC48M \hideinitializer */ +#define CLK_CLKSEL0_USBSEL_PLL (0x1UL << CLK_CLKSEL0_USBSEL_Pos) /*!< Select USB clock source from PLL \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* CLKSEL1 constant definitions. */ +/*---------------------------------------------------------------------------------------------------------*/ +#define CLK_CLKSEL1_WDTSEL_LXT (0x1UL << CLK_CLKSEL1_WDTSEL_Pos) /*!< Select WDT clock source from low speed crystal \hideinitializer */ +#define CLK_CLKSEL1_WDTSEL_LIRC (0x3UL << CLK_CLKSEL1_WDTSEL_Pos) /*!< Select WDT clock source from low speed oscillator \hideinitializer */ +#define CLK_CLKSEL1_WDTSEL_HCLK_DIV2048 (0x2UL << CLK_CLKSEL1_WDTSEL_Pos) /*!< Select WDT clock source from HCLK/2048 \hideinitializer */ + +#define CLK_CLKSEL1_TMR0SEL_HXT (0x0UL << CLK_CLKSEL1_TMR0SEL_Pos) /*!< Select TMR0 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL1_TMR0SEL_LXT (0x1UL << CLK_CLKSEL1_TMR0SEL_Pos) /*!< Select TMR0 clock source from low speed crystal \hideinitializer */ +#define CLK_CLKSEL1_TMR0SEL_LIRC (0x5UL << CLK_CLKSEL1_TMR0SEL_Pos) /*!< Select TMR0 clock source from low speed oscillator \hideinitializer */ +#define CLK_CLKSEL1_TMR0SEL_HIRC (0x7UL << CLK_CLKSEL1_TMR0SEL_Pos) /*!< Select TMR0 clock source from high speed oscillator \hideinitializer */ +#define CLK_CLKSEL1_TMR0SEL_PCLK0 (0x2UL << CLK_CLKSEL1_TMR0SEL_Pos) /*!< Select TMR0 clock source from PCLK0 \hideinitializer */ +#define CLK_CLKSEL1_TMR0SEL_EXT (0x3UL << CLK_CLKSEL1_TMR0SEL_Pos) /*!< Select TMR0 clock source from external trigger \hideinitializer */ + +#define CLK_CLKSEL1_TMR1SEL_HXT (0x0UL << CLK_CLKSEL1_TMR1SEL_Pos) /*!< Select TMR1 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL1_TMR1SEL_LXT (0x1UL << CLK_CLKSEL1_TMR1SEL_Pos) /*!< Select TMR1 clock source from low speed crystal \hideinitializer */ +#define CLK_CLKSEL1_TMR1SEL_LIRC (0x5UL << CLK_CLKSEL1_TMR1SEL_Pos) /*!< Select TMR1 clock source from low speed oscillator \hideinitializer */ +#define CLK_CLKSEL1_TMR1SEL_HIRC (0x7UL << CLK_CLKSEL1_TMR1SEL_Pos) /*!< Select TMR1 clock source from high speed oscillator \hideinitializer */ +#define CLK_CLKSEL1_TMR1SEL_PCLK0 (0x2UL << CLK_CLKSEL1_TMR1SEL_Pos) /*!< Select TMR1 clock source from PCLK0 \hideinitializer */ +#define CLK_CLKSEL1_TMR1SEL_EXT (0x3UL << CLK_CLKSEL1_TMR1SEL_Pos) /*!< Select TMR1 clock source from external trigger \hideinitializer */ + +#define CLK_CLKSEL1_TMR2SEL_HXT (0x0UL << CLK_CLKSEL1_TMR2SEL_Pos) /*!< Select TMR2 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL1_TMR2SEL_LXT (0x1UL << CLK_CLKSEL1_TMR2SEL_Pos) /*!< Select TMR2 clock source from low speed crystal \hideinitializer */ +#define CLK_CLKSEL1_TMR2SEL_LIRC (0x5UL << CLK_CLKSEL1_TMR2SEL_Pos) /*!< Select TMR2 clock source from low speed oscillator \hideinitializer */ +#define CLK_CLKSEL1_TMR2SEL_HIRC (0x7UL << CLK_CLKSEL1_TMR2SEL_Pos) /*!< Select TMR2 clock source from high speed oscillator \hideinitializer */ +#define CLK_CLKSEL1_TMR2SEL_PCLK1 (0x2UL << CLK_CLKSEL1_TMR2SEL_Pos) /*!< Select TMR2 clock source from PCLK1 \hideinitializer */ +#define CLK_CLKSEL1_TMR2SEL_EXT (0x3UL << CLK_CLKSEL1_TMR2SEL_Pos) /*!< Select TMR2 clock source from external trigger \hideinitializer */ + +#define CLK_CLKSEL1_TMR3SEL_HXT (0x0UL << CLK_CLKSEL1_TMR3SEL_Pos) /*!< Select TMR3 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL1_TMR3SEL_LXT (0x1UL << CLK_CLKSEL1_TMR3SEL_Pos) /*!< Select TMR3 clock source from low speed crystal \hideinitializer */ +#define CLK_CLKSEL1_TMR3SEL_LIRC (0x5UL << CLK_CLKSEL1_TMR3SEL_Pos) /*!< Select TMR3 clock source from low speed oscillator \hideinitializer */ +#define CLK_CLKSEL1_TMR3SEL_HIRC (0x7UL << CLK_CLKSEL1_TMR3SEL_Pos) /*!< Select TMR3 clock source from high speed oscillator \hideinitializer */ +#define CLK_CLKSEL1_TMR3SEL_PCLK1 (0x2UL << CLK_CLKSEL1_TMR3SEL_Pos) /*!< Select TMR3 clock source from PCLK1 \hideinitializer */ +#define CLK_CLKSEL1_TMR3SEL_EXT (0x3UL << CLK_CLKSEL1_TMR3SEL_Pos) /*!< Select TMR3 clock source from external trigger \hideinitializer */ + +#define CLK_CLKSEL1_UART0SEL_HXT (0x0UL << CLK_CLKSEL1_UART0SEL_Pos) /*!< Select UART0 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL1_UART0SEL_LXT (0x2UL << CLK_CLKSEL1_UART0SEL_Pos) /*!< Select UART0 clock source from low speed crystal \hideinitializer */ +#define CLK_CLKSEL1_UART0SEL_PLL (0x1UL << CLK_CLKSEL1_UART0SEL_Pos) /*!< Select UART0 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL1_UART0SEL_HIRC (0x3UL << CLK_CLKSEL1_UART0SEL_Pos) /*!< Select UART0 clock source from high speed oscillator \hideinitializer */ + +#define CLK_CLKSEL1_UART1SEL_HXT (0x0UL << CLK_CLKSEL1_UART1SEL_Pos) /*!< Select UART1 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL1_UART1SEL_LXT (0x2UL << CLK_CLKSEL1_UART1SEL_Pos) /*!< Select UART1 clock source from low speed crystal \hideinitializer */ +#define CLK_CLKSEL1_UART1SEL_PLL (0x1UL << CLK_CLKSEL1_UART1SEL_Pos) /*!< Select UART1 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL1_UART1SEL_HIRC (0x3UL << CLK_CLKSEL1_UART1SEL_Pos) /*!< Select UART1 clock source from high speed oscillator \hideinitializer */ + +#define CLK_CLKSEL1_CLKOSEL_HXT (0x0UL << CLK_CLKSEL1_CLKOSEL_Pos) /*!< Select CLKO clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL1_CLKOSEL_LXT (0x1UL << CLK_CLKSEL1_CLKOSEL_Pos) /*!< Select CLKO clock source from low speed crystal \hideinitializer */ +#define CLK_CLKSEL1_CLKOSEL_HIRC (0x3UL << CLK_CLKSEL1_CLKOSEL_Pos) /*!< Select CLKO clock source from high speed oscillator \hideinitializer */ +#define CLK_CLKSEL1_CLKOSEL_HCLK (0x2UL << CLK_CLKSEL1_CLKOSEL_Pos) /*!< Select CLKO clock source from HCLK \hideinitializer */ + +#define CLK_CLKSEL1_WWDTSEL_LIRC (0x3UL << CLK_CLKSEL1_WWDTSEL_Pos) /*!< Select WWDT clock source from low speed oscillator \hideinitializer */ +#define CLK_CLKSEL1_WWDTSEL_HCLK_DIV2048 (0x2UL << CLK_CLKSEL1_WWDTSEL_Pos) /*!< Select WWDT clock source from HCLK/2048 \hideinitializer */ + + +/*---------------------------------------------------------------------------------------------------------*/ +/* CLKSEL2 constant definitions. */ +/*---------------------------------------------------------------------------------------------------------*/ +#define CLK_CLKSEL2_QSPI0SEL_HXT (0x0UL << CLK_CLKSEL2_QSPI0SEL_Pos) /*!< Select QSPI0 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL2_QSPI0SEL_PLL (0x1UL << CLK_CLKSEL2_QSPI0SEL_Pos) /*!< Select QSPI0 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL2_QSPI0SEL_HIRC (0x3UL << CLK_CLKSEL2_QSPI0SEL_Pos) /*!< Select QSPI0 clock source from high speed oscillator \hideinitializer */ +#define CLK_CLKSEL2_QSPI0SEL_PCLK0 (0x2UL << CLK_CLKSEL2_QSPI0SEL_Pos) /*!< Select QSPI0 clock source from PCLK0 \hideinitializer */ + +#define CLK_CLKSEL2_SPI0SEL_HXT (0x0UL << CLK_CLKSEL2_SPI0SEL_Pos) /*!< Select SPI0 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL2_SPI0SEL_PLL (0x1UL << CLK_CLKSEL2_SPI0SEL_Pos) /*!< Select SPI0 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL2_SPI0SEL_HIRC (0x3UL << CLK_CLKSEL2_SPI0SEL_Pos) /*!< Select SPI0 clock source from high speed oscillator \hideinitializer */ +#define CLK_CLKSEL2_SPI0SEL_PCLK1 (0x2UL << CLK_CLKSEL2_SPI0SEL_Pos) /*!< Select SPI0 clock source from PCLK1 \hideinitializer */ + +#define CLK_CLKSEL2_SPI1SEL_HXT (0x0UL << CLK_CLKSEL2_SPI1SEL_Pos) /*!< Select SPI1 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL2_SPI1SEL_PLL (0x1UL << CLK_CLKSEL2_SPI1SEL_Pos) /*!< Select SPI1 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL2_SPI1SEL_HIRC (0x3UL << CLK_CLKSEL2_SPI1SEL_Pos) /*!< Select SPI1 clock source from high speed oscillator \hideinitializer */ +#define CLK_CLKSEL2_SPI1SEL_PCLK0 (0x2UL << CLK_CLKSEL2_SPI1SEL_Pos) /*!< Select SPI1 clock source from PCLK0 \hideinitializer */ + +#define CLK_CLKSEL2_EPWM0SEL_PLL (0x0UL << CLK_CLKSEL2_EPWM0SEL_Pos) /*!< Select EPWM0 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL2_EPWM0SEL_PCLK0 (0x1UL << CLK_CLKSEL2_EPWM0SEL_Pos) /*!< Select EPWM0 clock source from PCLK0 \hideinitializer */ + +#define CLK_CLKSEL2_EPWM1SEL_PLL (0x0UL << CLK_CLKSEL2_EPWM1SEL_Pos) /*!< Select EPWM1 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL2_EPWM1SEL_PCLK1 (0x1UL << CLK_CLKSEL2_EPWM1SEL_Pos) /*!< Select EPWM1 clock source from PCLK1 \hideinitializer */ + +#define CLK_CLKSEL2_BPWM0SEL_PLL (0x0UL << CLK_CLKSEL2_BPWM0SEL_Pos) /*!< Select BPWM0 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL2_BPWM0SEL_PCLK0 (0x1UL << CLK_CLKSEL2_BPWM0SEL_Pos) /*!< Select BPWM0 clock source from PCLK0 \hideinitializer */ + +#define CLK_CLKSEL2_BPWM1SEL_PLL (0x0UL << CLK_CLKSEL2_BPWM1SEL_Pos) /*!< Select BPWM1 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL2_BPWM1SEL_PCLK1 (0x1UL << CLK_CLKSEL2_BPWM1SEL_Pos) /*!< Select BPWM1 clock source from PCLK1 \hideinitializer */ + +#define CLK_CLKSEL2_SPI2SEL_HXT (0x0UL << CLK_CLKSEL2_SPI2SEL_Pos) /*!< Select SPI2 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL2_SPI2SEL_PLL (0x1UL << CLK_CLKSEL2_SPI2SEL_Pos) /*!< Select SPI2 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL2_SPI2SEL_HIRC (0x3UL << CLK_CLKSEL2_SPI2SEL_Pos) /*!< Select SPI2 clock source from high speed oscillator \hideinitializer */ +#define CLK_CLKSEL2_SPI2SEL_PCLK1 (0x2UL << CLK_CLKSEL2_SPI2SEL_Pos) /*!< Select SPI2 clock source from PCLK1 \hideinitializer */ + +#define CLK_CLKSEL2_SPI3SEL_HXT (0x0UL << CLK_CLKSEL2_SPI3SEL_Pos) /*!< Select SPI3 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL2_SPI3SEL_PLL (0x1UL << CLK_CLKSEL2_SPI3SEL_Pos) /*!< Select SPI3 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL2_SPI3SEL_HIRC (0x3UL << CLK_CLKSEL2_SPI3SEL_Pos) /*!< Select SPI3 clock source from high speed oscillator \hideinitializer */ +#define CLK_CLKSEL2_SPI3SEL_PCLK0 (0x2UL << CLK_CLKSEL2_SPI3SEL_Pos) /*!< Select SPI3 clock source from PCLK0 \hideinitializer */ + + +/*---------------------------------------------------------------------------------------------------------*/ +/* CLKSEL3 constant definitions. */ +/*---------------------------------------------------------------------------------------------------------*/ +#define CLK_CLKSEL3_SC0SEL_HXT (0x0UL << CLK_CLKSEL3_SC0SEL_Pos) /*!< Select SC0 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL3_SC0SEL_PLL (0x1UL << CLK_CLKSEL3_SC0SEL_Pos) /*!< Select SC0 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL3_SC0SEL_HIRC (0x3UL << CLK_CLKSEL3_SC0SEL_Pos) /*!< Select SC0 clock source from high speed oscillator \hideinitializer */ +#define CLK_CLKSEL3_SC0SEL_PCLK0 (0x2UL << CLK_CLKSEL3_SC0SEL_Pos) /*!< Select SC0 clock source from PCLK0 \hideinitializer */ + +#define CLK_CLKSEL3_SC1SEL_HXT (0x0UL << CLK_CLKSEL3_SC1SEL_Pos) /*!< Select SC1 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL3_SC1SEL_PLL (0x1UL << CLK_CLKSEL3_SC1SEL_Pos) /*!< Select SC1 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL3_SC1SEL_HIRC (0x3UL << CLK_CLKSEL3_SC1SEL_Pos) /*!< Select SC1 clock source from high speed oscillator \hideinitializer */ +#define CLK_CLKSEL3_SC1SEL_PCLK1 (0x2UL << CLK_CLKSEL3_SC1SEL_Pos) /*!< Select SC1 clock source from PCLK1 \hideinitializer */ + +#define CLK_CLKSEL3_SC2SEL_HXT (0x0UL << CLK_CLKSEL3_SC2SEL_Pos) /*!< Select SC2 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL3_SC2SEL_PLL (0x1UL << CLK_CLKSEL3_SC2SEL_Pos) /*!< Select SC2 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL3_SC2SEL_HIRC (0x3UL << CLK_CLKSEL3_SC2SEL_Pos) /*!< Select SC2 clock source from high speed oscillator \hideinitializer */ +#define CLK_CLKSEL3_SC2SEL_PCLK0 (0x2UL << CLK_CLKSEL3_SC2SEL_Pos) /*!< Select SC2 clock source from PCLK0 \hideinitializer */ + +#define CLK_CLKSEL3_RTCSEL_LXT (0x0UL << CLK_CLKSEL3_RTCSEL_Pos) /*!< Select RTC clock source from low speed crystal \hideinitializer */ +#define CLK_CLKSEL3_RTCSEL_LIRC (0x1UL << CLK_CLKSEL3_RTCSEL_Pos) /*!< Select RTC clock source from low speed oscillator \hideinitializer */ + +#define CLK_CLKSEL3_QSPI1SEL_HXT (0x0UL << CLK_CLKSEL3_QSPI1SEL_Pos) /*!< Select QSPI1 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL3_QSPI1SEL_PLL (0x1UL << CLK_CLKSEL3_QSPI1SEL_Pos) /*!< Select QSPI1 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL3_QSPI1SEL_HIRC (0x3UL << CLK_CLKSEL3_QSPI1SEL_Pos) /*!< Select QSPI1 clock source from high speed oscillator \hideinitializer */ +#define CLK_CLKSEL3_QSPI1SEL_PCLK1 (0x2UL << CLK_CLKSEL3_QSPI1SEL_Pos) /*!< Select QSPI1 clock source from PCLK1 \hideinitializer */ + +#define CLK_CLKSEL3_I2S0SEL_HXT (0x0UL << CLK_CLKSEL3_I2S0SEL_Pos) /*!< Select I2S0 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL3_I2S0SEL_PLL (0x1UL << CLK_CLKSEL3_I2S0SEL_Pos) /*!< Select I2S0 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL3_I2S0SEL_HIRC (0x3UL << CLK_CLKSEL3_I2S0SEL_Pos) /*!< Select I2S0 clock source from high speed oscillator \hideinitializer */ +#define CLK_CLKSEL3_I2S0SEL_PCLK0 (0x2UL << CLK_CLKSEL3_I2S0SEL_Pos) /*!< Select I2S0 clock source from PCLK0 \hideinitializer */ + +#define CLK_CLKSEL3_UART2SEL_HXT (0x0UL << CLK_CLKSEL3_UART2SEL_Pos) /*!< Select UART2 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL3_UART2SEL_LXT (0x2UL << CLK_CLKSEL3_UART2SEL_Pos) /*!< Select UART2 clock source from low speed crystal \hideinitializer */ +#define CLK_CLKSEL3_UART2SEL_PLL (0x1UL << CLK_CLKSEL3_UART2SEL_Pos) /*!< Select UART2 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL3_UART2SEL_HIRC (0x3UL << CLK_CLKSEL3_UART2SEL_Pos) /*!< Select UART2 clock source from high speed oscillator \hideinitializer */ + +#define CLK_CLKSEL3_UART3SEL_HXT (0x0UL << CLK_CLKSEL3_UART3SEL_Pos) /*!< Select UART3 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL3_UART3SEL_LXT (0x2UL << CLK_CLKSEL3_UART3SEL_Pos) /*!< Select UART3 clock source from low speed crystal \hideinitializer */ +#define CLK_CLKSEL3_UART3SEL_PLL (0x1UL << CLK_CLKSEL3_UART3SEL_Pos) /*!< Select UART3 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL3_UART3SEL_HIRC (0x3UL << CLK_CLKSEL3_UART3SEL_Pos) /*!< Select UART3 clock source from high speed oscillator \hideinitializer */ + +#define CLK_CLKSEL3_UART4SEL_HXT (0x0UL << CLK_CLKSEL3_UART4SEL_Pos) /*!< Select UART4 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL3_UART4SEL_LXT (0x2UL << CLK_CLKSEL3_UART4SEL_Pos) /*!< Select UART4 clock source from low speed crystal \hideinitializer */ +#define CLK_CLKSEL3_UART4SEL_PLL (0x1UL << CLK_CLKSEL3_UART4SEL_Pos) /*!< Select UART4 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL3_UART4SEL_HIRC (0x3UL << CLK_CLKSEL3_UART4SEL_Pos) /*!< Select UART4 clock source from high speed oscillator \hideinitializer */ + +#define CLK_CLKSEL3_UART5SEL_HXT (0x0UL << CLK_CLKSEL3_UART5SEL_Pos) /*!< Select UART5 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL3_UART5SEL_LXT (0x2UL << CLK_CLKSEL3_UART5SEL_Pos) /*!< Select UART5 clock source from low speed crystal \hideinitializer */ +#define CLK_CLKSEL3_UART5SEL_PLL (0x1UL << CLK_CLKSEL3_UART5SEL_Pos) /*!< Select UART5 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL3_UART5SEL_HIRC (0x3UL << CLK_CLKSEL3_UART5SEL_Pos) /*!< Select UART5 clock source from high speed oscillator \hideinitializer */ + +#define CLK_CLKSEL3_UART6SEL_HXT (0x0UL << CLK_CLKSEL3_UART6SEL_Pos) /*!< Select UART6 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL3_UART6SEL_LXT (0x2UL << CLK_CLKSEL3_UART6SEL_Pos) /*!< Select UART6 clock source from low speed crystal \hideinitializer */ +#define CLK_CLKSEL3_UART6SEL_PLL (0x1UL << CLK_CLKSEL3_UART6SEL_Pos) /*!< Select UART6 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL3_UART6SEL_HIRC (0x3UL << CLK_CLKSEL3_UART6SEL_Pos) /*!< Select UART6 clock source from high speed oscillator \hideinitializer */ + +#define CLK_CLKSEL3_UART7SEL_HXT (0x0UL << CLK_CLKSEL3_UART7SEL_Pos) /*!< Select UART7 clock source from high speed crystal \hideinitializer */ +#define CLK_CLKSEL3_UART7SEL_LXT (0x2UL << CLK_CLKSEL3_UART7SEL_Pos) /*!< Select UART7 clock source from low speed crystal \hideinitializer */ +#define CLK_CLKSEL3_UART7SEL_PLL (0x1UL << CLK_CLKSEL3_UART7SEL_Pos) /*!< Select UART7 clock source from PLL \hideinitializer */ +#define CLK_CLKSEL3_UART7SEL_HIRC (0x3UL << CLK_CLKSEL3_UART7SEL_Pos) /*!< Select UART7 clock source from high speed oscillator \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* CLKDIV0 constant definitions. */ +/*---------------------------------------------------------------------------------------------------------*/ +#define CLK_CLKDIV0_HCLK(x) (((x) - 1UL) << CLK_CLKDIV0_HCLKDIV_Pos) /*!< CLKDIV0 Setting for HCLK clock divider. It could be 1~16 \hideinitializer */ +#define CLK_CLKDIV0_USB(x) (((x) - 1UL) << CLK_CLKDIV0_USBDIV_Pos) /*!< CLKDIV0 Setting for USB clock divider. It could be 1~16 \hideinitializer */ +#define CLK_CLKDIV0_SDH0(x) (((x) - 1UL) << CLK_CLKDIV0_SDH0DIV_Pos) /*!< CLKDIV0 Setting for SDH0 clock divider. It could be 1~256 \hideinitializer */ +#define CLK_CLKDIV0_UART0(x) (((x) - 1UL) << CLK_CLKDIV0_UART0DIV_Pos) /*!< CLKDIV0 Setting for UART0 clock divider. It could be 1~16 \hideinitializer */ +#define CLK_CLKDIV0_UART1(x) (((x) - 1UL) << CLK_CLKDIV0_UART1DIV_Pos) /*!< CLKDIV0 Setting for UART1 clock divider. It could be 1~16 \hideinitializer */ +#define CLK_CLKDIV0_EADC(x) (((x) - 1UL) << CLK_CLKDIV0_EADCDIV_Pos) /*!< CLKDIV0 Setting for EADC clock divider. It could be 1~256 \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* CLKDIV1 constant definitions. */ +/*---------------------------------------------------------------------------------------------------------*/ +#define CLK_CLKDIV1_SC0(x) (((x) - 1UL) << CLK_CLKDIV1_SC0DIV_Pos) /*!< CLKDIV1 Setting for SC0 clock divider. It could be 1~256 \hideinitializer */ +#define CLK_CLKDIV1_SC1(x) (((x) - 1UL) << CLK_CLKDIV1_SC1DIV_Pos) /*!< CLKDIV1 Setting for SC1 clock divider. It could be 1~256 \hideinitializer */ +#define CLK_CLKDIV1_SC2(x) (((x) - 1UL) << CLK_CLKDIV1_SC2DIV_Pos) /*!< CLKDIV1 Setting for SC2 clock divider. It could be 1~256 \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* CLKDIV2 constant definitions. */ +/*---------------------------------------------------------------------------------------------------------*/ +#define CLK_CLKDIV2_I2S0(x) (((x) - 1UL) << CLK_CLKDIV2_I2SDIV_Pos) /*!< CLKDIV2 Setting for I2S0 clock divider. It could be 1~16 */ +#define CLK_CLKDIV2_EADC1(x) (((x) - 1UL) << CLK_CLKDIV2_EADC1DIV_Pos) /*!< CLKDIV2 Setting for EADC1 clock divider. It could be 1~256 */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* CLKDIV3 constant definitions. */ +/*---------------------------------------------------------------------------------------------------------*/ +#define CLK_CLKDIV3_CCAP(x) (((x) - 1UL) << CLK_CLKDIV3_CCAPDIV_Pos) /*!< CLKDIV3 Setting for CCAP clock divider. It could be 1~256 */ +#define CLK_CLKDIV3_VSENSE(x) (((x) - 1UL) << CLK_CLKDIV3_VSENSEDIV_Pos) /*!< CLKDIV3 Setting for VSENSE clock divider. It could be 1~256 */ +#define CLK_CLKDIV3_EMAC(x) (((x) - 1UL) << CLK_CLKDIV3_EMACDIV_Pos) /*!< CLKDIV3 Setting for EMAC clock divider. It could be 1~256 \hideinitializer */ +#define CLK_CLKDIV3_SDH1(x) (((x) - 1UL) << CLK_CLKDIV3_SDH1DIV_Pos) /*!< CLKDIV3 Setting for SDH1 clock divider. It could be 1~256 \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* CLKDIV4 constant definitions. */ +/*---------------------------------------------------------------------------------------------------------*/ +#define CLK_CLKDIV4_UART2(x) (((x) - 1UL) << CLK_CLKDIV4_UART2DIV_Pos) /*!< CLKDIV4 Setting for UART2 clock divider. It could be 1~16 \hideinitializer */ +#define CLK_CLKDIV4_UART3(x) (((x) - 1UL) << CLK_CLKDIV4_UART3DIV_Pos) /*!< CLKDIV4 Setting for UART3 clock divider. It could be 1~16 \hideinitializer */ +#define CLK_CLKDIV4_UART4(x) (((x) - 1UL) << CLK_CLKDIV4_UART4DIV_Pos) /*!< CLKDIV4 Setting for UART4 clock divider. It could be 1~16 \hideinitializer */ +#define CLK_CLKDIV4_UART5(x) (((x) - 1UL) << CLK_CLKDIV4_UART5DIV_Pos) /*!< CLKDIV4 Setting for UART5 clock divider. It could be 1~16 \hideinitializer */ +#define CLK_CLKDIV4_UART6(x) (((x) - 1UL) << CLK_CLKDIV4_UART6DIV_Pos) /*!< CLKDIV4 Setting for UART6 clock divider. It could be 1~16 */ +#define CLK_CLKDIV4_UART7(x) (((x) - 1UL) << CLK_CLKDIV4_UART7DIV_Pos) /*!< CLKDIV4 Setting for UART7 clock divider. It could be 1~16 */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* PCLKDIV constant definitions. */ +/*---------------------------------------------------------------------------------------------------------*/ +#define CLK_PCLKDIV_PCLK0DIV1 (0x0UL << CLK_PCLKDIV_APB0DIV_Pos) /*!< PCLKDIV Setting for PCLK0 = HCLK \hideinitializer */ +#define CLK_PCLKDIV_PCLK0DIV2 (0x1UL << CLK_PCLKDIV_APB0DIV_Pos) /*!< PCLKDIV Setting for PCLK0 = 1/2 HCLK \hideinitializer */ +#define CLK_PCLKDIV_PCLK0DIV4 (0x2UL << CLK_PCLKDIV_APB0DIV_Pos) /*!< PCLKDIV Setting for PCLK0 = 1/4 HCLK \hideinitializer */ +#define CLK_PCLKDIV_PCLK0DIV8 (0x3UL << CLK_PCLKDIV_APB0DIV_Pos) /*!< PCLKDIV Setting for PCLK0 = 1/8 HCLK \hideinitializer */ +#define CLK_PCLKDIV_PCLK0DIV16 (0x4UL << CLK_PCLKDIV_APB0DIV_Pos) /*!< PCLKDIV Setting for PCLK0 = 1/16 HCLK \hideinitializer */ +#define CLK_PCLKDIV_PCLK1DIV1 (0x0UL << CLK_PCLKDIV_APB1DIV_Pos) /*!< PCLKDIV Setting for PCLK1 = HCLK \hideinitializer */ +#define CLK_PCLKDIV_PCLK1DIV2 (0x1UL << CLK_PCLKDIV_APB1DIV_Pos) /*!< PCLKDIV Setting for PCLK1 = 1/2 HCLK \hideinitializer */ +#define CLK_PCLKDIV_PCLK1DIV4 (0x2UL << CLK_PCLKDIV_APB1DIV_Pos) /*!< PCLKDIV Setting for PCLK1 = 1/4 HCLK \hideinitializer */ +#define CLK_PCLKDIV_PCLK1DIV8 (0x3UL << CLK_PCLKDIV_APB1DIV_Pos) /*!< PCLKDIV Setting for PCLK1 = 1/8 HCLK \hideinitializer */ +#define CLK_PCLKDIV_PCLK1DIV16 (0x4UL << CLK_PCLKDIV_APB1DIV_Pos) /*!< PCLKDIV Setting for PCLK1 = 1/16 HCLK \hideinitializer */ +// +#define CLK_PCLKDIV_APB0DIV_DIV1 (0x0UL << CLK_PCLKDIV_APB0DIV_Pos) /*!< PCLKDIV Setting for PCLK0 = HCLK \hideinitializer */ +#define CLK_PCLKDIV_APB0DIV_DIV2 (0x1UL << CLK_PCLKDIV_APB0DIV_Pos) /*!< PCLKDIV Setting for PCLK0 = 1/2 HCLK \hideinitializer */ +#define CLK_PCLKDIV_APB0DIV_DIV4 (0x2UL << CLK_PCLKDIV_APB0DIV_Pos) /*!< PCLKDIV Setting for PCLK0 = 1/4 HCLK \hideinitializer */ +#define CLK_PCLKDIV_APB0DIV_DIV8 (0x3UL << CLK_PCLKDIV_APB0DIV_Pos) /*!< PCLKDIV Setting for PCLK0 = 1/8 HCLK \hideinitializer */ +#define CLK_PCLKDIV_APB0DIV_DIV16 (0x4UL << CLK_PCLKDIV_APB0DIV_Pos) /*!< PCLKDIV Setting for PCLK0 = 1/16 HCLK \hideinitializer */ +#define CLK_PCLKDIV_APB1DIV_DIV1 (0x0UL << CLK_PCLKDIV_APB1DIV_Pos) /*!< PCLKDIV Setting for PCLK1 = HCLK \hideinitializer */ +#define CLK_PCLKDIV_APB1DIV_DIV2 (0x1UL << CLK_PCLKDIV_APB1DIV_Pos) /*!< PCLKDIV Setting for PCLK1 = 1/2 HCLK \hideinitializer */ +#define CLK_PCLKDIV_APB1DIV_DIV4 (0x2UL << CLK_PCLKDIV_APB1DIV_Pos) /*!< PCLKDIV Setting for PCLK1 = 1/4 HCLK \hideinitializer */ +#define CLK_PCLKDIV_APB1DIV_DIV8 (0x3UL << CLK_PCLKDIV_APB1DIV_Pos) /*!< PCLKDIV Setting for PCLK1 = 1/8 HCLK \hideinitializer */ +#define CLK_PCLKDIV_APB1DIV_DIV16 (0x4UL << CLK_PCLKDIV_APB1DIV_Pos) /*!< PCLKDIV Setting for PCLK1 = 1/16 HCLK \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* PLLCTL constant definitions. PLL = FIN * 2 * NF / NR / NO */ +/*---------------------------------------------------------------------------------------------------------*/ +#define CLK_PLLCTL_PLLSRC_HXT 0x00000000UL /*!< For PLL clock source is HXT. 4MHz < FIN/NR < 8MHz \hideinitializer */ +#define CLK_PLLCTL_PLLSRC_HIRC 0x00080000UL /*!< For PLL clock source is HIRC. 4MHz < FIN/NR < 8MHz \hideinitializer */ + +#define CLK_PLLCTL_NF(x) (((x)-2UL)) /*!< x must be constant and 2 <= x <= 513. 200MHz < FIN*2*NF/NR < 500MHz. \hideinitializer */ +#define CLK_PLLCTL_NR(x) (((x)-1UL)<<9) /*!< x must be constant and 1 <= x <= 32. 4MHz < FIN/NR < 8MHz \hideinitializer */ + +#define CLK_PLLCTL_NO_1 0x0000UL /*!< For output divider is 1 \hideinitializer */ +#define CLK_PLLCTL_NO_2 0x4000UL /*!< For output divider is 2 \hideinitializer */ +#define CLK_PLLCTL_NO_4 0xC000UL /*!< For output divider is 4 \hideinitializer */ + +#define CLK_PLLCTL_72MHz_HXT (CLK_PLLCTL_PLLSRC_HXT | CLK_PLLCTL_NR(3UL) | CLK_PLLCTL_NF( 36UL) | CLK_PLLCTL_NO_4) /*!< Predefined PLLCTL setting for 72MHz PLL output with HXT(12MHz X'tal) \hideinitializer */ +#define CLK_PLLCTL_80MHz_HXT (CLK_PLLCTL_PLLSRC_HXT | CLK_PLLCTL_NR(3UL) | CLK_PLLCTL_NF( 40UL) | CLK_PLLCTL_NO_4) /*!< Predefined PLLCTL setting for 80MHz PLL output with HXT(12MHz X'tal) \hideinitializer */ +#define CLK_PLLCTL_144MHz_HXT (CLK_PLLCTL_PLLSRC_HXT | CLK_PLLCTL_NR(2UL) | CLK_PLLCTL_NF( 24UL) | CLK_PLLCTL_NO_2) /*!< Predefined PLLCTL setting for 144MHz PLL output with HXT(12MHz X'tal) \hideinitializer */ +#define CLK_PLLCTL_160MHz_HXT (CLK_PLLCTL_PLLSRC_HXT | CLK_PLLCTL_NR(3UL) | CLK_PLLCTL_NF( 40UL) | CLK_PLLCTL_NO_2) /*!< Predefined PLLCTL setting for 160MHz PLL output with HXT(12MHz X'tal) \hideinitializer */ +#define CLK_PLLCTL_192MHz_HXT (CLK_PLLCTL_PLLSRC_HXT | CLK_PLLCTL_NR(2UL) | CLK_PLLCTL_NF( 32UL) | CLK_PLLCTL_NO_2) /*!< Predefined PLLCTL setting for 192MHz PLL output with HXT(12MHz X'tal) \hideinitializer */ + +#define CLK_PLLCTL_72MHz_HIRC (CLK_PLLCTL_PLLSRC_HIRC | CLK_PLLCTL_NR(3UL) | CLK_PLLCTL_NF( 36UL) | CLK_PLLCTL_NO_4) /*!< Predefined PLLCTL setting for 72MHz PLL output with HIRC(12MHz IRC) \hideinitializer */ +#define CLK_PLLCTL_80MHz_HIRC (CLK_PLLCTL_PLLSRC_HIRC | CLK_PLLCTL_NR(3UL) | CLK_PLLCTL_NF( 40UL) | CLK_PLLCTL_NO_4) /*!< Predefined PLLCTL setting for 80MHz PLL output with HIRC(12MHz IRC) \hideinitializer */ +#define CLK_PLLCTL_144MHz_HIRC (CLK_PLLCTL_PLLSRC_HIRC | CLK_PLLCTL_NR(2UL) | CLK_PLLCTL_NF( 24UL) | CLK_PLLCTL_NO_2) /*!< Predefined PLLCTL setting for 144MHz PLL output with HIRC(12MHz IRC) \hideinitializer */ +#define CLK_PLLCTL_160MHz_HIRC (CLK_PLLCTL_PLLSRC_HIRC | CLK_PLLCTL_NR(3UL) | CLK_PLLCTL_NF( 40UL) | CLK_PLLCTL_NO_2) /*!< Predefined PLLCTL setting for 160MHz PLL output with HIRC(12MHz IRC) \hideinitializer */ +#define CLK_PLLCTL_192MHz_HIRC (CLK_PLLCTL_PLLSRC_HIRC | CLK_PLLCTL_NR(2UL) | CLK_PLLCTL_NF( 32UL) | CLK_PLLCTL_NO_2) /*!< Predefined PLLCTL setting for 192MHz PLL output with HIRC(12MHz IRC) \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* MODULE constant definitions. */ +/*---------------------------------------------------------------------------------------------------------*/ + +/* APBCLK(31:30)|CLKSEL(29:28)|CLKSEL_Msk(27:25) |CLKSEL_Pos(24:20)|CLKDIV(19:18)|CLKDIV_Msk(17:10)|CLKDIV_Pos(9:5)|IP_EN_Pos(4:0) */ + +#define MODULE_APBCLK(x) (((x) >>30) & 0x3UL) /*!< Calculate AHBCLK/APBCLK offset on MODULE index, 0x0:AHBCLK, 0x1:APBCLK0, 0x2:APBCLK1 \hideinitializer */ +#define MODULE_CLKSEL(x) (((x) >>28) & 0x3UL) /*!< Calculate CLKSEL offset on MODULE index, 0x0:CLKSEL0, 0x1:CLKSEL1, 0x2:CLKSEL2, 0x3:CLKSEL3 \hideinitializer */ +#define MODULE_CLKSEL_Msk(x) (((x) >>25) & 0x7UL) /*!< Calculate CLKSEL mask offset on MODULE index \hideinitializer */ +#define MODULE_CLKSEL_Pos(x) (((x) >>20) & 0x1fUL) /*!< Calculate CLKSEL position offset on MODULE index \hideinitializer */ +#define MODULE_CLKDIV(x) (((x) >>18) & 0x3UL) /*!< Calculate APBCLK CLKDIV on MODULE index, 0x0:CLKDIV0, 0x1:CLKDIV1, 0x2:CLKDIV3, 0x3:CLKDIV4 \hideinitializer */ +#define MODULE_CLKDIV_Msk(x) (((x) >>10) & 0xffUL) /*!< Calculate CLKDIV mask offset on MODULE index \hideinitializer */ +#define MODULE_CLKDIV_Pos(x) (((x) >>5 ) & 0x1fUL) /*!< Calculate CLKDIV position offset on MODULE index \hideinitializer */ +#define MODULE_IP_EN_Pos(x) (((x) >>0 ) & 0x1fUL) /*!< Calculate APBCLK offset on MODULE index \hideinitializer */ +#define MODULE_NoMsk 0x0UL /*!< Not mask on MODULE index \hideinitializer */ +#define NA MODULE_NoMsk /*!< Not Available \hideinitializer */ + +#define MODULE_APBCLK_ENC(x) (((x) & 0x03UL) << 30) /*!< MODULE index, 0x0:AHBCLK, 0x1:APBCLK0, 0x2:APBCLK1 \hideinitializer */ +#define MODULE_CLKSEL_ENC(x) (((x) & 0x03UL) << 28) /*!< CLKSEL offset on MODULE index, 0x0:CLKSEL0, 0x1:CLKSEL1, 0x2:CLKSEL2, 0x3:CLKSEL3 \hideinitializer */ +#define MODULE_CLKSEL_Msk_ENC(x) (((x) & 0x07UL) << 25) /*!< CLKSEL mask offset on MODULE index \hideinitializer */ +#define MODULE_CLKSEL_Pos_ENC(x) (((x) & 0x1fUL) << 20) /*!< CLKSEL position offset on MODULE index \hideinitializer */ +#define MODULE_CLKDIV_ENC(x) (((x) & 0x03UL) << 18) /*!< APBCLK CLKDIV on MODULE index, 0x0:CLKDIV0, 0x1:CLKDIV1, 0x2:CLKDIV3, 0x3:CLKDIV4 \hideinitializer */ +#define MODULE_CLKDIV_Msk_ENC(x) (((x) & 0xffUL) << 10) /*!< CLKDIV mask offset on MODULE index \hideinitializer */ +#define MODULE_CLKDIV_Pos_ENC(x) (((x) & 0x1fUL) << 5) /*!< CLKDIV position offset on MODULE index \hideinitializer */ +#define MODULE_IP_EN_Pos_ENC(x) (((x) & 0x1fUL) << 0) /*!< AHBCLK/APBCLK offset on MODULE index \hideinitializer */ + +#define PDMA_MODULE ((0UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(1UL<<0)) /*!< PDMA Module \hideinitializer */ +#define ISP_MODULE ((0UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(2UL<<0)) /*!< ISP Module \hideinitializer */ +#define EBI_MODULE ((0UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(3UL<<0)) /*!< EBI Module \hideinitializer */ +#define USBH_MODULE ((0UL<<30)|(0UL<<28) |(0x1UL<<25) |(8UL<<20) |(0UL<<18) |(0xFUL<<10) |(4UL<<5) |(16UL<<0)) /*!< USBH Module \hideinitializer */ +#define EMAC_MODULE ((0UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(2UL<<18) |(0xFFUL<<10) |(16UL<<5) |(5UL<<0)) /*!< EMAC Module \hideinitializer */ +#define SDH0_MODULE ((0UL<<30)|(0UL<<28) |(0x3UL<<25) |(20UL<<20) |(0UL<<18) |(0xFFUL<<10) |(24UL<<5) |(6UL<<0)) /*!< SDH0 Module \hideinitializer */ +#define CRC_MODULE ((0UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(7UL<<0)) /*!< CRC Module \hideinitializer */ +#define CCAP_MODULE ((0UL<<30)|(0UL<<28) |(0x3UL<<25) |(16UL<<20) |(2UL<<18) |(0xFFUL<<10) |(0UL<<5) |(8UL<<0)) /*!< CCAP Module \hideinitializer */ +#define SEN_MODULE ((0UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(9UL<<0)) /*!< SEN Module \hideinitializer */ +#define HSUSBD_MODULE ((0UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(10UL<<0)) /*!< HSUSBD Module \hideinitializer */ +#define CRPT_MODULE ((0UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(12UL<<0)) /*!< CRPT Module \hideinitializer */ +#define SPIM_MODULE ((0UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(14UL<<0)) /*!< SPIM Module \hideinitializer */ +#define FMCIDLE_MODULE ((0UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(15UL<<0)) /*!< FMCIDLE Module \hideinitializer */ +#define SDH1_MODULE ((0UL<<30)|(0UL<<28) |(0x3UL<<25) |(22UL<<20) |(2UL<<18) |(0xFFUL<<10) |(24UL<<5) |(17UL<<0)) /*!< SDH1 Module \hideinitializer */ +#define WDT_MODULE ((1UL<<30)|(1UL<<28) |(0x3UL<<25) |(0UL<<20) |(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(0UL<<0)) /*!< WDT Module \hideinitializer */ +#define RTC_MODULE ((1UL<<30)|(3UL<<28) |(0x1UL<<25) |(8UL<<20) |(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(1UL<<0)) /*!< RTC Module \hideinitializer */ +#define TMR0_MODULE ((1UL<<30)|(1UL<<28) |(0x7UL<<25) |(8UL<<20) |(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(2UL<<0)) /*!< TMR0 Module \hideinitializer */ +#define TMR1_MODULE ((1UL<<30)|(1UL<<28) |(0x7UL<<25) |(12UL<<20) |(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(3UL<<0)) /*!< TMR1 Module \hideinitializer */ +#define TMR2_MODULE ((1UL<<30)|(1UL<<28) |(0x7UL<<25) |(16UL<<20) |(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(4UL<<0)) /*!< TMR2 Module \hideinitializer */ +#define TMR3_MODULE ((1UL<<30)|(1UL<<28) |(0x7UL<<25) |(20UL<<20) |(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(5UL<<0)) /*!< TMR3 Module \hideinitializer */ +#define CLKO_MODULE ((1UL<<30)|(1UL<<28) |(0x3UL<<25) |(28UL<<20) |(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(6UL<<0)) /*!< CLKO Module \hideinitializer */ +#define WWDT_MODULE ((1UL<<30)|(1UL<<28) |(0x3UL<<25) |(30UL<<20) |(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(0UL<<0)) /*!< WWDT Module \hideinitializer */ +#define ACMP01_MODULE ((1UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(7UL<<0)) /*!< ACMP01 Module \hideinitializer */ +#define I2C0_MODULE ((1UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(8UL<<0)) /*!< I2C0 Module \hideinitializer */ +#define I2C1_MODULE ((1UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(9UL<<0)) /*!< I2C1 Module \hideinitializer */ +#define I2C2_MODULE ((1UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(10UL<<0)) /*!< I2C2 Module \hideinitializer */ +#define QSPI0_MODULE ((1UL<<30)|(2UL<<28) |(0x3UL<<25) |(2UL<<20) |(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(12UL<<0)) /*!< QSPI0 Module \hideinitializer */ +#define SPI0_MODULE ((1UL<<30)|(2UL<<28) |(0x3UL<<25) |(4UL<<20) |(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(13UL<<0)) /*!< SPI0 Module \hideinitializer */ +#define SPI1_MODULE ((1UL<<30)|(2UL<<28) |(0x3UL<<25) |(6UL<<20) |(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(14UL<<0)) /*!< SPI1 Module \hideinitializer */ +#define SPI2_MODULE ((1UL<<30)|(2UL<<28) |(0x3UL<<25) |(10UL<<20) |(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(15UL<<0)) /*!< SPI2 Module \hideinitializer */ +#define UART0_MODULE ((1UL<<30)|(1UL<<28) |(0x3UL<<25) |(24UL<<20) |(0UL<<18) |(0xFUL<<10) |(8UL<<5) |(16UL<<0)) /*!< UART0 Module \hideinitializer */ +#define UART1_MODULE ((1UL<<30)|(1UL<<28) |(0x3UL<<25) |(26UL<<20) |(0UL<<18) |(0xFUL<<10) |(12UL<<5) |(17UL<<0)) /*!< UART1 Module \hideinitializer */ +#define UART2_MODULE ((1UL<<30)|(3UL<<28) |(0x3UL<<25) |(24UL<<20) |(3UL<<18) |(0xFUL<<10) |(0UL<<5) |(18UL<<0)) /*!< UART2 Module \hideinitializer */ +#define UART3_MODULE ((1UL<<30)|(3UL<<28) |(0x3UL<<25) |(26UL<<20) |(3UL<<18) |(0xFUL<<10) |(4UL<<5) |(19UL<<0)) /*!< UART3 Module \hideinitializer */ +#define UART4_MODULE ((1UL<<30)|(3UL<<28) |(0x3UL<<25) |(28UL<<20) |(3UL<<18) |(0xFUL<<10) |(8UL<<5) |(20UL<<0)) /*!< UART4 Module \hideinitializer */ +#define UART5_MODULE ((1UL<<30)|(3UL<<28) |(0x3UL<<25) |(30UL<<20) |(3UL<<18) |(0xFUL<<10) |(12UL<<5) |(21UL<<0)) /*!< UART5 Module \hideinitializer */ +#define UART6_MODULE ((1UL<<30)|(3UL<<28) |(0x3UL<<25) |(20UL<<20) |(3UL<<18) |(0xFUL<<10) |(16UL<<5) |(22UL<<0)) /*!< UART6 Module \hideinitializer */ +#define UART7_MODULE ((1UL<<30)|(3UL<<28) |(0x3UL<<25) |(22UL<<20) |(3UL<<18) |(0xFUL<<10) |(20UL<<5) |(23UL<<0)) /*!< UART7 Module \hideinitializer */ +#define CAN0_MODULE ((1UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(24UL<<0)) /*!< CAN0 Module \hideinitializer */ +#define CAN1_MODULE ((1UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(25UL<<0)) /*!< CAN1 Module \hideinitializer */ +#define OTG_MODULE ((1UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(26UL<<0)) /*!< OTG Module \hideinitializer */ +#define USBD_MODULE ((1UL<<30)|(MODULE_NoMsk<<28)|(1UL<<25) |(8UL<<20) |(MODULE_NoMsk<<18)|(0xFUL<<10) |(4UL<<5) |(27UL<<0)) /*!< USBD Module \hideinitializer */ +#define EADC_MODULE ((1UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(0UL<<18) |(0xFFUL<<10) |(16UL<<5) |(28UL<<0)) /*!< EADC Module \hideinitializer */ +#define I2S0_MODULE ((1UL<<30)|(3UL<<28) |(0x3UL<<25) |(16UL<<20) |(2UL<<18) |(0xFUL<<10) |(0UL<<5) |(29UL<<0)) /*!< I2S0 Module \hideinitializer */ +#define HSOTG_MODULE ((1UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(30UL<<0)) /*!< HSOTG Module \hideinitializer */ +#define SC0_MODULE ((2UL<<30)|(3UL<<28) |(0x3UL<<25) |(0UL<<20) |(1UL<<18) |(0xFFUL<<10) |(0UL<<5) |(0UL<<0)) /*!< SC0 Module \hideinitializer */ +#define SC1_MODULE ((2UL<<30)|(3UL<<28) |(0x3UL<<25) |(2UL<<20) |(1UL<<18) |(0xFFUL<<10) |(8UL<<5) |(1UL<<0)) /*!< SC1 Module \hideinitializer */ +#define SC2_MODULE ((2UL<<30)|(3UL<<28) |(0x3UL<<25) |(4UL<<20) |(1UL<<18) |(0xFFUL<<10) |(16UL<<5) |(2UL<<0)) /*!< SC2 Module \hideinitializer */ +#define QSPI1_MODULE ((2UL<<30)|(3UL<<28) |(0x3UL<<25) |(12UL<<20) |(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(4UL<<0)) /*!< QSPI1 Module \hideinitializer */ +#define SPI3_MODULE ((2UL<<30)|(2UL<<28) |(0x3UL<<25) |(12UL<<20) |(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(6UL<<0)) /*!< SPI3 Module \hideinitializer */ +#define USCI0_MODULE ((2UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(8UL<<0)) /*!< USCI0 Module \hideinitializer */ +#define USCI1_MODULE ((2UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(9UL<<0)) /*!< USCI1 Module \hideinitializer */ +#define DAC_MODULE ((2UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(12UL<<0)) /*!< DAC Module \hideinitializer */ +#define CAN2_MODULE ((2UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(28UL<<0)) /*!< CAN2 Module \hideinitializer */ +#define EPWM0_MODULE ((2UL<<30)|(2UL<<28) |(0x1UL<<25) |(0UL<<20) |(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(16UL<<0)) /*!< EPWM0 Module \hideinitializer */ +#define EPWM1_MODULE ((2UL<<30)|(2UL<<28) |(0x1UL<<25) |(1UL<<20) |(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(17UL<<0)) /*!< EPWM1 Module \hideinitializer */ +#define BPWM0_MODULE ((2UL<<30)|(2UL<<28) |(0x1UL<<25) |(8UL<<20) |(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(18UL<<0)) /*!< BPWM0 Module \hideinitializer */ +#define BPWM1_MODULE ((2UL<<30)|(2UL<<28) |(0x1UL<<25) |(9UL<<20) |(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(19UL<<0)) /*!< BPWM1 Module \hideinitializer */ +#define QEI0_MODULE ((2UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(22UL<<0)) /*!< QEI0 Module \hideinitializer */ +#define QEI1_MODULE ((2UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(23UL<<0)) /*!< QEI1 Module \hideinitializer */ +#define TRNG_MODULE ((2UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(25UL<<0)) /*!< TRNG Module \hideinitializer */ +#define ECAP0_MODULE ((2UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(26UL<<0)) /*!< ECAP0 Module \hideinitializer */ +#define ECAP1_MODULE ((2UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(27UL<<0)) /*!< ECAP1 Module \hideinitializer */ +#define OPA_MODULE ((2UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(MODULE_NoMsk<<18)|(MODULE_NoMsk<<10)|(MODULE_NoMsk<<5)|(30UL<<0)) /*!< OPA Module \hideinitializer */ +#define EADC1_MODULE ((2UL<<30)|(MODULE_NoMsk<<28)|(MODULE_NoMsk<<25)|(MODULE_NoMsk<<20)|(2UL<<18) |(0xFFUL<<10) |(24UL<<5) |(31UL<<0)) /*!< EADC1 Module \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* PDMSEL constant definitions. */ +/*---------------------------------------------------------------------------------------------------------*/ +#define CLK_PMUCTL_PDMSEL_PD (0x0UL << CLK_PMUCTL_PDMSEL_Pos) /*!< Select power down mode is Power-down mode \hideinitializer */ +#define CLK_PMUCTL_PDMSEL_LLPD (0x1UL << CLK_PMUCTL_PDMSEL_Pos) /*!< Select power down mode is Low leakage Power-down mode \hideinitializer */ +#define CLK_PMUCTL_PDMSEL_FWPD (0x2UL << CLK_PMUCTL_PDMSEL_Pos) /*!< Select power down mode is Fast wake-up Power-down mode \hideinitializer */ +#define CLK_PMUCTL_PDMSEL_SPD0 (0x4UL << CLK_PMUCTL_PDMSEL_Pos) /*!< Select power down mode is Standby Power-down mode 0 \hideinitializer */ +#define CLK_PMUCTL_PDMSEL_SPD1 (0x5UL << CLK_PMUCTL_PDMSEL_Pos) /*!< Select power down mode is Standby Power-down mode 1 \hideinitializer */ +#define CLK_PMUCTL_PDMSEL_DPD (0x6UL << CLK_PMUCTL_PDMSEL_Pos) /*!< Select power down mode is Deep Power-down mode \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* WKTMRIS constant definitions. */ +/*---------------------------------------------------------------------------------------------------------*/ +#define CLK_PMUCTL_WKTMRIS_128 (0x0UL << CLK_PMUCTL_WKTMRIS_Pos) /*!< Select Wake-up Timer Time-out Interval is 128 OSC10K clocks (12.8 ms) \hideinitializer */ +#define CLK_PMUCTL_WKTMRIS_256 (0x1UL << CLK_PMUCTL_WKTMRIS_Pos) /*!< Select Wake-up Timer Time-out Interval is 256 OSC10K clocks (25.6 ms) \hideinitializer */ +#define CLK_PMUCTL_WKTMRIS_512 (0x2UL << CLK_PMUCTL_WKTMRIS_Pos) /*!< Select Wake-up Timer Time-out Interval is 512 OSC10K clocks (51.2 ms) \hideinitializer */ +#define CLK_PMUCTL_WKTMRIS_1024 (0x3UL << CLK_PMUCTL_WKTMRIS_Pos) /*!< Select Wake-up Timer Time-out Interval is 1024 OSC10K clocks (102.4ms) \hideinitializer */ +#define CLK_PMUCTL_WKTMRIS_4096 (0x4UL << CLK_PMUCTL_WKTMRIS_Pos) /*!< Select Wake-up Timer Time-out Interval is 4096 OSC10K clocks (409.6ms) \hideinitializer */ +#define CLK_PMUCTL_WKTMRIS_8192 (0x5UL << CLK_PMUCTL_WKTMRIS_Pos) /*!< Select Wake-up Timer Time-out Interval is 8192 OSC10K clocks (819.2ms) \hideinitializer */ +#define CLK_PMUCTL_WKTMRIS_16384 (0x6UL << CLK_PMUCTL_WKTMRIS_Pos) /*!< Select Wake-up Timer Time-out Interval is 16384 OSC10K clocks (1638.4ms) \hideinitializer */ +#define CLK_PMUCTL_WKTMRIS_65536 (0x7UL << CLK_PMUCTL_WKTMRIS_Pos) /*!< Select Wake-up Timer Time-out Interval is 65536 OSC10K clocks (6553.6ms) \hideinitializer */ +#define CLK_PMUCTL_WKTMRIS_131072 (0x8UL << CLK_PMUCTL_WKTMRIS_Pos) /*!< Select Wake-up Timer Time-out Interval is 131072 OSC10K clocks (13107.2 ms) \hideinitializer */ +#define CLK_PMUCTL_WKTMRIS_262144 (0x9UL << CLK_PMUCTL_WKTMRIS_Pos) /*!< Select Wake-up Timer Time-out Interval is 262144 OSC10K clocks (26214.4 ms) \hideinitializer */ +#define CLK_PMUCTL_WKTMRIS_524288 (0xaUL << CLK_PMUCTL_WKTMRIS_Pos) /*!< Select Wake-up Timer Time-out Interval is 524288 OSC10K clocks (52428.8ms) \hideinitializer */ +#define CLK_PMUCTL_WKTMRIS_1048576 (0xbUL << CLK_PMUCTL_WKTMRIS_Pos) /*!< Select Wake-up Timer Time-out Interval is 1048576 OSC10K clocks (104857.6ms) \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* SWKDBCLKSEL constant definitions. */ +/*---------------------------------------------------------------------------------------------------------*/ +#define CLK_SWKDBCTL_SWKDBCLKSEL_1 (0x0UL << CLK_SWKDBCTL_SWKDBCLKSEL_Pos) /*!< Select Standby Power-down Pin De-bounce Sampling Cycle is 1 clocks \hideinitializer */ +#define CLK_SWKDBCTL_SWKDBCLKSEL_2 (0x1UL << CLK_SWKDBCTL_SWKDBCLKSEL_Pos) /*!< Select Standby Power-down Pin De-bounce Sampling Cycle is 2 clocks \hideinitializer */ +#define CLK_SWKDBCTL_SWKDBCLKSEL_4 (0x2UL << CLK_SWKDBCTL_SWKDBCLKSEL_Pos) /*!< Select Standby Power-down Pin De-bounce Sampling Cycle is 4 clocks \hideinitializer */ +#define CLK_SWKDBCTL_SWKDBCLKSEL_8 (0x3UL << CLK_SWKDBCTL_SWKDBCLKSEL_Pos) /*!< Select Standby Power-down Pin De-bounce Sampling Cycle is 8 clocks \hideinitializer */ +#define CLK_SWKDBCTL_SWKDBCLKSEL_16 (0x4UL << CLK_SWKDBCTL_SWKDBCLKSEL_Pos) /*!< Select Standby Power-down Pin De-bounce Sampling Cycle is 16 clocks \hideinitializer */ +#define CLK_SWKDBCTL_SWKDBCLKSEL_32 (0x5UL << CLK_SWKDBCTL_SWKDBCLKSEL_Pos) /*!< Select Standby Power-down Pin De-bounce Sampling Cycle is 32 clocks \hideinitializer */ +#define CLK_SWKDBCTL_SWKDBCLKSEL_64 (0x6UL << CLK_SWKDBCTL_SWKDBCLKSEL_Pos) /*!< Select Standby Power-down Pin De-bounce Sampling Cycle is 64 clocks \hideinitializer */ +#define CLK_SWKDBCTL_SWKDBCLKSEL_128 (0x7UL << CLK_SWKDBCTL_SWKDBCLKSEL_Pos) /*!< Select Standby Power-down Pin De-bounce Sampling Cycle is 128 clocks \hideinitializer */ +#define CLK_SWKDBCTL_SWKDBCLKSEL_256 (0x8UL << CLK_SWKDBCTL_SWKDBCLKSEL_Pos) /*!< Select Standby Power-down Pin De-bounce Sampling Cycle is 256 clocks \hideinitializer */ +#define CLK_SWKDBCTL_SWKDBCLKSEL_2x256 (0x9UL << CLK_SWKDBCTL_SWKDBCLKSEL_Pos) /*!< Select Standby Power-down Pin De-bounce Sampling Cycle is 2x256 clocks \hideinitializer */ +#define CLK_SWKDBCTL_SWKDBCLKSEL_4x256 (0xaUL << CLK_SWKDBCTL_SWKDBCLKSEL_Pos) /*!< Select Standby Power-down Pin De-bounce Sampling Cycle is 4x256 clocks \hideinitializer */ +#define CLK_SWKDBCTL_SWKDBCLKSEL_8x256 (0xbUL << CLK_SWKDBCTL_SWKDBCLKSEL_Pos) /*!< Select Standby Power-down Pin De-bounce Sampling Cycle is 8x256 clocks \hideinitializer */ +#define CLK_SWKDBCTL_SWKDBCLKSEL_16x256 (0xcUL << CLK_SWKDBCTL_SWKDBCLKSEL_Pos) /*!< Select Standby Power-down Pin De-bounce Sampling Cycle is 16x256 clocks \hideinitializer */ +#define CLK_SWKDBCTL_SWKDBCLKSEL_32x256 (0xdUL << CLK_SWKDBCTL_SWKDBCLKSEL_Pos) /*!< Select Standby Power-down Pin De-bounce Sampling Cycle is 32x256 clocks \hideinitializer */ +#define CLK_SWKDBCTL_SWKDBCLKSEL_64x256 (0xeUL << CLK_SWKDBCTL_SWKDBCLKSEL_Pos) /*!< Select Standby Power-down Pin De-bounce Sampling Cycle is 64x256 clocks \hideinitializer */ +#define CLK_SWKDBCTL_SWKDBCLKSEL_128x256 (0xfUL << CLK_SWKDBCTL_SWKDBCLKSEL_Pos) /*!< Select Standby Power-down Pin De-bounce Sampling Cycle is 128x256 clocks \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* DPD Pin Rising/Falling Edge Wake-up Enable constant definitions. */ +/*---------------------------------------------------------------------------------------------------------*/ +#define CLK_DPDWKPIN_DISABLE (0x0UL << CLK_PMUCTL_WKPINEN_Pos) /*!< Disable Wake-up pin at Deep Power-down mode \hideinitializer */ +#define CLK_DPDWKPIN_RISING (0x1UL << CLK_PMUCTL_WKPINEN_Pos) /*!< Enable Wake-up pin rising edge at Deep Power-down mode \hideinitializer */ +#define CLK_DPDWKPIN_FALLING (0x2UL << CLK_PMUCTL_WKPINEN_Pos) /*!< Enable Wake-up pin falling edge at Deep Power-down mode \hideinitializer */ +#define CLK_DPDWKPIN_BOTHEDGE (0x3UL << CLK_PMUCTL_WKPINEN_Pos) /*!< Enable Wake-up pin both edge at Deep Power-down mode \hideinitializer */ + +#define CLK_DPDWKPIN0_DISABLE (0x0UL << CLK_PMUCTL_WKPINEN_Pos) /*!< Disable Wake-up pin0 (GPC.0) at Deep Power-down mode \hideinitializer */ +#define CLK_DPDWKPIN0_RISING (0x1UL << CLK_PMUCTL_WKPINEN_Pos) /*!< Enable Wake-up pin0 (GPC.0) rising edge at Deep Power-down mode \hideinitializer */ +#define CLK_DPDWKPIN0_FALLING (0x2UL << CLK_PMUCTL_WKPINEN_Pos) /*!< Enable Wake-up pin0 (GPC.0) falling edge at Deep Power-down mode \hideinitializer */ +#define CLK_DPDWKPIN0_BOTHEDGE (0x3UL << CLK_PMUCTL_WKPINEN_Pos) /*!< Enable Wake-up pin0 (GPC.0) both edge at Deep Power-down mode \hideinitializer */ + +#define CLK_DPDWKPIN1_DISABLE (0x0UL << CLK_PMUCTL_WKPINEN1_Pos) /*!< Disable Wake-up pin1 (GPB.0) at Deep Power-down mode \hideinitializer */ +#define CLK_DPDWKPIN1_RISING (0x1UL << CLK_PMUCTL_WKPINEN1_Pos) /*!< Enable Wake-up pin1 (GPB.0) rising edge at Deep Power-down mode \hideinitializer */ +#define CLK_DPDWKPIN1_FALLING (0x2UL << CLK_PMUCTL_WKPINEN1_Pos) /*!< Enable Wake-up pin1 (GPB.0) falling edge at Deep Power-down mode \hideinitializer */ +#define CLK_DPDWKPIN1_BOTHEDGE (0x3UL << CLK_PMUCTL_WKPINEN1_Pos) /*!< Enable Wake-up pin1 (GPB.0) both edge at Deep Power-down mode \hideinitializer */ + +#define CLK_DPDWKPIN2_DISABLE (0x0UL << CLK_PMUCTL_WKPINEN2_Pos) /*!< Disable Wake-up pin2 (GPB.2) at Deep Power-down mode \hideinitializer */ +#define CLK_DPDWKPIN2_RISING (0x1UL << CLK_PMUCTL_WKPINEN2_Pos) /*!< Enable Wake-up pin2 (GPB.2) rising edge at Deep Power-down mode \hideinitializer */ +#define CLK_DPDWKPIN2_FALLING (0x2UL << CLK_PMUCTL_WKPINEN2_Pos) /*!< Enable Wake-up pin2 (GPB.2) falling edge at Deep Power-down mode \hideinitializer */ +#define CLK_DPDWKPIN2_BOTHEDGE (0x3UL << CLK_PMUCTL_WKPINEN2_Pos) /*!< Enable Wake-up pin2 (GPB.2) both edge at Deep Power-down mode \hideinitializer */ + +#define CLK_DPDWKPIN3_DISABLE (0x0UL << CLK_PMUCTL_WKPINEN3_Pos) /*!< Disable Wake-up pin3 (GPB.12) at Deep Power-down mode \hideinitializer */ +#define CLK_DPDWKPIN3_RISING (0x1UL << CLK_PMUCTL_WKPINEN3_Pos) /*!< Enable Wake-up pin3 (GPB.12) rising edge at Deep Power-down mode \hideinitializer */ +#define CLK_DPDWKPIN3_FALLING (0x2UL << CLK_PMUCTL_WKPINEN3_Pos) /*!< Enable Wake-up pin3 (GPB.12) falling edge at Deep Power-down mode \hideinitializer */ +#define CLK_DPDWKPIN3_BOTHEDGE (0x3UL << CLK_PMUCTL_WKPINEN3_Pos) /*!< Enable Wake-up pin3 (GPB.12) both edge at Deep Power-down mode \hideinitializer */ + +#define CLK_DPDWKPIN4_DISABLE (0x0UL << CLK_PMUCTL_WKPINEN4_Pos) /*!< Disable Wake-up pin4 (GPF.6) at Deep Power-down mode \hideinitializer */ +#define CLK_DPDWKPIN4_RISING (0x1UL << CLK_PMUCTL_WKPINEN4_Pos) /*!< Enable Wake-up pin4 (GPF.6) rising edge at Deep Power-down mode \hideinitializer */ +#define CLK_DPDWKPIN4_FALLING (0x2UL << CLK_PMUCTL_WKPINEN4_Pos) /*!< Enable Wake-up pin4 (GPF.6) falling edge at Deep Power-down mode \hideinitializer */ +#define CLK_DPDWKPIN4_BOTHEDGE (0x3UL << CLK_PMUCTL_WKPINEN4_Pos) /*!< Enable Wake-up pin4 (GPF.6) both edge at Deep Power-down mode \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* SPD Pin Rising/Falling Edge Wake-up Enable constant definitions. */ +/*---------------------------------------------------------------------------------------------------------*/ +#define CLK_SPDWKPIN_ENABLE (0x1UL << 0) /*!< Enable Standby Power-down Pin Wake-up \hideinitializer */ +#define CLK_SPDWKPIN_RISING (0x1UL << 1) /*!< Standby Power-down Wake-up on Standby Power-down Pin rising edge \hideinitializer */ +#define CLK_SPDWKPIN_FALLING (0x1UL << 2) /*!< Standby Power-down Wake-up on Standby Power-down Pin falling edge \hideinitializer */ +#define CLK_SPDWKPIN_DEBOUNCEEN (0x1UL << 8) /*!< Enable Standby power-down pin De-bounce function \hideinitializer */ +#define CLK_SPDWKPIN_DEBOUNCEDIS (0x0UL << 8) /*!< Disable Standby power-down pin De-bounce function \hideinitializer */ + +#define CLK_SPDSRETSEL_NO (0x0UL << CLK_PMUCTL_SRETSEL_Pos) /*!< No SRAM retention when chip enter SPD mode \hideinitializer */ +#define CLK_SPDSRETSEL_16K (0x1UL << CLK_PMUCTL_SRETSEL_Pos) /*!< 16K SRAM retention when chip enter SPD mode \hideinitializer */ +#define CLK_SPDSRETSEL_32K (0x2UL << CLK_PMUCTL_SRETSEL_Pos) /*!< 32K SRAM retention when chip enter SPD mode \hideinitializer */ +#define CLK_SPDSRETSEL_64K (0x3UL << CLK_PMUCTL_SRETSEL_Pos) /*!< 64K SRAM retention when chip enter SPD mode \hideinitializer */ +#define CLK_SPDSRETSEL_128K (0x4UL << CLK_PMUCTL_SRETSEL_Pos) /*!< 128K SRAM retention when chip enter SPD mode \hideinitializer */ + +#define CLK_DISABLE_WKTMR(void) (CLK->PMUCTL &= ~CLK_PMUCTL_WKTMREN_Msk) /*!< Disable Wake-up timer at Standby or Deep Power-down mode \hideinitializer */ +#define CLK_ENABLE_WKTMR(void) (CLK->PMUCTL |= CLK_PMUCTL_WKTMREN_Msk) /*!< Enable Wake-up timer at Standby or Deep Power-down mode \hideinitializer */ +#define CLK_DISABLE_DPDWKPIN(void) (CLK->PMUCTL &= ~CLK_PMUCTL_WKPINEN_Msk) /*!< Disable Wake-up pin at Deep Power-down mode \hideinitializer */ +#define CLK_DISABLE_DPDWKPIN0(void) (CLK->PMUCTL &= ~CLK_PMUCTL_WKPINEN_Msk) /*!< Disable Wake-up pin0 (GPC.0) at Deep Power-down mode \hideinitializer */ +#define CLK_DISABLE_DPDWKPIN1(void) (CLK->PMUCTL &= ~CLK_PMUCTL_WKPINEN1_Msk) /*!< Disable Wake-up pin1 (GPB.0) at Deep Power-down mode \hideinitializer */ +#define CLK_DISABLE_DPDWKPIN2(void) (CLK->PMUCTL &= ~CLK_PMUCTL_WKPINEN2_Msk) /*!< Disable Wake-up pin2 (GPB.2) at Deep Power-down mode \hideinitializer */ +#define CLK_DISABLE_DPDWKPIN3(void) (CLK->PMUCTL &= ~CLK_PMUCTL_WKPINEN3_Msk) /*!< Disable Wake-up pin3 (GPB.12) at Deep Power-down mode \hideinitializer */ +#define CLK_DISABLE_DPDWKPIN4(void) (CLK->PMUCTL &= ~CLK_PMUCTL_WKPINEN4_Msk) /*!< Disable Wake-up pin4 (GPF.6) at Deep Power-down mode \hideinitializer */ +#define CLK_DISABLE_SPDACMP(void) (CLK->PMUCTL &= ~CLK_PMUCTL_ACMPSPWK_Msk) /*!< Disable ACMP wake-up at Standby Power-down mode \hideinitializer */ +#define CLK_ENABLE_SPDACMP(void) (CLK->PMUCTL |= CLK_PMUCTL_ACMPSPWK_Msk) /*!< Enable ACMP wake-up at Standby Power-down mode \hideinitializer */ +#define CLK_DISABLE_RTCWK(void) (CLK->PMUCTL &= ~CLK_PMUCTL_RTCWKEN_Msk) /*!< Disable RTC Wake-up at Standby or Deep Power-down mode \hideinitializer */ +#define CLK_ENABLE_RTCWK(void) (CLK->PMUCTL |= CLK_PMUCTL_RTCWKEN_Msk) /*!< Enable RTC Wake-up at Standby or Deep Power-down mode \hideinitializer */ + +/*@}*/ /* end of group CLK_EXPORTED_CONSTANTS */ + +/** @addtogroup CLK_EXPORTED_FUNCTIONS CLK Exported Functions + @{ +*/ + +/** + * @brief Set Wake-up Timer Time-out Interval + * + * @param[in] u32Interval The Wake-up Timer Time-out Interval selection. It could be + * - \ref CLK_PMUCTL_WKTMRIS_128 + * - \ref CLK_PMUCTL_WKTMRIS_256 + * - \ref CLK_PMUCTL_WKTMRIS_512 + * - \ref CLK_PMUCTL_WKTMRIS_1024 + * - \ref CLK_PMUCTL_WKTMRIS_4096 + * - \ref CLK_PMUCTL_WKTMRIS_8192 + * - \ref CLK_PMUCTL_WKTMRIS_16384 + * - \ref CLK_PMUCTL_WKTMRIS_65536 + * - \ref CLK_PMUCTL_WKTMRIS_131072 + * - \ref CLK_PMUCTL_WKTMRIS_262144 + * - \ref CLK_PMUCTL_WKTMRIS_524288 + * - \ref CLK_PMUCTL_WKTMRIS_1048576 + * + * @return None + * + * @details This function set Wake-up Timer Time-out Interval. + * + * \hideinitializer + */ +#define CLK_SET_WKTMR_INTERVAL(u32Interval) (CLK->PMUCTL |= (u32Interval)) + +/** + * @brief Set De-bounce Sampling Cycle Time + * + * @param[in] u32CycleSel The de-bounce sampling cycle selection. It could be + * - \ref CLK_SWKDBCTL_SWKDBCLKSEL_1 + * - \ref CLK_SWKDBCTL_SWKDBCLKSEL_2 + * - \ref CLK_SWKDBCTL_SWKDBCLKSEL_4 + * - \ref CLK_SWKDBCTL_SWKDBCLKSEL_8 + * - \ref CLK_SWKDBCTL_SWKDBCLKSEL_16 + * - \ref CLK_SWKDBCTL_SWKDBCLKSEL_32 + * - \ref CLK_SWKDBCTL_SWKDBCLKSEL_64 + * - \ref CLK_SWKDBCTL_SWKDBCLKSEL_128 + * - \ref CLK_SWKDBCTL_SWKDBCLKSEL_256 + * - \ref CLK_SWKDBCTL_SWKDBCLKSEL_2x256 + * - \ref CLK_SWKDBCTL_SWKDBCLKSEL_4x256 + * - \ref CLK_SWKDBCTL_SWKDBCLKSEL_8x256 + * - \ref CLK_SWKDBCTL_SWKDBCLKSEL_16x256 + * - \ref CLK_SWKDBCTL_SWKDBCLKSEL_32x256 + * - \ref CLK_SWKDBCTL_SWKDBCLKSEL_64x256 + * - \ref CLK_SWKDBCTL_SWKDBCLKSEL_128x256 + * + * @return None + * + * @details This function set Set De-bounce Sampling Cycle Time. + * + * \hideinitializer + */ +#define CLK_SET_SPDDEBOUNCETIME(u32CycleSel) (CLK->SWKDBCTL = (u32CycleSel)) + +/*---------------------------------------------------------------------------------------------------------*/ +/* static inline functions */ +/*---------------------------------------------------------------------------------------------------------*/ +/* Declare these inline functions here to avoid MISRA C 2004 rule 8.1 error */ +__STATIC_INLINE void CLK_SysTickDelay(uint32_t us); +__STATIC_INLINE void CLK_SysTickLongDelay(uint32_t us); + +/** + * @brief This function execute delay function. + * @param[in] us Delay time. The Max value is 2^24 / CPU Clock(MHz). Ex: + * 72MHz => 233016us, 50MHz => 335544us, + * 48MHz => 349525us, 28MHz => 699050us ... + * @return None + * @details Use the SysTick to generate the delay time and the unit is in us. + * The SysTick clock source is from HCLK, i.e the same as system core clock. + */ +__STATIC_INLINE void CLK_SysTickDelay(uint32_t us) +{ + SysTick->LOAD = us * CyclesPerUs; + SysTick->VAL = 0x0UL; + SysTick->CTRL = SysTick_CTRL_CLKSOURCE_Msk | SysTick_CTRL_ENABLE_Msk; + + /* Waiting for down-count to zero */ + while((SysTick->CTRL & SysTick_CTRL_COUNTFLAG_Msk) == 0UL) + { + } + + /* Disable SysTick counter */ + SysTick->CTRL = 0UL; +} + +/** + * @brief This function execute long delay function. + * @param[in] us Delay time. + * @return None + * @details Use the SysTick to generate the long delay time and the UNIT is in us. + * The SysTick clock source is from HCLK, i.e the same as system core clock. + * User can use SystemCoreClockUpdate() to calculate CyclesPerUs automatically before using this function. + */ +__STATIC_INLINE void CLK_SysTickLongDelay(uint32_t us) +{ + uint32_t delay; + + /* It should <= 349525us for each delay loop */ + delay = 349525UL; + + do + { + if(us > delay) + { + us -= delay; + } + else + { + delay = us; + us = 0UL; + } + + SysTick->LOAD = delay * CyclesPerUs; + SysTick->VAL = (0x0UL); + SysTick->CTRL = SysTick_CTRL_CLKSOURCE_Msk | SysTick_CTRL_ENABLE_Msk; + + /* Waiting for down-count to zero */ + while((SysTick->CTRL & SysTick_CTRL_COUNTFLAG_Msk) == 0UL); + + /* Disable SysTick counter */ + SysTick->CTRL = 0UL; + + } + while(us > 0UL); + +} + + +void CLK_DisableCKO(void); +void CLK_EnableCKO(uint32_t u32ClkSrc, uint32_t u32ClkDiv, uint32_t u32ClkDivBy1En); +void CLK_PowerDown(void); +void CLK_Idle(void); +uint32_t CLK_GetHXTFreq(void); +uint32_t CLK_GetLXTFreq(void); +uint32_t CLK_GetHCLKFreq(void); +uint32_t CLK_GetPCLK0Freq(void); +uint32_t CLK_GetPCLK1Freq(void); +uint32_t CLK_GetCPUFreq(void); +uint32_t CLK_SetCoreClock(uint32_t u32Hclk); +void CLK_SetHCLK(uint32_t u32ClkSrc, uint32_t u32ClkDiv); +void CLK_SetModuleClock(uint32_t u32ModuleIdx, uint32_t u32ClkSrc, uint32_t u32ClkDiv); +void CLK_SetSysTickClockSrc(uint32_t u32ClkSrc); +void CLK_EnableXtalRC(uint32_t u32ClkMask); +void CLK_DisableXtalRC(uint32_t u32ClkMask); +void CLK_EnableModuleClock(uint32_t u32ModuleIdx); +void CLK_DisableModuleClock(uint32_t u32ModuleIdx); +uint32_t CLK_EnablePLL(uint32_t u32PllClkSrc, uint32_t u32PllFreq); +void CLK_DisablePLL(void); +uint32_t CLK_WaitClockReady(uint32_t u32ClkMask); +void CLK_EnableSysTick(uint32_t u32ClkSrc, uint32_t u32Count); +void CLK_DisableSysTick(void); +void CLK_SetPowerDownMode(uint32_t u32PDMode); +void CLK_EnableDPDWKPin(uint32_t u32TriggerType); +uint32_t CLK_GetPMUWKSrc(void); +void CLK_EnableSPDWKPin(uint32_t u32Port, uint32_t u32Pin, uint32_t u32TriggerType, uint32_t u32DebounceEn); +uint32_t CLK_GetPLLClockFreq(void); +uint32_t CLK_GetModuleClockSource(uint32_t u32ModuleIdx); +uint32_t CLK_GetModuleClockDivider(uint32_t u32ModuleIdx); + +/*@}*/ /* end of group CLK_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group CLK_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_CLK_H__ */ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_crc.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_crc.h new file mode 100644 index 00000000000..2dc6afca049 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_crc.h @@ -0,0 +1,113 @@ +/**************************************************************************//** + * @file nu_crc.h + * @version V1.00 + * @brief M480 series CRC driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __NU_CRC_H__ +#define __NU_CRC_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup CRC_Driver CRC Driver + @{ +*/ + +/** @addtogroup CRC_EXPORTED_CONSTANTS CRC Exported Constants + @{ +*/ +/*---------------------------------------------------------------------------------------------------------*/ +/* CRC Polynomial Mode Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define CRC_CCITT (0UL << CRC_CTL_CRCMODE_Pos) /*!SEED = (u32Seed); CRC->CTL |= CRC_CTL_CHKSINIT_Msk; }while(0) + +/** + * @brief Get CRC Seed Value + * + * @param None + * + * @return CRC seed value + * + * @details This macro gets the current CRC seed value. + * \hideinitializer + */ +#define CRC_GET_SEED() (CRC->SEED) + +/** + * @brief CRC Write Data + * + * @param[in] u32Data Write data + * + * @return None + * + * @details User can write data directly to CRC Write Data Register(CRC_DAT) by this macro to perform CRC operation. + * \hideinitializer + */ +#define CRC_WRITE_DATA(u32Data) (CRC->DAT = (u32Data)) + +void CRC_Open(uint32_t u32Mode, uint32_t u32Attribute, uint32_t u32Seed, uint32_t u32DataLen); +uint32_t CRC_GetChecksum(void); + +/*@}*/ /* end of group CRC_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group CRC_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_crypto.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_crypto.h new file mode 100644 index 00000000000..6b0ccb27d0a --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_crypto.h @@ -0,0 +1,378 @@ +/**************************************************************************//** + * @file nu_crypto.h + * @version V1.10 + * @brief Cryptographic Accelerator driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + ******************************************************************************/ +#ifndef __NU_CRYPTO_H__ +#define __NU_CRYPTO_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup CRYPTO_Driver CRYPTO Driver + @{ +*/ + + +/** @addtogroup CRYPTO_EXPORTED_CONSTANTS CRYPTO Exported Constants + @{ +*/ + +#define PRNG_KEY_SIZE_64 0UL /*!< Select to generate 64-bit random key \hideinitializer */ +#define PRNG_KEY_SIZE_128 1UL /*!< Select to generate 128-bit random key \hideinitializer */ +#define PRNG_KEY_SIZE_192 2UL /*!< Select to generate 192-bit random key \hideinitializer */ +#define PRNG_KEY_SIZE_256 3UL /*!< Select to generate 256-bit random key \hideinitializer */ + +#define PRNG_SEED_CONT 0UL /*!< PRNG using current seed \hideinitializer */ +#define PRNG_SEED_RELOAD 1UL /*!< PRNG reload new seed \hideinitializer */ + +#define AES_KEY_SIZE_128 0UL /*!< AES select 128-bit key length \hideinitializer */ +#define AES_KEY_SIZE_192 1UL /*!< AES select 192-bit key length \hideinitializer */ +#define AES_KEY_SIZE_256 2UL /*!< AES select 256-bit key length \hideinitializer */ + +#define AES_MODE_ECB 0UL /*!< AES select ECB mode \hideinitializer */ +#define AES_MODE_CBC 1UL /*!< AES select CBC mode \hideinitializer */ +#define AES_MODE_CFB 2UL /*!< AES select CFB mode \hideinitializer */ +#define AES_MODE_OFB 3UL /*!< AES select OFB mode \hideinitializer */ +#define AES_MODE_CTR 4UL /*!< AES select CTR mode \hideinitializer */ +#define AES_MODE_CBC_CS1 0x10UL /*!< AES select CBC CS1 mode \hideinitializer */ +#define AES_MODE_CBC_CS2 0x11UL /*!< AES select CBC CS2 mode \hideinitializer */ +#define AES_MODE_CBC_CS3 0x12UL /*!< AES select CBC CS3 mode \hideinitializer */ + +#define AES_NO_SWAP 0UL /*!< AES do not swap input and output data \hideinitializer */ +#define AES_OUT_SWAP 1UL /*!< AES swap output data \hideinitializer */ +#define AES_IN_SWAP 2UL /*!< AES swap input data \hideinitializer */ +#define AES_IN_OUT_SWAP 3UL /*!< AES swap both input and output data \hideinitializer */ + +#define DES_MODE_ECB 0x000UL /*!< DES select ECB mode \hideinitializer */ +#define DES_MODE_CBC 0x100UL /*!< DES select CBC mode \hideinitializer */ +#define DES_MODE_CFB 0x200UL /*!< DES select CFB mode \hideinitializer */ +#define DES_MODE_OFB 0x300UL /*!< DES select OFB mode \hideinitializer */ +#define DES_MODE_CTR 0x400UL /*!< DES select CTR mode \hideinitializer */ +#define TDES_MODE_ECB 0x004UL /*!< TDES select ECB mode \hideinitializer */ +#define TDES_MODE_CBC 0x104UL /*!< TDES select CBC mode \hideinitializer */ +#define TDES_MODE_CFB 0x204UL /*!< TDES select CFB mode \hideinitializer */ +#define TDES_MODE_OFB 0x304UL /*!< TDES select OFB mode \hideinitializer */ +#define TDES_MODE_CTR 0x404UL /*!< TDES select CTR mode \hideinitializer */ + +#define TDES_NO_SWAP 0UL /*!< TDES do not swap data \hideinitializer */ +#define TDES_WHL_SWAP 1UL /*!< TDES swap high-low word \hideinitializer */ +#define TDES_OUT_SWAP 2UL /*!< TDES swap output data \hideinitializer */ +#define TDES_OUT_WHL_SWAP 3UL /*!< TDES swap output data and high-low word \hideinitializer */ +#define TDES_IN_SWAP 4UL /*!< TDES swap input data \hideinitializer */ +#define TDES_IN_WHL_SWAP 5UL /*!< TDES swap input data and high-low word \hideinitializer */ +#define TDES_IN_OUT_SWAP 6UL /*!< TDES swap both input and output data \hideinitializer */ +#define TDES_IN_OUT_WHL_SWAP 7UL /*!< TDES swap input, output and high-low word \hideinitializer */ + +#define SHA_MODE_SHA1 0UL /*!< SHA select SHA-1 160-bit \hideinitializer */ +#define SHA_MODE_SHA224 5UL /*!< SHA select SHA-224 224-bit \hideinitializer */ +#define SHA_MODE_SHA256 4UL /*!< SHA select SHA-256 256-bit \hideinitializer */ +#define SHA_MODE_SHA384 7UL /*!< SHA select SHA-384 384-bit \hideinitializer */ +#define SHA_MODE_SHA512 6UL /*!< SHA select SHA-512 512-bit \hideinitializer */ + +#define SHA_NO_SWAP 0UL /*!< SHA do not swap input and output data \hideinitializer */ +#define SHA_OUT_SWAP 1UL /*!< SHA swap output data \hideinitializer */ +#define SHA_IN_SWAP 2UL /*!< SHA swap input data \hideinitializer */ +#define SHA_IN_OUT_SWAP 3UL /*!< SHA swap both input and output data \hideinitializer */ + +#define CRYPTO_DMA_FIRST 0x4UL /*!< Do first encrypt/decrypt in DMA cascade \hideinitializer */ +#define CRYPTO_DMA_ONE_SHOT 0x5UL /*!< Do one shot encrypt/decrypt with DMA \hideinitializer */ +#define CRYPTO_DMA_CONTINUE 0x6UL /*!< Do continuous encrypt/decrypt in DMA cascade \hideinitializer */ +#define CRYPTO_DMA_LAST 0x7UL /*!< Do last encrypt/decrypt in DMA cascade \hideinitializer */ + +typedef enum +{ + /*!< ECC curve \hideinitializer */ + CURVE_P_192, /*!< ECC curve P-192 \hideinitializer */ + CURVE_P_224, /*!< ECC curve P-224 \hideinitializer */ + CURVE_P_256, /*!< ECC curve P-256 \hideinitializer */ + CURVE_P_384, /*!< ECC curve P-384 \hideinitializer */ + CURVE_P_521, /*!< ECC curve P-521 \hideinitializer */ + CURVE_K_163, /*!< ECC curve K-163 \hideinitializer */ + CURVE_K_233, /*!< ECC curve K-233 \hideinitializer */ + CURVE_K_283, /*!< ECC curve K-283 \hideinitializer */ + CURVE_K_409, /*!< ECC curve K-409 \hideinitializer */ + CURVE_K_571, /*!< ECC curve K-571 \hideinitializer */ + CURVE_B_163, /*!< ECC curve B-163 \hideinitializer */ + CURVE_B_233, /*!< ECC curve B-233 \hideinitializer */ + CURVE_B_283, /*!< ECC curve B-283 \hideinitializer */ + CURVE_B_409, /*!< ECC curve B-409 \hideinitializer */ + CURVE_B_571, /*!< ECC curve K-571 \hideinitializer */ + CURVE_KO_192, /*!< ECC 192-bits "Koblitz" curve \hideinitializer */ + CURVE_KO_224, /*!< ECC 224-bits "Koblitz" curve \hideinitializer */ + CURVE_KO_256, /*!< ECC 256-bits "Koblitz" curve \hideinitializer */ + CURVE_BP_256, /*!< ECC Brainpool 256-bits curve \hideinitializer */ + CURVE_BP_384, /*!< ECC Brainpool 256-bits curve \hideinitializer */ + CURVE_BP_512, /*!< ECC Brainpool 256-bits curve \hideinitializer */ + CURVE_UNDEF, /*!< Invalid curve \hideinitializer */ +} +E_ECC_CURVE; /*!< ECC curve \hideinitializer */ + + +/*@}*/ /* end of group CRYPTO_EXPORTED_CONSTANTS */ + + +/** @addtogroup M480_CRYPTO_EXPORTED_MACROS CRYPTO Exported Macros + @{ +*/ + +/*----------------------------------------------------------------------------------------------*/ +/* Macros */ +/*----------------------------------------------------------------------------------------------*/ + +/** + * @brief This macro enables PRNG interrupt. + * @param crpt Specified cripto module + * @return None + * \hideinitializer + */ +#define PRNG_ENABLE_INT(crpt) ((crpt)->INTEN |= CRPT_INTEN_PRNGIEN_Msk) + +/** + * @brief This macro disables PRNG interrupt. + * @param crpt Specified cripto module + * @return None + * \hideinitializer + */ +#define PRNG_DISABLE_INT(crpt) ((crpt)->INTEN &= ~CRPT_INTEN_PRNGIEN_Msk) + +/** + * @brief This macro gets PRNG interrupt flag. + * @param crpt Specified cripto module + * @return PRNG interrupt flag. + * \hideinitializer + */ +#define PRNG_GET_INT_FLAG(crpt) ((crpt)->INTSTS & CRPT_INTSTS_PRNGIF_Msk) + +/** + * @brief This macro clears PRNG interrupt flag. + * @param crpt Specified cripto module + * @return None + * \hideinitializer + */ +#define PRNG_CLR_INT_FLAG(crpt) ((crpt)->INTSTS = CRPT_INTSTS_PRNGIF_Msk) + +/** + * @brief This macro enables AES interrupt. + * @param crpt Specified cripto module + * @return None + * \hideinitializer + */ +#define AES_ENABLE_INT(crpt) ((crpt)->INTEN |= (CRPT_INTEN_AESIEN_Msk|CRPT_INTEN_AESEIEN_Msk)) + +/** + * @brief This macro disables AES interrupt. + * @param crpt Specified cripto module + * @return None + * \hideinitializer + */ +#define AES_DISABLE_INT(crpt) ((crpt)->INTEN &= ~(CRPT_INTEN_AESIEN_Msk|CRPT_INTEN_AESEIEN_Msk)) + +/** + * @brief This macro gets AES interrupt flag. + * @param crpt Specified cripto module + * @return AES interrupt flag. + * \hideinitializer + */ +#define AES_GET_INT_FLAG(crpt) ((crpt)->INTSTS & (CRPT_INTSTS_AESIF_Msk|CRPT_INTSTS_AESEIF_Msk)) + +/** + * @brief This macro clears AES interrupt flag. + * @param crpt Specified cripto module + * @return None + * \hideinitializer + */ +#define AES_CLR_INT_FLAG(crpt) ((crpt)->INTSTS = (CRPT_INTSTS_AESIF_Msk|CRPT_INTSTS_AESEIF_Msk)) + +/** + * @brief This macro enables AES key protection. + * @param crpt Specified cripto module + * @return None + * \hideinitializer + */ +#define AES_ENABLE_KEY_PROTECT(crpt) ((crpt)->AES_CTL |= CRPT_AES_CTL_KEYPRT_Msk) + +/** + * @brief This macro disables AES key protection. + * @param crpt Specified cripto module + * @return None + * \hideinitializer + */ +#define AES_DISABLE_KEY_PROTECT(crpt) ((crpt)->AES_CTL = ((crpt)->AES_CTL & ~CRPT_AES_CTL_KEYPRT_Msk) | (0x16UL<AES_CTL &= ~CRPT_AES_CTL_KEYPRT_Msk) + +/** + * @brief This macro enables TDES interrupt. + * @param crpt Specified cripto module + * @return None + * \hideinitializer + */ +#define TDES_ENABLE_INT(crpt) ((crpt)->INTEN |= (CRPT_INTEN_TDESIEN_Msk|CRPT_INTEN_TDESEIEN_Msk)) + +/** + * @brief This macro disables TDES interrupt. + * @param crpt Specified cripto module + * @return None + * \hideinitializer + */ +#define TDES_DISABLE_INT(crpt) ((crpt)->INTEN &= ~(CRPT_INTEN_TDESIEN_Msk|CRPT_INTEN_TDESEIEN_Msk)) + +/** + * @brief This macro gets TDES interrupt flag. + * @param crpt Specified cripto module + * @return TDES interrupt flag. + * \hideinitializer + */ +#define TDES_GET_INT_FLAG(crpt) ((crpt)->INTSTS & (CRPT_INTSTS_TDESIF_Msk|CRPT_INTSTS_TDESEIF_Msk)) + +/** + * @brief This macro clears TDES interrupt flag. + * @param crpt Specified cripto module + * @return None + * \hideinitializer + */ +#define TDES_CLR_INT_FLAG(crpt) ((crpt)->INTSTS = (CRPT_INTSTS_TDESIF_Msk|CRPT_INTSTS_TDESEIF_Msk)) + +/** + * @brief This macro enables TDES key protection. + * @param crpt Specified cripto module + * @return None + * \hideinitializer + */ +#define TDES_ENABLE_KEY_PROTECT(crpt) ((crpt)->TDES_CTL |= CRPT_TDES_CTL_KEYPRT_Msk) + +/** + * @brief This macro disables TDES key protection. + * @param crpt Specified cripto module + * @return None + * \hideinitializer + */ +#define TDES_DISABLE_KEY_PROTECT(crpt) ((crpt)->TDES_CTL = ((crpt)->TDES_CTL & ~CRPT_TDES_CTL_KEYPRT_Msk) | (0x16UL<TDES_CTL &= ~CRPT_TDES_CTL_KEYPRT_Msk) + +/** + * @brief This macro enables SHA interrupt. + * @param crpt Specified cripto module + * @return None + * \hideinitializer + */ +#define SHA_ENABLE_INT(crpt) ((crpt)->INTEN |= (CRPT_INTEN_HMACIEN_Msk|CRPT_INTEN_HMACEIEN_Msk)) + +/** + * @brief This macro disables SHA interrupt. + * @param crpt Specified cripto module + * @return None + * \hideinitializer + */ +#define SHA_DISABLE_INT(crpt) ((crpt)->INTEN &= ~(CRPT_INTEN_HMACIEN_Msk|CRPT_INTEN_HMACEIEN_Msk)) + +/** + * @brief This macro gets SHA interrupt flag. + * @param crpt Specified cripto module + * @return SHA interrupt flag. + * \hideinitializer + */ +#define SHA_GET_INT_FLAG(crpt) ((crpt)->INTSTS & (CRPT_INTSTS_HMACIF_Msk|CRPT_INTSTS_HMACEIF_Msk)) + +/** + * @brief This macro clears SHA interrupt flag. + * @param crpt Specified cripto module + * @return None + * \hideinitializer + */ +#define SHA_CLR_INT_FLAG(crpt) ((crpt)->INTSTS = (CRPT_INTSTS_HMACIF_Msk|CRPT_INTSTS_HMACEIF_Msk)) + +/** + * @brief This macro enables ECC interrupt. + * @param crpt Specified cripto module + * @return None + * \hideinitializer + */ +#define ECC_ENABLE_INT(crpt) ((crpt)->INTEN |= (CRPT_INTEN_ECCIEN_Msk|CRPT_INTEN_ECCEIEN_Msk)) + +/** + * @brief This macro disables ECC interrupt. + * @param crpt Specified cripto module + * @return None + * \hideinitializer + */ +#define ECC_DISABLE_INT(crpt) ((crpt)->INTEN &= ~(CRPT_INTEN_ECCIEN_Msk|CRPT_INTEN_ECCEIEN_Msk)) + +/** + * @brief This macro gets ECC interrupt flag. + * @param crpt Specified cripto module + * @return ECC interrupt flag. + * \hideinitializer + */ +#define ECC_GET_INT_FLAG(crpt) ((crpt)->INTSTS & (CRPT_INTSTS_ECCIF_Msk|CRPT_INTSTS_ECCEIF_Msk)) + +/** + * @brief This macro clears ECC interrupt flag. + * @param crpt Specified cripto module + * @return None + * \hideinitializer + */ +#define ECC_CLR_INT_FLAG(crpt) ((crpt)->INTSTS = (CRPT_INTSTS_ECCIF_Msk|CRPT_INTSTS_ECCEIF_Msk)) + + +/*@}*/ /* end of group M480_CRYPTO_EXPORTED_MACROS */ + + +/** @addtogroup CRYPTO_EXPORTED_FUNCTIONS CRYPTO Exported Functions + @{ +*/ + + +/*---------------------------------------------------------------------------------------------------------*/ +/* Functions */ +/*---------------------------------------------------------------------------------------------------------*/ + +void PRNG_Open(CRPT_T *crpt, uint32_t u32KeySize, uint32_t u32SeedReload, uint32_t u32Seed); +void PRNG_Start(CRPT_T *crpt); +void PRNG_Read(CRPT_T *crpt, uint32_t u32RandKey[]); +void AES_Open(CRPT_T *crpt, uint32_t u32Channel, uint32_t u32EncDec, uint32_t u32OpMode, uint32_t u32KeySize, uint32_t u32SwapType); +void AES_Start(CRPT_T *crpt, uint32_t u32Channel, uint32_t u32DMAMode); +void AES_SetKey(CRPT_T *crpt, uint32_t u32Channel, uint32_t au32Keys[], uint32_t u32KeySize); +void AES_SetInitVect(CRPT_T *crpt, uint32_t u32Channel, uint32_t au32IV[]); +void AES_SetDMATransfer(CRPT_T *crpt, uint32_t u32Channel, uint32_t u32SrcAddr, uint32_t u32DstAddr, uint32_t u32TransCnt); +void TDES_Open(CRPT_T *crpt, uint32_t u32Channel, uint32_t u32EncDec, int32_t Is3DES, int32_t Is3Key, uint32_t u32OpMode, uint32_t u32SwapType); +void TDES_Start(CRPT_T *crpt, int32_t u32Channel, uint32_t u32DMAMode); +void TDES_SetKey(CRPT_T *crpt, uint32_t u32Channel, uint32_t au32Keys[3][2]); +void TDES_SetInitVect(CRPT_T *crpt, uint32_t u32Channel, uint32_t u32IVH, uint32_t u32IVL); +void TDES_SetDMATransfer(CRPT_T *crpt, uint32_t u32Channel, uint32_t u32SrcAddr, uint32_t u32DstAddr, uint32_t u32TransCnt); +void SHA_Open(CRPT_T *crpt, uint32_t u32OpMode, uint32_t u32SwapType, uint32_t hmac_key_len); +void SHA_Start(CRPT_T *crpt, uint32_t u32DMAMode); +void SHA_SetDMATransfer(CRPT_T *crpt, uint32_t u32SrcAddr, uint32_t u32TransCnt); +void SHA_Read(CRPT_T *crpt, uint32_t u32Digest[]); +void ECC_Complete(CRPT_T *crpt); +int ECC_IsPrivateKeyValid(CRPT_T *crpt, E_ECC_CURVE ecc_curve, char private_k[]); +int32_t ECC_GeneratePublicKey(CRPT_T *crpt, E_ECC_CURVE ecc_curve, char *private_k, char public_k1[], char public_k2[]); +int32_t ECC_Mutiply(CRPT_T *crpt, E_ECC_CURVE ecc_curve, char x1[], char y1[], char *k, char x2[], char y2[]); +int32_t ECC_GenerateSecretZ(CRPT_T *crpt, E_ECC_CURVE ecc_curve, char *private_k, char public_k1[], char public_k2[], char secret_z[]); +int32_t ECC_GenerateSignature(CRPT_T *crpt, E_ECC_CURVE ecc_curve, char *message, char *d, char *k, char *R, char *S); +int32_t ECC_VerifySignature(CRPT_T *crpt, E_ECC_CURVE ecc_curve, char *message, char *public_k1, char *public_k2, char *R, char *S); + + +/*@}*/ /* end of group CRYPTO_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group CRYPTO_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_CRYPTO_H__ */ + +/*** (C) COPYRIGHT 2017 Nuvoton Technology Corp. ***/ + diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_dac.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_dac.h new file mode 100644 index 00000000000..71c22f4e4a0 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_dac.h @@ -0,0 +1,269 @@ +/**************************************************************************//** + * @file nu_dac.h + * @version V1.00 + * @brief M480 series DAC driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. +*****************************************************************************/ +#ifndef __NU_DAC_H__ +#define __NU_DAC_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup DAC_Driver DAC Driver + @{ +*/ + + +/** @addtogroup DAC_EXPORTED_CONSTANTS DAC Exported Constants + @{ +*/ + +/*---------------------------------------------------------------------------------------------------------*/ +/* DAC_CTL Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define DAC_CTL_LALIGN_RIGHT_ALIGN (0UL<SWTRG = DAC_SWTRG_SWTRG_Msk) + +/** + * @brief Enable DAC data left-aligned. + * @param[in] dac Base address of DAC module. + * @return None + * @details User has to load data into DAC_DAT[15:4] bits. DAC_DAT[31:16] and DAC_DAT[3:0] are ignored in DAC conversion. + * \hideinitializer + */ +#define DAC_ENABLE_LEFT_ALIGN(dac) ((dac)->CTL |= DAC_CTL_LALIGN_Msk) + +/** + * @brief Enable DAC data right-aligned. + * @param[in] dac Base address of DAC module. + * @return None + * @details User has to load data into DAC_DAT[11:0] bits, DAC_DAT[31:12] are ignored in DAC conversion. + * \hideinitializer + */ +#define DAC_ENABLE_RIGHT_ALIGN(dac) ((dac)->CTL &= ~DAC_CTL_LALIGN_Msk) + +/** + * @brief Enable output voltage buffer. + * @param[in] dac Base address of DAC module. + * @return None + * @details The DAC integrates a voltage output buffer that can be used to reduce output impedance and + * drive external loads directly without having to add an external operational amplifier. + * \hideinitializer + */ +#define DAC_ENABLE_BYPASS_BUFFER(dac) ((dac)->CTL |= DAC_CTL_BYPASS_Msk) + +/** + * @brief Disable output voltage buffer. + * @param[in] dac Base address of DAC module. + * @return None + * @details This macro is used to disable output voltage buffer. + * \hideinitializer + */ +#define DAC_DISABLE_BYPASS_BUFFER(dac) ((dac)->CTL &= ~DAC_CTL_BYPASS_Msk) + +/** + * @brief Enable the interrupt. + * @param[in] dac Base address of DAC module. + * @param[in] u32Ch Not used in M480 DAC. + * @return None + * @details This macro is used to enable DAC interrupt. + * \hideinitializer + */ +#define DAC_ENABLE_INT(dac, u32Ch) ((dac)->CTL |= DAC_CTL_DACIEN_Msk) + +/** + * @brief Disable the interrupt. + * @param[in] dac Base address of DAC module. + * @param[in] u32Ch Not used in M480 DAC. + * @return None + * @details This macro is used to disable DAC interrupt. + * \hideinitializer + */ +#define DAC_DISABLE_INT(dac, u32Ch) ((dac)->CTL &= ~DAC_CTL_DACIEN_Msk) + +/** + * @brief Enable DMA under-run interrupt. + * @param[in] dac Base address of DAC module. + * @return None + * @details This macro is used to enable DMA under-run interrupt. + * \hideinitializer + */ +#define DAC_ENABLE_DMAUDR_INT(dac) ((dac)->CTL |= DAC_CTL_DMAURIEN_Msk) + +/** + * @brief Disable DMA under-run interrupt. + * @param[in] dac Base address of DAC module. + * @return None + * @details This macro is used to disable DMA under-run interrupt. + * \hideinitializer + */ +#define DAC_DISABLE_DMAUDR_INT(dac) ((dac)->CTL &= ~DAC_CTL_DMAURIEN_Msk) + +/** + * @brief Enable PDMA mode. + * @param[in] dac Base address of DAC module. + * @return None + * @details DAC DMA request is generated when a hardware trigger event occurs while DMAEN (DAC_CTL[2]) is set. + * \hideinitializer + */ +#define DAC_ENABLE_PDMA(dac) ((dac)->CTL |= DAC_CTL_DMAEN_Msk) + +/** + * @brief Disable PDMA mode. + * @param[in] dac Base address of DAC module. + * @return None + * @details This macro is used to disable DMA mode. + * \hideinitializer + */ +#define DAC_DISABLE_PDMA(dac) ((dac)->CTL &= ~DAC_CTL_DMAEN_Msk) + +/** + * @brief Write data for conversion. + * @param[in] dac Base address of DAC module. + * @param[in] u32Ch Not used in M480 DAC. + * @param[in] u32Data Decides the data for conversion, valid range are between 0~0xFFF. + * @return None + * @details 12 bit left alignment: user has to load data into DAC_DAT[15:4] bits. + * 12 bit right alignment: user has to load data into DAC_DAT[11:0] bits. + * \hideinitializer + */ +#define DAC_WRITE_DATA(dac, u32Ch, u32Data) ((dac)->DAT = (u32Data)) + +/** + * @brief Read DAC 12-bit holding data. + * @param[in] dac Base address of DAC module. + * @param[in] u32Ch Not used in M480 DAC. + * @return Return DAC 12-bit holding data. + * @details This macro is used to read DAC_DAT register. + * \hideinitializer + */ +#define DAC_READ_DATA(dac, u32Ch) ((dac)->DAT) + +/** + * @brief Get the busy state of DAC. + * @param[in] dac Base address of DAC module. + * @param[in] u32Ch Not used in M480 DAC. + * @retval 0 Idle state. + * @retval 1 Busy state. + * @details This macro is used to read BUSY bit (DAC_STATUS[8]) to get busy state. + * \hideinitializer + */ +#define DAC_IS_BUSY(dac, u32Ch) (((dac)->STATUS & DAC_STATUS_BUSY_Msk) >> DAC_STATUS_BUSY_Pos) + +/** + * @brief Get the interrupt flag. + * @param[in] dac Base address of DAC module. + * @param[in] u32Ch Not used in M480 DAC. + * @retval 0 DAC is in conversion state. + * @retval 1 DAC conversion finish. + * @details This macro is used to read FINISH bit (DAC_STATUS[0]) to get DAC conversion complete finish flag. + * \hideinitializer + */ +#define DAC_GET_INT_FLAG(dac, u32Ch) ((dac)->STATUS & DAC_STATUS_FINISH_Msk) + +/** + * @brief Get the DMA under-run flag. + * @param[in] dac Base address of DAC module. + * @retval 0 No DMA under-run error condition occurred. + * @retval 1 DMA under-run error condition occurred. + * @details This macro is used to read DMAUDR bit (DAC_STATUS[1]) to get DMA under-run state. + * \hideinitializer + */ +#define DAC_GET_DMAUDR_FLAG(dac) (((dac)->STATUS & DAC_STATUS_DMAUDR_Msk) >> DAC_STATUS_DMAUDR_Pos) + +/** + * @brief This macro clear the interrupt status bit. + * @param[in] dac Base address of DAC module. + * @param[in] u32Ch Not used in M480 DAC. + * @return None + * @details User writes FINISH bit (DAC_STATUS[0]) to clear DAC conversion complete finish flag. + * \hideinitializer + */ +#define DAC_CLR_INT_FLAG(dac, u32Ch) ((dac)->STATUS = DAC_STATUS_FINISH_Msk) + +/** + * @brief This macro clear the DMA under-run flag. + * @param[in] dac Base address of DAC module. + * @return None + * @details User writes DMAUDR bit (DAC_STATUS[1]) to clear DMA under-run flag. + * \hideinitializer + */ +#define DAC_CLR_DMAUDR_FLAG(dac) ((dac)->STATUS = DAC_STATUS_DMAUDR_Msk) + + +/** + * @brief Enable DAC group mode + * @param[in] dac Base address of DAC module. + * @return None + * \hideinitializer + */ +#define DAC_ENABLE_GROUP_MODE(dac) (DAC0->CTL |= DAC_CTL_GRPEN_Msk) + +/** + * @brief Disable DAC group mode + * @param[in] dac Base address of DAC module. + * @return None + * \hideinitializer + */ +#define DAC_DISABLE_GROUP_MODE(dac) (DAC0->CTL &= ~DAC_CTL_GRPEN_Msk) + +void DAC_Open(DAC_T *dac, uint32_t u32Ch, uint32_t u32TrgSrc); +void DAC_Close(DAC_T *dac, uint32_t u32Ch); +uint32_t DAC_SetDelayTime(DAC_T *dac, uint32_t u32Delay); + +/*@}*/ /* end of group DAC_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group DAC_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_DAC_H__ */ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_eadc.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_eadc.h new file mode 100644 index 00000000000..c9bd0ef39bc --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_eadc.h @@ -0,0 +1,616 @@ +/**************************************************************************//** + * @file nu_eadc.h + * @version V0.10 + * @brief M480 series EADC driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. +*****************************************************************************/ +#ifndef __NU_EADC_H__ +#define __NU_EADC_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup EADC_Driver EADC Driver + @{ +*/ + +/** @addtogroup EADC_EXPORTED_CONSTANTS EADC Exported Constants + @{ +*/ + +/*---------------------------------------------------------------------------------------------------------*/ +/* EADC_CTL Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define EADC_CTL_DIFFEN_SINGLE_END (0UL<CTL |= EADC_CTL_ADCRST_Msk) + +/** + * @brief Enable PDMA transfer. + * @param[in] eadc The pointer of the specified EADC module. + * @return None + * @details When A/D conversion is completed, the converted data is loaded into EADC_DATn (n: 0 ~ 18) register, + * user can enable this bit to generate a PDMA data transfer request. + * @note When set PDMAEN bit (EADC_CTL[11]), user must set ADINTENn (EADC_CTL[5:2], n=0~3) = 0 to disable interrupt. + * \hideinitializer + */ +#define EADC_ENABLE_PDMA(eadc) ((eadc)->CTL |= EADC_CTL_PDMAEN_Msk) + +/** + * @brief Disable PDMA transfer. + * @param[in] eadc The pointer of the specified EADC module. + * @return None + * @details This macro is used to disable PDMA transfer. + * \hideinitializer + */ +#define EADC_DISABLE_PDMA(eadc) ((eadc)->CTL &= (~EADC_CTL_PDMAEN_Msk)) + +/** + * @brief Enable Sample Module PDMA transfer. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32ModuleMask the combination of sample module interrupt status bits. Each bit corresponds to a sample module interrupt status. + * This parameter decides which sample module interrupts will be disabled, valid range are between 1~0x7FFFF. + * @return None + * @details When A/D conversion is completed, the converted data is loaded into EADC_DATn (n: 0 ~ 18) register, + * user can enable this bit to generate a PDMA data transfer request. + * \hideinitializer + */ +#define EADC_ENABLE_SAMPLE_MODULE_PDMA(eadc, u32ModuleMask) ((eadc)->PDMACTL |= u32ModuleMask) + +/** + * @brief Disable Sample Module PDMA transfer. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32ModuleMask the combination of sample module interrupt status bits. Each bit corresponds to a sample module interrupt status. + * This parameter decides which sample module interrupts will be disabled, valid range are between 1~0x7FFFF. + * @return None + * @details This macro is used to disable sample module PDMA transfer. + * \hideinitializer + */ +#define EADC_DISABLE_SAMPLE_MODULE_PDMA(eadc, u32ModuleMask) ((eadc)->PDMACTL &= (~u32ModuleMask)) + +/** + * @brief Enable double buffer mode. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32ModuleNum Decides the sample module number, valid value are from 0 to 3. + * @return None + * @details The ADC controller supports a double buffer mode in sample module 0~3. + * If user enable DBMEN (EADC_SCTLn[23], n=0~3), the double buffer mode will enable. + * \hideinitializer + */ +#define EADC_ENABLE_DOUBLE_BUFFER(eadc, u32ModuleNum) ((eadc)->SCTL[(u32ModuleNum)] |= EADC_SCTL_DBMEN_Msk) + +/** + * @brief Disable double buffer mode. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32ModuleNum Decides the sample module number, valid value are from 0 to 3. + * @return None + * @details Sample has one sample result register. + * \hideinitializer + */ +#define EADC_DISABLE_DOUBLE_BUFFER(eadc, u32ModuleNum) ((eadc)->SCTL[(u32ModuleNum)] &= ~EADC_SCTL_DBMEN_Msk) + +/** + * @brief Set ADIFn at A/D end of conversion. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32ModuleNum Decides the sample module number, valid value are from 0 to 15. + * @return None + * @details The A/D converter generates ADIFn (EADC_STATUS2[3:0], n=0~3) at the start of conversion. + * \hideinitializer + */ +#define EADC_ENABLE_INT_POSITION(eadc, u32ModuleNum) ((eadc)->SCTL[(u32ModuleNum)] |= EADC_SCTL_INTPOS_Msk) + +/** + * @brief Set ADIFn at A/D start of conversion. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32ModuleNum Decides the sample module number, valid value are from 0 to 15. + * @return None + * @details The A/D converter generates ADIFn (EADC_STATUS2[3:0], n=0~3) at the end of conversion. + * \hideinitializer + */ +#define EADC_DISABLE_INT_POSITION(eadc, u32ModuleNum) ((eadc)->SCTL[(u32ModuleNum)] &= ~EADC_SCTL_INTPOS_Msk) + +/** + * @brief Enable the interrupt. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32Mask Decides the combination of interrupt status bits. Each bit corresponds to a interrupt status. + * This parameter decides which interrupts will be enabled. Bit 0 is ADCIEN0, bit 1 is ADCIEN1..., bit 3 is ADCIEN3. + * @return None + * @details The A/D converter generates a conversion end ADIFn (EADC_STATUS2[n]) upon the end of specific sample module A/D conversion. + * If ADCIENn bit (EADC_CTL[n+2]) is set then conversion end interrupt request ADINTn is generated (n=0~3). + * \hideinitializer + */ +#define EADC_ENABLE_INT(eadc, u32Mask) ((eadc)->CTL |= ((u32Mask) << EADC_CTL_ADCIEN0_Pos)) + +/** + * @brief Disable the interrupt. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32Mask Decides the combination of interrupt status bits. Each bit corresponds to a interrupt status. + * This parameter decides which interrupts will be disabled. Bit 0 is ADCIEN0, bit 1 is ADCIEN1..., bit 3 is ADCIEN3. + * @return None + * @details Specific sample module A/D ADINT0 interrupt function Disabled. + * \hideinitializer + */ +#define EADC_DISABLE_INT(eadc, u32Mask) ((eadc)->CTL &= ~((u32Mask) << EADC_CTL_ADCIEN0_Pos)) + +/** + * @brief Enable the sample module interrupt. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32IntSel Decides which interrupt source will be used, valid value are from 0 to 3. + * @param[in] u32ModuleMask the combination of sample module interrupt status bits. Each bit corresponds to a sample module interrupt status. + * This parameter decides which sample module interrupts will be enabled, valid range are between 1~0x7FFFF. + * @return None + * @details There are 4 ADC interrupts ADINT0~3, and each of these interrupts has its own interrupt vector address. + * \hideinitializer + */ +#define EADC_ENABLE_SAMPLE_MODULE_INT(eadc, u32IntSel, u32ModuleMask) ((eadc)->INTSRC[(u32IntSel)] |= (u32ModuleMask)) + +/** + * @brief Disable the sample module interrupt. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32IntSel Decides which interrupt source will be used, valid value are from 0 to 3. + * @param[in] u32ModuleMask the combination of sample module interrupt status bits. Each bit corresponds to a sample module interrupt status. + * This parameter decides which sample module interrupts will be disabled, valid range are between 1~0x7FFFF. + * @return None + * @details There are 4 ADC interrupts ADINT0~3, and each of these interrupts has its own interrupt vector address. + * \hideinitializer + */ +#define EADC_DISABLE_SAMPLE_MODULE_INT(eadc, u32IntSel, u32ModuleMask) ((eadc)->INTSRC[(u32IntSel)] &= ~(u32ModuleMask)) + +/** + * @brief Set the input mode output format. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32Format Decides the output format. Valid values are: + * - EADC_CTL_DMOF_STRAIGHT_BINARY :Select the straight binary format as the output format of the conversion result. + * - EADC_CTL_DMOF_TWOS_COMPLEMENT :Select the 2's complement format as the output format of the conversion result. + * @return None + * @details The macro is used to set A/D input mode output format. + * \hideinitializer + */ +#define EADC_SET_DMOF(eadc, u32Format) ((eadc)->CTL = ((eadc)->CTL & ~EADC_CTL_DMOF_Msk) | (u32Format)) + +/** + * @brief Start the A/D conversion. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32ModuleMask The combination of sample module. Each bit corresponds to a sample module. + * This parameter decides which sample module will be conversion, valid range are between 1~0x7FFFF. + * Bit 0 is sample module 0, bit 1 is sample module 1..., bit 18 is sample module 18. + * @return None + * @details After write EADC_SWTRG register to start ADC conversion, the EADC_PENDSTS register will show which SAMPLE will conversion. + * \hideinitializer + */ +#define EADC_START_CONV(eadc, u32ModuleMask) ((eadc)->SWTRG = (u32ModuleMask)) + +/** + * @brief Cancel the conversion for sample module. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32ModuleMask The combination of sample module. Each bit corresponds to a sample module. + * This parameter decides which sample module will stop the conversion, valid range are between 1~0x7FFFF. + * Bit 0 is sample module 0, bit 1 is sample module 1..., bit 18 is sample module18. + * @return None + * @details If user want to disable the conversion of the sample module, user can write EADC_PENDSTS register to clear it. + * \hideinitializer + */ +#define EADC_STOP_CONV(eadc, u32ModuleMask) ((eadc)->PENDSTS = (u32ModuleMask)) + +/** + * @brief Get the conversion pending flag. + * @param[in] eadc The pointer of the specified EADC module. + * @return Return the conversion pending sample module. + * @details This STPFn(EADC_PENDSTS[18:0]) bit remains 1 during pending state, when the respective ADC conversion is end, + * the STPFn (n=0~18) bit is automatically cleared to 0. + * \hideinitializer + */ +#define EADC_GET_PENDING_CONV(eadc) ((eadc)->PENDSTS) + +/** + * @brief Get the conversion data of the user-specified sample module. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32ModuleNum Decides the sample module number, valid value are from 0 to 18. + * @return Return the conversion data of the user-specified sample module. + * @details This macro is used to read RESULT bit (EADC_DATn[15:0], n=0~18) field to get conversion data. + * \hideinitializer + */ +#define EADC_GET_CONV_DATA(eadc, u32ModuleNum) ((eadc)->DAT[(u32ModuleNum)] & EADC_DAT_RESULT_Msk) + +/** + * @brief Get the data overrun flag of the user-specified sample module. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32ModuleMask The combination of data overrun status bits. Each bit corresponds to a data overrun status, valid range are between 1~0x7FFFF. + * @return Return the data overrun flag of the user-specified sample module. + * @details This macro is used to read OV bit (EADC_STATUS0[31:16], EADC_STATUS1[18:16]) field to get data overrun status. + * \hideinitializer + */ +#define EADC_GET_DATA_OVERRUN_FLAG(eadc, u32ModuleMask) ((((eadc)->STATUS0 >> EADC_STATUS0_OV_Pos) | ((eadc)->STATUS1 & EADC_STATUS1_OV_Msk)) & (u32ModuleMask)) + +/** + * @brief Get the data valid flag of the user-specified sample module. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32ModuleMask The combination of data valid status bits. Each bit corresponds to a data valid status, valid range are between 1~0x7FFFF. + * @return Return the data valid flag of the user-specified sample module. + * @details This macro is used to read VALID bit (EADC_STATUS0[15:0], EADC_STATUS1[2:0]) field to get data valid status. + * \hideinitializer + */ +#define EADC_GET_DATA_VALID_FLAG(eadc, u32ModuleMask) ((((eadc)->STATUS0 & EADC_STATUS0_VALID_Msk) | (((eadc)->STATUS1 & EADC_STATUS1_VALID_Msk) << 16)) & (u32ModuleMask)) + +/** + * @brief Get the double data of the user-specified sample module. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32ModuleNum Decides the sample module number, valid value are from 0 to 18. + * @return Return the double data of the user-specified sample module. + * @details This macro is used to read RESULT bit (EADC_DDATn[15:0], n=0~3) field to get conversion data. + * \hideinitializer + */ +#define EADC_GET_DOUBLE_DATA(eadc, u32ModuleNum) ((eadc)->DDAT[(u32ModuleNum)] & EADC_DDAT0_RESULT_Msk) + +/** + * @brief Get the user-specified interrupt flags. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32Mask The combination of interrupt status bits. Each bit corresponds to a interrupt status. + * Bit 0 is ADIF0, bit 1 is ADIF1..., bit 3 is ADIF3. + * Bit 4 is ADCMPF0, bit 5 is ADCMPF1..., bit 7 is ADCMPF3. + * @return Return the user-specified interrupt flags. + * @details This macro is used to get the user-specified interrupt flags. + * \hideinitializer + */ +#define EADC_GET_INT_FLAG(eadc, u32Mask) ((eadc)->STATUS2 & (u32Mask)) + +/** + * @brief Get the user-specified sample module overrun flags. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32ModuleMask The combination of sample module overrun status bits. Each bit corresponds to a sample module overrun status, valid range are between 1~0x7FFFF. + * @return Return the user-specified sample module overrun flags. + * @details This macro is used to get the user-specified sample module overrun flags. + * \hideinitializer + */ +#define EADC_GET_SAMPLE_MODULE_OV_FLAG(eadc, u32ModuleMask) ((eadc)->OVSTS & (u32ModuleMask)) + +/** + * @brief Clear the selected interrupt status bits. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32Mask The combination of compare interrupt status bits. Each bit corresponds to a compare interrupt status. + * Bit 0 is ADIF0, bit 1 is ADIF1..., bit 3 is ADIF3. + * Bit 4 is ADCMPF0, bit 5 is ADCMPF1..., bit 7 is ADCMPF3. + * @return None + * @details This macro is used to clear clear the selected interrupt status bits. + * \hideinitializer + */ +#define EADC_CLR_INT_FLAG(eadc, u32Mask) ((eadc)->STATUS2 = (u32Mask)) + +/** + * @brief Clear the selected sample module overrun status bits. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32ModuleMask The combination of sample module overrun status bits. Each bit corresponds to a sample module overrun status. + * Bit 0 is SPOVF0, bit 1 is SPOVF1..., bit 18 is SPOVF18. + * @return None + * @details This macro is used to clear the selected sample module overrun status bits. + * \hideinitializer + */ +#define EADC_CLR_SAMPLE_MODULE_OV_FLAG(eadc, u32ModuleMask) ((eadc)->OVSTS = (u32ModuleMask)) + +/** + * @brief Check all sample module A/D result data register overrun flags. + * @param[in] eadc The pointer of the specified EADC module. + * @retval 0 None of sample module data register overrun flag is set to 1. + * @retval 1 Any one of sample module data register overrun flag is set to 1. + * @details The AOV bit (EADC_STATUS2[27]) will keep 1 when any one of sample module data register overrun flag OVn (EADC_DATn[16]) is set to 1. + * \hideinitializer + */ +#define EADC_IS_DATA_OV(eadc) (((eadc)->STATUS2 & EADC_STATUS2_AOV_Msk) >> EADC_STATUS2_AOV_Pos) + +/** + * @brief Check all sample module A/D result data register valid flags. + * @param[in] eadc The pointer of the specified EADC module. + * @retval 0 None of sample module data register valid flag is set to 1. + * @retval 1 Any one of sample module data register valid flag is set to 1. + * @details The AVALID bit (EADC_STATUS2[26]) will keep 1 when any one of sample module data register valid flag VALIDn (EADC_DATn[17]) is set to 1. + * \hideinitializer + */ +#define EADC_IS_DATA_VALID(eadc) (((eadc)->STATUS2 & EADC_STATUS2_AVALID_Msk) >> EADC_STATUS2_AVALID_Pos) + +/** + * @brief Check all A/D sample module start of conversion overrun flags. + * @param[in] eadc The pointer of the specified EADC module. + * @retval 0 None of sample module event overrun flag is set to 1. + * @retval 1 Any one of sample module event overrun flag is set to 1. + * @details The STOVF bit (EADC_STATUS2[25]) will keep 1 when any one of sample module event overrun flag SPOVFn (EADC_OVSTS[n]) is set to 1. + * \hideinitializer + */ +#define EADC_IS_SAMPLE_MODULE_OV(eadc) (((eadc)->STATUS2 & EADC_STATUS2_STOVF_Msk) >> EADC_STATUS2_STOVF_Pos) + +/** + * @brief Check all A/D interrupt flag overrun bits. + * @param[in] eadc The pointer of the specified EADC module. + * @retval 0 None of ADINT interrupt flag is overwritten to 1. + * @retval 1 Any one of ADINT interrupt flag is overwritten to 1. + * @details The ADOVIF bit (EADC_STATUS2[24]) will keep 1 when any one of ADINT interrupt flag ADOVIFn (EADC_STATUS2[11:8]) is overwritten to 1. + * \hideinitializer + */ +#define EADC_IS_INT_FLAG_OV(eadc) (((eadc)->STATUS2 & EADC_STATUS2_ADOVIF_Msk) >> EADC_STATUS2_ADOVIF_Pos) + +/** + * @brief Get the busy state of EADC. + * @param[in] eadc The pointer of the specified EADC module. + * @retval 0 Idle state. + * @retval 1 Busy state. + * @details This macro is used to read BUSY bit (EADC_STATUS2[23]) to get busy state. + * \hideinitializer + */ +#define EADC_IS_BUSY(eadc) (((eadc)->STATUS2 & EADC_STATUS2_BUSY_Msk) >> EADC_STATUS2_BUSY_Pos) + +/** + * @brief Configure the comparator 0 and enable it. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32ModuleNum specifies the compare sample module, valid value are from 0 to 18. + * @param[in] u32Condition specifies the compare condition. Valid values are: + * - \ref EADC_CMP_CMPCOND_LESS_THAN :The compare condition is "less than the compare value" + * - \ref EADC_CMP_CMPCOND_GREATER_OR_EQUAL :The compare condition is "greater than or equal to the compare value + * @param[in] u16CMPData specifies the compare value, valid range are between 0~0xFFF. + * @param[in] u32MatchCount specifies the match count setting, valid range are between 0~0xF. + * @return None + * @details For example, ADC_ENABLE_CMP0(EADC, 5, ADC_ADCMPR_CMPCOND_GREATER_OR_EQUAL, 0x800, 10, EADC_CMP_CMPWEN_DISABLE, EADC_CMP_ADCMPIE_ENABLE); + * Means EADC will assert comparator 0 flag if sample module 5 conversion result is greater or + * equal to 0x800 for 10 times continuously, and a compare interrupt request is generated. + * \hideinitializer + */ +#define EADC_ENABLE_CMP0(eadc,\ + u32ModuleNum,\ + u32Condition,\ + u16CMPData,\ + u32MatchCount) ((eadc)->CMP[0] |=(((u32ModuleNum) << EADC_CMP_CMPSPL_Pos)|\ + (u32Condition) |\ + ((u16CMPData) << EADC_CMP_CMPDAT_Pos)| \ + (((u32MatchCount) - 1) << EADC_CMP_CMPMCNT_Pos)|\ + EADC_CMP_ADCMPEN_Msk)) + +/** + * @brief Configure the comparator 1 and enable it. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32ModuleNum specifies the compare sample module, valid value are from 0 to 18. + * @param[in] u32Condition specifies the compare condition. Valid values are: + * - \ref EADC_CMP_CMPCOND_LESS_THAN :The compare condition is "less than the compare value" + * - \ref EADC_CMP_CMPCOND_GREATER_OR_EQUAL :The compare condition is "greater than or equal to the compare value + * @param[in] u16CMPData specifies the compare value, valid range are between 0~0xFFF. + * @param[in] u32MatchCount specifies the match count setting, valid range are between 0~0xF. + * @return None + * @details For example, ADC_ENABLE_CMP1(EADC, 5, ADC_ADCMPR_CMPCOND_GREATER_OR_EQUAL, 0x800, 10, EADC_CMP_ADCMPIE_ENABLE); + * Means EADC will assert comparator 1 flag if sample module 5 conversion result is greater or + * equal to 0x800 for 10 times continuously, and a compare interrupt request is generated. + * \hideinitializer + */ +#define EADC_ENABLE_CMP1(eadc,\ + u32ModuleNum,\ + u32Condition,\ + u16CMPData,\ + u32MatchCount) ((eadc)->CMP[1] |=(((u32ModuleNum) << EADC_CMP_CMPSPL_Pos)|\ + (u32Condition) |\ + ((u16CMPData) << EADC_CMP_CMPDAT_Pos)| \ + (((u32MatchCount) - 1) << EADC_CMP_CMPMCNT_Pos)|\ + EADC_CMP_ADCMPEN_Msk)) + +/** + * @brief Configure the comparator 2 and enable it. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32ModuleNum specifies the compare sample module, valid value are from 0 to 18. + * @param[in] u32Condition specifies the compare condition. Valid values are: + * - \ref EADC_CMP_CMPCOND_LESS_THAN :The compare condition is "less than the compare value" + * - \ref EADC_CMP_CMPCOND_GREATER_OR_EQUAL :The compare condition is "greater than or equal to the compare value + * @param[in] u16CMPData specifies the compare value, valid range are between 0~0xFFF. + * @param[in] u32MatchCount specifies the match count setting, valid range are between 0~0xF. + * @return None + * @details For example, ADC_ENABLE_CMP2(EADC, 5, ADC_ADCMPR_CMPCOND_GREATER_OR_EQUAL, 0x800, 10, EADC_CMP_CMPWEN_DISABLE, EADC_CMP_ADCMPIE_ENABLE); + * Means EADC will assert comparator 2 flag if sample module 5 conversion result is greater or + * equal to 0x800 for 10 times continuously, and a compare interrupt request is generated. + * \hideinitializer + */ +#define EADC_ENABLE_CMP2(eadc,\ + u32ModuleNum,\ + u32Condition,\ + u16CMPData,\ + u32MatchCount) ((eadc)->CMP[2] |=(((u32ModuleNum) << EADC_CMP_CMPSPL_Pos)|\ + (u32Condition) |\ + ((u16CMPData) << EADC_CMP_CMPDAT_Pos)| \ + (((u32MatchCount) - 1) << EADC_CMP_CMPMCNT_Pos)|\ + EADC_CMP_ADCMPEN_Msk)) + +/** + * @brief Configure the comparator 3 and enable it. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32ModuleNum specifies the compare sample module, valid value are from 0 to 18. + * @param[in] u32Condition specifies the compare condition. Valid values are: + * - \ref EADC_CMP_CMPCOND_LESS_THAN :The compare condition is "less than the compare value" + * - \ref EADC_CMP_CMPCOND_GREATER_OR_EQUAL :The compare condition is "greater than or equal to the compare value + * @param[in] u16CMPData specifies the compare value, valid range are between 0~0xFFF. + * @param[in] u32MatchCount specifies the match count setting, valid range are between 1~0xF. + * @return None + * @details For example, ADC_ENABLE_CMP3(EADC, 5, ADC_ADCMPR_CMPCOND_GREATER_OR_EQUAL, 0x800, 10, EADC_CMP_ADCMPIE_ENABLE); + * Means EADC will assert comparator 3 flag if sample module 5 conversion result is greater or + * equal to 0x800 for 10 times continuously, and a compare interrupt request is generated. + * \hideinitializer + */ +#define EADC_ENABLE_CMP3(eadc,\ + u32ModuleNum,\ + u32Condition,\ + u16CMPData,\ + u32MatchCount) ((eadc)->CMP[3] |=(((u32ModuleNum) << EADC_CMP_CMPSPL_Pos)|\ + (u32Condition) |\ + ((u16CMPData) << EADC_CMP_CMPDAT_Pos)| \ + (((u32MatchCount) - 1) << EADC_CMP_CMPMCNT_Pos)|\ + EADC_CMP_ADCMPEN_Msk)) + +/** + * @brief Enable the compare window mode. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32CMP Specifies the compare register, valid value are 0 and 2. + * @return None + * @details ADCMPF0 (EADC_STATUS2[4]) will be set when both EADC_CMP0 and EADC_CMP1 compared condition matched. + * \hideinitializer + */ +#define EADC_ENABLE_CMP_WINDOW_MODE(eadc, u32CMP) ((eadc)->CMP[(u32CMP)] |= EADC_CMP_CMPWEN_Msk) + +/** + * @brief Disable the compare window mode. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32CMP Specifies the compare register, valid value are 0 and 2. + * @return None + * @details ADCMPF2 (EADC_STATUS2[6]) will be set when both EADC_CMP2 and EADC_CMP3 compared condition matched. + * \hideinitializer + */ +#define EADC_DISABLE_CMP_WINDOW_MODE(eadc, u32CMP) ((eadc)->CMP[(u32CMP)] &= ~EADC_CMP_CMPWEN_Msk) + +/** + * @brief Enable the compare interrupt. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32CMP Specifies the compare register, valid value are from 0 to 3. + * @return None + * @details If the compare function is enabled and the compare condition matches the setting of CMPCOND (EADC_CMPn[2], n=0~3) + * and CMPMCNT (EADC_CMPn[11:8], n=0~3), ADCMPFn (EADC_STATUS2[7:4], n=0~3) will be asserted, in the meanwhile, + * if ADCMPIE is set to 1, a compare interrupt request is generated. + * \hideinitializer + */ +#define EADC_ENABLE_CMP_INT(eadc, u32CMP) ((eadc)->CMP[(u32CMP)] |= EADC_CMP_ADCMPIE_Msk) + +/** + * @brief Disable the compare interrupt. + * @param[in] eadc The pointer of the specified EADC module. + * @param[in] u32CMP Specifies the compare register, valid value are from 0 to 3. + * @return None + * @details This macro is used to disable the compare interrupt. + * \hideinitializer + */ +#define EADC_DISABLE_CMP_INT(eadc, u32CMP) ((eadc)->CMP[(u32CMP)] &= ~EADC_CMP_ADCMPIE_Msk) + +/** + * @brief Disable comparator 0. + * @param[in] eadc The pointer of the specified EADC module. + * @return None + * @details This macro is used to disable comparator 0. + * \hideinitializer + */ +#define EADC_DISABLE_CMP0(eadc) ((eadc)->CMP[0] = 0) + +/** + * @brief Disable comparator 1. + * @param[in] eadc The pointer of the specified EADC module. + * @return None + * @details This macro is used to disable comparator 1. + * \hideinitializer + */ +#define EADC_DISABLE_CMP1(eadc) ((eadc)->CMP[1] = 0) + +/** + * @brief Disable comparator 2. + * @param[in] eadc The pointer of the specified EADC module. + * @return None + * @details This macro is used to disable comparator 2. + * \hideinitializer + */ +#define EADC_DISABLE_CMP2(eadc) ((eadc)->CMP[2] = 0) + +/** + * @brief Disable comparator 3. + * @param[in] eadc The pointer of the specified EADC module. + * @return None + * @details This macro is used to disable comparator 3. + * \hideinitializer + */ +#define EADC_DISABLE_CMP3(eadc) ((eadc)->CMP[3] = 0) + +/*---------------------------------------------------------------------------------------------------------*/ +/* Define EADC functions prototype */ +/*---------------------------------------------------------------------------------------------------------*/ +void EADC_Open(EADC_T *eadc, uint32_t u32InputMode); +void EADC_Close(EADC_T *eadc); +void EADC_ConfigSampleModule(EADC_T *eadc, uint32_t u32ModuleNum, uint32_t u32TriggerSrc, uint32_t u32Channel); +void EADC_SetTriggerDelayTime(EADC_T *eadc, uint32_t u32ModuleNum, uint32_t u32TriggerDelayTime, uint32_t u32DelayClockDivider); +void EADC_SetExtendSampleTime(EADC_T *eadc, uint32_t u32ModuleNum, uint32_t u32ExtendSampleTime); + +/*@}*/ /* end of group EADC_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group EADC_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_EADC_H__ */ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_ebi.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_ebi.h new file mode 100644 index 00000000000..cd9c4998122 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_ebi.h @@ -0,0 +1,352 @@ +/**************************************************************************//** + * @file nu_ebi.h + * @version V3.00 + * @brief M480 series External Bus Interface(EBI) driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __NU_EBI_H__ +#define __NU_EBI_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup EBI_Driver EBI Driver + @{ +*/ + +/** @addtogroup EBI_EXPORTED_CONSTANTS EBI Exported Constants + @{ +*/ +/*---------------------------------------------------------------------------------------------------------*/ +/* Miscellaneous Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define EBI_BANK0_BASE_ADDR 0x60000000UL /*!< EBI bank0 base address \hideinitializer */ +#define EBI_BANK1_BASE_ADDR 0x60100000UL /*!< EBI bank1 base address \hideinitializer */ +#define EBI_BANK2_BASE_ADDR 0x60200000UL /*!< EBI bank2 base address \hideinitializer */ +#define EBI_MAX_SIZE 0x00100000UL /*!< Maximum EBI size for each bank is 1 MB \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Constants for EBI bank number */ +/*---------------------------------------------------------------------------------------------------------*/ +#define EBI_BANK0 0UL /*!< EBI bank 0 \hideinitializer */ +#define EBI_BANK1 1UL /*!< EBI bank 1 \hideinitializer */ +#define EBI_BANK2 2UL /*!< EBI bank 2 \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Constants for EBI data bus width */ +/*---------------------------------------------------------------------------------------------------------*/ +#define EBI_BUSWIDTH_8BIT 8UL /*!< EBI bus width is 8-bit \hideinitializer */ +#define EBI_BUSWIDTH_16BIT 16UL /*!< EBI bus width is 16-bit \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Constants for EBI CS Active Level */ +/*---------------------------------------------------------------------------------------------------------*/ +#define EBI_CS_ACTIVE_LOW 0UL /*!< EBI CS active level is low \hideinitializer */ +#define EBI_CS_ACTIVE_HIGH 1UL /*!< EBI CS active level is high \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Constants for EBI MCLK divider and Timing */ +/*---------------------------------------------------------------------------------------------------------*/ +#define EBI_MCLKDIV_1 0x0UL /*!< EBI output clock(MCLK) is HCLK/1 \hideinitializer */ +#define EBI_MCLKDIV_2 0x1UL /*!< EBI output clock(MCLK) is HCLK/2 \hideinitializer */ +#define EBI_MCLKDIV_4 0x2UL /*!< EBI output clock(MCLK) is HCLK/4 \hideinitializer */ +#define EBI_MCLKDIV_8 0x3UL /*!< EBI output clock(MCLK) is HCLK/8 \hideinitializer */ +#define EBI_MCLKDIV_16 0x4UL /*!< EBI output clock(MCLK) is HCLK/16 \hideinitializer */ +#define EBI_MCLKDIV_32 0x5UL /*!< EBI output clock(MCLK) is HCLK/32 \hideinitializer */ +#define EBI_MCLKDIV_64 0x6UL /*!< EBI output clock(MCLK) is HCLK/64 \hideinitializer */ +#define EBI_MCLKDIV_128 0x7UL /*!< EBI output clock(MCLK) is HCLK/128 \hideinitializer */ + +#define EBI_TIMING_FASTEST 0x0UL /*!< EBI timing is the fastest \hideinitializer */ +#define EBI_TIMING_VERYFAST 0x1UL /*!< EBI timing is very fast \hideinitializer */ +#define EBI_TIMING_FAST 0x2UL /*!< EBI timing is fast \hideinitializer */ +#define EBI_TIMING_NORMAL 0x3UL /*!< EBI timing is normal \hideinitializer */ +#define EBI_TIMING_SLOW 0x4UL /*!< EBI timing is slow \hideinitializer */ +#define EBI_TIMING_VERYSLOW 0x5UL /*!< EBI timing is very slow \hideinitializer */ +#define EBI_TIMING_SLOWEST 0x6UL /*!< EBI timing is the slowest \hideinitializer */ + +#define EBI_OPMODE_NORMAL 0x0UL /*!< EBI bus operate in normal mode \hideinitializer */ +#define EBI_OPMODE_CACCESS (EBI_CTL_CACCESS_Msk) /*!< EBI bus operate in Continuous Data Access mode \hideinitializer */ +#define EBI_OPMODE_ADSEPARATE (EBI_CTL_ADSEPEN_Msk) /*!< EBI bus operate in AD Separate mode \hideinitializer */ + +/*@}*/ /* end of group EBI_EXPORTED_CONSTANTS */ + + +/** @addtogroup EBI_EXPORTED_FUNCTIONS EBI Exported Functions + @{ +*/ + +/** + * @brief Read 8-bit data on EBI bank0 + * + * @param[in] u32Addr The data address on EBI bank0. + * + * @return 8-bit Data + * + * @details This macro is used to read 8-bit data from specify address on EBI bank0. + * \hideinitializer + */ +#define EBI0_READ_DATA8(u32Addr) (*((volatile unsigned char *)(EBI_BANK0_BASE_ADDR+(u32Addr)))) + +/** + * @brief Write 8-bit data to EBI bank0 + * + * @param[in] u32Addr The data address on EBI bank0. + * @param[in] u32Data Specify data to be written. + * + * @return None + * + * @details This macro is used to write 8-bit data to specify address on EBI bank0. + * \hideinitializer + */ +#define EBI0_WRITE_DATA8(u32Addr, u32Data) (*((volatile unsigned char *)(EBI_BANK0_BASE_ADDR+(u32Addr))) = (u32Data)) + +/** + * @brief Read 16-bit data on EBI bank0 + * + * @param[in] u32Addr The data address on EBI bank0. + * + * @return 16-bit Data + * + * @details This macro is used to read 16-bit data from specify address on EBI bank0. + * \hideinitializer + */ +#define EBI0_READ_DATA16(u32Addr) (*((volatile unsigned short *)(EBI_BANK0_BASE_ADDR+(u32Addr)))) + +/** + * @brief Write 16-bit data to EBI bank0 + * + * @param[in] u32Addr The data address on EBI bank0. + * @param[in] u32Data Specify data to be written. + * + * @return None + * + * @details This macro is used to write 16-bit data to specify address on EBI bank0. + * \hideinitializer + */ +#define EBI0_WRITE_DATA16(u32Addr, u32Data) (*((volatile unsigned short *)(EBI_BANK0_BASE_ADDR+(u32Addr))) = (u32Data)) + +/** + * @brief Read 32-bit data on EBI bank0 + * + * @param[in] u32Addr The data address on EBI bank0. + * + * @return 32-bit Data + * + * @details This macro is used to read 32-bit data from specify address on EBI bank0. + * \hideinitializer + */ +#define EBI0_READ_DATA32(u32Addr) (*((volatile unsigned int *)(EBI_BANK0_BASE_ADDR+(u32Addr)))) + +/** + * @brief Write 32-bit data to EBI bank0 + * + * @param[in] u32Addr The data address on EBI bank0. + * @param[in] u32Data Specify data to be written. + * + * @return None + * + * @details This macro is used to write 32-bit data to specify address on EBI bank0. + * \hideinitializer + */ +#define EBI0_WRITE_DATA32(u32Addr, u32Data) (*((volatile unsigned int *)(EBI_BANK0_BASE_ADDR+(u32Addr))) = (u32Data)) + +/** + * @brief Read 8-bit data on EBI bank1 + * + * @param[in] u32Addr The data address on EBI bank1. + * + * @return 8-bit Data + * + * @details This macro is used to read 8-bit data from specify address on EBI bank1. + * \hideinitializer + */ +#define EBI1_READ_DATA8(u32Addr) (*((volatile unsigned char *)(EBI_BANK1_BASE_ADDR+(u32Addr)))) + +/** + * @brief Write 8-bit data to EBI bank1 + * + * @param[in] u32Addr The data address on EBI bank1. + * @param[in] u32Data Specify data to be written. + * + * @return None + * + * @details This macro is used to write 8-bit data to specify address on EBI bank1. + * \hideinitializer + */ +#define EBI1_WRITE_DATA8(u32Addr, u32Data) (*((volatile unsigned char *)(EBI_BANK1_BASE_ADDR+(u32Addr))) = (u32Data)) + +/** + * @brief Read 16-bit data on EBI bank1 + * + * @param[in] u32Addr The data address on EBI bank1. + * + * @return 16-bit Data + * + * @details This macro is used to read 16-bit data from specify address on EBI bank1. + * \hideinitializer + */ +#define EBI1_READ_DATA16(u32Addr) (*((volatile unsigned short *)(EBI_BANK1_BASE_ADDR+(u32Addr)))) + +/** + * @brief Write 16-bit data to EBI bank1 + * + * @param[in] u32Addr The data address on EBI bank1. + * @param[in] u32Data Specify data to be written. + * + * @return None + * + * @details This macro is used to write 16-bit data to specify address on EBI bank1. + * \hideinitializer + */ +#define EBI1_WRITE_DATA16(u32Addr, u32Data) (*((volatile unsigned short *)(EBI_BANK1_BASE_ADDR+(u32Addr))) = (u32Data)) + +/** + * @brief Read 32-bit data on EBI bank1 + * + * @param[in] u32Addr The data address on EBI bank1. + * + * @return 32-bit Data + * + * @details This macro is used to read 32-bit data from specify address on EBI bank1. + * \hideinitializer + */ +#define EBI1_READ_DATA32(u32Addr) (*((volatile unsigned int *)(EBI_BANK1_BASE_ADDR+(u32Addr)))) + +/** + * @brief Write 32-bit data to EBI bank1 + * + * @param[in] u32Addr The data address on EBI bank1. + * @param[in] u32Data Specify data to be written. + * + * @return None + * + * @details This macro is used to write 32-bit data to specify address on EBI bank1. + * \hideinitializer + */ +#define EBI1_WRITE_DATA32(u32Addr, u32Data) (*((volatile unsigned int *)(EBI_BANK1_BASE_ADDR+(u32Addr))) = (u32Data)) + +/** + * @brief Read 8-bit data on EBI bank2 + * + * @param[in] u32Addr The data address on EBI bank2. + * + * @return 8-bit Data + * + * @details This macro is used to read 8-bit data from specify address on EBI bank2. + * \hideinitializer + */ +#define EBI2_READ_DATA8(u32Addr) (*((volatile unsigned char *)(EBI_BANK2_BASE_ADDR+(u32Addr)))) + +/** + * @brief Write 8-bit data to EBI bank2 + * + * @param[in] u32Addr The data address on EBI bank2. + * @param[in] u32Data Specify data to be written. + * + * @return None + * + * @details This macro is used to write 8-bit data to specify address on EBI bank2. + * \hideinitializer + */ +#define EBI2_WRITE_DATA8(u32Addr, u32Data) (*((volatile unsigned char *)(EBI_BANK2_BASE_ADDR+(u32Addr))) = (u32Data)) + +/** + * @brief Read 16-bit data on EBI bank2 + * + * @param[in] u32Addr The data address on EBI bank2. + * + * @return 16-bit Data + * + * @details This macro is used to read 16-bit data from specify address on EBI bank2. + * \hideinitializer + */ +#define EBI2_READ_DATA16(u32Addr) (*((volatile unsigned short *)(EBI_BANK2_BASE_ADDR+(u32Addr)))) + +/** + * @brief Write 16-bit data to EBI bank2 + * + * @param[in] u32Addr The data address on EBI bank2. + * @param[in] u32Data Specify data to be written. + * + * @return None + * + * @details This macro is used to write 16-bit data to specify address on EBI bank2. + * \hideinitializer + */ +#define EBI2_WRITE_DATA16(u32Addr, u32Data) (*((volatile unsigned short *)(EBI_BANK2_BASE_ADDR+(u32Addr))) = (u32Data)) + +/** + * @brief Read 32-bit data on EBI bank2 + * + * @param[in] u32Addr The data address on EBI bank2. + * + * @return 32-bit Data + * + * @details This macro is used to read 32-bit data from specify address on EBI bank2. + * \hideinitializer + */ +#define EBI2_READ_DATA32(u32Addr) (*((volatile unsigned int *)(EBI_BANK2_BASE_ADDR+(u32Addr)))) + +/** + * @brief Write 32-bit data to EBI bank2 + * + * @param[in] u32Addr The data address on EBI bank2. + * @param[in] u32Data Specify data to be written. + * + * @return None + * + * @details This macro is used to write 32-bit data to specify address on EBI bank2. + * \hideinitializer + */ +#define EBI2_WRITE_DATA32(u32Addr, u32Data) (*((volatile unsigned int *)(EBI_BANK2_BASE_ADDR+(u32Addr))) = (u32Data)) + +/** + * @brief Enable EBI Write Buffer + * + * @param None + * + * @return None + * + * @details This macro is used to improve EBI write operation for all EBI banks. + * \hideinitializer + */ +#define EBI_ENABLE_WRITE_BUFFER() (EBI->CTL0 |= EBI_CTL_WBUFEN_Msk); + +/** + * @brief Disable EBI Write Buffer + * + * @param None + * + * @return None + * + * @details This macro is used to disable EBI write buffer function. + * \hideinitializer + */ +#define EBI_DISABLE_WRITE_BUFFER() (EBI->CTL0 &= ~EBI_CTL_WBUFEN_Msk); + +void EBI_Open(uint32_t u32Bank, uint32_t u32DataWidth, uint32_t u32TimingClass, uint32_t u32BusMode, uint32_t u32CSActiveLevel); +void EBI_Close(uint32_t u32Bank); +void EBI_SetBusTiming(uint32_t u32Bank, uint32_t u32TimingConfig, uint32_t u32MclkDiv); + +/*@}*/ /* end of group EBI_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group EBI_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_ecap.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_ecap.h new file mode 100644 index 00000000000..ebcf061ac06 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_ecap.h @@ -0,0 +1,458 @@ +/**************************************************************************//** + * @file nu_ecap.h + * @version V3.00 + * @brief EnHanced Input Capture Timer(ECAP) driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. +*****************************************************************************/ +#ifndef __NU_ECAP_H__ +#define __NU_ECAP_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup ECAP_Driver ECAP Driver + @{ +*/ + +/** @addtogroup ECAP_EXPORTED_CONSTANTS ECAP Exported Constants + @{ +*/ + +#define ECAP_IC0 (0UL) /*!< ECAP IC0 Unit \hideinitializer */ +#define ECAP_IC1 (1UL) /*!< ECAP IC1 Unit \hideinitializer */ +#define ECAP_IC2 (2UL) /*!< ECAP IC2 Unit \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* ECAP CTL0 constant definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define ECAP_NOISE_FILTER_CLKDIV_1 (0UL<CTL0 = ((ecap)->CTL0 & ~ECAP_CTL0_NFCLKSEL_Msk)|(u32ClkSel)) + +/** + * @brief This macro is used to disable noise filter + * @param[in] ecap Specify ECAP port + * @return None + * @details This macro will disable the noise filter of input capture. + * \hideinitializer + */ +#define ECAP_NOISE_FILTER_DISABLE(ecap) ((ecap)->CTL0 |= ECAP_CTL0_CAPNFDIS_Msk) + +/** + * @brief This macro is used to enable noise filter + * @param[in] ecap Specify ECAP port + * @param[in] u32ClkSel Select noise filter clock divide number + * - \ref ECAP_NOISE_FILTER_CLKDIV_1 + * - \ref ECAP_NOISE_FILTER_CLKDIV_2 + * - \ref ECAP_NOISE_FILTER_CLKDIV_4 + * - \ref ECAP_NOISE_FILTER_CLKDIV_16 + * - \ref ECAP_NOISE_FILTER_CLKDIV_32 + * - \ref ECAP_NOISE_FILTER_CLKDIV_64 + * @return None + * @details This macro will enable the noise filter of input capture and set noise filter clock divide. + * \hideinitializer + */ +#define ECAP_NOISE_FILTER_ENABLE(ecap, u32ClkSel) ((ecap)->CTL0 = ((ecap)->CTL0 & ~(ECAP_CTL0_CAPNFDIS_Msk|ECAP_CTL0_NFCLKSEL_Msk))|(u32ClkSel)) + +/** + * @brief This macro is used to enable input channel unit + * @param[in] ecap Specify ECAP port + * @param[in] u32Mask The input channel mask + * - \ref ECAP_CTL0_IC0EN_Msk + * - \ref ECAP_CTL0_IC1EN_Msk + * - \ref ECAP_CTL0_IC2EN_Msk + * @return None + * @details This macro will enable the input channel_n to input capture. + * \hideinitializer + */ +#define ECAP_ENABLE_INPUT_CHANNEL(ecap, u32Mask) ((ecap)->CTL0 |= (u32Mask)) + +/** + * @brief This macro is used to disable input channel unit + * @param[in] ecap Specify ECAP port + * @param[in] u32Mask The input channel mask + * - \ref ECAP_CTL0_IC0EN_Msk + * - \ref ECAP_CTL0_IC1EN_Msk + * - \ref ECAP_CTL0_IC2EN_Msk + * @return None + * @details This macro will disable the input channel_n to input capture. + * \hideinitializer + */ +#define ECAP_DISABLE_INPUT_CHANNEL(ecap, u32Mask) ((ecap)->CTL0 &= ~(u32Mask)) + +/** + * @brief This macro is used to select input channel source + * @param[in] ecap Specify ECAP port + * @param[in] u32Index The input channel number + * - \ref ECAP_IC0 + * - \ref ECAP_IC1 + * - \ref ECAP_IC2 + * @param[in] u32Src The input source + * - \ref ECAP_CAP_INPUT_SRC_FROM_IC + * - \ref ECAP_CAP_INPUT_SRC_FROM_CH + * @return None + * @details This macro will select the input source from ICx, CHx. + * \hideinitializer + */ +#define ECAP_SEL_INPUT_SRC(ecap, u32Index, u32Src) ((ecap)->CTL0 = ((ecap)->CTL0 & ~(ECAP_CTL0_CAPSEL0_Msk<<((u32Index)<<1)))|(((u32Src)<CTL0 |= (u32Mask)) + +/** + * @brief This macro is used to disable input channel interrupt + * @param[in] ecap Specify ECAP port + * @param[in] u32Mask The input channel mask + * - \ref ECAP_IC0 + * - \ref ECAP_IC1 + * - \ref ECAP_IC2 + * @return None + * @details This macro will disable the input channel_n interrupt. + * \hideinitializer + */ +#define ECAP_DISABLE_INT(ecap, u32Mask) ((ecap)->CTL0 &= ~(u32Mask)) + +/** + * @brief This macro is used to enable input channel overflow interrupt + * @param[in] ecap Specify ECAP port + * @return None + * @details This macro will enable the input channel overflow interrupt. + * \hideinitializer + */ +#define ECAP_ENABLE_OVF_INT(ecap) ((ecap)->CTL0 |= ECAP_CTL0_OVIEN_Msk) + +/** + * @brief This macro is used to disable input channel overflow interrupt + * @param[in] ecap Specify ECAP port + * @return None + * @details This macro will disable the input channel overflow interrupt. + * \hideinitializer + */ +#define ECAP_DISABLE_OVF_INT(ecap) ((ecap)->CTL0 &= ~ECAP_CTL0_OVIEN_Msk) + +/** + * @brief This macro is used to enable input channel compare-match interrupt + * @param[in] ecap Specify ECAP port + * @return None + * @details This macro will enable the input channel compare-match interrupt. + * \hideinitializer + */ +#define ECAP_ENABLE_CMP_MATCH_INT(ecap) ((ecap)->CTL0 |= ECAP_CTL0_CMPIEN_Msk) + +/** + * @brief This macro is used to disable input channel compare-match interrupt + * @param[in] ecap Specify ECAP port + * @return None + * @details This macro will disable the input channel compare-match interrupt. + * \hideinitializer + */ +#define ECAP_DISABLE_CMP_MATCH_INT(ecap) ((ecap)->CTL0 &= ~ECAP_CTL0_CMPIEN_Msk) + +/** + * @brief This macro is used to start capture counter + * @param[in] ecap Specify ECAP port + * @return None + * @details This macro will start capture counter up-counting. + * \hideinitializer + */ +#define ECAP_CNT_START(ecap) ((ecap)->CTL0 |= ECAP_CTL0_CNTEN_Msk) + +/** + * @brief This macro is used to stop capture counter + * @param[in] ecap Specify ECAP port + * @return None + * @details This macro will stop capture counter up-counting. + * \hideinitializer + */ +#define ECAP_CNT_STOP(ecap) ((ecap)->CTL0 &= ~ECAP_CTL0_CNTEN_Msk) + +/** + * @brief This macro is used to set event to clear capture counter + * @param[in] ecap Specify ECAP port + * @param[in] u32Event The input channel number + * - \ref ECAP_CTL0_CMPCLREN_Msk + * - \ref ECAP_CTL1_CAP0RLDEN_Msk + * - \ref ECAP_CTL1_CAP1RLDEN_Msk + * - \ref ECAP_CTL1_CAP2RLDEN_Msk + * - \ref ECAP_CTL1_OVRLDEN_Msk + + * @return None + * @details This macro will enable and select compare or capture event that can clear capture counter. + * \hideinitializer + */ +#define ECAP_SET_CNT_CLEAR_EVENT(ecap, u32Event) do{ \ + if((u32Event) & ECAP_CTL0_CMPCLREN_Msk) \ + (ecap)->CTL0 |= ECAP_CTL0_CMPCLREN_Msk; \ + else \ + (ecap)->CTL0 &= ~ECAP_CTL0_CMPCLREN_Msk; \ + (ecap)->CTL1 = ((ecap)->CTL1 &~0xF00) | ((u32Event) & 0xF00); \ + }while(0); + +/** + * @brief This macro is used to enable compare function + * @param[in] ecap Specify ECAP port + * @return None + * @details This macro will enable the compare function. + * \hideinitializer + */ +#define ECAP_ENABLE_CMP(ecap) ((ecap)->CTL0 |= ECAP_CTL0_CMPEN_Msk) + +/** + * @brief This macro is used to disable compare function + * @param[in] ecap Specify ECAP port + * @return None + * @details This macro will disable the compare function. + * \hideinitializer + */ +#define ECAP_DISABLE_CMP(ecap) ((ecap)->CTL0 &= ~ECAP_CTL0_CMPEN_Msk) + +/** + * @brief This macro is used to enable input capture function. + * @param[in] ecap Specify ECAP port + * @return None + * @details This macro will enable input capture timer/counter. + * \hideinitializer + */ +#define ECAP_ENABLE_CNT(ecap) ((ecap)->CTL0 |= ECAP_CTL0_CAPEN_Msk) + +/** + * @brief This macro is used to disable input capture function. + * @param[in] ecap Specify ECAP port + * @return None + * @details This macro will disable input capture timer/counter. + * \hideinitializer + */ +#define ECAP_DISABLE_CNT(ecap) ((ecap)->CTL0 &= ~ECAP_CTL0_CAPEN_Msk) + +/** + * @brief This macro is used to select input channel edge detection + * @param[in] ecap Specify ECAP port + * @param[in] u32Index The input channel number + * - \ref ECAP_IC0 + * - \ref ECAP_IC1 + * - \ref ECAP_IC2 + * @param[in] u32Edge The input source + * - \ref ECAP_RISING_EDGE + * - \ref ECAP_FALLING_EDGE + * - \ref ECAP_RISING_FALLING_EDGE + * @return None + * @details This macro will select input capture can detect falling edge, rising edge or either rising or falling edge change. + * \hideinitializer + */ +#define ECAP_SEL_CAPTURE_EDGE(ecap, u32Index, u32Edge) ((ecap)->CTL1 = ((ecap)->CTL1 & ~(ECAP_CTL1_EDGESEL0_Msk<<((u32Index)<<1)))|((u32Edge)<<((u32Index)<<1))) + +/** + * @brief This macro is used to select ECAP counter reload trigger source + * @param[in] ecap Specify ECAP port + * @param[in] u32TrigSrc The input source + * - \ref ECAP_CTL1_CAP0RLDEN_Msk + * - \ref ECAP_CTL1_CAP1RLDEN_Msk + * - \ref ECAP_CTL1_CAP2RLDEN_Msk + * - \ref ECAP_CTL1_OVRLDEN_Msk + * @return None + * @details This macro will select capture counter reload trigger source. + * \hideinitializer + */ +#define ECAP_SEL_RELOAD_TRIG_SRC(ecap, u32TrigSrc) ((ecap)->CTL1 = ((ecap)->CTL1 & ~0xF00)|(u32TrigSrc)) + +/** + * @brief This macro is used to select capture timer clock divide. + * @param[in] ecap Specify ECAP port + * @param[in] u32Clkdiv The input source + * - \ref ECAP_CAPTURE_TIMER_CLKDIV_1 + * - \ref ECAP_CAPTURE_TIMER_CLKDIV_4 + * - \ref ECAP_CAPTURE_TIMER_CLKDIV_16 + * - \ref ECAP_CAPTURE_TIMER_CLKDIV_32 + * - \ref ECAP_CAPTURE_TIMER_CLKDIV_64 + * - \ref ECAP_CAPTURE_TIMER_CLKDIV_96 + * - \ref ECAP_CAPTURE_TIMER_CLKDIV_112 + * - \ref ECAP_CAPTURE_TIMER_CLKDIV_128 + * @return None + * @details This macro will select capture timer clock has a pre-divider with eight divided option. + * \hideinitializer + */ +#define ECAP_SEL_TIMER_CLK_DIV(ecap, u32Clkdiv) ((ecap)->CTL1 = ((ecap)->CTL1 & ~ECAP_CTL1_CLKSEL_Msk)|(u32Clkdiv)) + +/** + * @brief This macro is used to select capture timer/counter clock source + * @param[in] ecap Specify ECAP port + * @param[in] u32ClkSrc The input source + * - \ref ECAP_CAPTURE_TIMER_CLK_SRC_CAP_CLK + * - \ref ECAP_CAPTURE_TIMER_CLK_SRC_CAP0 + * - \ref ECAP_CAPTURE_TIMER_CLK_SRC_CAP1 + * - \ref ECAP_CAPTURE_TIMER_CLK_SRC_CAP2 + * @return None + * @details This macro will select capture timer/clock clock source. + * \hideinitializer + */ +#define ECAP_SEL_TIMER_CLK_SRC(ecap, u32ClkSrc) ((ecap)->CTL1 = ((ecap)->CTL1 & ~ECAP_CTL1_CNTSRCSEL_Msk)|(u32ClkSrc)) + +/** + * @brief This macro is used to read input capture status + * @param[in] ecap Specify ECAP port + * @return Input capture status flags + * @details This macro will get the input capture interrupt status. + * \hideinitializer + */ +#define ECAP_GET_INT_STATUS(ecap) ((ecap)->STATUS) + +/** + * @brief This macro is used to get input channel interrupt flag + * @param[in] ecap Specify ECAP port + * @param[in] u32Mask The input channel mask + * - \ref ECAP_STATUS_CAPTF0_Msk + * - \ref ECAP_STATUS_CAPTF1_Msk + * - \ref ECAP_STATUS_CAPTF2_Msk + * - \ref ECAP_STATUS_CAPOVF_Msk + * - \ref ECAP_STATUS_CAPCMPF_Msk + * @return None + * @details This macro will write 1 to get the input channel_n interrupt flag. + * \hideinitializer + */ +#define ECAP_GET_CAPTURE_FLAG(ecap, u32Mask) (((ecap)->STATUS & (u32Mask))?1:0) + +/** + * @brief This macro is used to clear input channel interrupt flag + * @param[in] ecap Specify ECAP port + * @param[in] u32Mask The input channel mask + * - \ref ECAP_STATUS_CAPTF0_Msk + * - \ref ECAP_STATUS_CAPTF1_Msk + * - \ref ECAP_STATUS_CAPTF2_Msk + * - \ref ECAP_STATUS_CAPOVF_Msk + * - \ref ECAP_STATUS_CAPCMPF_Msk + * @return None + * @details This macro will write 1 to clear the input channel_n interrupt flag. + * \hideinitializer + */ +#define ECAP_CLR_CAPTURE_FLAG(ecap, u32Mask) ((ecap)->STATUS = (u32Mask)) + +/** + * @brief This macro is used to set input capture counter value + * @param[in] ecap Specify ECAP port + * @param[in] u32Val Counter value + * @return None + * @details This macro will set a counter value of input capture. + * \hideinitializer + */ +#define ECAP_SET_CNT_VALUE(ecap, u32Val) ((ecap)->CNT = (u32Val)) + +/** + * @brief This macro is used to get input capture counter value + * @param[in] ecap Specify ECAP port + * @return Capture counter value + * @details This macro will get a counter value of input capture. + * \hideinitializer + */ +#define ECAP_GET_CNT_VALUE(ecap) ((ecap)->CNT) + +/** + * @brief This macro is used to get input capture counter hold value + * @param[in] ecap Specify ECAP port + * @param[in] u32Index The input channel number + * - \ref ECAP_IC0 + * - \ref ECAP_IC1 + * - \ref ECAP_IC2 + * @return Capture counter hold value + * @details This macro will get a hold value of input capture channel_n. + * \hideinitializer + */ +#define ECAP_GET_CNT_HOLD_VALUE(ecap, u32Index) (*(__IO uint32_t *) (&((ecap)->HLD0) + (u32Index))) + +/** + * @brief This macro is used to set input capture counter compare value + * @param[in] ecap Specify ECAP port + * @param[in] u32Val Input capture compare value + * @return None + * @details This macro will set a compare value of input capture counter. + * \hideinitializer + */ +#define ECAP_SET_CNT_CMP(ecap, u32Val) ((ecap)->CNTCMP = (u32Val)) + +void ECAP_Open(ECAP_T* ecap, uint32_t u32FuncMask); +void ECAP_Close(ECAP_T* ecap); +void ECAP_EnableINT(ECAP_T* ecap, uint32_t u32Mask); +void ECAP_DisableINT(ECAP_T* ecap, uint32_t u32Mask); +/*@}*/ /* end of group ECAP_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group ECAP_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_ECAP_H__ */ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_emac.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_emac.h new file mode 100644 index 00000000000..152873d76ac --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_emac.h @@ -0,0 +1,357 @@ +/**************************************************************************//** + * @file nu_emac.h + * @version V1.00 + * @brief M480 EMAC driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. +*****************************************************************************/ +#ifndef __NU_EMAC_H__ +#define __NU_EMAC_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + +#include + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup EMAC_Driver EMAC Driver + @{ +*/ + +/** @addtogroup EMAC_EXPORTED_CONSTANTS EMAC Exported Constants + @{ +*/ + +#define EMAC_PHY_ADDR 1UL /*!< PHY address, this address is board dependent \hideinitializer */ +#define EMAC_RX_DESC_SIZE 4UL /*!< Number of Rx Descriptors, should be 2 at least \hideinitializer */ +#define EMAC_TX_DESC_SIZE 4UL /*!< Number of Tx Descriptors, should be 2 at least \hideinitializer */ +#define EMAC_CAMENTRY_NB 16UL /*!< Number of CAM \hideinitializer */ +#define EMAC_MAX_PKT_SIZE 1524UL /*!< Number of HDR + EXTRA + VLAN_TAG + PAYLOAD + CRC \hideinitializer */ + +#define EMAC_LINK_DOWN 0UL /*!< Ethernet link is down \hideinitializer */ +#define EMAC_LINK_100F 1UL /*!< Ethernet link is 100Mbps full duplex \hideinitializer */ +#define EMAC_LINK_100H 2UL /*!< Ethernet link is 100Mbps half duplex \hideinitializer */ +#define EMAC_LINK_10F 3UL /*!< Ethernet link is 10Mbps full duplex \hideinitializer */ +#define EMAC_LINK_10H 4UL /*!< Ethernet link is 10Mbps half duplex \hideinitializer */ + +/*@}*/ /* end of group EMAC_EXPORTED_CONSTANTS */ + + +/** @addtogroup EMAC_EXPORTED_FUNCTIONS EMAC Exported Functions + @{ +*/ + + +/** + * @brief Enable EMAC Tx function + * @param None + * @return None + * \hideinitializer + */ +#define EMAC_ENABLE_TX() (EMAC->CTL |= EMAC_CTL_TXON_Msk) + + +/** + * @brief Enable EMAC Rx function + * @param None + * @return None + * \hideinitializer + */ +#define EMAC_ENABLE_RX() do{EMAC->CTL |= EMAC_CTL_RXON_Msk; EMAC->RXST = 0;}while(0) + +/** + * @brief Disable EMAC Tx function + * @param None + * @return None + * \hideinitializer + */ +#define EMAC_DISABLE_TX() (EMAC->CTL &= ~EMAC_CTL_TXON_Msk) + + +/** + * @brief Disable EMAC Rx function + * @param None + * @return None + * \hideinitializer + */ +#define EMAC_DISABLE_RX() (EMAC->CTL &= ~EMAC_CTL_RXON_Msk) + +/** + * @brief Enable EMAC Magic Packet Wakeup function + * @param None + * @return None + * \hideinitializer + */ +#define EMAC_ENABLE_MAGIC_PKT_WAKEUP() (EMAC->CTL |= EMAC_CTL_WOLEN_Msk) + +/** + * @brief Disable EMAC Magic Packet Wakeup function + * @param None + * @return None + * \hideinitializer + */ +#define EMAC_DISABLE_MAGIC_PKT_WAKEUP() (EMAC->CTL &= ~EMAC_CTL_WOLEN_Msk) + +/** + * @brief Enable EMAC to receive broadcast packets + * @param None + * @return None + * \hideinitializer + */ +#define EMAC_ENABLE_RECV_BCASTPKT() (EMAC->CAMCTL |= EMAC_CAMCTL_ABP_Msk) + +/** + * @brief Disable EMAC to receive broadcast packets + * @param None + * @return None + * \hideinitializer + */ +#define EMAC_DISABLE_RECV_BCASTPKT() (EMAC->CAMCTL &= ~EMAC_CAMCTL_ABP_Msk) + +/** + * @brief Enable EMAC to receive multicast packets + * @param None + * @return None + * \hideinitializer + */ +#define EMAC_ENABLE_RECV_MCASTPKT() (EMAC->CAMCTL |= EMAC_CAMCTL_AMP_Msk) + +/** + * @brief Disable EMAC Magic Packet Wakeup function + * @param None + * @return None + * \hideinitializer + */ +#define EMAC_DISABLE_RECV_MCASTPKT() (EMAC->CAMCTL &= ~EMAC_CAMCTL_AMP_Msk) + +/** + * @brief Check if EMAC time stamp alarm interrupt occurred or not + * @param None + * @return If time stamp alarm interrupt occurred or not + * @retval 0 Alarm interrupt does not occur + * @retval 1 Alarm interrupt occurred + * \hideinitializer + */ +#define EMAC_GET_ALARM_FLAG() (EMAC->INTSTS & EMAC_INTSTS_TSALMIF_Msk ? 1 : 0) + +/** + * @brief Clear EMAC time stamp alarm interrupt flag + * @param None + * @return None + * \hideinitializer + */ +#define EMAC_CLR_ALARM_FLAG() (EMAC->INTSTS = EMAC_INTSTS_TSALMIF_Msk) + +/** + * @brief Trigger EMAC Rx function + * @param None + * @return None + */ +#define EMAC_TRIGGER_RX() do{EMAC->RXST = 0UL;}while(0) + +/** + * @brief Trigger EMAC Tx function + * @param None + * @return None + */ +#define EMAC_TRIGGER_TX() do{EMAC->TXST = 0UL;}while(0) + +/** + * @brief Enable specified EMAC interrupt + * + * @param[in] emac The pointer of the specified EMAC module + * @param[in] u32eIntSel Interrupt type select + * - \ref EMAC_INTEN_RXIEN_Msk : Receive + * - \ref EMAC_INTEN_CRCEIEN_Msk : CRC Error + * - \ref EMAC_INTEN_RXOVIEN_Msk : Receive FIFO Overflow + * - \ref EMAC_INTEN_LPIEN_Msk : Long Packet + * - \ref EMAC_INTEN_RXGDIEN_Msk : Receive Good + * - \ref EMAC_INTEN_ALIEIEN_Msk : Alignment Error + * - \ref EMAC_INTEN_RPIEN_Msk : Runt Packet + * - \ref EMAC_INTEN_MPCOVIEN_Msk : Miss Packet Counter Overrun + * - \ref EMAC_INTEN_MFLEIEN_Msk : Maximum Frame Length Exceed + * - \ref EMAC_INTEN_DENIEN_Msk : DMA Early Notification + * - \ref EMAC_INTEN_RDUIEN_Msk : Receive Descriptor Unavailable + * - \ref EMAC_INTEN_RXBEIEN_Msk : Receive Bus Error + * - \ref EMAC_INTEN_CFRIEN_Msk : Control Frame Receive + * - \ref EMAC_INTEN_WOLIEN_Msk : Wake on LAN Interrupt + * - \ref EMAC_INTEN_TXIEN_Msk : Transmit + * - \ref EMAC_INTEN_TXUDIEN_Msk : Transmit FIFO Underflow + * - \ref EMAC_INTEN_TXCPIEN_Msk : Transmit Completion + * - \ref EMAC_INTEN_EXDEFIEN_Msk : Defer Exceed + * - \ref EMAC_INTEN_NCSIEN_Msk : No Carrier Sense + * - \ref EMAC_INTEN_TXABTIEN_Msk : Transmit Abort + * - \ref EMAC_INTEN_LCIEN_Msk : Late Collision + * - \ref EMAC_INTEN_TDUIEN_Msk : Transmit Descriptor Unavailable + * - \ref EMAC_INTEN_TXBEIEN_Msk : Transmit Bus Error + * - \ref EMAC_INTEN_TSALMIEN_Msk : Time Stamp Alarm + * + * @return None + * + * @details This macro enable specified EMAC interrupt. + * \hideinitializer + */ +#define EMAC_ENABLE_INT(emac, u32eIntSel) ((emac)->INTEN |= (u32eIntSel)) + +/** + * @brief Disable specified EMAC interrupt + * + * @param[in] emac The pointer of the specified EMAC module + * @param[in] u32eIntSel Interrupt type select + * - \ref EMAC_INTEN_RXIEN_Msk : Receive + * - \ref EMAC_INTEN_CRCEIEN_Msk : CRC Error + * - \ref EMAC_INTEN_RXOVIEN_Msk : Receive FIFO Overflow + * - \ref EMAC_INTEN_LPIEN_Msk : Long Packet + * - \ref EMAC_INTEN_RXGDIEN_Msk : Receive Good + * - \ref EMAC_INTEN_ALIEIEN_Msk : Alignment Error + * - \ref EMAC_INTEN_RPIEN_Msk : Runt Packet + * - \ref EMAC_INTEN_MPCOVIEN_Msk : Miss Packet Counter Overrun + * - \ref EMAC_INTEN_MFLEIEN_Msk : Maximum Frame Length Exceed + * - \ref EMAC_INTEN_DENIEN_Msk : DMA Early Notification + * - \ref EMAC_INTEN_RDUIEN_Msk : Receive Descriptor Unavailable + * - \ref EMAC_INTEN_RXBEIEN_Msk : Receive Bus Error + * - \ref EMAC_INTEN_CFRIEN_Msk : Control Frame Receive + * - \ref EMAC_INTEN_WOLIEN_Msk : Wake on LAN Interrupt + * - \ref EMAC_INTEN_TXIEN_Msk : Transmit + * - \ref EMAC_INTEN_TXUDIEN_Msk : Transmit FIFO Underflow + * - \ref EMAC_INTEN_TXCPIEN_Msk : Transmit Completion + * - \ref EMAC_INTEN_EXDEFIEN_Msk : Defer Exceed + * - \ref EMAC_INTEN_NCSIEN_Msk : No Carrier Sense + * - \ref EMAC_INTEN_TXABTIEN_Msk : Transmit Abort + * - \ref EMAC_INTEN_LCIEN_Msk : Late Collision + * - \ref EMAC_INTEN_TDUIEN_Msk : Transmit Descriptor Unavailable + * - \ref EMAC_INTEN_TXBEIEN_Msk : Transmit Bus Error + * - \ref EMAC_INTEN_TSALMIEN_Msk : Time Stamp Alarm + * + * @return None + * + * @details This macro disable specified EMAC interrupt. + * \hideinitializer + */ +#define EMAC_DISABLE_INT(emac, u32eIntSel) ((emac)->INTEN &= ~ (u32eIntSel)) + +/** + * @brief Get specified interrupt flag/status + * + * @param[in] emac The pointer of the specified EMAC module + * @param[in] u32eIntTypeFlag Interrupt Type Flag, should be + * - \ref EMAC_INTSTS_RXIF_Msk : Receive + * - \ref EMAC_INTSTS_CRCEIF_Msk : CRC Error + * - \ref EMAC_INTSTS_RXOVIF_Msk : Receive FIFO Overflow + * - \ref EMAC_INTSTS_LPIF_Msk : Long Packet + * - \ref EMAC_INTSTS_RXGDIF_Msk : Receive Good + * - \ref EMAC_INTSTS_ALIEIF_Msk : Alignment Error + * - \ref EMAC_INTSTS_RPIF_Msk : Runt Packet + * - \ref EMAC_INTSTS_MPCOVIF_Msk : Missed Packet Counter + * - \ref EMAC_INTSTS_MFLEIF_Msk : Maximum Frame Length Exceed + * - \ref EMAC_INTSTS_DENIF_Msk : DMA Early Notification + * - \ref EMAC_INTSTS_RDUIF_Msk : Receive Descriptor Unavailable + * - \ref EMAC_INTSTS_RXBEIF_Msk : Receive Bus Error + * - \ref EMAC_INTSTS_CFRIF_Msk : Control Frame Receive + * - \ref EMAC_INTSTS_WOLIF_Msk : Wake on LAN + * - \ref EMAC_INTSTS_TXIF_Msk : Transmit + * - \ref EMAC_INTSTS_TXUDIF_Msk : Transmit FIFO Underflow + * - \ref EMAC_INTSTS_TXCPIF_Msk : Transmit Completion + * - \ref EMAC_INTSTS_EXDEFIF_Msk : Defer Exceed + * - \ref EMAC_INTSTS_NCSIF_Msk : No Carrier Sense + * - \ref EMAC_INTSTS_TXABTIF_Msk : Transmit Abort + * - \ref EMAC_INTSTS_LCIF_Msk : Late Collision + * - \ref EMAC_INTSTS_TDUIF_Msk : Transmit Descriptor Unavailable + * - \ref EMAC_INTSTS_TXBEIF_Msk : Transmit Bus Error + * - \ref EMAC_INTSTS_TSALMIF_Msk : Time Stamp Alarm + * + * @return None + * + * @details This macro get specified interrupt flag or interrupt indicator status. + * \hideinitializer + */ +#define EMAC_GET_INT_FLAG(emac, u32eIntTypeFlag) (((emac)->INTSTS & (u32eIntTypeFlag))?1:0) + +/** + * @brief Clear specified interrupt flag/status + * + * @param[in] emac The pointer of the specified EMAC module + * @param[in] u32eIntTypeFlag Interrupt Type Flag, should be + * - \ref EMAC_INTSTS_RXIF_Msk : Receive + * - \ref EMAC_INTSTS_CRCEIF_Msk : CRC Error + * - \ref EMAC_INTSTS_RXOVIF_Msk : Receive FIFO Overflow + * - \ref EMAC_INTSTS_LPIF_Msk : Long Packet + * - \ref EMAC_INTSTS_RXGDIF_Msk : Receive Good + * - \ref EMAC_INTSTS_ALIEIF_Msk : Alignment Error + * - \ref EMAC_INTSTS_RPIF_Msk : Runt Packet + * - \ref EMAC_INTSTS_MPCOVIF_Msk : Missed Packet Counter + * - \ref EMAC_INTSTS_MFLEIF_Msk : Maximum Frame Length Exceed + * - \ref EMAC_INTSTS_DENIF_Msk : DMA Early Notification + * - \ref EMAC_INTSTS_RDUIF_Msk : Receive Descriptor Unavailable + * - \ref EMAC_INTSTS_RXBEIF_Msk : Receive Bus Error + * - \ref EMAC_INTSTS_CFRIF_Msk : Control Frame Receive + * - \ref EMAC_INTSTS_WOLIF_Msk : Wake on LAN + * - \ref EMAC_INTSTS_TXIF_Msk : Transmit + * - \ref EMAC_INTSTS_TXUDIF_Msk : Transmit FIFO Underflow + * - \ref EMAC_INTSTS_TXCPIF_Msk : Transmit Completion + * - \ref EMAC_INTSTS_EXDEFIF_Msk : Defer Exceed + * - \ref EMAC_INTSTS_NCSIF_Msk : No Carrier Sense + * - \ref EMAC_INTSTS_TXABTIF_Msk : Transmit Abort + * - \ref EMAC_INTSTS_LCIF_Msk : Late Collision + * - \ref EMAC_INTSTS_TDUIF_Msk : Transmit Descriptor Unavailable + * - \ref EMAC_INTSTS_TXBEIF_Msk : Transmit Bus Error + * - \ref EMAC_INTSTS_TSALMIF_Msk : Time Stamp Alarm + * + * @retval 0 The specified interrupt is not happened. + * 1 The specified interrupt is happened. + * + * @details This macro clear specified interrupt flag or interrupt indicator status. + * \hideinitializer + */ +#define EMAC_CLEAR_INT_FLAG(emac, u32eIntTypeFlag) ((emac)->INTSTS |= (u32eIntTypeFlag)) + +void EMAC_Open(uint8_t *pu8MacAddr); +void EMAC_Close(void); +void EMAC_SetMacAddr(uint8_t *pu8MacAddr); +void EMAC_EnableCamEntry(uint32_t u32Entry, uint8_t pu8MacAddr[]); +void EMAC_DisableCamEntry(uint32_t u32Entry); + +uint32_t EMAC_RecvPkt(uint8_t *pu8Data, uint32_t *pu32Size); +uint32_t EMAC_RecvPktTS(uint8_t *pu8Data, uint32_t *pu32Size, uint32_t *pu32Sec, uint32_t *pu32Nsec); +void EMAC_RecvPktDone(void); + +uint32_t EMAC_SendPkt(uint8_t *pu8Data, uint32_t u32Size); +uint32_t EMAC_SendPktDone(void); +uint32_t EMAC_SendPktDoneTS(uint32_t *pu32Sec, uint32_t *pu32Nsec); + +void EMAC_EnableTS(uint32_t u32Sec, uint32_t u32Nsec); +void EMAC_DisableTS(void); +void EMAC_GetTime(uint32_t *pu32Sec, uint32_t *pu32Nsec); +void EMAC_SetTime(uint32_t u32Sec, uint32_t u32Nsec); +void EMAC_UpdateTime(uint32_t u32Neg, uint32_t u32Sec, uint32_t u32Nsec); +void EMAC_EnableAlarm(uint32_t u32Sec, uint32_t u32Nsec); +void EMAC_DisableAlarm(void); + +uint32_t EMAC_CheckLinkStatus(void); + +void EMAC_PhyInit(void); +int32_t EMAC_FillCamEntry(uint8_t pu8MacAddr[]); +uint8_t *EMAC_ClaimFreeTXBuf(void); +uint32_t EMAC_GetAvailRXBufSize(uint8_t** ppuDataBuf); +uint32_t EMAC_SendPktWoCopy(uint32_t u32Size); +void EMAC_RecvPktDoneWoRxTrigger(void); + +/*@}*/ /* end of group EMAC_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group EMAC_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_EMAC_H__ */ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_epwm.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_epwm.h new file mode 100644 index 00000000000..3e9a673467a --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_epwm.h @@ -0,0 +1,623 @@ +/**************************************************************************//** + * @file nu_epwm.h + * @version V3.00 + * @brief M480 series EPWM driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __NU_EPWM_H__ +#define __NU_EPWM_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup EPWM_Driver EPWM Driver + @{ +*/ + +/** @addtogroup EPWM_EXPORTED_CONSTANTS EPWM Exported Constants + @{ +*/ +#define EPWM_CHANNEL_NUM (6U) /*!< EPWM channel number \hideinitializer */ +#define EPWM_CH_0_MASK (0x1U) /*!< EPWM channel 0 mask \hideinitializer */ +#define EPWM_CH_1_MASK (0x2U) /*!< EPWM channel 1 mask \hideinitializer */ +#define EPWM_CH_2_MASK (0x4U) /*!< EPWM channel 2 mask \hideinitializer */ +#define EPWM_CH_3_MASK (0x8U) /*!< EPWM channel 3 mask \hideinitializer */ +#define EPWM_CH_4_MASK (0x10U) /*!< EPWM channel 4 mask \hideinitializer */ +#define EPWM_CH_5_MASK (0x20U) /*!< EPWM channel 5 mask \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Counter Type Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define EPWM_UP_COUNTER (0U) /*!< Up counter type \hideinitializer */ +#define EPWM_DOWN_COUNTER (1U) /*!< Down counter type \hideinitializer */ +#define EPWM_UP_DOWN_COUNTER (2U) /*!< Up-Down counter type \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Aligned Type Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define EPWM_EDGE_ALIGNED (1U) /*!< EPWM working in edge aligned type(down count) \hideinitializer */ +#define EPWM_CENTER_ALIGNED (2U) /*!< EPWM working in center aligned type \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Output Level Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define EPWM_OUTPUT_NOTHING (0U) /*!< EPWM output nothing \hideinitializer */ +#define EPWM_OUTPUT_LOW (1U) /*!< EPWM output low \hideinitializer */ +#define EPWM_OUTPUT_HIGH (2U) /*!< EPWM output high \hideinitializer */ +#define EPWM_OUTPUT_TOGGLE (3U) /*!< EPWM output toggle \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Synchronous Start Function Control Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define EPWM_SSCTL_SSRC_EPWM0 (0U<CTL1 = (epwm)->CTL1 | (0x7ul<CTL1 = (epwm)->CTL1 & ~(0x7ul<CTL0 = (epwm)->CTL0 | EPWM_CTL0_GROUPEN_Msk) + +/** + * @brief This macro disable group mode + * @param[in] epwm The pointer of the specified EPWM module + * @return None + * @details This macro is used to disable group mode of EPWM module. + * \hideinitializer + */ +#define EPWM_DISABLE_GROUP_MODE(epwm) ((epwm)->CTL0 = (epwm)->CTL0 & ~EPWM_CTL0_GROUPEN_Msk) + +/** + * @brief Enable timer synchronous start counting function of specified channel(s) + * @param[in] epwm The pointer of the specified EPWM module + * @param[in] u32ChannelMask Combination of enabled channels. Each bit corresponds to a channel + * Bit 0 represents channel 0, bit 1 represents channel 1... + * @param[in] u32SyncSrc Synchronous start source selection, valid values are: + * - \ref EPWM_SSCTL_SSRC_EPWM0 + * - \ref EPWM_SSCTL_SSRC_EPWM1 + * - \ref EPWM_SSCTL_SSRC_BPWM0 + * - \ref EPWM_SSCTL_SSRC_BPWM1 + * @return None + * @details This macro is used to enable timer synchronous start counting function of specified channel(s). + * \hideinitializer + */ +#define EPWM_ENABLE_TIMER_SYNC(epwm, u32ChannelMask, u32SyncSrc) ((epwm)->SSCTL = ((epwm)->SSCTL & ~EPWM_SSCTL_SSRC_Msk) | (u32SyncSrc) | (u32ChannelMask)) + +/** + * @brief Disable timer synchronous start counting function of specified channel(s) + * @param[in] epwm The pointer of the specified EPWM module + * @param[in] u32ChannelMask Combination of enabled channels. Each bit corresponds to a channel + * Bit 0 represents channel 0, bit 1 represents channel 1... + * @return None + * @details This macro is used to disable timer synchronous start counting function of specified channel(s). + * \hideinitializer + */ +#define EPWM_DISABLE_TIMER_SYNC(epwm, u32ChannelMask) \ + do{ \ + int i;\ + for(i = 0; i < 6; i++) { \ + if((u32ChannelMask) & (1 << i)) \ + (epwm)->SSCTL &= ~(1UL << i); \ + } \ + }while(0) + +/** + * @brief This macro enable EPWM counter synchronous start counting function. + * @param[in] epwm The pointer of the specified EPWM module + * @return None + * @details This macro is used to make selected EPWM0 and EPWM1 channel(s) start counting at the same time. + * To configure synchronous start counting channel(s) by EPWM_ENABLE_TIMER_SYNC() and EPWM_DISABLE_TIMER_SYNC(). + * \hideinitializer + */ +#define EPWM_TRIGGER_SYNC_START(epwm) ((epwm)->SSTRG = EPWM_SSTRG_CNTSEN_Msk) + +/** + * @brief This macro enable output inverter of specified channel(s) + * @param[in] epwm The pointer of the specified EPWM module + * @param[in] u32ChannelMask Combination of enabled channels. Each bit corresponds to a channel + * Bit 0 represents channel 0, bit 1 represents channel 1... + * @return None + * @details This macro is used to enable output inverter of specified channel(s). + * \hideinitializer + */ +#define EPWM_ENABLE_OUTPUT_INVERTER(epwm, u32ChannelMask) ((epwm)->POLCTL = (u32ChannelMask)) + +/** + * @brief This macro get captured rising data + * @param[in] epwm The pointer of the specified EPWM module + * @param[in] u32ChannelNum EPWM channel number. Valid values are between 0~5 + * @return None + * @details This macro is used to get captured rising data of specified channel. + * \hideinitializer + */ +#define EPWM_GET_CAPTURE_RISING_DATA(epwm, u32ChannelNum) ((epwm)->CAPDAT[(u32ChannelNum)].RCAPDAT) + +/** + * @brief This macro get captured falling data + * @param[in] epwm The pointer of the specified EPWM module + * @param[in] u32ChannelNum EPWM channel number. Valid values are between 0~5 + * @return None + * @details This macro is used to get captured falling data of specified channel. + * \hideinitializer + */ +#define EPWM_GET_CAPTURE_FALLING_DATA(epwm, u32ChannelNum) ((epwm)->CAPDAT[(u32ChannelNum)].FCAPDAT) + +/** + * @brief This macro mask output logic to high or low + * @param[in] epwm The pointer of the specified EPWM module + * @param[in] u32ChannelMask Combination of enabled channels. Each bit corresponds to a channel + * Bit 0 represents channel 0, bit 1 represents channel 1... + * @param[in] u32LevelMask Output logic to high or low + * @return None + * @details This macro is used to mask output logic to high or low of specified channel(s). + * @note If u32ChannelMask parameter is 0, then mask function will be disabled. + * \hideinitializer + */ +#define EPWM_MASK_OUTPUT(epwm, u32ChannelMask, u32LevelMask) \ + { \ + (epwm)->MSKEN = (u32ChannelMask); \ + (epwm)->MSK = (u32LevelMask); \ + } + +/** + * @brief This macro set the prescaler of the selected channel + * @param[in] epwm The pointer of the specified EPWM module + * @param[in] u32ChannelNum EPWM channel number. Valid values are between 0~5 + * @param[in] u32Prescaler Clock prescaler of specified channel. Valid values are between 0 ~ 0xFFF + * @return None + * @details This macro is used to set the prescaler of specified channel. + * @note Every even channel N, and channel (N + 1) share a prescaler. So if channel 0 prescaler changed, channel 1 will also be affected. + * The clock of EPWM counter is divided by (u32Prescaler + 1). + * \hideinitializer + */ +#define EPWM_SET_PRESCALER(epwm, u32ChannelNum, u32Prescaler) ((epwm)->CLKPSC[(u32ChannelNum) >> 1] = (u32Prescaler)) + +/** + * @brief This macro get the prescaler of the selected channel + * @param[in] epwm The pointer of the specified EPWM module + * @param[in] u32ChannelNum EPWM channel number. Valid values are between 0~5 + * @return Return Clock prescaler of specified channel. Valid values are between 0 ~ 0xFFF + * @details This macro is used to get the prescaler of specified channel. + * @note Every even channel N, and channel (N + 1) share a prescaler. So if channel 0 prescaler changed, channel 1 will also be affected. + * The clock of EPWM counter is divided by (u32Prescaler + 1). + * \hideinitializer + */ +#define EPWM_GET_PRESCALER(epwm, u32ChannelNum) ((epwm)->CLKPSC[(u32ChannelNum) >> 1U]) + +/** + * @brief This macro set the comparator of the selected channel + * @param[in] epwm The pointer of the specified EPWM module + * @param[in] u32ChannelNum EPWM channel number. Valid values are between 0~5 + * @param[in] u32CMR Comparator of specified channel. Valid values are between 0~0xFFFF + * @return None + * @details This macro is used to set the comparator of specified channel. + * @note This new setting will take effect on next EPWM period. + * \hideinitializer + */ +#define EPWM_SET_CMR(epwm, u32ChannelNum, u32CMR) ((epwm)->CMPDAT[(u32ChannelNum)]= (u32CMR)) + +/** + * @brief This macro get the comparator of the selected channel + * @param[in] epwm The pointer of the specified EPWM module + * @param[in] u32ChannelNum EPWM channel number. Valid values are between 0~5 + * @return Return the comparator of specified channel. Valid values are between 0~0xFFFF + * @details This macro is used to get the comparator of specified channel. + * \hideinitializer + */ +#define EPWM_GET_CMR(epwm, u32ChannelNum) ((epwm)->CMPDAT[(u32ChannelNum)]) + +/** + * @brief This macro set the free trigger comparator of the selected channel + * @param[in] epwm The pointer of the specified EPWM module + * @param[in] u32ChannelNum EPWM channel number. Valid values are between 0~5 + * @param[in] u32FTCMR Free trigger comparator of specified channel. Valid values are between 0~0xFFFF + * @return None + * @details This macro is used to set the free trigger comparator of specified channel. + * @note This new setting will take effect on next EPWM period. + * \hideinitializer + */ +#define EPWM_SET_FTCMR(epwm, u32ChannelNum, u32FTCMR) (((epwm)->FTCMPDAT[((u32ChannelNum) >> 1U)]) = (u32FTCMR)) + +/** + * @brief This macro set the period of the selected channel + * @param[in] epwm The pointer of the specified EPWM module + * @param[in] u32ChannelNum EPWM channel number. Valid values are between 0~5 + * @param[in] u32CNR Period of specified channel. Valid values are between 0~0xFFFF + * @return None + * @details This macro is used to set the period of specified channel. + * @note This new setting will take effect on next EPWM period. + * @note EPWM counter will stop if period length set to 0. + * \hideinitializer + */ +#define EPWM_SET_CNR(epwm, u32ChannelNum, u32CNR) ((epwm)->PERIOD[(u32ChannelNum)] = (u32CNR)) + +/** + * @brief This macro get the period of the selected channel + * @param[in] epwm The pointer of the specified EPWM module + * @param[in] u32ChannelNum EPWM channel number. Valid values are between 0~5 + * @return Return the period of specified channel. Valid values are between 0~0xFFFF + * @details This macro is used to get the period of specified channel. + * \hideinitializer + */ +#define EPWM_GET_CNR(epwm, u32ChannelNum) ((epwm)->PERIOD[(u32ChannelNum)]) + +/** + * @brief This macro set the EPWM aligned type + * @param[in] epwm The pointer of the specified EPWM module + * @param[in] u32ChannelMask Combination of enabled channels. Each bit corresponds to a channel + * Bit 0 represents channel 0, bit 1 represents channel 1... + * @param[in] u32AlignedType EPWM aligned type, valid values are: + * - \ref EPWM_EDGE_ALIGNED + * - \ref EPWM_CENTER_ALIGNED + * @return None + * @details This macro is used to set the EPWM aligned type of specified channel(s). + * \hideinitializer + */ +#define EPWM_SET_ALIGNED_TYPE(epwm, u32ChannelMask, u32AlignedType) \ + do{ \ + int i; \ + for(i = 0; i < 6; i++) { \ + if((u32ChannelMask) & (1 << i)) \ + (epwm)->CTL1 = (((epwm)->CTL1 & ~(3UL << (i << 1))) | ((u32AlignedType) << (i << 1))); \ + } \ + }while(0) + +/** + * @brief Set load window of window loading mode for specified channel(s) + * @param[in] epwm The pointer of the specified EPWM module + * @param[in] u32ChannelMask Combination of enabled channels. Each bit corresponds to a channel + * Bit 0 represents channel 0, bit 1 represents channel 1... + * @return None + * @details This macro is used to set load window of window loading mode for specified channel(s). + * \hideinitializer + */ +#define EPWM_SET_LOAD_WINDOW(epwm, u32ChannelMask) ((epwm)->LOAD |= (u32ChannelMask)) + +/** + * @brief Trigger synchronous event from specified channel(s) + * @param[in] epwm The pointer of the specified EPWM module + * @param[in] u32ChannelNum EPWM channel number. Valid values are 0, 2, 4 + * Bit 0 represents channel 0, bit 1 represents channel 2 and bit 2 represents channel 4 + * @return None + * @details This macro is used to trigger synchronous event from specified channel(s). + * \hideinitializer + */ +#define EPWM_TRIGGER_SYNC(epwm, u32ChannelNum) ((epwm)->SWSYNC |= (1 << ((u32ChannelNum) >> 1))) + +/** + * @brief Clear counter of specified channel(s) + * @param[in] epwm The pointer of the specified EPWM module + * @param[in] u32ChannelMask Combination of enabled channels. Each bit corresponds to a channel + * Bit 0 represents channel 0, bit 1 represents channel 1... + * @return None + * @details This macro is used to clear counter of specified channel(s). + * \hideinitializer + */ +#define EPWM_CLR_COUNTER(epwm, u32ChannelMask) ((epwm)->CNTCLR |= (u32ChannelMask)) + +/** + * @brief Set output level at zero, compare up, period(center) and compare down of specified channel(s) + * @param[in] epwm The pointer of the specified EPWM module + * @param[in] u32ChannelMask Combination of enabled channels. Each bit corresponds to a channel + * Bit 0 represents channel 0, bit 1 represents channel 1... + * @param[in] u32ZeroLevel output level at zero point, valid values are: + * - \ref EPWM_OUTPUT_NOTHING + * - \ref EPWM_OUTPUT_LOW + * - \ref EPWM_OUTPUT_HIGH + * - \ref EPWM_OUTPUT_TOGGLE + * @param[in] u32CmpUpLevel output level at compare up point, valid values are: + * - \ref EPWM_OUTPUT_NOTHING + * - \ref EPWM_OUTPUT_LOW + * - \ref EPWM_OUTPUT_HIGH + * - \ref EPWM_OUTPUT_TOGGLE + * @param[in] u32PeriodLevel output level at period(center) point, valid values are: + * - \ref EPWM_OUTPUT_NOTHING + * - \ref EPWM_OUTPUT_LOW + * - \ref EPWM_OUTPUT_HIGH + * - \ref EPWM_OUTPUT_TOGGLE + * @param[in] u32CmpDownLevel output level at compare down point, valid values are: + * - \ref EPWM_OUTPUT_NOTHING + * - \ref EPWM_OUTPUT_LOW + * - \ref EPWM_OUTPUT_HIGH + * - \ref EPWM_OUTPUT_TOGGLE + * @return None + * @details This macro is used to Set output level at zero, compare up, period(center) and compare down of specified channel(s). + * \hideinitializer + */ +#define EPWM_SET_OUTPUT_LEVEL(epwm, u32ChannelMask, u32ZeroLevel, u32CmpUpLevel, u32PeriodLevel, u32CmpDownLevel) \ + do{ \ + int i; \ + for(i = 0; i < 6; i++) { \ + if((u32ChannelMask) & (1 << i)) { \ + (epwm)->WGCTL0 = (((epwm)->WGCTL0 & ~(3UL << (i << 1))) | ((u32ZeroLevel) << (i << 1))); \ + (epwm)->WGCTL0 = (((epwm)->WGCTL0 & ~(3UL << (EPWM_WGCTL0_PRDPCTL0_Pos + (i << 1)))) | ((u32PeriodLevel) << (EPWM_WGCTL0_PRDPCTL0_Pos + (i << 1)))); \ + (epwm)->WGCTL1 = (((epwm)->WGCTL1 & ~(3UL << (i << 1))) | ((u32CmpUpLevel) << (i << 1))); \ + (epwm)->WGCTL1 = (((epwm)->WGCTL1 & ~(3UL << (EPWM_WGCTL1_CMPDCTL0_Pos + (i << 1)))) | ((u32CmpDownLevel) << (EPWM_WGCTL1_CMPDCTL0_Pos + (i << 1)))); \ + } \ + } \ + }while(0) + +/** + * @brief Trigger brake event from specified channel(s) + * @param[in] epwm The pointer of the specified EPWM module + * @param[in] u32ChannelMask Combination of enabled channels. Each bit corresponds to a channel + * Bit 0 represents channel 0, bit 1 represents channel 2 and bit 2 represents channel 4 + * @param[in] u32BrakeType Type of brake trigger. + * - \ref EPWM_FB_EDGE + * - \ref EPWM_FB_LEVEL + * @return None + * @details This macro is used to trigger brake event from specified channel(s). + * \hideinitializer + */ +#define EPWM_TRIGGER_BRAKE(epwm, u32ChannelMask, u32BrakeType) ((epwm)->SWBRK |= ((u32ChannelMask) << (u32BrakeType))) + +/** + * @brief Set Dead zone clock source + * @param[in] epwm The pointer of the specified EPWM module + * @param[in] u32ChannelNum EPWM channel number. Valid values are between 0~5 + * @param[in] u32AfterPrescaler Dead zone clock source is from prescaler output. Valid values are TRUE (after prescaler) or FALSE (before prescaler). + * @return None + * @details This macro is used to set Dead zone clock source. Every two channels share the same setting. + * @note The write-protection function should be disabled before using this function. + * \hideinitializer + */ +#define EPWM_SET_DEADZONE_CLK_SRC(epwm, u32ChannelNum, u32AfterPrescaler) \ + ((epwm)->DTCTL[(u32ChannelNum) >> 1] = (((epwm)->DTCTL[(u32ChannelNum) >> 1] & ~EPWM_DTCTL0_1_DTCKSEL_Msk) | \ + ((u32AfterPrescaler) << EPWM_DTCTL0_1_DTCKSEL_Pos))) + +/*---------------------------------------------------------------------------------------------------------*/ +/* Define EPWM functions prototype */ +/*---------------------------------------------------------------------------------------------------------*/ +uint32_t EPWM_ConfigCaptureChannel(EPWM_T *epwm, uint32_t u32ChannelNum, uint32_t u32UnitTimeNsec, uint32_t u32CaptureEdge); +uint32_t EPWM_ConfigOutputChannel(EPWM_T *epwm, uint32_t u32ChannelNum, uint32_t u32Frequency, uint32_t u32DutyCycle); +void EPWM_Start(EPWM_T *epwm, uint32_t u32ChannelMask); +void EPWM_Stop(EPWM_T *epwm, uint32_t u32ChannelMask); +void EPWM_ForceStop(EPWM_T *epwm, uint32_t u32ChannelMask); +void EPWM_EnableADCTrigger(EPWM_T *epwm, uint32_t u32ChannelNum, uint32_t u32Condition); +void EPWM_DisableADCTrigger(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_ClearADCTriggerFlag(EPWM_T *epwm, uint32_t u32ChannelNum, uint32_t u32Condition); +uint32_t EPWM_GetADCTriggerFlag(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_EnableDACTrigger(EPWM_T *epwm, uint32_t u32ChannelNum, uint32_t u32Condition); +void EPWM_DisableDACTrigger(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_ClearDACTriggerFlag(EPWM_T *epwm, uint32_t u32ChannelNum, uint32_t u32Condition); +uint32_t EPWM_GetDACTriggerFlag(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_EnableFaultBrake(EPWM_T *epwm, uint32_t u32ChannelMask, uint32_t u32LevelMask, uint32_t u32BrakeSource); +void EPWM_EnableCapture(EPWM_T *epwm, uint32_t u32ChannelMask); +void EPWM_DisableCapture(EPWM_T *epwm, uint32_t u32ChannelMask); +void EPWM_EnableOutput(EPWM_T *epwm, uint32_t u32ChannelMask); +void EPWM_DisableOutput(EPWM_T *epwm, uint32_t u32ChannelMask); +void EPWM_EnablePDMA(EPWM_T *epwm, uint32_t u32ChannelNum, uint32_t u32RisingFirst, uint32_t u32Mode); +void EPWM_DisablePDMA(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_EnableDeadZone(EPWM_T *epwm, uint32_t u32ChannelNum, uint32_t u32Duration); +void EPWM_DisableDeadZone(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_EnableCaptureInt(EPWM_T *epwm, uint32_t u32ChannelNum, uint32_t u32Edge); +void EPWM_DisableCaptureInt(EPWM_T *epwm, uint32_t u32ChannelNum, uint32_t u32Edge); +void EPWM_ClearCaptureIntFlag(EPWM_T *epwm, uint32_t u32ChannelNum, uint32_t u32Edge); +uint32_t EPWM_GetCaptureIntFlag(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_EnableDutyInt(EPWM_T *epwm, uint32_t u32ChannelNum, uint32_t u32IntDutyType); +void EPWM_DisableDutyInt(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_ClearDutyIntFlag(EPWM_T *epwm, uint32_t u32ChannelNum); +uint32_t EPWM_GetDutyIntFlag(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_EnableFaultBrakeInt(EPWM_T *epwm, uint32_t u32BrakeSource); +void EPWM_DisableFaultBrakeInt(EPWM_T *epwm, uint32_t u32BrakeSource); +void EPWM_ClearFaultBrakeIntFlag(EPWM_T *epwm, uint32_t u32BrakeSource); +uint32_t EPWM_GetFaultBrakeIntFlag(EPWM_T *epwm, uint32_t u32BrakeSource); +void EPWM_EnablePeriodInt(EPWM_T *epwm, uint32_t u32ChannelNum, uint32_t u32IntPeriodType); +void EPWM_DisablePeriodInt(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_ClearPeriodIntFlag(EPWM_T *epwm, uint32_t u32ChannelNum); +uint32_t EPWM_GetPeriodIntFlag(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_EnableZeroInt(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_DisableZeroInt(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_ClearZeroIntFlag(EPWM_T *epwm, uint32_t u32ChannelNum); +uint32_t EPWM_GetZeroIntFlag(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_EnableAcc(EPWM_T *epwm, uint32_t u32ChannelNum, uint32_t u32IntFlagCnt, uint32_t u32IntAccSrc); +void EPWM_DisableAcc(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_EnableAccInt(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_DisableAccInt(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_ClearAccInt(EPWM_T *epwm, uint32_t u32ChannelNum); +uint32_t EPWM_GetAccInt(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_EnableAccPDMA(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_DisableAccPDMA(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_EnableAccStopMode(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_DisableAccStopMode(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_ClearFTDutyIntFlag(EPWM_T *epwm, uint32_t u32ChannelNum); +uint32_t EPWM_GetFTDutyIntFlag(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_EnableLoadMode(EPWM_T *epwm, uint32_t u32ChannelNum, uint32_t u32LoadMode); +void EPWM_DisableLoadMode(EPWM_T *epwm, uint32_t u32ChannelNum, uint32_t u32LoadMode); +void EPWM_ConfigSyncPhase(EPWM_T *epwm, uint32_t u32ChannelNum, uint32_t u32SyncSrc, uint32_t u32Direction, uint32_t u32StartPhase); +void EPWM_EnableSyncPhase(EPWM_T *epwm, uint32_t u32ChannelMask); +void EPWM_DisableSyncPhase(EPWM_T *epwm, uint32_t u32ChannelMask); +void EPWM_EnableSyncNoiseFilter(EPWM_T *epwm, uint32_t u32ClkCnt, uint32_t u32ClkDivSel); +void EPWM_DisableSyncNoiseFilter(EPWM_T *epwm); +void EPWM_EnableSyncPinInverse(EPWM_T *epwm); +void EPWM_DisableSyncPinInverse(EPWM_T *epwm); +void EPWM_SetClockSource(EPWM_T *epwm, uint32_t u32ChannelNum, uint32_t u32ClkSrcSel); +void EPWM_EnableBrakeNoiseFilter(EPWM_T *epwm, uint32_t u32BrakePinNum, uint32_t u32ClkCnt, uint32_t u32ClkDivSel); +void EPWM_DisableBrakeNoiseFilter(EPWM_T *epwm, uint32_t u32BrakePinNum); +void EPWM_EnableBrakePinInverse(EPWM_T *epwm, uint32_t u32BrakePinNum); +void EPWM_DisableBrakePinInverse(EPWM_T *epwm, uint32_t u32BrakePinNum); +void EPWM_SetBrakePinSource(EPWM_T *epwm, uint32_t u32BrakePinNum, uint32_t u32SelAnotherModule); +void EPWM_SetLeadingEdgeBlanking(EPWM_T *epwm, uint32_t u32TrigSrcSel, uint32_t u32TrigType, uint32_t u32BlankingCnt, uint32_t u32BlankingEnable); +uint32_t EPWM_GetWrapAroundFlag(EPWM_T *epwm, uint32_t u32ChannelNum); +void EPWM_ClearWrapAroundFlag(EPWM_T *epwm, uint32_t u32ChannelNum); + +/*@}*/ /* end of group EPWM_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group EPWM_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_EPWM_H__ */ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_fmc.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_fmc.h new file mode 100644 index 00000000000..d2aa0e96bdc --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_fmc.h @@ -0,0 +1,302 @@ +/**************************************************************************//** + * @file nu_fmc.h + * @version V1.00 + * @brief M480 Series Flash Memory Controller Driver Header File + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + ******************************************************************************/ +#ifndef __NU_FMC_H__ +#define __NU_FMC_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup FMC_Driver FMC Driver + @{ +*/ + + +/** @addtogroup FMC_EXPORTED_CONSTANTS FMC Exported Constants + @{ +*/ + + +/*---------------------------------------------------------------------------------------------------------*/ +/* Define Base Address */ +/*---------------------------------------------------------------------------------------------------------*/ +#define FMC_APROM_BASE 0x00000000UL /*!< APROM base address \hideinitializer */ +#define FMC_APROM_END 0x00080000UL /*!< APROM end address \hideinitializer */ +#define FMC_APROM_BANK0_END (FMC_APROM_END/2UL) /*!< APROM bank0 end address \hideinitializer */ +#define FMC_LDROM_BASE 0x00100000UL /*!< LDROM base address \hideinitializer */ +#define FMC_LDROM_END 0x00101000UL /*!< LDROM end address \hideinitializer */ +#define FMC_SPROM_BASE 0x00200000UL /*!< SPROM base address \hideinitializer */ +#define FMC_SPROM_END 0x00201000UL /*!< SPROM end address \hideinitializer */ +#define FMC_XOM_BASE 0x00200000UL /*!< XOM Base Address \hideinitializer */ +#define FMC_XOMR0_BASE 0x00200000UL /*!< XOMR 0 Base Address \hideinitializer */ +#define FMC_XOMR1_BASE 0x00200010UL /*!< XOMR 1 Base Address \hideinitializer */ +#define FMC_XOMR2_BASE 0x00200020UL /*!< XOMR 2 Base Address \hideinitializer */ +#define FMC_XOMR3_BASE 0x00200030UL /*!< XOMR 3 Base Address \hideinitializer */ +#define FMC_CONFIG_BASE 0x00300000UL /*!< User Configuration address \hideinitializer */ +#define FMC_USER_CONFIG_0 0x00300000UL /*!< User Config 0 address \hideinitializer */ +#define FMC_USER_CONFIG_1 0x00300004UL /*!< User Config 1 address \hideinitializer */ +#define FMC_USER_CONFIG_2 0x00300008UL /*!< User Config 2 address \hideinitializer */ +#define FMC_KPROM_BASE 0x00301000UL /*!< Security ROM base address \hideinitializer */ +#define FMC_OTP_BASE 0x00310000UL /*!< OTP flash base address \hideinitializer */ + +#define FMC_FLASH_PAGE_SIZE 0x1000UL /*!< Flash Page Size (4K bytes) \hideinitializer */ +#define FMC_PAGE_ADDR_MASK 0xFFFFF000UL /*!< Flash page address mask \hideinitializer */ +#define FMC_MULTI_WORD_PROG_LEN 512 /*!< The maximum length of a multi-word program. */ + +#define FMC_APROM_SIZE FMC_APROM_END /*!< APROM Size \hideinitializer */ +#define FMC_BANK_SIZE (FMC_APROM_SIZE/2UL) /*!< APROM Bank Size \hideinitializer */ +#define FMC_LDROM_SIZE 0x1000UL /*!< LDROM Size (4 Kbytes) \hideinitializer */ +#define FMC_SPROM_SIZE 0x1000UL /*!< SPROM Size (4 Kbytes) \hideinitializer */ +#define FMC_OTP_ENTRY_CNT 256UL /*!< OTP entry number \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* XOM region number constant definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define XOMR0 0UL /*!< XOM region 0 */ +#define XOMR1 1UL /*!< XOM region 1 */ +#define XOMR2 2UL /*!< XOM region 2 */ +#define XOMR3 3UL /*!< XOM region 3 */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* ISPCTL constant definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define IS_BOOT_FROM_LDROM 0x1UL /*!< ISPCTL setting to select to boot from LDROM */ +#define IS_BOOT_FROM_APROM 0x0UL /*!< ISPCTL setting to select to boot from APROM */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* ISPCMD constant definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define FMC_ISPCMD_READ 0x00UL /*!< ISP Command: Read flash word \hideinitializer */ +#define FMC_ISPCMD_READ_UID 0x04UL /*!< ISP Command: Read Unique ID \hideinitializer */ +#define FMC_ISPCMD_READ_ALL1 0x08UL /*!< ISP Command: Read all-one result \hideinitializer */ +#define FMC_ISPCMD_READ_CID 0x0BUL /*!< ISP Command: Read Company ID \hideinitializer */ +#define FMC_ISPCMD_READ_DID 0x0CUL /*!< ISP Command: Read Device ID \hideinitializer */ +#define FMC_ISPCMD_READ_CKS 0x0DUL /*!< ISP Command: Read checksum \hideinitializer */ +#define FMC_ISPCMD_PROGRAM 0x21UL /*!< ISP Command: Write flash word \hideinitializer */ +#define FMC_ISPCMD_PAGE_ERASE 0x22UL /*!< ISP Command: Page Erase Flash \hideinitializer */ +#define FMC_ISPCMD_BANK_ERASE 0x23UL /*!< ISP Command: Erase Flash bank 0 or 1 \hideinitializer */ +#define FMC_ISPCMD_BLOCK_ERASE 0x25UL /*!< ISP Command: Erase 4 pages alignment of APROM in bank 0 or 1 \hideinitializer */ +#define FMC_ISPCMD_PROGRAM_MUL 0x27UL /*!< ISP Command: Multuple word program \hideinitializer */ +#define FMC_ISPCMD_RUN_ALL1 0x28UL /*!< ISP Command: Run all-one verification \hideinitializer */ +#define FMC_ISPCMD_RUN_CKS 0x2DUL /*!< ISP Command: Run checksum calculation \hideinitializer */ +#define FMC_ISPCMD_VECMAP 0x2EUL /*!< ISP Command: Vector Page Remap \hideinitializer */ +#define FMC_ISPCMD_READ_64 0x40UL /*!< ISP Command: Read double flash word \hideinitializer */ +#define FMC_ISPCMD_PROGRAM_64 0x61UL /*!< ISP Command: Write double flash word \hideinitializer */ + +#define READ_ALLONE_YES 0xA11FFFFFUL /*!< Check-all-one result is all one. \hideinitializer */ +#define READ_ALLONE_NOT 0xA1100000UL /*!< Check-all-one result is not all one. \hideinitializer */ +#define READ_ALLONE_CMD_FAIL 0xFFFFFFFFUL /*!< Check-all-one command failed. \hideinitializer */ + + +/*@}*/ /* end of group FMC_EXPORTED_CONSTANTS */ + + +/** @addtogroup FMC_EXPORTED_MACROS FMC Exported Macros + @{ +*/ + + +/*---------------------------------------------------------------------------------------------------------*/ +/* Macros */ +/*---------------------------------------------------------------------------------------------------------*/ + +#define FMC_SET_APROM_BOOT() (FMC->ISPCTL &= ~FMC_ISPCTL_BS_Msk) /*!< Select booting from APROM \hideinitializer */ +#define FMC_SET_LDROM_BOOT() (FMC->ISPCTL |= FMC_ISPCTL_BS_Msk) /*!< Select booting from LDROM \hideinitializer */ +#define FMC_ENABLE_AP_UPDATE() (FMC->ISPCTL |= FMC_ISPCTL_APUEN_Msk) /*!< Enable APROM update \hideinitializer */ +#define FMC_DISABLE_AP_UPDATE() (FMC->ISPCTL &= ~FMC_ISPCTL_APUEN_Msk) /*!< Disable APROM update \hideinitializer */ +#define FMC_ENABLE_CFG_UPDATE() (FMC->ISPCTL |= FMC_ISPCTL_CFGUEN_Msk) /*!< Enable User Config update \hideinitializer */ +#define FMC_DISABLE_CFG_UPDATE() (FMC->ISPCTL &= ~FMC_ISPCTL_CFGUEN_Msk) /*!< Disable User Config update \hideinitializer */ +#define FMC_ENABLE_LD_UPDATE() (FMC->ISPCTL |= FMC_ISPCTL_LDUEN_Msk) /*!< Enable LDROM update \hideinitializer */ +#define FMC_DISABLE_LD_UPDATE() (FMC->ISPCTL &= ~FMC_ISPCTL_LDUEN_Msk) /*!< Disable LDROM update \hideinitializer */ +#define FMC_ENABLE_SP_UPDATE() (FMC->ISPCTL |= FMC_ISPCTL_SPUEN_Msk) /*!< Enable SPROM update \hideinitializer */ +#define FMC_DISABLE_SP_UPDATE() (FMC->ISPCTL &= ~FMC_ISPCTL_SPUEN_Msk) /*!< Disable SPROM update \hideinitializer */ +#define FMC_DISABLE_ISP() (FMC->ISPCTL &= ~FMC_ISPCTL_ISPEN_Msk) /*!< Disable ISP function \hideinitializer */ +#define FMC_ENABLE_ISP() (FMC->ISPCTL |= FMC_ISPCTL_ISPEN_Msk) /*!< Enable ISP function \hideinitializer */ +#define FMC_GET_FAIL_FLAG() ((FMC->ISPCTL & FMC_ISPCTL_ISPFF_Msk) ? 1UL : 0UL) /*!< Get ISP fail flag \hideinitializer */ +#define FMC_CLR_FAIL_FLAG() (FMC->ISPCTL |= FMC_ISPCTL_ISPFF_Msk) /*!< Clear ISP fail flag \hideinitializer */ + +/*@}*/ /* end of group FMC_EXPORTED_MACROS */ + + +/** @addtogroup FMC_EXPORTED_FUNCTIONS FMC Exported Functions + @{ +*/ + +/*---------------------------------------------------------------------------------------------------------*/ +/* inline functions */ +/*---------------------------------------------------------------------------------------------------------*/ + +__STATIC_INLINE uint32_t FMC_ReadCID(void); +__STATIC_INLINE uint32_t FMC_ReadPID(void); +__STATIC_INLINE uint32_t FMC_ReadUID(uint8_t u8Index); +__STATIC_INLINE uint32_t FMC_ReadUCID(uint32_t u32Index); +__STATIC_INLINE void FMC_SetVectorPageAddr(uint32_t u32PageAddr); +__STATIC_INLINE uint32_t FMC_GetVECMAP(void); + +/** + * @brief Get current vector mapping address. + * @param None + * @return The current vector mapping address. + * @details To get VECMAP value which is the page address for remapping to vector page (0x0). + * @note + * VECMAP only valid when new IAP function is enabled. (CBS = 10'b or 00'b) + */ +__STATIC_INLINE uint32_t FMC_GetVECMAP(void) +{ + return (FMC->ISPSTS & FMC_ISPSTS_VECMAP_Msk); +} + +/** + * @brief Read company ID + * @param None + * @return The company ID (32-bit) + * @details The company ID of Nuvoton is fixed to be 0xDA + */ +__STATIC_INLINE uint32_t FMC_ReadCID(void) +{ + FMC->ISPCMD = FMC_ISPCMD_READ_CID; /* Set ISP Command Code */ + FMC->ISPADDR = 0x0u; /* Must keep 0x0 when read CID */ + FMC->ISPTRG = FMC_ISPTRG_ISPGO_Msk; /* Trigger to start ISP procedure */ +#if ISBEN + __ISB(); +#endif /* To make sure ISP/CPU be Synchronized */ + while(FMC->ISPTRG & FMC_ISPTRG_ISPGO_Msk) {} /* Waiting for ISP Done */ + + return FMC->ISPDAT; +} + +/** + * @brief Read product ID + * @param None + * @return The product ID (32-bit) + * @details This function is used to read product ID. + */ +__STATIC_INLINE uint32_t FMC_ReadPID(void) +{ + FMC->ISPCMD = FMC_ISPCMD_READ_DID; /* Set ISP Command Code */ + FMC->ISPADDR = 0x04u; /* Must keep 0x4 when read PID */ + FMC->ISPTRG = FMC_ISPTRG_ISPGO_Msk; /* Trigger to start ISP procedure */ +#if ISBEN + __ISB(); +#endif /* To make sure ISP/CPU be Synchronized */ + while(FMC->ISPTRG & FMC_ISPTRG_ISPGO_Msk) {} /* Waiting for ISP Done */ + + return FMC->ISPDAT; +} + +/** + * @brief Read Unique ID + * @param[in] u8Index UID index. 0 = UID[31:0], 1 = UID[63:32], 2 = UID[95:64] + * @return The 32-bit unique ID data of specified UID index. + * @details To read out 96-bit Unique ID. + */ +__STATIC_INLINE uint32_t FMC_ReadUID(uint8_t u8Index) +{ + FMC->ISPCMD = FMC_ISPCMD_READ_UID; + FMC->ISPADDR = ((uint32_t)u8Index << 2u); + FMC->ISPDAT = 0u; + FMC->ISPTRG = 0x1u; +#if ISBEN + __ISB(); +#endif + while(FMC->ISPTRG) {} + + return FMC->ISPDAT; +} + +/** + * @brief To read UCID + * @param[in] u32Index Index of the UCID to read. u32Index must be 0, 1, 2, or 3. + * @return The UCID of specified index + * @details This function is used to read unique chip ID (UCID). + */ +__STATIC_INLINE uint32_t FMC_ReadUCID(uint32_t u32Index) +{ + FMC->ISPCMD = FMC_ISPCMD_READ_UID; /* Set ISP Command Code */ + FMC->ISPADDR = (0x04u * u32Index) + 0x10u; /* The UCID is at offset 0x10 with word alignment. */ + FMC->ISPTRG = FMC_ISPTRG_ISPGO_Msk; /* Trigger to start ISP procedure */ +#if ISBEN + __ISB(); +#endif /* To make sure ISP/CPU be Synchronized */ + while(FMC->ISPTRG & FMC_ISPTRG_ISPGO_Msk) {} /* Waiting for ISP Done */ + + return FMC->ISPDAT; +} + +/** + * @brief Set vector mapping address + * @param[in] u32PageAddr The page address to remap to address 0x0. The address must be page alignment. + * @return To set VECMAP to remap specified page address to 0x0. + * @details This function is used to set VECMAP to map specified page to vector page (0x0). + * @note + * VECMAP only valid when new IAP function is enabled. (CBS = 10'b or 00'b) + */ +__STATIC_INLINE void FMC_SetVectorPageAddr(uint32_t u32PageAddr) +{ + FMC->ISPCMD = FMC_ISPCMD_VECMAP; /* Set ISP Command Code */ + FMC->ISPADDR = u32PageAddr; /* The address of specified page which will be map to address 0x0. It must be page alignment. */ + FMC->ISPTRG = 0x1u; /* Trigger to start ISP procedure */ +#if ISBEN + __ISB(); +#endif /* To make sure ISP/CPU be Synchronized */ + while(FMC->ISPTRG) {} /* Waiting for ISP Done */ +} + + +/*---------------------------------------------------------------------------------------------------------*/ +/* Functions */ +/*---------------------------------------------------------------------------------------------------------*/ + +extern void FMC_Close(void); +extern int32_t FMC_ConfigXOM(uint32_t xom_num, uint32_t xom_base, uint8_t xom_page); +extern int32_t FMC_Erase(uint32_t u32PageAddr); +extern int32_t FMC_Erase_SPROM(void); +extern int32_t FMC_Erase_Block(uint32_t u32BlockAddr); +extern int32_t FMC_Erase_Bank(uint32_t u32BankAddr); +extern int32_t FMC_EraseXOM(uint32_t xom_num); +extern int32_t FMC_GetXOMState(uint32_t xom_num); +extern int32_t FMC_GetBootSource(void); +extern void FMC_Open(void); +extern uint32_t FMC_Read(uint32_t u32Addr); +extern int32_t FMC_Read_64(uint32_t u32addr, uint32_t * u32data0, uint32_t * u32data1); +extern uint32_t FMC_ReadDataFlashBaseAddr(void); +extern void FMC_SetBootSource(int32_t i32BootSrc); +extern void FMC_Write(uint32_t u32Addr, uint32_t u32Data); +extern int32_t FMC_Write8Bytes(uint32_t u32addr, uint32_t u32data0, uint32_t u32data1); +extern int32_t FMC_WriteMultiple(uint32_t u32Addr, uint32_t pu32Buf[], uint32_t u32Len); +extern int32_t FMC_Write_OTP(uint32_t otp_num, uint32_t low_word, uint32_t high_word); +extern int32_t FMC_Read_OTP(uint32_t otp_num, uint32_t *low_word, uint32_t *high_word); +extern int32_t FMC_Lock_OTP(uint32_t otp_num); +extern int32_t FMC_Is_OTP_Locked(uint32_t otp_num); +extern int32_t FMC_ReadConfig(uint32_t u32Config[], uint32_t u32Count); +extern int32_t FMC_WriteConfig(uint32_t u32Config[], uint32_t u32Count); +extern uint32_t FMC_GetChkSum(uint32_t u32addr, uint32_t u32count); +extern uint32_t FMC_CheckAllOne(uint32_t u32addr, uint32_t u32count); +extern int32_t FMC_SetSPKey(uint32_t key[3], uint32_t kpmax, uint32_t kemax, const int32_t lock_CONFIG, const int32_t lock_SPROM); +extern int32_t FMC_CompareSPKey(uint32_t key[3]); + + +/*@}*/ /* end of group FMC_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group FMC_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_FMC_H__ */ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_gpio.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_gpio.h new file mode 100644 index 00000000000..08ce10ce59e --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_gpio.h @@ -0,0 +1,497 @@ +/**************************************************************************//** + * @file GPIO.h + * @version V3.00 + * @brief M480 series GPIO driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + ******************************************************************************/ +#ifndef __NU_GPIO_H__ +#define __NU_GPIO_H__ + + +#ifdef __cplusplus +extern "C" +{ +#endif + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup GPIO_Driver GPIO Driver + @{ +*/ + +/** @addtogroup GPIO_EXPORTED_CONSTANTS GPIO Exported Constants + @{ +*/ + + +#define GPIO_PIN_MAX 16UL /*!< Specify Maximum Pins of Each GPIO Port \hideinitializer */ + + +/*---------------------------------------------------------------------------------------------------------*/ +/* GPIO_MODE Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define GPIO_MODE_INPUT 0x0UL /*!< Input Mode \hideinitializer */ +#define GPIO_MODE_OUTPUT 0x1UL /*!< Output Mode \hideinitializer */ +#define GPIO_MODE_OPEN_DRAIN 0x2UL /*!< Open-Drain Mode \hideinitializer */ +#define GPIO_MODE_QUASI 0x3UL /*!< Quasi-bidirectional Mode \hideinitializer */ + + +/*---------------------------------------------------------------------------------------------------------*/ +/* GPIO Interrupt Type Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define GPIO_INT_RISING 0x00010000UL /*!< Interrupt enable by Input Rising Edge \hideinitializer */ +#define GPIO_INT_FALLING 0x00000001UL /*!< Interrupt enable by Input Falling Edge \hideinitializer */ +#define GPIO_INT_BOTH_EDGE 0x00010001UL /*!< Interrupt enable by both Rising Edge and Falling Edge \hideinitializer */ +#define GPIO_INT_HIGH 0x01010000UL /*!< Interrupt enable by Level-High \hideinitializer */ +#define GPIO_INT_LOW 0x01000001UL /*!< Interrupt enable by Level-Level \hideinitializer */ + + +/*---------------------------------------------------------------------------------------------------------*/ +/* GPIO_INTTYPE Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define GPIO_INTTYPE_EDGE 0UL /*!< GPIO_INTTYPE Setting for Edge Trigger Mode \hideinitializer */ +#define GPIO_INTTYPE_LEVEL 1UL /*!< GPIO_INTTYPE Setting for Edge Level Mode \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* GPIO Slew Rate Type Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define GPIO_SLEWCTL_NORMAL 0x0UL /*!< GPIO slew setting for normal Mode \hideinitializer */ +#define GPIO_SLEWCTL_HIGH 0x1UL /*!< GPIO slew setting for high Mode \hideinitializer */ +#define GPIO_SLEWCTL_FAST 0x2UL /*!< GPIO slew setting for fast Mode \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* GPIO Pull-up And Pull-down Type Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define GPIO_PUSEL_DISABLE 0x0UL /*!< GPIO PUSEL setting for Disable Mode \hideinitializer */ +#define GPIO_PUSEL_PULL_UP 0x1UL /*!< GPIO PUSEL setting for Pull-up Mode \hideinitializer */ +#define GPIO_PUSEL_PULL_DOWN 0x2UL /*!< GPIO PUSEL setting for Pull-down Mode \hideinitializer */ + + +/*---------------------------------------------------------------------------------------------------------*/ +/* GPIO_DBCTL Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define GPIO_DBCTL_ICLK_ON 0x00000020UL /*!< GPIO_DBCTL setting for all IO pins edge detection circuit is always active after reset \hideinitializer */ +#define GPIO_DBCTL_ICLK_OFF 0x00000000UL /*!< GPIO_DBCTL setting for edge detection circuit is active only if IO pin corresponding GPIOx_IEN bit is set to 1 \hideinitializer */ + +#define GPIO_DBCTL_DBCLKSRC_LIRC 0x00000010UL /*!< GPIO_DBCTL setting for de-bounce counter clock source is the internal 10 kHz \hideinitializer */ +#define GPIO_DBCTL_DBCLKSRC_HCLK 0x00000000UL /*!< GPIO_DBCTL setting for de-bounce counter clock source is the HCLK \hideinitializer */ + +#define GPIO_DBCTL_DBCLKSEL_1 0x00000000UL /*!< GPIO_DBCTL setting for sampling cycle = 1 clocks \hideinitializer */ +#define GPIO_DBCTL_DBCLKSEL_2 0x00000001UL /*!< GPIO_DBCTL setting for sampling cycle = 2 clocks \hideinitializer */ +#define GPIO_DBCTL_DBCLKSEL_4 0x00000002UL /*!< GPIO_DBCTL setting for sampling cycle = 4 clocks \hideinitializer */ +#define GPIO_DBCTL_DBCLKSEL_8 0x00000003UL /*!< GPIO_DBCTL setting for sampling cycle = 8 clocks \hideinitializer */ +#define GPIO_DBCTL_DBCLKSEL_16 0x00000004UL /*!< GPIO_DBCTL setting for sampling cycle = 16 clocks \hideinitializer */ +#define GPIO_DBCTL_DBCLKSEL_32 0x00000005UL /*!< GPIO_DBCTL setting for sampling cycle = 32 clocks \hideinitializer */ +#define GPIO_DBCTL_DBCLKSEL_64 0x00000006UL /*!< GPIO_DBCTL setting for sampling cycle = 64 clocks \hideinitializer */ +#define GPIO_DBCTL_DBCLKSEL_128 0x00000007UL /*!< GPIO_DBCTL setting for sampling cycle = 128 clocks \hideinitializer */ +#define GPIO_DBCTL_DBCLKSEL_256 0x00000008UL /*!< GPIO_DBCTL setting for sampling cycle = 256 clocks \hideinitializer */ +#define GPIO_DBCTL_DBCLKSEL_512 0x00000009UL /*!< GPIO_DBCTL setting for sampling cycle = 512 clocks \hideinitializer */ +#define GPIO_DBCTL_DBCLKSEL_1024 0x0000000AUL /*!< GPIO_DBCTL setting for sampling cycle = 1024 clocks \hideinitializer */ +#define GPIO_DBCTL_DBCLKSEL_2048 0x0000000BUL /*!< GPIO_DBCTL setting for sampling cycle = 2048 clocks \hideinitializer */ +#define GPIO_DBCTL_DBCLKSEL_4096 0x0000000CUL /*!< GPIO_DBCTL setting for sampling cycle = 4096 clocks \hideinitializer */ +#define GPIO_DBCTL_DBCLKSEL_8192 0x0000000DUL /*!< GPIO_DBCTL setting for sampling cycle = 8192 clocks \hideinitializer */ +#define GPIO_DBCTL_DBCLKSEL_16384 0x0000000EUL /*!< GPIO_DBCTL setting for sampling cycle = 16384 clocks \hideinitializer */ +#define GPIO_DBCTL_DBCLKSEL_32768 0x0000000FUL /*!< GPIO_DBCTL setting for sampling cycle = 32768 clocks \hideinitializer */ + + +/* Define GPIO Pin Data Input/Output. It could be used to control each I/O pin by pin address mapping. + Example 1: + + PA0 = 1; + + It is used to set GPIO PA.0 to high; + + Example 2: + + if (PA0) + PA0 = 0; + + If GPIO PA.0 pin status is high, then set GPIO PA.0 data output to low. + */ +#define GPIO_PIN_DATA(port, pin) (*((volatile uint32_t *)((GPIO_PIN_DATA_BASE+(0x40*(port))) + ((pin)<<2)))) /*!< Pin Data Input/Output \hideinitializer */ +#define PA0 GPIO_PIN_DATA(0, 0 ) /*!< Specify PA.0 Pin Data Input/Output \hideinitializer */ +#define PA1 GPIO_PIN_DATA(0, 1 ) /*!< Specify PA.1 Pin Data Input/Output \hideinitializer */ +#define PA2 GPIO_PIN_DATA(0, 2 ) /*!< Specify PA.2 Pin Data Input/Output \hideinitializer */ +#define PA3 GPIO_PIN_DATA(0, 3 ) /*!< Specify PA.3 Pin Data Input/Output \hideinitializer */ +#define PA4 GPIO_PIN_DATA(0, 4 ) /*!< Specify PA.4 Pin Data Input/Output \hideinitializer */ +#define PA5 GPIO_PIN_DATA(0, 5 ) /*!< Specify PA.5 Pin Data Input/Output \hideinitializer */ +#define PA6 GPIO_PIN_DATA(0, 6 ) /*!< Specify PA.6 Pin Data Input/Output \hideinitializer */ +#define PA7 GPIO_PIN_DATA(0, 7 ) /*!< Specify PA.7 Pin Data Input/Output \hideinitializer */ +#define PA8 GPIO_PIN_DATA(0, 8 ) /*!< Specify PA.8 Pin Data Input/Output \hideinitializer */ +#define PA9 GPIO_PIN_DATA(0, 9 ) /*!< Specify PA.9 Pin Data Input/Output \hideinitializer */ +#define PA10 GPIO_PIN_DATA(0, 10) /*!< Specify PA.10 Pin Data Input/Output \hideinitializer */ +#define PA11 GPIO_PIN_DATA(0, 11) /*!< Specify PA.11 Pin Data Input/Output \hideinitializer */ +#define PA12 GPIO_PIN_DATA(0, 12) /*!< Specify PA.12 Pin Data Input/Output \hideinitializer */ +#define PA13 GPIO_PIN_DATA(0, 13) /*!< Specify PA.13 Pin Data Input/Output \hideinitializer */ +#define PA14 GPIO_PIN_DATA(0, 14) /*!< Specify PA.14 Pin Data Input/Output \hideinitializer */ +#define PA15 GPIO_PIN_DATA(0, 15) /*!< Specify PA.15 Pin Data Input/Output \hideinitializer */ +#define PB0 GPIO_PIN_DATA(1, 0 ) /*!< Specify PB.0 Pin Data Input/Output \hideinitializer */ +#define PB1 GPIO_PIN_DATA(1, 1 ) /*!< Specify PB.1 Pin Data Input/Output \hideinitializer */ +#define PB2 GPIO_PIN_DATA(1, 2 ) /*!< Specify PB.2 Pin Data Input/Output \hideinitializer */ +#define PB3 GPIO_PIN_DATA(1, 3 ) /*!< Specify PB.3 Pin Data Input/Output \hideinitializer */ +#define PB4 GPIO_PIN_DATA(1, 4 ) /*!< Specify PB.4 Pin Data Input/Output \hideinitializer */ +#define PB5 GPIO_PIN_DATA(1, 5 ) /*!< Specify PB.5 Pin Data Input/Output \hideinitializer */ +#define PB6 GPIO_PIN_DATA(1, 6 ) /*!< Specify PB.6 Pin Data Input/Output \hideinitializer */ +#define PB7 GPIO_PIN_DATA(1, 7 ) /*!< Specify PB.7 Pin Data Input/Output \hideinitializer */ +#define PB8 GPIO_PIN_DATA(1, 8 ) /*!< Specify PB.8 Pin Data Input/Output \hideinitializer */ +#define PB9 GPIO_PIN_DATA(1, 9 ) /*!< Specify PB.9 Pin Data Input/Output \hideinitializer */ +#define PB10 GPIO_PIN_DATA(1, 10) /*!< Specify PB.10 Pin Data Input/Output \hideinitializer */ +#define PB11 GPIO_PIN_DATA(1, 11) /*!< Specify PB.11 Pin Data Input/Output \hideinitializer */ +#define PB12 GPIO_PIN_DATA(1, 12) /*!< Specify PB.12 Pin Data Input/Output \hideinitializer */ +#define PB13 GPIO_PIN_DATA(1, 13) /*!< Specify PB.13 Pin Data Input/Output \hideinitializer */ +#define PB14 GPIO_PIN_DATA(1, 14) /*!< Specify PB.14 Pin Data Input/Output \hideinitializer */ +#define PB15 GPIO_PIN_DATA(1, 15) /*!< Specify PB.15 Pin Data Input/Output \hideinitializer */ +#define PC0 GPIO_PIN_DATA(2, 0 ) /*!< Specify PC.0 Pin Data Input/Output \hideinitializer */ +#define PC1 GPIO_PIN_DATA(2, 1 ) /*!< Specify PC.1 Pin Data Input/Output \hideinitializer */ +#define PC2 GPIO_PIN_DATA(2, 2 ) /*!< Specify PC.2 Pin Data Input/Output \hideinitializer */ +#define PC3 GPIO_PIN_DATA(2, 3 ) /*!< Specify PC.3 Pin Data Input/Output \hideinitializer */ +#define PC4 GPIO_PIN_DATA(2, 4 ) /*!< Specify PC.4 Pin Data Input/Output \hideinitializer */ +#define PC5 GPIO_PIN_DATA(2, 5 ) /*!< Specify PC.5 Pin Data Input/Output \hideinitializer */ +#define PC6 GPIO_PIN_DATA(2, 6 ) /*!< Specify PC.6 Pin Data Input/Output \hideinitializer */ +#define PC7 GPIO_PIN_DATA(2, 7 ) /*!< Specify PC.7 Pin Data Input/Output \hideinitializer */ +#define PC8 GPIO_PIN_DATA(2, 8 ) /*!< Specify PC.8 Pin Data Input/Output \hideinitializer */ +#define PC9 GPIO_PIN_DATA(2, 9 ) /*!< Specify PC.9 Pin Data Input/Output \hideinitializer */ +#define PC10 GPIO_PIN_DATA(2, 10) /*!< Specify PC.10 Pin Data Input/Output \hideinitializer */ +#define PC11 GPIO_PIN_DATA(2, 11) /*!< Specify PC.11 Pin Data Input/Output \hideinitializer */ +#define PC12 GPIO_PIN_DATA(2, 12) /*!< Specify PC.12 Pin Data Input/Output \hideinitializer */ +#define PC13 GPIO_PIN_DATA(2, 13) /*!< Specify PC.13 Pin Data Input/Output \hideinitializer */ +#define PC14 GPIO_PIN_DATA(2, 14) /*!< Specify PC.14 Pin Data Input/Output \hideinitializer */ +#define PD0 GPIO_PIN_DATA(3, 0 ) /*!< Specify PD.0 Pin Data Input/Output \hideinitializer */ +#define PD1 GPIO_PIN_DATA(3, 1 ) /*!< Specify PD.1 Pin Data Input/Output \hideinitializer */ +#define PD2 GPIO_PIN_DATA(3, 2 ) /*!< Specify PD.2 Pin Data Input/Output \hideinitializer */ +#define PD3 GPIO_PIN_DATA(3, 3 ) /*!< Specify PD.3 Pin Data Input/Output \hideinitializer */ +#define PD4 GPIO_PIN_DATA(3, 4 ) /*!< Specify PD.4 Pin Data Input/Output \hideinitializer */ +#define PD5 GPIO_PIN_DATA(3, 5 ) /*!< Specify PD.5 Pin Data Input/Output \hideinitializer */ +#define PD6 GPIO_PIN_DATA(3, 6 ) /*!< Specify PD.6 Pin Data Input/Output \hideinitializer */ +#define PD7 GPIO_PIN_DATA(3, 7 ) /*!< Specify PD.7 Pin Data Input/Output \hideinitializer */ +#define PD8 GPIO_PIN_DATA(3, 8 ) /*!< Specify PD.8 Pin Data Input/Output \hideinitializer */ +#define PD9 GPIO_PIN_DATA(3, 9 ) /*!< Specify PD.9 Pin Data Input/Output \hideinitializer */ +#define PD10 GPIO_PIN_DATA(3, 10) /*!< Specify PD.10 Pin Data Input/Output \hideinitializer */ +#define PD11 GPIO_PIN_DATA(3, 11) /*!< Specify PD.11 Pin Data Input/Output \hideinitializer */ +#define PD12 GPIO_PIN_DATA(3, 12) /*!< Specify PD.12 Pin Data Input/Output \hideinitializer */ +#define PD13 GPIO_PIN_DATA(3, 13) /*!< Specify PD.13 Pin Data Input/Output \hideinitializer */ +#define PD14 GPIO_PIN_DATA(3, 14) /*!< Specify PD.14 Pin Data Input/Output \hideinitializer */ +#define PE0 GPIO_PIN_DATA(4, 0 ) /*!< Specify PE.0 Pin Data Input/Output \hideinitializer */ +#define PE1 GPIO_PIN_DATA(4, 1 ) /*!< Specify PE.1 Pin Data Input/Output \hideinitializer */ +#define PE2 GPIO_PIN_DATA(4, 2 ) /*!< Specify PE.2 Pin Data Input/Output \hideinitializer */ +#define PE3 GPIO_PIN_DATA(4, 3 ) /*!< Specify PE.3 Pin Data Input/Output \hideinitializer */ +#define PE4 GPIO_PIN_DATA(4, 4 ) /*!< Specify PE.4 Pin Data Input/Output \hideinitializer */ +#define PE5 GPIO_PIN_DATA(4, 5 ) /*!< Specify PE.5 Pin Data Input/Output \hideinitializer */ +#define PE6 GPIO_PIN_DATA(4, 6 ) /*!< Specify PE.6 Pin Data Input/Output \hideinitializer */ +#define PE7 GPIO_PIN_DATA(4, 7 ) /*!< Specify PE.7 Pin Data Input/Output \hideinitializer */ +#define PE8 GPIO_PIN_DATA(4, 8 ) /*!< Specify PE.8 Pin Data Input/Output \hideinitializer */ +#define PE9 GPIO_PIN_DATA(4, 9 ) /*!< Specify PE.9 Pin Data Input/Output \hideinitializer */ +#define PE10 GPIO_PIN_DATA(4, 10) /*!< Specify PE.10 Pin Data Input/Output \hideinitializer */ +#define PE11 GPIO_PIN_DATA(4, 11) /*!< Specify PE.11 Pin Data Input/Output \hideinitializer */ +#define PE12 GPIO_PIN_DATA(4, 12) /*!< Specify PE.12 Pin Data Input/Output \hideinitializer */ +#define PE13 GPIO_PIN_DATA(4, 13) /*!< Specify PE.13 Pin Data Input/Output \hideinitializer */ +#define PE14 GPIO_PIN_DATA(4, 14) /*!< Specify PE.14 Pin Data Input/Output \hideinitializer */ +#define PE15 GPIO_PIN_DATA(4, 15) /*!< Specify PE.15 Pin Data Input/Output \hideinitializer */ +#define PF0 GPIO_PIN_DATA(5, 0 ) /*!< Specify PF.0 Pin Data Input/Output \hideinitializer */ +#define PF1 GPIO_PIN_DATA(5, 1 ) /*!< Specify PF.1 Pin Data Input/Output \hideinitializer */ +#define PF2 GPIO_PIN_DATA(5, 2 ) /*!< Specify PF.2 Pin Data Input/Output \hideinitializer */ +#define PF3 GPIO_PIN_DATA(5, 3 ) /*!< Specify PF.3 Pin Data Input/Output \hideinitializer */ +#define PF4 GPIO_PIN_DATA(5, 4 ) /*!< Specify PF.4 Pin Data Input/Output \hideinitializer */ +#define PF5 GPIO_PIN_DATA(5, 5 ) /*!< Specify PF.5 Pin Data Input/Output \hideinitializer */ +#define PF6 GPIO_PIN_DATA(5, 6 ) /*!< Specify PF.6 Pin Data Input/Output \hideinitializer */ +#define PF7 GPIO_PIN_DATA(5, 7 ) /*!< Specify PF.7 Pin Data Input/Output \hideinitializer */ +#define PF8 GPIO_PIN_DATA(5, 8 ) /*!< Specify PF.8 Pin Data Input/Output \hideinitializer */ +#define PF9 GPIO_PIN_DATA(5, 9 ) /*!< Specify PF.9 Pin Data Input/Output \hideinitializer */ +#define PF10 GPIO_PIN_DATA(5, 10) /*!< Specify PF.10 Pin Data Input/Output \hideinitializer */ +#define PF11 GPIO_PIN_DATA(5, 11) /*!< Specify PF.11 Pin Data Input/Output \hideinitializer */ +#define PG0 GPIO_PIN_DATA(6, 0 ) /*!< Specify PG.0 Pin Data Input/Output \hideinitializer */ +#define PG1 GPIO_PIN_DATA(6, 1 ) /*!< Specify PG.1 Pin Data Input/Output \hideinitializer */ +#define PG2 GPIO_PIN_DATA(6, 2 ) /*!< Specify PG.2 Pin Data Input/Output \hideinitializer */ +#define PG3 GPIO_PIN_DATA(6, 3 ) /*!< Specify PG.3 Pin Data Input/Output \hideinitializer */ +#define PG4 GPIO_PIN_DATA(6, 4 ) /*!< Specify PG.4 Pin Data Input/Output \hideinitializer */ +#define PG5 GPIO_PIN_DATA(6, 5 ) /*!< Specify PG.5 Pin Data Input/Output \hideinitializer */ +#define PG6 GPIO_PIN_DATA(6, 6 ) /*!< Specify PG.6 Pin Data Input/Output \hideinitializer */ +#define PG7 GPIO_PIN_DATA(6, 7 ) /*!< Specify PG.7 Pin Data Input/Output \hideinitializer */ +#define PG8 GPIO_PIN_DATA(6, 8 ) /*!< Specify PG.8 Pin Data Input/Output \hideinitializer */ +#define PG9 GPIO_PIN_DATA(6, 9 ) /*!< Specify PG.9 Pin Data Input/Output \hideinitializer */ +#define PG10 GPIO_PIN_DATA(6, 10) /*!< Specify PG.10 Pin Data Input/Output \hideinitializer */ +#define PG11 GPIO_PIN_DATA(6, 11) /*!< Specify PG.11 Pin Data Input/Output \hideinitializer */ +#define PG12 GPIO_PIN_DATA(6, 12) /*!< Specify PG.12 Pin Data Input/Output \hideinitializer */ +#define PG13 GPIO_PIN_DATA(6, 13) /*!< Specify PG.13 Pin Data Input/Output \hideinitializer */ +#define PG14 GPIO_PIN_DATA(6, 14) /*!< Specify PG.14 Pin Data Input/Output \hideinitializer */ +#define PG15 GPIO_PIN_DATA(6, 15) /*!< Specify PG.15 Pin Data Input/Output \hideinitializer */ +#define PH0 GPIO_PIN_DATA(7, 0 ) /*!< Specify PH.0 Pin Data Input/Output \hideinitializer */ +#define PH1 GPIO_PIN_DATA(7, 1 ) /*!< Specify PH.1 Pin Data Input/Output \hideinitializer */ +#define PH2 GPIO_PIN_DATA(7, 2 ) /*!< Specify PH.2 Pin Data Input/Output \hideinitializer */ +#define PH3 GPIO_PIN_DATA(7, 3 ) /*!< Specify PH.3 Pin Data Input/Output \hideinitializer */ +#define PH4 GPIO_PIN_DATA(7, 4 ) /*!< Specify PH.4 Pin Data Input/Output \hideinitializer */ +#define PH5 GPIO_PIN_DATA(7, 5 ) /*!< Specify PH.5 Pin Data Input/Output \hideinitializer */ +#define PH6 GPIO_PIN_DATA(7, 6 ) /*!< Specify PH.6 Pin Data Input/Output \hideinitializer */ +#define PH7 GPIO_PIN_DATA(7, 7 ) /*!< Specify PH.7 Pin Data Input/Output \hideinitializer */ +#define PH8 GPIO_PIN_DATA(7, 8 ) /*!< Specify PH.8 Pin Data Input/Output \hideinitializer */ +#define PH9 GPIO_PIN_DATA(7, 9 ) /*!< Specify PH.9 Pin Data Input/Output \hideinitializer */ +#define PH10 GPIO_PIN_DATA(7, 10) /*!< Specify PH.10 Pin Data Input/Output \hideinitializer */ +#define PH11 GPIO_PIN_DATA(7, 11) /*!< Specify PH.11 Pin Data Input/Output \hideinitializer */ + + +/*@}*/ /* end of group GPIO_EXPORTED_CONSTANTS */ + + +/** @addtogroup GPIO_EXPORTED_FUNCTIONS GPIO Exported Functions + @{ +*/ + +/** + * @brief Clear GPIO Pin Interrupt Flag + * + * @param[in] port GPIO port. It could be PA, PB, PC, PD, PE, PF, PG or PH. + * @param[in] u32PinMask The single or multiple pins of specified GPIO port. + * It could be BIT0 ~ BIT15 for PA, PB, PC, PD, PF and PH GPIO port. + * It could be BIT0 ~ BIT13 for PE GPIO port. + * It could be BIT0 ~ BIT11 for PG GPIO port. + * + * @return None + * + * @details Clear the interrupt status of specified GPIO pin. + * \hideinitializer + */ +#define GPIO_CLR_INT_FLAG(port, u32PinMask) ((port)->INTSRC = (u32PinMask)) + +/** + * @brief Disable Pin De-bounce Function + * + * @param[in] port GPIO port. It could be PA, PB, PC, PD, PE, PF, PG or PH. + * @param[in] u32PinMask The single or multiple pins of specified GPIO port. + * It could be BIT0 ~ BIT15 for PA, PB, PC, PD, PF and PH GPIO port. + * It could be BIT0 ~ BIT13 for PE GPIO port. + * It could be BIT0 ~ BIT11 for PG GPIO port. + * + * @return None + * + * @details Disable the interrupt de-bounce function of specified GPIO pin. + * \hideinitializer + */ +#define GPIO_DISABLE_DEBOUNCE(port, u32PinMask) ((port)->DBEN &= ~(u32PinMask)) + +/** + * @brief Enable Pin De-bounce Function + * + * @param[in] port GPIO port. It could be PA, PB, PC, PD, PE, PF, PG or PH. + * @param[in] u32PinMask The single or multiple pins of specified GPIO port. + * It could be BIT0 ~ BIT15 for PA, PB, PC, PD, PF and PH GPIO port. + * It could be BIT0 ~ BIT13 for PE GPIO port. + * It could be BIT0 ~ BIT11 for PG GPIO port. + * @return None + * + * @details Enable the interrupt de-bounce function of specified GPIO pin. + * \hideinitializer + */ +#define GPIO_ENABLE_DEBOUNCE(port, u32PinMask) ((port)->DBEN |= (u32PinMask)) + +/** + * @brief Disable I/O Digital Input Path + * + * @param[in] port GPIO port. It could be PA, PB, PC, PD, PE, PF, PG or PH. + * @param[in] u32PinMask The single or multiple pins of specified GPIO port. + * It could be BIT0 ~ BIT15 for PA, PB, PC, PD, PF and PH GPIO port. + * It could be BIT0 ~ BIT13 for PE GPIO port. + * It could be BIT0 ~ BIT11 for PG GPIO port. + * + * @return None + * + * @details Disable I/O digital input path of specified GPIO pin. + * \hideinitializer + */ +#define GPIO_DISABLE_DIGITAL_PATH(port, u32PinMask) ((port)->DINOFF |= ((u32PinMask)<<16)) + +/** + * @brief Enable I/O Digital Input Path + * + * @param[in] port GPIO port. It could be PA, PB, PC, PD, PE, PF, PG or PH. + * @param[in] u32PinMask The single or multiple pins of specified GPIO port. + * It could be BIT0 ~ BIT15 for PA, PB, PC, PD, PF and PH GPIO port. + * It could be BIT0 ~ BIT13 for PE GPIO port. + * It could be BIT0 ~ BIT11 for PG GPIO port. + * + * @return None + * + * @details Enable I/O digital input path of specified GPIO pin. + * \hideinitializer + */ +#define GPIO_ENABLE_DIGITAL_PATH(port, u32PinMask) ((port)->DINOFF &= ~((u32PinMask)<<16)) + +/** + * @brief Disable I/O DOUT mask + * + * @param[in] port GPIO port. It could be PA, PB, PC, PD, PE, PF, PG or PH. + * @param[in] u32PinMask The single or multiple pins of specified GPIO port. + * It could be BIT0 ~ BIT15 for PA, PB, PC, PD, PF and PH GPIO port. + * It could be BIT0 ~ BIT13 for PE GPIO port. + * It could be BIT0 ~ BIT11 for PG GPIO port. + * + * @return None + * + * @details Disable I/O DOUT mask of specified GPIO pin. + * \hideinitializer + */ +#define GPIO_DISABLE_DOUT_MASK(port, u32PinMask) ((port)->DATMSK &= ~(u32PinMask)) + +/** + * @brief Enable I/O DOUT mask + * + * @param[in] port GPIO port. It could be PA, PB, PC, PD, PE, PF, PG or PH. + * @param[in] u32PinMask The single or multiple pins of specified GPIO port. + * It could be BIT0 ~ BIT15 for PA, PB, PC, PD, PF and PH GPIO port. + * It could be BIT0 ~ BIT13 for PE GPIO port. + * It could be BIT0 ~ BIT11 for PG GPIO port. + * + * @return None + * + * @details Enable I/O DOUT mask of specified GPIO pin. + * \hideinitializer + */ +#define GPIO_ENABLE_DOUT_MASK(port, u32PinMask) ((port)->DATMSK |= (u32PinMask)) + +/** + * @brief Get GPIO Pin Interrupt Flag + * + * @param[in] port GPIO port. It could be PA, PB, PC, PD, PE, PF, PG or PH. + * @param[in] u32PinMask The single or multiple pins of specified GPIO port. + * It could be BIT0 ~ BIT15 for PA, PB, PC, PD, PF and PH GPIO port. + * It could be BIT0 ~ BIT13 for PE GPIO port. + * It could be BIT0 ~ BIT11 for PG GPIO port. + * + * @retval 0 No interrupt at specified GPIO pin + * @retval 1 The specified GPIO pin generate an interrupt + * + * @details Get the interrupt status of specified GPIO pin. + * \hideinitializer + */ +#define GPIO_GET_INT_FLAG(port, u32PinMask) ((port)->INTSRC & (u32PinMask)) + +/** + * @brief Set De-bounce Sampling Cycle Time + * + * @param[in] u32ClkSrc The de-bounce counter clock source. It could be GPIO_DBCTL_DBCLKSRC_HCLK or GPIO_DBCTL_DBCLKSRC_LIRC. + * @param[in] u32ClkSel The de-bounce sampling cycle selection. It could be + * - \ref GPIO_DBCTL_DBCLKSEL_1 + * - \ref GPIO_DBCTL_DBCLKSEL_2 + * - \ref GPIO_DBCTL_DBCLKSEL_4 + * - \ref GPIO_DBCTL_DBCLKSEL_8 + * - \ref GPIO_DBCTL_DBCLKSEL_16 + * - \ref GPIO_DBCTL_DBCLKSEL_32 + * - \ref GPIO_DBCTL_DBCLKSEL_64 + * - \ref GPIO_DBCTL_DBCLKSEL_128 + * - \ref GPIO_DBCTL_DBCLKSEL_256 + * - \ref GPIO_DBCTL_DBCLKSEL_512 + * - \ref GPIO_DBCTL_DBCLKSEL_1024 + * - \ref GPIO_DBCTL_DBCLKSEL_2048 + * - \ref GPIO_DBCTL_DBCLKSEL_4096 + * - \ref GPIO_DBCTL_DBCLKSEL_8192 + * - \ref GPIO_DBCTL_DBCLKSEL_16384 + * - \ref GPIO_DBCTL_DBCLKSEL_32768 + * + * @return None + * + * @details Set the interrupt de-bounce sampling cycle time based on the debounce counter clock source. \n + * Example: _GPIO_SET_DEBOUNCE_TIME(GPIO_DBCTL_DBCLKSRC_LIRC, GPIO_DBCTL_DBCLKSEL_4). \n + * It's meaning the De-debounce counter clock source is internal 10 KHz and sampling cycle selection is 4. \n + * Then the target de-bounce sampling cycle time is (4)*(1/(10*1000)) s = 4*0.0001 s = 400 us, + * and system will sampling interrupt input once per 00 us. + * \hideinitializer + */ +#define GPIO_SET_DEBOUNCE_TIME(u32ClkSrc, u32ClkSel) (GPIO->DBCTL = (GPIO_DBCTL_ICLKON_Msk | (u32ClkSrc) | (u32ClkSel))) + +/** + * @brief Get GPIO Port IN Data + * +* @param[in] port GPIO port. It could be PA, PB, PC, PD, PE, PF, PG or PH. + * + * @return The specified port data + * + * @details Get the PIN register of specified GPIO port. + * \hideinitializer + */ +#define GPIO_GET_IN_DATA(port) ((port)->PIN) + +/** + * @brief Set GPIO Port OUT Data + * + * @param[in] port GPIO port. It could be PA, PB, PC, PD, PE, PF, PG or PH. + * @param[in] u32Data GPIO port data. + * + * @return None + * + * @details Set the Data into specified GPIO port. + * \hideinitializer + */ +#define GPIO_SET_OUT_DATA(port, u32Data) ((port)->DOUT = (u32Data)) + +/** + * @brief Toggle Specified GPIO pin + * + * @param[in] u32Pin Pxy + * + * @return None + * + * @details Toggle the specified GPIO pint. + * \hideinitializer + */ +#define GPIO_TOGGLE(u32Pin) ((u32Pin) ^= 1) + + +/** + * @brief Enable External GPIO interrupt + * + * @param[in] port GPIO port. It could be PA, PB, PC, PD, PE, PF, PG or PH. + * @param[in] u32Pin The pin of specified GPIO port. + * It could be 0 ~ 15 for PA, PB, PC, PD, PF and PH GPIO port. + * It could be 0 ~ 13 for PE GPIO port. + * It could be 0 ~ 11 for PG GPIO port. + * @param[in] u32IntAttribs The interrupt attribute of specified GPIO pin. It could be \n + * GPIO_INT_RISING, GPIO_INT_FALLING, GPIO_INT_BOTH_EDGE, GPIO_INT_HIGH, GPIO_INT_LOW. + * + * @return None + * + * @details This function is used to enable specified GPIO pin interrupt. + * \hideinitializer + */ +#define GPIO_EnableEINT GPIO_EnableInt + +/** + * @brief Disable External GPIO interrupt + * + * @param[in] port GPIO port. It could be PA, PB, PC, PD, PE, PF, PG or PH. + * @param[in] u32Pin The pin of specified GPIO port. + * It could be 0 ~ 15 for PA, PB, PC, PD, PF and PH GPIO port. + * It could be 0 ~ 13 for PE GPIO port. + * It could be 0 ~ 11 for PG GPIO port. + * + * @return None + * + * @details This function is used to enable specified GPIO pin interrupt. + * \hideinitializer + */ +#define GPIO_DisableEINT GPIO_DisableInt + + +void GPIO_SetMode(GPIO_T *port, uint32_t u32PinMask, uint32_t u32Mode); +void GPIO_EnableInt(GPIO_T *port, uint32_t u32Pin, uint32_t u32IntAttribs); +void GPIO_DisableInt(GPIO_T *port, uint32_t u32Pin); +void GPIO_SetSlewCtl(GPIO_T *port, uint32_t u32PinMask, uint32_t u32Mode); +void GPIO_SetPullCtl(GPIO_T *port, uint32_t u32PinMask, uint32_t u32Mode); + + +/*@}*/ /* end of group GPIO_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group GPIO_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_GPIO_H__ */ + +/*** (C) COPYRIGHT 2013~2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_hsotg.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_hsotg.h new file mode 100644 index 00000000000..b561f226748 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_hsotg.h @@ -0,0 +1,268 @@ +/**************************************************************************//** + * @file nu_hsotg.h + * @version V0.10 + * @brief M480 Series HSOTG Driver Header File + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + ******************************************************************************/ +#ifndef __NU_HSOTG_H__ +#define __NU_HSOTG_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup HSOTG_Driver HSOTG Driver + @{ +*/ + + +/** @addtogroup HSOTG_EXPORTED_CONSTANTS HSOTG Exported Constants + @{ +*/ + + + +/*---------------------------------------------------------------------------------------------------------*/ +/* HSOTG constant definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define HSOTG_VBUS_EN_ACTIVE_HIGH (0UL) /*!< USB VBUS power switch enable signal is active high. \hideinitializer */ +#define HSOTG_VBUS_EN_ACTIVE_LOW (1UL) /*!< USB VBUS power switch enable signal is active low. \hideinitializer */ +#define HSOTG_VBUS_ST_VALID_HIGH (0UL) /*!< USB VBUS power switch valid status is high. \hideinitializer */ +#define HSOTG_VBUS_ST_VALID_LOW (1UL) /*!< USB VBUS power switch valid status is low. \hideinitializer */ + + +/*@}*/ /* end of group HSOTG_EXPORTED_CONSTANTS */ + + +/** @addtogroup HSOTG_EXPORTED_FUNCTIONS HSOTG Exported Functions + @{ +*/ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Define Macros and functions */ +/*---------------------------------------------------------------------------------------------------------*/ + + +/** + * @brief This macro is used to enable HSOTG function + * @param None + * @return None + * @details This macro will set OTGEN bit of HSOTG_CTL register to enable HSOTG function. + * \hideinitializer + */ +#define HSOTG_ENABLE() (HSOTG->CTL |= HSOTG_CTL_OTGEN_Msk) + +/** + * @brief This macro is used to disable HSOTG function + * @param None + * @return None + * @details This macro will clear OTGEN bit of HSOTG_CTL register to disable HSOTG function. + * \hideinitializer + */ +#define HSOTG_DISABLE() (HSOTG->CTL &= ~HSOTG_CTL_OTGEN_Msk) + +/** + * @brief This macro is used to enable USB PHY + * @param None + * @return None + * @details When the USB role is selected as HSOTG device, use this macro to enable USB PHY. + * This macro will set OTGPHYEN bit of HSOTG_PHYCTL register to enable USB PHY. + * \hideinitializer + */ +#define HSOTG_ENABLE_PHY() (HSOTG->PHYCTL |= HSOTG_PHYCTL_OTGPHYEN_Msk) + +/** + * @brief This macro is used to disable USB PHY + * @param None + * @return None + * @details This macro will clear OTGPHYEN bit of HSOTG_PHYCTL register to disable USB PHY. + * \hideinitializer + */ +#define HSOTG_DISABLE_PHY() (HSOTG->PHYCTL &= ~HSOTG_PHYCTL_OTGPHYEN_Msk) + +/** + * @brief This macro is used to enable ID detection function + * @param None + * @return None + * @details This macro will set IDDETEN bit of HSOTG_PHYCTL register to enable ID detection function. + * \hideinitializer + */ +#define HSOTG_ENABLE_ID_DETECT() (HSOTG->PHYCTL |= HSOTG_PHYCTL_IDDETEN_Msk) + +/** + * @brief This macro is used to disable ID detection function + * @param None + * @return None + * @details This macro will clear IDDETEN bit of HSOTG_PHYCTL register to disable ID detection function. + * \hideinitializer + */ +#define HSOTG_DISABLE_ID_DETECT() (HSOTG->PHYCTL &= ~HSOTG_PHYCTL_IDDETEN_Msk) + +/** + * @brief This macro is used to enable HSOTG wake-up function + * @param None + * @return None + * @details This macro will set WKEN bit of HSOTG_CTL register to enable HSOTG wake-up function. + * \hideinitializer + */ +#define HSOTG_ENABLE_WAKEUP() (HSOTG->CTL |= HSOTG_CTL_WKEN_Msk) + +/** + * @brief This macro is used to disable HSOTG wake-up function + * @param None + * @return None + * @details This macro will clear WKEN bit of HSOTG_CTL register to disable HSOTG wake-up function. + * \hideinitializer + */ +#define HSOTG_DISABLE_WAKEUP() (HSOTG->CTL &= ~HSOTG_CTL_WKEN_Msk) + +/** + * @brief This macro is used to set the polarity of USB_VBUS_EN pin + * @param[in] u32Pol The polarity selection. Valid values are listed below. + * - \ref HSOTG_VBUS_EN_ACTIVE_HIGH + * - \ref HSOTG_VBUS_EN_ACTIVE_LOW + * @return None + * @details This macro is used to set the polarity of external USB VBUS power switch enable signal. + * \hideinitializer + */ +#define HSOTG_SET_VBUS_EN_POL(u32Pol) (HSOTG->PHYCTL = (HSOTG->PHYCTL & (~HSOTG_PHYCTL_VBENPOL_Msk)) | ((u32Pol)<PHYCTL = (HSOTG->PHYCTL & (~HSOTG_PHYCTL_VBSTSPOL_Msk)) | ((u32Pol)<INTEN |= (u32Mask)) + +/** + * @brief This macro is used to disable HSOTG related interrupts + * @param[in] u32Mask The combination of interrupt source. Each bit corresponds to a interrupt source. Valid values are listed below. + * - \ref HSOTG_INTEN_ROLECHGIEN_Msk + * - \ref HSOTG_INTEN_VBEIEN_Msk + * - \ref HSOTG_INTEN_SRPFIEN_Msk + * - \ref HSOTG_INTEN_HNPFIEN_Msk + * - \ref HSOTG_INTEN_GOIDLEIEN_Msk + * - \ref HSOTG_INTEN_IDCHGIEN_Msk + * - \ref HSOTG_INTEN_PDEVIEN_Msk + * - \ref HSOTG_INTEN_HOSTIEN_Msk + * - \ref HSOTG_INTEN_BVLDCHGIEN_Msk + * - \ref HSOTG_INTEN_AVLDCHGIEN_Msk + * - \ref HSOTG_INTEN_VBCHGIEN_Msk + * - \ref HSOTG_INTEN_SECHGIEN_Msk + * - \ref HSOTG_INTEN_SRPDETIEN_Msk + * @return None + * @details This macro will disable HSOTG related interrupts specified by u32Mask parameter. + * \hideinitializer + */ +#define HSOTG_DISABLE_INT(u32Mask) (HSOTG->INTEN &= ~(u32Mask)) + +/** + * @brief This macro is used to get HSOTG related interrupt flags + * @param[in] u32Mask The combination of interrupt source. Each bit corresponds to a interrupt source. Valid values are listed below. + * - \ref HSOTG_INTSTS_ROLECHGIF_Msk + * - \ref HSOTG_INTSTS_VBEIF_Msk + * - \ref HSOTG_INTSTS_SRPFIF_Msk + * - \ref HSOTG_INTSTS_HNPFIF_Msk + * - \ref HSOTG_INTSTS_GOIDLEIF_Msk + * - \ref HSOTG_INTSTS_IDCHGIF_Msk + * - \ref HSOTG_INTSTS_PDEVIF_Msk + * - \ref HSOTG_INTSTS_HOSTIF_Msk + * - \ref HSOTG_INTSTS_BVLDCHGIF_Msk + * - \ref HSOTG_INTSTS_AVLDCHGIF_Msk + * - \ref HSOTG_INTSTS_VBCHGIF_Msk + * - \ref HSOTG_INTSTS_SECHGIF_Msk + * - \ref HSOTG_INTSTS_SRPDETIF_Msk + * @return Interrupt flags of selected sources. + * @details This macro will return HSOTG related interrupt flags specified by u32Mask parameter. + * \hideinitializer + */ +#define HSOTG_GET_INT_FLAG(u32Mask) (HSOTG->INTSTS & (u32Mask)) + +/** + * @brief This macro is used to clear HSOTG related interrupt flags + * @param[in] u32Mask The combination of interrupt source. Each bit corresponds to a interrupt source. Valid values are listed below. + * - \ref HSOTG_INTSTS_ROLECHGIF_Msk + * - \ref HSOTG_INTSTS_VBEIF_Msk + * - \ref HSOTG_INTSTS_SRPFIF_Msk + * - \ref HSOTG_INTSTS_HNPFIF_Msk + * - \ref HSOTG_INTSTS_GOIDLEIF_Msk + * - \ref HSOTG_INTSTS_IDCHGIF_Msk + * - \ref HSOTG_INTSTS_PDEVIF_Msk + * - \ref HSOTG_INTSTS_HOSTIF_Msk + * - \ref HSOTG_INTSTS_BVLDCHGIF_Msk + * - \ref HSOTG_INTSTS_AVLDCHGIF_Msk + * - \ref HSOTG_INTSTS_VBCHGIF_Msk + * - \ref HSOTG_INTSTS_SECHGIF_Msk + * - \ref HSOTG_INTSTS_SRPDETIF_Msk + * @return None + * @details This macro will clear HSOTG related interrupt flags specified by u32Mask parameter. + * \hideinitializer + */ +#define HSOTG_CLR_INT_FLAG(u32Mask) (HSOTG->INTSTS = (u32Mask)) + +/** + * @brief This macro is used to get HSOTG related status + * @param[in] u32Mask The combination of user specified source. Valid values are listed below. + * - \ref HSOTG_STATUS_OVERCUR_Msk + * - \ref HSOTG_STATUS_IDSTS_Msk + * - \ref HSOTG_STATUS_SESSEND_Msk + * - \ref HSOTG_STATUS_BVLD_Msk + * - \ref HSOTG_STATUS_AVLD_Msk + * - \ref HSOTG_STATUS_VBUSVLD_Msk + * @return The user specified status. + * @details This macro will return HSOTG related status specified by u32Mask parameter. + * \hideinitializer + */ +#define HSOTG_GET_STATUS(u32Mask) (HSOTG->STATUS & (u32Mask)) + + + +/*@}*/ /* end of group HSOTG_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group HSOTG_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + + +#ifdef __cplusplus +} +#endif + + +#endif /* __NU_HSOTG_H__ */ + +/*** (C) COPYRIGHT 2017 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_hsusbd.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_hsusbd.h new file mode 100644 index 00000000000..3fcebb1b2da --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_hsusbd.h @@ -0,0 +1,382 @@ +/**************************************************************************//** + * @file nu_hsusbd.h + * @version V1.00 + * @brief M480 HSUSBD driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __NU_HSUSBD_H__ +#define __NU_HSUSBD_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup HSUSBD_Driver HSUSBD Driver + @{ +*/ + +/** @addtogroup HSUSBD_EXPORTED_CONSTANTS HSUSBD Exported Constants + @{ +*/ +/** @cond HIDDEN_SYMBOLS */ +#define HSUSBD_MAX_EP 12ul + +#define Maximum(a,b) (a)>(b) ? (a) : (b) +#define Minimum(a,b) (((a)<(b)) ? (a) : (b)) + + +#define CEP 0xfful /*!< Control Endpoint \hideinitializer */ +#define EPA 0ul /*!< Endpoint A \hideinitializer */ +#define EPB 1ul /*!< Endpoint B \hideinitializer */ +#define EPC 2ul /*!< Endpoint C \hideinitializer */ +#define EPD 3ul /*!< Endpoint D \hideinitializer */ +#define EPE 4ul /*!< Endpoint E \hideinitializer */ +#define EPF 5ul /*!< Endpoint F \hideinitializer */ +#define EPG 6ul /*!< Endpoint G \hideinitializer */ +#define EPH 7ul /*!< Endpoint H \hideinitializer */ +#define EPI 8ul /*!< Endpoint I \hideinitializer */ +#define EPJ 9ul /*!< Endpoint J \hideinitializer */ +#define EPK 10ul /*!< Endpoint K \hideinitializer */ +#define EPL 11ul /*!< Endpoint L \hideinitializer */ + +/** @endcond HIDDEN_SYMBOLS */ +/********************* Bit definition of CEPCTL register **********************/ +#define HSUSBD_CEPCTL_NAKCLR ((uint32_t)0x00000000ul) /*!PHYCTL |= (HSUSBD_PHYCTL_PHYEN_Msk|HSUSBD_PHYCTL_DPPUEN_Msk))) /*!PHYCTL &= ~HSUSBD_PHYCTL_DPPUEN_Msk)) /*!PHYCTL |= HSUSBD_PHYCTL_PHYEN_Msk)) /*!PHYCTL &= ~HSUSBD_PHYCTL_PHYEN_Msk)) /*!PHYCTL &= ~HSUSBD_PHYCTL_DPPUEN_Msk)) /*!PHYCTL |= HSUSBD_PHYCTL_DPPUEN_Msk)) /*!FADDR = (addr)) /*!FADDR)) /*!GINTEN = (intr)) /*!BUSINTEN = (intr)) /*!BUSINTSTS) /*!BUSINTSTS = (flag)) /*!CEPINTEN = (intr)) /*!CEPINTSTS = (flag)) /*!CEPCTL = (flag)) /*!CEPTXCNT = (size)) /*!EP[(ep)].EPMPS = (size)) /*!EP[(ep)].EPINTEN = (intr)) /*!EP[(ep)].EPINTSTS) /*!EP[(ep)].EPINTSTS = (flag)) /*!DMACNT = (len)) /*!DMAADDR = (addr)) /*!DMACTL = (HSUSBD->DMACTL & ~HSUSBD_DMACTL_EPNUM_Msk) | HSUSBD_DMACTL_DMARD_Msk | (epnum) | 0x100) /*!DMACTL = (HSUSBD->DMACTL & ~(HSUSBD_DMACTL_EPNUM_Msk | HSUSBD_DMACTL_DMARD_Msk | 0x100)) | (epnum)) /*!DMACTL |= HSUSBD_DMACTL_DMAEN_Msk) /*!PHYCTL & HSUSBD_PHYCTL_VBUSDET_Msk)) /*!DMACNT = 0ul; + HSUSBD->DMACTL = 0x80ul; + HSUSBD->DMACTL = 0x00ul; +} +/** + * @brief HSUSBD_SetEpBufAddr, Set Endpoint buffer address + * @param[in] u32Ep Endpoint Number + * @param[in] u32Base Buffer Start Address + * @param[in] u32Len Buffer length + * @retval None. + */ +__STATIC_INLINE void HSUSBD_SetEpBufAddr(uint32_t u32Ep, uint32_t u32Base, uint32_t u32Len) +{ + if (u32Ep == CEP) + { + HSUSBD->CEPBUFST = u32Base; + HSUSBD->CEPBUFEND = u32Base + u32Len - 1ul; + } + else + { + HSUSBD->EP[u32Ep].EPBUFST = u32Base; + HSUSBD->EP[u32Ep].EPBUFEND = u32Base + u32Len - 1ul; + } +} + +/** + * @brief HSUSBD_ConfigEp, Config Endpoint + * @param[in] u32Ep USB endpoint + * @param[in] u32EpNum Endpoint number + * @param[in] u32EpType Endpoint type + * @param[in] u32EpDir Endpoint direction + * @retval None. + */ +__STATIC_INLINE void HSUSBD_ConfigEp(uint32_t u32Ep, uint32_t u32EpNum, uint32_t u32EpType, uint32_t u32EpDir) +{ + if (u32EpType == HSUSBD_EP_CFG_TYPE_BULK) + { + HSUSBD->EP[u32Ep].EPRSPCTL = (HSUSBD_EP_RSPCTL_FLUSH|HSUSBD_EP_RSPCTL_MODE_AUTO); + } + else if (u32EpType == HSUSBD_EP_CFG_TYPE_INT) + { + HSUSBD->EP[u32Ep].EPRSPCTL = (HSUSBD_EP_RSPCTL_FLUSH|HSUSBD_EP_RSPCTL_MODE_MANUAL); + } + else if (u32EpType == HSUSBD_EP_CFG_TYPE_ISO) + { + HSUSBD->EP[u32Ep].EPRSPCTL = (HSUSBD_EP_RSPCTL_FLUSH|HSUSBD_EP_RSPCTL_MODE_FLY); + } + + HSUSBD->EP[u32Ep].EPCFG = (u32EpType|u32EpDir|HSUSBD_EP_CFG_VALID|(u32EpNum << 4)); +} + +/** + * @brief Set USB endpoint stall state + * @param[in] u32Ep The USB endpoint ID. + * @return None + * @details Set USB endpoint stall state for the specified endpoint ID. Endpoint will respond STALL token automatically. + */ +__STATIC_INLINE void HSUSBD_SetEpStall(uint32_t u32Ep) +{ + if (u32Ep == CEP) + { + HSUSBD_SET_CEP_STATE(HSUSBD_CEPCTL_STALL); + } + else + { + HSUSBD->EP[u32Ep].EPRSPCTL = (HSUSBD->EP[u32Ep].EPRSPCTL & 0xf7ul) | HSUSBD_EP_RSPCTL_HALT; + } +} + +/** + * @brief Set USB endpoint stall state + * + * @param[in] u32EpNum USB endpoint + * @return None + * + * @details Set USB endpoint stall state, endpoint will return STALL token. + */ +__STATIC_INLINE void HSUSBD_SetStall(uint32_t u32EpNum) +{ + uint32_t i; + + if (u32EpNum == 0ul) + { + HSUSBD_SET_CEP_STATE(HSUSBD_CEPCTL_STALL); + } + else + { + for (i=0ul; iEP[i].EPCFG & 0xf0ul) >> 4) == u32EpNum) + { + HSUSBD->EP[i].EPRSPCTL = (HSUSBD->EP[i].EPRSPCTL & 0xf7ul) | HSUSBD_EP_RSPCTL_HALT; + } + } + } +} + +/** + * @brief Clear USB endpoint stall state + * @param[in] u32Ep The USB endpoint ID. + * @return None + * @details Clear USB endpoint stall state for the specified endpoint ID. Endpoint will respond ACK/NAK token. + */ +__STATIC_INLINE void HSUSBD_ClearEpStall(uint32_t u32Ep) +{ + HSUSBD->EP[u32Ep].EPRSPCTL = HSUSBD_EP_RSPCTL_TOGGLE; +} + +/** + * @brief Clear USB endpoint stall state + * + * @param[in] u32EpNum USB endpoint + * @return None + * + * @details Clear USB endpoint stall state, endpoint will return ACK/NAK token. + */ +__STATIC_INLINE void HSUSBD_ClearStall(uint32_t u32EpNum) +{ + uint32_t i; + + for (i=0ul; iEP[i].EPCFG & 0xf0ul) >> 4) == u32EpNum) + { + HSUSBD->EP[i].EPRSPCTL = HSUSBD_EP_RSPCTL_TOGGLE; + } + } +} + +/** + * @brief Get USB endpoint stall state + * @param[in] u32Ep The USB endpoint ID. + * @retval 0 USB endpoint is not stalled. + * @retval Others USB endpoint is stalled. + * @details Get USB endpoint stall state of the specified endpoint ID. + */ +__STATIC_INLINE uint32_t HSUSBD_GetEpStall(uint32_t u32Ep) +{ + return (HSUSBD->EP[u32Ep].EPRSPCTL & HSUSBD_EP_RSPCTL_HALT); +} + +/** + * @brief Get USB endpoint stall state + * + * @param[in] u32EpNum USB endpoint + * @retval 0: USB endpoint is not stalled. + * @retval non-0: USB endpoint is stalled. + * + * @details Get USB endpoint stall state. + */ +__STATIC_INLINE uint32_t HSUSBD_GetStall(uint32_t u32EpNum) +{ + uint32_t i; + uint32_t val = 0ul; + + for (i=0ul; iEP[i].EPCFG & 0xf0ul) >> 4) == u32EpNum) + { + val = (HSUSBD->EP[i].EPRSPCTL & HSUSBD_EP_RSPCTL_HALT); + break; + } + } + return val; +} + + +/*-------------------------------------------------------------------------------------------*/ +typedef void (*HSUSBD_VENDOR_REQ)(void); /*!CTL0 = ((i2c)->CTL0 & ~0x3c) | (u8Ctrl)) + +/** + * @brief The macro is used to set START condition of I2C Bus + * + * @param[in] i2c Specify I2C port + * + * @return None + * + * @details Set the I2C bus START condition in I2C_CTL register. + * \hideinitializer + */ +#define I2C_START(i2c) ((i2c)->CTL0 = ((i2c)->CTL0 & ~I2C_CTL0_SI_Msk) | I2C_CTL0_STA_Msk) + +/** + * @brief The macro is used to wait I2C bus status get ready + * + * @param[in] i2c Specify I2C port + * + * @return None + * + * @details When a new status is presented of I2C bus, the SI flag will be set in I2C_CTL register. + * \hideinitializer + */ +#define I2C_WAIT_READY(i2c) while(!((i2c)->CTL0 & I2C_CTL0_SI_Msk)) + +/** + * @brief The macro is used to Read I2C Bus Data Register + * + * @param[in] i2c Specify I2C port + * + * @return A byte of I2C data register + * + * @details I2C controller read data from bus and save it in I2CDAT register. + * \hideinitializer + */ +#define I2C_GET_DATA(i2c) ((i2c)->DAT) + +/** + * @brief Write a Data to I2C Data Register + * + * @param[in] i2c Specify I2C port + * @param[in] u8Data A byte that writes to data register + * + * @return None + * + * @details When write a data to I2C_DAT register, the I2C controller will shift it to I2C bus. + * \hideinitializer + */ +#define I2C_SET_DATA(i2c, u8Data) ((i2c)->DAT = (u8Data)) + +/** + * @brief Get I2C Bus status code + * + * @param[in] i2c Specify I2C port + * + * @return I2C status code + * + * @details To get this status code to monitor I2C bus event. + * \hideinitializer + */ +#define I2C_GET_STATUS(i2c) ((i2c)->STATUS0) + +/** + * @brief Get Time-out flag from I2C Bus + * + * @param[in] i2c Specify I2C port + * + * @retval 0 I2C Bus time-out is not happened + * @retval 1 I2C Bus time-out is happened + * + * @details When I2C bus occurs time-out event, the time-out flag will be set. + * \hideinitializer + */ +#define I2C_GET_TIMEOUT_FLAG(i2c) ( ((i2c)->TOCTL & I2C_TOCTL_TOIF_Msk) == I2C_TOCTL_TOIF_Msk ? 1:0 ) + +/** + * @brief To get wake-up flag from I2C Bus + * + * @param[in] i2c Specify I2C port + * + * @retval 0 Chip is not woken-up from power-down mode + * @retval 1 Chip is woken-up from power-down mode + * + * @details I2C bus occurs wake-up event, wake-up flag will be set. + * \hideinitializer + */ +#define I2C_GET_WAKEUP_FLAG(i2c) ( ((i2c)->WKSTS & I2C_WKSTS_WKIF_Msk) == I2C_WKSTS_WKIF_Msk ? 1:0 ) + +/** + * @brief To clear wake-up flag + * + * @param[in] i2c Specify I2C port + * + * @return None + * + * @details If wake-up flag is set, use this macro to clear it. + * \hideinitializer + */ +#define I2C_CLEAR_WAKEUP_FLAG(i2c) ((i2c)->WKSTS = I2C_WKSTS_WKIF_Msk) + +/** + * @brief To get SMBus Status + * + * @param[in] i2c Specify I2C port + * + * @return SMBus status + * + * @details To get the Bus Management status of I2C_BUSSTS register + * \hideinitializer + * + */ +#define I2C_SMBUS_GET_STATUS(i2c) ((i2c)->BUSSTS) + +/** + * @brief Get SMBus CRC value + * + * @param[in] i2c Specify I2C port + * + * @return Packet error check byte value + * + * @details The CRC check value after a transmission or a reception by count by using CRC8 + * \hideinitializer + */ +#define I2C_SMBUS_GET_PEC_VALUE(i2c) ((i2c)->PKTCRC) + +/** + * @brief Set SMBus Bytes number of Transmission or reception + * + * @param[in] i2c Specify I2C port + * @param[in] u32PktSize Transmit / Receive bytes + * + * @return None + * + * @details The transmission or receive byte number in one transaction when PECEN is set. The maximum is 255 bytes. + * \hideinitializer + */ +#define I2C_SMBUS_SET_PACKET_BYTE_COUNT(i2c, u32PktSize) ((i2c)->PKTSIZE = (u32PktSize)) + +/** + * @brief Enable SMBus Alert function + * + * @param[in] i2c Specify I2C port + * + * @return None + * + * @details Device Mode(BMHEN=0): If ALERTEN(I2C_BUSCTL[4]) is set, the Alert pin will pull lo, and reply ACK when get ARP from host + * Host Mode(BMHEN=1): If ALERTEN(I2C_BUSCTL[4]) is set, the Alert pin is supported to receive alert state(Lo trigger) + * \hideinitializer + */ +#define I2C_SMBUS_ENABLE_ALERT(i2c) ((i2c)->BUSCTL |= I2C_BUSCTL_ALERTEN_Msk) + +/** + * @brief Disable SMBus Alert pin function + * + * @param[in] i2c Specify I2C port + * + * @return None + * + * @details Device Mode(BMHEN=0): If ALERTEN(I2C_BUSCTL[4]) is clear, the Alert pin will pull hi, and reply NACK when get ARP from host + * Host Mode(BMHEN=1): If ALERTEN(I2C_BUSCTL[4]) is clear, the Alert pin is not supported to receive alert state(Lo trigger) + * \hideinitializer + */ +#define I2C_SMBUS_DISABLE_ALERT(i2c) ((i2c)->BUSCTL &= ~I2C_BUSCTL_ALERTEN_Msk) + +/** + * @brief Set SMBus SUSCON pin is output mode + * + * @param[in] i2c Specify I2C port + * + * @return None + * + * @details This function to set SUSCON(I2C_BUSCTL[6]) pin is output mode. + * + * \hideinitializer + */ +#define I2C_SMBUS_SET_SUSCON_OUT(i2c) ((i2c)->BUSCTL |= I2C_BUSCTL_SCTLOEN_Msk) + +/** + * @brief Set SMBus SUSCON pin is input mode + * + * @param[in] i2c Specify I2C port + * + * @return None + * + * @details This function to set SUSCON(I2C_BUSCTL[6]) pin is input mode. + * + * \hideinitializer + */ +#define I2C_SMBUS_SET_SUSCON_IN(i2c) ((i2c)->BUSCTL &= ~I2C_BUSCTL_SCTLOEN_Msk) + +/** + * @brief Set SMBus SUSCON pin output high state + * + * @param[in] i2c Specify I2C port + * + * @return None + * + * @details This function to set SUSCON(I2C_BUSCTL[6]) pin is output hi state. + * \hideinitializer + */ +#define I2C_SMBUS_SET_SUSCON_HIGH(i2c) ((i2c)->BUSCTL |= I2C_BUSCTL_SCTLOSTS_Msk) + + +/** + * @brief Set SMBus SUSCON pin output low state + * + * @param[in] i2c Specify I2C port + * + * @return None + * + * @details This function to set SUSCON(I2C_BUSCTL[6]) pin is output lo state. + * \hideinitializer + */ +#define I2C_SMBUS_SET_SUSCON_LOW(i2c) ((i2c)->BUSCTL &= ~I2C_BUSCTL_SCTLOSTS_Msk) + +/** + * @brief Enable SMBus Acknowledge control by manual + * + * @param[in] i2c Specify I2C port + * + * @return None + * + * @details The 9th bit can response the ACK or NACK according the received data by user. When the byte is received, SCLK line stretching to low between the 8th and 9th SCLK pulse. + * \hideinitializer + */ +#define I2C_SMBUS_ACK_MANUAL(i2c) ((i2c)->BUSCTL |= I2C_BUSCTL_ACKMEN_Msk) + +/** + * @brief Disable SMBus Acknowledge control by manual + * + * @param[in] i2c Specify I2C port + * + * @return None + * + * @details Disable acknowledge response control by user. + * \hideinitializer + */ +#define I2C_SMBUS_ACK_AUTO(i2c) ((i2c)->BUSCTL &= ~I2C_BUSCTL_ACKMEN_Msk) + +/** + * @brief Enable SMBus Acknowledge manual interrupt + * + * @param[in] i2c Specify I2C port + * + * @return None + * + * @details This function is used to enable SMBUS acknowledge manual interrupt on the 9th clock cycle when SMBUS=1 and ACKMEN=1 + * \hideinitializer + */ +#define I2C_SMBUS_9THBIT_INT_ENABLE(i2c) ((i2c)->BUSCTL |= I2C_BUSCTL_ACKM9SI_Msk) + +/** + * @brief Disable SMBus Acknowledge manual interrupt + * + * @param[in] i2c Specify I2C port + * + * @return None + * + * @details This function is used to disable SMBUS acknowledge manual interrupt on the 9th clock cycle when SMBUS=1 and ACKMEN=1 + * \hideinitializer + */ +#define I2C_SMBUS_9THBIT_INT_DISABLE(i2c) ((i2c)->BUSCTL &= ~I2C_BUSCTL_ACKM9SI_Msk) + +/** + * @brief Enable SMBus PEC clear at REPEAT START + * + * @param[in] i2c Specify I2C port + * + * @return None + * + * @details This function is used to enable the condition of REAEAT START can clear the PEC calculation. + * \hideinitializer + */ +#define I2C_SMBUS_RST_PEC_AT_START_ENABLE(i2c) ((i2c)->BUSCTL |= I2C_BUSCTL_PECCLR_Msk) + +/** + * @brief Disable SMBus PEC clear at Repeat START + * + * @param[in] i2c Specify I2C port + * + * @return None + * + * @details This function is used to disable the condition of Repeat START can clear the PEC calculation. + * \hideinitializer + */ +#define I2C_SMBUS_RST_PEC_AT_START_DISABLE(i2c) ((i2c)->BUSCTL &= ~I2C_BUSCTL_PECCLR_Msk) + +/** + * @brief Enable RX PDMA function. + * @param[in] i2c The pointer of the specified I2C module. + * @return None. + * @details Set RXPDMAEN bit of I2C_CTL1 register to enable RX PDMA transfer function. + * \hideinitializer + */ +#define I2C_ENABLE_RX_PDMA(i2c) ((i2c)->CTL1 |= I2C_CTL1_RXPDMAEN_Msk) + +/** + * @brief Enable TX PDMA function. + * @param[in] i2c The pointer of the specified I2C module. + * @return None. + * @details Set TXPDMAEN bit of I2C_CTL1 register to enable TX PDMA transfer function. + * \hideinitializer + */ +#define I2C_ENABLE_TX_PDMA(i2c) ((i2c)->CTL1 |= I2C_CTL1_TXPDMAEN_Msk) + +/** + * @brief Disable RX PDMA transfer. + * @param[in] i2c The pointer of the specified I2C module. + * @return None. + * @details Clear RXPDMAEN bit of I2C_CTL1 register to disable RX PDMA transfer function. + * \hideinitializer + */ +#define I2C_DISABLE_RX_PDMA(i2c) ((i2c)->CTL1 &= ~I2C_CTL1_RXPDMAEN_Msk) + +/** + * @brief Disable TX PDMA transfer. + * @param[in] i2c The pointer of the specified I2C module. + * @return None. + * @details Clear TXPDMAEN bit of I2C_CTL1 register to disable TX PDMA transfer function. + * \hideinitializer + */ +#define I2C_DISABLE_TX_PDMA(i2c) ((i2c)->CTL1 &= ~I2C_CTL1_TXPDMAEN_Msk) + +/** + * @brief Enable PDMA stretch function. + * @param[in] i2c The pointer of the specified I2C module. + * @return None. + * @details Enable this function is to stretch bus by hardware after PDMA transfer is done if SI is not cleared. + * \hideinitializer + */ +#define I2C_ENABLE_PDMA_STRETCH(i2c) ((i2c)->CTL1 |= I2C_CTL1_PDMASTR_Msk) + +/** + * @brief Disable PDMA stretch function. + * @param[in] i2c The pointer of the specified I2C module. + * @return None. + * @details I2C will send STOP after PDMA transfers done automatically. + * \hideinitializer + */ +#define I2C_DISABLE_PDMA_STRETCH(i2c) ((i2c)->CTL1 &= ~I2C_CTL1_PDMASTR_Msk) + +/** + * @brief Reset PDMA function. + * @param[in] i2c The pointer of the specified I2C module. + * @return None. + * @details I2C PDMA engine will be reset after this function is called. + * \hideinitializer + */ +#define I2C_DISABLE_RST_PDMA(i2c) ((i2c)->CTL1 |= I2C_CTL1_PDMARST_Msk) + +/*---------------------------------------------------------------------------------------------------------*/ +/* inline functions */ +/*---------------------------------------------------------------------------------------------------------*/ + +/* Declare these inline functions here to avoid MISRA C 2004 rule 8.1 error */ +__STATIC_INLINE void I2C_STOP(I2C_T *i2c); + +/** + * @brief The macro is used to set STOP condition of I2C Bus + * + * @param[in] i2c Specify I2C port + * + * @return None + * + * @details Set the I2C bus STOP condition in I2C_CTL register. + */ +__STATIC_INLINE void I2C_STOP(I2C_T *i2c) +{ + + (i2c)->CTL0 |= (I2C_CTL0_SI_Msk | I2C_CTL0_STO_Msk); + while(i2c->CTL0 & I2C_CTL0_STO_Msk) + { + } +} + +void I2C_ClearTimeoutFlag(I2C_T *i2c); +void I2C_Close(I2C_T *i2c); +void I2C_Trigger(I2C_T *i2c, uint8_t u8Start, uint8_t u8Stop, uint8_t u8Si, uint8_t u8Ack); +void I2C_DisableInt(I2C_T *i2c); +void I2C_EnableInt(I2C_T *i2c); +uint32_t I2C_GetBusClockFreq(I2C_T *i2c); +uint32_t I2C_GetIntFlag(I2C_T *i2c); +uint32_t I2C_GetStatus(I2C_T *i2c); +uint32_t I2C_Open(I2C_T *i2c, uint32_t u32BusClock); +uint8_t I2C_GetData(I2C_T *i2c); +void I2C_SetSlaveAddr(I2C_T *i2c, uint8_t u8SlaveNo, uint8_t u8SlaveAddr, uint8_t u8GCMode); +void I2C_SetSlaveAddrMask(I2C_T *i2c, uint8_t u8SlaveNo, uint8_t u8SlaveAddrMask); +uint32_t I2C_SetBusClockFreq(I2C_T *i2c, uint32_t u32BusClock); +void I2C_EnableTimeout(I2C_T *i2c, uint8_t u8LongTimeout); +void I2C_DisableTimeout(I2C_T *i2c); +void I2C_EnableWakeup(I2C_T *i2c); +void I2C_DisableWakeup(I2C_T *i2c); +void I2C_SetData(I2C_T *i2c, uint8_t u8Data); +void I2C_SMBusClearInterruptFlag(I2C_T *i2c, uint8_t u8SMBusIntFlag); +uint8_t I2C_WriteByte(I2C_T *i2c, uint8_t u8SlaveAddr, uint8_t data); +uint32_t I2C_WriteMultiBytes(I2C_T *i2c, uint8_t u8SlaveAddr, uint8_t data[], uint32_t u32wLen); +uint8_t I2C_WriteByteOneReg(I2C_T *i2c, uint8_t u8SlaveAddr, uint8_t u8DataAddr, uint8_t data); +uint32_t I2C_WriteMultiBytesOneReg(I2C_T *i2c, uint8_t u8SlaveAddr, uint8_t u8DataAddr, uint8_t data[], uint32_t u32wLen); +uint8_t I2C_WriteByteTwoRegs(I2C_T *i2c, uint8_t u8SlaveAddr, uint16_t u16DataAddr, uint8_t data); +uint32_t I2C_WriteMultiBytesTwoRegs(I2C_T *i2c, uint8_t u8SlaveAddr, uint16_t u16DataAddr, uint8_t data[], uint32_t u32wLen); +uint8_t I2C_ReadByte(I2C_T *i2c, uint8_t u8SlaveAddr); +uint32_t I2C_ReadMultiBytes(I2C_T *i2c, uint8_t u8SlaveAddr, uint8_t rdata[], uint32_t u32rLen); +uint8_t I2C_ReadByteOneReg(I2C_T *i2c, uint8_t u8SlaveAddr, uint8_t u8DataAddr); +uint32_t I2C_ReadMultiBytesOneReg(I2C_T *i2c, uint8_t u8SlaveAddr, uint8_t u8DataAddr, uint8_t rdata[], uint32_t u32rLen); +uint8_t I2C_ReadByteTwoRegs(I2C_T *i2c, uint8_t u8SlaveAddr, uint16_t u16DataAddr); +uint32_t I2C_ReadMultiBytesTwoRegs(I2C_T *i2c, uint8_t u8SlaveAddr, uint16_t u16DataAddr, uint8_t rdata[], uint32_t u32rLen); +uint32_t I2C_SMBusGetStatus(I2C_T *i2c); +void I2C_SMBusSetPacketByteCount(I2C_T *i2c, uint32_t u32PktSize); +void I2C_SMBusOpen(I2C_T *i2c, uint8_t u8HostDevice); +void I2C_SMBusClose(I2C_T *i2c); +void I2C_SMBusPECTxEnable(I2C_T *i2c, uint8_t u8PECTxEn); +uint8_t I2C_SMBusGetPECValue(I2C_T *i2c); +void I2C_SMBusIdleTimeout(I2C_T *i2c, uint32_t us, uint32_t u32Hclk); +void I2C_SMBusTimeout(I2C_T *i2c, uint32_t ms, uint32_t u32Pclk); +void I2C_SMBusClockLoTimeout(I2C_T *i2c, uint32_t ms, uint32_t u32Pclk); + +/*@}*/ /* end of group I2C_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group I2C_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_i2s.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_i2s.h new file mode 100644 index 00000000000..096c6c0d1ae --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_i2s.h @@ -0,0 +1,353 @@ +/****************************************************************************//** + * @file nu_i2s.h + * @version V0.10 + * @brief M480 I2S driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. +*****************************************************************************/ +#ifndef __NU_I2S_H__ +#define __NU_I2S_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup I2S_Driver I2S Driver + @{ +*/ + +/** @addtogroup I2S_EXPORTED_CONSTANTS I2S Exported Constants + @{ +*/ +#define I2S_DATABIT_8 (0U << I2S_CTL0_DATWIDTH_Pos) /*!< I2S data width is 8-bit \hideinitializer */ +#define I2S_DATABIT_16 (1U << I2S_CTL0_DATWIDTH_Pos) /*!< I2S data width is 16-bit \hideinitializer */ +#define I2S_DATABIT_24 (2U << I2S_CTL0_DATWIDTH_Pos) /*!< I2S data width is 24-bit \hideinitializer */ +#define I2S_DATABIT_32 (3U << I2S_CTL0_DATWIDTH_Pos) /*!< I2S data width is 32-bit \hideinitializer */ + +/* Audio Format */ +#define I2S_ENABLE_MONO I2S_CTL0_MONO_Msk /*!< Mono channel \hideinitializer */ +#define I2S_DISABLE_MONO (0U) /*!< Stereo channel \hideinitializer */ + +/* I2S Data Format */ +#define I2S_FORMAT_I2S (0U << I2S_CTL0_FORMAT_Pos) /*!< I2S data format \hideinitializer */ +#define I2S_FORMAT_I2S_MSB (1U << I2S_CTL0_FORMAT_Pos) /*!< I2S MSB data format \hideinitializer */ +#define I2S_FORMAT_I2S_LSB (2U << I2S_CTL0_FORMAT_Pos) /*!< I2S LSB data format \hideinitializer */ +#define I2S_FORMAT_PCM (4U << I2S_CTL0_FORMAT_Pos) /*!< PCM data format \hideinitializer */ +#define I2S_FORMAT_PCM_MSB (5U << I2S_CTL0_FORMAT_Pos) /*!< PCM MSB data format \hideinitializer */ +#define I2S_FORMAT_PCM_LSB (6U << I2S_CTL0_FORMAT_Pos) /*!< PCM LSB data format \hideinitializer */ + +/* I2S Data Format */ +#define I2S_ORDER_AT_MSB (0U) /*!< Channel data is at MSB \hideinitializer */ +#define I2S_ORDER_AT_LSB I2S_CTL0_ORDER_Msk /*!< Channel data is at LSB \hideinitializer */ + +/* I2S TDM Channel Number */ +#define I2S_TDM_2CH 0U /*!< Use TDM 2 channel \hideinitializer */ +#define I2S_TDM_4CH 1U /*!< Use TDM 4 channel \hideinitializer */ +#define I2S_TDM_6CH 2U /*!< Use TDM 6 channel \hideinitializer */ +#define I2S_TDM_8CH 3U /*!< Use TDM 8 channel \hideinitializer */ + +/* I2S TDM Channel Width */ +#define I2S_TDM_WIDTH_8BIT 0U /*!< TDM channel witch is 8-bit \hideinitializer */ +#define I2S_TDM_WIDTH_16BIT 1U /*!< TDM channel witch is 16-bit \hideinitializer */ +#define I2S_TDM_WIDTH_24BIT 2U /*!< TDM channel witch is 24-bit \hideinitializer */ +#define I2S_TDM_WIDTH_32BIT 3U /*!< TDM channel witch is 32-bit \hideinitializer */ + +/* I2S TDM Sync Width */ +#define I2S_TDM_SYNC_ONE_BCLK 0U /*!< TDM sync widht is one BLCK period \hideinitializer */ +#define I2S_TDM_SYNC_ONE_CHANNEL 1U /*!< TDM sync widht is one channel period \hideinitializer */ + +/* I2S Operation mode */ +#define I2S_MODE_SLAVE I2S_CTL0_SLAVE_Msk /*!< As slave mode \hideinitializer */ +#define I2S_MODE_MASTER (0u) /*!< As master mode \hideinitializer */ + +/* I2S FIFO Threshold */ +#define I2S_FIFO_TX_LEVEL_WORD_0 (0U) /*!< TX threshold is 0 word \hideinitializer */ +#define I2S_FIFO_TX_LEVEL_WORD_1 (1U << I2S_CTL1_TXTH_Pos) /*!< TX threshold is 1 word \hideinitializer */ +#define I2S_FIFO_TX_LEVEL_WORD_2 (2U << I2S_CTL1_TXTH_Pos) /*!< TX threshold is 2 words \hideinitializer */ +#define I2S_FIFO_TX_LEVEL_WORD_3 (3U << I2S_CTL1_TXTH_Pos) /*!< TX threshold is 3 words \hideinitializer */ +#define I2S_FIFO_TX_LEVEL_WORD_4 (4U << I2S_CTL1_TXTH_Pos) /*!< TX threshold is 4 words \hideinitializer */ +#define I2S_FIFO_TX_LEVEL_WORD_5 (5U << I2S_CTL1_TXTH_Pos) /*!< TX threshold is 5 words \hideinitializer */ +#define I2S_FIFO_TX_LEVEL_WORD_6 (6U << I2S_CTL1_TXTH_Pos) /*!< TX threshold is 6 words \hideinitializer */ +#define I2S_FIFO_TX_LEVEL_WORD_7 (7U << I2S_CTL1_TXTH_Pos) /*!< TX threshold is 7 words \hideinitializer */ +#define I2S_FIFO_TX_LEVEL_WORD_8 (8U << I2S_CTL1_TXTH_Pos) /*!< TX threshold is 8 words \hideinitializer */ +#define I2S_FIFO_TX_LEVEL_WORD_9 (9U << I2S_CTL1_TXTH_Pos) /*!< TX threshold is 9 words \hideinitializer */ +#define I2S_FIFO_TX_LEVEL_WORD_10 (10U << I2S_CTL1_TXTH_Pos) /*!< TX threshold is 10 words \hideinitializer */ +#define I2S_FIFO_TX_LEVEL_WORD_11 (11U << I2S_CTL1_TXTH_Pos) /*!< TX threshold is 11 words \hideinitializer */ +#define I2S_FIFO_TX_LEVEL_WORD_12 (12U << I2S_CTL1_TXTH_Pos) /*!< TX threshold is 12 words \hideinitializer */ +#define I2S_FIFO_TX_LEVEL_WORD_13 (13U << I2S_CTL1_TXTH_Pos) /*!< TX threshold is 13 words \hideinitializer */ +#define I2S_FIFO_TX_LEVEL_WORD_14 (14U << I2S_CTL1_TXTH_Pos) /*!< TX threshold is 14 words \hideinitializer */ +#define I2S_FIFO_TX_LEVEL_WORD_15 (15U << I2S_CTL1_TXTH_Pos) /*!< TX threshold is 15 words \hideinitializer */ + +#define I2S_FIFO_RX_LEVEL_WORD_1 (0U) /*!< RX threshold is 1 word \hideinitializer */ +#define I2S_FIFO_RX_LEVEL_WORD_2 (1U << I2S_CTL1_RXTH_Pos) /*!< RX threshold is 2 words \hideinitializer */ +#define I2S_FIFO_RX_LEVEL_WORD_3 (2U << I2S_CTL1_RXTH_Pos) /*!< RX threshold is 3 words \hideinitializer */ +#define I2S_FIFO_RX_LEVEL_WORD_4 (3U << I2S_CTL1_RXTH_Pos) /*!< RX threshold is 4 words \hideinitializer */ +#define I2S_FIFO_RX_LEVEL_WORD_5 (4U << I2S_CTL1_RXTH_Pos) /*!< RX threshold is 5 words \hideinitializer */ +#define I2S_FIFO_RX_LEVEL_WORD_6 (5U << I2S_CTL1_RXTH_Pos) /*!< RX threshold is 6 words \hideinitializer */ +#define I2S_FIFO_RX_LEVEL_WORD_7 (6U << I2S_CTL1_RXTH_Pos) /*!< RX threshold is 7 words \hideinitializer */ +#define I2S_FIFO_RX_LEVEL_WORD_8 (7U << I2S_CTL1_RXTH_Pos) /*!< RX threshold is 8 words \hideinitializer */ +#define I2S_FIFO_RX_LEVEL_WORD_9 (8U << I2S_CTL1_RXTH_Pos) /*!< RX threshold is 9 words \hideinitializer */ +#define I2S_FIFO_RX_LEVEL_WORD_10 (9U << I2S_CTL1_RXTH_Pos) /*!< RX threshold is 10 words \hideinitializer */ +#define I2S_FIFO_RX_LEVEL_WORD_11 (10U << I2S_CTL1_RXTH_Pos) /*!< RX threshold is 11 words \hideinitializer */ +#define I2S_FIFO_RX_LEVEL_WORD_12 (11U << I2S_CTL1_RXTH_Pos) /*!< RX threshold is 12 words \hideinitializer */ +#define I2S_FIFO_RX_LEVEL_WORD_13 (12U << I2S_CTL1_RXTH_Pos) /*!< RX threshold is 13 words \hideinitializer */ +#define I2S_FIFO_RX_LEVEL_WORD_14 (13U << I2S_CTL1_RXTH_Pos) /*!< RX threshold is 14 words \hideinitializer */ +#define I2S_FIFO_RX_LEVEL_WORD_15 (14U << I2S_CTL1_RXTH_Pos) /*!< RX threshold is 15 words \hideinitializer */ +#define I2S_FIFO_RX_LEVEL_WORD_16 (15U << I2S_CTL1_RXTH_Pos) /*!< RX threshold is 16 words \hideinitializer */ + +/* I2S Record Channel */ +#define I2S_MONO_RIGHT (0U) /*!< Record mono right channel \hideinitializer */ +#define I2S_MONO_LEFT I2S_CTL0_RXLCH_Msk /*!< Record mono left channel \hideinitializer */ + +/* I2S Channel */ +#define I2S_RIGHT (0U) /*!< Select right channel \hideinitializer */ +#define I2S_LEFT (1U) /*!< Select left channel \hideinitializer */ + +/*@}*/ /* end of group I2S_EXPORTED_CONSTANTS */ + +/** @addtogroup I2S_EXPORTED_FUNCTIONS I2S Exported Functions + @{ +*/ +/*---------------------------------------------------------------------------------------------------------*/ +/* inline functions */ +/*---------------------------------------------------------------------------------------------------------*/ +/** + * @brief Enable zero cross detect function. + * @param[in] i2s is the base address of I2S module. + * @param[in] u32ChMask is the mask for channel number (valid value is from (1~8). + * @return none + * \hideinitializer + */ +__STATIC_INLINE void I2S_ENABLE_TX_ZCD(I2S_T *i2s, uint32_t u32ChMask) +{ + if((u32ChMask > 0U) && (u32ChMask < 9U)) + { + i2s->CTL1 |= ((uint32_t)1U << (u32ChMask-1U)); + } +} + +/** + * @brief Disable zero cross detect function. + * @param[in] i2s is the base address of I2S module. + * @param[in] u32ChMask is the mask for channel number (valid value is from (1~8). + * @return none + * \hideinitializer + */ +__STATIC_INLINE void I2S_DISABLE_TX_ZCD(I2S_T *i2s, uint32_t u32ChMask) +{ + if((u32ChMask > 0U) && (u32ChMask < 9U)) + { + i2s->CTL1 &= ~((uint32_t)1U << (u32ChMask-1U)); + } +} + +/** + * @brief Enable I2S Tx DMA function. I2S requests DMA to transfer data to Tx FIFO. + * @param[in] i2s is the base address of I2S module. + * @return none + * \hideinitializer + */ +#define I2S_ENABLE_TXDMA(i2s) ( (i2s)->CTL0 |= I2S_CTL0_TXPDMAEN_Msk ) + +/** + * @brief Disable I2S Tx DMA function. I2S requests DMA to transfer data to Tx FIFO. + * @param[in] i2s is the base address of I2S module. + * @return none + * \hideinitializer + */ +#define I2S_DISABLE_TXDMA(i2s) ( (i2s)->CTL0 &= ~I2S_CTL0_TXPDMAEN_Msk ) + +/** + * @brief Enable I2S Rx DMA function. I2S requests DMA to transfer data from Rx FIFO. + * @param[in] i2s is the base address of I2S module. + * @return none + * \hideinitializer + */ +#define I2S_ENABLE_RXDMA(i2s) ( (i2s)->CTL0 |= I2S_CTL0_RXPDMAEN_Msk ) + +/** + * @brief Disable I2S Rx DMA function. I2S requests DMA to transfer data from Rx FIFO. + * @param[in] i2s is the base address of I2S module. + * @return none + * \hideinitializer + */ +#define I2S_DISABLE_RXDMA(i2s) ( (i2s)->CTL0 &= ~I2S_CTL0_RXPDMAEN_Msk ) + +/** + * @brief Enable I2S Tx function . + * @param[in] i2s is the base address of I2S module. + * @return none + * \hideinitializer + */ +#define I2S_ENABLE_TX(i2s) ( (i2s)->CTL0 |= I2S_CTL0_TXEN_Msk ) + +/** + * @brief Disable I2S Tx function . + * @param[in] i2s is the base address of I2S module. + * @return none + * \hideinitializer + */ +#define I2S_DISABLE_TX(i2s) ( (i2s)->CTL0 &= ~I2S_CTL0_TXEN_Msk ) + +/** + * @brief Enable I2S Rx function . + * @param[in] i2s is the base address of I2S module. + * @return none + * \hideinitializer + */ +#define I2S_ENABLE_RX(i2s) ( (i2s)->CTL0 |= I2S_CTL0_RXEN_Msk ) + +/** + * @brief Disable I2S Rx function . + * @param[in] i2s is the base address of I2S module. + * @return none + * \hideinitializer + */ +#define I2S_DISABLE_RX(i2s) ( (i2s)->CTL0 &= ~I2S_CTL0_RXEN_Msk ) + +/** + * @brief Enable Tx Mute function . + * @param[in] i2s is the base address of I2S module. + * @return none + * \hideinitializer + */ +#define I2S_ENABLE_TX_MUTE(i2s) ( (i2s)->CTL0 |= I2S_CTL0_MUTE_Msk ) + +/** + * @brief Disable Tx Mute function . + * @param[in] i2s is the base address of I2S module. + * @return none + * \hideinitializer + */ +#define I2S_DISABLE_TX_MUTE(i2s) ( (i2s)->CTL0 &= ~I2S_CTL0_MUTE_Msk ) + +/** + * @brief Clear Tx FIFO. Internal pointer is reset to FIFO start point. + * @param[in] i2s is the base address of I2S module. + * @return none + * \hideinitializer + */ +#define I2S_CLR_TX_FIFO(i2s) ( (i2s)->CTL0 |= I2S_CTL0_TXFBCLR_Msk ) + +/** + * @brief Clear Rx FIFO. Internal pointer is reset to FIFO start point. + * @param[in] i2s is the base address of I2S module. + * @return none + * \hideinitializer + */ +#define I2S_CLR_RX_FIFO(i2s) ( (i2s)->CTL0 |= I2S_CTL0_RXFBCLR_Msk ) + +/** + * @brief This function sets the recording source channel when mono mode is used. + * @param[in] i2s is the base address of I2S module. + * @param[in] u32Ch left or right channel. Valid values are: + * - \ref I2S_MONO_LEFT + * - \ref I2S_MONO_RIGHT + * @return none + * \hideinitializer + */ +__STATIC_INLINE void I2S_SET_MONO_RX_CHANNEL(I2S_T *i2s, uint32_t u32Ch) +{ + u32Ch == I2S_MONO_LEFT ? + (i2s->CTL0 |= I2S_CTL0_RXLCH_Msk) : + (i2s->CTL0 &= ~I2S_CTL0_RXLCH_Msk); +} + +/** + * @brief Write data to I2S Tx FIFO. + * @param[in] i2s is the base address of I2S module. + * @param[in] u32Data: The data written to FIFO. + * @return none + * \hideinitializer + */ +#define I2S_WRITE_TX_FIFO(i2s, u32Data) ( (i2s)->TXFIFO = (u32Data) ) + +/** + * @brief Read Rx FIFO. + * @param[in] i2s is the base address of I2S module. + * @return Data in Rx FIFO. + * \hideinitializer + */ +#define I2S_READ_RX_FIFO(i2s) ( (i2s)->RXFIFO ) + +/** + * @brief This function gets the interrupt flag according to the mask parameter. + * @param[in] i2s is the base address of I2S module. + * @param[in] u32Mask is the mask for the all interrupt flags. + * @return The masked bit value of interrupt flag. + * \hideinitializer + */ +#define I2S_GET_INT_FLAG(i2s, u32Mask) ( (i2s)->STATUS0 & (u32Mask) ) + +/** + * @brief This function clears the interrupt flag according to the mask parameter. + * @param[in] i2s is the base address of I2S module. + * @param[in] u32Mask is the mask for the all interrupt flags. + * @return none + * \hideinitializer + */ +#define I2S_CLR_INT_FLAG(i2s, u32Mask) ( (i2s)->STATUS0 |= (u32Mask) ) + +/** + * @brief This function gets the zero crossing interrupt flag according to the mask parameter. + * @param[in] i2s is the base address of I2S module. + * @param[in] u32Mask is the mask for the all interrupt flags. + * @return The masked bit value of interrupt flag. + * \hideinitializer + */ +#define I2S_GET_ZC_INT_FLAG(i2s, u32Mask) ( (i2s)->STATUS1 & (u32Mask) ) + +/** + * @brief This function clears the zero crossing interrupt flag according to the mask parameter. + * @param[in] i2s is the base address of I2S module. + * @param[in] u32Mask is the mask for the all interrupt flags. + * @return none + * \hideinitializer + */ +#define I2S_CLR_ZC_INT_FLAG(i2s, u32Mask) ( (i2s)->STATUS1 |= (u32Mask) ) + +/** + * @brief Get transmit FIFO level + * @param[in] i2s is the base address of I2S module. + * @return FIFO level + * \hideinitializer + */ +#define I2S_GET_TX_FIFO_LEVEL(i2s) ( (((i2s)->STATUS1 & I2S_STATUS1_TXCNT_Msk) >> I2S_STATUS1_TXCNT_Pos) & 0xF ) + +/** + * @brief Get receive FIFO level + * @param[in] i2s is the base address of I2S module. + * @return FIFO level + * \hideinitializer + */ +#define I2S_GET_RX_FIFO_LEVEL(i2s) ( (((i2s)->STATUS1 & I2S_STATUS1_RXCNT_Msk) >> I2S_STATUS1_RXCNT_Pos) & 0xF ) + +void I2S_Close(I2S_T *i2s); +void I2S_EnableInt(I2S_T *i2s, uint32_t u32Mask); +void I2S_DisableInt(I2S_T *i2s, uint32_t u32Mask); +uint32_t I2S_EnableMCLK(I2S_T *i2s, uint32_t u32BusClock); +void I2S_DisableMCLK(I2S_T *i2s); +void I2S_SetFIFO(I2S_T *i2s, uint32_t u32TxThreshold, uint32_t u32RxThreshold); +void I2S_ConfigureTDM(I2S_T *i2s, uint32_t u32ChannelWidth, uint32_t u32ChannelNum, uint32_t u32SyncWidth); +uint32_t I2S_Open(I2S_T *i2s, uint32_t u32MasterSlave, uint32_t u32SampleRate, uint32_t u32WordWidth, uint32_t u32MonoData, uint32_t u32DataFormat); + +/*@}*/ /* end of group I2S_EXPORTED_FUNCTIONS */ + + +/*@}*/ /* end of group I2S_Driver */ + +/*@}*/ /* end of group Standard_Driver */ +#ifdef __cplusplus +} +#endif + +#endif + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ + diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_opa.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_opa.h new file mode 100644 index 00000000000..8d2baa9d180 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_opa.h @@ -0,0 +1,209 @@ +/**************************************************************************//** + * @file nu_opa.h + * @version V3.00 + * @brief M480 series OPA driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __NU_OPA_H__ +#define __NU_OPA_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup OPA_Driver OPA Driver + @{ +*/ + +/** @addtogroup OPA_EXPORTED_CONSTANTS OPA Exported Constants + @{ +*/ +#define OPA_CALIBRATION_CLK_1K (0UL) /*!< OPA calibration clock select 1 KHz \hideinitializer */ +#define OPA_CALIBRATION_RV_1_2_AVDD (0UL) /*!< OPA calibration reference voltage select 1/2 AVDD \hideinitializer */ +#define OPA_CALIBRATION_RV_H_L_VCM (1UL) /*!< OPA calibration reference voltage select from high vcm to low vcm \hideinitializer */ + +/*@}*/ /* end of group OPA_EXPORTED_CONSTANTS */ + +/** @addtogroup OPA_EXPORTED_FUNCTIONS OPA Exported Functions + @{ +*/ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Define OPA functions prototype */ +/*---------------------------------------------------------------------------------------------------------*/ +__STATIC_INLINE int32_t OPA_Calibration(OPA_T *opa, uint32_t u32OpaNum, uint32_t u32ClockSel, uint32_t u32LevelSel); + +/** + * @brief This macro is used to power on the OPA circuit + * @param[in] opa The pointer of the specified OPA module + * @param[in] u32OpaNum The OPA number. 0 for OPA0; 1 for OPA1; 2 for OPA2. + * @return None + * @details This macro will set OPx_EN (x=0, 1) bit of OPACR register to power on the OPA circuit. + * @note Remember to enable HIRC clock while power on the OPA circuit. + * \hideinitializer + */ +#define OPA_POWER_ON(opa, u32OpaNum) ((opa)->CTL |= (1UL<<(OPA_CTL_OPEN0_Pos+(u32OpaNum)))) + +/** + * @brief This macro is used to power down the OPA circuit + * @param[in] opa The pointer of the specified OPA module + * @param[in] u32OpaNum The OPA number. 0 for OPA0; 1 for OPA1; 2 for OPA2. + * @return None + * @details This macro will clear OPx_EN (x=0, 1) bit of OPACR register to power down the OPA circuit. + * \hideinitializer + */ +#define OPA_POWER_DOWN(opa, u32OpaNum) ((opa)->CTL &= ~(1UL<<(OPA_CTL_OPEN0_Pos+(u32OpaNum)))) + +/** + * @brief This macro is used to enable the OPA Schmitt trigger buffer + * @param[in] opa The pointer of the specified OPA module + * @param[in] u32OpaNum The OPA number. 0 for OPA0; 1 for OPA1; 2 for OPA2. + * @return None + * @details This macro will set OPSCHx_EN (x=0, 1) bit of OPACR register to enable the OPA Schmitt trigger buffer. + * \hideinitializer + */ +#define OPA_ENABLE_SCH_TRIGGER(opa, u32OpaNum) ((opa)->CTL |= (1UL<<(OPA_CTL_OPDOEN0_Pos+(u32OpaNum)))) + +/** + * @brief This macro is used to disable the OPA Schmitt trigger buffer + * @param[in] opa The pointer of the specified OPA module + * @param[in] u32OpaNum The OPA number. 0 for OPA0; 1 for OPA1; 2 for OPA2. + * @return None + * @details This macro will clear OPSCHx_EN (x=0, 1) bit of OPACR register to disable the OPA Schmitt trigger buffer. + * \hideinitializer + */ +#define OPA_DISABLE_SCH_TRIGGER(opa, u32OpaNum) ((opa)->CTL &= ~(1UL<<(OPA_CTL_OPDOEN0_Pos+(u32OpaNum)))) + +/** + * @brief This macro is used to enable OPA Schmitt trigger digital output interrupt + * @param[in] opa The pointer of the specified OPA module + * @param[in] u32OpaNum The OPA number. 0 for OPA0; 1 for OPA1; 2 for OPA2. + * @return None + * @details This macro will set OPDIEx (x=0, 1) bit of OPACR register to enable the OPA Schmitt trigger digital output interrupt. + * \hideinitializer + */ +#define OPA_ENABLE_INT(opa, u32OpaNum) ((opa)->CTL |= (1UL<<(OPA_CTL_OPDOIEN0_Pos+(u32OpaNum)))) + +/** + * @brief This macro is used to disable OPA Schmitt trigger digital output interrupt + * @param[in] opa The pointer of the specified OPA module + * @param[in] u32OpaNum The OPA number. 0 for OPA0; 1 for OPA1; 2 for OPA2. + * @return None + * @details This macro will clear OPDIEx (x=0, 1) bit of OPACR register to disable the OPA Schmitt trigger digital output interrupt. + * \hideinitializer + */ +#define OPA_DISABLE_INT(opa, u32OpaNum) ((opa)->CTL &= ~(1UL<<(OPA_CTL_OPDOIEN0_Pos+(u32OpaNum)))) + +/** + * @brief This macro is used to get OPA digital output state + * @param[in] opa The pointer of the specified OPA module + * @param[in] u32OpaNum The OPA number. 0 for OPA0; 1 for OPA1; 2 for OPA2. + * @return OPA digital output state + * @details This macro will return the OPA digital output value. + * \hideinitializer + */ +#define OPA_GET_DIGITAL_OUTPUT(opa, u32OpaNum) (((opa)->STATUS & (OPA_STATUS_OPDO0_Msk<<(u32OpaNum)))?1UL:0UL) + +/** + * @brief This macro is used to get OPA interrupt flag + * @param[in] opa The pointer of the specified OPA module + * @param[in] u32OpaNum The OPA number. 0 for OPA0; 1 for OPA1; 2 for OPA2. + * @retval 0 OPA interrupt does not occur. + * @retval 1 OPA interrupt occurs. + * @details This macro will return the ACMP interrupt flag. + * \hideinitializer + */ +#define OPA_GET_INT_FLAG(opa, u32OpaNum) (((opa)->STATUS & (OPA_STATUS_OPDOIF0_Msk<<(u32OpaNum)))?1UL:0UL) + +/** + * @brief This macro is used to clear OPA interrupt flag + * @param[in] opa The pointer of the specified OPA module + * @param[in] u32OpaNum The OPA number. 0 for OPA0; 1 for OPA1; 2 for OPA2. + * @return None + * @details This macro will write 1 to OPDFx (x=0,1) bit of OPASR register to clear interrupt flag. + * \hideinitializer + */ +#define OPA_CLR_INT_FLAG(opa, u32OpaNum) ((opa)->STATUS = (OPA_STATUS_OPDOIF0_Msk<<(u32OpaNum))) + + +/** + * @brief This function is used to configure and start OPA calibration + * @param[in] opa The pointer of the specified OPA module + * @param[in] u32OpaNum The OPA number. 0 for OPA0; 1 for OPA1; 2 for OPA2. + * @param[in] u32ClockSel Select OPA calibration clock + * - \ref OPA_CALIBRATION_CLK_1K + * @param[in] u32RefVol Select OPA reference voltage + * - \ref OPA_CALIBRATION_RV_1_2_AVDD + * - \ref OPA_CALIBRATION_RV_H_L_VCM + * @retval 0 PMOS and NMOS calibration successfully. + * @retval -1 only PMOS calibration failed. + * @retval -2 only NMOS calibration failed. + * @retval -3 PMOS and NMOS calibration failed. + */ +__STATIC_INLINE int32_t OPA_Calibration(OPA_T *opa, + uint32_t u32OpaNum, + uint32_t u32ClockSel, + uint32_t u32RefVol) +{ + uint32_t u32CALResult; + int32_t i32Ret = 0L; + + (opa)->CALCTL = (((opa)->CALCTL) & ~(OPA_CALCTL_CALCLK0_Msk << (u32OpaNum << 1))); + (opa)->CALCTL = (((opa)->CALCTL) & ~(OPA_CALCTL_CALRVS0_Msk << (u32OpaNum))) | (((u32RefVol) << OPA_CALCTL_CALRVS0_Pos) << (u32OpaNum)); + (opa)->CALCTL |= (OPA_CALCTL_CALTRG0_Msk << (u32OpaNum)); + while((opa)->CALCTL & (OPA_CALCTL_CALTRG0_Msk << (u32OpaNum))) {} + + u32CALResult = ((opa)->CALST >> ((u32OpaNum)*4U)) & (OPA_CALST_CALNS0_Msk|OPA_CALST_CALPS0_Msk); + if (u32CALResult == 0U) + { + i32Ret = 0L; + } + else if (u32CALResult == OPA_CALST_CALNS0_Msk) + { + i32Ret = -2L; + } + else if (u32CALResult == OPA_CALST_CALPS0_Msk) + { + i32Ret = -1L; + } + else if (u32CALResult == (OPA_CALST_CALNS0_Msk|OPA_CALST_CALPS0_Msk)) + { + i32Ret = -3L; + } + + return i32Ret; +} + +/** + * @brief This macro is used to generate asynchronous reset signals to OPA controller + * @param None + * @return None + * \hideinitializer + */ +#define OPA_Reset() \ +do { \ + SYS->IPRST2 |= SYS_IPRST2_OPARST_Msk; \ + SYS->IPRST2 &= ~SYS_IPRST2_OPARST_Msk; \ +} while(0) + +/*@}*/ /* end of group OPA_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group OPA_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_OPA_H__ */ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_otg.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_otg.h new file mode 100644 index 00000000000..21c4b8be240 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_otg.h @@ -0,0 +1,268 @@ +/**************************************************************************//** + * @file nu_otg.h + * @version V0.10 + * @brief M480 Series OTG Driver Header File + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + ******************************************************************************/ +#ifndef __NU_OTG_H__ +#define __NU_OTG_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup OTG_Driver OTG Driver + @{ +*/ + + +/** @addtogroup OTG_EXPORTED_CONSTANTS OTG Exported Constants + @{ +*/ + + + +/*---------------------------------------------------------------------------------------------------------*/ +/* OTG constant definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define OTG_VBUS_EN_ACTIVE_HIGH (0UL) /*!< USB VBUS power switch enable signal is active high. \hideinitializer */ +#define OTG_VBUS_EN_ACTIVE_LOW (1UL) /*!< USB VBUS power switch enable signal is active low. \hideinitializer */ +#define OTG_VBUS_ST_VALID_HIGH (0UL) /*!< USB VBUS power switch valid status is high. \hideinitializer */ +#define OTG_VBUS_ST_VALID_LOW (1UL) /*!< USB VBUS power switch valid status is low. \hideinitializer */ + + +/*@}*/ /* end of group OTG_EXPORTED_CONSTANTS */ + + +/** @addtogroup OTG_EXPORTED_FUNCTIONS OTG Exported Functions + @{ +*/ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Define Macros and functions */ +/*---------------------------------------------------------------------------------------------------------*/ + + +/** + * @brief This macro is used to enable OTG function + * @param None + * @return None + * @details This macro will set OTGEN bit of OTG_CTL register to enable OTG function. + * \hideinitializer + */ +#define OTG_ENABLE() (OTG->CTL |= OTG_CTL_OTGEN_Msk) + +/** + * @brief This macro is used to disable OTG function + * @param None + * @return None + * @details This macro will clear OTGEN bit of OTG_CTL register to disable OTG function. + * \hideinitializer + */ +#define OTG_DISABLE() (OTG->CTL &= ~OTG_CTL_OTGEN_Msk) + +/** + * @brief This macro is used to enable USB PHY + * @param None + * @return None + * @details When the USB role is selected as OTG device, use this macro to enable USB PHY. + * This macro will set OTGPHYEN bit of OTG_PHYCTL register to enable USB PHY. + * \hideinitializer + */ +#define OTG_ENABLE_PHY() (OTG->PHYCTL |= OTG_PHYCTL_OTGPHYEN_Msk) + +/** + * @brief This macro is used to disable USB PHY + * @param None + * @return None + * @details This macro will clear OTGPHYEN bit of OTG_PHYCTL register to disable USB PHY. + * \hideinitializer + */ +#define OTG_DISABLE_PHY() (OTG->PHYCTL &= ~OTG_PHYCTL_OTGPHYEN_Msk) + +/** + * @brief This macro is used to enable ID detection function + * @param None + * @return None + * @details This macro will set IDDETEN bit of OTG_PHYCTL register to enable ID detection function. + * \hideinitializer + */ +#define OTG_ENABLE_ID_DETECT() (OTG->PHYCTL |= OTG_PHYCTL_IDDETEN_Msk) + +/** + * @brief This macro is used to disable ID detection function + * @param None + * @return None + * @details This macro will clear IDDETEN bit of OTG_PHYCTL register to disable ID detection function. + * \hideinitializer + */ +#define OTG_DISABLE_ID_DETECT() (OTG->PHYCTL &= ~OTG_PHYCTL_IDDETEN_Msk) + +/** + * @brief This macro is used to enable OTG wake-up function + * @param None + * @return None + * @details This macro will set WKEN bit of OTG_CTL register to enable OTG wake-up function. + * \hideinitializer + */ +#define OTG_ENABLE_WAKEUP() (OTG->CTL |= OTG_CTL_WKEN_Msk) + +/** + * @brief This macro is used to disable OTG wake-up function + * @param None + * @return None + * @details This macro will clear WKEN bit of OTG_CTL register to disable OTG wake-up function. + * \hideinitializer + */ +#define OTG_DISABLE_WAKEUP() (OTG->CTL &= ~OTG_CTL_WKEN_Msk) + +/** + * @brief This macro is used to set the polarity of USB_VBUS_EN pin + * @param[in] u32Pol The polarity selection. Valid values are listed below. + * - \ref OTG_VBUS_EN_ACTIVE_HIGH + * - \ref OTG_VBUS_EN_ACTIVE_LOW + * @return None + * @details This macro is used to set the polarity of external USB VBUS power switch enable signal. + * \hideinitializer + */ +#define OTG_SET_VBUS_EN_POL(u32Pol) (OTG->PHYCTL = (OTG->PHYCTL & (~OTG_PHYCTL_VBENPOL_Msk)) | ((u32Pol)<PHYCTL = (OTG->PHYCTL & (~OTG_PHYCTL_VBSTSPOL_Msk)) | ((u32Pol)<INTEN |= (u32Mask)) + +/** + * @brief This macro is used to disable OTG related interrupts + * @param[in] u32Mask The combination of interrupt source. Each bit corresponds to a interrupt source. Valid values are listed below. + * - \ref OTG_INTEN_ROLECHGIEN_Msk + * - \ref OTG_INTEN_VBEIEN_Msk + * - \ref OTG_INTEN_SRPFIEN_Msk + * - \ref OTG_INTEN_HNPFIEN_Msk + * - \ref OTG_INTEN_GOIDLEIEN_Msk + * - \ref OTG_INTEN_IDCHGIEN_Msk + * - \ref OTG_INTEN_PDEVIEN_Msk + * - \ref OTG_INTEN_HOSTIEN_Msk + * - \ref OTG_INTEN_BVLDCHGIEN_Msk + * - \ref OTG_INTEN_AVLDCHGIEN_Msk + * - \ref OTG_INTEN_VBCHGIEN_Msk + * - \ref OTG_INTEN_SECHGIEN_Msk + * - \ref OTG_INTEN_SRPDETIEN_Msk + * @return None + * @details This macro will disable OTG related interrupts specified by u32Mask parameter. + * \hideinitializer + */ +#define OTG_DISABLE_INT(u32Mask) (OTG->INTEN &= ~(u32Mask)) + +/** + * @brief This macro is used to get OTG related interrupt flags + * @param[in] u32Mask The combination of interrupt source. Each bit corresponds to a interrupt source. Valid values are listed below. + * - \ref OTG_INTSTS_ROLECHGIF_Msk + * - \ref OTG_INTSTS_VBEIF_Msk + * - \ref OTG_INTSTS_SRPFIF_Msk + * - \ref OTG_INTSTS_HNPFIF_Msk + * - \ref OTG_INTSTS_GOIDLEIF_Msk + * - \ref OTG_INTSTS_IDCHGIF_Msk + * - \ref OTG_INTSTS_PDEVIF_Msk + * - \ref OTG_INTSTS_HOSTIF_Msk + * - \ref OTG_INTSTS_BVLDCHGIF_Msk + * - \ref OTG_INTSTS_AVLDCHGIF_Msk + * - \ref OTG_INTSTS_VBCHGIF_Msk + * - \ref OTG_INTSTS_SECHGIF_Msk + * - \ref OTG_INTSTS_SRPDETIF_Msk + * @return Interrupt flags of selected sources. + * @details This macro will return OTG related interrupt flags specified by u32Mask parameter. + * \hideinitializer + */ +#define OTG_GET_INT_FLAG(u32Mask) (OTG->INTSTS & (u32Mask)) + +/** + * @brief This macro is used to clear OTG related interrupt flags + * @param[in] u32Mask The combination of interrupt source. Each bit corresponds to a interrupt source. Valid values are listed below. + * - \ref OTG_INTSTS_ROLECHGIF_Msk + * - \ref OTG_INTSTS_VBEIF_Msk + * - \ref OTG_INTSTS_SRPFIF_Msk + * - \ref OTG_INTSTS_HNPFIF_Msk + * - \ref OTG_INTSTS_GOIDLEIF_Msk + * - \ref OTG_INTSTS_IDCHGIF_Msk + * - \ref OTG_INTSTS_PDEVIF_Msk + * - \ref OTG_INTSTS_HOSTIF_Msk + * - \ref OTG_INTSTS_BVLDCHGIF_Msk + * - \ref OTG_INTSTS_AVLDCHGIF_Msk + * - \ref OTG_INTSTS_VBCHGIF_Msk + * - \ref OTG_INTSTS_SECHGIF_Msk + * - \ref OTG_INTSTS_SRPDETIF_Msk + * @return None + * @details This macro will clear OTG related interrupt flags specified by u32Mask parameter. + * \hideinitializer + */ +#define OTG_CLR_INT_FLAG(u32Mask) (OTG->INTSTS = (u32Mask)) + +/** + * @brief This macro is used to get OTG related status + * @param[in] u32Mask The combination of user specified source. Valid values are listed below. + * - \ref OTG_STATUS_OVERCUR_Msk + * - \ref OTG_STATUS_IDSTS_Msk + * - \ref OTG_STATUS_SESSEND_Msk + * - \ref OTG_STATUS_BVLD_Msk + * - \ref OTG_STATUS_AVLD_Msk + * - \ref OTG_STATUS_VBUSVLD_Msk + * @return The user specified status. + * @details This macro will return OTG related status specified by u32Mask parameter. + * \hideinitializer + */ +#define OTG_GET_STATUS(u32Mask) (OTG->STATUS & (u32Mask)) + + + +/*@}*/ /* end of group OTG_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group OTG_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + + +#ifdef __cplusplus +} +#endif + + +#endif /*__NU_OTG_H__ */ + +/*** (C) COPYRIGHT 2017 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_pdma.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_pdma.h new file mode 100644 index 00000000000..8579994db78 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_pdma.h @@ -0,0 +1,391 @@ +/**************************************************************************//** + * @file nu_pdma.h + * @version V1.00 + * @brief M480 series PDMA driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __NU_PDMA_H__ +#define __NU_PDMA_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup PDMA_Driver PDMA Driver + @{ +*/ + +/** @addtogroup PDMA_EXPORTED_CONSTANTS PDMA Exported Constants + @{ +*/ +#define PDMA_CH_MAX 16UL /*!< Specify Maximum Channels of PDMA \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Operation Mode Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define PDMA_OP_STOP 0x00000000UL /*!INTSTS)) + +/** + * @brief Get Transfer Done Interrupt Status + * + * @param[in] pdma The pointer of the specified PDMA module + * + * @return None + * + * @details Get the transfer done Interrupt status. + * \hideinitializer + */ +#define PDMA_GET_TD_STS(pdma) ((uint32_t)(pdma->TDSTS)) + +/** + * @brief Clear Transfer Done Interrupt Status + * + * @param[in] pdma The pointer of the specified PDMA module + * + * @param[in] u32Mask The channel mask + * + * @return None + * + * @details Clear the transfer done Interrupt status. + * \hideinitializer + */ +#define PDMA_CLR_TD_FLAG(pdma,u32Mask) ((uint32_t)(pdma->TDSTS = (u32Mask))) + +/** + * @brief Get Target Abort Interrupt Status + * + * @param[in] pdma The pointer of the specified PDMA module + * + * @return None + * + * @details Get the target abort Interrupt status. + * \hideinitializer + */ +#define PDMA_GET_ABORT_STS(pdma) ((uint32_t)(pdma->ABTSTS)) + +/** + * @brief Clear Target Abort Interrupt Status + * + * @param[in] pdma The pointer of the specified PDMA module + * + * @param[in] u32Mask The channel mask + * + * @return None + * + * @details Clear the target abort Interrupt status. + * \hideinitializer + */ +#define PDMA_CLR_ABORT_FLAG(pdma,u32Mask) ((uint32_t)(pdma->ABTSTS = (u32Mask))) + +/** + * @brief Get Alignment Interrupt Status + * + * @param[in] pdma The pointer of the specified PDMA module + * + * @return None + * + * @details Get Alignment Interrupt status. + * \hideinitializer + */ +#define PDMA_GET_ALIGN_STS(pdma) ((uint32_t)(PDMA->ALIGN)) + +/** + * @brief Clear Alignment Interrupt Status + * + * @param[in] pdma The pointer of the specified PDMA module + * @param[in] u32Mask The channel mask + * + * @return None + * + * @details Clear the Alignment Interrupt status. + * \hideinitializer + */ +#define PDMA_CLR_ALIGN_FLAG(pdma,u32Mask) ((uint32_t)(pdma->ALIGN = (u32Mask))) + +/** + * @brief Clear Timeout Interrupt Status + * + * @param[in] pdma The pointer of the specified PDMA module + * @param[in] u32Ch The selected channel + * + * @return None + * + * @details Clear the selected channel timeout interrupt status. + * \hideinitializer + */ +#define PDMA_CLR_TMOUT_FLAG(pdma,u32Ch) ((uint32_t)(pdma->INTSTS = (1 << ((u32Ch) + 8)))) + +/** + * @brief Check Channel Status + * + * @param[in] pdma The pointer of the specified PDMA module + * @param[in] u32Ch The selected channel + * + * @retval 0 Idle state + * @retval 1 Busy state + * + * @details Check the selected channel is busy or not. + * \hideinitializer + */ +#define PDMA_IS_CH_BUSY(pdma,u32Ch) ((uint32_t)(pdma->TRGSTS & (1 << (u32Ch)))? 1 : 0) + +/** + * @brief Set Source Address + * + * @param[in] pdma The pointer of the specified PDMA module + * @param[in] u32Ch The selected channel + * @param[in] u32Addr The selected address + * + * @return None + * + * @details This macro set the selected channel source address. + * \hideinitializer + */ +#define PDMA_SET_SRC_ADDR(pdma,u32Ch, u32Addr) ((uint32_t)(pdma->DSCT[(u32Ch)].SA = (u32Addr))) + +/** + * @brief Set Destination Address + * + * @param[in] pdma The pointer of the specified PDMA module + * @param[in] u32Ch The selected channel + * @param[in] u32Addr The selected address + * + * @return None + * + * @details This macro set the selected channel destination address. + * \hideinitializer + */ +#define PDMA_SET_DST_ADDR(pdma,u32Ch, u32Addr) ((uint32_t)(pdma->DSCT[(u32Ch)].DA = (u32Addr))) + +/** + * @brief Set Transfer Count + * + * @param[in] pdma The pointer of the specified PDMA module + * @param[in] u32Ch The selected channel + * @param[in] u32TransCount Transfer Count + * + * @return None + * + * @details This macro set the selected channel transfer count. + * \hideinitializer + */ +#define PDMA_SET_TRANS_CNT(pdma,u32Ch, u32TransCount) ((uint32_t)(pdma->DSCT[(u32Ch)].CTL=(pdma->DSCT[(u32Ch)].CTL&~PDMA_DSCT_CTL_TXCNT_Msk)|(((u32TransCount)-1) << PDMA_DSCT_CTL_TXCNT_Pos))) + +/** + * @brief Set Scatter-gather descriptor Address + * + * @param[in] pdma The pointer of the specified PDMA module + * @param[in] u32Ch The selected channel + * @param[in] u32Addr The descriptor address + * + * @return None + * + * @details This macro set the selected channel scatter-gather descriptor address. + * \hideinitializer + */ +#define PDMA_SET_SCATTER_DESC(pdma,u32Ch, u32Addr) ((uint32_t)(pdma->DSCT[(u32Ch)].NEXT = (u32Addr) - (pdma->SCATBA))) + +/** + * @brief Stop the channel + * + * @param[in] pdma The pointer of the specified PDMA module + * + * @param[in] u32Ch The selected channel + * + * @return None + * + * @details This macro stop the selected channel. + * \hideinitializer + */ +#define PDMA_STOP(pdma,u32Ch) ((uint32_t)(pdma->PAUSE = (1 << (u32Ch)))) + +/** + * @brief Pause the channel + * + * @param[in] pdma The pointer of the specified PDMA module + * + * @param[in] u32Ch The selected channel + * + * @return None + * + * @details This macro pause the selected channel. + * \hideinitializer + */ +#define PDMA_PAUSE(pdma,u32Ch) ((uint32_t)(pdma->PAUSE = (1 << (u32Ch)))) + +/*---------------------------------------------------------------------------------------------------------*/ +/* Define PDMA functions prototype */ +/*---------------------------------------------------------------------------------------------------------*/ +void PDMA_Open(PDMA_T * pdma,uint32_t u32Mask); +void PDMA_Close(PDMA_T * pdma); +void PDMA_SetTransferCnt(PDMA_T * pdma,uint32_t u32Ch, uint32_t u32Width, uint32_t u32TransCount); +void PDMA_SetTransferAddr(PDMA_T * pdma,uint32_t u32Ch, uint32_t u32SrcAddr, uint32_t u32SrcCtrl, uint32_t u32DstAddr, uint32_t u32DstCtrl); +void PDMA_SetTransferMode(PDMA_T * pdma,uint32_t u32Ch, uint32_t u32Peripheral, uint32_t u32ScatterEn, uint32_t u32DescAddr); +void PDMA_SetBurstType(PDMA_T * pdma,uint32_t u32Ch, uint32_t u32BurstType, uint32_t u32BurstSize); +void PDMA_EnableTimeout(PDMA_T * pdma,uint32_t u32Mask); +void PDMA_DisableTimeout(PDMA_T * pdma,uint32_t u32Mask); +void PDMA_SetTimeOut(PDMA_T * pdma,uint32_t u32Ch, uint32_t u32OnOff, uint32_t u32TimeOutCnt); +void PDMA_Trigger(PDMA_T * pdma,uint32_t u32Ch); +void PDMA_EnableInt(PDMA_T * pdma,uint32_t u32Ch, uint32_t u32Mask); +void PDMA_DisableInt(PDMA_T * pdma,uint32_t u32Ch, uint32_t u32Mask); +void PDMA_SetStride(PDMA_T * pdma,uint32_t u32Ch, uint32_t u32DestLen, uint32_t u32SrcLen, uint32_t u32TransCount); +void PDMA_SetRepeat(PDMA_T * pdma,uint32_t u32Ch, uint32_t u32DestInterval, uint32_t u32SrcInterval, uint32_t u32RepeatCount); + + +/*@}*/ /* end of group PDMA_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group PDMA_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_PDMA_H__ */ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_qei.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_qei.h new file mode 100644 index 00000000000..217d506fd2a --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_qei.h @@ -0,0 +1,390 @@ +/**************************************************************************//** + * @file nu_qei.h + * @version V3.00 + * @brief Quadrature Encoder Interface (QEI) driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. +*****************************************************************************/ +#ifndef __NU_QEI_H__ +#define __NU_QEI_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup QEI_Driver QEI Driver + @{ +*/ + +/** @addtogroup QEI_EXPORTED_CONSTANTS QEI Exported Constants + @{ +*/ + +/*---------------------------------------------------------------------------------------------------------*/ +/* QEI counting mode selection constants definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define QEI_CTL_X4_FREE_COUNTING_MODE (0x0<CTL &= (~QEI_CTL_CMPEN_Msk)) + +/** + * @brief Enable QEI compare function + * @param[in] qei The pointer of the specified QEI module. + * @return None + * @details This macro enable QEI counter compare function. + * \hideinitializer + */ +#define QEI_ENABLE_CNT_CMP(qei) ((qei)->CTL |= QEI_CTL_CMPEN_Msk) + +/** + * @brief Disable QEI index latch function + * @param[in] qei The pointer of the specified QEI module. + * @return None + * @details This macro disable QEI index trigger counter latch function. + * \hideinitializer + */ +#define QEI_DISABLE_INDEX_LATCH(qei) ((qei)->CTL &= (~QEI_CTL_IDXLATEN_Msk)) + +/** + * @brief Enable QEI index latch function + * @param[in] qei The pointer of the specified QEI module. + * @return None + * @details This macro enable QEI index trigger counter latch function. + * \hideinitializer + */ +#define QEI_ENABLE_INDEX_LATCH(qei) ((qei)->CTL |= QEI_CTL_IDXLATEN_Msk) + +/** + * @brief Disable QEI index reload function + * @param[in] qei The pointer of the specified QEI module. + * @return None + * @details This macro disable QEI index trigger counter reload function. + * \hideinitializer + */ +#define QEI_DISABLE_INDEX_RELOAD(qei) ((qei)->CTL &= (~QEI_CTL_IDXRLDEN_Msk)) + +/** + * @brief Enable QEI index reload function + * @param[in] qei The pointer of the specified QEI module. + * @return None + * @details This macro enable QEI index trigger counter reload function. + * \hideinitializer + */ +#define QEI_ENABLE_INDEX_RELOAD(qei) ((qei)->CTL |= QEI_CTL_IDXRLDEN_Msk) + +/** + * @brief Disable QEI input + * @param[in] qei The pointer of the specified QEI module. + * @param[in] u32InputType Input signal type. + * - \ref QEI_CTL_CHAEN_Msk : QEA input + * - \ref QEI_CTL_CHAEN_Msk : QEB input + * - \ref QEI_CTL_IDXEN_Msk : IDX input + * @return None + * @details This macro disable specified QEI signal input. + * \hideinitializer + */ +#define QEI_DISABLE_INPUT(qei, u32InputType) ((qei)->CTL &= ~(u32InputType)) + +/** + * @brief Enable QEI input + * @param[in] qei The pointer of the specified QEI module. + * @param[in] u32InputType Input signal type . + * - \ref QEI_CTL_CHAEN_Msk : QEA input + * - \ref QEI_CTL_CHBEN_Msk : QEB input + * - \ref QEI_CTL_IDXEN_Msk : IDX input + * @return None + * @details This macro enable specified QEI signal input. + * \hideinitializer + */ +#define QEI_ENABLE_INPUT(qei, u32InputType) ((qei)->CTL |= (u32InputType)) + +/** + * @brief Disable inverted input polarity + * @param[in] qei The pointer of the specified QEI module. + * @param[in] u32InputType Input signal type . + * - \ref QEI_CTL_CHAINV_Msk : QEA Input + * - \ref QEI_CTL_CHBINV_Msk : QEB Input + * - \ref QEI_CTL_IDXINV_Msk : IDX Input + * @return None + * @details This macro disable specified QEI signal inverted input polarity. + * \hideinitializer + */ +#define QEI_DISABLE_INPUT_INV(qei, u32InputType) ((qei)->CTL &= ~(u32InputType)) + +/** + * @brief Enable inverted input polarity + * @param[in] qei The pointer of the specified QEI module. + * @param[in] u32InputType Input signal type. + * - \ref QEI_CTL_CHAINV_Msk : QEA Input + * - \ref QEI_CTL_CHBINV_Msk : QEB Input + * - \ref QEI_CTL_IDXINV_Msk : IDX Input + * @return None + * @details This macro inverse specified QEI signal input polarity. + * \hideinitializer + */ +#define QEI_ENABLE_INPUT_INV(qei, u32InputType) ((qei)->CTL |= (u32InputType)) + +/** + * @brief Disable QEI interrupt + * @param[in] qei The pointer of the specified QEI module. + * @param[in] u32IntSel Interrupt type selection. + * - \ref QEI_CTL_DIRIEN_Msk : Direction change interrupt + * - \ref QEI_CTL_OVUNIEN_Msk : Counter overflow or underflow interrupt + * - \ref QEI_CTL_CMPIEN_Msk : Compare-match interrupt + * - \ref QEI_CTL_IDXIEN_Msk : Index detected interrupt + * @return None + * @details This macro disable specified QEI interrupt. + * \hideinitializer + */ +#define QEI_DISABLE_INT(qei, u32IntSel) ((qei)->CTL &= ~(u32IntSel)) + +/** + * @brief Enable QEI interrupt + * @param[in] qei The pointer of the specified QEI module. + * @param[in] u32IntSel Interrupt type selection. + * - \ref QEI_CTL_DIRIEN_Msk : Direction change interrupt + * - \ref QEI_CTL_OVUNIEN_Msk : Counter overflow or underflow interrupt + * - \ref QEI_CTL_CMPIEN_Msk : Compare-match interrupt + * - \ref QEI_CTL_IDXIEN_Msk : Index detected interrupt + * @return None + * @details This macro enable specified QEI interrupt. + * \hideinitializer + */ +#define QEI_ENABLE_INT(qei, u32IntSel) ((qei)->CTL |= (u32IntSel)) + +/** + * @brief Disable QEI noise filter + * @param[in] qei The pointer of the specified QEI module. + * @return None + * @details This macro disable QEI noise filter function. + * \hideinitializer + */ +#define QEI_DISABLE_NOISE_FILTER(qei) ((qei)->CTL |= QEI_CTL_NFDIS_Msk) + +/** + * @brief Enable QEI noise filter + * @param[in] qei The pointer of the specified QEI module. + * @param[in] u32ClkSel The sampling frequency of the noise filter clock. + * - \ref QEI_CTL_NFCLKSEL_DIV1 + * - \ref QEI_CTL_NFCLKSEL_DIV2 + * - \ref QEI_CTL_NFCLKSEL_DIV4 + * - \ref QEI_CTL_NFCLKSEL_DIV16 + * - \ref QEI_CTL_NFCLKSEL_DIV32 + * - \ref QEI_CTL_NFCLKSEL_DIV64 + * @return None + * @details This macro enable QEI noise filter function and select noise filter clock. + * \hideinitializer + */ +#define QEI_ENABLE_NOISE_FILTER(qei, u32ClkSel) ((qei)->CTL = ((qei)->CTL & (~(QEI_CTL_NFDIS_Msk|QEI_CTL_NFCLKSEL_Msk))) | (u32ClkSel)) + +/** + * @brief Get QEI counter value + * @param[in] qei The pointer of the specified QEI module. + * @return QEI pulse counter register value. + * @details This macro get QEI pulse counter value. + * \hideinitializer + */ +#define QEI_GET_CNT_VALUE(qei) ((qei)->CNT) + +/** + * @brief Get QEI counting direction + * @param[in] qei The pointer of the specified QEI module. + * @retval 0 QEI counter is in down-counting. + * @retval 1 QEI counter is in up-counting. + * @details This macro get QEI counting direction. + * \hideinitializer + */ +#define QEI_GET_DIR(qei) (((qei)->STATUS & (QEI_STATUS_DIRF_Msk))?1:0) + +/** + * @brief Get QEI counter hold value + * @param[in] qei The pointer of the specified QEI module. + * @return QEI pulse counter hold register value. + * @details This macro get QEI pulse counter hold value, which is updated with counter value in hold counter value control. + * \hideinitializer + */ +#define QEI_GET_HOLD_VALUE(qei) ((qei)->CNTHOLD) + +/** + * @brief Get QEI counter index latch value + * @param[in] qei The pointer of the specified QEI module. + * @return QEI pulse counter index latch value + * @details This macro get QEI pulse counter index latch value, which is updated with counter value when the index is detected. + * \hideinitializer + */ +#define QEI_GET_INDEX_LATCH_VALUE(qei) ((qei)->CNTLATCH) + +/** + * @brief Set QEI counter index latch value + * @param[in] qei The pointer of the specified QEI module. + * @param[in] u32Val The latch value. + * @return QEI pulse counter index latch value + * @details This macro set QEI pulse counter index latch value, which is updated with counter value when the index is detected. + * \hideinitializer + */ +#define QEI_SET_INDEX_LATCH_VALUE(qei,u32Val) ((qei)->CNTLATCH = (u32Val)) + +/** + * @brief Get QEI interrupt flag status + * @param[in] qei The pointer of the specified QEI module. + * @param[in] u32IntSel Interrupt type selection. +* - \ref QEI_STATUS_DIRF_Msk : Counting direction flag + * - \ref QEI_STATUS_DIRCHGF_Msk : Direction change flag + * - \ref QEI_STATUS_OVUNF_Msk : Counter overflow or underflow flag + * - \ref QEI_STATUS_CMPF_Msk : Compare-match flag + * - \ref QEI_STATUS_IDXF_Msk : Index detected flag + * @retval 0 QEI specified interrupt flag is not set. + * @retval 1 QEI specified interrupt flag is set. + * @details This macro get QEI specified interrupt flag status. + * \hideinitializer + */ +#define QEI_GET_INT_FLAG(qei, u32IntSel) (((qei)->STATUS & (u32IntSel))?1:0) + + +/** + * @brief Clear QEI interrupt flag + * @param[in] qei The pointer of the specified QEI module. + * @param[in] u32IntSel Interrupt type selection. + * - \ref QEI_STATUS_DIRCHGF_Msk : Direction change flag + * - \ref QEI_STATUS_OVUNF_Msk : Counter overflow or underflow flag + * - \ref QEI_STATUS_CMPF_Msk : Compare-match flag + * - \ref QEI_STATUS_IDXF_Msk : Index detected flag + * @return None + * @details This macro clear QEI specified interrupt flag. + * \hideinitializer + */ +#define QEI_CLR_INT_FLAG(qei, u32IntSel) ((qei)->STATUS = (u32IntSel)) + +/** + * @brief Set QEI counter compare value + * @param[in] qei The pointer of the specified QEI module. + * @param[in] u32Value The counter compare value. + * @return None + * @details This macro set QEI pulse counter compare value. + * \hideinitializer + */ +#define QEI_SET_CNT_CMP(qei, u32Value) ((qei)->CNTCMP = (u32Value)) + +/** + * @brief Set QEI counter value + * @param[in] qei The pointer of the specified QEI module. + * @param[in] u32Value The counter compare value. + * @return None + * @details This macro set QEI pulse counter value. + * \hideinitializer + */ +#define QEI_SET_CNT_VALUE(qei, u32Value) ((qei)->CNT = (u32Value)) + +/** + * @brief Enable QEI counter hold mode + * @param[in] qei The pointer of the specified QEI module. + * @param[in] u32Type The triggered type. + * - \ref QEI_CTL_HOLDCNT_Msk : Hold QEI_CNT control + * - \ref QEI_CTL_HOLDTMR0_Msk : Hold QEI_CNT by Timer0 + * - \ref QEI_CTL_HOLDTMR1_Msk : Hold QEI_CNT by Timer1 + * - \ref QEI_CTL_HOLDTMR2_Msk : Hold QEI_CNT by Timer2 + * - \ref QEI_CTL_HOLDTMR3_Msk : Hold QEI_CNT by Timer3 + * @return None + * @details This macro enable QEI counter hold mode. + * \hideinitializer + */ +#define QEI_ENABLE_HOLD_TRG_SRC(qei, u32Type) ((qei)->CTL |= (u32Type)) + +/** + * @brief Disable QEI counter hold mode + * @param[in] qei The pointer of the specified QEI module. + * @param[in] u32Type The triggered type. + * - \ref QEI_CTL_HOLDCNT_Msk : Hold QEI_CNT control + * - \ref QEI_CTL_HOLDTMR0_Msk : Hold QEI_CNT by Timer0 + * - \ref QEI_CTL_HOLDTMR1_Msk : Hold QEI_CNT by Timer1 + * - \ref QEI_CTL_HOLDTMR2_Msk : Hold QEI_CNT by Timer2 + * - \ref QEI_CTL_HOLDTMR3_Msk : Hold QEI_CNT by Timer3 + * @return None + * @details This macro disable QEI counter hold mode. + * \hideinitializer + */ +#define QEI_DISABLE_HOLD_TRG_SRC(qei, u32Type) ((qei)->CTL &= ~(u32Type)) + +/** + * @brief Set QEI maximum count value + * @param[in] qei The pointer of the specified QEI module. + * @param[in] u32Value The counter maximum value. + * @return QEI maximum count value + * @details This macro set QEI maximum count value. + * \hideinitializer + */ +#define QEI_SET_CNT_MAX(qei, u32Value) ((qei)->CNTMAX = (u32Value)) + +/** + * @brief Set QEI counting mode + * @param[in] qei The pointer of the specified QEI module. + * @param[in] u32Mode QEI counting mode. + * - \ref QEI_CTL_X4_FREE_COUNTING_MODE + * - \ref QEI_CTL_X2_FREE_COUNTING_MODE + * - \ref QEI_CTL_X4_COMPARE_COUNTING_MODE + * - \ref QEI_CTL_X2_COMPARE_COUNTING_MODE + * @return None + * @details This macro set QEI counting mode. + * \hideinitializer + */ +#define QEI_SET_CNT_MODE(qei, u32Mode) ((qei)->CTL = ((qei)->CTL & (~QEI_CTL_MODE_Msk)) | (u32Mode)) + + +void QEI_Close(QEI_T* qei); +void QEI_DisableInt(QEI_T* qei, uint32_t u32IntSel); +void QEI_EnableInt(QEI_T* qei, uint32_t u32IntSel); +void QEI_Open(QEI_T* qei, uint32_t u32Mode, uint32_t u32Value); +void QEI_Start(QEI_T* qei); +void QEI_Stop(QEI_T* qei); + + +/*@}*/ /* end of group QEI_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group QEI_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_QEI_H__ */ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_qspi.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_qspi.h new file mode 100644 index 00000000000..64114525e1e --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_qspi.h @@ -0,0 +1,357 @@ +/**************************************************************************//** + * @file nu_qspi.h + * @version V3.00 + * @brief M480 series QSPI driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. +*****************************************************************************/ +#ifndef __NU_QSPI_H__ +#define __NU_QSPI_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup QSPI_Driver QSPI Driver + @{ +*/ + +/** @addtogroup QSPI_EXPORTED_CONSTANTS QSPI Exported Constants + @{ +*/ + +#define QSPI_MODE_0 (QSPI_CTL_TXNEG_Msk) /*!< CLKPOL=0; RXNEG=0; TXNEG=1 \hideinitializer */ +#define QSPI_MODE_1 (QSPI_CTL_RXNEG_Msk) /*!< CLKPOL=0; RXNEG=1; TXNEG=0 \hideinitializer */ +#define QSPI_MODE_2 (QSPI_CTL_CLKPOL_Msk | QSPI_CTL_RXNEG_Msk) /*!< CLKPOL=1; RXNEG=1; TXNEG=0 \hideinitializer */ +#define QSPI_MODE_3 (QSPI_CTL_CLKPOL_Msk | QSPI_CTL_TXNEG_Msk) /*!< CLKPOL=1; RXNEG=0; TXNEG=1 \hideinitializer */ + +#define QSPI_SLAVE (QSPI_CTL_SLAVE_Msk) /*!< Set as slave \hideinitializer */ +#define QSPI_MASTER (0x0U) /*!< Set as master \hideinitializer */ + +#define QSPI_SS (QSPI_SSCTL_SS_Msk) /*!< Set SS \hideinitializer */ +#define QSPI_SS_ACTIVE_HIGH (QSPI_SSCTL_SSACTPOL_Msk) /*!< SS active high \hideinitializer */ +#define QSPI_SS_ACTIVE_LOW (0x0U) /*!< SS active low \hideinitializer */ + +/* QSPI Interrupt Mask */ +#define QSPI_UNIT_INT_MASK (0x001U) /*!< Unit transfer interrupt mask \hideinitializer */ +#define QSPI_SSACT_INT_MASK (0x002U) /*!< Slave selection signal active interrupt mask \hideinitializer */ +#define QSPI_SSINACT_INT_MASK (0x004U) /*!< Slave selection signal inactive interrupt mask \hideinitializer */ +#define QSPI_SLVUR_INT_MASK (0x008U) /*!< Slave under run interrupt mask \hideinitializer */ +#define QSPI_SLVBE_INT_MASK (0x010U) /*!< Slave bit count error interrupt mask \hideinitializer */ +#define QSPI_TXUF_INT_MASK (0x040U) /*!< Slave TX underflow interrupt mask \hideinitializer */ +#define QSPI_FIFO_TXTH_INT_MASK (0x080U) /*!< FIFO TX threshold interrupt mask \hideinitializer */ +#define QSPI_FIFO_RXTH_INT_MASK (0x100U) /*!< FIFO RX threshold interrupt mask \hideinitializer */ +#define QSPI_FIFO_RXOV_INT_MASK (0x200U) /*!< FIFO RX overrun interrupt mask \hideinitializer */ +#define QSPI_FIFO_RXTO_INT_MASK (0x400U) /*!< FIFO RX time-out interrupt mask \hideinitializer */ + +/* QSPI Status Mask */ +#define QSPI_BUSY_MASK (0x01U) /*!< Busy status mask \hideinitializer */ +#define QSPI_RX_EMPTY_MASK (0x02U) /*!< RX empty status mask \hideinitializer */ +#define QSPI_RX_FULL_MASK (0x04U) /*!< RX full status mask \hideinitializer */ +#define QSPI_TX_EMPTY_MASK (0x08U) /*!< TX empty status mask \hideinitializer */ +#define QSPI_TX_FULL_MASK (0x10U) /*!< TX full status mask \hideinitializer */ +#define QSPI_TXRX_RESET_MASK (0x20U) /*!< TX or RX reset status mask \hideinitializer */ +#define QSPI_QSPIEN_STS_MASK (0x40U) /*!< QSPIEN status mask \hideinitializer */ +#define QSPI_SSLINE_STS_MASK (0x80U) /*!< QSPIx_SS line status mask \hideinitializer */ + +/*@}*/ /* end of group QSPI_EXPORTED_CONSTANTS */ + + +/** @addtogroup QSPI_EXPORTED_FUNCTIONS QSPI Exported Functions + @{ +*/ + +/** + * @brief Clear the unit transfer interrupt flag. + * @param[in] qspi The pointer of the specified QSPI module. + * @return None. + * @details Write 1 to UNITIF bit of QSPI_STATUS register to clear the unit transfer interrupt flag. + * \hideinitializer + */ +#define QSPI_CLR_UNIT_TRANS_INT_FLAG(qspi) ((qspi)->STATUS = QSPI_STATUS_UNITIF_Msk) + +/** + * @brief Trigger RX PDMA function. + * @param[in] qspi The pointer of the specified QSPI module. + * @return None. + * @details Set RXPDMAEN bit of QSPI_PDMACTL register to enable RX PDMA transfer function. + * \hideinitializer + */ +#define QSPI_TRIGGER_RX_PDMA(qspi) ((qspi)->PDMACTL |= QSPI_PDMACTL_RXPDMAEN_Msk) + +/** + * @brief Trigger TX PDMA function. + * @param[in] qspi The pointer of the specified QSPI module. + * @return None. + * @details Set TXPDMAEN bit of QSPI_PDMACTL register to enable TX PDMA transfer function. + * \hideinitializer + */ +#define QSPI_TRIGGER_TX_PDMA(qspi) ((qspi)->PDMACTL |= QSPI_PDMACTL_TXPDMAEN_Msk) + +/** + * @brief Disable RX PDMA transfer. + * @param[in] qspi The pointer of the specified QSPI module. + * @return None. + * @details Clear RXPDMAEN bit of QSPI_PDMACTL register to disable RX PDMA transfer function. + * \hideinitializer + */ +#define QSPI_DISABLE_RX_PDMA(qspi) ( (qspi)->PDMACTL &= ~QSPI_PDMACTL_RXPDMAEN_Msk ) + +/** + * @brief Disable TX PDMA transfer. + * @param[in] qspi The pointer of the specified QSPI module. + * @return None. + * @details Clear TXPDMAEN bit of QSPI_PDMACTL register to disable TX PDMA transfer function. + * \hideinitializer + */ +#define QSPI_DISABLE_TX_PDMA(qspi) ( (qspi)->PDMACTL &= ~QSPI_PDMACTL_TXPDMAEN_Msk ) + +/** + * @brief Get the count of available data in RX FIFO. + * @param[in] qspi The pointer of the specified QSPI module. + * @return The count of available data in RX FIFO. + * @details Read RXCNT (QSPI_STATUS[27:24]) to get the count of available data in RX FIFO. + * \hideinitializer + */ +#define QSPI_GET_RX_FIFO_COUNT(qspi) (((qspi)->STATUS & QSPI_STATUS_RXCNT_Msk) >> QSPI_STATUS_RXCNT_Pos) + +/** + * @brief Get the RX FIFO empty flag. + * @param[in] qspi The pointer of the specified QSPI module. + * @retval 0 RX FIFO is not empty. + * @retval 1 RX FIFO is empty. + * @details Read RXEMPTY bit of QSPI_STATUS register to get the RX FIFO empty flag. + * \hideinitializer + */ +#define QSPI_GET_RX_FIFO_EMPTY_FLAG(qspi) (((qspi)->STATUS & QSPI_STATUS_RXEMPTY_Msk)>>QSPI_STATUS_RXEMPTY_Pos) + +/** + * @brief Get the TX FIFO empty flag. + * @param[in] qspi The pointer of the specified QSPI module. + * @retval 0 TX FIFO is not empty. + * @retval 1 TX FIFO is empty. + * @details Read TXEMPTY bit of QSPI_STATUS register to get the TX FIFO empty flag. + * \hideinitializer + */ +#define QSPI_GET_TX_FIFO_EMPTY_FLAG(qspi) (((qspi)->STATUS & QSPI_STATUS_TXEMPTY_Msk)>>QSPI_STATUS_TXEMPTY_Pos) + +/** + * @brief Get the TX FIFO full flag. + * @param[in] qspi The pointer of the specified QSPI module. + * @retval 0 TX FIFO is not full. + * @retval 1 TX FIFO is full. + * @details Read TXFULL bit of QSPI_STATUS register to get the TX FIFO full flag. + * \hideinitializer + */ +#define QSPI_GET_TX_FIFO_FULL_FLAG(qspi) (((qspi)->STATUS & QSPI_STATUS_TXFULL_Msk)>>QSPI_STATUS_TXFULL_Pos) + +/** + * @brief Get the datum read from RX register. + * @param[in] qspi The pointer of the specified QSPI module. + * @return Data in RX register. + * @details Read QSPI_RX register to get the received datum. + * \hideinitializer + */ +#define QSPI_READ_RX(qspi) ((qspi)->RX) + +/** + * @brief Write datum to TX register. + * @param[in] qspi The pointer of the specified QSPI module. + * @param[in] u32TxData The datum which user attempt to transfer through QSPI bus. + * @return None. + * @details Write u32TxData to QSPI_TX register. + * \hideinitializer + */ +#define QSPI_WRITE_TX(qspi, u32TxData) ((qspi)->TX = (u32TxData)) + +/** + * @brief Set QSPIx_SS pin to high state. + * @param[in] qspi The pointer of the specified QSPI module. + * @return None. + * @details Disable automatic slave selection function and set QSPIx_SS pin to high state. + * \hideinitializer + */ +#define QSPI_SET_SS_HIGH(qspi) ((qspi)->SSCTL = ((qspi)->SSCTL & (~QSPI_SSCTL_AUTOSS_Msk)) | (QSPI_SSCTL_SSACTPOL_Msk | QSPI_SSCTL_SS_Msk)) + +/** + * @brief Set QSPIx_SS pin to low state. + * @param[in] qspi The pointer of the specified QSPI module. + * @return None. + * @details Disable automatic slave selection function and set QSPIx_SS pin to low state. + * \hideinitializer + */ +#define QSPI_SET_SS_LOW(qspi) ((qspi)->SSCTL = ((qspi)->SSCTL & (~(QSPI_SSCTL_AUTOSS_Msk | QSPI_SSCTL_SSACTPOL_Msk))) | QSPI_SSCTL_SS_Msk) + +/** + * @brief Enable Byte Reorder function. + * @param[in] qspi The pointer of the specified QSPI module. + * @return None. + * @details Enable Byte Reorder function. The suspend interval depends on the setting of SUSPITV (QSPI_CTL[7:4]). + * \hideinitializer + */ +#define QSPI_ENABLE_BYTE_REORDER(qspi) ((qspi)->CTL |= QSPI_CTL_REORDER_Msk) + +/** + * @brief Disable Byte Reorder function. + * @param[in] qspi The pointer of the specified QSPI module. + * @return None. + * @details Clear REORDER bit field of QSPI_CTL register to disable Byte Reorder function. + * \hideinitializer + */ +#define QSPI_DISABLE_BYTE_REORDER(qspi) ((qspi)->CTL &= ~QSPI_CTL_REORDER_Msk) + +/** + * @brief Set the length of suspend interval. + * @param[in] qspi The pointer of the specified QSPI module. + * @param[in] u32SuspCycle Decides the length of suspend interval. It could be 0 ~ 15. + * @return None. + * @details Set the length of suspend interval according to u32SuspCycle. + * The length of suspend interval is ((u32SuspCycle + 0.5) * the length of one QSPI bus clock cycle). + * \hideinitializer + */ +#define QSPI_SET_SUSPEND_CYCLE(qspi, u32SuspCycle) ((qspi)->CTL = ((qspi)->CTL & ~QSPI_CTL_SUSPITV_Msk) | ((u32SuspCycle) << QSPI_CTL_SUSPITV_Pos)) + +/** + * @brief Set the QSPI transfer sequence with LSB first. + * @param[in] qspi The pointer of the specified QSPI module. + * @return None. + * @details Set LSB bit of QSPI_CTL register to set the QSPI transfer sequence with LSB first. + * \hideinitializer + */ +#define QSPI_SET_LSB_FIRST(qspi) ((qspi)->CTL |= QSPI_CTL_LSB_Msk) + +/** + * @brief Set the QSPI transfer sequence with MSB first. + * @param[in] qspi The pointer of the specified SPI module. + * @return None. + * @details Clear LSB bit of QSPI_CTL register to set the QSPI transfer sequence with MSB first. + * \hideinitializer + */ +#define QSPI_SET_MSB_FIRST(qspi) ((qspi)->CTL &= ~QSPI_CTL_LSB_Msk) + +/** + * @brief Set the data width of a QSPI transaction. + * @param[in] qspi The pointer of the specified QSPI module. + * @param[in] u32Width The bit width of one transaction. + * @return None. + * @details The data width can be 8 ~ 32 bits. + * \hideinitializer + */ +#define QSPI_SET_DATA_WIDTH(qspi, u32Width) ((qspi)->CTL = ((qspi)->CTL & ~QSPI_CTL_DWIDTH_Msk) | (((u32Width)&0x1F) << QSPI_CTL_DWIDTH_Pos)) + +/** + * @brief Get the QSPI busy state. + * @param[in] qspi The pointer of the specified QSPI module. + * @retval 0 QSPI controller is not busy. + * @retval 1 QSPI controller is busy. + * @details This macro will return the busy state of QSPI controller. + * \hideinitializer + */ +#define QSPI_IS_BUSY(qspi) ( ((qspi)->STATUS & QSPI_STATUS_BUSY_Msk)>>QSPI_STATUS_BUSY_Pos ) + +/** + * @brief Enable QSPI controller. + * @param[in] qspi The pointer of the specified QSPI module. + * @return None. + * @details Set QSPIEN (QSPI_CTL[0]) to enable QSPI controller. + * \hideinitializer + */ +#define QSPI_ENABLE(qspi) ((qspi)->CTL |= QSPI_CTL_QSPIEN_Msk) + +/** + * @brief Disable QSPI controller. + * @param[in] qspi The pointer of the specified QSPI module. + * @return None. + * @details Clear QSPIEN (QSPI_CTL[0]) to disable QSPI controller. + * \hideinitializer + */ +#define QSPI_DISABLE(qspi) ((qspi)->CTL &= ~QSPI_CTL_QSPIEN_Msk) + +/** + * @brief Disable QSPI Dual IO function. + * @param[in] qspi is the base address of QSPI module. + * @return none + * \hideinitializer + */ +#define QSPI_DISABLE_DUAL_MODE(qspi) ( (qspi)->CTL &= ~QSPI_CTL_DUALIOEN_Msk ) + +/** + * @brief Enable Dual IO function and set QSPI Dual IO direction to input. + * @param[in] qspi is the base address of QSPI module. + * @return none + * \hideinitializer + */ +#define QSPI_ENABLE_DUAL_INPUT_MODE(qspi) ( (qspi)->CTL = ((qspi)->CTL & ~QSPI_CTL_DATDIR_Msk) | QSPI_CTL_DUALIOEN_Msk ) + +/** + * @brief Enable Dual IO function and set QSPI Dual IO direction to output. + * @param[in] qspi is the base address of QSPI module. + * @return none + * \hideinitializer + */ +#define QSPI_ENABLE_DUAL_OUTPUT_MODE(qspi) ( (qspi)->CTL |= QSPI_CTL_DATDIR_Msk | QSPI_CTL_DUALIOEN_Msk ) + +/** + * @brief Disable QSPI Dual IO function. + * @param[in] qspi is the base address of QSPI module. + * @return none + * \hideinitializer + */ +#define QSPI_DISABLE_QUAD_MODE(qspi) ( (qspi)->CTL &= ~QSPI_CTL_QUADIOEN_Msk ) + +/** + * @brief Set QSPI Quad IO direction to input. + * @param[in] qspi is the base address of QSPI module. + * @return none + * \hideinitializer + */ +#define QSPI_ENABLE_QUAD_INPUT_MODE(qspi) ( (qspi)->CTL = ((qspi)->CTL & ~QSPI_CTL_DATDIR_Msk) | QSPI_CTL_QUADIOEN_Msk ) + +/** + * @brief Set QSPI Quad IO direction to output. + * @param[in] qspi is the base address of QSPI module. + * @return none + * \hideinitializer + */ +#define QSPI_ENABLE_QUAD_OUTPUT_MODE(qspi) ( (qspi)->CTL |= QSPI_CTL_DATDIR_Msk | QSPI_CTL_QUADIOEN_Msk ) + + + + +/* Function prototype declaration */ +uint32_t QSPI_Open(QSPI_T *qspi, uint32_t u32MasterSlave, uint32_t u32QSPIMode, uint32_t u32DataWidth, uint32_t u32BusClock); +void QSPI_Close(QSPI_T *qspi); +void QSPI_ClearRxFIFO(QSPI_T *qspi); +void QSPI_ClearTxFIFO(QSPI_T *qspi); +void QSPI_DisableAutoSS(QSPI_T *qspi); +void QSPI_EnableAutoSS(QSPI_T *qspi, uint32_t u32SSPinMask, uint32_t u32ActiveLevel); +uint32_t QSPI_SetBusClock(QSPI_T *qspi, uint32_t u32BusClock); +void QSPI_SetFIFO(QSPI_T *qspi, uint32_t u32TxThreshold, uint32_t u32RxThreshold); +uint32_t QSPI_GetBusClock(QSPI_T *qspi); +void QSPI_EnableInt(QSPI_T *qspi, uint32_t u32Mask); +void QSPI_DisableInt(QSPI_T *qspi, uint32_t u32Mask); +uint32_t QSPI_GetIntFlag(QSPI_T *qspi, uint32_t u32Mask); +void QSPI_ClearIntFlag(QSPI_T *qspi, uint32_t u32Mask); +uint32_t QSPI_GetStatus(QSPI_T *qspi, uint32_t u32Mask); + + +/*@}*/ /* end of group QSPI_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group QSPI_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_rtc.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_rtc.h new file mode 100644 index 00000000000..f416519b67d --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_rtc.h @@ -0,0 +1,342 @@ +/**************************************************************************//** + * @file nu_rtc.h + * @version V3.00 + * @brief M480 series RTC driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __NU_RTC_H__ +#define __NU_RTC_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup RTC_Driver RTC Driver + @{ +*/ + +/** @addtogroup RTC_EXPORTED_CONSTANTS RTC Exported Constants + @{ +*/ +/*---------------------------------------------------------------------------------------------------------*/ +/* RTC Initial Keyword Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define RTC_INIT_KEY 0xA5EB1357UL /*!< RTC Initiation Key to make RTC leaving reset state \hideinitializer */ +#define RTC_WRITE_KEY 0x0000A965UL /*!< RTC Register Access Enable Key to enable RTC read/write accessible and kept 1024 RTC clock \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* RTC Time Attribute Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define RTC_CLOCK_12 0UL /*!< RTC as 12-hour time scale with AM and PM indication \hideinitializer */ +#define RTC_CLOCK_24 1UL /*!< RTC as 24-hour time scale \hideinitializer */ +#define RTC_AM 1UL /*!< RTC as AM indication \hideinitializer */ +#define RTC_PM 2UL /*!< RTC as PM indication \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* RTC Tick Period Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define RTC_TICK_1_SEC 0x0UL /*!< RTC time tick period is 1 second \hideinitializer */ +#define RTC_TICK_1_2_SEC 0x1UL /*!< RTC time tick period is 1/2 second \hideinitializer */ +#define RTC_TICK_1_4_SEC 0x2UL /*!< RTC time tick period is 1/4 second \hideinitializer */ +#define RTC_TICK_1_8_SEC 0x3UL /*!< RTC time tick period is 1/8 second \hideinitializer */ +#define RTC_TICK_1_16_SEC 0x4UL /*!< RTC time tick period is 1/16 second \hideinitializer */ +#define RTC_TICK_1_32_SEC 0x5UL /*!< RTC time tick period is 1/32 second \hideinitializer */ +#define RTC_TICK_1_64_SEC 0x6UL /*!< RTC time tick period is 1/64 second \hideinitializer */ +#define RTC_TICK_1_128_SEC 0x7UL /*!< RTC time tick period is 1/128 second \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* RTC Day of Week Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define RTC_SUNDAY 0x0UL /*!< Day of the Week is Sunday \hideinitializer */ +#define RTC_MONDAY 0x1UL /*!< Day of the Week is Monday \hideinitializer */ +#define RTC_TUESDAY 0x2UL /*!< Day of the Week is Tuesday \hideinitializer */ +#define RTC_WEDNESDAY 0x3UL /*!< Day of the Week is Wednesday \hideinitializer */ +#define RTC_THURSDAY 0x4UL /*!< Day of the Week is Thursday \hideinitializer */ +#define RTC_FRIDAY 0x5UL /*!< Day of the Week is Friday \hideinitializer */ +#define RTC_SATURDAY 0x6UL /*!< Day of the Week is Saturday \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* RTC Miscellaneous Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define RTC_WAIT_COUNT 0xFFFFFFFFUL /*!< Initial Time-out Value \hideinitializer */ +#define RTC_YEAR2000 2000UL /*!< RTC Reference for compute year data \hideinitializer */ +#define RTC_FCR_REFERENCE 32761UL /*!< RTC Reference for frequency compensation \hideinitializer */ + + +#define RTC_TAMPER0_SELECT (0x1ul << 0) /*!< Select Tamper 0 \hideinitializer */ +#define RTC_TAMPER1_SELECT (0x1ul << 1) /*!< Select Tamper 1 \hideinitializer */ +#define RTC_TAMPER2_SELECT (0x1ul << 2) /*!< Select Tamper 2 \hideinitializer */ +#define RTC_TAMPER3_SELECT (0x1ul << 3) /*!< Select Tamper 3 \hideinitializer */ +#define RTC_TAMPER4_SELECT (0x1ul << 4) /*!< Select Tamper 4 \hideinitializer */ +#define RTC_TAMPER5_SELECT (0x1ul << 5) /*!< Select Tamper 5 \hideinitializer */ +#define MAX_TAMPER_PIN_NUM 6ul /*!< Tamper Pin number \hideinitializer */ + +#define RTC_TAMPER_HIGH_LEVEL_DETECT 1ul /*!< Tamper pin detect voltage level is high \hideinitializer */ +#define RTC_TAMPER_LOW_LEVEL_DETECT 0ul /*!< Tamper pin detect voltage level is low \hideinitializer */ + +#define RTC_TAMPER_DEBOUNCE_ENABLE 1ul /*!< Enable RTC tamper pin de-bounce function \hideinitializer */ +#define RTC_TAMPER_DEBOUNCE_DISABLE 0ul /*!< Disable RTC tamper pin de-bounce function \hideinitializer */ + +#define RTC_PAIR0_SELECT (0x1ul << 0) /*!< Select Pair 0 \hideinitializer */ +#define RTC_PAIR1_SELECT (0x1ul << 1) /*!< Select Pair 1 \hideinitializer */ +#define RTC_PAIR2_SELECT (0x1ul << 2) /*!< Select Pair 2 \hideinitializer */ +#define MAX_PAIR_NUM 3ul /*!< Pair number \hideinitializer */ + +#define RTC_2POW10_CLK (0x0 << RTC_TAMPCTL_DYNRATE_Pos) /*!< 1024 RTC clock cycles \hideinitializer */ +#define RTC_2POW11_CLK (0x1 << RTC_TAMPCTL_DYNRATE_Pos) /*!< 1024 x 2 RTC clock cycles \hideinitializer */ +#define RTC_2POW12_CLK (0x2 << RTC_TAMPCTL_DYNRATE_Pos) /*!< 1024 x 4 RTC clock cycles \hideinitializer */ +#define RTC_2POW13_CLK (0x3 << RTC_TAMPCTL_DYNRATE_Pos) /*!< 1024 x 6 RTC clock cycles \hideinitializer */ +#define RTC_2POW14_CLK (0x4 << RTC_TAMPCTL_DYNRATE_Pos) /*!< 1024 x 8 RTC clock cycles \hideinitializer */ +#define RTC_2POW15_CLK (0x5 << RTC_TAMPCTL_DYNRATE_Pos) /*!< 1024 x 16 RTC clock cycles \hideinitializer */ +#define RTC_2POW16_CLK (0x6 << RTC_TAMPCTL_DYNRATE_Pos) /*!< 1024 x 32 RTC clock cycles \hideinitializer */ +#define RTC_2POW17_CLK (0x7 << RTC_TAMPCTL_DYNRATE_Pos) /*!< 1024 x 64 RTC clock cycles \hideinitializer */ + +#define REF_RANDOM_PATTERN 0x0 /*!< The new reference pattern is generated by random number generator when the reference pattern run out \hideinitializer */ +#define REF_PREVIOUS_PATTERN 0x1 /*!< The new reference pattern is repeated previous random value when the reference pattern run out \hideinitializer */ +#define REF_SEED 0x3 /*!< The new reference pattern is repeated from SEED (RTC_TAMPSEED[31:0]) when the reference pattern run out \hideinitializer */ + +/*@}*/ /* end of group RTC_EXPORTED_CONSTANTS */ + + +/** @addtogroup RTC_EXPORTED_STRUCTS RTC Exported Structs + @{ +*/ +/** + * @details RTC define Time Data Struct + */ +typedef struct +{ + uint32_t u32Year; /*!< Year value */ + uint32_t u32Month; /*!< Month value */ + uint32_t u32Day; /*!< Day value */ + uint32_t u32DayOfWeek; /*!< Day of week value */ + uint32_t u32Hour; /*!< Hour value */ + uint32_t u32Minute; /*!< Minute value */ + uint32_t u32Second; /*!< Second value */ + uint32_t u32TimeScale; /*!< 12-Hour, 24-Hour */ + uint32_t u32AmPm; /*!< Only Time Scale select 12-hr used */ +} S_RTC_TIME_DATA_T; + +/*@}*/ /* end of group RTC_EXPORTED_STRUCTS */ + + +/** @addtogroup RTC_EXPORTED_FUNCTIONS RTC Exported Functions + @{ +*/ + +/** + * @brief Indicate is Leap Year or not + * + * @param None + * + * @retval 0 This year is not a leap year + * @retval 1 This year is a leap year + * + * @details According to current date, return this year is leap year or not. + * \hideinitializer + */ +#define RTC_IS_LEAP_YEAR() (RTC->LEAPYEAR & RTC_LEAPYEAR_LEAPYEAR_Msk ? 1:0) + +/** + * @brief Clear RTC Alarm Interrupt Flag + * + * @param None + * + * @return None + * + * @details This macro is used to clear RTC alarm interrupt flag. + * \hideinitializer + */ +#define RTC_CLEAR_ALARM_INT_FLAG() (RTC->INTSTS = RTC_INTSTS_ALMIF_Msk) + +/** + * @brief Clear RTC Tick Interrupt Flag + * + * @param None + * + * @return None + * + * @details This macro is used to clear RTC tick interrupt flag. + * \hideinitializer + */ +#define RTC_CLEAR_TICK_INT_FLAG() (RTC->INTSTS = RTC_INTSTS_TICKIF_Msk) + +/** + * @brief Clear RTC Tamper Interrupt Flag + * + * @param u32TamperFlag Tamper interrupt flag. It consists of: \n + * - \ref RTC_INTSTS_TAMP0IF_Msk \n + * - \ref RTC_INTSTS_TAMP1IF_Msk \n + * - \ref RTC_INTSTS_TAMP2IF_Msk \n + * - \ref RTC_INTSTS_TAMP3IF_Msk \n + * - \ref RTC_INTSTS_TAMP4IF_Msk \n + * - \ref RTC_INTSTS_TAMP5IF_Msk + * + * @return None + * + * @details This macro is used to clear RTC snooper pin interrupt flag. + * \hideinitializer + */ +#define RTC_CLEAR_TAMPER_INT_FLAG(u32TamperFlag) (RTC->INTSTS = (u32TamperFlag)) + +/** + * @brief Get RTC Alarm Interrupt Flag + * + * @param None + * + * @retval 0 RTC alarm interrupt did not occur + * @retval 1 RTC alarm interrupt occurred + * + * @details This macro indicates RTC alarm interrupt occurred or not. + * \hideinitializer + */ +#define RTC_GET_ALARM_INT_FLAG() ((RTC->INTSTS & RTC_INTSTS_ALMIF_Msk)? 1:0) + +/** + * @brief Get RTC Time Tick Interrupt Flag + * + * @param None + * + * @retval 0 RTC time tick interrupt did not occur + * @retval 1 RTC time tick interrupt occurred + * + * @details This macro indicates RTC time tick interrupt occurred or not. + * \hideinitializer + */ +#define RTC_GET_TICK_INT_FLAG() ((RTC->INTSTS & RTC_INTSTS_TICKIF_Msk)? 1:0) + +/** + * @brief Get RTC Tamper Interrupt Flag + * + * @param None + * + * @retval 0 RTC snooper pin interrupt did not occur + * @retval 1 RTC snooper pin interrupt occurred + * + * @details This macro indicates RTC snooper pin interrupt occurred or not. + * \hideinitializer + */ +#define RTC_GET_TAMPER_INT_FLAG() ((RTC->INTSTS & (0x3F00))? 1:0) + +/** + * @brief Get RTC TAMPER Interrupt Status + * + * @param None + * + * @retval RTC_INTSTS_TAMP0IF_Msk Tamper 0 interrupt flag is generated + * @retval RTC_INTSTS_TAMP1IF_Msk Tamper 1 interrupt flag is generated + * @retval RTC_INTSTS_TAMP2IF_Msk Tamper 2 interrupt flag is generated + * @retval RTC_INTSTS_TAMP3IF_Msk Tamper 3 interrupt flag is generated + * @retval RTC_INTSTS_TAMP4IF_Msk Tamper 4 interrupt flag is generated + * @retval RTC_INTSTS_TAMP5IF_Msk Tamper 5 interrupt flag is generated + * + * @details This macro indicates RTC snooper pin interrupt occurred or not. + * \hideinitializer + */ +#define RTC_GET_TAMPER_INT_STATUS() ((RTC->INTSTS & (0x3F00))) + +/** + * @brief Read Spare Register + * + * @param[in] u32RegNum The spare register number, 0~19. + * + * @return Spare register content + * + * @details Read the specify spare register content. + * @note The returned value is valid only when SPRRDY(SPRCTL[7] SPR Register Ready) bit is set. \n + * And its controlled by RTC Access Enable Register. + * \hideinitializer + */ +#define RTC_READ_SPARE_REGISTER(u32RegNum) (RTC->SPR[(u32RegNum)]) + +/** + * @brief Write Spare Register + * + * @param[in] u32RegNum The spare register number, 0~19. + * @param[in] u32RegValue The spare register value. + * + * @return None + * + * @details Write specify data to spare register. + * @note This macro is effect only when SPRRDY(SPRCTL[7] SPR Register Ready) bit is set. \n + * And its controlled by RTC Access Enable Register(RTC_RWEN). + * \hideinitializer + */ +#define RTC_WRITE_SPARE_REGISTER(u32RegNum, u32RegValue) (RTC->SPR[(u32RegNum)] = (u32RegValue)) + +/* Declare these inline functions here to avoid MISRA C 2004 rule 8.1 error */ +__STATIC_INLINE void RTC_WaitAccessEnable(void); + +/** + * @brief Wait RTC Access Enable + * + * @param None + * + * @return None + * + * @details This function is used to enable the maximum RTC read/write accessible time. + */ +__STATIC_INLINE void RTC_WaitAccessEnable(void) +{ + while((RTC->RWEN & RTC_RWEN_RTCBUSY_Msk) == RTC_RWEN_RTCBUSY_Msk) + { + } + + if(!(SYS->CSERVER & 0x1)) + { + /* To wait RWENF bit is cleared and enable RWENF bit (Access Enable bit) again */ + RTC->RWEN = RTC_WRITE_KEY; + } + + /* To wait RWENF bit is set and user can access the protected-register of RTC from now on */ + while((RTC->RWEN & RTC_RWEN_RWENF_Msk) == (uint32_t)0x0) + { + } +} + +void RTC_Open(S_RTC_TIME_DATA_T *sPt); +void RTC_Close(void); +void RTC_32KCalibration(int32_t i32FrequencyX10000); +void RTC_GetDateAndTime(S_RTC_TIME_DATA_T *sPt); +void RTC_GetAlarmDateAndTime(S_RTC_TIME_DATA_T *sPt); +void RTC_SetDateAndTime(S_RTC_TIME_DATA_T *sPt); +void RTC_SetAlarmDateAndTime(S_RTC_TIME_DATA_T *sPt); +void RTC_SetDate(uint32_t u32Year, uint32_t u32Month, uint32_t u32Day, uint32_t u32DayOfWeek); +void RTC_SetTime(uint32_t u32Hour, uint32_t u32Minute, uint32_t u32Second, uint32_t u32TimeMode, uint32_t u32AmPm); +void RTC_SetAlarmDate(uint32_t u32Year, uint32_t u32Month, uint32_t u32Day); +void RTC_SetAlarmTime(uint32_t u32Hour, uint32_t u32Minute, uint32_t u32Second, uint32_t u32TimeMode, uint32_t u32AmPm); +void RTC_SetAlarmDateMask(uint8_t u8IsTenYMsk, uint8_t u8IsYMsk, uint8_t u8IsTenMMsk, uint8_t u8IsMMsk, uint8_t u8IsTenDMsk, uint8_t u8IsDMsk); +void RTC_SetAlarmTimeMask(uint8_t u8IsTenHMsk, uint8_t u8IsHMsk, uint8_t u8IsTenMMsk, uint8_t u8IsMMsk, uint8_t u8IsTenSMsk, uint8_t u8IsSMsk); +uint32_t RTC_GetDayOfWeek(void); +void RTC_SetTickPeriod(uint32_t u32TickSelection); +void RTC_EnableInt(uint32_t u32IntFlagMask); +void RTC_DisableInt(uint32_t u32IntFlagMask); +void RTC_EnableSpareAccess(void); +void RTC_DisableSpareRegister(void); +void RTC_StaticTamperEnable(uint32_t u32TamperSelect, uint32_t u32DetecLevel, uint32_t u32DebounceEn); +void RTC_StaticTamperDisable(uint32_t u32TamperSelect); +void RTC_DynamicTamperEnable(uint32_t u32PairSel, uint32_t u32DebounceEn, uint32_t u32Pair1Source, uint32_t u32Pair2Source); +void RTC_DynamicTamperDisable(uint32_t u32PairSel); +void RTC_DynamicTamperConfig(uint32_t u32ChangeRate, uint32_t u32SeedReload, uint32_t u32RefPattern, uint32_t u32Seed); + +/*@}*/ /* end of group RTC_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group RTC_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_RTC_H__ */ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_sc.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_sc.h new file mode 100644 index 00000000000..ac778b66442 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_sc.h @@ -0,0 +1,268 @@ +/**************************************************************************//** + * @file nu_sc.h + * @version V1.00 + * @brief M480 Smartcard (SC) driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __NU_SC_H__ +#define __NU_SC_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup SC_Driver SC Driver + @{ +*/ + +/** @addtogroup SC_EXPORTED_CONSTANTS SC Exported Constants + @{ +*/ +#define SC_INTERFACE_NUM 3 /*!< Smartcard interface numbers \hideinitializer */ +#define SC_PIN_STATE_HIGH 1 /*!< Smartcard pin status high \hideinitializer */ +#define SC_PIN_STATE_LOW 0 /*!< Smartcard pin status low \hideinitializer */ +#define SC_PIN_STATE_IGNORE 0xFFFFFFFF /*!< Ignore pin status \hideinitializer */ +#define SC_CLK_ON 1 /*!< Smartcard clock on \hideinitializer */ +#define SC_CLK_OFF 0 /*!< Smartcard clock off \hideinitializer */ + +#define SC_TMR_MODE_0 (0ul << SC_TMRCTL0_OPMODE_Pos) /*!INTEN |= (u32Mask)) + +/** + * @brief This macro disable smartcard interrupt + * @param[in] sc Base address of smartcard module + * @param[in] u32Mask Interrupt mask to be disabled. A combination of + * - \ref SC_INTEN_ACERRIEN_Msk + * - \ref SC_INTEN_RXTOIEN_Msk + * - \ref SC_INTEN_INITIEN_Msk + * - \ref SC_INTEN_CDIEN_Msk + * - \ref SC_INTEN_BGTIEN_Msk + * - \ref SC_INTEN_TMR2IEN_Msk + * - \ref SC_INTEN_TMR1IEN_Msk + * - \ref SC_INTEN_TMR0IEN_Msk + * - \ref SC_INTEN_TERRIEN_Msk + * - \ref SC_INTEN_TBEIEN_Msk + * - \ref SC_INTEN_RDAIEN_Msk + * @return None + * \hideinitializer + */ +#define SC_DISABLE_INT(sc, u32Mask) ((sc)->INTEN &= ~(u32Mask)) + +/** + * @brief This macro set VCC pin state of smartcard interface + * @param[in] sc Base address of smartcard module + * @param[in] u32State Pin state of VCC pin, valid parameters are \ref SC_PIN_STATE_HIGH and \ref SC_PIN_STATE_LOW + * @return None + * \hideinitializer + */ +#define SC_SET_VCC_PIN(sc, u32State) \ + do {\ + while((sc)->PINCTL & SC_PINCTL_SYNC_Msk);\ + if(u32State)\ + (sc)->PINCTL |= SC_PINCTL_PWREN_Msk;\ + else\ + (sc)->PINCTL &= ~SC_PINCTL_PWREN_Msk;\ + }while(0) + + +/** + * @brief This macro turns CLK output on or off + * @param[in] sc Base address of smartcard module + * @param[in] u32OnOff Clock on or off for selected smartcard module, valid values are \ref SC_CLK_ON and \ref SC_CLK_OFF + * @return None + * \hideinitializer + */ +#define SC_SET_CLK_PIN(sc, u32OnOff)\ + do {\ + while((sc)->PINCTL & SC_PINCTL_SYNC_Msk);\ + if(u32OnOff)\ + (sc)->PINCTL |= SC_PINCTL_CLKKEEP_Msk;\ + else\ + (sc)->PINCTL &= ~(SC_PINCTL_CLKKEEP_Msk);\ + }while(0) + +/** + * @brief This macro set I/O pin state of smartcard interface + * @param[in] sc Base address of smartcard module + * @param[in] u32State Pin state of I/O pin, valid parameters are \ref SC_PIN_STATE_HIGH and \ref SC_PIN_STATE_LOW + * @return None + * \hideinitializer + */ +#define SC_SET_IO_PIN(sc, u32State)\ + do {\ + while((sc)->PINCTL & SC_PINCTL_SYNC_Msk);\ + if(u32State)\ + (sc)->PINCTL |= SC_PINCTL_SCDATA_Msk;\ + else\ + (sc)->PINCTL &= ~SC_PINCTL_SCDATA_Msk;\ + }while(0) + +/** + * @brief This macro set RST pin state of smartcard interface + * @param[in] sc Base address of smartcard module + * @param[in] u32State Pin state of RST pin, valid parameters are \ref SC_PIN_STATE_HIGH and \ref SC_PIN_STATE_LOW + * @return None + * \hideinitializer + */ +#define SC_SET_RST_PIN(sc, u32State)\ + do {\ + while((sc)->PINCTL & SC_PINCTL_SYNC_Msk);\ + if(u32State)\ + (sc)->PINCTL |= SC_PINCTL_RSTEN_Msk;\ + else\ + (sc)->PINCTL &= ~SC_PINCTL_RSTEN_Msk;\ + }while(0) + +/** + * @brief This macro read one byte from smartcard module receive FIFO + * @param[in] sc Base address of smartcard module + * @return One byte read from receive FIFO + * \hideinitializer + */ +#define SC_READ(sc) ((char)((sc)->DAT)) + +/** + * @brief This macro write one byte to smartcard module transmit FIFO + * @param[in] sc Base address of smartcard module + * @param[in] u8Data Data to write to transmit FIFO + * @return None + * \hideinitializer + */ +#define SC_WRITE(sc, u8Data) ((sc)->DAT = (u8Data)) + +/** + * @brief This macro set smartcard stop bit length + * @param[in] sc Base address of smartcard module + * @param[in] u32Len Stop bit length, ether 1 or 2. + * @return None + * @details Stop bit length must be 1 for T = 1 protocol and 2 for T = 0 protocol. + * \hideinitializer + */ +#define SC_SET_STOP_BIT_LEN(sc, u32Len) ((sc)->CTL = ((sc)->CTL & ~SC_CTL_NSB_Msk) | ((u32Len) == 1 ? SC_CTL_NSB_Msk : 0)) + +/* Declare these inline functions here to avoid MISRA C 2004 rule 8.1 error */ +__STATIC_INLINE void SC_SetTxRetry(SC_T *sc, uint32_t u32Count); +__STATIC_INLINE void SC_SetRxRetry(SC_T *sc, uint32_t u32Count); + +/** + * @brief Enable/Disable Tx error retry, and set Tx error retry count + * @param[in] sc Base address of smartcard module + * @param[in] u32Count The number of times of Tx error retry count, between 0~8. 0 means disable Tx error retry + * @return None + */ +__STATIC_INLINE void SC_SetTxRetry(SC_T *sc, uint32_t u32Count) +{ + while((sc)->CTL & SC_CTL_SYNC_Msk) + { + ; + } + /* Retry count must set while enable bit disabled, so disable it first */ + (sc)->CTL &= ~(SC_CTL_TXRTY_Msk | SC_CTL_TXRTYEN_Msk); + + if((u32Count) != 0UL) + { + while((sc)->CTL & SC_CTL_SYNC_Msk) + { + ; + } + (sc)->CTL |= (((u32Count) - 1UL) << SC_CTL_TXRTY_Pos) | SC_CTL_TXRTYEN_Msk; + } +} + +/** + * @brief Enable/Disable Rx error retry, and set Rx error retry count + * @param[in] sc Base address of smartcard module + * @param[in] u32Count The number of times of Rx error retry count, between 0~8. 0 means disable Rx error retry + * @return None + */ +__STATIC_INLINE void SC_SetRxRetry(SC_T *sc, uint32_t u32Count) +{ + while((sc)->CTL & SC_CTL_SYNC_Msk) + { + ; + } + /* Retry count must set while enable bit disabled, so disable it first */ + (sc)->CTL &= ~(SC_CTL_RXRTY_Msk | SC_CTL_RXRTYEN_Msk); + + if((u32Count) != 0UL) + { + while((sc)->CTL & SC_CTL_SYNC_Msk) + { + ; + } + (sc)->CTL |= (((u32Count) - 1UL) << SC_CTL_RXRTY_Pos) | SC_CTL_RXRTYEN_Msk; + } + +} + + +uint32_t SC_IsCardInserted(SC_T *sc); +void SC_ClearFIFO(SC_T *sc); +void SC_Close(SC_T *sc); +void SC_Open(SC_T *sc, uint32_t u32CardDet, uint32_t u32PWR); +void SC_ResetReader(SC_T *sc); +void SC_SetBlockGuardTime(SC_T *sc, uint32_t u32BGT); +void SC_SetCharGuardTime(SC_T *sc, uint32_t u32CGT); +void SC_StopAllTimer(SC_T *sc); +void SC_StartTimer(SC_T *sc, uint32_t u32TimerNum, uint32_t u32Mode, uint32_t u32ETUCount); +void SC_StopTimer(SC_T *sc, uint32_t u32TimerNum); +uint32_t SC_GetInterfaceClock(SC_T *sc); + + +/*@}*/ /* end of group SC_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group SC_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_SC_H__ */ + +/*** (C) COPYRIGHT 2017 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_scuart.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_scuart.h new file mode 100644 index 00000000000..e5e9e7831ae --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_scuart.h @@ -0,0 +1,267 @@ +/**************************************************************************//** + * @file nu_scuart.h + * @version V1.00 + * @brief M480 Smartcard UART mode (SCUART) driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __NU_SCUART_H__ +#define __NU_SCUART_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup SCUART_Driver SCUART Driver + @{ +*/ + +/** @addtogroup SCUART_EXPORTED_CONSTANTS SCUART Exported Constants + @{ +*/ +#define SCUART_CHAR_LEN_5 (0x3ul << SC_UARTCTL_WLS_Pos) /*!< Set SCUART word length to 5 bits \hideinitializer */ +#define SCUART_CHAR_LEN_6 (0x2ul << SC_UARTCTL_WLS_Pos) /*!< Set SCUART word length to 6 bits \hideinitializer */ +#define SCUART_CHAR_LEN_7 (0x1ul << SC_UARTCTL_WLS_Pos) /*!< Set SCUART word length to 7 bits \hideinitializer */ +#define SCUART_CHAR_LEN_8 (0UL) /*!< Set SCUART word length to 8 bits \hideinitializer */ + +#define SCUART_PARITY_NONE (SC_UARTCTL_PBOFF_Msk) /*!< Set SCUART transfer with no parity \hideinitializer */ +#define SCUART_PARITY_ODD (SC_UARTCTL_OPE_Msk) /*!< Set SCUART transfer with odd parity \hideinitializer */ +#define SCUART_PARITY_EVEN (0UL) /*!< Set SCUART transfer with even parity \hideinitializer */ + +#define SCUART_STOP_BIT_1 (SC_CTL_NSB_Msk) /*!< Set SCUART transfer with one stop bit \hideinitializer */ +#define SCUART_STOP_BIT_2 (0UL) /*!< Set SCUART transfer with two stop bits \hideinitializer */ + + +/*@}*/ /* end of group SCUART_EXPORTED_CONSTANTS */ + + +/** @addtogroup SCUART_EXPORTED_FUNCTIONS SCUART Exported Functions + @{ +*/ + +/* TX Macros */ +/** + * @brief Write Data to Tx data register + * @param[in] sc The base address of smartcard module. + * @param[in] u8Data Data byte to transmit + * @return None + * \hideinitializer + */ +#define SCUART_WRITE(sc, u8Data) ((sc)->DAT = (u8Data)) + +/** + * @brief Get TX FIFO empty flag status from register + * @param[in] sc The base address of smartcard module + * @return Transmit FIFO empty status + * @retval 0 Transmit FIFO is not empty + * @retval SC_STATUS_TXEMPTY_Msk Transmit FIFO is empty + * \hideinitializer + */ +#define SCUART_GET_TX_EMPTY(sc) ((sc)->STATUS & SC_STATUS_TXEMPTY_Msk) + +/** + * @brief Get TX FIFO full flag status from register + * @param[in] sc The base address of smartcard module + * @return Transmit FIFO full status + * @retval 0 Transmit FIFO is not full + * @retval SC_STATUS_TXFULL_Msk Transmit FIFO is full + * \hideinitializer + */ +#define SCUART_GET_TX_FULL(sc) ((sc)->STATUS & SC_STATUS_TXFULL_Msk) + +/** + * @brief Wait specified smartcard port transmission complete + * @param[in] sc The base address of smartcard module + * @return None + * @note This Macro blocks until transmit complete. + * \hideinitializer + */ +#define SCUART_WAIT_TX_EMPTY(sc) while((sc)->STATUS & SC_STATUS_TXACT_Msk) + +/** + * @brief Check specified smartcard port transmit FIFO is full or not + * @param[in] sc The base address of smartcard module + * @return Transmit FIFO full status + * @retval 0 Transmit FIFO is not full + * @retval 1 Transmit FIFO is full + * \hideinitializer + */ +#define SCUART_IS_TX_FULL(sc) ((sc)->STATUS & SC_STATUS_TXFULL_Msk ? 1 : 0) + +/** + * @brief Check specified smartcard port transmission is over + * @param[in] sc The base address of smartcard module + * @return Transmit complete status + * @retval 0 Transmit is not complete + * @retval 1 Transmit complete + * \hideinitializer + */ +#define SCUART_IS_TX_EMPTY(sc) ((sc)->STATUS & SC_STATUS_TXACT_Msk ? 0 : 1) + +/** + * @brief Check specified Smartcard port Transmission Status + * @param[in] sc The pointer of smartcard module. + * @retval 0 Transmit is completed + * @retval 1 Transmit is active + * @details TXACT (SC_STATUS[31]) is set by hardware when Tx transfer is in active and the STOP bit of the last byte has been transmitted. + * \hideinitializer + */ +#define SCUART_IS_TX_ACTIVE(sc) (((sc)->STATUS & SC_STATUS_TXACT_Msk)? 1 : 0) + +/* RX Macros */ + +/** + * @brief Read Rx data register + * @param[in] sc The base address of smartcard module + * @return The oldest data byte in RX FIFO + * \hideinitializer + */ +#define SCUART_READ(sc) ((sc)->DAT) + +/** + * @brief Get RX FIFO empty flag status from register + * @param[in] sc The base address of smartcard module + * @return Receive FIFO empty status + * @retval 0 Receive FIFO is not empty + * @retval SC_STATUS_RXEMPTY_Msk Receive FIFO is empty + * \hideinitializer + */ +#define SCUART_GET_RX_EMPTY(sc) ((sc)->STATUS & SC_STATUS_RXEMPTY_Msk) + + +/** + * @brief Get RX FIFO full flag status from register + * @param[in] sc The base address of smartcard module + * @return Receive FIFO full status + * @retval 0 Receive FIFO is not full + * @retval SC_STATUS_RXFULLF_Msk Receive FIFO is full + * \hideinitializer + */ +#define SCUART_GET_RX_FULL(sc) ((sc)->STATUS & SC_STATUS_RXFULL_Msk) + +/** + * @brief Check if receive data number in FIFO reach FIFO trigger level or not + * @param[in] sc The base address of smartcard module + * @return Receive FIFO data status + * @retval 0 The number of bytes in receive FIFO is less than trigger level + * @retval 1 The number of bytes in receive FIFO equals or larger than trigger level + * @note If receive trigger level is \b not 1 byte, this macro return 0 does not necessary indicates there is \b no data in FIFO + * \hideinitializer + */ +#define SCUART_IS_RX_READY(sc) ((sc)->INTSTS & SC_INTSTS_RDAIF_Msk ? 1 : 0) + +/** + * @brief Check specified smartcard port receive FIFO is full or not + * @param[in] sc The base address of smartcard module + * @return Receive FIFO full status + * @retval 0 Receive FIFO is not full + * @retval 1 Receive FIFO is full + * \hideinitializer + */ +#define SCUART_IS_RX_FULL(sc) ((sc)->STATUS & SC_STATUS_RXFULL_Msk ? 1 : 0) + +/* Interrupt Macros */ + +/** + * @brief Enable specified interrupts + * @param[in] sc The base address of smartcard module + * @param[in] u32Mask Interrupt masks to enable, a combination of following bits + * - \ref SC_INTEN_RXTOIEN_Msk + * - \ref SC_INTEN_TERRIEN_Msk + * - \ref SC_INTEN_TBEIEN_Msk + * - \ref SC_INTEN_RDAIEN_Msk + * @return None + * \hideinitializer + */ +#define SCUART_ENABLE_INT(sc, u32Mask) ((sc)->INTEN |= (u32Mask)) + +/** + * @brief Disable specified interrupts + * @param[in] sc The base address of smartcard module + * @param[in] u32Mask Interrupt masks to disable, a combination of following bits + * - \ref SC_INTEN_RXTOIEN_Msk + * - \ref SC_INTEN_TERRIEN_Msk + * - \ref SC_INTEN_TBEIEN_Msk + * - \ref SC_INTEN_RDAIEN_Msk + * @return None + * \hideinitializer + */ +#define SCUART_DISABLE_INT(sc, u32Mask) ((sc)->INTEN &= ~(u32Mask)) + +/** + * @brief Get specified interrupt flag/status + * @param[in] sc The base address of smartcard module + * @param[in] u32Type Interrupt flag/status to check, could be one of following value + * - \ref SC_INTSTS_RXTOIF_Msk + * - \ref SC_INTSTS_TERRIF_Msk + * - \ref SC_INTSTS_TBEIF_Msk + * - \ref SC_INTSTS_RDAIF_Msk + * @return The status of specified interrupt + * @retval 0 Specified interrupt does not happened + * @retval 1 Specified interrupt happened + * \hideinitializer + */ +#define SCUART_GET_INT_FLAG(sc, u32Type) ((sc)->INTSTS & (u32Type) ? 1 : 0) + +/** + * @brief Clear specified interrupt flag/status + * @param[in] sc The base address of smartcard module + * @param[in] u32Type Interrupt flag/status to clear, could be the combination of following values + * - \ref SC_INTSTS_RXTOIF_Msk + * - \ref SC_INTSTS_TERRIF_Msk + * - \ref SC_INTSTS_TBEIF_Msk + * @return None + * \hideinitializer + */ +#define SCUART_CLR_INT_FLAG(sc, u32Type) ((sc)->INTSTS = (u32Type)) + +/** + * @brief Get receive error flag/status + * @param[in] sc The base address of smartcard module + * @return Current receive error status, could one of following errors: + * @retval SC_STATUS_PEF_Msk Parity error + * @retval SC_STATUS_FEF_Msk Frame error + * @retval SC_STATUS_BEF_Msk Break error + * \hideinitializer + */ +#define SCUART_GET_ERR_FLAG(sc) ((sc)->STATUS & (SC_STATUS_PEF_Msk | SC_STATUS_FEF_Msk | SC_STATUS_BEF_Msk)) + +/** + * @brief Clear specified receive error flag/status + * @param[in] sc The base address of smartcard module + * @param[in] u32Mask Receive error flag/status to clear, combination following values + * - \ref SC_STATUS_PEF_Msk + * - \ref SC_STATUS_FEF_Msk + * - \ref SC_STATUS_BEF_Msk + * @return None + * \hideinitializer + */ +#define SCUART_CLR_ERR_FLAG(sc, u32Mask) ((sc)->STATUS = (u32Mask)) + +void SCUART_Close(SC_T* sc); +uint32_t SCUART_Open(SC_T* sc, uint32_t u32baudrate); +uint32_t SCUART_Read(SC_T* sc, uint8_t pu8RxBuf[], uint32_t u32ReadBytes); +uint32_t SCUART_SetLineConfig(SC_T* sc, uint32_t u32Baudrate, uint32_t u32DataWidth, uint32_t u32Parity, uint32_t u32StopBits); +void SCUART_SetTimeoutCnt(SC_T* sc, uint32_t u32TOC); +void SCUART_Write(SC_T* sc,uint8_t pu8TxBuf[], uint32_t u32WriteBytes); + +/*@}*/ /* end of group SCUART_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group SCUART_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_SCUART_H__ */ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_sdh.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_sdh.h new file mode 100644 index 00000000000..41d1d199f59 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_sdh.h @@ -0,0 +1,203 @@ +/**************************************************************************//** + * @file nu_sdh.h + * @version V1.00 + * @brief M480 SDH driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. +*****************************************************************************/ +#include + +#ifndef __NU_SDH_H__ +#define __NU_SDH_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup SDH_Driver SDH Driver + @{ +*/ + + +/** @addtogroup SDH_EXPORTED_CONSTANTS SDH Exported Constants + @{ +*/ + +#define SDH_ERR_ID 0xFFFF0100ul /*!< SDH error ID \hideinitializer */ + +#define SDH_TIMEOUT (SDH_ERR_ID|0x01ul) /*!< Timeout \hideinitializer */ +#define SDH_NO_MEMORY (SDH_ERR_ID|0x02ul) /*!< OOM \hideinitializer */ + +/*-- function return value */ +#define Successful 0ul /*!< Success \hideinitializer */ +#define Fail 1ul /*!< Failed \hideinitializer */ + +/*--- define type of SD card or MMC */ +#define SDH_TYPE_UNKNOWN 0ul /*!< Unknown card type \hideinitializer */ +#define SDH_TYPE_SD_HIGH 1ul /*!< SDHC card \hideinitializer */ +#define SDH_TYPE_SD_LOW 2ul /*!< SD card \hideinitializer */ +#define SDH_TYPE_MMC 3ul /*!< MMC card \hideinitializer */ +#define SDH_TYPE_EMMC 4ul /*!< eMMC card \hideinitializer */ + +/* SD error */ +#define SDH_NO_SD_CARD (SDH_ERR_ID|0x10ul) /*!< Card removed \hideinitializer */ +#define SDH_ERR_DEVICE (SDH_ERR_ID|0x11ul) /*!< Device error \hideinitializer */ +#define SDH_INIT_TIMEOUT (SDH_ERR_ID|0x12ul) /*!< Card init timeout \hideinitializer */ +#define SDH_SELECT_ERROR (SDH_ERR_ID|0x13ul) /*!< Card select error \hideinitializer */ +#define SDH_WRITE_PROTECT (SDH_ERR_ID|0x14ul) /*!< Card write protect \hideinitializer */ +#define SDH_INIT_ERROR (SDH_ERR_ID|0x15ul) /*!< Card init error \hideinitializer */ +#define SDH_CRC7_ERROR (SDH_ERR_ID|0x16ul) /*!< CRC 7 error \hideinitializer */ +#define SDH_CRC16_ERROR (SDH_ERR_ID|0x17ul) /*!< CRC 16 error \hideinitializer */ +#define SDH_CRC_ERROR (SDH_ERR_ID|0x18ul) /*!< CRC error \hideinitializer */ +#define SDH_CMD8_ERROR (SDH_ERR_ID|0x19ul) /*!< Command 8 error \hideinitializer */ + +#define MMC_FREQ 20000ul /*!< output 20MHz to MMC \hideinitializer */ +#define SD_FREQ 25000ul /*!< output 25MHz to SD \hideinitializer */ +#define SDHC_FREQ 50000ul /*!< output 50MHz to SDH \hideinitializer */ + +#define SD_PORT0 (1 << 0) /*!< Card select SD0 \hideinitializer */ +#define SD_PORT1 (1 << 2) /*!< Card select SD1 \hideinitializer */ +#define CardDetect_From_GPIO (1ul << 8) /*!< Card detection pin is GPIO \hideinitializer */ +#define CardDetect_From_DAT3 (1ul << 9) /*!< Card detection pin is DAT3 \hideinitializer */ + +/*@}*/ /* end of group SDH_EXPORTED_CONSTANTS */ + +/** @addtogroup SDH_EXPORTED_TYPEDEF SDH Exported Type Defines + @{ +*/ +typedef struct SDH_info_t +{ + unsigned char IsCardInsert; /*!< Card insert state */ + unsigned char R3Flag; + unsigned char R7Flag; + unsigned char volatile DataReadyFlag; + unsigned int CardType; /*!< SDHC, SD, or MMC */ + unsigned int RCA; /*!< Relative card address */ + unsigned int totalSectorN; /*!< Total sector number */ + unsigned int diskSize; /*!< Disk size in K bytes */ + int sectorSize; /*!< Sector size in bytes */ + unsigned char *dmabuf; +} SDH_INFO_T; /*!< Structure holds SD card info */ + +/*@}*/ /* end of group SDH_EXPORTED_TYPEDEF */ + +/** @cond HIDDEN_SYMBOLS */ +extern SDH_INFO_T SD0, SD1; +/** @endcond HIDDEN_SYMBOLS */ + +/** @addtogroup SDH_EXPORTED_FUNCTIONS SDH Exported Functions + @{ +*/ + +/** + * @brief Enable specified interrupt. + * + * @param[in] sdh Select SDH0 or SDH1. + * @param[in] u32IntMask Interrupt type mask: + * \ref SDH_INTEN_BLKDIEN_Msk / \ref SDH_INTEN_CRCIEN_Msk / \ref SDH_INTEN_CDIEN_Msk / + * \ref SDH_INTEN_CDSRC_Msk \ref SDH_INTEN_RTOIEN_Msk / \ref SDH_INTEN_DITOIEN_Msk / + * \ref SDH_INTEN_WKIEN_Msk + * + * @return None. + * \hideinitializer + */ +#define SDH_ENABLE_INT(sdh, u32IntMask) ((sdh)->INTEN |= (u32IntMask)) + +/** + * @brief Disable specified interrupt. + * + * @param[in] sdh Select SDH0 or SDH1. + * @param[in] u32IntMask Interrupt type mask: + * \ref SDH_INTEN_BLKDIEN_Msk / \ref SDH_INTEN_CRCIEN_Msk / \ref SDH_INTEN_CDIEN_Msk / + * \ref SDH_INTEN_RTOIEN_Msk / \ref SDH_INTEN_DITOIEN_Msk / \ref SDH_INTEN_WKIEN_Msk / \ref SDH_INTEN_CDSRC_Msk / + * + * @return None. + * \hideinitializer + */ +#define SDH_DISABLE_INT(sdh, u32IntMask) ((sdh)->INTEN &= ~(u32IntMask)) + +/** + * @brief Get specified interrupt flag/status. + * + * @param[in] sdh Select SDH0 or SDH1. + * @param[in] u32IntMask Interrupt type mask: + * \ref SDH_INTSTS_BLKDIF_Msk / \ref SDH_INTSTS_CRCIF_Msk / \ref SDH_INTSTS_CRC7_Msk / + * \ref SDH_INTSTS_CRC16_Msk / \ref SDH_INTSTS_CRCSTS_Msk / \ref SDH_INTSTS_DAT0STS_Msk / + * \ref SDH_INTSTS_CDIF_Msk \ref SDH_INTSTS_RTOIF_Msk / + * \ref SDH_INTSTS_DITOIF_Msk / \ref SDH_INTSTS_CDSTS_Msk / + * \ref SDH_INTSTS_DAT1STS_Msk + * + * + * @return 0 = The specified interrupt is not happened. + * 1 = The specified interrupt is happened. + * \hideinitializer + */ +#define SDH_GET_INT_FLAG(sdh, u32IntMask) (((sdh)->INTSTS & (u32IntMask))?1:0) + + +/** + * @brief Clear specified interrupt flag/status. + * + * @param[in] sdh Select SDH0 or SDH1. + * @param[in] u32IntMask Interrupt type mask: + * \ref SDH_INTSTS_BLKDIF_Msk / \ref SDH_INTSTS_CRCIF_Msk / \ref SDH_INTSTS_CDIF_Msk / + * \ref SDH_INTSTS_RTOIF_Msk / \ref SDH_INTSTS_DITOIF_Msk + * + * + * @return None. + * \hideinitializer + */ +#define SDH_CLR_INT_FLAG(sdh, u32IntMask) ((sdh)->INTSTS = (u32IntMask)) + + +/** + * @brief Check SD Card inserted or removed. + * + * @param[in] sdh Select SDH0 or SDH1. + * + * @return 1: Card inserted. + * 0: Card removed. + * \hideinitializer + */ +#define SDH_IS_CARD_PRESENT(sdh) (((sdh) == SDH0)? SD0.IsCardInsert : SD1.IsCardInsert) + +/** + * @brief Get SD Card capacity. + * + * @param[in] sdh Select SDH0 or SDH1. + * + * @return SD Card capacity. (unit: KByte) + * \hideinitializer + */ +#define SDH_GET_CARD_CAPACITY(sdh) (((sdh) == SDH0)? SD0.diskSize : SD1.diskSize) + + +void SDH_Open(SDH_T *sdh, uint32_t u32CardDetSrc); +uint32_t SDH_Probe(SDH_T *sdh); +uint32_t SDH_Read(SDH_T *sdh, uint8_t *pu8BufAddr, uint32_t u32StartSec, uint32_t u32SecCount); +uint32_t SDH_Write(SDH_T *sdh, uint8_t *pu8BufAddr, uint32_t u32StartSec, uint32_t u32SecCount); + +uint32_t SDH_CardDetection(SDH_T *sdh); +void SDH_Open_Disk(SDH_T *sdh, uint32_t u32CardDetSrc); +void SDH_Close_Disk(SDH_T *sdh); + + +/*@}*/ /* end of group SDH_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group SDH_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_SDH_H__ */ +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_spi.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_spi.h new file mode 100644 index 00000000000..77eeda3b96c --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_spi.h @@ -0,0 +1,584 @@ +/**************************************************************************//** + * @file nu_spi.h + * @version V3.00 + * @brief M480 series SPI driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. +*****************************************************************************/ +#ifndef __NU_SPI_H__ +#define __NU_SPI_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup SPI_Driver SPI Driver + @{ +*/ + +/** @addtogroup SPI_EXPORTED_CONSTANTS SPI Exported Constants + @{ +*/ + +#define SPI_MODE_0 (SPI_CTL_TXNEG_Msk) /*!< CLKPOL=0; RXNEG=0; TXNEG=1 \hideinitializer */ +#define SPI_MODE_1 (SPI_CTL_RXNEG_Msk) /*!< CLKPOL=0; RXNEG=1; TXNEG=0 \hideinitializer */ +#define SPI_MODE_2 (SPI_CTL_CLKPOL_Msk | SPI_CTL_RXNEG_Msk) /*!< CLKPOL=1; RXNEG=1; TXNEG=0 \hideinitializer */ +#define SPI_MODE_3 (SPI_CTL_CLKPOL_Msk | SPI_CTL_TXNEG_Msk) /*!< CLKPOL=1; RXNEG=0; TXNEG=1 \hideinitializer */ + +#define SPI_SLAVE (SPI_CTL_SLAVE_Msk) /*!< Set as slave \hideinitializer */ +#define SPI_MASTER (0x0U) /*!< Set as master \hideinitializer */ + +#define SPI_SS (SPI_SSCTL_SS_Msk) /*!< Set SS \hideinitializer */ +#define SPI_SS_ACTIVE_HIGH (SPI_SSCTL_SSACTPOL_Msk) /*!< SS active high \hideinitializer */ +#define SPI_SS_ACTIVE_LOW (0x0U) /*!< SS active low \hideinitializer */ + +/* SPI Interrupt Mask */ +#define SPI_UNIT_INT_MASK (0x001U) /*!< Unit transfer interrupt mask \hideinitializer */ +#define SPI_SSACT_INT_MASK (0x002U) /*!< Slave selection signal active interrupt mask \hideinitializer */ +#define SPI_SSINACT_INT_MASK (0x004U) /*!< Slave selection signal inactive interrupt mask \hideinitializer */ +#define SPI_SLVUR_INT_MASK (0x008U) /*!< Slave under run interrupt mask \hideinitializer */ +#define SPI_SLVBE_INT_MASK (0x010U) /*!< Slave bit count error interrupt mask \hideinitializer */ +#define SPI_TXUF_INT_MASK (0x040U) /*!< Slave TX underflow interrupt mask \hideinitializer */ +#define SPI_FIFO_TXTH_INT_MASK (0x080U) /*!< FIFO TX threshold interrupt mask \hideinitializer */ +#define SPI_FIFO_RXTH_INT_MASK (0x100U) /*!< FIFO RX threshold interrupt mask \hideinitializer */ +#define SPI_FIFO_RXOV_INT_MASK (0x200U) /*!< FIFO RX overrun interrupt mask \hideinitializer */ +#define SPI_FIFO_RXTO_INT_MASK (0x400U) /*!< FIFO RX time-out interrupt mask \hideinitializer */ + +/* SPI Status Mask */ +#define SPI_BUSY_MASK (0x01U) /*!< Busy status mask \hideinitializer */ +#define SPI_RX_EMPTY_MASK (0x02U) /*!< RX empty status mask \hideinitializer */ +#define SPI_RX_FULL_MASK (0x04U) /*!< RX full status mask \hideinitializer */ +#define SPI_TX_EMPTY_MASK (0x08U) /*!< TX empty status mask \hideinitializer */ +#define SPI_TX_FULL_MASK (0x10U) /*!< TX full status mask \hideinitializer */ +#define SPI_TXRX_RESET_MASK (0x20U) /*!< TX or RX reset status mask \hideinitializer */ +#define SPI_SPIEN_STS_MASK (0x40U) /*!< SPIEN status mask \hideinitializer */ +#define SPI_SSLINE_STS_MASK (0x80U) /*!< SPIx_SS line status mask \hideinitializer */ + + +/* I2S Data Width */ +#define SPII2S_DATABIT_8 (0U << SPI_I2SCTL_WDWIDTH_Pos) /*!< I2S data width is 8-bit \hideinitializer */ +#define SPII2S_DATABIT_16 (1U << SPI_I2SCTL_WDWIDTH_Pos) /*!< I2S data width is 16-bit \hideinitializer */ +#define SPII2S_DATABIT_24 (2U << SPI_I2SCTL_WDWIDTH_Pos) /*!< I2S data width is 24-bit \hideinitializer */ +#define SPII2S_DATABIT_32 (3U << SPI_I2SCTL_WDWIDTH_Pos) /*!< I2S data width is 32-bit \hideinitializer */ + +/* I2S Audio Format */ +#define SPII2S_MONO SPI_I2SCTL_MONO_Msk /*!< Monaural channel \hideinitializer */ +#define SPII2S_STEREO (0U) /*!< Stereo channel \hideinitializer */ + +/* I2S Data Format */ +#define SPII2S_FORMAT_I2S (0U<STATUS = SPI_STATUS_UNITIF_Msk) + +/** + * @brief Trigger RX PDMA function. + * @param[in] spi The pointer of the specified SPI module. + * @return None. + * @details Set RXPDMAEN bit of SPI_PDMACTL register to enable RX PDMA transfer function. + * \hideinitializer + */ +#define SPI_TRIGGER_RX_PDMA(spi) ((spi)->PDMACTL |= SPI_PDMACTL_RXPDMAEN_Msk) + +/** + * @brief Trigger TX PDMA function. + * @param[in] spi The pointer of the specified SPI module. + * @return None. + * @details Set TXPDMAEN bit of SPI_PDMACTL register to enable TX PDMA transfer function. + * \hideinitializer + */ +#define SPI_TRIGGER_TX_PDMA(spi) ((spi)->PDMACTL |= SPI_PDMACTL_TXPDMAEN_Msk) + +/** + * @brief Disable RX PDMA transfer. + * @param[in] spi The pointer of the specified SPI module. + * @return None. + * @details Clear RXPDMAEN bit of SPI_PDMACTL register to disable RX PDMA transfer function. + * \hideinitializer + */ +#define SPI_DISABLE_RX_PDMA(spi) ( (spi)->PDMACTL &= ~SPI_PDMACTL_RXPDMAEN_Msk ) + +/** + * @brief Disable TX PDMA transfer. + * @param[in] spi The pointer of the specified SPI module. + * @return None. + * @details Clear TXPDMAEN bit of SPI_PDMACTL register to disable TX PDMA transfer function. + * \hideinitializer + */ +#define SPI_DISABLE_TX_PDMA(spi) ( (spi)->PDMACTL &= ~SPI_PDMACTL_TXPDMAEN_Msk ) + +/** + * @brief Get the count of available data in RX FIFO. + * @param[in] spi The pointer of the specified SPI module. + * @return The count of available data in RX FIFO. + * @details Read RXCNT (SPI_STATUS[27:24]) to get the count of available data in RX FIFO. + * \hideinitializer + */ +#define SPI_GET_RX_FIFO_COUNT(spi) (((spi)->STATUS & SPI_STATUS_RXCNT_Msk) >> SPI_STATUS_RXCNT_Pos) + +/** + * @brief Get the RX FIFO empty flag. + * @param[in] spi The pointer of the specified SPI module. + * @retval 0 RX FIFO is not empty. + * @retval 1 RX FIFO is empty. + * @details Read RXEMPTY bit of SPI_STATUS register to get the RX FIFO empty flag. + * \hideinitializer + */ +#define SPI_GET_RX_FIFO_EMPTY_FLAG(spi) (((spi)->STATUS & SPI_STATUS_RXEMPTY_Msk)>>SPI_STATUS_RXEMPTY_Pos) + +/** + * @brief Get the TX FIFO empty flag. + * @param[in] spi The pointer of the specified SPI module. + * @retval 0 TX FIFO is not empty. + * @retval 1 TX FIFO is empty. + * @details Read TXEMPTY bit of SPI_STATUS register to get the TX FIFO empty flag. + * \hideinitializer + */ +#define SPI_GET_TX_FIFO_EMPTY_FLAG(spi) (((spi)->STATUS & SPI_STATUS_TXEMPTY_Msk)>>SPI_STATUS_TXEMPTY_Pos) + +/** + * @brief Get the TX FIFO full flag. + * @param[in] spi The pointer of the specified SPI module. + * @retval 0 TX FIFO is not full. + * @retval 1 TX FIFO is full. + * @details Read TXFULL bit of SPI_STATUS register to get the TX FIFO full flag. + * \hideinitializer + */ +#define SPI_GET_TX_FIFO_FULL_FLAG(spi) (((spi)->STATUS & SPI_STATUS_TXFULL_Msk)>>SPI_STATUS_TXFULL_Pos) + +/** + * @brief Get the datum read from RX register. + * @param[in] spi The pointer of the specified SPI module. + * @return Data in RX register. + * @details Read SPI_RX register to get the received datum. + * \hideinitializer + */ +#define SPI_READ_RX(spi) ((spi)->RX) + +/** + * @brief Write datum to TX register. + * @param[in] spi The pointer of the specified SPI module. + * @param[in] u32TxData The datum which user attempt to transfer through SPI bus. + * @return None. + * @details Write u32TxData to SPI_TX register. + * \hideinitializer + */ +#define SPI_WRITE_TX(spi, u32TxData) ((spi)->TX = (u32TxData)) + +/** + * @brief Set SPIx_SS pin to high state. + * @param[in] spi The pointer of the specified SPI module. + * @return None. + * @details Disable automatic slave selection function and set SPIx_SS pin to high state. + * \hideinitializer + */ +#define SPI_SET_SS_HIGH(spi) ((spi)->SSCTL = ((spi)->SSCTL & (~SPI_SSCTL_AUTOSS_Msk)) | (SPI_SSCTL_SSACTPOL_Msk | SPI_SSCTL_SS_Msk)) + +/** + * @brief Set SPIx_SS pin to low state. + * @param[in] spi The pointer of the specified SPI module. + * @return None. + * @details Disable automatic slave selection function and set SPIx_SS pin to low state. + * \hideinitializer + */ +#define SPI_SET_SS_LOW(spi) ((spi)->SSCTL = ((spi)->SSCTL & (~(SPI_SSCTL_AUTOSS_Msk | SPI_SSCTL_SSACTPOL_Msk))) | SPI_SSCTL_SS_Msk) + +/** + * @brief Enable Byte Reorder function. + * @param[in] spi The pointer of the specified SPI module. + * @return None. + * @details Enable Byte Reorder function. The suspend interval depends on the setting of SUSPITV (SPI_CTL[7:4]). + * \hideinitializer + */ +#define SPI_ENABLE_BYTE_REORDER(spi) ((spi)->CTL |= SPI_CTL_REORDER_Msk) + +/** + * @brief Disable Byte Reorder function. + * @param[in] spi The pointer of the specified SPI module. + * @return None. + * @details Clear REORDER bit field of SPI_CTL register to disable Byte Reorder function. + * \hideinitializer + */ +#define SPI_DISABLE_BYTE_REORDER(spi) ((spi)->CTL &= ~SPI_CTL_REORDER_Msk) + +/** + * @brief Set the length of suspend interval. + * @param[in] spi The pointer of the specified SPI module. + * @param[in] u32SuspCycle Decides the length of suspend interval. It could be 0 ~ 15. + * @return None. + * @details Set the length of suspend interval according to u32SuspCycle. + * The length of suspend interval is ((u32SuspCycle + 0.5) * the length of one SPI bus clock cycle). + * \hideinitializer + */ +#define SPI_SET_SUSPEND_CYCLE(spi, u32SuspCycle) ((spi)->CTL = ((spi)->CTL & ~SPI_CTL_SUSPITV_Msk) | ((u32SuspCycle) << SPI_CTL_SUSPITV_Pos)) + +/** + * @brief Set the SPI transfer sequence with LSB first. + * @param[in] spi The pointer of the specified SPI module. + * @return None. + * @details Set LSB bit of SPI_CTL register to set the SPI transfer sequence with LSB first. + * \hideinitializer + */ +#define SPI_SET_LSB_FIRST(spi) ((spi)->CTL |= SPI_CTL_LSB_Msk) + +/** + * @brief Set the SPI transfer sequence with MSB first. + * @param[in] spi The pointer of the specified SPI module. + * @return None. + * @details Clear LSB bit of SPI_CTL register to set the SPI transfer sequence with MSB first. + * \hideinitializer + */ +#define SPI_SET_MSB_FIRST(spi) ((spi)->CTL &= ~SPI_CTL_LSB_Msk) + +/** + * @brief Set the data width of a SPI transaction. + * @param[in] spi The pointer of the specified SPI module. + * @param[in] u32Width The bit width of one transaction. + * @return None. + * @details The data width can be 8 ~ 32 bits. + * \hideinitializer + */ +#define SPI_SET_DATA_WIDTH(spi, u32Width) ((spi)->CTL = ((spi)->CTL & ~SPI_CTL_DWIDTH_Msk) | (((u32Width)&0x1F) << SPI_CTL_DWIDTH_Pos)) + +/** + * @brief Get the SPI busy state. + * @param[in] spi The pointer of the specified SPI module. + * @retval 0 SPI controller is not busy. + * @retval 1 SPI controller is busy. + * @details This macro will return the busy state of SPI controller. + * \hideinitializer + */ +#define SPI_IS_BUSY(spi) ( ((spi)->STATUS & SPI_STATUS_BUSY_Msk)>>SPI_STATUS_BUSY_Pos ) + +/** + * @brief Enable SPI controller. + * @param[in] spi The pointer of the specified SPI module. + * @return None. + * @details Set SPIEN (SPI_CTL[0]) to enable SPI controller. + * \hideinitializer + */ +#define SPI_ENABLE(spi) ((spi)->CTL |= SPI_CTL_SPIEN_Msk) + +/** + * @brief Disable SPI controller. + * @param[in] spi The pointer of the specified SPI module. + * @return None. + * @details Clear SPIEN (SPI_CTL[0]) to disable SPI controller. + * \hideinitializer + */ +#define SPI_DISABLE(spi) ((spi)->CTL &= ~SPI_CTL_SPIEN_Msk) + +/* Declare these inline functions here to avoid MISRA C 2004 rule 8.1 error */ +__STATIC_INLINE void SPII2S_ENABLE_TX_ZCD(SPI_T *i2s, uint32_t u32ChMask); +__STATIC_INLINE void SPII2S_DISABLE_TX_ZCD(SPI_T *i2s, uint32_t u32ChMask); +__STATIC_INLINE void SPII2S_SET_MONO_RX_CHANNEL(SPI_T *i2s, uint32_t u32Ch); + +/** + * @brief Enable zero cross detection function. + * @param[in] i2s The pointer of the specified I2S module. + * @param[in] u32ChMask The mask for left or right channel. Valid values are: + * - \ref SPII2S_RIGHT + * - \ref SPII2S_LEFT + * @return None + * @details This function will set RZCEN or LZCEN bit of SPI_I2SCTL register to enable zero cross detection function. + */ +__STATIC_INLINE void SPII2S_ENABLE_TX_ZCD(SPI_T *i2s, uint32_t u32ChMask) +{ + if(u32ChMask == SPII2S_RIGHT) + { + i2s->I2SCTL |= SPI_I2SCTL_RZCEN_Msk; + } + else + { + i2s->I2SCTL |= SPI_I2SCTL_LZCEN_Msk; + } +} + +/** + * @brief Disable zero cross detection function. + * @param[in] i2s The pointer of the specified I2S module. + * @param[in] u32ChMask The mask for left or right channel. Valid values are: + * - \ref SPII2S_RIGHT + * - \ref SPII2S_LEFT + * @return None + * @details This function will clear RZCEN or LZCEN bit of SPI_I2SCTL register to disable zero cross detection function. + */ +__STATIC_INLINE void SPII2S_DISABLE_TX_ZCD(SPI_T *i2s, uint32_t u32ChMask) +{ + if(u32ChMask == SPII2S_RIGHT) + { + i2s->I2SCTL &= ~SPI_I2SCTL_RZCEN_Msk; + } + else + { + i2s->I2SCTL &= ~SPI_I2SCTL_LZCEN_Msk; + } +} + +/** + * @brief Enable I2S TX DMA function. + * @param[in] i2s The pointer of the specified I2S module. + * @return None + * @details This macro will set TXPDMAEN bit of SPI_PDMACTL register to transmit data with PDMA. + * \hideinitializer + */ +#define SPII2S_ENABLE_TXDMA(i2s) ( (i2s)->PDMACTL |= SPI_PDMACTL_TXPDMAEN_Msk ) + +/** + * @brief Disable I2S TX DMA function. + * @param[in] i2s The pointer of the specified I2S module. + * @return None + * @details This macro will clear TXPDMAEN bit of SPI_PDMACTL register to disable TX DMA function. + * \hideinitializer + */ +#define SPII2S_DISABLE_TXDMA(i2s) ( (i2s)->PDMACTL &= ~SPI_PDMACTL_TXPDMAEN_Msk ) + +/** + * @brief Enable I2S RX DMA function. + * @param[in] i2s The pointer of the specified I2S module. + * @return None + * @details This macro will set RXPDMAEN bit of SPI_PDMACTL register to receive data with PDMA. + * \hideinitializer + */ +#define SPII2S_ENABLE_RXDMA(i2s) ( (i2s)->PDMACTL |= SPI_PDMACTL_RXPDMAEN_Msk ) + +/** + * @brief Disable I2S RX DMA function. + * @param[in] i2s The pointer of the specified I2S module. + * @return None + * @details This macro will clear RXPDMAEN bit of SPI_PDMACTL register to disable RX DMA function. + * \hideinitializer + */ +#define SPII2S_DISABLE_RXDMA(i2s) ( (i2s)->PDMACTL &= ~SPI_PDMACTL_RXPDMAEN_Msk ) + +/** + * @brief Enable I2S TX function. + * @param[in] i2s The pointer of the specified I2S module. + * @return None + * @details This macro will set TXEN bit of SPI_I2SCTL register to enable I2S TX function. + * \hideinitializer + */ +#define SPII2S_ENABLE_TX(i2s) ( (i2s)->I2SCTL |= SPI_I2SCTL_TXEN_Msk ) + +/** + * @brief Disable I2S TX function. + * @param[in] i2s The pointer of the specified I2S module. + * @return None + * @details This macro will clear TXEN bit of SPI_I2SCTL register to disable I2S TX function. + * \hideinitializer + */ +#define SPII2S_DISABLE_TX(i2s) ( (i2s)->I2SCTL &= ~SPI_I2SCTL_TXEN_Msk ) + +/** + * @brief Enable I2S RX function. + * @param[in] i2s The pointer of the specified I2S module. + * @return None + * @details This macro will set RXEN bit of SPI_I2SCTL register to enable I2S RX function. + * \hideinitializer + */ +#define SPII2S_ENABLE_RX(i2s) ( (i2s)->I2SCTL |= SPI_I2SCTL_RXEN_Msk ) + +/** + * @brief Disable I2S RX function. + * @param[in] i2s The pointer of the specified I2S module. + * @return None + * @details This macro will clear RXEN bit of SPI_I2SCTL register to disable I2S RX function. + * \hideinitializer + */ +#define SPII2S_DISABLE_RX(i2s) ( (i2s)->I2SCTL &= ~SPI_I2SCTL_RXEN_Msk ) + +/** + * @brief Enable TX Mute function. + * @param[in] i2s The pointer of the specified I2S module. + * @return None + * @details This macro will set MUTE bit of SPI_I2SCTL register to enable I2S TX mute function. + * \hideinitializer + */ +#define SPII2S_ENABLE_TX_MUTE(i2s) ( (i2s)->I2SCTL |= SPI_I2SCTL_MUTE_Msk ) + +/** + * @brief Disable TX Mute function. + * @param[in] i2s The pointer of the specified I2S module. + * @return None + * @details This macro will clear MUTE bit of SPI_I2SCTL register to disable I2S TX mute function. + * \hideinitializer + */ +#define SPII2S_DISABLE_TX_MUTE(i2s) ( (i2s)->I2SCTL &= ~SPI_I2SCTL_MUTE_Msk ) + +/** + * @brief Clear TX FIFO. + * @param[in] i2s The pointer of the specified I2S module. + * @return None + * @details This macro will clear TX FIFO. The internal TX FIFO pointer will be reset to FIFO start point. + * \hideinitializer + */ +#define SPII2S_CLR_TX_FIFO(i2s) ( (i2s)->FIFOCTL |= SPI_FIFOCTL_TXFBCLR_Msk ) + +/** + * @brief Clear RX FIFO. + * @param[in] i2s The pointer of the specified I2S module. + * @return None + * @details This macro will clear RX FIFO. The internal RX FIFO pointer will be reset to FIFO start point. + * \hideinitializer + */ +#define SPII2S_CLR_RX_FIFO(i2s) ( (i2s)->FIFOCTL |= SPI_FIFOCTL_RXFBCLR_Msk ) + +/** + * @brief This function sets the recording source channel when mono mode is used. + * @param[in] i2s The pointer of the specified I2S module. + * @param[in] u32Ch left or right channel. Valid values are: + * - \ref SPII2S_MONO_LEFT + * - \ref SPII2S_MONO_RIGHT + * @return None + * @details This function selects the recording source channel of monaural mode. + * \hideinitializer + */ +__STATIC_INLINE void SPII2S_SET_MONO_RX_CHANNEL(SPI_T *i2s, uint32_t u32Ch) +{ + u32Ch == SPII2S_MONO_LEFT ? + (i2s->I2SCTL |= SPI_I2SCTL_RXLCH_Msk) : + (i2s->I2SCTL &= ~SPI_I2SCTL_RXLCH_Msk); +} + +/** + * @brief Write data to I2S TX FIFO. + * @param[in] i2s The pointer of the specified I2S module. + * @param[in] u32Data The value written to TX FIFO. + * @return None + * @details This macro will write a value to TX FIFO. + * \hideinitializer + */ +#define SPII2S_WRITE_TX_FIFO(i2s, u32Data) ( (i2s)->TX = (u32Data) ) + +/** + * @brief Read RX FIFO. + * @param[in] i2s The pointer of the specified I2S module. + * @return The value read from RX FIFO. + * @details This function will return a value read from RX FIFO. + * \hideinitializer + */ +#define SPII2S_READ_RX_FIFO(i2s) ( (i2s)->RX ) + +/** + * @brief Get the interrupt flag. + * @param[in] i2s The pointer of the specified I2S module. + * @param[in] u32Mask The mask value for all interrupt flags. + * @return The interrupt flags specified by the u32mask parameter. + * @details This macro will return the combination interrupt flags of SPI_I2SSTS register. The flags are specified by the u32mask parameter. + * \hideinitializer + */ +#define SPII2S_GET_INT_FLAG(i2s, u32Mask) ( (i2s)->I2SSTS & (u32Mask) ) + +/** + * @brief Clear the interrupt flag. + * @param[in] i2s The pointer of the specified I2S module. + * @param[in] u32Mask The mask value for all interrupt flags. + * @return None + * @details This macro will clear the interrupt flags specified by the u32mask parameter. + * @note Except TX and RX FIFO threshold interrupt flags, the other interrupt flags can be cleared by writing 1 to itself. + * \hideinitializer + */ +#define SPII2S_CLR_INT_FLAG(i2s, u32Mask) ( (i2s)->I2SSTS = (u32Mask) ) + +/** + * @brief Get transmit FIFO level + * @param[in] i2s The pointer of the specified I2S module. + * @return TX FIFO level + * @details This macro will return the number of available words in TX FIFO. + * \hideinitializer + */ +#define SPII2S_GET_TX_FIFO_LEVEL(i2s) ( ((i2s)->I2SSTS & SPI_I2SSTS_TXCNT_Msk) >> SPI_I2SSTS_TXCNT_Pos ) + +/** + * @brief Get receive FIFO level + * @param[in] i2s The pointer of the specified I2S module. + * @return RX FIFO level + * @details This macro will return the number of available words in RX FIFO. + * \hideinitializer + */ +#define SPII2S_GET_RX_FIFO_LEVEL(i2s) ( ((i2s)->I2SSTS & SPI_I2SSTS_RXCNT_Msk) >> SPI_I2SSTS_RXCNT_Pos ) + + + +/* Function prototype declaration */ +uint32_t SPI_Open(SPI_T *spi, uint32_t u32MasterSlave, uint32_t u32SPIMode, uint32_t u32DataWidth, uint32_t u32BusClock); +void SPI_Close(SPI_T *spi); +void SPI_ClearRxFIFO(SPI_T *spi); +void SPI_ClearTxFIFO(SPI_T *spi); +void SPI_DisableAutoSS(SPI_T *spi); +void SPI_EnableAutoSS(SPI_T *spi, uint32_t u32SSPinMask, uint32_t u32ActiveLevel); +uint32_t SPI_SetBusClock(SPI_T *spi, uint32_t u32BusClock); +void SPI_SetFIFO(SPI_T *spi, uint32_t u32TxThreshold, uint32_t u32RxThreshold); +uint32_t SPI_GetBusClock(SPI_T *spi); +void SPI_EnableInt(SPI_T *spi, uint32_t u32Mask); +void SPI_DisableInt(SPI_T *spi, uint32_t u32Mask); +uint32_t SPI_GetIntFlag(SPI_T *spi, uint32_t u32Mask); +void SPI_ClearIntFlag(SPI_T *spi, uint32_t u32Mask); +uint32_t SPI_GetStatus(SPI_T *spi, uint32_t u32Mask); + +uint32_t SPII2S_Open(SPI_T *i2s, uint32_t u32MasterSlave, uint32_t u32SampleRate, uint32_t u32WordWidth, uint32_t u32Channels, uint32_t u32DataFormat); +void SPII2S_Close(SPI_T *i2s); +void SPII2S_EnableInt(SPI_T *i2s, uint32_t u32Mask); +void SPII2S_DisableInt(SPI_T *i2s, uint32_t u32Mask); +uint32_t SPII2S_EnableMCLK(SPI_T *i2s, uint32_t u32BusClock); +void SPII2S_DisableMCLK(SPI_T *i2s); +void SPII2S_SetFIFO(SPI_T *i2s, uint32_t u32TxThreshold, uint32_t u32RxThreshold); + + +/*@}*/ /* end of group SPI_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group SPI_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_spim.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_spim.h new file mode 100644 index 00000000000..84a0d98ffba --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_spim.h @@ -0,0 +1,634 @@ +/**************************************************************************//** + * @file nu_spim.h + * @version V1.00 + * @brief M480 series SPIM driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. +*****************************************************************************/ +#ifndef __NU_SPIM_H__ +#define __NU_SPIM_H__ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Include related headers */ +/*---------------------------------------------------------------------------------------------------------*/ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup SPIM_Driver SPIM Driver + @{ +*/ + + +/** @addtogroup SPIM_EXPORTED_CONSTANTS SPIM Exported Constants + @{ +*/ + +#define SPIM_DMM_MAP_ADDR 0x8000000UL /*!< DMM mode memory map base address \hideinitializer */ +#define SPIM_DMM_SIZE 0x2000000UL /*!< DMM mode memory mapping size \hideinitializer */ +#define SPIM_CCM_ADDR 0x20020000UL /*!< CCM mode memory map base address \hideinitializer */ +#define SPIM_CCM_SIZE 0x8000UL /*!< CCM mode memory size \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* SPIM_CTL0 constant definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define SPIM_CTL0_RW_IN(x) ((x) ? 0UL : (0x1UL << SPIM_CTL0_QDIODIR_Pos)) /*!< SPIM_CTL0: SPI Interface Direction Select \hideinitializer */ +#define SPIM_CTL0_BITMODE_SING (0UL << SPIM_CTL0_BITMODE_Pos) /*!< SPIM_CTL0: One bit mode (SPI Interface including DO, DI, HOLD, WP) \hideinitializer */ +#define SPIM_CTL0_BITMODE_DUAL (1UL << SPIM_CTL0_BITMODE_Pos) /*!< SPIM_CTL0: Two bits mode (SPI Interface including D0, D1, HOLD, WP) \hideinitializer */ +#define SPIM_CTL0_BITMODE_QUAD (2UL << SPIM_CTL0_BITMODE_Pos) /*!< SPIM_CTL0: Four bits mode (SPI Interface including D0, D1, D2, D3) \hideinitializer */ +#define SPIM_CTL0_OPMODE_IO (0UL << SPIM_CTL0_OPMODE_Pos) /*!< SPIM_CTL0: I/O Mode \hideinitializer */ +#define SPIM_CTL0_OPMODE_PAGEWRITE (1UL << SPIM_CTL0_OPMODE_Pos) /*!< SPIM_CTL0: Page Write Mode \hideinitializer */ +#define SPIM_CTL0_OPMODE_PAGEREAD (2UL << SPIM_CTL0_OPMODE_Pos) /*!< SPIM_CTL0: Page Read Mode \hideinitializer */ +#define SPIM_CTL0_OPMODE_DIRECTMAP (3UL << SPIM_CTL0_OPMODE_Pos) /*!< SPIM_CTL0: Direct Map Mode \hideinitializer */ + +#define CMD_NORMAL_PAGE_PROGRAM (0x02UL << SPIM_CTL0_CMDCODE_Pos) /*!< SPIM_CTL0: Page Program (Page Write Mode Use) \hideinitializer */ +#define CMD_NORMAL_PAGE_PROGRAM_4B (0x12UL << SPIM_CTL0_CMDCODE_Pos) /*!< SPIM_CTL0: Page Program (Page Write Mode Use) \hideinitializer */ +#define CMD_QUAD_PAGE_PROGRAM_WINBOND (0x32UL << SPIM_CTL0_CMDCODE_Pos) /*!< SPIM_CTL0: Quad Page program (for Winbond) (Page Write Mode Use) \hideinitializer */ +#define CMD_QUAD_PAGE_PROGRAM_MXIC (0x38UL << SPIM_CTL0_CMDCODE_Pos) /*!< SPIM_CTL0: Quad Page program (for MXIC) (Page Write Mode Use) \hideinitializer */ +#define CMD_QUAD_PAGE_PROGRAM_EON (0x40UL << SPIM_CTL0_CMDCODE_Pos) /*!< SPIM_CTL0: Quad Page Program (for EON) (Page Write Mode Use) \hideinitializer */ + +#define CMD_DMA_NORMAL_READ (0x03UL << SPIM_CTL0_CMDCODE_Pos) /*!< SPIM_CTL0: Read Data (Page Read Mode Use) \hideinitializer */ +#define CMD_DMA_FAST_READ (0x0BUL << SPIM_CTL0_CMDCODE_Pos) /*!< SPIM_CTL0: Fast Read (Page Read Mode Use) \hideinitializer */ +#define CMD_DMA_NORMAL_DUAL_READ (0x3BUL << SPIM_CTL0_CMDCODE_Pos) /*!< SPIM_CTL0: Fast Read Dual Output (Page Read Mode Use) \hideinitializer */ +#define CMD_DMA_FAST_READ_DUAL_OUTPUT (0x3BUL << SPIM_CTL0_CMDCODE_Pos) /*!< SPIM_CTL0: Fast Read Dual Output (Page Read Mode Use) \hideinitializer */ +#define CMD_DMA_FAST_READ_QUAD_OUTPUT (0x6BUL << SPIM_CTL0_CMDCODE_Pos) /*!< SPIM_CTL0: Fast Read Dual Output (Page Read Mode Use) \hideinitializer */ +#define CMD_DMA_FAST_DUAL_READ (0xBBUL << SPIM_CTL0_CMDCODE_Pos) /*!< SPIM_CTL0: Fast Read Dual Output (Page Read Mode Use) \hideinitializer */ +#define CMD_DMA_NORMAL_QUAD_READ (0xE7UL << SPIM_CTL0_CMDCODE_Pos) /*!< SPIM_CTL0: Fast Read Quad I/O (Page Read Mode Use) \hideinitializer */ +#define CMD_DMA_FAST_QUAD_READ (0xEBUL << SPIM_CTL0_CMDCODE_Pos) /*!< SPIM_CTL0: Fast Read Quad I/O (Page Read Mode Use) \hideinitializer */ + +/** @cond HIDDEN_SYMBOLS */ + +typedef enum +{ + MFGID_UNKNOW = 0x00U, + MFGID_SPANSION = 0x01U, + MFGID_EON = 0x1CU, + MFGID_ISSI = 0x7FU, + MFGID_MXIC = 0xC2U, + MFGID_WINBOND = 0xEFU +} +E_MFGID; + +/* Flash opcodes. */ +#define OPCODE_WREN 0x06U /* Write enable */ +#define OPCODE_RDSR 0x05U /* Read status register #1*/ +#define OPCODE_WRSR 0x01U /* Write status register #1 */ +#define OPCODE_RDSR2 0x35U /* Read status register #2*/ +#define OPCODE_WRSR2 0x31U /* Write status register #2 */ +#define OPCODE_RDSR3 0x15U /* Read status register #3*/ +#define OPCODE_WRSR3 0x11U /* Write status register #3 */ +#define OPCODE_PP 0x02U /* Page program (up to 256 bytes) */ +#define OPCODE_SE_4K 0x20U /* Erase 4KB sector */ +#define OPCODE_BE_32K 0x52U /* Erase 32KB block */ +#define OPCODE_CHIP_ERASE 0xc7U /* Erase whole flash chip */ +#define OPCODE_BE_64K 0xd8U /* Erase 64KB block */ +#define OPCODE_READ_ID 0x90U /* Read ID */ +#define OPCODE_RDID 0x9fU /* Read JEDEC ID */ +#define OPCODE_BRRD 0x16U /* SPANSION flash - Bank Register Read command */ +#define OPCODE_BRWR 0x17U /* SPANSION flash - Bank Register write command */ +#define OPCODE_NORM_READ 0x03U /* Read data bytes */ +#define OPCODE_FAST_READ 0x0bU /* Read data bytes */ +#define OPCODE_FAST_DUAL_READ 0x3bU /* Read data bytes */ +#define OPCODE_FAST_QUAD_READ 0x6bU /* Read data bytes */ + +/* Used for SST flashes only. */ +#define OPCODE_BP 0x02U /* Byte program */ +#define OPCODE_WRDI 0x04U /* Write disable */ +#define OPCODE_AAI_WP 0xadU /* Auto u32Address increment word program */ + +/* Used for Macronix flashes only. */ +#define OPCODE_EN4B 0xb7U /* Enter 4-byte mode */ +#define OPCODE_EX4B 0xe9U /* Exit 4-byte mode */ + +#define OPCODE_RDSCUR 0x2bU +#define OPCODE_WRSCUR 0x2fU + +#define OPCODE_RSTEN 0x66U +#define OPCODE_RST 0x99U + +#define OPCODE_ENQPI 0x38U +#define OPCODE_EXQPI 0xFFU + +/* Status Register bits. */ +#define SR_WIP 0x1U /* Write in progress */ +#define SR_WEL 0x2U /* Write enable latch */ +#define SR_QE 0x40U /* Quad Enable for MXIC */ +/* Status Register #2 bits. */ +#define SR2_QE 0x2U /* Quad Enable for Winbond */ +/* meaning of other SR_* bits may differ between vendors */ +#define SR_BP0 0x4U /* Block protect 0 */ +#define SR_BP1 0x8U /* Block protect 1 */ +#define SR_BP2 0x10U /* Block protect 2 */ +#define SR_SRWD 0x80U /* SR write protect */ +#define SR3_ADR 0x01U /* 4-byte u32Address mode */ + +#define SCUR_4BYTE 0x04U /* 4-byte u32Address mode */ + +/** @endcond HIDDEN_SYMBOLS */ + +/*@}*/ /* end of group SPIM_EXPORTED_CONSTANTS */ + + +/** @addtogroup SPIM_EXPORTED_FUNCTIONS SPIM Exported Functions + @{ +*/ + + +/*---------------------------------------------------------------------------------------------------------*/ +/* Define Macros and functions */ +/*---------------------------------------------------------------------------------------------------------*/ + +/** + * @details Enable cipher. + * \hideinitializer + */ +#define SPIM_ENABLE_CIPHER() (SPIM->CTL0 &= ~SPIM_CTL0_CIPHOFF_Msk) + +/** + * @details Disable cipher. + * \hideinitializer + */ +#define SPIM_DISABLE_CIPHER() (SPIM->CTL0 |= SPIM_CTL0_CIPHOFF_Msk) + +/** + * @details Enable cipher balance + * \hideinitializer + */ +#define SPIM_ENABLE_BALEN() (SPIM->CTL0 |= SPIM_CTL0_BALEN_Msk) + +/** + * @details Disable cipher balance + * \hideinitializer + */ +#define SPIM_DISABLE_BALEN() (SPIM->CTL0 &= ~SPIM_CTL0_BALEN_Msk) + +/** + * @details Set 4-byte address to be enabled/disabled. + * \hideinitializer + */ +#define SPIM_SET_4BYTE_ADDR_EN(x) \ + do { \ + SPIM->CTL0 = (SPIM->CTL0 & (~SPIM_CTL0_B4ADDREN_Msk)) | (((x) ? 1UL : 0UL) << SPIM_CTL0_B4ADDREN_Pos); \ + } while (0) + +/** + * @details Enable SPIM interrupt + * \hideinitializer + */ +#define SPIM_ENABLE_INT() (SPIM->CTL0 |= SPIM_CTL0_IEN_Msk) + +/** + * @details Disable SPIM interrupt + * \hideinitializer + */ +#define SPIM_DISABLE_INT() (SPIM->CTL0 &= ~SPIM_CTL0_IEN_Msk) + +/** + * @details Is interrupt flag on. + * \hideinitializer + */ +#define SPIM_IS_IF_ON() ((SPIM->CTL0 & SPIM_CTL0_IF_Msk) != 0UL) + +/** + * @details Clear interrupt flag. + * \hideinitializer + */ +#define SPIM_CLR_INT() \ + do { \ + SPIM->CTL0 = (SPIM->CTL0 & (~SPIM_CTL0_IF_Msk)) | (1UL << SPIM_CTL0_IF_Pos); \ + } while (0) + +/** + * @details Set transmit/receive bit length + * \hideinitializer + */ +#define SPIM_SET_DATA_WIDTH(x) \ + do { \ + SPIM->CTL0 = (SPIM->CTL0 & (~SPIM_CTL0_DWIDTH_Msk)) | (((x) - 1U) << SPIM_CTL0_DWIDTH_Pos); \ + } while (0) + +/** + * @details Get data transmit/receive bit length setting + * \hideinitializer + */ +#define SPIM_GET_DATA_WIDTH() \ + (((SPIM->CTL0 & SPIM_CTL0_DWIDTH_Msk) >> SPIM_CTL0_DWIDTH_Pos)+1U) + +/** + * @details Set data transmit/receive burst number + * \hideinitializer + */ +#define SPIM_SET_DATA_NUM(x) \ + do { \ + SPIM->CTL0 = (SPIM->CTL0 & (~SPIM_CTL0_BURSTNUM_Msk)) | (((x) - 1U) << SPIM_CTL0_BURSTNUM_Pos); \ + } while (0) + +/** + * @details Get data transmit/receive burst number + * \hideinitializer + */ +#define SPIM_GET_DATA_NUM() \ + (((SPIM->CTL0 & SPIM_CTL0_BURSTNUM_Msk) >> SPIM_CTL0_BURSTNUM_Pos)+1U) + +/** + * @details Enable Single Input mode. + * \hideinitializer + */ +#define SPIM_ENABLE_SING_INPUT_MODE() \ + do { \ + SPIM->CTL0 = (SPIM->CTL0 & (~(SPIM_CTL0_BITMODE_Msk | SPIM_CTL0_QDIODIR_Msk))) | (SPIM_CTL0_BITMODE_SING | SPIM_CTL0_RW_IN(1)); \ + } while (0) + +/** + * @details Enable Single Output mode. + * \hideinitializer + */ +#define SPIM_ENABLE_SING_OUTPUT_MODE() \ + do { \ + SPIM->CTL0 = (SPIM->CTL0 & (~(SPIM_CTL0_BITMODE_Msk | SPIM_CTL0_QDIODIR_Msk))) | (SPIM_CTL0_BITMODE_SING | SPIM_CTL0_RW_IN(0)); \ + } while (0) + +/** + * @details Enable Dual Input mode. + * \hideinitializer + */ +#define SPIM_ENABLE_DUAL_INPUT_MODE() \ + do { \ + SPIM->CTL0 = (SPIM->CTL0 & (~(SPIM_CTL0_BITMODE_Msk | SPIM_CTL0_QDIODIR_Msk))) | (SPIM_CTL0_BITMODE_DUAL | SPIM_CTL0_RW_IN(1U)); \ + } while (0) + +/** + * @details Enable Dual Output mode. + * \hideinitializer + */ +#define SPIM_ENABLE_DUAL_OUTPUT_MODE() \ + do { \ + SPIM->CTL0 = (SPIM->CTL0 & (~(SPIM_CTL0_BITMODE_Msk | SPIM_CTL0_QDIODIR_Msk))) | (SPIM_CTL0_BITMODE_DUAL | SPIM_CTL0_RW_IN(0U)); \ + } while (0) + +/** + * @details Enable Quad Input mode. + * \hideinitializer + */ +#define SPIM_ENABLE_QUAD_INPUT_MODE() \ + do { \ + SPIM->CTL0 = (SPIM->CTL0 & (~(SPIM_CTL0_BITMODE_Msk | SPIM_CTL0_QDIODIR_Msk))) | (SPIM_CTL0_BITMODE_QUAD | SPIM_CTL0_RW_IN(1U)); \ + } while (0) + +/** + * @details Enable Quad Output mode. + * \hideinitializer + */ +#define SPIM_ENABLE_QUAD_OUTPUT_MODE() \ + do { \ + SPIM->CTL0 = (SPIM->CTL0 & (~(SPIM_CTL0_BITMODE_Msk | SPIM_CTL0_QDIODIR_Msk))) | (SPIM_CTL0_BITMODE_QUAD | SPIM_CTL0_RW_IN(0U)); \ + } while (0) + +/** + * @details Set suspend interval which ranges between 0 and 15. + * \hideinitializer + */ +#define SPIM_SET_SUSP_INTVL(x) \ + do { \ + SPIM->CTL0 = (SPIM->CTL0 & (~SPIM_CTL0_SUSPITV_Msk)) | ((x) << SPIM_CTL0_SUSPITV_Pos); \ + } while (0) + +/** + * @details Get suspend interval setting + * \hideinitializer + */ +#define SPIM_GET_SUSP_INTVL() \ + ((SPIM->CTL0 & SPIM_CTL0_SUSPITV_Msk) >> SPIM_CTL0_SUSPITV_Pos) + +/** + * @details Set operation mode. + * \hideinitializer + */ +#define SPIM_SET_OPMODE(x) \ + do { \ + SPIM->CTL0 = (SPIM->CTL0 & (~SPIM_CTL0_OPMODE_Msk)) | (x); \ + } while (0) + +/** + * @details Get operation mode. + * \hideinitializer + */ +#define SPIM_GET_OP_MODE() (SPIM->CTL0 & SPIM_CTL0_OPMODE_Msk) + +/** + * @details Set SPIM mode. + * \hideinitializer + */ +#define SPIM_SET_SPIM_MODE(x) \ + do { \ + SPIM->CTL0 = (SPIM->CTL0 & (~SPIM_CTL0_CMDCODE_Msk)) | (x); \ + } while (0) + +/** + * @details Get SPIM mode. + * \hideinitializer + */ +#define SPIM_GET_SPIM_MODE() (SPIM->CTL0 & SPIM_CTL0_CMDCODE_Msk) + +/** + * @details Start operation. + * \hideinitializer + */ +#define SPIM_SET_GO() (SPIM->CTL1 |= SPIM_CTL1_SPIMEN_Msk) + +/** + * @details Is engine busy. + * \hideinitializer + */ +#define SPIM_IS_BUSY() (SPIM->CTL1 & SPIM_CTL1_SPIMEN_Msk) + +/** + * @details Wait for free. + * \hideinitializer + */ +#define SPIM_WAIT_FREE() \ + do { \ + while (SPIM->CTL1 & SPIM_CTL1_SPIMEN_Msk) { } \ + } while (0) + +/** + * @details Enable cache. + * \hideinitializer + */ +#define SPIM_ENABLE_CACHE() (SPIM->CTL1 &= ~SPIM_CTL1_CACHEOFF_Msk) + +/** + * @details Disable cache. + * \hideinitializer + */ +#define SPIM_DISABLE_CACHE() (SPIM->CTL1 |= SPIM_CTL1_CACHEOFF_Msk) + +/** + * @details Is cache enabled. + * \hideinitializer + */ +#define SPIM_IS_CACHE_EN() ((SPIM->CTL1 & SPIM_CTL1_CACHEOFF_Msk) ? 0 : 1) + +/** + * @details Enable CCM + * \hideinitializer + */ +#define SPIM_ENABLE_CCM() (SPIM->CTL1 |= SPIM_CTL1_CCMEN_Msk) + +/** + * @details Disable CCM. + * \hideinitializer + */ +#define SPIM_DISABLE_CCM() (SPIM->CTL1 &= ~SPIM_CTL1_CCMEN_Msk) + +/** + * @details Is CCM enabled. + * \hideinitializer + */ +#define SPIM_IS_CCM_EN() ((SPIM->CTL1 & SPIM_CTL1_CCMEN_Msk) >> SPIM_CTL1_CCMEN_Pos) + +/** + * @details Invalidate cache. + * \hideinitializer + */ +#define SPIM_INVALID_CACHE() (SPIM->CTL1 |= SPIM_CTL1_CDINVAL_Msk) + +/** + * @details Set SS(Select Active) to active level. + * \hideinitializer + */ +#define SPIM_SET_SS_EN(x) \ + do { \ + (SPIM->CTL1 = (SPIM->CTL1 & (~SPIM_CTL1_SS_Msk)) | ((! (x) ? 1UL : 0UL) << SPIM_CTL1_SS_Pos)); \ + } while (0) + +/** + * @details Is SS(Select Active) in active level. + * \hideinitializer + */ +#define SPIM_GET_SS_EN() \ + (!(SPIM->CTL1 & SPIM_CTL1_SS_Msk)) + +/** + * @details Set active level of slave select to be high/low. + * \hideinitializer + */ +#define SPIM_SET_SS_ACTLVL(x) \ + do { \ + (SPIM->CTL1 = (SPIM->CTL1 & (~SPIM_CTL1_SSACTPOL_Msk)) | ((!! (x) ? 1UL : 0UL) << SPIM_CTL1_SSACTPOL_Pos)); \ + } while (0) + +/** + * @details Set idle time interval + * \hideinitializer + */ +#define SPIM_SET_IDL_INTVL(x) \ + do { \ + SPIM->CTL1 = (SPIM->CTL1 & (~SPIM_CTL1_IDLETIME_Msk)) | ((x) << SPIM_CTL1_IDLETIME_Pos); \ + } while (0) + +/** + * @details Get idle time interval setting + * \hideinitializer + */ +#define SPIM_GET_IDL_INTVL() \ + ((SPIM->CTL1 & SPIM_CTL1_IDLETIME_Msk) >> SPIM_CTL1_IDLETIME_Pos) + +/** + * @details Set SPIM clock divider + * \hideinitializer + */ +#define SPIM_SET_CLOCK_DIVIDER(x) \ + do { \ + SPIM->CTL1 = (SPIM->CTL1 & (~SPIM_CTL1_DIVIDER_Msk)) | ((x) << SPIM_CTL1_DIVIDER_Pos); \ + } while (0) + +/** + * @details Get SPIM current clock divider setting + * \hideinitializer + */ +#define SPIM_GET_CLOCK_DIVIDER() \ + ((SPIM->CTL1 & SPIM_CTL1_DIVIDER_Msk) >> SPIM_CTL1_DIVIDER_Pos) + +/** + * @details Set SPI flash deselect time interval of DMA write mode + * \hideinitializer + */ +#define SPIM_SET_RXCLKDLY_DWDELSEL(x) \ + do { \ + (SPIM->RXCLKDLY = (SPIM->RXCLKDLY & (~SPIM_RXCLKDLY_DWDELSEL_Msk)) | ((x) << SPIM_RXCLKDLY_DWDELSEL_Pos)); \ + } while (0) + +/** + * @details Get SPI flash deselect time interval of DMA write mode + * \hideinitializer + */ +#define SPIM_GET_RXCLKDLY_DWDELSEL() \ + ((SPIM->RXCLKDLY & SPIM_RXCLKDLY_DWDELSEL_Msk) >> SPIM_RXCLKDLY_DWDELSEL_Pos) + +/** + * @details Set sampling clock delay selection for received data + * \hideinitializer + */ +#define SPIM_SET_RXCLKDLY_RDDLYSEL(x) \ + do { \ + (SPIM->RXCLKDLY = (SPIM->RXCLKDLY & (~SPIM_RXCLKDLY_RDDLYSEL_Msk)) | ((x) << SPIM_RXCLKDLY_RDDLYSEL_Pos)); \ + } while (0) + +/** + * @details Get sampling clock delay selection for received data + * \hideinitializer + */ +#define SPIM_GET_RXCLKDLY_RDDLYSEL() \ + ((SPIM->RXCLKDLY & SPIM_RXCLKDLY_RDDLYSEL_Msk) >> SPIM_RXCLKDLY_RDDLYSEL_Pos) + +/** + * @details Set sampling clock edge selection for received data + * \hideinitializer + */ +#define SPIM_SET_RXCLKDLY_RDEDGE() \ + (SPIM->RXCLKDLY |= SPIM_RXCLKDLY_RDEDGE_Msk); \ + +/** + * @details Get sampling clock edge selection for received data + * \hideinitializer + */ +#define SPIM_CLR_RXCLKDLY_RDEDGE() \ + (SPIM->RXCLKDLY &= ~SPIM_RXCLKDLY_RDEDGE_Msk) + +/** + * @details Set mode bits data for continuous read mode + * \hideinitializer + */ +#define SPIM_SET_DMMCTL_CRMDAT(x) \ + do { \ + (SPIM->DMMCTL = (SPIM->DMMCTL & (~SPIM_DMMCTL_CRMDAT_Msk)) | ((x) << SPIM_DMMCTL_CRMDAT_Pos)) | SPIM_DMMCTL_CREN_Msk; \ + } while (0) + +/** + * @details Get mode bits data for continuous read mode + * \hideinitializer + */ +#define SPIM_GET_DMMCTL_CRMDAT() \ + ((SPIM->DMMCTL & SPIM_DMMCTL_CRMDAT_Msk) >> SPIM_DMMCTL_CRMDAT_Pos) + +/** + * @details Set DMM mode SPI flash deselect time + * \hideinitializer + */ +#define SPIM_DMM_SET_DESELTIM(x) \ + do { \ + SPIM->DMMCTL = (SPIM->DMMCTL & ~SPIM_DMMCTL_DESELTIM_Msk) | (((x) & 0x1FUL) << SPIM_DMMCTL_DESELTIM_Pos); \ + } while (0) + +/** + * @details Get current DMM mode SPI flash deselect time setting + * \hideinitializer + */ +#define SPIM_DMM_GET_DESELTIM() \ + ((SPIM->DMMCTL & SPIM_DMMCTL_DESELTIM_Msk) >> SPIM_DMMCTL_DESELTIM_Pos) + +/** + * @details Enable DMM mode burst wrap mode + * \hideinitializer + */ +#define SPIM_DMM_ENABLE_BWEN() (SPIM->DMMCTL |= SPIM_DMMCTL_BWEN_Msk) + +/** + * @details Disable DMM mode burst wrap mode + * \hideinitializer + */ +#define SPIM_DMM_DISABLE_BWEN() (SPIM->DMMCTL &= ~SPIM_DMMCTL_BWEN_Msk) + +/** + * @details Enable DMM mode continuous read mode + * \hideinitializer + */ +#define SPIM_DMM_ENABLE_CREN() (SPIM->DMMCTL |= SPIM_DMMCTL_CREN_Msk) + +/** + * @details Disable DMM mode continuous read mode + * \hideinitializer + */ +#define SPIM_DMM_DISABLE_CREN() (SPIM->DMMCTL &= ~SPIM_DMMCTL_CREN_Msk) + +/** + * @details Set DMM mode SPI flash active SCLK time + * \hideinitializer + */ +#define SPIM_DMM_SET_ACTSCLKT(x) \ + do { \ + SPIM->DMMCTL = (SPIM->DMMCTL & ~SPIM_DMMCTL_ACTSCLKT_Msk) | (((x) & 0xFUL) << SPIM_DMMCTL_ACTSCLKT_Pos) | SPIM_DMMCTL_UACTSCLK_Msk; \ + } while (0) + +/** + * @details Set SPI flash active SCLK time as SPIM default + * \hideinitializer + */ +#define SPIM_DMM_SET_DEFAULT_ACTSCLK() (SPIM->DMMCTL &= ~SPIM_DMMCTL_UACTSCLK_Msk) + +/** + * @details Set dummy cycle number (Only for DMM mode and DMA mode) + * \hideinitializer + */ +#define SPIM_SET_DCNUM(x) \ + do { \ + SPIM->CTL2 = (SPIM->CTL2 & ~SPIM_CTL2_DCNUM_Msk) | (((x) & 0x1FUL) << SPIM_CTL2_DCNUM_Pos) | SPIM_CTL2_USETEN_Msk; \ + } while (0) + +/** + * @details Set dummy cycle number (Only for DMM mode and DMA mode) as SPIM default + * \hideinitializer + */ +#define SPIM_SET_DEFAULT_DCNUM(x) (SPIM->CTL2 &= ~SPIM_CTL2_USETEN_Msk) + + + +/*---------------------------------------------------------------------------------------------------------*/ +/* Define Function Prototypes */ +/*---------------------------------------------------------------------------------------------------------*/ + + +int SPIM_InitFlash(int clrWP); +uint32_t SPIM_GetSClkFreq(void); +void SPIM_ReadJedecId(uint8_t idBuf[], uint32_t u32NRx, uint32_t u32NBit); +int SPIM_Enable_4Bytes_Mode(int isEn, uint32_t u32NBit); +int SPIM_Is4ByteModeEnable(uint32_t u32NBit); + +void SPIM_ChipErase(uint32_t u32NBit, int isSync); +void SPIM_EraseBlock(uint32_t u32Addr, int is4ByteAddr, uint8_t u8ErsCmd, uint32_t u32NBit, int isSync); + +void SPIM_IO_Write(uint32_t u32Addr, int is4ByteAddr, uint32_t u32NTx, uint8_t pu8TxBuf[], uint8_t wrCmd, uint32_t u32NBitCmd, uint32_t u32NBitAddr, uint32_t u32NBitDat); +void SPIM_IO_Read(uint32_t u32Addr, int is4ByteAddr, uint32_t u32NRx, uint8_t pu8RxBuf[], uint8_t rdCmd, uint32_t u32NBitCmd, uint32_t u32NBitAddr, uint32_t u32NBitDat, int u32NDummy); + +void SPIM_DMA_Write(uint32_t u32Addr, int is4ByteAddr, uint32_t u32NTx, uint8_t pu8TxBuf[], uint32_t wrCmd); +void SPIM_DMA_Read(uint32_t u32Addr, int is4ByteAddr, uint32_t u32NRx, uint8_t pu8RxBuf[], uint32_t u32RdCmd, int isSync); + +void SPIM_EnterDirectMapMode(int is4ByteAddr, uint32_t u32RdCmd, uint32_t u32IdleIntvl); +void SPIM_ExitDirectMapMode(void); + +void SPIM_SetQuadEnable(int isEn, uint32_t u32NBit); + +void SPIM_WinbondUnlock(uint32_t u32NBit); + +/*@}*/ /* end of group SPIM_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group SPIM_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_SPIM_H__ */ + +/*** (C) COPYRIGHT 2017 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_sys.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_sys.h new file mode 100644 index 00000000000..a476699c2af --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_sys.h @@ -0,0 +1,1636 @@ +/**************************************************************************//** + * @file SYS.h + * @version V3.0 + * @brief M480 Series SYS Driver Header File + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + ******************************************************************************/ + +#ifndef __NU_SYS_H__ +#define __NU_SYS_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup SYS_Driver SYS Driver + @{ +*/ + +/** @addtogroup SYS_EXPORTED_CONSTANTS SYS Exported Constants + @{ +*/ + + +/*---------------------------------------------------------------------------------------------------------*/ +/* Module Reset Control Resister constant definitions. */ +/*---------------------------------------------------------------------------------------------------------*/ +#define PDMA_RST ((0UL<<24) | SYS_IPRST0_PDMARST_Pos) /*!< Reset PDMA \hideinitializer*/ +#define EBI_RST ((0UL<<24) | SYS_IPRST0_EBIRST_Pos) /*!< Reset EBI \hideinitializer*/ +#define EMAC_RST ((0UL<<24) | SYS_IPRST0_EMACRST_Pos) /*!< Reset EMAC \hideinitializer */ +#define SDH0_RST ((0UL<<24) | SYS_IPRST0_SDH0RST_Pos) /*!< Reset SDH0 \hideinitializer */ +#define CRC_RST ((0UL<<24) | SYS_IPRST0_CRCRST_Pos) /*!< Reset CRC \hideinitializer */ +#define CCAP_RST ((0UL<<24) | SYS_IPRST0_CCAPRST_Pos) /*!< Reset ICAP \hideinitializer */ +#define HSUSBD_RST ((0UL<<24) | SYS_IPRST0_HSUSBDRST_Pos) /*!< Reset HSUSBD \hideinitializer */ +#define CRPT_RST ((0UL<<24) | SYS_IPRST0_CRPTRST_Pos) /*!< Reset CRPT \hideinitializer */ +#define SPIM_RST ((0UL<<24) | SYS_IPRST0_SPIMRST_Pos) /*!< Reset SPIM \hideinitializer */ +#define USBH_RST ((0UL<<24) | SYS_IPRST0_USBHRST_Pos) /*!< Reset USBH \hideinitializer */ +#define SDH1_RST ((0UL<<24) | SYS_IPRST0_SDH1RST_Pos) /*!< Reset SDH1 \hideinitializer */ + +#define GPIO_RST ((4UL<<24) | SYS_IPRST1_GPIORST_Pos) /*!< Reset GPIO \hideinitializer */ +#define TMR0_RST ((4UL<<24) | SYS_IPRST1_TMR0RST_Pos) /*!< Reset TMR0 \hideinitializer */ +#define TMR1_RST ((4UL<<24) | SYS_IPRST1_TMR1RST_Pos) /*!< Reset TMR1 \hideinitializer */ +#define TMR2_RST ((4UL<<24) | SYS_IPRST1_TMR2RST_Pos) /*!< Reset TMR2 \hideinitializer */ +#define TMR3_RST ((4UL<<24) | SYS_IPRST1_TMR3RST_Pos) /*!< Reset TMR3 \hideinitializer */ +#define ACMP01_RST ((4UL<<24) | SYS_IPRST1_ACMP01RST_Pos) /*!< Reset ACMP01 \hideinitializer */ +#define I2C0_RST ((4UL<<24) | SYS_IPRST1_I2C0RST_Pos) /*!< Reset I2C0 \hideinitializer */ +#define I2C1_RST ((4UL<<24) | SYS_IPRST1_I2C1RST_Pos) /*!< Reset I2C1 \hideinitializer */ +#define I2C2_RST ((4UL<<24) | SYS_IPRST1_I2C2RST_Pos) /*!< Reset I2C2 \hideinitializer */ +#define QSPI0_RST ((4UL<<24) | SYS_IPRST1_QSPI0RST_Pos) /*!< Reset QSPI0 \hideinitializer */ +#define SPI0_RST ((4UL<<24) | SYS_IPRST1_SPI0RST_Pos) /*!< Reset SPI0 \hideinitializer */ +#define SPI1_RST ((4UL<<24) | SYS_IPRST1_SPI1RST_Pos) /*!< Reset SPI1 \hideinitializer */ +#define SPI2_RST ((4UL<<24) | SYS_IPRST1_SPI2RST_Pos) /*!< Reset SPI2 \hideinitializer */ +#define UART0_RST ((4UL<<24) | SYS_IPRST1_UART0RST_Pos) /*!< Reset UART0 \hideinitializer */ +#define UART1_RST ((4UL<<24) | SYS_IPRST1_UART1RST_Pos) /*!< Reset UART1 \hideinitializer */ +#define UART2_RST ((4UL<<24) | SYS_IPRST1_UART2RST_Pos) /*!< Reset UART2 \hideinitializer */ +#define UART3_RST ((4UL<<24) | SYS_IPRST1_UART3RST_Pos) /*!< Reset UART3 \hideinitializer */ +#define UART4_RST ((4UL<<24) | SYS_IPRST1_UART4RST_Pos) /*!< Reset UART4 \hideinitializer */ +#define UART5_RST ((4UL<<24) | SYS_IPRST1_UART5RST_Pos) /*!< Reset UART5 \hideinitializer */ +#define UART6_RST ((4UL<<24) | SYS_IPRST1_UART6RST_Pos) /*!< Reset UART6 \hideinitializer */ +#define UART7_RST ((4UL<<24) | SYS_IPRST1_UART7RST_Pos) /*!< Reset UART7 \hideinitializer */ +#define CAN0_RST ((4UL<<24) | SYS_IPRST1_CAN0RST_Pos) /*!< Reset CAN0 \hideinitializer */ +#define CAN1_RST ((4UL<<24) | SYS_IPRST1_CAN1RST_Pos) /*!< Reset CAN1 \hideinitializer */ +#define OTG_RST ((4UL<<24) | SYS_IPRST1_OTGRST_Pos) /*!< Reset OTG \hideinitializer */ +#define USBD_RST ((4UL<<24) | SYS_IPRST1_USBDRST_Pos) /*!< Reset USBD \hideinitializer */ +#define EADC_RST ((4UL<<24) | SYS_IPRST1_EADCRST_Pos) /*!< Reset EADC \hideinitializer */ +#define I2S0_RST ((4UL<<24) | SYS_IPRST1_I2S0RST_Pos) /*!< Reset I2S0 \hideinitializer */ +#define HSOTG_RST ((4UL<<24) | SYS_IPRST1_HSOTGRST_Pos) /*!< Reset HSOTG \hideinitializer */ +#define TRNG_RST ((4UL<<24) | SYS_IPRST1_TRNGRST_Pos) /*!< Reset TRNG \hideinitializer */ + +#define SC0_RST ((8UL<<24) | SYS_IPRST2_SC0RST_Pos) /*!< Reset SC0 \hideinitializer */ +#define SC1_RST ((8UL<<24) | SYS_IPRST2_SC1RST_Pos) /*!< Reset SC1 \hideinitializer */ +#define SC2_RST ((8UL<<24) | SYS_IPRST2_SC2RST_Pos) /*!< Reset SC2 \hideinitializer */ +#define QSPI1_RST ((8UL<<24) | SYS_IPRST2_QSPI1RST_Pos) /*!< Reset QSPI1 \hideinitializer */ +#define SPI3_RST ((8UL<<24) | SYS_IPRST2_SPI3RST_Pos) /*!< Reset SPI3 \hideinitializer */ +#define USCI0_RST ((8UL<<24) | SYS_IPRST2_USCI0RST_Pos) /*!< Reset USCI0 \hideinitializer */ +#define USCI1_RST ((8UL<<24) | SYS_IPRST2_USCI1RST_Pos) /*!< Reset USCI1 \hideinitializer */ +#define DAC_RST ((8UL<<24) | SYS_IPRST2_DACRST_Pos) /*!< Reset DAC \hideinitializer */ +#define EPWM0_RST ((8UL<<24) | SYS_IPRST2_EPWM0RST_Pos) /*!< Reset EPWM0 \hideinitializer */ +#define EPWM1_RST ((8UL<<24) | SYS_IPRST2_EPWM1RST_Pos) /*!< Reset EPWM1 \hideinitializer */ +#define BPWM0_RST ((8UL<<24) | SYS_IPRST2_BPWM0RST_Pos) /*!< Reset BPWM0 \hideinitializer */ +#define BPWM1_RST ((8UL<<24) | SYS_IPRST2_BPWM1RST_Pos) /*!< Reset BPWM1 \hideinitializer */ +#define QEI0_RST ((8UL<<24) | SYS_IPRST2_QEI0RST_Pos) /*!< Reset QEI0 \hideinitializer */ +#define QEI1_RST ((8UL<<24) | SYS_IPRST2_QEI1RST_Pos) /*!< Reset QEI1 \hideinitializer */ +#define ECAP0_RST ((8UL<<24) | SYS_IPRST2_ECAP0RST_Pos) /*!< Reset ECAP0 \hideinitializer */ +#define ECAP1_RST ((8UL<<24) | SYS_IPRST2_ECAP1RST_Pos) /*!< Reset ECAP1 \hideinitializer */ +#define CAN2_RST ((8UL<<24) | SYS_IPRST2_CAN2RST_Pos) /*!< Reset CAN2 \hideinitializer */ +#define OPA_RST ((8UL<<24) | SYS_IPRST2_OPARST_Pos) /*!< Reset OPA \hideinitializer */ +#define EADC1_RST ((8UL<<24) | SYS_IPRST2_EADC1RST_Pos) /*!< Reset EADC1 \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Brown Out Detector Threshold Voltage Selection constant definitions. */ +/*---------------------------------------------------------------------------------------------------------*/ +#define SYS_BODCTL_BOD_RST_EN (1UL << SYS_BODCTL_BODRSTEN_Pos) /*!< Brown-out Reset Enable \hideinitializer */ +#define SYS_BODCTL_BOD_INTERRUPT_EN (0UL << SYS_BODCTL_BODRSTEN_Pos) /*!< Brown-out Interrupt Enable \hideinitializer */ +#define SYS_BODCTL_BODVL_3_0V (7UL << SYS_BODCTL_BODVL_Pos) /*!< Setting Brown Out Detector Threshold Voltage as 3.0V \hideinitializer */ +#define SYS_BODCTL_BODVL_2_8V (6UL << SYS_BODCTL_BODVL_Pos) /*!< Setting Brown Out Detector Threshold Voltage as 2.8V \hideinitializer */ +#define SYS_BODCTL_BODVL_2_6V (5UL << SYS_BODCTL_BODVL_Pos) /*!< Setting Brown Out Detector Threshold Voltage as 2.6V \hideinitializer */ +#define SYS_BODCTL_BODVL_2_4V (4UL << SYS_BODCTL_BODVL_Pos) /*!< Setting Brown Out Detector Threshold Voltage as 2.4V \hideinitializer */ +#define SYS_BODCTL_BODVL_2_2V (3UL << SYS_BODCTL_BODVL_Pos) /*!< Setting Brown Out Detector Threshold Voltage as 2.2V \hideinitializer */ +#define SYS_BODCTL_BODVL_2_0V (2UL << SYS_BODCTL_BODVL_Pos) /*!< Setting Brown Out Detector Threshold Voltage as 2.0V \hideinitializer */ +#define SYS_BODCTL_BODVL_1_8V (1UL << SYS_BODCTL_BODVL_Pos) /*!< Setting Brown Out Detector Threshold Voltage as 1.8V \hideinitializer */ +#define SYS_BODCTL_BODVL_1_6V (0UL << SYS_BODCTL_BODVL_Pos) /*!< Setting Brown Out Detector Threshold Voltage as 1.6V \hideinitializer */ + + +/*---------------------------------------------------------------------------------------------------------*/ +/* VREFCTL constant definitions. (Write-Protection Register) */ +/*---------------------------------------------------------------------------------------------------------*/ +#define SYS_VREFCTL_VREF_PIN (0x0UL << SYS_VREFCTL_VREFCTL_Pos) /*!< Vref = Vref pin \hideinitializer */ +#define SYS_VREFCTL_VREF_1_6V (0x3UL << SYS_VREFCTL_VREFCTL_Pos) /*!< Vref = 1.6V \hideinitializer */ +#define SYS_VREFCTL_VREF_2_0V (0x7UL << SYS_VREFCTL_VREFCTL_Pos) /*!< Vref = 2.0V \hideinitializer */ +#define SYS_VREFCTL_VREF_2_5V (0xBUL << SYS_VREFCTL_VREFCTL_Pos) /*!< Vref = 2.5V \hideinitializer */ +#define SYS_VREFCTL_VREF_3_0V (0xFUL << SYS_VREFCTL_VREFCTL_Pos) /*!< Vref = 3.0V \hideinitializer */ +#define SYS_VREFCTL_VREF_AVDD (0x10UL << SYS_VREFCTL_VREFCTL_Pos) /*!< Vref = AVDD \hideinitializer */ + + +/*---------------------------------------------------------------------------------------------------------*/ +/* USBPHY constant definitions. (Write-Protection Register) */ +/*---------------------------------------------------------------------------------------------------------*/ +#define SYS_USBPHY_USBROLE_STD_USBD (0x0UL << SYS_USBPHY_USBROLE_Pos) /*!< Standard USB device \hideinitializer */ +#define SYS_USBPHY_USBROLE_STD_USBH (0x1UL << SYS_USBPHY_USBROLE_Pos) /*!< Standard USB host \hideinitializer */ +#define SYS_USBPHY_USBROLE_ID_DEPH (0x2UL << SYS_USBPHY_USBROLE_Pos) /*!< ID dependent device \hideinitializer */ +#define SYS_USBPHY_USBROLE_ON_THE_GO (0x3UL << SYS_USBPHY_USBROLE_Pos) /*!< On-The-Go device \hideinitializer */ +#define SYS_USBPHY_HSUSBROLE_STD_USBD (0x0UL << SYS_USBPHY_HSUSBROLE_Pos) /*!< Standard HSUSB device \hideinitializer */ +#define SYS_USBPHY_HSUSBROLE_STD_USBH (0x1UL << SYS_USBPHY_HSUSBROLE_Pos) /*!< Standard HSUSB host \hideinitializer */ +#define SYS_USBPHY_HSUSBROLE_ID_DEPH (0x2UL << SYS_USBPHY_HSUSBROLE_Pos) /*!< ID dependent device \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* PLCTL constant definitions. (Write-Protection Register) */ +/*---------------------------------------------------------------------------------------------------------*/ +#define SYS_PLCTL_PLSEL_PL0 (0x0UL<GPA_MFPL = (SYS->GPA_MFPL & (~SYS_GPA_MFPL_PA0MFP_Msk) ) | SYS_GPA_MFPL_PA0_MFP_SC0_CLK ; + +*/ +/********************* Bit definition of GPA_MFPL register **********************/ +#define SYS_GPA_MFPL_PA0MFP_GPIO (0x00UL<BODCTL |= SYS_BODCTL_BODIF_Msk) + +/** + * @brief Set Brown-out detector function to normal mode + * @param None + * @return None + * @details This macro set Brown-out detector to normal mode. + * The register write-protection function should be disabled before using this macro. + * \hideinitializer + */ +#define SYS_CLEAR_BOD_LPM() (SYS->BODCTL &= ~SYS_BODCTL_BODLPM_Msk) + +/** + * @brief Disable Brown-out detector function + * @param None + * @return None + * @details This macro disable Brown-out detector function. + * The register write-protection function should be disabled before using this macro. + * \hideinitializer + */ +#define SYS_DISABLE_BOD() (SYS->BODCTL &= ~SYS_BODCTL_BODEN_Msk) + +/** + * @brief Enable Brown-out detector function + * @param None + * @return None + * @details This macro enable Brown-out detector function. + * The register write-protection function should be disabled before using this macro. + * \hideinitializer + */ +#define SYS_ENABLE_BOD() (SYS->BODCTL |= SYS_BODCTL_BODEN_Msk) + +/** + * @brief Get Brown-out detector interrupt flag + * @param None + * @retval 0 Brown-out detect interrupt flag is not set. + * @retval >=1 Brown-out detect interrupt flag is set. + * @details This macro get Brown-out detector interrupt flag. + * \hideinitializer + */ +#define SYS_GET_BOD_INT_FLAG() (SYS->BODCTL & SYS_BODCTL_BODIF_Msk) + +/** + * @brief Get Brown-out detector status + * @param None + * @retval 0 System voltage is higher than BOD threshold voltage setting or BOD function is disabled. + * @retval >=1 System voltage is lower than BOD threshold voltage setting. + * @details This macro get Brown-out detector output status. + * If the BOD function is disabled, this function always return 0. + * \hideinitializer + */ +#define SYS_GET_BOD_OUTPUT() (SYS->BODCTL & SYS_BODCTL_BODOUT_Msk) + +/** + * @brief Enable Brown-out detector interrupt function + * @param None + * @return None + * @details This macro enable Brown-out detector interrupt function. + * The register write-protection function should be disabled before using this macro. + * \hideinitializer + */ +#define SYS_DISABLE_BOD_RST() (SYS->BODCTL &= ~SYS_BODCTL_BODRSTEN_Msk) + +/** + * @brief Enable Brown-out detector reset function + * @param None + * @return None + * @details This macro enable Brown-out detect reset function. + * The register write-protection function should be disabled before using this macro. + * \hideinitializer + */ +#define SYS_ENABLE_BOD_RST() (SYS->BODCTL |= SYS_BODCTL_BODRSTEN_Msk) + +/** + * @brief Set Brown-out detector function low power mode + * @param None + * @return None + * @details This macro set Brown-out detector to low power mode. + * The register write-protection function should be disabled before using this macro. + * \hideinitializer + */ +#define SYS_SET_BOD_LPM() (SYS->BODCTL |= SYS_BODCTL_BODLPM_Msk) + +/** + * @brief Set Brown-out detector voltage level + * @param[in] u32Level is Brown-out voltage level. Including : + * - \ref SYS_BODCTL_BODVL_3_0V + * - \ref SYS_BODCTL_BODVL_2_8V + * - \ref SYS_BODCTL_BODVL_2_6V + * - \ref SYS_BODCTL_BODVL_2_4V + * - \ref SYS_BODCTL_BODVL_2_2V + * - \ref SYS_BODCTL_BODVL_2_0V + * - \ref SYS_BODCTL_BODVL_1_8V + * - \ref SYS_BODCTL_BODVL_1_6V + * @return None + * @details This macro set Brown-out detector voltage level. + * The write-protection function should be disabled before using this macro. + * \hideinitializer + */ +#define SYS_SET_BOD_LEVEL(u32Level) (SYS->BODCTL = (SYS->BODCTL & ~SYS_BODCTL_BODVL_Msk) | (u32Level)) + +/** + * @brief Get reset source is from Brown-out detector reset + * @param None + * @retval 0 Previous reset source is not from Brown-out detector reset + * @retval >=1 Previous reset source is from Brown-out detector reset + * @details This macro get previous reset source is from Brown-out detect reset or not. + * \hideinitializer + */ +#define SYS_IS_BOD_RST() (SYS->RSTSTS & SYS_RSTSTS_BODRF_Msk) + +/** + * @brief Get reset source is from CPU reset + * @param None + * @retval 0 Previous reset source is not from CPU reset + * @retval >=1 Previous reset source is from CPU reset + * @details This macro get previous reset source is from CPU reset. + * \hideinitializer + */ +#define SYS_IS_CPU_RST() (SYS->RSTSTS & SYS_RSTSTS_CPURF_Msk) + +/** + * @brief Get reset source is from LVR Reset + * @param None + * @retval 0 Previous reset source is not from Low-Voltage-Reset + * @retval >=1 Previous reset source is from Low-Voltage-Reset + * @details This macro get previous reset source is from Low-Voltage-Reset. + * \hideinitializer + */ +#define SYS_IS_LVR_RST() (SYS->RSTSTS & SYS_RSTSTS_LVRF_Msk) + +/** + * @brief Get reset source is from Power-on Reset + * @param None + * @retval 0 Previous reset source is not from Power-on Reset + * @retval >=1 Previous reset source is from Power-on Reset + * @details This macro get previous reset source is from Power-on Reset. + * \hideinitializer + */ +#define SYS_IS_POR_RST() (SYS->RSTSTS & SYS_RSTSTS_PORF_Msk) + +/** + * @brief Get reset source is from reset pin reset + * @param None + * @retval 0 Previous reset source is not from reset pin reset + * @retval >=1 Previous reset source is from reset pin reset + * @details This macro get previous reset source is from reset pin reset. + * \hideinitializer + */ +#define SYS_IS_RSTPIN_RST() (SYS->RSTSTS & SYS_RSTSTS_PINRF_Msk) + +/** + * @brief Get reset source is from system reset + * @param None + * @retval 0 Previous reset source is not from system reset + * @retval >=1 Previous reset source is from system reset + * @details This macro get previous reset source is from system reset. + * \hideinitializer + */ +#define SYS_IS_SYSTEM_RST() (SYS->RSTSTS & SYS_RSTSTS_SYSRF_Msk) + +/** + * @brief Get reset source is from window watch dog reset + * @param None + * @retval 0 Previous reset source is not from window watch dog reset + * @retval >=1 Previous reset source is from window watch dog reset + * @details This macro get previous reset source is from window watch dog reset. + * \hideinitializer + */ +#define SYS_IS_WDT_RST() (SYS->RSTSTS & SYS_RSTSTS_WDTRF_Msk) + +/** + * @brief Disable Low-Voltage-Reset function + * @param None + * @return None + * @details This macro disable Low-Voltage-Reset function. + * The register write-protection function should be disabled before using this macro. + * \hideinitializer + */ +#define SYS_DISABLE_LVR() (SYS->BODCTL &= ~SYS_BODCTL_LVREN_Msk) + +/** + * @brief Enable Low-Voltage-Reset function + * @param None + * @return None + * @details This macro enable Low-Voltage-Reset function. + * The register write-protection function should be disabled before using this macro. + * \hideinitializer + */ +#define SYS_ENABLE_LVR() (SYS->BODCTL |= SYS_BODCTL_LVREN_Msk) + +/** + * @brief Disable Power-on Reset function + * @param None + * @return None + * @details This macro disable Power-on Reset function. + * The register write-protection function should be disabled before using this macro. + * \hideinitializer + */ +#define SYS_DISABLE_POR() (((SYS->CSERVER & SYS_CSERVER_VERSION_Msk) == 0) ? (SYS->PORCTL = 0x5AA5):(SYS->PORDISAN = 0x5AA5)) + +/** + * @brief Enable Power-on Reset function + * @param None + * @return None + * @details This macro enable Power-on Reset function. + * The register write-protection function should be disabled before using this macro. + * \hideinitializer + */ +#define SYS_ENABLE_POR() (((SYS->CSERVER & SYS_CSERVER_VERSION_Msk) == 0) ? (SYS->PORCTL = 0):(SYS->PORDISAN = 0)) + +/** + * @brief Clear reset source flag + * @param[in] u32RstSrc is reset source. Including : + * - \ref SYS_RSTSTS_PORF_Msk + * - \ref SYS_RSTSTS_PINRF_Msk + * - \ref SYS_RSTSTS_WDTRF_Msk + * - \ref SYS_RSTSTS_LVRF_Msk + * - \ref SYS_RSTSTS_BODRF_Msk + * - \ref SYS_RSTSTS_SYSRF_Msk + * - \ref SYS_RSTSTS_CPURF_Msk + * - \ref SYS_RSTSTS_CPULKRF_Msk + * @return None + * @details This macro clear reset source flag. + * \hideinitializer + */ +#define SYS_CLEAR_RST_SOURCE(u32RstSrc) ((SYS->RSTSTS) = (u32RstSrc) ) + + +/*---------------------------------------------------------------------------------------------------------*/ +/* static inline functions */ +/*---------------------------------------------------------------------------------------------------------*/ +/* Declare these inline functions here to avoid MISRA C 2004 rule 8.1 error */ +__STATIC_INLINE void SYS_UnlockReg(void); +__STATIC_INLINE void SYS_LockReg(void); + +/** + * @brief Disable register write-protection function + * @param None + * @return None + * @details This function disable register write-protection function. + * To unlock the protected register to allow write access. + */ +__STATIC_INLINE void SYS_UnlockReg(void) +{ + do + { + SYS->REGLCTL = 0x59UL; + SYS->REGLCTL = 0x16UL; + SYS->REGLCTL = 0x88UL; + } + while(SYS->REGLCTL == 0UL); +} + +/** + * @brief Enable register write-protection function + * @param None + * @return None + * @details This function is used to enable register write-protection function. + * To lock the protected register to forbid write access. + */ +__STATIC_INLINE void SYS_LockReg(void) +{ + SYS->REGLCTL = 0UL; +} + + +void SYS_ClearResetSrc(uint32_t u32Src); +uint32_t SYS_GetBODStatus(void); +uint32_t SYS_GetResetSrc(void); +uint32_t SYS_IsRegLocked(void); +uint32_t SYS_ReadPDID(void); +void SYS_ResetChip(void); +void SYS_ResetCPU(void); +void SYS_ResetModule(uint32_t u32ModuleIndex); +void SYS_EnableBOD(int32_t i32Mode, uint32_t u32BODLevel); +void SYS_DisableBOD(void); +void SYS_SetPowerLevel(uint32_t u32PowerLevel); +void SYS_SetVRef(uint32_t u32VRefCTL); + +/*@}*/ /* end of group SYS_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group SYS_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_SYS_H__ */ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_timer.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_timer.h new file mode 100644 index 00000000000..f889abf09f0 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_timer.h @@ -0,0 +1,523 @@ +/**************************************************************************//** + * @file nu_timer.h + * @version V1.00 + * @brief M480 series Timer Controller(Timer) driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __NU_TIMER_H__ +#define __NU_TIMER_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup TIMER_Driver TIMER Driver + @{ +*/ + +/** @addtogroup TIMER_EXPORTED_CONSTANTS TIMER Exported Constants + @{ +*/ +/*---------------------------------------------------------------------------------------------------------*/ +/* TIMER Operation Mode, External Counter and Capture Mode Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define TIMER_ONESHOT_MODE (0UL << TIMER_CTL_OPMODE_Pos) /*!< Timer working in one-shot mode \hideinitializer */ +#define TIMER_PERIODIC_MODE (1UL << TIMER_CTL_OPMODE_Pos) /*!< Timer working in periodic mode \hideinitializer */ +#define TIMER_TOGGLE_MODE (2UL << TIMER_CTL_OPMODE_Pos) /*!< Timer working in toggle-output mode \hideinitializer */ +#define TIMER_CONTINUOUS_MODE (3UL << TIMER_CTL_OPMODE_Pos) /*!< Timer working in continuous counting mode \hideinitializer */ +#define TIMER_TOUT_PIN_FROM_TMX (0UL << TIMER_CTL_TGLPINSEL_Pos) /*!< Timer toggle-output pin is from TMx pin \hideinitializer */ +#define TIMER_TOUT_PIN_FROM_TMX_EXT (1UL << TIMER_CTL_TGLPINSEL_Pos) /*!< Timer toggle-output pin is from TMx_EXT pin \hideinitializer */ + +#define TIMER_COUNTER_EVENT_FALLING (0UL << TIMER_EXTCTL_CNTPHASE_Pos) /*!< Counter increase on falling edge detection \hideinitializer */ +#define TIMER_COUNTER_EVENT_RISING (1UL << TIMER_EXTCTL_CNTPHASE_Pos) /*!< Counter increase on rising edge detection \hideinitializer */ +#define TIMER_CAPTURE_FREE_COUNTING_MODE (0UL << TIMER_EXTCTL_CAPFUNCS_Pos) /*!< Timer capture event to get timer counter value \hideinitializer */ +#define TIMER_CAPTURE_COUNTER_RESET_MODE (1UL << TIMER_EXTCTL_CAPFUNCS_Pos) /*!< Timer capture event to reset timer counter \hideinitializer */ + +#define TIMER_CAPTURE_EVENT_FALLING (0UL << TIMER_EXTCTL_CAPEDGE_Pos) /*!< Falling edge detection to trigger capture event \hideinitializer */ +#define TIMER_CAPTURE_EVENT_RISING (1UL << TIMER_EXTCTL_CAPEDGE_Pos) /*!< Rising edge detection to trigger capture event \hideinitializer */ +#define TIMER_CAPTURE_EVENT_FALLING_RISING (2UL << TIMER_EXTCTL_CAPEDGE_Pos) /*!< Both falling and rising edge detection to trigger capture event, and first event at falling edge \hideinitializer */ +#define TIMER_CAPTURE_EVENT_RISING_FALLING (3UL << TIMER_EXTCTL_CAPEDGE_Pos) /*!< Both rising and falling edge detection to trigger capture event, and first event at rising edge \hideinitializer */ +#define TIMER_CAPTURE_EVENT_GET_LOW_PERIOD (6UL << TIMER_EXTCTL_CAPEDGE_Pos) /*!< First capture event is at falling edge, follows are at at rising edge \hideinitializer */ +#define TIMER_CAPTURE_EVENT_GET_HIGH_PERIOD (7UL << TIMER_EXTCTL_CAPEDGE_Pos) /*!< First capture event is at rising edge, follows are at at falling edge \hideinitializer */ + +#define TIMER_TRGSRC_TIMEOUT_EVENT (0UL << TIMER_TRGCTL_TRGSSEL_Pos) /*!< Select internal trigger source from timer time-out event \hideinitializer */ +#define TIMER_TRGSRC_CAPTURE_EVENT (1UL << TIMER_TRGCTL_TRGSSEL_Pos) /*!< Select internal trigger source from timer capture event \hideinitializer */ +#define TIMER_TRG_TO_EPWM (TIMER_TRGCTL_TRGEPWM_Msk) /*!< Each timer event as EPWM counter clock source \hideinitializer */ +#define TIMER_TRG_TO_EADC (TIMER_TRGCTL_TRGEADC_Msk) /*!< Each timer event to start ADC conversion \hideinitializer */ +#define TIMER_TRG_TO_DAC (TIMER_TRGCTL_TRGDAC_Msk) /*!< Each timer event to start DAC conversion \hideinitializer */ +#define TIMER_TRG_TO_PDMA (TIMER_TRGCTL_TRGPDMA_Msk) /*!< Each timer event to trigger PDMA transfer \hideinitializer */ + +/*@}*/ /* end of group TIMER_EXPORTED_CONSTANTS */ + + +/** @addtogroup TIMER_EXPORTED_FUNCTIONS TIMER Exported Functions + @{ +*/ + +/** + * @brief Set Timer Compared Value + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * @param[in] u32Value Timer compare value. Valid values are between 2 to 0xFFFFFF. + * + * @return None + * + * @details This macro is used to set timer compared value to adjust timer time-out interval. + * @note 1. Never write 0x0 or 0x1 in this field, or the core will run into unknown state. \n + * 2. If update timer compared value in continuous counting mode, timer counter value will keep counting continuously. \n + * But if timer is operating at other modes, the timer up counter will restart counting and start from 0. + * \hideinitializer + */ +#define TIMER_SET_CMP_VALUE(timer, u32Value) ((timer)->CMP = (u32Value)) + +/** + * @brief Set Timer Prescale Value + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * @param[in] u32Value Timer prescale value. Valid values are between 0 to 0xFF. + * + * @return None + * + * @details This macro is used to set timer prescale value and timer source clock will be divided by (prescale + 1) \n + * before it is fed into timer. + * \hideinitializer + */ +#define TIMER_SET_PRESCALE_VALUE(timer, u32Value) ((timer)->CTL = ((timer)->CTL & ~TIMER_CTL_PSC_Msk) | (u32Value)) + +/** + * @brief Check specify Timer Status + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @retval 0 Timer 24-bit up counter is inactive + * @retval 1 Timer 24-bit up counter is active + * + * @details This macro is used to check if specify Timer counter is inactive or active. + * \hideinitializer + */ +#define TIMER_IS_ACTIVE(timer) (((timer)->CTL & TIMER_CTL_ACTSTS_Msk)? 1 : 0) + +/** + * @brief Select Toggle-output Pin + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * @param[in] u32ToutSel Toggle-output pin selection, valid values are: + * - \ref TIMER_TOUT_PIN_FROM_TMX + * - \ref TIMER_TOUT_PIN_FROM_TMX_EXT + * + * @return None + * + * @details This macro is used to select timer toggle-output pin is output on TMx or TMx_EXT pin. + * \hideinitializer + */ +#define TIMER_SELECT_TOUT_PIN(timer, u32ToutSel) ((timer)->CTL = ((timer)->CTL & ~TIMER_CTL_TGLPINSEL_Msk) | (u32ToutSel)) + +/** + * @brief Select Timer operating mode + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * @param[in] u32OpMode Operation mode. Possible options are + * - \ref TIMER_ONESHOT_MODE + * - \ref TIMER_PERIODIC_MODE + * - \ref TIMER_TOGGLE_MODE + * - \ref TIMER_CONTINUOUS_MODE + * + * @return None + * \hideinitializer + */ +#define TIMER_SET_OPMODE(timer, u32OpMode) ((timer)->CTL = ((timer)->CTL & ~TIMER_CTL_OPMODE_Msk) | (u32OpMode)) + +/* Declare these inline functions here to avoid MISRA C 2004 rule 8.1 error */ +__STATIC_INLINE void TIMER_Start(TIMER_T *timer); +__STATIC_INLINE void TIMER_Stop(TIMER_T *timer); +__STATIC_INLINE void TIMER_EnableWakeup(TIMER_T *timer); +__STATIC_INLINE void TIMER_DisableWakeup(TIMER_T *timer); +__STATIC_INLINE void TIMER_StartCapture(TIMER_T *timer); +__STATIC_INLINE void TIMER_StopCapture(TIMER_T *timer); +__STATIC_INLINE void TIMER_EnableCaptureDebounce(TIMER_T *timer); +__STATIC_INLINE void TIMER_DisableCaptureDebounce(TIMER_T *timer); +__STATIC_INLINE void TIMER_EnableEventCounterDebounce(TIMER_T *timer); +__STATIC_INLINE void TIMER_DisableEventCounterDebounce(TIMER_T *timer); +__STATIC_INLINE void TIMER_EnableInt(TIMER_T *timer); +__STATIC_INLINE void TIMER_DisableInt(TIMER_T *timer); +__STATIC_INLINE void TIMER_EnableCaptureInt(TIMER_T *timer); +__STATIC_INLINE void TIMER_DisableCaptureInt(TIMER_T *timer); +__STATIC_INLINE uint32_t TIMER_GetIntFlag(TIMER_T *timer); +__STATIC_INLINE void TIMER_ClearIntFlag(TIMER_T *timer); +__STATIC_INLINE uint32_t TIMER_GetCaptureIntFlag(TIMER_T *timer); +__STATIC_INLINE void TIMER_ClearCaptureIntFlag(TIMER_T *timer); +__STATIC_INLINE uint32_t TIMER_GetWakeupFlag(TIMER_T *timer); +__STATIC_INLINE void TIMER_ClearWakeupFlag(TIMER_T *timer); +__STATIC_INLINE uint32_t TIMER_GetCaptureData(TIMER_T *timer); +__STATIC_INLINE uint32_t TIMER_GetCounter(TIMER_T *timer); +__STATIC_INLINE void TIMER_ResetCounter(TIMER_T *timer); + +/** + * @brief Start Timer Counting + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This function is used to start Timer counting. + */ +__STATIC_INLINE void TIMER_Start(TIMER_T *timer) +{ + timer->CTL |= TIMER_CTL_CNTEN_Msk; +} + +/** + * @brief Stop Timer Counting + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This function is used to stop/suspend Timer counting. + */ +__STATIC_INLINE void TIMER_Stop(TIMER_T *timer) +{ + timer->CTL &= ~TIMER_CTL_CNTEN_Msk; +} + +/** + * @brief Enable Timer Interrupt Wake-up Function + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This function is used to enable the timer interrupt wake-up function and interrupt source could be time-out interrupt, \n + * counter event interrupt or capture trigger interrupt. + * @note To wake the system from Power-down mode, timer clock source must be ether LXT or LIRC. + */ +__STATIC_INLINE void TIMER_EnableWakeup(TIMER_T *timer) +{ + timer->CTL |= TIMER_CTL_WKEN_Msk; +} + +/** + * @brief Disable Timer Wake-up Function + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This function is used to disable the timer interrupt wake-up function. + */ +__STATIC_INLINE void TIMER_DisableWakeup(TIMER_T *timer) +{ + timer->CTL &= ~TIMER_CTL_WKEN_Msk; +} + +/** + * @brief Start Timer Capture Function + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This function is used to start Timer capture function. + */ +__STATIC_INLINE void TIMER_StartCapture(TIMER_T *timer) +{ + timer->EXTCTL |= TIMER_EXTCTL_CAPEN_Msk; +} + +/** + * @brief Stop Timer Capture Function + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This function is used to stop Timer capture function. + */ +__STATIC_INLINE void TIMER_StopCapture(TIMER_T *timer) +{ + timer->EXTCTL &= ~TIMER_EXTCTL_CAPEN_Msk; +} + +/** + * @brief Enable Capture Pin De-bounce + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This function is used to enable the detect de-bounce function of capture pin. + */ +__STATIC_INLINE void TIMER_EnableCaptureDebounce(TIMER_T *timer) +{ + timer->EXTCTL |= TIMER_EXTCTL_CAPDBEN_Msk; +} + +/** + * @brief Disable Capture Pin De-bounce + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This function is used to disable the detect de-bounce function of capture pin. + */ +__STATIC_INLINE void TIMER_DisableCaptureDebounce(TIMER_T *timer) +{ + timer->EXTCTL &= ~TIMER_EXTCTL_CAPDBEN_Msk; +} + +/** + * @brief Enable Counter Pin De-bounce + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This function is used to enable the detect de-bounce function of counter pin. + */ +__STATIC_INLINE void TIMER_EnableEventCounterDebounce(TIMER_T *timer) +{ + timer->EXTCTL |= TIMER_EXTCTL_CNTDBEN_Msk; +} + +/** + * @brief Disable Counter Pin De-bounce + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This function is used to disable the detect de-bounce function of counter pin. + */ +__STATIC_INLINE void TIMER_DisableEventCounterDebounce(TIMER_T *timer) +{ + timer->EXTCTL &= ~TIMER_EXTCTL_CNTDBEN_Msk; +} + +/** + * @brief Enable Timer Time-out Interrupt + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This function is used to enable the timer time-out interrupt function. + */ +__STATIC_INLINE void TIMER_EnableInt(TIMER_T *timer) +{ + timer->CTL |= TIMER_CTL_INTEN_Msk; +} + +/** + * @brief Disable Timer Time-out Interrupt + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This function is used to disable the timer time-out interrupt function. + */ +__STATIC_INLINE void TIMER_DisableInt(TIMER_T *timer) +{ + timer->CTL &= ~TIMER_CTL_INTEN_Msk; +} + +/** + * @brief Enable Capture Trigger Interrupt + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This function is used to enable the timer capture trigger interrupt function. + */ +__STATIC_INLINE void TIMER_EnableCaptureInt(TIMER_T *timer) +{ + timer->EXTCTL |= TIMER_EXTCTL_CAPIEN_Msk; +} + +/** + * @brief Disable Capture Trigger Interrupt + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This function is used to disable the timer capture trigger interrupt function. + */ +__STATIC_INLINE void TIMER_DisableCaptureInt(TIMER_T *timer) +{ + timer->EXTCTL &= ~TIMER_EXTCTL_CAPIEN_Msk; +} + +/** + * @brief Get Timer Time-out Interrupt Flag + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @retval 0 Timer time-out interrupt did not occur + * @retval 1 Timer time-out interrupt occurred + * + * @details This function indicates timer time-out interrupt occurred or not. + */ +__STATIC_INLINE uint32_t TIMER_GetIntFlag(TIMER_T *timer) +{ + return ((timer->INTSTS & TIMER_INTSTS_TIF_Msk) ? 1UL : 0UL); +} + +/** + * @brief Clear Timer Time-out Interrupt Flag + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This function clears timer time-out interrupt flag to 0. + */ +__STATIC_INLINE void TIMER_ClearIntFlag(TIMER_T *timer) +{ + timer->INTSTS = TIMER_INTSTS_TIF_Msk; +} + +/** + * @brief Get Timer Capture Interrupt Flag + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @retval 0 Timer capture interrupt did not occur + * @retval 1 Timer capture interrupt occurred + * + * @details This function indicates timer capture trigger interrupt occurred or not. + */ +__STATIC_INLINE uint32_t TIMER_GetCaptureIntFlag(TIMER_T *timer) +{ + return timer->EINTSTS; +} + +/** + * @brief Clear Timer Capture Interrupt Flag + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This function clears timer capture trigger interrupt flag to 0. + */ +__STATIC_INLINE void TIMER_ClearCaptureIntFlag(TIMER_T *timer) +{ + timer->EINTSTS = TIMER_EINTSTS_CAPIF_Msk; +} + +/** + * @brief Get Timer Wake-up Flag + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @retval 0 Timer does not cause CPU wake-up + * @retval 1 Timer interrupt event cause CPU wake-up + * + * @details This function indicates timer interrupt event has waked up system or not. + */ +__STATIC_INLINE uint32_t TIMER_GetWakeupFlag(TIMER_T *timer) +{ + return (timer->INTSTS & TIMER_INTSTS_TWKF_Msk ? 1UL : 0UL); +} + +/** + * @brief Clear Timer Wake-up Flag + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This function clears the timer wake-up system flag to 0. + */ +__STATIC_INLINE void TIMER_ClearWakeupFlag(TIMER_T *timer) +{ + timer->INTSTS = TIMER_INTSTS_TWKF_Msk; +} + +/** + * @brief Get Capture value + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return 24-bit Capture Value + * + * @details This function reports the current 24-bit timer capture value. + */ +__STATIC_INLINE uint32_t TIMER_GetCaptureData(TIMER_T *timer) +{ + return timer->CAP; +} + +/** + * @brief Get Counter value + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return 24-bit Counter Value + * + * @details This function reports the current 24-bit timer counter value. + */ +__STATIC_INLINE uint32_t TIMER_GetCounter(TIMER_T *timer) +{ + return timer->CNT; +} + +/** + * @brief Reset Counter + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This function is used to reset current counter value and internal prescale counter value. + */ +__STATIC_INLINE void TIMER_ResetCounter(TIMER_T *timer) +{ + timer->CNT = 0UL; + while((timer->CNT&TIMER_CNT_RSTACT_Msk) == TIMER_CNT_RSTACT_Msk) + { + ; + } +} + + +uint32_t TIMER_Open(TIMER_T *timer, uint32_t u32Mode, uint32_t u32Freq); +void TIMER_Close(TIMER_T *timer); +void TIMER_Delay(TIMER_T *timer, uint32_t u32Usec); +void TIMER_EnableCapture(TIMER_T *timer, uint32_t u32CapMode, uint32_t u32Edge); +void TIMER_DisableCapture(TIMER_T *timer); +void TIMER_EnableEventCounter(TIMER_T *timer, uint32_t u32Edge); +void TIMER_DisableEventCounter(TIMER_T *timer); +uint32_t TIMER_GetModuleClock(TIMER_T *timer); +void TIMER_EnableFreqCounter(TIMER_T *timer, + uint32_t u32DropCount, + uint32_t u32Timeout, + uint32_t u32EnableInt); +void TIMER_DisableFreqCounter(TIMER_T *timer); +void TIMER_SetTriggerSource(TIMER_T *timer, uint32_t u32Src); +void TIMER_SetTriggerTarget(TIMER_T *timer, uint32_t u32Mask); + +/*@}*/ /* end of group TIMER_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group TIMER_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_TIMER_H__ */ + + diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_timer_pwm.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_timer_pwm.h new file mode 100644 index 00000000000..c7b122ff911 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_timer_pwm.h @@ -0,0 +1,746 @@ +/**************************************************************************//** + * @file nu_timer_pwm.h + * @version V1.00 + * @brief M480 series Timer PWM Controller(Timer PWM) driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __NU_TIMER_PWM_H__ +#define __NU_TIMER_PWM_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ +/** @addtogroup TIMER_PWM_Driver TIMER PWM Driver + @{ +*/ + +/** @addtogroup TIMER_PWM_EXPORTED_CONSTANTS TIMER PWM Exported Constants + @{ +*/ +/*---------------------------------------------------------------------------------------------------------*/ +/* Output Channel Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define TPWM_CH0 (BIT0) /*!< Indicate PWMx_CH0 \hideinitializer */ +#define TPWM_CH1 (BIT1) /*!< Indicate PWMx_CH1 \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Counter Type Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define TPWM_UP_COUNT (0UL << TIMER_PWMCTL_CNTTYPE_Pos) /*!< Up count type \hideinitializer */ +#define TPWM_DOWN_COUNT (1UL << TIMER_PWMCTL_CNTTYPE_Pos) /*!< Down count type \hideinitializer */ +#define TPWM_UP_DOWN_COUNT (2UL << TIMER_PWMCTL_CNTTYPE_Pos) /*!< Up-Down count type \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Counter Mode Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define TPWM_AUTO_RELOAD_MODE (0UL) /*!< Auto-reload mode \hideinitializer */ +#define TPWM_ONE_SHOT_MODE (TIMER_PWMCTL_CNTMODE_Msk) /*!< One-shot mode \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Output Level Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define TPWM_OUTPUT_TOGGLE (0UL) /*!< Timer PWM output toggle \hideinitializer */ +#define TPWM_OUTPUT_NOTHING (1UL) /*!< Timer PWM output nothing \hideinitializer */ +#define TPWM_OUTPUT_LOW (2UL) /*!< Timer PWM output low \hideinitializer */ +#define TPWM_OUTPUT_HIGH (3UL) /*!< Timer PWM output high \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Trigger ADC Source Select Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define TPWM_TRIGGER_ADC_AT_ZERO_POINT (0UL << TIMER_PWMEADCTS_TRGSEL_Pos) /*!< Timer PWM trigger ADC while counter zero point event occurred \hideinitializer */ +#define TPWM_TRIGGER_ADC_AT_PERIOD_POINT (1UL << TIMER_PWMEADCTS_TRGSEL_Pos) /*!< Timer PWM trigger ADC while counter period point event occurred \hideinitializer */ +#define TPWM_TRIGGER_ADC_AT_ZERO_OR_PERIOD_POINT (2UL << TIMER_PWMEADCTS_TRGSEL_Pos) /*!< Timer PWM trigger ADC while counter zero or period point event occurred \hideinitializer */ +#define TPWM_TRIGGER_ADC_AT_COMPARE_UP_COUNT_POINT (3UL << TIMER_PWMEADCTS_TRGSEL_Pos) /*!< Timer PWM trigger ADC while counter up count compare point event occurred \hideinitializer */ +#define TPWM_TRIGGER_ADC_AT_COMPARE_DOWN_COUNT_POINT (4UL << TIMER_PWMEADCTS_TRGSEL_Pos) /*!< Timer PWM trigger ADC while counter down count compare point event occurred \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Brake Control Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define TPWM_BRAKE_SOURCE_EDGE_ACMP0 (TIMER_PWMBRKCTL_CPO0EBEN_Msk) /*!< Comparator 0 as edge-detect fault brake source \hideinitializer */ +#define TPWM_BRAKE_SOURCE_EDGE_ACMP1 (TIMER_PWMBRKCTL_CPO1EBEN_Msk) /*!< Comparator 1 as edge-detect fault brake source \hideinitializer */ +#define TPWM_BRAKE_SOURCE_EDGE_BKPIN (TIMER_PWMBRKCTL_BRKPEEN_Msk) /*!< Brake pin as edge-detect fault brake source \hideinitializer */ +#define TPWM_BRAKE_SOURCE_EDGE_SYS_CSS (TIMER_PWMBRKCTL_SYSEBEN_Msk | (TIMER_PWMFAILBRK_CSSBRKEN_Msk << 16)) /*!< System fail condition: clock security system detection as edge-detect fault brake source \hideinitializer */ +#define TPWM_BRAKE_SOURCE_EDGE_SYS_BOD (TIMER_PWMBRKCTL_SYSEBEN_Msk | (TIMER_PWMFAILBRK_BODBRKEN_Msk << 16)) /*!< System fail condition: brown-out detection as edge-detect fault brake source \hideinitializer */ +#define TPWM_BRAKE_SOURCE_EDGE_SYS_COR (TIMER_PWMBRKCTL_SYSEBEN_Msk | (TIMER_PWMFAILBRK_CORBRKEN_Msk << 16)) /*!< System fail condition: core lockup detection as edge-detect fault brake source \hideinitializer */ +#define TPWM_BRAKE_SOURCE_EDGE_SYS_RAM (TIMER_PWMBRKCTL_SYSEBEN_Msk | (TIMER_PWMFAILBRK_RAMBRKEN_Msk << 16)) /*!< System fail condition: SRAM parity error detection as edge-detect fault brake source \hideinitializer */ + + +#define TPWM_BRAKE_SOURCE_LEVEL_ACMP0 (TIMER_PWMBRKCTL_CPO0LBEN_Msk) /*!< Comparator 0 as level-detect fault brake source \hideinitializer */ +#define TPWM_BRAKE_SOURCE_LEVEL_ACMP1 (TIMER_PWMBRKCTL_CPO1LBEN_Msk) /*!< Comparator 1 as level-detect fault brake source \hideinitializer */ +#define TPWM_BRAKE_SOURCE_LEVEL_BKPIN (TIMER_PWMBRKCTL_BRKPLEN_Msk) /*!< Brake pin as level-detect fault brake source \hideinitializer */ +#define TPWM_BRAKE_SOURCE_LEVEL_SYS_CSS (TIMER_PWMBRKCTL_SYSLBEN_Msk | (TIMER_PWMFAILBRK_CSSBRKEN_Msk << 16)) /*!< System fail condition: clock security system detection as level-detect fault brake source \hideinitializer */ +#define TPWM_BRAKE_SOURCE_LEVEL_SYS_BOD (TIMER_PWMBRKCTL_SYSLBEN_Msk | (TIMER_PWMFAILBRK_BODBRKEN_Msk << 16)) /*!< System fail condition: brown-out detection as level-detect fault brake source \hideinitializer */ +#define TPWM_BRAKE_SOURCE_LEVEL_SYS_COR (TIMER_PWMBRKCTL_SYSLBEN_Msk | (TIMER_PWMFAILBRK_CORBRKEN_Msk << 16)) /*!< System fail condition: core lockup detection as level-detect fault brake source \hideinitializer */ +#define TPWM_BRAKE_SOURCE_LEVEL_SYS_RAM (TIMER_PWMBRKCTL_SYSLBEN_Msk | (TIMER_PWMFAILBRK_RAMBRKEN_Msk << 16)) /*!< System fail condition: SRAM parity error detection as level-detect fault brake source \hideinitializer */ + +#define TPWM_BRAKE_EDGE (TIMER_PWMSWBRK_BRKETRG_Msk) /*!< Edge-detect fault brake \hideinitializer */ +#define TPWM_BRAKE_LEVEL (TIMER_PWMSWBRK_BRKLTRG_Msk) /*!< Level-detect fault brake \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Load Mode Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define TPWM_LOAD_MODE_PERIOD (0UL) /*!< Timer PWM period load mode \hideinitializer */ +#define TPWM_LOAD_MODE_IMMEDIATE (TIMER_PWMCTL_IMMLDEN_Msk) /*!< Timer PWM immediately load mode \hideinitializer */ +#define TPWM_LOAD_MODE_CENTER (TIMER_PWMCTL_CTRLD_Msk) /*!< Timer PWM center load mode \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Brake Pin De-bounce Clock Source Select Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define TPWM_BKP_DBCLK_PCLK_DIV_1 (0UL) /*!< De-bounce clock is PCLK divide by 1 \hideinitializer */ +#define TPWM_BKP_DBCLK_PCLK_DIV_2 (1UL) /*!< De-bounce clock is PCLK divide by 2 \hideinitializer */ +#define TPWM_BKP_DBCLK_PCLK_DIV_4 (2UL) /*!< De-bounce clock is PCLK divide by 4 \hideinitializer */ +#define TPWM_BKP_DBCLK_PCLK_DIV_8 (3UL) /*!< De-bounce clock is PCLK divide by 8 \hideinitializer */ +#define TPWM_BKP_DBCLK_PCLK_DIV_16 (4UL) /*!< De-bounce clock is PCLK divide by 16 \hideinitializer */ +#define TPWM_BKP_DBCLK_PCLK_DIV_32 (5UL) /*!< De-bounce clock is PCLK divide by 32 \hideinitializer */ +#define TPWM_BKP_DBCLK_PCLK_DIV_64 (6UL) /*!< De-bounce clock is PCLK divide by 64 \hideinitializer */ +#define TPWM_BKP_DBCLK_PCLK_DIV_128 (7UL) /*!< De-bounce clock is PCLK divide by 128 \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Brake Pin Source Select Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define TPWM_TM_BRAKE0 (0UL) /*!< Brake pin source comes from TM_BRAKE0 \hideinitializer */ +#define TPWM_TM_BRAKE1 (1UL) /*!< Brake pin source comes from TM_BRAKE1 \hideinitializer */ +#define TPWM_TM_BRAKE2 (2UL) /*!< Brake pin source comes from TM_BRAKE2 \hideinitializer */ +#define TPWM_TM_BRAKE3 (3UL) /*!< Brake pin source comes from TM_BRAKE3 \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Counter Clock Source Select Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define TPWM_CNTR_CLKSRC_TMR_CLK (0UL) /*!< Timer PWM Clock source selects to TMR_CLK \hideinitializer */ +#define TPWM_CNTR_CLKSRC_TIMER0_INT (1UL) /*!< Timer PWM Clock source selects to TIMER0 interrupt event \hideinitializer */ +#define TPWM_CNTR_CLKSRC_TIMER1_INT (2UL) /*!< Timer PWM Clock source selects to TIMER1 interrupt event \hideinitializer */ +#define TPWM_CNTR_CLKSRC_TIMER2_INT (3UL) /*!< Timer PWM Clock source selects to TIMER2 interrupt event \hideinitializer */ +#define TPWM_CNTR_CLKSRC_TIMER3_INT (4UL) /*!< Timer PWM Clock source selects to TIMER3 interrupt event \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* Counter Synchronous Mode Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define TPWM_CNTR_SYNC_DISABLE (0UL) /*!< Disable TIMER PWM synchronous function \hideinitializer */ +#define TPWM_CNTR_SYNC_START_BY_TIMER0 ((0<ALTCTL = (1 << TIMER_ALTCTL_FUNCSEL_Pos)) + +/** + * @brief Disable PWM Counter Mode + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro is used to disable specified Timer channel as PWM counter mode, then timer counter mode is available. + * @note All registers about PWM counter function will be cleared to 0 after executing this macro. + * \hideinitializer + */ +#define TPWM_DISABLE_PWM_MODE(timer) ((timer)->ALTCTL = (0 << TIMER_ALTCTL_FUNCSEL_Pos)) + +/** + * @brief Enable Independent Mode + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro is used to enable independent mode of TIMER PWM module and complementary mode will be disabled. + * \hideinitializer + */ +#define TPWM_ENABLE_INDEPENDENT_MODE(timer) ((timer)->PWMCTL &= ~(1 << TIMER_PWMCTL_OUTMODE_Pos)) + +/** + * @brief Enable Complementary Mode + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro is used to enable complementary mode of Timer PWM module and independent mode will be disabled. + * \hideinitializer + */ +#define TPWM_ENABLE_COMPLEMENTARY_MODE(timer) ((timer)->PWMCTL |= (1 << TIMER_PWMCTL_OUTMODE_Pos)) + +/** + * @brief Set Counter Type + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * @param[in] type Timer PWM count type, could be one of the following type + * - \ref TPWM_UP_COUNT + * - \ref TPWM_DOWN_COUNT + * - \ref TPWM_UP_DOWN_COUNT + * + * @return None + * + * @details This macro is used to set Timer PWM counter type. + * \hideinitializer + */ +#define TPWM_SET_COUNTER_TYPE(timer, type) ((timer)->PWMCTL = ((timer)->PWMCTL & ~TIMER_PWMCTL_CNTTYPE_Msk) | (type)) + +/** + * @brief Start PWM Counter + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro is used to enable PWM generator and start counter counting. + * \hideinitializer + */ +#define TPWM_START_COUNTER(timer) ((timer)->PWMCTL |= TIMER_PWMCTL_CNTEN_Msk) + +/** + * @brief Stop PWM Counter + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro is used to stop PWM counter after current period is completed. + * \hideinitializer + */ +#define TPWM_STOP_COUNTER(timer) ((timer)->PWMPERIOD = 0x0) + +/** + * @brief Set Counter Clock Prescaler + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @param[in] prescaler Clock prescaler of specified channel. Valid values are between 0x0~0xFFF. + * + * @return None + * + * @details This macro is used to set the prescaler of specified TIMER PWM. + * @note If prescaler is 0, then there is no scaling in counter clock source. + * \hideinitializer + */ +#define TPWM_SET_PRESCALER(timer, prescaler) ((timer)->PWMCLKPSC = (prescaler)) + +/** + * @brief Get Counter Clock Prescaler + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return Target prescaler setting, CLKPSC (TIMERx_PWMCLKPSC[11:0]) + * + * @details Get the prescaler setting, the target counter clock divider is (CLKPSC + 1). + * \hideinitializer + */ +#define TPWM_GET_PRESCALER(timer) ((timer)->PWMCLKPSC) + +/** + * @brief Set Counter Period + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @param[in] period Period of specified channel. Valid values are between 0x0~0xFFFF. + * + * @return None + * + * @details This macro is used to set the period of specified TIMER PWM. + * \hideinitializer + */ +#define TPWM_SET_PERIOD(timer, period) ((timer)->PWMPERIOD = (period)) + +/** + * @brief Get Counter Period + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return Target period setting, PERIOD (TIMERx_PWMPERIOD[15:0]) + * + * @details This macro is used to get the period of specified TIMER PWM. + * \hideinitializer + */ +#define TPWM_GET_PERIOD(timer) ((timer)->PWMPERIOD) + +/** + * @brief Set Comparator Value + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @param[in] cmp Comparator of specified channel. Valid values are between 0x0~0xFFFF. + * + * @return None + * + * @details This macro is used to set the comparator value of specified TIMER PWM. + * \hideinitializer + */ +#define TPWM_SET_CMPDAT(timer, cmp) ((timer)->PWMCMPDAT = (cmp)) + +/** + * @brief Get Comparator Value + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return Target comparator setting, CMPDAT (TIMERx_PWMCMPDAT[15:0]) + * + * @details This macro is used to get the comparator value of specified TIMER PWM. + * \hideinitializer + */ +#define TPWM_GET_CMPDAT(timer) ((timer)->PWMCMPDAT) + +/** + * @brief Clear Counter + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro is used to clear counter of specified TIMER PWM. + * \hideinitializer + */ +#define TPWM_CLEAR_COUNTER(timer) ((timer)->PWMCNTCLR = TIMER_PWMCNTCLR_CNTCLR_Msk) + +/** + * @brief Software Trigger Brake Event + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @param[in] type Type of brake trigger. Valid values are: + * - \ref TPWM_BRAKE_EDGE + * - \ref TPWM_BRAKE_LEVEL + * + * @return None + * + * @details This macro is used to trigger brake event by writing PWMSWBRK register. + * \hideinitializer + */ +#define TPWM_SW_TRIGGER_BRAKE(timer, type) ((timer)->PWMSWBRK = (type)) + +/** + * @brief Enable Output Function + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @param[in] ch Enable specified channel output function. Valid values are the combination of: + * - \ref TPWM_CH0 + * - \ref TPWM_CH1 + * + * @return None + * + * @details This macro is used to enable output function of specified output pins. + * @note If the corresponding bit in ch parameter is 0, then output function will be disabled in this channel. + * \hideinitializer + */ +#define TPWM_ENABLE_OUTPUT(timer, ch) ((timer)->PWMPOEN = (ch)) + +/** + * @brief Set Output Inverse + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @param[in] ch Set specified channel output is inversed or not. Valid values are the combination of: + * - \ref TPWM_CH0 + * - \ref TPWM_CH1 + * + * @return None + * + * @details This macro is used to enable output inverse of specified output pins. + * @note If ch parameter is 0, then output inverse function will be disabled. + * \hideinitializer + */ +#define TPWM_SET_OUTPUT_INVERSE(timer, ch) ((timer)->PWMPOLCTL = (ch)) + +/** + * @brief Enable Output Function + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @param[in] ch Enable specified channel output mask function. Valid values are the combination of: + * - \ref TPWM_CH0 + * - \ref TPWM_CH1 + * + * @param[in] level Output to high or low on specified mask channel. + * + * @return None + * + * @details This macro is used to enable output function of specified output pins. + * @note If ch parameter is 0, then output mask function will be disabled. + * \hideinitializer + */ +#define TPWM_SET_MASK_OUTPUT(timer, ch, level) do {(timer)->PWMMSKEN = (ch); (timer)->PWMMSK = (level); }while(0) + +/** + * @brief Set Counter Synchronous Mode + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @param[in] mode Synchronous mode. Possible options are: + * - \ref TPWM_CNTR_SYNC_DISABLE + * - \ref TPWM_CNTR_SYNC_START_BY_TIMER0 + * - \ref TPWM_CNTR_SYNC_CLEAR_BY_TIMER0 + * - \ref TPWM_CNTR_SYNC_START_BY_TIMER2 + * - \ref TPWM_CNTR_SYNC_CLEAR_BY_TIMER2 + * + * @return None + * + * @details This macro is used to set counter synchronous mode of specified Timer PWM module. + * @note Only support all PWM counters are synchronous by TIMER0 PWM or TIMER0~1 PWM counter synchronous by TIMER0 PWM and + * TIMER2~3 PWM counter synchronous by TIMER2 PWM. + * \hideinitializer + */ +#define TPWM_SET_COUNTER_SYNC_MODE(timer, mode) ((timer)->PWMSCTL = (mode)) + +/** + * @brief Trigger Counter Synchronous + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro is used to trigger synchronous event by specified TIMER PWM. + * @note 1. This macro is only available for TIMER0 PWM and TIMER2 PWM. \n + * 2. STRGEN (PWMSTRG[0]) is write only and always read as 0. + * \hideinitializer + */ +#define TPWM_TRIGGER_COUNTER_SYNC(timer) ((timer)->PWMSTRG = TIMER_PWMSTRG_STRGEN_Msk) + +/** + * @brief Enable Zero Event Interrupt + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro is used to enable the zero event interrupt function. + * \hideinitializer + */ +#define TPWM_ENABLE_ZERO_INT(timer) ((timer)->PWMINTEN0 |= TIMER_PWMINTEN0_ZIEN_Msk) + +/** + * @brief Disable Zero Event Interrupt + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro is used to disable the zero event interrupt function. + * \hideinitializer + */ +#define TPWM_DISABLE_ZERO_INT(timer) ((timer)->PWMINTEN0 &= ~TIMER_PWMINTEN0_ZIEN_Msk) + +/** + * @brief Get Zero Event Interrupt Flag + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @retval 0 Zero event interrupt did not occur + * @retval 1 Zero event interrupt occurred + * + * @details This macro indicates zero event occurred or not. + * \hideinitializer + */ +#define TPWM_GET_ZERO_INT_FLAG(timer) (((timer)->PWMINTSTS0 & TIMER_PWMINTSTS0_ZIF_Msk)? 1 : 0) + +/** + * @brief Clear Zero Event Interrupt Flag + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro clears zero event interrupt flag. + * \hideinitializer + */ +#define TPWM_CLEAR_ZERO_INT_FLAG(timer) ((timer)->PWMINTSTS0 = TIMER_PWMINTSTS0_ZIF_Msk) + +/** + * @brief Enable Period Event Interrupt + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro is used to enable the period event interrupt function. + * \hideinitializer + */ +#define TPWM_ENABLE_PERIOD_INT(timer) ((timer)->PWMINTEN0 |= TIMER_PWMINTEN0_PIEN_Msk) + +/** + * @brief Disable Period Event Interrupt + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro is used to disable the period event interrupt function. + * \hideinitializer + */ +#define TPWM_DISABLE_PERIOD_INT(timer) ((timer)->PWMINTEN0 &= ~TIMER_PWMINTEN0_PIEN_Msk) + +/** + * @brief Get Period Event Interrupt Flag + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @retval 0 Period event interrupt did not occur + * @retval 1 Period event interrupt occurred + * + * @details This macro indicates period event occurred or not. + * \hideinitializer + */ +#define TPWM_GET_PERIOD_INT_FLAG(timer) (((timer)->PWMINTSTS0 & TIMER_PWMINTSTS0_PIF_Msk)? 1 : 0) + +/** + * @brief Clear Period Event Interrupt Flag + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro clears period event interrupt flag. + * \hideinitializer + */ +#define TPWM_CLEAR_PERIOD_INT_FLAG(timer) ((timer)->PWMINTSTS0 = TIMER_PWMINTSTS0_PIF_Msk) + +/** + * @brief Enable Compare Up Event Interrupt + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro is used to enable the compare up event interrupt function. + * \hideinitializer + */ +#define TPWM_ENABLE_CMP_UP_INT(timer) ((timer)->PWMINTEN0 |= TIMER_PWMINTEN0_CMPUIEN_Msk) + +/** + * @brief Disable Compare Up Event Interrupt + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro is used to disable the compare up event interrupt function. + * \hideinitializer + */ +#define TPWM_DISABLE_CMP_UP_INT(timer) ((timer)->PWMINTEN0 &= ~TIMER_PWMINTEN0_CMPUIEN_Msk) + +/** + * @brief Get Compare Up Event Interrupt Flag + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @retval 0 Compare up event interrupt did not occur + * @retval 1 Compare up event interrupt occurred + * + * @details This macro indicates compare up event occurred or not. + * \hideinitializer + */ +#define TPWM_GET_CMP_UP_INT_FLAG(timer) (((timer)->PWMINTSTS0 & TIMER_PWMINTSTS0_CMPUIF_Msk)? 1 : 0) + +/** + * @brief Clear Compare Up Event Interrupt Flag + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro clears compare up event interrupt flag. + * \hideinitializer + */ +#define TPWM_CLEAR_CMP_UP_INT_FLAG(timer) ((timer)->PWMINTSTS0 = TIMER_PWMINTSTS0_CMPUIF_Msk) + +/** + * @brief Enable Compare Down Event Interrupt + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro is used to enable the compare down event interrupt function. + * \hideinitializer + */ +#define TPWM_ENABLE_CMP_DOWN_INT(timer) ((timer)->PWMINTEN0 |= TIMER_PWMINTEN0_CMPDIEN_Msk) + +/** + * @brief Disable Compare Down Event Interrupt + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro is used to disable the compare down event interrupt function. + * \hideinitializer + */ +#define TPWM_DISABLE_CMP_DOWN_INT(timer) ((timer)->PWMINTEN0 &= ~TIMER_PWMINTEN0_CMPDIEN_Msk) + +/** + * @brief Get Compare Down Event Interrupt Flag + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @retval 0 Compare down event interrupt did not occur + * @retval 1 Compare down event interrupt occurred + * + * @details This macro indicates compare down event occurred or not. + * \hideinitializer + */ +#define TPWM_GET_CMP_DOWN_INT_FLAG(timer) (((timer)->PWMINTSTS0 & TIMER_PWMINTSTS0_CMPDIF_Msk)? 1 : 0) + +/** + * @brief Clear Compare Down Event Interrupt Flag + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro clears compare down event interrupt flag. + * \hideinitializer + */ +#define TPWM_CLEAR_CMP_DOWN_INT_FLAG(timer) ((timer)->PWMINTSTS0 = TIMER_PWMINTSTS0_CMPDIF_Msk) + +/** + * @brief Get Counter Reach Maximum Count Status + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @retval 0 Timer PWM counter never counts to maximum value + * @retval 1 Timer PWM counter counts to maximum value, 0xFFFF + * + * @details This macro indicates Timer PWM counter has count to 0xFFFF or not. + * \hideinitializer + */ +#define TPWM_GET_REACH_MAX_CNT_STATUS(timer) (((timer)->PWMSTATUS & TIMER_PWMSTATUS_CNTMAXF_Msk)? 1 : 0) + +/** + * @brief Clear Counter Reach Maximum Count Status + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro clears reach maximum count status. + * \hideinitializer + */ +#define TPWM_CLEAR_REACH_MAX_CNT_STATUS(timer) ((timer)->PWMSTATUS = TIMER_PWMSTATUS_CNTMAXF_Msk) + +/** + * @brief Get Trigger ADC Status + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @retval 0 Trigger ADC start conversion is not occur + * @retval 1 Specified counter compare event has trigger ADC start conversion + * + * @details This macro is used to indicate PWM counter compare event has triggered ADC start conversion. + * \hideinitializer + */ +#define TPWM_GET_TRG_ADC_STATUS(timer) (((timer)->PWMSTATUS & TIMER_PWMSTATUS_EADCTRGF_Msk)? 1 : 0) + +/** + * @brief Clear Trigger ADC Status + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro is used to clear PWM counter compare event trigger ADC status. + * \hideinitializer + */ +#define TPWM_CLEAR_TRG_ADC_STATUS(timer) ((timer)->PWMSTATUS = TIMER_PWMSTATUS_EADCTRGF_Msk) + +/** + * @brief Set Brake Event at Brake Pin High or Low-to-High + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro is used to set detect brake event when external brake pin at high level or transfer from low to high. + * @note The default brake pin detection is high level or from low to high. + * \hideinitializer + */ +#define TPWM_SET_BRAKE_PIN_HIGH_DETECT(timer) ((timer)->PWMBNF &= ~TIMER_PWMBNF_BRKPINV_Msk) + +/** + * @brief Set Brake Event at Brake Pin Low or High-to-Low + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * + * @return None + * + * @details This macro is used to set detect brake event when external brake pin at low level or transfer from high to low. + * \hideinitializer + */ +#define TPWM_SET_BRAKE_PIN_LOW_DETECT(timer) ((timer)->PWMBNF |= TIMER_PWMBNF_BRKPINV_Msk) + +/** + * @brief Set External Brake Pin Source + * + * @param[in] timer The pointer of the specified Timer module. It could be TIMER0, TIMER1, TIMER2, TIMER3. + * @param[in] pin The external brake pin source, could be one of following source + * - \ref TPWM_TM_BRAKE0 + * - \ref TPWM_TM_BRAKE1 + * - \ref TPWM_TM_BRAKE2 + * - \ref TPWM_TM_BRAKE3 + * + * @return None + * + * @details This macro is used to set detect brake event when external brake pin at high level or transfer from low to high. + * \hideinitializer + */ +#define TPWM_SET_BRAKE_PIN_SOURCE(timer, pin) ((timer)->PWMBNF = ((timer)->PWMBNF & ~TIMER_PWMBNF_BKPINSRC_Msk) | ((pin)<CTL = (TRNG->CTL&~TRNG_CTL_CLKP_Msk)|((clkpsc & 0xf)<> 4ul)-2ul) + + +/** + * @brief Calculate UART baudrate mode2 divider + * + * @param[in] u32SrcFreq UART clock frequency + * @param[in] u32BaudRate Baudrate of UART module + * + * @return UART baudrate mode2 divider + * + * @details This macro calculate UART baudrate mode2 divider. + * \hideinitializer + */ +#define UART_BAUD_MODE2_DIVIDER(u32SrcFreq, u32BaudRate) ((((u32SrcFreq) + ((u32BaudRate)/2ul)) / (u32BaudRate))-2ul) + + +/** + * @brief Write UART data + * + * @param[in] uart The pointer of the specified UART module + * @param[in] u8Data Data byte to transmit. + * + * @return None + * + * @details This macro write Data to Tx data register. + * \hideinitializer + */ +#define UART_WRITE(uart, u8Data) ((uart)->DAT = (u8Data)) + + +/** + * @brief Read UART data + * + * @param[in] uart The pointer of the specified UART module + * + * @return The oldest data byte in RX FIFO. + * + * @details This macro read Rx data register. + * \hideinitializer + */ +#define UART_READ(uart) ((uart)->DAT) + + +/** + * @brief Get Tx empty + * + * @param[in] uart The pointer of the specified UART module + * + * @retval 0 Tx FIFO is not empty + * @retval >=1 Tx FIFO is empty + * + * @details This macro get Transmitter FIFO empty register value. + * \hideinitializer + */ +#define UART_GET_TX_EMPTY(uart) ((uart)->FIFOSTS & UART_FIFOSTS_TXEMPTY_Msk) + + +/** + * @brief Get Rx empty + * + * @param[in] uart The pointer of the specified UART module + * + * @retval 0 Rx FIFO is not empty + * @retval >=1 Rx FIFO is empty + * + * @details This macro get Receiver FIFO empty register value. + * \hideinitializer + */ +#define UART_GET_RX_EMPTY(uart) ((uart)->FIFOSTS & UART_FIFOSTS_RXEMPTY_Msk) + + +/** + * @brief Check specified UART port transmission is over. + * + * @param[in] uart The pointer of the specified UART module + * + * @retval 0 Tx transmission is not over + * @retval 1 Tx transmission is over + * + * @details This macro return Transmitter Empty Flag register bit value. + * It indicates if specified UART port transmission is over nor not. + * \hideinitializer + */ +#define UART_IS_TX_EMPTY(uart) (((uart)->FIFOSTS & UART_FIFOSTS_TXEMPTYF_Msk) >> UART_FIFOSTS_TXEMPTYF_Pos) + + +/** + * @brief Wait specified UART port transmission is over + * + * @param[in] uart The pointer of the specified UART module + * + * @return None + * + * @details This macro wait specified UART port transmission is over. + * \hideinitializer + */ +#define UART_WAIT_TX_EMPTY(uart) while(!((((uart)->FIFOSTS) & UART_FIFOSTS_TXEMPTYF_Msk) >> UART_FIFOSTS_TXEMPTYF_Pos)) + + +/** + * @brief Check RX is ready or not + * + * @param[in] uart The pointer of the specified UART module + * + * @retval 0 The number of bytes in the RX FIFO is less than the RFITL + * @retval 1 The number of bytes in the RX FIFO equals or larger than RFITL + * + * @details This macro check receive data available interrupt flag is set or not. + * \hideinitializer + */ +#define UART_IS_RX_READY(uart) (((uart)->INTSTS & UART_INTSTS_RDAIF_Msk)>>UART_INTSTS_RDAIF_Pos) + + +/** + * @brief Check TX FIFO is full or not + * + * @param[in] uart The pointer of the specified UART module + * + * @retval 1 TX FIFO is full + * @retval 0 TX FIFO is not full + * + * @details This macro check TX FIFO is full or not. + * \hideinitializer + */ +#define UART_IS_TX_FULL(uart) (((uart)->FIFOSTS & UART_FIFOSTS_TXFULL_Msk)>>UART_FIFOSTS_TXFULL_Pos) + + +/** + * @brief Check RX FIFO is full or not + * + * @param[in] uart The pointer of the specified UART module + * + * @retval 1 RX FIFO is full + * @retval 0 RX FIFO is not full + * + * @details This macro check RX FIFO is full or not. + * \hideinitializer + */ +#define UART_IS_RX_FULL(uart) (((uart)->FIFOSTS & UART_FIFOSTS_RXFULL_Msk)>>UART_FIFOSTS_RXFULL_Pos) + + +/** + * @brief Get Tx full register value + * + * @param[in] uart The pointer of the specified UART module + * + * @retval 0 Tx FIFO is not full. + * @retval >=1 Tx FIFO is full. + * + * @details This macro get Tx full register value. + * \hideinitializer + */ +#define UART_GET_TX_FULL(uart) ((uart)->FIFOSTS & UART_FIFOSTS_TXFULL_Msk) + + +/** + * @brief Get Rx full register value + * + * @param[in] uart The pointer of the specified UART module + * + * @retval 0 Rx FIFO is not full. + * @retval >=1 Rx FIFO is full. + * + * @details This macro get Rx full register value. + * \hideinitializer + */ +#define UART_GET_RX_FULL(uart) ((uart)->FIFOSTS & UART_FIFOSTS_RXFULL_Msk) + + +/** + * @brief Enable specified UART interrupt + * + * @param[in] uart The pointer of the specified UART module + * @param[in] u32eIntSel Interrupt type select + * - \ref UART_INTEN_ABRIEN_Msk : Auto baud rate interrupt + * - \ref UART_INTEN_WKIEN_Msk : Wakeup interrupt + * - \ref UART_INTEN_LINIEN_Msk : Lin bus interrupt + * - \ref UART_INTEN_BUFERRIEN_Msk : Buffer Error interrupt + * - \ref UART_INTEN_RXTOIEN_Msk : Rx time-out interrupt + * - \ref UART_INTEN_MODEMIEN_Msk : Modem interrupt + * - \ref UART_INTEN_RLSIEN_Msk : Rx Line status interrupt + * - \ref UART_INTEN_THREIEN_Msk : Tx empty interrupt + * - \ref UART_INTEN_RDAIEN_Msk : Rx ready interrupt + * + * @return None + * + * @details This macro enable specified UART interrupt. + * \hideinitializer + */ +#define UART_ENABLE_INT(uart, u32eIntSel) ((uart)->INTEN |= (u32eIntSel)) + + +/** + * @brief Disable specified UART interrupt + * + * @param[in] uart The pointer of the specified UART module + * @param[in] u32eIntSel Interrupt type select + * - \ref UART_INTEN_ABRIEN_Msk : Auto baud rate interrupt + * - \ref UART_INTEN_WKIEN_Msk : Wakeup interrupt + * - \ref UART_INTEN_LINIEN_Msk : Lin bus interrupt + * - \ref UART_INTEN_BUFERRIEN_Msk : Buffer Error interrupt + * - \ref UART_INTEN_RXTOIEN_Msk : Rx time-out interrupt + * - \ref UART_INTEN_MODEMIEN_Msk : Modem status interrupt + * - \ref UART_INTEN_RLSIEN_Msk : Receive Line status interrupt + * - \ref UART_INTEN_THREIEN_Msk : Tx empty interrupt + * - \ref UART_INTEN_RDAIEN_Msk : Rx ready interrupt + * + * @return None + * + * @details This macro enable specified UART interrupt. + * \hideinitializer + */ +#define UART_DISABLE_INT(uart, u32eIntSel) ((uart)->INTEN &= ~ (u32eIntSel)) + + +/** + * @brief Get specified interrupt flag/status + * + * @param[in] uart The pointer of the specified UART module + * @param[in] u32eIntTypeFlag Interrupt Type Flag, should be + * - \ref UART_INTSTS_HWBUFEINT_Msk : In DMA Mode, Buffer Error Interrupt Indicator + * - \ref UART_INTSTS_HWTOINT_Msk : In DMA Mode, Time-out Interrupt Indicator + * - \ref UART_INTSTS_HWMODINT_Msk : In DMA Mode, MODEM Status Interrupt Indicator + * - \ref UART_INTSTS_HWRLSINT_Msk : In DMA Mode, Receive Line Status Interrupt Indicator + * - \ref UART_INTSTS_HWBUFEIF_Msk : In DMA Mode, Buffer Error Interrupt Flag + * - \ref UART_INTSTS_HWTOIF_Msk : In DMA Mode, Time-out Interrupt Flag + * - \ref UART_INTSTS_HWMODIF_Msk : In DMA Mode, MODEM Interrupt Flag + * - \ref UART_INTSTS_HWRLSIF_Msk : In DMA Mode, Receive Line Status Flag + * - \ref UART_INTSTS_LININT_Msk : LIN Bus Interrupt Indicator + * - \ref UART_INTSTS_BUFERRINT_Msk : Buffer Error Interrupt Indicator + * - \ref UART_INTSTS_RXTOINT_Msk : Time-out Interrupt Indicator + * - \ref UART_INTSTS_MODEMINT_Msk : Modem Status Interrupt Indicator + * - \ref UART_INTSTS_RLSINT_Msk : Receive Line Status Interrupt Indicator + * - \ref UART_INTSTS_THREINT_Msk : Transmit Holding Register Empty Interrupt Indicator + * - \ref UART_INTSTS_RDAINT_Msk : Receive Data Available Interrupt Indicator + * - \ref UART_INTSTS_LINIF_Msk : LIN Bus Flag + * - \ref UART_INTSTS_BUFERRIF_Msk : Buffer Error Interrupt Flag + * - \ref UART_INTSTS_RXTOIF_Msk : Rx Time-out Interrupt Flag + * - \ref UART_INTSTS_MODEMIF_Msk : Modem Interrupt Flag + * - \ref UART_INTSTS_RLSIF_Msk : Receive Line Status Interrupt Flag + * - \ref UART_INTSTS_THREIF_Msk : Tx Empty Interrupt Flag + * - \ref UART_INTSTS_RDAIF_Msk : Rx Ready Interrupt Flag + * + * @retval 0 The specified interrupt is not happened. + * 1 The specified interrupt is happened. + * + * @details This macro get specified interrupt flag or interrupt indicator status. + * \hideinitializer + */ +#define UART_GET_INT_FLAG(uart,u32eIntTypeFlag) (((uart)->INTSTS & (u32eIntTypeFlag))?1:0) + + +/** + * @brief Clear RS-485 Address Byte Detection Flag + * + * @param[in] uart The pointer of the specified UART module + * + * @return None + * + * @details This macro clear RS-485 address byte detection flag. + * \hideinitializer + */ +#define UART_RS485_CLEAR_ADDR_FLAG(uart) ((uart)->FIFOSTS = UART_FIFOSTS_ADDRDETF_Msk) + + +/** + * @brief Get RS-485 Address Byte Detection Flag + * + * @param[in] uart The pointer of the specified UART module + * + * @retval 0 Receiver detects a data that is not an address bit. + * @retval 1 Receiver detects a data that is an address bit. + * + * @details This macro get RS-485 address byte detection flag. + * \hideinitializer + */ +#define UART_RS485_GET_ADDR_FLAG(uart) (((uart)->FIFOSTS & UART_FIFOSTS_ADDRDETF_Msk) >> UART_FIFOSTS_ADDRDETF_Pos) + +/* Declare these inline functions here to avoid MISRA C 2004 rule 8.1 error */ +__STATIC_INLINE void UART_CLEAR_RTS(UART_T* uart); +__STATIC_INLINE void UART_SET_RTS(UART_T* uart); + + +/** + * @brief Set RTS pin to low + * + * @param[in] uart The pointer of the specified UART module + * + * @return None + * + * @details This macro set RTS pin to low. + */ +__STATIC_INLINE void UART_CLEAR_RTS(UART_T* uart) +{ + uart->MODEM |= UART_MODEM_RTSACTLV_Msk; + uart->MODEM &= ~UART_MODEM_RTS_Msk; +} + + +/** + * @brief Set RTS pin to high + * + * @param[in] uart The pointer of the specified UART module + * + * @return None + * + * @details This macro set RTS pin to high. + */ +__STATIC_INLINE void UART_SET_RTS(UART_T* uart) +{ + uart->MODEM |= UART_MODEM_RTSACTLV_Msk | UART_MODEM_RTS_Msk; +} + +/** + * @brief Enable specified UART PDMA function + * + * @param[in] uart The pointer of the specified UART module + * @param[in] u32FuncSel Combination of following functions + * - \ref UART_INTEN_TXPDMAEN_Msk + * - \ref UART_INTEN_RXPDMAEN_Msk + * + * @return None + * + * \hideinitializer + */ +#define UART_PDMA_ENABLE(uart, u32FuncSel) ((uart)->INTEN |= (u32FuncSel)) +/** + * @brief Disable specified UART PDMA function + * + * @param[in] uart The pointer of the specified UART module + * @param[in] u32FuncSel Combination of following functions + * - \ref UART_INTEN_TXPDMAEN_Msk + * - \ref UART_INTEN_RXPDMAEN_Msk + * + * @return None + * + * \hideinitializer + */ +#define UART_PDMA_DISABLE(uart, u32FuncSel) ((uart)->INTEN &= ~(u32FuncSel)) + + +void UART_ClearIntFlag(UART_T* uart, uint32_t u32InterruptFlag); +void UART_Close(UART_T* uart); +void UART_DisableFlowCtrl(UART_T* uart); +void UART_DisableInt(UART_T* uart, uint32_t u32InterruptFlag); +void UART_EnableFlowCtrl(UART_T* uart); +void UART_EnableInt(UART_T* uart, uint32_t u32InterruptFlag); +void UART_Open(UART_T* uart, uint32_t u32baudrate); +uint32_t UART_Read(UART_T* uart, uint8_t pu8RxBuf[], uint32_t u32ReadBytes); +void UART_SetLineConfig(UART_T* uart, uint32_t u32baudrate, uint32_t u32data_width, uint32_t u32parity, uint32_t u32stop_bits); +void UART_SetTimeoutCnt(UART_T* uart, uint32_t u32TOC); +void UART_SelectIrDAMode(UART_T* uart, uint32_t u32Buadrate, uint32_t u32Direction); +void UART_SelectRS485Mode(UART_T* uart, uint32_t u32Mode, uint32_t u32Addr); +void UART_SelectLINMode(UART_T* uart, uint32_t u32Mode, uint32_t u32BreakLength); +uint32_t UART_Write(UART_T* uart, uint8_t pu8TxBuf[], uint32_t u32WriteBytes); + + + + +/*@}*/ /* end of group UART_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group UART_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /*__NU_UART_H__*/ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_usbd.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_usbd.h new file mode 100644 index 00000000000..cc03314b85e --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_usbd.h @@ -0,0 +1,693 @@ +/**************************************************************************//** + * @file nu_usbd.h + * @version V1.00 + * @brief M480 series USB driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + ******************************************************************************/ +#ifndef __NU_USBD_H__ +#define __NU_USBD_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup USBD_Driver USBD Driver + @{ +*/ + +/** @addtogroup USBD_EXPORTED_STRUCT USBD Exported Struct + @{ +*/ +typedef struct s_usbd_info +{ + uint8_t *gu8DevDesc; /*!< Pointer for USB Device Descriptor */ + uint8_t *gu8ConfigDesc; /*!< Pointer for USB Configuration Descriptor */ + uint8_t **gu8StringDesc; /*!< Pointer for USB String Descriptor pointers */ + uint8_t **gu8HidReportDesc; /*!< Pointer for USB HID Report Descriptor */ + uint8_t *gu8BosDesc; /*!< Pointer for USB BOS Descriptor */ + uint32_t *gu32HidReportSize; /*!< Pointer for HID Report descriptor Size */ + uint32_t *gu32ConfigHidDescIdx; /*!< Pointer for HID Descriptor start index */ + +} S_USBD_INFO_T; /*!< Device description structure */ + +extern const S_USBD_INFO_T gsInfo; + +/*@}*/ /* end of group USBD_EXPORTED_STRUCT */ + + + + +/** @addtogroup USBD_EXPORTED_CONSTANTS USBD Exported Constants + @{ +*/ +#define USBD_BUF_BASE (USBD_BASE+0x100ul) /*!< USBD buffer base address \hideinitializer */ +#define USBD_MAX_EP 12ul /*!< Total EP number \hideinitializer */ + +#define EP0 0ul /*!< Endpoint 0 \hideinitializer */ +#define EP1 1ul /*!< Endpoint 1 \hideinitializer */ +#define EP2 2ul /*!< Endpoint 2 \hideinitializer */ +#define EP3 3ul /*!< Endpoint 3 \hideinitializer */ +#define EP4 4ul /*!< Endpoint 4 \hideinitializer */ +#define EP5 5ul /*!< Endpoint 5 \hideinitializer */ +#define EP6 6ul /*!< Endpoint 6 \hideinitializer */ +#define EP7 7ul /*!< Endpoint 7 \hideinitializer */ +#define EP8 8ul /*!< Endpoint 8 \hideinitializer */ +#define EP9 9ul /*!< Endpoint 9 \hideinitializer */ +#define EP10 10ul /*!< Endpoint 10 \hideinitializer */ +#define EP11 11ul /*!< Endpoint 11 \hideinitializer */ + +/** @cond HIDDEN_SYMBOLS */ +/* USB Request Type */ +#define REQ_STANDARD 0x00ul +#define REQ_CLASS 0x20ul +#define REQ_VENDOR 0x40ul + +/* USB Standard Request */ +#define GET_STATUS 0x00ul +#define CLEAR_FEATURE 0x01ul +#define SET_FEATURE 0x03ul +#define SET_ADDRESS 0x05ul +#define GET_DESCRIPTOR 0x06ul +#define SET_DESCRIPTOR 0x07ul +#define GET_CONFIGURATION 0x08ul +#define SET_CONFIGURATION 0x09ul +#define GET_INTERFACE 0x0Aul +#define SET_INTERFACE 0x0Bul +#define SYNC_FRAME 0x0Cul + +/* USB Descriptor Type */ +#define DESC_DEVICE 0x01ul +#define DESC_CONFIG 0x02ul +#define DESC_STRING 0x03ul +#define DESC_INTERFACE 0x04ul +#define DESC_ENDPOINT 0x05ul +#define DESC_QUALIFIER 0x06ul +#define DESC_OTHERSPEED 0x07ul +#define DESC_IFPOWER 0x08ul +#define DESC_OTG 0x09ul +#define DESC_BOS 0x0Ful +#define DESC_CAPABILITY 0x10ul + +/* USB Device Capability Type */ +#define CAP_WIRELESS 0x01ul +#define CAP_USB20_EXT 0x02ul + +/* USB HID Descriptor Type */ +#define DESC_HID 0x21ul +#define DESC_HID_RPT 0x22ul + +/* USB Descriptor Length */ +#define LEN_DEVICE 18ul +#define LEN_QUALIFIER 10ul +#define LEN_CONFIG 9ul +#define LEN_INTERFACE 9ul +#define LEN_ENDPOINT 7ul +#define LEN_OTG 5ul +#define LEN_BOS 5ul +#define LEN_HID 9ul +#define LEN_CCID 0x36ul +#define LEN_BOSCAP 7ul + +/* USB Endpoint Type */ +#define EP_ISO 0x01 +#define EP_BULK 0x02 +#define EP_INT 0x03 + +#define EP_INPUT 0x80 +#define EP_OUTPUT 0x00 + +/* USB Feature Selector */ +#define FEATURE_DEVICE_REMOTE_WAKEUP 0x01ul +#define FEATURE_ENDPOINT_HALT 0x00ul +/** @endcond HIDDEN_SYMBOLS */ + +/******************************************************************************/ +/* USB Specific Macros */ +/******************************************************************************/ + +#define USBD_WAKEUP_EN USBD_INTEN_WKEN_Msk /*!< USB Wake-up Enable \hideinitializer */ +#define USBD_DRVSE0 USBD_SE0_SE0_Msk /*!< Drive SE0 \hideinitializer */ + +#define USBD_DPPU_EN USBD_ATTR_DPPUEN_Msk /*!< USB D+ Pull-up Enable \hideinitializer */ +#define USBD_PWRDN USBD_ATTR_PWRDN_Msk /*!< PHY Turn-On \hideinitializer */ +#define USBD_PHY_EN USBD_ATTR_PHYEN_Msk /*!< PHY Enable \hideinitializer */ +#define USBD_USB_EN USBD_ATTR_USBEN_Msk /*!< USB Enable \hideinitializer */ + +#define USBD_INT_BUS USBD_INTEN_BUSIEN_Msk /*!< USB Bus Event Interrupt \hideinitializer */ +#define USBD_INT_USB USBD_INTEN_USBIEN_Msk /*!< USB Event Interrupt \hideinitializer */ +#define USBD_INT_FLDET USBD_INTEN_VBDETIEN_Msk /*!< USB VBUS Detection Interrupt \hideinitializer */ +#define USBD_INT_WAKEUP (USBD_INTEN_NEVWKIEN_Msk | USBD_INTEN_WKEN_Msk) /*!< USB No-Event-Wake-Up Interrupt \hideinitializer */ + +#define USBD_INTSTS_WAKEUP USBD_INTSTS_NEVWKIF_Msk /*!< USB No-Event-Wake-Up Interrupt Status \hideinitializer */ +#define USBD_INTSTS_FLDET USBD_INTSTS_VBDETIF_Msk /*!< USB Float Detect Interrupt Status \hideinitializer */ +#define USBD_INTSTS_BUS USBD_INTSTS_BUSIF_Msk /*!< USB Bus Event Interrupt Status \hideinitializer */ +#define USBD_INTSTS_USB USBD_INTSTS_USBIF_Msk /*!< USB Event Interrupt Status \hideinitializer */ +#define USBD_INTSTS_SETUP USBD_INTSTS_SETUP_Msk /*!< USB Setup Event \hideinitializer */ +#define USBD_INTSTS_EP0 USBD_INTSTS_EPEVT0_Msk /*!< USB Endpoint 0 Event \hideinitializer */ +#define USBD_INTSTS_EP1 USBD_INTSTS_EPEVT1_Msk /*!< USB Endpoint 1 Event \hideinitializer */ +#define USBD_INTSTS_EP2 USBD_INTSTS_EPEVT2_Msk /*!< USB Endpoint 2 Event \hideinitializer */ +#define USBD_INTSTS_EP3 USBD_INTSTS_EPEVT3_Msk /*!< USB Endpoint 3 Event \hideinitializer */ +#define USBD_INTSTS_EP4 USBD_INTSTS_EPEVT4_Msk /*!< USB Endpoint 4 Event \hideinitializer */ +#define USBD_INTSTS_EP5 USBD_INTSTS_EPEVT5_Msk /*!< USB Endpoint 5 Event \hideinitializer */ +#define USBD_INTSTS_EP6 USBD_INTSTS_EPEVT6_Msk /*!< USB Endpoint 6 Event \hideinitializer */ +#define USBD_INTSTS_EP7 USBD_INTSTS_EPEVT7_Msk /*!< USB Endpoint 7 Event \hideinitializer */ +#define USBD_INTSTS_EP8 USBD_INTSTS_EPEVT8_Msk /*!< USB Endpoint 8 Event \hideinitializer */ +#define USBD_INTSTS_EP9 USBD_INTSTS_EPEVT9_Msk /*!< USB Endpoint 9 Event \hideinitializer */ +#define USBD_INTSTS_EP10 USBD_INTSTS_EPEVT10_Msk /*!< USB Endpoint 10 Event \hideinitializer */ +#define USBD_INTSTS_EP11 USBD_INTSTS_EPEVT11_Msk /*!< USB Endpoint 11 Event \hideinitializer */ + +#define USBD_STATE_USBRST USBD_ATTR_USBRST_Msk /*!< USB Bus Reset \hideinitializer */ +#define USBD_STATE_SUSPEND USBD_ATTR_SUSPEND_Msk /*!< USB Bus Suspend \hideinitializer */ +#define USBD_STATE_RESUME USBD_ATTR_RESUME_Msk /*!< USB Bus Resume \hideinitializer */ +#define USBD_STATE_TIMEOUT USBD_ATTR_TOUT_Msk /*!< USB Bus Timeout \hideinitializer */ + +#define USBD_CFGP_SSTALL USBD_CFGP_SSTALL_Msk /*!< Set Stall \hideinitializer */ +#define USBD_CFG_CSTALL USBD_CFG_CSTALL_Msk /*!< Clear Stall \hideinitializer */ + +#define USBD_CFG_EPMODE_DISABLE (0ul << USBD_CFG_STATE_Pos)/*!< Endpoint Disable \hideinitializer */ +#define USBD_CFG_EPMODE_OUT (1ul << USBD_CFG_STATE_Pos)/*!< Out Endpoint \hideinitializer */ +#define USBD_CFG_EPMODE_IN (2ul << USBD_CFG_STATE_Pos)/*!< In Endpoint \hideinitializer */ +#define USBD_CFG_TYPE_ISO (1ul << USBD_CFG_ISOCH_Pos) /*!< Isochronous \hideinitializer */ + + + +/*@}*/ /* end of group USBD_EXPORTED_CONSTANTS */ + + +/** @addtogroup USBD_EXPORTED_FUNCTIONS USBD Exported Functions + @{ +*/ +/** + * @brief Compare two input numbers and return maximum one. + * + * @param[in] a First number to be compared. + * @param[in] b Second number to be compared. + * + * @return Maximum value between a and b. + * + * @details If a > b, then return a. Otherwise, return b. + * \hideinitializer + */ +#define USBD_Maximum(a,b) ((a)>(b) ? (a) : (b)) + + +/** + * @brief Compare two input numbers and return minimum one + * + * @param[in] a First number to be compared + * @param[in] b Second number to be compared + * + * @return Minimum value between a and b + * + * @details If a < b, then return a. Otherwise, return b. + * \hideinitializer + */ +#define USBD_Minimum(a,b) ((a)<(b) ? (a) : (b)) + + +/** + * @brief Enable USB + * + * @param None + * + * @return None + * + * @details To set USB ATTR control register to enable USB and PHY. + * \hideinitializer + */ +#define USBD_ENABLE_USB() ((uint32_t)(USBD->ATTR |= 0x7D0)) + +/** + * @brief Disable USB + * + * @param None + * + * @return None + * + * @details To set USB ATTR control register to disable USB. + * \hideinitializer + */ +#define USBD_DISABLE_USB() ((uint32_t)(USBD->ATTR &= ~USBD_USB_EN)) + +/** + * @brief Enable USB PHY + * + * @param None + * + * @return None + * + * @details To set USB ATTR control register to enable USB PHY. + * \hideinitializer + */ +#define USBD_ENABLE_PHY() ((uint32_t)(USBD->ATTR |= USBD_PHY_EN)) + +/** + * @brief Disable USB PHY + * + * @param None + * + * @return None + * + * @details To set USB ATTR control register to disable USB PHY. + * \hideinitializer + */ +#define USBD_DISABLE_PHY() ((uint32_t)(USBD->ATTR &= ~USBD_PHY_EN)) + +/** + * @brief Enable SE0. Force USB PHY transceiver to drive SE0. + * + * @param None + * + * @return None + * + * @details Set DRVSE0 bit of USB_DRVSE0 register to enable software-disconnect function. Force USB PHY transceiver to drive SE0 to bus. + * \hideinitializer + */ +#define USBD_SET_SE0() ((uint32_t)(USBD->SE0 |= USBD_DRVSE0)) + +/** + * @brief Disable SE0 + * + * @param None + * + * @return None + * + * @details Clear DRVSE0 bit of USB_DRVSE0 register to disable software-disconnect function. + * \hideinitializer + */ +#define USBD_CLR_SE0() ((uint32_t)(USBD->SE0 &= ~USBD_DRVSE0)) + +/** + * @brief Set USB device address + * + * @param[in] addr The USB device address. + * + * @return None + * + * @details Write USB device address to USB_FADDR register. + * \hideinitializer + */ +#define USBD_SET_ADDR(addr) (USBD->FADDR = (addr)) + +/** + * @brief Get USB device address + * + * @param None + * + * @return USB device address + * + * @details Read USB_FADDR register to get USB device address. + * \hideinitializer + */ +#define USBD_GET_ADDR() ((uint32_t)(USBD->FADDR)) + +/** + * @brief Enable USB interrupt function + * + * @param[in] intr The combination of the specified interrupt enable bits. + * Each bit corresponds to a interrupt enable bit. + * This parameter decides which interrupts will be enabled. + * (USBD_INT_WAKEUP, USBD_INT_FLDET, USBD_INT_USB, USBD_INT_BUS) + * + * @return None + * + * @details Enable USB related interrupt functions specified by intr parameter. + * \hideinitializer + */ +#define USBD_ENABLE_INT(intr) (USBD->INTEN |= (intr)) + +/** + * @brief Get interrupt status + * + * @param None + * + * @return The value of USB_INTSTS register + * + * @details Return all interrupt flags of USB_INTSTS register. + * \hideinitializer + */ +#define USBD_GET_INT_FLAG() ((uint32_t)(USBD->INTSTS)) + +/** + * @brief Clear USB interrupt flag + * + * @param[in] flag The combination of the specified interrupt flags. + * Each bit corresponds to a interrupt source. + * This parameter decides which interrupt flags will be cleared. + * (USBD_INTSTS_WAKEUP, USBD_INTSTS_FLDET, USBD_INTSTS_BUS, USBD_INTSTS_USB) + * + * @return None + * + * @details Clear USB related interrupt flags specified by flag parameter. + * \hideinitializer + */ +#define USBD_CLR_INT_FLAG(flag) (USBD->INTSTS = (flag)) + +/** + * @brief Get endpoint status + * + * @param None + * + * @return The value of USB_EPSTS register. + * + * @details Return all endpoint status. + * \hideinitializer + */ +#define USBD_GET_EP_FLAG() ((uint32_t)(USBD->EPSTS)) + +/** + * @brief Get USB bus state + * + * @param None + * + * @return The value of USB_ATTR[3:0]. + * Bit 0 indicates USB bus reset status. + * Bit 1 indicates USB bus suspend status. + * Bit 2 indicates USB bus resume status. + * Bit 3 indicates USB bus time-out status. + * + * @details Return USB_ATTR[3:0] for USB bus events. + * \hideinitializer + */ +#define USBD_GET_BUS_STATE() ((uint32_t)(USBD->ATTR & 0xf)) + +/** + * @brief Check cable connection state + * + * @param None + * + * @retval 0 USB cable is not attached. + * @retval 1 USB cable is attached. + * + * @details Check the connection state by FLDET bit of USB_FLDET register. + * \hideinitializer + */ +#define USBD_IS_ATTACHED() ((uint32_t)(USBD->VBUSDET & USBD_VBUSDET_VBUSDET_Msk)) + +/** + * @brief Stop USB transaction of the specified endpoint ID + * + * @param[in] ep The USB endpoint ID. M480 Series supports 8 hardware endpoint ID. This parameter could be 0 ~ 11. + * + * @return None + * + * @details Write 1 to CLRRDY bit of USB_CFGPx register to stop USB transaction of the specified endpoint ID. + * \hideinitializer + */ +#define USBD_STOP_TRANSACTION(ep) (*((__IO uint32_t *) ((uint32_t)&USBD->EP[0].CFGP + (uint32_t)((ep) << 4))) |= USBD_CFGP_CLRRDY_Msk) + +/** + * @brief Set USB DATA1 PID for the specified endpoint ID + * + * @param[in] ep The USB endpoint ID. M480 Series supports 8 hardware endpoint ID. This parameter could be 0 ~ 11. + * + * @return None + * + * @details Set DSQ_SYNC bit of USB_CFGx register to specify the DATA1 PID for the following IN token transaction. + * Base on this setting, hardware will toggle PID between DATA0 and DATA1 automatically for IN token transactions. + * \hideinitializer + */ +#define USBD_SET_DATA1(ep) (*((__IO uint32_t *) ((uint32_t)&USBD->EP[0].CFG + (uint32_t)((ep) << 4))) |= USBD_CFG_DSQSYNC_Msk) + +/** + * @brief Set USB DATA0 PID for the specified endpoint ID + * + * @param[in] ep The USB endpoint ID. M480 Series supports 8 hardware endpoint ID. This parameter could be 0 ~ 11. + * + * @return None + * + * @details Clear DSQ_SYNC bit of USB_CFGx register to specify the DATA0 PID for the following IN token transaction. + * Base on this setting, hardware will toggle PID between DATA0 and DATA1 automatically for IN token transactions. + * \hideinitializer + */ +#define USBD_SET_DATA0(ep) (*((__IO uint32_t *) ((uint32_t)&USBD->EP[0].CFG + (uint32_t)((ep) << 4))) &= (~USBD_CFG_DSQSYNC_Msk)) + +/** + * @brief Set USB payload size (IN data) + * + * @param[in] ep The USB endpoint ID. M480 Series supports 8 hardware endpoint ID. This parameter could be 0 ~ 11. + * + * @param[in] size The transfer length. + * + * @return None + * + * @details This macro will write the transfer length to USB_MXPLDx register for IN data transaction. + * \hideinitializer + */ +#define USBD_SET_PAYLOAD_LEN(ep, size) (*((__IO uint32_t *) ((uint32_t)&USBD->EP[0].MXPLD + (uint32_t)((ep) << 4))) = (size)) + +/** + * @brief Get USB payload size (OUT data) + * + * @param[in] ep The USB endpoint ID. M480 Series supports 8 endpoint ID. This parameter could be 0 ~ 11. + * + * @return The value of USB_MXPLDx register. + * + * @details Get the data length of OUT data transaction by reading USB_MXPLDx register. + * \hideinitializer + */ +#define USBD_GET_PAYLOAD_LEN(ep) ((uint32_t)*((__IO uint32_t *) ((uint32_t)&USBD->EP[0].MXPLD + (uint32_t)((ep) << 4)))) + +/** + * @brief Configure endpoint + * + * @param[in] ep The USB endpoint ID. M480 Series supports 8 hardware endpoint ID. This parameter could be 0 ~ 11. + * + * @param[in] config The USB configuration. + * + * @return None + * + * @details This macro will write config parameter to USB_CFGx register of specified endpoint ID. + * \hideinitializer + */ +#define USBD_CONFIG_EP(ep, config) (*((__IO uint32_t *) ((uint32_t)&USBD->EP[0].CFG + (uint32_t)((ep) << 4))) = (config)) + +/** + * @brief Set USB endpoint buffer + * + * @param[in] ep The USB endpoint ID. M480 Series supports 8 hardware endpoint ID. This parameter could be 0 ~ 11. + * + * @param[in] offset The SRAM offset. + * + * @return None + * + * @details This macro will set the SRAM offset for the specified endpoint ID. + * \hideinitializer + */ +#define USBD_SET_EP_BUF_ADDR(ep, offset) (*((__IO uint32_t *) ((uint32_t)&USBD->EP[0].BUFSEG + (uint32_t)((ep) << 4))) = (offset)) + +/** + * @brief Get the offset of the specified USB endpoint buffer + * + * @param[in] ep The USB endpoint ID. M480 Series supports 8 hardware endpoint ID. This parameter could be 0 ~ 11. + * + * @return The offset of the specified endpoint buffer. + * + * @details This macro will return the SRAM offset of the specified endpoint ID. + * \hideinitializer + */ +#define USBD_GET_EP_BUF_ADDR(ep) ((uint32_t)*((__IO uint32_t *) ((uint32_t)&USBD->EP[0].BUFSEG + (uint32_t)((ep) << 4)))) + +/** + * @brief Set USB endpoint stall state + * + * @param[in] ep The USB endpoint ID. M480 Series supports 8 hardware endpoint ID. This parameter could be 0 ~ 11. + * + * @return None + * + * @details Set USB endpoint stall state for the specified endpoint ID. Endpoint will respond STALL token automatically. + * \hideinitializer + */ +#define USBD_SET_EP_STALL(ep) (*((__IO uint32_t *) ((uint32_t)&USBD->EP[0ul].CFGP + (uint32_t)((ep) << 4))) |= USBD_CFGP_SSTALL_Msk) + +/** + * @brief Clear USB endpoint stall state + * + * @param[in] ep The USB endpoint ID. M480 Series supports 8 hardware endpoint ID. This parameter could be 0 ~ 11. + * + * @return None + * + * @details Clear USB endpoint stall state for the specified endpoint ID. Endpoint will respond ACK/NAK token. + * \hideinitializer + */ +#define USBD_CLR_EP_STALL(ep) (*((__IO uint32_t *) ((uint32_t)&USBD->EP[0].CFGP + (uint32_t)((ep) << 4))) &= ~USBD_CFGP_SSTALL_Msk) + +/** + * @brief Get USB endpoint stall state + * + * @param[in] ep The USB endpoint ID. M480 Series supports 8 hardware endpoint ID. This parameter could be 0 ~ 11. + * + * @retval 0 USB endpoint is not stalled. + * @retval Others USB endpoint is stalled. + * + * @details Get USB endpoint stall state of the specified endpoint ID. + * \hideinitializer + */ +#define USBD_GET_EP_STALL(ep) (*((__IO uint32_t *) ((uint32_t)&USBD->EP[0].CFGP + (uint32_t)((ep) << 4))) & USBD_CFGP_SSTALL_Msk) + +/** + * @brief To support byte access between USB SRAM and system SRAM + * + * @param[in] dest Destination pointer. + * + * @param[in] src Source pointer. + * + * @param[in] size Byte count. + * + * @return None + * + * @details This function will copy the number of data specified by size and src parameters to the address specified by dest parameter. + * + */ +__STATIC_INLINE void USBD_MemCopy(uint8_t dest[], uint8_t src[], uint32_t size) +{ + uint32_t volatile i=0ul; + + while(size--) + { + dest[i] = src[i]; + i++; + } +} + +/** + * @brief Set USB endpoint stall state + * + * @param[in] epnum USB endpoint number + * + * @return None + * + * @details Set USB endpoint stall state. Endpoint will respond STALL token automatically. + * + */ +__STATIC_INLINE void USBD_SetStall(uint8_t epnum) +{ + uint32_t u32CfgAddr; + uint32_t u32Cfg; + uint32_t i; + + for(i = 0ul; i < USBD_MAX_EP; i++) + { + u32CfgAddr = (uint32_t)(i << 4) + (uint32_t)&USBD->EP[0].CFG; /* USBD_CFG0 */ + u32Cfg = *((__IO uint32_t *)(u32CfgAddr)); + + if((u32Cfg & 0xful) == epnum) + { + u32CfgAddr = (uint32_t)(i << 4) + (uint32_t)&USBD->EP[0].CFGP; /* USBD_CFGP0 */ + u32Cfg = *((__IO uint32_t *)(u32CfgAddr)); + + *((__IO uint32_t *)(u32CfgAddr)) = (u32Cfg | USBD_CFGP_SSTALL); + break; + } + } +} + +/** + * @brief Clear USB endpoint stall state + * + * @param[in] epnum USB endpoint number + * + * @return None + * + * @details Clear USB endpoint stall state. Endpoint will respond ACK/NAK token. + */ +__STATIC_INLINE void USBD_ClearStall(uint8_t epnum) +{ + uint32_t u32CfgAddr; + uint32_t u32Cfg; + uint32_t i; + + for(i = 0ul; i < USBD_MAX_EP; i++) + { + u32CfgAddr = (uint32_t)(i << 4) + (uint32_t)&USBD->EP[0].CFG; /* USBD_CFG0 */ + u32Cfg = *((__IO uint32_t *)(u32CfgAddr)); + + if((u32Cfg & 0xful) == epnum) + { + u32CfgAddr = (uint32_t)(i << 4) + (uint32_t)&USBD->EP[0].CFGP; /* USBD_CFGP0 */ + u32Cfg = *((__IO uint32_t *)(u32CfgAddr)); + + *((__IO uint32_t *)(u32CfgAddr)) = (u32Cfg & ~USBD_CFGP_SSTALL); + break; + } + } +} + +/** + * @brief Get USB endpoint stall state + * + * @param[in] epnum USB endpoint number + * + * @retval 0 USB endpoint is not stalled. + * @retval Others USB endpoint is stalled. + * + * @details Get USB endpoint stall state. + * + */ +__STATIC_INLINE uint32_t USBD_GetStall(uint8_t epnum) +{ + uint32_t u32CfgAddr; + uint32_t u32Cfg; + uint32_t i; + + for(i = 0ul; i < USBD_MAX_EP; i++) + { + u32CfgAddr = (uint32_t)(i << 4) + (uint32_t)&USBD->EP[0].CFG; /* USBD_CFG0 */ + u32Cfg = *((__IO uint32_t *)(u32CfgAddr)); + + if((u32Cfg & 0xful) == epnum) + { + u32CfgAddr = (uint32_t)(i << 4) + (uint32_t)&USBD->EP[0].CFGP; /* USBD_CFGP0 */ + break; + } + } + + return ((*((__IO uint32_t *)(u32CfgAddr))) & USBD_CFGP_SSTALL); +} + + +extern volatile uint8_t g_usbd_RemoteWakeupEn; + + +typedef void (*VENDOR_REQ)(void); /*!< Functional pointer type definition for Vendor class */ +typedef void (*CLASS_REQ)(void); /*!< Functional pointer type declaration for USB class request callback handler */ +typedef void (*SET_INTERFACE_REQ)(uint32_t u32AltInterface); /*!< Functional pointer type declaration for USB set interface request callback handler */ +typedef void (*SET_CONFIG_CB)(void); /*!< Functional pointer type declaration for USB set configuration request callback handler */ + + +/*--------------------------------------------------------------------*/ +void USBD_Open(const S_USBD_INFO_T *param, CLASS_REQ pfnClassReq, SET_INTERFACE_REQ pfnSetInterface); +void USBD_Start(void); +void USBD_GetSetupPacket(uint8_t *buf); +void USBD_ProcessSetupPacket(void); +void USBD_StandardRequest(void); +void USBD_PrepareCtrlIn(uint8_t pu8Buf[], uint32_t u32Size); +void USBD_CtrlIn(void); +void USBD_PrepareCtrlOut(uint8_t *pu8Buf, uint32_t u32Size); +void USBD_CtrlOut(void); +void USBD_SwReset(void); +void USBD_SetVendorRequest(VENDOR_REQ pfnVendorReq); +void USBD_SetConfigCallback(SET_CONFIG_CB pfnSetConfigCallback); +void USBD_LockEpStall(uint32_t u32EpBitmap); + +/*@}*/ /* end of group USBD_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group USBD_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /*__NU_USBD_H__*/ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_usci_i2c.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_usci_i2c.h new file mode 100644 index 00000000000..55508d5e77e --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_usci_i2c.h @@ -0,0 +1,332 @@ +/**************************************************************************//** + * @file USCI_I2C.h + * @version V3.0 + * @brief M480 series USCI I2C(UI2C) driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + ******************************************************************************/ +#ifndef __NU_USCI_I2C_H__ +#define __NU_USCI_I2C_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup USCI_I2C_Driver USCI_I2C Driver + @{ +*/ + +/** @addtogroup USCI_I2C_EXPORTED_CONSTANTS USCI_I2C Exported Constants + @{ +*/ + +/*---------------------------------------------------------------------------------------------------------*/ +/* USCI_I2C master event definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +enum UI2C_MASTER_EVENT +{ + MASTER_SEND_ADDRESS = 10, /*!< Master send address to Slave */ + MASTER_SEND_H_WR_ADDRESS, /*!< Master send High address to Slave */ + MASTER_SEND_H_RD_ADDRESS, /*!< Master send address to Slave (Read ADDR) */ + MASTER_SEND_L_ADDRESS, /*!< Master send Low address to Slave */ + MASTER_SEND_DATA, /*!< Master Send Data to Slave */ + MASTER_SEND_REPEAT_START, /*!< Master send repeat start to Slave */ + MASTER_READ_DATA, /*!< Master Get Data from Slave */ + MASTER_STOP, /*!< Master send stop to Slave */ + MASTER_SEND_START /*!< Master send start to Slave */ +}; + +/*---------------------------------------------------------------------------------------------------------*/ +/* USCI_I2C slave event definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +enum UI2C_SLAVE_EVENT +{ + SLAVE_ADDRESS_ACK = 100, /*!< Slave send address ACK */ + SLAVE_H_WR_ADDRESS_ACK, /*!< Slave send High address ACK */ + SLAVE_L_WR_ADDRESS_ACK, /*!< Slave send Low address ACK */ + SLAVE_GET_DATA, /*!< Slave Get Data from Master (Write CMD) */ + SLAVE_SEND_DATA, /*!< Slave Send Data to Master (Read CMD) */ + SLAVE_H_RD_ADDRESS_ACK, /*!< Slave send High address ACK */ + SLAVE_L_RD_ADDRESS_ACK /*!< Slave send Low address ACK */ +}; + +/*---------------------------------------------------------------------------------------------------------*/ +/* USCI_CTL constant definitions. */ +/*---------------------------------------------------------------------------------------------------------*/ +#define UI2C_CTL_PTRG 0x20UL /*!< USCI_CTL setting for I2C control bits. It would set PTRG bit \hideinitializer */ +#define UI2C_CTL_STA 0x08UL /*!< USCI_CTL setting for I2C control bits. It would set STA bit \hideinitializer */ +#define UI2C_CTL_STO 0x04UL /*!< USCI_CTL setting for I2C control bits. It would set STO bit \hideinitializer */ +#define UI2C_CTL_AA 0x02UL /*!< USCI_CTL setting for I2C control bits. It would set AA bit \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* USCI_I2C GCMode constant definitions. */ +/*---------------------------------------------------------------------------------------------------------*/ +#define UI2C_GCMODE_ENABLE (1U) /*!< Enable USCI_I2C GC Mode \hideinitializer */ +#define UI2C_GCMODE_DISABLE (0U) /*!< Disable USCI_I2C GC Mode \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* USCI_I2C Wakeup Mode constant definitions. */ +/*---------------------------------------------------------------------------------------------------------*/ +#define UI2C_DATA_TOGGLE_WK (0x0U << UI2C_WKCTL_WKADDREN_Pos) /*!< Wakeup according data toggle \hideinitializer */ +#define UI2C_ADDR_MATCH_WK (0x1U << UI2C_WKCTL_WKADDREN_Pos) /*!< Wakeup according address match \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* USCI_I2C interrupt mask definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define UI2C_TO_INT_MASK (0x001U) /*!< Time-out interrupt mask \hideinitializer */ +#define UI2C_STAR_INT_MASK (0x002U) /*!< Start condition received interrupt mask \hideinitializer */ +#define UI2C_STOR_INT_MASK (0x004U) /*!< Stop condition received interrupt mask \hideinitializer */ +#define UI2C_NACK_INT_MASK (0x008U) /*!< Non-acknowledge interrupt mask \hideinitializer */ +#define UI2C_ARBLO_INT_MASK (0x010U) /*!< Arbitration lost interrupt mask \hideinitializer */ +#define UI2C_ERR_INT_MASK (0x020U) /*!< Error interrupt mask \hideinitializer */ +#define UI2C_ACK_INT_MASK (0x040U) /*!< Acknowledge interrupt mask \hideinitializer */ + +/*@}*/ /* end of group USCI_I2C_EXPORTED_CONSTANTS */ + + +/** @addtogroup USCI_I2C_EXPORTED_FUNCTIONS USCI_I2C Exported Functions + @{ +*/ + +/** + * @brief This macro sets the USCI_I2C protocol control register at one time + * + * @param[in] ui2c The pointer of the specified USCI_I2C module. + * @param[in] u8Ctrl Set the register value of USCI_I2C control register. + * + * @return None + * + * @details Set UI2C_PROTCTL register to control USCI_I2C bus conditions of START, STOP, SI, ACK. + * \hideinitializer + */ +#define UI2C_SET_CONTROL_REG(ui2c, u8Ctrl) ((ui2c)->PROTCTL = ((ui2c)->PROTCTL & ~0x2EU) | (u8Ctrl)) + +/** + * @brief This macro only set START bit to protocol control register of USCI_I2C module. + * + * @param[in] ui2c The pointer of the specified USCI_I2C module. + * + * @return None + * + * @details Set the USCI_I2C bus START condition in UI2C_PROTCTL register. + * \hideinitializer + */ +#define UI2C_START(ui2c) ((ui2c)->PROTCTL = ((ui2c)->PROTCTL & ~UI2C_PROTCTL_PTRG_Msk) | UI2C_PROTCTL_STA_Msk) + +/** + * @brief This macro only set STOP bit to the control register of USCI_I2C module + * + * @param[in] ui2c The pointer of the specified USCI_I2C module. + * + * @return None + * + * @details Set the USCI_I2C bus STOP condition in UI2C_PROTCTL register. + * \hideinitializer + */ +#define UI2C_STOP(ui2c) ((ui2c)->PROTCTL = ((ui2c)->PROTCTL & ~0x2E) | (UI2C_PROTCTL_PTRG_Msk | UI2C_PROTCTL_STO_Msk)) + +/** + * @brief This macro returns the data stored in data register of USCI_I2C module + * + * @param[in] ui2c The pointer of the specified USCI_I2C module. + * + * @return Data + * + * @details Read a byte data value of UI2C_RXDAT register from USCI_I2C bus + * \hideinitializer + */ +#define UI2C_GET_DATA(ui2c) ((ui2c)->RXDAT) + +/** + * @brief This macro writes the data to data register of USCI_I2C module + * + * @param[in] ui2c The pointer of the specified USCI_I2C module. + * @param[in] u8Data The data which will be written to data register of USCI_I2C module. + * + * @return None + * + * @details Write a byte data value of UI2C_TXDAT register, then sends address or data to USCI I2C bus + * \hideinitializer + */ +#define UI2C_SET_DATA(ui2c, u8Data) ((ui2c)->TXDAT = (u8Data)) + +/** + * @brief This macro returns time-out flag + * + * @param[in] ui2c The pointer of the specified USCI_I2C module. + * + * @retval 0 USCI_I2C bus time-out is not happened + * @retval 1 USCI_I2C bus time-out is happened + * + * @details USCI_I2C bus occurs time-out event, the time-out flag will be set. If not occurs time-out event, this bit is cleared. + * \hideinitializer + */ +#define UI2C_GET_TIMEOUT_FLAG(ui2c) (((ui2c)->PROTSTS & UI2C_PROTSTS_TOIF_Msk) == UI2C_PROTSTS_TOIF_Msk ? 1:0) + +/** + * @brief This macro returns wake-up flag + * + * @param[in] ui2c The pointer of the specified USCI_I2C module. + * + * @retval 0 Chip is not woken-up from power-down mode + * @retval 1 Chip is woken-up from power-down mode + * + * @details USCI_I2C controller wake-up flag will be set when USCI_I2C bus occurs wake-up from deep-sleep. + * \hideinitializer + */ +#define UI2C_GET_WAKEUP_FLAG(ui2c) (((ui2c)->WKSTS & UI2C_WKSTS_WKF_Msk) == UI2C_WKSTS_WKF_Msk ? 1:0) + +/** + * @brief This macro is used to clear USCI_I2C wake-up flag + * + * @param[in] ui2c The pointer of the specified USCI_I2C module. + * + * @return None + * + * @details If USCI_I2C wake-up flag is set, use this macro to clear it. + * \hideinitializer + */ +#define UI2C_CLR_WAKEUP_FLAG(ui2c) ((ui2c)->WKSTS = UI2C_WKSTS_WKF_Msk) + +/** + * @brief This macro disables the USCI_I2C 10-bit address mode + * + * @param[in] ui2c The pointer of the specified USCI_I2C module. + * + * @return None + * + * @details The UI2C_I2C is 7-bit address mode, when disable USCI_I2C 10-bit address match function. + * \hideinitializer + */ +#define UI2C_DISABLE_10BIT_ADDR_MODE(ui2c) ((ui2c)->PROTCTL &= ~(UI2C_PROTCTL_ADDR10EN_Msk)) + +/** + * @brief This macro enables the 10-bit address mode + * + * @param[in] ui2c The pointer of the specified USCI_I2C module. + * + * @return None + * + * @details To enable USCI_I2C 10-bit address match function. + * \hideinitializer + */ +#define UI2C_ENABLE_10BIT_ADDR_MODE(ui2c) ((ui2c)->PROTCTL |= UI2C_PROTCTL_ADDR10EN_Msk) + +/** + * @brief This macro gets USCI_I2C protocol interrupt flag or bus status + * + * @param[in] ui2c The pointer of the specified USCI_I2C module. + * + * @return A word data of USCI_I2C_PROTSTS register + * + * @details Read a word data of USCI_I2C PROTSTS register to get USCI_I2C bus Interrupt flags or status. + * \hideinitializer + */ +#define UI2C_GET_PROT_STATUS(ui2c) ((ui2c)->PROTSTS) + +/** + * @brief This macro clears specified protocol interrupt flag + * @param[in] ui2c The pointer of the specified USCI_I2C module. + * @param[in] u32IntTypeFlag Interrupt Type Flag, should be + * - \ref UI2C_PROTSTS_ACKIF_Msk + * - \ref UI2C_PROTSTS_ERRIF_Msk + * - \ref UI2C_PROTSTS_ARBLOIF_Msk + * - \ref UI2C_PROTSTS_NACKIF_Msk + * - \ref UI2C_PROTSTS_STORIF_Msk + * - \ref UI2C_PROTSTS_STARIF_Msk + * - \ref UI2C_PROTSTS_TOIF_Msk + * @return None + * + * @details To clear interrupt flag when USCI_I2C occurs interrupt and set interrupt flag. + * \hideinitializer + */ +#define UI2C_CLR_PROT_INT_FLAG(ui2c,u32IntTypeFlag) ((ui2c)->PROTSTS = (u32IntTypeFlag)) + +/** + * @brief This macro enables specified protocol interrupt + * @param[in] ui2c The pointer of the specified USCI_I2C module. + * @param[in] u32IntSel Interrupt Type, should be + * - \ref UI2C_PROTIEN_ACKIEN_Msk + * - \ref UI2C_PROTIEN_ERRIEN_Msk + * - \ref UI2C_PROTIEN_ARBLOIEN_Msk + * - \ref UI2C_PROTIEN_NACKIEN_Msk + * - \ref UI2C_PROTIEN_STORIEN_Msk + * - \ref UI2C_PROTIEN_STARIEN_Msk + * - \ref UI2C_PROTIEN_TOIEN_Msk + * @return None + * + * @details Set specified USCI_I2C protocol interrupt bits to enable interrupt function. + * \hideinitializer + */ +#define UI2C_ENABLE_PROT_INT(ui2c, u32IntSel) ((ui2c)->PROTIEN |= (u32IntSel)) + +/** + * @brief This macro disables specified protocol interrupt + * @param[in] ui2c The pointer of the specified USCI_I2C module. + * @param[in] u32IntSel Interrupt Type, should be + * - \ref UI2C_PROTIEN_ACKIEN_Msk + * - \ref UI2C_PROTIEN_ERRIEN_Msk + * - \ref UI2C_PROTIEN_ARBLOIEN_Msk + * - \ref UI2C_PROTIEN_NACKIEN_Msk + * - \ref UI2C_PROTIEN_STORIEN_Msk + * - \ref UI2C_PROTIEN_STARIEN_Msk + * - \ref UI2C_PROTIEN_TOIEN_Msk + * @return None + * + * @details Clear specified USCI_I2C protocol interrupt bits to disable interrupt function. + * \hideinitializer + */ +#define UI2C_DISABLE_PROT_INT(ui2c, u32IntSel) ((ui2c)->PROTIEN &= ~ (u32IntSel)) + + +uint32_t UI2C_Open(UI2C_T *ui2c, uint32_t u32BusClock); +void UI2C_Close(UI2C_T *ui2c); +void UI2C_ClearTimeoutFlag(UI2C_T *ui2c); +void UI2C_Trigger(UI2C_T *ui2c, uint8_t u8Start, uint8_t u8Stop, uint8_t u8Ptrg, uint8_t u8Ack); +void UI2C_DisableInt(UI2C_T *ui2c, uint32_t u32Mask); +void UI2C_EnableInt(UI2C_T *ui2c, uint32_t u32Mask); +uint32_t UI2C_GetBusClockFreq(UI2C_T *ui2c); +uint32_t UI2C_SetBusClockFreq(UI2C_T *ui2c, uint32_t u32BusClock); +uint32_t UI2C_GetIntFlag(UI2C_T *ui2c, uint32_t u32Mask); +void UI2C_ClearIntFlag(UI2C_T* ui2c, uint32_t u32Mask); +uint32_t UI2C_GetData(UI2C_T *ui2c); +void UI2C_SetData(UI2C_T *ui2c, uint8_t u8Data); +void UI2C_SetSlaveAddr(UI2C_T *ui2c, uint8_t u8SlaveNo, uint16_t u16SlaveAddr, uint8_t u8GCMode); +void UI2C_SetSlaveAddrMask(UI2C_T *ui2c, uint8_t u8SlaveNo, uint16_t u16SlaveAddrMask); +void UI2C_EnableTimeout(UI2C_T *ui2c, uint32_t u32TimeoutCnt); +void UI2C_DisableTimeout(UI2C_T *ui2c); +void UI2C_EnableWakeup(UI2C_T *ui2c, uint8_t u8WakeupMode); +void UI2C_DisableWakeup(UI2C_T *ui2c); +uint8_t UI2C_WriteByte(UI2C_T *ui2c, uint8_t u8SlaveAddr, uint8_t data); +uint32_t UI2C_WriteMultiBytes(UI2C_T *ui2c, uint8_t u8SlaveAddr, uint8_t *data, uint32_t u32wLen); +uint8_t UI2C_WriteByteOneReg(UI2C_T *ui2c, uint8_t u8SlaveAddr, uint8_t u8DataAddr, uint8_t data); +uint32_t UI2C_WriteMultiBytesOneReg(UI2C_T *ui2c, uint8_t u8SlaveAddr, uint8_t u8DataAddr, uint8_t *data, uint32_t u32wLen); +uint8_t UI2C_WriteByteTwoRegs(UI2C_T *ui2c, uint8_t u8SlaveAddr, uint16_t u16DataAddr, uint8_t data); +uint32_t UI2C_WriteMultiBytesTwoRegs(UI2C_T *ui2c, uint8_t u8SlaveAddr, uint16_t u16DataAddr, uint8_t *data, uint32_t u32wLen); +uint8_t UI2C_ReadByte(UI2C_T *ui2c, uint8_t u8SlaveAddr); +uint32_t UI2C_ReadMultiBytes(UI2C_T *ui2c, uint8_t u8SlaveAddr, uint8_t *rdata, uint32_t u32rLen); +uint8_t UI2C_ReadByteOneReg(UI2C_T *ui2c, uint8_t u8SlaveAddr, uint8_t u8DataAddr); +uint32_t UI2C_ReadMultiBytesOneReg(UI2C_T *ui2c, uint8_t u8SlaveAddr, uint8_t u8DataAddr, uint8_t *rdata, uint32_t u32rLen); +uint8_t UI2C_ReadByteTwoRegs(UI2C_T *ui2c, uint8_t u8SlaveAddr, uint16_t u16DataAddr); +uint32_t UI2C_ReadMultiBytesTwoRegs(UI2C_T *ui2c, uint8_t u8SlaveAddr, uint16_t u16DataAddr, uint8_t *rdata, uint32_t u32rLen); + +/*@}*/ /* end of group USCI_I2C_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group USCI_I2C_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_usci_spi.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_usci_spi.h new file mode 100644 index 00000000000..68d4e02a897 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_usci_spi.h @@ -0,0 +1,411 @@ +/****************************************************************************//** + * @file nu_usci_spi.h + * @version V3.00 + * @brief M480 series USCI_SPI driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. +*****************************************************************************/ +#ifndef __NU_USCI_SPI_H__ +#define __NU_USCI_SPI_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup USCI_SPI_Driver USCI_SPI Driver + @{ +*/ + +/** @addtogroup USCI_SPI_EXPORTED_CONSTANTS USCI_SPI Exported Constants + @{ +*/ + +#define USPI_MODE_0 (0x0 << USPI_PROTCTL_SCLKMODE_Pos) /*!< SCLK idle low; data transmit with falling edge and receive with rising edge \hideinitializer */ +#define USPI_MODE_1 (0x1 << USPI_PROTCTL_SCLKMODE_Pos) /*!< SCLK idle low; data transmit with rising edge and receive with falling edge \hideinitializer */ +#define USPI_MODE_2 (0x2 << USPI_PROTCTL_SCLKMODE_Pos) /*!< SCLK idle high; data transmit with rising edge and receive with falling edge \hideinitializer */ +#define USPI_MODE_3 (0x3 << USPI_PROTCTL_SCLKMODE_Pos) /*!< SCLK idle high; data transmit with falling edge and receive with rising edge \hideinitializer */ + +#define USPI_SLAVE (USPI_PROTCTL_SLAVE_Msk) /*!< Set as slave \hideinitializer */ +#define USPI_MASTER (0x0ul) /*!< Set as master \hideinitializer */ + +#define USPI_SS (USPI_PROTCTL_SS_Msk) /*!< Set SS \hideinitializer */ +#define USPI_SS_ACTIVE_HIGH (0x0ul) /*!< SS active high \hideinitializer */ +#define USPI_SS_ACTIVE_LOW (USPI_LINECTL_CTLOINV_Msk) /*!< SS active low \hideinitializer */ + +/* USCI_SPI Interrupt Mask */ +#define USPI_SSINACT_INT_MASK (0x001ul) /*!< Slave Slave Inactive interrupt mask \hideinitializer */ +#define USPI_SSACT_INT_MASK (0x002ul) /*!< Slave Slave Active interrupt mask \hideinitializer */ +#define USPI_SLVTO_INT_MASK (0x004ul) /*!< Slave Mode Time-out interrupt mask \hideinitializer */ +#define USPI_SLVBE_INT_MASK (0x008ul) /*!< Slave Mode Bit Count Error interrupt mask \hideinitializer */ +#define USPI_TXUDR_INT_MASK (0x010ul) /*!< Slave Transmit Under Run interrupt mask \hideinitializer */ +#define USPI_RXOV_INT_MASK (0x020ul) /*!< Receive Buffer Overrun interrupt mask \hideinitializer */ +#define USPI_TXST_INT_MASK (0x040ul) /*!< Transmit Start interrupt mask \hideinitializer */ +#define USPI_TXEND_INT_MASK (0x080ul) /*!< Transmit End interrupt mask \hideinitializer */ +#define USPI_RXST_INT_MASK (0x100ul) /*!< Receive Start interrupt mask \hideinitializer */ +#define USPI_RXEND_INT_MASK (0x200ul) /*!< Receive End interrupt mask \hideinitializer */ + +/* USCI_SPI Status Mask */ +#define USPI_BUSY_MASK (0x01ul) /*!< Busy status mask \hideinitializer */ +#define USPI_RX_EMPTY_MASK (0x02ul) /*!< RX empty status mask \hideinitializer */ +#define USPI_RX_FULL_MASK (0x04ul) /*!< RX full status mask \hideinitializer */ +#define USPI_TX_EMPTY_MASK (0x08ul) /*!< TX empty status mask \hideinitializer */ +#define USPI_TX_FULL_MASK (0x10ul) /*!< TX full status mask \hideinitializer */ +#define USPI_SSLINE_STS_MASK (0x20ul) /*!< USCI_SPI_SS line status mask \hideinitializer */ + +/*@}*/ /* end of group USCI_SPI_EXPORTED_CONSTANTS */ + + +/** @addtogroup USCI_SPI_EXPORTED_FUNCTIONS USCI_SPI Exported Functions + @{ +*/ + +/** + * @brief Disable slave 3-wire mode. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @return None + * \hideinitializer + */ +#define USPI_DISABLE_3WIRE_MODE(uspi) ( (uspi)->PROTCTL &= ~USPI_PROTCTL_SLV3WIRE_Msk ) + +/** + * @brief Enable slave 3-wire mode. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @return None + * \hideinitializer + */ +#define USPI_ENABLE_3WIRE_MODE(uspi) ( (uspi)->PROTCTL |= USPI_PROTCTL_SLV3WIRE_Msk ) + +/** + * @brief Get the Rx buffer empty flag. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @return Rx buffer flag + * @retval 0: Rx buffer is not empty + * @retval 1: Rx buffer is empty + * \hideinitializer + */ +#define USPI_GET_RX_EMPTY_FLAG(uspi) ( ((uspi)->BUFSTS & USPI_BUFSTS_RXEMPTY_Msk) == USPI_BUFSTS_RXEMPTY_Msk ? 1:0 ) + +/** + * @brief Get the Tx buffer empty flag. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @return Tx buffer flag + * @retval 0: Tx buffer is not empty + * @retval 1: Tx buffer is empty + * \hideinitializer + */ +#define USPI_GET_TX_EMPTY_FLAG(uspi) ( ((uspi)->BUFSTS & USPI_BUFSTS_TXEMPTY_Msk) == USPI_BUFSTS_TXEMPTY_Msk ? 1:0 ) + +/** + * @brief Get the Tx buffer full flag. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @return Tx buffer flag + * @retval 0: Tx buffer is not full + * @retval 1: Tx buffer is full + * \hideinitializer + */ +#define USPI_GET_TX_FULL_FLAG(uspi) ( ((uspi)->BUFSTS & USPI_BUFSTS_TXFULL_Msk) == USPI_BUFSTS_TXFULL_Msk ? 1:0 ) + +/** + * @brief Get the datum read from RX register. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @return data in Rx register + * \hideinitializer + */ +#define USPI_READ_RX(uspi) ((uspi)->RXDAT) + +/** + * @brief Write datum to TX register. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @param[in] u32TxData The datum which user attempt to transfer through USCI_SPI bus. + * @return None + * \hideinitializer + */ +#define USPI_WRITE_TX(uspi, u32TxData) ( (uspi)->TXDAT = (u32TxData) ) + +/** + * @brief Set USCI_SPI_SS pin to high state. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @return None. + * @details Disable automatic slave selection function and set USCI_SPI_SS pin to high state. Only available in Master mode. + * \hideinitializer + */ +#define USPI_SET_SS_HIGH(uspi) \ + do{ \ + (uspi)->LINECTL &= ~(USPI_LINECTL_CTLOINV_Msk); \ + (uspi)->PROTCTL = ((uspi)->PROTCTL & ~(USPI_PROTCTL_AUTOSS_Msk | USPI_PROTCTL_SS_Msk)); \ + }while(0) + +/** + * @brief Set USCI_SPI_SS pin to low state. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @return None. + * @details Disable automatic slave selection function and set USCI_SPI_SS pin to low state. Only available in Master mode. + * \hideinitializer + */ +#define USPI_SET_SS_LOW(uspi) \ + do{ \ + (uspi)->LINECTL |= (USPI_LINECTL_CTLOINV_Msk); \ + (uspi)->PROTCTL = (((uspi)->PROTCTL & ~USPI_PROTCTL_AUTOSS_Msk) | USPI_PROTCTL_SS_Msk); \ + }while(0) + +/** + * @brief Set the length of suspend interval. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @param[in] u32SuspCycle Decide the length of suspend interval. + * @return None + * \hideinitializer + */ +#define USPI_SET_SUSPEND_CYCLE(uspi, u32SuspCycle) ( (uspi)->PROTCTL = ((uspi)->PROTCTL & ~USPI_PROTCTL_SUSPITV_Msk) | ((u32SuspCycle) << USPI_PROTCTL_SUSPITV_Pos) ) + +/** + * @brief Set the USCI_SPI transfer sequence with LSB first. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @return None + * \hideinitializer + */ +#define USPI_SET_LSB_FIRST(uspi) ( (uspi)->LINECTL |= USPI_LINECTL_LSB_Msk ) + +/** + * @brief Set the USCI_SPI transfer sequence with MSB first. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @return None + * \hideinitializer + */ +#define USPI_SET_MSB_FIRST(uspi) ( (uspi)->LINECTL &= ~USPI_LINECTL_LSB_Msk ) + +/** + * @brief Set the data width of a USCI_SPI transaction. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @param[in] u32Width The data width + * @return None + * \hideinitializer + */ +#define USPI_SET_DATA_WIDTH(uspi,u32Width) \ + do{ \ + if((u32Width) == 16ul){ \ + (uspi)->LINECTL = ((uspi)->LINECTL & ~USPI_LINECTL_DWIDTH_Msk) | (0 << USPI_LINECTL_DWIDTH_Pos); \ + }else { \ + (uspi)->LINECTL = ((uspi)->LINECTL & ~USPI_LINECTL_DWIDTH_Msk) | ((u32Width) << USPI_LINECTL_DWIDTH_Pos); \ + } \ + }while(0) + +/** + * @brief Get the USCI_SPI busy state. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @return USCI_SPI busy status + * @retval 0: USCI_SPI module is not busy + * @retval 1: USCI_SPI module is busy + * \hideinitializer + */ +#define USPI_IS_BUSY(uspi) ( ((uspi)->PROTSTS & USPI_PROTSTS_BUSY_Msk) == USPI_PROTSTS_BUSY_Msk ? 1:0 ) + +/** + * @brief Get the USCI_SPI wakeup flag. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @return Wakeup status. + * @retval 0 Flag is not set. + * @retval 1 Flag is set. + * \hideinitializer + */ +#define USPI_GET_WAKEUP_FLAG(uspi) ( ((uspi)->WKSTS & USPI_WKSTS_WKF_Msk) == USPI_WKSTS_WKF_Msk ? 1:0) + +/** + * @brief Clear the USCI_SPI wakeup flag. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @return None + * \hideinitializer + */ +#define USPI_CLR_WAKEUP_FLAG(uspi) ( (uspi)->WKSTS |= USPI_WKSTS_WKF_Msk) + +/** + * @brief Get protocol interrupt flag/status. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @return The interrupt flag/status of protocol status register. + * \hideinitializer + */ +#define USPI_GET_PROT_STATUS(uspi) ( (uspi)->PROTSTS) + +/** + * @brief Clear specified protocol interrupt flag. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @param[in] u32IntTypeFlag Interrupt Type Flag, should be + * - \ref USPI_PROTSTS_SSACTIF_Msk + * - \ref USPI_PROTSTS_SSINAIF_Msk + * - \ref USPI_PROTSTS_SLVBEIF_Msk + * - \ref USPI_PROTSTS_SLVTOIF_Msk + * - \ref USPI_PROTSTS_RXENDIF_Msk + * - \ref USPI_PROTSTS_RXSTIF_Msk + * - \ref USPI_PROTSTS_TXENDIF_Msk + * - \ref USPI_PROTSTS_TXSTIF_Msk + * @return None + * \hideinitializer + */ +#define USPI_CLR_PROT_INT_FLAG(uspi,u32IntTypeFlag) ( (uspi)->PROTSTS = (u32IntTypeFlag)) + +/** + * @brief Get buffer interrupt flag/status. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @return The interrupt flag/status of buffer status register. + * \hideinitializer + */ +#define USPI_GET_BUF_STATUS(uspi) ( (uspi)->BUFSTS) + +/** + * @brief Clear specified buffer interrupt flag. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @param[in] u32IntTypeFlag Interrupt Type Flag, should be + * - \ref USPI_BUFSTS_TXUDRIF_Msk + * - \ref USPI_BUFSTS_RXOVIF_Msk + * @return None + * \hideinitializer + */ +#define USPI_CLR_BUF_INT_FLAG(uspi,u32IntTypeFlag) ( (uspi)->BUFSTS = (u32IntTypeFlag)) + +/** + * @brief Enable specified protocol interrupt. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @param[in] u32IntSel Interrupt Type, should be + * - \ref USPI_PROTIEN_SLVBEIEN_Msk + * - \ref USPI_PROTIEN_SLVTOIEN_Msk + * - \ref USPI_PROTIEN_SSACTIEN_Msk + * - \ref USPI_PROTIEN_SSINAIEN_Msk + * @return None + * \hideinitializer + */ +#define USPI_ENABLE_PROT_INT(uspi, u32IntSel) ((uspi)->PROTIEN |= (u32IntSel)) + +/** + * @brief Disable specified protocol interrupt. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @param[in] u32IntSel Interrupt Type, should be + * - \ref USPI_PROTIEN_SLVBEIEN_Msk + * - \ref USPI_PROTIEN_SLVTOIEN_Msk + * - \ref USPI_PROTIEN_SSACTIEN_Msk + * - \ref USPI_PROTIEN_SSINAIEN_Msk + * @return None + * \hideinitializer + */ +#define USPI_DISABLE_PROT_INT(uspi, u32IntSel) ((uspi)->PROTIEN &= ~ (u32IntSel)) + +/** + * @brief Enable specified buffer interrupt. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @param[in] u32IntSel Interrupt Type, should be + * - \ref USPI_BUFCTL_RXOVIEN_Msk + * - \ref USPI_BUFCTL_TXUDRIEN_Msk + * @return None + * \hideinitializer + */ +#define USPI_ENABLE_BUF_INT(uspi, u32IntSel) ((uspi)->BUFCTL |= (u32IntSel)) + +/** + * @brief Disable specified buffer interrupt. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @param[in] u32IntSel Interrupt Type, should be + * - \ref USPI_BUFCTL_RXOVIEN_Msk + * - \ref USPI_BUFCTL_TXUDRIEN_Msk + * @return None + * \hideinitializer + */ +#define USPI_DISABLE_BUF_INT(uspi, u32IntSel) ((uspi)->BUFCTL &= ~ (u32IntSel)) + +/** + * @brief Enable specified transfer interrupt. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @param[in] u32IntSel Interrupt Type, should be + * - \ref USPI_INTEN_RXENDIEN_Msk + * - \ref USPI_INTEN_RXSTIEN_Msk + * - \ref USPI_INTEN_TXENDIEN_Msk + * - \ref USPI_INTEN_TXSTIEN_Msk + * @return None + * \hideinitializer + */ +#define USPI_ENABLE_TRANS_INT(uspi, u32IntSel) ((uspi)->INTEN |= (u32IntSel)) + +/** + * @brief Disable specified transfer interrupt. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @param[in] u32IntSel Interrupt Type, should be + * - \ref USPI_INTEN_RXENDIEN_Msk + * - \ref USPI_INTEN_RXSTIEN_Msk + * - \ref USPI_INTEN_TXENDIEN_Msk + * - \ref USPI_INTEN_TXSTIEN_Msk + * @return None + * \hideinitializer + */ +#define USPI_DISABLE_TRANS_INT(uspi, u32IntSel) ((uspi)->INTEN &= ~ (u32IntSel)) + + +/** + * @brief Trigger RX PDMA function. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @return None. + * @details Set RXPDMAEN bit of USPI_PDMACTL register to enable RX PDMA transfer function. + * \hideinitializer + */ +#define USPI_TRIGGER_RX_PDMA(uspi) ((uspi)->PDMACTL |= USPI_PDMACTL_RXPDMAEN_Msk|USPI_PDMACTL_PDMAEN_Msk) + +/** + * @brief Trigger TX PDMA function. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @return None. + * @details Set TXPDMAEN bit of USPI_PDMACTL register to enable TX PDMA transfer function. + * \hideinitializer + */ +#define USPI_TRIGGER_TX_PDMA(uspi) ((uspi)->PDMACTL |= USPI_PDMACTL_TXPDMAEN_Msk|USPI_PDMACTL_PDMAEN_Msk) + +/** + * @brief Disable RX PDMA transfer. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @return None. + * @details Clear RXPDMAEN bit of USPI_PDMACTL register to disable RX PDMA transfer function. + * \hideinitializer + */ +#define USPI_DISABLE_RX_PDMA(uspi) ( (uspi)->PDMACTL &= ~USPI_PDMACTL_RXPDMAEN_Msk ) + +/** + * @brief Disable TX PDMA transfer. + * @param[in] uspi The pointer of the specified USCI_SPI module. + * @return None. + * @details Clear TXPDMAEN bit of USPI_PDMACTL register to disable TX PDMA transfer function. + * \hideinitializer + */ +#define USPI_DISABLE_TX_PDMA(uspi) ( (uspi)->PDMACTL &= ~USPI_PDMACTL_TXPDMAEN_Msk ) + +uint32_t USPI_Open(USPI_T *uspi, uint32_t u32MasterSlave, uint32_t u32SPIMode, uint32_t u32DataWidth, uint32_t u32BusClock); +void USPI_Close(USPI_T *uspi); +void USPI_ClearRxBuf(USPI_T *uspi); +void USPI_ClearTxBuf(USPI_T *uspi); +void USPI_DisableAutoSS(USPI_T *uspi); +void USPI_EnableAutoSS(USPI_T *uspi, uint32_t u32SSPinMask, uint32_t u32ActiveLevel); +uint32_t USPI_SetBusClock(USPI_T *uspi, uint32_t u32BusClock); +uint32_t USPI_GetBusClock(USPI_T *uspi); +void USPI_EnableInt(USPI_T *uspi, uint32_t u32Mask); +void USPI_DisableInt(USPI_T *uspi, uint32_t u32Mask); +uint32_t USPI_GetIntFlag(USPI_T *uspi, uint32_t u32Mask); +void USPI_ClearIntFlag(USPI_T *uspi, uint32_t u32Mask); +uint32_t USPI_GetStatus(USPI_T *uspi, uint32_t u32Mask); +void USPI_EnableWakeup(USPI_T *uspi); +void USPI_DisableWakeup(USPI_T *uspi); + + +/*@}*/ /* end of group USCI_SPI_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group USCI_SPI_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_USCI_SPI_H__ */ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_usci_uart.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_usci_uart.h new file mode 100644 index 00000000000..098fd319f49 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_usci_uart.h @@ -0,0 +1,471 @@ +/**************************************************************************//** + * @file nu_usci_uart.h + * @version V3.00 + * @brief M480 series USCI UART (UUART) driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. +*****************************************************************************/ +#ifndef __NU_USCI_UART_H__ +#define __NU_USCI_UART_H__ + + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup USCI_UART_Driver USCI_UART Driver + @{ +*/ + +/** @addtogroup USCI_UART_EXPORTED_CONSTANTS USCI_UART Exported Constants + @{ +*/ + +/*---------------------------------------------------------------------------------------------------------*/ +/* UUART_LINECTL constants definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define UUART_WORD_LEN_6 (6ul << UUART_LINECTL_DWIDTH_Pos) /*!< UUART_LINECTL setting to set UART word length to 6 bits \hideinitializer */ +#define UUART_WORD_LEN_7 (7ul << UUART_LINECTL_DWIDTH_Pos) /*!< UUART_LINECTL setting to set UART word length to 7 bits \hideinitializer */ +#define UUART_WORD_LEN_8 (8ul << UUART_LINECTL_DWIDTH_Pos) /*!< UUART_LINECTL setting to set UART word length to 8 bits \hideinitializer */ +#define UUART_WORD_LEN_9 (9ul << UUART_LINECTL_DWIDTH_Pos) /*!< UUART_LINECTL setting to set UART word length to 9 bits \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* UUART_PROTCTL constants definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define UUART_PARITY_NONE (0x0ul << UUART_PROTCTL_PARITYEN_Pos) /*!< UUART_PROTCTL setting to set UART as no parity \hideinitializer */ +#define UUART_PARITY_ODD (0x1ul << UUART_PROTCTL_PARITYEN_Pos) /*!< UUART_PROTCTL setting to set UART as odd parity \hideinitializer */ +#define UUART_PARITY_EVEN (0x3ul << UUART_PROTCTL_PARITYEN_Pos) /*!< UUART_PROTCTL setting to set UART as even parity \hideinitializer */ + +#define UUART_STOP_BIT_1 (0x0ul) /*!< UUART_PROTCTL setting for one stop bit \hideinitializer */ +#define UUART_STOP_BIT_2 (0x1ul) /*!< UUART_PROTCTL setting for two stop bit \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* USCI UART interrupt mask definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define UUART_ABR_INT_MASK (0x002ul) /*!< Auto-baud rate interrupt mask \hideinitializer */ +#define UUART_RLS_INT_MASK (0x004ul) /*!< Receive line status interrupt mask \hideinitializer */ +#define UUART_BUF_RXOV_INT_MASK (0x008ul) /*!< Buffer RX overrun interrupt mask \hideinitializer */ +#define UUART_TXST_INT_MASK (0x010ul) /*!< TX start interrupt mask \hideinitializer */ +#define UUART_TXEND_INT_MASK (0x020ul) /*!< Tx end interrupt mask \hideinitializer */ +#define UUART_RXST_INT_MASK (0x040ul) /*!< RX start interrupt mask \hideinitializer */ +#define UUART_RXEND_INT_MASK (0x080ul) /*!< RX end interrupt mask \hideinitializer */ + + +/*@}*/ /* end of group USCI_UART_EXPORTED_CONSTANTS */ + + +/** @addtogroup USCI_UART_EXPORTED_FUNCTIONS USCI_UART Exported Functions + @{ +*/ + + +/** + * @brief Write USCI_UART data + * + * @param[in] uuart The pointer of the specified USCI_UART module + * @param[in] u8Data Data byte to transmit. + * + * @return None + * + * @details This macro write Data to Tx data register. + * \hideinitializer + */ +#define UUART_WRITE(uuart, u8Data) ((uuart)->TXDAT = (u8Data)) + + +/** + * @brief Read USCI_UART data + * + * @param[in] uuart The pointer of the specified USCI_UART module + * + * @return The oldest data byte in RX buffer. + * + * @details This macro read Rx data register. + * \hideinitializer + */ +#define UUART_READ(uuart) ((uuart)->RXDAT) + + +/** + * @brief Get Tx empty + * + * @param[in] uuart The pointer of the specified USCI_UART module + * + * @retval 0 Tx buffer is not empty + * @retval >=1 Tx buffer is empty + * + * @details This macro get Transmitter buffer empty register value. + * \hideinitializer + */ +#define UUART_GET_TX_EMPTY(uuart) ((uuart)->BUFSTS & UUART_BUFSTS_TXEMPTY_Msk) + + +/** + * @brief Get Rx empty + * + * @param[in] uuart The pointer of the specified USCI_UART module + * + * @retval 0 Rx buffer is not empty + * @retval >=1 Rx buffer is empty + * + * @details This macro get Receiver buffer empty register value. + * \hideinitializer + */ +#define UUART_GET_RX_EMPTY(uuart) ((uuart)->BUFSTS & UUART_BUFSTS_RXEMPTY_Msk) + + +/** + * @brief Check specified usci_uart port transmission is over. + * + * @param[in] uuart The pointer of the specified USCI_UART module + * + * @retval 0 Tx transmission is not over + * @retval 1 Tx transmission is over + * + * @details This macro return Transmitter Empty Flag register bit value. \n + * It indicates if specified usci_uart port transmission is over nor not. + * \hideinitializer + */ +#define UUART_IS_TX_EMPTY(uuart) (((uuart)->BUFSTS & UUART_BUFSTS_TXEMPTY_Msk) >> UUART_BUFSTS_TXEMPTY_Pos) + + +/** + * @brief Check specified usci_uart port receiver is empty. + * + * @param[in] uuart The pointer of the specified USCI_UART module + * + * @retval 0 Rx receiver is not empty + * @retval 1 Rx receiver is empty + * + * @details This macro return Receive Empty Flag register bit value. \n + * It indicates if specified usci_uart port receiver is empty nor not. + * \hideinitializer + */ +#define UUART_IS_RX_EMPTY(uuart) (((uuart)->BUFSTS & UUART_BUFSTS_RXEMPTY_Msk) >> UUART_BUFSTS_RXEMPTY_Pos) + + +/** + * @brief Wait specified usci_uart port transmission is over + * + * @param[in] uuart The pointer of the specified USCI_UART module + * + * @return None + * + * @details This macro wait specified usci_uart port transmission is over. + * \hideinitializer + */ +#define UUART_WAIT_TX_EMPTY(uuart) while(!((((uuart)->BUFSTS) & UUART_BUFSTS_TXEMPTY_Msk) >> UUART_BUFSTS_TXEMPTY_Pos)) + + +/** + * @brief Check TX buffer is full or not + * + * @param[in] uuart The pointer of the specified USCI_UART module + * + * @retval 1 TX buffer is full + * @retval 0 TX buffer is not full + * + * @details This macro check TX buffer is full or not. + * \hideinitializer + */ +#define UUART_IS_TX_FULL(uuart) (((uuart)->BUFSTS & UUART_BUFSTS_TXFULL_Msk)>>UUART_BUFSTS_TXFULL_Pos) + + +/** + * @brief Check RX buffer is full or not + * + * @param[in] uuart The pointer of the specified USCI_UART module + * + * @retval 1 RX buffer is full + * @retval 0 RX buffer is not full + * + * @details This macro check RX buffer is full or not. + * \hideinitializer + */ +#define UUART_IS_RX_FULL(uuart) (((uuart)->BUFSTS & UUART_BUFSTS_RXFULL_Msk)>>UUART_BUFSTS_RXFULL_Pos) + + +/** + * @brief Get Tx full register value + * + * @param[in] uuart The pointer of the specified USCI_UART module + * + * @retval 0 Tx buffer is not full. + * @retval >=1 Tx buffer is full. + * + * @details This macro get Tx full register value. + * \hideinitializer + */ +#define UUART_GET_TX_FULL(uuart) ((uuart)->BUFSTS & UUART_BUFSTS_TXFULL_Msk) + + +/** + * @brief Get Rx full register value + * + * @param[in] uuart The pointer of the specified USCI_UART module + * + * @retval 0 Rx buffer is not full. + * @retval >=1 Rx buffer is full. + * + * @details This macro get Rx full register value. + * \hideinitializer + */ +#define UUART_GET_RX_FULL(uuart) ((uuart)->BUFSTS & UUART_BUFSTS_RXFULL_Msk) + + +/** + * @brief Enable specified USCI_UART protocol interrupt + * + * @param[in] uuart The pointer of the specified USCI_UART module + * @param[in] u32IntSel Interrupt type select + * - \ref UUART_PROTIEN_RLSIEN_Msk : Rx Line status interrupt + * - \ref UUART_PROTIEN_ABRIEN_Msk : Auto-baud rate interrupt + * + * @return None + * + * @details This macro enable specified USCI_UART protocol interrupt. + * \hideinitializer + */ +#define UUART_ENABLE_PROT_INT(uuart, u32IntSel) ((uuart)->PROTIEN |= (u32IntSel)) + + +/** + * @brief Disable specified USCI_UART protocol interrupt + * + * @param[in] uuart The pointer of the specified USCI_UART module + * @param[in] u32IntSel Interrupt type select + * - \ref UUART_PROTIEN_RLSIEN_Msk : Rx Line status interrupt + * - \ref UUART_PROTIEN_ABRIEN_Msk : Auto-baud rate interrupt + * + * @return None + * + * @details This macro disable specified USCI_UART protocol interrupt. + * \hideinitializer + */ +#define UUART_DISABLE_PROT_INT(uuart, u32IntSel) ((uuart)->PROTIEN &= ~(u32IntSel)) + + +/** + * @brief Enable specified USCI_UART buffer interrupt + * + * @param[in] uuart The pointer of the specified USCI_UART module + * @param[in] u32IntSel Interrupt type select + * - \ref UUART_BUFCTL_RXOVIEN_Msk : Receive buffer overrun error interrupt + * + * @return None + * + * @details This macro enable specified USCI_UART buffer interrupt. + * \hideinitializer + */ +#define UUART_ENABLE_BUF_INT(uuart, u32IntSel) ((uuart)->BUFCTL |= (u32IntSel)) + + +/** + * @brief Disable specified USCI_UART buffer interrupt + * + * @param[in] uuart The pointer of the specified USCI_UART module + * @param[in] u32IntSel Interrupt type select + * - \ref UUART_BUFCTL_RXOVIEN_Msk : Receive buffer overrun error interrupt + * + * @return None + * + * @details This macro disable specified USCI_UART buffer interrupt. + * \hideinitializer + */ +#define UUART_DISABLE_BUF_INT(uuart, u32IntSel) ((uuart)->BUFCTL &= ~ (u32IntSel)) + + +/** + * @brief Enable specified USCI_UART transfer interrupt + * + * @param[in] uuart The pointer of the specified USCI_UART module + * @param[in] u32IntSel Interrupt type select + * - \ref UUART_INTEN_RXENDIEN_Msk : Receive end interrupt + * - \ref UUART_INTEN_RXSTIEN_Msk : Receive start interrupt + * - \ref UUART_INTEN_TXENDIEN_Msk : Transmit end interrupt + * - \ref UUART_INTEN_TXSTIEN_Msk : Transmit start interrupt + * + * @return None + * + * @details This macro enable specified USCI_UART transfer interrupt. + * \hideinitializer + */ +#define UUART_ENABLE_TRANS_INT(uuart, u32IntSel) ((uuart)->INTEN |= (u32IntSel)) + + +/** + * @brief Disable specified USCI_UART transfer interrupt + * + * @param[in] uuart The pointer of the specified USCI_UART module + * @param[in] u32IntSel Interrupt type select + * - \ref UUART_INTEN_RXENDIEN_Msk : Receive end interrupt + * - \ref UUART_INTEN_RXSTIEN_Msk : Receive start interrupt + * - \ref UUART_INTEN_TXENDIEN_Msk : Transmit end interrupt + * - \ref UUART_INTEN_TXSTIEN_Msk : Transmit start interrupt + * + * @return None + * + * @details This macro disable specified USCI_UART transfer interrupt. + * \hideinitializer + */ +#define UUART_DISABLE_TRANS_INT(uuart, u32IntSel) ((uuart)->INTEN &= ~(u32IntSel)) + + +/** + * @brief Get protocol interrupt flag/status + * + * @param[in] uuart The pointer of the specified USCI_UART module + * + * @return The interrupt flag/status of protocol status register. + * + * @details This macro get protocol status register value. + * \hideinitializer + */ +#define UUART_GET_PROT_STATUS(uuart) ((uuart)->PROTSTS) + + +/** + * @brief Clear specified protocol interrupt flag + * + * @param[in] uuart The pointer of the specified USCI_UART module + * @param[in] u32IntTypeFlag Interrupt Type Flag, should be + * - \ref UUART_PROTSTS_ABERRSTS_Msk : Auto-baud Rate Error Interrupt Indicator + * - \ref UUART_PROTSTS_ABRDETIF_Msk : Auto-baud Rate Detected Interrupt Flag + * - \ref UUART_PROTSTS_BREAK_Msk : Break Flag + * - \ref UUART_PROTSTS_FRMERR_Msk : Framing Error Flag + * - \ref UUART_PROTSTS_PARITYERR_Msk : Parity Error Flag + * - \ref UUART_PROTSTS_RXENDIF_Msk : Receive End Interrupt Flag + * - \ref UUART_PROTSTS_RXSTIF_Msk : Receive Start Interrupt Flag + * - \ref UUART_PROTSTS_TXENDIF_Msk : Transmit End Interrupt Flag + * - \ref UUART_PROTSTS_TXSTIF_Msk : Transmit Start Interrupt Flag + * + * @return None + * + * @details This macro clear specified protocol interrupt flag. + * \hideinitializer + */ +#define UUART_CLR_PROT_INT_FLAG(uuart,u32IntTypeFlag) ((uuart)->PROTSTS = (u32IntTypeFlag)) + + +/** + * @brief Get transmit/receive buffer interrupt flag/status + * + * @param[in] uuart The pointer of the specified USCI_UART module + * + * @return The interrupt flag/status of buffer status register. + * + * @details This macro get buffer status register value. + * \hideinitializer + */ +#define UUART_GET_BUF_STATUS(uuart) ((uuart)->BUFSTS) + + +/** + * @brief Clear specified buffer interrupt flag + * + * @param[in] uuart The pointer of the specified USCI_UART module + * @param[in] u32IntTypeFlag Interrupt Type Flag, should be + * - \ref UUART_BUFSTS_RXOVIF_Msk : Receive Buffer Over-run Error Interrupt Indicator + * + * @return None + * + * @details This macro clear specified buffer interrupt flag. + * \hideinitializer + */ +#define UUART_CLR_BUF_INT_FLAG(uuart,u32IntTypeFlag) ((uuart)->BUFSTS = (u32IntTypeFlag)) + + +/** + * @brief Get wakeup flag + * + * @param[in] uuart The pointer of the specified USCI_UART module + * + * @retval 0 Chip did not wake up from power-down mode. + * @retval 1 Chip waked up from power-down mode. + * + * @details This macro get wakeup flag. + * \hideinitializer + */ +#define UUART_GET_WAKEUP_FLAG(uuart) ((uuart)->WKSTS & UUART_WKSTS_WKF_Msk ? 1: 0 ) + + +/** + * @brief Clear wakeup flag + * + * @param[in] uuart The pointer of the specified USCI_UART module + * + * @return None + * + * @details This macro clear wakeup flag. + * \hideinitializer + */ +#define UUART_CLR_WAKEUP_FLAG(uuart) ((uuart)->WKSTS = UUART_WKSTS_WKF_Msk) + +/** + * @brief Enable specified USCI_UART PDMA function + * + * @param[in] uuart The pointer of the specified USCI_UART module + * @param[in] u32FuncSel Combination of following functions + * - \ref UUART_PDMACTL_TXPDMAEN_Msk + * - \ref UUART_PDMACTL_RXPDMAEN_Msk + * - \ref UUART_PDMACTL_PDMAEN_Msk + * + * @return None + * + * \hideinitializer + */ +#define UUART_PDMA_ENABLE(uuart, u32FuncSel) ((uuart)->PDMACTL |= (u32FuncSel)) + +/** + * @brief Disable specified USCI_UART PDMA function + * + * @param[in] uuart The pointer of the specified USCI_UART module + * @param[in] u32FuncSel Combination of following functions + * - \ref UUART_PDMACTL_TXPDMAEN_Msk + * - \ref UUART_PDMACTL_RXPDMAEN_Msk + * - \ref UUART_PDMACTL_PDMAEN_Msk + * + * @return None + * + * \hideinitializer + */ +#define UUART_PDMA_DISABLE(uuart, u32FuncSel) ((uuart)->PDMACTL &= ~(u32FuncSel)) + + + + +void UUART_ClearIntFlag(UUART_T* uuart, uint32_t u32Mask); +uint32_t UUART_GetIntFlag(UUART_T* uuart, uint32_t u32Mask); +void UUART_Close(UUART_T* uuart); +void UUART_DisableInt(UUART_T* uuart, uint32_t u32Mask); +void UUART_EnableInt(UUART_T* uuart, uint32_t u32Mask); +uint32_t UUART_Open(UUART_T* uuart, uint32_t u32baudrate); +uint32_t UUART_Read(UUART_T* uuart, uint8_t pu8RxBuf[], uint32_t u32ReadBytes); +uint32_t UUART_SetLine_Config(UUART_T* uuart, uint32_t u32baudrate, uint32_t u32data_width, uint32_t u32parity, uint32_t u32stop_bits); +uint32_t UUART_Write(UUART_T* uuart, uint8_t pu8TxBuf[], uint32_t u32WriteBytes); +void UUART_EnableWakeup(UUART_T* uuart, uint32_t u32WakeupMode); +void UUART_DisableWakeup(UUART_T* uuart); +void UUART_EnableFlowCtrl(UUART_T* uuart); +void UUART_DisableFlowCtrl(UUART_T* uuart); + + +/*@}*/ /* end of group USCI_UART_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group USCI_UART_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_USCI_UART_H__ */ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_wdt.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_wdt.h new file mode 100644 index 00000000000..634d73f8028 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_wdt.h @@ -0,0 +1,216 @@ +/**************************************************************************//** + * @file nu_wdt.h + * @version V3.00 + * @brief M480 series WDT driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __NU_WDT_H__ +#define __NU_WDT_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup WDT_Driver WDT Driver + @{ +*/ + +/** @addtogroup WDT_EXPORTED_CONSTANTS WDT Exported Constants + @{ +*/ +/*---------------------------------------------------------------------------------------------------------*/ +/* WDT Time-out Interval Period Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define WDT_TIMEOUT_2POW4 (0UL << WDT_CTL_TOUTSEL_Pos) /*!< Setting WDT time-out interval to 2^4 * WDT clocks \hideinitializer */ +#define WDT_TIMEOUT_2POW6 (1UL << WDT_CTL_TOUTSEL_Pos) /*!< Setting WDT time-out interval to 2^6 * WDT clocks \hideinitializer */ +#define WDT_TIMEOUT_2POW8 (2UL << WDT_CTL_TOUTSEL_Pos) /*!< Setting WDT time-out interval to 2^8 * WDT clocks \hideinitializer */ +#define WDT_TIMEOUT_2POW10 (3UL << WDT_CTL_TOUTSEL_Pos) /*!< Setting WDT time-out interval to 2^10 * WDT clocks \hideinitializer */ +#define WDT_TIMEOUT_2POW12 (4UL << WDT_CTL_TOUTSEL_Pos) /*!< Setting WDT time-out interval to 2^12 * WDT clocks \hideinitializer */ +#define WDT_TIMEOUT_2POW14 (5UL << WDT_CTL_TOUTSEL_Pos) /*!< Setting WDT time-out interval to 2^14 * WDT clocks \hideinitializer */ +#define WDT_TIMEOUT_2POW16 (6UL << WDT_CTL_TOUTSEL_Pos) /*!< Setting WDT time-out interval to 2^16 * WDT clocks \hideinitializer */ +#define WDT_TIMEOUT_2POW18 (7UL << WDT_CTL_TOUTSEL_Pos) /*!< Setting WDT time-out interval to 2^18 * WDT clocks \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* WDT Reset Delay Period Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define WDT_RESET_DELAY_1026CLK (0UL << WDT_ALTCTL_RSTDSEL_Pos) /*!< Setting WDT reset delay period to 1026 * WDT clocks \hideinitializer */ +#define WDT_RESET_DELAY_130CLK (1UL << WDT_ALTCTL_RSTDSEL_Pos) /*!< Setting WDT reset delay period to 130 * WDT clocks \hideinitializer */ +#define WDT_RESET_DELAY_18CLK (2UL << WDT_ALTCTL_RSTDSEL_Pos) /*!< Setting WDT reset delay period to 18 * WDT clocks \hideinitializer */ +#define WDT_RESET_DELAY_3CLK (3UL << WDT_ALTCTL_RSTDSEL_Pos) /*!< Setting WDT reset delay period to 3 * WDT clocks \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* WDT Free Reset Counter Keyword Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define WDT_RESET_COUNTER_KEYWORD (0x00005AA5UL) /*!< Fill this value to WDT_RSTCNT register to free reset WDT counter \hideinitializer */ + +/*@}*/ /* end of group WDT_EXPORTED_CONSTANTS */ + + +/** @addtogroup WDT_EXPORTED_FUNCTIONS WDT Exported Functions + @{ +*/ + +/** + * @brief Clear WDT Reset System Flag + * + * @param None + * + * @return None + * + * @details This macro clears WDT time-out reset system flag. + * \hideinitializer + */ +#define WDT_CLEAR_RESET_FLAG() (WDT->CTL = (WDT->CTL & ~(WDT_CTL_IF_Msk | WDT_CTL_WKF_Msk)) | WDT_CTL_RSTF_Msk) + +/** + * @brief Clear WDT Time-out Interrupt Flag + * + * @param None + * + * @return None + * + * @details This macro clears WDT time-out interrupt flag. + * \hideinitializer + */ +#define WDT_CLEAR_TIMEOUT_INT_FLAG() (WDT->CTL = (WDT->CTL & ~(WDT_CTL_RSTF_Msk | WDT_CTL_WKF_Msk)) | WDT_CTL_IF_Msk) + +/** + * @brief Clear WDT Wake-up Flag + * + * @param None + * + * @return None + * + * @details This macro clears WDT time-out wake-up system flag. + * \hideinitializer + */ +#define WDT_CLEAR_TIMEOUT_WAKEUP_FLAG() (WDT->CTL = (WDT->CTL & ~(WDT_CTL_RSTF_Msk | WDT_CTL_IF_Msk)) | WDT_CTL_WKF_Msk) + +/** + * @brief Get WDT Time-out Reset Flag + * + * @param None + * + * @retval 0 WDT time-out reset system did not occur + * @retval 1 WDT time-out reset system occurred + * + * @details This macro indicates system has been reset by WDT time-out reset or not. + * \hideinitializer + */ +#define WDT_GET_RESET_FLAG() ((WDT->CTL & WDT_CTL_RSTF_Msk)? 1UL : 0UL) + +/** + * @brief Get WDT Time-out Interrupt Flag + * + * @param None + * + * @retval 0 WDT time-out interrupt did not occur + * @retval 1 WDT time-out interrupt occurred + * + * @details This macro indicates WDT time-out interrupt occurred or not. + * \hideinitializer + */ +#define WDT_GET_TIMEOUT_INT_FLAG() ((WDT->CTL & WDT_CTL_IF_Msk)? 1UL : 0UL) + +/** + * @brief Get WDT Time-out Wake-up Flag + * + * @param None + * + * @retval 0 WDT time-out interrupt does not cause CPU wake-up + * @retval 1 WDT time-out interrupt event cause CPU wake-up + * + * @details This macro indicates WDT time-out interrupt event has waked up system or not. + * \hideinitializer + */ +#define WDT_GET_TIMEOUT_WAKEUP_FLAG() ((WDT->CTL & WDT_CTL_WKF_Msk)? 1UL : 0UL) + +/** + * @brief Reset WDT Counter + * + * @param None + * + * @return None + * + * @details This macro is used to reset the internal 18-bit WDT up counter value. + * @note If WDT is activated and time-out reset system function is enabled also, user should \n + * reset the 18-bit WDT up counter value to avoid generate WDT time-out reset signal to \n + * reset system before the WDT time-out reset delay period expires. + * \hideinitializer + */ +#define WDT_RESET_COUNTER() (WDT->RSTCNT = WDT_RESET_COUNTER_KEYWORD) + +/* Declare these inline functions here to avoid MISRA C 2004 rule 8.1 error */ +__STATIC_INLINE void WDT_Close(void); +__STATIC_INLINE void WDT_EnableInt(void); +__STATIC_INLINE void WDT_DisableInt(void); + +/** + * @brief Stop WDT Counting + * + * @param None + * + * @return None + * + * @details This function will stop WDT counting and disable WDT module. + */ +__STATIC_INLINE void WDT_Close(void) +{ + WDT->CTL = 0UL; + return; +} + +/** + * @brief Enable WDT Time-out Interrupt + * + * @param None + * + * @return None + * + * @details This function will enable the WDT time-out interrupt function. + */ +__STATIC_INLINE void WDT_EnableInt(void) +{ + WDT->CTL |= WDT_CTL_INTEN_Msk; + return; +} + +/** + * @brief Disable WDT Time-out Interrupt + * + * @param None + * + * @return None + * + * @details This function will disable the WDT time-out interrupt function. + */ +__STATIC_INLINE void WDT_DisableInt(void) +{ + /* Do not touch another write 1 clear bits */ + WDT->CTL &= ~(WDT_CTL_INTEN_Msk | WDT_CTL_RSTF_Msk | WDT_CTL_IF_Msk | WDT_CTL_WKF_Msk); + return; +} + +void WDT_Open(uint32_t u32TimeoutInterval, uint32_t u32ResetDelay, uint32_t u32EnableReset, uint32_t u32EnableWakeup); + +/*@}*/ /* end of group WDT_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group WDT_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_WDT_H__ */ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_wwdt.h b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_wwdt.h new file mode 100644 index 00000000000..a15ae1446b2 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/inc/nu_wwdt.h @@ -0,0 +1,152 @@ +/**************************************************************************//** + * @file nu_wwdt.h + * @version V3.00 + * @brief M480 series WWDT driver header file + * + * SPDX-License-Identifier: Apache-2.0 + * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved. + *****************************************************************************/ +#ifndef __NU_WWDT_H__ +#define __NU_WWDT_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +/** @addtogroup Standard_Driver Standard Driver + @{ +*/ + +/** @addtogroup WWDT_Driver WWDT Driver + @{ +*/ + +/** @addtogroup WWDT_EXPORTED_CONSTANTS WWDT Exported Constants + @{ +*/ +/*---------------------------------------------------------------------------------------------------------*/ +/* WWDT Prescale Period Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define WWDT_PRESCALER_1 (0 << WWDT_CTL_PSCSEL_Pos) /*!< Select max time-out period to 1 * (64*WWDT_CLK) \hideinitializer */ +#define WWDT_PRESCALER_2 (1 << WWDT_CTL_PSCSEL_Pos) /*!< Select max time-out period to 2 * (64*WWDT_CLK) \hideinitializer */ +#define WWDT_PRESCALER_4 (2 << WWDT_CTL_PSCSEL_Pos) /*!< Select max time-out period to 4 * (64*WWDT_CLK) \hideinitializer */ +#define WWDT_PRESCALER_8 (3 << WWDT_CTL_PSCSEL_Pos) /*!< Select max time-out period to 8 * (64*WWDT_CLK) \hideinitializer */ +#define WWDT_PRESCALER_16 (4 << WWDT_CTL_PSCSEL_Pos) /*!< Select max time-out period to 16 * (64*WWDT_CLK) \hideinitializer */ +#define WWDT_PRESCALER_32 (5 << WWDT_CTL_PSCSEL_Pos) /*!< Select max time-out period to 32 * (64*WWDT_CLK) \hideinitializer */ +#define WWDT_PRESCALER_64 (6 << WWDT_CTL_PSCSEL_Pos) /*!< Select max time-out period to 64 * (64*WWDT_CLK) \hideinitializer */ +#define WWDT_PRESCALER_128 (7 << WWDT_CTL_PSCSEL_Pos) /*!< Select max time-out period to 128 * (64*WWDT_CLK) \hideinitializer */ +#define WWDT_PRESCALER_192 (8 << WWDT_CTL_PSCSEL_Pos) /*!< Select max time-out period to 192 * (64*WWDT_CLK) \hideinitializer */ +#define WWDT_PRESCALER_256 (9 << WWDT_CTL_PSCSEL_Pos) /*!< Select max time-out period to 256 * (64*WWDT_CLK) \hideinitializer */ +#define WWDT_PRESCALER_384 (10 << WWDT_CTL_PSCSEL_Pos) /*!< Select max time-out period to 384 * (64*WWDT_CLK) \hideinitializer */ +#define WWDT_PRESCALER_512 (11 << WWDT_CTL_PSCSEL_Pos) /*!< Select max time-out period to 512 * (64*WWDT_CLK) \hideinitializer */ +#define WWDT_PRESCALER_768 (12 << WWDT_CTL_PSCSEL_Pos) /*!< Select max time-out period to 768 * (64*WWDT_CLK) \hideinitializer */ +#define WWDT_PRESCALER_1024 (13 << WWDT_CTL_PSCSEL_Pos) /*!< Select max time-out period to 1024 * (64*WWDT_CLK) \hideinitializer */ +#define WWDT_PRESCALER_1536 (14 << WWDT_CTL_PSCSEL_Pos) /*!< Select max time-out period to 1536 * (64*WWDT_CLK) \hideinitializer */ +#define WWDT_PRESCALER_2048 (15 << WWDT_CTL_PSCSEL_Pos) /*!< Select max time-out period to 2048 * (64*WWDT_CLK) \hideinitializer */ + +/*---------------------------------------------------------------------------------------------------------*/ +/* WWDT Reload Counter Keyword Constant Definitions */ +/*---------------------------------------------------------------------------------------------------------*/ +#define WWDT_RELOAD_WORD (0x00005AA5) /*!< Fill this value to WWDT_RLDCNT register to reload WWDT counter \hideinitializer */ + +/*@}*/ /* end of group WWDT_EXPORTED_CONSTANTS */ + + +/** @addtogroup WWDT_EXPORTED_FUNCTIONS WWDT Exported Functions + @{ +*/ + +/** + * @brief Clear WWDT Reset System Flag + * + * @param None + * + * @return None + * + * @details This macro is used to clear WWDT time-out reset system flag. + * \hideinitializer + */ +#define WWDT_CLEAR_RESET_FLAG() (WWDT->STATUS = WWDT_STATUS_WWDTRF_Msk) + +/** + * @brief Clear WWDT Compared Match Interrupt Flag + * + * @param None + * + * @return None + * + * @details This macro is used to clear WWDT compared match interrupt flag. + * \hideinitializer + */ +#define WWDT_CLEAR_INT_FLAG() (WWDT->STATUS = WWDT_STATUS_WWDTIF_Msk) + +/** + * @brief Get WWDT Reset System Flag + * + * @param None + * + * @retval 0 WWDT time-out reset system did not occur + * @retval 1 WWDT time-out reset system occurred + * + * @details This macro is used to indicate system has been reset by WWDT time-out reset or not. + * \hideinitializer + */ +#define WWDT_GET_RESET_FLAG() ((WWDT->STATUS & WWDT_STATUS_WWDTRF_Msk)? 1 : 0) + +/** + * @brief Get WWDT Compared Match Interrupt Flag + * + * @param None + * + * @retval 0 WWDT compare match interrupt did not occur + * @retval 1 WWDT compare match interrupt occurred + * + * @details This macro is used to indicate WWDT counter value matches CMPDAT value or not. + * \hideinitializer + */ +#define WWDT_GET_INT_FLAG() ((WWDT->STATUS & WWDT_STATUS_WWDTIF_Msk)? 1 : 0) + +/** + * @brief Get WWDT Counter + * + * @param None + * + * @return WWDT Counter Value + * + * @details This macro reflects the current WWDT counter value. + * \hideinitializer + */ +#define WWDT_GET_COUNTER() (WWDT->CNT) + +/** + * @brief Reload WWDT Counter + * + * @param None + * + * @return None + * + * @details This macro is used to reload the WWDT counter value to 0x3F. + * @note User can only write WWDT_RLDCNT register to reload WWDT counter value when current WWDT counter value \n + * between 0 and CMPDAT value. If user writes WWDT_RLDCNT when current WWDT counter value is larger than CMPDAT, \n + * WWDT reset signal will generate immediately to reset system. + * \hideinitializer + */ +#define WWDT_RELOAD_COUNTER() (WWDT->RLDCNT = WWDT_RELOAD_WORD) + +void WWDT_Open(uint32_t u32PreScale, uint32_t u32CmpValue, uint32_t u32EnableInt); + +/*@}*/ /* end of group WWDT_EXPORTED_FUNCTIONS */ + +/*@}*/ /* end of group WWDT_Driver */ + +/*@}*/ /* end of group Standard_Driver */ + +#ifdef __cplusplus +} +#endif + +#endif /* __NU_WWDT_H__ */ + +/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ diff --git a/bsp/nuvoton/libraries/m480/StdDriver/lib/libStdDriver.ewd b/bsp/nuvoton/libraries/m480/StdDriver/lib/libStdDriver.ewd new file mode 100644 index 00000000000..4990af44b47 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/lib/libStdDriver.ewd @@ -0,0 +1,3285 @@ + + + + 2 + + Debug + + ARM + + 1 + + C-SPY + 2 + + 28 + 1 + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ARMSIM_ID + 2 + + 1 + 1 + 1 + + + + + + + + ANGEL_ID + 2 + + 0 + 1 + 1 + + + + + + + + + + + + CADI_ID + 2 + + 0 + 1 + 1 + + + + + + + + + CMSISDAP_ID + 2 + + 4 + 1 + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + GDBSERVER_ID + 2 + + 0 + 1 + 1 + + + + + + + + + + + IARROM_ID + 2 + + 1 + 1 + 1 + + + + + + + + + IJET_ID + 2 + + 8 + 1 + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + JLINK_ID + 2 + + 16 + 1 + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + LMIFTDI_ID + 2 + + 2 + 1 + 1 + + + + + + + + + + MACRAIGOR_ID + 2 + + 3 + 1 + 1 + + + + + + + + + + + + + + + + + + + + + + + PEMICRO_ID + 2 + + 3 + 1 + 1 + + + + + + + + RDI_ID + 2 + + 2 + 1 + 1 + + + + + + + + + + + + + + + + STLINK_ID + 2 + + 3 + 1 + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + THIRDPARTY_ID + 2 + + 0 + 1 + 1 + + + + + + + + TIFET_ID + 2 + + 1 + 1 + 1 + + + + + + + + + + + + + + + + + + + XDS100_ID + 2 + + 6 + 1 + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + $TOOLKIT_DIR$\plugins\middleware\HCCWare\HCCWare.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\middleware\PercepioTraceExporter\PercepioTraceExportPlugin.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\AVIX\AVIX.ENU.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\CMX\CmxArmPlugin.ENU.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\CMX\CmxTinyArmPlugin.ENU.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\embOS\embOSPlugin.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\MQX\MQXRtosPlugin.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\OpenRTOS\OpenRTOSPlugin.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\Quadros\Quadros_EWB7_Plugin.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\SafeRTOS\SafeRTOSPlugin.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\ThreadX\ThreadXArmPlugin.ENU.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\TI-RTOS\tirtosplugin.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\uCOS-II\uCOS-II-286-KA-CSpy.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\uCOS-II\uCOS-II-KA-CSpy.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\uCOS-III\uCOS-III-KA-CSpy.ewplugin + 0 + + + $EW_DIR$\common\plugins\CodeCoverage\CodeCoverage.ENU.ewplugin + 1 + + + $EW_DIR$\common\plugins\Orti\Orti.ENU.ewplugin + 0 + + + $EW_DIR$\common\plugins\uCProbe\uCProbePlugin.ENU.ewplugin + 0 + + + + + Release + + ARM + + 0 + + C-SPY + 2 + + 28 + 1 + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ARMSIM_ID + 2 + + 1 + 1 + 0 + + + + + + + + ANGEL_ID + 2 + + 0 + 1 + 0 + + + + + + + + + + + + CADI_ID + 2 + + 0 + 1 + 0 + + + + + + + + + CMSISDAP_ID + 2 + + 4 + 1 + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + GDBSERVER_ID + 2 + + 0 + 1 + 0 + + + + + + + + + + + IARROM_ID + 2 + + 1 + 1 + 0 + + + + + + + + + IJET_ID + 2 + + 8 + 1 + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + JLINK_ID + 2 + + 16 + 1 + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + LMIFTDI_ID + 2 + + 2 + 1 + 0 + + + + + + + + + + MACRAIGOR_ID + 2 + + 3 + 1 + 0 + + + + + + + + + + + + + + + + + + + + + + + PEMICRO_ID + 2 + + 3 + 1 + 0 + + + + + + + + RDI_ID + 2 + + 2 + 1 + 0 + + + + + + + + + + + + + + + + STLINK_ID + 2 + + 3 + 1 + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + THIRDPARTY_ID + 2 + + 0 + 1 + 0 + + + + + + + + TIFET_ID + 2 + + 1 + 1 + 0 + + + + + + + + + + + + + + + + + + + XDS100_ID + 2 + + 6 + 1 + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + $TOOLKIT_DIR$\plugins\middleware\HCCWare\HCCWare.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\middleware\PercepioTraceExporter\PercepioTraceExportPlugin.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\AVIX\AVIX.ENU.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\CMX\CmxArmPlugin.ENU.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\CMX\CmxTinyArmPlugin.ENU.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\embOS\embOSPlugin.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\MQX\MQXRtosPlugin.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\OpenRTOS\OpenRTOSPlugin.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\Quadros\Quadros_EWB7_Plugin.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\SafeRTOS\SafeRTOSPlugin.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\ThreadX\ThreadXArmPlugin.ENU.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\TI-RTOS\tirtosplugin.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\uCOS-II\uCOS-II-286-KA-CSpy.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\uCOS-II\uCOS-II-KA-CSpy.ewplugin + 0 + + + $TOOLKIT_DIR$\plugins\rtos\uCOS-III\uCOS-III-KA-CSpy.ewplugin + 0 + + + $EW_DIR$\common\plugins\CodeCoverage\CodeCoverage.ENU.ewplugin + 1 + + + $EW_DIR$\common\plugins\Orti\Orti.ENU.ewplugin + 0 + + + $EW_DIR$\common\plugins\uCProbe\uCProbePlugin.ENU.ewplugin + 0 + + + + + + diff --git a/bsp/nuvoton/libraries/m480/StdDriver/lib/libStdDriver.ewp b/bsp/nuvoton/libraries/m480/StdDriver/lib/libStdDriver.ewp new file mode 100644 index 00000000000..8759c80add9 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/lib/libStdDriver.ewp @@ -0,0 +1,2197 @@ + + + 3 + + Debug + + ARM + + 1 + + General + 3 + + 31 + 1 + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ICCARM + 2 + + 35 + 1 + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + AARM + 2 + + 10 + 1 + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + OBJCOPY + 0 + + 1 + 1 + 1 + + + + + + + + + CUSTOM + 3 + + + + 0 + + + + BICOMP + 0 + + + + BUILDACTION + 1 + + + + + + + ILINK + 0 + + 22 + 1 + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + IARCHIVE + 0 + + 0 + 1 + 1 + + + + + + + BILINK + 0 + + + + + Release + + ARM + + 0 + + General + 3 + + 31 + 1 + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ICCARM + 2 + + 35 + 1 + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + AARM + 2 + + 10 + 1 + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + OBJCOPY + 0 + + 1 + 1 + 0 + + + + + + + + + CUSTOM + 3 + + + + 0 + + + + BICOMP + 0 + + + + BUILDACTION + 1 + + + + + + + ILINK + 0 + + 22 + 1 + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + IARCHIVE + 0 + + 0 + 1 + 0 + + + + + + + BILINK + 0 + + + + + src + + $PROJ_DIR$\..\src\nu_acmp.c + + + $PROJ_DIR$\..\src\nu_bpwm.c + + + $PROJ_DIR$\..\src\nu_can.c + + + $PROJ_DIR$\..\src\nu_ccap.c + + + $PROJ_DIR$\..\src\nu_clk.c + + + $PROJ_DIR$\..\src\nu_crc.c + + + $PROJ_DIR$\..\src\nu_crypto.c + + + $PROJ_DIR$\..\src\nu_dac.c + + + $PROJ_DIR$\..\src\nu_eadc.c + + + $PROJ_DIR$\..\src\nu_ebi.c + + + $PROJ_DIR$\..\src\nu_ecap.c + + + $PROJ_DIR$\..\src\nu_emac.c + + + $PROJ_DIR$\..\src\nu_epwm.c + + + $PROJ_DIR$\..\src\nu_fmc.c + + + $PROJ_DIR$\..\src\nu_gpio.c + + + $PROJ_DIR$\..\src\nu_hsusbd.c + + + $PROJ_DIR$\..\src\nu_i2c.c + + + $PROJ_DIR$\..\src\nu_i2s.c + + + $PROJ_DIR$\..\src\nu_pdma.c + + + $PROJ_DIR$\..\src\nu_qei.c + + + $PROJ_DIR$\..\src\nu_qspi.c + + + $PROJ_DIR$\..\src\nu_rtc.c + + + $PROJ_DIR$\..\src\nu_sc.c + + + $PROJ_DIR$\..\src\nu_scuart.c + + + $PROJ_DIR$\..\src\nu_sdh.c + + + $PROJ_DIR$\..\src\nu_spi.c + + + $PROJ_DIR$\..\src\nu_spim.c + + + $PROJ_DIR$\..\src\nu_sys.c + + + $PROJ_DIR$\..\src\nu_timer.c + + + $PROJ_DIR$\..\src\nu_timer_pwm.c + + + $PROJ_DIR$\..\src\nu_trng.c + + + $PROJ_DIR$\..\src\nu_uart.c + + + $PROJ_DIR$\..\src\nu_usbd.c + + + $PROJ_DIR$\..\src\nu_usci_i2c.c + + + $PROJ_DIR$\..\src\nu_usci_spi.c + + + $PROJ_DIR$\..\src\nu_usci_uart.c + + + $PROJ_DIR$\..\src\nu_wdt.c + + + $PROJ_DIR$\..\src\nu_wwdt.c + + + diff --git a/bsp/nuvoton/libraries/m480/StdDriver/lib/libStdDriver.eww b/bsp/nuvoton/libraries/m480/StdDriver/lib/libStdDriver.eww new file mode 100644 index 00000000000..fcdfcdfe308 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/lib/libStdDriver.eww @@ -0,0 +1,10 @@ + + + + + $WS_DIR$\libStdDriver.ewp + + + + + diff --git a/bsp/nuvoton/libraries/m480/StdDriver/lib/libStdDriver.uvprojx b/bsp/nuvoton/libraries/m480/StdDriver/lib/libStdDriver.uvprojx new file mode 100644 index 00000000000..c447d034e0a --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/lib/libStdDriver.uvprojx @@ -0,0 +1,587 @@ + + + + 2.1 + +
### uVision Project, (C) Keil Software
+ + + + libstddriver-m480 + 0x4 + ARM-ADS + 5060750::V5.06 update 6 (build 750)::ARMCC + 0 + + + M487JIDAE + Nuvoton + Nuvoton.NuMicro_DFP.1.3.9 + http://www.nuvoton.com/hq/enu/Documents/KEILSoftwarePack + IRAM(0x20000000,0x28000) IROM(0x00000000,0x80000) CPUTYPE("Cortex-M4") FPU2 CLOCK(12000000) + + + UL2CM3(-S0 -C0 -P0 -FD20000000 -FC1000 -FN1 -FF0M481_AP_512 -FS00 -FL080000 -FP0($$Device:M487JIDAE$Flash\M481_AP_512.FLM)) + 0 + $$Device:M487JIDAE$Device\M480\Include\M480.h + + + + + + + + + + $$Device:M487JIDAE$SVD\Nuvoton\M481_v1.svd + 0 + 0 + + + + + + + 0 + 0 + 0 + 0 + 1 + + .\build\keil5\ + libstddriver_keil + 0 + 1 + 1 + 1 + 1 + .\build\keil5\ + 1 + 0 + 0 + + 0 + 0 + + + 0 + 0 + 0 + 0 + + + 0 + 0 + + + 0 + 0 + 0 + 0 + + + 1 + 0 + xcopy /y ".\build\keil5\@L.lib" "." + + 0 + 0 + 0 + 0 + + 1 + + + + 0 + 0 + 0 + 0 + 0 + 1 + 0 + 0 + 0 + 0 + 3 + + + 1 + + + SARMCM3.DLL + + DCM.DLL + -pCM4 + SARMCM3.DLL + + TCM.DLL + -pCM4 + + + + 1 + 0 + 0 + 0 + 16 + + + + + 1 + 0 + 0 + 1 + 1 + 4096 + + 1 + BIN\UL2CM3.DLL + "" () + + + + + 0 + + + + 0 + 1 + 1 + 1 + 1 + 1 + 1 + 1 + 0 + 1 + 1 + 0 + 1 + 1 + 0 + 0 + 1 + 1 + 1 + 1 + 1 + 1 + 1 + 1 + 1 + 0 + 0 + "Cortex-M4" + + 0 + 0 + 0 + 1 + 1 + 0 + 0 + 2 + 0 + 0 + 0 + 8 + 1 + 0 + 0 + 0 + 3 + 3 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 1 + 0 + 0 + 0 + 0 + 1 + 0 + + + 0 + 0x0 + 0x0 + + + 0 + 0x0 + 0x0 + + + 0 + 0x0 + 0x0 + + + 0 + 0x0 + 0x0 + + + 0 + 0x0 + 0x0 + + + 0 + 0x0 + 0x0 + + + 0 + 0x20000000 + 0x28000 + + + 1 + 0x0 + 0x80000 + + + 0 + 0x0 + 0x0 + + + 1 + 0x0 + 0x0 + + + 1 + 0x0 + 0x0 + + + 1 + 0x0 + 0x0 + + + 1 + 0x0 + 0x80000 + + + 1 + 0x0 + 0x0 + + + 0 + 0x0 + 0x0 + + + 0 + 0x0 + 0x0 + + + 0 + 0x0 + 0x0 + + + 0 + 0x20000000 + 0x28000 + + + 0 + 0x0 + 0x0 + + + + + + 1 + 1 + 0 + 0 + 1 + 0 + 0 + 0 + 0 + 0 + 1 + 0 + 0 + 0 + 0 + 0 + 5 + 3 + 0 + 0 + 0 + 1 + 0 + + + + + ..\inc;..\lib;..\..\CMSIS\Include;..\..\Device\Nuvoton\M480\Include + + + + 1 + 0 + 0 + 1 + 0 + 0 + 1 + 0 + 0 + 0 + + + + + + + + + 0 + 0 + 0 + 0 + 1 + 0 + 0x00000000 + 0x20000000 + + + + + + + + + + + + + src + + + nu_acmp.c + 1 + ..\src\nu_acmp.c + + + nu_bpwm.c + 1 + ..\src\nu_bpwm.c + + + nu_can.c + 1 + ..\src\nu_can.c + + + nu_ccap.c + 1 + ..\src\nu_ccap.c + + + nu_clk.c + 1 + ..\src\nu_clk.c + + + nu_crc.c + 1 + ..\src\nu_crc.c + + + nu_crypto.c + 1 + ..\src\nu_crypto.c + + + nu_dac.c + 1 + ..\src\nu_dac.c + + + nu_eadc.c + 1 + ..\src\nu_eadc.c + + + nu_ebi.c + 1 + ..\src\nu_ebi.c + + + nu_ecap.c + 1 + ..\src\nu_ecap.c + + + nu_emac.c + 1 + ..\src\nu_emac.c + + + nu_epwm.c + 1 + ..\src\nu_epwm.c + + + nu_fmc.c + 1 + ..\src\nu_fmc.c + + + nu_gpio.c + 1 + ..\src\nu_gpio.c + + + nu_hsusbd.c + 1 + ..\src\nu_hsusbd.c + + + nu_i2c.c + 1 + ..\src\nu_i2c.c + + + nu_i2s.c + 1 + ..\src\nu_i2s.c + + + nu_pdma.c + 1 + ..\src\nu_pdma.c + + + nu_qei.c + 1 + ..\src\nu_qei.c + + + nu_qspi.c + 1 + ..\src\nu_qspi.c + + + nu_rtc.c + 1 + ..\src\nu_rtc.c + + + nu_sc.c + 1 + ..\src\nu_sc.c + + + nu_scuart.c + 1 + ..\src\nu_scuart.c + + + nu_sdh.c + 1 + ..\src\nu_sdh.c + + + nu_spi.c + 1 + ..\src\nu_spi.c + + + nu_spim.c + 1 + ..\src\nu_spim.c + + + nu_sys.c + 1 + ..\src\nu_sys.c + + + nu_timer.c + 1 + ..\src\nu_timer.c + + + nu_timer_pwm.c + 1 + ..\src\nu_timer_pwm.c + + + nu_trng.c + 1 + ..\src\nu_trng.c + + + nu_uart.c + 1 + ..\src\nu_uart.c + + + nu_usbd.c + 1 + ..\src\nu_usbd.c + + + nu_usci_i2c.c + 1 + ..\src\nu_usci_i2c.c + + + nu_usci_spi.c + 1 + ..\src\nu_usci_spi.c + + + nu_usci_uart.c + 1 + ..\src\nu_usci_uart.c + + + nu_wdt.c + 1 + ..\src\nu_wdt.c + + + nu_wwdt.c + 1 + ..\src\nu_wwdt.c + + + + + + + + + + + + + +
diff --git a/bsp/nuvoton/libraries/m480/StdDriver/lib/libStdDriver_4.uvproj b/bsp/nuvoton/libraries/m480/StdDriver/lib/libStdDriver_4.uvproj new file mode 100644 index 00000000000..3f834f0d1b6 --- /dev/null +++ b/bsp/nuvoton/libraries/m480/StdDriver/lib/libStdDriver_4.uvproj @@ -0,0 +1,591 @@ + + + + 1.1 + +
### uVision Project, (C) Keil Software
+ + + + libStdDriver_4 + 0x4 + ARM-ADS + + + M487JIDAE + Nuvoton + IRAM(0x20000000-0x20027FFF) IROM(0-0x7FFFF) CLOCK(192000000) CPUTYPE("Cortex-M4") FPU2 + + undefined + + 0 + + + + + + + + + + + SFD\Nuvoton\M481_v1.SFR + 0 + + + + + + + 0 + 0 + 0 + 0 + 1 + + .\build\keil4\ + libstddriver_keil4 + 0 + 1 + 1 + 1 + 1 + .\build\keil4\ + 1 + 0 + 0 + + 0 + 0 + + + 0 + 0 + 0 + 0 + + + 0 + 0 + + + 0 + 0 + + + 1 + 0 + xcopy /y ".\build\keil4\@L.lib" "." + + 0 + 0 + + 0 + + + + 0 + 0 + 0 + 0 + 0 + 1 + 0 + 0 + 0 + 0 + 3 + + + + + SARMCM3.DLL + + DARMCM1.DLL + + SARMCM3.DLL + + TARMCM1.DLL + + + + + 1 + 0 + 0 + 0 + 16 + + + 0 + 1 + 1 + 1 + 1 + 1 + 1 + 1 + 0 + + + 1 + 1 + 1 + 1 + 1 + 1 + 0 + 1 + 1 + + 0 + 11 + + + + + + + + + + + + + + NULink\Nu_Link.dll + + + + + 1 + 0 + 0 + 1 + 1 + 4101 + + 0 + NULink\Nu_Link.dll + "" () + + + + + 0 + 1 + 1 + 1 + 1 + 1 + 1 + 1 + 0 + 1 + 1 + 0 + 1 + 1 + 0 + 0 + 1 + 1 + 1 + 1 + 1 + 1 + 1 + 1 + 1 + 0 + 0 + "Cortex-M4" + + 0 + 0 + 0 + 1 + 1 + 0 + 0 + 1 + 0 + 0 + 8 + 0 + 0 + 0 + 3 + 3 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 1 + 0 + 0 + 0 + 0 + 1 + 0 + + + 0 + 0x0 + 0x0 + + + 0 + 0x0 + 0x0 + + + 0 + 0x0 + 0x0 + + + 0 + 0x0 + 0x0 + + + 0 + 0x0 + 0x0 + + + 0 + 0x0 + 0x0 + + + 0 + 0x20000000 + 0x28000 + + + 1 + 0x0 + 0x80000 + + + 0 + 0x0 + 0x0 + + + 1 + 0x0 + 0x0 + + + 1 + 0x0 + 0x0 + + + 1 + 0x0 + 0x0 + + + 1 + 0x0 + 0x80000 + + + 1 + 0x0 + 0x0 + + + 0 + 0x0 + 0x0 + + + 0 + 0x0 + 0x0 + + + 0 + 0x0 + 0x0 + + + 0 + 0x20000000 + 0x28000 + + + 0 + 0x0 + 0x0 + + + + + + 1 + 1 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + + --c99 + + + ..\lib;..\inc;..\..\CMSIS\Include;..\..\Device\Nuvoton\M480\Include + + + + 1 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + + + + + + + + + 0 + 0 + 0 + 0 + 1 + 0 + 0x00000000 + 0x20000000 + .\linking_scripts\m480_flash.sct + + + + + + + + + + + src + + + nu_acmp.c + 1 + ..\src\nu_acmp.c + + + nu_bpwm.c + 1 + ..\src\nu_bpwm.c + + + nu_can.c + 1 + ..\src\nu_can.c + + + nu_ccap.c + 1 + ..\src\nu_ccap.c + + + nu_clk.c + 1 + ..\src\nu_clk.c + + + nu_crc.c + 1 + ..\src\nu_crc.c + + + nu_crypto.c + 1 + ..\src\nu_crypto.c + + + nu_dac.c + 1 + ..\src\nu_dac.c + + + nu_eadc.c + 1 + ..\src\nu_eadc.c + + + nu_ebi.c + 1 + ..\src\nu_ebi.c + + + nu_ecap.c + 1 + ..\src\nu_ecap.c + + + nu_emac.c + 1 + ..\src\nu_emac.c + + + nu_epwm.c + 1 + ..\src\nu_epwm.c + + + nu_fmc.c + 1 + ..\src\nu_fmc.c + + + nu_gpio.c + 1 + ..\src\nu_gpio.c + + + nu_hsusbd.c + 1 + ..\src\nu_hsusbd.c + + + nu_i2c.c + 1 + ..\src\nu_i2c.c + + + nu_i2s.c + 1 + ..\src\nu_i2s.c + + + nu_pdma.c + 1 + ..\src\nu_pdma.c + + + nu_qei.c + 1 + ..\src\nu_qei.c + + + nu_qspi.c + 1 + ..\src\nu_qspi.c + + + nu_rtc.c + 1 + ..\src\nu_rtc.c + + + nu_sc.c + 1 + ..\src\nu_sc.c + + + nu_scuart.c + 1 + ..\src\nu_scuart.c + + + nu_sdh.c + 1 + ..\src\nu_sdh.c + + + nu_spi.c + 1 + ..\src\nu_spi.c + + + nu_spim.c + 1 + ..\src\nu_spim.c + + + nu_sys.c + 1 + ..\src\nu_sys.c + + + nu_timer.c + 1 + ..\src\nu_timer.c + + + nu_timer_pwm.c + 1 + ..\src\nu_timer_pwm.c + + + nu_trng.c + 1 + ..\src\nu_trng.c + + + nu_uart.c + 1 + ..\src\nu_uart.c + + + nu_usbd.c + 1 + ..\src\nu_usbd.c + + + nu_usci_i2c.c + 1 + ..\src\nu_usci_i2c.c + + + nu_usci_spi.c + 1 + ..\src\nu_usci_spi.c + + + nu_usci_uart.c + 1 + ..\src\nu_usci_uart.c + + + nu_wdt.c + 1 + ..\src\nu_wdt.c + + + nu_wwdt.c + 1 + ..\src\nu_wwdt.c + + + + + + + +
diff --git a/bsp/nuvoton/libraries/m480/StdDriver/lib/libstddriver_gcc.a b/bsp/nuvoton/libraries/m480/StdDriver/lib/libstddriver_gcc.a new file mode 100644 index 0000000000000000000000000000000000000000..3eaf2920f2067838e80366b116ad1c2138a9858f GIT binary patch literal 204826 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 literal 0 HcmV?d00001 diff --git a/bsp/nuvoton/libraries/m480/StdDriver/lib/libstddriver_iar.a b/bsp/nuvoton/libraries/m480/StdDriver/lib/libstddriver_iar.a new file mode 100644 index 0000000000000000000000000000000000000000..4b30da25fa4acae930a8db076026249450d16073 GIT binary patch literal 411394 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

WgFPb1`a*$q7G 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

0XU> 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 z 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 %%hRS;JwmhIjg;O?*BD9{BPQxd{J_{ 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 ZvT;g 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�q(mbjUy}@3_4|Yt9q$AC`P;k=sht##A|rtfvS41 zs#mxN2heZC^ib(eC*^)suW%0zpx?B#yYa=I_3}&)s+WVBs#s?@*uy!?S5v4*G_}T= zo06kB>zWd(k7Jrzp^lv;SrGKA6|Hgw*`ZvC=>qZu6 z3j+wanX`%+K5)c0{V)Ng`j-5_uY1CO(u@w!*ua0opMS!i|2vEgjBV-e6=MUh3^YH` z^nmC~O0UMhyEx!+fs{c+?hHUzOZTYWAKN|_b=r1iQXE#^Er6h2x0GESvb(Lt_k^ig z+@pw!X$phfC&}KC-C@9!E);KQYSCEWU=K*PyQ9Y!nA*fQ6|v|WV33C-Ne`boy)lg~ z9#-X|wKM?zmZZDK^^Wo0)Y=}^)S|V(!M-h7JVkHs4v%=KwS7m|i|&yH_;)3L!Fj&i zbZh@!t`&Vf3ho2Rb&LuRxhRT1RK%idfI)sF$=)$I$@vb%yhHP`CKsIr59?1P+tNFx zJ1o~@I)k68deK}u!2Pp?#)q1H$tm_eSM@4)?*MxIm(7W9&(Yp-^a)?@PSJO%su$g* z1L(^o-5tAA{7q2xqPuheeTAf3hKJBLYxP{Is72>M!*{YId-0f?79e$ZtJI8KrRqg* z=>U3)r7_oYOkel7?jAQ5Oby@EOj1l^5Y#k5^#(&K>GVu08F~=Z3_*2|7=>vLW}t$? zVP+;dL-(SS2_{=Y20_i1)Hwe|QaYip%cN2XyBP#EM^e4?Y4Hwz?oUn6Tum+(RPbPL zuq@h+_Pz@`+!!rg?dB(f^K&;{X2&H2Vu2t=_Y8Lt1Yuz!D7$Q|90X#qAi9RT*%Ea2 z-;@X?D+hsCB8c`bXGO>MmP9C7IS9mUg6Lr@IbS#%8LdnWO zAnp`ISC2b_G;+Bj5lU7L0!6P+YL&C2 z;rqBC&8x+|J#Fp1?#`0V-!+8|s;v0u1~7j%rg2%tYOf(0H>q-kc`$(a^Er*ava_el z-R44qnhe+k4lg7QZEf8lim1JPv5=rD3t<9>t+7K_yW0VZpl!KUVeC+F+hcA7ds17x zBiAZC9SZK%m>bR&O^xzvxmMxnP;k3q4*j{_ZW|rcqVCpI=gTk5_zs4RUB?67lfvzt zU3~vLgz9#$o}i-K-Q&Cm_%~91#MlnkGcv1^?pO6ndv<{Pn=y@kG}nw7_dTe|RaN5+ z;C(oS{cd4omd=|adV-3wqfg7#3;t-z^NzuvPMTw?UTMz`px;U9&|sNoXUA2&(w!aP z{$5I(9pgrY!t(t>ipm^<3miU-9lFPjYU^+vuc35BJ)!Cq{=otC$1#nb{5Z7t_Ovof z6`#}-RQL-IWbmowagS(DI*bCj>Y>Z(DMeJAQyApu5ov~ToG*1;PHSq}IN)F}J%ev* zO@T2A#K#ljWr|q#rBNUQgPahNb`ZxIQxOWgH(emE*7dTxv;aRf;xUxtyy-%5O|F%F83i{z;%FepnNmOgT170odKl!)h@|mM zo{B{$`YcT?8wVWhbrEZ#k*(C08UY%Ux?uSjSdaXvlGBGz}Q zdX>9(fcxDE&AoH~R(e{{d$e0!R9?=t&{iO#ocr@YZu=ot9<$X*~P?bUO0KX>TacsOl#pM&K zUS;ncK(9+^b7;IjHN#I9QdH$2T;Q-ia?X_hjv0&BkjIR2A1RqUzUZyDRx zhcSaN9Pv^jc(15vl7rhe0kyY{I=|CBv^Td4FXtkg{^6H{e)z*drtfGR0}Im~f+Mxl z%`O;9f%{4>I#V}&H<$(%+-oVvC8cQHnTwUCJilPKQ_~ z%Uk>NM?sJnO|lS+mj1a;6-EgikIeD(0|^G1kQIS(nKGnLOQ zQW&;JA`;hEj0d>7q_V!H%1U{iwJ-pEETzMNqK5WuRjxE=1JK7Ky1QrC56&6g*%<~} z-qrQ8y|jS;`#Imz;!au$+z)iU#@|_hKcVnw80;`HwO1eM3FNX_T+fWM>|=^z7~p;62I0BgT$4vnBa& zKcqcb*Ojs}%74QG{#VC54UR-_Z%om3rRv#NSit`p%cFsy_N%Akd~Rka)Tb$;;+(=D zuT9C3AzmQQP~}Q%HUK>bI7w*xzd~sKwqEIZDYAg=$3AdDp#7b0qA)V-8r^b zJOaHT*UGkx!t=(6!~Bf4k)gF+ponEx55sm*M2>3nljiA+T&##?TMvW0IU;er#3K%_ zUo)VvL{Ct5mmbLA)`&M3KL60)%(l5rPf*T4dLV<_BOc8RCN}v!pizZ8^aSM$qzCxr zF(0}VW;FgzMRnG)PvOo<-ywnTT`}3?Ix6PQc4ekHPuaS%rzPQdPehIM)5XpG=DoRC z_GA{O_eEUSD0l5OP4)em#=EZUyF+35pvP!T7L6Pl6Zv@dAzgRgvKNgiNG;(1NXGL+ zFuHA8t*O=C76Mmpk@P1CA z+uGgTuz6ted?5vAA@37q37re_*kT zyZEr$NPaEEgboUag&$uWXcmp2_d@<3{P}16`S0PqkoL}&R`FiQygxHPw6=88Wu#?n zm%XW=R_BIHicbaw1a)If@oH_<-Ym$Z3PTHmS`<^mT?wh7S)54~h86^Mb41aJ%FQ^n zFiSMGY#VT}x5jKRrsm}~MXc~;8077qL_u++{)x*=N9hhl)NLae&0Dhl>yA_@7 z4T`GQ+Vi5$4+gx0Yu*j@o14FfRJ~*$TcGrhC^!%LQzWid^;&x#`+v;iL$tVgT$Ky% zi31Avgo2B>S*yym?i@EyD!7cBr&PVxp5x|e1($KNLDg&RIc}Z_czn>^hY6om^^$#T zfvSH_!DZY$uj;k-95-7$K2(dF7gV|6o;aZJFDbZ)o2{x`>&|iWvVzOF*{{%p5ta`z~h7N;%1ksm+WH;RQ>A;F5_m8s@K|c-0buC*;?GZp~?mK!~umr zpx`2I-c;pUcaEDw3NGX3u&USEbKJb8;4*HGs(P(G$IaUTj}N+wn|D;bWFK3g>fcpx z88`2#daXUj%?BPIrp3*Ns$6hS98ma=6kNp3$EsZG&T;dJg3Gx1RMl(kIc`2va2YqB zt9q?H$IbY!aldd_e9&FoT&n6N``7|if4PFoxS62pwe}o0S9ts!EpDz<<$`BGb7;fL3eR8Q`JlMu?4Drwt~yJ zxlYwH@>+{{(wf_vhC!r!3aB5vlZa;-bZ%>o6NakEg>YwbC17Av@no10X< z)}G^LNxLvTw0#*Nzg3GvhSk-Io zIc`>a{0CaxJgUkC_rw8(e_X*u+^kXMT6d0{wF)ldW}T|n+H>4IrQkAd)~kB0J;%+4 zfX4^j#mz=lFWJWysQPCWT*l2NRj;+@xOv{=f2GCEW>qe@Ck`n53kojc=0#Pmb?3O* zs^BtiwyAopJ;%*<1($KNL)B~TIc{DJczn=Z+`OjhCHvR{RliHYW!&sm^;&z5n>`*M zk_`9S?|<#p^@4xuf%3nh8Hm`~uj}<0aP+*X8OZQCs3)k;fdlBUW*{Tzh@PN62achm z!XSiyA>v}1J!~?tVp=KZ=>4dJ= zXTXv4v1TA6>7<^ZJ_nAZPc;J>NvHG#^*L}PeJ%{*AaId%T2D~SAvVEbxb)9?9AL;0 zFUm-|Oixgs14q(?V2}(6+en(I>!l155A4E~nt_OmOAvVEbn5h}aNSdW5sLz2T>AGN$3=-Q&x?a~y z86+Oqg}Iu6h@^SCUY`L+(tOQ8M$(OXg8Cddk``(PGLjbQ3F>p;NV-WF#6jTNq?`2w z#T;T29EMvo0~txT>Iv#|;7D2;43c4E8%ek8dMSg%1G}(HGZ2xqT-WO};7D4b8OTVw zOHWXr14q)`nt_a@d-MeLIdCMc5(aS)xJbHBPf*MuHo;+dKr@h$^q`)gJ_nAZhl9a6 zomky%OjoP_jvY)tFda}gfX6V&7pY>>wqVbNiB zqrJOjw4Ct$L?MOG#ZHIyy@_)Y8)UN1T3{Wt9(pB_{_CgTJ(+9X*?a}ZO)EG4i368x z&&9tNj2wdWn??F=G1+QM{CmmABJg=pq;GXTG{Nen`1g{JMUZ}*NZ;;!Xco)M@$V%c ziy-}ukRGc!j_PXdcJs06ZM;_$vEV3Skgo;uf-wkt8+9}XX=kbw3_S*BcVK#bJkS*S z*At=O#Sndlo{8kc}3@gOe;7B5{@SX#Vg2~$!{OULdnZAFgj_| zqg0)ks!Pj{i>CP#MRbl~UbJbKQy$Kz0&I@W$RBsNpKGg<+R)EbnaeBNeDaPRfS=BA znjvZJ>69G*Z+y8NYxEj__JF}}{mZfRo zbiBI9(Z9H_L-8`Lkihx#w@>KWtC_&z+Ss8t%7UtAMj=5(7SaR`vtozgW3jxmzwDR> zWOgA%MIO=xd0cNDddJ}$HvjS6ojIxEOl>bJ>TgCgOy^m&n@r7ryy*?8QZ|ifnBHj7 z&Tg#7VE*Gx7o>_Xl_!rRVYtX*=0yS&(>J6PAB%I%naXZif`YqQa_Dx%pCVYIsYPFb z!}(Upnq^jf!w>Z~O)WYL9PI6q?FgSIqaNHHxmI-bD7fX4>mGM*So56vb9ZWL(O2ML z?~-gw$EZ-l)VW)!sYPdjgS|(x-Ju@LB=cM=x_T6z_el=lMDw488*~<}-f+Jv7oDX6 z=m#TuL`SF!YJVQm)UtKJ!9F5cyyx%F4SElAwIUXM0}S#pNp`o5^|t0c@y8Xl=o@JG zJ`s`QhKGtU?}x9|A=3>#+voL)w=EjDz+4M1<*W?Og&%=64%(jNp&UEHq(Bukh&%^p9$+nNf zeNm`nisP-SUNn~upkJ0WmJ0FS=EA&PQH#!jhVLtq>>bxKyf--0J^rhzUi6j@pm$2T zqcvF5J65}LvFPhraIZ_QSDe;nx!ygBTC@!`eD_6UI4!YuADw(}XmZ&(@L&%_Y)?x^ z_yUhvf$L3GFPjSoxF7N~Ugo2&g?PdDaIWdL5{2hm5oh`a&XuC#sHT>E0}l4>h?Oh2 zQ&7C4sb%MYgMBw*(LZn{rk=%nxmI>%6x;_9XZi-tm15#UO)dKd9PCFCYx)MxnVRH} zHMQ&cqK@rQo9tL?uL{jI#*_xikm5N&S^)!4Z$0W5OY)q%! zRhnGk?0K+LB9=M_>`Z|?RZ+{vo(4HBBB^u0z7)pO6}9Z^X^=A_65Ru~r6``6i)B}4 z!Oc!MbPd>+qWC&Zt}!?0Hz<8MCHiz=fu`TcPR|=D`8DBhTnB=BJfiR=jh3-J?P7V$HM(B5mKN|| z8}U6q;&Ejf##)zYWm`vrdMcuNWlT^|tk>kSZ{Wdhh}iBf>g3wzEEE$P6}4>aX^_ua z61^D2f&H%^9^8~`&NO}O5Yw=I-lE+`u>bY8n{!RKO=#G@V9^m6&!yXg5q!$gA$u{` zblZdmy49ks_OZ76%a?bXrV8t%GBOuru-#h>$K!FNpuck=M=YOs>qRaIWRj#lO2B43|H161W{F}P9 z$27IV+T&o~VYUa$w$UFS(Z^H8IckqUdISyA_dGgwxKZq1-uiuAugoBILN*_=4OScK zL)%Ax`8-Z2qR&7)80p0qKqL*{j~T@?OsqfJ=l=56Cw1Ms+Zu}U$efVPr`84sTGXDM zI(I6Q%H}Z--_HY_R+@D`T}V)!N9u)~F8#W>Q${>xdvIAMmEB_=z7qnR=4$s~Vj)3w z9;w&=koCqc`qfW=maR9o2;Y!5i&HfW`097Rdm;YccF{jx{IiQL9Q}uX{LLl5`SpdJ z!+tRM!co8e*)RX_^NTJN7Jn-1jg9}x%KpuEv8;xs@dIehF>KMAW3(}VHU?vDG1@r8 zY+$i3+Q28@TRMk01z&u}hEwp#_m<9~PWh(UaLTu6<7}tk6Z6<`%C~7_m{ZO&8&3HS zZJgtj!DhoL!)W7sPWge^aLNy9#wzx9>$!``R)1S z+k@rU2wp_Cys-o%9ywcOX+K`Ej?yhRTj>2+ab>?|dn;l$R{^9Rr`>uGo_1>r$kqKC z_YG{CGN50-hUV_}p7!qZ+Xpu^{kXC5%rz(&bto;hfp&>zF*YD^ChnB z+@_l?)AZOMX3-D0=2)9Kv}Laj_J{fXn{A73Hy7DW$5Zt!>5sMdsKK=fmfB5`V0nMH zSl(ZJ{l{1w?~gR1u71c{%U|wbhbAbG!({wAp zJrSIjo1o*WDL^1zVFKUw3SaW3LCRNCMKu!`n4QcFKi3T~&`7{8`77_98(DB=a_N!y zbxz#d+3ojj2-Vb{L{ZBVC=mOY@LvEoUkiOh{> zv-y5x;~Ats6s6|~FmtyKr;=JGV`e$ny~PYZXTaq$Bc4ZNK`obOVDxsBp37yPMZS|t zYPpP=FW0-ww6?XOE6;1JQ*geQO3p5c&cK2BATazHZ1c6P52N4Ja<#Tu0xlnMYFe7x zHcRGvQ6ERYt1e8yg`b9<8nrkJ?fP%YRaKe&K$O)NLa`YgmD+F~x3-+2zNilMzB9=@A405s{(Hm$V zJ=h*-y5GGj*Gi@V1ve$-+)FHU{!h)dN>6@uWm?L)l||_R&h%WX^fV~A8G^&73^9=6 z&O2&-XDXs|4QHN$+eAs%SqE`EI94yXA7YODOb(5l2`*JKS5hOQW zgU&Kb>)(<}B}eA4`?nF(j;lHS@dFx5<*&|#=eWk{VQ~i~rca0B(|6q?dfm6MsM%bW zDqJApm4Kk`G@18~r3-a??^t~0-hIu8ELSL^FJS0%fJ<<&D~WZpRPlLQ4tKJ>JCnGm z{(_%^pzaM+ubgHFX;mf_3B@t)MgKbmW0Pe#E#9&tmxCpGYEa;@yiD7dwOLrdf>seNCUNd?CMf_f@Ytzq6D zwe9OurC{eVFdG6xEwe8lHR~I5t>7q7aL)#gPA%_APvSS_TESDG;GPd0t`Z_H&3uy0 zidwLhG<;uhqmxtwDc&r zS0zWMmGh(%^0izmdU_Pxu9zFbo^(R)&b10phl1M^b3@saPRPBvR^jPTaBm2XPAs?U zbVBaWq>`ftLA@y`oLbJ0PRN6)QnF(V%wfTp)5`hL33(*fN{#^qcT{lZv~r$wLLSSt zl4n4{y(2h#PB~L^LLOJtlC7ZO`yP=!y)C_C=}GJuaov4CRWic_gWHD@)85&|H?njG zbV3o!o*oAIaYV-RC{E^D*_2UuekwTs0V+CqP9;Lg%|ReO7sLpD`;^X^(}_^BauA41 zzZ?$7aJHgz<+4O5Svd&A1VLcn${ksX>xrpSGGh$Pl@a3)&Y-g>s3$36+0(-yuZl=M zJXp4Xx@cGDV%e2ha8m`>+TGqc=6s$LLScA~qLyq04RX39@j;XJZk{Scy|rr+1yDJ+3Q!Al$qUalN8C<1p;y&vH-0cWy*><6>uT zCCqo<=jCFlxESkjEKKJ|9FCfIrTV>5QOmZT2DvaIaWm-3N|)b7nO636B&eGNh3QD4 zTFu1#n-#TGt%8Q{EfL98g9&4Fmff0*rLtl$D^%;!i1QVLTSz*|ZdcT@t*1dQi%4Is z=Eih+rjgGR5J7+s8xb$?Ktne zc3!4|+UWZfv1BS>kPis5r!~AbPKW)$Tq~Id6x_ptLuL9egPXCQM{==b8d#VMHTRvqLyq04RVbjkzuffYU1f{IV5*L5i`>qMg<&{qMyUS947|XO{&G-A?@Qtv+-^wv0sRw zl%!cu9p?G}aQqju0tWs$W&&V}h528<`sqsz4Zn|OK!JV|^cSE1nsNW#~f?Rd1+zQJ=}ND5zCq^)l?+y1pp zIH=inV(iwpn_Zh}H_vjLn2SQ>cibkXoY3arW*5kIb6Df##->&M`VH_?Q!q_tJktH3 z*&cnHtRtBxvZ7xXT~ivG9>X>HOLY7w2rkE;3HUP+f7~3AQA06afE8#)_Vo?Iz)>S@ zn`;>UA+4biWap-f?V3eYX9HQ1D_1#G8TW_EvN^aWD}IRt$kS90>ka zJ(@xYM-ri6#Sn<2fj~Ftf>CX}Gz+y@#}v_7x<<=anuI~V6UfdnqsQ2;1T|X66QNW> z2Z4Am5M#RA+TGn9HCOMaO2N!yU_J~?Pe%*ijZ-h|M5+|rJO<|Dz;vP;?E{2HTux?M z!7z}ZJ`EI>pc&rU;r7?Of`2L(3!Z|7>F0sND-ObxI`yY>v0y4#aF-772OoEiZJjN= z_hzQZWr|v`l{9=O1QNpp(wEM=iHchAl{CmJCE3yHR$DZ4Q6{BQ(a~|RyDBgv#&maL zi7j*UVeY!G&NOG}hBAD`1rm-^1J%{q8TvRwDb}ya#X=zk3vPPgT1Sf0+q_zTZ7w>~ z^z;@iOlJnJx2>~vPxvRO2pQWe;TS>$BI!kt(M^9bpw1}R*UazTa?0OWYW-}hv zb0v&3AXwA6KTlJ+e))N^@D>K3=Np?tX)4+mT zCAgu|ln&B;xmYp{EVu^*ceXS&qeQt_G7T(D9~Rs&VQQ`?kK|&>G_WvzRB-1=Q#z3z z%f*suV8N{s-1np@ok~ySV#zeH;MNK5`_hy;c2DMF$uzLw)*H_D>j(Ft1;a#=Fs}2o zrslpm4(E+2i?vnQo9gx%U9WWa7T`CfJeDe8f2!u^biLBwTY%pj@iYX;T>`4_Et=}Q z#YLQJCg5OSj99uP@RMOWy{+n1=H3DH@r353Rbfsc_^u{bc{308eZ$(-La}Nmtxy`;*AEoY`Nr?9Qr9x` zfcpt!VAo8gx6>o{j})=!o_WCiq%puy2}Z7|7sEGjRNZMkAk~Qa_EMzCpG?;=UUOzqu?e=4!sceq@k26 za;@m;QE-zahfWB4(g?%kTq}Bd6x`L4Lmz}asa2bjYei3wg1bg?=z_2(HD}Xut?21d zaMuQ|cN~vPQ6n}Z5uBU62c&>t2*j*FU~E)=X<>Gv6ug*%*Y$zu8ZK|C={V2H#lpS{ z7Ti3^4f!61tlW449q1c!v1sa9a5oyxc2e9q&X+Jc#}}w_?yMMqUX;*u*TH=T$ct6E z%G?`(zB!@k?!%eWS-(V;tIWLt=vxz-?n0b7o&L9}a+SF^0DXHx)7^+Or}(%-m8;CX z0qErkO?M^EoZ{q8RjxAk2B7asXu3Ob=F~E*ROKpjZvgt9gr>U`XHHGTy{cSg?hQcS z7ty`r{KIQ%EbdoCHWn=g2f3$#J{Y0+6an9WnA`k^6t%+G@{EvFZ74Scmhg=)_k z9B;EW;vp10gSrxbCgIOy{NeYMyGDs;P!k69U>mvg;cvbYQj0q=5jb4jv+ooFaiu4^ z$BpLCEKp}^QX=S99s+TdCwhYwwWe1mf^Ov@5K}#YoYY5vr>hNm-qz^&~+Z74fdjM9Gh^lZAm)yA zQKspJf`sEup7IaP+->O1iK4rC3SPH(qPyKc&~ta5w`Q8|CrCIh^%RD0+D7rTQ94g= zPbJ+iaA1~M#y(lVgNsrAStU6x*Hm`pCk&?5$P7TQFm#Vu$*RXqDIwRp;@{aXgrG!_ z{_ZF}p1%8Ym)e1QG_~v*aImWcOX~@6DXC4kFV{-00R{Jf;CedFA0F0{r&IYsO)dFK z9PGm}J2t%RMgtj-XljMC$H6`-*&bApZ~x7R)MJ`lv=%(9*F@~7(cvXRGdKGQO)gsp z9@gt5+i^Ztk%)RaPinHWrh$ws-h>6**BhK3<rsy4y3z|RT^NAgY-sAXQ04d+?rqI%QN-LhgJJt(M2Zy! zs6t*+#Imi2L2ipkx+(VYO)bdFs$8}f2B3FDG~K;>b81FjQRT9^FaZ5pL?h$yb|PJY zcdByPTo{1fozNJMCb~HLJxs}W2!T{#SB6A8; zcfM1syq$~AmtR#82ZUL0$0LqMr!WXjmGN#amQ9%j_rBrm-D@8YOxxDugG|bIKLKHQ zLQ3hvc~X)+=E~-Lsp0rUQ;Ws|2YV`J>B8omsnz&QQ!AW34)%1+ zc8nVBCd*P3jQUL zGvi<{FtGr6~0V^oE4L}Jh>xh`i-*{wZfNa_+BqbM66w|+}^~}wP}v37rmte z=y{UHWY-WDW{B(tO)h#19@aO;EFW4_G{y1)MXfMq8swswx_L=V5)jWc~Q0dspL*Ty(awzt690yBh|W zE|;7iO?6kfJ9DvU>RFiHWw_pPxO=dbN++=G(iN#h7fNDpOF(UCz=k4TEAj^iLe zTAfKnLk2-TCMljkZfBi8o=HVR24VPwq%H^pZiCLEtLs`#b+-J%OsGnMgMCu6@$~bj zGO1kDFa;e8Plmk2;1e}OSbj3qik2P)hm|M;=Lfn5okfihmZMCyqNhi}VPVR^g=yu8 zBWmffJY}X9Z37Jw3snZPJ3QPqZ9G=1OvR$BXJLv}D+AXdOsQ6}aAhhMO+5<^i&qA& zdt5xt8w*&bV$syIFvT*Kg2RI=KI6?~Z!Be*sbyPF!xsx$1`>M_eCcpuVarS{`UV;# zR=Eshm}2gl;5~}!eDf14(D22Im(I82ynK2#7QW0?XZ(F}$)MIR=3$MMFas=RSKIRe z%VFj!mst)!Id5SAZ!C^!X?p9nd(^oj-PjE^Gguun)zmtUP;giwQ*g51L+3A+$;{QV zZ@|G~$xO*|$HjJsv1n!{R`@auTP&R^N$$6xX`ss%R?p1T3SXu{Vhv46a)%babnU`Q znweVR%QQ%=swqkC(88B4VOU!;Q!9L#28nex18FYa;azMx>#*3Sq8GiT186L|8EDa+ zMX~AD4hwJQa?xAxV8;)PSU$9HruGsGa7t&RRv0r45=(GOk`FC>DUz`YXQo#8G7SDT@1y0rC;#s&SGmL;YBPbJ7rC{eVFjoe~&y2A5SCdku;N~&7T@{!xHNxIqU7bkZ!a#|+ z7bqn43Kr#J!Beo{ZVH^gy@Vwl=$liiVCXq8w**Gaz$uF0NDnFZ`uSzgW{vBvi$0$YlcQ$nzMASS}Z5!+xssLB<#!2sqDOFGOS zv5n^=idZxbFl--{B&Ls?eZi=1@$~00RW4df1DLN#XxyN1uu>9Y!W5_M4Uf~`bK))E#Vs;JO>6pHx>drmP&@m^wJ2!<147OPVZGw$G z>0d4+Q1(DGK^8k=2RX+Edw~S66cSWqAx+@$TI?Vu+SrC>r><9IAS~d&+wwfuLfp~O zRp)h0RlGAC?B1C5Q*La{?9!>g}<->e=OxO2qoL%w{^YJ-&?@{c+890H-pZiQ}}pYiI^92aO~LZN4j3&FD&4HGUmlJ9NXxBqU#m@!UF!MVxEFm zOy&7ZQJu9LEHQ0nIAtvj-_tS4Gjh<-P&aw}fQU0{g)h?}FSBGaFUK~*m*<*N4+#p- zi4hm3<=EEc3QaBh1{}_lB38`Hu?_BIRW5rA1DIc((0*!;ZCR$Ma+SF^fcZ5E&GU2Y z5T4l{RoUe^py3q1?B6aR&sB(pOFaSL(rO|(KgO${p%vR+}b2b2deM<8Lph0I* zQ!+=DE6v#e^t^}`bAW6+a)T8s3!c!1> zgK^-%fp};1pZ}=mD8k}T{`kH!J(Tz_ctjE28Ko`%AcZ!>gB02n4^n6|JV>Ff zZ!|9K-*j>EAm!gdun$rw$)LuyCQ0-l<*y*v2PqfhUxSmUAV2HZWy7PPX$>Ai_ov4o z<~hhT{5>6iuEn45E@`KD4zjWlO>C!K(X@3`*GRtxFkOD`Rzw$5VZvDsgS=Oe!&^G| zmWOT$S7lPk(u1Jxm((zPMA$EyPraT8G_`0eaIg;v*5BLEW#HjNDEWoEnbneT{U&Pj zAB}%68W{xX9~bGv6AjywS(9t*7pB3uV-i@Ht`*?$u^4mn>nfTdq;;C?oWsl=XDoSG zKPA{7VF=p4?r0untXEVnvY$!mj0Fwf4T2O8i`->;qoO+BtR@5v-)9Ah$0WQ0I@)%M z`b~;jtcXB^d|r^z>f{vnn{%<`8dz{I2(GoWt#wSB8z?sO!(LQWu7s=>1PtRF zXax8qr8?M_YtA(}@g)jwyWm=}=2^RMPpHqiLsLt>5(oRLWLteY!dfML5wko=k|jU?@je=nI?1nJ+1(uZdfgU+G`Z@;FNJp&H*O~H<8 z>uB%Ap|^t;)QLQ(sm?hGs3Cn42YXns(L2hfTYW@P*;u~jX_|r|eZm0NM=gvV8lEQM zW%RZS+S)t($6_gDkCjsRJVaxo`oQF!#H70onfYwYZX7QqaruO4Fu2ZgaitHkc`x&5 zZ#$PyYucIj^#m>pc@By!*aQ5B%%cc+3>oI5pGX8>IkvMIRZ(E!_^|~|4>WQ-nFwV^ z$-?nd3-)xkbkg;_&-}-{IzlyYN>j_;nF}mFw-)qfFkU!zfB6hfYig8%sEo`5_LtK8 zTb+F)l)_(@Ns%!>9#wewn)N+8`_60s@eunTUu3huhg8b05e-wb(uYBZlIhS85oW0m zsZ^Q<8m4B=k51HVC(Wa2?e6q}K`n_{_#;)lc~rRx57?{$;^DS-oP%hmY^lv@XqE!W z6FC1NvZ-?AlP1W)tPA1|hF`#!KXX|%D}%%$JLd&w7N%xx5YOSOYNKtDhfqGm-_O$ztp_n6SRuhRurR0b($->mEDB`%b-tNvW-`6nRxJC9HG@O@9#y$Zm z71m~H5w>pi9c2?5W^s{7V^diVHd{vNF1yRzgSFwmxH0}0e0Sux7yn93RJ8ZlOaG{Q zY}}=@#h=PO_TFH@%teaohf-yKTc%syYmC2ks;=116K1n)kj23>YwAz<}8e7%*VK z?3)1_3>YwA!0ej=vzvY2@ApVL(vftepP9@bq+;XWbM*ZjNspvQkEBPU#*hw%5Z8+w zBSCmN5W6}1$1oX*9OkH{$$sjuXHv8zP z2i%I-swF%LV%c=u15Wrc8=vq5gXNxL9M?C@OC(0f$a=;P7!#q{AE{i(_R) zaiZ_hgGYxsSkGCE(Bj4jev?7aiXaSxWJmB;!SgH(1r=C|-1MgSf88 zizSE`9ofL)<9N||4Uwf3ugNlAbXtQ|O&ggy!C3H*P~_;q2E|@trx3)Lj&AS-d#@r7 zbb5nguXuIi$uMi~AUhp`>FRoKh|Z!~ismbc#c2EMTP=N;<>A zDa8^%yQt;S+*W`JDVTJ6gJ6z~x*Z4U^^MMMNNg3RlR`)5HaMMmJWSwRr72-LwIMYY zs8S3io!P)$25K{Kyp`z?*rzic*^pUtukGlpb~zXCsG}PHRZClWm--(@uvqWY!jOHgag`u!f+WF+J?xM1_LRYRIf* za*#tyXEmVPVuo!-%;B8AKS<{^#3p9S9%dp1lFn#g-9SK^5du1&A-0v7UJE9j%+O2Q zR#6+>-8TYHdZRmqJHpF?e0iv_7tB zRJ!OWhQwB6dMR{t0)x;EFq6s^oxqUTDoiJZj!t0kI!x?_gKg>M@N3OlYR(LLgQO!FGHV@e<H`M%hevWuhVlVS00(v^o zA?QbEpySEKh1xti&>=UM=>h;X9q3@x)Yu_mZkuhorF57>Y*L|82o)XT5LCT!&z+8N zNR4Hv7XwSjH+UsVX8*A3U(y|qDnDB(@^dOTnb`8oZ94 z1DKz;RJvVsU_)jta)lgPIG>)w8vVQQ>B4NbfUJll9>GTVP*g?pKToH&g%D z>}#?ABzaIh)?@C`@m4*;s`6H&2cIq<2LzenW{6Ir)fBec#gHc@i!Vx0$bD+z-IoWVST_}@i-|Vj@ z{i0{P{W(fMJ#vpOSK+MjH}n&=qzy6a*x|QEIb$ZKtH{SblxL&fDL%H55 zae^lv%%gjZh;8vUCn=nMe$qlvnIdg#>Avu}fLui*m%`o|;vu#7x)UY=0R zWx4=B{Zyh3p6!Q7PwVy?J|Mt<*6DkOcSp_-qultlQgln7Q_UJZ13>*kq;8H%I`v97 z>h>~TBA|aM(vLJHpYH6-y4~^Jnpj(KZ1g1p`d1=7>MhS0+Pr^NHJ4*A0D!-qt4H`@ zNw3Rq==K(Phk*XANZ;%m@n<&BE9hp;TF#gthxVOFE5PQ9r*{=AN7}8gkXi2K0KXqe zaW`pF(exh7Akqh#nd8hI2+0lvz&~9YU|+vm+(RwQm%5#EMv1vVK>xMVqfu9L<{RCv#Xd)X zKX;tXHfQunv%}?wYSs$d%RxSzwL??!hLGLTd8%1urvSi@bZYu^lb&~e2O?@1k5Y^p zI1xj6bfQFIn&FEIRs3TL0cv;w0bxNxK_-j@b-QyA zwF8_*0RjF=PCsfEzuLe3d&J3#k;#4?vMqCo9^_M;*eN@sNe+y4$evSKI-NJkaIP274Gyv zpBHQW-V^Q{kn=Tj1?}}fFO9YSqe7r5$1l{(6|~nwdvVax@QnDH*uEMr)9nR%f&l;0 zRL>uY+L_7ARCATi0KhL#)%@kJ{V@It)m()$0Pq#DT6{WdYyMTby@D4A@UKbroG|;X z_O+_HN@oDz*E==Myiy$%GqCo)-cSgjIZz;QaZ^HwXS1o>dvhs7&56W-u`*%E`Dy!H zy|omg=0#%Q<@SU@Ddv$=>Upfv?KKYp0sS3LA1|}8cjC_6rg38_n0H0GW?#>YCNG4B z^={2t<_0;mYrU50^X#ea`#|ar+?$znrVv7Pzf(1bXP6;<3~Dvq0g?n=r zA1el_d5S=wJdseaTwgk(LFgxoL28a75GYS46cZ7Ad&xPIr%Y zLnGDCtLB;q4}f}OqDFr-thJ)4$rlR&Y7PVhgqITn@-nzEZ=Rb9A!IuidA-Cp9y2G-KOmt0Qt0WqVunrKGl}B=m2NNb zV+8cyWO^DobPgy1-xdPYJ$MKRhi+xx(&)aBe>3*!JWz9fm~O8*2ngusWqR-34&fb9 z2vGOnA#ib2LU7MVo?N9Ce10)V%}oRX<(PyrWq6vO!lefMSlwQ85fIQHm+0|$=yoeR z>1FD8)m)={0MrW;HR>9*dhS+JQ*mM`M9qc7fN^rd7~TUjD17WS^{5u<0ctJ+1Nu`F zeRmIT0To<3NJ+Ksv{I0o6UhPN^n`(j6pd{S$-&SwieYMwA`(2El~cSIy6b1F_7)y2 zLGDY_j~S)^)Hid79J1FzbE1#tFb}%ZcbW&4i0{ix=*i>uqZz`s&cDKJU0au#wX#3P zb(xt6`(vBNhwYtz-4TC5_a?re+m@zFF;;7Xjc=UMLBXQ^W`2wb%I(OB4`%lFk7$_i zwEO#GpnPz;h3(ko#^dbIpX2*G__9AH;QKuPV<*fx(m0nj?MA;)6YQ^FhLZ^>g}-Xt z(x3>^2Y&btcz9MnrdF>;1p9afl|qg33@ZJ=bfNVOg7R58Xd@HI3LMvt}gHdry@l) z!W1JJve`*H*z=fXP3o8`2N|=A(nL=t?j+G8`bpJXVFv)zm|P5SF)wL{k)F}4MYNEE zjCn;#4qokJ`FYh`VFv)jlV-Gv?AfU(Gq2z}tH9Izc ztZH_29=p&1fMeE>Y{`_Gy^+V~HpYe-IYkXDrV4|hIb(PoW zQAp@ys?NrEQEt;?oT!1tEFoe2MBU83FmgaqK25hPkya4UW2!LX`^h*eB4;SZ8ad3w zVUkc_#RMRlQySAeTeX+jf&ew<2qU_Ww3$I%qF8I>5Nk{j3a+32bB}-v6l&Q`bBgR_;dPp|hGsd)mp0@RoTB)T$%Xj`XSbi0CA5a46>Px9sLp)D)76#`T|NC;f4iV1S+ z&~_SD7XnmVNC;eD4p62d%pKZNxkfct@BsigrUD5bPaxXdzb7*(&{zl{CIKaomN)ae z7!{cNRC5I!08nExFu=pKq|NCE6k`z_#K2+>&|;~riKaByrxq0`WT0WDk7(}Ieas*7 zWpnjW&8ko{ImnpUi^=l9CCc5$3jwP9009A0dXWn^sz=2Am12$h6@M?n6ryq(63Q921#p3U()T)f$UCt z2LS;+=IbPXbYz-ekZHc+dquT7yc}?0d?0|1nL0_w30wGd0J{i=^`x&CLU0a6uaN9R za^MA1bvX0w0*BlU9lew<~5M>>br!;Rgcfn4@Dl z4IPb)gp;LgwSB)3px_{dzy)UNVi#C@|DafeRr8pt@Q%kUgt9cdQ8tnd{c`ZpW5mZbbE~-5YS_KF6LA1b9|bPLS{9Tn1qvD+;TMkF4mOmXR7uJ zI}qGAgn#0mlZR;MI!yR(^Jf9^eVINxiKovx<@6c-@Y84XW1GeY?VVl8^w}HH^ce*k z-#ER4f<@D39a2U2-9a| z3e#uwOH7~9&tEleZcqfH>9eck^cjWn(`WQUOrOzDF?~iq#q=5dOsCI&g6T6V)^_vD z`^@Ya<{;b7#h)eka~}S&isxwA8Ko2v-il_ORnMIAcZ>ayt= z+c`N$vnCbHeAb?b?q*_eJ z*k|Fznza~jAqV-AOdHMST&kMu>@b_NT&lw-Wp*6sa>ZE8k03^zuarvvJsEByjkm4H zjT~KmLkZdJ#SmUCh1t~8HHwvE>)#s!IOsvX&T5m{2V0)6&utuCw;GS2i4@EmV_iD% zf0Jr5eBI{5?YT|ICTd_;TWMeaEc1c+ znEQu)EK`xVqY%J3@Y`UTwoJo-u_j{RtOM&UIJv73pynjPz{x$9LCK)c*W*1TDJ5$Q z0aPa%28{b6MzjN@y%qNt0@R#D7&yUq<5ULXAv24|SL2Dvf%(livEuz5KzuPSuZN*B z+je6ShhnaP0|0P*F>cjjbjwB-3prwoiWD-?@O?OGcmQGdUMwpSn_^%EhhkQ^IRJ2c zA1>9rnAzt{p{5i|HganL9m%1^r{7YG zO(Mg5FvT0|HZ*&ME)dY;1MpZsBk-wSV(Ervukt+tdVByb_0zG{n$H`mqgcbC*(-d3 zfPU_{NZ&o&gJln#`BYc2ltVi30V*DR82dapJSJdSu6IDS73(^r181(_0|4qHW3|j4 z8oR-w4heVW3OoRyK02t)kX>{bFxGQ0+8YaCZ?_q;AXbLWKkc#NSj!>7&RjtU0OEW? ztTv@p3^rj!hlD$G1s(u^pOmUmRK-XW)^x;hW3Iv(0Qf1f+LTiVH?Ip=+9B!AUZDp9 z=!;{uEu)O5mH;a|B%T9Q_#DLE)iYx~l~Tr2Lx2??5^v2FxYt8_POPOe%4li>u)IT} zt+|5sdT7s!wU`zR6FpS@vBX2NoxK7N1gMv0YJ9oS=SJbE@?)h(f;R!`d}cs@ajc&` zHSC9t-X^sGSo0x0_z)ErK8(GwmnMX;H#S_*ASG6QL@r!_nuoxE{_8?Lx z&K|}B5b1yeR2*;+n}QXw9!1L(U3VX--+_f7(t{6CapA*QAJF1Bb{b1T2p<_0 zbY!>K>ocX;a~kVF670leW9Zy&u{T*I23Rm2mTa<&^&do)HjZmFd>{i@>Po5fdnLPq zh-DuEYmF7GSIciT{?q3h9TIk&qtQZpzR}OW+gNizd|$?zj~}H0Z$s$!5dU`eCVz23Mn7asKg5tR{S-sS^ivEO)6abx zFE%KCA%*y&<4Fuj?+1U_4W67gc9`GJo88f`1?|aa8rxx<*_2ju$kNGvocRKjo~8J6 zVHjub?Z)P0{*0v)$I+f6~yv+tbfvJP)JjL2-{zjE?m0 z?z%XXM{6^a!(}n^La6RbRFhnOQ3H5?W^+VQMQsF$Xp~SrU{r&Hm_r{tV9ww^7Dz4o zgQn%m)*G2=Q+m2b23-?E5qvncIG`JJCR!|m=Fy-T864{8wPe(UY{*On zUJyd{cu)=X;DyPims*e~QcD5nWzakoG^2mCC~7*MjxIZnn_=|Hv;u^FHiRB_5USYE zMVAYau>ypC!GuQH@5e`Y_zN9ZTLU&G1_zSGOp1Vd$tdt9iqlkoJvMD*cYl;86^oZO zD<@Gs%3*GBpH?13|ec|h$Zn2}!8=6(;#&VF~%C&A7 zody;*Yt|NI9!h^F*5V_HUyqDV@1Kpx+gnE!=G{u5ik}n)()%$9UwYuX*yeQi#!j{A zgHni!qX+}WM+sxb^wD8nmq|73W8Gf!5D?IR8td_{8>-xAxvj!=QZT=Wb*2cIxW`Cm?D_9moId?15=1v(SSLU5KRP;l0n}edkjw@!Q2KI0% zHD@pd?7ZB@an-P14eXJLG<;-6rQs;W%H;4!MSZ8(0_)UJ9-S!n7?nd$$0*hs*Qvo> zz)BR4iDQEfN{!xesil;&LJ8RkLN+M^E=(;P!!%C;WF>$nMY52eRD(~>Y|M;u(*Q$W zo)W1-PSPDZHM5n8Ar}`%Dm*@Bb-T6MrjFAt!6HxgC6MX zBdzQ?m|Av&W-gD^AXng#fA>l>;wNd&ngAk|gJuQi!6ToCHVD8O$JFR?sCgjdPru=XJa4M5DmP zMvp*O%eY9A@?s%C(MiUEmzND>+N>cY1Woy@y?z%bWRq@JeP|T8c-14Q8%{2gguGS= zP;`=U;N=YinLTq1%So`$=FBGj!;d$-saYLgjP&GkkT%tJAT_m!#!=Czr&1DTURf2uk4R; zUFLPs{@BL+z{D5@+qR2dckI8%)4$#I?YgK}Y_I=>woOAX!v6ZH{pG@KZ+<19F2zT#s;I?$|oGt zd{b#=ucON}#x~p%`^%}8b~KLJio6BYPHmlsLba@;%d~n{waWf-sx=*rRf%fnw$2-% zTHDcOni#9vXn#4?rj9OCc_~X8JG^dw*=lC5Z0=~A)A=9vt{@MOYsU^bs2!%JwOx$= zF2kQo@W*}6GSW97<{7{2pxa7q|kkn=&(q`HYoHu@~vX5QJomd zLmR^12%Y6*S}A&II4m<2kt~F2o>U?2JjQ7^);L157O_GO@=>fE=^mSbZ9v^@C1vXT z%%n1<5UOK@3a(%^X{QW5HZwWkt~3sX|JmUPmv>NlJ;cYcxQD(QH-Gu2|M=YI$XMo@ zfg=FO3t4S<1nlm?u0?*mB4xyhg#c=HCFcUql8fBBk7u|GSv<=j*X-MK+G z;*S8QlDH%>6lg4h;(V*Hceih}J1QU-C`JXDih;e*D=Ei`D{k6Fic!Z#VqljUCFNzW z-;tj(@{;&^4wDjuzs!dZD|jjYmdDq14oeXJ3Lie+5%bFUy3Szu^hE zDiT=;)vZ!BwZGp@rPEO6ZJDVEWFb_mf@)e{?~Fb-r%2c@-27S;aK07TSFbe`ZeeGvHLu*Q;j6+GnD8+V|;WSGgEy-O6|(yxvc~ZQs|zPx)4z+kxyl&B9Vnq zJtI`Z;^P!EqWo-bEHQ%?(C3A&Z%|UH4SPYcmasw%<%>c&JA5o+s?STAt;F<75H|@` zZ=e6@crul(S2A0P=#@~t#wvPLnbIU4bgwH$6&j0yeN!r_NQfTETe+=My}a9v7c#)?##p9NN#Nw%6}P#(TDpk?B<3zqWYY`jNP#z|gs26;<%m)jH=f)z{YXLn%>S$CqU@2RV)XYV&&_g@l zXt6(ha{^w$N1CJf;Mu=!9jzE0*F9Rqvn6AIeyj&fbaXMMzCba0dUzrdH&TOpypi@` zH5fH9^dBGR6Ec%y;@vYq6Dg1<8XX5wo8m!H4YrNRrxm!p33m7-Uou*R?FrfBC z8%D+2yD%(({!kkv__<%X zfU;n`{g#2!u>}7%y)esMI-bv=AmcLg%SUYac*>I|GKBam>@TF6eqB4hiwd!&+=$^y zbMQPtR*p}`M<;bOsX0T2+>Yl-2S(y(p!+iXS&l!KhjF<69(g3g*X{J1I;66GeIu{B zy5I)&mRP#x`6z1>)r&+EwPF?~#C(t$z<)dH`Y7B(`myS5ycnHYP5UEy~~;B(!$uFvseSrNk05+Y^BXvXWnp5PEC4BgATY;jK-YBIEt*ZO)uSu zQxgNTTtiN&j8u>;mXZOtev2NGrzeIykq%`=P@EYQvnTCgV`W|o&Wa6=lt#*F06Hgx zAMPIL^K17fQTaVLH*zxVDKwqruncr1%9=TQ;@KrRiTxiP>}9~dr633eiF!^Qd*XSFv(>7W!%g>7Y?$!!Iwkb?PK(21tPwldG>wgOW~!Q2>hqN%X0 z%!|3rG2>PS3u8iO2h5j)j@t{@%4|w31stoudNn9QTj5%n*D_ln$w3L?8%9O-8_UL` zuFIRLg>gw$4m#jAM?1aIMTIinYWQYUJc+LK(L*pC^`5+CwYzrBUD>Pl{TZucFI&w1fZ= z`X+?t2E(>8-zJ6vh($mh+Hl?bNn^61u&vBtim`x{VqoV5rD!T_D|19{D?o)5%%g%% zG!?d$nV;JVOd$pHn4l9)g>7Yy&25euw=!7M7PT_R1s%5+u9Z1Hu@rEuLi`p6MQAHr zD|2FID5W^NNl7bnu2710!nHC>6l;kq)X2&6g)(ksE=Vk;wEI@( zPhO9>??3Dxj~D(HgFI%@Rol2fYrUW`$iFY+g{wPuq){^res#CgdPFLD?#H;sEA5@r zXuYNwGkg}KiQA9@17xJYkXZP!UE{QlSbv{ z{b7R=|BNPBu|aHREMkKgSnLlQl(Ty1z-T|h12eXWRm?@S1VD{lVuN~m|13WjX`eIL zBUUjN;SvBic83k>kr`8byy-O(JHuwiA~=Yl#D1_rIeRK+1`R45R&0~^2!wJjWdzO|@<= z&TMo>r}rjk^Kmg2f&7uT1kMB4%)q9wsmXnCWwtn@<9ib{eN*sHHMG$q*4PX-)w-{( zCelZbba-!qp46Z9^v&_<7FVISC3%PS(N!qCyZ33}I7XkHkBO<+^)ZgxQ3 z4Dr#yy$O1^R%oL~w6F_os{MsS)8afjyf;Drq7~Zcp~VKUsdl2Pj+4yZ0II!3$+iU0 zvHfdCcQta7*&;x-x1t*Y=-B*K&`0`5@r@2@D;~3E0#31($zBaEc6=r76xy`e{cW&R zWw70AYI9KD`6sj61_V33lCZx?50DwNY(yy!u*Yj;P~s>>P+(tIQgn}w4%4G3T3w87 zT~nI^Or&69Q&+DW!5JMm!N^9DvJzXmX2ud#h@r%Gu3m|0UaahM)2l zySRE?SjIrr7aO?7mJ*L;&|uqEuW1hK$vq!>#$m_S#8l#WAyn9@)vJc_X;(j&N~)^Z zr8P5_ph65K_Gk4<{EOpBB?x=7CZ-b73!%cUtX|dEY|dmN_4(+;T`pnHRze0Tbl8s7 z>w5Ma?Vsk#5Y-$yZI_wWRzi9uRM>*mtA?6bE8(^>nn>l64%%g;GnSY^3mvvy4Z4Y< z#9}~%I%RawuIGAt5$!|RnvM-ug*p^nz^RbZLAwF&%w=}aLyN6eNjnRjUc9sT|N7R6 zj@ni13SB{fkDXRYKQf9bZ|t5G{$V^&?CHo|HH7oQOQQ>+Yz|?wRf3pi4U?zTB#IST zbntFwb$BlMt^-IFh7R3L$iDwqB6I%_ z+peZs?*CC?r1N$YwD13w(A@vKJ=ePapXqC_(#$P#n)`oumbk1&q_Wi#Sn)`qE3oYjAs8GB9ALR!f zvdd&|EoHS2U<>twxz=_6C_Ct!-GuCWe_5OznR|Z^=UVRlQFhRwy9pZR7P0o7zYU7o zRYudw(!skay<8n#%qMbve8Q@!U8jB!{);tJQ>k-h+A7L(I(8QhlpsnHlu$PJpUx;f z{UdIxAIg6^i#PUS>~$B6fd08mPY-_XG|+9J19@W)E`;+T-(5vA0tSqYmN8}e82;~b zh|b{!*F*JI@yrx+lGkUsY zdWhe!;%R#{hx*3s-#(ge<~EKhFPk+{|-^i~=_T=M) zsGIpoZY#u3NTK^I=&(4yd&t!t8r%3hGZlzI2-TNf)f~g-e8YWvhO+ooZqt!c3g$OL zHzHz5-Ap>(7PSO9-^3xtCIuyCkeZFp|Ku|^|6w07;bHeZ|E_0jdc^l-(&N*1EbBG> z%eKx>X?b*)sd4tlxGrR~{U;_mkmL5>+q#(w93P20fv^6s(05f^``(SeSv+plpY!r! zOS7MXFwVTiGtfMh+i>Eg+0_Bh4Qm+R<+{Vxv>kR*kP-Yz8KWkiNj@JC&{rn9K%OJuzp7xnV;ml6vQ?SCB{<)yN3k@Yjsj4M^wyS=*1t?}@3JIi2Q=O=J>s=tu21q>yHD zXb$HZ{J9o?uEQTUhckdzAA}6spD+G_yF_ci=~)UpkNVOR^>p1H*M<@T`ZH5~Z-0~d zRMXDV?Nz=-*>%2dZ^3s6=$Gbt{}mWLATHGH zE%*)r{l&T7f4oGGjAgpL1>Yf{zcklJXHj3K+gtD*0{qK!y`Pn!N7NO%y#?PPpkI;e zcjxj$J+Z5FdkelpKz~iHA7DN`53kkjE%*)r{q?zikojh-!yEJfEgU!o9Nd)a|IRz0 z8ho=JpoIg+fPQ7J52pp0*I_+C3kQw?2e;??A)f-O!>jZFEgU!o^mj--2Gytu<*_yM zW~|$b{0IU5U5TFBKjzaNxLdc^_yGa^+C)$7AM@!3+^gGb{D6S|{!Ab8hw^`&Zm;th z0sVuSK75vK-j{WIozDpHAI|jrsrB|dQXBe+Zm;th0sV$dkE1x;I~&c&Jf_?0d`3Y3 zM5Ygm2&fHxQn%OnjDY^>OuxI2KeeIH==M6F5zs%E=?6TY+R*29d!5e+=r?BiLC-gB z=!<%Qx&vmw!ONNc?}7uW!JG5|bqCCV{?$w`zN4oq{F)x1?tmH4zme&OLJFu3zo`eP zJ75O%n^{k*J8VzXFCnm7HoRR5q54oT@bYfXz+9St7$C%Zr4TK=cnlaHC=4?b#*XNY zd{_z8%9ntF^l?sd6CCW1ZqO&SP%RurIIup;Sp$P3P2aJkM)&h_m=@jy3Y;%<4!(=+ z!zr|!I%A6C|4hfDTJ&GNVPa4ozhNbnBb#=S>{vg=+_*()`s zht)#0@EPI2nisS1%%M8Rj~?o}98n5U@f2aeI4WaMWnnMW{LL?gsCx+*FpkL?wwkab zs&vOz0=4iZVIUosk+_nuKdN-c*Fx1D#yGGRW-MD#*dJB86U$-h-Xsc~lQRxi681)w zZc!~%-Cv9Y>(q=DDhT_eN_Sd4T-|Gm1n=~W$CZS=Ql&ei7OL(u#({Mfvt~50U7?-q zWnWa~&erX!mka^@xsl%7SjJObTcVoFbOC_+{7Bt9a~Q3@9g3yub%ACrqk|mU3t2m5 zxO-YZ?N>F;|H}{PUsMU?{J2jdTvO^15e)8@Wh5We&r4iV4#UoP8X!ljtdPn`*A%Jpk%eLTwlGo0V~+-21n^@71+X zC07~_9`Dpy&ESz5sx`GxTj0^-z`8qQVP6rELb^@&l*81$NfbEuW*lTgNE+R+`-(y8 zo&*S#bs42OIGtac?bm1z6ob?q2@o7Tlu<_a@VRS;K-L$7)Ex;B96gdzhNUBV{y$m_ zQguWKM=Hj>^c3)x8AT2xv5GWt!6w`h>NAzCy zQ87phM*#%NCppEmpUx4zl6_hX(!x;yf%17yG3}>wMD6ew#UL#l1rR7-(Q*3DjqqXz`^YZCp)tikDg z`~p>hyL5Yv9}v*rBlYxnLb<_zeBocK+a2EwFlNOj!obIU%&?=E_HXaue$6WRa1yyl zC~)vVK)8Nm)Qz#DXAf2aso8}UKDHAY!QgJaMiLzuybdGO!?jQ?9SR&+k7lfq0UR-e z18iL%jJjYODuL?$A{a=IXQc3IVz<+Hq7~>hM76R0LcnDm)o)N@LoIRB6jbf0x8v%l&w=&A~J+bo)zr0X)WpgP=-A~|v@lM9@ zFNKCT2RyUSo8 zeX5XbJIMa1UHz;Us+B{D1M7>F#VsK_q;~boN}#I07zWbUDao{l?2AUjzA1&MIuaN# z=Kh)MiJAu(=%zhnFVs^zv=pN1MPR@c0%2`;|c+)J^}=U6HBse-J$4u)UnlZ!e*kV3MKergh`J$sW^A5Nf z%L*_!J1>B+B!%8S{S>!N)cJ(~h0IGKaIrKagoPGV6fV^5&cWm)70v-8puafNkIvYA zcRta88t7%E5cNa^3>cSYjDhYU_s&Jl^JTid?tu}|U!Lj3QU=@Qy`mVT?nQv$XhlYG zk36n7)H+{P2~>9$!9cnuBlQiApi5%kR;i7?wiKf7C}6<2J}{;=M=*jyfBU!98#Jq< z`){~?os0lr-xSozfV8b4H|zEyKY_r*%0QrRmc#KQ)K$AxF&1)0ilMwcRgUi2bzHNY#CVZut?_xH~m#HP%iJ?OmzXe@0IA>~78K$Z3mbBkknSt_@n0 zzVOduQQ1cOC;N(GOVBE)yNAiDtfq$qJBDhgUfl?Zr zJF!c}z9e=pF#|6N#F4-E{jeKdG5( zY}Nz)bfR_3Ro&t;dagZF2vKt&DCVp9wl@1+{1kkNj4zY7{);wjb4#Bn)9=>X__np} zckm$x`_I}*xHSmN@uBmU?*$woz9(PCk8Ero_t$1jv8{7soBh`qZHCp>`6|Bbw%>P; z{~t*3-^^|7*wxl~hxvM*M+ZsNvBNlg6OI=OIyH-aZiAn;Ki1ZHB)&f17Qbz8!`jE= zH=Ygl$9DK(8gl#dC-{lh#{Qsh-A&VAf6~Y9_=#F7P3E5&C9yRXQ3Y zw>8H7wO#N@0{735y1zN|2lIbqjvm8QvyEz7o#=wd+ui85nWnY=eo4ROjrtY#0>GpxW>0N^KKmQ z{f(J7`+La##@vz~7Da_Kb-2#Lz#J=^bvhW{q3X1nuO|n$5Lj zvFGFhu+ zCx_PTt0l<;y;EE#nY#QBq-bMyZ2b;00BWjK%-Q##gAV!UIqsH?%m^<|&$2TmkeW0l zoV{meV=m3zY#c?2Aa?rgg_1uCwM7mc4hb|Hc4;0*#Pr)sC5H&KMgA-d?##|!nme9t zrv~Shk~;+2B6k)BlG*x8b2nwWyMNSNyk7E0p|;4O!+~Y?1k*eY4~)11O3lbyC6^}H z7Wrf#XlB!}$Z7upd;P=j_Qm&>p_IOpxeS5o4nsIwO3kifn!Bi!zF+d!x|BMHp_H1P z$25_u222~xYn+7FuY&D z)Sg3r_fIapJyCj>mO@lKDlquENRmQqdZJ`rTnW^|V~&K=OPJSp-~szm0>`*_Or_{j z&02AjKtNc|geku_&!9i-^}DetgP|vNxo&qpCi^)>R~s@4TwJLkM*MV)d52k14C6e7 z*-OO}!{F>{4K(Ox<;>9**AzlHM`1r;dVELeF%JXWfn@T|nX^~zyF}DQ9^h19C5BnYz?Qy(PvpPC8hIT5}-;#)cG~C8= z+iLBNg0IyK8X6hh@1T7T-tWNQ?K6gdhq8P}DMUz6lpX~H zKWmsWykFnG2k(8*{{KAZz=OKSruVtocp6!|s~pDrid?BIfbP*j%@KDv1U;_Smcuw_ zahZ;NITSee>6{t8O+JZ&x~%tCLT!ONrh)W;PMVG&_MVw#a1T~OZGk_g!QXm~)HBv> z_Hz2@ZS~5(;ZSnD}GK-~c|;NXQ!kJPaPT4k_N4^Vf&4Cr6V z^u0cd%#-G2JwV+7GvMHrpl=>{5Rb<7_KI~3uNH$8yyPG_dR?V7`<){yO>Y!~w07h` zpuDA1Mw}xWI^A3hvIUMT2$XkpimxCv^!9E!%oex`Rpou1Gwc#Y{j?8?LAJn?1%dLB zPT>}Xo&_HlgKU8#3j*a+l`=Ha=U$R%8ve6#nAWZs11&mO z!YLbtZ_0sM`(hTH&E48{iiYa#)oH-UahpQZJsxXjFH*8)xP-|z* z0_RATgL!e6jplH~qsoC=J7X4{9nGBPe*ea^gxFu+F9Po%3)MrDhiwvG|r6PZg;)|wNDF+L0WoZ5GW^Ul)mQhD4!-not~4+ zfm-_VELxuOr=Qud-`GL>{^Q^7XLjAUXEto}oz|vcaSJ29Co5C_=B=&fkLwDP@NJ#% z|j>VFOOUmGGKvukB>6`PWsO zW4oD)_7&4!`6aGIZ-Z9-D_j=uZuVjyF3Nto%Y=dCa*qu?WG>6>ZZ;Nfh5JNDiW4X_ z>TR7z;qHw#uG|XuwS7Oi-sU10euLnl!67;pdCLs?IMr1p?$R zC-PbS!y|(;+&0^0JZDoOgmM)FJhtiz!-8OfxyKZ z2>~yIwymdL+nb6pZVp2h5!#8N+?*&8^Iiw0=lh9fTr!ao*h?FDJA1B)86kabuZx^3v)*6}R(0-O^yYbP2jWfMYe6Cq* zWR^qwWuhJA!6YgiUn#~?E>m7OF_hmV%Km;H@Sw8st!8DgT+VDtG?7^k@uA~fiJaLx z4ae^e&vbQ?>il83P0fc$3f;U|hxI$04Rq&@(5w}%mqUA0terA6^7rA!%~y<$D_5cq zjM@0I7}#TCWpjjA57TWsRxwth%VH>xi!i?~8|$XhW% zrUHC{X033&9NG(GEsBffQVG5&w^gW43f;0;H_$t<*YD=+yN?B%2ht^l5EZ_o3cOr1SLj|3^cArdFX%4jl-F10#tPPHp}Q*9b$cjf^wqhs0(DyGuJt;6 zH)-o0H*D0rU#FUNasq(*hD05{tF+7TZq)5Hd_aJIbF6Rjkudn|0@hnJYlZFQ(B2wr zQH?lPs1DwySu12Ohjvx0H5G~3R617c_6l7fpuaQLqe?NIipd(yT48%Rw0C>$l)>rf z2gnKCdvcqjhRIy+L`XHT_j)P1Up?K!V?AN-BU97w(*roZSv(PS$!De-e)m zs@~6LrV7ytp?W@5xgHEv>lboc6=|fqz z#ZbN%D>1IaPiU%B?<-cvP2Lhr6<{@#AI8e2oOAvtv(@5ilpubRsN8yF(?$6-v(<=3 z3F7C8D(b|4ksBQ|X#`Emo4ybKmDi2*G<%1!zvRr3CO&MkC4p|%*QF48oO28q-=+*Y z^rw4h(77=iP0!tmA2bf(!&DvlP($YvcrsRo!{c)J{+uThT7~ed{T)a=O#XHBilBOFWT{s_HlBU z^nH9Zw{4es*Q5h^>65{k^m=H2{H$vx^;hkW9lK_lPKo{X^Tyf^qJ@tf@%7^W4L1|I zT-U;e+X-;$OxRz$bcPIgetd=-?#k(!wTKpS zkk6FbSv~#Jn=@R0o3isP%~~W2Ike}*T2yF{rmoSss=2}r0I1J1YV*zT7@ZN*I}lFm zprU`iZqM-=0{W#wk7R|NieS4ix0Sd-3f;v*H!|D|r^8WASf&_DR3V1)QlUgO30UeV zU#1vKSRsb;a-rOP#$ex2$OI}GSE%L^Is!nwLZ}D(%>-G{nMnJz(=(`g> ztqHkRx0m=a0{Yv9epZi+z1cWym1Zu%r5@-zgmxsV-=^<)r)Dmpr5@P++Epwu)y zq!^3TAcpc`sWi=t!%{9kq8N+VAck^-RJx|cfvIVFOf?tL5&-oRQf(U-$EK#~NzGbB z3pun;ORZ^M9GIG>XB1z=TY!E}aQ7XA%ab#+mUexVHc!Yrd zWvS<7DqQt(`%Z!2p4*w-;i3{wlJD1;hUPdh!%QiH%D6A zvM`$}&D*NI3>O5b-!*D%0698yWNZc&Tj1D8+l{0?(|ejVN9S^AKakqNK5DnjfEDG( zhq8M{w3YmqDDAb%#cR4{F1DT6=HOhqOOq54v)s3ck-wMJiM zrXrAqP<5!|s~_YK0C{j74q`Lpd*2Qd45{ zfLfs=6k`R;Vz=Mbka_p*#ou@%{_gu-9XRJ7#gamdx%>4i|8C{#Sq zV85#S%x*h8^r}IIk2!bE0A3<${Po9epm1^gLdwSS#d1evyB9Awbzd1c8ey zBZ3^5u+?^jZZA8K2=K3t^kRU*P7Ge7n#*(n0Q|a0ZC(X9^XUS`Kg6hHgV4 zK*fQCz{TS+K@4-)hVBX7UU480;6D}X!*GXf=$=;16?y;w{%ou^4VBA$YUrL*%@ue6 zK>b3j<|fMVsiE6g3Q=(pVZeAPW^fbbyih~;aw$Z`ON0UAm6##MKwLxjsve-?LNMUq z^;j=PLR>@lh902eKrrCotwb+ILtI0*xe%h}LQvr29Y@HAMQnfWUEQuZ$PwVbAM5=9 z2@(M72b#6Q_Ht-HinU^h#I|uC>-Gv=Ai)1L)>9!4<1C*k#tNCmz21B!+&4k(ll9 zD;S5{-xcdt%XPK?ccxu!MXB8g(uHXKK=MLI~0SViCOfZ#XAW zPhxI+VsbdQ@G&vE#d2N)GoP4)vmmLM9G=;9pin|}gi#@KbR@Q0PD`{SJAk8@eX%o-yw#eyh!%RF?@YDq7SW~$;2PClg);%_ySwK#_CLYLM}+`oHyR6`KCvKb-K>v+)YYe@5M^H~4bDDKQ8+%7k{8nT zMJdFVI1@BD`^usy-SpargI=B&Xx2L1%Aq|z*3M{#H(zRtPEgH`9o|*ZRB+A*0^}#g^8V?jbePvm^E5w6 zwO67Z2%s;D)i_mqWOldvSkXMvPtgNZ_<{ikr^Wig>4Hxk;l--Gf)50!&xqB%1Krc7 z_q#7lOlSB^J%HnD#a=Mr;OtnBIx!Q=dgLI^IfW3M1oydQRHr2dPL^Z{@51c#dY)=$ z2lk`!lQ7BVp z4!OHbz2!?wAzHa%3>eE5hTj>*OuS!S2+_)kqrk_NF#(5T2M^SJUZL76{6K*E>R63x z7~c`oT3k~ORPmFr;Osh$!`X?+BeSTZ7^bBwCc)E<8YSc#wXippg0%D#?#(SR1GU8a zFk6nURP7Z9fq)p^7StG|8k|n!lK9&X65g)c9bV~G(xW0F!OiLjgS$py=s(`k9i~7`7a%kYWAw+T=V8Uz!h>Ld{-_5`RPOc$ z&06Kh6gYTXAi}+}PpKzzTMKv~0R5DZCwIv5pDqMw;UrUC5I=WchCt z0<>_Fu;A$}0ZQ(W^|ZMVpoOP|1yAn?khoLU%e#uPg$Ka^{e2IZtlaGnG;5U~Q{dnu zfe81?#{T2n)&d>~Kz}Oa$sMx%&k6xrI7wLW^o0N=cgTABvJjw!r-TJhUki}9Q`XBj zim`pv9J%psBnXg8 zb4WaPbD181eQ3oNF2d-|su-rVtB{R%B$O~_f;vhs$9L)hYCZx3`n!VO4lfK)2RFPH z->usnUm16yb|4|a&Ds<*6uY@sw{M9XPlB8KC1!BeKr|wh`*)gakJ)rx;(U zZ2oQ1?OWhxq9?)4s}d8cmi6(PVr=CgFhGAJ25{A~^fwh_YdSMP-z))1g|aT*E`@02 zC!xXFyAqXDDC_LKQixX05*nO+AW@=XSw|mg)>cjg1r9zA2s_M`6yi^Gd)-Mwf}77$ zj4ygNC7*%74>t(+w^I6F$BMDeqZ=4;kgP6P!GjtK}mdY2U9V|9Do zNkW2~<5G+-dNw7;>-H^i<4JI{P+~#>v_4K$jIA652Iwcp04{)*zDO~)rZWTdQzalN zcGksdr4X(BBs4fXU80g=XPuo<3en10LW8rjBuW%N>*#FF+RBNbz`?l|K}$5X6r=Vxj;vU!1Kt)u0;hmh0xVa}E%1J1@QOqohV|?q#g)3<;pNDnzp(*<*j<(Cvq8113n6MLKxdbS z=HTPngb)VA+@RWZdVrdTz<`4rgkBEx*vfUIW-YO$9ORo5E$%$tvE55F4Qt*~2vFk- z2ne_41V7wBqYby|_7)DpIK!$`PpdD&*3&c^xVjXi>O^qBxKl9tb{`r2;~4!NMjO`X zcIQDEZ7}6ECc(|!0)x>EY6IPW{B-|4#UL%5Wjy%1SHO}-h%H_B6#}&Im9XGxodBVP zP|DnYe99gu25I3fnsdGFBq@WP|>cX03p|91(sd)=nAW1)EgUpH++%E{majK2{>DI3s9@;0v17 zf#q}p=dhPU`(mucyd#s%emO5`<_g;Df!-8rhx(fG+~ijjYb7&S4eo21a*}O^%)-3a z6>FVq)Zo6ED*2!^x_58o#wyilp?f>k^|-jwje93IR-r}<-FvCdt+q46%J1jKD%5BJ z{V>(J4-Y2MWALNgScMubbf3gJY??Z&f11q!vjY25)$Y(ZRZC1Eap?^V@IMcF`DC|E z_ZNz>5Njz0_N!Ql8XorwzSiv(xIlpaZLAN&`fj>*?vKsOJ|)@3jGp%ud?0{+SWxeQ zDmMe4@X~+j6eOB=I9xS5xbmQ;Si~GajtG!Foe%mi`#4fH*L}ns_?RCcd!Uk8^>P zJUU4+*6ES~z@h+{Zs}rW?IzOVo!5IOOytCW7 zaHejrJ4r}zb9TU(FR5sYSN{)Rn9iw%s=M?s{|`{%cu7Fco-y1kJ)(_n8W*x*xF2ixXZ7QB zq@Thtp>dlrG}^jo(Y*Owu&r}vSejjCRfoAU&<1M94!;$bumv(*+Nbf2(f@aU3KNc5 zIt23l3=b>lD5{Me=60ChCMg5>JmVfEVp$& z+TPeZZE9uXxu$6crue@ zZJqxYj*D8?(b#A#*3(4eX*LX-4FgA&1y5hOOTyFK2E}|LEjPEG<~15CwhEriOh#Mh z#Q@H4H10DN>uHklv>JwGhT+ESE#*dcNqAc6E_qL@8jUly4xY?#b6e++8#ofH(YV%F ztf$Gw)Bg#>Cc~I4)AW(MBs_iQE_qL1HEh8McYB<@5N@}&Btu$ulUBFC%@c zaQVi+YHXC3r?z!Ify;BZvuO$Wwbot{?esbqhBn4Pf6`{cdVA6J$Xp(7m+bn~^TVc{ zD>errF8zzJ@6$u*yRFBchw;bl`!q^BaD*cX{$KN(md?{Zcvy^HCH^V3xXz;+!%MBU zfBJiWxo;Nlrb6Qh2gKJ4DAqvm&t8BtO!*sbT>qE&I(KO8xIt{QF*?{^1fA1IgXD7( zLpe@<^5zd-GTh(Y=VlFPPUv3~LxJU0ko;Sa?E8m(4?1|?ee7E(4L<#QZsUZS_w^*T z!vX;He;76TYTfj}6R)2CGckCk;6*aP{+H2o_l}O?44m+uJhwf%?nt}3@teqIZ^L0h zKrmd~en-l=!{h5p#!+x5F*|J9cac7nXzXnE-Oo6gbI<|ukdv*={+d7iPJ71*#P{V* zWNwGsJgyC$d9!&Ony+o~?{SSy?f3`M*A-qRo-td=AyeBrDSWz%+}7<)a|dBw)z-c@ zniJYX?os^NfIpAnk84X%3FM}lcZ@R^P=wIHjLaMovqg7iCSUk?&`;5#eB2d;Gu$V$ z<^zYjqw8_8@g%DNWo-y8PgbS^cyDSdu)GeM`@LpDmeO^(t(a7)2KGTAjS~A%Y|vvk z0moEPy#nZA5#Gn!Ev$Ydvz2gO3E~E?nwX{dvD{Wnu~Y;5gpfulelj-bQJff3{Im$~ zy`&DfwvadJrUW)a@U+okyJ%vQpAC8GAOSM8Lg_`Td# zOtDl0`+<-~DgH1v=uzA$r1)bI-pAXe_>;_5!g(d4_L*1hoTd2l+*VAnR0I2^kVYx~ zDmLg*+&QH98xh{e+oky1%vQpAC8BodR{S{FB}?&PxviLDsRnkQkVYv!A~xtz+$E&= zC=uSr+ogDZW-H;m5>Y$Gt9H#&d~9wjrdX_wjZqz96%ea9)Y1UFcO4Ww*&r>s+K5i)oJZ zATN{RDAkuF7CoNeSru59NrjKTOZf8KSR{HapjQN)>_6G0U#S?&Ntb$%uae>@=~pL~ zLPSLu>{_Yt(RWF|E;km5UW*9c5OlI5Ws`oRVk{?J>OsC)ile08l2{566@9T=rNT$w zCH=PCSR{HaBDgB(WRJ=weYIjNCtd16zEg^$q_0UVg@}qy+1*m%qwkV_Pi`y{y%rI? zH|S*7$|n6j#aK?d)PuZEild}IkXQ;46}_{Eq{2tvC4GHvEE2sI5qu=*WFN~W{ZYkO zPP){C{FoF+Nq;=C6e23RX-`UpkG@O#Q@OE7^jbvlnV^%MEt~Xb6=ON+QV;U;QXD1y zg~U>bsOYb~C>1{XF6l4j#v;*c5y4GCCwpBs>8~ipa?+(93HOu$X}!uCAKsp;APN! z6={ZfB{+@kf1R1iJST+e+en3x`3ZJVnD+gcyR~^|b8#@XGLogx9hU0c3N_mH=J4EB zWg01TN2EHpT8utsIWo6ZnMMlT{8TsDrk!>lK03EmnMMlTu|bEySHBLKW;zyRCP#FO zg?(lRAymf)Ro~#0DO`YPe&U48RES~_LUp20O`GAit*2$NCnbgw%!!~_6ckOr92>Qf zisLDnt-uRPs7|x0k=dieSjuJo_BC;FZga?8lX{rQ!9BxjoBh-KFq4TzVojHDs)%PQ z#sWD7Kz+7V&zNPv%^9-<`JCKV04H*AmssrxRlnW=Uy>-o=Vc~GbrV0PB*j9gE)c5z zJutcHmK0JITAJG&(#q#d8WoZxvln8r7l;^oV!`}TDl`Zeq}88H_gnItjLX=9~#(+LA_cCv9hf> z!)+sGmU3T{8<}e76T_VgT0pN8y1t%iTo}yJ7}saE64EO{yiur7NJg-6vwN0M3A;(L z7V}leA-yF?C!|$jWo~0?l6)Zr^ERmqMcSS>d%I#R4R4vx(cFyUv__BjgG44wMam~12v2w`*rz zkkU}V@dYIHU>;Pg49<#2P(!(1Dt#$;A67n`8;ex01@uv=6J;D&sv;XSb2*O%0OH4k z7z-!k=fxAbjj>5C2q~CPNnI%Cwvs%p7z?>DF|H)fCd#OiJf|3I*icDckjkip+e)%g zw>x-RNhW5MLleRg%+nJLhy-kl8_~BxfdoxRRWuSUF=9owTgHWCyOaO6ten_!$#;EL2o*$OdP$FG< zenhb{I4d4Ojqe-&Cv&&WcA+qkL?ZN>LnLd45|nm$O3vz#guf)5Kg%at?^I?jW!CCPLYLt(8QYng~ zE6+!0=5lrj0N6(b@os5(o}b$on?zVh!8}Il((-()Vk~6CZgF`&E>TA1`FO=x!-n#_ zP%4%3e4=i5@U%SdmX+s|bA42v7wLA+>9owTgHWDNO#pFuK25Q5#;EL2o==z3P$FG< zK0~oGI4d4Ojq-7pREpy0%JbQpxttvW0QR{-{EM_aFUf6;O(HC$V4g2^X?eatF&47n z7jb#MFi}S3`69(w!-n#_Oe&S~e2H#%@U%StA}i0A<@%^RFW2py(`lJw2cbM)kpSZI ze5GRLj8WO4JYOZHp+vg!e6?a_a8^8m8s+0!sT9T0mFMd;b2&Q%0PGur7z?YD`J@{a zBZHGDOEIuFN6NHJ-=bLyc>!>cgM4eMjf(Ycnzc#}1$$MbRZ8~iLIB54i#B2&K@j;n z6+%?F*AxP9uBRo?`v}GR?i3N1?|U>e=a7yMCH&q<915u`;`eE0X6FSa=#e$+BCRN- zu9QEZ+AH}Y5Wqhq*Y z>G)92UyQ_|oVs%Ul4fRhUSNVAS+gn9ibCqj`75fuk}m=Q{A)rk<}YnIe_b&$IgPdu z1N&yAOw0LOnzfW4$^7TrsWvL-?`YO4Ih6DFBCS%+-!BAk{H&bwBxNY)A1Z{XoPSgZ zz`33kMD`KN`6nqNF6W%K z7l8o&TOk)ykhYx9{h@zRp2$Wfr_pA+{gnT(NST)N!!>IuKawfTBT{Wt&X3frRdOij z^CPWN&W|nxaQv*C^E_iH=f^69sGKh-1mIlH3L^Um<^1>*5ts85G&ARrjt}Mh#7G>< zsVnCvX=Y~U1t#cG5En&SQAk}mKSi}y@YNK*~j%KZrLpfg(X_az*ULkdN`$s=bmg0s;J$LM~<( zZ8=||7@3?#TZn&7r}5_njJj4)d^Tc69muN)CYfQAO=OSflTlHmK%SaQtAR;QS%mvx<5r`#lG(Rew%3w}Kl0)Gz%1 z%)JMc9>;a(JA>iV`pNQnT0TFYJ?Fgxk4*)@7O4qHlpxv@F=I^9_YD9-hW!~LAPE)- z(jY)nYps_#=bR&$bIv*EoO8}O=XXO@*X`lm)<4C`KtcEu5jzFu4jY08+mJ)U*dF&+f?=vfsoRs`$#F3%rf=-c8w0-@zFwFW^1( zJ*0Q8+RncEKF&~i0q?CJBE56hcJ|kgaE8hYc#r)A>7C2Av(J8tGgMx{d+p~)@7%VX zpZNO%XQ;e@_uQ?&E$j1Km~MBjE054^gELfKzsDq z_TimyhRO?gFW$xK={@SvP`E2hPSP!a3b#8@dmp3ZJz#Pb+&kD_Ky8M?y;hf!g~RCEoy(tKi+%5eg>11bPFIK`U0rEk5TfMFu4lu z9c-IFHA{YXVKWqN3zMth-nq61YBLn>0F$fW-m!K9YBLn>43n$i-l=v4YBLn>29vAc z-l6sYYBLn>36rbf-kJ6WYBLn>1Cy)Z-jVhLYBLn>50k6l-iZzbYBLlb1e2@aekeQy zsB=T%p*TYoKN|`UM|$t3JQN;*GgMx{d+Je0Z->I8afZqZcyB!x>FrQ>9L`XA0q?QL zBfT98Prw-}FW|lQB&4@P;mJ5d^ z+oA9roT2gp-iyyueb4Y1zc_Q4Uf8F1A^1k&`NcHAjijWzFwzb7xjP$_c2O~{jHy!6 zT@rM3!Jg5PUS;yFhD(cS38s;f?(&?DW&w)in+sPIl04DgQ|GGFKTb)qt8%j8+*yFD zi)oGtkX}m6Yje5Qfy{TcN(R!2|AlV*SrfPrm#j#%6sz4oJHMR zO!LsF|LOS=Yg6~p7z|_Myi0JV;DojhIUN zVqTduu9u2w9vYbeJ$GS^>y^CF+lLz0t02)~5!H*Stgq*ldEvjg3pN!MNVdlpRImdJiPx!sf)(1RumoYg`|K#8PZ#Tpt^yu@5z_Pe5V{ zYs6IA&+^KgaeZD)^U%l)=wSzITwmse-agd0w*HQ+WJw?@Npx65^YlplpZ(KVT6Ma!*;}UEzuAMVwXVJKJ0g1S zohg>K%&DUsuxpP56Ua^ z#&vKp(HAyvTvFCxT!-d$dE+{)nCOcd8<${%aUG$``gqs)Jo<2b_L6=*?Rz9j4P@I6 z1p+n1(Rq39O9aOh(#p9iCg^ci*dCX74N7(7nWllYxJFLo6Y|9kdlv-9Jr?Q?_)cTzVN;Yuf*w(@Xgog7nuRy=#9yNqId^ujKpozY*zO z`^#C%n{bB83-}JW1?gP}$hRAA#ThCu;CtZqSWo6V>Q966iu4Ygq4WY7gYHyLUNY! z5uCwapg5e;OfW#GgpcI`-Sg@T-4+&aI6V$hJ-aaUbu_%1luzcBUA^plj?7K}6ihE+ z2Lh>|$*b$**#|p1xY?gY$tCPePul16+AcGH>EOWm0!%M~2Lh>Iiqw8a(7`eDWTb`73Zq{X_S&E zsQFmr=T?yw-+fQ(i(+Dum}#kiTmP9Xgt?XN#~!un+knJ$)vcb$+gWk0>f1*tiGrGs zMeb-7S@B)fcPb_(iJ6uPxJ%I4k3DMDcLj;*s#`sgcemnP)%S=}5(PCMi`>g9vf{g{ z?_Eqx5;H9oa9`DpEvOAQ#um&QtM$6kfaA!1AQ4bwF)0toD|@5A*6#5~OChI&Wq^W2>Xo^~EyOmocqN92SW#H2h@l~j27 z7F5>|t-)&k9tWi#h0{Sh00ileiS@msBkm3tPu7lw$)$7;AoZG9ojvZ!vxMVOYAHHA z?0I6Q?OjmoZBX47jMD#R-wQhlr#t#gJ9?2eW=w5br)jLIsi~!@m;T+{)by=CYig$d zqd)lX4K`Rr|G#(XmdiF-x@ctemYc2GY{jDCX|viE4X)T^`RXN07d164UA$zI#>%C? z-rzT^Z~E4^zD0yZlbFf>x6Ze#AqLU2*`}LswqoguRX=I%stvdDpUajnUD-N)gSHv1 zt2bY=c-7L@8Ld-(xq8|1C9N~3w@qyw-)ytxlzHW*Jw2`eIBiMijLw<=L?!vfPZq6Q zwf?H#tR(oNUv9Daq7|HmgmTs|VQ?5vT)so(o%eGv)auFp+iTPiDbHzI6 zO=`KLdEMSg&FeNzrXb(6?)6QR)@z!qUq5W3gh}fSO(s)qT6ci{b8NDFj!pj*khwC3{nry}fDOf1s4xnp<9%{4GtB^--dxb(hfZcQv={(83)0ofZ>K>;9g8e5!e} z+brUOx2*S;|C?a^_j~^D4lZQNdLQ|}J2m~Y=9WiVxYPvY5wB_8ySZ?aCbJu>Wba9n z)$jDr{pC+KH~stINiB!3!-RFRiqN(GZ@SjuM4`{>xt45M@2p8p|Mj~I$&^;DyV0ao z@?T>z)Y4V2qPxcHuwAjGJxKpNME^WY|Fn?JeY?@Vh$ppQVhTd$OIaGa8aIT>jV4VvLD591(oSd@@pc@Zg&u!?!L ztY{o|jx44nfti$aM`t>E{N5Lj*CfY837D3NNO7E1WHFJKAZy|j2Xi}yz7q%*V&Msy zrhDO7SG}&iz{AdoaSAS4kdfx(Of%FqG&sliDI3TsaT3M_9cfO>G<~7aG~M8SJ-v|T zfNr4mwKYmootde+7i4WG&p4hHrC?g7BGx&XVoohPEh0;abE6bo)l5aK^F&@=5|;>Sd!eH=$JipNx4KNDNqAK{;w( zPT(s8=jCfrY_# zx+pArqPn_M%B5ok}sUypW=XV6HEpT zPy~?r7NGWbMkx7Km|O+-w?%F*sQqmno&?{4Qp?dQC+%HDtt&N8iSI_K6=YxLdvn?a zbF;SQF1!yUrn#Azln)e?uDpB;@IjDRj`gK|IHzRWpo0*4nw6)^kD%lq4ZEyEGsXl+{zc_>Zt(w0M(EH!tiL{mEL**9_vDGGTkS`MWK*H?R9H%{^(~ zg=b#Z$##)OuO>?1`5HH;{`Ys>oNP=wPq#J>k*S#MZ9GYHu&3ysr^8%qbgU~k7306z zPDW`SW=^;q)0|JpcWOS3OpNU0xSYZ}3ni?H64EH|At&S%?oKj$^odbI8s%>tpKKJp zqgfR>0-sVyO5rjgsZNVjuA&@xPcI~u0exl9j8v|=>|JLSlFER-%ID-%w3TCybDUdD zOC!CMN^*XzbJgbfeL*p;l<6yeQLJ+{mtz|j7ZXdNzVerf&JFgXW4(UJ<+;LT#k3+b zmXhv@Sm!FwtLiI@X{AhG`Kx1{t2|rzHN~`2rmy>Tu`V0E+1#&3sij;eC+&?zt!o3e z`1*QK9VoR(F3PD?cNMk9BJM`16=dHU z_ZGFrF789A6=dHU4@BCYp}DR#*ft(SsgCTX{1WoBn`&N8+J}o;*Bab|kD$~FvTu#Y zidxqiJR5x+rB;xAYdjfgYxA>-BNzH9lw8)(UQgO*idt_Rya0R_C0C$*dpuv%y7rK_ zrM-ZXE6~0{Uh>*HZFJHNP2(vq7m^^;3aOs28WlOwNY=iT_F6G5g$z>Cy^+^tlYNev zZx+)^m`+N%w~dY~?)r+I;+;ZLikJyW^`22l=^c>+<@?376f#Ij_hDW)R(DLc)sKp4 zB}^wJ-6uxJuDlFN$d?WRQ|>>q#!`kabbQSl!z@59iwy z6HA~@`$yR)-fZ*5X6Zq5^*>*$bw`kYQreQvI;}I- zp^am|`0yLTUo?$zcj<<(tU{<+nx3V9o}+)B4{MN~o-Vr|eETH%fmb2?AAZA(`}mGR zQof6UkW_aCRab9st-c^^-rikEN&th9fcFN~*wBbCAiMN^aY_Q0$w>2n(ag>E2ich) zj8jrHFC)#vK{Gr$;&u{vsCgtxNU*$!6psZ(ePG`Bcwf!zOFUjoOc0Hhpic(f@WN@0 z`U2{E-J{_`J_S+}SgR)GGgdjP!KsSn$-%S5#3VJ-lJ5DS8(O{T;>N>NDp+J%q zj~(cXLQ;YkgrwTKC2NT>n#((nWY5_qPD$asj5ON?%|P9;*ju*G|DGT@3FY501lmjU z)2*_`eEOF=vCnZ}?>Ggpax&8F8#Kdx0mu6j`xTNBydWgi0YSy%;Ba8_O|}D3Y66>+ zllI`C9qtWScCYM=1%KR}t&TprGdP!@L}AKPpa2&@vt2 zjtLrVhK$J0aV$tpK&_gTYgE~@fP94h#i{1_$nhxEfwRN2I&X>r#6Gd8cDKHzO;19} z4nEVL&nUo!K=4yCHI>^<%Gl;l&HtV%tQV2uG^=oxmja%iPe>JwP@*E#nW`9@J6@-| zCG_usVRP5yER>oRQ18uaD2?@mKBpiaacGXT=c3dKwCYKGek`8vOD)ZC0ZJ}sI{>jS zDu{itWnytLO0HmM<-SzK{SuP<`S|;0Tj-gu%i~y!Mq?L0zD(V$^kvn|Ht$Ssh zQic;9iLO>reY`fE`w(PV&9t+XOGKu@>qOdACy_{ms2-6r24YKbkB@^si|x+qB4Y4796e z9{Sjl5VIz0*wBo#`H78Cpue9yG;g@8v5>z0Jm4zOE7zw-F8KNbEe|_x?xBi1C~1iE zkzHxVfANP6WGL3d1~*Ld=RRMg{k@mypO@V}-=8)bBl8;dg?0BB#d`dBMuYY!TBl5D zn>RFjHhEF&?^`*;Aa7mJEeFcr_Atl=zSq}1Sel*EL+^8c`>R*t9ikb8=>P#K*wg#1$n>htQ|y`|;REJ5=(J+-m%QUzxS`Tw>)HaJ|G zpEHE~KcW&1l;-CQA^-Z+VD$8Dd5gA({6C&EHaP0?PXqSQ-rx)&f7|$Q&G#72&ly7g zcKXwoCz;=rr-Sm-BeYWfWd4r8@1*?n+-Z6K&X9i^AJJ(mFOg;mn(2cb^a;PRYjB2; ze+K{uF{aIcE&Jgndl>RKQ0cQyL zXV0UjLCb3(IfCM6{C9bgBu7we#DA9;N^%6n-|^q&#w0m{;_vzIX{DwiIf9~#|DIl{ zm>v|}te8=$m=P2`te9D;m>CqkJzaD@iTJWy&+^XT3?V{vufqGT>B}Y)q9j}d)SC}(|{KNGu zz{~Rk|1NJO$q^I_x+||C zIf7zi{=57dk|QV<{=BcEVL3y{{|oxF`~sXI~34;v7M-h!y3RkQ_nrPZT(O z(8gWC8AASl=6l`rXR@a$J>+h1AgCx0=Lm`=JTvYd?d5wH^gn#5M&AfM2|916b@ptT zH-}V8)Xim@I4_Naw4&*&)#lM;k>xb?E|>o*FP}fu=xnsjZ=Es|2`N>#4}M)xbu?y? zYDTH*H$XLmRMSgU%YbScsVHI>tCp4UUxBKFRGp=&-vSl4Mn|b?c|p}KtpWQkE8(U< z#jOFmEK_a4Dn1d;h9U>;#|F8dw=y!D?Cyn;p{yz>+Z%GdtxTI>>FR>CLyV+tD`O^D zx+RcK=UQ&n9oiI2|Ggkp(`?(Sze>7QLE1IHx0kQlUfE9n$yyrt#|9Si|I|i@`Wp4| zUjA<(7(kRuedB+o^#f9ZP!^X+}61?*&f{$ zXxd%pr8EbNW)2M#!~Ohufvz_CUs=`4#j>l#IkdSBfohu33^#^H>w|)zp4W?G#Gw!& zD>PwfrK$7FAcsK+m7^_`L*~ldaJU?YV?=K|KUA-Upom{qh$Aq8=B{)ML7IXFnliwV z5Wve7npSMAZcL%83~^Kv(cV~58?Q?-Waf}=iK8JyR^j#DE+K4KUW#KNLH3)dF}r36 zqpO^8EM(|Bv1dR#q^BHl97O1Jwr60vl%lsBu?8Y&e%waURR9##%R1!v7|>qnUy?)p z>jbD){~D}ISZqW7We_Jqg!3|qPD>)lzj{ji%P>xd4E3*`A*l%RFGDy35;FgqDGcOahH)lj zc>mH4LH=bBXF-JbuW3>WX3dwzGVm(VuIgyp=k&5Ed#g+0@$}`1F*!m z4C3M>g4U!Cfrc)FxCA1|waA=GhAu<6G)16*Kio}wElJ-pkjo&%`<8YH@-2h793s4L zbtZkwAg+iJot3U3In*_-glch(x;6sx3tTn!207!H8^!T_$p0QC!P zL*y5Ra4jZ~U(oB|q!W-|7{GN9png#{<`~5FNd(<3E%6J3xB(*6FG_|SL%1Qc(>60KyG0WH$#MX3-v5CzdoA zV<(yy8p>@kWm=_kN)C0-+o4*Vvsc>@Ii~^K0RdsvrFB65X&`q(i1;VnA{Z_kybR?o zOd%)r0OX?va5n~!kFMy^MHBK-1GonQbY7S(n$W__Fz!t<=yq0#lN!W*5J65#E><#l z8N&ULKwH9L{fJ!D5FUU8Z3fv3`1`e@YJZ&qtwJ{ZoS!@=pVJ3AVHhLBanX@#Pbm0{Zn^EkbfG)3lQP`Q+E`Qe;UM#5F!3a&rJ1goE(V_)fCPd`cZfNyq2ya0G2hDcb2G*d7_Erq! zZ3xlno!>M>9%c~lKm>aj#ms^9Jl7!Jg$O=+)!tY@uiX=~LM~<)??J}+uoeJ~e@6U1 z6w_^5^=>q~HR=yy^~_4olpN}rA40WyrtWPa&oqFKFd*|xI^EDKck|kiXByDQ5F`fW z9Rn>v4dD|^AkQk>v^0QEAs`>|k!KmiXAqHF{UOgXgwG+tc@}K|r#;I+zJL(#SvoO9 zo@EeULWK7$omru=%OJL%6y5odG&$5*?pcPh4P=ZDYXOjF8S%DIOrE8Uh&;=vx3_9~ zLZNF`sb^(5)U$SgYB~f$FYAzyLO1_&bNfiYBh>4$k)8qV!V1Jr7{SBtP@j|`cJ8PQ zJ3{~;EF?Poc z+H(yXrg3P95PKvMbV4$*Y>g0mLWG}B>R=O(xe;P7h~VQ@4c(H7XT_0zZ>ZPvSc5(4 zm2qT=5c@y`4VI0*jqzw30rrIea%=U9*sUY=ezAJPO1G9A>el;1wYasOvOzv+^ant_ zcWYe|R3Hw-2y*Le9|-xiDa1jLz<%vVO61oDa4-glU#D(TayJ;nAsC^4tv-qT+7J$f z1odmGN7}Cq<1ow+zxInf)=e1X*G7L7 z)O)|ywnTny5Jy7<4b`Q7Z2-qWKz%{)KxUW7w+-Rgn9yE+#)kVrv#56;hxNJ`7}L=P zd8cKp!3+rzdW@ioa6BgXAfYSfD#!^52!)9i?tTi261FBMVnlX~n{HL2IAIYdB@i4b z{2T&J04(F=1VclGdIt&>mT?MZWWhqa7EJ;yaHkaSjZU|A~7Ru457GTDQ9Aej~v>tC~{cHSr{@-tN5}xfkm8+5%&C0 zyjqC8{~U~v0OXAo1t43Da|;YPLBY?i$&5Qbbg5rkl|)ei+1s7{T$w-_nKg!yqn7AUJ*`HtgaSy*Po;@S&4t7(PrfF2M}9 zhDaPaj0B{ZXmZ~h?=RN!$31NkUKC$&D2e%pqU!RotPnJ>U|E{sbSoO8M#~e&`u5GZp^SV zWoV}caSuj#JJoRt&Z7+EUJNnIKxm_ea33bHjrKNlhXb0ZLEK+J$j$z86E)`n9>97r z(O&$ZgLs-jJcto&pl#)G)Ic7>5HYS{zsmuw%RnB+kldgTt;;YT!3?%8zh48b%OD=b z2yb1waR#l+Kpw*ou`b;_gw|yUk7I&b*H}6L8pIO?gxsbsw=Q!h`$?=<>%zzU#kvgQ zDU49-Dh+=I@-&91b@>N+pmiC@GZ>=Qf!}PF++LDQM%pJTHVQ=qH zOTeKCgm^cJV9P2TOG1eEk_dWzSvZ+%j!huS`!Pk zW(M>b1d)&APeGbd4K?cLDN1L~)6BSrC|^K|y1d^gK`w8q^Cd>eJ3#!V42@*Ji9J!>*X2QAgLBDC(F}>;?%Ob!bhZWk6xa5O#-z5O%`RF%)(TXb%XIu;ccK zQN%HTJt2T&ML6Ao!i_=fl|)PrPphJMV;Fm5hQyn!QBlA#jC~-3-|FPI+|m5P0QQ9d zyF5bC#sKz%03U4%`xwZ=_lJnwEC~f0Q-}i~0UXFgmp>4S>3oS6-rNF0>VsmnY>kvg zD6@HTFjQ-VN>51);1CG#0ZMCtf`dUEnnZB0Z%@Zb!#E5xG{9(>L;=PS4u=F6V6+S< zz!<_2kPre4&HR;v;)~%N2{{s9{4@Xs7(+M;5;Va0$p{KC261!}K>^0UZUO}u!#D;r ze1Or$Kmo=uj)jcuwQ+PN00kHWI1U2r?j8y-2CxPKe1Iuz=x07^5XVDAZd!%{j3Jx= z3E*5Ry8MYyOaVp#-V|W}9MF> z3lccMgl8gAa4?9oF+x{6{+KKZ4u)|KWN>is8`UT{7{Iv@Ai*Kq>p|hcAkKpbA0E`W z%wA;Xp9XP0MCjVlZx^BXU=SBT1RZFRT{E-!h^~Jj6r*$NNPSVPmR-%#_+a)uFNSK3 z59tYr0bBwBK0FjoxMnplh)Xd-!-F~{3J->G86>#yppzgJ9t`1fNHF1n-mvGkS5Sa3 zq$?mv0|dB@gc{^Zh|mDxwh>T(Fon1Z5;Q>g83+mx25~h;_yD2(f&zqLTmu;#Abew@ z0AT>vLVyH_?34ux5C(A_MEC%q)j$ElAg+f94G_LHQGhUr8z6!Xy(9yK5#I>K6d+WM zCJ;t_Q>>Q9$w~u+dEo43sP_I{IGmc9vq9W~5#--=G*#aGXJ5622)AMaKXx`YR+lD3 z{%y)|8zk_FE_n@|#%bi)hH*P&(8+0iK`P+ZUDGlNth+wD8z3Kz`rJ>wgLMgkmVG#F01i6+@Y|-|l zQQr^M{)CUdad)dWH2fRL0}!G^uR_fs9xwnU)+BVb06%Hn;XL8kf3hv z5y;IA;t7ZlH+OeZk((R9lMvwCT-yP;xgk6S3Es`sKaiUn#M2OA+*}KS+}u!}DWR0z zjWCF3A%fgoC#cBHjruvL&fMI+PY=1dfjkc(y49C|y?Bgwn$Zbl*bM>eYZ$pBQ7rF|I z<3)sc2O?U1r)aGNzabD{8n2?(q#wVB|ZtBNU@8IclN}ceJ+Hh?3kc9e=oe%C5!zQvQq+*c|3h|Tjwaq<1J}t zOv-#7&%onK?UJB~*JroCklWj`?3$*8SLY(Xw~*a1L_NRw5GZWk-7$mAJxn!_WU2*FyHh5OH01b^fEXv#xCDLBl;!{o;(> z4!y@v4op+R!)efa4CEjTQST`}1R1=?Fb>8H@g6@|K<_b(LokC3KYyMV4W8|Wb13F` zFVyG;z0g1o!w~U8zj%ReXc&iMhPYw9f3R;zkG(@bG?*hW#`s}kaT^=&kp++(&nfpq zbAsn6tk>o7m`+Qe7aGRVX$HN8X=03HFhiaz_fNQ1mE%~<$YRRGN^)G9BIj}@Mp=`f zNMvf)-47U;OuHVB8T>UsZ>}&T8N>+*MCv;-ArKhIi5S9ji*Q2;hBX5@DFKn-=eun8CL`{TnJ_Of!hnFhWC#?_e0y4CHhS z(XBrJYDO5;4CIUiWPG?WUhC@V<6{L~x{&|_n?aq4QHj@1L32B+fRIx;sDT7bOr9()=MU(Q7%bPa+@SDrWwekX$Zx% z)R9A(2N=p_n4&SwP559;GmOhILjuy+;KrpP$zZO)7$1^!{DdLNK(0(cav@1kFeDk& zRT!0cV^#=B261%(A!m@vLy|eBbPd*LZj4X!Ngo@^wP}jD@x&8k$JH$BB2)>%1sGMe$xZGv7y|YrqI`t6AwSe zJ$ws>s27L363~%NS#HG`?}6GZ&;t$Rwge>Sfr^42Xi&FfRN}o;&|L1o2(lF2AB%4S z#w~j%*2nh}<2(K_=B@%p4*Zk{0&^zlZmiD&0Y0}Ur7)Cx(i8~<6QkUlplBe_*a`!I zDan19!GXX(2m{A+gSbC|;6PA(_f#+rgLnWV+ycel@PKi^P##QB^4m8s4j9TqX-a4I zP7Jt0F_4Eb#K!@5+XIFHLwN*KI1J<-ABJlT!+A8#VROT031XXlECI=d6Gg#rV#@P4 zMkU^41uf$3g-~|YfbF0~7yvBnO;zfv{ zwxBQW)#d(_@m>UY2?BT*INS<1u8R;aLj<{hcv8XaE+E1ykdV6_Z`>XcUWEidhtMI$ zcq&4?1`)EJ;2i}u33JB~F~M$h{zmV%^NwmVeASS?khR;_B0(gkdqt8ZZSkQ)=FK}Y`yIc)#{>!&8n;^ z4PXxl5EpgxIpm=RuqOnlhZYy8s0e#Of?Xsd2Q@|58v?{Zv*$IDiyFi}5TP#WXA#In z4Psx2a4zaMs*#Ht#(t3DUDPdXk%t<_{*WOa>c?>8p@wh(B&dga1oBXWI1nPdhZc6G zky#uB5t)aobt4Zo#W)x;oQG1sraja^4v8VMcUS76W_RyUs8$ax+!e~&!2k|}0P#@w z?O)`f25>k8sE6|SqmvmliWZg7u8o8-K90L*Lrtq`#s8f%H1ai`F^bR?xDZ_D)z|{z+2$7Q-#2Se3PFmQ! zM)f!zA~Gjc14mA3ig5yDsFV6R9vVaq;=~vsn@6QCYPOe7f@*cq!daB86%62H2v8T* zSchEH08W7b=b{v+(k^Nsr$UGtwh!CLunpogh)}~WS-ly;>5w3X?aP1++Yrux1T}1r zK!$A)XF`NGYz_KoerOP9K}2TQY8J?_4dZOcP{VdpBV^Zxa868+=POI?+B|`IE>x>s z7oNDt?Aid%!+`AQCxuJ3Ol01Mb3Wwg?8?7o7>z#$aREf+!yOud4B|qFu&+l) z@vb21mKz~MJwveA?||+Z0g@_vrA0f`x@V zmw@EHc!ey?LY_}Rs%*?MUMMi+4qLgAnVWDgV!bmmygk5nZlBM32{X8B!+sAMiY(-1 z45=K9EaMf-P;2*_U(nc1i@b^M@gf~+>n~%HZ!vw^cDW1>AkdH8= z>^MP;__%$UjYGo*l}jVD{OPPZJP1S6g$h7l_aNNKH&hKEn`R zaQdEwrfv|QClDnc^?~*I0&{XBF0^)2mM<|QJE5x<0?pk}w*HnmD-l|Z9j^nOt%cRu z219t7Pfs4Wk8D7%F(ug+Lue+X2bto1(@jxuviJ z)@w|5ub+ozY8X3WhP`VB&D0=vN+9_Bx4r2Fqq5=bj5(2sK|?i^T`)y&RFqD14P;jg z;l&3ntNEk7?i*`xj%h%UQZQ-Gstbq*fikgeCs4Gk%j)wp)L|D$7IT9+v2{A&ZPo=$SCRiszwd+lt zEh5)6gp(j4n+~LV(=bkk4C&3{$-k@-4B!+9aGeSE-Vozd%*ekG9{Hvz$7ztk2H|gC zA%if0(-VMjI?C+NqgtE+0cue`L?MeZWjHfN$c&)WqRgD(EU3=xL2U|ow_%(O85AVL zu_)x-hHwrfkVR!r7oic`0M3N~t_D4e=O1-M)?gUtK?YCSeT+h#X#nR#K*@A4vj_vZ zAcn}Xkkaln2S+Z1YVC^RK2COhL%0YMq$_+gpuRAKiy=Y#A{+ftUl_(EkimW7M@`fh z25@N%kkbdH&1lXiTn5$bmf_ADatedE93rSE;4Q?gCk){VNRXb$wp&qG7{rwjk#&Ve zd(;(%aTR26SNKsAb%g<39RuW^acNhWyUN!Is9m0V233{BVVO!T@fv09rlvChyRTJ!Uy{fp{}i>*S+w(+vS` zfdJ}c$78n%7}1BOi11l z&l=L)i@p=8wI>QU#1Y^w2+*Ez9)Wto6ya`2a6RDIs9m7b2u5 zd~iTLVF>rd1iguv3{TvV_CDkNSWjQnrCFpr7;SdOv%au|2Qa~Juj>@73i4nALfh-~ zAr-u8kE`+!W|R+mG2~$kp)Lt)BxD!1MIOP7pZC!=P`9+HIZF)N^ifR6UdU{YGC}=g z1-&fk%dNt!`X9%7-={k8!ag;SCon`ztME0nPz^(P5)(L5WS`fG7mU)OhVc|;l#jqM z`%Lsf2h19v9>l4DmOv z^q@w(gpMJvVu+a5;7D)Z#%c31ZSoqX(6Xs;`zv^>(Z7!MsoP(W@djp)iEB$h6E|ge zv!Iu)hH?`(yAf|;ed!jJ^oC))jT!bWqG)zv?*hJ)K$P4*3(aYY@@|qtN21KLXVBCQ z=e-1nroR5hH8gaCc)x&cUZs9v=4OXMHTy+2@FB-Agu@}hIY!~GY*qt9I06&IG5j7iatwnwGKC<=@Cf7> z25}TdkYo58H^?yz;AjX?$H?v;A!Ai9Ev~j)MrZUx7Ts z=+{8K_l&}mSI8)ihY0T(YFEfJOes!?5i;*B^$asJJ`t+fGw5sE$q~ZJ{PLRHER03Bs69izb+B_MWdONL0k?I-YL|kkW(1M6){4N0+c$1IV^A`RI^R{SdC2D0ItFSHfi_T zEEMbw;OZ10zr}^@+EA{+6tZi-!G-MF0Ir3A%&v7(i|pDkuEPwn>*?9Y7m!^W#Ptx7 z+vZ1BZ3s6&f>^cQwLw;G^fyAiw`v{ukX0MRO%UO&y7029EYKOm%`rlbRg_w_Ie2jk zREt#)Yp6$7Z2-4ofLOIUHnM61xD5h$?_hd%uN|3!LEH`zVhTP;B2zGgJ0L+!A>3s_ z=3p3iLWVa7bqiz;25}cecyrJdCkk=~agRmN{foZjNg6SxEQjuL-V4>TjnWGqg+qw@ zFd}=`#c*%o>zoL4Kg8sB*J8_xD)RtD(C%7C7P8}584(_Y1P*oh@FuFrLzqGK4WEHS zh=(B}Z&~Kt0YW@dg6OVw&FxeBj7>ahk4G_up2MeSzua^9v57~B#~>p9Y@K}9!izfvU;yH-$X0H8$%-l4_^Cbu|bEP0NHomlwg~T%jZW2p+ z6_do;d-c8L$kr|5HH=Ve_b={4LES=L#}KvmY$p%dyQRF5ppeDG4+p^>dJ{vu&1(-K zo3|x-D-EIbS$S}`oVODkXZKnd6y7c59SjMUukM2^-(ub^VB}U&X^6Kk;&>11z3CU8 z8V$W;Zb`kLfLPPl>Oj*sqz^DjO<&L8K+`vf4>3Ya-))IN!#9YJFd{R2tqU}KL-{yC z5yLMF^|pULNkjOgMdBWjL=;n$Pcg;2kM=Tj9|QR;4RP+H?ScjkTcytv9QT$Yb)R_l z9@pp#3<>U|p%%K2sneGQjNI2McOP@>YwJHT2PUM9lIY#1@B*0NJ_fQ)0%F|9eQpc7 zk0EV~N#Z`)ccP#J8OU}RA`V2P?0y*ZBE#7pbKG>P_`n2gn;jAmaw4*SzbzN9dqYp? za&1RU@%FFX1nu9{XQu?j*{vEsv|9t&8AH@={RSDdS_9do0Fk>rOtKn}+c=@ZX@qn%+Kff?GM z9s(QGK#p>des_AbKY4mIpF>BdqoJBh5JHcM#t3l?MC6X9nZ`tfVMJ)tud)Ds4A3Pf;EfLRJ^%Tr^3OkhfT!c1{agKCa2=&`5l z`i5{iB;=bB^@Ks30TDVo>D60bs3Q#FOi0MTb<2c&RFAVDVq=O8qw~gPmStuX2yiw8 zIZ|kC`QPjUfK_4*uNO6xfR1S2z7)(TvCF_R%6H~4C7MB@RMW> zPG$!@>k5Oo3?jHG`BjHHyESVWcc1xt46(P5Z6M4?@e8tquw-#>mWi)AulHM zvC`b%&aA?4u7@19iV`0;`Wv7=_xv9+3PZRtCdd(nQll`39BzVYotW3!3sdu~2@K+9 zh^W(w+zyz-B31rxYa3>^;cMXsA)zrDrsAB+k#Q-@2QEE@-l*HXo?d_?s{LWg@Ant(( zwkLm{9NCir+zSDTTLP#A_d$SK6F3x)5cflbT9ZFIgRIF^;{k}szDt&ll!oyjX0Sc^ zQXqRWgohwO?Ma7TWKRb0hy~D&QGfE>jI?8xLzlXbLbbQ2!kbSJ;xUL|d-4adV|$9q z@HhmhJr(Y*q7pm-0b)-+M8?4>D#DYHz~(eP+|-HfDPlYY8JRudc~r!B8Z+!G0AhQJ z2+u%*+Ed}KENaYWV}RV(PsS&{yt(uL98`OID!kJuD}X^f4-srn{`@ksCj)o^0>qxO zdnNHCDyqhd5Fr*-yk&_h@e%|$gYtJtkU^PxybKwcL1}Ns171{-S1^MODixq2!mE&= z235FEiJIcI7@)VyOD)RYQGXrly-gKvj$~!9kT)=dt;(MsMpk7JZ(@YlRrcI0vMURD z3q!=Rh?LnUidUBNHs+{-`PBxpFAI4GLoy4~?nM@6Deq#6T1eqe9_*d>3JBTwDmM|c zH}*c(dlS(@#A`3Mb9)>70}P?A=?HJihDKsa@*#$3zj%*>{bC>=VMx|5S|8XihVn6{ zXulM0eT9B8h))uTVYLi%s|m_KbMiTE7k*B17e1durzW36wd>QuOcxQpfP~Z*6C!+> zBG79KhP&N|5RI=Q#@7F*9!bcju|28+*ku5Yzqlo2sjWR#C9=4 z3 zK!jL@o2em#Fn~QFKn)^uaWkx=LhO}dkV&{x6UZJ+DfWhhEaK}z40Wer>;oD8L!~BI zqblqhi)EL)v?I+v_0~6j)}U`Kn_en!i#E9 zR~o`WkdSqyu7OZj8pgqp0luP=b)^v>5{qSvyR<9KCitOH?YmM3e$u1!_fuI4MTR?q6vun*G6(p;}sTL2W30Uqsf6hHwfb zNGoO!>L6n@h*L3wn$hn$qh>UK(;&b%qs|miGaAGh7D0=@ImwMuX@o3?PQlNFYS)Yd zuo)x5S&*R3=$`2Exp#t@*ga zuh^wu%<}LWtkocQ-UD+Sg{^ju~nn9)be8h1`K5Y9M|)1saH{&7Bw` z1~Q)y&ZNVKq1=Tj-agcKp?w(0-35rOG0W}4EJN?XdbN+jmVEFzgSZzX*gkrSZ~1_T z`w|E?k8Jh|?ZcGgehdjizM3ku5QBLDW7tCAvjVU}4`PT|$UwP;n4&y{Dc(XfGD8b7 zkcSHpSwNRth*@Jlg7s=4h5LG;H4NfWj1UVcejgPg9!ns^Lj1%WT8Jsf;}{Yq4<#02 zFi&8NT1aUOF_0%Q#P_Y11oo|gJXL_m)0@YpXyMC9(Mni&ov zyaNfeDO=hTrX}8u0Wu(!_JkR--h*n_6NO1hRslnJ9};BopSTT)C?7zI>rej{0c6ys zBp)Uj;Y2O!PlNafB64>_QGXi3$B-~S+*#V62JlG?kU^-lKg}@pDO9`uEG$B@o-l;Z zAR*h#kpOAdAPDg}L~v)CH&vp}G{yKL$p}+J)R_kHWsFFU*jXjaXuI{d^_W6F&9!7< zwV%)BPANcwwxpj&p_Vj-*cKvOOP0BXVQiOV%*bBRh+5JhwvQ3A8((UZX1{(1sCF$` z*b>WH(hzop1ZhdX8bu9h2s=T7Hl#mafGpA=c8(FUmtNWkX19G8sCJE@Q&6+hn>B(V z>{1b7FG%231$_Dg z6=H9QuwUek?I0?{J`f@Q*og-$`47J1lkU>M8 zJ<4THyCB8^DF%IR)t&P&&od#yfsnv83FolPfq#TJC`Kf2z+`H3^WtErb~cFzOzsRr zI0O>ZCKHYs5e|g}Hc4<(6;JaoPQ|fU@2nC}%VWlI zn4xybJAH+_4Vh)xqO8FfHcr29f#Rh_9FGxVp4m&Ekbzpr2^b&rn}itu*Fq_KXj;{{CmJyhhN!_?_C%ZAO{0^6&Vk+@7K4h)}4#1?(+=x@!Q?X9acWvSahwzWIGaQ&x9&3@zPq z>GH^IewMeQAH;Sre@NP-_4loTKsI%nTwze`Emt+F0{y>M?HK)od$8t>@d7XG8Jkxr zq&%7MDlZ(GU#k>S9)H1Gyl!l?T1R=j?mn-hN{kJTR9=$uWZEaZmTX|WZ@5xR*)r`* zUb~=oyi!PcGT}QS^nOY$P+_o?BeT}eMC+^-Nb|O4l{Vu;iAzFX-v(~n$t$*i?kmMZ7=(nw=cXdsl`V-~Q&wPQAkU$o=w_Mm2 z`Hyy8bjhi7wPWOJ8imOq8uih6wVpn9iP{#c>MJ+lN>f9uzmb~!R4S@XoZ7Tb6a8Ns z{nOI)L;81fQ`5Kptf`s)kAJ7XH`rj&vK5;wYHC`sy0OLYw%Fh|oP~aGzKj0d!vEQ{ z&bM8rEKAR3n{K|@ilr-7{iL<4Hr&d8E?d5IW$W|}+Gez_-h9d8RZClG7yp;5mn~n? zI&(U;^!R3*EvL*YH|^LB}JAc83FmJ{3 z%{KXMZRxN1=R2F5uhXB0vL8jnReP2Gd5!*go&IT|dVagn7@5b10vZF2Mr%{^U-sAf ze%|PqK0NS?){g0I@_+M&nwneX_vvl?yZgC~fB!4_eP##$KC>g_|7-bumgJwMKTH1g z+QLp3vu<_DUxpv2HZgOPrYxbtudhg(HL;IislWq&YsWj<>EFZ9vhNF zso2R$U*bzo_v_+APbWjW!+1)2$ZCXFxgi z7{$!_vdshfwFo{KQQjLqhl*z-u`@zo!Fln|keGdl%MN-Wuigl%(00N-V@O<5>%98sP)$E3 zYMoc}LDDQnQ&M|nttE%nn&VSJTv}@*o`=NcwKnScP)$FkYi-ngEIKRrym~iRy4Evo z)-bDS?23c5%c8Yj2*l}1=cNA}r0orw5A$_X(K*YYSLNcmB4;VdK`G0j+J6CBjwKRI z+os7Q(1n;1F@9+o$ z^`=N&(c(tF0?A8T+=w@i#2sb9P+DAasEz*{5|_5P5wC>e(iS)BEs(mr#f^FuQge&T zJ~y^;BVUc=r7dp6{~n1uD_dN0Xp3)!#HB56#J_{$(iS)B|BlqmlLuw4Nl{+|x3 ztT!QId#o>S0Hfal>&qL!=y$~WiUu%%opS){jnQ(K^EtHpcY*4(&*jy-LUl>m^YY!W zoHD^lpFGPbwbQcik&`d*(=X@pz;t{TmG24V6PZT2D=B7wgXw6<{i3oCFj-W80M@4r zsGvU(>yw>O033t?=^?s6I3!2lBPiu9;B#mL917Lx`sdY$L3K&(^YX)?JRQ2}-npxu z7XHXsFP@o-KB6|hdlXccR^6zNhU)UF8~HI%Ue@hYb)!Enrq= zOP0;Hpk3`X2|c;LOvVdaDh0v`1%eh&_XQIrFf}+ap{EkaR4GvcLpV7{kmo4M+aP3- zHaI1rFKL5_a9V*-(FUwHH8?$?FKL5_aAuA`HX_r(QWr22#K$pXMA~GnBk@&8oUU`Ez9v$O7o|FzwZ_e^McT3|8|`&STUuo!z8;Cw79JJ*#z-x; zUsh$~95*3tS(T0UW~42xvJu~c#O1wg)VJl-wQ;(0obBlqhLp~R%bSzTWLa8A#QRI$l)-LouO`A4umwT|tSg}5>MN3lNLdeQYC!}^l; zivUj)05aN?H-H(Cp2Yg{1~B@ku)e$jjQ(k?uV?@Rc(wqTR&M>=fRaTm;5n=>Zvdlz z9_z~+!02DV`icfHfR_q@>D3J&S+oIO#`^LGF#1=pzPtg9{#C56XaECvy#Sa|-2jqB z8{iGBFK+;&e-rD=8^Gw_!upB^Fo1UofSJ_|AX&5l-o^Uz1~B^fu)e$jjQ)MBuV?@R z_{0O~XoViJnX;7}X`_Fy-%2xxspjTbmWTesop1Owr>9$$RdUJ_)SuwU*-t>M1K{4^923&lW673_hsoPen)FX4J1oY?+~dg zO3!Lj_8lX2M|sg%-4U+6n^Dt8kZAH$E|)w(zI#s2jZ#r~+K%B&fv}GubT;@XM|lA> zPtfn1)6cK>jnw<92%0M}_RBH)=nKbH1kMxm`{(q0exgdxd4m2Bqo1a8ta5Lf|R5{6_!F zu}UBI38xHvde>OD31w@bR*uY>bsW|n54G~FlDVOVwI@KW9Oy7NG_dwWsBM=wY0#5N ze&oR7lL}(C>XODXMt?HYmNb^po&vQcjb*f_LTyQ78SQCMTh>@cd`3>}EvLM_jB%Zr zl9x1@k)M^4m$aIZpPiDIG@Oy2laiOUozb5g>!n@G+s-uoc`12G+Zp-!DS1iT8Tkb% zc}d$D`GqNYS=$-?WvU+-rR=_^E@da_O~@&ePD@vp1wH*W|K{HricD7=LY))XYk*!wK`QAtP_qy#LkCn$Ody)?t;!>*5-n^hG~;|XwvW~z0$0&K|?lKNfy#tH`=I^o=^G#g(0p( zQ}e?v=4X9I?FS;8Wg7QFo0t+kPek3))cl;!uDwx`ojRwf`S~b2l?6z+OL$7$ zF`XnYL=viJQ6fzu5-!w>Mnc_F%%0VOdaJ4Vr6@Zrlynhaf%>ee`Q=DbUMQ}{D_)WH zR5WPJHi2(KJCSF&GQBy8cJJu1{bJ`yH*%o*Jw5&) z4NF!|f5#O_19+9zD~Bah=XNFQ@=NfHr~*c^0oLHB7(e~M#}X5qyc*AO?U4% zqFC+HYErHb$W+GYy$wYV{Ms9L2bI?4`-qH=GY_61Vbx2!R_?C$+?ZJ^hnM8+&!?h$f%Xq6%+QnlN$FvL*#_~2b@h}qX z_0vgoTm@ZSFIYNYeATOmas9JN{4f=|e6I4+ScUQGt6o01#pir^)6a>vH7kqvGV62;KP2l=6DE(pA4-WVxU%zv0u5ZWCuUh}$XIr<>^nJAQ`o{J<%zWjm zUO$ZM+qCfc|FyY(=O5Miwr%O^86Inc7MQQy*D$t*h_qdcywn$%<=0*)>24V;w&y~9 zGg>OlLU!OnK?nZYTguEqc5LB8bTF*yFjX8=%j`NYQ*Gu_y!Wo@r7G3gHrYwaPf z?#$PRwvwviXJye_#WIz`ARToT6Bp$flDMErA5NY$YbkLYZ!e zH^wW$-Q-%ZwR3~GjpC-cQ`b^+(u;-Aw7XmkHm&l3X&c*;JfLDy2)$N_ID5#o;P9Bd zmZ@0kT2dUnRtO|}%C)AU4ohCk427v{g$~n!TO#RRa;@oWb1ggUrLJWl4J{tzvd<6X(hHmv; zDb;>lD(H+~f2l$|+P`IVoIaUSoacW1g%ZP&raGV{zkv{D-=I_)%EShY-{mvPSee*5 z>j*LIz!p9w^+#=ud=NF;S!U}@r_NIIgJ{}Pho&p$?Y9Z_4-Hi&u!+Z%2GNcX*bZ(P zsDD%XUZa?_z#%PkjxTh9R7n=ysRoc1*3nT+A*;V>>@bSRf60Xor3)E%tiF(mN68C? zur68TLWj|X%(z&6Au}u{FJ#Rp+j%@(rk86~sXxZDIZUsP;OUhamqT5(@rrYRKgRV# z;5d>3M~|IfhXUjS!q*V`#T3KtYx5EZ=tbrb}injyJ03Ox4f>H(0viw1Nk!CA& zO^ZCrjN)>t0Of=6#9AQu(D71$wQ2z|^*?ao7To28mY?^1Ln4crSD(nGf~}Ho;IARx zb%Y7{NiE~G5i_d{?(+4QDok}xZt0`@a&T_(^%pDn_9;@VZ%7}8x$vniqhscGM{VSeUmOuzSRj&0|Y<@FKg0O8P( zN(rBx_y*E*fwX^tN~!o|(({0{KGrKQ?Vx#Ene==tm1E}QRb|o(fV5Z3ONL*jywoZe z%%!^^^y>Kb4mq+*V`?Pz8R)bPokh6}X*;INnfhW2=e3t3?R5RTQ?ZHj+AEN@y{$uz zDN|G|E%cR0JgsfR!jk}M7x^n+g~YSytydnV$Fz=FVrPphwC22h60_ep{LnAFnT=+@7Yyr|e58ccdxt zVfzxwooPzp%zX*wt~91Ic8n6t-D%8>*h5M%_oOi{tQlV^;oO_%xDaQYri61}31=%u zGX7ISx<5^t=1IntN=Of+NwYl3I8_Ph!8ECThDU7@{Idl0P#V?Q;ZaK_gnBrQnvpft z(g~p+Nu$V|e6fBtA=Z<^qH%e_T>fr}`!q-N7G^iokt}+sm`2*C@=6+`2S?_x5Dl}$ z&V*0rh5cPaLr#eXS*v^|uk0QjAL#3yL+4=S7_;&*f6&I#4G)7AIANIQZ0dg=R-bRzZj+7BY_gzD?XALYc; zCRE>PuD%~f+6mOxOFxOE6REG)ei~^fR9`RNdL3R~(h5yuvVOJ5L{@$fV4HlNLbci{ z&$jtIru;5M^D{l$FMhmF&E_LA-2c)Xu#l%Zdt||ck~(SwZ3s)8IS09 zJi~D0h7+HzQ`wzjS^Ermt88&J$?JBGb)6mY+i2nSc8PT}rire&R?A;+*H}kGt_X`O z>AY}v5&Cam$wF$%mYXeGLaz&w&xa1hYG5Y#zw5Z(F`(0&j! zZQ>w0Zz7=mb07)}d@OMS7|vE7TQJvQ4iJp9of1mkdLqbyxw6pV?ptk}EdT8W*|*w0l5d&OzjEJd(=6YVZ?)af z-2D7Hf5FkjeWs~*>GH+DYij!5cNfxU*;a2s-);N2x%snPmZ8m7{5sCIXo=`V#Wm({ zy1hyNyhZ=KP5*>%y0O8zkGlOp{+qW)`Ui((C>ibVr_n}7l0u@6BR?$s-p()3XyxbC zc!f|%R@s!o?;R?0Ym!2;%BB{6pQbW5j1-bp_BVy!XQ|8$B86m?{cYj*_8F>k`+S9T z)%~dOd#9_N+ulh^f_CO&E6OQ43kuq6ic6JKOe-kp!|k!{AsmCBs)uM{{G^xmpSkhCQU#v+^GBcLU@20hVT$P+;RxF`$s#uqtWW!7{z@I*? z_0?&kzq4(aN*A{QWsu5Bg?@r`9ioeinA80f>FC4Opfz&3*+>_*N}{&UNxMW!A5ZOX zP^(KF=J)n?<$ElbtPas#)R8%J#(d8K=|YjZfnGmmOd}+JNVRXu;!QT){6{nn_WWjK z^``uyI{snm`WsP@{YM@j_4j|`??Y#G=KmNafSX5bA_;yT`xW^-%S~Nir6lm^PR7!p zSEl4k&Bb@$P)!t`hWb>!=!?bKWt}PVB+GrUn6Wf5_z%hA8jyO^S!TW%6KuR77sDp{ z4$Xr14Hz;^n4fDrXKilIsqCK7k^aFsjTD+&aNu`a=<|wRJwDe>S+bqjczDi{H+kJtesL)TvYduKg#xn{ZdS0yU|AG5#xD zW3a#MB9G`rdWLG@v-E|FIG1+yAR`oKG4)7XgI+oj@C&-;_RSmns#jSsH+hXW^cv2h z^)eIgU~AM1=4QS7kurTeSW9TmY7BL!N!oCILw!Btjj?U~6_-`&IfBP}bPX&0v1e-jiIjbo`HN>O3Gj@bOA{-XMRoD z-a;3A6?o20bM((q$$LhJ$GU1?ZEClG28Q5XJIMpDetW&)3ct4eeDUoC=&SbAWUW7i z{!Kdo>2KQeDBw0qzV)qd(f8ihh>rf1+beO|z9E|>Tsq#@c$fZpkN$a|{t5dUe9&6I zRsYxgpKPK-T|;57CIKdk`J-JyV0i1jl>he61rAe_QBUWM2o zLv$L19N3*G;>Vm(59fz^$l2P7652e$wuBsmohYG$GrFtu0eSMa!FpFWzoUz`W^ye` z#;y+CS&g@xOTp zY-%3npWT=jLPwrJ9mXqv&S~P4>gOB1iC9Gd$A3up7enY?IM!9KH@fHb_tV5MSB$7WLidYjw4 zURe;8wgP9Xg);0V2;UH8j9e-5kb`YG__cCXCCHlKnB3*DG`eu6Jzccfh$I))=I4L+ zE?%`bbOVi8?tY8>PF8%OsB83yCJ$#uoD)&TYa}CWCw9-PFU)tbRFmArFO|7B+yav` z>y&Y$jnt1MlR%u;-Y#HXi}MV&f2eCtp6+}R!21VB2J7_tH*v=YGmPs!PvVM{l+fj7 z2)zW;meHkXYSIk)JADx&H+;D z*vbQbn`}SYz%!>dmf6dvBKM|VqPGTT0P8fh$vo_b^zYI+Csilho5S->&GHSJZpwV~ zL#i3yOZ-^s+1&i?Mq^}NLtX$V6V8_ZI%%Eezm&hn1{OBDdV6d9Ws;`mR{5>Aaih1d zPA)L`i@sJGyPKN-N`4vn#(jbPq9Dtx6}KUL)!Spqy8*Kx7E~Gvt+aXz^a;4{Zv|P{f%lH*Euk?{q%qQ z`)`&lUpj@i(EdSi-cI8(uyLY7)N?8+g(-PXJE3!8SIgkcUwov$}bol z%G_#`+=a^-xnfwzZ*4hheLeFV-926Pak2u_16{*zG?mO`J=_mn-4q2R5N?qxNI4`F zB&JBm`RR>7h9_DQy4|cL*{-=*lq984lnk?nVt9n;8tSSI>ll%B3XK}|ao(Yoi|JpD z@p{+L@L)d|r1kGw+gpFq$|iMyk~oT&kbagT5#ewp_=#!W%DolO8?ttMTwWrEoH@q0 zGyJ^dCY3mQ=u z7t+6z<5JI07R_C{Y5Isc_@ADhMcvC*EZSg$Max!fvV8TDrHh)HR;+IDHFfmb zV%3smD^}5ePa<&1-icFug9bC+JNcCU`HcSgoc;-WC;Yl3w|TOjzB;LYuz%EzG&5E& zZ)*OYd{v5eZ}UHYpMUNs{QLv{xwG)|5BcY5g`cPJ&(jM(Z@@q6ueJU`ifQfL3&-Uw zdfV#de9|ON*O}Rm@OtcpI1 z)^ZvUhwBzAnpaN;>ayzQ)iZ#)w9~Lye9UOonDleT}hh`bQ2sblLo)z4Dl; zZNMmdx6Mx5baIZ@c65}#$L1gIs>xZ_>Bcak{Jl1ReXOfT%0DwL=odkKd~~eQJvdIE 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

+<9` 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

~q^r2Z0ZyS}l{eeQE4-+iotIE=$E)sN48H4Gj$) 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�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 z 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

00SUK-&-s|{aWIZ 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 z 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 aEqaYeZC^tPS_m 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℘sYVh?%eRdr3q!V%MAeesF1OIK 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�q#n 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 z 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

-F?LKHmU44 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Π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