Feature/kigen esim manufacturing

CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+# 3.32.0 - Dec 18 2024
+* Add manufacturing tool to provision Kigen eSIMs + enable profile after dowload
+
+# 3.31.0 - Dec 18 2024
+* Add manufacturing tool to provision Kigen eSIMs + fixes
+
+# 3.30.3 - Dec 1 2024
+* Add manufacturing tool to provision Kigen eSIMs + fixes
+
+# 3.30.3 - Dec 1 2024
+* Add manufacturing tool to provision Kigen eSIMs + minor fix to e2e tests + fix for at-ok checks
+
+# 3.30.2 - Dec 1 2024
+* Add manufacturing tool to provision Kigen eSIMs + minor fix to e2e tests
+
+# 3.30.1 - Dec 1 2024
+* Add manufacturing tool to provision Kigen eSIMs + minor fix to e2e tests
+
+# 3.30.0 - Dec 1 2024
+* Add manufacturing tool to provision Kigen eSIMs
+
 # 3.29.0 - Oct 17 2024
 * Add `particle binary list-assets` and `particle binary strip-assets`
 

ESIM_PROVISION.md

@@ -0,0 +1,70 @@
+# Provision a blank eSIM
+
+### Pre-req
+
+1. Input JSON (A JSON file that has a list of EIDs and their respective RSP URLs)
+2. Output (Folder where output logs will be stored. Defaults to `esim_loading_logs` if not set)
+3. lpa tool (lpa tool binary - differently built for mac and windows)
+4. binaries (Folder with the user binaries)
+
+## Setup
+
+### Local folder setup on computer
+
+Put your files in this structure (for example)
+
+```
+/kigen-resources
+├── /binaries
+│   ├── esim-firmware-b5som.bin
+│   ├── esim-firmware-msom.bin
+├── input.json
+├── custom_output_folder/
+├── lpa
+│   ├── mac
+│   ├── ├── lpa
+│   ├── windows
+│   ├── ├── lpa.exe
+```
+
+### Particle CLI points to Staging
+```
+$ particle update-cli --disable-updates
+Automatic update checks are now disabled
+
+$ export PARTICLE_MANIFEST_HOST=binaries.staging.particle.io
+
+$ particle update-cli --version 3.30.4
+Updating the CLI to 3.30.4
+Automatic update checks are now disabled
+CLI updated successfully
+
+$ particle --version
+3.30.4
+
+$ 
+```
+
+### Device Setup 
+
+1. Connect your device(s) to the computer
+2. Run this command
+```
+particle.js esim provision --input /path/to/input.json --lpa /path/to/lpa-tool --binaries /path/to/binaries --bulk true
+```
+
+### Expected Outcome
+First, the device(s) are flashed. Once the download process starts on a given device, device will turn its LED into yellow. If the download worked, LED turns green. If the download failed, LED turns red.
+
+### After testing
+
+Return to using particle-cli for production
+```
+$ export PARTICLE_MANIFEST_HOST=binaries.particle.io
+$ particle update-cli --enable-updates
+$ particle update-cli
+$ particle --version
+```
+
+### Notes and Warnings
+1. 

package.json

@@ -1,7 +1,7 @@
 {
   "name": "particle-cli",
   "description": "Simple Node commandline application for working with your Particle devices and using the Particle Cloud",
-  "version": "3.29.0",
+  "version": "3.32.0",
   "author": "David Middlecamp",
   "bin": {
     "particle": "./src/index.js"

src/cli/esim.js

@@ -0,0 +1,46 @@
+const unindent = require('../lib/unindent');
+
+module.exports = ({ commandProcessor, root }) => {
+	const esim = commandProcessor.createCategory(root, 'esim', 'Download eSIM profiles (INTERNAL ONLY)');
+
+	commandProcessor.createCommand(esim, 'provision', 'Provisions eSIM profiles on a device', {
+		options: Object.assign({
+			'lpa': {
+				description: 'Provide the LPA tool path'
+			},
+			'input': {
+				description: 'Provide the input json file path'
+			},
+			'output': {
+				description: 'Provide the output folder path'
+			},
+			'binary': {
+				description: 'Provide the path to the binaries'
+			},
+			'bulk': {
+				description: 'Provision multiple devices'
+			}
+		}),
+		handler: (args) => {
+			const ESimCommands = require('../cmd/esim');
+			if (args.bulk) {
+				return new ESimCommands().bulkProvisionCommand(args);
+			} else {
+				return new ESimCommands().provisionCommand(args);
+			}
+		},
+		examples: {
+			'$0 $command': 'TBD'
+		},
+		epilogue: unindent(`
+			The JSON file should look like this:
+			{
+			  "TBD": "TBD"
+			}
+
+			TBD TBD
+		`)
+	});
+	return esim;
+};
+

src/cli/index.js

@@ -5,6 +5,7 @@ const bundle = require('./bundle');
 const cloud = require('./cloud');
 const config = require('./config');
 const doctor = require('./doctor');
+const esim = require('./esim');
 const protection = require('./device-protection');
 const flash = require('./flash');
 const func = require('./function');
@@ -50,6 +51,7 @@ module.exports = function registerAllCommands(context) {
 	cloud(context);
 	config(context);
 	doctor(context);
+	esim(context);
 	protection(context);
 	flash(context);
 	func(context);