How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Picarro Edge — SAM FOUP gRPC API

The first-party gRPC/ProtoBuf interface Picarro publishes for external access to Picarro SAM (semiconductor airborne molecular contamination) systems. The `picarro-edge` server exposes three services — FOUP for starting, aborting and retrieving FOUP measurement jobs, MeasurementSet for managing which compounds are measured, and Controller for streaming instrument health alerts. Every service also exposes a server-streaming `watch()` signal feed that acts as a pub/sub event channel. Interface definitions, Python client wheels, Debian packages and command-line tools are published openly on GitHub.

This event API exposes 0 operations across 6 channels, and defines 19 schemas. It is described by AsyncAPI 3.0.0, at version 6.1.0.

The API connects through 2 servers: localhost:3343 (grpc), localhost:7528 (grpc).

0 operations 6 channels 19 schemas

Metadata

The identity and technical contract details declared by the specification.

Specification
AsyncAPI 3.0.0
API Version
6.1.0
Base URL
grpc://localhost:3343

Messages & Schemas 19

The contract defines 19 schemas that model the data carried by its messages. The most detailed are Error (8 properties), JobStatus (1 property), OperationalStatus (1 property), AnalyzerFdcEvent (1 property). Each schema is shown below with its type and property counts.

OperationalStatus
message
Emitted on any change of system operational state.
JobStatus
message
Emitted upon change, and once per second during a run.
JobResult
message
Emitted once a job has completed successfully.
ReprocessedResult
message
Emitted when reprocessed data is available.
AnalyzerFdcEvent
message
Emitted when the analyzer reports FDC flags. Introduced in FOUP v6.1. Carries an escalation reason (ESCALATED, ESCALATIONCONTINUED every 60s while critical, or…
MSOpResponse
message
Emitted on measurement-set operation status change (MSOPACCEPTED, MSOPSUCCESS, ...).
SuggestedMeasurementSets
message
Measurement-set additions the system suggests from historical data.
RawPicarroMQ
message
Raw message received over PicarroMQ from SAM core. mappingkey is the PicarroMQ topic; mappingaction is fixed as MAPUPDATE. Not cached server-side. Debugging us…
AnalyzerDriverStarted
message
mappingaction fixed as MAPADDITION; mappingkey is the analyzer identity (e.g. "Picarro9038-NUV1083"). Implicitly invalidates existing analyzerhealth mappings.…
AnalyzerHealth
message
mappingaction indicates added/updated/removed; mappingkey is the analyzer identity. Cached server-side and re-emitted on subsequent watch() calls.
GenericPlatformSignal
message
Signal multiplexer emitted by the platform services. See the corresponding .proto file in grpc/ for the exact oneof variants.
Error
object
picarro.status.Error — the common status/exception payload.
8 properties
OperationalStatus
object
Overall system operational state.
1 property
JobStatus
object
1 property
JobResult
object
Measured concentrations for a completed job.
1 property
AnalyzerFdcEvent
object
1 property
MSOpResponse
object
Measurement-set operation acknowledgement/result (MSOPACCEPTED, MSOPSUCCESS).
MeasurementSetList
object
A list of measurement sets with their compound-id (cid) membership.
VariantValue
object
picarro.variant.Value — a dynamically typed value.

Specification

The full machine-readable AsyncAPI contract behind this narrative.

Source

picarro-sam-foup-asyncapi.yml Raw ↑
Where this information came from

This is an independent, third-party profile of Picarro Edge — SAM FOUP gRPC API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.