service

Documentation

Overview

This package provides a basic EdgeX Foundry device service implementation meant to be embedded in an application, similar in approach to the builtin net/http package.

Index

• func DriverConfigs() map[string]string
• func Main(serviceName string, serviceVersion string, proto interface{}, ...)
• type Bootstrap
  • func NewBootstrap(router *mux.Router) *Bootstrap
  • func (b *Bootstrap) BootstrapHandler(ctx context.Context, wg *sync.WaitGroup, startupTimer startup.Timer, ...) (success bool)
• type DeviceService
  • func RunningService() *DeviceService
  • func (s *DeviceService) AddDevice(device models.Device) (string, errors.EdgeX)
  • func (s *DeviceService) AddDeviceAutoEvent(deviceName string, event models.AutoEvent) errors.EdgeX
  • func (s *DeviceService) AddDeviceProfile(profile models.DeviceProfile) (string, errors.EdgeX)
  • func (s *DeviceService) AddProvisionWatcher(watcher models.ProvisionWatcher) (string, errors.EdgeX)
  • func (s *DeviceService) AddRoute(route string, handler func(http.ResponseWriter, *http.Request), ...) error
  • func (s *DeviceService) AsyncReadings() bool
  • func (s *DeviceService) DeviceDiscovery() bool
  • func (s *DeviceService) DeviceProfiles() []models.DeviceProfile
  • func (s *DeviceService) DeviceResource(deviceName string, deviceResource string) (models.DeviceResource, bool)
  • func (s *DeviceService) Devices() []models.Device
  • func (s *DeviceService) GetDeviceByName(name string) (models.Device, errors.EdgeX)
  • func (s *DeviceService) GetProvisionWatcherByName(name string) (models.ProvisionWatcher, errors.EdgeX)
  • func (s *DeviceService) Initialize(serviceName, serviceVersion string, proto interface{})
  • func (s *DeviceService) Name() string
  • func (s *DeviceService) ProvisionWatchers() []models.ProvisionWatcher
  • func (s *DeviceService) RemoveDeviceAutoEvent(deviceName string, event models.AutoEvent) errors.EdgeX
  • func (s *DeviceService) RemoveDeviceByName(name string) errors.EdgeX
  • func (s *DeviceService) RemoveDeviceProfileByName(name string) errors.EdgeX
  • func (s *DeviceService) RemoveProvisionWatcher(name string) errors.EdgeX
  • func (s *DeviceService) ResourceOperation(deviceName string, deviceResource string, method string) (models.ResourceOperation, bool)
  • func (s *DeviceService) Stop(force bool)
  • func (s *DeviceService) UpdateDevice(device models.Device) errors.EdgeX
  • func (s *DeviceService) UpdateDeviceOperatingState(deviceName string, state string) errors.EdgeX
  • func (s *DeviceService) UpdateDeviceProfile(profile models.DeviceProfile) errors.EdgeX
  • func (s *DeviceService) UpdateFromContainer(r *mux.Router, dic *di.Container)
  • func (s *DeviceService) UpdateProvisionWatcher(watcher models.ProvisionWatcher) errors.EdgeX
  • func (s *DeviceService) Version() string

Functions

func DriverConfigs

func DriverConfigs() map[string]string

DriverConfigs retrieves the driver specific configuration

func Main

func Main(serviceName string, serviceVersion string, proto interface{}, ctx context.Context, cancel context.CancelFunc, router *mux.Router)

Types

type Bootstrap

type Bootstrap struct {
	// contains filtered or unexported fields
}

Bootstrap contains references to dependencies required by the BootstrapHandler.

func NewBootstrap

func NewBootstrap(router *mux.Router) *Bootstrap

NewBootstrap is a factory method that returns an initialized Bootstrap receiver struct.

func (*Bootstrap) BootstrapHandler

func (b *Bootstrap) BootstrapHandler(ctx context.Context, wg *sync.WaitGroup, startupTimer startup.Timer, dic *di.Container) (success bool)

type DeviceService

type DeviceService struct {
	ServiceName    string
	LoggingClient  logger.LoggingClient
	RegistryClient registry.Client
	SecretProvider interfaces.SecretProvider
	// contains filtered or unexported fields
}

func RunningService

func RunningService() *DeviceService

RunningService returns the Service instance which is running

func (*DeviceService) AddDevice

func (s *DeviceService) AddDevice(device models.Device) (string, errors.EdgeX)

AddDevice adds a new Device to the Device Service and Core Metadata Returns new Device id or non-nil error.

func (*DeviceService) AddDeviceAutoEvent

func (s *DeviceService) AddDeviceAutoEvent(deviceName string, event models.AutoEvent) errors.EdgeX

AddDeviceAutoEvent adds a new AutoEvent to the Device with given name

func (*DeviceService) AddDeviceProfile

func (s *DeviceService) AddDeviceProfile(profile models.DeviceProfile) (string, errors.EdgeX)

AddDeviceProfile adds a new DeviceProfile to the Device Service and Core Metadata Returns new DeviceProfile id or non-nil error.

func (*DeviceService) AddProvisionWatcher

func (s *DeviceService) AddProvisionWatcher(watcher models.ProvisionWatcher) (string, errors.EdgeX)

AddProvisionWatcher adds a new Watcher to the cache and Core Metadata Returns new Watcher id or non-nil error.

func (*DeviceService) AddRoute

func (s *DeviceService) AddRoute(route string, handler func(http.ResponseWriter, *http.Request), methods ...string) error

AddRoute allows leveraging the existing internal web server to add routes specific to Device Service.

func (*DeviceService) AsyncReadings

func (s *DeviceService) AsyncReadings() bool

AsyncReadings returns a bool value to indicate whether the asynchronous reading is enabled.

func (*DeviceService) DeviceDiscovery

func (s *DeviceService) DeviceDiscovery() bool

func (*DeviceService) DeviceProfiles

func (s *DeviceService) DeviceProfiles() []models.DeviceProfile

DeviceProfiles return all managed DeviceProfiles from cache

func (*DeviceService) DeviceResource

func (s *DeviceService) DeviceResource(deviceName string, deviceResource string) (models.DeviceResource, bool)

DeviceResource retrieves the specific DeviceResource instance from cache according to the Device name and Device Resource name

func (*DeviceService) Devices

func (s *DeviceService) Devices() []models.Device

Devices return all managed Devices from cache

func (*DeviceService) GetDeviceByName

func (s *DeviceService) GetDeviceByName(name string) (models.Device, errors.EdgeX)

GetDeviceByName returns the Device by its name if it exists in the cache, or returns an error.

func (*DeviceService) GetProvisionWatcherByName

func (s *DeviceService) GetProvisionWatcherByName(name string) (models.ProvisionWatcher, errors.EdgeX)

GetProvisionWatcherByName returns the Watcher by its name if it exists in the cache, or returns an error.

func (*DeviceService) Initialize

func (s *DeviceService) Initialize(serviceName, serviceVersion string, proto interface{})

func (*DeviceService) Name

func (s *DeviceService) Name() string

Name returns the name of this Device Service

func (*DeviceService) ProvisionWatchers

func (s *DeviceService) ProvisionWatchers() []models.ProvisionWatcher

ProvisionWatchers return all managed Watchers from cache

func (*DeviceService) RemoveDeviceAutoEvent

func (s *DeviceService) RemoveDeviceAutoEvent(deviceName string, event models.AutoEvent) errors.EdgeX

RemoveDeviceAutoEvent removes an AutoEvent from the Device with given name

func (*DeviceService) RemoveDeviceByName

func (s *DeviceService) RemoveDeviceByName(name string) errors.EdgeX

RemoveDeviceByName removes the specified Device by name from the cache and ensures that the instance in Core Metadata is also removed.

func (*DeviceService) RemoveDeviceProfileByName

func (s *DeviceService) RemoveDeviceProfileByName(name string) errors.EdgeX

RemoveDeviceProfileByName removes the specified DeviceProfile by name from the cache and ensures that the instance in Core Metadata is also removed.

func (*DeviceService) RemoveProvisionWatcher

func (s *DeviceService) RemoveProvisionWatcher(name string) errors.EdgeX

RemoveProvisionWatcher removes the specified Watcher by name from the cache and ensures that the instance in Core Metadata is also removed.

func (*DeviceService) ResourceOperation

func (s *DeviceService) ResourceOperation(deviceName string, deviceResource string, method string) (models.ResourceOperation, bool)

ResourceOperation retrieves the first matched ResourceOperation instance from cache according to the Device name, Device Resource name, and the method (get or set).

func (*DeviceService) Stop

func (s *DeviceService) Stop(force bool)

Stop shuts down the Service

func (*DeviceService) UpdateDevice

func (s *DeviceService) UpdateDevice(device models.Device) errors.EdgeX

UpdateDevice updates the Device in the cache and ensures that the copy in Core Metadata is also updated.

func (*DeviceService) UpdateDeviceOperatingState

func (s *DeviceService) UpdateDeviceOperatingState(deviceName string, state string) errors.EdgeX

UpdateDeviceOperatingState updates the Device's OperatingState with given name in Core Metadata and device service cache.

func (*DeviceService) UpdateDeviceProfile

func (s *DeviceService) UpdateDeviceProfile(profile models.DeviceProfile) errors.EdgeX

UpdateDeviceProfile updates the DeviceProfile in the cache and ensures that the copy in Core Metadata is also updated.

func (*DeviceService) UpdateFromContainer

func (s *DeviceService) UpdateFromContainer(r *mux.Router, dic *di.Container)

func (*DeviceService) UpdateProvisionWatcher

func (s *DeviceService) UpdateProvisionWatcher(watcher models.ProvisionWatcher) errors.EdgeX

UpdateProvisionWatcher updates the Watcher in the cache and ensures that the copy in Core Metadata is also updated.

func (*DeviceService) Version

func (s *DeviceService) Version() string

Version returns the version number of this Device Service