Editing Documentation/Maemo 5 Developer Guide/Using Connectivity Components/Maemo Connectivity
Warning: You are not logged in.
Your IP address will be recorded in this page's edit history.
Warning: This page is 62 kilobytes long; some browsers may have problems editing pages approaching or longer than 32kb. Please consider breaking the page into smaller sections.
The edit can be undone.
Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 980: | Line 980: | ||
===== strong_bt_req ===== | ===== strong_bt_req ===== | ||
- | + | :Parameters | |
- | : <ol><li>string Bluetooth address of the device to pair with</li><li>boolean <code>TRUE</code> if strong authentication enabled, <code>FALSE</code> if strong authentication is disabled | + | : <ol><li>string Bluetooth address of the device to pair with</li><li>boolean <code>TRUE</code> if strong authentication enabled, <code>FALSE</code> if strong authentication is disabled |
;Return Parameters | ;Return Parameters | ||
: none | : none | ||
Line 989: | Line 989: | ||
: Requests strong (16 digit) BT PIN dialog for a BT device | : Requests strong (16 digit) BT PIN dialog for a BT device | ||
- | = | + | <div class="graybox"> |
- | + | ||
- | : | + | Method: show_sim_pin_dlg |
- | + | Parameters: 1. string Bluetooth address of the device used with SAP | |
- | : none | + | 2. boolean TRUE if PIN was incorrect and retry dialog |
- | + | should be displayed before asking PIN. FALSE | |
- | : | + | if this is the first PIN request. |
- | + | ||
- | : Shows SIM PIN dialog | + | Return Parameters: none |
+ | Errors: com.nokia.icd_ui.error.flight_mode: | ||
+ | Flight mode enabled, dialog not shown | ||
+ | |||
+ | Description: Shows SIM PIN dialog | ||
- | + | </div> | |
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | + | The code example for the application to show the connect dialog using show_conn_dlg is following. Note the use of the macro. | |
- | + | <tt><span>'''<span><font color="#000080"><nowiki>#include</nowiki></font></span>'''</span> <span><font color="#FF0000"><osso-ic-ui-dbus.h></font></span> | |
+ | <span>''<span><font color="#9A1900">/* ... */</font></span>''</span> | ||
+ | <span>''<span><font color="#9A1900">/* in our code somewhere, where we need the Connect Dialog*/</font></span>''</span> | ||
+ | DBusMessage <span><font color="#990000"><nowiki>*</nowiki></font></span>uimsg<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | <span>''<span><font color="#9A1900">/* construct the message for Connect Dialog request*/</font></span>''</span> | ||
+ | uimsg <span><font color="#990000"><nowiki>=</nowiki></font></span> | ||
+ | <span>'''<span><font color="#000000">dbus_message_new_method_call</font></span>'''</span><span><font color="#990000">(</font></span>ICD_UI_DBUS_SERVICE<span><font color="#990000">,</font></span> | ||
+ | ICD_UI_DBUS_PATH<span><font color="#990000">,</font></span> | ||
+ | ICD_UI_DBUS_INTERFACE<span><font color="#990000">,</font></span> | ||
+ | <span>''<span><font color="#9A1900">/*macro for show_conn_dlg */</font></span>''</span> | ||
+ | ICD_UI_SHOW_CONNDLG_REQ<span><font color="#990000">);</font></span> | ||
+ | <span>''<span><font color="#9A1900">/* send the message */</font></span>''</span> | ||
+ | reply <span><font color="#990000"><nowiki>=</nowiki></font></span> | ||
+ | <span>'''<span><font color="#000000">dbus_connection_send_with_reply_and_block</font></span>'''</span><span><font color="#990000">(</font></span>connection<span><font color="#990000">,</font></span> | ||
+ | uimsg<span><font color="#990000">,</font></span> | ||
+ | reply_timeout<span><font color="#990000">,</font></span> | ||
+ | <span><font color="#990000">&</font></span>error<span><font color="#990000">);</font></span> | ||
+ | <span>'''<span><font color="#0000FF">if</font></span>'''</span> <span><font color="#990000">(</font></span>reply <span><font color="#990000"><nowiki>==</nowiki></font></span> NULL<span><font color="#990000">)</font></span> <span><font color="#FF0000">{</font></span> | ||
+ | <span>'''<span><font color="#000000">DLOG_ERR</font></span>'''</span><span><font color="#990000">(</font></span><span><font color="#FF0000">"Failed to show connect dialog: %s"</font></span><span><font color="#990000">,</font></span> uierror<span><font color="#990000">.</font></span>message<span><font color="#990000">);</font></span> | ||
+ | <span>'''<span><font color="#000000">dbus_error_free</font></span>'''</span><span><font color="#990000">(&</font></span>uierror<span><font color="#990000">);</font></span> | ||
+ | <span><font color="#FF0000">}</font></span> | ||
+ | <span>'''<span><font color="#000000">dbus_message_unref</font></span>'''</span><span><font color="#990000">(</font></span>uimsg<span><font color="#990000">);</font></span> | ||
+ | <span>'''<span><font color="#000000">dbus_message_unref</font></span>'''</span><span><font color="#990000">(</font></span>reply<span><font color="#990000">);</font></span> | ||
+ | <span>''<span><font color="#9A1900">/* ... */</font></span>''</span></tt> | ||
- | + | The signals emitted from com.nokia.icd_ui interface are listed below. | |
- | |||
- | |||
- | |||
- | |||
+ | <div class="graybox"> | ||
- | + | ||
+ | Signal: disconnect | ||
+ | Parameters: 1. boolean TRUE if "disconnect" pressed, FALSE if "cancel" | ||
+ | |||
+ | Description: Signal emitted from UI when disconnect dialog has been closed. | ||
- | + | </div> | |
- | + | ||
- | + | ||
- | + | ||
- | |||
- | + | <div class="graybox"> | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
+ | Signal: retry | ||
+ | Parameters: 1. string The IAP that is to be retried | ||
+ | 2. boolean TRUE if "retry" pressed, FALSE if "cancel" | ||
+ | |||
+ | Description: Signal emitted from UI when the retry dialog has been closed. | ||
- | + | </div> | |
- | + | ||
- | + | ||
- | + | ||
+ | <br /><br /> | ||
- | = | + | <div class="graybox"> |
- | + | ||
- | : | + | Signal: change |
- | + | Parameters: 1. string Old IAP to change from | |
- | : Signal emitted from UI when | + | 2. string New IAP to change to |
+ | 3. boolean Change to the new IAP If TRUE, keep old if FALSE | ||
+ | |||
+ | Description: Signal emitted from UI when change connection dialog has | ||
+ | been closed. | ||
- | + | </div> | |
- | |||
- | |||
- | |||
- | |||
- | = | + | <div class="graybox"> |
- | + | ||
- | : | + | Signal: passwd |
- | + | Parameters: 1. string Username supplied or modified by the user | |
- | : Signal emitted from UI when the | + | 2. string Password supplied or modified by the user |
+ | 3. string IAP name | ||
+ | 4. boolean TRUE if "ok" pressed, FALSE if "cancel" | ||
+ | |||
+ | Description: Signal emitted from UI when the username/password dialog has | ||
+ | been closed | ||
- | + | </div> | |
- | |||
- | |||
- | |||
- | |||
- | = | + | <div class="graybox"> |
- | + | ||
- | : | + | Signal: gtc_response |
- | + | Parameters: 1. string Response to the given challenge or empty string | |
- | : Signal emitted from UI when the | + | if cancelled |
+ | 2. boolean TRUE if "ok" pressed, FALSE if "cancel" | ||
+ | |||
+ | Description: Signal emitted from UI when the EAP GTC challenge dialog has | ||
+ | been closed. | ||
- | + | </div> | |
- | + | ||
- | : < | + | <div class="graybox"> |
- | + | ||
- | : Signal emitted from UI when the SIM PIN has been entered. | + | |
+ | Signal: mschap_change | ||
+ | Parameters: 1. string Supplied username | ||
+ | 2. string The new password or empty string if cancelled | ||
+ | 3. string IAP name | ||
+ | 4. boolean TRUE if "ok" pressed, FALSE if "cancel" | ||
+ | |||
+ | Description: Signal emitted from UI when the MSCHAPv2 password has been | ||
+ | changed | ||
+ | |||
+ | </div> | ||
+ | |||
+ | |||
+ | <div class="graybox"> | ||
+ | |||
+ | |||
+ | Signal: private_key_passwd | ||
+ | Parameters: 1. byte array Certificate ID | ||
+ | 2. string Password for the private key or empty string if none | ||
+ | 3. boolean TRUE if "ok" pressed, FALSE if "cancel" | ||
+ | |||
+ | Description: Signal emitted from UI when the private key password dialog | ||
+ | has been closed | ||
+ | |||
+ | </div> | ||
+ | |||
+ | |||
+ | <div class="graybox"> | ||
+ | |||
+ | |||
+ | Signal: server_cert | ||
+ | Parameters: 1. boolean TRUE if strong PIN entered, FALSE if strong | ||
+ | PIN dialog was canceled | ||
+ | |||
+ | Description: Signal emitted from UI when the server certificate error | ||
+ | dialog has been closed | ||
+ | |||
+ | </div> | ||
+ | |||
+ | <br /><br /> | ||
+ | |||
+ | <div class="graybox"> | ||
+ | |||
+ | |||
+ | Signal: strong_bt | ||
+ | Parameters: 1. boolean TRUE if strong PIN entered, FALSE if strong | ||
+ | PIN dialog was cancelled | ||
+ | |||
+ | Description: Signal emitted from UI when the strong (16 digit) BT PIN | ||
+ | has been entered | ||
+ | |||
+ | </div> | ||
+ | |||
+ | |||
+ | <div class="graybox"> | ||
+ | |||
+ | |||
+ | Signal: sim_pin | ||
+ | Parameters: 1. string SIM PIN code or empty string if cancelled | ||
+ | 2. boolean TRUE if "ok" pressed, FALSE if "cancel" | ||
+ | |||
+ | Description: Signal emitted from UI when the SIM PIN has been entered. | ||
+ | |||
+ | </div> | ||
===Bluetooth D-Bus UI dialogs === | ===Bluetooth D-Bus UI dialogs === |
Learn more about Contributing to the wiki.