GUIDE

Emergency failure codes

A plain-language reference for the result codes returned by the emergency-lighting software.

This guide explains the reported result. It does not assign the work. A result can describe a fitting fault, a communications problem, a test sequence problem, or an engineering configuration problem.

Initialisation and communications

Result code	Meaning
`FAIL_INIT_LON_COMS_FAILURE`	No communication with the module while Lightscape collected the result.
`FAIL_INIT_DALI_COMS_FAILURE`	No communication with the specific emergency device while Lightscape collected the result.
`FAIL_INIT_FLAG_NOT_CLEARED`	The test-complete flag did not clear before the test started.
`FAIL_INIT_ALREADY_INITIALISING`	Another test might still be initialising. Try again after 20 or 30 seconds.
`FAIL_INIT_INVALID_RESPONSE`	The APB returned an unexpected reply.
`FAIL_INIT_CONFLICTING_TEST_TYPE`	The module was asked to run functional and duration tests at the same time. A module cannot mix these test types.
`FAIL_INIT_INVALID_ADDRESS`	The module received an invalid address parameter.
`FAIL_INIT_NOT_INITED`	The emergency fitting is present in Lightscape but is typically not configured as an emergency on the module.

Test sequence and control

Result code	Meaning
`FAIL_SEQ_COLLECT_WHILE_TESTING_MODULE`	Lightscape tried to collect a result while the module still reported that the test was running.
`FAIL_SEQ_COLLECT_WHILE_TESTING_DEVICE`	Lightscape tried to collect a result while the emergency device still reported that the test was running. A module reset or power cycle during the test can cause this result.
`FAIL_CANCELLED_BY_USER`	A user cancelled the test before the test completed.
`FAIL_ALREADY_IN_TEST`	Another test was already running on the same short address.

Fitting and test results

Result code	Meaning
`FAIL_CIRCUIT_FAILURE`	The device reported a circuit fault.
`FAIL_BATTERY_DURATION_FAILURE`	The battery did not last for its rated duration.
`FAIL_BATTERY_FAILURE`	The device reported a battery fault.
`FAIL_EMERGENCY_LAMP_FAILURE`	The lamp did not strike in emergency mode or did not remain lit for the required duration.
`FAIL_FUNCTIONAL_DELAY`	Current Lightscape versions should not report this code.
`FAIL_DURATION_DELAY`	Current Lightscape versions should not report this code.
`FAIL_FUNCTION_TEST`	The emergency device reported a functional-test failure, but no relevant failure-reason flag was set.
`FAIL_DURATION_TEST`	The emergency device reported a duration-test failure, but no relevant failure-reason flag was set.
`FAIL_TIMEOUT_NEVER_STARTED`	The test did not start within the permitted time.
`FAIL_TIMEOUT_NOT_COMPLETED`	The test did not finish within the permitted time.
`FAIL_OTHER`	An unexpected failure occurred that does not have a more specific result code.
`PASS`	The reported test passed.