Main Content

j1939.Channel 属性

j1939.Channel 对象的属性

全页展开

使用以下属性检查或配置 J1939 通道设置。使用 j1939Channel 创建一个通道。

设备信息

全部展开

此 属性 为只读。

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

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

数据类型: char

此 属性 为只读。

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

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

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

数据类型: char

此 属性 为只读。

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

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

数据类型: double

此 属性 为只读。

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

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

数据类型: double | char

数据详细信息

全部展开

此 属性 为只读。

ParameterGroupsAvailable 属性显示通道可接收的参数组的总数。

数据类型: double

此 属性 为只读。

ParameterGroupsReceived 属性指示自上次启动通道以来收到的参数组的总数。

数据类型: double

此 属性 为只读。

ParameterGroupsTransmitted 属性指示自上次启动通道以来传输的参数组的总数。

数据类型: double

此 属性 为只读。

FilterPassList 显示通道可以传递给网络的参数组名称和编号的列表。该列表将参数组名称和编号显示为字符向量或由字符向量和数字组成的元胞数组。

要更改值，请使用下列过滤函数之一：filterAllowOnly、filterAllowAll 或 filterBlockAll。

数据类型: char | cell

此 属性 为只读。

FilterBlockList 显示通道阻止的参数组名称和编号的列表。该列表将参数组名称和编号显示为字符向量或由字符向量和数字组成的元胞数组。要更改值，请使用一个过滤函数。

要更改值，请使用下列过滤函数之一：filterAllowOnly、filterAllowAll 或 filterBlockAll。

数据类型: char | cell

通道信息

全部展开

此 属性 为只读。

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

  • false（默认值）- 通道处于离线状态。

  • true - 通道处于在线状态。

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

数据类型: logical

此 属性 为只读。

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

  • 'N/A' - 供应商不支持此属性。

  • 'ErrorActive' - 节点在检测到错误时传输主动报错标志。注意：此状态并不表示错误一定实际存在，而是指示错误是如何处理的。

  • 'ErrorPassive' - 节点在检测到错误时传输被动报错标志。

  • 'BusOff' - 节点不在总线上传输任何内容。

数据类型: char

此 属性 为只读。

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

  • true - 具有对硬件通道的完全控制权限，可以更改属性值。

  • false - 不具有完全控制权限，不能更改属性值。

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

注意

只有在设备上创建的第一个通道会被授予初始化访问权限。

数据类型: logical

此 属性 为只读。

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

数据类型: datetime

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

  • false（默认值）- 通道处于正常或活动模式。在此模式下，通道既可以正常传输和接收报文，也可以在网络上执行其他任务，例如确认报文和创建错误帧。

  • true - 通道处于静默模式。您可以观察网络上的所有报文活动并执行分析，而不影响网络状态或行为。在此模式下，您只能接收报文而不能传输任何报文。

数据类型: logical

此 属性 为只读。

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

数据类型: char

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

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

  • high speed

  • high voltage

  • sleep

  • wake up

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

此 属性 为只读。

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

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

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

数据类型: double

此 属性 为只读。

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

注意

该属性不适用于 National Instruments CAN 设备。通道将显示 NaN 值。

数据类型: double

此 属性 为只读。

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

注意

该属性不适用于 National Instruments CAN 设备。通道将显示 NaN 值。

数据类型: double

此 属性 为只读。

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

注意

该属性不适用于 National Instruments CAN 设备。通道将显示 NaN 值。

数据类型: double

其他信息

全部展开

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

提示

使用 UserData 保存和加载对象时，为避免出现意外结果，请以简单数据类型和构造指定自定义数据。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | struct | table | cell | function_handle | categorical | datetime | duration | calendarDuration | fi
复数支持: 是

版本历史记录

在 R2015b 中推出

另请参阅

函数

属性

主题