Marian: Created page with " '''radio.create''' is a message sent to request creation of a radio interface. ===Parameters=== ;radio_driver : Optional radio driver (module) name. If present only modu..."

2018-05-25T08:15:41Z

Created page with " '''radio.create''' is a message sent to request creation of a radio interface. ===Parameters=== ;radio_driver : Optional radio driver (module) name. If present only modu..."

New page

'''radio.create''' is a message sent to request creation of a radio interface.

===Parameters===

;radio_driver
: Optional radio driver (module) name. If present only modules matching it will handle the message
;radio_params_prefix
: Optional prefix for radio init parameters. Defaults to '''radio.'''
: Message parameters starting with indicated prefix will be used to create the radio interface

===Return===

;Success (message dispatch return true)
: A RadioInterface pointer is returned in '''interface''' parameter
;Failure (message dispatch return false)
: '''code''' (RadioInterface error code) parameter may be returned along with other parameters describing the failure

===Usage example===

Message m("radio.create");
// Set some radio related params ...
Engine::dispatch(m);
NamedPointer* np = YOBJECT(NamedPointer,m.getParam(YSTRING("interface")));
RadioInterface* r = np ? YOBJECT(RadioInterface,np) : 0;
if (r) {
// Remove pointer from 'np': take ownership
np->takeData();
// Use the RadioInterface. You are owning the pointer now!
}
else {
// Failure !
}

Radio.create - Revision history

Marian: Created page with " '''radio.create''' is a message sent to request creation of a radio interface. ===Parameters=== ;radio_driver : Optional radio driver (module) name. If present only modu..."