"SecureKey91.exe" Readme

Introduction
SecureKey91.exe is an example program that reads/writes the DS1991 iButton.  It contains 3 password-protected memory areas (called "subkeys" or "secure subkeys").

This particular example was written in Microsoft VB.NET (Visual Studio 2005).

Requirements
1-Wire Drivers version 4.00 or higher, with the OneWireAPI.NET.dll in the same directory as the executable.

 

.NET Framework 2.0 Redistributable:


Visual J# .NET 2.0 Second Edition Redistributable:


When compiling this program, make sure that the program references “vjslib”, and the OneWireAPI.NET.dll.

 

Before running this program, make sure to set the default 1-Wire adapter settings to the preferred type (usually "{DS9490}") and number (usually "USB1").  This can be done by running the "Default 1-Wire NET.exe" program found in the 1-Wire Drivers application directory.

Operation
To run the SecureKey91.exe program, double-click on the "SecureKey91.exe" file.  This runs the program.  The main window of the program will appear containing a text box and 3 buttons.  The top of the text box shows which 1-Wire adapter and port is being used as the "Default" adapter and port.  The 3 buttons on the main window of MemoryBanks.exe are titled "Find and set all DS1991 passwords", "Write the secure subkeys", and "Read the secure subkeys".  Clicking on "Find and set all DS1991 passwords" will set the passwords of the three subkeys to the hard-coded password, "password", with the hard-coded id of "ds1991id". Clicking on "Write the secure subkeys" button writes the hard-coded buffer "testing 123" to each subkey.  Finally, clicking on the "Read the secure subkeys" button will read the secure subkeys and print the contents to the text box.

Files

AssemblyInfo.vb                    - VB.NET module containing version strings

FormSecureKey.Designer.vb          - VB.NET module containing prototype code

FormSecureKey.resx                 - VB.NET resources file

FormSecureKey.vb                   - VB.NET module containing most of the 1-Wire code

Readme.html                        - This file.

SecureKey91.sln                    - Visual Studio.NET solutions file

SecureKey91.vbproj                 - VB.NET project file

SecureKey91.vbproj.user            - VB.NET file project user file

SecureKey91.vb                     - VB module containing source to program

..\..\..\..\Lib\OW.NET\OneWireAPI.NET.dll - 1-Wire API

..\bin\SecureKey91.exe             - Program executable.