Seeking help with O2 report/OSCAR

[ejbpesca]

WisNeaMe Thank You!  I found the binary files on my MacBook!

For my Mac the Click Path to the binary files was:

Finder > Option + Go > Library > Containers > O2_Insight_Pro > Data > Library > Application Support > O2_Insight_Pro > Data > Folder with O2 Ring serial number > (here will appear a list of the binary files in YYYYMMDDHHMM format names example: 202401030122

This path is not available from OSCAR > Data > Viatom Wellue  therefore the binary files will have to be placed within a location in Finder without having to click Finder > Option + Go > Library

Select one or more binary files found by the above path then:   Edit > Copy > Finder > Choose a Location > Paste > OSCAR > Data > Import Viatom/Wellue Data >  (This will reveal a modified version of Finder.)  Navigate to the file saved at the chosen location > file number that matches date of OSCAR Daily Report

The SpO2 data will be entered a the bottom of the OSCAR Daily Report.  Scroll down to view it.  Click and hold the graph to move it up the screen to the desired location.  Resize graphs as needed by click hold the bottom of the graph.

Problems I experience with the above process:

1. Some OSCAR Daily Reports will import O2Ring binary files, others will not.
2. SpO2 graphs and other OSCAR graphs do not line up even though the O2Ring was synced with the computer.  It appears the problem is the AirSense 10 clock and the O2Ring clock are not synced.
3. The day date of the O2Ring binary file does not always match the OSCAR Daily Report file day date (checking the date at the bottom of OSCAR can help find which O2Ring file should be imported for any given day.
4. Some O2Ring binary files have the same day date number.  Up to three files can be listed with the same day date number with no indication which should be selected for import to OSCAR.
5. If SpO2 data is removed from an OSCAR Daily Report, another cannot be imported into that report.
6. Cpap therapy and O2Ring data gathering will physically begin within 3 minutes of each starting, yet the OSCAR report will show the CPAP therapy did not begin until nearly an hour later.

[Crimson Nape]

With over 3-years of using a Wellue oximeter with my CPAP, I've never gotten a total time synchronization. The oximeter may take up to a minute to initialize before it will write the filename and starting time. That is why we coded OSCAR to allow you to adjust the time and date using its filename. Import your CPAP data into OSCAR first. Note its starting time. Go to your oximeter data and rename the file to reflect the CPAP's starting time. Remember, a CPAP's day if from noon to noon. The oximeter's day is the normal midnight to midnight.

- Red

[ejbpesca]

CrimsonNape wrote:

Go to your oximeter data and rename the file to reflect the CPAP's starting time.

When you write Go to your oximeter data I think you mean go to the O2Ring binary file on the computer by using Finder to change its name to the desired time, or are you referring to an action within the OSCAR app after the file has been imported to OSCAR?

Here's the click path to put O2Ring binary files in position for OSCAR to recognize for import:

For MacBook M2 OS Sonoma,  I found the files by this path:



Finder > Option + Go (reveals Library under Go) > Library > Containers > O2_Insight_Pro > Data > Library > Application Support > O2_Insight_Pro > Data > Serial number for the O2Ring > select one or more of the files listed as all numbers, e.g. 20240107013001 > Edit > Copy > navigate in Finder to a place in Documents or the Desktop where the files are to be pasted > Paste 



Now the O2Ring binary files can be found in regular Finder for importing to OSCAR.



OSCAR Daily Report > Data > Import data from Viatom/Wellue > a version of Finder will appear.  Navigate to the place where the file was pasted. > File > Open



Upon clicking Open, the desired file should import to the OSCAR Daily Report as an SpO2 Graph.  The graph may not be visible because it is at the bottom of the graphs in OSCAR.  Scroll down to find it then click hold to move it up the report to the desired location.



Possible problems with this process:

1. CPAP machine times, computer times, and O2Ring times are not the same.  Even though the O2Ring is synced to the computer via the O2 Insight Pro app this is still a problem so the time of an O2 drop does not match with an apnea or flow limitation event.
   
2. Files downloaded from the O2Ring sometimes have the same date.  One date's data can be fragmented into up to three files.  Perhaps the ring stopped and started gathering data during sleep.
   
3. Even though O2Ring data gathering and CPAP therapy begin at the same time, the OSCAR report shows CPAP therapy to have started up to an hour after the O2Ring began gathering SpO2 data.
   
4. Sometimes OSCAR will not import the binary file.
   

[WisNaeMe]

Thats great, you’re nearly there…

To access the files directly from OSCAR, try the following -


Go back into Finder and navigate through the file structure and get to the directory with the Serial Number (again using Finder + Option key > Go).  

Then (right) click, drag and drop this directory name (i.e. the 10 digit serial number) to Finder’s left-hand grey sidebar, (just under the Favourites heading - usually at the top of the sidebar list).  You will find that the directory name will ‘stick’ there and then be accessible directly from within the Import Viatom/Wellue Data window of OSCAR (…as it’s just a mini version of Finder).

Within OSCAR you can then select that directory from the left most sidebar of the Import Viatom/Wellue Data popup window and it  will list all the files in that directory.  You can then select the file you wish to import.  (The most recent file is usually at the bottom of the list).

If you go through the above, that would save you having to copy files about (and potentially creating unwanted duplicates and confusion).  All files created and stored by the O2 Insight Pro app would automatically be accessible from within OSCAR (though you would still need to import them into their respective Daily View.



As regards the problems you encountered - 

I usually make a point of importing O2 data daily and only after I’ve first imported my PAP card data for the last session / evening.
I just import one day at a time and only then when I’m on the appropriate Daily View page. (Allows me to scrub the day’s data, adjust date/time and re-import if necessary).  I’ve not tried / risked importing multiple days. I seem to remember some comment about only doing one day at a time, so stuck with that.

Sometimes the O2 files are simply corrupt, sometimes there are short stub files, where only a few seconds of data are recorded.  These can occur simply by handing the ring and ‘setting it off’ unintentionally. These files are usually only a few bytes long and can each have the same filename, so I delete them to avoid confusion.  I’ve not tried to import these multiple files into the same Daily View page - I’m not sure what would happen.  I just regard them as noise and so I import the biggest file and delete the rest.

I tend to use the O2 ring (and OSCAR for that matter) to give me broad indications and trends of whats’s been going on, so I’m not really looking for high levels of precision regards time - just enough of a pointer to seek help when necessary.

As Crimson Nape points out, the O2 ring can be slow to kick off and might need a bit of time re-alignment.  I tend to work from the CPAP data timing and adjust the O2 Ring data accordingly.  Watch out for daylight savings time adjustments too (both CPAP and Ring).  Again if you cross the noon sleep threshold, then you have to pay attention to the date as well.

I’ve deleted a days O2 data from a Daily View, adjusted the time and I had no problems importing it back into the same Daily View.

I’ve not had major problems with CPAP and O2 Ring synchronisation.  I usually start the ring, just as i start the PAP machine (on autoStart) and when imported the following day there is only a few seconds to 1 minute difference between their respective start times.  It may be you have some issues with your PAP machine’s time settings (e.g. clock setting, daylight savings, timezone), or possibly OSCAR’s clock drift settings.  I think the Ring’s time setting is fairly basic by comparison.

[ejbpesca]

Thank you WisNaeMe. 10/4 on all points. Now to get some OSCAR reports with SpO2 graphs and keep improving my therapy.

[ejbpesca]

I am finding and importing O2Ring files okay now. Those files are funky.

The start and end times can be random numbers not even close to true times. Two files may generated by one continuous session.

I opened a couple of so-called "binary" files, one transferred to Insight Pro, the other to Viatom. The characters and symbols seem a jumbled-up mess.

Does anyone recognize what kind of data or computer language is being displayed by opening an O2Ring binary file?

[Crimson Nape]

Yes!  If you tried to open a binary data file with a text editor, you will see garbage.  That's because the file is storing the actual value and a text editor is trying to display its corresponding ASCII character.  You need a Hex editor program to view the data.

I don't know if a Mac has this, but you could try entering the following into a terminal screen for a decimal listing.

Code:

od -t u1 Oximeter_binary_filename

You must be in the directory with the file to use the above command. Otherwise, you will need to supply the path to the file, too.
Something like this:

Code:

od -t u1 Directory_Path_to/Oximeter_binary_filename

- Red

[Crimson Nape]

As an update to this thread, I tried installing O2 Insight Pro on a VM iMac O/S.  As of this post, the newest software, version 1.8.7, created the following path:
~/Library/Containers/com.viatom.O2PCViewer-BLE/Data.  I'm unable to get the USB/HID to connect in the virtual machine, so I'm unable to verify for actual data.

The Library directory is hidden. While in the Finder, you will need to use, Shift+Command+G.  In the search box, type: ~/Library.  This will open it the finder and allow you to proceed to the Containers directory and its subdirectories.

- Red

[ejbpesca]

Crimson Nape wrote:

The Library directory is hidden. While in the Finder, you will need to use, Shift+Command+G.  In the search box, type: ~/Library.  This will open it the finder and allow you to proceed to the Containers directory and its subdirectories.

In Finder, when I press Shift+Command+G a search box appears with ~/Library/ present and highlighted.  From there, anything I add to the search box as prescribed in ApneaBoardWiki leads to Files Do Not Exist.  If I use the method Finder > Go > Option key, the hidden Library appears under Go.  Clicking Library reveals a Containers folder with subfolders available.

I am using a MacBook M2 with Sonoma OS.

The path to finding O2_Insight_Pro binary files in the hidden Library under Containers is an 8 step path.  Apple, Wellue or someone did a fine job of hiding the binary files from a consumer-level user like me.

[WisNaeMe]

Red 

Happy to send some O2 ring data files if it helps you with testing in the interim.

As ejbpesca says, the actual O2 data is stored/saved in a directory nested a few levels below the path you highlighted (in a directory named after the serial number of the ring).  The full directory path seems to be somewhat concatenated and duplicated.  The root path of the ring install seems to also vary depending on who distributed the ring (Viatom, Wellue, et al).  

I usually connect with my O2 ring via bluetooth and the connection is ALWAYS very flakey (it can take a good few tries - jumping between download and recording modes). I found using a USB cable can have similar quirks. In that it tends to go into charging mode when plugged in and so sometimes fails to make the data connection.  

When originally researching oximeters, I picked up that some Viatom USB cables might be specific to their devices and have a small chip/resistor? moulded into the connection and that using a generic USB cable can stop them from downloading data.  Though this issue appeared to be more specific to their ‘Checkme’ wrist-worn devices.  But might be worth checking if you are using the original cable supplied with the ring (I use the original one an it works fine).

The secret sauce for a (bluetooth) connection for me seems to be - 

1. The Ring has to be turned ON before the O2 Insight Pro software is running.  
   
2. Set the ring running and then quickly remove it from finger (otherwise it appears to go into data recording mode and can’t make the connection). 
   
3. Start the O2 Insight software running; 
   
4. Connect and download from the ring within the O2 Insight Pro application; 
   
5. Paint myself with woad and run around the ring naked beating a drum (…optional stage). 
   
6. …Then finally on to importing the data from within OSCAR.
   

I have also tried Viatom’s - ViaHealth mobile app (available for both Apple and Android mobiles from the Viatom Website).  It is equally flakey for making connections.  It also tries to get you to store data in their cloud in China? (optional, but a still bit questionable!). You then have to hunt down the data file on your phone and transfer it to somewhere that OSCAR can find it.

None of the above really helps if you are a sleep addled CPAP user!

As a further potential complication…  MacOS Sonoma (MacOS 14.x any version!) should probably be avoided in VM’s, it’s flakey enough running on native hardware and there seems to have been some persistent issues round Bluetooth and USB connections - these problems don’t seem to have gone away yet. So if your VM is running Sonoma it might be adding to your problems. Its predecessor Ventura (MacOS13.x) might offer a more stable OS for a VM build  …if stuck ,it’s always worth trying your own incantation of my step 5! (above).  If nothing else it will keep the family amused.

As a further, further aside.  I also tried the Viatom O2 Ring with SleepHQ’s iOS phone app - SleepO2. The SleepO2 app is certainly tidier and more robust than Viatom’s ViHealth app.  From SleepO2, data imports into both the Apple Health app and SleepHQ’s cloud (if you’re a subscriber), though the raw data is not readily accessible via the iPhone, unless you have access to Apple’s APIs.  But it does suggest that O2 rings are the same irrespective of who’s distributing or reselling them (as you might expect) …and pricing seems pretty consistent across all the channels.

It’s amazing that such a piddlingly small piece of hardware has generated so many words!  But hopefully it will be of some help to others following on their own journey to find the ‘One Ring!’  …and make the damn thing work!


For Information - current Software / Hardware setup is…

Computer -
Intel iMac running macOS Sonoma 14.2.1

Oximeter -
O2 Ring - firmware v. 1.9.0
O2 Insight Pro - macOS v. 1.8.9
ViHealth App -  iOS v. 2.30.61
(All distributed by Viatom - updates on their website)