can.Channel 属性

DeviceVendor 属性指示设备供应商的名称。

使用 canChannel 或 j1939Channel 函数配置通道时，将自动定义值。

对于 National Instruments™ 设备，Device 属性显示硬件上的设备编号。

对于所有其他供应商，Device 属性显示有关 CAN 或 J1939 通道所连接的设备类型的信息。

使用 canChannel 或 j1939Channel 函数配置通道时，将自动定义值。

DeviceChannelIndex 属性指示已配置指定的 CAN 或 J1939 通道的通道索引。

使用 canChannel 或 j1939Channel 函数配置通道时，将自动定义值。

DeviceSerialNumber 属性显示连接到 CAN 或 J1939 通道的设备的序列号。

使用 canChannel 或 j1939Channel 函数配置通道时，将自动定义值。

ProtocolMode 属性指示为 CAN 通道配置的通信协议，可以是 CAN 或 CAN FD。

该值是在使用 canChannel 函数配置通道时定义的。

Running 属性通过下列值指示 CAN 或 J1939 通道的状态：

使用 start 函数将通道设置为在线状态。

MessagesAvailable 属性显示 CAN 通道可接收的报文总数。当没有可用报文时，该值为 0。

MessagesReceived 属性指示自上次启动通道以来收到的报文总数。当没有收到报文时，该值为 0，并随通道接收的报文数递增。

MessagesTransmitted 属性指示自上次启动通道以来传输的报文总数。当没有发送报文时，默认值为 0，并随通道传输的报文数递增。

将 MessageReceivedFcn 配置为在可用报文达到所需数量时运行的回调函数，指定为字符向量、字符串或函数句柄。

MessageReceivedFcnCount 属性定义要触发所配置的 MessageReceivedFcn 运行需要达到的可用报文数。

例如，如需指定要执行的回调函数，请键入：

canch.MessageReceivedFcn = @Myfunction;

将 MessageReceivedFcnCount 配置为触发 MessageReceivedFcn 回调函数所需达到的可用报文数。

默认值为 1。您可以为 MessageReceivedFcnCount 指定一个正整数。例如，要指定触发回调所需的报文计数，请键入：

canch.MessageReceivedFcnCount = 55;

InitializationAccess 属性根据下列值指示配置的 CAN 或 J1939 通道对象是否具有对设备通道的完全控制权限：

仅当对象具有对硬件通道的完全控制权限时，您才能更改硬件通道的某些属性值。

InitialTimestamp 属性指示通过 start 函数将通道设置为在线状态的时间或通道收到其启动触发信号的时间。对于 National Instruments 设备，该时间从设备驱动获得；对于其他供应商的设备，该时间从运行 MATLAB 的操作系统获得。

指示报文接受过滤器的设置，以字符向量形式返回。此属性指示由函数 filterAllowOnly、filterAllowAll 和 filterBlockAll 实现的设置。

示例: 'Standard ID Filter: Allow All | Extended ID Filter: Allow All'

BusStatus 属性显示有关 CAN 总线或 J1939 总线状态的信息。

根据下列值指定通道是否以静默方式运行：

清除并重新创建 Kvaser 通道时，其 SilentMode 设置将保留。如果您在不支持 SilentMode 的设备上指定该模式，将会导致错误。

TransceiverName 指示设备收发机的名称。设备收发机将进出总线的数字比特流转换为总线上存在的实际电信号。

如果 CAN 或 J1939 收发机允许您控制其模式，则可以使用 TransceiverState 属性设置模式。

每种模式的数值属性值由收发机制造商定义。请参阅 CAN 收发机文档以了解适当的收发机模式。通过数值代表的可能模式有：

ReceiveErrorCount 属性指示自上次启动通道以来报文接收期间的错误总数。默认值为 0，并随错误数递增。

TransmitErrorCount 属性指示自上次启动通道以来报文传输期间的错误总数。默认值为 0，并随错误数递增。

BusSpeed 属性指示传输报文的速度（位/秒）。默认值由供应商驱动分配。

您可以使用 configBusSpeed 函数将 BusSpeed 设置为支持的比特率，从而指定通道名称和比特率值作为输入参数。例如，要将 CAN 通道对象 canch 的总线速度更改为每秒 250,000 位并查看结果，请键入

configBusSpeed(canch,250000);
bs = canch.BusSpeed

SJW 显示位时间段的同步跳转宽度。为了调整芯片上的总线时钟，控制器可以将位的长度缩短或延长整数个时间段。这些位时间调整的最大值称为同步跳转宽度或 SJW。

TSEG1 和 TSEG2 属性分别指示通道重新同步或补偿网络延迟时间可延长和缩短采样时间的时间量（以位时间段为单位）。配置 CAN 通道的总线速度时，将继承该值。

NumOfSamples 属性是位定时参数，它指示在网络中进行一次位读取时执行的位采样数。该值是基于通道的驱动设置的一个正整数。

所选设备的仲裁总线速度，以每秒位数为单位。默认速度由所选设备分配。

所选设备的数据总线速度，以每秒位数为单位。默认速度由所选设备分配。

（仅限 PEAK-System。）指定仲裁比特率的预分频器。

指定仲裁同步跳转宽度（即重新同步时的位时间调整）的最大限制。该值必须为正整数，表示位时间量子段的数量。由所选的总线速度设置来确定默认值。

指定采样点之前的位时间量子数量。该值必须为正整数。通常，此值的调整是通过对 ArbitrationTSEG2 进行对应的反向调整来实现的，因此其总和保持不变。由所选的总线速度设置来确定默认值。

指定采样点后的位时间量子数量。该值必须为正整数。通常，此值的调整是通过对 ArbitrationTSEG1 进行对应的反向调整来实现的，因此其总和保持不变。由所选的总线速度设置来确定默认值。

（仅限 PEAK-System。）指定数据比特率的预分频器。

指定数据同步跳转宽度（即重新同步时的位时间调整）的最大限制。该值必须为正整数，表示位时间量子段的数量。由所选的总线速度设置来确定默认值。

指定采样点之前的位时间量子数量。该值必须为正整数。通常，此值的调整是通过对 DataTSEG2 进行对应的反向调整来实现的，因此其总和保持不变。由所选的总线速度设置来确定默认值。

指定采样点后的位时间量子数量。该值必须为正整数。通常，此值的调整是通过对 DataTSEG1 进行对应的反向调整来实现的，因此其总和保持不变。由所选的总线速度设置来确定默认值。

BusLoad 属性提供有关 Kvaser 设备上的报文流在 CAN 网络上形成的负载的信息。CAN 网络上的当前报文流表示为 0.00% 到 100.00% 之间的一个百分比。

OnboardTermination 属性指定 NI-XNET 设备是否使用其 CAN 总线的板载终端。有关特定设备的行为和特征的详细信息，请参阅其供应商文档。

StartTriggerTerminal 属性指定同步触发信号连接，以在连接的源终端上启动 NI-XNET 通道。

要配置 NI-XNET CAN 模块（例如 NI 9862）以在外部机箱终端提供的外部信号触发事件发生时开始数据采集，请将 CAN 通道 StartTriggerTerminal 属性设置为适当的终端名称。将 NI MAX 实用工具的机箱名称与触发信号终端名称进行组合，形成属性值字符向量；例如，'/cDAQ3/PFI0'。

示例

在终端 /cDAQ3/PFI0 上配置 NI-XNET CAN 模块启动触发信号。

ch1 = canChannel('NI','CAN1')
ch1.StartTriggerTerminal = '/cDAQ3/PFI0'
start(ch1)  % Acquisition begins on hardware trigger

使用硬件触发配置时，InitialTimestamp 值表示触发 CAN 通道采集的绝对时间。收到的 CAN 报文的 Timestamp 值相对于触发时刻。

ch1.InitialTimestamp
messages = receive(ch1,Inf);
messages(1).Timestamp

Database 属性存储有关所连 CAN 数据库的信息。如果您的通道报文未连接到数据库，则属性值为空结构体 []。您可以编辑 CAN 通道的 Database 属性，但不能编辑 CAN 报文的 Database 属性。

要查看 CAN 报文所连数据库的相关信息，请键入：

message.Database

要将 CAN 通道上的数据库信息设置为 C:\Database.dbc，请键入：

channel.Database = canDatabase('C:\Database.dbc')

使用 UserData 属性输入要存储在 CAN 报文或 J1939 参数组、通道或数据库对象中的自定义数据。保存指定了 UserData 的对象时，会自动保存自定义数据。加载指定了 UserData 的对象时，会自动加载自定义数据。