Campbell

Campbell Scientific dataloggers are industrial measurement loggers, programmed per installation. The adapter reads one through the logger’s own web-service API (command=DataQuery) with no vendor cloud involved, and normalizes two of its tables into a wire document.

Configuration

vendor: "campbell" selects this adapter. The entry is validated by campbellStationConfigSchema, exported from @azohra/meteo.station/server.

Field	Type	Meaning
id	string, required	Your feed-local station id, the value ?station= and primaryStationId name.
name	string, required	The display name carried on the wire.
baseUrl	http(s) URL, required	The logger’s web-service endpoint, the URL that answers ?command=DataQuery.
source	string, required	The data-source symbol that tables are addressed under, for example LOGGER01:Wind Station. The segment after the colon must match the station_name the logger reports in table headers. The adapter verifies the match on every response.
timeZone	IANA zone, required	The zone the logger stamps records in. It is optional for other vendors and required here, because records arrive as naive local time with no offset.
currentTable	string, default "I3Sec"	The fast wind table serving the current reading.
historyTable	string, default "I5Min"	The aggregate table serving history, temperature, and wind chill.
currentIntervalSeconds	positive number, default 3	The current table’s own record interval, verified against the table header, and declared as samplingWindowSeconds.
historyPeriodMinutes	positive number, default 5	The history table’s record interval, verified against the table header, and carried as history.periodMinutes.
currentCacheTtlSeconds	number ≥ 3, default 15	Cache TTL for the current table (history caches for 120 s).
latitude, longitude, elevationM	numbers, optional	Position claims, carried on the wire.
pageUrl	http(s) URL, optional	A public page for the station. There is no vendor default, so omitting it means null.

Capabilities

{ gustLull: true, temperature: true, conditions: false, history: true }. live and battery are undeclared. On the wire, an undeclared capability key reads as false (evolution rules).

The pinned field contracts (below) carry wind, temperature, and wind chill. They include no barometer, so conditions is false and the block never appears (the rulebook). samplingWindowSeconds is currentIntervalSeconds. recommendedPollSeconds is the larger of currentIntervalSeconds and currentCacheTtlSeconds. Polling a three-second table faster than its cache TTL returns the cached rows.

Endpoint

GET <baseUrl>?command=DataQuery&uri=<source>.<table>&format=json&… reads the current table with mode=most-recent and the history table with mode=backfill over the requested window. The config carries no credential fields, and requests carry only the project User-Agent. Access control to the logger belongs to the deployment. Responses are capped at 512 KiB and cache under the key campbell/<baseUrl>/<source>/<table>/<mode>/<period>/<order>. The current table caches for currentCacheTtlSeconds (default 15 s) and the history table for 120 s.

What the adapter guards

• Field contracts are pinned. The current table must carry Wind_Speed (Avg), Wind_Lull (Min), Wind_Gust (Max) in kilometers/hour and WindDir (Smp) in degrees. The history table must carry Temp and Wind_Chill (Smp, Deg C), WindDir, and WS_kph_Max/Avg/Min. A field whose name, process, type, or units changed throws, so a reprogrammed logger degrades to unavailable instead of serving renumbered columns.
• Headers are verified. Every response’s station_name (the text after the colon in source), table_name, and record interval must match the config. A response not marked complete (more: false) throws.
• Naive local times are disambiguated by context. The logger stamps records in station-local time with no offset, and the configured IANA zone converts them. A DST fall-back makes one local hour name two instants. History points resolve to the candidate strictly after the previous point, and the current reading resolves to the candidate nearest now. A spring-forward gap names no instant at all, so the timestamp resolves to the transition itself.
• A current reading sitting about an hour from now (within five minutes of exactly one hour) logs a clock_skew warning. Loggers are often pinned to standard time year-round while the configured zone observes DST. In that case configure a fixed-offset zone (Etc/GMT+8 for Pacific) instead, or the reverse.
• History fails soft and current fails hard. Both tables are fetched in parallel. A history failure costs history, along with the temperature and wind chill it carries. The failure is logged and the station stays ok. A current-table failure degrades the whole station.
• Temperature and wind chill come from the history table, because the current table carries wind only. In mode: "current" the adapter reads just the current table and reuses the last full load’s temperature and wind chill from cache (TTL 120 s). After that they are null rather than stale.
• Speeds are validated 0–500 in the vendor’s km/h before conversion to m/s. Directions are validated 0–360 and normalized, and a calm reading carries a null direction.

Setup

import { createStationFeedHandler } from "@azohra/meteo.station/server";

const handler = createStationFeedHandler({
  stations: [
    {
      vendor: "campbell",
      id: "summit",
      name: "Summit Logger",
      baseUrl: "http://logger.example:30001/.",
      source: "LOGGER01:Wind Station",
      timeZone: "America/Vancouver",
      latitude: 49.5,
      longitude: -118.5,
    },
  ],
});

export default { fetch: handler };

Where next

To render the station, getting started § 2 mounts the card against your feed. History is declared, so the chart and trend draw. conditions is not declared, so the air matrix carries no column for this station (What your hardware shows maps the rest). Pick React or custom elements, then theming.