Back up to the Voice SIM Category Page

SIP2SIM Technical

From AAISP Support Site
Revision as of 00:54, 19 December 2018 by Adsb (talk | contribs) (Make it clearer that DNS provides SRV records)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search


The SIP2SIM service registers with a SIP endpoint using a specified hostname, username, and password as set on the control pages. This registration comes from one of our SIP service IP addresses ( or 2001:8b0:0:30::5060:0/112). For maintenance, the IP used can change from time to time, and will usually mean a de-registration is sent from the previous IP and a new registration from the new IP.

Calls made to the registered contact are passed to the SIM.

Calls from the mobile are sent to the hostname specified, using the username and password specified. The called number is the dialled number from the phone. The CLI is the SIM's ICCID. The call comes from the same group of call servers and will normally be from the same IP address from which the registration request is sent.

All calls each way are UDP SIP/2.0 control messages with G.711 64kbs a-law audio. The service uses DNS with SRV records.

  • The CLI for calls to a mobile should be sent as a full international number without the leading +. Other formats will work, but are likely to present with a + and the digits sent. This is an area we want to improve over time. You can, however, present any CLI.
  • Some networks present an in-band audio recording before clearing for busy or no reply, etc. We are hoping to be able to remove this in the future and just send the normal clearing code.
  • Some mobile phones validate dialled numbers and may not allow dialling of short sequences, such as three digits.
  • The dialled number on a mobile phone is normally presented as dialled, but if dialled with a + prefix, the plus is lost and the digits only presented.
  • Calls to 999 or 112 will go direct to an emergency services operator. Some phones hijack other numbers such as 911. At present the network hijacks a few other three digit numbers such as 901.
  • Calls starting * and #, and followed by digits, are passed to you, but some combinations of * and # can be used for normal GSM settings and are processed by the network. On dual identity SIMs, you may also see the phone reporting that it is sending some codes, such as *02# - these are to do with profile switching and nothing to be concerned about.
  • If you tell the phone to withhold callign number, calls from the phone won't work. SIP2SIM logically has no number anyway, so you need other ways to present of withhold a number. Our VoIP services uses 141 as a prefix for this.
  • Changes to the registered SIP server can take up to a minute to take effect.
  • At present there may be ways for some calls to reach the phone bypassing the VoIP (i.e. a hidden number) but we expect to be able to fix this in due course.
  • If using an A&A VoIP number, set the hostname to and use the number and password assigned.
  • Some phones (for example iPhones) prohibit tethering - this is not something we are doing, and we hope eventually to be able to find a way to fix this.
  • Some VoIP servers such as asterisk are stupid if we de-register from one call server and register from another and there is an overlap. The overlap should ensure no gap and calls work, but instead asterisk takes the latter de-register as cancelling the first. This is a fault in asterisk and you should complain to the developers. Thankful we do not upgrade the servers that often and so move registrations.
  • Some VoIP providers do not support compact SIP. This is not RFC compliant (RFC 3261 says "Implementations MUST accept both the long and short forms of each header name.") so SIP2SIM will not work with these providers until they fix their service.
  • SIP2SIM is known not to work correctly with Sipgate where multiple Sipgate registrations are involved. We cannot work with them to fix it as they say using SIP2SIM is against their terms.

Some numbers have special conditions, specifically 07 mobile numbers. These must be sent over radio to a mobile handset. OFCOM have finally agreed that sending incoming calls to a SIP endpoint that we know is connected via radio to a mobile handset is allowed. This means SIP2SIM qualifies, and so it is possible to set an 07 A&A mobile number to a SIP2SIM connection and accept incoming calls. At present this has the same 2p+VAT/min call cost but we hope in future to be able to subsidise that from 07 incoming call revenue. Our 07 numbers are not available from all carriers and networks yet, and we are working on that. Our 07 numbers also cannot receive inbound texts, and we are working on that. As such, we do not, at present, suggest using an 07 A&A number.


The text service allows texts to and from the phone with the SIM. Texts can be sent to the phone by using our normal text gateway with a destination of the SIM ICCID and credentials for the text service (e.g. a VoIP account). The control pages allow texts from the phone to be sent to an HTTP address of your choice.

  • Some phones and some networks validate the number you are texting from a phone and will only reliably allow texting of a full phone number.
  • If you have an A&A VoIP number on the same login as the SIM you can set the SIM ICCID on the incoming section of the VoIP number so that texts to that number are relayed directly to the SIM. There is a text charge for this. Not all of our VoIP numbers can accept incoming texts.
  • If you have an A&A VoIP number on the same login as the SIM you can set this on the SIM config on the control pages so that texts from the SIM are sent out as from that number. This incurs our normal outgoing text cost plus the SIP2SIM text cost, but we hope in future to apply a discount in this case.
  • There may be a small range of non UK mobile numbers to which mobile originated texts would go directly, i.e. bypassing the normal http posting, and presenting a different sending number.
  • At present there may be ways for some texts to reach the phone bypassing the http posting (i.e. a hidden number) but we expect to be able to fix this in due course.
  • Some phones (e.g. iPhones) send SMS to validate services (e.g. iMessage) and these will be chargeable.

Not all A&A VoIP numbers can handle incoming texts. There is unlikely to ever be any discounting of inbound text charges even when we have 07 mobile numbers working for texts as we are unlikely to see incoming revenue from such texts.


To use data, set the APN to mobiledata with no username or password.

  • At present the data makes use of a NAT Internet connection which is unfiltered. We hope to have a more direct APN in due course.
  • Some phones will need the APN setting, and may need it setting for each profile separately on O2/EU SIMs.

SIM application

Some types of SIM has an application which can be accessed on most phones as a SIM settings menu of some sort. This allows you to switch the profile between O2 UK (only works on O2 in the UK), a Europe roaming (works in EU, including roaming in the UK to other operators), or world roaming (works anywhere). This can also change automatically, e.g. if set to UK roaming and O2 UK is found as a network.

Different types of SIM

There are different types of SIM available, the full roaming version with the SIM application, and SIMs that are only O2 UK with no roaming. The latter are intended for use where only O2 UK usage is acceptable and for any devices that do not work will with a SIM application for any reason. We may also have some that are just Vodafone NL for telemetry usage (expensive data, but works on any network).

At launch we will be shipping the UK O2 only SIMs. Once we launch the roaming SIMs existing customers will be able to upgrade for free.

SIM Sizes

SIM cutout lines

The SIMs are provided on credit card sized (full size SIM) with push out for mini and micro SIMs. The SIM is also printed with an outline for a nano SIM so you can cut it down. We recommend using a proper cutting tool, but scissors usually work. Cutting down SIMs is at you own risk (for damaging the SIM or your phone).


We can set the operator name on the SIM, which is displayed on the screen on many mobiles. Note that iPhones only show this in a menu and not the main screen. We can only do this by a SIM update message to the SIM, so it does not show your chosen operator name on first use, only once updated, and even then may need the phone power cycling. At present this is a manual process and you have to ask staff to send the update, but we hope to integrate it with the control pages in due course.

We can print with A&A logo and QR code link to SIM config, or without any A&A branding if you need. Please let us know. Supply artwork as full colour (ideally RGB BMP) 1024x648 300dpi. The following templates show the position of A&A branding and text, QR code, and SIM masking. Your artwork should cover the whole card rather than having gaps for the masked areas, etc., as we may change layout slightly from time to time and if there are changes to the cards themselves.

We cannot guarantee that printing will be free from any defects. You can, if you prefer, order unprinted cards and print them yourself. Unprinted cards may have ICCID and barcode pre-printed.