mqtt

Documentation

Index

• Constants
• func ParseQuery(query string) (url.Values, error)
• type ModuleTransport
  • func NewModuleTransport(opts ...TransportOption) *ModuleTransport
  • func (tr *ModuleTransport) Connect(ctx context.Context, creds transport.Credentials) error
  • func (tr *ModuleTransport) Send(ctx context.Context, msg *common.Message) error
  • func (tr *ModuleTransport) SubscribeEvents(ctx context.Context, mux transport.MessageDispatcher) error
• type Transport
  • func New(opts ...TransportOption) *Transport
  • func (tr *Transport) Close() error
  • func (tr *Transport) Connect(ctx context.Context, creds transport.Credentials) error
  • func (tr *Transport) GetBlobSharedAccessSignature(ctx context.Context, blobName string) (string, string, error)
  • func (tr *Transport) NotifyUploadComplete(ctx context.Context, correlationID string, success bool, statusCode int, ...) error
  • func (tr *Transport) RegisterDirectMethods(ctx context.Context, mux transport.MethodDispatcher) error
  • func (tr *Transport) RetrieveTwinProperties(ctx context.Context) ([]byte, error)
  • func (tr *Transport) Send(ctx context.Context, msg *common.Message) error
  • func (tr *Transport) SetLogger(logger logger.Logger)
  • func (tr *Transport) SubscribeEvents(ctx context.Context, mux transport.MessageDispatcher) error
  • func (tr *Transport) SubscribeTwinUpdates(ctx context.Context, mux transport.TwinStateDispatcher) error
  • func (tr *Transport) UpdateTwinProperties(ctx context.Context, b []byte) (int, error)
  • func (tr *Transport) UploadToBlob(ctx context.Context, sasURI string, file io.Reader, size int64) error
• type TransportOption
  • func WithClientOptionsConfig(fn func(opts *mqtt.ClientOptions)) TransportOption
  • func WithLogger(l logger.Logger) TransportOption
  • func WithModelID(modelID string) TransportOption
  • func WithWebSocket(enable bool) TransportOption

Constants

const DefaultQoS = 1

DefaultQoS is the default quality of service value.

Functions

func ParseQuery

func ParseQuery(query string) (url.Values, error)

Types

type ModuleTransport

type ModuleTransport struct {
	Transport
	// contains filtered or unexported fields
}

func NewModuleTransport

func NewModuleTransport(opts ...TransportOption) *ModuleTransport

New returns new Transport transport. See more: https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-mqtt-support

func (*ModuleTransport) Connect

func (tr *ModuleTransport) Connect(ctx context.Context, creds transport.Credentials) error

func (*ModuleTransport) Send

func (tr *ModuleTransport) Send(ctx context.Context, msg *common.Message) error

func (*ModuleTransport) SubscribeEvents

func (tr *ModuleTransport) SubscribeEvents(ctx context.Context, mux transport.MessageDispatcher) error

type Transport

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

func New

func New(opts ...TransportOption) *Transport

New returns new Transport transport. See more: https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-mqtt-support

func (*Transport) Close

func (tr *Transport) Close() error

func (*Transport) Connect

func (tr *Transport) Connect(ctx context.Context, creds transport.Credentials) error

func (*Transport) GetBlobSharedAccessSignature

func (tr *Transport) GetBlobSharedAccessSignature(ctx context.Context, blobName string) (string, string, error)

GetBlobSharedAccessSignature is not available in the MQTT transport.

func (*Transport) NotifyUploadComplete

func (tr *Transport) NotifyUploadComplete(ctx context.Context, correlationID string, success bool, statusCode int, statusDescription string) error

NotifyUploadComplete is not available in the MQTT transport.

func (*Transport) RegisterDirectMethods

func (tr *Transport) RegisterDirectMethods(ctx context.Context, mux transport.MethodDispatcher) error

func (*Transport) RetrieveTwinProperties

func (tr *Transport) RetrieveTwinProperties(ctx context.Context) ([]byte, error)

func (*Transport) Send

func (tr *Transport) Send(ctx context.Context, msg *common.Message) error

func (*Transport) SetLogger

func (tr *Transport) SetLogger(logger logger.Logger)

func (*Transport) SubscribeEvents

func (tr *Transport) SubscribeEvents(ctx context.Context, mux transport.MessageDispatcher) error

func (*Transport) SubscribeTwinUpdates

func (tr *Transport) SubscribeTwinUpdates(ctx context.Context, mux transport.TwinStateDispatcher) error

func (*Transport) UpdateTwinProperties

func (tr *Transport) UpdateTwinProperties(ctx context.Context, b []byte) (int, error)

func (*Transport) UploadToBlob

func (tr *Transport) UploadToBlob(ctx context.Context, sasURI string, file io.Reader, size int64) error

UploadToBlob is not available in the MQTT transport.

type TransportOption

type TransportOption func(tr *Transport)

TransportOption is a transport configuration option.

func WithClientOptionsConfig

func WithClientOptionsConfig(fn func(opts *mqtt.ClientOptions)) TransportOption

WithClientOptionsConfig configures the mqtt client options structure, use it only when you know EXACTLY what you're doing, because changing some of opts attributes may lead to unexpected behaviour.

Typical usecase is to change adjust connect or reconnect interval.

func WithLogger

func WithLogger(l logger.Logger) TransportOption

WithLogger sets logger for errors and warnings plus debug messages when it's enabled.

func WithModelID

func WithModelID(modelID string) TransportOption

WithModelId makes the mqtt client register the specified DTDL modeldID when a connection is established, this is useful for Azure PNP integration.

func WithWebSocket

func WithWebSocket(enable bool) TransportOption

WithWebSocket makes the mqtt client use MQTT over WebSockets on port 443, which is great if e.g. port 8883 is blocked.