Add RTL-TCP.

Author: Cossey

rtl-tcp/Dockerfile

@@ -0,0 +1,14 @@
+FROM alpine
+
+LABEL maintainer="[email protected]"
+EXPOSE 1234
+HEALTHCHECK --interval=30s --timeout=30s --start-period=5s --retries=3 CMD pgrep -f rtl_tcp
+
+RUN apk add --no-cache bash rtl-sdr
+
+RUN echo 'blacklist dvb_usb_rtl28xxu' > /etc/modprobe.d/dvb_usb_rtl28xxu.conf
+
+ADD /library.sh /
+ADD /rtl-tcp/rtl-tcp.sh /
+
+ENTRYPOINT ["/rtl-tcp.sh"]

rtl-tcp/README.md

@@ -0,0 +1,38 @@
+# RTL TCP (SDR)
+
+Repository for a docker image that runs the rtl_tcp program.
+Originally leveraging the `erben22/rpi-rtlsdr-base` image, this image has been overhauled and runs an instance of the rtl_tcp program.
+
+## Environment Variables
+
+| Variable     | Type    | Description                                               |
+| ------------ | ------- | --------------------------------------------------------- |
+| DEVICE       | integer | Set the device index. *Default 0*.                        |
+| GAIN         | integer | Set the device gain. *Default 0 (auto)*.                  |
+| BUFFERS      | integer | Set the number of buffers. *Default 15*.                  |
+| LIST_BUFFERS | integer | Max number of linked list buffers to keep. *Default 500*. |
+| PPM_ERROR    | integer | PPM Error. *Default 0*.                                   |
+| FREQUENCY    | integer | Frequency to tune to (Hz).                                |
+| SAMPLE_RATE  | integer | Sample rate (Hz). *Default 2048000 Hz*.                   |
+| BIAS_T       | boolean | Enable bias-T on GPIO PIN 0.                              |
+
+> All the variables above also support the `_FILE` suffix to load their values from a file.
+
+## Usage
+
+Run rtl_tcp in a container, exposing connections to it via port 1234.
+Using `--privileged` and mapping the `/dev/bus/usb` volume, an RTL dongle is made available to the container.
+Clients will be able to connect via port 1234 to the docker hosts's address.
+
+```sh
+sudo docker run -d -it -p 1234:1234 --device /dev/bus/usb:/dev/bus/usb kosdk/rtl-tcp
+```
+
+## Building this Image
+
+Use the [unified build tool](/README.md#building-images).
+There are no additional parameters to configure.
+
+## Health check
+
+This image checks to ensure that the script is running.

rtl-tcp/build.env

@@ -0,0 +1,2 @@
+PLATFORM=linux/arm/v6,linux/arm/v7,linux/arm64,linux/386,linux/amd64,linux/ppc64le,linux/s390x
+DOCKERFILE=./Dockerfile

rtl-tcp/rtl-tcp.sh

@@ -0,0 +1,76 @@
+#!/bin/bash
+
+# RTL TCP Entrypoint script
+# Copyright (C) 2022 Stewart Cossey
+
+. ./library.sh
+
+extraparams=""
+
+file_env "DEVICE"
+file_env "GAIN"
+file_env "BUFFERS"
+file_env "LIST_BUFFERS"
+file_env "PPM_ERROR"
+file_env "FREQUENCY"
+file_env "SAMPLE_RATE"
+file_env "BIAS_T"
+
+validate_env "DEVICE" int
+validate_env "GAIN" int
+validate_env "BUFFERS" int
+validate_env "LIST_BUFFERS" int
+validate_env "PPM_ERROR" int
+validate_env "FREQUENCY" int
+validate_env "SAMPLE_RATE" int
+validate_env "BIAS_T" bool
+
+if [ -n "$DEVICE" ]
+then
+    echo "Using device index ${DEVICE}"
+    extraparams+="-d ${DEVICE} "
+fi
+
+if [ -n "$GAIN" ]
+then
+    echo "Using gain ${GAIN}"
+    extraparams+="-g ${GAIN} "
+fi
+
+if [ -n "$BUFFERS" ]
+then
+    echo "Using ${BUFFERS} buffers"
+    extraparams+="-b ${BUFFERS} "
+fi
+
+if [ -n "$LIST_BUFFERS" ]
+then
+    echo "Using ${LIST_BUFFERS} max linked list buffers"
+    extraparams+="-n ${LIST_BUFFERS} "
+fi
+
+if [ -n "$PPM_ERROR" ]
+then
+    echo "Using ppm ${PPM_ERROR}"
+    extraparams+="-P ${PPM_ERROR} "
+fi
+
+if [ -n "$FREQUENCY" ]
+then
+    echo "Using frequency ${FREQUENCY}"
+    extraparams+="-f ${FREQUENCY} "
+fi
+
+if [ -n "$SAMPLE_RATE" ]
+then
+    echo "Using sample rate ${SAMPLE_RATE}"
+    extraparams+="-s ${SAMPLE_RATE} "
+fi
+
+if [ -n "$BIAS_T" ] && [ "$BIAS_T" == "true" ]
+then
+    echo "Using bias-T"
+    extraparams+="-T "
+fi
+
+rtl_tcp -a ${LISTEN_IP:-$(hostname -i)} $extraparams