# at.adsb.receiver.station

> Published by [adsb.at](https://lexicon.garden/identity/did:plc:32thk4eifx4ou6mxevswgjhg)

✓ This is the authoritative definition for this NSID.

## Description

A declaration of an ADS-B receiver station. One per account, representing a physical receiver contributing aircraft surveillance data to the network.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:32thk4eifx4ou6mxevswgjhg/at.adsb.receiver.station)
- [Documentation](https://lexicon.garden/lexicon/did:plc:32thk4eifx4ou6mxevswgjhg/at.adsb.receiver.station/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:32thk4eifx4ou6mxevswgjhg/at.adsb.receiver.station/examples)

## Definitions

### `at.adsb.receiver.station`

**Type**: `record`

A declaration of an ADS-B receiver station.

**Key**: `literal:self`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `avatar` | `blob` | No | Photo of the receiver setup or antenna. |
| `status` | `string` | Yes | Current operational status of the station. |
| `website` | `string` (uri) | No | URL to the station's public stats page or dashboard. |
| `hardware` | `ref` → `#hardwareInfo` | No |  |
| `location` | `ref` → `community.lexicon.location.geo` | Yes | Approximate geographic position of the receiver. For privacy, coordinates should be rounded to 2 decimal places (~1 km precision). MLAT services requiring precise positions should handle that out-of-band unless comfortable with precise coordinates. |
| `createdAt` | `string` (datetime) | Yes |  |
| `protocols` | `array` | No | Data protocols this station receives. |
| `description` | `string` | No | Free-form description of the station, its setup, or coverage area. |
| `displayName` | `string` | Yes | Human-readable name for the station. |
| `coverageRadiusNm` | `integer` | No | Estimated reception range in nautical miles. |

### `at.adsb.receiver.station#hardwareInfo`

**Type**: `object`

Receiver hardware and software details.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `antenna` | `string` | No | Antenna type or model. |
| `receiver` | `string` | No | Receiver type or model (e.g. 'RTL-SDR V4', 'Airspy Mini'). |
| `software` | `string` | No | Decoder software in use (e.g. 'readsb', 'dump1090-fa'). |

## Raw Schema

```json
{
  "id": "at.adsb.receiver.station",
  "defs": {
    "main": {
      "key": "literal:self",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "displayName",
          "location",
          "status",
          "createdAt"
        ],
        "properties": {
          "avatar": {
            "type": "blob",
            "accept": [
              "image/png",
              "image/jpeg"
            ],
            "maxSize": 1000000,
            "description": "Photo of the receiver setup or antenna."
          },
          "status": {
            "type": "string",
            "maxLength": 256,
            "description": "Current operational status of the station.",
            "knownValues": [
              "at.adsb.receiver.station#active",
              "at.adsb.receiver.station#inactive",
              "at.adsb.receiver.station#maintenance"
            ]
          },
          "website": {
            "type": "string",
            "format": "uri",
            "description": "URL to the station's public stats page or dashboard."
          },
          "hardware": {
            "ref": "#hardwareInfo",
            "type": "ref"
          },
          "location": {
            "ref": "community.lexicon.location.geo",
            "type": "ref",
            "description": "Approximate geographic position of the receiver. For privacy, coordinates should be rounded to 2 decimal places (~1 km precision). MLAT services requiring precise positions should handle that out-of-band unless comfortable with precise coordinates."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime"
          },
          "protocols": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 256,
              "knownValues": [
                "at.adsb.receiver.station#adsb",
                "at.adsb.receiver.station#mlat",
                "at.adsb.receiver.station#uat",
                "at.adsb.receiver.station#acars",
                "at.adsb.receiver.station#vdl2",
                "at.adsb.receiver.station#hfdl"
              ]
            },
            "maxLength": 10,
            "description": "Data protocols this station receives."
          },
          "description": {
            "type": "string",
            "maxLength": 2560,
            "description": "Free-form description of the station, its setup, or coverage area.",
            "maxGraphemes": 256
          },
          "displayName": {
            "type": "string",
            "maxLength": 640,
            "description": "Human-readable name for the station.",
            "maxGraphemes": 64
          },
          "coverageRadiusNm": {
            "type": "integer",
            "maximum": 500,
            "minimum": 0,
            "description": "Estimated reception range in nautical miles."
          }
        }
      },
      "description": "A declaration of an ADS-B receiver station."
    },
    "hardwareInfo": {
      "type": "object",
      "properties": {
        "antenna": {
          "type": "string",
          "maxLength": 640,
          "description": "Antenna type or model.",
          "maxGraphemes": 64
        },
        "receiver": {
          "type": "string",
          "maxLength": 640,
          "description": "Receiver type or model (e.g. 'RTL-SDR V4', 'Airspy Mini').",
          "maxGraphemes": 64
        },
        "software": {
          "type": "string",
          "maxLength": 640,
          "description": "Decoder software in use (e.g. 'readsb', 'dump1090-fa').",
          "maxGraphemes": 64
        }
      },
      "description": "Receiver hardware and software details."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "description": "A declaration of an ADS-B receiver station. One per account, representing a physical receiver contributing aircraft surveillance data to the network."
}
```