id: apollo_agc_bridge
label: Apollo AGC Bridge
category: '[Apollo USB]'
flags: [python]

parameters:
- id: host
  label: yaAGC Host
  dtype: string
  default: 'localhost'
- id: port
  label: yaAGC Port
  dtype: int
  default: '19697'

inputs:
- label: uplink_data
  domain: message
  optional: true

outputs:
- label: downlink_data
  domain: message
- label: status
  domain: message

templates:
  imports: from apollo import agc_bridge
  make: >-
    apollo.agc_bridge.agc_bridge(
      host=${host},
      port=${port})

documentation: |-
  Apollo AGC Bridge

  Bidirectional bridge between GNU Radio message ports and a Virtual AGC
  (yaAGC) instance over TCP. Connects as a client to the AGC socket
  protocol (4-byte packets on port 19697).

  Filters for telecom-relevant channels (045 INLINK, 057 OUTLINK,
  034 DNTM1, 035 DNTM2) by default.

  Auto-reconnects with exponential backoff on connection loss.

  Ports:
    uplink_data (in)  - PDU with (channel, value) to send to AGC
    downlink_data (out) - received AGC packets as PDU
    status (out) - connection state: "connecting", "connected", "disconnected"

  Parameters:
    host: yaAGC hostname or IP address
    port: yaAGC TCP port number

file_format: 1