Luminaire Dimming

Setting Luminaire Dimming is multi-step process. The set of allowed dimming features depends on hardware vendor.

Dimming Explained

  1. A luminaire referrs to the mounting on which socket it is installed [1..n].
  2. A mounting referrs to the segment.
  3. A segment referrs to the segment type.
  4. A segment type refers to the lighting policy.
  5. A lighing policy contains rules - a set of lanes containing conditions.
    • A lane refers to the lighting profile to be selected if conditions satisfies input.
    • Logical operation AND is used to compare lane conditions and input.
    • Input is: socket, luminaire model, mounting category, mounting type for each smart luminaire.
  6. The last, mandatory lane without conditions is taken if no lane above satisfies input.
  7. A lighting profile holds rules of luminaire on/off and dimming for every day of the year. These dimming rules shall be stored in each Head.
  8. A luminaire referrs to the head what is currently installed on the luminaire.
  9. A head referrs to the lighting profile assigned in the past.
  10. Comparing lighting profile “to be” vs “fact” System recognizes what heads require synchronization.
  11. When command setProfile received by head and stored succesfully, the System links head and lighting profile in the database. If lighting profile on the luminaire and head are the same, that means lighting profile is upplied succesfully.

Important: A special profile No dimming exists in the System, to be used if dimming should not be applied. In fact, it is a special type of profile rules, and must be uploaded into the head as well.

What Impacts to Lighting Profile Selection

  1. Mounting socket number.

  2. Segment Type through Segment.

  3. Mounting type.

  4. Luminaire Model.

  5. Mounting Category.

  6. Day, Day Type are available only by limited hardware vendors.

    It a future policy rule conditions could be extended.

Tasks

  1. Change dimming rules of the ligthting profile already assigned to luminaires.
  2. Change lighting profile of a single luminaire.
  3. Assign individual dimming rules to a single luminaire.
  4. Reassing lighting profiles to luminaires if policy rules were changed.

Change Dimming Rules of the Ligthting Profile Already Used by Luminaires

  1. Open Lighting Profile page.

  2. Make necessary changes. See setting lighting profile.

  3. Go to Lighting Rules->Synchronization.

  4. Run function luminaries.smart.with_head->Build the list of head sync commands. You will find another parameter heads.sync_requests.todo if there is impact and synchronization is required.

  5. Wait evening time, when all smart luminaires will become online.

  6. Run function luminaries.smart.with_head->Push all head sync commands.

  7. Track head sync execution progress by viewing parameters: heads.sync_requests.total, heads.sync_requests.in_progress, heads.sync_requests.done, heads.sync_requests.rejected, heads.sync_requests.toBeRepeated.

  8. When heads.sync_requests.todo is 0 (zero) and heads.sync_requests.toBeRepeated is visible and holds value, run function luminaries.smart.with_head->Push all head sync commands again.

Change lighting profile of a single luminaire.

It is considered that settings lighting policies were done before and lighting profile is exist.

  1. Go to mounting page with required luminaire.
  2. Start editing mounting.
  3. Change mounting category.
  4. Save changes.
  5. Go to Lighting Rules->Synchronization.
  6. Ru function luminaries.smart.with_head->Assign profile to luminaires. You will find another parameter luminaries.smart.profile_upload_required if there is impact and syncronization is required.
  7. Run function luminaries.smart.with_head->Build the list of head sync commands. You will find another parameter heads.sync_requests.todo if there is impact and synchronization is required.
  8. Wait evening time, when all smart luminaires will become online.
  9. Run function luminaries.smart.with_head->Push all head sync commands. The process will be working on background.
  10. Track head sync execution progress by viewing parameters: heads.sync_requests.in_progress, heads.sync_requests.done, heads.sync_requests.rejected, heads.sync_requests.toBeRepeated. Click refresh icon in the right top corner of the widget.
  11. When heads.sync_requests.todo is 0 (zero) and heads.sync_requests.toBeRepeated is visible and holds value, run function luminaries.smart.with_head->Push all head sync commands again.

Assign Individual Dimming Rules to a Single Luminaire

  1. Go to mounting page with required luminaire.
  2. Start editing mounting.
  3. Change mounting category to YYY.
  4. Save changes.
  5. Go to Lighting Rules->Profiles.
  6. Create new lighting profile XXX (see article create lighting profile)
  7. Change status of lighting profile from Draft to Active (it makes profile visible in policy editor).
  8. Go to Lighting Rules->Policies.
  9. Click to the link with policy unique id. A policy page opens in view mode.
  10. Click button Edit Rules. The lanes are switched to edit mode (see article edit policy rules)
  11. Add new lane with Rule Mounting Category YYY. The lane refers to profile XXX.
  12. Save changes.
  13. Go to Lighting Rules->Synchronization.
  14. Run function luminaries.smart.with_head->Assign profile to luminaires. You will find another parameter luminaries.smart.profile_upload_required if there is impact and syncronization is required.
  15. Run function luminaries.smart.with_head->Build the list of head sync commands. You will find another parameter heads.sync_requests.todo if there is impact and synchronization is required.
  16. Wait evening time, when all smart luminaires will become online.
  17. Run function luminaries.smart.with_head->Push all head sync commands. The process will be working on background.
  18. Track head sync execution progress by viewing parameters: heads.sync_requests.in_progress, heads.sync_requests.done, heads.sync_requests.rejected, heads.sync_requests.toBeRepeated. Click refresh icon in the right top corner of the widget.
  19. When heads.sync_requests.todo is 0 (zero) and heads.sync_requests.toBeRepeated is visible and holds value, run function luminaries.smart.with_head->Push all head sync commands again.

Reassing Lighting Profiles to Luminaires If Policy Rules Were Changed

  1. Go to Lighting Rules->Synchronization.
  2. Run function luminaries.smart.with_head->Assign profile to luminaires. You will find another parameter luminaries.smart.profile_upload_required if there is impact and syncronization is required.
  3. Run function luminaries.smart.with_head->Build the list of head sync commands. You will find another parameter heads.sync_requests.todo if there is impact and synchronization is required.
  4. Wait evening time, when all smart luminaires will become online.
  5. Run function luminaries.smart.with_head->Push all head sync commands. The process will be working on background.
  6. Track head sync execution progress by viewing parameters: heads.sync_requests.in_progress, heads.sync_requests.done, heads.sync_requests.rejected, heads.sync_requests.toBeRepeated. Click refresh icon in the right top corner of the widget.
  7. When heads.sync_requests.todo is 0 (zero) and heads.sync_requests.toBeRepeated is visible and holds value, run function luminaries.smart.with_head->Push all head sync commands again.

Last modified September 2, 2022 : update documentation speciall for Volos (f728541)