Section 1: Java Installation
Begin by checking the version of Java you have installed. Open command prompt and type “java --version”.



If this says “OpenJDK” version 11 or newer skip to section 2. Otherwise, continue with Section 1. It is possible that you receive a message “Java is not recognized as an internal or external command”. This means that your system does not have java installed at all. If this is the case, then you do not need to follow the java uninstall guide and can skip to installing OpenJDK.

Due to certificate changes made by Oracle, that version of Java will no longer be compatible with OneWireViewer and will need to be uninstalled.

Open “Windows Settings” and select “Apps”

In the “Apps” page search for java and uninstall any existing versions.


Typing “java --version” into command prompt should now return the following message

We will now install OpenJDK, the java version compatible with OneWireViewer. Navigate to the OpenJDK website by clicking the link: Home | Adoptium.


From here select “Latest LTS Release” to begin the download (verified to work up to version jdk-21.0.3+9. Older versions can be downloaded via the “Other platforms and versions” button.

Once the download is complete run the “OpenJDK21U-jdk…” file to begin the java installation.

If needed select “run” in the Windows Security Warning popup.

Select “Next”.

Select “Next”.

Select “Install”.

Select “Finish” and the correct version of java should now be installed.

To confirm, type “java --version” into command prompt again and you should see the following (you may need to close and reopen command prompt).

Section 2: Install OneWireViewer and Bundled Drivers
Begin by ensuring all iButtons are disconnected from your computer.

Check to see if OneWireViewer is already installed by clicking on the windows icon in the bottom left of the taskbar. If the folder is not there, skip to the next page.

Remove pre-existing OneWireViewer folders and drivers in the “Windows Settings” > “Apps” method we used to uninstall java previously. Uninstalling “OneWireDrivers_x64” should remove both the drivers and the file folder.

To install OneWireViewer and the drivers, navigate to the following link: HERE. Select the correct version for your operating system and press the “Download” button.

In Windows, open “File Explorer” and open the “Downloads” folder on the left-hand file menu.

Drag the “install_1_wire_drivers_x64_v405” zip file from this folder to the desktop.

Right click on the zip file and select “Extract All…”

Select “Extract”.


The folder should automatically open once the file is finished extracting. Double click on the “install_1_wire_drivers_x64_v405” folder and run the “OneWireDrivers_x64” file to begin installation.


Select “Next”.

Click the “I accept the terms in the License Agreement” box and hit “Next”.

Select “Next”.

Select “Install”.

If you get a Windows Security popup select “Install”.

 

Select “Finish”.

Your OneWireViewer should now be installed. To check this, click on the Windows icon in the bottom left of the task bar and look for the “1-Wire Drivers x64” folder. Left click on the folder and you should see 5 files including “OneWireViewer.jar”

Section 3: Connecting the Correct Java Version to OneWireViewer
Next the correct java version needs to be assigned to the OneWireViewer.jar file. Click on the Windows icon in the bottom left > left click on the 1-Wire Drivers x64 folder > right click on “OneWireViewer.jar” > hover over “More” > left click on “Open File Location”

This should open the folder containing those 5 files. From there, right click on “OneWireViewer.jar” and select “Properties”

Go to the “General” Tab and select “Change…”.

Select “More Apps”.

Scroll down and select “Look for another app on this PC”

Open the “Eclipse Adoptium” folder > jkd-21.0.13.9-hotspot (or your version number of jdk) > bin > select on “javaw” (NOT “java”). Select “Open”.

Press “Apply”.

Select the “Shortcut” tab and copy (CTRL+C) the entire “Start in:” url excluding quotation marks as seen below. example: C:\Program Files\Maxim Integrated Products\1-Wire Drivers x64\

With that address copied, press “OK”.


Finally, paste the copied url into the outlined area of the figure below and press the Enter key to navigate to the folder. After navigating to the folder it should have the same files as the screenshot below.

Section 4: Install iButton USB drivers
Plug the blue USB adapter (only the adapter, do NOT connect the iButton yet) into your PC and Microsoft should automatically install the drivers. Wait for a notification to appear that the device is ready for use. If nothing happens it is possible that the device has previously been installed on your system.




Section 5: Opening OneWireViewer
With the iButton still disconnect, open OneWireViewer by double clicking the OneWireViewer JAR file within the file explorer window from Section 3. If nothing happens skip to Section 6. You should see the following screen appear.


Depending on the version of OneWireViewer installed, a different window may pop up first. Simply close that out and the above GUI should appear.

At this step you can safely connect your iButton to the USB adapter. Wait a couple seconds for it to connect and press “OK”. This should open the OneWireViewer GUI. If this opens successfully, you are done with the OneWireViewer installation guide.

If instead you see the following with the iButton connected, continue to section 6.

Section 6: OneWireViewer Won’t Open / iButton Won’t Connect
OneWireViewer.jar won’t open after the .jar file is run:
With the iButton connected, select OneWireViewer from the File Explorer window by clicking on it once. Next, click on File in the top left of the file explorer window > hover over the arrow next to “Open Windows PowerShell” and click “Open Windows PowerShell as administrator”. *NOTE* If you do not have administrator permissions on your system you can open the basic version of “Open windows PowerShell” instead. Both should work, but if the problem is an administrator permissions error, then the user version will not be able to open OneWireViewer.




PowerShell should open with the file explorer OneWireViewer path already selected. If it does not, and instead opens into the user file, do the following commands to get into the correct file location. The part in the quotation marks should be the path from file explorer where the OneWireViewer.jar application is located, and the quotation marks are needed. The commands to exit the Users colder is “cd ..” (no quotes) and to enter the correct location is cd “your path”.

Next, type (without quotes) “java -jar OneWireViewer.jar” and press enter.


The PowerShell should get filled with file locations and a Window similar to that of section 5 should pop up (again it is possible that another window will pop up first, just navigate through it to continue). Press “OK” on the “message” interface that opens. If the OneWireViewer GUI opens, then you are now done with this User Guide. If not, and the “1-Wire Net Not Available” message pops up, then continue with the guide.

Whether this worked or not, it can be helpful to create a batch file so that we do not have to open Windows Power Shell every time OneWireViewer needs to be run.

Batch File:
From the Windows search bar open “notepad” and type “java -jar OneWireViewer.jar”

In the top left of notepad press “File” and “Save As”. In the window that opens navigate to the “1-Wire Drivers x64” folder path, change the File name to “run.bat”, and Save as type to “All Files”.

Press “Save” and the run.bat batch file should be present in the 1-Wire Drivers x64 folder. In future, double click on this run.bat instead of opening Windows PowerShell.

iButton can’t connect:
First, ensure that the iButton is correctly embedded in the socket and that it is connected to your computer.
Next, we’ll check that the device drivers are being installed correctly. Open “Device Manager” by searching in the Windows taskbar. You should see a 1-Wire option at the top which indicates the drivers installed correctly, an example of this is in the figure below. If you do not see this device, then continue with the guide. Sometimes the “1-Wire” subheading is present, but the device appears as “Unknown device” within the 1-Wire subheading. This is an error and the below steps must be done to fix the issue.

Look for a subfolder called “Other Devices”. Click the arrow to expand and there should be a device called “Unknown device”.


Right click on the “Unknown device” and select “Properties”. Select the “Driver” tab. If the option is available press “Update Driver”. If not, go back to the general tab and press the “Change settings” button at the bottom left of the UI. Now click on the “Driver’ tab and press “Update Driver”

Select “Browse my computer for drivers”


Select “Browse”


Next in the “Browse For Folder” window that opens navigate the file explorer path that the OnewireViewer.jar folder is located in. In my system this is Windows (C:) > Program Files > Maxim Integrated Products > 1-Wire Drivers x64. Select the WinUSB_Driver folder and press “OK”. Press “Next” and the drivers should correctly install. The “1-Wire” option should now appear in Windows device manager. Close out device manager and start the Windows PowerShell or the run.bat file to launch OneWireViewer. Navigate the message popup as previously done and OnewireViewer should open with the iButton connected.