Files
scripts/carriersettings-extractor
Chirayu Desai ea8804b723 carriersettings-extractor: Sync tag name
* If you look at the CarrierConfigV2 converter, it reads
  'pbundle_as_map' and not 'bundle' - which isn't handled at all
* All others match parseCarrierConfigToMap

Ref: 2093949: Add support for "double" and "bundle" in pb generating script | https://android-review.googlesource.com/c/platform/tools/carrier_settings/+/2093949
TODO: Figure out how to run the converter as a test somehow
Change-Id: I2197766590625e9f4cd12d30a65204a2ec750515
2023-06-16 21:40:21 +02:00
..
2023-06-16 21:40:21 +02:00

carriersettings-extractor

Android Open Source Project (AOSP) includes APN settings (apns-full-conf.xml) and carrier settings (carrier_config_*.xml + vendor.xml) in human-readable XML format. However, Google Pixel device images instead include APN and carrier settings as binary protobuf files for use by the CarrierSettings system app.

This script converts the CarrierSettings protobuf files (e.g., carrier_list.pb, others.pb) to XML format compatible with AOSP. This may be helpful for Android-based systems that do not bundle CarrierSettings, but wish to support carriers that are not included in AOSP.

For a description of each APN and carrier setting, refer to the doc comments in Telephony.java and CarrierConfigManager.java, respectively.

Dependencies

  • protobuf-compiler (protoc) - optional, see below
  • python3-protobuf - required

Usage

Download a Pixel factory image and extract the CarrierSettings protobuf files. Convert CarrierSettings/*.pb to apns-full-conf.xml and vendor.xml.

./carriersettings_extractor.py -i CarrierSettings -a apns-conf.xml -v vendor.xml

Protobuf definitions

The definitions in carrier_list.proto and carrier_settings.proto are useful for inspecting the CarrierSettings protobuf files.

protoc --decode=com.google.carrier.CarrierList carrier_list.proto < CarrierSettings/carrier_list.pb
protoc --decode=com.google.carrier.CarrierSettings carrier_settings.proto < CarrierSettings/verizon_us.pb
protoc --decode=com.google.carrier.MultiCarrierSettings carrier_settings.proto < CarrierSettings/others.pb

To check schema or otherwise inspect the protobuf files without applying definitions, use the --decode_raw argument.

protoc --decode_raw < CarrierSettings/carrier_list.pb
protoc --decode_raw < CarrierSettings/verizon_us.pb
protoc --decode_raw < CarrierSettings/others.pb