[Gennoise]

What's up dudes

This post is for everyone who works with the IP control API. I don't know how you feel about the documentation on Dune HD's website, but a bigass text file is not what I call a documentation. Which is why I've decided to step up and take some action!

With the introduction of API version 3, another set of commands and parameters were introduced. And of course, following company tradition, they are poorly documented (if at all). It took me literally hours to figure out the proper syntax for each and every new feature. I hope to spare others from having to go through the same.

On my project page, you can now find a new wiki page with a complete reference for all commands, command parameters and command results, version 1 through 3.

Direct link: http://code.google.com/p/dune-api-co...i/ApiReference

If you happen to be a .NET developer, you can also just use the binaries that I've provided and avoid messing with the underlying API altogether.
For everyone else, I really do hope to bring a little more insight into what's possible and, more importantly, how to do it.

If you have any comments, I'd love some feedback on this. I'm playing with the idea of expanding this into some sort of community wiki with userguides and tutorials. Or y'know, just something that allows you to avoid having to look at the official documentation pages ever again. It would also make it significantly easier to find the information that you're looking for without having to post a thread about it here and wait for a reply. Not that there is anything wrong with that.

[j5races]

Since they chnaged the zoom to a zoom plus SELECT command, i cant get zoom to work via IP on my crestron. I am sending the zoom ir emulation command then the select ir emulation command but it doesnt accept the select. If I paste the same command into a web browser it does work.

Any ideas?

Thanks
Jon

[Gennoise]

Version 2 or up? I can help you with that. Instead of emulating a button, you can set it directly.

syntax: cmd=set_playback_state&video_zoom=value

Replace value with one of these:

• normal
• enlarge
• make_wider
• fill_screen
• full_fill_screen
• make_taller
• cut_edges

Version 3 gets two more zoom modes:

• full_enlarge
• full_stretch

I'll add it to the reference ASAP, but it's currently past 3 in the morning for me. I tend to make better posts when I'm awake.

EDIT

I wrote it anyway, screw getting enough sleep

http://code.google.com/p/dune-api-co...ckStateCommand

This should be extremely helpful in figuring out how to manipulate playback settings. Almost none of these things were previously documented.

[Gennoise]

Have you tried sending the ir_code, waiting a second, then sending the ir_code again? That always works for me. I can cycle through all zoom modes by repeatedly sending ir_code=FD02BF00.

[j5races]

What are you sending from? I am sending From my Crestron system and that doesnt work for me. I get the ZOOM: Press SELECT bar on the screen but it doesnt toggle after. I am working with another awesome Crestron guy (Chip). I hope he has some ideas to fix it. The last resort would be to make the crestron toggle thru the modes (I can do this if needed, but think letting the dune toggle is a lot more reliable and smoother).

[Gennoise]

I just use a webbrowser and repeatedly press refresh. But it works equally well in code.

I think the mechanism is as following:
First ZOOM press: open zoom editor.
Subsequent ZOOM press: change zoom mode and apply.

Then, if you wait a few seconds, the zoom editor will close. Which means that the first press is used to open it again. If I can find 10 minutes to spare, I'll figure out the true mechanism.

Anyhow, why not just use set_playback_state? Emulating button presses is more of a last resort thing, when everything else fails.

[Gennoise]

I finally managed to create a page for each command and command result. It took a lot of work, but I think it was worth it.

If anything is still unclear, feel free to ask and I'll update the pages if appropriate. There may be some mistakes about version 3 stuff, I'm still figuring out the details myself.

[Gennoise]

Originally Posted by j5races Since they chnaged the zoom to a zoom plus SELECT command, i cant get zoom to work via IP on my crestron. I am sending the zoom ir emulation command then the select ir emulation command but it doesnt accept the select. If I paste the same command into a web browser it does work. Any ideas? Thanks Jon

For me, it works like this: If I press ZOOM once, it opens the zoom editor. Now I can press either ZOOM or SELECT, and it will cycle through the available zoom modes and apply it immediately. Then I can press ENTER to dismiss the zoom editor, or just wait a few seconds and it disappears automatically.


I've made some corrections to the set_playback_state page. I finally figured out the true meaning of "playback_clip": it is actually the visible rectangle of the screen's surface, and resizing it does not resize the video rectangle. Everything outside this so-called playback clip is just black.

[AV_Integrated]

Originally Posted by j5races What are you sending from? I am sending From my Crestron system and that doesnt work for me. I get the ZOOM: Press SELECT bar on the screen but it doesnt toggle after. I am working with another awesome Crestron guy (Chip). I hope he has some ideas to fix it. The last resort would be to make the crestron toggle thru the modes (I can do this if needed, but think letting the dune toggle is a lot more reliable and smoother).

Chip really knows his stuff on the Yahoo forums.

If you get into it enough to put together a module, that would be great to see. I put together a SIMPL+ piece with the old protocols, but I don't think zoom works right. Also, I really want something that I can just drop the IP address of the player into and have it work properly across the board - which I don't have time to play with.

I still think the Dune has to be in standby mode to work, which means after a power failure you must send an IR power on command before the IP power commands will even work. This means a dual run of both IR emitter and the IP connection for reliability after a power outage and keeping my family from killing me.

[Gennoise]

Quick update to let everyone know I've made some changes to the main page. There's less clutter now, and I've tried to make the syntax more clear by adding color. Does it look better now? Let me know.

Besides that, everything related to protocol version 3 should now be correct. I'm still looking to add summaries for last_playback_event, but I don't know what half of them are, let alone how to trigger them.


---

Originally Posted by AV_Integrated I still think the Dune has to be in standby mode to work, which means after a power failure you must send an IR power on command before the IP power commands will even work. This means a dual run of both IR emitter and the IP connection for reliability after a power outage and keeping my family from killing me.

There's a way for the smart models to automatically power on again after a sudden power outage.

http://dune-hd.com/firmware/rc/ (scroll down to Automatic power-on mode)

Dune HD models starting with Dune HD Smart/Max/Duo do not boot automatically when the power is connected. Instead they are put by default into hardware standby mode, and wait for the user to explicitly request power-on. Dune HD Smart D1/B1/H1 (latest batches only, shipped starting with June-2011, serial number on the unit should be ASD1LHVAA***1123***00001 or greater), Dune HD Lite 53D, Dune HD TV-101/301 models can be reprogrammed to boot automatically on power-on. This possibility is helpful when the player should be used in "Digital Signage" (Dune HD Network) mode, and it can also be helpful in some other cases. Reprogramming affects the flash memory of the microcontroller which is responsible for power on/off handling, and can be done in the following way: - Put the unit into hardware standby (full power-off) mode. - Carefully direct the RC onto the IR eye. - Carefully press the following sequence of RC buttons: P, O, W, E, R, 1, ENTER - The unit should LED-blink once. If the unit does not blink, try again several times. If it does not work, it means the unit has an old version of the MCU firmware and auto-power-on mode is not supported by the unit. - To disable auto-power-on: the same, but press: P, O, W, E, R, 0, ENTER Dune HD Max/Duo models can not be reprogrammed to boot automatically on power-on.