开发设备驱动程序—Wolfram 语言参考资料

link管理

链接快照平台

输入网页链接，自动生成快照
标签化管理网页链接

相关文章推荐

善良的红茶 · SQLPrepare 函数 - ODBC ...· 1 月前 ·

一身肌肉的莲藕 · VS2022创建CLR调用OpenCv ...· 1 月前 ·

绅士的电脑桌 · useState使用ref从父函数组件传递时 ...· 1 月前 ·

深沉的大白菜 · 深入 React 的 setState ...· 1 月前 ·

威武的马克杯 · react相关面试知识点总结 - ...· 1 月前 ·

跑龙套的荔枝 · 国际奥数竞赛全员满分，23次世界第一！奥数强 ...· 8 月前 ·

要出家的移动电源 · 教学一体机价格由什么因素决定- 品牌排名- 皓丽· 1 年前 ·

小胡子的李子 · 网格设计- 书有新旧，但文字没有· 1 年前 ·

害羞的小熊猫 · 最爱- 知乎· 1 年前 ·

聪明伶俐的柠檬 · 我国民族区域自治制度的历史及其发展_中国人大网· 1 年前 ·

对于大多数设备，组成 “ 框架 ” 的函数并不直接关注设备编程或底层硬件通讯软件. 基于硬件设备的不同，这种实现也会不一样. 例如，它可能会包含用 C 编写底层设备程序（或由第三方提供），然后使用 WSTP API 把这些程序的接口连接到程序包级别的 Wolfram 语言函数. 这些函数会由 “ 框架 ” 以合适的方式串起来，创建 Wolfram 语言设备驱动程序. 另一种实现方法是可能完全避免底层的 C 编程，使用 Wolfram 语言的 .NET/Link 功能，从 Wolfram 语言函数内部的驱动程序级别与设备交互. “ 框架 ” 的职能就是整合这些函数，通过用户级函数的集合，提供与设备接口的统一方法.

综述

创建设备驱动程序和封装与设备低级交互的开发级函数收集在 DeviceFramework` 上下文，详情请参阅 “ 设备框架函数 ” . 设备驱动程序的核心是函数 DeviceClassRegister .

DeviceFramework`DeviceClassRegister [ " class " , opts ]

对指定的类注册设备驱动程序，它的操作由选项 opts 定义

DeviceFramework`DeviceClassRegister [ " class " , " parent " , opts ]

注册与 parent 相同的类，除了由选项 opts 定义的操作

创建设备驱动程序.

一个参变量格式 DeviceClassRegister [ " class " , opts ] 创建一个典型的驱动程序，两个参变量格式 DeviceClassRegister [ " class " , " parent " , opts ] 实现基本的继承并允许你扩展父类而无需重复它的定义.

该驱动程序只实现一个读操作. 这类设备不可以写：

"ConfigureFunction" None

如何配置设备

"ReadFunction" None

如何从设备中读取

"ReadBufferFunction" None

如何从设备缓冲区中读取

"WriteFunction" None

如何写入设备

"WriteBufferFunction" None

如何写入设备缓冲区

"ExecuteFunction" None

如何在设备中执行命令

"ExecuteAsynchronousFunction" None

如何异步执行命令

"CloseFunction" None

关闭设备执行的函数

"Properties" { }

标准化的属性

"DeviceIconFunction" None

如何为设备对象创建图标

"DriverVersion" Missing [ "NotAvailable" ]

驱动程序的版本号

重要的设备驱动程序选项.

更一般的工作流可能涉及在打开设备前创建设备管理器（初始化对象和它的句柄），在给用户公开一个新的设备对象之前预配置设备属性. 在设备关闭后，初始化对象会在释放阶段被处理.

也可以为设置和获取标准化设备属性定义句柄，公开原始设备属性和方法，并让用户访问与设备关联的输入和输出流. 驱动程序可以为创建多个设备类以及指定其他自定义句柄定义规则.

选项

默认值

"OpenManagerFunction" None

执行打开设备管理器的函数

"MakeManagerHandleFunction" Identity

如何为设备管理器创建句柄

"PreconfigureFunction" { } &

如何预配置一个新设备

"ReleaseFunction" Null &

如何处理设备管理器对象

"ReadTimeSeriesFunction" Automatic

DeviceReadTimeSeries 句柄

"StatusLabelFunction" Automatic

如何为设备对象创建状态标签

"NativeProperties" { }

原始属性

"NativeMethods" { }

原始方法

"GetPropertyFunction" DeviceFramework`DeviceGetProperty

如何获取标准化属性

"SetPropertyFunction" DeviceFramework`DeviceSetProperty

如何设置标准化属性

"GetNativePropertyFunction" Automatic

如何获取原始属性

"SetNativePropertyFunction" Automatic

如何设置原始属性

"NativeIDFunction" None

如何获取设备的原始 ID

"OpenReadFunction" None

如何打开与设备关联的输入流

"OpenWriteFunction" None

如何打开与设备关联的输出流

"DeregisterOnClose" False

是否在设备关闭后注销设备

"Singleton" Automatic

为多个设备创建规则

高级设备驱动程序选项.

下一节将详细讨论 DeviceClassRegister 的选项. 与其他 Wolfram 语言选项一样，没有任何一个 DeviceClassRegister 选项是强制性的，在一个特定的驱动程序实现中，其中的许多选项会被省略.

下面的例子，是一个简单设备的驱动程序，可以执行设备的读取操作，且封装在一个文件中：

BeginPackage["MyDevice`"]

Begin["`Private`"]

read[__] := XXXXX

DeviceFramework`DeviceClassRegister["MyDevice", "ReadFunction"  read]

End[]

EndPackage[]

一个基本的驱动程序文件 MyDevice.m .

为了自动被框架发现, class 的 DeviceClassRegister [ " class " , … ] 语句必须存在于 Wolfram 语言程序包 class .m 中 . 注意该命名规则， DeviceClassRegister 的第一个字符串参数必须与驱动程序文件名匹配. 另外，驱动程序必须放在下列位置之一：

在当前运行的笔记本目录（ NotebookDirectory ）
在计算机系统中指定的目录 FileNameJoin [ { $InstallationDirectory , "SystemFiles" , "Devices" , "DeviceDrivers" } ]
$Path 中的任何位置
在数据包的服务器或在驱动程序的数据包目录（参见 “ 开发设备驱动程序数据包 ” ）

如果驱动程序没有遵循这个规则，它仍然可以被使用，但是它必须被明确加载进 Wolfram 语言会话中，例如，使用 Get .

若要使驱动程序在特定平台中可用，你可以在 If 中封装 DeviceClassRegister [ ] 语句.

该驱动程序只可以用在 Mac OS X：

设备驱动程序选项

DeviceClassRegister 的选项，也被称为 设备驱动程序选项 ，允许您创建适合设备的驱动程序. 包含 “ Function ” （驱动程序函数）单词的驱动程序选项的名称大致对应于用户级函数. 比如， "ConfigureFunction" 在执行 DeviceConfigure 时被调用， "FindFunction" 在 FindDevices 中被调用等. 然而，也有用户级函数跨越多个驱动程序函数，如下所示. 其中一个例子是设备打开序列，在 DeviceOpen 中执行，包含 "OpenManagerFunction" 、 "MakeManagerHandleFunction" 、 "OpenFunction" 和 "PreconfigureFunction" .

提供给许多驱动程序函数的第一个参量是 { ihandle , dhandle } 形式的列表，其中 ihandle 是初始化对象的句柄（或管理器句柄，参阅 "MakeManagerHandleFunction" ）， dhandle 是设备句柄（参阅 "OpenFunction" ）. 这个规则应用于 "ConfigureFunction" 、 "ReadFunction" 和其他驱动程序函数，让你使用任何必要的句柄，跳过其他句柄. 比如，如果你只需要 ihandle ，则驱动程序函数会实现为 f [ { ih_ , _ } , args___ ] := ( * use ih * ) ；若只用 dhandle ，你只需为 f [ { _ , dh_ } , args___ ] := … 提供规则；若要跳过这两个句柄，使用 f [ _ , args___ ] := … ，等等. 在下文中你会发现很多这样的用法.

剩下的提供给驱动程序函数的参变量一般是从父顶层函数传过来，可能从列表封装中剥离. 例如，对于 DeviceRead [ dev , param ] 和 DeviceRead [ dev , { param } ] ， "ReadFunction"  f 的实现会收到一个像 f [ handles , param ] 的调用；对于 DeviceRead [ dev , { param ₁ , param ₂ , … } ] ，函数会被调用为 f [ handles , param ₁ , param ₂ , … ] ；对于 DeviceRead [ dev ] ，调用形式为 f [ handles ] ，等等. 你应该期待所有父函数文档描述的组合可能，如果某些组合没有意义，会发出适当的错误信息. 如果失败，驱动程序函数会返回 $Failed ，除非那些在本教程中特殊指出的.

当报告错误时，如果你的驱动程序导出这样的符号时，习惯上，它会与你自己的用户可见符号关联信息. 或者，你可以为你的类分配信息给特殊的符号 DeviceFramework`Devices` class . 该教程给出这个规范的一些例子. 欲了解更多，请参阅 "消息" .

当然，如果你的驱动程序不能实现某些驱动程序函数，你则不用担心那些函数的错误信息. 这些信息是由框架发出的.

这个伪驱动程序没有实现任何驱动程序函数：

你可以打开一个伪设备，但是尝试执行任何特定操作均会导致错误：

在阅读本教程时，你已经注意到，大部分例子只是应用顶层的 Wolfram 语言指令. 这是有意这么做的，这样你可以重新计算范例，没有任何指定设备可以学习使用 “ 框架 ” . 实际上的驱动程序会，当然会调用外部程序. 请参阅 "调用外部程序" 获取概述以及下面的 “ 范例 ” 了解典型的应用.

除了本教程的范例，你还可以参考 Wolfram 语言文档中的演示驱动程序实现. 例如，想知道如何实现 "ExecuteAsynchronousFunction" ，请参见 DeviceExecuteAsynchronous 的演示驱动程序.

执行下面命令，查验 "ExecuteAsynchronousFunction" 的演示实现：

"FindFunction"

为了让你的驱动程序可被发现，你的驱动程序必须有 "FindFunction" 选项. "FindFunction"  f 指定 f [] 应被 FindDevices [ class ] 调用来找到给定类的设备. 函数 f 不接收参变量，应该返回 { { arg ₁₁ , arg ₁₂ , … } , { arg ₂₁ , arg ₂₂ , … } , … } 形式的输出，其中 { arg _{i

1} , arg _{i

2} , … } 是参变量的列表，它可以提供给 DeviceOpen [ class , { arg _{i

1} , arg _{i

2} , … } ] 以便打开设备号 i .

由函数 f 返回的典型参变量可以是端口名称、GPIB 地址或照相机名称. 如果设备可以无需参变量而打开，那么 f 可以返回 { { } } & .

如果驱动程序中有 "FindFunction" ，用户则可以使用你的设备类，而无需首先明确开启设备.

没有合适 "FindFunction" 的设备不会被自动发现：

在使用前，你必须打开此设备类：

通过提供 "FindFunction" 选项，驱动程序得以扩展：

这类设备可以自动被框架打开：

在执行要求的操作后，设备仍然开启，直到它们被明确关闭：

"OpenManagerFunction"

"OpenManagerFunction"  f 指定 f [ args … ] 应该在设备打开序列开始时被调用，以便创建一个初始化对象，它也被称为 “ 驱动程序管理器 ” . args 与用户提供给 DeviceOpen [ " class " , { args … } ] 的一样. 在设备寿命周期结束时，取消初始化设置阶段，返回的值会传给 "ReleaseFunction" . 使用 DeviceInitObject 在设备关闭前的任何时间获取初始化对象.

您可能希望向指定 "OpenManagerFunction" ，例如，打开一个与外部程序的 WSTP 连接. 在这种情况，该函数将返回一个 LinkObject ，您可以在 "ReleaseFunction" 中用 LinkClose 关闭.

该驱动程序保持在类中对打开设备的计数：

当设备打开（关闭）时，该计数器会增加（减少）：

"MakeManagerHandleFunction"

您可以通过指定 "MakeManagerHandleFunction"  f 创建一个单独的句柄来初始化对象（管理器句柄）. 函数 f [ obj ] 在 "OpenManagerFunction" 之后被调用，并提供由 "OpenManagerFunction" 创建的初始化对象 obj . 返回的值被假设为管理器句柄. 如果没有 "MakeManagerHandleFunction" ，管理器句柄自身会被假设为初始化对象. 管理器句柄会被传给许多驱动程序函数，作为第一个参数的一部分（见下文）.

管理器句柄会被传给许多驱动程序函数，作为第一个参变量的一部分. 在其他时候，您可以用 DeviceManagerHandle 获取句柄.

管理器句柄的例子可以是插座句柄或一个 .NET 对象 .

"OpenFunction"

由 "OpenFunction"  f 指定的函数是由框架调用的主函数，对应于用户对 DeviceOpen 的调用. f [ ihandle , args … ] 接收由 "MakeManagerHandleFunction" 创建的的管理器句柄 ihandle 以及用户提供给 DeviceOpen [ " class " , { args … } ] 的参数 args . 返回值被称为 “ 设备句柄 ” . 此句柄以及管理器句柄会被传给许多驱动程序函数. 另外，您可以用 DeviceHandle 进行检索.

框架尝试在由 "OpenFunction" 返回的设备句柄以及由 DeviceOpen 返回的顶级 DeviceObject 间维持一对一的响应. 因此强烈建议您的设备句柄是唯一的或至少不会与由其他你无法控制的驱动程序创建的句柄相冲突. 一个简单的实现方法就是用 CreateUUID 产生您的句柄. 或者，您可以以 " com . company . class "[ … ] 形式或类似方法返回句柄.

该类设备打印打开参数，没有使用 ihandle 参数：

获取设备句柄，并用它来取回设备对象：

如果省略 "OpenFunction" ，框架会为类中任何新设备分配随机的设备句柄.

该驱动程序没有实现 "OpenFunction" ：

你仍然可以使用由框架提供的默认设备句柄：

"OpenReadFunction"

"OpenReadFunction"  f 指定 f [ { ihandle , dhandle } , args … ] 应该在设备打开序列期间被调用，在 "OpenFunction" 之后，打开任何与设备相关联的输入流. 第一个参量 { ihandle , dhandle } ，是许多驱动程序函数常见的参量，其中 ihandle 是管理器句柄， dhandle 是设备句柄. 参变量 args 是那些提供给 DeviceOpen [ " class " , { args … } ] 的. 返回值必须是输入流对象或输入流对象列表.

演示驱动程序提供一个样本，实现设备的输入和输出流：

"OpenWriteFunction"

"OpenWriteFunction"  f 指定 f [ { ihandle , dhandle } , args … ] 应该在设备打开序列期间被调用，在 "OpenFunction" 之后，打开任何与设备相关联的输入流. 第一个参量 { ihandle , dhandle } ，是许多驱动程序函数常见的参量，其中 ihandle 是管理器句柄， dhandle 是设备句柄. 参变量 args 是那些提供给 DeviceOpen [ " class " , { args … } ] 的. 返回值必须是输入流对象或输入流对象列表.

演示驱动程序提供一个样本，实现设备的输入和输出流：

"PreconfigureFunction"

由 "PreconfigureFunction"  f 指定的函数决定设备打开序列. 对于将返回给用户的设备对象 dev ， f [ dev ] 被保证在成功调用 DeviceOpen 之后被调用，但是在初始化配置之前，重新应用于设备的顶层设备属性（如果之前在设备中被设置过）或设置类属性（如果由驱动程序定义）. "PreconfigureFunction" 必须通过 "PreconfigureFunction" 自身、 "OpenFunction" 或在设备打开序列中的任何其他函数返回由驱动程序配置的属性清单. 这些属性不会被框架改变直到 DeviceOpen 结束. 会返回 All 或 None .

该驱动程序基于设备 ID 设置设备属性 "parity" ：

"PreconfigureFunction" 也很方便为打开和关闭设备状态设置状态标签.

该驱动程序在20秒后自动关闭一个打开的设备，并显示时间的运行指示灯直到关闭：

"ConfigureFunction"

"ConfigureFunction"  f 指定 f [ { ihandle , dhandle } , args … ] 应该被调用以便响应顶层命令 DeviceConfigure [ dev , { args … } ] 来配置设备. 第一个参量 { ihandle , dhandle } ，是许多驱动程序函数常见的参量，其中 ihandle 是管理器句柄， dhandle 是设备句柄. 该函数的返回值被忽略.

该驱动程序中的 "ConfigureFunction" 设置顶层属性：

通过调用 DeviceConfigure 打开设备并配置：

以下是属性的新值：

"ReadFunction"

"ReadFunction"  f 指明 f [ { ihandle , dhandle } , args … ] 应该被调用以响应顶层命令 DeviceRead [ dev , { args … } ] 来从设备中读取数据. 第一个参量 { ihandle , dhandle } ，是许多驱动程序函数常见的参量，其中 ihandle 是管理器句柄， dhandle 是设备句柄. 该函数的返回值会作为 DeviceRead [ ] 命令的输出传递给用户.

该类设备从字符串中读取连续字符. 每个设备的当前字符串位置存在关联中，其中设备句柄作为关键字. 关键字添加入 "OpenFunction" 的关联中，在 "CloseFunction" 中去除：

打开设备并从中读取一个字符：

打开另一个设备并读取多个字符：

当前读取指针记录每个开启的设备：

再次从第一个设备中读取，给出下一个字符串，直到设备完整读取字符串：

关闭设备，清除计数器：

"ReadFunction" 的实现会有益于强大参变量的检验. 必要时，需要的错误信息可以分配给对应于 DeviceFramework`Devices` 上下文中类名称的符号.

该驱动程序让设备读取实数或整数随机值，并实现初步参变量检查：

打开设备并用合法参变量调用 DeviceRead ：

用非法参变量调用 DeviceRead ，触发错误：

"ReadBufferFunction" 可能的特征值.

f 的返回值会传给用户作为 DeviceReadBuffer [ ] 命令的输出.

使用 "ReadBufferFunction" 的典型范例是从串行设备中读取字节序列.

"WriteFunction"

"WriteFunction"  f 指明 f [ { ihandle , dhandle } , args … ] 应被调用以便响应顶层命令 DeviceWrite [ dev , { args … } ] ，把数据写入设备. 第一个参量 { ihandle , dhandle } ，是许多驱动程序函数常见的参量，其中 ihandle 是管理器句柄， dhandle 是设备句柄. 该函数的返回值被忽略.

该驱动程序为每个 DeviceWrite 的调用创建一个新笔记本：

打开一个设备并执行编写操作：

如果你的设备要对多个参数写值，那么把它们的值提供给 DeviceWrite 作为一个关联或一个规则集合是很常见的. 剖析这个规则的任务就落在 "WriteFunction" .

"WriteFunction" 中的剖析规则：

打开一个设备并执行一个编写操作，创建一个新的笔记本，带有指定的文本和标题，以及空白节单元：

"WriteBufferFunction"

"WriteBufferFunction"  f 指明 f [ { ihandle , dhandle } , args … ] 应被调用以响应顶层命令 DeviceWriteBuffer [ dev , { args … } ] ，把数据写入设备缓存. 第一个参量 { ihandle , dhandle } ，是许多驱动程序函数常见的参量，其中 ihandle 是管理器句柄， dhandle 是设备句柄. 该函数的返回值被忽略.

使用 "WriteBufferFunction" 的典型例子是对串行设备编写字节序列.

"ExecuteFunction"

"ExecuteFunction"  f 指明 f [ { ihandle , dhandle } , " command " , args … ] 应被调用以响应顶层命令 DeviceExecute [ dev , " command " , { args … } ] ，在设备中执行命令. 第一个参量 { ihandle , dhandle } ，是许多驱动程序函数常见的参量，其中 ihandle 是管理器句柄， dhandle 是设备句柄. 该函数的返回值会传给用户作为 DeviceExecute [ ] 命令的输出.

"ExecuteAsynchronousFunction"

"ExecuteAsynchronousFunction"  f 指明 f [ { ihandle , dhandle } , " command " , args … , fun ] 应被调用以响应顶层命令 DeviceExecuteAsynchronous [ dev , " command " , { args … } , fun ] ，在设备上开始异步执行指定的命令. 第一个参量 { ihandle , dhandle } ，是许多驱动程序函数常见的参量，其中 ihandle 是管理器句柄， dhandle 是设备句柄. 函数 f 一般会把用户指定的句柄函数 fun 传给下流，当事件发生时被执行. f 的返回值应该是 AsynchronousTaskObject [ ] 或类似的对象，会传给用户作为 DeviceExecuteAsynchronous [ ] 命令的输出.

如果 command 不被支持，函数 f 必须产生一个 Missing [ ] 对象或简单返回未计算的值. 不管怎样，框架会产生一个合适的信息. 如果是其他错误， f 必须产生合适的信息并返回 $Failed . 尤其是，如果指定的带有给定参变量的命令不能被执行.

command 可以是 "Read" 、 "Write" 、 "ReadBuffer" 、 "WriteBuffer" 或任何其他被驱动程序支持的命令.

该驱动程序异步存储 URL 的内容至一个文件：

准备一个进度函数和进度指示器：

开始异步任务并观察进程：

对于不支持的操作框架发出一个错误信息：

"CloseFunction"

"CloseFunction"  f 指明 f [ { ihandle , dhandle } ] 应被调用以响应顶层命令 DeviceClose [ dev ] ，关闭设备并释放相关资源. 第一个参量 { ihandle , dhandle } ，是许多驱动程序函数常见的参量，其中 ihandle 是管理器句柄， dhandle 是设备句柄. 该函数的返回值会传给用户作为 DeviceClose [ ] 命令的输出. 成功完成后，期待为 Null .

"CloseFunction" 一般包括关闭所有端口和套接口并释放其他资源，除了那些在 "ReleaseFunction" 中关闭的. 在 "OpenReadFunction" 和 "OpenWriteFunction" 中打开的流会自动被框架关闭，证明它们可以使用 Close 关闭. 如果不是那样，你应该在 "CloseFunction" 中关闭流.

关闭的设备仍然在当前 Wolfram 语言会话中可用. 使用 "DeregisterOnClose" 在关闭后完全去除设备.

"ReleaseFunction"

"ReleaseFunction"  f 指明 f [ obj ] 应在 "CloseFunction" 之后被调用，在 DeviceClose 操作期间，破坏由 "OpenManagerFunction" 创建的初始化对象 obj ，必要的话并执行其他剩下的清扫任务. 该函数的返回值被忽略，除非它是 $Failed .

如果你使用 "OpenManagerFunction" 打开一个与外部程序的 WSTP 连接，你可以在 "ReleaseFunction" 中关闭连接.

"DeregisterOnClose"

"DeregisterOnClose"  True 指明 DeviceClose 应该不只是释放所有外部资源，并要从当前 Wolfram 语言会话中完全去除设备. 默认情况下，使用 "DeregisterOnClose"  False ，设备仍然可用，并可以用同样的参数重新开启.

使用 "DeregisterOnClose" 选项的默认值，关闭的设备仍然可用：

框架继续跟踪打开设备所使用的参数：

你可以重新打开设备而无需指定打开的参变量：

该类设备在关闭后自动注销：

"Singleton"

"Singleton" 选项决定框架如何处理 DeviceOpen [ " class " , { args … } ] 命令，因此为多个设备设定创建规则. "Singleton" 选项可能的值如下：

crit

返回第一个注册的设备，其中 crit [ dev , { args } ] 计算为 True

为一个类中多个设备创建规则.

默认值 Automatic 等价于标准 crit 等于 SameQ [ DeviceOpenArguments [ #1 ] , #2 ] & .

使用 "Singleton"  Automatic ，只有与参变量的新集合一起调用时， DeviceOpen 才返回新的设备：

调用具有同样参变量的 DeviceOpen 给出同样的设备：

使用 "Singleton"  True ，在第一个调用之后，框架忽略所有对 DeviceOpen 的调用并返回同样的设备，不管是否使用不同的参变量进行调用：

使用 "Singleton"  False ，尽管用同样的参变量调用， DeviceOpen 也会返回新的设备：

重要的是，如果不需要打开一个新设备响应 DeviceOpen ，框架一般不会执行驱动函数的打开序列，包括 "OpenFunction" . 然而，如果指定的标准 crit 返回 True ，它会执行打开序列，但是参变量 args 不完全匹配先前打开设备的参变量. 这样让你为不同的参变量集合重新配置同样的设备.

使用该驱动程序， DeviceOpen 对每个不一样的第一个参变量返回一个新的设备：

该演示设备有一个稍微更强大的 "Singleton" 选项实现：

以下设置驱动程序. "PreconfigureFunction" 在这种情况下，告诉驱动程序跳过属性 "p" 的配置：

打开一个设备并检验其属性. 该值来自于变量 $external （也就是说，值 "x" 被忽略）：

改变属性值. “ 外部 ” 变量也改变了：

如果 “ 外部 ” 变量在本会话之外被改变（例如，用户按下设备上的按钮），下一个属性查询会提取新值：

关闭设备并再次改变设备上的外部属性：

因为没有和设备通讯，属性的报告值仍然是旧的：

当设备重新开启时，值会自动被更新：

"NativeProperties"

选项 "NativeProperties"  { property ₁ , property ₂ , … } 指明本地属性列表，一般在给定类的设备上可用. 当你希望以由框架提供的标准方式访问你的设备并希望有选项可以直接与设备工作，本地属性很有用. 本地属性的名称一般是由不受你控制的第三方程序库定义. 它们可以是任何 “ 合理的 ” Wolfram 语言表达式.

举例来说，你可能想为一个通过 .NET/Link 连接的设备使用 DeviceOpen 、 DeviceRead 、 DeviceExecute 以及其他标准 Wolfram 语言函数设置一个驱动程序，并且同时让你的用户通过 .NET/Link 接口与设备直接通信.

该演示设备提供一个样本，实现标准的和本地的属性：

"GetNativePropertyFunction"

"GetNativePropertyFunction"  f 指明 f [ dhandle , p ] 应被调用，通过设备句柄 dhandle 查询设备的本地属性 p 的值. 函数 f 应返回属性值. 默认值 Automatic 本质上等价于 Function [ { dhandle , p } , dhandle @ p ] .

演示设备提供实现 "GetNativePropertyFunction" 的样本：

"SetNativePropertyFunction"

"SetNativePropertyFunction"  f 指明 f [ dhandle , p , val ] 应被调用，设置由设备句柄 dhandle 识别的设备上的本地属性 p 值为 val . 函数的返回值被忽视. 默认值 Automatic 本质上等价于 Function [ { dhandle , p , val } , dhandle @ p = val ] .

演示设备提供实现 "SetNativePropertyFunction" 的样本：

"StatusLabelFunction"

默认情况下，框架使用 DeviceDefaultStatusLabels [ ] 为由 DeviceOpen [ class ] 打开的设备创建状态标签， DeviceDefaultStatusLabels [ p ] 用于在 DeviceOpen [ class , { p , … } ] 中带有参数 p 的设备. 你可以使用选项 "StatusLabelFunction"  f 创建你自己的标签. 函数 f [ { args } ] 会在设备准备阶段被调用，其中参变量 args 由 DeviceOpen [ " class " , { args … } ] 提供. 它必须返回一个字符串，为一个打开的设备替代标签或两个字符串 { olbl , clbl } 列表，标签 olbl 替代打开的设备，标签 clbl 替代关闭的设备.

该驱动程序实现自定义的状态标签：

构建更高级的标签，调用 "PreconfigureFunction" 中的 DeviceStatusLabels .

"DeviceIconFunction"

"DeviceIconFunction"  f 指明 f [ { ihandle , dhandle } , args … ] 应被调用，为因响应 DeviceOpen [ " class " , { args … } ] 而创建的设备对象创建一个自定义图标. 第一个参量 { ihandle , dhandle } ，是许多驱动程序函数常见的参量，其中 ihandle 是管理器句柄， dhandle 是设备句柄. 函数必须返回一个 Graphics 对象.

"DriverVersion"

使用 "DriverVersion"  num 指明驱动程序的版本号为数值 num . 如果有旧的版本，框架会自动加载最高、最新的版本. 也可能加载其他版本；请参阅 "使用驱动程序文件" .

可以用 DeviceDriverVersion 获取已加载驱动程序的版本号.

指定驱动程序的版本号并提取之：

设备框架函数

除了 DeviceClassRegister ，框架还为驱动程序文件提供函数，提取关于设备对象的用户可见的和内部的信息，访问类偏好设置以及其他实用程序.

DeviceFramework`DeviceClassRegister [ class , … ]

注册指定的类

DeviceFramework`DeviceClassClear [ class ]

清除指定的类

添加和去除驱动程序的类.

在 DeviceClassRegister 内部，它会调用 DeviceClassClear ，并在创建任何新类前，有效地去除所有存在的对指定类的定义，因此当开发驱动程序时，你可以安全地多次调用 DeviceClassRegister .

使用驱动程序文件

DeviceFramework`FindDeviceDrivers [ form ]

给出名称匹配字符串模式 form 的类的驱动程序列表

DeviceFramework`DeviceDriverLoad [ class ]

发现并加载指定类的驱动程序

DeviceFramework`DeviceDriverFile [ dev | class ]

为设备 dev 或类 class 提供当前注册的驱动程序的路径

DeviceFramework`DeviceDriverPaclet [ dev | class ]

为设备 dev 或类 class 提供当前加载的数据包驱动程序的数据包对象

DeviceFramework`DeviceDriverVersion [ dev | class ]

为设备 dev 或类 class 提供当前加载的驱动程序的版本号

运用驱动程序文件.

FindDeviceDrivers 以 { " path/to/driver " , class , version } 形式返回三元组列表. 你可以使用此信息检查驱动程序文件，而无需加载到 Wolfram 语言会话，比较不同的驱动程序版本，或加载先前的驱动程序版本，而非最近版本，均可以由 DeviceOpen 自动加载.

找出某个类别的所有可用驱动器，并在系统编辑器中打开相应的文件：

对于已加载的驱动程序，你可以使用 DeviceDriverFile 找到确切的加载文件. 这个很有用，如果你的驱动程序有多个实现，并想确保框架加载了正确的版本；或者在重新编辑后，重新加载驱动程序；或只是学习驱动程序实现的细节.

打开演示驱动程序并查找驱动程序文件：

执行下面的命令并在 Wolfram 语言会话中以笔记本形式打开驱动程序文件：

访问关于设备的用户可视信息

DeviceFramework`DeviceClass [ dev ]

返回设备 dev 的类

DeviceFramework`DeviceID [ dev ]

返回设备 dev 的 ID

DeviceFramework`DeviceStatusLabels [ dev ] , DeviceFramework`DeviceStatusLabels [ dev ] = { olbl , clbl }

为设备 dev 的打开和关闭状态，获取和设置状态标签

访问关于设备对象的用户可视信息.

你可以在设备运行的任何时间改变状态标签. 新的标签会在下次前端为你的设备对象创建用户界面时被显示. 因此，你会在设备首次呈现给用户前在 "PreconfigureFunction" 创建自定义的状态标签.

为演示设备创建一个内置状态标签：

访问关于设备的内部信息

DeviceFramework`DeviceInitObject [ dev ]

返回设备 dev 的初始化对象

DeviceFramework`DeviceManagerHandle [ dev ]

返回设备 dev 的初始化对象的句柄

DeviceFramework`DeviceHandle [ dev ]

返回设备 dev 的句柄

DeviceFramework`DeviceObjectFromHandle [ h ]

返回句柄 h 的设备对象

DeviceFramework`DeviceOpenArguments [ dev ]

返回打开设备 dev 的参量

DeviceFramework`DeviceDriverOption [ class , "opt" ] , DeviceFramework`DeviceDriverOption [ class , "opt" ] = val

获取和设置指定类的设备驱动程序选项 " opt " 的值

访问由框架保留的内部对象.

虽然 DeviceDriverOption 可以在任何时候被调用，但是在派生类中调用父函数尤其有用.

该驱动程序是基于 "RandomSignalDemo" 并调用其自身的上一层（父层）的 "ReadFunction" ：

从设备中读取，给出累积的随机值列表，其中从上一层（父层）读取，给出独立的值：

DeviceDriverOption 还让你在操作设备时，动态改变驱动程序函数值.

最初，此类的设备读取提供给 DeviceRead 的正弦参数：

以下改变驱动程序去读取锯齿波：

类属性

当框架需要在特殊的 DeviceObject 中分配标准属性时，它从 类属性 中取值. 类属性由 DeviceClassRegister 的选项 "Properties" 指定，在加载驱动程序后的任何时间均可以被访问.

DeviceFramework`DeviceClassProperties [ class ]

对指定的类返回可用属性列表

DeviceFramework`DeviceClassProperties [ class , prop ]

对指定的类返回属性 prop 的值

DeviceFramework`DeviceClassProperties [ class , { p ₁ , p ₂ , … } ]

返回多个属性的值

DeviceFramework`DeviceClassProperties [ class , prop ] = val , DeviceFramework`DeviceClassProperties [ class , { p ₁ , p ₂ , … } ] = { v ₁ , v ₂ , … }

设置指定属性的值

访问类属性.

类属性在为类创建任何设备对象前就可用：

变化设备属性不会改变类属性：

相反，改变类属性不会重置已存在设备的属性，但是它会改变类中新设备的属性：