.RU     RUn Command

Syntax:

          .RU  command with arguments

See also:

.TF  

Function:

The .RU directive allows you to run another program or script after the assembler has finished without an error. This is most useful if you want to start the programmer directly after assembly.
This directive is available as of version 3.03.00 of the SB-Assembler.

Boundary Sync:

In Version 3 of the SB-Assembler this directive will not perform a boundary sync.

Explanation:

It doesn't matter where you use this directive in your program. Usually it is used somewhere at the top of the program, just before or after specifying the target file for instance.
It is useless to have more than one .RU directive in one program, however it is not an error if you do so. Only the last instance of the command will be executed a the end of the assembly run.

The most practical use of this directive is to start a programmer right after an assembly run. Therefore the command or script will only be executed when the assembly ends without errors. Remember that the target file will most likely be corrupt when the assembler ends with an error. Thus uploading a corrupt file would most likely crash your target system.
Warnings are ignored.

You can run any command you like, including all required arguments. Everything following the .RU directive will be considered to be the command and its arguments. No syntax checking is performed by the SB-Assembler.

Example:

         .RU  epsim -a 2732 mynewprogram.int
         .RU  avrdude -P /dev/ttyUSB0 -p m644 -U flash:w:mynewprogram.hex