https:\/\/github.com\/estkme-group\/lpac.git<\/a>
We use QMI as noted, so we will enable the QMI flag.
Make and install.<\/p>\n\n\n\nAPL01:~\/lpac$ sudo apt-get install -y build-essential libpcsclite-dev libcurl4-openssl-dev zip\nReading package lists... Done\nBuilding dependency tree... Done\nReading state information... Done\n...\n...\n\nAPL01:~$ git clone https:\/\/github.com\/estkme-group\/lpac.git\nCloning into 'lpac'...\nremote: Enumerating objects: 2865, done.\nremote: Counting objects: 100% (647\/647), done.\nremote: Compressing objects: 100% (256\/256), done.\nremote: Total 2865 (delta 540), reused 399 (delta 389), pack-reused 2218 (from 3)\nReceiving objects: 100% (2865\/2865), 1.04 MiB | 4.17 MiB\/s, done.\nResolving deltas: 100% (1922\/1922), done.\n\nAPL01:~\/lpac$ git checkout tags\/v2.3.0\nNote: switching to 'tags\/v2.3.0'.\n...\nHEAD is now at c2fcf5e chore: bump version to 2.3.0\n\njakob@jakob-UP-APL01:~\/lpac$ cmake -B lpacoutput -DLPAC_WITH_APDU_QMI=ON\n-- The C compiler identification is GNU 13.3.0\n-- Detecting C compiler ABI info\n-- Detecting C compiler ABI info - done\n-- Check for working C compiler: \/usr\/bin\/cc - skipped\n-- Detecting C compile features\n-- Detecting C compile features - done\n-- Found PkgConfig: \/usr\/bin\/pkg-config (found version \"1.8.1\")\n-- Checking for module 'libpcsclite'\n-- Found libpcsclite, version 2.0.3\n-- Found PCSCLite: \/usr\/lib\/x86_64-linux-gnu\/libpcsclite.so\n-- Checking for module 'qmi-glib'\n-- Found qmi-glib, version 1.35.6\n-- Found CURL: \/usr\/lib\/x86_64-linux-gnu\/libcurl.so (found version \"8.5.0\")\n-- Found Git: \/usr\/bin\/git (found version \"2.43.0\")\n-- Configuring done (2.1s)\n-- Generating done (0.0s)\n-- Build files have been written to: \/home\/jakob\/lpac\/lpacoutput\n\nAPL01:~\/lpac$ cmake --build lpacoutput\n[ 1%] Building C object cjson\/CMakeFiles\/cjson-static.dir\/cJSON.c.o\n[ 3%] Building C object cjson\/CMakeFiles\/cjson-static.dir\/cJSON_ex.c.o\n[ 5%] Linking C static library libcjson-static.a\n[ 5%] Built target cjson-static\n[ 7%] Building C object euicc\/CMakeFiles\/euicc.dir\/base64.c.o\n...\n[ 98%] Building C object src\/CMakeFiles\/lpac.dir\/applet\/profile\/nickname.c.o\n[100%] Linking C executable ..\/lpacoutput\/lpac\n[100%] Built target lpac\n\nAPL01:~\/lpac$ sudo cmake --install lpacoutput\n-- Install configuration: \"\"\n-- Installing: \/usr\/local\/bin\/lpac\n-- Set non-toolchain portion of runtime path of \"\/usr\/local\/bin\/lpac\" to \"\/usr\/local\/lib\/lpac\"\n\n<\/code><\/pre>\n\n\n\nStep 5:<\/h4>\n\n\n\n
Export qmi function and qmi_device for lpac to use the correct driver.<\/p>\n\n\n\n
APL01:~$ export LPAC_APDU=qmi\nAPL01:~$ export LPAC_APDU_QMI_DEVICE=\/dev\/cdc-wdm0\n<\/code><\/pre>\n\n\n\nStep 6:<\/h4>\n\n\n\n
Use lpac to gather chip information and handle the eSIM itself.
We pipe the command with jq to get it more readable.
Chip info.
This displays the information of the eUICC you are using with your device.<\/p>\n\n\n\n
APL01:~\/drivertest\/qmi_wwan$ sudo -E lpac chip info | jq .\n{\n \"type\": \"lpa\",\n \"payload\": {\n \"code\": 0,\n \"message\": \"success\",\n \"data\": {\n \"eidValue\": \"8XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX0\",\n \"EuiccConfiguredAddresses\": {\n \"defaultDpAddress\": \"smdp-plus-1.eu.cd.rsp.kigen.com\",\n \"rootDsAddress\": \"lpa.ds.gsma.com\"\n },\n \"EUICCInfo2\": {\n \"profileVersion\": \"2.3.1\",\n \"svn\": \"2.3.0\",\n \"euiccFirmwareVer\": \"36.16.23\",\n \"extCardResource\": {\n \"installedApplication\": 6,\n \"freeNonVolatileMemory\": 213008,\n \"freeVolatileMemory\": 9058\n },\n \"uiccCapability\": [\n \"usimSupport\",\n \"isimSupport\",\n \"csimSupport\",\n \"akaMilenage\",\n \"akaCave\",\n \"akaTuak128\",\n \"akaTuak256\",\n \"gbaAuthenUsim\",\n \"gbaAuthenISim\",\n \"eapClient\",\n \"javacard\",\n \"multipleUsimSupport\",\n \"multipleIsimSupport\",\n \"multipleCsimSupport\"\n ],\n \"ts102241Version\": \"15.1.0\",\n \"globalplatformVersion\": \"2.3.0\",\n \"rspCapability\": [\n \"additionalProfile\",\n \"testProfileSupport\"\n ],\n \"euiccCiPKIdListForVerification\": [\n \"8XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXb\"\n ],\n \"euiccCiPKIdListForSigning\": [\n \"8XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXb\"\n ],\n \"euiccCategory\": null,\n \"forbiddenProfilePolicyRules\": [\n \"ppr1\"\n ],\n \"ppVersion\": \"1.0.0\",\n \"sasAcreditationNumber\": \"KN-XX-XX-XXXX\",\n \"certificationDataObject\": {\n \"platformLabel\": null,\n \"discoveryBaseURL\": null\n }\n },\n \"rulesAuthorisationTable\": [\n {\n \"pprIds\": [\n \"ppr1\",\n \"ppr2\"\n ],\n \"allowedOperators\": [\n {\n \"plmn\": \"eeeeee\",\n \"gid1\": null,\n \"gid2\": null\n }\n ],\n \"pprFlags\": [\n \"consentRequired\"\n ]\n }\n ]\n }\n }\n}\n\n<\/code><\/pre>\n\n\n\nProfile list<\/h4>\n\n\n\n
This shows all profiles in your eUICC.<\/p>\n\n\n\n
APL01:~$ sudo -E lpac profile list | jq .\n{\n \"type\": \"lpa\",\n \"payload\": {\n \"code\": 0,\n \"message\": \"success\",\n \"data\": [\n {\n \"iccid\": \"8944476500000515770\",\n \"isdpAid\": \"a0000005591010ffffffff8900001100\",\n \"profileState\": \"disabled\",\n \"profileNickname\": \"test\",\n \"serviceProviderName\": \"BetterRoaming\",\n \"profileName\": \"BetterRoaming\",\n \"iconType\": null,\n \"icon\": null,\n \"profileClass\": \"operational\"\n },\n {\n \"iccid\": \"8944476500000932264\",\n \"isdpAid\": \"a0000005591010ffffffff8900001300\",\n \"profileState\": \"disabled\",\n \"profileNickname\": null,\n \"serviceProviderName\": \"BetterRoaming\",\n \"profileName\": \"BetterRoaming\",\n \"iconType\": null,\n \"icon\": null,\n \"profileClass\": \"operational\"\n }\n ]\n }\n}\n<\/code><\/pre>\n\n\n\nProfile download<\/h4>\n\n\n\n
This downloads a profile to your eUICC.<\/p>\n\n\n\n
APL01:~$ sudo -E lpac profile download -a 'LPA:1$rsp.truphone.com$QRF-SPEEDTEST'\n{\"type\":\"progress\",\"payload\":{\"code\":0,\"message\":\"es10b_get_euicc_challenge_and_info\",\"data\":\"rsp.truphone.com\"}}\n{\"type\":\"progress\",\"payload\":{\"code\":0,\"message\":\"es9p_initiate_authentication\",\"data\":\"rsp.truphone.com\"}}\n{\"type\":\"progress\",\"payload\":{\"code\":0,\"message\":\"es10b_authenticate_server\",\"data\":\"rsp.truphone.com\"}}\n{\"type\":\"progress\",\"payload\":{\"code\":0,\"message\":\"es9p_authenticate_client\",\"data\":\"rsp.truphone.com\"}}\n{\"type\":\"progress\",\"payload\":{\"code\":0,\"message\":\"es8p_meatadata_parse\",\"data\":{\"iccid\":\"8944476500001126791\",\"serviceProviderName\":\"Speedtest Travel\",\"profileName\":\"BetterRoaming\",\"iconType\":null,\"icon\":null,\"profileClass\":null}}}\n{\"type\":\"progress\",\"payload\":{\"code\":0,\"message\":\"es10b_prepare_download\",\"data\":\"rsp.truphone.com\"}}\n{\"type\":\"progress\",\"payload\":{\"code\":0,\"message\":\"es9p_get_bound_profile_package\",\"data\":\"rsp.truphone.com\"}}\n{\"type\":\"progress\",\"payload\":{\"code\":0,\"message\":\"es10b_load_bound_profile_package\",\"data\":\"rsp.truphone.com\"}}\n{\"type\":\"lpa\",\"payload\":{\"code\":0,\"message\":\"success\",\"data\":null}}\n<\/code><\/pre>\n\n\n\nProfile list<\/h4>\n\n\n\n
Here we can see that our profile we just downloaded is available on the SIM.<\/p>\n\n\n\n
APL01:~$ sudo -E lpac profile list | jq .\n{\n \"type\": \"lpa\",\n \"payload\": {\n \"code\": 0,\n \"message\": \"success\",\n \"data\": [\n {\n \"iccid\": \"8944476500000515770\",\n \"isdpAid\": \"a0000005591010ffffffff8900001100\",\n \"profileState\": \"disabled\",\n \"profileNickname\": \"test\",\n \"serviceProviderName\": \"BetterRoaming\",\n \"profileName\": \"BetterRoaming\",\n \"iconType\": null,\n \"icon\": null,\n \"profileClass\": \"operational\"\n },\n {\n \"iccid\": \"8944476500000932264\",\n \"isdpAid\": \"a0000005591010ffffffff8900001300\",\n \"profileState\": \"disabled\",\n \"profileNickname\": null,\n \"serviceProviderName\": \"BetterRoaming\",\n \"profileName\": \"BetterRoaming\",\n \"iconType\": null,\n \"icon\": null,\n \"profileClass\": \"operational\"\n },\n {\n \"iccid\": \"8944476500001126791\",\n \"isdpAid\": \"a0000005591010ffffffff8900001400\",\n \"profileState\": \"disabled\",\n \"profileNickname\": null,\n \"serviceProviderName\": \"Speedtest Travel\",\n \"profileName\": \"BetterRoaming\",\n \"iconType\": null,\n \"icon\": null,\n \"profileClass\": \"operational\"\n }\n ]\n }\n}\n\n<\/code><\/pre>\n\n\n\nEnable profile<\/h4>\n\n\n\n
In order to enable a profile, you enable it with it’s corresponding ICCID, making sure you get a success message.<\/p>\n\n\n\n
APL01:~$ sudo -E lpac profile enable 89357XXXXXXXXXXXXX\n{\"type\":\"lpa\",\"payload\":{\"code\":0,\"message\":\"success\",\"data\":null}}\n<\/code><\/pre>\n\n\n\nProcess notification<\/h4>\n\n\n\n
Make sure the SM-DP+ server knows the profile is downloaded, installed and enabled correctly.
After successfully processed, you can delete old notifications.<\/p>\n\n\n\n
APL01:~$ sudo -E lpac notification process -a\n{\"type\":\"progress\",\"payload\":{\"code\":0,\"message\":\"es10b_list_notification\",\"data\":null}}\n{\"type\":\"progress\",\"payload\":{\"code\":0,\"message\":\"es10b_retrieve_notifications_list\",\"data\":\"77\"}}\n{\"type\":\"progress\",\"payload\":{\"code\":0,\"message\":\"es9p_handle_notification\",\"data\":\"77\"}}\n{\"type\":\"progress\",\"payload\":{\"code\":0,\"message\":\"es10b_retrieve_notifications_list\",\"data\":\"78\"}}\n{\"type\":\"progress\",\"payload\":{\"code\":0,\"message\":\"es9p_handle_notification\",\"data\":\"78\"}}\n{\"type\":\"progress\",\"payload\":{\"code\":0,\"message\":\"es10b_retrieve_notifications_list\",\"data\":\"79\"}}\n{\"type\":\"progress\",\"payload\":{\"code\":0,\"message\":\"es9p_handle_notification\",\"data\":\"79\"}}\n{\"type\":\"lpa\",\"payload\":{\"code\":0,\"message\":\"success\",\"data\":null}}\n<\/code><\/pre>\n\n\n\nIMPORTANT<\/h4>\n\n\n\n
If you disable and delete a profile, it is important that you process the notifications to make sure the SM-DP+ server knows you have handed the profile back.<\/p>\n\n\n\n
<\/p>\n","protected":false},"excerpt":{"rendered":"
You probably know how traditional SIM cards works, but do you know how to use an eSIM in Linux ? And how well does eSIM work in a Linux environment? Good news is that it\u2019s possible to get a module with an eSIM up and running on your machine with a bit of configuration. So […]<\/p>\n","protected":false},"author":3,"featured_media":2051,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[55,54],"tags":[2567,869,2568,2104,1093],"class_list":["post-56235","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-instalation-support","category-support-download","tag-esim","tag-linux","tag-sim","tag-simcom","tag-ubuntu"],"acf":[],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/wodatherm.com\/en\/wp-json\/wp\/v2\/posts\/56235","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wodatherm.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wodatherm.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wodatherm.com\/en\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/wodatherm.com\/en\/wp-json\/wp\/v2\/comments?post=56235"}],"version-history":[{"count":0,"href":"https:\/\/wodatherm.com\/en\/wp-json\/wp\/v2\/posts\/56235\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wodatherm.com\/en\/wp-json\/wp\/v2\/media\/2051"}],"wp:attachment":[{"href":"https:\/\/wodatherm.com\/en\/wp-json\/wp\/v2\/media?parent=56235"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wodatherm.com\/en\/wp-json\/wp\/v2\/categories?post=56235"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wodatherm.com\/en\/wp-json\/wp\/v2\/tags?post=56235"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}