listening Property

Whether the class should operate in server mode by listening for incoming requests.

Syntax

def get_listening() -> bool: ...
def set_listening(value: bool) -> None: ...

listening = property(get_listening, set_listening)

Default Value

FALSE

Remarks

This property controls whether the class operates in server mode or client mode.

When this property is disabled (default), the class operate in client mode, allowing applications to send requests using the get, post, send_custom_request, etc. methods.

When this property is enabled, the class listens on local_port for incoming CoAP requests, firing the on_request event anytime one arrives. Applications can service these requests directly during on_request events, or send separate responses later using the send_response method.

Note: Applications that wish to use the class in server mode should set the local_port property to the desired listening port (such as 5683, the standard CoAP port) before enabling this property. Otherwise the system will choose a port at random.