Getting Started with eSIM.plus Starter Kit Community

Caution: You must make sure your downloaded APN and Profile are working correctly, otherwise, your device will lose connection from the remote platform. If you lose your connection from the remote platform, you can recover network links by manually configuring your APN and Profile setting from your local device via AT command (AT command will be displayed down below).


Architecture of eSIM.plus

1. eSIM.plus Management Portal
 

The Management Portal grants you the ability to control your devices. You can:

     a. Register your new device. Registration can let the management portal recognizes your devices.

     b. Upload your Activation Code obtained from your suppliers to the portal. Our management portal will push the Activation Code to your designated equipment. This can enable connectivity on your device.

2. eSIM.plus Management Platform

eSIM.plus Management platform is the core part of our product. All the information from the portal and terminal will be exchanged here, other than that, the management platform is in charge of maintaining link connection with the terminal and other value-added services.

3. Resource Suppliers

Resource Suppliers could be either mobile network operators like Vodafone, T-Mobile, or other virtual operators. All you need to do first is to obtain an Activation Code from your favorite suppliers. Here is a list of different suppliers:

eSIM.Info (esiminfo.com)

eSIMDB (esimdb.com)

Local Wireless carrier

4. We will provide you a taste Profile with 100MB data for your location via email.

Activation Code sample

5.Terminal with eSIM Starter Kit

Terminals that want to use eSIM Starter Kit service must install related software and embed a dedicated eSIM chipset.

There are 4 ways to build an eSIM Starter Kit.

1.  Order eSIM.plus dongle directly from us.

2.  Buy a wireless module and eUICC from us, we embed software to the module and design your own device.

3.  Use your own wireless module and buy eUICC from us, download software SDK, integrate into your software system, build your own device.

4.Buy eUICC from us, bring your own Android device and integrated software SDK to your device.


Is there other device that support eSIM.plus?

We could also offer the solution with wiriless module + eUICC or SDK+eUICC for your device to experience eSIM.plus,for a fast integration with your IoT device and highly-efficient remote provisioning, onboarding and management of eSIM profiles.


Where can you order an eSIM Profile?

Resource Suppliers could be either mobile network operators like Vodafone, T-Mobile, or other virtual operators. All you need to do first is to obtain a profile from your favorite suppliers. Here is a list of different suppliers.

eSIMinfo (esiminfo.com)

eSIMDB (esimdb.com)

Local Wireless carrier (https://support.apple.com/en-hk/HT209096)


How does it work?

Each eUICC contains a provisioning profile. Provisioning profile will help you bridge your first network connection when you power on your device. Then your device can have connectivity to connect with the eSIM.plus Management Platform. By using the management platform, it will push Activation Code to the devices accordingly and guide the devices to download profiles from the SM-DP+ server. After the success of downloading the profile, the devices will switch from the provisioning profile to the downloaded profile.

 

Caution: Provisioning profile has very limited complimentary data usage, you need to purchase a data package after running out of all complimentary data packages. 


eSIM.plus Community AT Command

AT+QSOFTSIMCFG

AT+QSOFTSIMCFG=“version”

Querrying RedteaReady software version

AT+QSOFTSIMCFG=”uicc”

Manage eUICC Profiles

Read Command

AT+QSOFTSIMCFG=”uicc”,,

Response

+QSOFTSIMCFG=”uicc”,,

“eid”

+QSOFTSIMCFG=”uicc”,, num,(list of iccid <iccid,class,state>)

+QSOFTSIMCFG=”uicc”,, “xUICC”

OK

If there is any error, response:

ERROR[error code]

Write Command

AT+QSOFTSIMCFG=”uicc”,,[,][,][,]

Response

+QSOFTSIMCFG=”uicc”,[,]

+QSOFTSIMCFG=”uicc”,[,]

+QSOFTSIMCFG=”uicc”,[,]

OK

If there is any error, response:

ERROR[error code]

 

Parameters :

integer type

Description

  0   

Get eUICC and profile info (eid, icccidI)

  1

Config eUICC profiles working state

integer type           

Description

  0

Get eid information

  1

Get iccid information of profiles and working state

  integer type

Description

1

Set profile Enable or Disable

 

Examples:

Get Version

at+qsoftsimcfg=”version”

+QSOFTSIMCFG:”version”,”RQS004_EC20HDLG_20201016#B200514041353733500″OK

Get eid

at+qsoftsimcfg=”uicc”,0,0

+QSOFTSIMCFG: uicc”,0,”89086657727465610100000000001626″OK

Get ICCID List (include provisioning profile)

at+qsoftsimcfg=”uicc”,0,1

+QSOFTSIMCFG: “uicc”,1,2,8944500703196138932F,1,0,898602B9211850001400,2,1OK

Enable a profile (iccid)

at+qsoftsimcfg=”uicc”,1,1,898602B9211850001400

+QSOFTSIMCFG: “uicc”,1,898602B9211850001400

OK

Switch to Provisioning Profile

at+qsoftsimcfg=”uicc”,1,0

+QSOFTSIMCFG: “uicc”,0,8944500703196138932F

OK

 

How do you use it?

 

Windows

Install Windows Driver (Please refer to the “Resource” in kit.esim.plus) Download and install driver and software.

After installing a Windows driver, you can see a USB serial port and a USB network on your system. Before connecting networks, please make sure you have uploaded Profile(s) and correct APN to the management platform, send a command to the device to download profile(s) to the device, and enabled one of them. Now you can use it as a normal USB dongle and explore the internet world. You can manage profiles in your device from kit.esim.plus anywhere, anytime.

 

Using AT Command

You can use your own favorite serials console tool to send AT commands from the USB AT Port.

 

Linux (Ubuntu)

Follow the Linux Driver Installation Guide, now you can either build an application to control the eSIM or send AT command by using the “echo” command directly.

 

Raspberry Pi

Raspberry Pi officially installs a Linux system inside, you just need to follow the normal Linux operation guide. 

 

Embedded Linux ( OpenWrt )

Please modify the system driver files described in the Resource(USB Driver) and rebuild the firmware. After updating the firmware, a network port will appear in the system interface list. For more detail, please refer to the network configuration of Linux.

 

Arduino and other IOT board

Most Arduino boards have TTL serial connectors, you just need to connect TX/RX/GND pins (3.3V) from Dongle directly to the Arduino board. You can send data from the serial port to the dongle by encapsulating data into an AT command.

 

License

Last revision Feb 18, 2021

 

Terminology

 

Activation Code (AC)

 

Information issued by an Operator/Service Provider to an End User. End-User can use it to request for downloads and installations of a Profile. Normally it is a QR code for being scanned from an end-user device to obtain the information.

 

Confirmation Code (CC)

 

A code entered by an End User required by the SM-DP+ for the download of a Profile.

 

Embedded SIM (eSIM)

 

The GSMA has defined a radical new way to securely download SIM information into a ‘Secure Element’ that can be permanently embedded inside any type of device. To enable this change, an ecosystem of trusted platforms and players has been facilitated by the GSMA to create the eSIM solution. It offers an equivalent level of security and protection to that provided by the removable SIM card.

 

Universal Integrated Circuit Card (UICC)

 

Also known as a SIM card, is the smart card (integrated circuit card) used in mobile terminals in mobile networks.[1]

 

eUICC 

 

A removable or non-removable UICC enables the local management of Profiles in a secure way.

 

Enabled Profile 

 

The state of a Profile when its files and/or applications (e.g. NAA) are selectable.

 

ICCID 

 

A unique number to identify a Profile in an eUICC as defined by ITUT E.118 [14][14]. International Mobile Subscriber Identity Unique identifier owned and issued by Operators as defined in 3GPP TS 23.003 [3] Section 2.2.

 

Local Profile Assistant (LPA) 

 

A functional element in the Device or in the eUICC that provides the LPD, LDS, and LUI features.

 

Mobile Network Operator (MNO)

 

An entity providing access capability and communication services to its Subscribers through a mobile network infrastructure.

 

Profile 

 

A combination of data and applications to be provisioned on an eUICC for the purpose of providing services.

 

Provisioning Profile 

 

A combination of Operator data and applications to be provisioned on an eUICC for the purposes of providing connectivity to a mobile network solely for the purpose of the provisioning of Profiles on the eUICC.

 

Remote SIM Provisioning (RSP)

 

The downloading, installing, enabling, disabling, and deleting of a Profile on an eUICC.

 

Subscriber 

 

An entity (associated with one or more users) that is engaged in a Subscription with an Operator. The Subscriber is allowed to subscribe and unsubscribe to services, as well as register an end-user or a list of end-users authorized to use these services.

 

 

Subscription Manager Data Preparation + (SM-DP+) 

 

This role prepares Profile Packages, secures each with a Profile protection key, stores Profile protection keys in a secure manner as well as the Protected Profile Packages in a Profile Package repository, and links the Protected Profile Packages to specified EIDs. The SM-DP+ binds Protected Profile Packages to the respective EID and securely downloads these Bound Profile Packages to the LPA of the respective eUICC.

 

Access Point Name  (APN)

 

An Access Point Name (APN) is the name of a gateway between a GSM, GPRS, 3G, or 4G mobile network and another computer network, frequently the public Internet. A mobile device making a data connection must be configured with an APN to present to the carrier. The carrier will then examine this identifier to determine what type of network connection should be created, for example: which IP addresses should be assigned to the wireless device, which security methods should be used, and how or if, it should be connected to some private customer network.

Why eSIM.plus

A Combination of eSIM & ES

eSIM.plus starter kit

Console