pflarue / ardop

Source for various version of ARDOP
Other
23 stars 4 forks source link

Webgui #23

Closed pflarue closed 1 month ago

pflarue commented 1 month ago

Add a new web browser based GUI for ardopcf. This is enabled by using -G or --webgui followed by a port number when starting ardopcf. Then, once ardopcf is running, point a web browser to that port number to display an interactive web page. This should work with a web browser on the same machine where ardopcf is running, or from any other device on the same network.

This is intended as a replacement for the ARDOP GUI written by John Wiseman for use with (pi)ardopc. While that GUI will continue to be supported for now, support for it may be phased out once any bugs in this new Webgui are worked out. The greatest advantage of this Webgui over the earlier GUI is that, since it is viewed in a web browser, it is completely platform independent. Thus, it is also usable on a phone or tablet, making it a good companion to Pat Winlink using the HTTP interface. Other than its platform independence, the most significant feature that the Webgui has over the older ARDOP GUI is the ability to adjust the Transmit Drive Level. This provides a more convenient way to adjust the amplitude of the audio sent to the radio. This can be used to avoid overdriving the radio.

The WebSocket based communication protocol used for communication between ardopcf and the browser based WebGui should be considered unstable and undocumented. It is subject to significant change without notice in future releases of ardopcf. Thus, other programs should not attempt to interface with ardopcf via this protocol.

A Developer Mode is also supported by this new Webgui. If a negative port number is specified when starting ardopcf, then the Webgui will be available at the corresponding positive port number, with some additional features enabled. The most significant of these features is a one line text input control that allows Host commands to be sent to ardopcf, including the recently added _SEND command. As its name suggests, Developer Mode is intended only for Development and Debugging, not for normal use of ardopcf with a host program such as Pat Winlink.