Merge pull request #51 from bondhome/marcio/scripts

Scripts folder and add_multiple_devices helper script

scripts/README.md

@@ -0,0 +1,48 @@
+# Scripts
+
+Here you can find some useful scripts to automate tasks using the `bond-cli` tool.
+
+## [add_multiple_devices.sh](add_multiple_devices.sh)
+A script to add multiple devices with the same template, location, and name prefix. Useful for testing.
+
+### Usage
+```
+Usage: ./scripts/add_multiple_devices.sh --bondID ZXBL00000 --deviceName 'Test Device' --location 'Bedroom' --template RMS12 --quantity 10
+ --bondID The ID of the Bond you want to create the new devices
+ --deviceName The name of the device. This will be a prefix of the actual name. I.e: 'Test Device 1', 'Test Device 2'...
+ --location Device Location (Bedroom, Living Room, etc.)
+ --template The device template name to be created (RCF84, A1, etc.)
+ --quantity The amount of devices that will be created
+```
+
+### Example
+```bash
+# On the repository root folder
+./scripts/add_multiple_devices.sh --bondID ZPEA12345 --deviceName "Test Shade" --location "Testing" --template RMS12 --quantity 15
+```
+
+That will create 15 RMS12 Motorized Shades starting with `Test Shade 01` through `Test Shade 15` in the `Testing` location.
+So the final output would be:
+```
+Devices on ZPEA77140
+----------------------------------------------------
+|dev_id |name |location |
+|----------------|----------------|----------------|
+|7c26c755c37a9d71|Test Shade 01 |Testing |
+|f27e84845e66cade|Test Shade 02 |Testing |
+|32a7a66bce293ca0|Test Shade 03 |Testing |
+|c0bbe6982a52dc24|Test Shade 04 |Testing |
+|b0d05e3ebefba5cd|Test Shade 05 |Testing |
+|d309f67257adffe1|Test Shade 06 |Testing |
+|fea75bbd5de7d783|Test Shade 07 |Testing |
+|c9da1d8bb323997a|Test Shade 08 |Testing |
+|7953e71d35873a80|Test Shade 09 |Testing |
+|adce5a30809542f7|Test Shade 10 |Testing |
+|0ffa61dd811639f3|Test Shade 11 |Testing |
+|c4b24e2a09c09ed4|Test Shade 12 |Testing |
+|3a4b45a6ea46d68a|Test Shade 13 |Testing |
+|0549cbd40147f4a6|Test Shade 14 |Testing |
+|827610a5e664e3e2|Test Shade 15 |Testing |
+----------------------------------------------------
+Done!
+```

scripts/add_multiple_devices.sh

@@ -0,0 +1,83 @@
+#!/bin/bash
+
+helpFunction()
+{
+ echo ""
+ echo "Usage: $0 --bondID ZXBL00000 --deviceName 'Test Device' --location 'Bedroom' --template RMS12 --quantity 10"
+ echo -e "\t--bondID The ID of the Bond you want to create the new devices"
+ echo -e "\t--deviceName The name of the device. This will be a prefix of the actual name. I.e: 'Test Device 1', 'Test Device 2'..."
+ echo -e "\t--location The device location (Bedroom, Living Room, etc.)"
+ echo -e "\t--template The device template name to be created (RCF84, A1, etc.)"
+ echo -e "\t--quantity The amount of devices that will be created"
+ exit 1 # Exit script after printing help
+}
+
+POSITIONAL_ARGS=()
+
+while [[ $# -gt 0 ]]; do
+ case $1 in
+ -h|--help)
+ helpFunction
+ exit 0
+ ;;
+ --bondID)
+ bondID=$2
+ shift # past argument
+ shift # past value
+ ;;
+ --deviceName)
+ deviceName=$2
+ shift # past argument
+ shift # past value
+ ;;
+ --template)
+ template=$2
+ shift # past argument
+ shift # past value
+ ;;
+ --location)
+ location=$2
+ shift # past argument
+ shift # past value
+ ;;
+ --quantity)
+ quantity=$2
+ shift # past argument
+ shift # past value
+ ;;
+ -*|--*)
+ echo "Unknown option $1"
+ exit 1
+ ;;
+ *)
+ POSITIONAL_ARGS+=("$1") # save positional arg
+ shift # past argument
+ ;;
+ esac
+done
+
+set -- "${POSITIONAL_ARGS[@]}" # restore positional parameters
+
+# Print helpFunction in case parameters are empty
+if [ -z "$bondID" ] || [ -z "$deviceName" ] || [ -z "$location" ] || [ -z "$template" ] || [ -z "$quantity" ]
+then
+ echo "Some or all of the parameters are empty";
+ helpFunction
+ exit 0
+fi
+
+echo "Looking for Bond $bondID..."
+echo
+
+bond discover
+bond select $bondid
+
+echo
+echo "Adding $deviceName (1 to $quantity) with template $template to $bondID"
+
+for (( i=1; i<=$quantity; i++ )); do
+ name="$deviceName $(printf %0*d ${#quantity} $i)"
+ bond devices create --name "$name" --location "$location" --template "$template"
+done
+
+echo "Done!"