RE: [TF-TD] Meeting minutes + Update TD Tutorial

Dear TD/AP and WoT members,

I’m a little bit confused the boundaries between 3 interaction type, that is, “Property”,
“Action” and “Event”.

At the F2F@Sunnyvale, I heard the interaction type concept, I agreed because it is
easy to understand conceptually.
But when I tried to create the map between 3 interaction type to get, put APIs to make
input document for TF-AP, I faced some difficulties.

In https://github.com/w3c/wot/blob/master/TF-TD/Tutorial.md, the sample “MyLED”
is described according to proposed interaction model.
This is very helpful to understand the TD and discuss issues.

For example, “ledOnOff” belongs to Property, on the other hand “fadeIn” and “fadeOut”
belong to Action.

“ledOnOff” will cause things=LED turn on or off. So “ledOnOff” can belong to Action
category too, I think.

And current “fedeIn” is defined that it has no return value, that is, OutputData = void/null.
It is possible to extend the definition as OutputData = Boolean and it represents the return
Value of fadeIn action is successful or not.
The InputData type is unsignedByte and it represents the time to fadeIn from turn off status
to turn on status of LED light.

When JSON encoded “fedeIn with 5 sec” is sent to WoT Servient, then WoT servient might
return the fade-in is successful or not after 5 second.
In this case, “fadeIn” can be classified in “Event” category, I think.

TF-TD and TF-AP members, how do you think to resolve my confusion ?

Best regards,
----
Kazuo Kajimoto
Senior Councillor of Groupwide Software Strategy,
Groupwide CTO Office
kajimoto.kazuo@jp.panasonic.com<mailto:kajimoto.kazuo@jp.panasonic.com>


From: Kaebisch, Sebastian [mailto:sebastian.kaebisch@siemens.com]
Sent: Friday, September 04, 2015 6:07 PM
To: public-wot-ig@w3.org
Subject: [TF-TD] Meeting minutes + Update TD Tutorial

Dear TD and WoT members,

please find the meeting minutes of Wednesday's web meeting here [1] or at the TD wiki page [2] (thanks to Dave for scribing).

The TD tutorial [3] contains some updates:
*         As discussed in the web meeting, the Property contains a new optional member “stability” to characterize how stable or dynamic the property is (please comment on it)
*         The LED example contains two new dim-able based actions: “fadeIn” and “fadeOut”
*         At the end of the tutorial there is the current discussion about the CoAP binding approach with and without HATEOAS.

Any feedback is welcome!

Please note that the next meeting will take place on 16th of September at 3pm CEST. I forgot to mention that Darko Anicic will organize and moderate the next 2 web meetings. I will be on parental leave until middle of October.

Best wishes
Sebastian


[1] http://www.w3.org/2015/09/02-wot-td-minutes.html
[2] https://www.w3.org/WoT/IG/wiki/Thing_Description#Minutes<https://www.w3.org/WoT/IG/wiki/Thing_Description>
[3] https://github.com/w3c/wot/blob/master/TF-TD/Tutorial.md