Skip to content

Import Apollo2 HAL from AmbiqSuite SDK 2.5.1 #55

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Aug 18, 2025
Merged

Import Apollo2 HAL from AmbiqSuite SDK 2.5.1 #55

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14,326 changes: 14,326 additions & 0 deletions CMSIS/AmbiqMicro/Include/apollo2.h
View file
Open in desktop

Large diffs are not rendered by default.

66 changes: 66 additions & 0 deletions CMSIS/AmbiqMicro/Include/system_apollo2.h
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
//*****************************************************************************
//
//! @file system_apollo2.h
//!
//! @brief Ambiq Micro Apollo2 MCU specific functions.
//
//*****************************************************************************

//*****************************************************************************
//
// Copyright (c) 2020, Ambiq Micro, Inc.
// All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are met:
//
// 1. Redistributions of source code must retain the above copyright notice,
// this list of conditions and the following disclaimer.
//
// 2. 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.
//
// 3. Neither the name of the copyright holder 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 HOLDER 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 SYSTEM_APOLLO2_H
#define SYSTEM_APOLLO2_H

#ifdef __cplusplus
extern "C" {
#endif

#include <stdint.h>

extern uint32_t SystemCoreClock; // System Clock Frequency (Core Clock)

//*****************************************************************************
//
// External function definitions
//
//*****************************************************************************
extern void SystemInit (void);
extern void SystemCoreClockUpdate (void);

#ifdef __cplusplus
}
#endif

#endif // SYSTEM_APOLLO2_H

2 changes: 2 additions & 0 deletions README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,8 @@ Status
+------------------------+--------------------------------+
| SOC | AmbiqSuite SDK Revision |
+========================+================================+
| Apollo2 | v2.5.1 |
+------------------------+--------------------------------+
| Apollo3 Blue | v3.1.1 |
+------------------------+--------------------------------+
| Apollo3 Blue Plus | v3.1.1 |
Expand Down
95 changes: 95 additions & 0 deletions docs/apollo2/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="AmbiqMicro"/>
<title>AmbiqSuite User Guide: AmbiqSuite Apollo2 Device Register Overview</title>
<link href="resources/tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resources/jquery.js"></script>
<script type="text/javascript" src="resources/dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<link href="resources/customdoxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectlogo"><img alt="Logo" src="resources/am_logo.png"/></td>
<td style="padding-left: 0.5em;">
<div id="projectname">Apollo2 Register Documentation
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li class="current"><a href="index.html"><span>Main&#160;Page</span></a></li>
</div>
</li>
</ul>
</div>
</div><!-- top -->
<!-- window showing the filter options -->
<div class="header">
<div class="headertitle">
<div class="title">Select a Peripheral to View its Register Documentation.</div></div>
</div><!--header-->

<div class="contents">
<!--<div class="textblock">Here is a list of all peripherals:</div>-->
<div class="directory">
<div class="levels"></div><table class="directory">
<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>
<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>
<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>
<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>
<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>
<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>
</table>
</div><!-- directory -->
</div><!-- contents -->

<div class="contents">
<!--<div class="textblock">Here is a list of all peripherals:</div>-->
<div class="directory">
<div class="levels"></div><table class="directory">
<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>

<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>

</table>
</div><!-- directory -->
</div><!-- contents -->

<hr size="1">
<body>
<div id="footer" align="right">
<small>
Apollo2 Register Documentation&nbsp;
<a href="http://www.ambiqmicro.com">
<img class="footer" src="resources/ambiqmicro_logo.png" alt="Ambiq Micro"/></a>&nbsp&nbsp Copyright &copy; ${year}&nbsp&nbsp<br />
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/>
</small>
</div>
</body>
</html>
Loading