Skip to content

Commit dd8f6e5

Browse files
srisurya1srisurya1
committed
Import Apollo2 HAL from AmbiqSuite SDK 2.5.1
Origin: Ambiq AmbiqSuite SDK Version: 2.5.1 Purpose: Add support for Apollo2 SoCs. Signed-off-by: Sri Surya <[email protected]>
1 parent e0538a9 commit dd8f6e5

File tree

121 files changed

+139472
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

121 files changed

+139472
-0
lines changed

‎CMSIS/AmbiqMicro/Include/apollo2.h

Lines changed: 14326 additions & 0 deletions
Large diffs are not rendered by default.

‎CMSIS/AmbiqMicro/Include/system_apollo2.h

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
//*****************************************************************************
2+
//
3+
//! @file system_apollo2.h
4+
//!
5+
//! @brief Ambiq Micro Apollo2 MCU specific functions.
6+
//
7+
//*****************************************************************************
8+
9+
//*****************************************************************************
10+
//
11+
// Copyright (c) 2020, Ambiq Micro, Inc.
12+
// All rights reserved.
13+
//
14+
// Redistribution and use in source and binary forms, with or without
15+
// modification, are permitted provided that the following conditions are met:
16+
//
17+
// 1. Redistributions of source code must retain the above copyright notice,
18+
// this list of conditions and the following disclaimer.
19+
//
20+
// 2. Redistributions in binary form must reproduce the above copyright
21+
// notice, this list of conditions and the following disclaimer in the
22+
// documentation and/or other materials provided with the distribution.
23+
//
24+
// 3. Neither the name of the copyright holder nor the names of its
25+
// contributors may be used to endorse or promote products derived from this
26+
// software without specific prior written permission.
27+
//
28+
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
29+
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
30+
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
31+
// ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
32+
// LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
33+
// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
34+
// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
35+
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
36+
// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
37+
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
38+
// POSSIBILITY OF SUCH DAMAGE.
39+
//
40+
//*****************************************************************************
41+
42+
#ifndef SYSTEM_APOLLO2_H
43+
#define SYSTEM_APOLLO2_H
44+
45+
#ifdef __cplusplus
46+
extern "C" {
47+
#endif
48+
49+
#include <stdint.h>
50+
51+
extern uint32_t SystemCoreClock; // System Clock Frequency (Core Clock)
52+
53+
//*****************************************************************************
54+
//
55+
// External function definitions
56+
//
57+
//*****************************************************************************
58+
extern void SystemInit (void);
59+
extern void SystemCoreClockUpdate (void);
60+
61+
#ifdef __cplusplus
62+
}
63+
#endif
64+
65+
#endif // SYSTEM_APOLLO2_H
66+

‎README.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,8 @@ Status
3030
+------------------------+--------------------------------+
3131
| SOC | AmbiqSuite SDK Revision |
3232
+========================+================================+
33+
| Apollo2 | v2.5.1 |
34+
+------------------------+--------------------------------+
3335
| Apollo3 Blue | v3.1.1 |
3436
+------------------------+--------------------------------+
3537
| Apollo3 Blue Plus | v3.1.1 |

‎docs/apollo2/index.html

Lines changed: 95 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,95 @@
1+
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2+
<html xmlns="http://www.w3.org/1999/xhtml">
3+
<head>
4+
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
5+
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
6+
<meta name="generator" content="AmbiqMicro"/>
7+
<title>AmbiqSuite User Guide: AmbiqSuite Apollo2 Device Register Overview</title>
8+
<link href="resources/tabs.css" rel="stylesheet" type="text/css"/>
9+
<script type="text/javascript" src="resources/jquery.js"></script>
10+
<script type="text/javascript" src="resources/dynsections.js"></script>
11+
<link href="search/search.css" rel="stylesheet" type="text/css"/>
12+
<link href="resources/customdoxygen.css" rel="stylesheet" type="text/css" />
13+
</head>
14+
<body>
15+
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
16+
<div id="titlearea">
17+
<table cellspacing="0" cellpadding="0">
18+
<tbody>
19+
<tr style="height: 56px;">
20+
<td id="projectlogo"><img alt="Logo" src="resources/am_logo.png"/></td>
21+
<td style="padding-left: 0.5em;">
22+
<div id="projectname">Apollo2 Register Documentation
23+
</div>
24+
</td>
25+
</tr>
26+
</tbody>
27+
</table>
28+
</div>
29+
<!-- end header part -->
30+
<div id="navrow1" class="tabs">
31+
<ul class="tablist">
32+
<li class="current"><a href="index.html"><span>Main&#160;Page</span></a></li>
33+
</div>
34+
</li>
35+
</ul>
36+
</div>
37+
</div><!-- top -->
38+
<!-- window showing the filter options -->
39+
<div class="header">
40+
<div class="headertitle">
41+
<div class="title">Select a Peripheral to View its Register Documentation.</div></div>
42+
</div><!--header-->
43+
44+
<div class="contents">
45+
<!--<div class="textblock">Here is a list of all peripherals:</div>-->
46+
<div class="directory">
47+
<div class="levels"></div><table class="directory">
48+
<tr id="row_0_" class="even"><td class="entry"><span style="width:0px;display:inline-block;">&#160;</span><span id="arr_0_" class="arrow" onclick="toggleFolder('0_')"></span><a STYLE="text-decoration: none" class="el">ARM Peripherals&nbsp&nbsp&nbsp</a></td><td>
49+
<tr id="row_0_0_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><a class="el" href="pages/itm_regs.html" target="_self">ITM</a></td><td class="desc">Integrated Trace Module</td></tr>
50+
<tr id="row_0_0_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><a class="el" href="pages/tpiu_regs.html" target="_self">TPIU</a></td><td class="desc">Trace Port Interface Unit</td></tr>
51+
<tr id="row_0_0_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><a class="el" href="pages/nvic_regs.html" target="_self">NVIC</a></td><td class="desc">Nested Vectored Interrupt Controller</td></tr>
52+
<tr id="row_0_0_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><a class="el" href="pages/sysctrl_regs.html" target="_self">SYSCTRL</a></td><td class="desc">System Control</td></tr>
53+
<tr id="row_0_0_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><a class="el" href="pages/systick_regs.html" target="_self">SYSTICK</a></td><td class="desc">System Timer</td></tr>
54+
</table>
55+
</div><!-- directory -->
56+
</div><!-- contents -->
57+
58+
<div class="contents">
59+
<!--<div class="textblock">Here is a list of all peripherals:</div>-->
60+
<div class="directory">
61+
<div class="levels"></div><table class="directory">
62+
<tr id="row_0_" class="even"><td class="entry"><span style="width:0px;display:inline-block;">&#160;</span><a STYLE="text-decoration: none" class="el">Apollo2 Peripherals</a></td><td>
63+
64+
<tr id="row_0_0_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><a class="el" href="pages/adc_regs.html" target="_self">ADC</a></td><td class="desc">Analog Digital Converter Control</td></tr>
65+
<tr id="row_0_0_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><a class="el" href="pages/cachectrl_regs.html" target="_self">CACHECTRL</a></td><td class="desc">Cache Control</td></tr>
66+
<tr id="row_0_0_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><a class="el" href="pages/clkgen_regs.html" target="_self">CLKGEN</a></td><td class="desc">Clock Generator</td></tr>
67+
<tr id="row_0_0_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><a class="el" href="pages/ctimer_regs.html" target="_self">CTIMER</a></td><td class="desc">Counter/Timer</td></tr>
68+
<tr id="row_0_0_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><a class="el" href="pages/gpio_regs.html" target="_self">GPIO</a></td><td class="desc">General Purpose IO</td></tr>
69+
<tr id="row_0_0_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><a class="el" href="pages/iomstr_regs.html" target="_self">IOMSTR</a></td><td class="desc">SPI/I2C I/O Master</td></tr>
70+
<tr id="row_0_0_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><a class="el" href="pages/ioslave_regs.html" target="_self">IOSLAVE</a></td><td class="desc">SPI/I2C I/O Slave</td></tr>
71+
<tr id="row_0_0_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><a class="el" href="pages/mcuctrl_regs.html" target="_self">MCUCTRL</a></td><td class="desc">MCU Miscellaneous Control Logic</td></tr>
72+
<tr id="row_0_0_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><a class="el" href="pages/pdm_regs.html" target="_self">PDM</a></td><td class="desc">Pulse Density Modulation Input (DMEMS Microphone)</td></tr>
73+
<tr id="row_0_0_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><a class="el" href="pages/pwrctrl_regs.html" target="_self">PWRCTRL</a></td><td class="desc">Power Control</td></tr>
74+
<tr id="row_0_0_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><a class="el" href="pages/rstgen_regs.html" target="_self">RSTGEN</a></td><td class="desc">MCU Reset Generator</td></tr>
75+
<tr id="row_0_0_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><a class="el" href="pages/rtc_regs.html" target="_self">RTC</a></td><td class="desc">Real Time Clock</td></tr>
76+
<tr id="row_0_0_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><a class="el" href="pages/uart_regs.html" target="_self">UART</a></td><td class="desc">Serial UART</td></tr>
77+
<tr id="row_0_0_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><a class="el" href="pages/vcomp_regs.html" target="_self">VCOMP</a></td><td class="desc">Voltage Comparator</td></tr>
78+
<tr id="row_0_0_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><a class="el" href="pages/wdt_regs.html" target="_self">WDT</a></td><td class="desc">Watchdog Timer</td></tr>
79+
80+
</table>
81+
</div><!-- directory -->
82+
</div><!-- contents -->
83+
84+
<hr size="1">
85+
<body>
86+
<div id="footer" align="right">
87+
<small>
88+
Apollo2 Register Documentation&nbsp;
89+
<a href="http://www.ambiqmicro.com">
90+
<img class="footer" src="resources/ambiqmicro_logo.png" alt="Ambiq Micro"/></a>&nbsp&nbsp Copyright &copy; ${year}&nbsp&nbsp<br />
91+
This documentation is licensed and distributed under the <a rel="license" href="http://opensource.org/licenses/BSD-3-Clause">BSD 3-Clause License</a>.&nbsp&nbsp<br/>
92+
</small>
93+
</div>
94+
</body>
95+
</html>

0 commit comments

Comments
 (0)