docker-gr-iridium-toolkit + TBG + libacars

A Docker image to use the gr-iridium and iridium-toolkit software from the Chaos Computer Club München to parse ACARS messages on the Iridium network.

It is possible to send ACARS and map data to TBG by performing the following steps:

1. Set the ACARS_ADDITIONAL_OUTPUTS variable in docker-compose.yaml to include "udp:thebaldgeek.net:XXXX". Contact him to get the port number.
2. Set the LIVEMAP_TO_TBG variable to true, set the ICAO code of your nearby airport AIRPORT_ICAO_CODE and specify the port to which you will send the satellite beam data TBG_SATS_PORT.

This was made using Kevin's script to manage MUCCC Iridium Toolkit and Rajan's docker image to wrap it.

Under active development, everything is subject to change without notice.

---

Docker Compose

services:
  irdm:
    container_name: irdm
    hostname: irdm
    image: ghcr.io/jkrasuk/docker-gr-iridium-toolkit
#    build: docker-gr-iridium-toolkit
    restart: always
    tty: true # actually needed, for iridium-parser.py
    ports:
      - 8888:8888 # for beam map
      - 8889:8889 # for mt map
    device_cgroup_rules:
      - 'c 189:* rwm'
    volumes:
      - /dev:/dev:rw
      - ./irdm.conf:/opt/irdm.conf:ro
      - ./logs:/opt/logs
    environment:
      - ENABLE_BEAM_MAP=true
#      - ENABLE_MTPOS_MAP=true
#      - ENABLE_MTPOS_MAP_LOG=true
#      - DISABLE_EXTRACTOR=true
      - LOG_EXTRACTOR_STATS=true
#      - LOG_MAP=true
      - EXTRACTOR_ARGS= -D 4 --multi-frame # Valid values when running high sample rate are 1, 2, 4, 8 and 16
      - STATION_ID=XX-YYYY-IRDM
      - LIVEMAP_TO_TBG=true
      - TBG_SATS_PORT=ZZZZ
      - AIRPORT_ICAO_CODE=YYYY
      - ACARS_ADDITIONAL_OUTPUTS=udp:acarshub:5558,udp:thebaldgeek.net:NNNN
#      - LOG_ACARS=true
#      - PARSER_ARGS= --harder --uw-ec --stats # remove --uw-ec then --harder if CPU usage is too high. --stats is required until an upstream bug is fixed
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "5"

irdm.conf has details of your SDR device. Full details can be found here. An example for using an RTL-SDR with max gain and bias-tee enabled:

[osmosdr-source]
sample_rate=2500000
center_freq=1625600000

# Uncomment to use the RTL-SDR's Bias Tee if available
device_args='rtl=0,bias=1'

# Automatic bandwidth
bandwidth=0

# LNA gain
gain=49.6