Unencrypt Zeo Bedside SD Card Data

[Jay Aitchsee]

To begin collecting your Zeo bedside data without encryption, go to:

http://zeodecoderview.sourceforge.net/

There are four pages of information here with instructions, be sure to read them all before beginning and upload your current data to Zeo, you'll have to wipe your card during this process. After, you'll be able to upload and download as before.

A link will take you to the Zeo data library where you can get the bedside unit firmware update, v2.6.3O, which will change future data storage to unencrypted. This link takes a while to open, be patient. After it opens, you must provide a name and email address. Download the update, extract it, copy it to the Zeo folder on your SD card and follow the instructions at the above site to complete the update.

Another link will take you to the Zeo Decoder Viewer, release 0.2A2, download. This is a very rudimentary viewer which allows you to view your sleep data without uploading to the Zeo site. Once you have the viewer installed, if it doesn't open with a double click, try using JAVAW.

OK, now you have direct access to your Zeo data - what good is it? It's a place to start if you're a hacker, for the rest of us, it's just being able to do it, as well as viewing naps (see my next post for a little more on naps). Later, when Jedimark is able to incorporate Zeo into SleepyHead, I think having access to unencrypted data will make it easier.

By the way, at Zeo there are detailed instructions for collecting raw data (brain waves) as well.

Enjoy,

Jay

Edited to add nap info

[tschultz]

At this time the mobile version provides no access to the data via anything other than the web interface. The bedside version does allow this updated, and unsupported firmware listed above, but for those that are unwilling to go through this process you can export much of the data from their web interface.

It will give you a CSV file with the summary information, but also contains two space separated fields with the actual sleep levels at 5 minute and 30 second intervals.

These can easily be graphed, and could be added to SleepyHead with some added data handling.

[Jay Aitchsee]

Yes, tschultz, your are correct. Exporting from the site and graphing that data is easy and has been done by our members. See "build a sleep Lab" below for some examples. The Zeo site is a much slicker presentation and offers many more features than the Zeo Decoder Viewer referenced in my post.
However, one of the shortcomings of the site is that not all the data from the card is uploaded. It is designed for monophasic sleep only - no naps. It simply looks at the longest sleep period of the day and calls it a night of sleep. Shorter periods are ignored. (See Zeo Sleep Info Center).
Even though shorter sleep periods are not uploaded, they are written to the card and can be viewed by the Zeo Decoder Viewer. So, if one wants to view naps, currently the only way to do it is with the viewer. One caveat though, the beside unit will only write to the card after the headband is docked if it determines sleep onset has occurred. Sleep onset is defined as 10 continuous minutes of a sleep stage (again, see the Sleep Center Info Center). This precludes writing to the card if the headband has simply been off the dock for some time. Therefore, naps of less than ten minutes will not be recorded.

Foregoing applies to beside unit only.

Jay

[MaxDarkside]

Jay,

Have you made a cable for the real-time streaming brain wave data from the Zeo? I've ordered a USB-Serial, connector, clips from Mouser and want to make sure my wire colors go in the right holes/spots.

[Jay Aitchsee]

No, Max, I haven't. But I think there are photos at the Zeo Sleep Info site showing the wiring.

[MaxDarkside]

I do know of the tutorial for making the cable at the location where the real-time Zeo driver is, but I don't know if all USB / Serial lead colors are the same (standard) so I don't want to accidentally connect power to a data In or Out (poof?!) and toast my Zeo or something. That would be bad.

[Jay Aitchsee]

The viewer

[MaxDarkside]

I do know of the tutorial for making the cable at the location where the real-time Zeo driver is, but I don't know if all USB / Serial lead colors are the same (standard) so I don't want to accidentally connect power to a data In or Out (poof?!) and toast my Zeo or something. That would be bad.

I found the spec sheet for the cable I ordered from Mouser and it's the same as the tutorial on how to make a cable so I can proceed without fear

[Jay Aitchsee]

Here it is, Liz.

[Lizistired]

Thanks Jay, The Zeo worked fine last night. I got the firmware upgraded... Probably going to need some help getting the viewer going though. Not a programmer and haven't worked in IT for 10 years. I downloaded everything to a folder on my desktop but keep getting "can't find..." messages when I double click on the "jar" files.. whatever they are? It appears that there is sample data in the download so I was hoping to play with that tonight. At least the data will be on the card.

[Lizistired]

I got the viewer to open. Guess I just need to go to bed and get some data! Hope I remember how I did it in the morning.

[Jay Aitchsee]

After you open the viewer, if you click on file/load dat file/ navigate to your card and select, it will load all the data on the card to the new ZEO data card file included with the viewer.

[Lizistired]

I got it this morning. I like that, it's quick. When I stretched it out in my overlay it was as pretty as the one online.
Is there a way to get the 10 second data with it too? I uploaded to the website to get it this morning.

[Jay Aitchsee]

You mean 30 sec? I'm pretty sure you can get it, but not with the viewer. I accidentally downloaded the decoder first and it will read the card, but I'm not sure how to make it read what you want. Or, notepad will read a lot of it. I haven't done much with it. I'm trying not to obsess, remember?

Besides,as you said,

Not a programmer and haven't worked in IT for 10 years

I'm not either. Never been in IT and haven't written code since about 1970. Not a software engineer or a medical technologist, not a mathematician, nor a statistician, or any of those things I was beginning to think was a requisite for being on the forum. Just trying to muddle through and get a handle on this sleep stuff.

Jay

[Jay Aitchsee]

Liz, if I go to the folder which holds the Decoder-viewer there are two more sub-folders: Lib and ZeoData. ZeoData holds the data which has been imported from the card organized by date/session. If I drill down to the individual sessions and click on one, I can read the data from the card for that session including the the 5minute and 30 sec hypnogram data. If I copy the 30 sec data and paste it into a spreadsheet (A1) and then do the "text to column" operation (space separated), it will fill the spreadsheet with the data and then it can be charted producing the same hypnogram that would have been done by downloading from the site. (actually, it's not quite the same, mine includes values 0,1,2,3,4, and 6. I remember reading something about the 6 value, but now i can't recall what it was. Something about deep sleep, I think).

The 30 sec data is labeled "Base Hypnogram" and the 5 min data is labeled the "Display Hypnogram".

I think it's a little quicker and cleaner than downloading from the site. Try it and see what you think.

Jay