• 产品与解决方案
  • 行业解决方案
  • 服务
  • 支持
  • 合作伙伴
  • 关于我们

12-工业协议命令参考

目录

02-CAN命令

本章节下载 02-CAN命令  (260.57 KB)

02-CAN命令


1 CAN

1.1  CAN配置命令

1.1.1  baudrate

baudrate命令用来设置CAN接口的波特率。

undo baudrate命令用来恢复缺省情况。

【命令】

baudrate baudrate-value

undo baudrate

【缺省情况】

CAN接口波特率为1000000bps。

【视图】

CAN接口视图

【缺省用户角色】

network-admin

network-operator

【参数】

baudrate-value:CAN接口的波特率,取值为:10000、20000、40000、50000、80000、100000、125000、200000、250000、400000、500000、800000、1000000,单位为bps。

【使用指导】

CAN接口的波特率需要与CAN网络中的终端设备的波特率保持一致,才能进行通信。请根据实际情况配置CAN接口的波特率。

【举例】

# 设置CAN1/3/5接口的波特率为20000bps。

<Sysname> system-view

[Sysname] interface can 1/3/5

[Sysname-Can 1/3/5] baudrate 20000

1.1.2  can mode raw

can mode raw命令用来配置CAN接口的工作模式为透传模式,并进入CAN透传模式视图。

undo can mode命令用来恢复缺省情况。

【命令】

can mode raw

undo can mode

【缺省情况】

CAN接口无缺省工作模式。

【视图】

CAN接口视图

【缺省用户角色】

network-admin

【使用指导】

使用undo can mode时,会删除当前接口下的全部历史会话信息。

【举例】

# 配置CAN接口的工作模式为透传模式,并进入CAN透传模式视图。

<Sysname> system-view

[Sysname] interface can 1/3/5

[Sysname-Can1/3/5] can mode raw

[Sysname-Can1/3/5-can-raw]

1.1.3  can frame-filter

can frame-filter命令用来在接口上设置帧过滤。

undo can frame-filter命令用来恢复缺省情况。

【命令】

can frame-filter { standard | extended } frame-id-list

undo can frame-filter { standard | extended } frame-id-list

【缺省情况】

接收所有标准帧和扩展帧。

【视图】

CAN接口视图

【缺省用户角色】

network-admin

network-operator

【参数】

standard frame-id-list:仅接收指定ID的标准帧,其他ID的标准帧会被过滤掉。表示方式为frame-id-list= { frame-id 1 [ to frame-id 2 ] }&<1-10>。其中,frame-id为标准帧的ID,frame-id取值范围为0~4294967295。frame-id 2的取值必须大于等于frame-id 1的取值。&<1-10>表示前面的参数最多可以输入10次。

extendedframe-id-list:仅接收指定ID的扩展帧,其他ID的扩展帧会被过滤掉。表示方式为frame-id-list= { frame-id 1 [ to frame-id 2 ] }&<1-10>。其中,frame-id为标准帧的ID,frame-id取值范围为0~4294967295。frame-id 2的取值必须大于等于frame-id 1的取值。&<1-10>表示前面的参数最多可以输入10次。

【使用指导】

应用场景

CAN报文分为标准帧和扩展帧,每个CAN报文都有一个唯一的帧ID。在实际应用中,可能只需处理特定帧ID的标准帧和扩展帧,而其他帧ID的报文则不需要处理。因此,通过对CAN接口进行帧过滤,可以提高CAN总线的通信效率,并减少处理上游数据的工作量。

工作机制

通过本功能,可以实现对CAN接口接收到的标准帧和扩展帧进行过滤,仅接受指定的ID的标准帧和扩展帧。

可同时配置标准帧过滤和扩展帧过滤。

【举例】

# 设置CAN接口仅接收ID为1的标准帧。

<Sysname> system-view

[Sysname] interface can 1/3/5

[Sysname-Can1/3/5] can frame-filter standard 1

1.1.4  default

default命令用来恢复当前接口的缺省配置。

【命令】

default

 

【视图】

CAN接口视图

【缺省用户角色】

network-admin

【使用指导】

注意

接口下的某些配置恢复到缺省情况后,会对设备上当前运行的业务产生影响。建议您在执行该命令前,完全了解其对网络产生的影响。

 

您可以在执行default命令后通过display this命令确认执行效果。对于未能成功恢复缺省的配置,建议您查阅相关功能的命令手册,手工执行恢复该配置缺省情况的命令。如果操作仍然不能成功,您可以通过设备的提示信息定位原因。

【举例】

# 将CAN1/3/5恢复为缺省配置。

<Sysname> system-view

[Sysname] interface can 1/3/5

[Sysname-Can1/3/5] default

1.1.5  description

description命令用来设置当前接口的描述信息。

undo description命令用来恢复缺省情况。

【命令】

description text

undo description

【缺省情况】

接口的描述信息为“接口名 Interface”,例如:CAN1/3/5 Interface。

【视图】

CAN接口视图

【缺省用户角色】

network-admin

【参数】

text:接口的描述信息,为1~255个字符的字符串,区分大小写。

【举例】

# 设置CAN1/3/5的描述信息为“can-interface”。

<Sysname> system-view

[Sysname] interface can 1/3/5

[Sysname-Can1/3/5] description can-interface

1.1.6  display can session

display can session命令用来显示CAN接口的TCP会话信息。

【命令】

display can session [ interface interface-type interface-number ] [ history ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

interface interface-type interface-number:显示指定CAN接口的TCP会话信息。interface-type interface-number分别表示接口类型和接口编号。如果未指定本参数,则显示所有CAN接口的TCP连接信息。

history:显示CAN接口曾经连接过的TCP会话信息,每个接口最多统计10条历史连接数据。

举例】

# 显示所有CAN接口下的TCP连接信息。

<Sysname> display can session

Interface              : Can 1/3/5

 Working mode          : raw

 Connection mode       : TCP Client

 Total packets sent    : 5340

 Total packets received: 5340

 Total servers         : 2

 Server info           :

  Server address    : 55.1.1.2

    Server port     : 502

    Client address  : 55.1.1.1

    Client port     : 1788

    VPN instance    : N/A

    Connect time    : 2023/12/22 17:55:45

    Packets sent    : 3655

    Packets received: 3655

  Server address    : 55.1.1.35

    Server port     : 2788

    Client address  : 55.1.1.1

    Client port     : 1788

    VPN instance    : N/A

    Connect time    : 2023/12/22 20:21:45

    Packets sent    : 1685

    Packets received: 1685

 

Interface              : Can 1/3/6

 Working mode          : raw

 Connection mode       : TCP Server

 Server port           : 502

 Total packets sent    : 8398

 Total packets received: 8404

 Total clients         : 2

 Client info           :

  Client address    : 22.2.2.2

    Client port     : 6654

    Server address  : 22.2.2.1

    Server port     : 502

    VPN instance    : N/A

    Connect time    : 2022/10/22 17:55:45

    Packets sent    : 3655

    Packets received: 3655

  Client address    : 22.2.2.8

    Client port     : 6654

    Server address  : 22.2.2.1

    Server port     : 502

    VPN instance    : N/A

    Connect time    : 2022/10/22 18:45:01

    Packets sent    : 2755

    Packets received: 2760

# 显示指定CAN接口下的TCP历史连接信息。

<Sysname> display can session interface can 1/3/5 history

Interface : Can 1/3/5

  Index 1

    Connection mode : TCP Server

    Server address  : 55.1.1.2

    Server port     : 502

    Client address  : 55.1.1.1

    Client port     : 1788

    VPN instance    : N/A

    Connect time    : 2023/12/22 17:55:45

    Disconnect time : 2023/12/22 18:55:45

    Packets sent    : 3655

    Packets received: 3655

  Index 2

    Connection mode : TCP Client

    Server address  : 55.1.1.35

    Server port     : 2788

    Client address  : 55.1.1.1

    Client port     : 1788

    VPN instance    : N/A

    Connect time    : 2023/12/22 20:21:45

    Disconnect time : 2023/12/22 21:21:45

    Packets sent    : 1685

    Packets received: 1685

表1-1 display can session命令显示信息描述表

字段

描述

Interface

CAN接口名称

Working mode

CAN接口的工作模式,取值包括:

·     Raw:透传模式

·     Forwarding:转发模式(暂不支持)

Connection mode

CAN接口的连接模式,取值包括:

·     TCP Server:CAN接口与上位机建立TCP连接,CAN接口为TCP服务器

·     TCP Client:CAN接口与上位机建立TCP连接,CAN接口为TCP客户端

Server port

TCP服务器的端口号

Client port

TCP客户端的端口号

Total packets sent

CAN接口通过TCP连接发送的数据包总数

Total packets received

CAN接口通过TCP连接接收的数据包总数

Total clients

与CAN接口建立了TCP连接的客户端数量

Total servers

与CAN接口建立了TCP连接的服务器数量

Client info

TCP客户端信息

Server info

TCP服务器信息

Client address

TCP客户端IP地址

Server address

TCP服务器IP地址

VPN instance

TCP连接所属的VPN实例

Connect time

与TCP客户端成功建立连接的时间

Disconnect time

与TCP客户端断开连接的时间

Packets sent

CAN接口向TCP客户端或服务器发送的数据包数量

Packets received

CAN接口从TCP客户端或服务器接收的数据包数量

 

1.1.7  display interface can

display interface can命令用来显示接口的运行状态和相关信息。

【命令】

display interface can [ interface-number ] [ brief [ description ] ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

interface-number:显示指定CAN接口的信息。interface-number表示CAN接口的编号。如果不指定interface-number参数,将显示所有已创建的CAN接口的相关信息。

brief:显示接口的概要信息。不指定该参数时,将显示接口的详细信息。

description:用来显示用户配置的接口的全部描述信息。如果某接口的描述信息超过25个字符,不指定该参数时,只显示描述信息中的前25个字符,超出部分不显示。【举例】

# 查看CAN接口相关信息。

<Sysname> display interface can 1/3/5

Can 1/3/5

Current state: --

Line protocol state: --

Description: CAN1/3/5 Interface

Maximum transmission unit: 1500

Internet protocol processing: Disabled

Last link flapping: Never

Baudrate: 1000000

Standard frame filter: 1 to 20, 30, 50

Extended frame filter: -

表1-2 display interface命令显示信息描述表

字段

描述

Current state

接口当前的物理状态和管理状态,取值为--,表示不支持

Line protocol state

接口的链路层协议状态,取值为--,表示不支持

Description

接口的描述信息

Maximum transmission unit

接口的MTU

Internet protocol processing: Disabled

接口当前不能处理IP报文

Last link flapping

接口最近一次物理状态改变到现在的时长。Never表示接口从设备启动后一直处于Down状态(没有改变过)

Last link flapping

接口最近一次物理状态改变到现在的时长。Never表示接口从设备启动后一直处于Down状态(没有改变过)

Baudrate

CAN接口波特率,取值包括:

·     10000 bps

·     20000 bps

·     40000 bps

·     50000 bps

·     80000 bps

·     100000 bps

·     125000 bps

·     200000 bps

·     250000 bps

·     400000 bps

·     500000 bps

·     800000 bps

·     1000000 bps

Standard frame filter

CAN接口设置标准帧过滤,仅接收指定ID的标准帧。-表示允许接收所有标准帧

Extended frame filter

CAN接口设置扩展帧过滤,仅接收指定ID的扩展帧。-表示允许接收所有扩展帧

 

1.1.8  interface can

interface can命令用来进入CAN接口视图。

【命令】

interface can interface-number

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

interface-number:CAN接口的编号。

【举例】

# 进入CAN1/3/5接口视图。

<Sysname> system-view

[Sysname] interface can 1/3/5

[Sysname-Can1/3/5]

1.1.9  tcp client

tcp client命令用来配置CAN接口作为TCP客户端与指定上位机建立TCP连接。

undo tcp client命令用来断开CAN接口作为TCP客户端时与上位机建立的TCP连接。

【命令】

tcp client server-ip server-ip server-port server-port [ vpn-instance vpn-instance-name ]

undo tcp client [ server-ip server-ip ]

【缺省情况】

CAN接口与上位机未建立TCP连接。

【视图】

CAN接口RAW视图

【缺省用户角色】

network-admin

【参数】

server-ip server-ip:指定上位机的IPv4地址,server-ip表示TCP服务器的IPv4地址。

server-port server-port:指定上位机的端口号,server-port的取值范围为1~65534。

vpn-instance vpn-instance-name:指定上位机所属的VPN实例。如果未指定本参数,则表示上位机位于公网中。

【使用指导】

工作机制

在TCP客户端连接模式下,CAN接口作为TCP客户端与上位机建立连接。CAN接口会主动发送请求报文给本命令配置的指定上位机,并建立TCP连接。

注意事项

可以通过多次执行本命令,配置多个与CAN接口建立TCP连接的上位机,最多为同一CAN接口配置4个上位机。

同一个CAN接口下配置的多条tcp client时,server-ip不能相同。

同一CAN接口,tcp clienttcp serverudp命令(udp local-portudp peer-ip)互斥,请不要同时配置。

不能通过重复执行tcp client命令来修改指定上位机的端口号,如需修改,请先执行undo tcp client命令再重新配置。

使用undo tcp client时,如果不指定server-ip server-ip参数,则表示断开CAN接口与所有上位机建立的TCP连接。

【举例】

# 在CAN透传模式视图下,配置CAN接口作为TCP客户端,与IP地址为7.7.7.7、端口为502的TCP服务器建立TCP连接。

<Sysname> system-view

[Sysname] interface can 1/3/5

[Sysname-Can1/3/5] can mode raw

[Sysname-Can1/3/5-can-raw] tcp client server-ip 7.7.7.7 server-port 502

1.1.10  tcp server

tcp server命令用来配置CAN接口作为TCP服务器与上位机建立TCP连接。

undo tcp server命令用来断开CAN接口作为TCP服务器时与上位机建立的所有TCP连接。

【命令】

tcp server server-port server-port [ vpn-instance vpn-instance-name ]

undo tcp server

【缺省情况】

CAN接口与上位机未建立TCP连接。

【视图】

CAN接口RAW视图

【缺省用户角色】

network-admin

【参数】

server-port server-port:指定CAN接口侦听的端口号,server-port的取值范围为1~65534。

vpn-instance vpn-instance-name:指定上位机所属的VPN实例。如果未指定本参数,则表示上位机位于公网中。

【使用指导】

工作机制

在TCP服务器连接模式下,CAN接口作为TCP服务器与上位机建立连接。CAN接口会侦听来自上位机的请求报文中的目的端口号,当请求报文中的目的端口号与本命令指定的侦听端口号一致时,CAN接口才会和上位机建立TCP连接。

注意事项

请合理规划指定的端口号,避免指定其他业务已经使用的端口号,否则可能导致CAN功能或其他业务功能无法正常使用。

在不同CAN接口下通过本命令配置的端口号不能相同。

同一CAN接口,tcp clienttcp serverudp(udp local-portudp peer-ip)命令互斥,请不要同时配置。

不能通过重复执行tcp server命令来修改侦听的端口号,如需修改,请先执行undo tcp server命令再重新配置。

【举例】

# 在CAN透传模式视图下,配置CAN接口作为TCP服务器与上位机建立TCP连接,侦听的端口号为1172。

<Sysname> system-view

[Sysname] interface can 1/3/5

[Sysname-can1/3/5] can mode raw

[Sysname-can1/3/5-can-raw] tcp server server-port 1172

1.1.11  udp local-port

udp local-port命令用来配置UDP连接模式下,CAN接口侦听UDP报文的端口号。

undo udp local-port命令用来删除CAN接口侦听UDP报文的端口号。

【命令】

udp local-port local-port

undo udp local-port

【缺省情况】

未配置CAN接口侦听UDP报文的端口号。

【视图】

CAN接口RAW视图

【缺省用户角色】

network-admin

【参数】

local-port local-port:指定CAN接口侦听UDP报文的端口号,local-port的取值范围为1~65534。

【使用指导】

工作机制

在UDP连接模式下,当设备收到来自上位机的CAN报文后,会获取报文的目的端口号。当CAN接口侦听UDP报文的端口号与报文的目的端口号一致时,则会将报文转发到对应的CAN接口处理。

注意事项

本命令需要结合udp peer-ip命令配合使用,CAN接口才可以实现CAN报文的以太网透传。

请合理规划指定的端口号,避免指定其他业务已经使用的端口号,否则可能导致CAN功能或其他业务功能无法正常使用。

在不同CAN接口下通过本命令配置的端口号不能相同。

同一CAN接口,tcp clienttcp serverudp(udp local-portudp peer-ip)命令互斥,请不要同时配置。

【举例】

# 在CAN透传模式视图下,配置CAN接口侦听UDP报文的端口号为4567。

<Sysname> system-view

[Sysname] interface can 1/3/5

[Sysname-Can1/3/5] can mode raw

[Sysname-Can1/3/5-can-raw] udp local-port 4567

1.1.12  udp peer-ip

udp peer-ip命令用来配置UDP连接模式下,与CAN接口连接的上位机的信息。

undo udp命令用来删除与CAN接口连接的上位机的信息。

【命令】

udp peer-ip peer-ip peer-port peer-port [ vpn-instance vpn-instance-name ]

undo udp peer-ip [ peer-ip ]

【缺省情况】

未配置UDP连接模式下,与CAN接口连接的上位机的信息。

【视图】

CAN接口RAW视图

【缺省用户角色】

network-admin

【参数】

peer-ip peer-ip:指定上位机的IPv4地址,peer-ip表示对端UDP的IPv4地址。

peer-port peer-port:指定上位机的端口号peer-port 的取值范围为1~65534。

vpn-instance vpn-instance-name:指定上位机所在的VPN实例。如果未指定本参数,则表示上位机位于公网中。

【使用指导】

工作机制

在UDP连接模式下,当设备收到来自上位机的CAN报文后,会获取报文的目的端口号,根据端口号查找到对应的CAN接口,然后在此CAN接口查询此CAN报文中的源端口和源IP地址是否与本命令配置的匹配,若不匹配,则会丢弃报文;若匹配,则将报文转发至CAN网络。

当CAN接口收到来自CAN网络的CAN报文后,通过UDP报文发送至本命令配置的指定上位机,只有指定的上位机能够接收此UDP报文。

应用场景

本命令需要结合udp local-port命令配合使用,CAN接口才可以实现CAN报文的以太网透传。

注意事项

每个CAN接口支持最多配置4个上位机的信息,且要求peer-ip不能重复。

同一CAN接口,tcp clienttcp serverudp(udp local-portudp peer-ip)命令互斥,请不要同时配置。

使用undo udp peer-ip时,如果不指定peer-ip参数,则会删除与CAN接口连接的所有上位机的信息。

【举例】

# 在CAN透传模式视图下,配置与CAN接口建立连接的上位机的IP地址为7.7.7.7,端口号为502。

<Sysname> system-view

[Sysname] interface can 1/3/5

[Sysname-Can1/3/5] can mode raw

[Sysname-Can1/3/5-can-raw] udp peer-ip 7.7.7.7 peer-port 502

 

不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!

新华三官网
联系我们