BLACK_BUILDING_TEST
Full-site power-fail drill: utility open, ride-through on battery, generator pickup, soak and return to utility.
When to use it
Use BLACK_BUILDING_TEST when the site's annual or semi-annual black-building test has to be run as a controlled sequence — utility opened deliberately, load riding on UPS, generators picking up, soak, and a proven return — with an automatic abandon if the load is not picked up in time.
Interface
The published port signature. This is the whole of what the block exposes to your program — the implementation body is not shown here and ships with the download.
Inputs
| Port | Type | Unit |
|---|---|---|
| ENABLE | BOOL | — |
| START | BOOL | — |
| ABORT | BOOL | — |
| MAX_ON_BATT | TIME | — |
| STEP_TIMEOUT | TIME | — |
| SOAK_TIME | TIME | — |
| GEN_LOSS_DEB | TIME | — |
| RESTORE_TMO | TIME | — |
| PRECHECK_OK | BOOL | — |
| UTIL_CLOSED_FB | BOOL | — |
| UTIL_OPEN_FB | BOOL | — |
| ON_BATT_FB | BOOL | — |
| GEN_LOAD_FB | BOOL | — |
| UPS_RUNTIME_MIN | REAL | min |
| MIN_RESERVE_MIN | REAL | min |
| ACK | BOOL | — |
Outputs
| Port | Type | Unit |
|---|---|---|
| STEP | USINT | — |
| TOTAL_STEPS | USINT | — |
| RUNNING | BOOL | — |
| RESTORING | BOOL | — |
| UTIL_OPEN_CMD | BOOL | — |
| UTIL_CLOSE_CMD | BOOL | — |
| GEN_START_CMD | BOOL | — |
| STEP_OK | BOOL | — |
| PASSED | BOOL | — |
| FAILED | BOOL | — |
| ABORTED | BOOL | — |
| GEN_PICKUP_S | REAL | s |
| ON_BATT_S | REAL | s |
| RESTORE_ELAPSED_S | REAL | s |
| STEP_ELAPSED_S | REAL | s |
| ALM_BATT_TIME_EXCEEDED | BOOL | — |
| ALM_GEN_LOST | BOOL | — |
| ALM_RESTORE_FAILED | BOOL | — |
| ALM_STEP_TMO | BOOL | — |
| ALM_RESERVE_LOW | BOOL | — |
Supervised control write
BLACK_BUILDING_TEST commands a real actuator. It is written to sit underneath your own interlock, permissive and protection logic — not to replace it. Commission it as you would any control block you wrote yourself.
Validation evidence
- Tests
- 10
- Simulated scans
- 210
- Simulator
- v0.1.0
Complete IEC 61131-3 implementation with a published test suite that runs on the vplant simulator. The counts above are that suite, executed on this build.
- Conforms to IEC 61131-3
Download BLACK_BUILDING_TEST — free
Create a free Ri Tech account to download the block. You get the Structured Text body, the Rockwell Add-On Instruction (.L5X), the Schneider Control Expert DFB (.XDB), PLCopen XML and the datasheet.
Every block in the catalogue is free to download, in every format it ships, with no purchase and no card. Browsing needs no account at all; downloading needs a signed-in one, so the block lands in your library and re-downloads whenever you need it.
Source is never published on this page. The implementation is released to a signed-in Ri Tech account — free of charge, but never anonymously.