A

accurate clock 精确的时钟

results in an accurate clock 产生了（导致、致使）一个精确的时钟

adaptive layout 自适应布局

adequate adj. 充足的；适当的；胜任的

For correct operation, the input signal to the ADC must be allowed adequate time to charge the sample and hold capacitor.

advance vt. 使……前进

advancing the connected timer by one second 将连接的时钟向前推进1秒

advance at different rates 以不同的速率前进

aligned /əˈlaɪnd/ v. 结盟；支持；使成一直线；校准；安放，排列；使一致（align 的过去式和过去分词）

be aligned on B 对齐至B

byte-aligned memory address 字节内存地址

alternate /ɔːlˈtɜːnət/ adj. 交替的，轮流的；间隔的，每隔（……天等）的；（一或多个事物）另外的，可供选择的；（两者）互不相容的；另类的，非传统的；v. （使）交替，（使）轮流 n. 替换物，代理人

alternate mux selection 交替复用选择

transient pulse 瞬时脉冲

alternate mux selections 交替复用选择

The GPyGMUXn register should be configured before the GPyMUXn to avoid transient pulses on GPIOs from alternate mux selections. GPyGMUXn 寄存器应在 GPyMUXn 之前配置，以避免交替复用选择对GPIO产生瞬时脉冲。

alteration n. 改变；变更；服装修改

The Embedded C++ library works in conjunction with 15 of the headers from the Standard C library, sometimes with small alterations.

amplify vt. 放大，扩大；增强；详述 vi. 详述

amplifier n. 增益器；放大器；

power amplifier （也简写: power amp）功率放大器

pre-amplifier 前置放大器（也写作：preamplifier 或 preamp）

operational amplifier 运算放大器

analog to analog latency 模比延迟

38 μs analog-to-analog latency

appends sth. as appropriate 适当地附加某物

When sending out the address on the bus, the TWI controller appends the read/write bit as appropriate, based on the state of the TWIMDIR bit in the master mode control register.

approximate /əˈprɒksɪmət/ adj. 近似的，大概的 v. 接近，近似；粗略估计

approximately /əˈprɒksɪmətli/ adv. 大约，近似地；近于

approximation n. 近似值

A typical motherboard, including an Am486DX2-80CPU, consumes around 13 W, meaning that the CPU accounts for approximately 16 percent of the total motherboard power consumption. 一个典型的主板，包括Am486DX2-80CPU，消耗约13W，这意味着CPU约占主板总功耗的16%。

arbitration /ˌɑːbɪˈtreɪʃn/ n. 公断，仲裁

arbitrarily /ˌɑːbɪˈtrerəli/ adv. 武断地；任意地；专横地；

SOC5 is chosen arbitrarily. （此处就）任意选择SOC5。

arithmetic /əˈrɪθmətɪk/ n. 算术，算法；数字

arithmetic operations 算术运算

assemble vt. 集合，聚集；装配；收集 vi. 集合，聚集

assembly n. 装配；集会，集合 n. 汇编，编译

assembly source 汇编源代码

assembly code 汇编码

assert vt. 维护，坚持；断言；主张；声称

assertion /əˈsɜːʃn/ n. 断言，声明；主张，要求；坚持；认定

assertion check 断言检查

internal asserts 内部断言

A be assigned to B A被分配给了B

Parameters are assigned to instructions in the order in which the instructions are instantiated in the code. 参数按照在代码中实例化指令的顺序被分配给了指令。

attribute n. 属性；特质 vt. 归属；把……归于

property n. 性质，性能；财产；所有权

pin attributes 引脚分配

the attached clock 附带的时钟

attenuate v. （使）减弱；（使）纤细，稀薄 adj. 减弱的；稀薄的；细小的

attenuated adj. （力量或效果）衰减的；（人）瘦长的 v. 使减弱；使变细；稀释

attenuation n. [物] 衰减；变薄；稀释

digital attenuation step 数字衰减步长

digital attenuation range 数字衰减范围

The volume setting of each ADC can be digitally attenuated in the ADCx_VOLUME registers.

auto increment 自增

auto-increment circuit 自增电路

The ADAU1772 always decodes the subaddress and sets the auto-increment circuit so that the address increments after the appropriate number of bytes.

auxiliary /ɔːɡˈzɪliəri/ adj. 辅助的；副的；附加的；（发动机、设备等）备用的

auxiliary definitions 辅助定义

B

base address 基地址

batch session 批处理会话

To launch a batch session using two command files "input1" and "input2".

sth. become scattered throughout somewhere 某物被分散到某处

As memory blocks are "freed" back to the HeapMem, the available memory in the HeapMem becomes scattered throughout the heap.

benchmark n. 参考标准，基准 (a standard by which something can be measured or judged)

bias n. 偏移；偏差；偏见；vt. 使存偏见 adj. 偏斜的 adv. 偏斜地

bias generators 偏置发生器

bitfield reference 位域参考

bond n. 债券；结合；约定；粘合剂；纽带 vi. 结合，团结在一起 vt. 使结合；以…作保

unbond adj. 未绑定的

floating unbonded inputs 未绑定的浮点输入

To avoid any floating unbonded inputs, the Boot ROM will enable internal pullups on GPIO pins that are not bonded out in a particular package. 为了避免任何未绑定的浮点输入，Boot ROM将在特定封装中未绑定的GPIO引脚上启用内部上拉。

boost vt. 促进；增加；支援 vi. 宣扬；偷窃 n. 推动；帮助；宣扬

PGA boost 可编程增益放大器（功率）提升

booster n. 升压机；支持者；扩爆器

booster-pack / boosterpack 增强包

bootloader 引导器

be broken down into

The process of converting an analog voltage to a digital value is broken down into an S+H phase and a conversion phase.

bypass n. 旁路，支流 v. 绕过，避开；忽视，不顾（规章制度）；设旁路，迂回

bypass capacitor 旁路电容

be bypassed with a capacitor 用一个电容进行绕装

Each supply signal on the board should also be bypassed with a single bulk capacitor (10 μF to 47 μF).

C

calibration n. 校准；刻度；标度

self-calibration 自校准

offset self-calibration 偏移自校准

Internal connection to VREFLO on all ADCs for offset self-calibration. ADC上所有到VREFLO的内部连接，都用于偏移自校准。（这语法也很迷）

A calls into B A调用B

Internally, the Memory module calls into the heap’s interface functions.

A make calls to B A调用B

it makes calls to the Heap module through the IHeap_Handle.

capacibility

capacitance n. 电容（值）

capacitor n. 电容器

easy parallel switching capacibility 易于并联开断/切换的电容

care should be taken when 当/在……时需要小心

Care should be taken when choosing a Task stack size.

在选择任务堆栈大小时要小心。

characteristic n. 特性

thermal resistance characteristics 热阻特性

static characteristic 静态特性

dynamic characteristic 动态特性

electrical characteristic 电气特性

switching characteristic 开关特性

diode characteristic 二极管特性

circuitry /ˈsɜːkɪtri/ n. 电路；电路系统；电路学；一环路

The easiest way to achieve this is to use a regulator that has a power good (PGOOD) signal to power the ADAU1772 or generate a power good signal using additional circuitry external to the regulator itself.

clamp v. 固定，稳定

The inputs are internally clamped to VDD and GND by diodes.

coefficient write 系数写入

collision /kəˈlɪʒn/ n. 碰撞；冲突；（意见，看法）的抵触；（政党等的）倾轧

collision detection 冲突检测

several-input-lines command 多行输入命令

Commands may extend over several input lines by ending each line but the last with a backslash ().

命令可以扩展到多个输入行，每一行以反斜杠()结束，最后一行以反斜杠()结束。

comment out sth. 注释掉

Therefore, commenting out a continued line comments out the entire command.

因此，注释掉一个连续的行就会注释掉整个命令.

That is, no white space is implied, nor is a comment terminated.

也就是说，没有空格，注释也不会终止。

commit /kəˈmɪt/ vt. 犯罪；把...交托给；指派…作战；使…承担义务；（公开地）表示意见 vi. 忠于（某个人、机构等）；承诺

amend last commit 修改上一次提交（的数据）

initial commit message 初始提交消息

configuration entry 配置条目

conjunction n. 结合；[语] 连接词；同时发生

connect A in series with B 让A与B以串联形式连接

The headphone outputs can also be configured as ground centered outputs by connecting coupling capacitors in series with the output pins.

consistency n. 一致性

data consistency 数据一致性

data consistency in every node of the system 系统内部各节点的数据一致性

constrain vt. 驱使；强迫；束缚

be significantly constrained 非常有限 / 显著不足的

This is particularly useful on targets where the code memory is significantly constrained.

constructor n. 构造函数；构造器；建造者

destructor n. 析构函数

context of a software interrupt 软件中断的上下文

Memory allocation APIs such as Memory_alloc() and Memory_calloc() cannot be called from within the context of a software interrupt.内存分配接口如A和B不能够在软件中断的上下文中被调用。

convention n. 公约

software convention 软件公约、软件惯例

Allocation of source bits to source processor and meaning is entirely based on software convention.源位分配到源处理器和意义完全基于软件惯例。

corner frequency 角频率

correspond /,kɒrə'spɒnd/ vi. 符合，一致；相应；通信

the corresponding modules 对应模块

The ADAU1772 knows to increment its subaddress register every two bytes because the requested subaddress corresponds to a register or memory area with a 2-byte word length. [此处应该是语法有问题，个人感觉应该是increase而不是increment]

For example, Ipc_S_SUCCESS, MessageQ_E_FAIL, and SharedRegion_E_MEMORY are status codes that may be returned by functions in the corresponding modules.

curly braces 花括号

denote optional arguments 表示可选参数

mutually exclusive choices 互相排斥的选择

In this document, curly braces ({}) denote optional arguments and a vertical bar (|) separates mutually exclusive choices.

在本文档中，花括号({})表示可选参数，竖线(|)分隔互斥的选项。

current n. 电流

concurrent adj. 并发的；一致的；同时发生的；并存的 n. [数] 共点；同时发生的事件

concurrently adv. 同时地

nominal current 名义电流、额定电流

rated current 额定电流

D

declaration /,deklə'reiʃən/ n. （纳税品等的）申报；宣布；公告；申诉书；声明；

function declaration 函数声明

derived /dɪˈraɪvd/ class 派生类

In derived classes, super() must be called before you can use this. 在派生类中，使用this 前必先调用 super() 函数。

diagnostics n. 诊断学（用作单数）

discrete /dɪˈskriːt/ adj. 离散的，不连续的 n. 分立元件；独立部件

discrete device 分离部件

dissipation n. 损耗，耗散

power dissipation 功率损耗

dynamic memory allocation and deallocation 动态内存分配和回收

SYS/BIOS provides reentrant versions of malloc() and free() that internally use the xdc.runtime. SYS/BIOS为内部使用XDC.RUNTIME的 malloc() 和 free() 提供了可重入版本。

E

electric

electrical

electron

electronic

electret /ɪˈlektrət/ n. 驻极体；电介体

electret microphone 驻极体麦克风

seamless interfacing 无缝连接（的接口）

Two microphone bias pins provide seamless interfacing to electret microphones. 两个麦克风偏置针为驻极体麦克风提供了无缝连接。

electrical layer requirements 电气层要求

elicit /i'lisit/ vt. 引出

endian n. 字节存储次序，元组排列顺序

big-endian 高位对齐，大端

small-endian 低位对齐，小端

device endianness 设备字节顺序

equivalent adj. （在价值、数量等方面）相等的；等价的；等效的；等量的；同意义的 n. 对等的人（或事物）；当量

equidistant /ˌiːkwɪˈdɪstənt/ adj. 等距的；距离相等的

For maximum effectiveness, locate the capacitor equidistant from the power and ground pins or slightly closer to the power pin if equidistant placement is not possible. 为了获取最大效率，应在电源及接地的等距接口处置放电容，若等距放置无法采用，则应在放置在电源一侧。

encoded internal representations 编码的内部表示

an entire contiguous Ethernet packet 一个完整连续的以太网包

error n. 错误，误差

fatal error 致命错误

offset error 便宜误差

gain error 增益误差

explicitly /ɪkˈsplɪsɪtli/ adv. 明确地；明白地

implicitly /ɪmˈplɪsɪtli/ adv. 含蓄地；暗中地

explicity and implicity 显性和隐性

exploring the ecosystem 探索生态系统

extent n. 程度；范围；长度

extend vt. 延伸；扩大；推广；伸出；给予；使竭尽全力；对…估价 vi. 延伸；扩大；伸展；使疏开

extensive adj. 广泛的；大量的；广阔的

extension n. 拓展；延伸；接发；（医学）牵引；（计算机）拓展名；（逻辑）外延

extended adj. 延伸的；扩大的；长期的；广大的 v. 延长；扩充（extend 的过去分词）

The extent to which this is true depends on the floating-point processor’s architecture. 这一点在多大程度上取决于浮点处理器的架构。

event combiner 事件组合器

expand vt. 扩张；使膨胀；详述 vi. 发展；张开，展开

expansion n. 膨胀；阐述；扩张物

It also expands the vector table to allow each interrupt to have its own ISR.

F

facility n. 设备，设施

facilitate v. 促进，帮助，使容易

These registers also provide a Source ID facility by which up to 28 different sources of interrupts can be identified. 这些寄存器还提供了一个 源 ID设备 ，通过它可以识别多达28个不同的中断源。

The IPCGRH register facilitates interrupts to external hosts. IPCGRH寄存器促进中断到外部主机。

farad /ˈfæræd/ n. 法拉

microfarad 微法

millifarad 毫法

nanofarad /ˈneɪnəˈfærəd/ 纳法

fed vt. 喂养

A be fed directly to somewhere / B A被直接带到某处 、A被直接喂给B（吃掉）

The ADAU1772 can generate its clocks either from an externally provided clock or from a crystal oscillator. In both cases, the on board PLL can be used or the clock can be fed directly to the core.

filter n. 滤波器

all-pole filters / gain 全通角过滤器/增益

second order filter 二阶滤波器

sinc filter

fixed adj. 固定的

variable-sized buffers 可变大小缓冲

fixed-size buffers 固定大小缓冲

formal parameter 形式参数

C++ allows you to specify default values for formal parameters within the function declaration. C++允许你在函数声明中指定形参的默认值。

forward adj. 正向的

diode forward current 二极管正向电流

on-board fractional PLL 板载小数分频PLL

frame sync edge detection 帧同步边缘检测

These registers (where x signifies SPORT 0 through 7) allow programs to set frame sync edge detection for I2S compatibility. 这些寄存器（其中x表示SPORT 0到7）允许程序设置帧同步边缘检测以实现I2S的兼容性。****

full-scale 全尺寸的、全尺度的、满量程的

full-scale input voltage 满量程输入电压

function call sequence 函数调用顺序

Standard IPC Function Call Sequence

A as a function of B. 把B带入函数求得A；把B当作自变量，A当作因变量。用于描述 A与B的关系。

collector current as a function of case temperature 集电极电流与外壳温度的关系

G

ganged adj. 成组的，联动的；v. 用金属细丝加固

ganged references

gate off 关闭

turn on 打开

give more control over sth. 在某事上予以更多控制权

graphical programming software 图形化编程软件

The program and parameter RAMs can be loaded with custom audio processing signal flow built using the SigmaStudio™ graphical programming software from Analog Devices, Inc. 在使用Analog Devices公司的SigmaStudio图形化编程软件建立自定义音频处理信号流时，程序和参数内存会被自动加载。

granularity n. 间隔尺寸，[岩] 粒度

the quality of being composed of relatively large particles

H

a handful of sth. 一些某物（可数）

An adaptive layout will give you more control over the design because you only have a handful of states to consider.

harmonic n. 谐波

total harmonic distortion + noise 总谐波失真和噪声

harness n. 马具；背带，吊带；甲胄；挽具状带子；降落伞背带；日常工作 v. 治理，利用；套；驾驭；披上甲胄；将（两只动物）拴在一起

wiring harness 线束

the complex wiring harness 复杂的线束

hierarchy board 层次结构板

hint n. 暗示；线索 vt. 暗示；示意 vi. 示意

This chapter provides hints for improving the runtime performance and shared memory usage of applications that use IPC.

I

identical adj. 一致的，一样的

Each ePWM instance is identical with one exception. 所有ePWM实例都是一致的，只有一个例外。

impedance /ɪmˈpiːdns/ n. 阻抗

input impedance 输入阻抗

output impedance 输出阻抗

load impedance 负载阻抗

impedance matching 阻抗匹配

impedance mismatch 阻抗失配

implement v. 实施，执行；实现，使生效 n. 工具，器具；手段 (apply in a manner consistent with its purpose or design)

implementation of the interface 接口的实现

instantiation of clock 时钟实例化

incorporate 包含

The ADAU1772 is a codec with four inputs and two outputs that incorporates a digital processing engine to perform filtering, level control, signal level monitoring, and mixing.

be independent of 独立于……；相对于……独立

indicate vt. 表明；指出；预示；象征

inherent adj. 固有的；内在的；与生俱来的，遗传的

In Round-Robin priority method, no SOC has an inherent higher priority than another. 在RR优先级模式下，所有SOC的优先级都平等。

install sth. across sth. 在某物上安装某物

To use MCLK on the J4 header, first install a resistor across the R2 pads. 要在J4引脚上使用MCLK，首先要在R2焊盘上安装一个电阻。

instantiation n. 实例化；[计] 例示

interact vt./vi. 互相影响；互相作用

interaction n. 相互作用，相互影响；交流；[数] 交互作用；互动

interactive adj. 交互式的；相互作用的

interactive plot windows 互动式绘制窗口

-p tells the program not to close any remaining interactive plot windows when the program exits.

internal digital supply voltage 内部数字电源电压

The operating voltage range is 1.8 V to 3.63 V, with an on-board regulator generating the internal digital supply voltage.

interrupt n. 中断

peripheral interrupt 外设中断

hardware interrupt 硬件中断

software interrupt 软件中断

external interrupt 外部中断

intuitive /ɪnˈtjuːɪtɪv/ adj. 直觉的；凭直觉获知的

counterintuitive adj. 违反直觉的

The naming convention for these endpoints is very consistent, but frequently counterintuitive.

invention n. 发明

inventory n. 存货，存货清单；详细目录；财产清册 vt. 给……开列清单

take inventory of 盘点一下

take inventory of the unique signals 对独特的信号进行盘点

invoke the class member function 调用类成员函数

By writing a wrapper function which accepts a class instance as a parameter, you can invoke the class member function from within the wrapper. 通过编写以类实例作为参数的包装函数，你可以在包装函数中调用其类成员函数。

insertion/withdrawal force 推拉力

isolate vt. （使）隔离，孤立；将……剔出；（某物质、细胞等）分离；区别看待（观点、问题等）n. 被隔离的人（或物）；[生]（用于研究的）分离菌，隔离群

isolated adj. 偏远的；孤立的；孤独的；单独的； 绝缘的

inter-channel isolation 通道间隔

optimal isolation 隔离优化

As previously stated, the stack has been designed for optimal isolation, and so that it may seamlessly plug in to varying run-time environments.

J

left/right justified 左/右对齐

L

legacy n. 遗产；遗赠财物；遗留问题；后遗症

latch vi. 占有，抓住；闭锁 vt. 闩上；纠缠住某人 n. 门闩，锁存器

latency n. 潜伏；潜在因素；延迟

leap year 闰年

locate sth. from somewhere 从某处定位某物

low latency 低延迟

The path from the analog input to the DSP core to the analog output is optimized for low latency and is ideal for noise cancelling headsets.

M

mandatory /‘mændətəri/ adj. 强制的；命令的；托管的； n. 受托者

Ping uses the ICMP protocol's mandatory ECHO_REQUEST datagram to elicit an ICMP ECHO_RESPONSE from a host or gateway.

PING使用ICMP协议的强制性的“回声请求”数据报来引出主机或网关的“回声响应”。

mangle /mæŋgl/ vt. 乱砍、损坏

name mangling （函数）命名重整

The process of encoding the signature into the link name is referred to as name mangling. 对链接名称解码签名的过程被称为命名重整。

Since function overloading is accomplished through name mangling, function overloading has limitations for functions that are called from the configuration. 由于函数重载是通过命名重整完成的，因此函数重载对从配置中调用的函数有限制。

maximum outstanding connection request 最大未完成连接请求

meet the requirement 满足需求

This feature assists designers in meeting the Energy Star requirements.

memory policy 存储策略

memory management traits 内存管理特征

Different heap implementations optimize for different memory management traits.

memory region 内存区域

This function enables caching for a specific memory region.

metric n. 度量标准 adj. 公制的；米制的；公尺的

metrics n. 度量；作诗法；韵律学

bad font metrics 糟糕的字体度量

-s tells the program to wait for slow font initialization on startup. Otherwise it prints an error and continues with bad font metrics.

modulate vi. 调制；转调 vt. 调节；调制；调整

modulation n. 调制；调整

modulator n. 调制器

PCM (Pulse Code Modulation) 脉冲编码调至

PDM (Pulse Density Modulation) 脉冲密度调制

PDM modulator 脉冲密度调制器

module n. [计] 模块；组件；模数

monolithic /ˌmɒnəˈlɪθɪk/ adj. 整体的；巨石的，庞大的；完全统一的 n. 单块集成电路，单片电路

monolithic diode 单片二极管

millennium /mɪˈleniəm/ n. 千年；千禧年

minimum addressable units 最小可寻址单元

Memory allocation sizes are measured in "Minimum Addressable Units" (MAUs) of memory. An MAU is the smallest unit of data storage that can be read or written by the CPU.

miscellaneous /ˌmɪsəˈleɪniəs/ adj. 混杂的，各种各样的；多方面的，多才多艺的

miscellaneous devices 杂项设备

A be a multiple of B A应该是B的数倍

To prevent unintended behavior "blockPtr" should be aligned on the cache line size and "byteCnt" should be a multiple of the cache line size.

multiplex adj. 多元的，多样的；多路传输的；v. 多路传输、多工

simplex 单工的

full-duplex 全双工

half-duplex 半双工

transmission simplex 单工传输

full-duplex communication 全双工通信

full-duplex channel 全双工信道

time division multiplex communication 时分多路通信

time multiplexer communication channel 时分多路通信信道

time-derived channel 时分通道、时分信道

multiplex up to 复用至xx

The ePIE multiplexes up to sixteen peripheral interrupts into each CPU interrupt line.

mutual /'mju: tfuel/ exclusion 互斥

Manages gates for mutual exclusion of shared resources by multiple processors and threads. 管理多个处理器和线程共享资源的互斥门。

N

noise cancelling headset 降噪耳机

O

octet /ɔk'tet/ 八重、八位（计算机语境下，基本与byte同意）

on a + adj. + basis 在何种基础上

You can reduce the amount of code space used by an application by setting the memory Policy on a global or per-module basis.

register optimizations 寄存器优化

local optimizations 本地优化

global optimizations 全局优化

interprocedure optimization 进程优化

other than .... 除了……

Blue boxes identify modules for which your application will call C API functions other than those used to dynamically create objects.

P

two parameter banks 参数集（参数组， two sets of parameters）

There are two parameter banks available. Each bank can hold a full set of 160 parameters (32 filters × 5 coefficients).

parasite /ˈpærəsaɪt/ n. 寄生虫

parasitic /ˌpærəˈsɪtɪk/ adj. 寄生的

parasitical adj. 寄生的

channel parasitic input capacitance 通道寄生输入电容

parse /'pɑːz/ v.理解，从语法上分析，解析

Parsing CGI Form Data 解析CGI结构的数据

a particular heap implementation 特定堆生成

Using Memory APIs makes applications and middleware portable and not tied to a particular heap implementation.

patched /pætʃt/ adj. 打补丁的 v. 打补丁；遮盖（视力好的眼）促进弱视眼看；（用补丁对程序）改错（patch 的过去式和过去分词）

be patched with sth. 用某物修补

period n. 周期

periodic /periɒdik/ adj. 周期的

perspective n. 观点；远景；透视图 adj. 透视的

customize perspective 定制化的角度（来看）

phase n. 相位

phase shifted 180 DEG 相位偏移180度

phase relationship 相位关系

sb./sth. places certain restrictions on sth. / sw. 某物对某物产生影响

Running the scheduler thread at a low priority places certain restrictions on how a Task can operate at the socket layer.

以低优先级运行调度程序线程会对任务在套接字层上的操作方式产生某些限制。

polar 北极

polarity /pəˈlærəti/ n. [物] 极性；两极；对立

signal polarity 信号极性

unipolar signal 单极信号（仅有零值和正值）

bipolar signal 双极信号（有正负值和零值）

populate v. 焊接

unpopulated header pads 未焊接点（盘）

unpopulated PCB 无载印制电路板

solder n. 焊料；接合物 v. 焊接；使联接在一起

To use an external speaker, wires can be soldered to the unpopulated header pads, J13 and J16.

The R2 resistor is not populated from the factory. 在工厂时，R2电阻未安装。

port n. 接口，端口

portable adj. 便携的

portfolio /pɔːtˈfəʊliəʊ/ n. 公文包；文件夹；证券投资组合；部长职务；作品集；（公司或机构提供的）系列产品，系列服务；（职业类型）短期合同制的，兼职的

broad portfolio 广泛的产品组合

potentiostat /pəu'tenʃiəstæt/ n. 恒电势器；[电] 稳压器

potentiostatic adj. 电压稳定器的；恒电势的；电势恒定器的

potentiometer /pəˌtenʃiˈɒmɪtə(r)/ n. 电位计；分压计

potentiometric /pəu,tenʃiə'metrik/ adj. 电势测定的，电位计的

control interface: switches and potentiometers 控制接口：开关和电位器

precision 精度

single-precision 单精度

double-precision 双精度

Single-precision biquad filter 单精度双四轴滤波器

The double length memory enables the core to double precision arithmetic with double length data and single length coefficients.

precision sensing applications 精密传感应用

They allow analog and digital sensing for interpreting capabilities with built-in ADCs, DACs, and temp sensors for precision sensing applications. 这些MCUs利用为紧密传感应用准备的内置模-数、数-模、温度传感器向模拟和数字传感提供解释能力。

【这逻辑，我确实接受不来】

preempt 抢占

All Clock functions run at the same SWI priority, so one Clock function cannot preempt another. 所有的时钟函数都运行在相同的SWI优先级，所以一个时钟函数不能抢占另一个时钟函数。

prefix n. 前缀 vt. 加前缀；将某事物加在前面

presume / assume 假定

So this book presumes that you have already learned something about Python programming from the many excellent tutorials and books on the subject.

On the other hand, this book does not start by assuming that you know any networking!

previous versions 以前的版本

Note that the appropriate include file location has changed from previous versions of IPC. 注意，适当的头文件位置已经从以前的IPC版本中更改。

prologue /prəʊlɒg/ n. 开场白

prolong /prəˈlɒŋ/ vt. 延长，拖延

they can then prolong the LOW period of the SCL signal to slow down the transfer. 可以延长SCL信号的低电平周期，以降低传输速度。

prior /ˈpraɪər/ adj. （时间、顺序等）先前的；优先的

priority n. 优先级

prioritize /praɪˈɒrətaɪz/ v. 按优先顺序列出，确定 (任务) 优先顺序；优先处理，优先考虑

prior to 在……之前； 居先

It is important to enrich the soil prior to planting. 栽种之前给土壤施肥很重要。

probe n. 探针；调查 vi. 调查；探测 vt. 探查；用探针探测

simulation probe 模拟探针

the proper adjustment 适当调整

The scheduler thread can run at any priority with the proper adjustment.

调度器线程经适当调整可以运行在任何优先级。

R

rate n. 速度；比率；价格；等级

rating n. 等级；等级评定；额定功率 v. 对…评价（rate的ing形式）

ratio n. 比率，比例

rational adj. 合理的；理性的 n. 有理数

speed n. 速度，速率；进度；迅速；繁荣；感光度；排挡；v. 快速运动；加速；促进；

The rate of the internal master clock must be set properly using the CC_MDIV bit in the clock control register (Address 0x0000). 内部主时钟的速率必须要在时钟控制寄存器下的CC_MDIV位上设置正确。

rated input voltage 额定输入电压

rated input current 额定输入电流

flammability rating 可燃性等级

absolute maximum ratings 最大功率

ESD ratings 静电放电等级

power supply rejection ratio 电源抑制比

SNR（Signal-to-Noise Ratio） 信噪比

rectification n. 整流

recursive nature 递归性质

Due to its recursive nature, a Task tends to consume a significant amount of stack.

由于其递归性质，任务往往会消耗大量的堆栈。

re-entrance exclusion methodology 重连拒绝方法

The NDK requires a re-entrance exclusion methodology to call into internal tack functions.

reentrant versions 可重入版本

regular adj. 有规律的

regulate vt. 调节；规定；控制；校准；有系统地管理

regulated voltage 稳定电压

regulator n. 监管机构，监管者；调整者；校准器；稳压器

Typically, on such regulators the power good signal changes state when the regulated voltage drops below ~90% of its target value.

通常只有在稳定电压低于规定目标的90%以下时，这些稳压器的良好信号才会改变状态。

on-board regulator 板载调节器

The on-board regulator generates the 3.3 V dc or 1.8 V dc supply, determined by S1, for the on-board circuitry. 板载整流器为板载电流提供了由S1决定的1.8V或3.3V电压。

LDO regulator （某种）线性稳压器？

the remote processor 远程处理器

The response from the remote processor triggers a hardware interrupt, which then posts a Semaphore to allow to Task to resume execution. 远程处理器的响应触发硬件中断，然后硬件中断发布一个信号量以允许任务继续执行。

power-on reset 开机复位

brownout reset 断电复位

resistor n. 电阻器

resistance n. 电阻值；电阻

constant resistance 恒定电阻

insulation resistance 绝缘电阻

damping resistor 阻尼电阻

equivalent series resistance 等效串联电阻

ruggedness /ˈrʌɡɪdnəs/ n. 强度，坚固性；险峻，崎岖；粗野

high ruggedness 高坚固性

runtime support library 运行时支持库

This module provides xdc.runtime.ITimestampClient APIs for the xdc Runtime Support Library.

S

sanity /ˈsænəti/ n. 明智；头脑清楚；精神健全；通情达理

saturate /ˈsætʃəreɪt/ vt. 使浸透；使饱和；使充满； adj. 浸透的；饱和的；

saturation n. 饱和度

Clear the X1CNT counter and then wait for it to saturate four times.

schematic n. 原理图

second 秒

microsecond 微秒

millisecond 毫秒

nanosecond 纳秒

semaphore /ˈseməfɔːr/ n. 信号标，信标，旗语；臂板信号装置 v. 打旗语，发信号

sequence n. 顺序

text sequences 文本序列

ship(v.) with 与某物一起（类似于打包在一起）

The fact that you will often be using Python libraries of prepared code—whether from the built-in standard library that ships with Python.

shunt /ʃʌnt/ v. n. 并励；并联；分流

signal path 信号通路，信号路径

a significant amount of 大量的

single-address mode 单地址模式

single-word mode 单字模式

burst mode 突发模式/爆发模式

All addresses can be accessed in either single-address mode or burst mode.

sophisticated services 复杂的服务

The idea of a protocol stack, in which very simple network services are used as a foundation on which to build more sophisticated services.

specification n. 规范 (a detailed description of design criteria for a piece of work)

specifications for benchmark tests 基准测试规范

target-specific functions 目标特定的功能

device-specific functions 设备特定的功能

split /splɪt/ vt. 分离；使分离；劈开；离开；分解 vi. 离开；被劈开；断绝关系 n. 劈开；裂缝 adj. 劈开的

stage changed （确认）暂存（数据）已变化

standalone operation 独立操作

For standalone operation, the clock can be generated using the on-board crystal oscillator.

static inline 静态内联

stimuli n. 刺激；刺激物；促进因素（stimulus的复数）

simulation stimuli 模拟刺激

at a strategic point in time 在战略性的时间点上 / 在关键时间点上 / 在关键时刻

support a myriad of sth. 支持各种各样的....

Our Processors and Microcontrollers support a myriad of general-purpose and application-specific needs. 我们的处理器和微控制器能够满足各种各样的通用或特定需求。

suppress vt. 抑制；镇压；废止

suppression n. 抑制；镇压；[植] 压抑

Pop-and-Click Suppression 音频杂音（嘀嗒和爆破）抑制

pop suppression 爆破（音）抑制

T

temperature n. 温度

junction temperature （T_j）结温；接点温度；接面温度

operating junction temperature 运行时结温

free-Air temperature 大气温度；

storage temperature 存储温度

ambient temperature （T_A）环境温度

terminate /ˈtɜːmɪneɪt/ vi./vt. 使终止；使结束；解雇

timing n. 时序

the timing of a burst mode write sequence 突发模式写入顺序时间（时序）

toggle /ˈtɒɡl/ n. 拴扣；切换键，开关；套索钉 v. 切换；拴牢，系紧

toggle split editor 切换分屏编辑器

toggle full screen 切换全屏幕

toggle function 切换函数

tolerable /ˈtɒlərəbl/ adj. 可以的；可容忍的

tolerable settling error 可容忍的沉降误差

torque /tɔːk/ n. 转矩，[力] 扭矩；项圈，金属领圈 v. (向轴、螺栓、圆轮等)施以扭动力；(使)沿轴转动；使(绕轴等)扭转；施加转矩

trench n. 沟渠、沟道

trim v. 修剪；切除 n. 点缀物；汽车装饰；修剪 adj. 整齐的；身材苗条的

offset trim register 偏移修整寄存器

trip n. （短程）旅行；幻觉；绊倒；错误；令人兴奋的经历；自我放纵的态度（或行动）；（机器、电路的）开关；（安全装置的）脱扣；轻捷的脚步；让人开心的奇人，奇妙有趣的经历 vi. 绊倒，跌倒；轻快地走（或跑、跳舞）；（非正式）（服用毒品后）产生幻觉；（部分电路）自动断开；作短途旅行 vt. 绊倒；（使）跌倒；触发（开关）；起（锚）；竖起（帆桁）

tristate n. 三角洲的

tristate buffer 三态缓冲器

tristate control 三态控制

truncate vt. 截断

Fractional values are truncated. 小数值已省略。/ 忽略小数部分

U

use sth. from sb./sth.

In earlier versions of gnuplot, some terminal types used the values from 'set size' to control also the size of the output canvas.

在gnuplot的早期版本中，一些终端类型使用set size中的值来控制输出画布的大小。

be used in a variety of combinations 被用于多种组合

IPC modules can be used in variety of combinations.

V

versatility /ˌvɜːsəˈtɪləti/ n. 多功能性；多才多艺；用途广泛

volatile /ˈvɒlətaɪl/ adj. [化学] 挥发性的；不稳定的；爆炸性的；反复无常的 n. 挥发物；有翅的动物

volatile unsigned int

W

welding v. 焊接；（使）紧密结合，成整体；焊接（物件）；（通过熔化或软化）连接（weld 的现在分词）n. 焊接，锻接

withstand

voltage withstand 耐电压

wrapper function 包装函数

Z

zero out 清零

Zero out structure object. 清空结构体对象

近意之词

level

level 有 层级、 等级 、电平、水平 之意，较难区分。

等级：relative stack priority level 相对堆栈优先（等）级

The below options allow you to set the scheduler's relative stack priority level and run mode.

下列设置允许你调整调度器的相对堆栈优先级和运行模式。

电平：full-scale level 满量程电平

logic-level 逻辑电平

Therefore, the full-scale level of a signal in the processing core will be slightly different from a full-scale level external to the IC.

独立

以下的词汇都具有 “分别的，独立的“之意

individual

respective

separated

术语

nomenclature /nəˈmeŋklətʃə(r)/ n. 命名法；术语

glossary n. 术语

terminology n. 术语，术语学；用辞

term n. 术语；学期；期限；条款；(代数式等的)项 vt. 把…叫做

时钟

clock oscillator /ˈɒsɪleɪtə(r)/ 时钟振荡器

internal oscillator 内部振荡器

external oscillator 外部振荡器

crystal oscillator 晶体振荡器

quartz crystal 石英晶振

external resonator 外部谐振器

程序

以下单词都具有程序/代码的意思

program

procedure

routine

code

utilities /juː'tɪlɪtɪz/ n. 实用程序

器件

switching regulator 开关整流器

voltage regulator 稳压器

limiter 限幅器

interpolator power 插值器功率

decimator power 切割器功率

capture 捕获器

pulse width modulator 脉冲幅频调制器

quadrature encoder 正交编码器

quadrature encoder pulse 正交编码器脉冲

sigma-delta filter module 西格玛-德尔塔滤波器模块

oscilloscope n. 示波器

co-processor 协处理器

modulator ADC 调制器

coupling capacitor 耦合电容器

discrete devices 分立器件

optoelectronic /ˌɒptəʊɪlekˈtrɒnɪks/ devices 光电子器件

线路

以下词汇均有 "线路" 之意：

line

wire

trace

cable

connect the audio cables 连接音频电缆

wider trace 更宽的线路、更宽的导线

If the headphone amplifiers are enabled, the PCB trace to this pin should be wider than traces to other pins to increase the current carrying capacity. A wider trace should also be used for the headphone output lines.

半导体

thyristor /'θaɪrɪstə/ n. 半导体闸流管

diode n. 二极管

collector n. 集电极

emitter /ɪˈmɪtə(r)/ n. 发射器，发射体，发射极

gate n. 栅极

collector-emitter voltage 集电极-发射极电压

collector-emitter breakdown voltage 集电极和发射极的击穿电压

collector-emitter saturation voltage 集电极和发射极的饱和电压

gate-emitter voltage 栅极发射极电压

gate-emitter threshold voltage 栅极和发射极的阈值电压

gate-emitter leakage current

pulsed collector current 脉冲（瞬时）集电极电流

High voltage gate driver IC 高电压栅极驱动芯片

600 V half bridge gate drive IC 600V半桥栅极驱动芯片

[TOC]

SYS/BIOS

• The Ethernet Media Access Controller (EMAC) module provides an efficient interface between the device core processor and the networked community.

• The EMAC controls the flow of packet data from the processor to the PHY. The MDIO module controls PHY configuration and status monitoring.

• Both the EMAC and the MDIO modules interface to the DSP through a custom interface that allows efficient data transmission and reception.

• This custom interface is referred to as the EMAC control module, and is considered integral to the EMAC/MDIO peripheral.

• The EMAC control, EMAC, and MDIO modules all have control registers. These registers are memory mapped into device memory space via the device configuration bus.【EMAC控制器、EMAC、MDIO模块都有控制寄存器，寄存器地址通过设备控制总线写入设备内存空间。】

• 【Descriptor 不存储任何缓冲数据，仅仅作为数据描述包而存在。主要结构为pNext、pBuffer、Buffer Offset、Buffer Length、Flags和Packet Length。其中，pBuffer是指向数据包Packet的指针存储块。】

Preparation

IDE Installation

SETUP

CONFIGURATIONS

Project

开发及编译环境

1. CSS安装
2. TI编译工具安装
3. SYS/BIOS安装
4. BIOS-MCSDK软件包安装
5. BIOS-MCSDK软件包补丁安装
6. XDC-Tools安装
7. pdk_C6657软件包

注意：

• 部分SDK、组件包可能会线下兼容，但是版本包带不带特殊标识，如XDCTOOLS个别版本带 _core 的，可能会导致不兼容gr platform。
• 组件包安装完毕之后需要在 CCS 的 Products and Repositories 中进行挂载和选择。

工程生成、导入与重编

工程的生成、导入与重编主要是针对他人写的代码，未针对我的硬件生成对应的工程文件，因而需要按照我的编译环境和硬件生成对应的工程文件，进而应用到我的硬件上。

工程生成

通过执行命令行工具 pdksetupenv.bat 和 pdkProjectCreate.bat 在对应的工程文件包生成工程文件夹 project 。

注意事项：

命令行工具中设置了一些关于路径的变量，如果安装了更新版本的软件包则因进入命令行文件对相应的文件路径进行修改。 如下，XDC-TOOLS 可能因为版本问题而导致 XDC_INSTALL_PATH 变量出错，各变量也应一一对照安装路径的文件夹名称进行审核。

pdksetupenv.bat 文件下的变量设置：

1 2	set MCSDK_INSTALL_PATH=D:\TexasInstruments\ set XDC_INSTALL_PATH=%MCSDK_INSTALL_PATH%\xdctools_3_25_06_96

pdkProjectCreate.bat 文件下的变量设置如下：

1 2 3 4 5 6 7 8 9 10 11

@REM 需修改成实际安装路径 set CCS_INSTALL_PATH="D:\ti\ccsv7" @REM 以下各文件版本需要根据当前最新使用的软件包版本来调整 set CGT_VERSION=8.3.8 set XDC_VERSION=3.32.2.25_core set BIOS_VERSION=6.33.06.50 set IPC_VERSION=1.24.03.32 set EDMA_VERSION=02.11.05.02 set NDK_VERSION=2.21.02.43 set PDK_VERSION=1.1.2.6

在以上文件都设置好以后，还需要进入CCS，点击 WINDOWS -> PREFERENCES -> CODE COMPOSER STUDIO -> PRODUCTS , 在 INSTALLED PRODUCTS 面板下找到已安装的软件包，如果未找到，点击 INSTALL , 选择 /ti 路径进行软件包安装。

如未挂载软件包，可能会出现错误提示如：!ERROR: Unknown product-type ID 'com.ti.sdo.edma3'!

找到示例文件，在示例文件的 /src/ 文件夹下，按住 shift键 并 点击鼠标右键，选择 在此处打开Powershell窗口 ，输入绝对路径和文件名称并按回车运行，如下：

1
2

D:\ti\pdk_C6657_1_1_2_6\packages\ti\drv\pdksetupenv.bat
D:\ti\pdk_C6657_1_1_2_6\packages\ti\drv\pdkProjectCreate.bat

成功时结果如下示：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

PDK_SHORT_NAME: I:\03.TexasInstruments_Workspace\tl-led-flash\src
*****************************************************************************
Detecting UnitTest Projects in PDK and importing them in the workspace "I:\03.TexasInstruments_Workspace\tl-led-flash\src\project"
找不到文件
*****************************************************************************
Detecting Example Projects in PDK and importing them in the workspace "I:\03.TexasInstruments_Workspace\tl-led-flash\src\project"
找不到文件
*****************************************************************************
Detecting TL Projects and importing them in the workspace "I:\03.TexasInstruments_Workspace\tl-led-flash\src\project"
Detected Example Project: tl-led-flash

--------------------------------------------------------------------------------
Creating project 'tl-led-flash'...


Done!
Copying macros.ini
已复制         1 个文件。

遇到关于 的问题

D:\ti\ccsv7\tools\compiler\ti-cgt-c6000_8.2.2\lib

XDC/STD

DETAILS

In addition to the interfaces specified below, this package also supplies a C/C++ header, std.h that facilitates the creation of portable sources. This header defines a set of "base" types that enable the creation of C-code that is portable between any two targets. C source code that relies exclusively on these types is portable to all targets and platforms. Where appropriate, the types defined below are related to the types defined in the library headers prescribed by the C99 standard (ISO/IEC 9899:1999).

Why not simply use the C99 types? Having a unique set of names provides a layer of insulation between a portable code base and a particular compiler; e.g., even if a compiler does not support the C99 types or defines them inappropriately for a particular device, it is possible to use the compiler without changing the code base. Thus, the developer is not forced to choose the lesser of two evils: waiting for a change to the compiler or forking the code base for a particular compiler device combination.

There are several situations where a small separate set of portable types can help the maintainability of a code base.

• not all of the types described in the C99 standard are required to be defined by conformant implementations nor is it possible for all devices to implement some of the types specified (e.g., int8_t is not implemented on C54 devices); so it is difficult to identify non-portable source code.
• not all compilers provide C99 type support; if XDC supplies the type definition and the compiler is updated to include C99 types, a compilation error will occur if the source includes the C99 headers.
• not all compiler and device combinations are conformant; even high quality compilers may not properly define the types for each device supported by compiler.

USAGE

1

#include <xdc/std.h>

To compile sources that include xdc/std.h, two symbols must be defined before including this header:

• xdc_target_types__

  the package qualified path of the target's standard types header; e.g., ti/targets/std.h. This value is specified in the target's stdInclude config parameter; see xdc.bld.ITarget.stdInclude

• xdc_target_name__

  the target's module name without the package prefix; e.g., C64 rather than ti.targets.C64.

For example, to compile sources for the ti.targets.C64 target using TI's cl6x compiler, the following command line is sufficient:

1

cl6x -Dxdc_target_types__=ti/targets/std.h -Dxdc_target_name__=C64

Each of the type names below has an equivalent "long name"; i.e., a name that has an "xdc_" prefix. For example, the type Bool can also be written as "xdc_Bool". Long names exist to avoid conflicts with names defined or used by existing code bases.

In the event that one of the short type names below conflicts with another type name (that can not be changed), it is possble to disable the short names by defining the symbol xdc__nolocalnames before including xdc/std.h.

1
2

#define xdc__nolocalnames
#include <xdc/std.h>

STANDARD TYPES

This header may be included multiple times and defines the following target-dependent types:

• Bool

  this type is large enough to hold the values 0 or 1. The constants TRUE and FALSE are of this type; see below.

• String

  this type is defined to be a char * and exists to allow code to distinguish between pointers to buffers of raw data and '\0' terminated strings.

• CString

  this type is defined to be a const char * and exists to allow code to distinguish between pointers to a modifiable '\0' terminated sequence of characters (i.e., a String) and one that is not modifiable (e.g., a literal string such as "hello world\n").

• Intn, where n = 8, 16, or 32

  signed integer type that is large enough to hold n bits; the actual target type may by be larger than n. This type is equivalent to one of the C99 types int_leastn_t or int_fastn_t; see Section 7.18.

• UIntn, where n = 8, 16, or 32

  unsigned integer type that is large enough to hold n bits; the actual target type may by be larger than n. This type is equivalent to one of the C99 types uint_leastn_t or uint_fastn_t; see ISO/IEC 9899:1999 Section 7.18.

• Bitsn, where n = 8, 16, or 32

  unsigned integer type that is precisely n bits. Not all targets support all values of n; if the target does not support an exact size the corresponding type is not defined. This type is equivalent to the corresponding C99 type uintn_t; see ISO/IEC 9899:1999 Section 7.18.

• Fxn

  this type is a pointer to code; it can hold a pointer to any function.

• Ptr

  this type is a pointer to data; it can hold a pointer to any data structure.

• IArg

  this integer type is large enough to hold a Fxn, Ptr, or Int.

• UArg

  this unsigned integer type is large enough to hold a Fxn, Ptr, or Int.

• LLong

  this long integer type is large enough to hold a Long and is defined as a 'long long' type on targets that support this type; otherwise, it is simply a Long. Note that C99 requires the long long type to be at least 64-bits wide (See ISO/IEC 9899:1999 Section 5.2.4.2.1). But some compilers do not support 64-bit integral types and some don't support the long long even though they do support 64-bit integral types. Since these variations limit the portability of valid C sources, the LLong type is always defined, is always at least as wide as the Long type, and is at least 64-bits wide for targets that support 64-bit integral types.

• ULLong

  this unsigned long integer type is large enough to hold a ULong and is defined as a 'unsigned long long' type on targets that support this type; otherwise, it is simply a ULong.

The xdc/std.h header also defines the following aliases for the base C types. These aliases exist so that C sources can consistently follow a naming convention in which all type names are written in camel-case.

• Char and UChar

  aliases for char and unsigned char, respectively

• Short and UShort

  aliases for short and unsigned short, respectively

• Int and UInt

  aliases for int and unsigned int, respectively

• Long and ULong

  aliases for long and unsigned long, respectively

• Double and LDouble

  aliases for double and long double, respectively

• SizeT

  alias for size_t

• VaList

  alias for va_list

The types above are defined for all targets. Some targets can support the following additional types. Since these types are not always supported by a target, these types should only be used when no other type sufficies.

• Bitsn, where n = 8, 16, or 32

  this unsigned integer type is precisely n-bits wide. This type is equivalent to the optional C99 type uintn_t; see ISO/IEC 9899:1999 Section 7.18.1.1. This type is defined if and only if the preprocessor macro xdc__BITSn__ is defined.

64 BIT TYPES

Although the C99 standard requires support for 64-bit types, not all compiler/device combinations can usefully support them. As a result, the 64-bit types described here may not be defined for all targets. For each type there is a corresponding pre-processor macro which is defined if and only if the type is supported.

• Int64

  signed integer type that is large enough to hold 64 bits; the actual target type may by be wider than 64 bits. This type is equivalent to one of the C99 types int_least64_t or int_fast64_t; see Section 7.18. This type is defined if and only if the preprocessor macro xdc__INT64__ is defined.

• UInt64

  unsigned integer type that is large enough to hold n bits; the actual target type may by be wider than 64 bits. This type is equivalent to one of the C99 types uint_least64_t or uint_fast64_t; see ISO/IEC 9899:1999 Section 7.18. This type is defined if and only if the preprocessor macro xdc__INT64__ is defined.

• Bits64

  unsigned integer type that is precisely 64 bits wide. If the target does not support an exact 64-bit size, this type is not defined. This type is equivalent to the corresponding C99 type uint64_t; see ISO/IEC 9899:1999 Section 7.18. This type is defined if and only if the preprocessor macro xdc__BITS64__ is defined.

The table below is from Log_print6() in the XDC/RUNTIME/LOG.H.

However, because the declared type of the arguments is IArg, all pointer arguments must be cast to an IArg type.IArg is an integral type large enough to hold any pointer or an int. So, casting a pointer to an IArg does not cause any loss of information and C's normal integer conversions make the cast unnecessary for integral arguments.

The format string can use the following conversion characters. However, it is important to recall that all arguments referenced by these conversion characters have been converted to an IArg prior to conversion; so, the use of "length modifiers" should be avoided.

usertype.h 中的定义:

1
2
3
4
5
6

typedef char           INT8;
typedef short          INT16;
typedef int            INT32;
typedef unsigned char  UINT8;
typedef unsigned short UINT16;
typedef unsigned int   UINT32;

SYS/BIOS RTOS

我们依赖操作系统来提供底层和中间件的服务，如让设备启动，处理基本IO口，允许多个程序并行运行，为多个正在运行的程序分配内存和磁盘空间，以及通过USB和以太网口等通讯堆栈来实现更多复杂的IO口通讯。

RTOS的优点

• 模块化设计，线程的使用使各任务得到最大化独立；
• 提供模块及接口以方便地驱动外设；
• 代码可移植性/脱离于内核处理器；

线程

• 线程是一组存储在存储器的代码，一旦寄存器被正确初始化，CPU就会执行这些代码。
• 定义和管理任何需要被操作的内容
  • 包括程序指针、堆栈和寄存器等值
  • 这些被统称“上下文”【每个线程都会被定义上下文，包括程序计数器、堆栈和关键寄存器的信息】
  • 会有一系列的线程需要在指定时间被执行，RTOS会按一定标准在指定时间选择线程执行。
• 线程可以使任何类型的，SYS/BIOS定义了四种线程类型（优先级降序排列）：
  • 硬件中断
  • 软件中断
  • 任务
  • 空闲
• 各线程有 隐式的(implicity) 和 显示的(explicity)（可能有）优先级
  • 隐式的优先级由线程类型决定
  • 显式的优先级由软件编程者决定
• 允许抢占（或者上下文切换）
  • 基于优先级的调度管理机制保证了最高优先级的线程能够在第一时间被执行
• 线程之间的交互
  • 阻断
  • 通信
  • 同步

TIMER and CLOCK

• 定时器模块 TIMER

• 管理定时器外设

• 提供虚拟的目标/设备概念

  • 【通过操作定时器模块而不是硬件外设，开发人员能够更轻松更直观地管理定时器，且在多个不同TI芯片中移植式，代码更具可移植性】
  • 【对于SYS/BIOS而言，可以产生无限数量的定时器】

• 时钟模块 CLOCK

  • 管理BIOS的“心脏节拍“
  • 在指定时间触发功能（单次或周期性）
  • 使用定时器模块或者应用层模块的“节拍”来处理输入事件
  • 【时钟模块所在的层位于定时器之上】
  • 【时钟模块可以通过定时器模块将系统中的外部事件引入作为输入事件，或者使用定时器模块产生的周期性节拍，基于这些输入事件，时钟模块可以产生软件中断，或者时钟模块还能提供一种服务，以便一次性或者周期性地触发任意数量的不同函数】
  • 【时钟实例中包含了对两个时间段的定义，第一个时间段的定义称为超时时间量，它定义了时钟实例的启动和首次触发相关函数的时间量，通常会在应用程序中，通过显示的调用时钟来启动一个时钟实例，如果创建时钟实例时，标志为TRUE，则实例会在创建后立即启动；第二个时间段的定义标志了相关函数首次调用和后续调用之间持续时间量；对于一次性的时钟实例，只需定义超时时间量，持续时间量将为0；相关函数都是由时钟实例的中断来调用的，这意味着必须在同一线程中启动或停止时钟，而不能在其他线程中任意启动或停止时钟】

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

// 启动/停止时钟实例，仅能通过时钟SWI调用
Clock_start()
Clock_stop()

// 启动/停止定时器底层产生时间节拍
// 【`时钟停止启动` 和 `时钟节拍停止`，用来为驱动时钟模块提供底层定时器】
Clock_tickStart()
Clock_tickStop()

// 修改停止的时钟实例
// 【设置 `时钟周期`、`超时`、`功能` 函数，用于修改时钟实例的参数】
Clock_setPeriod()
Clock_setTimeout()
Clock_setfunc()

// 允许修改时钟实例的参数，基于新的定时器频率
// 当CPU的频率发生变化时，可以通过此函数对时钟进行重新配置
Clock_tickReconfig()

• 时间戳模块
  • 为代码的基准测试提供便捷的时间戳服务
  • 允许时间戳记录RTA日志

1
2
3
4
5
6
7
8
9
10
11
12

/*前两个变量的类型由时钟模块定义*/
Clock_Params clockParams;               //用于容纳所有的时钟实例参数
Task_Handle myClock;                    //用于存储将要创建的时钟实例的句柄
Error_block eb;                         //错误块变量，若创建失败可以获取失败原因的信息

Clock_Params_init(&clockParams);        //时钟实例初始化参数，已默认值填充参数结构
/*下两句分别更新与默认值不同的参数*/
clockParams.period = 4;                 //Every 4 Clock ticks
ClockParams.startFlag = TRUE;           //Start immediately
Error_init(&eb);                        //错误块变量，若创建失败可以获取失败原因的信息

myClock = Clock_create((Clock_FuncPtr)clockHandler,4,&clockParams,&eb); //三参数，时钟实例创建，并返回句柄给myClock

在XGCONF中配置时钟参数：

时钟实例化参数：

HWI and Idle

嵌入式硬件中断的原理：前台/后台调度（主要由低优先级任务、无线循环任务和ISR构成，复杂性较低，存在不足）

• 应用程序循环处理由硬件中断服务程序职位的标志位
• ISR抢断主循环，执行中断服务【ISR 被称为前台进程】

SYS/BIOS在BIOS之上实行 Idle loop + Hwi + main() 的方式：

• 空闲循环是优先级最低的无限循环（并不代表优先级不重要），所执行的是一系列静态配置的后台程序
• 典型应用：用户界面，内置的系统测试，测量，以及低功耗模式
• 被最高优先级线程抢断/从被抢断的地方恢复运行
• ISR以HWI线程的方式运行，任意HWI都能抢断空闲循环

后台空闲循环（线程）

The background Idle Loop is the thread with the lowest priority of all. It runs in a loop when the CPU is not busy running another thread.

• When tasks are enabled, the Idle Loop is implemented as the only task running at priority 0.

• When tasks are disabled, the Idle Loop is fallen into after the application's "main()" function is called.（空闲循环会在应用程序main()函数被调用后陷入？）

HWI的中断及恢复流程（中断调度流程）：

1. 屏蔽任务调度【HWI是被视为隐式的较高优先级线程，因此不希望所有目前最高优先级的线程抢断HWI线程，如果应用程序没有启用任务模块，该段启动任务调度的程序将被优化出中断调度程序，以便确保中断调度程序能够高效执行】
2. 转向ISR堆栈（如果没有指向该堆栈）【如果当前指针指向任务堆栈，则此时会切换到中断堆栈】
3. 保存中断返回地址【中断调度程序将存储该指针，以防用户使用IRP的API来检索该返回地址，如果不需要使用该API则被优化】
4. 屏蔽SWI调度【如任务模块一样未被开启，则自动优化出中断调度程序】
5. 调用HWI挂钩启动函数【附加挂钩函数】
6. 如果允许自动嵌套：允许全局中断【有更高优先级的硬件中断来临时，打开中断屏蔽，使能全局中断】
7. 调用ISR服务程序【真正的硬件中断程序开始执行】
8. 屏蔽全局中断
9. 调用HWI挂钩结束函数
10. 运行SWI调度
11. 切换回任务堆栈
12. 运行任务调度

SYS/BIOS中断管理的优势：

1. 降低代码量
2. 提供中断堆栈，降低任务堆栈大小
3. 管理中断嵌套
4. 在ISR任务中禁止调度中断
5. 运行由ISR程序递交的SWI程序
6. 管理任务抢断
7. 提供监测
8. 灵活性：仍然允许不执行中断调度

注意： HWI不需要使用编译器认可的中断关键字！SYS/BIOS的中断调度会自动保存堆栈相关数据，如果使用会导致灾难性的运行故障发生！

1
2
3
4
5
6
7

Hwi_Params hwiParams;              //硬件中断参数结构体实例
Hwi_Handle hwi0;                   //硬件中断句柄
Error_block eb;

Hwi_Params_init(&hwiParams);       //参数初始化
hwiParams.arg = 5;                 //更新参数
hwi0 = Hwi_create(id,hwiFunc,&hwiParams,&eb);  //四参数，前两个未知

SWI

• 一般伴随着硬件中断的发生而发生，以便最灵活地处理中断事务

• 优先级共16级：0-15

• 寄存器的保护/恢复由SYS/BIOS系统自动处理

• 单堆栈模式：增加优先级将增加堆栈的开销

• 【与任务的处理方式不同，SWI在单个堆栈上运行，同时兼具优点与局限性，能使SWI以非常低的内存消耗来运行，但也不允许他们被挂起（即SWI必须运行到结束）】

• 【SWI通常由HWI调用，系统产生了一个外设的中断，从而触发了HWI线程，而HWI处理的都是需要紧急实时响应的事务，HWI线程需要尽可能快速处理完毕，并且处理HWI时会屏蔽其他中断，因此为了让HWI处理尽可能少的操作，一些不太需要紧急实时处理的任务会放到SWI中处理。】

• 【因此当HWI将中断发布到SWI时，SWI会立即处理】

• 【HWI通常是突发而紧急的，SWI通常较为灵活、常态而平稳】

• 【HWI通常以微秒计时，SWI通常以毫秒计时】

• 【HWI和SWI都只会运行一次，不管该线程在运行前被发布了多少次】

• 【具有相同优先级的两个SWI线程不会抢占对方，会以FIFO的方式先后运行两个线程，即使第二个线程已经被发布，但直到第一个线程运行完毕，第二个线程都在持续等待】

• 【如果使用ISR来发布更高优先级的SWI，或者说在使用ISR时发布SWI，则可能使得SWI立即抢占ISR的线程，造成数据丢失，BIOS更推荐使用HWI来发布SWI】

• 【同一个SWI线程不论在运行前被发布了多少次，都只会运行一次】

• If trigger value is needed by the Swi, use Swi_getTrigger() which returns the value of the trigger when the Swi function starts running.
• After each posting, the trigger is reset to the initial condition specified in the Swi object.

1
2
3
4
5
6
7
8
9
10

Swi_Params swiParams;
Swi_Handle mySwi;
Error_Block eb;    //创建错误块结构体实例

Swi_Params_init(&swiParams);
swiParams.priority = 15;

Error_init(&eb);   //初始化错误块结构体

mySwi = Swi_create(swiFunc, &swiParams, &eb);    //三参数

Task

SYS/BIOS-TASK

任务创建函数原型Task_create(Task_FuncPtr, Const*, Error_Block*)

注意：要与 TaskCreate(void*(), char*, int, uint, UINT32, UINT32, UINT32); 做区分。

1
2
3

Task_create(Task_FuncPtr fxn,
            const Task_Params *params, 
            Error_Block *eb);

示例

1
2
3
4
5
6
7

Task_Params taskParams;

// Create task with priority 15 
Task_Params_init(&taskParams);
taskParams.stackSize = 512;
taskParams.priority = 15;
Task_create((Task_FuncPtr)myFxn, &taskParams, &eb);

任务特性

• 任务调度使用更先进的调度技术
  • 每个任务在创建时都会设立独立堆栈，任务访问共享资源时可能会因为等待而被挂起
  • 任务会被其他更高优先级的线程打断（SWI、HWI），HWI 及 SWI不可挂起（SWI是需要退出和返回）；
• 任务的数量、状态及优先级都可以在程序执行时动态改变
• 【两个任务可以调用同一函数（主要该函数是可以重入？的函数），即该函数在执行完毕之前可被安全地二次调用，任务在调用函数时可携带参数，使函数知晓是被哪个实例调用】

任务间时间切片。

任务在正常情况下是个看似 “无限循环” 的进程，只有在整个系统停止后才会结束；但在未被挂起的情况下，任务在被CPU分时间调度的过程中，任务会重新从头开始运行，即不会停留在上一次的位置。任务看似一次被执行就一直被无限调度，实际上是在时间分片中快速切换。

任务与Semaphore。

在使用Semaphore作为同步方式的任务调度中，如果一个任务等级较高，且 Semaphore_pend() 时，设置了第二个参数为 BIOS_NO_WAIT ，即该任务会被立即循环执行。如果参数设置为 BIOS_WAIT_FOREVER ，则该程序将会一直等待，直到它的信号量被post出来。

原文：A timeout value of BIOS_WAIT_FOREVER causes the task to wait indefinitely for its semaphore to be posted. A timeout value of BIOS_NO_WAIT causes Semaphore_pend to return immediately.

注意：互相形成依赖的任务（如嵌套）不要用同一个信号量，会发生冲突、堆栈溢出或死锁等现象。尽量一个任务关联一个信号量。

注意：如果有堆栈溢出，应优先检查task和semaphore的初始化情况。

任务测试

Table 3-1. Comparison of Thread Characteristics

OSIF-TASK

<osif.h> 文件提供系统级接口函数，与SYS/BIOS提供的相似任务函数具有不一样的函数定义。所有任务相关函数如下：

1
2
3
4
5
6
7
8
9
10
11
12
13

// 以下功能可能需要被链接或移植
_extern void   TaskBlock(HANDLE h);
_extern HANDLE TaskCreate( void(*pFun)(), char *Name, int Priority, uint StackSize,
                          UINT32 Arg1, UINT32 Arg2, UINT32 Arg3 );
_extern void   TaskDestroy( HANDLE h );
_extern void   TaskExit();
_extern HANDLE TaskGetEnv( HANDLE h, int Slot );
_extern int    TaskGetPri(HANDLE h);
_extern HANDLE TaskSelf();
_extern void   TaskSetEnv( HANDLE h, int Slot, HANDLE hEnv );
_extern int    TaskSetPri(HANDLE h, int priority);
_extern void   TaskSleep(UINT32 delay);
_extern void   TaskYield();

任务创建函数 TaskCreate(void*(), char*, int, uint, UINT32, UINT32, UINT32);

1
2

_extern HANDLE TaskCreate( void(*pFun)(), char *Name, int Priority, uint StackSize,
                          UINT32 Arg1, UINT32 Arg2, UINT32 Arg3 );

TaskCreate(); 的使用方式如下：

1

( void ) TaskCreate ( TCP_Perform_Server , "TCPBenchmarkRX" , OS_TASKPRIHIGH , 0x1400 , 0 , 0 , 0 );

关于任务优先级Priority的定义存在同一头文件中，具体如下：

1
2
3
4
5
6
7
8
9
10

// Equates used in code
#define DBG_PRINT_LEVEL         (_oscfg.DbgPrintLevel)
#define DBG_ABORT_LEVEL         (_oscfg.DbgAbortLevel)
#define OS_TASKPRILOW           (_oscfg.TaskPriLow)
#define OS_TASKPRINORM          (_oscfg.TaskPriNorm)
#define OS_TASKPRIHIGH          (_oscfg.TaskPriHigh)
#define OS_TASKPRIKERN          (_oscfg.TaskPriKern)
#define OS_TASKSTKLOW           (_oscfg.TaskStkLow)
#define OS_TASKSTKNORM          (_oscfg.TaskStkNorm)
#define OS_TASKSTKHIGH          (_oscfg.TaskStkHigh)

以下出自 <spru523h.pdf> Chapter 3.3 Creating a Task

The process of creating a sockets application begins with the creation of a SYS/BIOS Task thread. You can use XGCONF to statically configure Tasks or use the standard SYS/BIOS API or the provided Task abstraction to dynamically create Tasks. For example, the following C code creates a basic Task:

1 2 3 4 5 6 7 8 9 10 11 12

Task_Params taskParams; Task_Handle hMyTask; Error_Block eb; Error_init(&eb); Task_Params_init(&taskParams); taskParams.stackSize = 4096; taskParams.priority = 5; /* Create a Task with priority 5 */ hMyTask = Task_create((Task_FuncPtr)entrypoint, &taskParams, &eb); if (hMyTask == NULL) { System_abort("Task create failed"); }

The same Task can be created via the TaskCreate() function in the Task abstraction API. The abstracted function is a little more restrictive. It creates a Task thread with exactly 3 parameters (they do not all have to be used). For example, the following call would create a Task similar to that shown above:

hMyTask = TaskCreate( entrypoint, "TaskName", OS_TASKPRINORM, stacksize, arg1, arg2, arg3 );

In both cases, hMyTask is a handle to a SYS/BIOS Task thread.

Synchronization

SYS/BIOS内的同步类型分为 进程同步 和 核同步 ；同步方式共5种：Semaphore(信号量) / Event(事件) / Gate(门) / Mailbox(邮箱) / Queue(队列)

Semaphore

信号量可分为 互斥型 和 计数型 两种。

互斥型信号量

也称为为互斥量、二进制型信号量。可以理解为只能维护资源数量为1的二值计数信号量（值为0或1），但是互斥信号量又不同于计数信号量，因为它还具有 优先级继承 的机制。

优先级继承机制是RTOS中为了避免出现 优先级翻转 问题而做的处理方式。简单来说就是如果低优先级持有互斥信号量那么高优先级任务想访问互斥量就会失败而挂起等待互斥量被释放，此时反而是低优先级任务在运行，这就出现了优先级翻转。为了避免该情况RTOS处理方式是把正在持有互斥量运行的低优先级任务的优先级提高到与等待访问互斥资源的高优先级任务同等优先级，这就是优先级继承。等互斥量被释放后RTOS会将该任务恢复到之前的低优先级。

特性：

• 信号量是指系统当前可用资源的数值，当资源超过1时，为 计数型信号量 ；当资源仅为1和0时，为 二进制型信号量；因为资源总为1及以上，因此不论是计数型还是二进制型，可用的信号量始终≥0。

• 信号量用于标识和实现任务的 挂起 和 发布

  • 发布 指任务正在处于结束状态，Semaphore_post() 将使信号量递增
  • 挂起 指任务正在处于运行状态，Semaphore_pend() 将使信号量递减
  • 使用 Semaphore_pend() 以使用资源，使用 Semaphore_post() 以离开资源

• 计数型信号量用来进行多任务管理

  • 多任务信号量的初始值将为可同时进行任务的最大值
  • 当达到最大可运行任务量时，信号量值为0，即信号阻塞

• 当信号量为0时，即系统资源被占满，如果此时出现最高优先级任务，系统将抢断低优先级任务从而使高优先级任务进行工作

任务与调用任务

在调用任务时，不需要特意调高被调用任务的等级。

在被调用任务的等级等于本任务时，使用Semaphore_post(); 并使用 task_yeild(); ，即可顺利将任务切换到被调用任务。(如下 SEM-1 示)

在被调用任务的等级低于本任务时，使用 Semaphore_post(); 并使用 task_sleep(); ，即可让低等级任务在本任务休眠期间执行。(如下 SEM-2 示)

SEM-1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

void task_core0TCPService(UArg a0, UArg a1) {                                      //Core0执行TCP信息接收任务
    short rx_length = 1;

    while(1){
        Semaphore_pend( sem0_TcpReceive, BIOS_WAIT_FOREVER );
        TcpReceive(ReceiveBuffer, RECEIVEBUFFER_SIZE);

        //...
        if(rx_length > 0){
            if(ReceiveBufferTemp[0]==0xf5){
                switch(ReceiveBufferTemp[2]){
                case 0x01:
                    if(ReceiveBufferTemp[3] == 0x01){                                                     
                        Semaphore_post(sem0_ad);                    //post同等级任务的信号量
                        Task_yield();                               //调用任务切换函数
                    }
                    //...
                default:
                    //...
                    break;
                }
            }
        }
        //...
    } 
}

void task_core0AdcRead(UArg a0, UArg a1)
{
	int i = 0;                                                                                               
	while(1){
        Semaphore_pend(sem0_ad,BIOS_WAIT_FOREVER);
        while(ADC_Cnt <= ADC_MICROSECOND){
		//...
        }
	}
}

Int main()
{ 
    Task_Handle task;                                              //创建空任务句柄
    Task_Params param;                                             //创建空任务参数
    Error_Block eb;                                                //创建空错误块
	Error_init(&eb);                                               //初始化错误块参数
    Task_Params_init(&param);                                      //初始化任务参数
    uart_init();                                                   //串口初始化
    uart_set_baudrate(115200);                                     //设置波特率

    if(CSL_chipReadDNUM() == 0)
    {
    	SemInit_Core0();                                            //配置semaphore，sem0_ad,sem0_da
    	FanLed_Init();                                              //点亮LED3，开启FAN
    	Sgmii_Init();                                               //外设初始化
        ADS8568_Init();                   //INT6
        DAC8565_Init();                   //INT7
    	Timer3_Init();                    //INT4

        task = Task_create(task_core0Init, &param, &eb);
        TaskSuccess(&task,"任务创建失败：task_core0Init\n"); 

        param.priority=10;
        task = Task_create(task_core0TCPService, &param, &eb); 
        TaskSuccess(&task,"任务创建失败：task_core0TCPListenAndReceive!\n"); 

        param.priority = 10;
        task = Task_create(task_core0AdcRead, &param, &eb);           //读取AD任务
        TaskSuccess(&task,"任务创建失败：task_core0AdcRead\n");                 
    }
    BIOS_start();
    return(0);
}

SEM-2

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

Void lowPriTask(UArg arg0, UArg arg1)
{
	for(;;){
		Semaphore_pend(mySem, BIOS_WAIT_FOREVER); //挂起任务
		resource += 1;                  //do work on locked resource
		Semaphore_post(mySem);
	}
}

Void hiPriTask(UArg arg0, UArg arg1)
{
	for(;;){
		Semaphore_pend(mySem, BIOS_WAIT_FOREVER);
		resource += 1;                  //do work on locked resource
		Semaphore_post(mySem);
		Task_sleep(5);                 //allow low pri taks to work
	}
}

任务与信号量之间的关系？

• 任务的顺利执行，需要经过 任务新建、信号量新建、信号量阻塞 和 信号量发布 四个流程。任务不是在被发布后就立即执行的，他需要等待信号量的到来。

• 先pend后post，即任务执行必须由对应的信号量进行排队（阻塞）和准备（发布），如果其中任何一个步骤缺省都无法执行任务。

• pend要在该任务被执行时使用，放置在任务最开始的一句话中；post可以放置在别的任务或 IRS 中断里，由别的任务或函数来启动本任务。

• 信号量使用须统一为计数型或二进制型？

Event

NDK

EMAC

EMAC驱动程序提供了一个定义良好的API层，允许应用程序使用EMAC外设来控制从处理器到PHY的数据包数据流，并使用MDIO模块来控制PHY配置和状态监控。

EMAC驱动程序的设计要求如下:

• 每个核支持多个EMAC端口(如果设备上可用)。
• 每个核支持多个通道/MAC地址。
• 支持多个内核在同一个EMAC端口上使用不同的通道。
• 驱动程序是独立于操作系统的，通过OSAL操作系统层暴露所有的操作系统callout。
• EMAC示例测试应用程序提供了标准配置，并演示了可度量的基准测试。

EMAC驱动程序的架构图如下:

1.EMAC设备驱动程序

设备驱动程序公开了一组定义良好的API，应用层使用它通过EMAC外围设备发送和接收数据包，并通过MDIO外围设备配置和监视PHY。驱动程序还公开了一组定义良好的操作系统抽象API，用于确保驱动程序是操作系统独立的和可移植的。EMAC驱动程序对所有EMAC MMR访问使用CSL EMAC功能层。

2.应用程序代码

这是EMAC驱动程序的用户，它与驱动程序的接口是通过定义良好的API集实现的。应用程序用户使用EMAC驱动程序API通过EMAC外围设备发送和接收数据包。

3.操作系统抽象层

EMAC LLD是独立于操作系统的，并通过这个层公开所有的操作系统调出。

4.CSL功能层

EMAC驱动程序使用CSL EMAC功能层通过访问MMR来对设备IP进行编程。

5.注册层

寄存器层是由IP所有者生成的IP块内存映射寄存器。EMAC驱动程序不直接访问MMR寄存器，而是使用EMAC CSL功能层实现这个目的。

SOCKET

在C++/MFC中有Window Socket，作为TCP/UDP数据传输的接口工具。

在C#/WPF中也有Socket，作用同上。

在C++/TI.SYSBIOS的NDK套件中也有Socket作为沟通套接的工具。

TI.SYSBIOS的NDK套件中，常用的函数如下：

NDK_accept()

Accept a connection on a socket

SOCKET NDK_accept(SOCKET s, struct sockaddr *pName, int *plen);

NDK_bind()

Bind a name to a socket

int NDK_bind(SOCKET s, struct sockaddr *pName, int len);

NDK_connect()

Initiate a connection on a socket

int NDK_connect(SOCKET s, struct sockaddr *pName, int len);

NDK_getpeername()

Return name (address) of connected peer

int NDK_getpeername(SOCKET s, struct sockaddr *pName, int *plen);

NDK_getsockname()

Return the local name (address) of the socket

int NDK_getsockname(SOCKET s, struct sockaddr *pName, int *plen);

NDK_getsockopt()

Get the value of a socket option

int NDK_getsockopt(SOCKET s, int level, int op, void *pbuf, int *pbufsize);

NDK_listen()

Listen for connection requests on a socket

int NDK_listen(SOCKET s, int maxcon);

NDK_recv()

Receive data from a socket

int NDK_recv(SOCKET s, void *pbuf, int size, int flags);

NDK_recvfrom()

Receive data from a socket with the senders name (address)

int NDK_recvfrom(SOCKET s, void *pbuf, int size, int flags, struct sockaddr *pName, int *plen);

NDK_send()

Send data to a connected socket

int NDK_send(SOCKET s, void *pbuf, int size, int flags);

NDK_sendto()

Send data to a specified destination on an unconnected socket

int NDK_sendto(SOCKET s, void *pbuf, int size, int flags, struct sockaddr *pName, int len);

NDK_setsockopt()

Set the value of a socket option

int NDK_setsockopt(SOCKET s, int level, int op, void *pbuf, int bufsize);

NDK_shutdown()

Close one half of a socket connection

int NDK_shutdown(SOCKET s, int how)

NDK_socket()

Create a socket

SOCKET NDK_socket(int domain, int type, int protocol);

NDK_socketpair()

Create socket pair. Redundant; see Section 3.5, Full Duplex Pipes Programming Interface.

The domain parameter specifies a communications domain within which communication will take place; 域参数指定通信将在其中发生的通信域;

Terminology

EMAC

Ethernet Media Access Controller

MDIO

Management Data Input/Output

PHY

Physical Layer

Purpose of the Peripheral

The EMAC module is used on the device to move data between the device and another host connected to the same network, in compliance with the Ethernet protocol.

PLL

Phase-Locked Loop 锁相环

锁相环路 是一种反馈控制电路，简称锁相环。

锁相环 的特点是：利用外部输入的参考信号控制环路内部振荡信号的频率和相位。因锁相环可以实现输出信号频率对输入信号频率的自动跟踪，所以锁相环通常用于闭环跟踪电路。

锁相环在工作的过程中，当输出信号的频率与输入信号的频率相等时，输出电压与输入电压保持固定的相位差值，即输出电压与输入电压的相位被锁住，这就是锁相环名称的由来。

锁相环通常由鉴相器（PD,Phase Detector）、环路滤波器（LF,Loop Filter）和 压控振荡器（VCO,Voltage Controlled Oscillator）三部分组成。

MII

以太网媒体接口有：MII、RMII、SMII、GMII

Media Independent Interface

称为 介质无关接口 或 媒体独立接口，它是 IEEE-802.3 定义的以太网行业标准。

• 它包括一个 数据接口 和一个 MAC 和 PHY 之间的管理接口。数据接口 包括分别用于 发送器 和 接收器 的两条独立信道，每条信道都有自己的 数据、时钟 和 控制信号 。MII数据接口总共需要16个信号。
• 管理接口是个双信号接口：一个是时钟信号，另一个是数据信号。通过管理接口，上层能监视和控制PHY。
• MII标准接口用于连接 Fast Ethernet MAC-block 与 PHY。表明在不对MAC硬件重新设计或替换的情况下，任何类型的PHY设备都可以正常工作。
• 在其他速率下工作的与MII等效的接口有：AUI（10M　以太网）、GMII（Gigabyte　以太网）和XAUI（10-Gigabit　以太网）。
• MII支持10兆和100兆的操作，一个接口由14根线组成，它的支持还是比较灵活的，但是有一个缺点是因为它一个端口用的信号线太多，如果一个8端口的交换机要用到112根线，16端口就要用到224根线，到32端口的话就要用到448根线，一般按照这个接口做交换机，是不太现实的，所以现代的交换机的制作都会用到由MII简化而来的标准，如 RMII、SMII、GMII 等。
  • RMII（Reduced MII）是简化的MII接口，在数据的收发上它比MII接口少了一倍的信号线，所以它一般要求是50兆的总线时钟。RMII一般用在多端口的交换机，它不是每个端口安排收、发两个时钟，而是所有的数据端口公用一个时钟用于所有端口的收发，这里就节省了不少的端口数目。RMII的一个端口要求7个数据线，比MII少了一倍，所以交换机能够接入多一倍数据的端口。和MII一样，RMII支持10兆和100兆的总线接口速度。
  • SMII（Serial MII）是由思科提出的一种媒体接口，它有比RMII更少的信号线数目，S表示串行的意思。因为它只用一根信号线传送发送数据，一根信号线传输接受数据，所以在时钟上为了满足100的需求，它的时钟频率很高，达到了125兆，为什么用125兆，是因为数据线里面会传送一些控制信息。SMII一个端口仅用4根信号线完成100信号的传输，比起RMII差不多又少了一倍的信号线。SMII在工业界的支持力度是很高的。同理，所有端口的数据收发都公用同一个外部的125M时钟。
  • GMII（Gigabyte MII）是千兆网的MII接口，这个也有相应的RGMII接口，表示简化了的GMII接口。

MII （Management interface）只有两条信号线。

SGMII

Serial Gigabit Media Independent Interface

SerDes

ESD

Electrostatic discharge

STATS

SOP

Start of Packet, the first fragment of packet

EOP

End of Packet, the last fragment of packet

EOQ

end-of-queue

LSB

least-significant bit

HDP

head descriptor pointer

DMA

TXnHDP

Transmit Channel n DMA Head Descriptor Pointer Register

RXnHDP

Receive Channel n DMA Head Descriptor Pointer Register

Swi

Software Interrupt

Hwi

Hardware Interrupt

ISR

中断服务程序

C99

C99 （以前称为C9X ）是ISO / IEC 9899：1999的非正式名称，在1999年推出，被ANSI于2000年3月采用。它是C编程语言标准的过去版本。 它扩展了以前的版本（ C90 ），增加了语言和标准库的新功能，并帮助实现更好地利用可用的计算机硬件，如IEEE 754-1985浮点运算和编译器技术，最主要的增强在数值处理上。 2011年发布的C编程语言标准的C11版本取代了C99。

C99是在C89/90的基础上发展起来的，增加了基本数据类型、关键字和一些系统函数等。

C99有一部分是对于增加了宽字符集，还加入了一些库函数，是继C89标准之后的第二个C语言官方标准。第一个C++语言官方标准C++98标准，就是基于C89编写的，因此C99标准新增的语法特性在C++的编译器中就或多或少地支持了，而完全或几乎完全支持C99标准的主流编译器有：GCC 、Clang 、Intel C++ Compiler 等。另外，Visual Studio 2013也部分支持了C99语法特征 。

C99标准的草案是免费的 [6]

初始化列表

初始化列表是用于初始化一组（结构体）内存位置的值列表。

例如，假设已经声明了以下 Date 结构体：

1	struct Date{int day, month, year;};

定义和初始化 Date 变量的方式是：先指定变量名，后接赋值运算符和初始化列表，如下所示：

1	Date birthday = {23, 8, 1983};

该声明定义 birthday 是一个 Date 结构体的变量，大括号内的值按顺序分配给其成员。

也可以仅初始化结构体变量的部分成员。例如，如果仅知道要存储的生日是8月23日， 但不知道年份，则可以按以下方式定义和初始化变量：

1	Date birthday = {23,8};

这里只有 day 和 month 成员被初始化，year 成员未初始化。但是，如果某个结构成员未被初始化，则所有跟在它后面的成员都需要保留为未初始化。使用初始化列表时，C++ 不提供跳过成员的方法。以下语句试图跳过 month 成员的初始化。这是不合法的。

1	Date birthday = {23,1983}; //非法

还有一点很重要，不能在结构体声明中初始化结构体成员，因为结构体声明只是创建一个新的数据类型，还不存在这种类型的变量。因为结构体声明只声明一个结构体“看起来是什么样子的”，所以不会在内存中创建成员变量。只有通过定义该结构体类型的变量来实例化结构体，才有地方存储初始值。

构造函数

虽然初始化列表易于使用，但它有两个缺点：

1. 如果有某个成员未被初始化，那么在这种情况下，跟随在该成员后面的成员都不能初始化。
2. 如果结构体包括任何诸如字符串之类的对象，那么在许多编译器上它都将无法运行。

在这些情况下，可以使用构造函数来初始化结构体成员变量，这和初始化类成员变量是相同的。与类构造函数一样，结构体的构造函数必须是与结构体名称相同的公共成员函数，并且没有返回类型。因为默认情况下，所有结构体成员都是公开的，所以不需要使用关键字 public。

以下是一个名为 Employee 的结构体的声明语句，它包含一个具有两参数的构造函数，以便在创建一个 Employee 变量而不向其传递任何参数时，提供默认值：

1 2 3 4 5 6 7 8 9 10 11 12

struct Employee { string name; // 员工姓名 int vacationDays, // 允许的年假 daysUsed; //已使用的年假天数 Employee (string n ="",int d = 0) // 构造函数 { name = n; vacationDays = 10; daysUsed = d; } };

Const in C++

1. const与#define

   两者都可以用来定义常量，但是const定义时，定义了常量的类型，所以更精确一些。

   #define只是简单的文本替换，除了可以定义常量外，还可以用来定义一些简单的函数，有点类似内联函数(Inline)。

   const和define定义的常量可以放在头文件里面。（小注：可以多次声明，但只能定义一次）

2. const与指针和引用

   • const与指针

     1 2 3 4

     int me; const int* p1 = &me;//p1可变，*p1不可变，此时不能用*p1来修改，但是p1可以转向 int* const p2 = &me;//p2不可变，*p2可变，此时允许*p2来修改其值，但是p2不能转向。 const int* const p3 = &me;//p3不可变，*p3也不可变，此时既不能用*p3来修改其值，也不能转向

   • 指针和引用的区别很简单，就是引用更简洁，更安全。因为引用声明时必须初始化。 引用更接近const指针，一旦与某个变量关联，就将一直效忠于他。

   • const指针可以接受const和非const地址，但是非const指针只能接受非const地址。所以const指针的能力更强一些，所以尽量多用const指针，这是一种习惯。

3. const与函数

• 由于2.3，所以经常把函数的形参类型设为const，而且多为const 引用。但是这里有一个限制，不能把不是左值的地址传递给引用。（左值包括变量，数组元素，结构成员，引用，被解除引用的指针等）。 形参是const类型的，说明该函数将不会修改其值，该函数便为const函数。

• const与类成员函数。先看看下面这段代码：

  1 2	const Stock land = Stock("hyd"); land.show();

  land 是常量，但是类成员函数show()无法保证不修改land，所以编译器将拒绝执行该段代码。除非你能保证show像const函数一样，但这需要另外一种语法，即：

  1 2	void show() const; //声明 void Stock::show() const{} //定义

内联函数

Inline Functions

超级循环

ANC

IPC

Inter-Processor Communication

内部处理器通信

NDK

Network Development Kit

网络开发套件

GPIO

General Purpose Input/Output

通用型之输入输出的简称，功能类似8051的P0—P3，其接脚可以供使用者由程控自由使用，PIN脚依现实考量可作为通用输入（GPI）或通用输出（GPO）或通用输入与输出（GPIO），如当clk generator, chip select等。

既然一个引脚可以用于输入、输出或其他特殊功能，那么一定有寄存器用来选择这些功能。对于输入，一定可以通过读取某个寄存器来确定引脚电位的高低；对于输出，一定可以通过写入某个寄存器来让这个引脚输出高电位或者低电位；对于其他特殊功能，则有另外的寄存器来控制它们。

EMIFA

SRIO

高速串行IO口

Hyperlink

超链接

JTAG

Warm reset

软复位

LLD

Low Level Driver

HAL

Hardware Adaption Layer硬件适应层

IGMP

Internet Group Management Protocol

Internet Group Management Protocol (IGMP) is designed to help routers in routing IP multicast traffic. Each router can have multiple ports, and it is inefficient for the router to replicate every IP multicast packet out of each active port. Using the IGMP protocol, the multicast router is able to keep track of which IP multicast addresses need to be routed to each individual port. This allows the router to limit IP multicast transmission to only those ports that require the multicast traffic. IGMP 是用来帮助路由器路由IP组播流量的。每个路由器可以有多个端口，并且路由器从每个活动端口复制每个IP组播包是低效的。使用IGMP协议，组播路由器能够跟踪哪些IP组播地址需要被路由到每个单独的端口。这允许路由器将IP组播传输限制为仅需要组播流量的端口。

The IGMP protocol assumes a client/server relationship between endpoints. The IGMP server is run by the multicast router to get IP multicast information about all the client on each of its individual ports. The IGMP client is only concerned with communicating its own multicast requirements to the local IGMP server, so that it will get the IP multicast packets that it requires. IGMP协议假定端点之间存在客户端/服务器关系。IGMP服务器由组播路由器运行，以获得关于每个单独端口上的所有客户端的IP组播信息。IGMP客户端只关心把它自己的组播要求传达给本地IGMP服务器，这样它就会得到它所需要的IP组播包。

Vocabulary

1. granularity n. 间隔尺寸，[岩] 粒度

   the quality of being composed of relatively large particles

2. be patched with 用**修补

   patched /pætʃt/

   adj. 打补丁的 v. 打补丁；遮盖（视力好的眼）促进弱视眼看；（用补丁对程序）改错（patch 的过去式和过去分词）

3. an entire contiguous Ethernet packet 一个完整连续的以太网包

4. byte-aligned memory address 字节内存地址

   aligned [əˈlaɪnd]

   22. 结盟；支持；使成一直线；校准；安放，排列；使一致（align 的过去式和过去分词）

5. prior [ˈpraɪər] adj. （时间、顺序等）先前的；优先的

6. indicate vt. 表明；指出；预示；象征

7. prologue /prəʊlɒg/ n. 开场白

8. auxiliary definitions 辅助定义

   auxiliary [ɔːɡˈzɪliəri]

   adj. 辅助的；副的；附加的；（发动机、设备等）备用的

9. static inline 静态内联

10. volatile unsigned int

    volatile [ˈvɒlətaɪl]

    adj. [化学] 挥发性的；不稳定的；爆炸性的；反复无常的

    14. 挥发物；有翅的动物

11. heap n. 信号量

12. explicity and implicity 显性和隐性

    explicitly [ɪkˈsplɪsɪtli]

    adv. 明确地；明白地

    implicitly [ɪmˈplɪsɪtli]

    adv. 含蓄地；暗中地

13. assertion check 断言检查

    assertion [əˈsɜːʃn]

    14. 断言，声明；主张，要求；坚持；认定

    assert

    internal asserts

14. wrapper function 包装函数

15. name mangling （函数）命名重整

    mangle /mæŋgl/

    vt. 乱砍、损坏

    The process of encoding the signature into the link name is referred to as name mangling. 对链接名称解码签名的过程被称为命名重整。

    Since function overloading is accomplished through name mangling, function overloading has limitations for functions that are called from the configuration. 由于函数重载是通过命名重整完成的，因此函数重载对从配置中调用的函数有限制。

16. periodic /periɒdik/ adj. 周期的

    period n. 周期

17. instantiation of clock 时钟实例化

18. advancing the connected timer by one second 将连接的时钟向前推进1秒

    advance at different rates 以不同的速率前进

19. the attached clock 附带的时钟

20. results in an accurate clock 产生了（导致、致使）一个精确的时钟

21. constructor n. 构造函数；构造器；建造者

22. destructor n. 析构函数

23. millenium n. 千年；千禧年

24. leap year 闰年

25. millisecond [ˈmɪlisekənd] n. 毫秒；千分之一秒

    microsecond 微秒

26. semaphore [ˈseməfɔːr] n. 信号标，旗语；臂板信号装置 v. 打旗语，发信号

27. diagnostics n. 诊断学（用作单数）

28. declaration /,deklə'reiʃən/ n. （纳税品等的）申报；宣布；公告；申诉书；声明；

29. prefix n. 前缀 vt. 加前缀；将某事物加在前面

30. assembly source 汇编源代码

    assembly code 汇编码

31. toggle split editor 切换分屏编辑器

    toggle [ˈtɒɡl]

    14. 拴扣；切换键，开关；套索钉

    15. 切换；拴牢，系紧

    split [splɪt]

    vt. 分离；使分离；劈开；离开；分解

    6. 离开；被劈开；断绝关系

    14. 劈开；裂缝 adj. 劈开的

    toggle full screen 切换全屏幕

    toggle funciton

32. perspective n. 观点；远景；透视图 adj. 透视的

    customize perspective

33. energia [e'nə:dʒiə] n. (Energia) 能源（火箭名）

    energia sketch 能源草图？

34. specifications for benchmark tests 基准测试规范

    specification

    ​ a detailed description of design criteria for a piece of work

    ​ n. 规范

    benchmark

    ​ a standard by which something can be measured or judged

    ​ n. 参考标准，基准

35. target-specific functions 目标特定的功能

    device-specific functions 设备特定的功能

36. implementation of the IGateProvider interface IGateProvider 接口的实现

    implement

    ​ apply in a manner consistent with its purpose or design

    ​ v. 实现

37. fixed-size buffers 固定大小缓冲

    fixed

    ​ adj. 固定的

    variable-sized buffers 可变大小缓冲

38. dynamic memory allocation and deallocation 动态内存分配和回收

39. reentrant versions 可重入版本

    SYS/BIOS provides reentrant versions of malloc() and free() that internally use the xdc.runtime.

    SYS/BIOS为内部使用XDC.RUNTIME的 malloc() 和 free() 提供了可重入版本。

40. formal parameter 形式参数

    C++ allows you to specify default values for formal parameters within the function declaration.

    C++允许你在函数声明中指定形参的默认值。

41. invoke the class member function 调用类成员函数

    By writing a wrapper function which accepts a class instance as a parameter, you can invoke the class member function from within the wrapper. 通过编写以类实例作为参数的包装函数，你可以在包装函数中调用其类成员函数。

42. context of a software interrupt 软件中断的上下文

    Memory allocation APIs such as Memory_alloc() and Memory_calloc() cannot be called from within the context of a software interrupt.内存分配接口如A和B不能够在软件中断的上下文中被调用。

43. initial commit message 初始提交消息

    commit [kəˈmɪt]

    ​ vt. 犯罪；把...交托给；指派…作战；使…承担义务；（公开地）表示意见

    ​ vi. 忠于（某个人、机构等）；承诺

    amend last commit 修改上一次提交（的数据）

44. stage changed （确认）暂存（数据）已变化

45. device endianness 设备字节顺序

46. preempt 抢占

    All Clock functions run at the same Swi priority, so one Clock function cannot preempt another. 所有的时钟函数都运行在相同的SWI优先级，所以一个时钟函数不能抢占另一个时钟函数。

47. terminate /ˈtɜːmɪneɪt/ vi./vt. 使终止；使结束；解雇

48. Event Combiner 事件组合器

49. optimal isolation 最佳隔离？？？

    As previously stated, the stack has been designed for optimal isolation, and so that it may seamlessly plug in to varying run-time environments.

50. octet /ɔk'tet/ 八重、八位（计算机语境下，基本与byte同意）

51. configuration entry 配置条目

52. is independent of 独立于……；相对于……独立

53. Parsing CGI Form Data 解析CGI结构的数据

    parse /'pɑːz/ v.理解，从语法上分析

Reference

www.digoboy.com

PART 1: HTML

Hyper Text Markup Language超文本标记语言

HTML框架

1
2
3
4
5
6
7
8
9

<!DOCTYPE html>	
<html long="en">
		<head>
			<title>TAG</title>
			<meta charset="UTF-8">
		</head>
		<body>
		</body>
	</html>

常用标签

基础标签

1
2
3
4
5
6
7
8
9
10
11
12
13

<!DOCTYPE html>	
<html long="zh">
		<head>
			<title>网页标题</title>
			<meta charset="UTF-8">
		</head>
		<body>
            <h1>内容标题</h1><hr><!--此处添加水平线-->
            <p>
                此处为<br>段落内容
            </p>
		</body>
	</html>

格式标签

表单标签

多媒体标签

图像标签

<img>

作用：向网页中嵌入一张图片

应用：<img src="url" alt="图片加载不出来时的代替文本" title="鼠标放到图片上的介绍文本">

Note:绝对路径用“”;相对路径用“/”

视频标签

音频标签

超链接标签

<a>

作用：超链接

应用：<a href="链接地址" target="_blank">连接描述</a>（内部、外部链接）

​ <a href="#">链接描述</a>（空链接）

​ <a href="文件地址、压缩包地址">下载文件</a>（文本、图片、视频、音频等均可以为超链接）

​ <a href="#age">年龄</a>

​ <h3 id="age">年龄详情</h3>(锚点链接)

Note:

• 默认为_self(当前窗口打开)
• _blank(新窗口中打开)
• ​ _top(整个窗口中打开)

列表标签

Note:

• <ul><ol>里面只能放<li>标签，<li>标签里面可以放弃他标签

• <dd>中的内容是<dt>中内容的说明或是包含于<dd>内容

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27

  <!DOCTYPE html> <html long="en"> <head> <meta charset="UTF-8"> <title>列表</title> </head> <body> <div> <ul> <li>洗衣机</li> <li>冰箱</li> <li>空调</li> </ul> <ol> <li>太阳</li> <li>地球</li> <li>西安</li> </ol> <dl> <dt>跨栏</dt> <dd>是一项运动</dd> <dd>奥运会项目</dd> <dd>刘翔是冠军</dd> </dl> </div> </body> </html>

表格标签

Note:

• 合并单元格时，选定操作目标单元格后，需要删掉被合并单元格的代码。

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43

  <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>表格</title> </head> <body> <table border="1"> <thead> <tr> <th>序号</th> <th>姓名</th> <td>年龄</td> </tr> </thead> <tbody> <tr> <td>1</td> <td>张佳佳</td> <td>24</td> </tr> <tr> <td>2</td> <td>张亮亮</td> <td>33</td> </tr> <tr> <td rowspan="2">3</td> <td>张盼盼</td> <td>22</td> </tr> <tr> <td>张志荣</td> <td>63</td> </tr> <tr> <td>4</td> <td colspan="2"></td> </tr> </tbody> </table> </body> </html>

高级HTML知识

网站图标设置

favicon

<link rel="shortcut icon" href="favicon.ico">

头部标签设置

TDK三大标签及SEO优化

TDK三大标签即title、description、keyword；SEO即Search Engine Optimization，即搜索引擎优化。

Title

<title>blablabla...</title>

Description

<meta name="description" content="blablablabla..." />

Keyword

<meta name="keyword" content="blablabla...">

PART 2: CSS

WebKit浏览器：

基于WebKit Core的浏览器。

WebKit是一种用来让网页浏览器绘制网页的排版引擎。它被用于Apple Safari。其分支Blink被用于基于Chromium的网页浏览器，如Opera与Google Chrome。

Webkit亦使用于Apple iOS、BlackBerry Tablet OS、Tizen及Amazon Kindle的默认浏览器。WebKit的C++应用程序接口提供了一系列的Class以在视窗上显示网页内容，并且实现了一些浏览器的特色，如用户链接点击、管理前后页面列表及近期历史页面等等。

WebKit的HTML及JavaScript代码源自KDE的KHTML及KJS库的一个分支[3]，现已由KDE、Apple、Google、Nokia、Bitstream、BlackBerry及Igalia等独立开发[4]。OS X、Windows、GNU/Linux以及其他类Unix系统操作系统，皆支持这个项目[5]。2013年4月3日，Google宣布它创建了WebKit中WebCore组件的分支——Blink，Blink用于新版Google Chrome与Opera[6][7]。

WebKit的WebCore及JavaScriptCore组件使用GNU宽通用公共许可证，其他组件则采用BSD许可证[8]。

截至2013年3月7日，Webkit商标已被苹果公司在美国专利及商标局注册为其商标。[9]

——Wikipedia

CSS是层叠样式表（Cascading Style Sheets）标记语言，主要用来设置文本的内容（大小、字体、对齐方式等）、图片的外形等等。

CSS语法规范：由 选择器 以及 一条或多条声明 两个主要的部分构成。

书写方式： 选择器: { 属性值; }

CSS基础知识

1. CSS 类命名规则

公共命名规则

其他DIV命名规则

　　登录条:loginBar

　　标志:logo

　　侧栏:sideBar

　　广告:banner

　　导航:nav

　　子导航:subNav

　　菜单:menu

　　子菜单:subMenu

　　搜索:search

　　滚动:scroll

　　页面主体:main

　　内容:content

　　标签页:tab

　　文章列表:list

　　提示信息:msg

　　小技巧:tips

　　栏目标题:title

　　友情链接:friendLink

　　页脚:footer

　　加入:joinus

　　指南:guild

　　服务:service

　　热点:hot

　　新闻:news

　　下载:download

　　注册:regsiter

　　状态:status

　　按钮:btn

　　投票:vote

　　合作伙伴:partner

　　版权:copyRight

2. 选择器

基础选择器

选择器按作用大小（从小到大）分为 ID选择器(使用井字符做特殊标注：#) 、类选择器（使用英文点号做特殊标注：.） 、 标签选择器 及 通配符选择器（使用英文星号做特殊标注：*）。

CCS 选择器的作用：选择器是为了选定标签，声明对象设置具体样式

复合选择器

并集选择器

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

<!DOCTYPE HTML>
<!--
如要求将下方熊大、熊二及佩奇一家都改为粉色，则按照<style>中的方式进行书写
-->
<html>
    <head>
        <style>
            //在两个没有从属关系（子代或后代）和相同特点（如同类标签）的同级不同类标签中，定义一个相同的样式
            div,
            p,
            .pig li {                //类选择器
                color: pink;
            }
        </style>
    </head>
    <body>
        <div>熊大</div>
        <p>熊二</p>
        <span>关头强</span>
        <ul class="pig">
            <li>PIG 1</li>
            <li>PIG 2</li>
            <li>PIG 3</li>
        </ul>
    </body>
</html>

链接伪类选择器

四个使用方式: link / visited / hover / active

1. 为了确保生效，应按照LVHA的顺序进行声明。
2. <a> 链接在浏览器中具有默认样式，不会因为在<body>中而随之改变，实际工作中需要给链接单独指定样式。
3. 使用时，加上冒号 : 与 四种状态之一 即可

举例：

1
2
3
4

a:hover
{ 
	background-color:yellow;
}

当鼠标经过父级元素时，显示子元素的遮罩层：

1
2
3

.tudou:hover .mask {
	display: block;      /* 显示遮罩层 */
}

最小盒子：即只能存放文字了，不能再存放其他标签/元素，如 <p>、<h1>等文字块级标签；

结构伪类选择器

nth-child()在执行时会先把所有子元素都进行排序，先看nth-child()括号中的数字，再匹配前方的标签是否与实际标签一致，如果不一致则不执行。

nth-of-type()在执行时会先把指定类型的子元素都进行排序，先看nth-of-type()括号中的数字，再匹配查找到具体的标签。

CSS中使用伪类选择器，根据结构顺序精确选择标签：

1
2
3
4
5
6
7
8
9

ul li:first-child {
  color: white;
}
ul li:last-child {
  color: green;
}
ul li:nth-chile(3) {
  color: yellow;
}

HTML结构如下：

1
2
3
4
5
6
7
8

<ul>
  <li>1</li>
  <li>2</li>
  <li>3</li>
  <li>4</li>
  <li>5</li>
  <li>6</li>
</ul>

自增长序列，n是从0开始的，按照公式从0开始计算，所得结果为选择器选择的行数。

元素显示模式

是指在页面上的元素以 块状模式 、 行内模式 或 行内块模式 进行显示。元素按显示模式可以分为 块状（级）元素 及 行内元素（内联元素） 及 行内块元素 三种类型。

元素显示模式的转换

即一个模式的元素需要另一个模式的特性，可以通过在CSS的标签样式属性中添加display语句进行转换。

转换为块级元素： display: block;

转换为行内元素： display: inline;

转换为行内块元素： display: inline-block;

选择器特性

层叠性、继承性、优先性

层叠性

样式冲突，就近原则

继承性

子标签会继承父标签的某些样式

子元素可以继承父元素的样式（text-，font-，line-这些元素开头的可以继承，以及color属性

1
2
3
4
5
6
7
8
9
10
11
12
13
14

<style>
    body{
        color:pink;
        font:25px/1.5 'Microsoft YaHei';
    }
    div{
        font:14px;
    }
/*此时div会继承body中1.5倍的行高，此时div中的行高就是14*1.5=21px*/
    行高可以跟单位也可以不跟单位
    如果子元素没有设置行高，则会继承父元素行高为1.5
    此时子元素的行高是：当前子元素的文字大小*1.5
    body行高1.5这样写法最大的优势就是里面子元素可以根据自己文字大小自动调整行高
</style>

优先性（权重）

选择器的加权结果并非二进制，而是在各个数位上进行单独相加，例如元素选择器与类选择器的加权结果为 0,0,1,1，左侧数位的数值越大，权重越高。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

	<style>
		div {
			color: red;
		}
		.colour {
			color: green;
		}
		#demo {
			color: burlywood;
		}
		p {
			color: #008000;
		}
	</style>
<body>
	<div class="colour" id="demo" style="color: #4682B4;">
		不爱绿色爱蓝色
		<p>
			继承的权重为0
		</p>
/*此时p是继承不到父级的设定* 所以看标签到底执行哪个样式，就先看这个标签有没有直接被选出来/
	</div>

3. List

list-style CSS 属性是一个简写对属性集合，包括list-style-type, list-style-image, 和 list-style-position。

list-style: none | circle | square inside ;表示<ul> 下 <li> 前的小点样式，如“无、圆圈、实心方形”。

例如：

1
2
3
4
5
6
7
8
9
10
11

<ul class="one">
  <li>List Item1</li>
  <li>List Item2</li>
  <li>List Item3</li>
</ul>
List 2
<ul class="two">
  <li>List Item A</li>
  <li>List Item B</li>
  <li>List Item C</li>
</ul>

及

1
2
3
4
5
6
7

.one {
  list-style: circle;
}

.two {
  list-style: square inside;
}

4. Background

background-color 可以设置为 transparent，即透明的，不可视的。

background-image 可以设置为 none，也可以跟上一个 url() 链接。如：background-image: url(http://xxxxxx.com/123.jpg)

background-repeat: repeat | no-repea | repeat-x | repeat-y ，分别是指 重复（平铺）、不平铺、在x轴上平铺 及 在y轴上平铺 。

background-position: top | bottom | left | right | center; 除了可以使用类似于左侧的方位词定位，还可以使用坐标轴数值定位。

background: [image] [repeat] [position]; 是复合写法，repeat 和 position 可省略，image 不可省略。

5. Font

FONT-FAMILY 字体族

通用属性之一，用于设置网页显示字体，font-family的使用方式为 font-family=" " ，双引号内可以书写多个字体，引擎会按顺序搜索本地字体并使用，如果都没有则使用本地字体。

注意：建议使用字体的全英文进行书写，如 微软雅黑 全英文为 Microsoft YaHei，英文书写时有空格的应用单引号‘’ 进行包裹。

FONT-SIZE 字体大小

通常用于对body标签内所有正文字体大小的设置，对标题（如h3）大小的设置仍需另起样式。

复合写法

font: font-style font-weight font-size/line-height font-family;

font-size 和 font-family 不可缺省

6. Text

文本属性

7. Box Module

盒子模型主要分三部分：border（边框）、padding（内边距）及 margin（外边距）。

Border

边框主要有一下三种参数：粗细、颜色及样式

• 粗细(border-width: 5px;)
• 颜色(boder-color: #555) （注意：如果这个值没有设置，它的默认值是元素的 color属性值（是文字颜色而非背景色）），可以定义为transparent（透明的）
• 样式(boder-style: none | hidden | dotted | dashed | solid | double(双层线) | groove(内雕刻) | ridge(外浮雕) | inset(内凹陷) | outset(外凹陷) ;)

border属性之可以在中间添加上、下、左、右四个方位词和三参数之一，如 border-top-color | border-bottom-style ....

边框使用时会影响盒子大小，需要注意调整。

复合写法

border: [border-width ||border-style ||border-color |inherit] ;

如：border: 10px solid transparent;

Padding

内边距涉及到的参数包括 上下左右四边的边距。

在未设置内盒子的width时，设置padding对内盒子实际显示大小不起影响，一旦设置width，则会让盒子的width在显示时超过设置参数的大小。

Margin

外边距同内边距。

在标准流下，设置块级盒子width参数后，设置margin左右为auto，可以让盒子实现居中效果。（以下三种写法，推荐第一个，第一个参数表示上下，第二个参数表示左右）

margin: 0 auto;

margin: auto;

margin-left: auto; margin-right: auto;

Q/A

盒子塌陷的解决方案

以下为两个盒子嵌套，同时设置上边距导致塌陷问题的解决方案：

• 可以为父元素定义上边框/上内边距
• 可以为父元素添加 overflow: hidden;
• 利用浮动、固定、绝对定位解决

8. Float

浮动最初的开发目的是让图片和文字产生环绕效果的，浮动可以让多个块级元素在一行内显示。

float: none | left | right;

注意：两个行内块元素中间会有空白间隙存在，如果父级元素设定了宽度，会让元素存放不下。需要给此类行内块元素设定浮动

浮动特性：

• 脱标

• 顶端对齐

• 具有行内块元素特性

外边距合并

外边距合并指的是，当两个垂直外边距相遇时，它们将形成一个外边距。合并后的外边距的高度等于两个发生合并的外边距的高度中的较大者。

注释：只有普通文档流中块框的垂直外边距才会发生外边距合并。行内框、浮动框或绝对定位之间的外边距不会合并。

在标准流中嵌套一个带有外边距的浮动框，不会让他们产生外边距合并。

9. Clean Float

清除浮动也叫闭合浮动，是指在未指定父级元素高度而子级元素为浮动时，会对父级元素同级的标准流造成影响，因而需要清除该类浮动造成的弊端的情况。

清除浮动的四种方式：

:after伪元素代码示例：

1
2
3
4
5
6
7
8
9
10
11

.clearfix:after {
	content: "";
	display: block;
	height: 0;
	clear: both;
	visibility: hidden;
}

.clearfix {       /* IE6、7专有 */
	*zoom: 1;
}

双伪元素代码示例：

1
2
3
4
5
6
7
8
9
10
11
12

.clearfix:before, .clearfix:after{
	content: "";
	display: table;
}

.clearfix:after{
	clear: both;
}

.clearfix{
	*zoom: 1;
}

10. Position

定位的意义

让盒子自由地在某个盒子中移动或固定在屏幕中的某个位置，并且可以压住其他盒子。

注意：对于标准流和浮动，不可以使用定位。

定位模式

position: static | relative | absolute | fixed ;

边偏移

相对于父级盒子（或者有定位的祖辈盒子）的边线偏移量（偏移量可以为负值）。

需要在设置好定位模式后边偏移才能生效。

四种偏移：top、bottom、right、left；

例：top: 10px; right: 20px;

如何将内容固定到版心右侧？

使用固定定位至左侧的50%，在调整margin-left值至版心宽度的一般（直接书写数值px）。

如何让内容固定到屏幕正中心？

使用固定定位至左侧和顶部的50%，再使用margin-left和margin-right的负值来抵消自身宽高的一半。

定位显示优先级

定位显示优先级，即定位叠放顺序，是指 具有定位属性的盒子（类似于PS图层）在Z轴上的显示优先级，数值越大则优先级越高。

如果设置为auto，则按照H5结构书写顺序以“后来居上”的原则显示。

如果设置为数值，则比auto优先级更高，但是不能写单位。

z-index: (number) | auto;

定位的特殊性质

• 给行内元素添加绝对或者固定定位后，可以设置宽度和高度（不等同于与块级元素互换特性？）
• 给块级元素添加绝对或者固定宽度后，不设置宽高也可以则应用内容的大小

11. 显示与隐藏

显示与隐藏的三种方式：display（显示隐藏）、visibility（显示隐藏）、overflow （溢出显示隐藏）