PSoC Creator 组 件 数 据 手 册 定 义 在 此 数 据 表 中 给 出 的 许 多 定 义 符 合 2.1 规 范 在 这 些 情 况 下, 如 需 正 确 了 解 术 语 定 义, 请 参 见 2.1 规 范 的 相 关 章 节 输 入 / 输 出 连 接 本 节 介 绍 从 器

Transcription

1 从 器 件 1.0 特 性 完 全 实 现 2.1 或 2.0 Slave Node( 从 器 件 节 点 ) 符 合 SAE J 规 范 自 动 同 步 波 特 率 完 全 实 现 Diagnostic Class I Slave Node( 诊 断 1 类 从 器 件 节 点 ) 完 全 支 持 传 输 层 自 动 检 测 总 线 闲 置 错 误 检 测 自 动 配 置 服 务 处 理 快 速 及 易 于 配 置 的 自 定 义 程 序 导 入 *.ncf/*.ldf 文 件 和 *.ncf 文 件 导 出 具 有 语 法 检 查 的 *.ncf/*.ldf 文 件 编 辑 器 概 述 从 器 件 组 件 在 PSoC 3 和 PSoC 5 器 件 上 实 现 了 2.1 从 器 件 节 点 此 外, 还 可 以 选 择 使 用 2.0 或 SAE J 合 规 性 规 范 此 组 件 含 有 总 线 通 信 所 必 需 的 硬 件 模 块, 通 过 API 函 数 以 及 应 用 代 码 以 轻 松 地 与 总 线 通 信 进 行 交 互 该 组 件 提 供 的 API 与 2.1 规 范 指 定 的 API 一 致 此 组 件 是 灵 活 性 与 易 于 使 用 的 完 美 组 合 提 供 组 件 自 定 义 程 序, 由 此 可 以 轻 松 配 置 从 器 件 的 所 有 参 数 Cypress Semiconductor Corporation 198 Champion Court San Jose, CA Document Number: Rev. ** Revised May 30, 2012

2 PSoC Creator 组 件 数 据 手 册 定 义 在 此 数 据 表 中 给 出 的 许 多 定 义 符 合 2.1 规 范 在 这 些 情 况 下, 如 需 正 确 了 解 术 语 定 义, 请 参 见 2.1 规 范 的 相 关 章 节 输 入 / 输 出 连 接 本 节 介 绍 从 器 件 的 输 入 和 输 出 连 接 TXD 输 出 这 是 数 字 输 出 终 端 此 终 端 信 号 是 该 节 点 发 送 到 总 线 上 的 数 据 RXD 输 入 这 是 数 字 输 入 终 端 此 终 端 信 号 是 物 理 总 线 上 各 种 CMOS 格 式 的 信 号 注 意 : 此 终 端 通 常 也 接 收 来 自 TXD 终 端 的 所 有 信 号 这 是 因 为 物 理 层 收 发 器 具 有 内 置 回 环, 可 以 接 收 总 线 上 的 所 有 信 号, 无 论 这 些 信 号 是 来 自 其 他 某 些 节 点, 还 是 来 自 本 身 的 节 点 原 理 图 宏 信 息 默 认 情 况 下,PSoC Creator 组 件 目 录 包 含 组 件 的 原 理 图 宏 此 宏 已 经 包 含 连 接 以 及 配 置 的 引 脚 组 件 该 原 理 图 宏 具 有 默 认 组 件 配 置, 如 下 图 所 示 Page 2 of 47 Document Number: Rev. **

3 元 件 参 数 将 从 器 件 组 件 拖 入 设 计 中, 双 击 该 组 件, 打 开 Configure ( 配 置 ) 对 话 框 General( 通 用 ) 选 项 卡 Use Automatic response_error Signal( 使 用 自 动 response_error 信 号 ) 该 选 项 卡 上 的 复 选 框 设 置 自 动 发 送 错 误 信 号 选 项 始 终 选 中 此 复 选 框, 因 此 在 自 定 义 程 序 Signals ( 信 号 ) 选 项 卡 中 自 动 添 加 1 位 信 号 此 信 号 的 默 认 名 称, 即 response_error 无 论 何 时 出 现 错 误 响 应 时, 组 件 均 自 动 设 置 此 信 号 此 外, 成 功 发 送 到 主 机 后, 组 件 还 自 动 清 除 此 信 号 根 据 2.1 规 范, 此 信 号 向 主 机 提 供 错 误 响 应 通 知 2.0 Compatibility( 2.0 兼 容 性 ) 通 过 此 选 项 选 择 此 组 件 是 否 与 2.0 规 范 兼 容 此 复 选 框 的 状 态 影 响 自 定 义 程 序 的 其 他 区 域 Enable J Compliance( 实 现 J 合 规 性 ) SAE J 规 范 与 2.x 规 范 类 似 它 对 2.x 要 求 补 充 了 几 点 限 制 然 而, 此 组 件 支 持 几 个 额 外 特 性, 从 而 使 其 与 J 完 全 兼 容 此 复 选 框 的 状 态 影 响 自 定 义 程 序 的 其 他 区 域 Document Number: Rev. ** Page 3 of 47

4 PSoC Creator 组 件 数 据 手 册 Bus Inactivity Timeout Detection( 总 线 闲 置 超 时 检 测 ) 此 选 项 控 制 总 线 闲 置 特 性 及 其 值 的 可 用 性 指 定 总 线 闲 置 时 间 后, 设 置 相 应 的 状 态 位 通 过 l_ifc_ioctl() 函 数 的 L_IOCTL_READ_STATUS 操 作 来 获 取 此 位 的 值 有 关 详 细 信 息, 请 参 见 功 能 说 明 Break Detection Threshold( 中 断 检 测 阀 值 ) 此 选 项 用 于 配 置 从 器 件 节 点 中 断 检 测 阀 值 默 认 值 为 本 地 主 导 从 器 件 位 时 间 的 11 倍 有 关 中 断 检 测 阀 值 选 择 标 准 的 详 细 信 息, 请 参 见 2.1 规 范 第 节 General Toolbar( 通 用 工 具 栏 ) 这 是 General( 通 用 ) 选 项 卡 顶 侧 的 工 具 栏 此 工 具 栏 提 供 文 件 操 作 的 访 问 图 1. General Toolbar( 通 用 工 具 栏 ) Import File( 导 入 文 件 ): 单 击 此 按 钮, 可 以 导 入 描 述 文 件 (LDF) 或 节 点 能 力 文 件 (NCF) 导 入 文 件 配 置 自 定 义 程 序 设 置, 与 NCF/LDF 文 件 现 有 节 点 列 表 中 选 中 的 节 点 配 置 相 互 匹 配 如 果 导 入 文 件 的 语 法 正 确 无 误, 则 显 示 可 用 节 点 列 表 类 似 列 表 如 图 2 所 示 选 择 其 中 一 个 要 导 入 的 可 用 节 点 说 明 图 2. 要 导 入 的 NCF 文 件 的 可 用 节 点 列 表 根 据 节 点 能 力 语 言 规 范 ( 修 订 版 2.1) 和 配 置 语 言 规 范 ( 修 订 版 2.1) 分 别 验 证 *.ncf 和 *.ldf 文 件 的 语 法 Page 4 of 47 Document Number: Rev. **

5 如 果 导 入 文 件 包 含 错 误, 则 显 示 对 话 框 窗 口, 类 似 于 图 3 在 此 情 况 下 有 两 个 选 项 : 使 用 增 强 编 辑 器 工 具 ( 更 多 信 息, 请 参 见 File Text Editor) 编 辑 导 入 文 件 以 更 正 错 误, 或 通 过 单 击 No( 否 ) 按 钮 取 消 导 入 图 3. NCF 文 件 导 入 失 败 Document Number: Rev. ** Page 5 of 47

6 PSoC Creator 组 件 数 据 手 册 选 中 要 导 入 的 节 点, 将 其 导 入 到 自 定 义 程 序 后, 显 示 一 个 对 话 框, 描 述 导 入 结 果 ( 参 见 图 4) 导 入 结 果 包 含 从 器 件 组 件 参 数, 在 导 入 过 程 中, 这 些 参 数 不 受 任 何 影 响 图 4. NCF 文 件 导 入 信 息 Page 6 of 47 Document Number: Rev. **

7 Export File( 导 出 文 件 ): 此 工 具 有 助 于 您 将 组 件 配 置 相 关 信 息 保 存 到 节 点 能 力 文 件 (NCF) 中 图 5. NCF 文 件 导 出 信 息 Document Number: Rev. ** Page 7 of 47

8 PSoC Creator 组 件 数 据 手 册 File Text Editor( 文 件 文 本 编 辑 器 ): 此 工 具 用 于 消 除 编 辑 和 验 证 NCF/LDF 文 件 的 语 法 根 据 节 点 能 力 语 言 规 范 ( 修 订 版 2.1) 来 验 证 *.ncf 文 件 的 语 法 根 据 配 置 语 言 规 范 ( 修 订 版 2.1) 来 验 证 *.ldf 文 件 的 语 法 图 6. 文 件 文 本 编 辑 器 工 具 在 Enhanced Editor Tool( 增 强 编 辑 器 工 具 ) 顶 侧 有 一 个 工 具 栏 ( 参 见 图 7) 图 7. 文 件 文 本 编 辑 器 工 具 栏 New File( 新 建 文 件 ): 创 建 选 定 文 件 类 型 的 新 文 件 Open File( 打 开 文 件 ): 打 开 指 定 的 现 有 文 件 Page 8 of 47 Document Number: Rev. **

9 Save File( 保 存 文 件 ): 将 创 建 完 成 的 文 件 保 存 到 指 定 位 置 Check Syntax( 检 查 语 法 ): 通 过 此 控 制, 可 以 检 查 *.ncf/*.ldf 文 件 的 语 法 是 否 正 确 如 果 有 任 何 语 法 错 误, 则 将 错 误 列 在 编 辑 器 窗 口 输 出 区 域 中, 说 明 所 在 位 置 的 行 数 和 列 数, 包 含 简 要 错 误 描 述 ( 图 8) 包 含 错 误 的 代 码 行 突 出 显 示 为 红 色 在 输 出 区 域, 双 击 错 误 行, 可 以 导 航 至 文 件 中 包 含 错 误 的 行 图 8. 文 件 语 法 检 查 Find( 查 找 ): 通 过 此 工 具, 可 以 查 找 在 文 件 中 搜 索 字 段 中 指 定 的 术 语 Find Next( 查 找 下 一 个 ) 查 找 下 一 个 匹 配 结 果 如 果 选 中 工 具 的 Mark Line( 标 记 行 ) 复 选 框, 则 单 击 Find All( 全 部 查 找 ) 按 钮 后, 包 含 必 要 术 语 的 行 标 有 黄 色 圆 圈 单 击 Find All( 全 部 查 找 ) 按 钮 后,Style found token( 样 式 查 找 结 果 令 牌 ) 复 选 框 启 用 或 禁 用 查 找 结 果 令 牌 的 黄 色 突 出 显 示 功 能, 如 图 9 所 示 Clear( 清 除 ) 按 钮 删 除 所 有 突 出 显 示 的 令 牌 Document Number: Rev. ** Page 9 of 47

10 PSoC Creator 组 件 数 据 手 册 图 9. 文 件 查 找 结 果 此 外, 在 增 强 编 辑 器 工 具 的 File( 文 件 ) 菜 单 ( 参 见 图 6) 及 通 过 相 应 的 工 具 栏 命 令, 可 以 获 得 所 有 工 具 Page 10 of 47 Document Number: Rev. **

11 Baud Rate( 波 特 率 ) 选 项 卡 图 10. Configure ( 配 置 ) 对 话 框 Baud Rate( 波 特 率 ) 选 项 卡 Automatic Baud Rate Synchronization( 自 动 同 步 波 特 率 ) 通 过 此 选 项, 可 以 启 用 或 禁 用 自 动 同 步 波 特 率 功 能 默 认 情 况 下, 此 选 项 处 于 启 用 状 态 如 果 启 用 此 选 项, 则 组 件 测 试 确 切 的 总 线 波 特 率, 从 各 个 帧 头 的 同 步 字 节 字 段 开 始 如 果 禁 用 此 选 项, 则 组 件 不 测 量 从 同 步 字 节 字 段 开 始 的 波 特 率 而 是 接 收 作 为 0x55 数 据 字 节 的 同 步 字 节 字 段 根 据 2.1 规 范 的 要 求, 频 率 偏 差 为 ±1.5 % 或 更 低 的 从 器 件 节 点 不 需 要 使 用 使 用 自 动 同 步 波 特 率 来 测 量 每 个 帧 的 同 步 字 节 字 段 然 而, 如 果 从 器 件 的 频 率 偏 差 大 于 ±1.5 %, 那 么 从 器 件 节 点 必 须 使 用 自 动 同 步 波 特 率 来 测 量 每 个 帧 的 同 步 字 节 字 段 因 此, 需 要 针 对 衍 生 BusClk 的 时 钟 源 检 查 频 率 偏 差 规 范 ( 这 通 常 是 内 部 主 振 荡 器 (IMO)) Nominal Bus Baud Rate( 额 定 总 线 波 特 率 ) 输 入 运 行 此 从 器 件 节 点 的 额 定 总 线 波 特 率 最 大 值 为 波 特, 最 小 值 为 1000 波 特 自 定 义 程 序 禁 止 您 选 择 此 范 围 以 外 的 波 特 率 在 下 拉 列 表 中, 这 些 值 为 和 2400 然 而, 您 可 以 在 组 合 框 中 键 入 介 于 之 间 的 任 意 值 如 果 修 改 Nominal Document Number: Rev. ** Page 11 of 47

12 PSoC Creator 组 件 数 据 手 册 Bus Baud Rate( 额 定 总 线 波 特 率 ), 则 按 Apply( 应 用 ) 按 钮 获 取 适 合 于 Source Clock Frequency( 源 时 钟 频 率 ) Source Clock Divider( 源 时 钟 分 频 器 ) 和 Actual Bus Baud Rate( 实 际 总 线 波 特 率 ) 字 段 的 新 值 Source Clock Frequency( 源 时 钟 频 率 ) 这 是 时 钟 频 率, 重 复 采 样 数 为 8, 可 用 于 数 据 传 输 Source Clock Divider( 源 时 钟 分 频 器 ) 这 是 时 钟 分 频 器 的 值, 用 来 从 BusClk 中 获 取 在 Source Clock Frequency( 源 时 钟 频 率 ) 中 指 定 的 时 钟 频 率 Actual Bus Baud Rate( 实 际 总 线 波 特 率 ) 此 处 显 示 总 线 波 特 率 的 实 际 值 从 器 件 将 在 此 波 特 率 下 工 作 可 以 修 改 BusClk 的 值, 从 而 使 Nominal Bus Baud Rate( 额 定 总 线 波 特 率 ) 等 于 Actual Bus Baud Rate( 实 际 总 线 波 特 率 ) Frames( 帧 ) 选 项 卡 此 选 项 卡 用 来 配 置 从 器 件 如 何 响 应 由 总 线 上 的 主 控 发 送 的 PID 值 在 此 选 项 卡 上 配 置 的 设 置 用 于 正 确 生 成 组 件 API 和 ISR 代 码 操 作 期 间, 从 器 件 接 收 PID ( 其 中 内 嵌 帧 ID), 用 来 确 定 从 器 件 ( 组 件 ) 的 响 应 方 法 Page 12 of 47 Document Number: Rev. **

13 图 11. Configure ( 配 置 ) 对 话 框 Frames( 帧 ) 选 项 卡 帧 配 置 表 该 配 置 表 位 于 此 选 项 卡 中 间 该 表 包 含 行 和 列 每 一 行 对 应 一 个 帧 注 意 : 此 选 项 卡 仅 显 示 用 户 帧 MRF 和 SRF 帧 由 此 组 件 来 支 持, 但 在 此 表 中 不 显 示 在 数 据 字 段 中 可 能 共 有 8 个 列 在 Index( 索 引 ) 列 中 的 字 段 显 示 每 个 使 用 帧 的 排 序 编 号 无 法 直 接 修 改 这 些 编 号 在 Name( 名 称 ) 列 中 的 字 段 用 于 输 入 每 个 帧 的 名 称 可 以 输 入 C 代 码 中 有 效 的 任 何 字 符 串 每 个 帧 的 名 称 必 须 是 唯 一 的 在 Default ID( 默 认 ID) 列 中 的 字 段 用 于 定 义 帧 ID, 这 是 帧 在 主 控 请 求 任 意 配 置 之 前 使 用 的 帧 ID 注 意 : 这 些 帧 ID 均 是 动 态 的 换 言 之, 主 控 可 以 在 运 行 时 重 新 配 置 帧 ID 在 这 些 单 元 格 中, 必 须 输 入 0x00-0x3B 之 间 的 值 可 以 输 入 十 六 进 制 或 十 进 制 格 式 的 值 Message ID( 消 息 ID) 列 不 在 图 11 中 显 示 这 是 因 为 该 列 通 常 是 不 可 见 的 列 只 有 在 选 中 自 定 义 程 序 的 General( 一 般 ) 选 项 卡 中 的 2.0 Compatibility( 2.0 兼 容 性 ) 复 选 框 时, 此 列 才 可 以 显 示 可 以 输 入 任 意 16 位 值 可 以 输 入 十 六 进 制 或 十 进 制 格 式 的 值 所 有 消 息 ID 的 值 均 是 唯 一 的 此 外, 输 入 到 此 表 中 的 消 息 ID 的 值 应 在 整 个 集 群 中 是 唯 一 的 例 如, 如 果 其 他 某 些 从 器 件 有 一 个 帧, 其 中 包 含 消 息 ID 0x000F, 则 组 件 不 再 有 任 何 包 含 消 息 ID 0x000F 的 帧 在 Direction( 方 向 ) 列 中 的 字 段 定 义 发 送 帧 数 据 的 方 向 ( 相 关 于 此 从 器 件 ) Publish( 发 布 ) 表 示 数 据 传 输 ;Subscribe( 订 阅 ) 表 示 数 据 接 收 Document Number: Rev. ** Page 13 of 47

14 PSoC Creator 组 件 数 据 手 册 在 Length( 长 度 ) 列 中 的 字 段 定 义 每 个 帧 所 接 收 和 发 送 的 字 节 数 1-8 之 间 ( 包 含 1 与 8) 的 值 有 效 在 Type( 类 型 ) 列 中 的 字 段 用 来 定 义 帧 的 类 型 从 器 件 有 两 种 帧 类 型 : 无 条 件 和 触 发 事 件 类 型 当 帧 为 订 阅 帧 时, 无 法 选 择 触 发 事 件 类 型 在 此 情 况 下, 无 法 修 改 此 单 元 格 如 果 将 此 单 元 格 从 触 发 事 件 更 改 为 无 条 件 类 型, 则 必 须 在 Association( 关 联 性 ) 列 中 将 此 帧 的 名 称 更 改 为, 这 里 假 设 其 名 称 在 该 列 的 任 意 单 元 格 中 显 示 在 Association( 关 联 性 ) 列 中 的 字 段 用 于 关 联 无 条 件 帧 与 触 发 事 件 类 型 的 帧 根 据 规 范, 触 发 事 件 类 型 的 帧 至 少 要 有 一 个 与 其 关 联 的 无 条 件 类 型 的 帧 因 此, 通 过 Association( 关 联 性 ) 设 置, 可 以 选 择 与 触 发 事 件 类 型 的 帧 无 关 的 任 意 无 条 件 类 型 的 帧 的 名 称 此 设 置 的 有 效 值 是 任 意 现 有 的 无 关 联 及 无 条 件 类 型 的 帧 的 名 称 只 有 一 个 无 条 件 类 型 的 帧 可 以 与 触 发 事 件 类 型 的 帧 相 互 关 联 因 此, 当 其 中 一 个 单 元 格 包 含 无 条 件 类 型 的 帧 的 名 称 时, 此 无 条 件 类 型 的 帧 的 名 称 无 法 用 于 其 他 任 意 行 如 果 触 发 事 件 类 型 的 帧 与 无 条 件 类 型 的 帧 相 互 关 联, 则 二 者 的 长 度 和 方 向 必 须 相 同 因 此, 触 发 事 件 类 型 的 帧 的 名 称 仅 在 适 用 这 些 条 件 的 无 条 件 类 型 的 帧 的 行 中 显 示 如 果 单 击 自 定 义 程 序 的 全 局 OK( 确 定 ) 按 钮, 或 通 过 单 击 另 一 个 选 项 卡 退 出 此 选 项 卡, 则 自 定 义 程 序 执 行 检 查, 以 确 保 不 再 有 与 任 意 无 条 件 类 型 的 帧 关 联 的 触 发 事 件 类 型 的 帧 注 意 : 帧 部 数 不 能 超 过 60 所 有 帧 的 总 计 大 小 限 定 为 256 个 字 节 选 项 卡 按 钮 在 此 选 项 卡 上 共 有 4 个 按 钮 Add( 添 加 ) 按 钮 添 加 新 帧 到 表 中 Delete( 删 除 ) 按 钮 从 表 中 删 除 当 前 选 中 的 帧 相 应 地 更 改 索 引 编 号 字 段 如 果 在 此 选 项 卡 上 删 除 一 个 帧, 则 压 缩 到 其 中 的 任 意 信 号 ( 使 用 Signals( 信 号 ) 选 项 卡 配 置 ) 均 被 移 至 未 安 置 信 号 区 域 ( 参 见 Signals( 信 号 ) 选 项 卡 部 分 中 的 Sort Signals( 排 序 信 号 ) 按 钮 ) 您 可 以 使 用 Up( 上 箭 头 ) 和 Down( 下 箭 头 ) 按 钮 给 每 个 帧 的 索 引 重 新 排 序 编 号 Page 14 of 47 Document Number: Rev. **

15 Signals( 信 号 ) 选 项 卡 在 自 定 义 程 序 中, 此 选 项 卡 用 于 定 义 压 缩 到 帧 中 的 信 号 图 12. Configure ( 配 置 ) 对 话 框 Signals( 信 号 ) 选 项 卡 Frames & Signals relations( 帧 与 信 号 关 联 性 ) 此 Signals( 信 号 ) 选 项 卡 的 图 形 区 域 用 来 显 示 您 使 用 自 定 义 程 序 定 义 的 帧 与 信 号 之 间 交 互 式 图 形 Frame Graphics( 帧 图 形 ): 一 个 帧 图 形 代 表 在 自 定 义 程 序 Frames( 帧 ) 选 项 卡 中 定 义 的 各 个 帧 Signal Graphics( 信 号 图 形 ): 各 个 信 号 图 形 代 表 为 从 器 件 定 义 的 相 应 信 号 信 号 图 形 显 示 为 白 色 状 态 栏 ( 参 见 图 12) 通 过 拖 放 操 作, 可 以 将 信 号 放 置 在 帧 顶 部 这 些 信 号 占 据 帧 的 位 或 字 节 在 信 号 上 单 击, 选 中 该 信 号 延 期 信 号 导 致 在 工 具 提 示 中 显 示 有 关 该 信 号 的 相 关 信 息 Document Number: Rev. ** Page 15 of 47

16 PSoC Creator 组 件 数 据 手 册 Unplaced Signals( 未 安 置 信 号 ) 此 图 形 区 域 是 添 加 信 号 后 临 时 存 储 这 些 信 号 的 区 域, 尚 未 放 置 信 号 信 号 可 以 在 Unplaced Signals ( 未 放 置 信 号 ) 区 域 与 Frames & Signals relations( 帧 与 信 号 关 联 性 ) 区 域 之 间 来 回 移 动 注 意 : 如 果 在 Frames( 帧 ) 选 项 卡 上 删 除 一 个 帧, 则 压 缩 到 其 中 的 任 意 信 号 ( 使 用 Signals( 信 号 ) 选 项 卡 配 置 ) 均 被 移 至 Unplaced Signals( 未 安 置 信 号 ) 区 域 response_error 1 位 response_error 信 号 自 动 添 加 在 自 定 义 程 序 的 Signals( 信 号 ) 选 项 卡 中 可 以 更 改 response_error 信 号 的 名 称, 但 却 无 法 从 Signals( 信 号 ) 选 项 卡 中 删 除 该 名 称 仅 允 许 有 一 个 response_error 信 号 实 例, 其 名 称 对 此 组 件 而 言 必 须 是 唯 一 的 response_error 信 号 是 布 尔 型 信 号, 可 以 放 置 在 由 从 器 件 发 布 的 帧 上 的 任 意 位 置 此 信 号 的 目 的 是 向 主 控 报 告 状 态 信 息 有 关 此 信 号 的 其 他 信 息, 请 参 见 2.1 规 范 第 节 向 集 群 报 告 信 号 工 具 栏 这 是 Signals( 信 号 ) 选 项 卡 顶 部 上 的 工 具 栏 此 工 具 栏 提 供 管 理 选 项 卡 上 各 个 信 号 的 简 易 方 法 图 13. 信 号 工 具 栏 1. Add/Delete( 添 加 / 删 除 ) 按 钮 该 Add Signal( 添 加 信 号 ) 按 钮 添 加 信 号 到 Unplaced Signals( 未 安 置 信 号 ) 区 域 Delete Signal( 删 除 信 号 ) 按 钮 删 除 从 组 件 中 选 择 的 信 号 Delete All Signals( 删 除 所 有 信 号 ) 按 钮 删 除 全 部 现 有 信 号 2. Signal Properties( 信 号 属 性 ) 按 钮 此 控 制 打 开 选 中 信 号 的 Signal Properties( 信 号 属 性 ) 窗 口 此 窗 口 可 以 用 于 更 改 信 号 属 性 注 意 : 信 号 属 性 窗 口 还 可 以 通 过 双 击 信 号 来 访 问 3. Find Signal( 查 找 信 号 ) 按 钮 通 过 此 按 钮, 可 以 搜 索 某 个 信 号 4. Sort Signals( 排 序 信 号 ) 按 钮 此 按 钮 用 于 排 序 Unplaced Signals( 未 安 置 信 号 ) 区 域 中 的 所 有 信 号 可 以 按 名 称 长 度 或 类 型 来 排 序 信 号 Page 16 of 47 Document Number: Rev. **

17 5. Renumber Signals( 重 新 编 号 信 号 ) 按 钮 此 按 钮 用 于 以 升 序 方 式 重 新 编 号 信 号 索 引 值 6. Move( 移 动 ) 按 钮 Unplace Signal( 未 安 置 信 号 ) 按 钮 可 以 将 所 选 信 号 从 Frames & Signals relations( 帧 和 信 号 关 联 性 ) 区 域 移 至 Unplaced Signals( 未 安 置 信 号 ) 区 域 该 Unplace All Signals( 未 安 置 信 号 ) 按 钮 可 以 将 所 有 信 号 移 至 Unplaced Signals( 未 安 置 信 号 ) 区 域 7. Show/Hide Event-triggered frames( 显 示 / 隐 藏 触 发 事 件 类 型 的 帧 ) 按 钮 通 过 此 按 钮, 可 以 显 示 或 隐 藏 帧 图 形, 其 对 应 于 Frames & Signals relations( 帧 和 信 号 关 联 性 ) 区 域 中 的 触 发 事 件 类 型 的 帧 8. Show/Hide Legend( 显 示 / 隐 藏 图 例 ) 按 钮 通 过 此 按 钮, 可 以 显 示 或 隐 藏 描 述 信 号 属 性 的 图 例 区 域 9. Signals Transparency( 信 号 透 明 度 ) 滑 条 此 滑 条 用 于 设 置 信 号 图 形 的 透 明 度 10. Print( 打 印 ) 按 钮 这 些 按 钮 用 于 打 印 输 出 Frames & Signals relations( 帧 与 信 号 关 联 性 ) 区 域 Signal Properties( 信 号 属 性 ) 窗 口 Adding Signals( 添 加 信 号 ) 在 工 具 栏 有 一 个 Add Signal( 添 加 信 号 ) 按 钮 此 按 钮 可 以 生 成 新 的 窗 口, 用 来 显 示 可 配 置 的 信 号 属 性 选 项 ( 参 见 图 14) 配 置 完 成 各 个 属 性 后, 添 加 新 信 号 在 此 章 节 中 介 绍 可 在 此 窗 口 中 配 置 的 各 种 信 号 属 性 Document Number: Rev. ** Page 17 of 47

18 PSoC Creator 组 件 数 据 手 册 图 14. Signal Properties( 信 号 属 性 ) 窗 口 Name( 名 称 ) Name( 名 称 ) 属 性 用 于 选 择 信 号 的 名 称 默 认 信 号 名 称 是 Signalx, 其 中, x 等 于 信 号 索 引 编 号 输 入 的 信 号 名 称 必 须 是 C 代 码 中 有 效 的 符 号 名 称 Type( 类 型 ) 此 属 性 用 于 选 择 信 号 类 型 根 据 2.1 规 范 共 定 义 两 种 信 号 类 型 一 个 标 量 信 号 长 度 是 1-16 位, 而 ByteArray 信 号 的 长 度 为 1-8 个 字 节 Length( 长 度 ) 此 属 性 用 于 选 择 信 号 长 度 标 量 信 号 长 度 为 1-16 位 ByteArray 信 号 的 长 度 为 1-8 个 字 节 Initial Value( 初 始 值 ) 此 属 性 用 于 选 择 信 号 的 初 始 值 此 值 必 须 以 十 进 制 格 式 输 入 Fill Color( 填 充 颜 色 ) 此 控 制 用 于 选 择 信 号 图 形 的 颜 色 Page 18 of 47 Document Number: Rev. **

19 Signal Description( 信 号 描 述 ) 此 属 性 用 于 输 入 任 何 相 关 描 述 或 有 关 信 号 的 其 他 信 息 Preview( 预 览 ) 此 图 形 区 域 显 示 添 加 信 号 时 信 号 的 外 观 Transport Layer( 传 输 层 ) 选 项 卡 Transport Layer( 传 输 层 ) 选 项 卡 视 图 如 图 15 所 示 图 15. Configure ( 配 置 ) 对 话 框 Transport Layer( 传 输 层 ) 选 项 卡 Use Transport Layer( 使 用 传 输 层 ) 如 果 未 选 中 Use Transport Layer( 使 用 传 输 层 ) 复 选 框, 从 器 件 节 点 将 不 支 持 传 输 层 如 果 选 中, 则 从 器 件 节 点 组 件 将 支 持 传 输 层 有 关 传 输 层 的 详 细 信 息, 请 参 见 2.1 规 范 Document Number: Rev. ** Page 19 of 47

20 PSoC Creator 组 件 数 据 手 册 API Format Selection(API 格 式 选 项 ) 此 控 制 用 于 选 择 传 输 层 API 功 能 的 格 式 选 项 有 Cooked Transport Layer API( 成 熟 传 输 层 API) 和 Raw Transport Layer API( 原 始 传 输 层 API) 通 常, 建 议 为 从 器 件 应 用 选 择 成 熟 格 式 成 熟 格 式 用 于 发 送 和 接 收 传 输 层 消 息, 而 每 条 消 息 仅 使 用 一 个 API 功 能 原 始 格 式 用 来 发 送 和 接 收 组 织 传 输 层 消 息 的 各 个 帧, 并 使 用 为 每 个 帧 调 用 的 一 个 API 功 能 2.1 规 范 第 7.4 节 定 义 了 传 输 层 API 的 这 两 种 格 式 Initial NAD( 初 始 NAD) 此 字 段 用 于 选 择 从 器 件 节 点 的 网 络 地 址 (NAD) NAD 用 于 MRF 和 SRF 帧, 以 便 在 一 个 集 群 中 寻 址 一 个 特 定 的 从 器 件 节 点 注 意 : 此 字 段 用 于 选 择 节 点 的 初 始 NAD 可 以 在 运 行 时 更 改 从 器 件 节 点 的 NAD 默 认 情 况 下, 初 始 NAD 值 的 范 围 是 0x01-0xFF 为 转 到 睡 眠 命 令 保 留 NAD 的 值 0x00 NAD 的 值 0x7E 保 留 为 功 能 NAD, 其 用 于 诊 断 服 务 NAD 的 值 0x7F 保 留 为 通 配 符 NAD 因 此, 自 定 义 程 序 限 制 您 在 此 字 段 中 输 入 0x00 0x7E 或 0x7F 如 果 选 中 J Compliance(J 合 规 性 ) 复 选 框,Transport Layer( 传 输 层 ) 选 项 卡 上 的 Initial NAD( 初 始 NAD) 的 值 限 定 为 0x60-0x6F 默 认 值 为 0x60 根 据 自 定 义 程 序 Frames ( 帧 ) 选 项 卡 上 使 用 的 帧 数, 进 一 步 限 制 初 始 值 有 关 详 细 信 息, 请 参 见 表 1 表 1. 根 据 从 器 件 节 点 中 使 用 的 帧 数 限 制 初 始 NAD 帧 数 可 用 的 初 始 NAD 的 值 1 到 4 0x60 到 0x6F 5 到 8 0x60 0x62 0x64 0x66 0x68 0x6A 0x6C 0x6E 0x6F 9 至 16 0x60 0x64 0x68 0x6E 0x6F 16 以 上 0x6E 0x6F Maximum Message Length( 最 大 消 息 长 度 ) 此 属 性 用 于 选 择 此 从 器 件 节 点 所 支 持 的 传 输 层 消 息 的 最 大 长 度 最 小 值 为 6, 因 为 在 消 息 中, 最 多 有 6 个 传 输 层 消 息 数 据 字 节 共 同 占 用 一 个 帧 此 组 件 仅 支 持 长 度 高 达 4095 字 节 的 传 输 层 消 息 注 意 : 实 际 的 传 输 层 消 息 缓 冲 区 位 于 节 点 的 应 用 代 码 中 TX 队 列 长 度 / RX 队 列 长 度 只 有 选 中 Raw Transport Layer API( 原 始 传 输 层 API) 格 式 时, 这 些 属 性 才 适 用 使 用 原 始 API 格 式 时, 有 一 条 消 息 队 列, 用 来 缓 冲 当 前 发 送 或 接 收 的 帧 响 应 数 据 如 果 从 器 件 无 法 快 速 更 新 队 列, 那 么 队 列 长 度 将 变 得 越 来 越 长 如 果 从 器 件 可 以 快 速 更 新 队 列, 那 么 队 列 可 以 变 短, Page 20 of 47 Document Number: Rev. **

21 从 而 减 少 RAM 使 用 量 该 组 件 支 持 的 队 列 长 度 为 , 步 长 为 8 字 节 每 个 队 列 的 默 认 大 小 为 32 字 节 Configuration Services( 配 置 服 务 ) 选 项 卡 2.1 规 范 用 来 定 义 从 器 件 必 须 支 持 的 配 置 服 务 请 求 ( 根 据 2.1 规 范, 某 些 为 必 选 项, 而 某 些 为 可 选 项 ) 此 组 件 支 持 所 有 必 选 请 求 和 某 些 可 选 服 务 请 求 共 有 8 项 配 置 服 务 请 求 (0xB0-0xB7) 在 2.1 规 范 的 表 4.6 中 列 出 这 些 服 务 此 组 件 支 持 其 中 某 些 服 务 您 可 以 选 择 禁 用 或 启 用 所 支 持 的 单 个 服 务 在 2.1 规 范 第 节 介 绍 这 些 配 置 服 务 请 求 图 16. Configure ( 配 置 ) 对 话 框 Configuration Services( 配 置 服 务 ) 选 项 卡 配 置 请 求 自 动 处 理 指 定 此 组 件, 以 便 自 动 处 理 配 置 服 务 请 求 换 言 之, 您 不 必 使 用 任 何 API 或 应 用 代 码 来 处 理 自 主 控 的 这 些 服 务 请 求 然 而, 您 可 以 禁 用 此 自 动 处 理, 而 使 用 自 定 义 应 用 代 码 来 处 理 这 些 请 求 要 简 化 此 选 项, 在 此 选 项 卡 上 有 一 个 Automatic Configuration Request Handling( 自 动 处 理 配 置 请 求 ) 复 选 框 如 果 选 中 该 复 选 框, 则 此 选 项 卡 上 的 其 他 所 有 选 项 均 为 启 用 状 态 如 果 未 选 中 该 复 选 框, 则 此 选 项 卡 上 的 其 他 所 有 选 项 均 为 禁 用 状 态 Document Number: Rev. ** Page 21 of 47

22 PSoC Creator 组 件 数 据 手 册 在 此 选 项 卡 上 启 用 的 任 何 服 务 均 由 此 组 件 自 动 处 理 在 总 线 工 作 过 程 中, 无 论 何 时 自 动 处 理 任 何 请 求, 相 应 的 MRF 和 SRF 帧 无 法 通 过 传 输 层 API 获 得 应 用 如 果 未 自 动 处 理 服 务 请 求 ( 即 在 此 选 项 卡 上 未 启 用 服 务 请 求 ), 则 必 须 使 用 传 输 层 API 通 过 应 用 程 序 接 收 或 发 送 配 置 服 务 请 求 所 对 应 的 MRF 和 SRF 帧 配 置 服 务 选 项 在 具 有 复 选 框 的 选 项 卡 上 列 出 各 个 支 持 的 配 置 服 务 请 求 您 可 以 选 择 需 要 自 动 处 理 的 个 别 服 务 请 求 服 务 0xB0 分 配 NAD 这 是 2.1 规 范 中 的 可 选 服 务 这 是 将 新 的 NAD 值 分 配 到 从 器 件 节 点 的 服 务 请 求 由 于 PSoC 器 件 的 高 度 可 编 程 性, 此 组 件 不 可 能 需 要 此 服 务 请 求 PSoC 在 启 动 之 后, 可 以 轻 松 配 置 NAD 到 所 需 的 值, 这 可 能 无 需 主 控 请 求 NAD 更 改 服 务 0xB1 分 配 帧 标 识 符 这 是 2.1 规 范 中 的 过 期 服 务 只 有 在 自 定 义 程 序 的 General( 一 般 ) 选 项 卡 上 选 中 2.0 Compatibility( 2.0 兼 容 性 ) 复 选 框 时, 它 才 处 于 可 用 状 态 此 配 置 服 务 请 求 用 于 更 改 此 从 器 件 节 点 响 应 的 帧 的 ID 值 在 2.1 规 范 中 未 介 绍 此 服 务 只 在 2.0 规 范 第 节 中 对 此 服 务 有 所 介 绍 此 服 务 可 用 于 此 组 件, 以 便 实 现 向 后 兼 容 性 服 务 0xB2 通 过 标 识 符 读 取 根 据 2.1 规 范, 此 配 置 服 务 请 求 是 必 选 选 项 此 请 求 用 来 支 持 主 控 读 取 从 器 件 标 识 信 息 ( 供 应 商 ID 功 能 ID 变 量 ) 该 组 件 仅 支 持 此 请 求 的 产 品 标 识 版 本 服 务 0xB3 有 条 件 更 改 NAD 这 是 2.1 规 范 中 的 可 选 服 务 它 非 常 类 似 于 分 配 NAD 配 置 服 务 其 中, 一 个 主 要 差 异 是 此 服 务 使 用 从 器 件 的 当 前 ( 易 失 性 )NAD, 而 不 使 用 初 始 ( 非 易 失 性 )NAD 发 生 此 请 求 时, 从 器 件 对 从 主 控 接 收 的 数 据 字 节 进 行 某 些 逻 辑 处 理, 如 果 处 理 结 果 为 零, 则 只 更 新 当 前 ( 易 失 性 )NAD 服 务 0xB4 数 据 转 储 此 服 务 请 求 是 2.1 规 范 中 的 可 选 项, 不 由 此 组 件 来 支 持 服 务 0xB5 通 过 SNPD 分 配 NAD 此 服 务 由 2.1 规 范 来 支 持, 但 也 可 以 由 J 规 范 来 支 持 此 组 件 不 支 持 该 服 务 Page 22 of 47 Document Number: Rev. **

23 在 J 规 范 中 定 义 了 目 标 复 位 配 置 (0xB5) 服 务 请 求 因 此, 仅 在 自 定 义 程 序 的 General ( 一 般 ) 选 项 卡 上 选 中 Enable J Compliance( 启 用 J 合 规 性 ) 复 选 框 时,0xB5 服 务 才 可 用 ( 作 为 目 标 复 位 ) 如 果 通 过 此 从 器 件 来 处 理 目 标 复 位 请 求, 则 在 l_ifc_ioctl() 函 数 的 L_IOCTL_READ_STATUS 操 作 中 设 置 标 志, 以 便 让 应 用 程 序 知 道 目 标 复 位 应 予 以 发 生 有 关 详 细 信 息, 请 参 见 功 能 说 明 服 务 0xB6 保 存 配 置 这 是 2.1 规 范 中 的 可 选 服 务 请 求 从 器 件 可 以 将 其 配 置 数 据 (NAD 值 和 PID 值 ) 保 存 在 非 易 失 性 存 储 器 ( 闪 存 ) 中 然 而, 应 用 代 码 必 须 实 现 实 际 闪 存 写 入 操 作 当 此 配 置 服 务 请 求 发 生 时, 在 由 l_ifc_read_status() API 函 数 返 回 的 状 态 下, 设 置 从 器 件 配 置 标 志 这 便 通 知 应 用 程 序 应 将 当 前 从 器 件 节 点 的 配 置 信 息 保 存 到 非 易 失 性 存 储 器 ( 闪 存 ) 中 服 务 0xB7 分 配 帧 标 识 符 范 围 这 是 2.1 规 范 中 的 必 选 配 置 服 务 请 求 通 过 此 服 务, 主 控 可 以 更 改 从 器 件 帧 的 易 失 性 帧 的 PID 值 从 器 件 信 息 如 果 选 中 Automatic Configuration Request Handling( 自 动 处 理 配 置 请 求 ) 复 选 框, 则 3 个 字 段 变 为 可 用 状 态 这 些 字 段 分 别 是 Supplier ID( 供 应 商 ID) Function ID( 功 能 ID) 和 Variant( 变 量 ) 供 应 商 ID 是 16 位 值, 但 其 有 效 范 围 是 0x0000-0x7FFE 功 能 ID 也 为 16 位, 其 有 效 范 围 为 0x0000-0xFFFE 变 量 为 8 位, 其 有 效 范 围 为 0x00-0xFF 这 些 值 用 于 配 置 服 务 请 求, 以 便 区 分 集 群 中 各 个 不 同 的 从 器 件 节 点 因 此, 在 某 些 方 面, 这 些 值 充 当 从 器 件 地 址 类 型 时 钟 选 择 PSoC Creator 计 算 所 需 频 率 和 时 钟 源, 并 生 成 实 现 所 需 的 各 种 资 源 当 禁 用 Automatic Baud Rate Synchronization( 自 动 同 步 波 特 率 ) 选 项 时, 时 钟 容 差 必 须 为 ± 1.5%, 而 未 禁 用 时, 时 钟 容 差 为 ±14% 如 果 在 此 限 制 下 无 法 生 成 时 钟, 则 显 示 一 条 警 告 在 此 情 况 下, 应 修 改 DWR 中 的 主 控 时 钟 源 Document Number: Rev. ** Page 23 of 47

24 PSoC Creator 组 件 数 据 手 册 放 置 组 件 放 置 于 整 个 UDB 阵 列 中, 并 且 所 有 放 置 信 息 通 过 cyfitter.h 文 件 提 供 给 API 仅 有 一 个 组 件 实 例 可 以 放 置 在 各 个 设 计 中 资 源 数 字 模 块 API Memory (API 存 储 器 )( 字 节 ) 模 式 数 据 路 径 单 元 PLD 状 态 单 元 Control/Count7 单 元 Flash ( 闪 存 ) RAM 引 脚 _Slave_Exa mple 项 目 Page 24 of 47 Document Number: Rev. **

25 应 用 程 序 编 程 接 口 应 用 程 序 编 程 接 口 (API) 子 程 序 允 许 您 使 用 软 件 配 置 组 件 下 表 列 出 并 介 绍 各 个 函 数 接 口 以 下 各 节 将 更 详 细 地 介 绍 每 个 函 数 默 认 情 况 下,PSoC Creator 将 实 例 名 称 _1 分 配 给 指 定 设 计 中 组 件 的 第 一 个 实 例 您 可 以 将 该 实 例 重 命 名 为 符 合 标 识 符 语 法 规 则 的 任 意 唯 一 值 实 例 名 称 会 成 为 每 个 全 局 函 数 名 称 变 量 和 常 量 符 号 的 前 缀 出 于 可 读 性 考 虑, 下 表 中 使 用 的 实 例 名 称 为 核 心 API 函 数 初 始 化 子 组 函 数 说 明 l_sys_init() 初 始 化 核 心 信 号 交 互 函 数 子 组 函 数 说 明 l_bool_rd() 读 取 并 返 回 1 位 信 号 的 当 前 值 l_u8_rd() 读 取 并 返 回 2-8 位 信 号 的 当 前 值 l_u16_rd() 读 取 并 返 回 9-16 位 信 号 的 当 前 值 l_bytes_rd() 读 取 并 返 回 信 号 中 所 选 字 节 的 当 前 值 l_bool_w() 将 1 位 信 号 的 当 前 值 设 置 为 v l_u8_wr() 将 信 号 当 前 值 设 置 为 2-8 位 l_u16_wr() 将 信 号 当 前 值 设 置 为 9-16 位 l_bytes_wr() 设 置 信 号 中 所 选 字 节 的 当 前 值 通 知 函 数 子 组 函 数 说 明 l_flg_tst() 返 回 表 示 标 志 当 前 状 态 的 布 尔 值 l_flg_clr() 将 标 志 当 前 值 设 置 为 零 Document Number: Rev. ** Page 25 of 47

26 PSoC Creator 组 件 数 据 手 册 接 口 管 理 函 数 * 子 组 函 数 说 明 l_ifc_init() 初 始 化 从 器 件 组 件 l_ifc_wake_up() 传 输 一 个 唤 醒 信 号 l_ifc_ioctl() 控 制 规 范 以 外 的 功 能 l_ifc_rx() 从 器 件 组 件 自 动 调 用 此 API 子 程 序 l_ifc_tx() 从 器 件 组 件 自 动 调 用 此 API 子 程 序 l_ifc_aux() 从 器 件 组 件 自 动 调 用 此 API 子 程 序 l_ifc_read_status() 返 回 指 定 接 口 的 状 态 用 户 提 供 的 调 出 子 组 函 数 说 明 l_sys_irq_disable() 禁 用 组 件 的 所 有 中 断 l_sys_irq_restore() 恢 复 组 件 的 所 有 中 断 节 点 配 置 函 数 函 数 说 明 ld_read_configuration() 串 行 化 当 前 配 置, 并 将 其 复 制 到 应 用 程 序 所 提 供 的 区 域 ( 数 据 指 针 ) ld_set_configuration() 根 据 输 入 参 数 指 定 的 配 置 来 配 置 NAD 和 PID ld_read_by_id_callout() 主 控 节 点 根 据 用 户 定 义 区 域 中 标 识 符 的 请 求 传 输 一 个 读 数 时 使 用 传 输 层 函 数 初 始 化 子 组 函 数 说 明 ld_init() 初 始 化 或 重 新 初 始 化 原 始 和 成 熟 传 输 层 初 始 化 所 有 传 输 层 缓 冲 区 如 果 正 在 进 行 的 诊 断 帧 在 总 线 上 传 输 成 熟 或 原 始 消 息, 则 该 函 数 将 不 会 中 止 原 始 传 输 层 API 函 数 子 组 函 数 说 明 ld_put_raw() 在 一 个 帧 上 8 个 数 据 字 节 传 输 的 调 用 队 列 Page 26 of 47 Document Number: Rev. **

27 函 数 说 明 ld_get_raw() 将 最 早 接 收 的 诊 断 帧 数 据 复 制 到 输 入 参 数 指 定 的 存 储 器 中 ld_raw_tx_status() 返 回 原 始 帧 传 输 函 数 的 状 态 ld_raw_rx_status() 返 回 原 始 帧 接 收 函 数 的 状 态 成 熟 传 输 层 API 函 数 子 组 函 数 ld_send_message() ld_receive_message() ld_tx_status() ld_rx_status() 说 明 将 通 过 数 据 和 长 度 指 定 的 信 息 压 缩 成 一 个 或 多 个 诊 断 帧 将 这 些 帧 通 过 地 址 NAD 传 输 到 主 控 节 点 准 备 诊 断 模 块 以 用 来 接 收 一 条 消 息 并 将 其 存 储 到 根 据 数 据 指 向 的 缓 冲 区 调 用 时, 长 度 表 示 最 大 允 许 长 度 接 收 完 成 时, 长 度 变 为 实 际 长 度, NAD 变 为 消 息 中 的 NAD 返 回 上 次 执 行 调 用 的 状 态 至 ld_send_message() 返 回 上 次 执 行 调 用 的 状 态 至 ld_receive_message() Non--Specified API 函 数 说 明 _Start() 启 动 组 件 操 作 _Stop() 启 动 组 件 操 作 核 心 API 函 数 : 初 始 化 l_bool l_sys_init() 说 明 : 初 始 化 核 心 此 函 数 不 执 行 任 何 操 作, 始 终 返 回 零 静 态 原 型 : l_bool l_sys_init(void) 始 终 返 回 0 Document Number: Rev. ** Page 27 of 47

28 PSoC Creator 组 件 数 据 手 册 核 心 API 函 数 : 信 号 交 互 在 后 续 所 有 静 态 信 号 API 调 用 中, sss 是 信 号 名 称, 例 如,l_u8_rd_EngineSpeed() 对 于 后 续 动 态 信 号 API 调 用, sss 是 在 应 用 程 序 编 程 接 口 中 定 义 的 信 号 句 柄 l_bool_rd() 说 明 : 静 态 原 型 : 读 取 并 返 回 1 位 信 号 的 当 前 值 如 果 无 效 信 号 句 柄 传 递 到 该 函 数, 则 无 需 执 行 任 何 操 作 l_bool l_bool_rd_sss(void) l_bool l_bool_rd(l_signal_handle sss) sss: 要 读 取 信 号 的 信 号 句 柄 返 回 信 号 的 当 前 值 l_u8_rd() 说 明 : 读 取 并 返 回 信 号 的 当 前 值 如 果 无 效 信 号 句 柄 传 递 到 该 函 数, 则 无 需 执 行 任 何 操 作 静 态 原 型 : l_u8 l_u8_rd_sss(void) l_u8 l_u8_rd(l_signal_handle sss) sss: 要 读 取 信 号 的 信 号 句 柄 返 回 信 号 的 当 前 值 Page 28 of 47 Document Number: Rev. **

29 l_u16_rd() 说 明 : 读 取 并 返 回 信 号 的 当 前 值 如 果 无 效 信 号 句 柄 传 递 到 该 函 数, 则 无 需 执 行 任 何 操 作 静 态 原 型 : l_u16 l_u16_rd_sss(void) l_u16 l_u16_rd(l_signal_handle sss) Sss: 要 读 取 信 号 的 信 号 句 柄 返 回 信 号 的 当 前 值 此 函 数 并 不 保 证 读 取 的 数 据 字 节 是 原 子 操 作 如 果 有 必 要 原 子 化 数 据 字 节, 则 应 用 程 序 必 须 确 保 实 现 这 种 情 况 l_bytes_rd() 说 明 : 静 态 原 型 : 读 取 并 返 回 信 号 中 所 选 字 节 的 当 前 值 Start( 开 始 ) 和 Count( 计 数 ) 参 数 的 总 和 从 不 大 于 字 节 阵 列 长 度 注 意 : 当 Start( 开 始 ) 和 Count( 计 数 ) 总 和 大 字 节 阵 列 长 度 时, 读 取 意 外 数 据 如 果 无 效 信 号 句 柄 传 递 到 该 函 数, 则 无 需 执 行 任 何 操 作 假 设 字 节 阵 列 长 度 为 8 个 字 节, 则 编 号 为 0-7 根 据 用 户 选 择 的 阵 列 读 取 2-6 个 字 节 要 求 Start( 开 始 ) 参 数 为 2( 跳 过 字 节 0 和 1),Count( 计 数 ) 参 数 为 5 在 此 情 况 下, 字 节 2 被 写 入 user_selected_array[0], 所 有 连 续 字 节 以 升 序 格 式 写 入 user_selected_array void l_bytes_rd_sss(l_u8 start, l_u8 count, l_u8* const data) void l_bytes_rd(l_signal_handle sss, l_u8 start, l_u8 count, l_u8* const data) sss: 要 读 取 信 号 的 信 号 句 柄 开 始 : 从 第 一 个 字 节 开 始 读 取 计 数 : 要 读 取 的 字 节 数 data: 指 针 指 向 阵 列, 在 此 阵 列 中 存 储 从 信 号 中 读 取 的 数 据 此 函 数 并 不 保 证 读 取 的 数 据 字 节 是 原 子 操 作 如 果 有 必 要 原 子 化 数 据 字 节, 则 应 用 程 序 必 须 确 保 实 现 这 种 情 况 Document Number: Rev. ** Page 29 of 47

30 PSoC Creator 组 件 数 据 手 册 l_bool_wr() 说 明 : 将 值 v 写 入 信 号 如 果 无 效 信 号 句 柄 传 递 到 该 函 数, 则 无 需 执 行 任 何 操 作 静 态 原 型 : void l_bool_wr_sss(l_bool v) void l_bool_wr(l_signal_handle sss, l_bool v) sss: 要 写 入 信 号 的 信 号 句 柄 v: 要 设 置 信 号 的 值 l_u8_wr() 说 明 : 将 值 v 写 入 信 号 如 果 无 效 信 号 句 柄 传 递 到 该 函 数, 则 无 需 执 行 任 何 操 作 静 态 原 型 : void l_u8_wr_sss(l_u8 v) void l_u8_wr(l_signal_handle sss, l_u8 v) sss: 要 写 入 信 号 的 信 号 句 柄 v: 要 设 置 信 号 的 值 l_u16_wr() 说 明 : 将 值 v 写 入 信 号 如 果 无 效 信 号 句 柄 传 递 到 该 函 数, 则 无 需 执 行 任 何 操 作 静 态 原 型 : void l_u16_wr_sss(l_u16 v) void l_u16_wr(l_signal_handle sss, l_u16 v) sss: 要 写 入 信 号 的 信 号 句 柄 ; v: 要 设 置 信 号 的 值 此 函 数 不 保 证 主 控 将 自 动 读 取 写 入 的 数 据 字 节 如 果 有 必 要 原 子 化 数 据 字 节, 则 应 用 程 序 必 须 确 保 实 现 这 种 情 况 Page 30 of 47 Document Number: Rev. **

31 l_bytes_wr() 说 明 : 静 态 原 型 : 将 所 选 字 节 的 当 前 值 写 入 由 名 称 sss 指 定 的 信 号 中 虽 然 器 件 驱 动 程 序 不 可 能 选 择 在 运 行 时 强 制 执 行 该 操 作, 但 是, 开 始 和 计 数 参 数 总 和 从 不 大 于 字 节 阵 列 的 长 度 注 意 : 当 开 始 和 计 数 参 数 总 和 大 字 节 阵 列 长 度 时, 读 取 意 外 数 据 如 果 无 效 信 号 句 柄 传 递 到 该 函 数, 则 无 需 执 行 任 何 操 作 假 设 字 节 阵 列 长 度 为 8 个 字 节, 则 编 号 为 0-7 写 入 此 阵 列 的 字 节 3 和 4, 开 始 参 数 为 3( 跳 过 字 节 0 1 和 2), 计 数 参 数 为 2 在 此 情 况 下, 从 user_selected_array[0] 开 始 写 入 字 节 阵 列 信 号 的 字 节 3, 并 从 user_selected_array[1] 写 入 字 节 4 void l_bytes_wr_sss(l_u8 start, l_u8 count, const l_u8* const data) void l_bytes_wr(l_signal_handle sss, l_u8 start, l_u8 count, const l_u8* const data) sss: 要 写 入 信 号 的 信 号 句 柄 开 始 : 要 写 入 到 的 第 一 个 字 节 计 数 : 要 写 入 的 字 节 数 data: 指 针 指 向 阵 列, 在 此 阵 列 中 定 位 传 输 到 主 控 的 数 据 此 函 数 不 保 证 主 控 以 原 子 方 式 读 取 写 入 的 数 据 字 节 如 果 有 必 要 原 子 化 数 据 字 节, 则 应 用 程 序 必 须 确 保 实 现 这 种 情 况 核 心 API 函 数 : 通 知 通 知 标 志 用 于 同 步 应 用 程 序 与 核 心 这 些 标 志 由 核 心 自 动 设 置, 并 且 仅 可 以 由 应 用 程 序 进 行 测 试 或 清 除 通 知 标 志 可 以 与 信 号 特 定 帧 中 的 信 号 ( 在 此 情 况 下, 相 同 信 号 被 压 缩 到 多 个 帧 中 ) 或 帧 对 应 成 功 发 送 或 接 收 相 应 信 号 或 帧 时, 通 过 此 组 件 设 置 标 记 在 以 下 所 有 标 记 API 子 程 序 中, fff 是 标 记 名 称, 例 如,l_flg_tst_RxEngineSpeed() 对 于 动 态 标 记 API 子 程 序, fff 是 在 应 用 程 序 编 程 接 口 中 早 期 定 义 的 信 号 句 柄 Document Number: Rev. ** Page 31 of 47

32 PSoC Creator 组 件 数 据 手 册 l_flg_tst() 说 明 : 静 态 原 型 : 此 函 数 返 回 通 过 名 称 fff 指 定 的 标 记 的 当 前 状 态 如 果 该 标 记 已 被 清 除, 则 返 回 假, 否 则 返 回 真 如 果 此 子 程 序 返 回 真 值, 则 表 示 相 应 信 号 或 帧 已 成 功 发 送 或 接 收 l_bool l_flg_tst_fff(void) l_bool l_flg_tst(l_flag_handle fff) fff: 标 记 句 柄 的 名 称 返 回 表 示 由 名 称 fff 指 定 的 标 记 的 当 前 状 态 的 C 布 尔 值 假 : 该 标 记 已 被 清 除 ; 真 : 该 标 记 尚 未 被 清 除 l_flg_clr() 说 明 : 清 除 通 过 名 称 fff 指 定 的 标 记 此 子 程 序 应 用 于 在 测 试 后 ( 在 l_flg_tst() API 之 后 ) 清 除 标 记 该 组 件 不 会 自 动 清 除 通 知 标 记 此 子 程 序 是 用 来 清 除 通 知 标 记 的 唯 一 方 法 静 态 原 型 : void l_flg_clr_fff(void) void l_flg_clr(l_flag_handle fff) fff: 标 记 句 柄 的 名 称 接 口 管 理 函 数 这 些 调 用 可 用 来 管 理 特 定 接 口 ( 到 达 总 线 的 逻 辑 通 道 ) 每 次 调 用 API 时, 按 照 接 口 名 称 ( 通 过 iii 扩 展 名 来 表 示 ) 标 记 各 个 接 口, 例 如,l_ifc_init_MyLinIfc() 对 于 此 组 件 来 说, 接 口 名 称 与 组 件 实 例 名 称 相 同 此 组 件 最 多 支 持 一 个 接 口 因 此, iii 从 未 有 过 一 个 以 上 的 有 效 标 识 符 Page 32 of 47 Document Number: Rev. **

33 l_ifc_init() 说 明 : l_ifc_init() 初 始 化 通 过 名 称 iii 指 定 的 从 器 件 组 件 实 例 它 用 来 设 置 内 部 函 数, 例 如 波 特 率, 并 启 动 从 器 伯 组 件 使 用 的 数 字 模 块 这 是 必 须 执 行 的 第 一 次 调 用, 然 后 使 用 其 他 任 何 接 口 相 关 的 从 器 件 API 函 数 静 态 原 型 : l_bool l_ifc_init_iii(void) l_bool l_ifc_init(l_ifc_handle iii) iii: 接 口 句 柄 名 称 如 果 初 始 化 成 功, 该 函 数 返 回 零 值, 失 败 时, 则 返 回 非 零 值 l_ifc_wake_up() 说 明 : 静 态 原 型 : 此 函 数 用 来 传 输 一 个 唤 醒 信 号 当 调 用 此 函 数 时, 直 接 传 输 该 唤 醒 信 号 调 用 此 API 函 数 时, 应 用 程 序 被 阻 止, 直 到 在 总 线 上 传 输 唤 醒 信 号 时 为 止 CyDelayUs() 函 数 用 作 时 序 源 根 据 在 PSoC Creator 中 输 入 的 时 钟 配 置 计 算 延 迟 void l_ifc_wake_up_iii(void) void l_ifc_wake_up(l_ifc_handle iii) iii: 接 口 句 柄 名 称 Document Number: Rev. ** Page 33 of 47

34 PSoC Creator 组 件 数 据 手 册 l_ifc_ioctl() 说 明 : 静 态 原 型 : 此 API 控 制 其 他 API 调 用 所 不 涵 盖 的 功 能 此 函 数 用 来 以 器 件 特 定 的 方 法 控 制 此 组 件 有 关 此 函 数 所 支 持 的 操 作, 请 参 见 元 件 参 数 这 一 节 l_u16 l_ifc_ioctl_iii(l_ioctl_op op, void* pv) l_u16 l_ifc_ioctl(l_ifc_handle iii, l_ioctl_op op, void* pv) iii: 在 OP 中 定 义 的 操 作 所 适 用 的 接 口 句 柄 的 名 称 op: 用 于 指 定 操 作 的 参 数 pv: 指 针 指 向 指 定 操 作 的 可 选 参 数 集, 这 些 参 数 必 须 提 供 给 该 函 数 下 表 介 绍 l_ifc_ioctl API 函 数 所 支 持 的 可 能 的 操 作 及 其 代 码 值 在 表 中 列 出 的 参 数 显 示 现 有 参 数 总 数 及 其 所 具 有 的 数 据 类 型 op 操 作 ( 符 号 名 称 ) 值 pv 参 数 列 表 说 明 L_IOCTL_READ_STATUS 0x00u 可 选 状 态 指 示 符 L_IOCTL_SET_BAUD_RATE 0x01u l_u16 l_u16 修 改 波 特 率 L_IOCTL_SLEEP 0x02u 准 备 低 功 耗 模 式 条 目 的 器 件 L_IOCTL_WAKEUP 0x03u 唤 醒 后 恢 复 组 件 状 态 L_IOCTL_SYNC_COUNTS 0x04u 返 回 同 步 字 段 定 时 器 计 数 L_IOCTL_SET_SERIAL_NUMBER 0x05u l_u8* 更 新 指 针 为 序 号 没 有 为 所 选 操 作 返 回 错 误 代 码 值 这 意 味 着 您 必 须 确 保 传 递 到 函 数 的 值 正 确 无 误 L_IOCTL_READ_STATUS 操 作 在 此 字 节 中 的 首 位 是 一 个 标 记, 其 表 示 总 线 上 尚 没 有 针 对 某 些 已 用 时 间 的 信 号 ( 启 用 Bus Inactivity Timeout Detection( 总 线 闲 置 超 时 检 测 ) 选 项 时 可 用 ) 如 果 已 用 时 间 是 过 去 的 某 个 阀 值, 则 设 置 此 标 记 调 用 此 API 可 以 清 除 返 回 后 的 所 有 状 态 位 第 二 个 位 是 一 个 标 记, 其 表 示 已 接 收 目 标 复 位 服 务 请 求 (0xB5)( 当 启 用 J 合 规 性 时 ) 符 号 名 值 说 明 _IOCTL_STS_BUS_INACTIVITY 0x0001u 在 总 线 上 未 检 测 到 某 个 已 用 时 间 的 信 号 _IOCTL_STS_TARGET_RESET 0x0002u 已 收 到 目 标 复 位 服 务 请 (0xB5) Page 34 of 47 Document Number: Rev. **

35 L_IOCTL_SET_BAUD_RATE 操 作 如 果 操 作 成 功, 返 回 0, 如 果 传 递 给 函 数 的 操 作 参 数 无 效, 则 返 回 1 L_IOCTL_SLEEP 操 作 如 果 操 作 成 功, 返 回 0, 如 果 传 递 给 函 数 的 操 作 参 数 无 效, 则 返 回 1 L_IOCTL_WAKEUP 操 作 如 果 操 作 成 功, 返 回 0, 如 果 传 递 给 函 数 的 操 作 参 数 无 效, 则 返 回 1 L_IOCTL_SYNC_COUNTS 操 作 返 回 同 步 字 段 定 时 器 计 数 的 当 前 数, 即 8 个 同 步 字 段 字 节 L_IOCTL_SET_SERIAL_NUMBER 操 作 如 果 操 作 成 功, 返 回 0, 如 果 传 递 给 函 数 的 操 作 参 数 无 效, 则 返 回 1 l_ifc_rx() 说 明 : 静 态 原 型 : 从 器 件 组 件 自 动 调 用 此 API 子 程 序 因 此, 此 API 子 程 序 不 必 由 应 用 程 序 代 码 来 调 用 它 仅 在 此 处 列 出, 用 来 说 明 规 范 的 合 规 性 void l_ifc_rx_iii(void) void l_ifc_rx(l_ifc_handle iii) iii: 接 口 句 柄 名 称 l_ifc_tx() 说 明 : 静 态 原 型 : 从 器 件 组 件 自 动 调 用 此 API 子 程 序 因 此, 此 API 子 程 序 不 必 由 应 用 程 序 代 码 来 调 用 它 仅 在 此 处 列 出, 用 来 说 明 规 范 的 合 规 性 void l_ifc_tx_iii(void) void l_ifc_tx(l_ifc_handle iii) iii: 接 口 句 柄 名 称 Document Number: Rev. ** Page 35 of 47

36 PSoC Creator 组 件 数 据 手 册 l_ifc_aux() 说 明 : 静 态 原 型 : 从 器 件 组 件 自 动 调 用 此 API 子 程 序 因 此, 此 API 子 程 序 不 必 由 应 用 程 序 代 码 来 调 用 它 仅 在 此 处 列 出, 用 来 说 明 规 范 的 合 规 性 void l_ifc_aux_iii(void) void l_ifc_aux(l_ifc_handle iii) iii: 接 口 句 柄 名 称 l_ifc_read_status() 说 明 : 此 函 数 返 回 上 一 个 通 信 的 状 态 有 关 从 器 件 状 态 文 字 中 各 个 信 息 字 段 的 详 细 信 息, 请 参 见 2.1 规 范 静 态 原 型 : l_u16 l_ifc_read_status_iii(void) l_u16 l_ifc_read_status(l_ifc_handle iii) iii: 接 口 句 柄 名 称 该 调 用 返 回 状 态 文 字 (16 位 值 ), 如 下 表 所 示 : 上 一 个 帧 PID 0 保 存 配 置 事 件 触 发 的 帧 冲 突 总 线 空 闲 转 到 睡 眠 过 速 成 功 传 输 响 应 中 出 错 状 态 文 字 仅 根 据 节 点 传 输 或 接 收 的 帧 来 设 置 ( 总 线 活 动 除 外 ) 调 用 API 后 清 除 状 态 文 字 Page 36 of 47 Document Number: Rev. **

37 用 户 提 供 的 调 出 l_sys_irq_disable() 说 明 : 此 函 数 禁 用 组 件 的 所 有 中 断 进 入 中 断 掩 码 位 时, 它 返 回 状 态 掩 码 此 函 数 基 本 等 效 于 大 多 数 组 件 的 DisableInt API 与 这 些 函 数 不 同, 它 必 须 保 存 返 回 值, 然 后 使 用 l_sys_irq_restore() 函 数 来 正 确 存 储 中 断 状 态 强 烈 建 议 您 在 使 用 此 API 子 程 序 时 务 必 要 小 心 如 果 此 组 件 中 断 禁 用 时 间 过 长, 通 信 可 能 失 败 此 子 程 序 应 由 应 用 程 序 来 提 供 然 而, 从 器 件 组 件 可 以 自 动 实 现 此 子 程 序 必 要 时, 您 可 以 修 改 子 程 序 中 的 代 码 静 态 原 型 : l_irqmask l_sys_irq_disable(void) 返 回 用 来 定 义 禁 用 中 断 的 数 字 模 块 的 中 断 寄 存 器 掩 码 l_sys_irq_restore() 说 明 : 此 函 数 可 以 恢 复 组 件 中 断 它 应 与 l_sys_irq_disable() 结 合 使 用 此 函 数 基 本 等 效 于 大 多 数 组 件 的 EnableInt API; 然 而, 在 启 动 组 件 时, 不 应 调 用 该 函 数 此 子 程 序 应 由 应 用 程 序 来 提 供 然 而, 从 器 件 组 件 可 以 自 动 实 现 此 子 程 序 必 要 时, 您 可 以 修 改 子 程 序 中 的 代 码 静 态 原 型 : void l_sys_irq_restore(l_irqmask previous) 上 一 个 : 用 于 定 义 启 用 中 断 的 数 字 模 块 的 中 断 掩 码 Document Number: Rev. ** Page 37 of 47

38 PSoC Creator 组 件 数 据 手 册 节 点 配 置 函 数 ld_read_configuration() 说 明 : 此 函 数 用 于 从 易 失 性 存 储 器 中 读 取 NAD 和 PID 值 此 函 数 可 用 于 读 取 当 前 配 置 数 据, 然 后 将 此 数 据 保 存 于 非 易 失 性 ( 闪 存 ) 存 储 器 中 在 状 态 寄 存 器 ( 由 l_ifc_read_status() 返 回 ) 中 设 置 保 存 配 置 位 时, 应 用 程 序 应 将 配 置 数 据 保 存 于 闪 存 中 静 态 原 型 : 所 读 取 的 配 置 数 据 是 串 行 字 节 第 一 个 字 节 是 从 器 件 的 当 前 NAD 下 一 个 字 节 是 从 器 件 向 其 响 应 的 帧 的 当 前 PID 值 PID 值 是 有 序 排 列 的, 其 中, 所 有 帧 显 示 在 LDF 或 NCF 文 件 中 l_u8 ld_read_configuration(l_ifc_handle iii, l_u8* const data, l_u8* length) iii: 接 口 句 柄 名 称 ; data: 从 中 读 取 配 置 数 据 的 阵 列 长 度 : 配 置 数 据 字 节 数 的 大 小 该 值 指 向 长 度 指 针 参 数, 将 其 设 置 为 配 置 数 据 的 实 际 长 度 该 函 数 返 回 下 表 中 列 出 的 值 符 号 名 说 明 LD_READ_OK LD_LENGTH_TOO_SHORT 如 果 配 置 数 据 读 取 成 功, 则 返 回 指 向 ( 或 被 指 向 ) 长 度 指 针 参 数 的 值 小 于 配 置 数 据 的 实 际 长 度 时 返 回 Page 38 of 47 Document Number: Rev. **

39 ld_set_configuration() 说 明 : 此 函 数 用 于 设 置 从 器 件 节 点 的 易 失 性 NAD 和 PID 的 值 这 可 能 用 来 在 运 行 时 修 改 NAD 和 PID 值 通 常, 仅 在 启 动 后 或 主 控 发 出 请 求 后 才 执 行 此 操 作 此 外, 如 果 从 器 件 更 改 NAD 和 / 或 PID 的 值, 主 控 可 能 不 再 与 从 器 件 进 行 通 信 有 关 配 置 数 据 包 含 的 内 容 及 如 何 存 储 配 置 数 据 的 详 细 信 息, 请 参 见 ld_read_configuration function() 静 态 原 型 : l_u8 ld_set_configuration(l_ifc_handle iii, const l_u8* const data, l_u16 length) iii: 接 口 句 柄 名 称 data: 适 用 于 从 器 件 节 点 的 配 置 数 据 阵 列 长 度 : 配 置 数 据 字 节 数 的 大 小 该 函 数 返 回 下 表 中 列 出 的 值 符 号 名 说 明 LD_SET_OK 如 果 配 置 数 据 设 置 成 功, 则 返 回 LD_LENGTH_NOT_CORRECT 如 果 长 度 参 数 的 值 不 等 于 从 器 件 节 点 配 置 数 据 的 值, 则 返 回 LD_DATA_ERROR 如 果 配 置 数 据 设 置 错 误, 则 返 回 Document Number: Rev. ** Page 39 of 47

40 PSoC Creator 组 件 数 据 手 册 ld_read_by_id_callout() 说 明 : 主 控 节 点 根 据 用 户 定 义 区 域 中 标 识 符 的 请 求 传 输 一 个 读 数 时 使 用 此 调 出 当 收 到 这 样 的 请 求 时, 从 驱 动 程 序 中 调 用 从 器 件 节 点 应 用 程 序 静 态 原 型 : l_u8 ld_read_by_id_callout (l_ifc_handle iii, l_u8 id, l_u8* data) iii: 接 口 句 柄 名 称 id: 在 用 户 定 义 区 域 中 的 标 识 符 (32-63), 根 据 标 识 符 配 置 请 求 的 读 取 framedata: 指 向 包 含 5 个 字 节 的 数 据 区 域 应 用 程 序 使 用 此 区 域 来 设 置 正 向 响 应 该 函 数 返 回 下 表 中 列 出 的 值 符 号 名 LD_NEGATIVE_RESPONSE LD_NO_RESPONSE LD_POSITIVE_RESPONSE 说 明 默 认 返 回 API 状 态 如 果 未 修 改 API 及 将 API 重 新 分 配 至 其 他 某 些 状 态, 则 始 终 返 回 该 状 态 您 可 以 手 动 设 置 此 状 态 集 若 设 置, 则 表 示 不 为 服 务 提 供 任 何 响 应 您 可 以 手 动 设 置 此 状 态 集 若 设 置, 则 表 示 为 服 务 提 供 响 应 该 响 应 将 指 向 或 被 指 向 FrameData 参 数 传 输 层 函 数 传 输 层 是 网 络 堆 栈 的 更 高 层 级 通 过 此 层 级, 应 用 程 序 可 以 发 送 或 接 收 消 息 格 式 而 非 帧 格 式 的 数 据 消 息 可 能 是 使 用 多 个 帧 发 送 或 接 收 的 许 多 字 节 传 输 层 用 于 配 置 服 务 诊 断 服 务 或 自 定 义 及 用 户 定 义 的 实 现 发 送 和 接 收 传 输 层 消 息 的 API 具 有 两 种 不 同 格 式 即 成 熟 格 式 和 原 始 格 式 此 组 件 仅 支 持 使 用 一 种 传 输 层 API 函 数 格 式 在 组 件 自 定 义 程 序 的 Transport Layer( 传 输 层 ) 选 项 卡 上 选 中 API 格 式 注 意 : 要 使 用 传 输 层 API 函 数, 必 须 在 组 件 自 定 义 程 序 的 Transport Layer( 传 输 层 ) 选 项 卡 上 启 用 传 输 层 的 使 用 Page 40 of 47 Document Number: Rev. **

41 ld_init() 说 明 : 此 子 程 序 可 以 初 始 化 或 重 新 初 始 化 从 器 件 节 点 的 传 输 层 使 用 任 何 传 输 层 API 函 数 前, 必 须 调 用 此 API 此 外, 在 从 器 件 节 点 可 以 执 行 任 何 传 输 层 通 信 之 前, 还 需 调 用 此 API 如 果 正 在 进 行 的 诊 断 帧 在 总 线 上 传 输 成 熟 或 原 始 消 息 过 程 中, 调 用 API, 该 消 息 将 中 止 ; 而 API 一 直 等 到 该 消 息 完 成 时 为 止 静 态 原 型 : void ld_init(l_ifc_handle iii) iii: 接 口 句 柄 名 称 原 始 传 输 层 API 函 数 ld_put_raw() 说 明 : 此 函 数 用 于 支 持 应 用 程 序 代 码 使 用 传 输 层 发 送 数 据 它 实 质 上 是 从 用 户 应 用 阵 列 将 某 些 数 据 复 制 到 帧 缓 冲 阵 列 此 函 数 用 于 一 次 发 送 一 个 完 整 的 传 输 层 消 息 帧 因 此, 传 输 层 消 息 多 帧 需 要 多 次 调 用 此 API 函 数 应 经 常 检 查 调 用 此 API 之 前 缓 冲 区 中 是 否 有 放 置 帧 的 空 间 静 态 原 型 : ( 返 回 值 ): ( 副 作 用 ): void ld_put_raw(l_ifc_handle iii, const l_u8* const data) iii: 接 口 句 柄 名 称 data: 要 发 送 数 据 的 阵 列 Document Number: Rev. ** Page 41 of 47

42 PSoC Creator 组 件 数 据 手 册 ld_get_raw() 说 明 : 此 函 数 用 于 支 持 应 用 程 序 代 码 使 用 传 输 层 接 收 数 据 它 实 质 上 是 从 帧 缓 冲 区 阵 列 将 某 些 数 据 复 制 到 用 户 应 用 阵 列 此 函 数 用 于 一 次 接 收 一 个 完 整 的 传 输 层 消 息 帧 因 此, 传 输 层 消 息 多 帧 需 要 多 次 调 用 此 API 函 数 如 果 接 收 队 列 为 空, 则 没 有 要 复 制 的 数 据 应 经 常 检 查 调 用 此 API 之 前 缓 冲 区 中 是 否 有 放 置 帧 的 空 间 静 态 原 型 : void ld_get_raw(l_ifc_handle iii, l_u8* const data) iii: 接 口 句 柄 名 称 data: 复 制 最 早 接 收 的 诊 断 帧 数 据 的 目 标 阵 列 ld_raw_tx_status() 说 明 : 使 用 原 始 API 时, 此 调 用 返 回 上 次 执 行 的 总 线 帧 传 输 的 状 态 静 态 原 型 : l_u8 ld_raw_tx_status(l_ifc_handle iii) iii: 接 口 句 柄 名 称 符 号 名 LD_QUEUE_EMPTY 说 明 传 输 队 列 为 空 如 果 上 次 调 用 ld_put_raw() 已 经 完 成, 则 已 完 成 队 列 中 所 有 帧 的 传 输 LD_QUEUE_AVAILABLE 传 输 队 列 包 含 许 多 条 目, 但 处 于 未 满 状 态 LD_QUEUE_FULL 传 输 队 列 已 满, 无 法 接 收 更 多 帧 LD_TRANSMIT_ERROR 传 输 过 程 中, 协 议 出 错, 初 始 化 并 重 新 执 行 传 输 Page 42 of 47 Document Number: Rev. **

43 ld_raw_rx_status() 说 明 : 使 用 原 始 API 时, 此 调 用 返 回 上 次 执 行 的 总 线 帧 接 收 的 状 态 静 态 原 型 : l_u8 ld_raw_rx_status(l_ifc_handle iii) iii: 接 口 句 柄 名 称 符 号 名 LD_NO_DATA 接 收 队 列 为 空 说 明 LD_DATA_AVAILABLE 接 收 队 列 包 含 可 以 读 取 的 数 据 LD_RECEIVE_ERROR 传 输 过 程 中, 协 议 出 错 初 始 化 并 重 新 执 行 传 输 成 熟 传 输 层 API 函 数 函 数 ld_send_message() 说 明 : 此 函 数 用 于 支 持 应 用 程 序 代 码 使 用 传 输 层 发 送 数 据 它 负 责 将 隔 那 些 在 多 个 SRF 帧 过 程 中 自 动 发 送 的 数 据 加 入 队 列 此 函 数 用 于 发 送 完 整 的 传 输 层 消 息 因 此, 传 输 层 消 息 多 帧 仅 需 要 调 用 一 次 此 API 函 数 长 度 值 必 须 介 于 字 节 之 间 如 果 消 息 正 在 进 程 中, 则 调 用 不 返 回 任 何 操 作 静 态 原 型 : void ld_send_message(l_ifc_handle iii, l_u16 length, l_u8 nad, const l_u8* const data) iii: 接 口 句 柄 名 称 长 度 : 要 发 送 数 据 字 节 数 的 大 小 nad: 发 送 数 据 的 目 标 从 器 件 节 点 的 地 址 数 据 : 要 发 送 数 据 的 阵 列 RSID 的 值 是 数 据 区 域 中 第 一 个 字 节 该 调 用 为 异 步 调 用, 即 在 消 息 发 送 完 成 前 从 不 挂 起, 并 且, 只 要 调 用 ld_tx_status() return LD_IN_PROGRESS, 缓 冲 区 不 可 能 被 应 用 程 序 更 改 Document Number: Rev. ** Page 43 of 47

44 PSoC Creator 组 件 数 据 手 册 ld_receive_message() 说 明 : 此 函 数 支 持 应 用 程 序 代 码 使 用 传 输 层 接 收 数 据 它 负 责 多 个 MRF 帧, 并 将 所 有 消 息 数 据 复 制 到 用 户 应 用 缓 冲 区 阵 列 此 函 数 用 于 接 收 完 整 的 传 输 层 消 息 因 此, 传 输 层 消 息 多 帧 仅 需 要 调 用 一 次 此 API 函 数 长 度 值 必 须 介 于 字 节 之 间 静 态 原 型 : void ld_receive_message(l_ifc_handle iii, l_u16* const length, l_u8* const nad, l_u8* const data) iii: 接 口 句 柄 名 称 长 度 : 要 接 收 数 据 字 节 数 的 大 小 nad: 从 中 接 收 数 据 的 从 器 件 节 点 的 地 址 data: 要 接 收 数 据 的 阵 列 SID 的 值 是 数 据 区 域 中 第 一 个 字 节 该 调 用 为 异 步 调 用, 即 在 消 息 接 收 完 成 前 从 不 挂 起, 并 且, 只 要 调 用 ld_tx_status() 返 回 LD_IN_PROGRESS, 缓 冲 区 不 可 能 被 应 用 程 序 更 改 ld_tx_status() 说 明 : 此 函 数 返 回 上 次 调 用 ld_send_message() 和 在 总 线 上 执 行 传 输 层 数 据 传 输 的 状 态 静 态 原 型 : l_u8 ld_tx_status(l_ifc_handle iii) iii: 接 口 句 柄 名 称 可 以 返 回 下 列 值 符 号 名 LD_IN_PROGRESS 传 输 尚 未 完 成 说 明 LD_COMPLETED 传 输 已 成 功 完 成 ( 因 此 您 可 以 发 布 新 的 ld_send_message call()) 此 外, 该 值 还 在 初 始 化 传 输 层 后 返 回 LD_FAILED 传 输 结 束 时 出 错 只 有 部 分 数 据 得 以 发 送 处 理 更 多 消 息 前, 必 须 重 新 初 始 化 传 输 层 要 查 找 传 输 失 败 的 原 因, 请 检 查 状 态 管 理 函 数 l_read_status() LD_N_AS_TIMEOUT 传 输 失 败, 因 为 N_As 超 时, 当 前 消 息 传 输 将 中 止 请 参 见 2.1 规 范 第 节 Page 44 of 47 Document Number: Rev. **

45 ld_rx_status() 说 明 : 此 函 数 返 回 上 次 调 用 ld_receive_message() 和 在 总 线 上 执 行 传 输 层 数 据 接 收 的 状 态 静 态 原 型 : l_u8 ld_rx_status(l_ifc_handle iii) Iii: 接 口 句 柄 名 称 可 以 返 回 下 列 值 : 符 号 名 LD_IN_PROGRESS 接 收 尚 未 完 成 说 明 LD_COMPLETED LD_FAILED 成 功 完 成 接 收, 所 有 信 息 ( 长 度 NAD 数 据 ) 均 为 可 用 状 态 此 外, 还 可 以 发 布 新 的 ld_receive_message() 调 用 此 外, 该 值 还 在 初 始 化 传 输 层 后 返 回 接 收 结 束 时 出 错 只 接 收 部 分 数 据, 该 数 据 不 可 用 处 理 更 多 传 输 层 消 息 前 初 始 化 要 查 找 接 收 失 败 的 原 因, 请 检 查 状 态 管 理 函 数 l_read_status() LD_N_CR_TIMEOUT 接 收 失 败, 因 为 N_Cr 超 时, 当 前 消 息 接 收 将 中 止 请 参 见 2.1 规 范 第 节 LD_WRONG_SN 接 收 失 败, 因 为 序 列 号 异 常 Non--Specified API _Start() 说 明 : 启 动 组 件 操 作 不 需 要 此 函 数 静 态 原 型 : l_bool _Start() 零 : 初 始 化 成 功 非 零 : 初 始 化 失 败 Document Number: Rev. ** Page 45 of 47

46 PSoC Creator 组 件 数 据 手 册 _Stop() 说 明 : 停 止 组 件 操 作 不 需 要 此 函 数 静 态 原 型 : l_bool _Stop() 固 件 源 代 码 示 例 PSoC Creator 在 查 找 示 例 项 目 对 话 框 中 提 供 了 很 多 包 括 原 理 图 和 代 码 示 例 的 示 例 项 目 要 获 取 组 件 特 定 的 示 例, 请 打 开 组 件 目 录 中 的 对 话 框 或 原 理 图 中 的 组 件 实 例 要 获 取 通 用 的 示 例, 请 打 开 Start Page( 开 始 页 ) 或 File( 文 件 ) 菜 单 中 的 对 话 框 根 据 需 要, 使 用 对 话 框 中 的 Filter Options( 滤 波 器 选 项 ) 可 缩 小 可 选 项 目 的 列 表 有 关 更 多 信 息, 请 参 见 PSoC Creator 帮 助 中 的 Find Example Project( 查 找 示 例 项 目 ) 主 题 PSoC 3 重 新 进 入 支 持 并 发 调 用 CyIntClearPending() 函 数, 因 为 这 是 在 组 件 中 从 两 个 不 同 的 中 断 执 行 调 用 默 认 情 况 下, 即 使 未 重 新 进 入, 它 也 可 以 执 行 重 新 进 入 支 持 以 在 编 译 过 程 中 去 除 MULTIPLE CALL TO FUNCTION 警 告 有 关 详 细 信 息, 请 参 见 PSoC Creator 帮 助 中 的 PSoC 3 中 的 重 入 代 码 这 一 主 题 此 外, 组 件 示 例 项 目 已 添 加 了 重 新 进 入 支 持 PSoC 和 总 线 硬 件 接 口 当 PSoC 从 器 件 节 点 直 接 与 总 线 连 接 时, 需 要 物 理 层 收 发 器 器 件 在 此 情 况 下, 组 件 的 TxD 引 脚 连 接 至 收 发 器 的 TXD 引 脚, 而 RxD 引 脚 连 接 至 收 发 器 的 RXD 引 脚 需 要 收 发 器 器 件, 因 为 PSoC 电 子 信 号 电 平 与 总 线 上 的 电 子 信 号 不 兼 容 某 些 收 发 器 器 件 还 具 有 启 用 或 睡 眠 输 入 信 号, 用 来 控 制 器 件 的 操 作 状 态 组 件 不 提 供 此 控 制 信 号 而 是 使 用 引 脚, 当 需 要 此 信 号 时, 用 其 将 所 需 信 号 输 出 到 收 发 器 器 件 Page 46 of 47 Document Number: Rev. **

47 图 17. PSoC 与 总 线 之 间 的 硬 件 接 口 PSoC Transceiver component rxd txd RXD Signal TXD Signal RXD TXD Bus Pin Control Signal (optional) NSLP 直 流 和 交 流 电 气 特 性 有 关 直 流 和 交 流 电 气 特 性 的 信 息, 请 参 见 2.1 规 范 的 物 理 层 规 范 这 一 章 组 件 更 改 版 本 1.0 是 组 件 的 首 次 发 行 版 本 版 本 更 改 说 明 更 改 / 影 响 原 因 1.0.a 对 数 据 表 进 行 了 少 量 编 辑 和 更 新 赛 普 拉 斯 半 导 体 公 司,2012 此 处 所 包 含 的 信 息 可 能 会 随 时 更 改, 恕 不 另 行 通 知 除 赛 普 拉 斯 产 品 的 内 嵌 电 路 之 外, 赛 普 拉 斯 半 导 体 公 司 不 对 任 何 其 他 电 路 的 使 用 承 担 任 何 责 任 也 不 根 据 专 利 或 其 他 权 利 以 明 示 或 暗 示 的 方 式 授 予 任 何 许 可 除 非 与 赛 普 拉 斯 签 订 明 确 的 书 面 协 议, 否 则 赛 普 拉 斯 产 品 不 保 证 能 够 用 于 或 适 用 于 医 疗 生 命 支 持 救 生 关 键 控 制 或 安 全 应 用 领 域 此 外, 对 于 可 能 发 生 运 转 异 常 和 故 障 并 对 用 户 造 成 严 重 伤 害 的 生 命 支 持 系 统, 赛 普 拉 斯 不 授 权 将 其 产 品 用 作 此 类 系 统 的 关 键 组 件 若 将 赛 普 拉 斯 产 品 用 于 生 命 支 持 系 统 中, 则 表 示 制 造 商 将 承 担 因 此 类 使 用 而 招 致 的 所 有 风 险, 并 确 保 赛 普 拉 斯 免 于 因 此 而 受 到 任 何 指 控 PSoC 是 赛 普 拉 斯 半 导 体 公 司 的 注 册 商 标,PSoC Creator 和 Programmable System-on-Chip 是 赛 普 拉 斯 半 导 体 公 司 的 商 标 此 处 引 用 的 所 有 其 他 商 标 或 注 册 商 标 归 其 各 自 所 有 者 所 有 所 有 源 代 码 ( 软 件 和 / 或 固 件 ) 均 归 赛 普 拉 斯 半 导 体 公 司 ( 赛 普 拉 斯 ) 所 有, 并 受 全 球 专 利 法 规 ( 美 国 和 美 国 以 外 的 专 利 法 规 ) 美 国 版 权 法 以 及 国 际 条 约 规 定 的 保 护 和 约 束 赛 普 拉 斯 据 此 向 获 许 可 者 授 予 适 用 于 个 人 的 非 独 占 性 不 可 转 让 的 许 可, 用 以 复 制 使 用 修 改 创 建 赛 普 拉 斯 源 代 码 的 派 生 作 品 编 译 赛 普 拉 斯 源 代 码 和 派 生 作 品, 并 且 其 目 的 只 能 是 创 建 自 定 义 软 件 和 / 或 固 件, 以 支 持 获 许 可 者 仅 将 其 获 得 的 产 品 依 照 适 用 协 议 规 定 的 方 式 与 赛 普 拉 斯 集 成 电 路 配 合 使 用 除 上 述 指 定 的 用 途 之 外, 未 经 赛 普 拉 斯 的 明 确 书 面 许 可, 不 得 对 此 类 源 代 码 进 行 任 何 复 制 修 改 转 换 编 译 或 演 示 免 责 声 明 : 赛 普 拉 斯 不 针 对 此 材 料 提 供 任 何 类 型 的 明 示 或 暗 示 保 证, 包 括 ( 但 不 仅 限 于 ) 针 对 特 定 用 途 的 适 销 性 和 适 用 性 的 暗 示 保 证 赛 普 拉 斯 保 留 在 不 做 出 通 知 的 情 况 下 对 此 处 所 述 材 料 进 行 更 改 的 权 利 赛 普 拉 斯 不 对 此 处 所 述 之 任 何 产 品 或 电 路 的 应 用 或 使 用 承 担 任 何 责 任 对 于 可 能 发 生 运 转 异 常 和 故 障 并 对 用 户 造 成 严 重 伤 害 的 生 命 支 持 系 统, 赛 普 拉 斯 不 授 权 将 其 产 品 用 作 此 类 系 统 的 关 键 组 件 若 将 赛 普 拉 斯 产 品 用 于 生 命 支 持 系 统 中, 则 表 示 制 造 商 将 承 担 因 此 类 使 用 而 招 致 的 所 有 风 险, 并 确 保 赛 普 拉 斯 免 于 因 此 而 受 到 任 何 指 控 产 品 使 用 可 能 受 适 用 的 赛 普 拉 斯 软 件 许 可 协 议 限 制 Document Number: Rev. ** Page 47 of 47