# Kigen Pulse

This tutorial explain the process of adding a new identity to a SIM as defined by the SGP.32 specifications.

### Quick Navigation

* [Connect your cellular module to Monogoto](#connect-the-murata-type1sc-module-to-monogoto)
* [Validate the SIM identity in Kigen Pulse](#validate-the-sim-identity-in-kigen-pulse)
* [Update the SIM’s profile](#update-the-sims-profile)
* [Video demo](#video-demo)

{% hint style="success" %}
Kickstart your SGP.32 journey with the Monogoto [**SGP.32 Ready Kit**](https://monogoto.io/labs/sgp-32-ready-kit/). Order the kit and receive the Murata development kit, the required SIMs and access to all platforms.
{% endhint %}

### Pre-requisites

* A development kit with embedded cellular module\
  \&#xNAN;*For example Murata's* [*LBAD0XX1SC-DM-EVK2*](https://www.murata.com/en-eu/products/connectivitymodule/cat-m1/support) *or Nordic's* [*Thingy:91*](https://www.nordicsemi.com/Products/Development-hardware/Nordic-Thingy-91)
* Access to the **Kigen Pulse platform** which can be requested [here](https://kigen.com/products/eim/) 
* A (plastic) SIM with Kigen’s latest [SIM OS](https://kigen.com/products/sim-os/) that supports IPAe
* A new SIM identity, including its activation code \*
* Access to the [Monogoto Hub](https://hub.monogoto.io/)

{% hint style="info" %}
\* From the Monogoto Hub you can directly order a new SIM by going to the menu item "Orders": <img src="https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2FRCs6vAKLSyxC1BPfpw41%2Forders.png?alt=media&#x26;token=e4ef752c-f318-42ba-80e1-b51e37f09e15" alt="" data-size="line">. Make sure to order a Embedded SIM (MFF2).
{% endhint %}

{% hint style="info" %}
Need help getting access to any platform, SIM or development kit? Reach out to <support@monogoto.io>
{% endhint %}

### Connect your cellular module to Monogoto

1. Start off by **inserting the plastic SIM card** from Kige&#x6E;**.**
2. Establish a connection with a mobile network. \
   \
   \&#xNAN;*Have a look at* [*our configuration guides*](https://docs.monogoto.io/getting-started/general-device-configurations/iot-devices) *for popular cellular modules for detailed instructions.*<br>
3. Check the IMSI and ICCID using AT Commands:

```bash
AT+CIMI
295050950080000

OK

AT%CCID
%CCID: 89999257300100800000

OK
```

4. Set the network selection to **automatic**:

```
AT+COPS=0
```

5. Set the APN to `data.mono`

```
AT+CGDCONT=1,"IP","data.mono"
```

6. Validate if the device has an active connection by looking for a confirmation **device event log** in the [Monogoto Hub](https://hub.monogoto.io/).

```
SUCCESS HSS ULA for Thing name = "ICCID 89999257300100800000" IMSI "295050950080000". MNO "VODAFONE LIBERTEL B.V."
```

### Validate the SIM identity in Kigen Pulse

1. **Access the** [**Kigen Pulse platform**](https://pulse.sandbox.kigen.com/)<br>

   <figure><img src="https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2FynpgFtSCaI6WyxrcTnTv%2F1.%20Kigen.png?alt=media&#x26;token=07260801-8979-4f09-806b-428becdd32e4" alt=""><figcaption><p>Kigen Pulse dashboard</p></figcaption></figure>

{% hint style="info" %}
Access to the Kigen Pulse platform can be requested [from Kigen](https://kigen.com/products/eim/).
{% endhint %}

2. **Match the EID in Kigen Pulse with the number printed on your SIM** \
   \
   Navigate to **eSIM IoT** > **eSIMs** \
   \
   Locate the EID number that matches the number printed on the SIM your received. Select your EID to open its configuration page.<br>

   <figure><img src="https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2FnHqb6Dsw2XK7UWqaeMJw%2F1.1%20Kigen%20EID.png?alt=media&#x26;token=0bc9e64e-906b-4b08-927d-66b5243ccbfb" alt=""><figcaption></figcaption></figure>
3. **Validate if the device is connected to Kigen.**\
   \
   Within the **EIS information** section, locate the ICCID marked as <mark style="background-color:green;">`ENABLED`</mark>.<br>

   <figure><img src="https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2FGuoHkUqp8Ui78WzTzSYq%2F2.%20Kigen%20EIS.png?alt=media&#x26;token=677869d1-0178-4f10-ae8e-0e460891c5dc" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The cellular module periodically checks the Kigen Pulse platform for pending tasks, such as ENABLE, DISABLE, DELETE or DOWNLOAD a profile.
{% endhint %}

3. **Request Profile Info**\
   \
   Go to the **IoT Device Single Operations** section and select **Get Profile Info List**.<br>

   <figure><img src="https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2FS5y2LvXkYKeUY6z9rdgo%2F3.%20Profile%20info%20list.png?alt=media&#x26;token=0d9644bb-b8c9-4176-abc1-572cdb6ae3f2" alt=""><figcaption></figcaption></figure>

   Scroll to the **Acknowledged Operations** section and wait for the response, which lists available and enabled profiles.\ <br>

   <figure><img src="https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2FvYwsy6Wi05bqHC9T0SBc%2F4.%20Kigen-get-profile-list.png?alt=media&#x26;token=098c3983-b057-4cf5-8665-79c82878ebc4" alt=""><figcaption></figcaption></figure>

### Update the SIM’s profile

In order to update the profile of the SIM, you need an activation code of a profile, enabling your IoT device to download the new profile.

{% hint style="info" %}
When using a SIM Profiles from Kigen, visit **Consumer > Profiles**.\
\
Select a Profile which has the state: <mark style="background-color:blue;">**RELEASED**</mark>.\
\
Find the Activation Code in the right bottom corner. Copy the code after <mark style="color:red;">`LPA:`</mark>, starting with <mark style="color:red;">`1$`</mark>\
\
![](https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2FY58nxnytd3xhgxAcy75J%2F5.%20Kigen-consumer-profile%20NEW-boxed%20SMALL.png?alt=media\&token=5a8520ef-6abb-48e6-87ae-21f7b9507d9b)<br>
{% endhint %}

1. Navigate to **eSIM IoT > eSIMs** and select your **EID**.

2. Select "**Download Profile** **via** **Activation Code"**.

   <figure><img src="https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2F3lzLKnOLUNCSx7DA81CC%2F6.%20Download%20Profile.png?alt=media&#x26;token=a8cf507d-20c7-4ccf-ad19-07eef517eb6b" alt=""><figcaption></figcaption></figure>

3. Paste the **Activation Code** and click **Confirm**.\
   \
   The activation code will like start with: <mark style="color:red;">`1$`</mark>

   <figure><img src="https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2FdbUOa5AvFl1ziE5NHczA%2F7.%20paste%20activation%20code.png?alt=media&#x26;token=dc08ee7d-8f36-40ca-a0fe-73cf0f7c6c93" alt=""><figcaption></figcaption></figure>

4. Wait for the acknowledgement of the **EIM Download Profile** operation. This may take several minutes.<br>

   <figure><img src="https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2FhAqna38fmPmVAFXzBUis%2F8.%20Kigen-profile%20downloaded%20ACK.png?alt=media&#x26;token=e736a2cd-c732-4df2-a328-099c40ab8d93" alt=""><figcaption></figcaption></figure>

5. Once the EIM profile is successfully downloaded onto the device, enable the profile by selecting “**Enable Profile**”.<br>

   <figure><img src="https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2FdcXKpza8TZeVRLFrMFku%2F9.%20Enable%20profile.png?alt=media&#x26;token=45858116-8bbc-43f0-9ef9-55518ab854a3" alt=""><figcaption></figcaption></figure>

6. Select the profile you want to enable.<br>

   <figure><img src="https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2Fo0MS3aAfXBAwkZBpNs7I%2F10.%20Enable%20new%20profile%20NEW.png?alt=media&#x26;token=b0b9eb75-43bb-4e84-bf84-30f1051a97fc" alt=""><figcaption></figcaption></figure>

7. Validate the new SIM profile.\
   \
   Wait for the **EIM-Enable-Profile** acknowledgement.<br>

   <figure><img src="https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2FR98qUVKUPZeyWRaEcYen%2F11.%20profile%20enabled.png?alt=media&#x26;token=12198bba-904f-412f-ba2b-49c41405e9a3" alt=""><figcaption></figcaption></figure>

   Once acknowledged, run the AT Commands on your device to request the IMSI and UICC of the SIM. If the SIM was enabled successfully, you will see the new IMSI and ICCID.\
   \
   The same IMSI and ICCID are also visible in the Monogoto Hub.

```bash
AT+CIMI
295050950000000
OK

AT%CCID
%CCID: 8999925700000072035
OK
```

{% hint style="success" %}
Do you see the new IMSI and ICCID? Congratulations! You've successfully updated the profile of your SIM using the SGP.32 specifications. 🎉
{% endhint %}

### Video demo

{% embed url="<https://www.youtube.com/watch?v=5XKzITklfgA>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.monogoto.io/getting-started/sim-cards/sgp.32/kigen-pulse.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.