本页翻译不是最新的。点击此处可查看最新英文版本。

Lamp

显示反映信号灯上信号值的颜色

• 

×

库:
Simulink / Dashboard

描述

Lamp 模块会显示一种颜色，用来指示其所连接的信号的值。要配置 Lamp 模块以提供仿真期间所需的信息，请指定一个或多个状态，这些状态将信号值与要显示的 Lamp 模块的颜色配对。您可以将 Lamp 模块与其他 Dashboard 模块结合使用，为您的模型构建包含各种控件和指示器的交互式控制板。

信号灯图标

您可以通过选择一个内置图标或上传您自己的自定义图标来更改 Lamp 模块的外观。内置图标包括基本形状、汽车指示灯和无线图标。您可以使用图标参数或使用工具条中的模块选项卡来更改 Lamp 模块的图标。Dashboard 库还包含为每个图标提供预配置的 Lamp 模块版本的库。有关完整的详细信息，请参阅图标。

如果您要自定义 Lamp 模块的外观（该外观无法通过选择图标来实现），请考虑使用 Customizable Blocks 库中的 Lamp 模块来设计您自己的指示灯。

连接 Dashboard 模块

Dashboard 模块不使用端口来连接到模型元素。要将 Dashboard 模块连接到模型中的信号，请使用连接模式。连接模式有助于在模型中连接 Dashboard 模块，尤其是需要一次连接多个模块时。要连接单个 Dashboard 模块，还可以使用模块对话框中的连接表。

提示

您可以在普通和加速模式仿真期间修改 Dashboard 模块连接。

要进入连接模式，请在画布中选择要连接的 Dashboard 模块。在 Simulink^® 工具条上，会出现以所选模块的类型命名的选项卡。在模块选项卡上，点击连接。在连接模式下，当您选择一个或多个信号或模块时，会出现可用于连接的信号的列表。从列表中选择信号以连接到所选 Dashboard 模块。要连接另一个 Dashboard 模块，请在要连接的模块上悬停并点击其上方的连接按钮。然后，在模型中选择一个或多个信号和模块，并选择要连接的信号。

完成模型中 Dashboard 模块的连接后，在模块选项卡上，点击完成连接。

提示

您可以使用具有 ShowInitialText 模块参数的 set_param 函数隐藏在未连接的模块上显示的消息。当您连接模块时，消息也会消失。

示例

容错燃油控制系统建模

此示例说明如何结合使用 Stateflow® 和 Simulink® 来高效地进行混合系统建模。这种类型的建模对于具有基于离散事件的多种可能运行模式的系统特别有用。传统的信号流在 Simulink 中处理，而控制配置的更改在 Stateflow 中实现。下面所述的模型表示汽油引擎的燃油控制系统。该系统具有很强的稳健性，因为它可以检测到单个传感器的故障，并且可以动态重新配置控制系统以实现不间断运行。

打开模型

限制

• 除了 Dashboard Scope 模块和 Display 模块之外，Dashboard 模块只能连接到实数标量信号。

• 工具条不支持面板内的模块。

• 您不能在模块对话框中使用连接表将 Dashboard 模块连接到已注释掉的模块。使用连接模式将 Dashboard 模块连接到带注释的模块时，Dashboard 模块在您取消注释模块之前不会显示连接的值。

• Dashboard 模块无法连接到引用模型中的模型元素。

• 在仿真模型层次结构时，引用模型内的 Dashboard 模块不会更新。

• Dashboard 模块不支持快速加速仿真。

• 在仿真期间，无法将 Dashboard 模块连接到 Stateflow^® 中的状态活动或图数据。

• 无法以编程方式将 Dashboard 模块连接到 Stateflow 中的状态活动或图数据。

• 由于加速模式仿真的模块简化或优化，一些信号在仿真期间没有可用的数据。要使用 Dashboard 模块查看此类信号，请标记信号以进行记录。

参数

连接 — 要连接和显示的信号

信号连接选项

使用连接表选择要连接到模块的信号。要将模块连接到信号，请执行下列步骤：

1. 在包含一个或多个信号的模型中进行选择。

2. 在表中，选择要连接的信号。

3. 点击应用。

提示

在仿真期间，可以将 Dashboard 模块连接到模型中的信号。

编程用法

模块参数：Binding

类型：Simulink.HMI.SignalSpecification

默认值：[]

状态 — 信号值和颜色对组

标量和 RGB 向量

状态将显示颜色与连接的信号值的相匹配。每个状态由状态和颜色组成。

• 状态 - 使 Lamp 模块显示指定颜色的已连接信号值。

• 颜色 - 当连接的信号值与对应的状态值匹配时信号灯的颜色。您可以从标准颜色调色板中选择，也可以使用 RGB 值指定自定义颜色。

[undefined] 状态指定当连接的信号值与状态表中指定的任何值都不匹配时，Lamp 模块的颜色。点击 + 按钮可添加另一个状态。

编程用法

要以编程方式为 Lamp 模块指定 State 和 Color 参数值，请使用包含以下字段的结构体数组：

• Value - 导致 Lamp 模块显示指定颜色指示的标量 double 信号值。

• Color - 1×3 [r g b] 向量，其值介于 0 和 1 之间，指定要显示的 Lamp 模块的颜色。

lampState1.Value = 1;
lampState1.Color = [0 0 1];
lampState2.Value = 2;
lampState2.Color = [1 0 0];
lampStates = [lampState1 lampState2];

模块参数：StateColors

类型：结构体数组

默认值：结构体

ColorDefault 参数指定当所连接信号的值与任何指定的状态值都不匹配时，Lamp 模块的颜色。将 ColorDefault 参数指定为 1×3 [r g b] 向量，其值介于 0 和 1 之间。

模块参数：ColorDefault

类型：[r g b] 向量

默认值：[0.7529 0.7529 0.7529]

图标 — Lamp 模块外观

SVG 图像

使用一个图标来配置模型中 Lamp 模块的外观。您可以从内置形状、汽车图标和无线图标中进行选择，也可以上传您自己的自定义 SVG 文件作为图标。

要查看图标选项，请在图标选项卡上选择图标类型。要使用您自己的 SVG 文件作为模块图标，请选择自定义作为图标类型并上传 SVG 文件。Lamp 模块的状态颜色可以应用于下列 SVG 元素：

• altGlyph

• circle

• ellipse

• path

• polygon

• rect

• text

• textPath

• tref

• tspan

形状图标

图标	基本形状库模块名称	编程使用的值
	Lamp	Default
	Check1	Check1
	Check2	Check2
	Check3	Check3
	Check4	Check4
	Circle	Circle
	Ex1	Ex1
	Ex2	Ex2
	Ex3	Ex3
	Ex4	Ex4
	Face	Face
	Frown1	Frown1
	Frown2	Frown2
	Hexagon	Hexagon
	Pentagon	Pentagon
	Rectangle	Rectangle
	Smile1	Smile1
	Smile2	Smile2
	Solid Face	SolidFace
	Solid Frown1	SolidFrown1
	Solid Frown2	SolidFrown2
	Solid Smile1	SolidSmile1
	Solid Smile2	SolidSmile2
	Square	Square
	Triangle	Triangle

汽车图标

图标	汽车指示灯库模块名称	编程使用的值
	Adaptive Cruise Control	AdaptiveCruiseControl
	Adaptive Cruise Control Failure	AdaptiveCruiseControlFailure
	Antilock Brake System	AntilockBrakeSystem
	Battery	Battery
	Check Engine	CheckEngine
	Check Engine2	CheckEngine2
	Cruise Control	CruiseControl
	Eco Mode	EcoMode
	Electronic Stability	ElectronicStability
	Engine	Engine
	Engine Coolant Temp	EngineCoolantTemp
	Engine Failure	EngineFailure
	Engine Heating	EngineHeating
	Engine Oil	EngineOil
	Exterior Bulb Failure	ExteriorBulbFailure
	Front Fog Light	FrontFogLight
	Fuel	Fuel
	Hazards	Hazards
	Headlamp Leveling	HeadlampLeveling
	High Beams	HighBeams
	Hill Descent Control	HillDescentControl
	Lighting Switch	LightingSwitch
	Low Beams	LowBeams
	Parking Assistance	ParkingAssistance
	Rear Fog Light	RearFogLight
	Side Lights	SideLights
	Stability Control	StabilityControl
	Stability Control Off	StabilityControlOff
	Tire Monitor	TireMonitor
	Traction Control	TractionControl
	Traction Control Off	TractionControlOff
	Traction Control Failure	TractionControlFailure
	Turn Signal Left	TurnSignalLeft
	Turn Signal Right	TurnSignalRight

无线图标

图标	图标名称	编程使用的值
	Network	Network
	Network No Signal	NetworkNoSignal
	Network Transmission	NetworkTransmission
	Network3G	Network3G
	Network4G	Network4G
	Network5G	Network5G

提示

• 您可以使用工具条中的模块选项卡更改 Lamp 模块的图标。

• Dashboard 库包含为每个图标提供预配置 Lamp 模块的库。

• 如果您要自定义 Lamp 模块的外观（该外观无法通过选择图标来实现），请考虑使用 Customizable Blocks 库中的 Lamp 模块来设计您自己的指示灯。

编程用法

模块参数：Icon

类型：字符串 | 字符向量

默认值：'Default'

标签 — 模块标签位置

Top (默认) | Bottom | Hide

模块标签的位置。当模块连接到模型中的元素时，标签是所连接的元素的名称。

编程用法

模块参数：LabelPosition

类型：字符向量

值：'Top' | 'Bottom' | 'Hide'

默认值：'Top'

不透明度 — 模块不透明度

1 (默认) | 标量

模块不透明度，指定为 0 到 1 之间的标量值。

示例: 0.5

编程用法

模块参数：Opacity

类型：标量

默认值： 1

模块特性

数据类型	Boolean | double | enumerated | fixed point | half | integer | single
直接馈通	否
多维信号	否
可变大小信号	否
过零检测	否

扩展功能

C/C++ 代码生成

使用 Simulink® Coder™ 生成 C 代码和 C++ 代码。

Dashboard 模块在代码生成中会被忽略。

版本历史记录

在 R2015a 中推出

另请参阅

MultiStateImage

主题

• 使用 Dashboard 模块对模型进行调优和可视化
• 决定如何可视化仿真数据