{"_id":"543d3ff2a10ab32000b3aa9e","__v":14,"is_link":false,"version":{"_id":"543b943865bf840e00b473b6","__v":5,"project":"543b943865bf840e00b473b3","createdAt":"2014-10-13T08:58:32.703Z","releaseDate":"2014-10-13T08:58:32.703Z","categories":["543b943865bf840e00b473b7","543b96e1b1479b1400c42f3d","543d1cdc3a300f20000d31ee","553e061924ec240d00b1f897","553e06431a946a0d00ad6f78"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"project":"543b943865bf840e00b473b3","user":"543b93f865bf840e00b473b2","category":{"_id":"543b943865bf840e00b473b7","version":"543b943865bf840e00b473b6","project":"543b943865bf840e00b473b3","__v":15,"pages":["543ffb2c22a3b30e001bdc37","543b965fb1479b1400c42f3a","543d1cbb5276641a00a593c3","543d3ff2a10ab32000b3aa9e","543d1fa83a300f20000d3206","543f8f8a051bdc0e00dfbf02","543d4a17a10ab32000b3aace","543ea21f3f50eb1a00ed2050","543ea6ac3f50eb1a00ed205e","543ebaedcc182e08005d0cc4","543f8cb422a3b30e001bdb48","543f838422a3b30e001bdb36","544184629c7623200053c8e7","5541356a69a03a2d00ce0b3b"],"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2014-10-13T08:58:32.718Z","from_sync":false,"order":9999,"slug":"documentation","title":"Documentation"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2014-10-14T15:23:30.499Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"basic_auth":false,"results":{"codes":[]},"try":true,"auth":"never","params":[],"url":""},"isReference":false,"order":3,"body":"The ContinuumBridge portal is your view onto what apps and devices are installed on your bridges. It allows you to \"discover\" devices and add apps that can use them. The paragraphs below take you through this process using the Demo Switch App example.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Logging-in\"\n}\n[/block]\nOn any computer, open a browser and press the \"Customer Login\" button on www.continuumbridge.com, or navigate to:\n\nhttp://portal.continuumbridge.com/\n\nOnce you have logged-in, your browser should look similar to the picture below with name of your bridge near the top-left of the screen (in this case, “My Bridge”). In the future, this portal will be developed into is a development portal and a user portal, but for now this is essentially a proto-development portal.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/uh2wgSJ6T6IckWPUxOIs_tmp.jpg\",\n        \"tmp.jpg\",\n        \"1397\",\n        \"963\",\n        \"#273c4e\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Adding bridge-apps\"\n}\n[/block]\nClick on the Install Apps button. A pop-up will appear similar to that shown below. From this, install Demo Switch App and press close. The app will appear in the list of apps on the left of the browser window.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/sZ4MYwJmTfSKeDtoqc28_tmp.jpg\",\n        \"tmp.jpg\",\n        \"1395\",\n        \"957\",\n        \"#907e5a\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"No apps?\",\n  \"body\": \"A few default apps are installed when you create a new bridge. At present, this sometimes does not happen. If you don't see any, please email us at info.continuumbridge.com and we'll fix it.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"\\\"Discovering\\\" devices\"\n}\n[/block]\nNow ensure that the devices that you want to use are on. Z-wave devices are generally included in a network by either pressing a button once or three times. Refer to the instruction of the specific device. Now press the “Connect to Device” button, and do whatever is required to your device to put it into discovery/inclusion mode. After a delay of up to 30 seconds, the display will show any devices that have been found. Status updates and instruction are displayed in the Bridge Messages window. An example of this is given below. Here a Vision Security 258 Z-wave device has been found, along with two devices mysteriously named “Continuum”, which are actually TI Sensortags that have been reprogrammed by ContinuumBridge.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/KhmasILURb63AVsEuf5J_tmp.jpg\",\n        \"tmp.jpg\",\n        \"1401\",\n        \"949\",\n        \"#4398e6\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nOnly one device may be installed at a time. With Z-wave devices, only one will be displayed. With Bluetooth devices, you may see many and a lot of devices (eg: some smartphones) will appear, but only try to install the device you are intending to install. \n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Z-wave devices\",\n  \"body\": \"Make sure the device is within a few metres of the bridge before trying to discover/include it. Once it is installed on the bridge, you can move it away.\\n\\nSometimes you may see a status message saying that a Z-wave device has been found, but then it is not identified. This can occur for a number of reasons, including a poor radio connection. If this happens, press the Z-exclude button on the portal and then the include/exclude button on the device (in accordance with the manufacturer's instructions). Then try again.\"\n}\n[/block]\nThe display below shows what happened when we clicked on the “Install” button of the Vision Security device and gave it the name “Magnetic Switch”. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/dlgPI15GTViXYAhbdIrK_tmp.jpg\",\n        \"tmp.jpg\",\n        \"1400\",\n        \"960\",\n        \"#273c4f\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Friendly names\",\n  \"body\": \"We find it useful to give our devices names that we can remember, such as \\\"Front Door Magnetic Switch\\\", for a magnetic switch that's on the front door. Then it's easy to work out which devices you want to connect to an app.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"In the current version of the platform, information about apps and adaptors is not sent to the bridge (Raspberry Pi) until the “Update” button in the group of buttons on the bottom-left of the screen is pressed, so press this. This will also cause any new apps and adaptors to be downloaded to the bridge if they are not already installed on it.\",\n  \"title\": \"The Update button\"\n}\n[/block]\nNow, repeat the “Connect to a Device” and installation process for other devices, remembering to press the “Update” button each time. The figure below shows the display after a mains switch and a “Continuum” Sensortag have been installed\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/jtLPOwcLRGWayOUOsiAL_tmp.jpg\",\n        \"tmp.jpg\",\n        \"1403\",\n        \"959\",\n        \"#273c4e\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"What are those letters and numbers after Bluetooth device names?\",\n  \"body\": \"They're the last 4 digits of the Bluetooth address. In some cases, this can be useful in identifying devices, if you have lots of the same sort of Bluetooth device. If this doesn't apply to you, just ignore them.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Connecting devices to apps\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Device permissions\",\n  \"body\": \"A key benefit of the ContinuumBridge platform is that you, the user, own and control your devices or appliances and you decide which bridge-apps you want to be able to see them. The permissions are given by connecting devices to apps as described in this section.\"\n}\n[/block]\nClick on the pencil next to the Demo Switch App. The resulting screen will be similar to that shown below. This shows that all three devices that have been installed can be connected to the app. In the display shown here, two have been connected, but just connect however many you have. Once you have done this, click the \"Update\" button and then the “Restart” button in the buttons area in the bottom-left of the browser window. You will see various messages in the Bridge Messages window. After the bridge has started, you will be able to either trigger the sensor or press a button on the Sensortag and the mains switch will turn on or off accordingly.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/Pi4YEYHFTk6uFmsnw3DA_tmp.jpg\",\n        \"tmp.jpg\",\n        \"1399\",\n        \"1011\",\n        \"#2ca1c3\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"success\",\n  \"title\": \"Congratulations\",\n  \"body\": \"You've connected devices to an app and got them to do something. This is a very simple example, but even with a few simple devices you can make it do lots more, just by editing the code.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"Things to remember\",\n  \"body\": \"This is an alpha version of the ContinuumBridge platform and is intended primarily for developers. Subsequent versions will have a far cleaner user interface, but for now, if things aren't going as you expected, remember:\\n\\n1. Always press the Update button on the portal when you have made any changes.\\n\\n2. Most changes won't take effect on the bridge until you have pressed Restart.\\n\\n3. Installing Z-wave devices can be a pain. See the notes above.\"\n}\n[/block]\n[To learn how to write a bridge-app ...](doc:writing-an-app-on-the-raspberry-pi)","excerpt":"","slug":"the-continuumbridge-portal","type":"basic","title":"The ContinuumBridge Portal"}

The ContinuumBridge Portal


The ContinuumBridge portal is your view onto what apps and devices are installed on your bridges. It allows you to "discover" devices and add apps that can use them. The paragraphs below take you through this process using the Demo Switch App example. [block:api-header] { "type": "basic", "title": "Logging-in" } [/block] On any computer, open a browser and press the "Customer Login" button on www.continuumbridge.com, or navigate to: http://portal.continuumbridge.com/ Once you have logged-in, your browser should look similar to the picture below with name of your bridge near the top-left of the screen (in this case, “My Bridge”). In the future, this portal will be developed into is a development portal and a user portal, but for now this is essentially a proto-development portal. [block:image] { "images": [ { "image": [ "https://files.readme.io/uh2wgSJ6T6IckWPUxOIs_tmp.jpg", "tmp.jpg", "1397", "963", "#273c4e", "" ] } ] } [/block] [block:api-header] { "type": "basic", "title": "Adding bridge-apps" } [/block] Click on the Install Apps button. A pop-up will appear similar to that shown below. From this, install Demo Switch App and press close. The app will appear in the list of apps on the left of the browser window. [block:image] { "images": [ { "image": [ "https://files.readme.io/sZ4MYwJmTfSKeDtoqc28_tmp.jpg", "tmp.jpg", "1395", "957", "#907e5a", "" ] } ] } [/block] [block:callout] { "type": "danger", "title": "No apps?", "body": "A few default apps are installed when you create a new bridge. At present, this sometimes does not happen. If you don't see any, please email us at info.continuumbridge.com and we'll fix it." } [/block] [block:api-header] { "type": "basic", "title": "\"Discovering\" devices" } [/block] Now ensure that the devices that you want to use are on. Z-wave devices are generally included in a network by either pressing a button once or three times. Refer to the instruction of the specific device. Now press the “Connect to Device” button, and do whatever is required to your device to put it into discovery/inclusion mode. After a delay of up to 30 seconds, the display will show any devices that have been found. Status updates and instruction are displayed in the Bridge Messages window. An example of this is given below. Here a Vision Security 258 Z-wave device has been found, along with two devices mysteriously named “Continuum”, which are actually TI Sensortags that have been reprogrammed by ContinuumBridge. [block:image] { "images": [ { "image": [ "https://files.readme.io/KhmasILURb63AVsEuf5J_tmp.jpg", "tmp.jpg", "1401", "949", "#4398e6", "" ] } ] } [/block] Only one device may be installed at a time. With Z-wave devices, only one will be displayed. With Bluetooth devices, you may see many and a lot of devices (eg: some smartphones) will appear, but only try to install the device you are intending to install. [block:callout] { "type": "warning", "title": "Z-wave devices", "body": "Make sure the device is within a few metres of the bridge before trying to discover/include it. Once it is installed on the bridge, you can move it away.\n\nSometimes you may see a status message saying that a Z-wave device has been found, but then it is not identified. This can occur for a number of reasons, including a poor radio connection. If this happens, press the Z-exclude button on the portal and then the include/exclude button on the device (in accordance with the manufacturer's instructions). Then try again." } [/block] The display below shows what happened when we clicked on the “Install” button of the Vision Security device and gave it the name “Magnetic Switch”. [block:image] { "images": [ { "image": [ "https://files.readme.io/dlgPI15GTViXYAhbdIrK_tmp.jpg", "tmp.jpg", "1400", "960", "#273c4f", "" ] } ] } [/block] [block:callout] { "type": "info", "title": "Friendly names", "body": "We find it useful to give our devices names that we can remember, such as \"Front Door Magnetic Switch\", for a magnetic switch that's on the front door. Then it's easy to work out which devices you want to connect to an app." } [/block] [block:callout] { "type": "warning", "body": "In the current version of the platform, information about apps and adaptors is not sent to the bridge (Raspberry Pi) until the “Update” button in the group of buttons on the bottom-left of the screen is pressed, so press this. This will also cause any new apps and adaptors to be downloaded to the bridge if they are not already installed on it.", "title": "The Update button" } [/block] Now, repeat the “Connect to a Device” and installation process for other devices, remembering to press the “Update” button each time. The figure below shows the display after a mains switch and a “Continuum” Sensortag have been installed [block:image] { "images": [ { "image": [ "https://files.readme.io/jtLPOwcLRGWayOUOsiAL_tmp.jpg", "tmp.jpg", "1403", "959", "#273c4e", "" ] } ] } [/block] [block:callout] { "type": "info", "title": "What are those letters and numbers after Bluetooth device names?", "body": "They're the last 4 digits of the Bluetooth address. In some cases, this can be useful in identifying devices, if you have lots of the same sort of Bluetooth device. If this doesn't apply to you, just ignore them." } [/block] [block:api-header] { "type": "basic", "title": "Connecting devices to apps" } [/block] [block:callout] { "type": "info", "title": "Device permissions", "body": "A key benefit of the ContinuumBridge platform is that you, the user, own and control your devices or appliances and you decide which bridge-apps you want to be able to see them. The permissions are given by connecting devices to apps as described in this section." } [/block] Click on the pencil next to the Demo Switch App. The resulting screen will be similar to that shown below. This shows that all three devices that have been installed can be connected to the app. In the display shown here, two have been connected, but just connect however many you have. Once you have done this, click the "Update" button and then the “Restart” button in the buttons area in the bottom-left of the browser window. You will see various messages in the Bridge Messages window. After the bridge has started, you will be able to either trigger the sensor or press a button on the Sensortag and the mains switch will turn on or off accordingly. [block:image] { "images": [ { "image": [ "https://files.readme.io/Pi4YEYHFTk6uFmsnw3DA_tmp.jpg", "tmp.jpg", "1399", "1011", "#2ca1c3", "" ] } ] } [/block] [block:callout] { "type": "success", "title": "Congratulations", "body": "You've connected devices to an app and got them to do something. This is a very simple example, but even with a few simple devices you can make it do lots more, just by editing the code." } [/block] [block:callout] { "type": "danger", "title": "Things to remember", "body": "This is an alpha version of the ContinuumBridge platform and is intended primarily for developers. Subsequent versions will have a far cleaner user interface, but for now, if things aren't going as you expected, remember:\n\n1. Always press the Update button on the portal when you have made any changes.\n\n2. Most changes won't take effect on the bridge until you have pressed Restart.\n\n3. Installing Z-wave devices can be a pain. See the notes above." } [/block] [To learn how to write a bridge-app ...](doc:writing-an-app-on-the-raspberry-pi)