// Copyright 2023 The Pigweed Authors
//
// Licensed under the Apache License, Version 2.0 (the "License"); you may not
// use this file except in compliance with the License. You may obtain a copy of
// the License at
//
//     https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
// WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
// License for the specific language governing permissions and limitations under
// the License.
syntax = "proto3";

package pw.trace.proto;

import "pw_chrono_protos/chrono.proto";

// TODO: b/309643763 - This is the prefered service for tracing, and the service
// defined in trace_rpc.proto has been deprecated and will be removed once
// existings clients migrate to this service.
service TraceService {
  // Start will enable tracing, populating the trace ring buffer.
  rpc Start(StartRequest) returns (StartResponse) {}

  // On stop the ring buffer will be written to the configured
  // stream.  No data is written to the stream until Stop is called.
  rpc Stop(StopRequest) returns (StopResponse) {}

  // Returns the clock paramaters of the system.
  rpc GetClockParameters(ClockParametersRequest)
      returns (ClockParametersResponse) {}
}

message StartRequest {}

message StartResponse {}

message StopRequest {}

message StopResponse {
  // as a convenience, the file id is returned on stop which can be
  // used to start a transfer directly, rather that requiring a user
  // list the files to obtain the file id.
  optional uint32 file_id = 1;
}

message ClockParametersRequest {}

message ClockParametersResponse {
  pw.chrono.ClockParameters clock_parameters = 1;
}