| 1 |
1 |
'''[wiki:GraspSwControllerCmd console]''' |
| 2 |
2 |
[[TracNav(GraspContents)]] |
| 3 |
3 |
||Command:||'''console'''|| |
| 4 |
4 |
||Contexts:||Network socket.|| |
| 5 |
5 |
||Function:||Turns off and on echo of commands on the serial console.|| |
| 6 |
6 |
||Required Parameters:||Console echo '''on''' (default at power up) or '''off'''|| |
| 7 |
7 |
||Optional Parameters:||none.|| |
| 8 |
8 |
When the STARGRASP controller boots, before the network is initialized, diagnostic |
| 10 |
10 |
After a DHCP (or static IP) address is assigned, the controller attempts to |
| 11 |
11 |
send log messages to the network console, to a process called [wiki:GraspSwToolkitReceiver grasp_receiver] |
| 12 |
12 |
which usually runs on tcp port 55515 of the DHCP server host (though the DHCP server |
| 13 |
13 |
can redirect to another host using the "next-server" directive.) |
| 14 |
14 |
Once "stage2" controller firmware is running and the network console connection |
| 15 |
15 |
is established, all commands sent to the controller still echo on the serial |
| 16 |
16 |
console, too. This should be turned off using the command '''console off''' |
| 17 |
17 |
with grasp_cmd through the network, for best performance. |
| 18 |
18 |
Later versions of the controller embedded code (developed after summer 2011) turn off console output automatically as soon as any network command is received to minimize the chances of console output being generated and unintentionally slowing down controller performance. In all cases, lack of a connection to the network logging program [wiki:GraspSwToolkitReceiver grasp_receiver] will still result in serial console output and slow performance. |
| 19 |
19 |
=== Notes: === |
| 20 |
20 |
''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.'' |
| 21 |
21 |
''Any command (or carriage return) entered on the serial console will re-enable '''console on''' mode.'' |
| 22 |
22 |
Recommendation is to have '''console off''' sent as part of the power-on initialization sequence for your detector unless you have newer firmware which defaults to this mode. Even in that case, the command won't do any harm. |
