I'm pretty new to SIMPL, but I've created a few touchscreen interfaces in VT and the l

Issue <a class="issue-link js-issue-link" data-error-text="Failed to load title" data-

We used “namespace” in our <a href="https://code.google.com/archive/p/crescendo-framew

Finish documentation,about adelyte/crescendo-for-crestron

shaunco commented on July 19, 2024

Issue #22 pointed me to Crescendo MC3.smw. I should have realized that it was the only program in the program folder, whereas everything else was a user module. Hopefully I'll get much further, but it would still be great to have complete documentation.

from crescendo-for-crestron.

adelyte-chris commented on July 19, 2024

I've fixed the download link on the Getting Started page. Thank you for the catch.

The framework is provided as a standard program archive in /program with the other two directories being self-explanatory. We expected developers to be familiar with that flat file hierarchy, but obviously more explanation is warranted.

We will add a Finding Your Way Around section to the Getting Started page.

from crescendo-for-crestron.

nmelin commented on July 19, 2024

Is there a single reference for all crescendo namespaces (all models, collections, interfaces, etc.), including commonly used namespace for custom functions that don't exist in the framework demo programs?

Are there any namespace changes that are currently under consideration?

We're seeking to synchronize program namespaces with system engineering documentation and a single reference would be very helpful, as would awareness of any upcoming changes. Scouring the documentation site yielded no answers.

Perhaps this should be a new issue?

Thanks @adelyte-austin @adelyte-chris

from crescendo-for-crestron.

adelyte-chris commented on July 19, 2024

By “namespace” do you mean “module” or are you thinking more like subfolders in the SIMPL Windows program? (I’m not trying to be pedantic, I want to make sure I answer your question.) Would you provide an example of a custom function?

…

On Wed, Dec 28, 2016 at 10:56 AM, nmelin ***@***.***> wrote: Is there a single reference for all crescendo namespaces (all models, collections, interfaces, etc.), including commonly used namespace for custom functions that don't exist in the framework template? Are there any namespace changes that are currently under consideration? We're seeking to synchronize program namespaces with system engineering documentation and a single reference would be very helpful, as would awareness of any upcoming changes. Scouring the documentation site yielded no answers. Perhaps this should be a separate issue? Thanks @adelyte-austin <https://github.com/adelyte-austin> @adelyte-chris <https://github.com/adelyte-chris> — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#32 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AGkRZOTUV43AqUreJX89BB3mKnM1FZrfks5rMrDKgaJpZM4IOG8h> .

from crescendo-for-crestron.

nmelin commented on July 19, 2024

Hi Chris, I'm thinking in the simpl windows program, signal naming conventions. Namespace examples, where variable name = <namespace identifier> separator <local name> Sources signal names = S-01__Play Lights signal names = L-05__dimUp Switchers signal names = X-61__inputHDMI Custom examples (don't know how adelyte has addressed these in the past): Access Control signal names: AC-{id_number}__signalName Art Lift: D-55_liftPreset1 Scheduled Event: Schd-01__resumeSchedule Is there better nomenclature to use for this than 'namespace'?

Sent from my iPhone On Dec 28, 2016, at 12:01 PM, Chris Massey <[email protected]> wrote: By “namespace” do you mean “module” or are you thinking more like in the SIMPL Windows program? (I’m not trying to be pedantic, I want to make sure I answer your question.) Would you provide an example of a custom function?

On Wed, Dec 28, 2016 at 10:56 AM, nmelin ***@***.***> wrote: Is there a single reference for all crescendo namespaces (all models, collections, interfaces, etc.), including commonly used namespace for custom functions that don't exist in the framework template? Are there any namespace changes that are currently under consideration? We're seeking to synchronize program namespaces with system engineering documentation and a single reference would be very helpful, as would awareness of any upcoming changes. Scouring the documentation site yielded no answers. Perhaps this should be a separate issue? Thanks @adelyte-austin <https://github.com/adelyte-austin> @adelyte-chris <https://github.com/adelyte-chris> — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#32 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AGkRZOTUV43AqUreJX89BB3mKnM1FZrfks5rMrDKgaJpZM4IOG8h> .

— You are receiving this because you commented. Reply to this email directly, view it on GitHub, or mute the thread.

from crescendo-for-crestron.

adelyte-chris commented on July 19, 2024

We used “namespace” in our original documentation on Google Code. It seems like a fine term to me.

Would something like our old SIMPL Style Guide updated with our best practices suffice?

We typically define global subsystems as Z and highly specific custom subsystems as Y if they don't fit D (Devices), C (Climate), W (Shades), or L (Lighting). For example, a standalone driveway sensor might be Y-01 because it's not a device—it offers no direct control.

from crescendo-for-crestron.

nmelin commented on July 19, 2024

Yes an updated SIMPL style guide would be helpful. For the purposes of engineering documentation, our team would need to expand the prefixes to cover processors, controllers, gateways, sensors, etc, instead of grouping them into D or Y.

Reference for others, pulled from SIMPL Style Guide

Prefix	Module
R	Room
A	Audio Zone
V	Video Zone
X	Switcher
S	Source
L	Lights
W	Shades
C	Climate
D	Other
M	Menu
T	Touchpanel
H	Remote
K	Keypad
Z	System

from crescendo-for-crestron.

adelyte-chris commented on July 19, 2024

Note that there is no such thing as `M` (menu) in Crescendo 2. Is a “processor” a Crestron processor? If so, then use `Z` as follows: `Z-00` (this processor, contextual to each program), `Z-01` to `Z-99` (a processor with a given ID). For example, a heartbeat signal from processor 3 would be `Z-03__Heartbeat!`. For gateways, use `G` (gateway). For sensors, use `E` (sensor event). For example, occupancy sensor 1 motion detected might be `E-01__Motion_Detected?`. Picking letters is almost arbitrary. Propose some and we’ll commit to them.

…

On Wed, Dec 28, 2016 at 1:23 PM, nmelin ***@***.***> wrote: Yes an updated SIMPL style guide would be helpful. For the purposes on engineering documentation, our team would need to expand the prefixes to cover processors, controllers, gateways, sensors, etc, instead of grouping them into D or Y. Reference for others, pulled from SIMPL Style Guide <https://code.google.com/archive/p/crescendo-framework/wikis/SimplStyle.wiki> Prefix Module R Room A Audio Zone V Video Zone X Switcher S Source L Lights W Shades C Climate D Other M Menu T Touchpanel H Remote K Keypad Z System — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#32 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AGkRZGSKDp6mwt0kjKnOMENXXXZcRTEkks5rMtNYgaJpZM4IOG8h> .

from crescendo-for-crestron.

Finish documentation about crescendo-for-crestron HOT 8 OPEN

Comments (8)

Related Issues (20)

Recommend Projects

React

Vue.js

Typescript

TensorFlow

Django

Laravel

D3

Recommend Topics

javascript

web

server

Machine learning

Visualization

Game

Recommend Org

Facebook

Microsoft

Google

Alibaba

D3

Tencent