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_EFM32HG_STK3400/TARGET_Silicon_Labs/TARGET_EFM32/dma_api_HAL.h@122:f9eeca106725, 2016-07-07 (annotated)

Committer:
Kojto
Date:
Thu Jul 07 14:34:11 2016 +0100
Revision:
122:f9eeca106725
Parent:
113:f141b2784e32 
Release 122 of the mbed library



Changes:

- new targets - Nucleo L432KC, Beetle, Nucleo F446ZE, Nucleo L011K4

- Thread safety addition - mbed API should contain a statement about thread safety

- critical section API addition

- CAS API (core_util_atomic_incr/decr)

- DEVICE_ are generated from targets.json file, device.h deprecated

- Callback replaces FunctionPointer to provide std like interface

- mbed HAL API docs improvements

- toolchain - prexif attributes with MBED_

            - add new attributes - packed, weak, forcedinline, align

- target.json - contains targets definitions

- ST - L1XX - Cube update to 1.5

     - SPI clock selection fix (clock from APB domain)

     - F7 - Cube update v1.4.0

     - L0 -  baudrate init fix

     - L1 - Cube update v1.5

     - F3 - baudrate init fix, 3 targets CAN support

     - F4 - Cube update v1.12.0, 3 targets CAN support

     - L4XX - Cube update v1.5.1

     - F0 - update Cube to v1.5.0

     - L4 - 2 targets (L476RG/VG) CAN support

- NXP - pwm clock fix for KSDK2 MCU

      - LPC2368 - remove ARM toolchain support - due to regression

      - KSDK2 - fix SPI , I2C address and repeat start

- Silabs - some fixes backported from mbed 3

- Renesas - RZ_A1H - SystemCoreClockUpdate addition

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Kojto 108:34e6b704fe68 1 /***************************************************************************//**
Kojto 108:34e6b704fe68 2 * @file dma_api_HAL.h
Kojto 108:34e6b704fe68 3 *******************************************************************************
Kojto 108:34e6b704fe68 4 * @section License
Kojto 108:34e6b704fe68 5 * <b>(C) Copyright 2015 Silicon Labs, http://www.silabs.com</b>
Kojto 108:34e6b704fe68 6 *******************************************************************************
Kojto 98:8ab26030e058 7 *
Kojto 122:f9eeca106725 8 * SPDX-License-Identifier: Apache-2.0
Kojto 98:8ab26030e058 9 *
Kojto 122:f9eeca106725 10 * Licensed under the Apache License, Version 2.0 (the "License"); you may
Kojto 122:f9eeca106725 11 * not use this file except in compliance with the License.
Kojto 122:f9eeca106725 12 * You may obtain a copy of the License at
Kojto 98:8ab26030e058 13 *
Kojto 122:f9eeca106725 14 * http://www.apache.org/licenses/LICENSE-2.0
Kojto 108:34e6b704fe68 15 *
Kojto 122:f9eeca106725 16 * Unless required by applicable law or agreed to in writing, software
Kojto 122:f9eeca106725 17 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
Kojto 122:f9eeca106725 18 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
Kojto 122:f9eeca106725 19 * See the License for the specific language governing permissions and
Kojto 122:f9eeca106725 20 * limitations under the License.
Kojto 108:34e6b704fe68 21 *
Kojto 108:34e6b704fe68 22 ******************************************************************************/
Kojto 108:34e6b704fe68 23
Kojto 98:8ab26030e058 24 #ifndef MBED_DMA_API_HAL_H
Kojto 98:8ab26030e058 25 #define MBED_DMA_API_HAL_H
Kojto 98:8ab26030e058 26
Kojto 98:8ab26030e058 27 #include <stdint.h>
Kojto 98:8ab26030e058 28 #include "dma_api.h"
Kojto 113:f141b2784e32 29 #include "em_device.h"
Kojto 113:f141b2784e32 30
Kojto 113:f141b2784e32 31 #ifdef DMA_PRESENT
Kojto 98:8ab26030e058 32 #include "em_dma.h"
Kojto 113:f141b2784e32 33 #endif
Kojto 113:f141b2784e32 34
Kojto 113:f141b2784e32 35 #ifdef LDMA_PRESENT
Kojto 113:f141b2784e32 36 #include "em_ldma.h"
Kojto 113:f141b2784e32 37 #endif
Kojto 98:8ab26030e058 38
Kojto 98:8ab26030e058 39 #ifdef __cplusplus
Kojto 98:8ab26030e058 40 extern "C" {
Kojto 98:8ab26030e058 41 #endif
Kojto 98:8ab26030e058 42
Kojto 98:8ab26030e058 43 /* Purpose of this file: extend dma_api.h to include EFM-specific DMA attributes */
Kojto 98:8ab26030e058 44
Kojto 98:8ab26030e058 45 #define DMA_CAP_2DCOPY (1 << 0)
Kojto 98:8ab26030e058 46 #define DMA_CAP_NONE (0 << 0)
Kojto 98:8ab26030e058 47
Kojto 98:8ab26030e058 48 #if ( DMA_CHAN_COUNT <= 4 )
Kojto 98:8ab26030e058 49 #define DMACTRL_CH_CNT 4
Kojto 98:8ab26030e058 50 #define DMACTRL_ALIGNMENT 256
Kojto 98:8ab26030e058 51
Kojto 98:8ab26030e058 52 #elif ( ( DMA_CHAN_COUNT > 4 ) && ( DMA_CHAN_COUNT <= 8 ) )
Kojto 98:8ab26030e058 53 #define DMACTRL_CH_CNT 8
Kojto 98:8ab26030e058 54 #define DMACTRL_ALIGNMENT 256
Kojto 98:8ab26030e058 55
Kojto 98:8ab26030e058 56 #elif ( ( DMA_CHAN_COUNT > 8 ) && ( DMA_CHAN_COUNT <= 16 ) )
Kojto 98:8ab26030e058 57 #define DMACTRL_CH_CNT 16
Kojto 98:8ab26030e058 58 #define DMACTRL_ALIGNMENT 512
Kojto 98:8ab26030e058 59
Kojto 98:8ab26030e058 60 #else
Kojto 98:8ab26030e058 61 #error "Unsupported DMA channel count (dma_api.c)."
Kojto 98:8ab26030e058 62 #endif
Kojto 98:8ab26030e058 63
Kojto 113:f141b2784e32 64 #ifdef LDMA_PRESENT
Kojto 113:f141b2784e32 65 typedef void (*LDMAx_CBFunc_t)(unsigned int channel, bool primary, void *user);
Kojto 113:f141b2784e32 66
Kojto 113:f141b2784e32 67 typedef struct
Kojto 113:f141b2784e32 68 {
Kojto 113:f141b2784e32 69 LDMAx_CBFunc_t cbFunc;
Kojto 113:f141b2784e32 70 void *userPtr;
Kojto 113:f141b2784e32 71 } LDMAx_Callback_t;
Kojto 113:f141b2784e32 72
Kojto 113:f141b2784e32 73 void LDMAx_StartTransfer( int ch,
Kojto 113:f141b2784e32 74 LDMA_TransferCfg_t *transfer,
Kojto 113:f141b2784e32 75 LDMA_Descriptor_t *descriptor,
Kojto 113:f141b2784e32 76 LDMAx_CBFunc_t cbFunc,
Kojto 113:f141b2784e32 77 void *userData );
Kojto 113:f141b2784e32 78 bool LDMAx_ChannelEnabled( int ch );
Kojto 113:f141b2784e32 79 #endif
Kojto 113:f141b2784e32 80
Kojto 98:8ab26030e058 81 typedef struct {
Kojto 100:cbbeb26dbd92 82 DMAUsage dmaUsageState;
Kojto 100:cbbeb26dbd92 83 int dmaChannel;
Kojto 113:f141b2784e32 84 #ifndef LDMA_PRESENT
Kojto 100:cbbeb26dbd92 85 DMA_CB_TypeDef dmaCallback;
Kojto 113:f141b2784e32 86 #else
Kojto 113:f141b2784e32 87 LDMAx_Callback_t dmaCallback;
Kojto 113:f141b2784e32 88 #endif
Kojto 98:8ab26030e058 89 } DMA_OPTIONS_t;
Kojto 98:8ab26030e058 90
Kojto 98:8ab26030e058 91 typedef void (*DMACallback)(void);
Kojto 98:8ab26030e058 92
Kojto 98:8ab26030e058 93 extern DMA_DESCRIPTOR_TypeDef dmaControlBlock[];
Kojto 98:8ab26030e058 94
Kojto 98:8ab26030e058 95 #ifdef __cplusplus
Kojto 98:8ab26030e058 96 }
Kojto 98:8ab26030e058 97 #endif
Kojto 98:8ab26030e058 98
Kojto 98:8ab26030e058 99 #endif