The iPhone Wiki is no longer updated. Visit this article on The Apple Wiki for current information.

Difference between revisions of "Carrier Bundle"

From The iPhone Wiki
Jump to: navigation, search
(New page: '''Carrier Bundles''' provide a way to organize all customizations related to carriers in one place. These include voice mail numbers, MMS and APN settings etc. For users on carriers othe...)
 
m (Update command based on email)
 
(23 intermediate revisions by 9 users not shown)
Line 3: Line 3:
 
For users on carriers other than the Apple's official partners, carrier bundles allow to configure important settings such as APN and enable features like MMS and tethering.
  
For users on carriers other than the Apple's official partners, carrier bundles allow to configure important settings such as APN and enable features like MMS and tethering.
   
−
On the iPhone side, carrier bundles are stored in the following directories:
 +
On the device side, carrier bundles are stored in the following directories:
 
* /var/mobile/Library/Carrier Bundles/ - bundles downloaded via [[iTunes]].
  
* /var/mobile/Library/Carrier Bundles/ - bundles downloaded via [[iTunes]].
−
* /System/Library/Carrier Bundles/ - bundles provided with the [[firmware]] image.
 +
* /System/Library/Carrier Bundles/ - bundles provided with the [[firmware]] image. Starting with iOS 4.2, carrier bundles are stored in a subfolder of this path.
   
−
If two bundles with the same name exist in both paths, the one on user partition takes precedence. This allows Apple to update carrier bundles without releasing a whole new OS.
 +
If two bundles with the same name exist in both paths, the one on user partition takes preference. This allows Apple to update carrier bundles without releasing a whole new OS.
   
  +
On a computer that has downloaded carrier bundle updates, they are stored in the following directories:
  +
* ~/Library/iTunes/iPhone Carrier Support/ - this folder will not exist if iTunes hasn't downloaded any carrier updates
   
−
= Structure =
 +
== Structure ==
  +
Carrier bundles are ZIP archives with .ipcc extension. They are named after the carrier and the country they are for (for example, <code>MyCarrier_au.ipcc</code>) They contain the mandatory Payload folder that includes the bundle itself and the symlink:
−  
−
Carrier bundles are ZIP archives with .ipcc extension. They contain the mandatory Payload folder that includes the bundle itself and the symlink:
  
   
 
\Payload\
  
\Payload\
−
\MyCarrier.bundle\
 +
\MyCarrier_au.bundle\
−
\carrier.plist - carrier settings go here
 +
\[[carrier.plist]] - carrier settings go here
−
\Default_CARRIER_MyCarrier.png - logo for light background
 +
\Default_CARRIER_MyCarrier.png - logo for grey status bar
−
\FSO_CARRIER_MyCarrier.png - logo for dark background
 +
\FSO_CARRIER_MyCarrier.png - logo for black statusbar
 
\Info.plist - bundle description
  
\Info.plist - bundle description
−
\12345 - symlink to MyCarrier.bundle (12345 is MCC+MNC)
 +
\version.plist - bundle version (not always present)
  +
\12345 - symlink to MyCarrier_au.bundle (12345 is MCC+MNC)
  +
  +
  +
== Enabling .ipcc support in iTunes ==
  +
  +
By default, [[iTunes]] allows only carrier bundle updates from Apple. However, when the [[iTunes Modes|"carrier-testing" preference]] is enabled, .ipcc files can be loaded from the user's hard drive by clicking either "Check for Updates" or "Restore" button while holding Shift (on Windows) or Option key (on Mac).
   
  +
To enable this preference, first close iTunes, then run the command below that corresponds with your OS:
  +
* macOS 10.14 and older: <code>defaults write com.apple.itunes carrier-testing -bool true</code>
  +
* macOS 10.15 and newer: <code>defaults write com.apple.AMPDevicesAgent carrier-testing -bool YES</code>
  +
* Windows: <code>"%ProgramFiles%\iTunes\iTunes.exe" /setPrefInt carrier-testing 1</code>
   
  +
== iOS 3.1 Changes ==
−
= Enabling .ipcc support in iTunes =
  
  +
As of iOS 3.1b1, APN settings are now being [http://skitch.com/beau/b4ca8/carrier.plist signed] to prevent tampering/modification by users.
  +
This has been implemented to stop users bypassing the carrier's designated APN for tethering that may require payment for access.
  +
This is also a concern for users of carriers that do not officially offer MMS or Tethering services for users at all.
  +
This signature-check can be circumvented by [http://wikee.iphwn.org/howto:random#how_do_i_re-enable_internet_tethering_on_3.1.2_firmware patching commcenter.]
   
  +
Only the APN settings are being signed; other settings can still be modified without needing to patch commcenter.
−
By default, [[iTunes]] allows only carrier bundle updates from Apple. However, when the "carrier-testing" preference is enabled, .ipcc files can be loaded from the user's hard drive by clicking either "Check for Updates" or "Restore" button while holding Shift (on Windows) or Option key (on Mac).
  
   
−
===To enable .ipcc support on Mac OS X:===
 +
== iOS 4.x Changes ==
  +
One of the new 'features' in iOS 4 is the addition of over-the-air carrier updates. Carriers can now push updated settings over the air without having to tether your device to a computer to poll for updates.
−
1. Quit iTunes.
  
  +
All carrier bundle settings are now signed, not just the APN settings. To circumvent this, [http://www.mirrorcreator.com/files/AIQ9DTQA/ commcenter must now be patched].
  +
The bit-mask for APN settings has also changed quite significantly.
   
  +
== Type Mask ==
−
2. Open Terminal and paste the following command:
  
  +
<pre style="color:red">These flags are depreciated for iOS 4 and above. These will need to be updated for 4.0 onwards.
−
defaults write com.apple.itunes carrier-testing -bool true
  
  +
</pre>
  +
Each APN in the carrier.plist has a numeric type-mask. It is bitmask (combination of flags) that designates what the APN should be used for (eg. phone data, tethering, visual voicemail, MMS, or a combination). This table shows what each-type mask designates an APN for.
   
  +
{| class="wikitable" border="1"
−
===To enable .ipcc support on Windows:===
  
  +
|+'''Type Mask'''
−
1. Quit iTunes.
  
  +
|-
  +
! Value
  +
! Feature
  +
|-
  +
| 0
  +
| Disabled
  +
|-
  +
| 1
  +
| Data
  +
|-
  +
| 2
  +
| Visual Voicemail (VVM)
  +
|-
  +
| 4
  +
| MMS
  +
|-
  +
| 48(0x30)
  +
| Tethering
  +
|}
  +
For example, 55 = 1+2+4+48 means "Tethering, MMS, VVM, Data"
   
  +
== External Links ==
−
2. Press Win-R and paste the following command:
  
  +
*[http://www.volkspost.info/ipcc_fw3/ Carrier Bundle Generator]
−
"%ProgramFiles%\iTunes\iTunes.exe" /setPrefInt carrier-testing 1
  
  +
*[http://b3.s3.quickshareit.com/typemask_new23290c.png Graphical table of APN values]

Latest revision as of 20:07, 9 January 2023

Carrier Bundles provide a way to organize all customizations related to carriers in one place. These include voice mail numbers, MMS and APN settings etc.

For users on carriers other than the Apple's official partners, carrier bundles allow to configure important settings such as APN and enable features like MMS and tethering.

On the device side, carrier bundles are stored in the following directories:

  • /var/mobile/Library/Carrier Bundles/ - bundles downloaded via iTunes.
  • /System/Library/Carrier Bundles/ - bundles provided with the firmware image. Starting with iOS 4.2, carrier bundles are stored in a subfolder of this path.

If two bundles with the same name exist in both paths, the one on user partition takes preference. This allows Apple to update carrier bundles without releasing a whole new OS.

On a computer that has downloaded carrier bundle updates, they are stored in the following directories:

  • ~/Library/iTunes/iPhone Carrier Support/ - this folder will not exist if iTunes hasn't downloaded any carrier updates

Structure

Carrier bundles are ZIP archives with .ipcc extension. They are named after the carrier and the country they are for (for example, MyCarrier_au.ipcc) They contain the mandatory Payload folder that includes the bundle itself and the symlink: 

\Payload\
        \MyCarrier_au.bundle\
                         \carrier.plist - carrier settings go here
                         \Default_CARRIER_MyCarrier.png - logo for grey status bar
                         \FSO_CARRIER_MyCarrier.png - logo for black statusbar
                         \Info.plist - bundle description
                         \version.plist - bundle version (not always present)
        \12345 - symlink to MyCarrier_au.bundle (12345 is MCC+MNC)


Enabling .ipcc support in iTunes

By default, iTunes allows only carrier bundle updates from Apple. However, when the "carrier-testing" preference is enabled, .ipcc files can be loaded from the user's hard drive by clicking either "Check for Updates" or "Restore" button while holding Shift (on Windows) or Option key (on Mac).

To enable this preference, first close iTunes, then run the command below that corresponds with your OS:

  • macOS 10.14 and older: defaults write com.apple.itunes carrier-testing -bool true
  • macOS 10.15 and newer: defaults write com.apple.AMPDevicesAgent carrier-testing -bool YES
  • Windows: "%ProgramFiles%\iTunes\iTunes.exe" /setPrefInt carrier-testing 1

iOS 3.1 Changes

As of iOS 3.1b1, APN settings are now being signed to prevent tampering/modification by users. This has been implemented to stop users bypassing the carrier's designated APN for tethering that may require payment for access. This is also a concern for users of carriers that do not officially offer MMS or Tethering services for users at all. This signature-check can be circumvented by patching commcenter.

Only the APN settings are being signed; other settings can still be modified without needing to patch commcenter.

iOS 4.x Changes

One of the new 'features' in iOS 4 is the addition of over-the-air carrier updates. Carriers can now push updated settings over the air without having to tether your device to a computer to poll for updates. All carrier bundle settings are now signed, not just the APN settings. To circumvent this, commcenter must now be patched. The bit-mask for APN settings has also changed quite significantly.

Type Mask

These flags are depreciated for iOS 4 and above. These will need to be updated for 4.0 onwards.

Each APN in the carrier.plist has a numeric type-mask. It is bitmask (combination of flags) that designates what the APN should be used for (eg. phone data, tethering, visual voicemail, MMS, or a combination). This table shows what each-type mask designates an APN for.

Type Mask
Value Feature
0 Disabled
1 Data
2 Visual Voicemail (VVM)
4 MMS
48(0x30) Tethering

For example, 55 = 1+2+4+48 means "Tethering, MMS, VVM, Data"

External Links

Retrieved from "https://www.theiphonewiki.com/w/index.php?title=Carrier_Bundle&oldid=125996"