From 94761654ea2c61451262aefaf3ac0725a7304053 Mon Sep 17 00:00:00 2001
From: Micah Halter <micah@balena.io>
Date: Mon, 29 Mar 2021 15:39:58 -0400
Subject: [PATCH] add instruction partials to device contracts

Change-type: minor
Signed-off-by: Micah Halter <micah@balena.io>
---
 .../beaglebone-black/contract.json               |  8 ++++++++
 contracts/hw.device-type/fincm3/contract.json    | 11 +++++++++++
 .../hw.device-type/intel-edison/contract.json    | 16 ++++++++++++++++
 .../hw.device-type/raspberry-pi/contract.json    |  6 ++++++
 4 files changed, 41 insertions(+)

diff --git a/contracts/hw.device-type/beaglebone-black/contract.json b/contracts/hw.device-type/beaglebone-black/contract.json
index c74912d7..14e92c27 100644
--- a/contracts/hw.device-type/beaglebone-black/contract.json
+++ b/contracts/hw.device-type/beaglebone-black/contract.json
@@ -28,6 +28,14 @@
     "media": {
       "installation": "sdcard"
     },
+    "installation": {
+      "method": "externalFlash"
+    },
     "is_private": false
+  },
+  "partials": {
+    "bootDeviceExternal": ["Power up the {{name}} while holding down the small button near the SD slot. You need to keep it pressed until the blue LEDs start flashing wildly."],
+    "flashIndicator": ["all LEDs are off"],
+    "bootDevice": ["Remove and re-connect power to the {{name}}"]
   }
 }
diff --git a/contracts/hw.device-type/fincm3/contract.json b/contracts/hw.device-type/fincm3/contract.json
index 62fbb544..c57ff294 100644
--- a/contracts/hw.device-type/fincm3/contract.json
+++ b/contracts/hw.device-type/fincm3/contract.json
@@ -26,6 +26,17 @@
     "media": {
       "installation": "dfu"
     },
+    "installation": {
+      "method": "internalFlash"
+    },
     "is_private": false
+  },
+  "partials": {
+    "connectDevice": [
+      "While not having the {{name}} board powered, connect your system to the board's DBG/PRG port via a micro-USB cable.",
+      "<em>Note: for the {{name}} v1.1, only power the board from the PRG port for flashing. For the {{name}} v1.0, power on the board by attaching power to either the Barrel or the Phoenix connector.</em>"
+    ],
+    "disconnectDevice": ["Power off the {{name}} by detaching the power if connected and unplug the DGB micro-USB cable."],
+    "bootDevice": ["Remove and re-connect power to the {{name}}"]
   }
 }
diff --git a/contracts/hw.device-type/intel-edison/contract.json b/contracts/hw.device-type/intel-edison/contract.json
index b198b0bf..74404077 100644
--- a/contracts/hw.device-type/intel-edison/contract.json
+++ b/contracts/hw.device-type/intel-edison/contract.json
@@ -28,6 +28,22 @@
     "media": {
       "installation": "dfu"
     },
+    "installation": {
+      "method": "other"
+    },
     "is_private": false
+  },
+  "partials": {
+    "instructions": [
+      "Install <code>dfu-util</code> and <code>coreutils</code> from your distributions repos. For example, for Ubuntu: <code>apt-get install dfu-util coreutils</code>",
+      "Unplug the Intel Edison board from your system",
+      "Unzip the downloaded Device OS file.",
+      "Execute the following from the unzipped directory: <code>sudo ./flashall.sh</code>",
+      "If you have trouble executing, you may need to modify the file permissions first: <code> sudo chmod +x ./flashall.sh</code>"
+    ],
+    "bootDevice": [
+      "Plug the Intel Edison as per the instructions on your terminal.",
+      "You can check the progress of the provisioning on your terminal."
+    ]
   }
 }
diff --git a/contracts/hw.device-type/raspberry-pi/contract.json b/contracts/hw.device-type/raspberry-pi/contract.json
index 89ff3cfe..d9ff7de6 100644
--- a/contracts/hw.device-type/raspberry-pi/contract.json
+++ b/contracts/hw.device-type/raspberry-pi/contract.json
@@ -26,6 +26,12 @@
     "media": {
       "installation": "sdcard"
     },
+    "installation": {
+      "method": "externalBoot"
+    },
     "is_private": false
+  },
+  "partials": {
+    "bootDevice": ["Connect power to the {{name}}"]
   }
 }