用户指南 3358

OneWireViewer用户指南,1.5版


摘要 : 本用户指南介绍了OneWireViewer软件程序以及如何使用该软件来评估1-Wire®iButton®器件的独有特性。

引言

OneWireViewer是一款基于Java™的软件包,用于通过个人电脑探测Maxim的1-Wire和iButton器件。1-Wire和iButton器件通过单条数据线和地参考端,按照1-Wire协议进行通信,提供几款适用于USB和串口的1-Wire适配器。OneWireViewer提供了评估1-Wire和iButton产品独有特性的用户界面,包括Thermochron® (温度记录)、Hygrochron™ (实时温度和湿度)、A/D (模/数转换)、时钟、存储器以及文件操作。

安装

关于1-Wire驱动的安装说明请参考应用笔记4373:“OneWireViewer和iButton®快速使用指南”,该操作将同时安装OneWireViewer。更多信息,请参考应用笔记5057:“OneWireViewer Tips and Tricks”的Identifying the System部分及后续章节。

卸载

请参考应用笔记5057:“OneWireViewer Tips and Tricks”的How to Install a Newer OneWireViewer Version部分。

程序主窗口

OneWireViewer的主窗口包括四个部分:Device List (左上角)、1-Wire Search Mode (左下角)、标签区域(右侧)以及菜单(顶部)。器件列表/搜索模式区域的宽度可通过水平移动与标签区域之间的垂直分割线来进行调整。 Device List/1-Wire Search Mode可通过点击器件列表右侧的小三角型图标进行删除/恢复。

程序主窗口

视图菜单

File
Close (退出程序)
快捷键为Alt-1 (代替Alt+F4)。按下Alt+F4或者Alt+1将终止程序。必须使用标准键盘的“1”才有效,不能是数字键盘。
View
Show Message Log (读取错误消息)
打开一个新窗口,其中显示设备访问记录和错误消息。

Show Tab in New Window (同时查看多个功能或器件)
若需使用该功能,请首先选择一个器件,然后选择一个可用标签。然后使用Show Tab in New Window,将选中的标签移至其自身的新窗口。然后主窗口将返回至Description标签。

Show Device Alternate Names (在器件列表中查看可选名称)
例子:在ROM ID的右侧显示Thermochron而不是DS1921G-F5。
Tools
Pick Adapter (更改通信端口和1-Wire端口适配器)
打开一个新窗口,选择一个1-Wire端口适配器、端口类型和端口号。更多信息请参考应用笔记5057:“OneWireViewer Tips and Tricks”的How to Change 1-Wire Adapters and Ports部分。

XML Tagging (加载在器件列表上能够显示的器件标签)
打开一个新窗口,选择包含正在使用器件的XML标签的文件。关于标签技术指标以及如何创建与OneWireViewer兼容的标签文件,请参见应用笔记158:“用XML实现1-Wire®标签”。

1-Wire Speed (选择要求的1-Wire速度)
允许选择标准速度或高速模式。大多数的1-Wire器件都支持这两种速度模式。若要使用高速模式,则该端口适配器也必须支持高速。如果选择了高速模式,而该端口适配器不支持高速模式,在试图连接支持高速模式的1-Wire器件时将出现错误信息。

Device Poll Rate (设置搜索1-Wire网络查找器件的频率)
速率分别为1秒、5秒、10秒、30秒、1分钟、5分钟和即时轮询。典型值为1秒,可获得最快响应。
Help
About (显示OneWireViewer的软件组件版本号)
打开一个窗口,显示下载1-Wire API和OneWireViewer源代码的站点;API版本;各种视图的版本号以及onewireviewer.properties文件存储在本地硬盘中的位置。在1-Wire API for Java Kit中OneWireViewer以源代码实例的形式提供。

视图窗口区域

Device List
区域显示网络上器件的ROM ID和器件型号/名称。1-Wire Search Mode控制列表中是否包含某器件。加入到网络的器件被添加到列表的底部。如果已经定义了XML标签(请参见上文中的视图菜单,Tools,XML Tagging部分),器件列表则显示标签而不是器件型号/名称。另外,只能应用与其标签相关的功能。

器件列表的下方显示网络上的器件总数和端口适配器的类型。在本例中,适配器为DS9097U。适配器名称上的括号{ }表示该它使用的是本地TMEX驱动。
1-Wire Search Mode (影响器件列表的内容)
Show Normal Devices
选中时,列表显示网络中的所有器件。

Show Alarming Devices
选中时,列表显示响应Conditional Search ROM命令的器件,例如,器件处于报警状态。

Show Chain Mode Devices
选中时,列表显示支持链路模式的器件。利用该功能,可检测出以链路模式连接的线性网络中所有器件的物理顺序。DS28EA00 1-Wire数字温度计器件就是一个例子。

Pause All Searching (停止/重新开始在网络中搜索加入/断开的器件)
选中时,则不再搜索1-Wire网络,降低网络通信流量(例如,有利于用示波器捕获事件),并冻结器件列表内容。如果选择了已经从网络断开的器件,则会产生一条错误消息。由于搜索暂停,所以不能访问已经加入网络但尚未包括在器件列表中的器件。若需结束暂停,请选中Show Normal Devices。
标签页区域
选中某个器件后,将显示含有该器件简短说明的Description标签。根据器件不同,可能会显示更多标签,从而操作相应器件的功能。在下方的支持的器件表格中列出了器件及相应器件功能标签页的一个清单。


1-Wire和iButton产品支持一组齐全的功能特性。下表中按家族码排序列出了适用的器件功能标签页。

支持的器件
Supported Devices Family Code Thermochron Mission Temperature Humidity Switch A to D Clock Memory File Password
DS1990A, DS1990R 01                    
DS1993L 06                
DS1992L 08                
DS1982, DS2502 09                
DS1995L 0A                
DS1985, DS2505 0B                
DS1996L 0C                
DS1920, DS1820 10                  
DS2406 12              
DS1971DS2430A¹ 14               ()  
DS28E04 1C              
DS2450 20                  
DS1921 21          
DS1822 22                  
DS1973, DS2433 23                
DS1904, DS2415 24                  
DS2438 26            
DS2417 27                  
DS18B20 28                  
DS2408 29                  
DS2431 2D                
DS2760, DS2762 30                
DS1977 37              
DS2413 3A                  
DS1922DS2422² 41       ()
DS1923 41      
DS28EA00³ 42                  
DS28EC20 43                
¹可以格式化该器件,但是没有储存文件的存储空间。
²只有DS2422支持A/D转换功能。
³该器件支持链路模式,更多信息请参见数据资料。

器件功能标签页

Thermochron (温度记录)

Thermochron标签页显示任务参数的实时信息和连接至OneWireViewer的所选Thermochron iButton的状态。用户可以开始新任务、结束(禁用)正在运行的任务、查看和下载任务温度记录、以及查看(不是下载)任务的温度柱状图和报警记录。与Mission标签页相似,Thermochron标签页只适用于DS1921系列温度记录器及其特性。另请参见上文中的支持的器件表格。

Thermochron标签页的结构包括两部分:Command (顶部)和器件数据标签(底部)。Command标签包括三个按钮,可操作器件的记录功能以及选择温度单位(°C或°F)。根据Thermochron标签页的大小不同,两个区域都可能显示滚动条。

Thermochron标签页实例

 Thermochron标签页实例

Thermochron标签页的命令
Refresh Mission Results (读取器件状态、温度、柱状图和报警记录)
可以监测进行中的任务,无需更改器件标签页。

Start New Mission (用户可以键入开始新任务所必需的数据)
该命令打开一个新窗口,用户可在其中键入下一个任务的参数。

Disable Mission (停止正在运行的任务)
该命令停止任务。收集的数据仍然存储在器件中。
当Thermochron标签页处于活动状态时,Thermochron标签页:
  • 自动读取器件状态、温度、柱状图和报警记录。
  • Status标签页上自动显示器件状态。
  • 以图表方式显示温度记录(如果打开Temperatures标签页)。
  • 以文本格式显示温度柱状图(如果打开Histogram标签页)。
  • 以文本格式显示报警记录(如果打开Alarm Log标签页)。
  • 可以在°C (默认)和°F之间改变温度单位,所选单位将被记忆。
  • 可以启动温度记录图表的自动调节功能。
  • 可以通过使用剪贴板或者保存为CSV (Excel®)文件来导出图表数据。
温度记录图形实例

温度记录图形实例

柱状图实例

柱状图实例

报警记录实例

报警记录实例

开始新任务窗口(默认)

开始新任务窗口(默认)

建议您将器件的实时时钟(RTC)与PC同步。以分钟为单位键入任务启动延迟。采样率、任务启动延迟、温度报警和反转的设置取决于任务的技术要求。指导信息请参见各自的DS1921系列数据资料。时钟报警功能与任务中的器件无关。所以可接受默认设置。

  • 报警记录中的时间参考(例如,“Low alarm started at: 21”)表示任务开始后经过的分钟数。若需确定报警发生时的日期和时间,请手动操作在任务开始日期和时间上加上显示的时间。
  • Thermochron标签页不能进行高温和低温报警搜索,所以,如果在任务期间出现温度报警,器件将不被标识为报警器件,除非还存在计时器报警。
  • 若需更新器件内报警频率和报警时间值,必须选中Enable Clock Alarm?。否则,当前设置(也就是上一个任务的设置)将在新任务中继续有效。
  • 当一个任务延续多个时区时,输出数据(剪贴板或csv文件)中显示的时间为任务的起始时间。

Mission (温度和湿度记录)

Mission标签页显示任务参数的实时信息和连接至OneWireViewer的所选温度记录器iButton的状态。用户可以开始新任务、结束(禁用)正在运行的任务、以及查看和下载任务的温度和湿度。Mission标签页与Thermochron标签页相似,但是用于DS1922系列iButton产品、DS1923 Hygrochron及其特性、以及DS2422 1-Wire温度/数据记录器。另请参见上文中的支持的器件表格。

Mission标签页的结构包括两个部分:Command (顶部)和器件数据标签(底部)。Command标签包含三个按钮,可操作器件记录功能以及选择温度单位(°C或°F)。根据Mission标签页的大小不同,两个区域中都可能显示滚动条。

Mission标签页实例

Mission标签页实例

Mission标签页的命令
Refresh Mission Results (读取器件状态、温度记录和数据记录)
可以查看正在进行的任务而无需更改器件标签页。如果该器件的密码功能被激活,用户必须首先使用密码标签页命令Set Software Passwords,才允许操作器件数据。

Start New Mission (用户可以键入开始新任务所必需的数据)
该命令打开新窗口,用户可以在该窗口键入下一个任务的参数。如果该器件的密码功能被激活,用户必须首先使用密码标签页命令Set Software Passwords,才允许操作器件数据。

Disable Mission (停止正在运行的任务)
该命令停止任务。收集的数据仍然储存在该器件中。如果该器件的密码功能被激活,用户必须首先使用密码标签页命令Set Software Passwords,才允许操作器件数据。

当Mission标签页处于活动状态时,Mission标签页:
  • 自动读取设备状态、温度记录和数据记录。
  • 在Status标签页上自动显示器件状态。
  • 以图表方式显示温度记录(如果打开了Temperature Data Log标签页)。
  • 以图表方式显示湿度或数据记录(如果打开Humidity Data LogData标签页)。
  • 可以在°C (默认)和°F之间改变温度单位,所选单位将被记忆。
  • 可以启动记录图表的自动比例调节功能。
  • 可以通过使用剪贴板或者保存为CSV (Excel)文件来导出记录数据。
温度数据记录图表实例(湿度数据记录类似)

温度数据记录图表实例(湿度数据记录类似)

开始新任务窗口(默认)

开始新任务窗口(默认)

建议您将器件的RTC与PC同步。以秒为单位键入采样率(采样间隔),以分钟为单位输入任务的Start Delay。SUTA的意思是在出现温度报警时开始任务(Start mission Upon Temperature Alarm)。采样率、任务启动延迟、分辨率、报警和反转的设置取决于任务的技术要求。指导信息请参见各自的器件数据资料。

  • Status标签页上的Mission Samples Count是指数据记录存储器中有效采样值的数量。存储器满时,该数字停止递增。
  • Total Mission Samples是指在一个任务期间的采样次数。当发生反转时,该值继续递增。
  • B1版本的器件(日期编码为2007以及更新的日期,序列号为005A900h至005C09Fh,0064200h和更高)不需要Use 1-Second Mission Test?
  • 尽管该器件被作为报警器件,但是Status标签页上并不标注Temperature High Alarm。如果出现Temperature Low Alarm,则高温和低温报警都将标注在Status标签页上。
  • 当一个任务延续多个时区时,输出数据(剪贴板或csv文件)中显示的时间为任务的起始时间。

密码

密码标签页允许用户设置、使能以及禁用1-Wire器件的密码,用户还可在此标签页中输入特定器件的读、写密码。

密码标签页包括两部分:Info (顶部)和Config (底部)。Config具有3个按钮,分别用于设置软件密码、设置器件密码以及使能/禁用1-Wire器件的密码保护功能。根据密码标签页的大小,Info部分可能会带有滚动条。

密码标签页

密码标签页

密码命令

Set Software Passwords (将器件的读、写密码输入软件)
如果该器件的密码功能被激活,则标签页需要知道密码才能访问器件。该命令提示用户在一个独立的小窗口中输入读取密码。在输入读取密码后,会提示用户输入完全操作权限的密码。当涉及具体器件的任务被关闭后,标签页并不记忆密码。密码为8个字节的十六进制字符串。

Set Device Passwords (向器件写入读取密码和完全操作权限密码)
如果用户想要激活器件的密码功能,必须首先向器件写入密码,然后激活使其生效。该命令弹出另外一个小窗口,要求用户指定/键入读取密码。在输入读取密码后,则提示用户输入完全操作权限的密码。接下来,密码会被写入至相应的器件寄存器。当涉及具体器件的任务被关闭后,标签页并不记忆密码。通过该命令输入的密码自动作为软件密码,不必再重新输入这些密码来作为软件密码。需要以8字节十六进制字符串的形式输入密码。

Enable/Disable Passwords on Device (使能或禁用器件的密码功能)
该命令使用户能够激活(使能)先前被写入至器件的密码。如果使能了密码功能,用户可以使用该命令禁用密码。该命令不会擦除设备中的密码。

Real-Time Temperature

Real-Time Temperature标签页显示连接至OneWireViewer的所选1-Wire温度器件的实时温度读数。屏幕上的实时温度记录创建自储存在PC内存上的温度数据。这与Thermochron和Mission标签页是不同的,在Thermochron和Mission标签页中,无论器件是否被连接至OneWireViewer,都在iButton内部进行温度记录。

Real-Time Temperature标签页的结构由三个部分组成:Info (顶部)、Graph (左下角)和Thermometer (右下角)。根据Real-Time Temperature标签页的大小不同,在Thermometer、Graph和Info区域可能会显示滚动条。Real-Time Temperature标签页适用于包含数字温度计的器件。器件列表请参见上文的支持的器件表格。

Real-Time Temperature标签页实例

 Real-Time Temperature标签页实例

当Real-Time Temperature标签页处于活动状态时,Real-Time Temperature标签页
  • 连续发送器件相关的命令来执行温度转换。
  • 每次转换之后都读取所选器件的温度寄存器。
  • 将器件相关的读数格式转换成约定的统一格式。
  • 以数字、图表和温度计刻度形式显示结果。
  • 根据需要可压缩图表的水平刻度以显示更多的读数。
  • 可以在°C (默认)和°F之间改变温度单位,所选单位将被记忆。
  • 可以更改温度显示的分辨率(仅限部分器件)。
  • 可以启动图表的自动比例调节功能。
  • 可以通过使用剪贴板来或者保存为CSV (Excel)文件导出图表数据。
  • 一旦发现所选器件从网络断开或者选择了其它器件,Real-Time Temperature标签页则关闭。
  • 若想在评估其它器件的同时使Real-Time Temperature标签页保持运行,首先要激活Real-Time Temperature标签页。然后在View菜单(参见程序主窗口)下选择Show Tab in New Window,这样将在新窗口中重新启动Real-Time Temperature标签页。即使器件从网络中消失,这个独立的窗口也将保持打开。
  • 对于DS1922L、DS1922T和DS1923,显示的温度读数经过软件修正。但是软件修正功能不适用于DS1922E。
  • Real-Time Temperature标签页不能读取正在执行任务的Thermochron (DS1921、DS1922或DS1923)的温度。

Real-Time Humidity

Real-Time Humidity标签页显示连接在OneWireViewer的所选1-Wire湿度器件的实时湿度读数。屏幕上的实时湿度记录创建自储存在PC内存中的湿度数据。这与Mission标签页是不同的:在Mission标签页中,无论是否连接至OneWireViewer,iButton内部都将进行湿度记录。

Real-Time Humidity标签页包括三个部分:Info (上部)、Graph (左下角)和Humidity (右下角)。根据湿度标签页的大小不同,在图形和/或湿度区域可能会显示滚动条。Real-Time Humidity标签页主要应用于DS1923。该标签页也支持其它能够被设置为测量湿度的器件。器件列表请参见上文的支持的器件表格。

Real-Time Humidity标签页实例

Real-Time Humidity标签页实例

当Real-Time Humidity标签页处于活动状态时,Real-Time Humidity标签页
  • 连续发送器件相关的命令以进行湿度转换。
  • 每次转换后,都将读取所选器件的湿度寄存器。
  • 将读数从器件相关的读数格式转换为约定的统一格式。
  • 以数值、图表和湿度刻度形式显示结果。
  • 根据需要可压缩图表的水平刻度以显示更多的读数。
  • 可以启动图表的自动比例调节功能。
  • 可以通过使用剪贴板或者保存为CSV (Excel)文件来导出图表数据。
  • 一旦发现所选器件从网络断开或者选择了其它器件,Real-Time Humidity标签页则关闭。
  • 若想在评估其它器件的同时使Real-Time Humidity标签页保持运行,首先要激活Real-Time Humidity标签页。然后在View菜单(参见程序主窗口)下选择Show Tab in New Window,这样将在新窗口中重新启动Real-Time Humidity标签页。即使器件从网络中消失,这个独立的窗口也将保持打开。
  • 若需同时查看湿度和温度,请分别在独立窗口中打开Real-Time Humidity和Real-Time Temperature标签页。
  • 对于DS1923,显示的湿度读数经过软件修正,但未经过温度或饱和漂移补偿。
  • Real-Time Humidity标签页不能读取正在执行任务的DS1923的湿度。

Switch

Switch标签页显示连接至OneWireViewer的所选1-Wire可编址开关器件的I/O通道实时信息。该信息包括通道状态、输出的逻辑电平和相关的活动锁存状态。用户可以更改(切换) I/O通道状态及清除状态锁存。多通道可编址开关器件的每路I/O通道都可以独立工作。

Switch标签页包括两个部分:Features (上部)和Channels (下部)。Features区域列出了器件相关的特征。所选器件的开关编号(也就是通道编号)由Channels区域的通道文本框编号表示。数字开关可被闭合(State = true)或打开(State = false)。Level显示开关输出上电压的等效逻辑电平。每路通道有两个与之相关的命令按钮。根据Switch标签页的大小和/或器件的不同,两个区域都可能会显示滚动条。Switch标签页适用于所有含有一路或多路电子开关的器件。关于器件列表的信息请参见上文中支持的器件表格。

Switch标签页实例

 Switch标签页实例

Switch标签页的通道命令
Toggle State (将开关状态切换为打开或关闭)
利用该命令可通过1-Wire网络更改开关状态。

Clear Activity (清除通道活动锁存)
利用该命令可通过1-Wire网络清除开关活动锁存。
当Switch标签页处于活动状态时,Switch标签页
  • 连续读取所选器件所有通道的状态。
  • 自动更新Channels区域的状态、电平和活动信息。
  • 若将开关通道作为远程数字传感器,则开关必须为关闭(State = false)。
  • 关于各个通道如何工作的详细信息请参见相关器件的数据资料。

A to D (模/数转换)

A to D标签页显示连接至OneWireViewer的所选1-Wire ADC的模拟输入实时电压读数。对于多通道ADC,用户可以选择将哪些通道包含在轮询中。

A to D标签页(适用于模/数转换器,ADC)包括两个部分:Features (上部)和Channels (下部)。Features区域列出了器件相关的特征。每个通道在Channels区域都有一个通道文本框。A to D Voltage显示模拟输入的电压读数。根据A to D标签页的大小和/或通道数的多少,两个区域都可能会显示滚动条。A to D标签页适用于含有一个或多个输入通道ADC的器件。关于器件列表的信息请参见上文中支持的器件表格。

A to D标签页实例

 A to D标签页实例

当A to D标签页处于活动状态时,A to D标签页
  • 连续读取/转换所选通道的输入电压。
  • 自动更新Channels区域内所选通道的电压读数。
  • 可以选择被监测通道(参见Include in Poll)。
  • 如果某个通道未被包含在轮询中,该通道的显示将“冻结”,并且不显示实际输入电压。
  • 通过Memory标签页能够在字节级设置电压范围、分辨率、电压报警门限和通道复用功能。更多信息请参见相应器件的数据资料。

Clock

Clock标签页显示连接至OneWireViewer的所选1-Wire器件的RTC实时读数。该标签页也显示1-Wire器件RTC与PC中RTC的时间差。用户可以将1-Wire器件的RTC与PC中的时钟同步或者暂停1-Wire器件中的RTC振荡器。

Clock标签页包括两部分:Info (上部)和Config (下部)。根据标签区域的大小,Info区域中可能会显示滚动条(水平或垂直)。当前时间的显示格式为24小时格式并带有时区。Clock标签页适用于所有含有RTC的器件。器件列表请参见上文中支持的器件表格。

Clock标签页实例

Clock标签页实例

Clock标签页实例

当Clock标签页处于活动状态时,Clock标签页
  • 连续读取所选器件的时间寄存器。
  • 将读数从器件相关的格式转换为约定的统一格式。
  • 显示器件的时间读数(每次读数自动更新)。
  • 可以停止和重新启动RTC振荡器。
  • 可以将计算机(PC或工作站)上的时间/日期复制至器件的时间寄存器(点击Synchronize Clock to PC Time),该功能也将重新启动暂停的RTC振荡器。
  • 如果1-Wire器件使用二进制计数器作为RTC (例如DS1904、DS2415和DS2417),Clock标签页则将器件时钟设置为UTC (也被称为格林威治标准时间,GMT)。如果1-Wire器件的RTC在独立的寄存器中计数秒、小时、日、月和年(例如DS1921和DS1922),Clock标签页则将器件时钟设置为当地时间。

Memory

Memory标签页以十六进制格式显示连接至OneWireViewer的所选1-Wire存储器件的所选存储块的数据。用户可以更改数据(请参见下文中的十六进制编辑器)并将其写回至1-Wire器件。

Memory标签页包括三部分:Banks (顶部)、Info (左下部)和Contents (中右部)。利用Contents区域下面的两个按钮可以重新读取所选存储块的数据(Refresh),以及将手动输入至Contents区域的数据写入至1-Wire器件(Commit Changes)。根据标签区域的大小,在Info和Contents区域可能会显示滚动条。Memory标签页适用于所有包含通用用户存储器和/或特殊功能/寄存器的所有器件。器件列表请参见上文中支持的器件表格。必须将存储块选中之后才能显示其数据(Contents)和特征(Info)。无论存储块选择如何变化,Contents区域都将被自动刷新。

Memory标签页实例(DS1922L)

Memory标签页实例(DS1922L)

当Memory标签页处于有效状态时,Memory标签页
  • 列出可用存储块的名称。
  • 显示所选存储块的特性和内容。
  • 可以更改所选存储块的内容。
  • 可以将新数据复制至所选存储块。
暂存器已被选中的Memory标签页实例

暂存器已被选中的Memory标签页实例

  • 存储块数量将及其各自名称与被查看器件的类型有关。
  • 内容区域的显示格式根据所选的器件和存储块不同而有所不同。对于大多数器件来说,每页上有2 x 16字节。对于EPROM器件,有n x 8字节(仅限于特殊功能寄存器)。对于DS1977,格式为每页2 x 32字节。
  • 如果所选存储块是暂存器,则在暂存器内容上方显示目标地址TA1、TA2和E/S字节(偏移)。对于其它存储块,根据器件不同,将会看到与存储器页相关的器件信息。
  • 若要写入器件,可在Contents区域选择要更改的字节,键入新数据,然后点击Commit Changes。该方法适用于Memory标签页上显示的所有存储块,标签页将执行必要步骤(例如,写入暂存器,复制暂存器)来更新器件存储器或寄存器。更多详细信息请参见辅助功能部分中的文本编辑器(十六进制/ASCII编辑器)。
  • 写入EPROM器件时需要支持12V编程脉冲的端口适配器。

File

File标签页显示连接至OneWireViewer的所选1-Wire存储器件的文件名称和目录结构。用户可格式化该器件,创建/删除目录和文件、编辑文件(请参见十六进制编辑器ASCII编辑器部分)、调整文件大小及将其写回至1-Wire器件。

File标签页支持1-Wire文件结构(请参考应用笔记114:“1-Wire File Structure”)。File标签页包括两个部分:Directory (中部左侧)和File Contents (中部右侧)。另外还有8个命令按钮。Directory和File Contents之间的竖线可以水平移动,从而更改区域大小。根据File标签页的大小,Directory和File Contents区域可能会显示滚动条。File标签页适用于所有含有通用用户存储器的器件。器件列表请参见上文中支持的器件表格。

File标签页实例(DS1922L)

File标签页实例(DS1922L)

File标签页命令
Format Device (在器件中创建根目录)
创建文件之前必须先将器件格式化。更多信息请参考应用笔记114 (见上文)。格式化不会擦除存储器。上次任务的数据将被最终覆盖。

Create New Directory (创建文件目录或子目录)
目录名称最长为4个ASCII字符。

Create New File (在器件中创建文件)
文件名称最长为4个ASCII字符加上0至99之间的一个数字扩展名。指定扩展名专用于特殊用途,例如:100用于增补文件(仅限于EPROM器件)。(更多信息请参见应用笔记114:“1-Wire File Structure”中的表1)。

Delete Selected (删除文件或目录)
使用该功能可删除目录中的文件项或者删除子目录。它并不清除文件内容。但是,随着文件条目或子目录的删除,通过File标签页将不能访问该文件。通过Memory标签页可在字节级恢复文件数据(见上文)。

Read Dir (读取器件目录)
显示文件和目录名。

Read File (读取并显示所选文件的内容)
能够以数据字节或文本的形式查看文件内容。点击HexAscii标签即可改变视图。

Write File (将修改写入至器件)
该功能假设文件大小未发生变化。若文件大小发生变化,请首先利用Resize File指定新文件的长度。Write File操作包括自动读回进行检验的操作。

Resize File (修改文件大小)
利用该功能可指定文件大小的字节数。如果新长度小于内容区域中字符的数量(字节),数据将被在末尾截断;如果新长度太大,将在文件的末尾附加上字节00h。首先必须读取文件才能够修改其大小。
当File标签页处于有效状态时,File标签页
  • 能够访问文件和目录的各种功能。
  • 允许选择文件或打开目录。
  • 允许修改文件内容和大小。
  • 允许向器件写入新内容。
已显示有目录和文件数据的File标签页实例

已显示有目录和文件数据的File标签页实例

  • 1-Wire文件结构可将多个器件作为一族进行格式化。所以,在格式化一个器件时,即使File标签页已经访问了该器件,也需要将其再次选中。
  • 在数据写入至文件之前,必须首先创建一个新文件。
  • 文件大小为28字节(DS1977为59字节)的倍数。利用Resize File命令修改文件大小将自动更新显示的目录区域的文件大小。将文件大小修改为0字节相当于首先删除文件然后在创建相同的文件。
  • 新文件被填充以00h字节,大小为28字节(DS1977为59字节)。
  • 若需在目录中创建文件,首先点击目录,然后使用Create New File功能。
  • 若需修改某个文件的内容(十六进制及ASCII格式),请选中待修改部分(字节/字符),键入新内容,然后点击Write File。若是在ASCII标签页编辑文件,当文件被写回至器件时将自动修改其大小。更多详细信息请参见辅助功能File标签页的十六进制编辑器ASCII编辑器部分。
  • 写入EPROM器件时需要一个支持12V编程脉冲的端口适配器。
  • 当访问另一个器件时,文件内容区域仍然会显示最近访问的文件数据内容。
  • 若需将磁盘文件复制至File标签页或者进行反向操作时,请使用操作系统的编辑、复制和粘贴功能。

辅助功能

十六进制编辑器

在Memory标签页中,用户能够以十六进制格式输入数据。当选中Hex标签页时,File标签页将认为输入的为十六进制。可通过三种方式使用十六进制编辑器:
  1. 修改:选中一个或多个字节,然后替换成相同数量的新字节。
  2. 删除:选中一个或多个字节,然后将其删除。
  3. 插入:将光标定位在内容区域中的字节之间,然后输入一个或多个字节。
对于特殊功能寄存器或EPROM器件,只能修改(覆盖)字节,不能插入或删除字节。

Memory标签页的十六进制编辑器
编辑区域 该标签页Contents区域中以白色背景显示的所有区域。每个区域均被视作一个独立项。在提交修改之前,可更新多个区域。
修改数据 利用光标选中编辑区域中一定数量的相邻字节,然后输入与所选字节数量相同的新字节。输入数据将覆盖所选范围,并将背景颜色修改为黄色。完成后,点击Commit Changes。
删除数据 利用光标选中编辑区域中一个或多个相邻字节,然后按下键盘上的“delete”键。这将删除编辑区域内选中的字节,并将受影响区域的背景颜色修改为黄色。完成后点击Commit Changes。标签页将提示用户是否将受影响区域填充以字节00h。这种填充操作并不实际发生,并且受影响区域末尾的数据保持不变。该区域中的所有其它数据向左移(低地址),移动的字节数等于被删除的字节数。
插入数据 将光标定位在编辑区域的某个区域,然后键入要插入的数据。该区域的背景颜色将被改为黄色,并将现有数据移至区域外的光标右侧。完成后点击Commit Changes。
检验数据 点击Refresh按钮,然后滚动至编辑区域的更新区域。
错误处理 可接受0至9之间的数字和A至F之间的字符(大/小写)。可在编辑区域输入其它字符,但是不会被写入至器件。字节之间的空格是可选的,并被作为分隔符。

File标签页的十六进制编辑器
编辑区域 该标签页的Hex标签页中的多行16字节;最后一行可稍短(部分可编辑)。每行均被作为一个独立项。在提交修改之前,可更新多行。可根据需要利用Resize按钮设置编辑区域的大小。在以下的说明中,假设编辑区域中含有数据,这些数据是通过选中目录区域中的某个文件然后点击Read File按钮而获得的。
修改数据 利用光标选中编辑区域中一定数量的相邻字节,然后输入与所选字节数量相同的新字节。输入的数据将覆盖所选范围,并将背景颜色修改为黄色。完成后,点击Write File。
删除数据 利用光标选中编辑区域中一个或多个相邻字节,然后按下键盘上的“delete”键。这将删除编辑区域内所选的字节,并将受影响区域的背景颜色修改为黄色。完成后点击Write File。在末尾不进行填充,末尾被删除的数据保持不变。行内的其它数据被向左移动(较低地址),移动字节数等于被删除的字节数。
插入数据 将光标定位在编辑区域的某行,然后键入要插入的数据。该区域的背景颜色将被改为黄色,并将现有数据移至区域外的光标右侧。完成后点击Write File。
检验数据 写入之后,文件将被自动读回并显示其数据。
错误处理 可接受0至9之间的数字和A至F之间的字符(大/小写)。可在编辑区域输入其它字符,但是若尝试将文件写入至器件,将会显示一个错误消息。字节之间的空格是可选的,并被作为分隔符。

ASCII编辑器(仅限File标签页)
编辑区域 这是该标签页的ASCII标签页中一块大空白区域。可利用Resize按钮更改文件大小。在以下的说明中,假设编辑区域中填充有“空白”或者含有数据,这些数据是通过选中目录区域中的某个文件后点击Read File按钮而获得的。
修改数据 利用光标选中编辑区域中一定数量的相邻字符,然后输入与所选字符数量相同的新字符。输入数据将覆盖所选范围。完成后点击Write File。
删除数据 利用光标选中编辑区域中一个或多个字符,然后按下键盘上的“delete”键。这将删除编辑区域内所选的字符。完成后点击Write File。并不在末尾填充,而是自动调整文件大小。
插入数据 将光标定位在编辑区域,然后键入要插入的文本。不会删除文本。结束后点击Write File。文件将自动调整大小。
检验数据 写入之后,文件将被自动读回并显示其数据。
错误处理 可接受所有的字符,包括英文键盘上没有的字符。

附录A. 1-Wire端口适配器

下表列出了OneWireViewer支持的1-Wire适配器。在Short Reference栏中列出的名称用于在编程设置时识别适配器的种类。DS9097E是一款较早的适配器,它依赖于控制COM端口的UART位定时。这种方法在应用笔记214:“Using a UART to Implement a 1-Wire Bus Master”中做了说明。

1-Wire端口适配器一览表
Port Type Short Reference Ordering Part Number Extended Features
COM DS9097U DS9097U-009#
DS9097U-S09#
DS1411-009#
DS1411-S09#
Overdrive, power delivery, built-in serial number (009-suffix only)
COM DS9097U DS9097U-E25# Overdrive, power delivery, EPROM programming (12V)
COM DS9097E* DS9097E# EPROM programming (12V)
COM DS9097E* DS9097#
DS1413#
None
USB DS9490 DS9490B#
DS9490R#
Overdrive, power delivery, built-in serial number
USB DS9481R DS9481R-3C7+ Overdrive, power delivery, EPROM programming (12V, 7V)
*不推荐用于新的设计。

扩展特性

高速模式
标准的1-Wire数据率为15.3kbps。所有的iButton和1-Wire器件都支持这一通信速率。大多数1-Wire器件还支持高速模式,典型为125kbps。

电源输出
大多数iButton和1-Wire器件都采用寄生供电,这意味着其工作电源来自于通信期间的1-Wire网络。然而有些器件需要的电能大于这种方式所能提供的能量。对于这些器件,请选择一款具有电源输出的适配器。

EPROM编程
一次性可编程(OTP)的iButton和1-Wire器件采用了被称为电可编程只读存储器(EPROM)技术。EPROM编程需要12V编程脉冲进行写入。尽管所有的适配器均可读取EPROM iButton,但是只有具备EPROM编程能力的适配器才能对其进行写操作。

NetAdapter
NetAdapter是虚拟的1-Wire适配器,使用TCP/IP协议,允许OneWireViewer通过连接在另一台PC的1-Wire适配器通信(只要两台PC均连接至TCP/IP网络)。此外,还要求另外一台PC上运行一个主机小程序,例如:用于Java软件开发套件的1-Wire API中的“StartNetAdapterHost”演示程序。建议在主机PC上安装与1-Wire适配器相符的软件驱动程序,例如:1-Wire驱动。如需深入了解详细信息,请参见应用笔记193:“Extending 1-Wire Range with Network Proxies”。

在1-Wire适配器所在的主机PC上,必须从命令行运行StartNetAdapterHost Java程序。只需简单地将程序和OneWireAPI.jar文件复制到目录中,然后输入以下示例命令行参数即可完成:

java  -cp .;OneWireAPI.jar StartNetAdapterHost  -adapterName {DS9490}  -adapterPort USB1  -listenPort 6161  -secret secret
上述命令设置主机程序与连接至USB1的DS9490通信,并允许通过TCP/IP端口6161实现NetAdapter连接,密码设置为“secret”。在OneWireViewer客户端,按照下图所示设置NetAdapter。在“Adapter Name”区域输入“NetAdapter”,在“Adapter Port”区域输入主机的IP地址、TCP/IP端口号和密码(以冒号分隔)。

“Pick Adapter”窗口实例

"Pick Adapter"窗口实例