Keywords: iButton, mission, recovery, data recovery, memory, 1-Wire, rollover, OneWireViewer, Public Domain Kit, PDK
This application note describes how to use the memlog utility to download the raw temperature and humidity values from the iButton® after a new mission is started. This utility does not recover iButtons with CRC or depleted battery issues.
To successfully recover data, you must have:
The iButton loggers contain mission data, but once you use the OneWireViewer to start a new mission, all previous mission information is lost. The raw data is still accessible, assuming you quickly stop the new mission to prevent it from overwriting the old data.
The memlog utility (memlog.zip) can be downloaded. Unzip the files into a folder. Plugin the DS9490R USB to iButton Adapter and double click on the run.bat file to run the application. It will prompt you to select the iButton based upon serial number.
iButton Data Log Dump for DS1921G, DS1922L/T, DS1923 MainMenu 1-Wire Memory Demo (0) Select Device (1) Quit Please enter value: 0 Device Selection (0) C7 00 00 00 33 1B 08 81 (1) F0 00 00 00 22 F0 B4 41 1
You can find the serial number information in OneWireViewer. For DS1922 and DS1923, you must select the mission settings for resolution, and for the DS1923 you also must select it if you logged humidity data. This assumes you used low resolution or high resolution for both the temperature and humidity data. If you do not remember the parameters, you can try different combinations, and review the output data between trials.
Resolution setting (1 for 0.5C/0.6%RH, 2 for 0.0625C/0.04%RH): 2 Did you log humidity data? (1 for yes, 0 for no): 1 Reading iButton Data, please wait... Finished, data stored in memlog_temperature.txt. You may close the window.
The data log is read and then saved into a file memlog_temperature.txt in the same folder as memlog.exe. You can open the file in Microsoft® Excel® as a tab delimited file. The first column contains the temperature data, and the second column contains the humidity data (if selected). There is no time information available; you will have to manually enter it. Each time memlog is opened, the output is added to the end of the text file. Delete memlog_temperature.txt before re-running memlog.
Figure 1. The output of memlog.
The data also does not account for rollovers. Rollovers occur when the iButton memory is full, then the new data points overwrite the old data points. The number of points the iButton can store is listed in Table 1.
Table 1. Maximum Number of Data Points Stored in the iButton
|Low Resolution||High Resolution|
This application can be used to recover the data log in most cases where you accidentally start a new mission before downloading the old data. Assuming you remember the mission parameters, start time, sampling interval, and how long you left the iButton out in the field to determine if a rollover occurred.
The source code for the application is also available in the download. (The source code is only needed for users who wish to modify the application.) This is designed to compile with the 1-Wire® Public Domain Kit (PDK). The PDK contains sample code for other utilities and also provides a library for accessing 1-Wire masters.