subrepo:
  subdir:   "libopencm3"
  merged:   "f5813a54"
upstream:
  origin:   "https://github.com/libopencm3/libopencm3"
  branch:   "master"
  commit:   "f5813a54"
git-subrepo:
  version:  "0.4.3"
  origin:   "???"
  commit:   "???"
This commit is contained in:
2021-09-30 16:34:10 +03:00
parent 1a441e5806
commit 244fdbc35c
1125 changed files with 185440 additions and 0 deletions

View File

@@ -0,0 +1,40 @@
##
## This file is part of the libopencm3 project.
##
## This library is free software: you can redistribute it and/or modify
## it under the terms of the GNU Lesser General Public License as published by
## the Free Software Foundation, either version 3 of the License, or
## (at your option) any later version.
##
## This library is distributed in the hope that it will be useful,
## but WITHOUT ANY WARRANTY; without even the implied warranty of
## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
## GNU Lesser General Public License for more details.
##
## You should have received a copy of the GNU Lesser General Public License
## along with this library. If not, see <http://www.gnu.org/licenses/>.
##
LIBNAME = libopencm3_sam4l
SRCLIBDIR ?= ../..
FP_FLAGS ?= -msoft-float
CC = $(PREFIX)gcc
AR = $(PREFIX)ar
TGT_CFLAGS = -Os -Wall -Wextra -I../../../include -fno-common \
-mcpu=cortex-m4 -mthumb $(FP_FLAGS) -Wstrict-prototypes \
-ffunction-sections -fdata-sections -MD -DSAM4L
TGT_CFLAGS += $(DEBUG_FLAGS)
# ARFLAGS = rcsv
ARFLAGS = rcs
OBJS += adcife.o
OBJS += gpio.o
OBJS += pm.o
OBJS += scif.o
OBJS += usart_common_all.o usart.o
VPATH += ../../usb:../../cm3:../common
include ../../Makefile.include

View File

@@ -0,0 +1,121 @@
/** @addtogroup scif
*
* @brief <b>Access functions for the SAM4 Analog to Digital Converter Interface (ADCIFE)</b>
* @ingroup SAM4
* LGPL License Terms @ref lgpl_license
* @author @htmlonly &copy; @endhtmlonly 2016
* Maxim Sloyko <maxims@google.com>
*
*/
#include <libopencm3/sam/adcife.h>
/** @brief Enable ADC interface. Must be done before any other configuration.
*
* This function does it synchronously and returns only when the interface is
* actually enabled.
*/
void adcife_enable_sync(void)
{
ADCIFE_CR = ADCIFE_CR_EN;
while (!(ADCIFE_SR & ADCIFE_SR_EN));
}
void adcife_configure(
enum adcife_refsel ref,
enum adcife_speed speed,
enum adcife_clk clk,
enum adcife_prescal prescal)
{
ADCIFE_CFG = ADCIFE_CFG_REFSEL_MASKED(ref)
| ADCIFE_CFG_SPEED_MASKED(speed)
| ADCIFE_CFG_PRESCAL_MASKED(prescal)
| clk;
}
void adcife_select_channel(enum adcife_channel ad)
{
ADCIFE_SEQCFG |= ADCIFE_SEQCFG_MUXPOS_MASKED(ad);
}
void adcife_set_resolution(enum adcife_resolution res)
{
if (ADCIFE_RESOLUTION_12BITS == res) {
ADCIFE_SEQCFG &= ~ADCIFE_SEQCFG_RES;
} else {
ADCIFE_SEQCFG |= ADCIFE_SEQCFG_RES;
}
}
void adcife_select_trigger(enum adcife_trigger trig)
{
ADCIFE_SEQCFG &= ~ADCIFE_SEQCFG_TRGSEL_MASK;
ADCIFE_SEQCFG |= ADCIFE_SEQCFG_TRGSEL_MASKED(trig);
}
void adcife_set_gain(enum adcife_gain gain)
{
ADCIFE_SEQCFG &= ~ADCIFE_SEQCFG_GAIN_MASK;
ADCIFE_SEQCFG |= ADCIFE_SEQCFG_GAIN_MASKED(gain);
}
void adcife_set_bipolar(bool enable)
{
if (enable) {
ADCIFE_SEQCFG |= ADCIFE_SEQCFG_BIPOLAR;
} else {
ADCIFE_SEQCFG &= ~ADCIFE_SEQCFG_BIPOLAR;
}
}
void adcife_set_left_adjust(bool enable)
{
if (enable) {
ADCIFE_SEQCFG |= ADCIFE_SEQCFG_HWLA;
} else {
ADCIFE_SEQCFG &= ~ADCIFE_SEQCFG_HWLA;
}
}
void adcife_start_conversion(void)
{
ADCIFE_CR = ADCIFE_CR_STRIG;
}
void adcife_wait_conversion(void)
{
while (!(ADCIFE_SR & ADCIFE_SR_SEOC));
ADCIFE_SCR = ADCIFE_SR_SEOC;
}
struct adcife_lcv adcife_get_lcv(void)
{
struct adcife_lcv res;
res._lc_u.lcv = ADCIFE_LCV;
return res;
}
void adcife_enable_interrupts(uint32_t imask)
{
ADCIFE_IER = imask;
}
void adcife_disable_interrupts(uint32_t imask)
{
ADCIFE_IDR = imask;
}
void adcife_timer_start(void)
{
ADCIFE_CR = ADCIFE_CR_TSTART;
}
void adcife_timer_stop(void)
{
ADCIFE_CR = ADCIFE_CR_TSTOP;
}
void adcife_timer_set_timeout(uint16_t timeout)
{
ADCIFE_TIM = timeout;
}

View File

@@ -0,0 +1,100 @@
/** @addtogroup gpio_defines
*
* @brief <b>Access functions for the SAM4 I/O Controller</b>
* @ingroup SAM4_defines
* LGPL License Terms @ref lgpl_license
* @author @htmlonly &copy; @endhtmlonly 2016
* Maxim Sloyko <maxims@google.com>
*
*/
/*
* This file is part of the libopencm3 project.
*
* Copyright (C) 2012 Gareth McMullin <gareth@blacksphere.co.nz>
* Copyright (C) 2014 Felix Held <felix-libopencm3@felixheld.de>
*
* This library is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#include <libopencm3/sam/gpio.h>
/** @brief Atomic set output
*
* @param[in] gpioport uint32_t: GPIO Port base address
* @param[in] gpios uint32_t
*/
void gpio_set(uint32_t gpioport, uint32_t gpios)
{
GPIO_OVRS(gpioport) = gpios;
}
/** @brief Atomic clear output
*
* @param[in] gpioport uint32_t: GPIO Port base address
* @param[in] gpios uint32_t
*/
void gpio_clear(uint32_t gpioport, uint32_t gpios)
{
GPIO_OVRC(gpioport) = gpios;
}
/** @brief Atomic toggle output
*
* @param[in] gpioport uint32_t: GPIO Port base address
* @param[in] gpios uint32_t
*/
void gpio_toggle(uint32_t gpioport, uint32_t gpios)
{
GPIO_OVRT(gpioport) = gpios;
}
/** @brief Enable output pins.
*
* Onlyc the ones where bits are set to "1" are touched, everything else
* remains in the old state.
*
* @param[in] gpioport uint32_t: GPIO Port base address
* @param[in] gpios uint32_t
* @param[in] mode enum gpio_mode GPIO mode. IN, OUT or peripheral function.
*/
void gpio_enable(uint32_t gpioport, uint32_t gpios, enum gpio_mode mode)
{
if (mode < GPIO_MODE_IN) {
GPIO_GPERC(gpioport) = gpios;
uint8_t i = 0;
for (; i < 3; ++i, mode >>= 1) {
GPIO_PMR_SETVAL(gpioport, i, mode & 1) = gpios;
}
} else if (mode == GPIO_MODE_OUT) {
GPIO_GPERS(gpioport) = gpios;
GPIO_ODERS(gpioport) = gpios;
} else if (mode == GPIO_MODE_IN) {
GPIO_GPERS(gpioport) = gpios;
GPIO_ODERC(gpioport) = gpios;
}
}
/** @brief Disable output pins.
*
* Onlyc the ones where bits are set to "1" are touched, everything else
* remains in the old state.
*
* @param[in] gpioport uint32_t: GPIO Port base address
* @param[in] gpios uint32_t
*/
void gpio_disable(uint32_t gpioport, uint32_t gpios)
{
GPIO_GPERC(gpioport) = gpios;
}

View File

@@ -0,0 +1,75 @@
/** @addtogroup scif
*
* @brief <b>Access functions for the SAM4 Power Manager (PM)</b>
* @ingroup SAM4
* LGPL License Terms @ref lgpl_license
* @author @htmlonly &copy; @endhtmlonly 2016
* Maxim Sloyko <maxims@google.com>
*
*/
/*
* This file is part of the libopencm3 project.
*
* This library is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#include <libopencm3/sam/pm.h>
void pm_select_main_clock(enum mck_src source_clock)
{
PM_UNLOCK = PM_MCCTRL_KEY;
PM_MCCTRL = ((source_clock & PM_MCCTRL_MCSEL_MASK) << PM_MCCTRL_MCSEL_SHIFT);
while (!(PM_SR & PM_SR_CKRDY));
}
void pm_enable_clock_div(enum pm_cksel sel_target, uint8_t div)
{
while (!(PM_SR & PM_SR_CKRDY));
uint32_t reg = (PM_CKSEL_DIV | (div & PM_CKSEL_MASK));
PM_UNLOCK = PM_CKSEL_KEY(sel_target);
PM_CKSEL(sel_target) = reg;
while (!(PM_SR & PM_SR_CKRDY));
}
void pm_set_divmask_clock(uint8_t mask)
{
PM_UNLOCK = PM_PBADIVMASK_KEY;
PM_PBADIVMASK = mask;
}
static void set_peripheral_clock_status(enum pm_peripheral periph, bool on)
{
uint8_t reg_id = periph/32;
uint8_t bit_offset = periph % 32;
uint32_t reg_mask = PM_MASK(reg_id);
if (on) {
reg_mask |= (1 << bit_offset);
} else {
reg_mask &= ~(1 << bit_offset);
}
PM_UNLOCK = PM_MASK_KEY(reg_id);
PM_MASK(reg_id) = reg_mask;
}
void pm_enable_peripheral_clock(enum pm_peripheral periph)
{
set_peripheral_clock_status(periph, true);
}
void pm_disable_peripheral_clock(enum pm_peripheral periph)
{
set_peripheral_clock_status(periph, false);
}

View File

@@ -0,0 +1,132 @@
/** @addtogroup scif
*
* @brief <b>Access functions for the SAM4 System Controf Interface (SCIF)</b>
* @ingroup SAM4
* LGPL License Terms @ref lgpl_license
* @author @htmlonly &copy; @endhtmlonly 2016
* Maxim Sloyko <maxims@google.com>
*
*/
/*
* This file is part of the libopencm3 project.
*
* This library is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#include <libopencm3/sam/scif.h>
/** @brief Enable external oscillator.
*
* @param[in] mode enum osc_mode: Oscillator mode (which pins oscillator connected to).
* @param[in] freq uint32_t: External Oscillator frequency, in Hertz. Must be 0.6MHz - 30MHz
* @param[in] startup enum osc_startup: Oscillator start time in RCSYS clock cycles.
*
* @returns zero upon success.
*/
int scif_osc_enable(enum osc_mode mode, uint32_t freq, enum osc_startup startup)
{
uint8_t gain;
const uint32_t kHz = 1000;
const uint32_t MHz = 1000 * kHz;
if (freq > 600 * kHz && freq <= 2 * MHz) {
gain = 0;
} else if (freq > 2 * MHz && freq <= 4 * MHz) {
gain = 1;
} else if (freq > 4 * MHz && freq <= 8 * MHz) {
gain = 2;
} else if (freq > 8 * MHz && freq <= 16 * MHz) {
gain = 3;
} else if (freq > 16 * MHz && freq <= 30 * MHz) {
gain = 4;
} else {
return -1;
}
SCIF_UNLOCK = SCIF_OSCCTRL0_KEY;
SCIF_OSCCTRL0 = mode | SCIF_OSCCTRL_OSCEN |
(gain << SCIF_OSCCTRL_GAIN_SHIFT) | (startup << SCIF_OSCCTRL_STARTUP_SHIFT);
while (!(SCIF_PCLKSR & SCIF_OSC0RDY));
return 0;
}
/** @brief Configure and enable PLL clock.
*
* @param[in] delay uint8_t: Specifies the number of RCSYS clock cycles before
* ISR.PLLLOCKn will be set after PLL has been written, or after PLL has
* been automatically re-enabled after exiting a sleep mode.
* @param[in] mul uint8_t: Multiply factor.
* @param[in] div uint8_t: Division factor.These fields determine the ratio of
* the PLL output frequency to the source oscillator frequency:
* f_vco = (PLLMUL+1)/PLLDIV * f_ref if PLLDIV >0
* f_vco = 2*(PLLMUL+1) * f_ref if PLLDIV = 0
* Note that the PLLMUL field should always be greater than 1 or the
* behavior of the PLL will be undefined.
* @param[in] pll_opt uint8_t: PLL Options.
*
* @returns zero upon success.
*/
int scif_enable_pll(uint8_t delay, uint8_t mul, uint8_t div, uint8_t pll_opt, enum pll_clk_src source_clock)
{
// First, PLL needs to be disabled, otherwise the configuration register
// is unaccessible.
uint32_t pll_val = SCIF_PLL0;
if (pll_val & SCIF_PLL0_PLLEN) {
SCIF_UNLOCK = SCIF_PLL0_KEY;
SCIF_PLL0 = pll_val & (~SCIF_PLL0_PLLEN);
}
if (mul == 0)
mul = 1;
pll_val = SCIF_PLL0_PLLOSC_MASKED(source_clock)
| SCIF_PLL0_PLLOPT_MASKED(pll_opt)
| SCIF_PLL0_PLLDIV_MASKED(div)
| SCIF_PLL0_PLLMUL_MASKED(mul)
| SCIF_PLL0_PLLCOUNT_MASKED(delay);
SCIF_UNLOCK = SCIF_PLL0_KEY;
SCIF_PLL0 = pll_val;
// Now enable TODO: does this really need to be separate operation?
SCIF_UNLOCK = SCIF_PLL0_KEY;
SCIF_PLL0 = pll_val | SCIF_PLL0_PLLEN;
while(!(SCIF_PCLKSR & SCIF_PLL0LOCK));
return 0;
}
/** @brief Configure and enable Generic Clock
*
* @param[in] gclk enum generic_clock: Generic Clock to configure and enable.
* @param[in] source_clock enum gclk_src: Source Clock for this Generic Clock.
* @param[in] div uint16_t: Division Factor. Upper 8 bits only used for Generic Clock 11,
* If 0, clock is undivided.
*/
void scif_enable_gclk(enum generic_clock gclk, enum gclk_src source_clock, uint16_t div)
{
uint32_t reg_val = SCIF_GCCTRL_CEN | SCIF_GCCTRL_OSCSEL_MASKED(source_clock);
if (div) {
if (gclk < GENERIC_CLOCK11) {
div &= 0xf;
}
reg_val |= SCIF_GCCTRL_DIV_MASKED(div) | SCIF_GCCTRL_DIVEN;
}
SCIF_GCTRL(gclk) = reg_val;
}

View File

@@ -0,0 +1,26 @@
/*
* This file is part of the libopencm3 project.
*
* Copyright (C) 2013 Gareth McMullin <gareth@blacksphere.co.nz>
*
* This library is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#include <libopencm3/sam/usart.h>
void usart_set_baudrate(uint32_t usart, uint32_t baud)
{
USART_BRGR(usart) = baud;
}