TI Luminary Micro ARM Cortex-M3驱动库详细指南

4星 · 超过85%的资源需积分: 13 111 浏览量更新于2024-07-28 收藏 1.92MB PDF 举报

ARM Cortex-M3 驱动库函数说明书是Luminary Micro公司为Cortex-M3架构的嵌入式开发提供的Stellaris Peripheral Driver Library（简称PDL）用户指南。这份文档主要针对的是2006-2007年期间的版本，它旨在帮助开发者更有效地利用Cortex-M3处理器及其周边设备，加速硬件开发进程。该手册的核心内容包括： 1. **版权和法律声明**：文档受版权保护，所有权利保留，除非在Luminary Micro的产品销售条款和条件中有明确授予，否则不会无条件地授予任何知识产权。这表明在使用该库时必须遵守相应的授权协议。 2. **产品适用范围**：该驱动库适用于非医疗、生命维持或涉及生命安全的应用场景。这意味着在选择和使用这些驱动时，用户需要确保它们满足所设计系统的需求和安全性限制。 3. **功能概述**：Stellaris Peripheral Driver Library涵盖了各种外设驱动，如定时器、串行通信接口、GPIO、ADC等，提供对Cortex-M3硬件资源的高效管理。这些驱动库的设计目标是简化硬件操作，减少代码量，提高开发效率。 4. **技术细节**：文档详细描述了各个驱动函数的使用方法，包括如何初始化、配置、读写数据以及处理中断等。对于每个函数，通常会提供参数列表、返回值和可能遇到的错误情况，有助于开发者理解和应用。 5. **更新和兼容性**：由于技术的不断发展，Luminary Micro可能会不通知用户就对文档中的规格和产品描述进行修改。因此，开发者在实际项目中使用前，应与当地的Luminary Micro销售办公室或分销商确认最新的规格。 6. **责任声明**：Luminary Micro对产品的销售和使用不承担任何明示或暗示的担保，包括适配特定用途、产品性能优良或不会侵犯任何专利、版权或知识产权。这意味着用户在使用过程中需要自行承担风险。 ARM Cortex-M3 驱动库函数说明书是开发人员在使用Luminary Micro提供的Cortex-M3开发板时不可或缺的参考资料，它提供了全面的驱动支持，帮助开发者快速构建稳定、高效的嵌入式系统应用。在开发过程中，务必遵循文档中的指导，并注意保持与厂商的最新沟通，以确保项目的顺利进行。

Programming Model

All other macros represent the value of a bit ﬁeld.

All register name macros start with the module name and instance number (for example, SSI0

for the ﬁrst SSI module) and are followed by the name of the register as it appears in the data

sheet (for example, the CR0 register in the data sheet results in SSI0_CR0_R).

All register bit ﬁelds start with the module name, followed by the register name, and then

followed by the bit ﬁeld name as it appears in the data sheet. For example, the SCR bit ﬁeld in

the CR0 register in the SSI module will be identiﬁed by SSI_CR0_SCR.... In the case where

the bit ﬁeld is a single bit, there will be nothing further (for example, SSI_CR0_SPH is a single

bit in the CR0 register). If the bit ﬁeld is more than a single bit, there will be a mask value (_M)

and either a shift (_S) if the bit ﬁeld contains a number or a set of enumerations if not.

Given these deﬁnitions, the CR0 register can be programmed as follows:

SSI0_CR0_R = ((5 << SSI_CR0_SCR_S) | SSI_CR0_SPH | SSI_CR0_SPO |

SSI_CR0_FRF_MOTO | SSI_CR0_DSS_8);

Alternatively, the following has the same effect (although it is not as easy to understand):

SSI0_CR0_R = 0x000005c7;

Extracting the value of the SCR ﬁeld from the CR0 register is as follows:

ulValue = (SSI0_CR0_R & SSI_CR0_SCR_M) >> SSI0_CR0_SCR_S;

The GPIO modules have many registers that do not have bit ﬁeld deﬁnitions. For these registers,

the register bits represent the individual GPIO pins; so bit zero in these registers corresponds to

the Px0 pin on the part (where x is replaced by a GPIO module letter), bit one corresponds to the

Px1 pin, and so on.

The blinky example for each board utilizes the direct register access model to blink the on-board

LED.

Note:

The hw_∗.h header ﬁles that are used by the drivers in the library contain many of the same

deﬁnitions as the header ﬁles used for direct register access. As such, the two can not be in-

cluded into the same source ﬁle without the compiler producing warnings about the redeﬁnition

of symbols.

4.3 Software Driver Model

In the software driver model, the API provided by the peripheral driver library is used by applica-

tions to control the peripherals. Since these drivers provide complete control of the peripherals in

their normal mode of operation, it is possible to write an entire application without direct access

to the hardware. This provides for rapid development of the application without requiring detailed

knowledge of how to program the peripherals.

Corresponding to the direct register access model example, the following will also program the CR0

16 November 19, 2007

Stellaris Peripheral Driver Library User’s Guide

5 Analog Comparator

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

API Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Programming Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

5.1 Introduction

The comparator API provides a set of functions for dealing with the analog comparators. A com-

parator can compare a test voltage against individual external reference voltage, a shared single

external reference voltage, or a shared internal reference voltage. It can provide its output to a

device pin, acting as a replacement for an analog comparator on the board, or it can be used to

signal the application via interrupts or triggers to the ADC to cause it to start capturing a sample

sequence. The interrupt generation and ADC triggering logic is separate, so that an interrupt can

be generated on a rising edge and the ADC triggered on a falling edge (for example).

This driver is contained in src/comp.c, with src/comp.h containing the API deﬁnitions for use

by applications.

5.2 API Functions

Functions

void ComparatorConﬁgure (unsigned long ulBase, unsigned long ulComp, unsigned long ul-

Conﬁg)

void ComparatorIntClear (unsigned long ulBase, unsigned long ulComp)

void ComparatorIntDisable (unsigned long ulBase, unsigned long ulComp)

void ComparatorIntEnable (unsigned long ulBase, unsigned long ulComp)

void ComparatorIntRegister (unsigned long ulBase, unsigned long ulComp, void

(∗pfnHandler)(void))

tBoolean ComparatorIntStatus (unsigned long ulBase, unsigned long ulComp, tBoolean

bMasked)

void ComparatorIntUnregister (unsigned long ulBase, unsigned long ulComp)

void ComparatorRefSet (unsigned long ulBase, unsigned long ulRef)

tBoolean ComparatorValueGet (unsigned long ulBase, unsigned long ulComp)

5.2.1 Detailed Description

The comparator API is fairly simple, like the comparators themselves. There are functions for

conﬁguring a comparator and reading its output (

ComparatorConﬁgure(), ComparatorRefSet() and

ComparatorValueGet()) and functions for dealing with an interrupt handler for the comparator (Com-

paratorIntRegister(), ComparatorIntUnregister(), ComparatorIntEnable(), ComparatorIntDisable(),

ComparatorIntStatus(), and ComparatorIntClear()).

November 19, 2007 19

Analog Comparator

5.2.2 Function Documentation

5.2.2.1 ComparatorConﬁgure

Conﬁgures a comparator.

Prototype:

void

ComparatorConfigure(unsigned long ulBase,

unsigned long ulComp,

unsigned long ulConfig)

Parameters:

ulBase is the base address of the comparator module.

ulComp is the index of the comparator to conﬁgure.

ulConﬁg is the conﬁguration of the comparator.

Description:

This function will conﬁgure a comparator. The ulConﬁg parameter is the result of a logical

OR operation between the COMP_TRIG_xxx, COMP_INT_xxx, COMP_ASRCP_xxx, and

COMP_OUTPUT_xxx values.

The COMP_TRIG_xxx term can take on the following values:

COMP_TRIG_NONE to have no trigger to the ADC.

COMP_TRIG_HIGH to trigger the ADC when the comparator output is high.

COMP_TRIG_LOW to trigger the ADC when the comparator output is low.

COMP_TRIG_FALL to trigger the ADC when the comparator output goes low.

COMP_TRIG_RISE to trigger the ADC when the comparator output goes high.

COMP_TRIG_BOTH to trigger the ADC when the comparator output goes low or high.

The COMP_INT_xxx term can take on the following values:

COMP_INT_HIGH to generate an interrupt when the comparator output is high.

COMP_INT_LOW to generate an interrupt when the comparator output is low.

COMP_INT_FALL to generate an interrupt when the comparator output goes low.

COMP_INT_RISE to generate an interrupt when the comparator output goes high.

COMP_INT_BOTH to generate an interrupt when the comparator output goes low or high.

The COMP_ASRCP_xxx term can take on the following values:

COMP_ASRCP_PIN to use the dedicated Comp+ pin as the reference voltage.

COMP_ASRCP_PIN0 to use the Comp0+ pin as the reference voltage (this the same as

COMP_ASRCP_PIN for the comparator 0).

COMP_ASRCP_REF to use the internally generated voltage as the reference voltage.

The COMP_OUTPUT_xxx term can take on the following values:

COMP_OUTPUT_NORMAL to enable a non-inverted output from the comparator to a

device pin.

COMP_OUTPUT_INVERT to enable an inverted output from the comparator to a device

pin.

20 November 19, 2007

剩余491页未读，继续阅读

l5013064

粉丝: 0
资源: 1

TI Luminary Micro ARM Cortex-M3驱动库详细指南

仿warkey源代码(vc版)

STM32（Cortex-M3）库函数（中文版和英文版）

cotex-m3驱动显示屏

ARM COTEX-A9

Cotex-M3指南

cotex-M3中文资料

webradio cotex-m3

TI Cotex-M3中文手册

ARM汇编实现流水灯，STM32F103,COTEX-M3系列指令

Cotex-M3中文手册(上半部分)

最新资源