====== Hwserver ======


The concept of Gwyscope is based on a server-client approach, i.e. a server - hwserver - is used to control all the hardware based on commands received from a client (e.g. Gwyscope GUI). Default hwserver installation is ''/root/gwyhwserver_gwyscope''. The server can be started after login to the Red Pitaya from the command line, providing port number for client connection and (optionally) .ini file with initial parameters settings. For example

<code>
./hwserver 50100 hwserver.ini
</code>

If started successfully, hwserver should log different values every cca 2 seconds. Note that if hwserver is running and the Red Pitaya would be at the same time accessed using its web interface, then the Red Pitaya freezes and all electronics has to be power cycled.

{{ :wiki:hw:mobaxterm_hwserver.png?400 }}

The start of hwserver can be automated using provided ''hwserver.service'' file. Example of this file is shown here:

<code>
[Unit]
Description=hwserver
After=network.target

[Service]
Type=simple
Environment=SOCKET_NUMBER=50100
Environment=INI_FILE=hwserver.ini
ExecStart=/root/gwyhwserver_gwyscope/hwserver ${SOCKET_NUMBER} ${INI_FILE}
User=root
WorkingDirectory=/root/gwyhwserver_gwyscope/
TimeoutStopSec=10

[Install]
WantedBy=multi-user.target
</code>

Change parameters to match the installation and copy it to ''/lib/systemd/system/'' directory.

<code>
cp /root/gwyhwserver_gwyscope/hwserver.service /lib/systemd/system/
</code>

The service is disabled by default, this can be verified using ''status'' command of ''systemctl'' system services manager.

<code>
root@rp-f0962a:~/gwyhwserver_gwyscope# systemctl status hwserver.service
 hwserver.service - hwserver
   Loaded: loaded (/lib/systemd/system/hwserver.service; disabled; vendor preset: enabled)
   Active: inactive (dead)
</code>

To enable automatic start of the hwserver after reboot or power on use ''enable''.

<code>
root@rp-f0962a:~/gwyhwserver_gwyscope# systemctl enable hwserver.service
Created symlink from /etc/systemd/system/multi-user.target.wants/hwserver.service to /lib/systemd/system/hwserver.service.
</code>

To start the service immediately use ''start''.

<code>
root@rp-f0962a:~/gwyhwserver_gwyscope# systemctl start hwserver.service
root@rp-f0962a:~/gwyhwserver_gwyscope# systemctl status hwserver.service
 hwserver.service - hwserver
   Loaded: loaded (/lib/systemd/system/hwserver.service; enabled; vendor preset: enabled)
   Active: active (running) since Thu 2025-02-20 11:58:50 UTC; 2s ago
 Main PID: 3195 (hwserver)
   CGroup: /system.slice/hwserver.service
           L¦3195 /root/gwyhwserver_gwyscope/hwserver 50100 hwserver.ini

Feb 20 11:58:50 rp-f0962a systemd[1]: Started hwserver.
Feb 20 11:58:50 rp-f0962a hwserver[3195]: starting RP hwserver...
Feb 20 11:58:50 rp-f0962a hwserver[3195]: hwserver version: v3.0
</code>

In order to view hwserver's log use ''journalctl''. Note, however, that the update time is considerably longer (>30 s) because the output is buffered.

<code>
journalctl -f -u hwserver.service
</code>

To stop the service immediately use ''stop''.

<code>
systemctl stop hwserver.service
</code>

If automatic hwserver starting is not desired anymore use ''disable''.

<code>
root@rp-f0962a:~/gwyhwserver_gwyscope# systemctl disable hwserver.service
Removed symlink /etc/systemd/system/multi-user.target.wants/hwserver.service.
</code>