mbed official / mbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.

TARGET_SAMR21G18A/TOOLCHAIN_GCC_ARM/system.h@171:3a7713b1edbc, 2018-11-08 (annotated)

Committer:
AnnaBridge
Date:
Thu Nov 08 11:45:42 2018 +0000
Revision:
171:3a7713b1edbc
Parent:
TARGET_SAMR21G18A/TARGET_Atmel/TARGET_SAM_CortexM0P/drivers/system/system.h@111:4336505e4b1c 
mbed library. Release version 164

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Kojto 111:4336505e4b1c 1 /**
Kojto 111:4336505e4b1c 2 * \file
Kojto 111:4336505e4b1c 3 *
Kojto 111:4336505e4b1c 4 * \brief SAM System related functionality
Kojto 111:4336505e4b1c 5 *
Kojto 111:4336505e4b1c 6 * Copyright (C) 2012-2015 Atmel Corporation. All rights reserved.
Kojto 111:4336505e4b1c 7 *
Kojto 111:4336505e4b1c 8 * \asf_license_start
Kojto 111:4336505e4b1c 9 *
Kojto 111:4336505e4b1c 10 * \page License
Kojto 111:4336505e4b1c 11 *
Kojto 111:4336505e4b1c 12 * Redistribution and use in source and binary forms, with or without
Kojto 111:4336505e4b1c 13 * modification, are permitted provided that the following conditions are met:
Kojto 111:4336505e4b1c 14 *
Kojto 111:4336505e4b1c 15 * 1. Redistributions of source code must retain the above copyright notice,
Kojto 111:4336505e4b1c 16 * this list of conditions and the following disclaimer.
Kojto 111:4336505e4b1c 17 *
Kojto 111:4336505e4b1c 18 * 2. Redistributions in binary form must reproduce the above copyright notice,
Kojto 111:4336505e4b1c 19 * this list of conditions and the following disclaimer in the documentation
Kojto 111:4336505e4b1c 20 * and/or other materials provided with the distribution.
Kojto 111:4336505e4b1c 21 *
Kojto 111:4336505e4b1c 22 * 3. The name of Atmel may not be used to endorse or promote products derived
Kojto 111:4336505e4b1c 23 * from this software without specific prior written permission.
Kojto 111:4336505e4b1c 24 *
Kojto 111:4336505e4b1c 25 * 4. This software may only be redistributed and used in connection with an
Kojto 111:4336505e4b1c 26 * Atmel microcontroller product.
Kojto 111:4336505e4b1c 27 *
Kojto 111:4336505e4b1c 28 * THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR IMPLIED
Kojto 111:4336505e4b1c 29 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
Kojto 111:4336505e4b1c 30 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE
Kojto 111:4336505e4b1c 31 * EXPRESSLY AND SPECIFICALLY DISCLAIMED. IN NO EVENT SHALL ATMEL BE LIABLE FOR
Kojto 111:4336505e4b1c 32 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
Kojto 111:4336505e4b1c 33 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
Kojto 111:4336505e4b1c 34 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
Kojto 111:4336505e4b1c 35 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
Kojto 111:4336505e4b1c 36 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
Kojto 111:4336505e4b1c 37 * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
Kojto 111:4336505e4b1c 38 * POSSIBILITY OF SUCH DAMAGE.
Kojto 111:4336505e4b1c 39 *
Kojto 111:4336505e4b1c 40 * \asf_license_stop
Kojto 111:4336505e4b1c 41 *
Kojto 111:4336505e4b1c 42 */
Kojto 111:4336505e4b1c 43 /*
Kojto 111:4336505e4b1c 44 * Support and FAQ: visit <a href="http://www.atmel.com/design-support/">Atmel Support</a>
Kojto 111:4336505e4b1c 45 */
Kojto 111:4336505e4b1c 46 #ifndef SYSTEM_H_INCLUDED
Kojto 111:4336505e4b1c 47 #define SYSTEM_H_INCLUDED
Kojto 111:4336505e4b1c 48
Kojto 111:4336505e4b1c 49 #include <compiler.h>
Kojto 111:4336505e4b1c 50 #include <clock.h>
Kojto 111:4336505e4b1c 51 #include <gclk.h>
Kojto 111:4336505e4b1c 52 #include <pinmux.h>
Kojto 111:4336505e4b1c 53 #include <power.h>
Kojto 111:4336505e4b1c 54 #include <reset.h>
Kojto 111:4336505e4b1c 55
Kojto 111:4336505e4b1c 56 #ifdef __cplusplus
Kojto 111:4336505e4b1c 57 extern "C" {
Kojto 111:4336505e4b1c 58 #endif
Kojto 111:4336505e4b1c 59
Kojto 111:4336505e4b1c 60 /**
Kojto 111:4336505e4b1c 61 * \defgroup asfdoc_sam0_system_group SAM System (SYSTEM) Driver
Kojto 111:4336505e4b1c 62 *
Kojto 111:4336505e4b1c 63 * This driver for Atmel&reg; | SMART ARM&reg;-based microcontrollers provides an interface for the configuration
Kojto 111:4336505e4b1c 64 * and management of the device's system relation functionality, necessary for
Kojto 111:4336505e4b1c 65 * the basic device operation. This is not limited to a single peripheral, but
Kojto 111:4336505e4b1c 66 * extends across multiple hardware peripherals.
Kojto 111:4336505e4b1c 67 *
Kojto 111:4336505e4b1c 68 * The following peripherals are used by this module:
Kojto 111:4336505e4b1c 69 * \if DEVICE_SAML21_SYSTEM_SUPPORT
Kojto 111:4336505e4b1c 70 * - PM (Power Manager)
Kojto 111:4336505e4b1c 71 * - RSTC(Reset Controller)
Kojto 111:4336505e4b1c 72 * - SUPC(Supply Controller)
Kojto 111:4336505e4b1c 73 * \endif
Kojto 111:4336505e4b1c 74 * \if DEVICE_SAMC21_SYSTEM_SUPPORT
Kojto 111:4336505e4b1c 75 * - PM (Power Manager)
Kojto 111:4336505e4b1c 76 * - RSTC(Reset Controller)
Kojto 111:4336505e4b1c 77 * - SUPC(Supply Controller)
Kojto 111:4336505e4b1c 78 * \endif
Kojto 111:4336505e4b1c 79 * \if DEVICE_SAMD21_SYSTEM_SUPPORT
Kojto 111:4336505e4b1c 80 * - SYSCTRL (System Control)
Kojto 111:4336505e4b1c 81 * - PM (Power Manager)
Kojto 111:4336505e4b1c 82 * \endif
Kojto 111:4336505e4b1c 83 *
Kojto 111:4336505e4b1c 84 * The following devices can use this module:
Kojto 111:4336505e4b1c 85 * \if DEVICE_SAML21_SYSTEM_SUPPORT
Kojto 111:4336505e4b1c 86 * - Atmel | SMART SAM L21
Kojto 111:4336505e4b1c 87 * \endif
Kojto 111:4336505e4b1c 88 * \if DEVICE_SAMC21_SYSTEM_SUPPORT
Kojto 111:4336505e4b1c 89 * - Atmel | SMART SAM C20/C21
Kojto 111:4336505e4b1c 90 * \endif
Kojto 111:4336505e4b1c 91 * \if DEVICE_SAMD21_SYSTEM_SUPPORT
Kojto 111:4336505e4b1c 92 * - Atmel | SMART SAM D20/D21
Kojto 111:4336505e4b1c 93 * - Atmel | SMART SAM R21
Kojto 111:4336505e4b1c 94 * - Atmel | SMART SAM D10/D11
Kojto 111:4336505e4b1c 95 * - Atmel | SMART SAM DAx
Kojto 111:4336505e4b1c 96 * \endif
Kojto 111:4336505e4b1c 97 *
Kojto 111:4336505e4b1c 98 * The outline of this documentation is as follows:
Kojto 111:4336505e4b1c 99 * - \ref asfdoc_sam0_system_prerequisites
Kojto 111:4336505e4b1c 100 * - \ref asfdoc_sam0_system_module_overview
Kojto 111:4336505e4b1c 101 * - \ref asfdoc_sam0_system_special_considerations
Kojto 111:4336505e4b1c 102 * - \ref asfdoc_sam0_system_extra_info
Kojto 111:4336505e4b1c 103 * - \ref asfdoc_sam0_system_examples
Kojto 111:4336505e4b1c 104 * - \ref asfdoc_sam0_system_api_overview
Kojto 111:4336505e4b1c 105 *
Kojto 111:4336505e4b1c 106 *
Kojto 111:4336505e4b1c 107 * \section asfdoc_sam0_system_prerequisites Prerequisites
Kojto 111:4336505e4b1c 108 *
Kojto 111:4336505e4b1c 109 * There are no prerequisites for this module.
Kojto 111:4336505e4b1c 110 *
Kojto 111:4336505e4b1c 111 *
Kojto 111:4336505e4b1c 112 * \section asfdoc_sam0_system_module_overview Module Overview
Kojto 111:4336505e4b1c 113 *
Kojto 111:4336505e4b1c 114 * The System driver provides a collection of interfaces between the user
Kojto 111:4336505e4b1c 115 * application logic, and the core device functionality (such as clocks, reset
Kojto 111:4336505e4b1c 116 * cause determination, etc.) that is required for all applications. It contains
Kojto 111:4336505e4b1c 117 * a number of sub-modules that control one specific aspect of the device:
Kojto 111:4336505e4b1c 118 *
Kojto 111:4336505e4b1c 119 * - System Core (this module)
Kojto 111:4336505e4b1c 120 * - \ref asfdoc_sam0_system_clock_group "System Clock Control" (sub-module)
Kojto 111:4336505e4b1c 121 * - \ref asfdoc_sam0_system_interrupt_group "System Interrupt Control" (sub-module)
Kojto 111:4336505e4b1c 122 * - \ref asfdoc_sam0_system_pinmux_group "System Pin Multiplexer Control" (sub-module)
Kojto 111:4336505e4b1c 123 *
Kojto 111:4336505e4b1c 124 *
Kojto 111:4336505e4b1c 125 * \if DEVICE_SAML21_SYSTEM_SUPPORT
Kojto 111:4336505e4b1c 126 * \subsection asfdoc_sam0_system_module_overview_vreg_l21 Voltage Regulator
Kojto 111:4336505e4b1c 127 * The SAM device controls the voltage regulators for the core (VDDCORE) and
Kojto 111:4336505e4b1c 128 * backup (VDDBU) domains. It sets the voltage regulators according to the sleep
Kojto 111:4336505e4b1c 129 * modes, the performance level, or the user configuration.
Kojto 111:4336505e4b1c 130 *
Kojto 111:4336505e4b1c 131 * In active mode, the voltage regulator can be chosen on the fly between a LDO
Kojto 111:4336505e4b1c 132 * or a Buck converter. In standby mode, the low power voltage regulator is used
Kojto 111:4336505e4b1c 133 * to supply VDDCORE.
Kojto 111:4336505e4b1c 134 *
Kojto 111:4336505e4b1c 135 * \subsection asfdoc_sam0_system_module_overview_bbps Battery Backup Power Switch
Kojto 111:4336505e4b1c 136 * The SAM device supports connection of a battery backup to the VBAT power pin.
Kojto 111:4336505e4b1c 137 * It includes functionality that enables automatic power switching between main
Kojto 111:4336505e4b1c 138 * power and battery backup power. This will ensure power to the backup domain,
Kojto 111:4336505e4b1c 139 * when the main battery or power source is unavailable.
Kojto 111:4336505e4b1c 140 * \endif
Kojto 111:4336505e4b1c 141 *
Kojto 111:4336505e4b1c 142 * \if DEVICE_SAMC21_SYSTEM_SUPPORT
Kojto 111:4336505e4b1c 143 * \subsection asfdoc_sam0_system_module_overview_vreg_c21 Voltage Regulator
Kojto 111:4336505e4b1c 144 * The SAM device controls the voltage regulators for the core (VDDCORE). It sets
Kojto 111:4336505e4b1c 145 * the voltage regulators according to the sleep modes.
Kojto 111:4336505e4b1c 146 *
Kojto 111:4336505e4b1c 147 * There are a selectable reference voltage and voltage dependent on the temperature
Kojto 111:4336505e4b1c 148 * which can be used by analog modules like the ADC.
Kojto 111:4336505e4b1c 149 * \endif
Kojto 111:4336505e4b1c 150 *
Kojto 111:4336505e4b1c 151 * \subsection asfdoc_sam0_system_module_overview_vref Voltage References
Kojto 111:4336505e4b1c 152 * The various analog modules within the SAM devices (such as AC, ADC, and
Kojto 111:4336505e4b1c 153 * DAC) require a voltage reference to be configured to act as a reference point
Kojto 111:4336505e4b1c 154 * for comparisons and conversions.
Kojto 111:4336505e4b1c 155 *
Kojto 111:4336505e4b1c 156 * The SAM devices contain multiple references, including an internal
Kojto 111:4336505e4b1c 157 * temperature sensor and a fixed band-gap voltage source. When enabled, the
Kojto 111:4336505e4b1c 158 * associated voltage reference can be selected within the desired peripheral
Kojto 111:4336505e4b1c 159 * where applicable.
Kojto 111:4336505e4b1c 160 *
Kojto 111:4336505e4b1c 161 * \subsection asfdoc_sam0_system_module_overview_reset_cause System Reset Cause
Kojto 111:4336505e4b1c 162 * In some applications there may be a need to execute a different program
Kojto 111:4336505e4b1c 163 * flow based on how the device was reset. For example, if the cause of reset
Kojto 111:4336505e4b1c 164 * was the Watchdog timer (WDT), this might indicate an error in the application,
Kojto 111:4336505e4b1c 165 * and a form of error handling or error logging might be needed.
Kojto 111:4336505e4b1c 166 *
Kojto 111:4336505e4b1c 167 * For this reason, an API is provided to retrieve the cause of the last system
Kojto 111:4336505e4b1c 168 * reset, so that appropriate action can be taken.
Kojto 111:4336505e4b1c 169 *
Kojto 111:4336505e4b1c 170 * \if DEVICE_SAML21_SYSTEM_SUPPORT
Kojto 111:4336505e4b1c 171 * There are three groups of reset sources:
Kojto 111:4336505e4b1c 172 * - Power supply reset: Resets caused by an electrical issue. It covers POR and BOD reset.
Kojto 111:4336505e4b1c 173 * - User reset: Resets caused by the application. It covers external reset,
Kojto 111:4336505e4b1c 174 * system reset, and watchdog reset.
Kojto 111:4336505e4b1c 175 * - Backup reset: Resets caused by a backup mode exit condition.
Kojto 111:4336505e4b1c 176 *
Kojto 111:4336505e4b1c 177 * \subsection asfdoc_sam0_system_module_overview_performance_level Performance Level
Kojto 111:4336505e4b1c 178 * Performance level allows the user to adjust the regulator output voltage to reduce
Kojto 111:4336505e4b1c 179 * power consumption. The user can on the fly select the most suitable performance
Kojto 111:4336505e4b1c 180 * level, depending on the application demands.
Kojto 111:4336505e4b1c 181 *
Kojto 111:4336505e4b1c 182 * The SAM device can operate at two different performance levels (PL0 and PL2).
Kojto 111:4336505e4b1c 183 * When operating at PL0, the voltage applied on the full logic area is reduced
Kojto 111:4336505e4b1c 184 * by voltage scaling. This voltage scaling technique allows to reduce the active
Kojto 111:4336505e4b1c 185 * power consumption while decreasing the maximum frequency of the device. When
Kojto 111:4336505e4b1c 186 * operating at PL2, the voltage regulator supplies the highest voltage, allowing
Kojto 111:4336505e4b1c 187 * the device to run at higher clock speeds.
Kojto 111:4336505e4b1c 188 *
Kojto 111:4336505e4b1c 189 * Performance level transition is possible only when the device is in active
Kojto 111:4336505e4b1c 190 * mode. After a reset, the device starts at the lowest performance level
Kojto 111:4336505e4b1c 191 * (lowest power consumption and lowest max. frequency). The application can then
Kojto 111:4336505e4b1c 192 * switch to another performance level at any time without any stop in the code
Kojto 111:4336505e4b1c 193 * execution. As shown in \ref asfdoc_sam0_system_performance_level_transition_figure.
Kojto 111:4336505e4b1c 194 *
Kojto 111:4336505e4b1c 195 * \note When scaling down the performance level, the bus frequency should first be
Kojto 111:4336505e4b1c 196 * scaled down in order to not exceed the maximum frequency allowed for the
Kojto 111:4336505e4b1c 197 * low performance level.
Kojto 111:4336505e4b1c 198 * When scaling up the performance level (e.g. from PL0 to PL2), check the performance
Kojto 111:4336505e4b1c 199 * level status before increasing the bus frequency. It can be increased only
Kojto 111:4336505e4b1c 200 * when the performance level transition is completed.
Kojto 111:4336505e4b1c 201 *
Kojto 111:4336505e4b1c 202 * \anchor asfdoc_sam0_system_performance_level_transition_figure
Kojto 111:4336505e4b1c 203 * \image html performance_level_transition.svg "Performance Level Transition"
Kojto 111:4336505e4b1c 204 *
Kojto 111:4336505e4b1c 205 * \subsection asfdoc_sam0_system_module_overview_power_domain Power Domain Gating
Kojto 111:4336505e4b1c 206 * Power domain gating allows power saving by reducing the voltage in logic
Kojto 111:4336505e4b1c 207 * areas in the device to a low-power supply. The feature is available in
Kojto 111:4336505e4b1c 208 * Standby sleep mode and will reduce the voltage in domains where all peripherals
Kojto 111:4336505e4b1c 209 * are idle. Internal logic will maintain its content, meaning the corresponding
Kojto 111:4336505e4b1c 210 * peripherals will not need to be reconfigured when normal operating voltage
Kojto 111:4336505e4b1c 211 * is returned. Most power domains can be in the following three states:
Kojto 111:4336505e4b1c 212 *
Kojto 111:4336505e4b1c 213 * - Active state: The power domain is powered on.
Kojto 111:4336505e4b1c 214 * - Retention state: The main voltage supply for the power domain is switched off,
Kojto 111:4336505e4b1c 215 * while maintaining a secondary low-power supply for the sequential cells. The
Kojto 111:4336505e4b1c 216 * logic context is restored when waking up.
Kojto 111:4336505e4b1c 217 * - Off state: The power domain is entirely powered off. The logic context is lost.
Kojto 111:4336505e4b1c 218 *
Kojto 111:4336505e4b1c 219 * The SAM L21 device contains three power domains which can be controlled using
Kojto 111:4336505e4b1c 220 * power domain gating, namely PD0, PD1, and PD2. These power domains can be
Kojto 111:4336505e4b1c 221 * configured to the following cases:
Kojto 111:4336505e4b1c 222 * - Default with no sleepwalking peripherals: A power domain is automatically set
Kojto 111:4336505e4b1c 223 * to retention state in standby sleep mode if no activity require it. The application
Kojto 111:4336505e4b1c 224 * can force all power domains to remain in active state during standby sleep mode
Kojto 111:4336505e4b1c 225 * in order to accelerate wakeup time.
Kojto 111:4336505e4b1c 226 * - Default with sleepwalking peripherals: If one or more peripherals are enabled
Kojto 111:4336505e4b1c 227 * to perform sleepwalking tasks in standby sleep mode, the corresponding power
Kojto 111:4336505e4b1c 228 * domain (PDn) remains in active state as well as all inferior power domains (<PDn).
Kojto 111:4336505e4b1c 229 * - Sleepwalking with dynamic power domain gating: During standby sleep mode, a
Kojto 111:4336505e4b1c 230 * power domain (PDn) in active can wake up a superior power domain (>PDn) in order
Kojto 111:4336505e4b1c 231 * to perform a sleepwalking task. The superior power domain is then automatically
Kojto 111:4336505e4b1c 232 * set to active state. At the end of the sleepwalking task, the device can either
Kojto 111:4336505e4b1c 233 * be woken up or the superior power domain can return to retention state.
Kojto 111:4336505e4b1c 234 *
Kojto 111:4336505e4b1c 235 * Power domains can be linked to each other, it allows a power domain (PDn) to be kept
Kojto 111:4336505e4b1c 236 * in active state if the inferior power domain (PDn-1) is in active state too.
Kojto 111:4336505e4b1c 237 *
Kojto 111:4336505e4b1c 238 * \ref asfdoc_sam0_system_power_domain_overview_table illustrates the
Kojto 111:4336505e4b1c 239 * four cases to consider in standby mode.
Kojto 111:4336505e4b1c 240 *
Kojto 111:4336505e4b1c 241 * \anchor asfdoc_sam0_system_power_domain_overview_table
Kojto 111:4336505e4b1c 242 * <table>
Kojto 111:4336505e4b1c 243 * <caption>Sleep Mode versus Power Domain State Overview</caption>
Kojto 111:4336505e4b1c 244 * <tr>
Kojto 111:4336505e4b1c 245 * <th>Sleep mode</th>
Kojto 111:4336505e4b1c 246 * <th>PD0</th>
Kojto 111:4336505e4b1c 247 * <th>PD1</th>
Kojto 111:4336505e4b1c 248 * <th>PD2</th>
Kojto 111:4336505e4b1c 249 * <th>PDTOP</th>
Kojto 111:4336505e4b1c 250 * <th>PDBACKUP</th>
Kojto 111:4336505e4b1c 251 * </tr>
Kojto 111:4336505e4b1c 252 * <tr>
Kojto 111:4336505e4b1c 253 * <td>Idle</td>
Kojto 111:4336505e4b1c 254 * <td>active</td>
Kojto 111:4336505e4b1c 255 * <td>active</td>
Kojto 111:4336505e4b1c 256 * <td>active</td>
Kojto 111:4336505e4b1c 257 * <td>active</td>
Kojto 111:4336505e4b1c 258 * <td>active</td>
Kojto 111:4336505e4b1c 259 * </tr>
Kojto 111:4336505e4b1c 260 * <tr>
Kojto 111:4336505e4b1c 261 * <td>Standby - Case 1</td>
Kojto 111:4336505e4b1c 262 * <td>active</td>
Kojto 111:4336505e4b1c 263 * <td>active</td>
Kojto 111:4336505e4b1c 264 * <td>active</td>
Kojto 111:4336505e4b1c 265 * <td>active</td>
Kojto 111:4336505e4b1c 266 * <td>active</td>
Kojto 111:4336505e4b1c 267 * </tr>
Kojto 111:4336505e4b1c 268 * <tr>
Kojto 111:4336505e4b1c 269 * <td>Standby - Case 2</td>
Kojto 111:4336505e4b1c 270 * <td>active</td>
Kojto 111:4336505e4b1c 271 * <td>active</td>
Kojto 111:4336505e4b1c 272 * <td>retention</td>
Kojto 111:4336505e4b1c 273 * <td>active</td>
Kojto 111:4336505e4b1c 274 * <td>active</td>
Kojto 111:4336505e4b1c 275 * </tr>
Kojto 111:4336505e4b1c 276 * <tr>
Kojto 111:4336505e4b1c 277 * <td>Standby - Case 3</td>
Kojto 111:4336505e4b1c 278 * <td>active</td>
Kojto 111:4336505e4b1c 279 * <td>retention</td>
Kojto 111:4336505e4b1c 280 * <td>retention</td>
Kojto 111:4336505e4b1c 281 * <td>active</td>
Kojto 111:4336505e4b1c 282 * <td>active</td>
Kojto 111:4336505e4b1c 283 * </tr>
Kojto 111:4336505e4b1c 284 * <tr>
Kojto 111:4336505e4b1c 285 * <td>Standby - Case 4</td>
Kojto 111:4336505e4b1c 286 * <td>retention</td>
Kojto 111:4336505e4b1c 287 * <td>retention</td>
Kojto 111:4336505e4b1c 288 * <td>retention</td>
Kojto 111:4336505e4b1c 289 * <td>active</td>
Kojto 111:4336505e4b1c 290 * <td>active</td>
Kojto 111:4336505e4b1c 291 * </tr>
Kojto 111:4336505e4b1c 292 * <tr>
Kojto 111:4336505e4b1c 293 * <td>Backup</td>
Kojto 111:4336505e4b1c 294 * <td>off</td>
Kojto 111:4336505e4b1c 295 * <td>off</td>
Kojto 111:4336505e4b1c 296 * <td>off</td>
Kojto 111:4336505e4b1c 297 * <td>off</td>
Kojto 111:4336505e4b1c 298 * <td>active</td>
Kojto 111:4336505e4b1c 299 * </tr>
Kojto 111:4336505e4b1c 300 * <tr>
Kojto 111:4336505e4b1c 301 * <td>Off</td>
Kojto 111:4336505e4b1c 302 * <td>off</td>
Kojto 111:4336505e4b1c 303 * <td>off</td>
Kojto 111:4336505e4b1c 304 * <td>off</td>
Kojto 111:4336505e4b1c 305 * <td>off</td>
Kojto 111:4336505e4b1c 306 * <td>off</td>
Kojto 111:4336505e4b1c 307 * </tr>
Kojto 111:4336505e4b1c 308 * </table>
Kojto 111:4336505e4b1c 309 *
Kojto 111:4336505e4b1c 310 * \subsection asfdoc_sam0_system_module_overview_ram_state RAMs Low Power Mode
Kojto 111:4336505e4b1c 311 * By default, in standby sleep mode, RAM is in low power mode (back biased)
Kojto 111:4336505e4b1c 312 * if its power domain is in retention state.
Kojto 111:4336505e4b1c 313 * \ref asfdoc_sam0_system_power_ram_state_table lists RAMs low power mode.
Kojto 111:4336505e4b1c 314 *
Kojto 111:4336505e4b1c 315 * \anchor asfdoc_sam0_system_power_ram_state_table
Kojto 111:4336505e4b1c 316 * <table>
Kojto 111:4336505e4b1c 317 * <caption>RAM Back-biasing Mode</caption>
Kojto 111:4336505e4b1c 318 * <tr>
Kojto 111:4336505e4b1c 319 * <th>RAM mode</th>
Kojto 111:4336505e4b1c 320 * <th>Description</th>
Kojto 111:4336505e4b1c 321 * </tr>
Kojto 111:4336505e4b1c 322 * <tr>
Kojto 111:4336505e4b1c 323 * <td>Retention Back-biasing mode</td>
Kojto 111:4336505e4b1c 324 * <td>RAM is back-biased if its power domain is in retention mode</td>
Kojto 111:4336505e4b1c 325 * </tr>
Kojto 111:4336505e4b1c 326 * <tr>
Kojto 111:4336505e4b1c 327 * <td>Standby Back-biasing mode</td>
Kojto 111:4336505e4b1c 328 * <td>RAM is back-biased if the device is in standby mode</td>
Kojto 111:4336505e4b1c 329 * </tr>
Kojto 111:4336505e4b1c 330 * <tr>
Kojto 111:4336505e4b1c 331 * <td>Standby OFF mode</td>
Kojto 111:4336505e4b1c 332 * <td>RAM is OFF if the device is in standby mode</td>
Kojto 111:4336505e4b1c 333 * </tr>
Kojto 111:4336505e4b1c 334 * <tr>
Kojto 111:4336505e4b1c 335 * <td>Always OFF mode</td>
Kojto 111:4336505e4b1c 336 * <td>RAM is OFF if the device is in RET mode</td>
Kojto 111:4336505e4b1c 337 * </tr>
Kojto 111:4336505e4b1c 338 * </table>
Kojto 111:4336505e4b1c 339 *
Kojto 111:4336505e4b1c 340 * \endif
Kojto 111:4336505e4b1c 341 *
Kojto 111:4336505e4b1c 342 * \subsection asfdoc_sam0_system_module_overview_sleep_mode Sleep Modes
Kojto 111:4336505e4b1c 343 * The SAM devices have several sleep modes. The sleep mode controls
Kojto 111:4336505e4b1c 344 * which clock systems on the device will remain enabled or disabled when the
Kojto 111:4336505e4b1c 345 * device enters a low power sleep mode.
Kojto 111:4336505e4b1c 346 * \ref asfdoc_sam0_system_module_sleep_mode_table "The table below" lists the
Kojto 111:4336505e4b1c 347 * clock settings of the different sleep modes.
Kojto 111:4336505e4b1c 348 *
Kojto 111:4336505e4b1c 349 * \anchor asfdoc_sam0_system_module_sleep_mode_table
Kojto 111:4336505e4b1c 350 * <table>
Kojto 111:4336505e4b1c 351 * <caption>SAM Device Sleep Modes</caption>
Kojto 111:4336505e4b1c 352 * \if DEVICE_SAML21_SYSTEM_SUPPORT
Kojto 111:4336505e4b1c 353 * <tr>
Kojto 111:4336505e4b1c 354 * <th>Sleep mode</th>
Kojto 111:4336505e4b1c 355 * <th>System clock</th>
Kojto 111:4336505e4b1c 356 * <th>CPU clock</th>
Kojto 111:4336505e4b1c 357 * <th>AHB/AHB clock</th>
Kojto 111:4336505e4b1c 358 * <th>GCLK clocks</th>
Kojto 111:4336505e4b1c 359 * <th>Oscillators (ONDEMAND = 0)</th>
Kojto 111:4336505e4b1c 360 * <th>Oscillators (ONDEMAND = 1)</th>
Kojto 111:4336505e4b1c 361 * <th>Regulator mode</th>
Kojto 111:4336505e4b1c 362 * <th>RAM mode</th>
Kojto 111:4336505e4b1c 363 * </tr>
Kojto 111:4336505e4b1c 364 * <tr>
Kojto 111:4336505e4b1c 365 * <td>Idle</td>
Kojto 111:4336505e4b1c 366 * <td>Run</td>
Kojto 111:4336505e4b1c 367 * <td>Stop</td>
Kojto 111:4336505e4b1c 368 * <td>Run if requested</td>
Kojto 111:4336505e4b1c 369 * <td>Run</td>
Kojto 111:4336505e4b1c 370 * <td>Run</td>
Kojto 111:4336505e4b1c 371 * <td>Run if requested</td>
Kojto 111:4336505e4b1c 372 * <td>Normal</td>
Kojto 111:4336505e4b1c 373 * <td>Normal</td>
Kojto 111:4336505e4b1c 374 * </tr>
Kojto 111:4336505e4b1c 375 * <tr>
Kojto 111:4336505e4b1c 376 * <td>Standby</td>
Kojto 111:4336505e4b1c 377 * <td>Stop</td>
Kojto 111:4336505e4b1c 378 * <td>Stop</td>
Kojto 111:4336505e4b1c 379 * <td>Run if requested</td>
Kojto 111:4336505e4b1c 380 * <td>Run if requested</td>
Kojto 111:4336505e4b1c 381 * <td>Run if requested or RUNSTDBY = 1</td>
Kojto 111:4336505e4b1c 382 * <td>Run if requested</td>
Kojto 111:4336505e4b1c 383 * <td>Low pwer</td>
Kojto 111:4336505e4b1c 384 * <td>Low pwer</td>
Kojto 111:4336505e4b1c 385 * </tr>
Kojto 111:4336505e4b1c 386 * <tr>
Kojto 111:4336505e4b1c 387 * <td>Backup</td>
Kojto 111:4336505e4b1c 388 * <td>Stop</td>
Kojto 111:4336505e4b1c 389 * <td>Stop</td>
Kojto 111:4336505e4b1c 390 * <td>Stop</td>
Kojto 111:4336505e4b1c 391 * <td>Stop</td>
Kojto 111:4336505e4b1c 392 * <td>Stop</td>
Kojto 111:4336505e4b1c 393 * <td>Stop</td>
Kojto 111:4336505e4b1c 394 * <td>Backup</td>
Kojto 111:4336505e4b1c 395 * <td>Off</td>
Kojto 111:4336505e4b1c 396 * </tr>
Kojto 111:4336505e4b1c 397 * <tr>
Kojto 111:4336505e4b1c 398 * <td>Off</td>
Kojto 111:4336505e4b1c 399 * <td>Off</td>
Kojto 111:4336505e4b1c 400 * <td>Off</td>
Kojto 111:4336505e4b1c 401 * <td>Off</td>
Kojto 111:4336505e4b1c 402 * <td>Off</td>
Kojto 111:4336505e4b1c 403 * <td>Off</td>
Kojto 111:4336505e4b1c 404 * <td>Off</td>
Kojto 111:4336505e4b1c 405 * <td>Off</td>
Kojto 111:4336505e4b1c 406 * <td>Off</td>
Kojto 111:4336505e4b1c 407 * </tr>
Kojto 111:4336505e4b1c 408 * \else
Kojto 111:4336505e4b1c 409 * <tr>
Kojto 111:4336505e4b1c 410 * <th>Sleep mode</th>
Kojto 111:4336505e4b1c 411 * <th>CPU clock</th>
Kojto 111:4336505e4b1c 412 * <th>AHB clock</th>
Kojto 111:4336505e4b1c 413 * <th>APB clocks</th>
Kojto 111:4336505e4b1c 414 * <th>Clock sources</th>
Kojto 111:4336505e4b1c 415 * <th>System clock</th>
Kojto 111:4336505e4b1c 416 * <th>32KHz</th>
Kojto 111:4336505e4b1c 417 * <th>Reg mode</th>
Kojto 111:4336505e4b1c 418 * <th>RAM mode</th>
Kojto 111:4336505e4b1c 419 * </tr>
Kojto 111:4336505e4b1c 420 * <tr>
Kojto 111:4336505e4b1c 421 * <td>Idle 0</td>
Kojto 111:4336505e4b1c 422 * <td>Stop</td>
Kojto 111:4336505e4b1c 423 * <td>Run</td>
Kojto 111:4336505e4b1c 424 * <td>Run</td>
Kojto 111:4336505e4b1c 425 * <td>Run</td>
Kojto 111:4336505e4b1c 426 * <td>Run</td>
Kojto 111:4336505e4b1c 427 * <td>Run</td>
Kojto 111:4336505e4b1c 428 * <td>Normal</td>
Kojto 111:4336505e4b1c 429 * <td>Normal</td>
Kojto 111:4336505e4b1c 430 * </tr>
Kojto 111:4336505e4b1c 431 * <tr>
Kojto 111:4336505e4b1c 432 * <td>Idle 1</td>
Kojto 111:4336505e4b1c 433 * <td>Stop</td>
Kojto 111:4336505e4b1c 434 * <td>Stop</td>
Kojto 111:4336505e4b1c 435 * <td>Run</td>
Kojto 111:4336505e4b1c 436 * <td>Run</td>
Kojto 111:4336505e4b1c 437 * <td>Run</td>
Kojto 111:4336505e4b1c 438 * <td>Run</td>
Kojto 111:4336505e4b1c 439 * <td>Normal</td>
Kojto 111:4336505e4b1c 440 * <td>Normal</td>
Kojto 111:4336505e4b1c 441 * </tr>
Kojto 111:4336505e4b1c 442 * <tr>
Kojto 111:4336505e4b1c 443 * <td>Idle 2</td>
Kojto 111:4336505e4b1c 444 * <td>Stop</td>
Kojto 111:4336505e4b1c 445 * <td>Stop</td>
Kojto 111:4336505e4b1c 446 * <td>Stop</td>
Kojto 111:4336505e4b1c 447 * <td>Run</td>
Kojto 111:4336505e4b1c 448 * <td>Run</td>
Kojto 111:4336505e4b1c 449 * <td>Run</td>
Kojto 111:4336505e4b1c 450 * <td>Normal</td>
Kojto 111:4336505e4b1c 451 * <td>Normal</td>
Kojto 111:4336505e4b1c 452 * </tr>
Kojto 111:4336505e4b1c 453 * <tr>
Kojto 111:4336505e4b1c 454 * <td>Standby</td>
Kojto 111:4336505e4b1c 455 * <td>Stop</td>
Kojto 111:4336505e4b1c 456 * <td>Stop</td>
Kojto 111:4336505e4b1c 457 * <td>Stop</td>
Kojto 111:4336505e4b1c 458 * <td>Stop</td>
Kojto 111:4336505e4b1c 459 * <td>Stop</td>
Kojto 111:4336505e4b1c 460 * <td>Stop</td>
Kojto 111:4336505e4b1c 461 * <td>Low Power</td>
Kojto 111:4336505e4b1c 462 * <td>Source/Drain biasing</td>
Kojto 111:4336505e4b1c 463 * </tr>
Kojto 111:4336505e4b1c 464 * \endif
Kojto 111:4336505e4b1c 465 * </table>
Kojto 111:4336505e4b1c 466 *
Kojto 111:4336505e4b1c 467 * Before entering device sleep, one of the available sleep modes must be set.
Kojto 111:4336505e4b1c 468 * The device will automatically wake up in response to an interrupt being
Kojto 111:4336505e4b1c 469 * generated or upon any other sleep mode exit condition.
Kojto 111:4336505e4b1c 470 *
Kojto 111:4336505e4b1c 471 * Some peripheral clocks will remain enabled during sleep, depending on their
Kojto 111:4336505e4b1c 472 * configuration. If desired, the modules can remain clocked during sleep to allow
Kojto 111:4336505e4b1c 473 * them continue to operate while other parts of the system are powered down
Kojto 111:4336505e4b1c 474 * to save power.
Kojto 111:4336505e4b1c 475 *
Kojto 111:4336505e4b1c 476 *
Kojto 111:4336505e4b1c 477 * \section asfdoc_sam0_system_special_considerations Special Considerations
Kojto 111:4336505e4b1c 478 *
Kojto 111:4336505e4b1c 479 * Most of the functions in this driver have device specific restrictions and
Kojto 111:4336505e4b1c 480 * caveats; refer to your device datasheet.
Kojto 111:4336505e4b1c 481 *
Kojto 111:4336505e4b1c 482 *
Kojto 111:4336505e4b1c 483 * \section asfdoc_sam0_system_extra_info Extra Information
Kojto 111:4336505e4b1c 484 *
Kojto 111:4336505e4b1c 485 * For extra information, see \ref asfdoc_sam0_system_extra. This includes:
Kojto 111:4336505e4b1c 486 * - \ref asfdoc_sam0_system_extra_acronyms
Kojto 111:4336505e4b1c 487 * - \ref asfdoc_sam0_system_extra_dependencies
Kojto 111:4336505e4b1c 488 * - \ref asfdoc_sam0_system_extra_errata
Kojto 111:4336505e4b1c 489 * - \ref asfdoc_sam0_system_extra_history
Kojto 111:4336505e4b1c 490 *
Kojto 111:4336505e4b1c 491 *
Kojto 111:4336505e4b1c 492 * \section asfdoc_sam0_system_examples Examples
Kojto 111:4336505e4b1c 493 *
Kojto 111:4336505e4b1c 494 * For SYSTEM module related examples, refer to the sub-modules listed in
Kojto 111:4336505e4b1c 495 * the \ref asfdoc_sam0_system_module_overview "system module overview".
Kojto 111:4336505e4b1c 496 *
Kojto 111:4336505e4b1c 497 * For a list of examples related to this driver, see
Kojto 111:4336505e4b1c 498 * \ref asfdoc_sam0_drivers_power_exqsg.
Kojto 111:4336505e4b1c 499 *
Kojto 111:4336505e4b1c 500 *
Kojto 111:4336505e4b1c 501 * \section asfdoc_sam0_system_api_overview API Overview
Kojto 111:4336505e4b1c 502 * @{
Kojto 111:4336505e4b1c 503 */
Kojto 111:4336505e4b1c 504
Kojto 111:4336505e4b1c 505 /**
Kojto 111:4336505e4b1c 506 * \name System Debugger
Kojto 111:4336505e4b1c 507 * @{
Kojto 111:4336505e4b1c 508 */
Kojto 111:4336505e4b1c 509
Kojto 111:4336505e4b1c 510 /**
Kojto 111:4336505e4b1c 511 * \brief Check if debugger is present.
Kojto 111:4336505e4b1c 512 *
Kojto 111:4336505e4b1c 513 * Check if debugger is connected to the onboard debug system (DAP).
Kojto 111:4336505e4b1c 514 *
Kojto 111:4336505e4b1c 515 * \return A bool identifying if a debugger is present.
Kojto 111:4336505e4b1c 516 *
Kojto 111:4336505e4b1c 517 * \retval true Debugger is connected to the system
Kojto 111:4336505e4b1c 518 * \retval false Debugger is not connected to the system
Kojto 111:4336505e4b1c 519 *
Kojto 111:4336505e4b1c 520 */
Kojto 111:4336505e4b1c 521 static inline bool system_is_debugger_present(void)
Kojto 111:4336505e4b1c 522 {
Kojto 111:4336505e4b1c 523 return DSU->STATUSB.reg & DSU_STATUSB_DBGPRES;
Kojto 111:4336505e4b1c 524 }
Kojto 111:4336505e4b1c 525
Kojto 111:4336505e4b1c 526 /**
Kojto 111:4336505e4b1c 527 * @}
Kojto 111:4336505e4b1c 528 */
Kojto 111:4336505e4b1c 529
Kojto 111:4336505e4b1c 530 /**
Kojto 111:4336505e4b1c 531 * \name System Identification
Kojto 111:4336505e4b1c 532 * @{
Kojto 111:4336505e4b1c 533 */
Kojto 111:4336505e4b1c 534
Kojto 111:4336505e4b1c 535 /**
Kojto 111:4336505e4b1c 536 * \brief Retrieve the device identification signature.
Kojto 111:4336505e4b1c 537 *
Kojto 111:4336505e4b1c 538 * Retrieves the signature of the current device.
Kojto 111:4336505e4b1c 539 *
Kojto 111:4336505e4b1c 540 * \return Device ID signature as a 32-bit integer.
Kojto 111:4336505e4b1c 541 */
Kojto 111:4336505e4b1c 542 static inline uint32_t system_get_device_id(void)
Kojto 111:4336505e4b1c 543 {
Kojto 111:4336505e4b1c 544 return DSU->DID.reg;
Kojto 111:4336505e4b1c 545 }
Kojto 111:4336505e4b1c 546
Kojto 111:4336505e4b1c 547 /**
Kojto 111:4336505e4b1c 548 * @}
Kojto 111:4336505e4b1c 549 */
Kojto 111:4336505e4b1c 550
Kojto 111:4336505e4b1c 551 /**
Kojto 111:4336505e4b1c 552 * \name System Initialization
Kojto 111:4336505e4b1c 553 * @{
Kojto 111:4336505e4b1c 554 */
Kojto 111:4336505e4b1c 555
Kojto 111:4336505e4b1c 556 void system_init(void);
Kojto 111:4336505e4b1c 557
Kojto 111:4336505e4b1c 558 /**
Kojto 111:4336505e4b1c 559 * @}
Kojto 111:4336505e4b1c 560 */
Kojto 111:4336505e4b1c 561
Kojto 111:4336505e4b1c 562
Kojto 111:4336505e4b1c 563 /**
Kojto 111:4336505e4b1c 564 * @}
Kojto 111:4336505e4b1c 565 */
Kojto 111:4336505e4b1c 566
Kojto 111:4336505e4b1c 567 /**
Kojto 111:4336505e4b1c 568
Kojto 111:4336505e4b1c 569 * \page asfdoc_sam0_drivers_power_exqsg Examples for Power Driver
Kojto 111:4336505e4b1c 570 *
Kojto 111:4336505e4b1c 571 * This is a list of the available Quick Start Guides (QSGs) and example
Kojto 111:4336505e4b1c 572 * applications. QSGs are simple examples with step-by-step instructions to
Kojto 111:4336505e4b1c 573 * configure and use this driver in a selection of
Kojto 111:4336505e4b1c 574 * use cases. Note that a QSG can be compiled as a standalone application or be
Kojto 111:4336505e4b1c 575 * added to the user application.
Kojto 111:4336505e4b1c 576 *
Kojto 111:4336505e4b1c 577 * \if DEVICE_SAML21_SYSTEM_SUPPORT
Kojto 111:4336505e4b1c 578 * - \subpage asfdoc_sam0_power_basic_use_case
Kojto 111:4336505e4b1c 579 * \endif
Kojto 111:4336505e4b1c 580 *
Kojto 111:4336505e4b1c 581 * \page asfdoc_sam0_system_extra Extra Information for SYSTEM Driver
Kojto 111:4336505e4b1c 582 *
Kojto 111:4336505e4b1c 583 * \section asfdoc_sam0_system_extra_acronyms Acronyms
Kojto 111:4336505e4b1c 584 * Below is a table listing the acronyms used in this module, along with their
Kojto 111:4336505e4b1c 585 * intended meanings.
Kojto 111:4336505e4b1c 586 *
Kojto 111:4336505e4b1c 587 * <table>
Kojto 111:4336505e4b1c 588 * <tr>
Kojto 111:4336505e4b1c 589 * <th>Acronym</th>
Kojto 111:4336505e4b1c 590 * <th>Definition</th>
Kojto 111:4336505e4b1c 591 * </tr>
Kojto 111:4336505e4b1c 592 * <tr>
Kojto 111:4336505e4b1c 593 * <td>PM</td>
Kojto 111:4336505e4b1c 594 * <td>Power Manager</td>
Kojto 111:4336505e4b1c 595 * </tr>
Kojto 111:4336505e4b1c 596 * \if DEVICE_SAML21_SYSTEM_SUPPORT
Kojto 111:4336505e4b1c 597 * <tr>
Kojto 111:4336505e4b1c 598 * <td>SUPC</td>
Kojto 111:4336505e4b1c 599 * <td>Supply Controller</td>
Kojto 111:4336505e4b1c 600 * </tr>
Kojto 111:4336505e4b1c 601 * <tr>
Kojto 111:4336505e4b1c 602 * <td>RSTC</td>
Kojto 111:4336505e4b1c 603 * <td>Reset Controller</td>
Kojto 111:4336505e4b1c 604 * </tr>
Kojto 111:4336505e4b1c 605 * \endif
Kojto 111:4336505e4b1c 606 * \if DEVICE_SAMC21_SYSTEM_SUPPORT
Kojto 111:4336505e4b1c 607 * <tr>
Kojto 111:4336505e4b1c 608 * <td>SUPC</td>
Kojto 111:4336505e4b1c 609 * <td>Supply Controller</td>
Kojto 111:4336505e4b1c 610 * </tr>
Kojto 111:4336505e4b1c 611 * <tr>
Kojto 111:4336505e4b1c 612 * <td>RSTC</td>
Kojto 111:4336505e4b1c 613 * <td>Reset Controller</td>
Kojto 111:4336505e4b1c 614 * </tr>
Kojto 111:4336505e4b1c 615 * \endif
Kojto 111:4336505e4b1c 616 * \if DEVICE_SAMD21_SYSTEM_SUPPORT
Kojto 111:4336505e4b1c 617 * <tr>
Kojto 111:4336505e4b1c 618 * <td>SYSCTRL</td>
Kojto 111:4336505e4b1c 619 * <td>System control interface</td>
Kojto 111:4336505e4b1c 620 * </tr>
Kojto 111:4336505e4b1c 621 * \endif
Kojto 111:4336505e4b1c 622 * </table>
Kojto 111:4336505e4b1c 623 *
Kojto 111:4336505e4b1c 624 *
Kojto 111:4336505e4b1c 625 * \section asfdoc_sam0_system_extra_dependencies Dependencies
Kojto 111:4336505e4b1c 626 * This driver has the following dependencies:
Kojto 111:4336505e4b1c 627 *
Kojto 111:4336505e4b1c 628 * - None
Kojto 111:4336505e4b1c 629 *
Kojto 111:4336505e4b1c 630 *
Kojto 111:4336505e4b1c 631 * \section asfdoc_sam0_system_extra_errata Errata
Kojto 111:4336505e4b1c 632 * There are no errata related to this driver.
Kojto 111:4336505e4b1c 633 *
Kojto 111:4336505e4b1c 634 *
Kojto 111:4336505e4b1c 635 * \section asfdoc_sam0_system_extra_history Module History
Kojto 111:4336505e4b1c 636 * An overview of the module history is presented in the table below, with
Kojto 111:4336505e4b1c 637 * details on the enhancements and fixes made to the module since its first
Kojto 111:4336505e4b1c 638 * release. The current version of this corresponds to the newest version in
Kojto 111:4336505e4b1c 639 * the table.
Kojto 111:4336505e4b1c 640 *
Kojto 111:4336505e4b1c 641 * <table>
Kojto 111:4336505e4b1c 642 * <tr>
Kojto 111:4336505e4b1c 643 * <th>Changelog</th>
Kojto 111:4336505e4b1c 644 * </tr>
Kojto 111:4336505e4b1c 645 * \if DEVICE_SAML21_SYSTEM_SUPPORT
Kojto 111:4336505e4b1c 646 * <tr>
Kojto 111:4336505e4b1c 647 * <td>Initial Release</td>
Kojto 111:4336505e4b1c 648 * </tr>
Kojto 111:4336505e4b1c 649 * \endif
Kojto 111:4336505e4b1c 650 * \if DEVICE_SAMC21_SYSTEM_SUPPORT
Kojto 111:4336505e4b1c 651 * <tr>
Kojto 111:4336505e4b1c 652 * <td>Initial Release</td>
Kojto 111:4336505e4b1c 653 * </tr>
Kojto 111:4336505e4b1c 654 * \endif
Kojto 111:4336505e4b1c 655 * \if DEVICE_SAMD21_SYSTEM_SUPPORT
Kojto 111:4336505e4b1c 656 * <tr>
Kojto 111:4336505e4b1c 657 * <td>Added new \c system_reset() to reset the complete MCU with some exceptions</td>
Kojto 111:4336505e4b1c 658 * </tr>
Kojto 111:4336505e4b1c 659 * <tr>
Kojto 111:4336505e4b1c 660 * <td>Added new \c system_get_device_id() function to retrieved the device
Kojto 111:4336505e4b1c 661 * ID.</td>
Kojto 111:4336505e4b1c 662 * </tr>
Kojto 111:4336505e4b1c 663 * <tr>
Kojto 111:4336505e4b1c 664 * <td>Initial Release</td>
Kojto 111:4336505e4b1c 665 * </tr>
Kojto 111:4336505e4b1c 666 * \endif
Kojto 111:4336505e4b1c 667 * </table>
Kojto 111:4336505e4b1c 668 *
Kojto 111:4336505e4b1c 669 * \page asfdoc_sam0_system_document_revision_history Document Revision History
Kojto 111:4336505e4b1c 670 *
Kojto 111:4336505e4b1c 671 * <table>
Kojto 111:4336505e4b1c 672 * <tr>
Kojto 111:4336505e4b1c 673 * <th>Doc. Rev.</td>
Kojto 111:4336505e4b1c 674 * <th>Date</td>
Kojto 111:4336505e4b1c 675 * <th>Comments</td>
Kojto 111:4336505e4b1c 676 * </tr>
Kojto 111:4336505e4b1c 677 * \if DEVICE_SAML21_SYSTEM_SUPPORT
Kojto 111:4336505e4b1c 678 * <tr>
Kojto 111:4336505e4b1c 679 * <td>42449A</td>
Kojto 111:4336505e4b1c 680 * <td>07/2015</td>
Kojto 111:4336505e4b1c 681 * <td>Initial document release</td>
Kojto 111:4336505e4b1c 682 * </tr>
Kojto 111:4336505e4b1c 683 * \endif
Kojto 111:4336505e4b1c 684 * \if DEVICE_SAMC21_SYSTEM_SUPPORT
Kojto 111:4336505e4b1c 685 * <tr>
Kojto 111:4336505e4b1c 686 * <td>42484A</td>
Kojto 111:4336505e4b1c 687 * <td>08/2015</td>
Kojto 111:4336505e4b1c 688 * <td>Initial document release.</td>
Kojto 111:4336505e4b1c 689 * </tr>
Kojto 111:4336505e4b1c 690 * \endif
Kojto 111:4336505e4b1c 691 * \if DEVICE_SAMD21_SYSTEM_SUPPORT
Kojto 111:4336505e4b1c 692 * <tr>
Kojto 111:4336505e4b1c 693 * <td>42120E</td>
Kojto 111:4336505e4b1c 694 * <td>04/2015</td>
Kojto 111:4336505e4b1c 695 * <td>Added support for SAMDAx</td>
Kojto 111:4336505e4b1c 696 * </tr>
Kojto 111:4336505e4b1c 697 * <tr>
Kojto 111:4336505e4b1c 698 * <td>42120D</td>
Kojto 111:4336505e4b1c 699 * <td>12/2014</td>
Kojto 111:4336505e4b1c 700 * <td>Added support for SAMR21 and SAMD10/D11</td>
Kojto 111:4336505e4b1c 701 * </tr>
Kojto 111:4336505e4b1c 702 * <tr>
Kojto 111:4336505e4b1c 703 * <td>42120C</td>
Kojto 111:4336505e4b1c 704 * <td>01/2014</td>
Kojto 111:4336505e4b1c 705 * <td>Added support for SAMD21</td>
Kojto 111:4336505e4b1c 706 * </tr>
Kojto 111:4336505e4b1c 707 * <tr>
Kojto 111:4336505e4b1c 708 * <td>42120B</td>
Kojto 111:4336505e4b1c 709 * <td>06/2013</td>
Kojto 111:4336505e4b1c 710 * <td>Corrected documentation typos</td>
Kojto 111:4336505e4b1c 711 * </tr>
Kojto 111:4336505e4b1c 712 * <tr>
Kojto 111:4336505e4b1c 713 * <td>42120A</td>
Kojto 111:4336505e4b1c 714 * <td>06/2013</td>
Kojto 111:4336505e4b1c 715 * <td>Initial document release</td>
Kojto 111:4336505e4b1c 716 * </tr>
Kojto 111:4336505e4b1c 717 * \endif
Kojto 111:4336505e4b1c 718 * </table>
Kojto 111:4336505e4b1c 719 */
Kojto 111:4336505e4b1c 720
Kojto 111:4336505e4b1c 721 #ifdef __cplusplus
Kojto 111:4336505e4b1c 722 }
Kojto 111:4336505e4b1c 723 #endif
Kojto 111:4336505e4b1c 724
Kojto 111:4336505e4b1c 725 #endif /* SYSTEM_H_INCLUDED */
Kojto 111:4336505e4b1c 726