blob: 89472f156acd17459b88ad5b5402c700d7d9ce16 [file] [log] [blame]
Kévin Redon69b92d92019-01-24 16:39:20 +01001/**
2 * \file
3 *
4 * \brief Sleep related functionality implementation.
5 *
6 * Copyright (c) 2014-2018 Microchip Technology Inc. and its subsidiaries.
7 *
8 * \asf_license_start
9 *
10 * \page License
11 *
12 * Subject to your compliance with these terms, you may use Microchip
13 * software and any derivatives exclusively with Microchip products.
14 * It is your responsibility to comply with third party license terms applicable
15 * to your use of third party software (including open source software) that
16 * may accompany Microchip software.
17 *
18 * THIS SOFTWARE IS SUPPLIED BY MICROCHIP "AS IS". NO WARRANTIES,
19 * WHETHER EXPRESS, IMPLIED OR STATUTORY, APPLY TO THIS SOFTWARE,
20 * INCLUDING ANY IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY,
21 * AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT WILL MICROCHIP BE
22 * LIABLE FOR ANY INDIRECT, SPECIAL, PUNITIVE, INCIDENTAL OR CONSEQUENTIAL
23 * LOSS, DAMAGE, COST OR EXPENSE OF ANY KIND WHATSOEVER RELATED TO THE
24 * SOFTWARE, HOWEVER CAUSED, EVEN IF MICROCHIP HAS BEEN ADVISED OF THE
25 * POSSIBILITY OR THE DAMAGES ARE FORESEEABLE. TO THE FULLEST EXTENT
26 * ALLOWED BY LAW, MICROCHIP'S TOTAL LIABILITY ON ALL CLAIMS IN ANY WAY
27 * RELATED TO THIS SOFTWARE WILL NOT EXCEED THE AMOUNT OF FEES, IF ANY,
28 * THAT YOU HAVE PAID DIRECTLY TO MICROCHIP FOR THIS SOFTWARE.
29 *
30 * \asf_license_stop
31 *
32 */
33
34#include "hal_sleep.h"
35#include <hpl_sleep.h>
36
37/**
38 * \brief Driver version
39 */
40#define DRIVER_VERSION 0x00000001u
41
42/**
43 * \brief Set the sleep mode of the device and put the MCU to sleep
44 *
45 * For an overview of which systems are disabled in sleep for the different
46 * sleep modes, see the data sheet.
47 *
48 * \param[in] mode Sleep mode to use
49 *
50 * \return The status of a sleep request
51 * \retval -1 The requested sleep mode was invalid or not available
52 * \retval 0 The operation completed successfully, returned after leaving the
53 * sleep
54 */
55int sleep(const uint8_t mode)
56{
57 if (ERR_NONE != _set_sleep_mode(mode))
58 return ERR_INVALID_ARG;
59
60 _go_to_sleep();
61
62 return ERR_NONE;
63}
64
65/**
66 * \brief Retrieve the current driver version
67 *
68 * \return Current driver version
69 */
70uint32_t sleep_get_version(void)
71{
72 return DRIVER_VERSION;
73}