Decode and encode alpha-identifier fields

Add identifier argument to sim_adn_parse and sim_adn_build.

Also fix the number length passed to extract_bcd_number in sim_adn_parse.

Read EFad and expose the IMSI MNC length (2-3)

Reformat comments a little

driver callback naming

On Sun, 30 Aug 2009 13:45:45 -0500
Denis Kenzior <denkenz@gmail.com> wrote:

> Hi Andres,
>
> > static struct ofono_modem_driver g1_driver = {
> >         .name = "HTC G1",
> >         .probe = g1_probe,
> >         .enable = g1_enable,
> >         .disable = g1_disable,
> >         .remove = g1_remove,
> >         .populate = g1_populate,
> > };
> >
>
> So the current intention:
> .probe - Detect whether device is really supported by the plugin,
> initialize any data structures specific to the device
> .remove - Destroy data structures
> .enable - Perform power up
> .disable - Perform power down
> .populate - Populate the atoms supported by this device (e.g. netreg,
> voicecall, etc)  This is called by the core after every power cycle,
> when the device is brought up.
>

Thanks!  See patch below.

> >
> > Of course, I'm also wondering why there needs to be two separate
> > layers of calls in the first place.  Why not have drivers register
> > everything from within probe, call ofono_set_powered(modem, TRUE)
> > once the device is ready, and be done with it?
>
> The reason for this is e.g. airplane mode, where you physically want
> to turn off the device.  Another case is for battery / power reasons,
> e.g. a netbook with a USB modem that is not being used.
>

Fair enough.  In the kernel, we have callbacks named suspend/resume
to handle that.

> > The only reason why this doesn't blow up in the generic_at plugin is
> > because the driver_data is leaked.  If one were to free it from
> > generic_at_exit in the wrong place (since it's allocated from
> > generic_at_init, it would make sense to free it in generic_at_exit),
> > one would see the same SEGV/SIGBUS/SIGILL errors upon ctrl-c.
>
> So the leak has now been fixed.
>
> I think you're being unnecessarily harsh here.  To be fair, the
> generic_at driver does something like this at init:

My criticism is simply w/ the naming.  'enable'/'disable' doesn't imply
anything about power.  powerup/powerdown, poweron/poweroff,
suspend/resume would all imply power state changes (at least the latter
would be familiar to those who do kernel stuff).  Having comments that
describe what the callbacks do would also work, though.

>From 80a7b54d52201dfd7d8b590457450ae0a4f72888 Mon Sep 17 00:00:00 2001
From: Andres Salomon <dilinger@collabora.co.uk>
Date: Sun, 30 Aug 2009 15:56:16 -0400
Subject: [PATCH] Add comments to ofono_modem_driver struct

Document what all the callbacks do.

Fix memory leak in generic_at driver

Add debug to modem_create

Make history drivers work again

Fix a problem with CtrlZ echo

When a PDU is submitted and echoed by the modem, the CtrlZ character
is also echoed back.  Fix the parser to handle this case appropriately.

gisi: return GPRS interface index/name

gisi: Fix indication debugging

Rename all files under drivers/isimodem/

Fix typo in technology name

Convert to fully non-recursive build system

Use script to generate list of builtin plugin symbols

Use proper variables for various commands

Add straw-man for rest of ISI modem driver

Fix broken dependency on include/ofono/*.h files

The fact that the directory exists does not prove that (all of) the
header file symbolic links have been created. This is particularly
annoying when a new header file gets added.

Fix build warning

Fix typos

gisi: Fix warning in g_isi_subscribe()

Save the GIsiModem instance in GIsiClient, so that calling
g_isi_subscribe() doesn't throw a warning.

Fix memory leak in ISI phonebook driver

gisi: Add debugging hooks

Fix memory leak in isimodem.c

Move dump_msg() to isi.h as static inline

Fix getting the offset into sms fragment bitmap.

Otherwise only 64 fragments fit.

Add generic_at modem driver

Useful for testing or when the device is extremely 27.007 compliant,
e.g. phonesim

Update the isi driver to the new modem driver api

Introduce the Modem driver API

Remove org.ofono.at.Manager

Add CONFIGDIR automake magic

Remove unused function

Enable multi-modem support

This patch enables concurrent use of multiple ISI modems, e.g., all
connected via USB using cdc_phonet.

Enable multiple instances of phonebook driver

Enable multiple instances of devinfo driver

Move struct isi_data to private

Refactor isidevinfo

Remove storing of pending request objects to linked list;
g_isi_client_destroy() will clear those properly. Fix naming of enums,
and use DECLARE_SUCCESS() macro.

Pass modem instance to phonebook driver

Fix unused variable l

Rename ofono_modem_*_userdata

Rename ofono_modem_get_userdata to ofono_modem_get_data
Rename ofono_modem_set_userdata to ofono_modem_set_data

For consistency with other drivers

Hide the ofono_modem datastructure

Port history to the new atom API

Use __atom_foreach

Add __ofono_modem_foreach_atom function

Fix unused variable modem

Fix unused function remove_all_watches

Fix unused variable modem

Remove unused function

Remove unused function

Fix implicit declaration of extract_bcd_number

Fix unused variable path

Fix unused variable l

Fix unused variable pbd

Fix return with no value warning

Fix a bunch of warnings about mixed signedness

Fix implicit declaration of ofono_phonebook_create

Fix unused variable pbd

Fix unused variable chat

Fix implicit declaration of ofono_netreg_create

Fix control reaches end of non-void function

Fix unused variable err warning

Fix implicit declaration of close warning

Update ISI driver for new devinfo API

Update the AT modem driver to the new devinfo api

Break out device info into a separate driver

The modem info ops (Serial, Manufacturer, etc) are broken into a
separate oFono atom.  This is mainly to support a proper modem device
driver infrastructure.  As a result the data structures have been
tweaked a little.

driver.h is now empty and has been removed.

Use types.h instead of driver.h here

Remove unused variables

Fix ISI driver side conditional name

Fix make distcheck and clear GISI build flags when disabled

Add configure switch to disable PhoNet/ISI support

gisi: PEP: use more portable non-blocking and close-on-exec

Fix make distcheck - gisi/modem.h

gisi/modem.h was not included in Makefile.am

Fix make distcheck

isicommon.h is no longer in the repository

Remove modem member from cb_data

Fix release specific not reporting proper reason

The proper disconnect reason was not being reported in the at modem
voicecall plugin

Emit the DisconnectReason signal

Make sure call history handles waiting calls

Missed waiting calls were not being handled properly

Remove poll_clcc variable

The reference implementation will always poll.  If a modem vendor has
extensions for call status reporting, then those should be used in a
separate driver

Update the AT modem voicecall driver for new API

Evolve the voicecall driver

Remove dead code in voicecall at driver

Update netreg AT modem driver to the new API

Evolve the netreg driver

Move mcc & mnc defines to types.h

Refine errors returned by message-waiting

If we have not initialized fully yet, return sim_not_ready error.
If we couldn't read EFmbi or not able to stat EFmbdn size properly, then
set mbdn_not_present to TRUE and always return not_supported error

Port AT modem driver to the new MWI api

Evolve message waiting low level API

Add a new SIM not ready error

Update voicecalls to the new SIM API

Update network registration to the new SIM API

Update message waiting to the new SIM API

Remove traces of sim_manager from modem.c

Remove unneeded function call

Update SIM AT driver to the new API

Evolve SIM driver

Move ofono_destroy_fun to types.h

Remove unneeded variable

Fix cut and paste error

Fix whitespace and style issues

Refactor ECC: Free the new_en_list

Avoid a potential memory leak in case the interface is removed during
the SIM read operation.

Port SMS AT modem driver to the new API

Evolve SMS driver API