Hi,
On 22 July 2010 02:22, Denis Kenzior <[email protected]> wrote:
> On 07/21/2010 05:06 PM, Shane Bryan wrote:
>>
>>> + [service].Error.NotFound
>>> +
>>> [service].Error.NotAuthorized +
>>
>> - What are the plans for the configuration of services/object paths for
>> "launch-able" Terminal Applications (AKA, Agents?)? Will there be a
>> stk.conf file or similar or will this be protected in a dbus service
>> config file?
Most likely the Terminal Applications capability will not be
implemented for a while, it is not used by popular SIMs and is not
very practical. It may be implemented if needed.
>>> + string GetInput(string alpha, array{byte} icon,
>>> + string default, byte min, byte max,
>>> + boolean hide_typing)
>>> +
>>> + Tells the agent to request an input string
>>> from the
>>> + user. The alpha parameter and icon gives
>>> context to
>>> + the user. The default string contains the
>>> suggested
>>> + default by the SIM. The min and max
>>> parameters contain
>>> + how many characters the user should enter.
>>> The
>>> + parameter hide_typing indicates whether
>>> user's typing
>>> + should be opaque.
>>> +
>>> + Possible Errors:
>>> [service].Error.SimToolkit.GoBack +
>>
>> - Same questions as above regarding the icon data formatting.
>>
>> - Given the min/max constraints, plus the default value, I assume
>> that if the input provided by the user falls within (inclusive) both
>> conditions, this is what is returned, otherwise the value of default
>> is returned, correct?
>
> No, this is more about validation. E.g. the agent should not return
> more than max or less than min characters. A maximum value of 255 means
> no maximum is given.
>
> The user can either accept the default value or enter his own input.
This really just means a text input field, with the default text as
initial value, if any.
>>> + string GetKey(string alpha, array{byte} icon)
>>> +
>>> + Tells the agent to request a single input
>>> key from
>>> + the user. The alpha parameter contains the
>>> context
>>> + for the request.
>>> +
>>> + Possible Errors:
>>> [service].Error.SimToolkit.GoBack +
>>
>> - I am assuming this "Key" is in fact meant to imply a single
>> Character, not a scan code or keycode from some hardware key,
>> correct? May seem obvious to some, but I can't always be sure.
>>
>
> Correct
The SIM either requests a single gsm 7-bit character, a single unicode
character or a single key press (on the physical keypad), depending on
the parameters of the SIM command. However this api does not make a
distiction between these options (the previous api does has an
"alphabet" parameter).
>>
>>
>>> + void Release()
>>> +
>>> + Agent is being released, possibly because of
>>> oFono
>>> + terminating, SimToolkit interface torn down
>>> or modem
>>> + off. If the agent is registered as a global
>>> agent,
>>> + no UnregisterAgent call is expected.
>>
>> Ok, so in this case, the SimToolkit will call the agents Release()
>> method when (as asked above in the RegisterAgent() comments) the modem
>> Powered state goes from true to false (as well as under other possible
>> conditions, yeah, I know), correct?
Yes, additionally ofono will call Release() on the "user-initiated
agent" when the card wants the UI to go back to the main menu or close
the UI altogether. The spec suggests / recommends that basically the
application should go to main menu if the last action performed was a
GoBack button press, otherwise the application should exit, but it may
depend on the specific use case. For example the javascript GUI
client I use for testing this always has screen space available so it
always goes to main menu.
Regards
_______________________________________________
ofono mailing list
[email protected]
http://lists.ofono.org/listinfo/ofono
