class QtCoap¶

Contains miscellaneous identifiers used throughout the Qt CoAP module. More…

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description¶

class ResponseCode¶

This enum represents the response code from the CoAP protocol, as defined in RFC 7252 and RFC 7959 .

Constant

Description

QtCoap.ResponseCode.EmptyMessage

The response code for an empty message.

QtCoap.ResponseCode.Created

The request was successful and has resulted in new resources being created. This response code corresponds to HTTP 201 “Created”.

QtCoap.ResponseCode.Deleted

The resource has been successfully deleted. This response code corresponds to HTTP 204 “No Content” but is only used in response to requests that cause the resource to cease being available, such as DELETE and, in certain circumstances, POST.

QtCoap.ResponseCode.Valid

This response code is related to HTTP 304 “Not Modified” but is only used to indicate that the response identified by the entity-tag given in the ETag Option is valid.

QtCoap.ResponseCode.Changed

The resource has been successfully modified. This response code corresponds to HTTP 204 “No Content” but is only used in response to POST and PUT requests.

QtCoap.ResponseCode.Content

The request has succeeded. This response code corresponds to HTTP 200 “OK” but is only used in response to GET requests.

QtCoap.ResponseCode.Continue

Indicates that the transfer of the current block was successful, and the server will send more blocks.

QtCoap.ResponseCode.BadRequest

The request was not recognized. This response code corresponds to HTTP 400 “Bad Request”.

QtCoap.ResponseCode.Unauthorized

The client is not authorized to perform the requested action. This response code corresponds to HTTP 401 “Unauthorized”.

QtCoap.ResponseCode.BadOption

The request could not be understood by the server due to unrecognized options.

QtCoap.ResponseCode.Forbidden

Access to this resource is forbidden. This response code corresponds to HTTP 403 “Forbidden”.

QtCoap.ResponseCode.NotFound

The resource requested was not found. This response code corresponds to HTTP 404 “Not Found”.

QtCoap.ResponseCode.MethodNotAllowed

The server does not allow the method used for the URL requested. This response code corresponds to HTTP 405 “Method Not Allowed” but with no parallel to the “Allow” header field.

QtCoap.ResponseCode.NotAcceptable

No resource satisfying the request’s acceptance criteria was found. This response code corresponds to HTTP 406 “Not Acceptable”, but with no response entity.

QtCoap.ResponseCode.RequestEntityIncomplete

The server has not received all blocks, of the request body, that it needs to proceed.

QtCoap.ResponseCode.PreconditionFailed

Preconditions given in the request header fields evaluated to false when tested on the server. This response code corresponds to HTTP 412 “Precondition Failed”.

QtCoap.ResponseCode.RequestEntityTooLarge

The request payload is larger than the server is willing or able to process. This response code corresponds to HTTP 413 “Request Entity Too Large”.

QtCoap.ResponseCode.UnsupportedContentFormat

The payload is in a format not supported by this method on the target resource. This response code corresponds to HTTP 415 “Unsupported Media Type”.

QtCoap.ResponseCode.InternalServerFault

The server encountered an unexpected condition that prevented it from fulfilling the request. This response code corresponds to HTTP 500 “Internal Server Error”.

QtCoap.ResponseCode.NotImplemented

The server does not support the functionality required to fulfill the request. This response code corresponds to HTTP 501 “Not Implemented”.

QtCoap.ResponseCode.BadGateway

An error occurred with an upstream server. This response code corresponds to HTTP 502 “Bad Gateway”.

QtCoap.ResponseCode.ServiceUnavailable

The service is currently unavailable. This response code corresponds to HTTP 503 “Service Unavailable”.

QtCoap.ResponseCode.GatewayTimeout

The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server. This response code corresponds to HTTP 504 “Gateway Timeout”.

QtCoap.ResponseCode.ProxyingNotSupported

The server is unable or unwilling to act as a forward-proxy for the URI specified in the Proxy-Uri Option or using the scheme specified in Proxy-Scheme.

QtCoap.ResponseCode.InvalidCode

An invalid response code.

Constant	Description
QtCoap.ResponseCode.EmptyMessage	The response code for an empty message.
QtCoap.ResponseCode.Created	The request was successful and has resulted in new resources being created. This response code corresponds to HTTP 201 “Created”.
QtCoap.ResponseCode.Deleted	The resource has been successfully deleted. This response code corresponds to HTTP 204 “No Content” but is only used in response to requests that cause the resource to cease being available, such as DELETE and, in certain circumstances, POST.
QtCoap.ResponseCode.Valid	This response code is related to HTTP 304 “Not Modified” but is only used to indicate that the response identified by the entity-tag given in the ETag Option is valid.
QtCoap.ResponseCode.Changed	The resource has been successfully modified. This response code corresponds to HTTP 204 “No Content” but is only used in response to POST and PUT requests.
QtCoap.ResponseCode.Content	The request has succeeded. This response code corresponds to HTTP 200 “OK” but is only used in response to GET requests.
QtCoap.ResponseCode.Continue	Indicates that the transfer of the current block was successful, and the server will send more blocks.
QtCoap.ResponseCode.BadRequest	The request was not recognized. This response code corresponds to HTTP 400 “Bad Request”.
QtCoap.ResponseCode.Unauthorized	The client is not authorized to perform the requested action. This response code corresponds to HTTP 401 “Unauthorized”.
QtCoap.ResponseCode.BadOption	The request could not be understood by the server due to unrecognized options.
QtCoap.ResponseCode.Forbidden	Access to this resource is forbidden. This response code corresponds to HTTP 403 “Forbidden”.
QtCoap.ResponseCode.NotFound	The resource requested was not found. This response code corresponds to HTTP 404 “Not Found”.
QtCoap.ResponseCode.MethodNotAllowed	The server does not allow the method used for the URL requested. This response code corresponds to HTTP 405 “Method Not Allowed” but with no parallel to the “Allow” header field.
QtCoap.ResponseCode.NotAcceptable	No resource satisfying the request’s acceptance criteria was found. This response code corresponds to HTTP 406 “Not Acceptable”, but with no response entity.
QtCoap.ResponseCode.RequestEntityIncomplete	The server has not received all blocks, of the request body, that it needs to proceed.
QtCoap.ResponseCode.PreconditionFailed	Preconditions given in the request header fields evaluated to `false` when tested on the server. This response code corresponds to HTTP 412 “Precondition Failed”.
QtCoap.ResponseCode.RequestEntityTooLarge	The request payload is larger than the server is willing or able to process. This response code corresponds to HTTP 413 “Request Entity Too Large”.
QtCoap.ResponseCode.UnsupportedContentFormat	The payload is in a format not supported by this method on the target resource. This response code corresponds to HTTP 415 “Unsupported Media Type”.
QtCoap.ResponseCode.InternalServerFault	The server encountered an unexpected condition that prevented it from fulfilling the request. This response code corresponds to HTTP 500 “Internal Server Error”.
QtCoap.ResponseCode.NotImplemented	The server does not support the functionality required to fulfill the request. This response code corresponds to HTTP 501 “Not Implemented”.
QtCoap.ResponseCode.BadGateway	An error occurred with an upstream server. This response code corresponds to HTTP 502 “Bad Gateway”.
QtCoap.ResponseCode.ServiceUnavailable	The service is currently unavailable. This response code corresponds to HTTP 503 “Service Unavailable”.
QtCoap.ResponseCode.GatewayTimeout	The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server. This response code corresponds to HTTP 504 “Gateway Timeout”.
QtCoap.ResponseCode.ProxyingNotSupported	The server is unable or unwilling to act as a forward-proxy for the URI specified in the Proxy-Uri Option or using the scheme specified in Proxy-Scheme.
QtCoap.ResponseCode.InvalidCode	An invalid response code.

class Error¶

Indicates the error condition found during processing of the request.

Constant

Description

QtCoap.Error.Ok

No error condition.

QtCoap.Error.HostNotFound

The remote host name was not found.

QtCoap.Error.AddressInUse

The address is already in use.

QtCoap.Error.TimeOut

The response did not arrive in time.

QtCoap.Error.BadRequest

The request was not recognized.

QtCoap.Error.Unauthorized

The client is not authorized to perform the requested action.

QtCoap.Error.BadOption

The request could not be understood by the server due to one or more unrecognized or malformed options.

QtCoap.Error.Forbidden

Access to this resource is forbidden.

QtCoap.Error.NotFound

The resource requested was not found.

QtCoap.Error.MethodNotAllowed

The server does not allow the method used for the URL requested.

QtCoap.Error.NotAcceptable

No resource satisfying the request’s acceptance criteria was found.

QtCoap.Error.RequestEntityIncomplete

The server has not received the blocks of the request body that it needs to proceed. The client has not sent all blocks, has not sent them in the order required by the server, or sent them long enough ago that the server has already discarded them.

QtCoap.Error.PreconditionFailed

One or more conditions given in the request header fields evaluated to false when tested on the server.

QtCoap.Error.RequestEntityTooLarge

The request payload is larger than the server is willing or able to process.

QtCoap.Error.UnsupportedContentFormat

The payload is in a format not supported by this method on the target resource.

QtCoap.Error.InternalServerFault

The server encountered an unexpected condition that prevented it from fulfilling the request.

QtCoap.Error.NotImplemented

The server does not support the functionality required to fulfill the request.

QtCoap.Error.BadGateway

An error occurred with an upstream server.

QtCoap.Error.ServiceUnavailable

The service is currently unavailable.

QtCoap.Error.GatewayTimeout

The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.

QtCoap.Error.ProxyingNotSupported

The server is unable or unwilling to act as a forward-proxy for the URI specified in the Proxy-Uri Option or using the scheme specified in Proxy-Scheme.

QtCoap.Error.Unknown

An unknown error occurred.

Constant	Description
QtCoap.Error.Ok	No error condition.
QtCoap.Error.HostNotFound	The remote host name was not found.
QtCoap.Error.AddressInUse	The address is already in use.
QtCoap.Error.TimeOut	The response did not arrive in time.
QtCoap.Error.BadRequest	The request was not recognized.
QtCoap.Error.Unauthorized	The client is not authorized to perform the requested action.
QtCoap.Error.BadOption	The request could not be understood by the server due to one or more unrecognized or malformed options.
QtCoap.Error.Forbidden	Access to this resource is forbidden.
QtCoap.Error.NotFound	The resource requested was not found.
QtCoap.Error.MethodNotAllowed	The server does not allow the method used for the URL requested.
QtCoap.Error.NotAcceptable	No resource satisfying the request’s acceptance criteria was found.
QtCoap.Error.RequestEntityIncomplete	The server has not received the blocks of the request body that it needs to proceed. The client has not sent all blocks, has not sent them in the order required by the server, or sent them long enough ago that the server has already discarded them.
QtCoap.Error.PreconditionFailed	One or more conditions given in the request header fields evaluated to false when tested on the server.
QtCoap.Error.RequestEntityTooLarge	The request payload is larger than the server is willing or able to process.
QtCoap.Error.UnsupportedContentFormat	The payload is in a format not supported by this method on the target resource.
QtCoap.Error.InternalServerFault	The server encountered an unexpected condition that prevented it from fulfilling the request.
QtCoap.Error.NotImplemented	The server does not support the functionality required to fulfill the request.
QtCoap.Error.BadGateway	An error occurred with an upstream server.
QtCoap.Error.ServiceUnavailable	The service is currently unavailable.
QtCoap.Error.GatewayTimeout	The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.
QtCoap.Error.ProxyingNotSupported	The server is unable or unwilling to act as a forward-proxy for the URI specified in the Proxy-Uri Option or using the scheme specified in Proxy-Scheme.
QtCoap.Error.Unknown	An unknown error occurred.

class Method¶

This enum specifies CoAP request methods.

Constant

Description

QtCoap.Method.Invalid

The default request method for an empty request.

QtCoap.Method.Get

GET method.

QtCoap.Method.Post

POST method.

QtCoap.Method.Put

PUT method.

QtCoap.Method.Delete

DELETE method.

QtCoap.Method.Other

Other request method.

Constant	Description
QtCoap.Method.Invalid	The default request method for an empty request.
QtCoap.Method.Get	GET method.
QtCoap.Method.Post	POST method.
QtCoap.Method.Put	PUT method.
QtCoap.Method.Delete	DELETE method.
QtCoap.Method.Other	Other request method.

class Port¶

This enum specifies the default CoAP port values.

Constant

Description

QtCoap.DefaultPort

The default port used for the non-secure transmission.

QtCoap.DefaultSecurePort

The default port used for the secure transmission.

Constant	Description
QtCoap.DefaultPort	The default port used for the non-secure transmission.
QtCoap.DefaultSecurePort	The default port used for the secure transmission.

class SecurityMode¶

Specifies the security mode used for securing a CoAP connection, as defined in RFC 7252 .

Constant

Description

QtCoap.SecurityMode.NoSecurity

There is no protocol-level security (DTLS is disabled).

QtCoap.SecurityMode.PreSharedKey

DTLS is enabled. PSK authentication will be used for security.

QtCoap.SecurityMode.RawPublicKey

DTLS is enabled. An asymmetric key pair without a certificate (a raw public key) will be used for security. This mode is not supported yet.

QtCoap.SecurityMode.Certificate

DTLS is enabled. An asymmetric key pair with an X.509 certificate will be used for security.

Constant	Description
QtCoap.SecurityMode.NoSecurity	There is no protocol-level security (DTLS is disabled).
QtCoap.SecurityMode.PreSharedKey	DTLS is enabled. PSK authentication will be used for security.
QtCoap.SecurityMode.RawPublicKey	DTLS is enabled. An asymmetric key pair without a certificate (a raw public key) will be used for security. This mode is not supported yet.
QtCoap.SecurityMode.Certificate	DTLS is enabled. An asymmetric key pair with an X.509 certificate will be used for security.

class MulticastGroup¶

This enum represents CoAP multicast group addresses defined in RFC 7252 .

Constant

Description

QtCoap.MulticastGroup.AllCoapNodesIPv4

IPv4 “All CoAP Nodes” address 224.0.1.187, from the “IPv4 Multicast Address Space Registry”.

QtCoap.MulticastGroup.AllCoapNodesIPv6LinkLocal

IPv6 “All CoAP Nodes” link-local scoped address FF02::FD, from the “IPv6 Multicast Address Space Registry”.

QtCoap.MulticastGroup.AllCoapNodesIPv6SiteLocal

IPv6 “All CoAP Nodes” site-local scoped address FF05::FD, from the “IPv6 Multicast Address Space Registry”.

Constant	Description
QtCoap.MulticastGroup.AllCoapNodesIPv4	IPv4 “All CoAP Nodes” address 224.0.1.187, from the “IPv4 Multicast Address Space Registry”.
QtCoap.MulticastGroup.AllCoapNodesIPv6LinkLocal	IPv6 “All CoAP Nodes” link-local scoped address FF02::FD, from the “IPv6 Multicast Address Space Registry”.
QtCoap.MulticastGroup.AllCoapNodesIPv6SiteLocal	IPv6 “All CoAP Nodes” site-local scoped address FF05::FD, from the “IPv6 Multicast Address Space Registry”.