{"id":26,"date":"2023-05-24T12:35:10","date_gmt":"2023-05-24T16:35:10","guid":{"rendered":"https:\/\/pressbooks.bccampus.ca\/iotplatform\/?post_type=chapter&#038;p=26"},"modified":"2023-09-02T13:07:38","modified_gmt":"2023-09-02T17:07:38","slug":"chapter-2","status":"publish","type":"chapter","link":"https:\/\/pressbooks.bccampus.ca\/iotplatform\/chapter\/chapter-2\/","title":{"raw":"Introduction to TB Platform","rendered":"Introduction to TB Platform"},"content":{"raw":"&nbsp;\r\n<h1><strong><span style=\"color: #3366ff\"> 2.1\u00a0 \u00a0Subscription plans \u00a0<\/span><\/strong><\/h1>\r\n<p style=\"text-align: justify\">In this chapter, we will provide a comprehensive overview of TB. TB is a versatile platform that caters to both personal and commercial needs, supporting a wide range of tasks such as data collection, processing, display, analysis, and device management. Furthermore, TB seamlessly integrates with popular communication protocols, including MQTT. To get started with TB, you'll need to select a subscription plan, each offering distinct features. Essentially, you have the option to install the open-source version of TB locally on your host (Community Edition), or utilize the free cloud version for a one-month trial period. Additionally, various cloud-based subscription plans are available, tailored to suit your specific IoT solution. For a detailed breakdown of features offered in each cloud-based tier, please refer to Table 2.<\/p>\r\n<p style=\"text-align: justify\"><span style=\"color: #3366ff\"><em>Table 2. TB cloud-based subscription plans<\/em><\/span><\/p>\r\n<img class=\"size-full wp-image-152 aligncenter\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9.jpg\" alt=\"\" width=\"755\" height=\"209\" \/>\r\n<p style=\"text-align: justify\">A data point in TB consists of a key-value pair, for example, {\"temperature\": 42, \"humidity\": 60}. Moreover, TB offers the option of white-labeling, allowing you to customize the configuration of your product and dashboard with your own logo. Furthermore, TB provides a pay-as-you-go subscription plan, enabling you to be billed based on your platform consumption. For more detailed information on the features offered in each tier of TB, please visit the official website at https:\/\/thingsboard.io\/pricing\/.<\/p>\r\n<p style=\"text-align: justify\">To start using TB in your project, you need to create an account and familiarize yourself with the different components of the platform. Here are the steps to create a free cloud-based account, known as ThingsBoard Cloud Maker:<\/p>\r\n<p style=\"text-align: justify\">1. Visit the TB registration page at https:\/\/thingsboard.cloud\/signup.<\/p>\r\n<p style=\"text-align: justify\">2. Provide your information, such as a valid Gmail address, during the registration process.<\/p>\r\n<p style=\"text-align: justify\">3. Upon successful registration, you will be redirected to your home page, as shown in Figure 3.<\/p>\r\n\r\n\r\n[caption id=\"attachment_154\" align=\"aligncenter\" width=\"765\"]<img class=\"size-full wp-image-154\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-1.jpg\" alt=\"\" width=\"765\" height=\"361\" \/> <span style=\"color: #3366ff\"><em>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 Figure 3. ThingsBoard Cloud Maker home page<\/em><\/span>[\/caption]\r\n<ul>\r\n \t<li style=\"text-align: justify\">On the left side of the home page, you will find various sections of the TB platform, including Plans and Billing, Rule chains, Integrations, Device groups, Asset groups, Widget library, and Dashboard groups. These sections allow you to access and manage different aspects of the platform.<\/li>\r\n \t<li style=\"text-align: justify\">In the body of the home page, there are quick links that provide convenient access to different parts of the platform. Additionally, Solution templates offer prebuilt IoT projects that you can explore and utilize for your own projects.<\/li>\r\n \t<li style=\"text-align: justify\">Your account information can be accessed from the top right corner of the home page, providing a quick way to view and manage your account settings.<\/li>\r\n<\/ul>\r\n<p style=\"text-align: justify\">To make the most of TB in your custom IoT projects, you need to define your devices within the platform. Additionally, you can add dashboard aliases in TB and place custom widgets on the dashboard to visualize and interact with your data. While other parts of the platform, such as Rule chains, are important, their detailed discussion exceeds the scope of this book.<\/p>\r\n\r\n<h1 style=\"text-align: justify\"><strong><span style=\"color: #3366ff\">2.2\u00a0 \u00a0Getting started with TB \u00a0<\/span><\/strong><\/h1>\r\n<p style=\"text-align: justify\">After logging in to TB, it is important to familiarize yourself with the essential steps of the platform. Here is a breakdown of the device group section:<\/p>\r\n<p style=\"text-align: justify\">4. Adding device groups:<\/p>\r\n\r\n<ul style=\"text-align: justify\">\r\n \t<li style=\"text-align: justify\">To quickly add a custom group of devices, such as sensors, actuators, and switches, you can use the \"+\" icon located in the upper right corner, as shown in Figure 4. However, TB also provides a pre-defined group called \"All\" that includes all devices.<\/li>\r\n \t<li style=\"text-align: justify\">When you click on the \"+\" icon, TB will prompt you to enter the name of the device group and provide a description. In Figure 4, we create a group named \"test\" with the description \"A sample device group\".<\/li>\r\n<\/ul>\r\n<p style=\"text-align: justify\">5. Managing device group details:<\/p>\r\n\r\n<ul style=\"text-align: justify\">\r\n \t<li style=\"text-align: justify\">Once you have added a device group, you can access its details by clicking on the edit button (represented by \"<img class=\"alignnone wp-image-311\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/Figure-25.-Installing-MQTT-package-2.jpg\" alt=\"\" width=\"18\" height=\"16\" \/>\"). This allows you to perform various actions, such as managing device credentials, deleting devices from the group, and copying the group token and access password.<\/li>\r\n<\/ul>\r\n[caption id=\"attachment_157\" align=\"aligncenter\" width=\"972\"]<img class=\"wp-image-157 size-full\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-2.jpg\" alt=\"\" width=\"972\" height=\"314\" \/> <span style=\"color: #3366ff\"><em>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0Figure 4. Adding device groups and managing its details<\/em><\/span>[\/caption]\r\n<p style=\"text-align: justify\">6. To define your custom device within the device group, in the device group section, click on the \"+\" icon located at the top right to add your device. For example, you can name your device \"temperature\".<\/p>\r\n\r\n\r\n[caption id=\"attachment_161\" align=\"aligncenter\" width=\"788\"]<img class=\"size-full wp-image-161\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-3.jpg\" alt=\"\" width=\"788\" height=\"367\" \/> <span style=\"color: #3366ff\"><em>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 Figure 5. Adding your device<\/em><\/span>[\/caption]\r\n<p style=\"text-align: justify\">7. To access important information related to your device, click on the \"<img class=\"alignnone wp-image-310\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/Figure-27.-Latest-telemetry-of-data-published-by-RPI-1.gif\" alt=\"\" width=\"18\" height=\"19\" \/>\" button, typically represented by an edit or settings icon. By doing so, you will be able to access the device ID or token. This token can be used as the device ID in your IoT projects.<\/p>\r\n\r\n\r\n[caption id=\"attachment_167\" align=\"aligncenter\" width=\"837\"]<img class=\"size-full wp-image-167\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-4.jpg\" alt=\"\" width=\"837\" height=\"388\" \/> <span style=\"color: #3366ff\"><em>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0Figure 6. Accessing device token and its telemetry data<\/em><\/span>[\/caption]\r\n<p style=\"text-align: justify\">8. To visualize your telemetry data in TB, you need to add dashboard groups. Start by adding dashboard groups in TB. Similar to the device group, define a name for your group and provide a description. This can be done by clicking on the appropriate button or option within the platform. Utilize the predefined group name \"All\" in your project, if it suits your requirements. This group allows you to easily include all relevant devices in your telemetry visualization.<\/p>\r\n\r\n\r\n[caption id=\"attachment_174\" align=\"aligncenter\" width=\"996\"]<img class=\"size-full wp-image-174\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-5.jpg\" alt=\"\" width=\"996\" height=\"273\" \/> <em><span style=\"color: #3366ff\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0Figure 7. Definition dashboard group<\/span><\/em>[\/caption]\r\n<p style=\"text-align: justify\">9. By clicking on the group name, a pop-up window will appear containing the details of the group. Within this window, you can click the \"Open entity group\" button, which will direct you to a dedicated page for adding dashboards. On this page, you can easily define and create your custom dashboard by clicking the \"+\" button. For example, you can name it \"Temperature Sensors\". This streamlined process enables you to efficiently organize and visualize specific data within your chosen group.<\/p>\r\n\r\n\r\n[caption id=\"attachment_177\" align=\"aligncenter\" width=\"816\"]<img class=\"size-full wp-image-177\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-6.jpg\" alt=\"\" width=\"816\" height=\"369\" \/> <span style=\"color: #3366ff\"><em>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0Figure 8. Adding the dashboard<\/em><\/span>[\/caption]\r\n<p style=\"text-align: justify\">10. When you click on the title of your dashboard, it will open the dedicated page where you can add widgets and visualize telemetry data. To add widgets and configure your dashboard, you need to toggle it into editing mode. This can be easily accomplished by clicking on the edit icon, represented by \"<img class=\"alignnone wp-image-309\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/Figure-25.-Installing-MQTT-package-1.jpg\" alt=\"\" width=\"18\" height=\"18\" \/>\", located at the bottom right corner of the page. By enabling the editing mode, you gain the ability to add widgets and make necessary configurations to customize your dashboard according to your preferences.<\/p>\r\n\r\n\r\n[caption id=\"attachment_183\" align=\"aligncenter\" width=\"991\"]<img class=\"size-full wp-image-183\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-7.jpg\" alt=\"\" width=\"991\" height=\"255\" \/> <span style=\"color: #3366ff\"><em>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0Figure 9. Main page of the dashboard<\/em><\/span>[\/caption]\r\n<p style=\"text-align: justify\">11. After entering the editing mode for your dashboard, click on the \"<img class=\"alignnone wp-image-304\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/Figure-28.-Adding-thermometer-gauge-right-and-radial-gauge-left.jpg\" alt=\"\" width=\"19\" height=\"16\" \/>\" button located at the top right corner. This will open a window where you can enter the alias name and specify its type. By defining the \"temperature\" device, you can include it in the device section of your alias. This alias serves as a reference to a specific type of device or entity that can be used within widgets on your dashboard, allowing you to effectively visualize and interact with the associated data.<\/p>\r\n\r\n\r\n[caption id=\"attachment_191\" align=\"aligncenter\" width=\"870\"]<img class=\"size-full wp-image-191\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-8.jpg\" alt=\"\" width=\"870\" height=\"282\" \/> <span style=\"color: #3366ff\"><em>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 Figure 10. Adding alias<\/em><\/span>[\/caption]\r\n<p style=\"text-align: justify\">12. To add custom widgets to your dashboard, simply click on the central box or use the \"<img class=\"alignnone wp-image-303\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/Figure-27.-Latest-telemetry-of-data-published-by-RPI.gif\" alt=\"\" width=\"18\" height=\"19\" \/>\" and then \"<img class=\"alignnone wp-image-302\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/Figure-25.-Installing-MQTT-package.jpg\" alt=\"\" width=\"18\" height=\"18\" \/>\" buttons. This will open a categorized list of available widgets. You can browse through the options and select the desired widget for your dashboard. If you need more information about the widgets, you can visit the TB website's user guide section on the widget library at https:\/\/thingsboard.io\/docs\/user-guide\/ui\/widget-library. This resource provides detailed insights into the functionality and usage of each widget, allowing you to enhance your dashboard with the appropriate visualization and interaction elements.<\/p>\r\n\r\n\r\n[caption id=\"attachment_194\" align=\"aligncenter\" width=\"1001\"]<img class=\"size-full wp-image-194\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-9.jpg\" alt=\"\" width=\"1001\" height=\"484\" \/> <span style=\"color: #3366ff\"><em>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0Figure 11. Widgets<\/em><\/span>[\/caption]\r\n<p style=\"text-align: justify\">13. In order to add a widget to your dashboard, you can select one from the available options and configure it by entering the entity alias along with other required parameters. Please note that the \"latest data key\" parameter has not been set at this point. This parameter refers to the name of the variable that is published from the device. The process of setting the \"latest data key\" will be explained in the final chapter, providing you with the necessary information to configure it appropriately.<\/p>\r\n\r\n\r\n[caption id=\"attachment_199\" align=\"aligncenter\" width=\"619\"]<img class=\"size-full wp-image-199\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-10.jpg\" alt=\"\" width=\"619\" height=\"297\" \/> <span style=\"color: #3366ff\"><em>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0Figure 12. Adding a sample widget<\/em><\/span>[\/caption]\r\n<p style=\"text-align: justify\">14. To ensure that your widget is successfully added and all changes are applied correctly, it is important to click the \"Apply changes\" button (<img class=\"alignnone wp-image-299\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/Figure-24.-Checking-the-python3-pip-version.jpg\" alt=\"\" width=\"18\" height=\"17\" \/>) located in the bottom-right corner of the dashboard page.<\/p>\r\n<p style=\"text-align: justify\">TB offers a wide range of features, including the ability to set alarms via SMS, email, or phone. Although discussing these features is beyond the scope of this chapter, readers can visit the TB website for more comprehensive documentation.<\/p>\r\n&nbsp;","rendered":"<p>&nbsp;<\/p>\n<h1><strong><span style=\"color: #3366ff\"> 2.1\u00a0 \u00a0Subscription plans \u00a0<\/span><\/strong><\/h1>\n<p style=\"text-align: justify\">In this chapter, we will provide a comprehensive overview of TB. TB is a versatile platform that caters to both personal and commercial needs, supporting a wide range of tasks such as data collection, processing, display, analysis, and device management. Furthermore, TB seamlessly integrates with popular communication protocols, including MQTT. To get started with TB, you&#8217;ll need to select a subscription plan, each offering distinct features. Essentially, you have the option to install the open-source version of TB locally on your host (Community Edition), or utilize the free cloud version for a one-month trial period. Additionally, various cloud-based subscription plans are available, tailored to suit your specific IoT solution. For a detailed breakdown of features offered in each cloud-based tier, please refer to Table 2.<\/p>\n<p style=\"text-align: justify\"><span style=\"color: #3366ff\"><em>Table 2. TB cloud-based subscription plans<\/em><\/span><\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-152 aligncenter\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9.jpg\" alt=\"\" width=\"755\" height=\"209\" srcset=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9.jpg 755w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-300x83.jpg 300w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-65x18.jpg 65w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-225x62.jpg 225w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-350x97.jpg 350w\" sizes=\"auto, (max-width: 755px) 100vw, 755px\" \/><\/p>\n<p style=\"text-align: justify\">A data point in TB consists of a key-value pair, for example, {&#8220;temperature&#8221;: 42, &#8220;humidity&#8221;: 60}. Moreover, TB offers the option of white-labeling, allowing you to customize the configuration of your product and dashboard with your own logo. Furthermore, TB provides a pay-as-you-go subscription plan, enabling you to be billed based on your platform consumption. For more detailed information on the features offered in each tier of TB, please visit the official website at https:\/\/thingsboard.io\/pricing\/.<\/p>\n<p style=\"text-align: justify\">To start using TB in your project, you need to create an account and familiarize yourself with the different components of the platform. Here are the steps to create a free cloud-based account, known as ThingsBoard Cloud Maker:<\/p>\n<p style=\"text-align: justify\">1. Visit the TB registration page at https:\/\/thingsboard.cloud\/signup.<\/p>\n<p style=\"text-align: justify\">2. Provide your information, such as a valid Gmail address, during the registration process.<\/p>\n<p style=\"text-align: justify\">3. Upon successful registration, you will be redirected to your home page, as shown in Figure 3.<\/p>\n<figure id=\"attachment_154\" aria-describedby=\"caption-attachment-154\" style=\"width: 765px\" class=\"wp-caption aligncenter\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-154\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-1.jpg\" alt=\"\" width=\"765\" height=\"361\" srcset=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-1.jpg 765w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-1-300x142.jpg 300w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-1-65x31.jpg 65w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-1-225x106.jpg 225w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-1-350x165.jpg 350w\" sizes=\"auto, (max-width: 765px) 100vw, 765px\" \/><figcaption id=\"caption-attachment-154\" class=\"wp-caption-text\"><span style=\"color: #3366ff\"><em>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 Figure 3. ThingsBoard Cloud Maker home page<\/em><\/span><\/figcaption><\/figure>\n<ul>\n<li style=\"text-align: justify\">On the left side of the home page, you will find various sections of the TB platform, including Plans and Billing, Rule chains, Integrations, Device groups, Asset groups, Widget library, and Dashboard groups. These sections allow you to access and manage different aspects of the platform.<\/li>\n<li style=\"text-align: justify\">In the body of the home page, there are quick links that provide convenient access to different parts of the platform. Additionally, Solution templates offer prebuilt IoT projects that you can explore and utilize for your own projects.<\/li>\n<li style=\"text-align: justify\">Your account information can be accessed from the top right corner of the home page, providing a quick way to view and manage your account settings.<\/li>\n<\/ul>\n<p style=\"text-align: justify\">To make the most of TB in your custom IoT projects, you need to define your devices within the platform. Additionally, you can add dashboard aliases in TB and place custom widgets on the dashboard to visualize and interact with your data. While other parts of the platform, such as Rule chains, are important, their detailed discussion exceeds the scope of this book.<\/p>\n<h1 style=\"text-align: justify\"><strong><span style=\"color: #3366ff\">2.2\u00a0 \u00a0Getting started with TB \u00a0<\/span><\/strong><\/h1>\n<p style=\"text-align: justify\">After logging in to TB, it is important to familiarize yourself with the essential steps of the platform. Here is a breakdown of the device group section:<\/p>\n<p style=\"text-align: justify\">4. Adding device groups:<\/p>\n<ul style=\"text-align: justify\">\n<li style=\"text-align: justify\">To quickly add a custom group of devices, such as sensors, actuators, and switches, you can use the &#8220;+&#8221; icon located in the upper right corner, as shown in Figure 4. However, TB also provides a pre-defined group called &#8220;All&#8221; that includes all devices.<\/li>\n<li style=\"text-align: justify\">When you click on the &#8220;+&#8221; icon, TB will prompt you to enter the name of the device group and provide a description. In Figure 4, we create a group named &#8220;test&#8221; with the description &#8220;A sample device group&#8221;.<\/li>\n<\/ul>\n<p style=\"text-align: justify\">5. Managing device group details:<\/p>\n<ul style=\"text-align: justify\">\n<li style=\"text-align: justify\">Once you have added a device group, you can access its details by clicking on the edit button (represented by &#8220;<img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-311\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/Figure-25.-Installing-MQTT-package-2.jpg\" alt=\"\" width=\"18\" height=\"16\" \/>&#8220;). This allows you to perform various actions, such as managing device credentials, deleting devices from the group, and copying the group token and access password.<\/li>\n<\/ul>\n<figure id=\"attachment_157\" aria-describedby=\"caption-attachment-157\" style=\"width: 972px\" class=\"wp-caption aligncenter\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-157 size-full\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-2.jpg\" alt=\"\" width=\"972\" height=\"314\" srcset=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-2.jpg 972w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-2-300x97.jpg 300w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-2-768x248.jpg 768w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-2-65x21.jpg 65w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-2-225x73.jpg 225w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-2-350x113.jpg 350w\" sizes=\"auto, (max-width: 972px) 100vw, 972px\" \/><figcaption id=\"caption-attachment-157\" class=\"wp-caption-text\"><span style=\"color: #3366ff\"><em>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0Figure 4. Adding device groups and managing its details<\/em><\/span><\/figcaption><\/figure>\n<p style=\"text-align: justify\">6. To define your custom device within the device group, in the device group section, click on the &#8220;+&#8221; icon located at the top right to add your device. For example, you can name your device &#8220;temperature&#8221;.<\/p>\n<figure id=\"attachment_161\" aria-describedby=\"caption-attachment-161\" style=\"width: 788px\" class=\"wp-caption aligncenter\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-161\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-3.jpg\" alt=\"\" width=\"788\" height=\"367\" srcset=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-3.jpg 788w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-3-300x140.jpg 300w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-3-768x358.jpg 768w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-3-65x30.jpg 65w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-3-225x105.jpg 225w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-3-350x163.jpg 350w\" sizes=\"auto, (max-width: 788px) 100vw, 788px\" \/><figcaption id=\"caption-attachment-161\" class=\"wp-caption-text\"><span style=\"color: #3366ff\"><em>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 Figure 5. Adding your device<\/em><\/span><\/figcaption><\/figure>\n<p style=\"text-align: justify\">7. To access important information related to your device, click on the &#8220;<img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-310\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/Figure-27.-Latest-telemetry-of-data-published-by-RPI-1.gif\" alt=\"\" width=\"18\" height=\"19\" \/>&#8221; button, typically represented by an edit or settings icon. By doing so, you will be able to access the device ID or token. This token can be used as the device ID in your IoT projects.<\/p>\n<figure id=\"attachment_167\" aria-describedby=\"caption-attachment-167\" style=\"width: 837px\" class=\"wp-caption aligncenter\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-167\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-4.jpg\" alt=\"\" width=\"837\" height=\"388\" srcset=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-4.jpg 837w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-4-300x139.jpg 300w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-4-768x356.jpg 768w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-4-65x30.jpg 65w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-4-225x104.jpg 225w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-4-350x162.jpg 350w\" sizes=\"auto, (max-width: 837px) 100vw, 837px\" \/><figcaption id=\"caption-attachment-167\" class=\"wp-caption-text\"><span style=\"color: #3366ff\"><em>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0Figure 6. Accessing device token and its telemetry data<\/em><\/span><\/figcaption><\/figure>\n<p style=\"text-align: justify\">8. To visualize your telemetry data in TB, you need to add dashboard groups. Start by adding dashboard groups in TB. Similar to the device group, define a name for your group and provide a description. This can be done by clicking on the appropriate button or option within the platform. Utilize the predefined group name &#8220;All&#8221; in your project, if it suits your requirements. This group allows you to easily include all relevant devices in your telemetry visualization.<\/p>\n<figure id=\"attachment_174\" aria-describedby=\"caption-attachment-174\" style=\"width: 996px\" class=\"wp-caption aligncenter\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-174\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-5.jpg\" alt=\"\" width=\"996\" height=\"273\" srcset=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-5.jpg 996w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-5-300x82.jpg 300w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-5-768x211.jpg 768w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-5-65x18.jpg 65w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-5-225x62.jpg 225w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-5-350x96.jpg 350w\" sizes=\"auto, (max-width: 996px) 100vw, 996px\" \/><figcaption id=\"caption-attachment-174\" class=\"wp-caption-text\"><em><span style=\"color: #3366ff\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0Figure 7. Definition dashboard group<\/span><\/em><\/figcaption><\/figure>\n<p style=\"text-align: justify\">9. By clicking on the group name, a pop-up window will appear containing the details of the group. Within this window, you can click the &#8220;Open entity group&#8221; button, which will direct you to a dedicated page for adding dashboards. On this page, you can easily define and create your custom dashboard by clicking the &#8220;+&#8221; button. For example, you can name it &#8220;Temperature Sensors&#8221;. This streamlined process enables you to efficiently organize and visualize specific data within your chosen group.<\/p>\n<figure id=\"attachment_177\" aria-describedby=\"caption-attachment-177\" style=\"width: 816px\" class=\"wp-caption aligncenter\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-177\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-6.jpg\" alt=\"\" width=\"816\" height=\"369\" srcset=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-6.jpg 816w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-6-300x136.jpg 300w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-6-768x347.jpg 768w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-6-65x29.jpg 65w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-6-225x102.jpg 225w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-6-350x158.jpg 350w\" sizes=\"auto, (max-width: 816px) 100vw, 816px\" \/><figcaption id=\"caption-attachment-177\" class=\"wp-caption-text\"><span style=\"color: #3366ff\"><em>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0Figure 8. Adding the dashboard<\/em><\/span><\/figcaption><\/figure>\n<p style=\"text-align: justify\">10. When you click on the title of your dashboard, it will open the dedicated page where you can add widgets and visualize telemetry data. To add widgets and configure your dashboard, you need to toggle it into editing mode. This can be easily accomplished by clicking on the edit icon, represented by &#8220;<img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-309\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/Figure-25.-Installing-MQTT-package-1.jpg\" alt=\"\" width=\"18\" height=\"18\" \/>&#8220;, located at the bottom right corner of the page. By enabling the editing mode, you gain the ability to add widgets and make necessary configurations to customize your dashboard according to your preferences.<\/p>\n<figure id=\"attachment_183\" aria-describedby=\"caption-attachment-183\" style=\"width: 991px\" class=\"wp-caption aligncenter\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-183\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-7.jpg\" alt=\"\" width=\"991\" height=\"255\" srcset=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-7.jpg 991w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-7-300x77.jpg 300w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-7-768x198.jpg 768w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-7-65x17.jpg 65w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-7-225x58.jpg 225w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-7-350x90.jpg 350w\" sizes=\"auto, (max-width: 991px) 100vw, 991px\" \/><figcaption id=\"caption-attachment-183\" class=\"wp-caption-text\"><span style=\"color: #3366ff\"><em>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0Figure 9. Main page of the dashboard<\/em><\/span><\/figcaption><\/figure>\n<p style=\"text-align: justify\">11. After entering the editing mode for your dashboard, click on the &#8220;<img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-304\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/Figure-28.-Adding-thermometer-gauge-right-and-radial-gauge-left.jpg\" alt=\"\" width=\"19\" height=\"16\" \/>&#8221; button located at the top right corner. This will open a window where you can enter the alias name and specify its type. By defining the &#8220;temperature&#8221; device, you can include it in the device section of your alias. This alias serves as a reference to a specific type of device or entity that can be used within widgets on your dashboard, allowing you to effectively visualize and interact with the associated data.<\/p>\n<figure id=\"attachment_191\" aria-describedby=\"caption-attachment-191\" style=\"width: 870px\" class=\"wp-caption aligncenter\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-191\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-8.jpg\" alt=\"\" width=\"870\" height=\"282\" srcset=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-8.jpg 870w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-8-300x97.jpg 300w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-8-768x249.jpg 768w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-8-65x21.jpg 65w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-8-225x73.jpg 225w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-8-350x113.jpg 350w\" sizes=\"auto, (max-width: 870px) 100vw, 870px\" \/><figcaption id=\"caption-attachment-191\" class=\"wp-caption-text\"><span style=\"color: #3366ff\"><em>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 Figure 10. Adding alias<\/em><\/span><\/figcaption><\/figure>\n<p style=\"text-align: justify\">12. To add custom widgets to your dashboard, simply click on the central box or use the &#8220;<img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-303\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/Figure-27.-Latest-telemetry-of-data-published-by-RPI.gif\" alt=\"\" width=\"18\" height=\"19\" srcset=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/Figure-27.-Latest-telemetry-of-data-published-by-RPI.gif 70w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/Figure-27.-Latest-telemetry-of-data-published-by-RPI-65x70.gif 65w\" sizes=\"auto, (max-width: 18px) 100vw, 18px\" \/>&#8221; and then &#8220;<img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-302\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/Figure-25.-Installing-MQTT-package.jpg\" alt=\"\" width=\"18\" height=\"18\" \/>&#8221; buttons. This will open a categorized list of available widgets. You can browse through the options and select the desired widget for your dashboard. If you need more information about the widgets, you can visit the TB website&#8217;s user guide section on the widget library at https:\/\/thingsboard.io\/docs\/user-guide\/ui\/widget-library. This resource provides detailed insights into the functionality and usage of each widget, allowing you to enhance your dashboard with the appropriate visualization and interaction elements.<\/p>\n<figure id=\"attachment_194\" aria-describedby=\"caption-attachment-194\" style=\"width: 1001px\" class=\"wp-caption aligncenter\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-194\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-9.jpg\" alt=\"\" width=\"1001\" height=\"484\" srcset=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-9.jpg 1001w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-9-300x145.jpg 300w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-9-768x371.jpg 768w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-9-65x31.jpg 65w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-9-225x109.jpg 225w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-9-350x169.jpg 350w\" sizes=\"auto, (max-width: 1001px) 100vw, 1001px\" \/><figcaption id=\"caption-attachment-194\" class=\"wp-caption-text\"><span style=\"color: #3366ff\"><em>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0Figure 11. Widgets<\/em><\/span><\/figcaption><\/figure>\n<p style=\"text-align: justify\">13. In order to add a widget to your dashboard, you can select one from the available options and configure it by entering the entity alias along with other required parameters. Please note that the &#8220;latest data key&#8221; parameter has not been set at this point. This parameter refers to the name of the variable that is published from the device. The process of setting the &#8220;latest data key&#8221; will be explained in the final chapter, providing you with the necessary information to configure it appropriately.<\/p>\n<figure id=\"attachment_199\" aria-describedby=\"caption-attachment-199\" style=\"width: 619px\" class=\"wp-caption aligncenter\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-199\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-10.jpg\" alt=\"\" width=\"619\" height=\"297\" srcset=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-10.jpg 619w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-10-300x144.jpg 300w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-10-65x31.jpg 65w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-10-225x108.jpg 225w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/\u0633\u06cc\u0645-\u06a9\u0627\u0648\u0647-\u062a\u06a9-10-350x168.jpg 350w\" sizes=\"auto, (max-width: 619px) 100vw, 619px\" \/><figcaption id=\"caption-attachment-199\" class=\"wp-caption-text\"><span style=\"color: #3366ff\"><em>\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0Figure 12. Adding a sample widget<\/em><\/span><\/figcaption><\/figure>\n<p style=\"text-align: justify\">14. To ensure that your widget is successfully added and all changes are applied correctly, it is important to click the &#8220;Apply changes&#8221; button (<img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-299\" src=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/Figure-24.-Checking-the-python3-pip-version.jpg\" alt=\"\" width=\"18\" height=\"17\" srcset=\"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/Figure-24.-Checking-the-python3-pip-version.jpg 81w, https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-content\/uploads\/sites\/1962\/2023\/05\/Figure-24.-Checking-the-python3-pip-version-65x62.jpg 65w\" sizes=\"auto, (max-width: 18px) 100vw, 18px\" \/>) located in the bottom-right corner of the dashboard page.<\/p>\n<p style=\"text-align: justify\">TB offers a wide range of features, including the ability to set alarms via SMS, email, or phone. Although discussing these features is beyond the scope of this chapter, readers can visit the TB website for more comprehensive documentation.<\/p>\n<p>&nbsp;<\/p>\n","protected":false},"author":1053,"menu_order":2,"template":"","meta":{"pb_show_title":"on","pb_short_title":"","pb_subtitle":"","pb_authors":[],"pb_section_license":""},"chapter-type":[],"contributor":[],"license":[],"class_list":["post-26","chapter","type-chapter","status-publish","hentry"],"part":3,"_links":{"self":[{"href":"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-json\/pressbooks\/v2\/chapters\/26","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-json\/pressbooks\/v2\/chapters"}],"about":[{"href":"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-json\/wp\/v2\/types\/chapter"}],"author":[{"embeddable":true,"href":"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-json\/wp\/v2\/users\/1053"}],"version-history":[{"count":25,"href":"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-json\/pressbooks\/v2\/chapters\/26\/revisions"}],"predecessor-version":[{"id":510,"href":"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-json\/pressbooks\/v2\/chapters\/26\/revisions\/510"}],"part":[{"href":"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-json\/pressbooks\/v2\/parts\/3"}],"metadata":[{"href":"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-json\/pressbooks\/v2\/chapters\/26\/metadata\/"}],"wp:attachment":[{"href":"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-json\/wp\/v2\/media?parent=26"}],"wp:term":[{"taxonomy":"chapter-type","embeddable":true,"href":"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-json\/pressbooks\/v2\/chapter-type?post=26"},{"taxonomy":"contributor","embeddable":true,"href":"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-json\/wp\/v2\/contributor?post=26"},{"taxonomy":"license","embeddable":true,"href":"https:\/\/pressbooks.bccampus.ca\/iotplatform\/wp-json\/wp\/v2\/license?post=26"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}