feat: add profile download activation code parsing (#72)

* feat: add profile download activation code parsing

* docs: update example

* chore: simplify strtok operations

README.md

@@ -305,17 +305,21 @@ There is no secondary confirmation for deleting a Profile, so please perform it
 
 ##### Download requires connection to SM-DP+ server and the following additional parameters:
 
-- `-s`: SM-DP+ server, optional, if not provided, it will try to read the defaultsmdp attribute.
+- `-s`: SM-DP+ server, optional, if not provided, it will try to read the default sm-dp+ attribute.
 - `-m`: Matching ID, activation code. optional.
 - `-c`: Confirmation Code, optional.
 - `-i`: The IMEI of the device to which Profile is to be downloaded, optional.
+- `-a`: LPA qrcode activation code string, e.g: `LPA:1$<sm-dp+ domain>$<matching id>`, if provided this option takes precedence over the `-s` and `-m` options, optional.
 
 <details>
 
 <summary>Example</summary>
 
 ```bash
 ./lpac profile download -s rsp.truphone.com -m "QR-G-5C-1LS-1W1Z9P7"
+
+# LPA qrcode activation code string
+./lpac profile download -a 'LPA:1$rsp.truphone.com$QR-G-5C-1LS-1W1Z9P7'
 ```
 
 </details>

src/applet/profile/download.c

@@ -11,7 +11,7 @@
 #include <euicc/es9p.h>
 #include <euicc/tostr.h>
 
-static const char *opt_string = "s:m:i:c:h?";
+static const char *opt_string = "s:m:i:c:a:h?";
 
 static int applet_main(int argc, char **argv)
 {
@@ -23,6 +23,7 @@ static int applet_main(int argc, char **argv)
     char *matchingId = NULL;
     char *imei = NULL;
     char *confirmation_code = NULL;
+    char *activation_code = NULL;
 
     struct es10a_euicc_configured_addresses configured_addresses = {0};
     struct es10b_load_bound_profile_package_result download_result = {0};
@@ -44,20 +45,71 @@ static int applet_main(int argc, char **argv)
         case 'c':
             confirmation_code = strdup(optarg);
             break;
+        case 'a':
+            activation_code = strdup(optarg);
+            if (strncmp(activation_code, "LPA:", 4) == 0)
+            {
+                activation_code += 4; // ignore uri scheme
+            }
+            break;
         case 'h':
         case '?':
             printf("Usage: %s [OPTIONS]\r\n", argv[0]);
             printf("\t -s SM-DP+ Domain\r\n");
             printf("\t -m Matching ID\r\n");
             printf("\t -i IMEI\r\n");
             printf("\t -c Confirmation Code (Password)\r\n");
+            printf("\t -a Activation Code (e.g: 'LPA:***')\r\n");
             printf("\t -h This help info\r\n");
             return -1;
+        default:
             break;
         }
         opt = getopt(argc, argv, opt_string);
     }
 
+    if (activation_code != NULL)
+    {
+        // SGP.22 v2.2.2; Page 111
+        // Section: 4.1 (Activation Code)
+
+        char *token = NULL;
+        int index = 0;
+
+        for (token = strtok(activation_code, "$"); token != NULL; token = strtok(NULL, "$"))
+        {
+            switch (index)
+            {
+            case 0: // Activation Code Format
+                if (strncmp(token, "1", strlen(token)) != 0)
+                {
+                    jprint_error("invalid activation code format", NULL);
+                    goto err;
+                }
+                break;
+            case 1: // SM-DP+ Address
+                smdp = strdup(token);
+                break;
+            case 2: // AC_Token or Matching ID
+                matchingId = strdup(token);
+                break;
+            case 3: // SM-DP+ OID
+                // ignored; this function is not implemented
+                break;
+            case 4: // Confirmation Code Required Flag
+                if (strncmp(token, "1", strlen(token)) == 0 && confirmation_code == NULL)
+                {
+                    jprint_error("confirmation code required", NULL);
+                    goto err;
+                }
+                break;
+            default:
+                break;
+            }
+            index++;
+        }
+    }
+
     if (smdp == NULL)
     {
         jprint_progress("es10a_get_euicc_configured_addresses");