#557 Question on the Haystack documentation

Scott Colestock Tue 31 Oct 2017

Hello -

New to researching this space. A tactical question: how do you search the documentation? The pages under: https://project-haystack.org/doc don't seem to be indexed by the search.

For instance, I was trying to see where the occupancyIndicator tag might be re-used across devices...but using the built-in site search (or just google with a "site:https://project-haystack.org/doc" qualifier) doesn't even show the original reference of occupancyIndicator that I happened to see.

thanks!

John Petze Tue 31 Oct 2017

Perhaps I misunderstand your question, but if I search for "occupied" (at the top right corner of the web page) I get a large number of hits related to the occupied tag and discussions on its use. Similar for occupancyIndicator although less discussion/hits.

In interpreting your specific question "I was trying to see where the occupancyIndicator tag might be re-used across devices", perhaps there is a misunderstanding of the use of tags. Haystack provides a standard information modeling approach for device data. You would add the occupied tag to the data coming from a sensor value that indicates that a space is occupied. The sensor equipment (device) itself would be tagged as to indicate that it was the occupancyIndicator in your specific project.

You would specify what sensor or device is providing that boolean value based on the unique characteristics of the product you are working with. You make the "link" between the device and the value it is producing.

Perhaps others can help as well.

Scott Colestock Tue 31 Oct 2017

Thanks for the fast reply -

Your comment "You would add the occupied tag to the data coming from a sensor value that indicates that a space is occupied". That makes sense.

I was curious whether other equipment beyond lighting might use the occupancyIndicator marker tag, since other devices might be able to provide that information. (Seemed strange that https://project-haystack.org/tag/occupancyIndicator indicated this was always associated with a lightsGroup, but I'm still learning my way around.)

(As a side note, the search function on the site made this tricky to look for because it turned my search into two words ("occupancy indicator") and then when I corrected that, all the pages that show this tag in the left hand table of contents were returned as results.)

John Petze Wed 1 Nov 2017

occupancyIndicator is simply a tag (marker) you would put on whatever the "thing" that you are defining as the indicator of occupancy. It's not exclusive to lighting. That was just a logical (maybe) place to put it in the tag organization on the site.

It could be an actual occupancy sensor, or it could be a "flag" you read from a BAS or other system.

Login or Signup to reply.