ALERT

The ALERT function is used to notify the user that the currently running program requires user intervention. This is useful in XJRunner when testing several boards simultaneously; the application directs the user's attention to the board that requires attention. In other contexts, where only one board is being tested, this statement has no effect.

The ALERT statement would typically used before a loop that called GETKEY while performing some kind of JTAG access (see the example below). Note that WAITKEY, INPUTBOX, MESSAGEBOX and MESSAGEBOX_ASYNC all automatically perform an ALERT.

ALERT was added in XJTAG v2.2. It is recognised in v2.1 builds of XJTAG from 2.1.9 onwards but has no effect. It is not recognised at all in versions of XJTAG prior to 2.1.9.

ALERT can be called without any brackets after it, but this usage is discouraged and will be deprecated in a future version.

ALERT()

Example

An LED test that flashes the LED and asks the user to confirm that it is flashing.

GLOBAL Test()(INT result)
  PRINT("Is LED ", UNIQUE_DEVICE_REF, " flashing?\nPress the space bar to pass or any other key to fail.\n");
  ALERT();

  DO
    LED := 1;
    SLEEP(100);
    LED := 0;
    SLEEP(100);
    key := GETKEY();
  WHILE key = 0
  END;

  IF key = ' ' THEN
    result := RESULT_PASS;
  ELSE
    result := RESULT_FAIL;
  END;
END;