'''[wiki:GraspSwControllerCmd console]'''

[[TracNav(GraspContents)]]

||Command:||'''console'''||
||Contexts:||Network socket.||
||Function:||Turns off and on echo of commands on the serial console.||
||Required Parameters:||Console echo '''on''' (default at power up) or '''off'''||
||Optional Parameters:||none.||

When the STARGRASP controller boots, before the network is initialized, diagnostic
messages are sent to the serial console port (9600 BAUD, No stop bits, 8 data, 1 parity.)
After a DHCP (or static IP) address is assigned, the controller attempts to
send log messages to the network console, to a process called grasp_receiver
which usually runs on tcp port 55515 of the DHCP server host (though the DHCP server
can redirect to another host using the "next-server" directive.)

Once "stage2" controller firmware is running and the network console connection
is established, all commands sent to the controller still echo on the serial
console, too.  This should be turned off using the command '''console off'''
with grasp_cmd through the network, for best performance.

=== Notes: ===

''Controller real-time performance will be adversely affected if the controller is unable to establish network logging, or if the controller is left in '''console on''' mode where commands still echo on the serial port.''

''Any command (or carriage return) entered on the serial console will re-enable '''console on''' mode.''

Recommendation is to have '''console off''' sent as part of the power-on initialization sequence for your detector.