„README.md“ ändern

This commit is contained in:
Michael Clemens 2021-11-12 09:56:51 +01:00
parent 9b004c8043
commit 1039317d5a

View File

@ -1,2 +1,60 @@
# hr50-api # Hardrock-50 API
The Hardrock-50 is a 50W power amplifier for amateur radio QRP transceivers. It has a display showing valuable information like the selected band, the SWR, power, temperature etc. This project provides an API that can be used to query all relevant information of the HR50 via HTTP. It is also possible to send commands to the HR50 via HTTP, e.g. to change the band or to change the keying method.
# Preconditions
You need a computer connected to the Hardrock-50 via USB, e.g. a Raspberry Pi. This system needs to be able to run Python and has to be connected to your network.
# Installation
Download all files and copy them into a directory on your raspberry pi. alternatively, you can clone the git repository as follows:
'''
# git clone https://git.qrz.is/clemens/hr50-api.git
'''
# Configuration
Open the file _hr50api.py_ and adapt the following lines to your environment:
'''
serial_port = '/dev/ttyUSB0'
baud = 19200
'''
# Execution
Executing this script will spawn a web server running on port 5000. This is not meant for production use and/or public exposure. Anyone able to access this server via the network can alter any settings on your HR50.
Run it as follows:
'''
# cd hr50-api
# ./bootstrap.sh
'''
# Examples
Now you can access the API e.g. with your (HR50 Remote Display)[https://git.qrz.is/clemens/hr50-remote-display]
For testing or other purposes, you can access the api with trhe help of curl or any webbrowser:
Set the keying method to 'PTT':
'''
micha@heater:~/hr50-api$ curl http://<IP_ADDRESS>:5000?cmd=hrmd1
'''
Set the keying method to 'COR':
'''
micha@heater:~/hr50-api$ curl http://<IP_ADDRESS>:5000?cmd=hrmd2
'''
Query the status:
'''
micha@heater:~/hr50-api$ curl http://<IP_ADDRESS>:5000/status
{"AVG":"43","BND":"15M","PEP":"60","PTT":"COR","STA":"RX","SWR":"1.9","TMP":"12C","VLT":"13.7V"}
'''