#cyphal #transport-layer #uavcan #uav #distributed-computing #can

no-std canadensis_can

Cyphal实现:Cyphal/CAN (CAN和CAN FD) 传输层

5个不稳定版本

0.3.0 2023年3月30日
0.2.2 2022年10月18日
0.2.1 2022年4月12日
0.2.0 2021年10月31日
0.1.0 2021年7月11日

#1648 in 嵌入式开发

34 每月下载量
用于 3 软件包

MIT/Apache

230KB
4.5K SLoC

Canadensis:Cyphal实现

本项目实现了(Cyphal的大部分功能) (之前称为UAVCAN v1.0)。正如Cyphal网站所解释的,“Cyphal是一种基于现代网络标准(以太网、CAN FD等)的实时车内分布式计算和通信的开放技术。它的创建是为了解决下一代智能车辆(有人和无人飞机、航天器、机器人、汽车等)在船上的确定性和数据分布的挑战。”

这是一个独立的项目,与Cyphal联盟无关。

子模块说明

此仓库使用子模块进行公共规范数据类型。克隆时,请使用git clone --recursive。如果您已使用非递归选项克隆了仓库,请运行git submodule init,然后运行git submodule update。否则,某些测试将失败。

已发布软件包

软件包 描述
canadensis (文档) 包含所有核心传输无关功能的库
canadensis_data_types (文档) Rust类型对应于Cyphal公共规范数据类型
canadensis_can (文档) Cyphal/CAN传输
canadensis_bxcan (文档) bxCAN嵌入式CAN控制器的兼容性
canadensis_linux (文档) Linux SocketCAN接口兼容性
canadensis_serial (文档) 实验性Cyphal/串行传输
canadensis_udp (文档) 实验性Cyphal/UDP传输
canadensis_pnp_client (文档) 用于即插即用节点ID分配的客户端库
canadensis_crc (文档) 访问软件镜像CRC
canadensis_write_crc (文档) 一个用于计算和写入软件镜像CRC的工具,用于与canadensis_crc一起使用
canadensis_codegen_rust (文档) 一个生成Rust数据类型和序列化代码的DSDL处理器
canadensis_macro (文档) 一个生成Rust数据类型和序列化代码的宏,从内联和/或外部DSDL文件生成

其他crate(canadensis_bit_length_setcanadensis_corecanadensis_derive_register_blockcanadensis_dsdl_frontendcanadensis_dsdl_parsercanadensis_encodingcanadensis_filter_config)在不同地方被重导出,所以通常您不需要直接依赖它们。

状态

此代码旨在符合Cyphal规范版本1.0-beta。

大部分功能正常工作。一些部分尚未完成

  • 有一些测试,但可能在尚未测试的领域存在一些错误。
  • 可以减少动态内存分配的数量,或者至少更好地记录。
  • 需要更好的文档

原则

  • 在嵌入式设备上运行
  • 使用动态内存分配,但仅当必要时
  • 支持Cyphal/CAN(经典CAN和CAN FD)
  • 支持Cyphal/串行和Cyphal/UDP(这些传输尚未完全指定,但canadensis实现与发布时的pycyphal兼容)

许可证

以下任一许可证下

由您选择。

贡献

除非您明确声明,否则根据Apache-2.0许可证定义,您有意提交的任何贡献,均应双授权,无任何附加条款或条件。


lib.rs:

Cyphal的CAN和CAN FD传输

此库实现了Cyphal/CAN传输层。它将传输分割成帧,将帧重新组装成传输,并跟踪订阅。

依赖关系

~2.5MB
~53K SLoC