内容 隐藏
1 AXIOMATIC AX140910 CAN-ENET 软件支持包
2 产品信息
3 产品用途
4 一般信息
5 SSP 内容
6 数据类型和编码风格
7 使用SSP
8 文档
9 执照
10 版本历史
11 我们的产品
12 保修、应用批准/限制
13 文件/资源
13.1 参考
14 相关文章

AXIOMATIC-标志

AXIOMATIC AX140910 CAN-ENET 软件支持包

AXIOMATIC-AX140910-CAN-ENET-软件-支持-包-产品

产品信息

CAN-ENET 软件支持包 (SSP) 是一组软件模块、文档和扩展包amp用于开发与各种 Axiomatic 以太网至 CAN 和 Wi-Fi 至 CAN 转换器配合使用的应用软件的文件。 软件包提供用户手册、源码 file小号和前amp莱斯。 用户手册对任何 SSP 版本 3.0.xx 均有效，并且特定于用户手册的更新是通过在用户手册版本号中添加字母 A、B、...、Z 来完成的。 SSP 可用于对资源有限的嵌入式系统进行编程，也可用于 Windows 或 Linux 中的应用程序编程。

产品用途

  1. 下载发行版 zip file 从公理 web网站或通过电子邮件以附件形式接收。
  2. 解开拉链 file 在 Windows 中，右键单击 file 然后按“属性”->“常规”->“取消阻止”中的“取消阻止”按钮。
  3. 解压 zip 存档以创建以下文件夹结构：
    • 根目录包含SSP帮助 file Microsoft HTML 帮助格式的 CANEnetSSP.chm 和 Adob​​e Reader 格式的用户手册 UMAX140910v3.0.pdf。
    • 来源 Files 文件夹包含以太网至 CAN 转换器通信协议中描述的转换器健康状态信息。
    • 前任amples 文件夹包含 examp可以使用 Windows.mk 或 Linux.mk 在 Microsoft Windows 或 Linux 上构建的文件 files.
  4. 构建可执行文件 files 代表前任amp使用 make 的文件 file位于 .Examples 目录。
  5. 如有必要，在 .Ex 中创建一个 .Bin 子目录amp所有可执行文件和对象所在的 les 目录 files 将被放置。
  6. SSP 邮编 file 包含已编译的 examp适用于 Windows 的文件位于 .Bin 子目录中。
  7. 所有 SSP 前amp文件在 Windows 10 和 Linux Ubuntu 16.04 上进行了测试。

SSP 仅使用 int 和 char 标准数据类型。 当整数参数的确切数据大小或最大数据大小不重要时，使用 int 类型。 char 类型用于指向 ASCII 字符串或引用单个 ASCII 字符。 其他基本类型均源自标头，并且具有精确的数据大小，但布尔类型 BOOL_t 除外，它源自 int，请参见：CommonTypes.h file.

缩略语

  • API 应用程序编程接口
  • ASCII 美国信息交换标准代码
  • BSD 伯克利软件发行版
  • CAN控制器局域网
  • HTML 超文本标记语言
  • IP 互联网协议
  • LAN 局域网
  • SSP 软件支持包

一般信息

CAN-ENET 软件支持包 (SSP) 提供了一组软件模块、文档和扩展amp用于开发与各种 Axiomatic 以太网至 CAN 和 Wi-Fi 至 CAN 转换器配合使用的应用软件的文件。
本用户手册适用于两个主版本号与本手册相同的SSP。 对于前amp文件中，本用户手册对任何 SSP 版本 3.0.xx 均有效。 针对用户手册的更新是通过在用户手册版本号中添加字母：A、B、...、Z 来完成的。 所有 SSP 软件模块均采用标准 C 编程语言编写，以实现可移植性并提供完整文档。 它们为 Axiomatic 专有通信和发现协议提供支持。 通信协议主要用于通过以太网或任何其他 IP 网络传输 CAN 消息，而发现协议则用于在 LAN 上定位转换器。 SSP 同样可以用于资源有限的嵌入式系统编程以及 Windows 或 Linux 中的应用程序编程。

SSP 内容

SSP 以 zip 形式分发 file 名称：CANEnetSSPv .zip，在哪里数字指的是SSP主版本号和– 可选文档变更信。 避免显示 SSP 帮助时出现潜在问题 file, 分布邮编 file 如果通过互联网获取（从 Axiomatic 下载后），应在 Windows 中解锁 web网站、以附件形式接收电子邮件等）这可以通过右键单击 file 然后按“属性”->“常规”->“取消阻止”中的“取消阻止”按钮。 解压 zip 存档后，将创建以下文件夹结构：

AXIOMATIC-AX140910-CAN-ENET-软件-支持-包-fig-1

根目录包含SSP帮助 file Microsoft HTML 帮助格式的 CANEnetSSP.chm 和 Adob​​e Reader 格式的用户手册 UMAX140910v3.0.pdf。 最重要的 SSP 版本号反映了不兼容的更改，下一个 - 兼容的更改，最后一个 - 不影响 SSP 功能的微小更改。 添加可选字母是为了更改用户手册和/或帮助 file

来源 Files
SSP源 file根据其类型分为 .\Source 和 .\Inc 目录。 它们是用标准 C 编写的，并提供以下软件模块：

  • 私信。 为以太网至 CAN 转换器通信协议中描述的独立于协议的消息结构提供支持。
  • 通讯协议。 支持从以太网到 CAN 转换器通信协议的消息。
  • 光盘协议。 支持从以太网到 CAN 转换器发现协议的消息。
  • 健康数据。 提供数据结构和函数，用于处理以太网至 CAN 转换器通信协议中描述的以太网至 CAN 转换器健康状态信息。

所有基本数据类型和常用宏都在 CommonTypes.h 中定义 file.

Examp莱斯
SSP 还包含以下扩展：amp.\Ex 中的文件程序amples 目录演示了使用 Axiomatic 以太网到 CAN 转换器进行通信的不同场景：

  • CANReceive.c。 该控制台应用程序展示了如何从 Axiomatic 以太网到 CAN 转换器接收 CAN 帧。
  • CANSend.c。 这个前任amp该文件演示了如何将 CAN 帧发送到 Axiomatic 以太网至 CAN 转换器。
  • 发现.c. 这个前任amp该应用程序展示了用户如何在局域网 (LAN) 上发现 Axiomatic 以太网至 CAN 转换器。
  • 心跳.c. 此应用程序演示了如何从 Axiomatic 以太网到 CAN 转换器接收心跳消息。 它还显示了从心跳消息中解包运行状况数据。
  • StatusRequest.c。 这个前任amp该应用程序展示了用户如何请求 Axiomatic 以太网至 CAN 转换器的状态

所有前amp可以使用 Windows.mk 或 Linux.mk 在 Microsoft Windows 或 Linux 上构建文件 files。 品牌 files 也位于 .\Examples 目录。 构建可执行文件后 files，make 脚本如有必要，会在 .\Ex 中创建 .\Bin 子目录amples 目录，放置所有可执行文件和对象 files。 SSP 邮编 file 包含已编译的 examp适用于 Windows 的文件位于 .\Bin 子目录中。 所有 SSP 前amp文件在 Windows 10 和 Linux Ubuntu 16.04 上进行了测试

数据类型和编码风格

SSP 仅使用 int 和 char 标准数据类型。 当整数参数的确切数据大小或最大数据大小不重要时，使用 int 类型。 char 类型用于指向 ASCII 字符串或引用单个 ASCII 字符。 其他基本类型均源自header 并具有精确的数据大小，但布尔类型 BOOL_t 除外，它派生自 int，请参阅：CommonTypes.h file。 所有 SSP 导出的基本类型均以大写字母命名并以“_t”结尾。 对于前ample：BOOL_t、WORD_t 等。所有其他导出类型均以大写字母命名，以 '_t' 结尾，并以 file 缩写 file 它们在中定义。“CP”用于 CommProtocol.h，“DP”用于 DiscProtocol.h，“HD”用于 HealthData.h，“PM”用于 PMessage.h file。 所有宏名称均使用大写字母并带有前缀 file 缩写 file 它们的定义方式与数据类型相同。 “CT”缩写用于 CommonTypes.h file.
变量名称以基本类型和指针的类型为前缀。 对于前ample：int 类型以“i”为前缀，指针类型以“p”为前缀，整数指针以“pi”为前缀，等等。结构体、联合体、枚举数没有前缀。 对于以零结尾的字符串，使用“sz”前缀。 函数名称以前缀 file 缩写方式与数据类型和宏相同。 一个制表符等于四个空格

使用SSP

用户应添加 SSP file到应用程序项目。 如果未使用适当的协议，则可以排除 CommProtocol.c 或 DiscProtocol.c。 如果不需要处理转换器健康数据，也可以排除 HealthData.c。
SSP 在使用前不需要初始化。 它没有任何全局变量。 所有 SSP 函数都是线程安全且可重入的。 为了发送和接收转换器消息，需要互联网协议（IP）的支持。 提供这种支持的标准方法是使用 Internet 套接字。 套接字 API 已标准化并用于所有 SSP examp文件和转换器操作的描述。

接收来自转换器的消息
用户应首先准备一个用于接收转换器数据的套接字。
接收到数据后，应将其传递给 PMParseFromBuffer() 函数。 用户提供两个回调函数：OnDataParsed() 和 OnDataParsedError()。 第一个函数在协议消息成功解析后调用，第二个函数在解析错误时调用。 然后，用户应该在 OnDataParsed() 函数内调用解析器来解析各个协议特定的消息，如下所示：

AXIOMATIC-AX140910-CAN-ENET-软件-支持-包-fig-2

UMAX140910。 CAN-ENET 软件支持包。 3.0版本

AXIOMATIC-AX140910-CAN-ENET-软件-支持-包-fig-3 AXIOMATIC-AX140910-CAN-ENET-软件-支持-包-fig-4

UMAX140910。 CAN-ENET 软件支持包。 3.0版本

AXIOMATIC-AX140910-CAN-ENET-软件-支持-包-fig-5 AXIOMATIC-AX140910-CAN-ENET-软件-支持-包-fig-6

如果用户想要将 dwHealthData 值解析为转换器主要硬件和软件组件的单独运行状态，则应调用 HDUnpackHealthData() 函数：

AXIOMATIC-AX140910-CAN-ENET-软件-支持-包-fig-7

UMAX140910。 CAN-ENET 软件支持包。 版本 3.0 此函数还返回转换器聚合的健康状态。

向转换器发送消息
通过首先生成所需的协议消息，然后将消息复制到发送缓冲区，可以将用户消息发送到转换器。 对于前amp文件，发送状态请求将需要以下命令

AXIOMATIC-AX140910-CAN-ENET-软件-支持-包-fig-8

发送 CAN FD 帧更为复杂。 CAN FD Stream 消息可以包含多个 CAN FD 或经典 CAN 帧，除非节点在状态响应或心跳消息中设置了 CP_SUPPORTED_FEATURE_FLAG_CAN_FD_STREAM_ONE_FRAME_PER_MESSAGE 标志。 用户应首先准备一个空的 CAN FD Stream 消息，然后向其中添加 CAN 帧。

AXIOMATIC-AX140910-CAN-ENET-软件-支持-包-fig-9

UMAX140910。 CAN-ENET 软件支持包。 3.0版本

AXIOMATIC-AX140910-CAN-ENET-软件-支持-包-fig-10

如果使用TCP协议，应该给socket设置TCP_NODELAY选项，以避免发送协议消息的延迟

发现转换器
可以使用以太网至 CAN 转换器发现协议来发现转换器。 用户应该执行以下操作：

  • 开个达tag具有 SO_BROADCAST 选项的 ram 套接字。
  • 准备发现请求并将其复制到传输缓冲区。
  • 将发现请求发送到全局 IP 地址。
  • 等待来自同一 LAN 上的转换器的传入发现响应。
  • 首先通过 PMParseFromBuffer() 解析响应，然后通过 OnDataParsed() 调用的 DPParseResponse() 解析响应。

一个简化的前amp下面给出了说明该概念的代码

AXIOMATIC-AX140910-CAN-ENET-软件-支持-包-fig-11

UMAX140910。 CAN-ENET 软件支持包。 3.0版本

AXIOMATIC-AX140910-CAN-ENET-软件-支持-包-fig-12

文档

可根据要求提供以下描述 SSP 中使用的 Axiomatic 专有协议的文档：

  • O. Bogush，“以太网到 CAN 转换器通信协议。 文档版本：5”，Axiomatic Technologies Corporation，14 年 2022 月 XNUMX 日。
  • O. Bogush，“以太网到 CAN 转换器发现协议。 文档版本：1A”，Axiomatic Technologies Corporation，5 年 2021 月 XNUMX 日。
  • O. Bogush，“以太网至 CAN 转换器的健康状态。 文档版本：3”，Axiomatic Technologies Corporation，5 年 2021 月 XNUMX 日。

如需索取文件，请联系 Axiomatic Technologies： sales@axiomatic.com

执照

SSP 软件通过 3 条款 BSD 许可证进行分发。 许可证文本包含在软件中 files

版本历史

用户手册版本 固体硫酸盐

版本

  

日期

  

作者

  

修改
3.0 3.0.0 14 年 2022 月 XNUMX 日 奥莱克·博古什 · 添加了对 CAN FD 流的支持。

· 不再支持 CAN 和通知流。

· 状态响应和心跳消息中添加了通信节点设置。

· 更新了 CommProtocol.c、CommProtocol.h 和 examp文件：CANReceive.c、CANSend.c、Heartbeat.c 和 StatusRequest.c。

· 更新了首页上的芬兰办公室电话号码。
2.0 2.0.xx 27月XNUMX日

2021

 奥莱克·博古什 · 添加了对 Axiomatic Wi-Fi 至 CAN 转换器的支持。

· 添加 转换器类型 参数 心跳

和 状态响应 消息。

· 更新 文档 部分。

· 更新 CAN接收.c, 心跳.c 和

状态请求.c examp莱斯与

Windows.mk 和 Linux.mk 制作 files.
1.0A 1.0.xx 2月XNUMX日

2017

 奥莱克·博古什 · 在 SSP 内容 添加了解锁分发 .zip 的请求 file 在 Windows 中。
1.0 1.0.xx 27 年 2016 月 XNUMX 日 奥莱克·博古什 · 初始发行。

我们的产品

  • AC / DC电源
  • 执行器控制/接口
  • 汽车以太网接口
  • 电池充电器
  • CAN 控制器、路由器、中继器
  • CAN/WiFi、CAN/蓝牙、路由器
  • 电流/体积tage/PWM 转换器
  • DC/DC电源转换器
  • 发动机温度扫描仪
  • 以太网/CAN 转换器、网关、交换机
  • 风扇驱动控制器
  • 网关、CAN/Modbus、RS-232
  • 陀螺仪、倾角仪
  • 液压阀门控制器
  • 三轴倾角仪
  • 输入/输出控制
  • LVDT 信号转换器
  • 机器控制
  • Modbus、RS-422、RS-485 控制
  • 电机控制、逆变器
  • 电源，DC/DC，AC/DC
  • PWM 信号转换器/隔离器
  • 旋转变压器信号调节器
  • 服务工具
  • 信号调节器、转换器
  • 应变计 CAN 控制
  • 浪涌抑制器

我们的公司
Axiomatic 为非公路用车、商用车、电动车、发电机组、物料搬运、可再生能源和工业 OEM 市场提供电子机器控制组件。 我们通过工程化和现成的机器控制进行创新，为我们的客户增加价值。

优质的设计和制造
我们在加拿大拥有通过 ISO9001:2015 认证的设计/制造工厂。

保修、应用批准/限制

Axiomatic Technologies Corporation 保留随时对其产品和服务进行更正、修改、增强、改进和其他更改的权利，以及在不另行通知的情况下终止任何产品或服务的权利。 客户应在下订单前获取最新的相关信息，并应验证该等信息是最新且完整的。 用户应确信该产品适合在预期应用中使用。 我们的所有产品均针对材料和工艺缺陷提供有限保修。 请参阅我们的保修、应用批准/限制和退货流程： https://www.axiomatic.com/service/.

遵守
产品合规性详细信息可在产品文献和/或 axiomatic.com 上找到。 如有任何疑问，请发送至 sales@axiomatic.com.

安全使用
所有产品均应由 Axiomatic 提供服务。 请勿自行打开产品并进行维修

服务
所有要退回 Axiomatic 的产品都需要退货材料授权号 (RMA#) sales@axiomatic.com。 请求 RMA 编号时，请提供以下信息：

  • 序列号、零件号
  • 运行时间、问题描述
  • 根据需要接线设置图、应用和其他注释

处理
公理化产品是电子垃圾。 请遵守当地环境废物和回收法律、法规和政策，安全处置或回收电子废物

联系方式
Axiomatic Technologies Corporation 1445 Courtneypark Dr. E. Mississauga, ON CANADA L5T 2E3

Axiomatic Technologies Oy Höytämöntie 6 33880 Lempäälä 芬兰

文件/资源

AXIOMATIC AX140910 CAN-ENET 软件支持包 [pdf] 用户手册
UMAX140910、AX140910、AX140910 CAN-ENET 软件支持包、AX140910 软件支持包、CAN-ENET 软件支持包、软件支持包、软件包、支持包、包

参考

相关文章

发表评论

您的电子邮件地址不会被公开。 必填字段已标记 *