j1939.Channel 属性
j1939.Channel
对象的属性
使用以下属性检查或配置 J1939 通道设置。使用 j1939Channel
创建一个通道。
设备信息
DeviceVendor
— 设备供应商名称
字符向量
Device
— 通道设备类型
字符向量
此 属性 为只读。
对于 National Instruments™ 设备,Device
属性显示硬件上的设备编号。
对于所有其他供应商,Device
属性显示有关 CAN 或 J1939 通道所连接的设备类型的信息。
使用 canChannel
或 j1939Channel
函数配置通道时,将自动定义值。
数据类型: char
DeviceChannelIndex
— 设备通道索引
双精度值
此 属性 为只读。
DeviceChannelIndex
属性指示已配置指定的 CAN 或 J1939 通道的通道索引。
使用 canChannel
或 j1939Channel
函数配置通道时,将自动定义值。
数据类型: double
DeviceSerialNumber
— 设备序列号
双精度值 | 字符
此 属性 为只读。
DeviceSerialNumber
属性显示连接到 CAN 或 J1939 通道的设备的序列号。
使用 canChannel
或 j1939Channel
函数配置通道时,将自动定义值。
数据类型: double
| char
数据详细信息
ParameterGroupsAvailable
— 可接收的参数组的数量
双精度值
此 属性 为只读。
ParameterGroupsAvailable
属性显示通道可接收的参数组的总数。
数据类型: double
ParameterGroupsReceived
— 通道收到的参数组的数量
双精度值
此 属性 为只读。
ParameterGroupsReceived
属性指示自上次启动通道以来收到的参数组的总数。
数据类型: double
ParameterGroupsTransmitted
— 通道传输的参数组的数量
双精度值
此 属性 为只读。
ParameterGroupsTransmitted
属性指示自上次启动通道以来传输的参数组的总数。
数据类型: double
FilterPassList
— 要传递的参数组的列表
字符 | 元胞
此 属性 为只读。
FilterPassList
显示通道可以传递给网络的参数组名称和编号的列表。该列表将参数组名称和编号显示为字符向量或由字符向量和数字组成的元胞数组。
要更改值,请使用下列过滤函数之一:filterAllowOnly
、filterAllowAll
或 filterBlockAll
。
数据类型: char
| cell
FilterBlockList
— 要阻止的参数组的列表
字符 | 元胞
此 属性 为只读。
FilterBlockList
显示通道阻止的参数组名称和编号的列表。该列表将参数组名称和编号显示为字符向量或由字符向量和数字组成的元胞数组。要更改值,请使用一个过滤函数。
要更改值,请使用下列过滤函数之一:filterAllowOnly
、filterAllowAll
或 filterBlockAll
。
数据类型: char
| cell
通道信息
Running
— 指示通道的运行状态
false
(0
) | true
(1
)
此 属性 为只读。
Running
属性通过下列值指示 CAN 或 J1939 通道的状态:
false
(默认值)- 通道处于离线状态。true
- 通道处于在线状态。
使用 start
函数将通道设置为在线状态。
数据类型: logical
BusStatus
— 总线状态
字符
此 属性 为只读。
BusStatus
属性显示有关 CAN 总线或 J1939 总线状态的信息。
'N/A'
- 供应商不支持此属性。'ErrorActive'
- 节点在检测到错误时传输主动报错标志。注意:此状态并不表示错误一定实际存在,而是指示错误是如何处理的。'ErrorPassive'
- 节点在检测到错误时传输被动报错标志。'BusOff'
- 节点不在总线上传输任何内容。
数据类型: char
InitializationAccess
— 指示设备通道的控制权限
true
(1
) | false
(0
)
此 属性 为只读。
InitializationAccess
属性根据下列值指示配置的 CAN 或 J1939 通道对象是否具有对设备通道的完全控制权限:
true
- 具有对硬件通道的完全控制权限,可以更改属性值。false
- 不具有完全控制权限,不能更改属性值。
仅当对象具有对硬件通道的完全控制权限时,您才能更改硬件通道的某些属性值。
注意
只有在设备上创建的第一个通道会被授予初始化访问权限。
数据类型: logical
InitialTimestamp
— 指示通道的开始时间
日期时间
此 属性 为只读。
InitialTimestamp
属性指示通过 start
函数将通道设置为在线状态的时间或通道收到其启动触发信号的时间。对于 National Instruments 设备,该时间从设备驱动获得;对于其他供应商的设备,该时间从运行 MATLAB 的操作系统获得。
数据类型: datetime
SilentMode
— 指定通道处于活动状态还是静默状态
false
(默认) | true
根据下列值指定通道是否以静默方式运行:
false
(默认值)- 通道处于正常或活动模式。在此模式下,通道既可以正常传输和接收报文,也可以在网络上执行其他任务,例如确认报文和创建错误帧。true
- 通道处于静默模式。您可以观察网络上的所有报文活动并执行分析,而不影响网络状态或行为。在此模式下,您只能接收报文而不能传输任何报文。
数据类型: logical
TransceiverName
— 设备收发机的名称
字符
此 属性 为只读。
TransceiverName
指示设备收发机的名称。设备收发机将进出总线的数字位流转换为总线上存在的实际电信号。
数据类型: char
TransceiverState
— 指定收发机的状态或模式
数值
如果 CAN 或 J1939 收发机允许您控制其模式,则可以使用 TransceiverState
属性设置模式。
每种模式的数值属性值由收发机制造商定义。请参阅 CAN 收发机文档以了解适当的收发机模式。通过数值代表的可能模式有:
high speed
high voltage
sleep
wake up
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
BusSpeed
— 总线传输的比特率
双精度值
此 属性 为只读。
BusSpeed
属性指示传输报文的速度(位/秒)。默认值由供应商驱动分配。
您可以使用 configBusSpeed
函数将 BusSpeed
设置为支持的比特率,从而指定通道名称和比特率值作为输入参数。例如,要将 CAN 通道对象 canch
的总线速度更改为每秒 250,000 位并查看结果,请键入
configBusSpeed(canch,250000); bs = canch.BusSpeed
数据类型: double
SJW
— 位时间段的同步跳转宽度 (SJW)
双精度值
此 属性 为只读。
SJW
显示位时间段的同步跳转宽度。为了调整芯片上的总线时钟,控制器可以将位的长度缩短或延长整数个时间段。这些位时间调整的最大值称为同步跳转宽度或 SJW
。
注意
该属性不适用于 National Instruments CAN 设备。通道将显示 NaN
值。
数据类型: double
TSEG1,TSEG2
— 允许延长和缩短采样时间的位时间段数
双精度值
此 属性 为只读。
TSEG1
和 TSEG2
属性分别指示通道重新同步或补偿网络延迟时间可延长和缩短采样时间的时间量(以位时间段为单位)。配置 CAN 通道的总线速度时,将继承该值。
注意
该属性不适用于 National Instruments CAN 设备。通道将显示 NaN
值。
数据类型: double
NumOfSamples
— 对通道可用的样本数
双精度值
此 属性 为只读。
NumOfSamples
属性是位定时参数,它指示在网络中进行一次位读取时执行的位采样数。该值是基于通道的驱动设置的一个正整数。
注意
该属性不适用于 National Instruments CAN 设备。通道将显示 NaN
值。
数据类型: double
其他信息
UserData
— 自定义数据
任何数据
使用 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 中推出
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)