comm

Documentation

Overview

Package comm contains trace_replay application host <-> guest communication protocol structures.

Index

• Constants
• type PowerTestVars
  • func GetPowerTestVars(s *testing.State) PowerTestVars
• type ProxyServerInfo
• type RepositoryInfo
• type SystemInfo
• type TestEntryResult
• type TestGroupConfig
• type TestGroupResult
• type TestVars
• type ValueEntry
• type VersionInfo

Constants

const (
	// TestResultSuccess means all the tests in a test group were completed successfully
	TestResultSuccess = "Success"
	// TestResultFailure means one or several tests in the group encountered a failure
	TestResultFailure = "Failure"

	// ProtocolVersion defines the current version of the communication protocol
	ProtocolVersion = 1

	// TestFlagDefault is used to select the default replay mode
	TestFlagDefault = "default"
	// TestFlagSurfaceless is used to select the surfaceless replay mode
	TestFlagSurfaceless = "surfaceless"
)

Types

type PowerTestVars

type PowerTestVars struct {
	ResultDir            string `json:"ResultDir,string"`
	SignalRunningFile    string `json:"SignalRunningFile,string"`
	SignalCheckpointFile string `json:"SignalCheckpointFile,string"`
}

PowerTestVars struct contains all runtime variables used by tests that interact with the graphics_Power test via IPC

func GetPowerTestVars

func GetPowerTestVars(s *testing.State) PowerTestVars

GetPowerTestVars populates a PowerTestVars struct with all of the dynamically defined variable values by querying the testing.State

type ProxyServerInfo

type ProxyServerInfo struct {
	URL string `json:"URL"`
}

ProxyServerInfo is used as a container for a proxy server information

type RepositoryInfo

type RepositoryInfo struct {
	RootURL string `json:"RootURL"`
	Version uint32 `json:"Version,string"`
}

RepositoryInfo is used as a container for the information about GC storage repository

type SystemInfo

type SystemInfo struct {
	Board           string `json:"Board"`
	Chipset         string `json:"Chipset"`
	Model           string `json:"Model"`
	ChromeOSVersion string `json:"ChromeOSVersion"`
}

SystemInfo is used as a container for the host related information

type TestEntryResult

type TestEntryResult struct {
	Name    string                `json:"Name"`
	Result  string                `json:"Result"`
	Message string                `json:"Message"`
	Values  map[string]ValueEntry `json:"Values"`
}

TestEntryResult struct contains the result of one TestEntry

type TestGroupConfig

type TestGroupConfig struct {
	Labels           []string        `json:"Labels"`
	Flags            []string        `json:"Flags"`
	Repository       RepositoryInfo  `json:"Repository"`
	Host             SystemInfo      `json:"Host"`
	ProxyServer      ProxyServerInfo `json:"ProxyServer"`
	Timeout          uint32          `json:"Timeout,string"`
	ExtendedDuration uint32          `json:"ExtendedDuration,string"`
}

TestGroupConfig struct is a part of host->guest communication protocol and it used to define a trace replay test group configuration as well as a container to deliver the required host environment related information inside the guest

type TestGroupResult

type TestGroupResult struct {
	Result  string            `json:"Result"`
	Message string            `json:"Message"`
	Entries []TestEntryResult `json:"Entries"`
}

TestGroupResult struct is a part of guest->host communication protocol and it carries the test results for a whole test group

type TestVars

type TestVars struct {
	PowerTestVars PowerTestVars `json:"PowerTestVars"`
}

TestVars struct contains all runtime variables that are consumed by the TraceReplay family of tests

type ValueEntry

type ValueEntry struct {
	Unit      string  `json:"Unit"`
	Direction int32   `json:"Direction,string"`
	Value     float32 `json:"Value,string"`
}

ValueEntry struct contains the result metrics for one trace replay test

type VersionInfo

type VersionInfo struct {
	ProtocolVersion uint32 `json:"ProtocolVersion,string"`
}

VersionInfo is used as a container for the protocol version information