framework/device/information.go

// Copyright (C) 2016 The Android Open Source Project
//
// 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
//
//      http://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.

package device

import (
	"net/url"

	"android.googlesource.com/platform/tools/gpu/framework/id"
)

// Information represents an instance of a specific computer Configuration.
// An instance is persistable, and can be used to retain information about offline devices, and reconnect to them.
type Information struct {
	ID            id.ID         // The unique identifier of the device.
	Name          string        // The friendly name of this device.
	Address       *url.URL      // How to connect to the device. The scheme controls the connection mechanism.
	Configuration Configuration // The hardware and software configuration of the device.
}

// GetID returns the instance identifier.
// It is safe to call on a nil pointer, in which case it returns the default ID.
func (i *Information) GetID() id.ID {
	if i == nil {
		return id.ID{}
	}
	return i.ID
}