_________________________________________________________www.btwtag.com User Manual Ver. 2.
_________________________________________________________www.btwtag.com This product complies with FCC radiation exposure limits set forth for an uncontrolled environment Pursuant to FCC 15.21 of the FCC rules, changes not expressly approved by btwTAG Safety, LLC. might cause harmful interference and void the FCC authorization to operate this product. This device complies with part 15 of the FCC Rules.
_________________________________________________________www.btwtag.com Contents Description .............................................................................................................................................. 5 Getting Started ........................................................................................................................................ 6 Signing in ...........................................................................................................
_________________________________________________________www.btwtag.com Contact ................................................................................................................................................. 43 Appendix I: APIs For OEM Platforms ...................................................................................................... 44 Defining the Structure .......................................................................................................................
_________________________________________________________www.btwtag.com Description • • • • • Ver. 2.0 The btwTAG (back-to-work tag) is a Confidential Workplace Contact Tracer and Social Distancing Reminder application. The device is equipped with a low power, high sensitivity transceiver that can detect messages from other sensors of the same type and estimate the distance between the sensors themselves with up to 20 cm (8 in.) of location accuracy.
_________________________________________________________www.btwtag.com Getting Started Welcome “back to work”! Signing in Point your browser to www.btwTAG.com and click on the Sign In icon. A Dialog box will appear. Enter your email and password confirmed during the registration process. Ver. 2.
_________________________________________________________www.btwtag.com Menu Dashboard The btwTAG Dashboard is designed to provide the end user with easy access to data and the tools with which to manage both the data and the devices themselves. At the top of the dashboard there are: • • • The Company Token Number of employees in system Free licenses (licenses yet to be paired with employees; the number will go down to zero) The left sidebar shows the links to the contact data and devices.
_________________________________________________________www.btwtag.com The profile also contains important information for access to your system using tokens. This includes: • • • Company Token: The Company Token is used to configure a btwTAG API Token: The API Token is used to access the Middleware References Security Token: The Security Token is used to access the personal data on a separate secure server How to get your company token: Ver. 2.
_________________________________________________________www.btwtag.com Today Balance The first data display is Today Balance. It indicates the tally of contact events for the day and a six-day average. The display also shows how many active tags were generating the data. Active Tags There are two types of active tags. First, all tags that are paired with an employee. Second, all tags that are not paired but act as beacons. Man Tags are all paired tags, and Area and Gate tags are all beacons.
_________________________________________________________www.btwtag.com Contacts Metrics The Contacts Metrics contain the last 14 days of data and is segmented by three time durations: less than 2 minutes; more than 2, but less than 5; more than 5. Contact Metrics is a critical indicator: longer the contact, less healthy the situation. The goal is to keep contact events from happening, but when they happen, they become more serious with longer the time duration.
_________________________________________________________www.btwtag.com Real Time Gates Real Time Gates. All Active Gate tags will be displayed here. Like Area tags, the color of the number will change depending on the thresholds set by the Admin. Ver. 2.
_________________________________________________________www.btwtag.com Last Activities An administrative aid to track recent admin activities such as the issuing of licenses. Latest Contact Events The Latest Contact Events is a limited functioning spreadsheet that allows a ranking by the five fields: Origin, Target, Target Type, Duration, When. Click at the top of the column to activate the ranking. TIP: Click at the top of the column to activate the ranking.
_________________________________________________________www.btwtag.com Below that is the display for All Contact Events. These are the content event data: • • • • • The device ID number The IDs of the devices that were within 6 feet of the tag The tag type The duration of the encounter The time of the encounter In addition to the ranking function at the top of the columns, there is a search field. Ver. 2.
_________________________________________________________www.btwtag.com Contact Tracing Clicking on the Contact Tracing link on the left sidebar brings you to the page where the end user can have access to names and surnames associated with the tags. With just the device hardware ID, the end user can view up to three levels of contact at the same time. Ver. 2.
_________________________________________________________www.btwtag.com People Man-Tags Clicking on the Man-Tags link on the left sidebar brings you to the page where All Man Tags are displayed. This is also where the configuration of the Man-Tags for each employee occurs. The top of the page displays the total number of devices, those that are user assigned, and available licenses. Below that is the link to open the dialog box for Massive Configuration.
_________________________________________________________www.btwtag.com All Man Tags are displayed in a searchable database with column ranking. The data displayed includes: • • • • • Hardware ID User State Group Battery Level (e.g.: 5 days life with once-a-day data upload) Updated At Device Configuration The All Man Tags table also has the details for each hardware device which can be found by clicking on the Details button shown below. This opens the device’s hardware information. Ver. 2.
_________________________________________________________www.btwtag.com The All Man Tags also has the link to open a dialog box for device configuration shown below. The Config Dialog allows configuration resets of the device parameters: • • • • • • Ver. 2.0 Wi-Fi network (network ID and password) Cloud Synch Time (10-720 minutes – can be modified) Ranging Type (medium = 1 meter/high = 1.
_________________________________________________________www.btwtag.com Note: The device will automatically perform an upload when the maximum 70 contact event limit is reached. There are four columns: Parameters, Actual Value, Next Connection Changes, Set Config. • • • • Parameters: Six parameters and an off/reset option. The Actual Value is the current live setting of the device.
_________________________________________________________www.btwtag.com This is followed with the confirmation. The configuration will change at the next Wi-Fi update, or the user can lay the tag on a flat surface in a horizontal position and the tag will enter the sleep mode. When the tag is picked up, it will connect with the Wi-Fi and assume the new configuration. Massive Configuration There is also a Massive Configuration dialog box accessible from the Man-Tags page mentioned above.
_________________________________________________________www.btwtag.com The link opens a configuration dialog box that is essentially identical to the configuration dialog described above for single tags. The difference is that the changes potentially apply to all devices. Click Save after the changes for the confirmation step. Ver. 2.
_________________________________________________________www.btwtag.com This is followed with the confirmation. The configuration will change at the next Wi-Fi update, or the user can lay the tag on a flat surface in a horizontal position and the tag will enter the sleep mode. When the tag is picked up, it will connect with the Wi-Fi and assume the new configuration. Creating a Group Select this first tag to be part of a group and click on Config. Ver. 2.
_________________________________________________________www.btwtag.com This will open the Config dialog box. Scroll down to the tag type and click on Prog. The tag will turn into a programmer. Configure the device according to the requirement. Then the programmer card will be able to broadcast the new configuration to the other tags. The tags themselves will be reconfigured either when the tag uploads to the Wi-Fi, or when the tag is laid flat and allowed to reset (about 5 seconds) through sleep mode.
_________________________________________________________www.btwtag.com Employees Clicking on the Employees link on the left sidebar brings you to the page where employees can be added to the system and where all employees in the system are listed in a searchable data display. The top of the page features current data for Total Registered Employees, Paired Employees, Unpaired Employees. Below that is the dialog box to Add Employee to the system.
_________________________________________________________www.btwtag.com Scroll down the page and there is a data display for All Employees. Click of the Stats icon to see the contact statistics for the device: Ver. 2.
_________________________________________________________www.btwtag.com There will also be an unpairing function (TBA) that will allow the end-user to “unpair” the device from the employee or between visitors. Ver. 2.
_________________________________________________________www.btwtag.com Environment Areas Areas can be tracked with a fixed device configured as an Area Tag. The dashboard shows total area tags, those tags with settings, and total attendance in the area. All Area Tags on the dashboard is the searchable database for Area Tags. Each Area Tag has a 6 to 8-meter radius. To configure, you go to the Man Tag page in the dashboard to configure the tag for Areas and Gates. All tags arrive on the system as Man Tag.
_________________________________________________________www.btwtag.com Click on the icon. This will open the Area Settings dialog box. Use this dialog box to set area parameters for an Area Tag. The area limit can be set for the presence of Man Tags to a maximum of 16 per Area Tag. An email alarm trigger is also available for when the limits are exceeded.
_________________________________________________________www.btwtag.com Click on this icon Click on this icon to open the device hardware ID. to view statistics for the area covered by this tag. Scroll down to view the tags present in the area in real time. Ver. 2.
_________________________________________________________www.btwtag.com Click on this icon to view the device configuration dialog box. Gates Passages and egress/ingress areas can be tracked with a fixed device configured as a Gate Tag. The dashboard shows total gate tags, those tags with settings, and total attendance in the area. All Area Tags on the dashboard is the searchable database for Area Tags. Each Area Tag has a 6 to 8-meter radius.
_________________________________________________________www.btwtag.com There is the Massive Configuration send button. All Gates Tags is the searchable database for gate tags. Click on this icon Ver. 2.0 to view statistics.
_________________________________________________________www.btwtag.com Click on this icon Ver. 2.0 to view or change Gate Settings.
_________________________________________________________www.btwtag.com btwTAG Configuration Single btwTAGs General properties and features of the tags: Specs here? 3 color LED light Green rapid flashing: battery charging Green constant: battery fully charged Green flashing every 10 seconds when worn: device in operation Red rapid flashing: Alarm and contact Blue rapid flashing: Searching for network; configuration change When device is laid flat, after 10 seconds, the device will go into sleep mode.
_________________________________________________________www.btwtag.com Here are the steps to configuring a single btwTAG: • • • • • • Ver. 2.0 Connect the btwTAG to the power supply Open a PC with Wi-Fi and connect to the btwTAGXXXX network Open a browser and point to 192.168.0.
_________________________________________________________www.btwtag.com Ver. 2.
_________________________________________________________www.btwtag.com Ver. 2.
_________________________________________________________www.btwtag.com Ver. 2.
_________________________________________________________www.btwtag.com Ver. 2.
_________________________________________________________www.btwtag.com Ver. 2.
_________________________________________________________www.btwtag.com btwTAG Ver. 2.
_________________________________________________________www.btwtag.com Multiple btwTAGs Here are the steps to configuring multiple btwTAGs: • • • • • • • Ver. 2.0 Set up a btwTAG only as per previous instructions Reopen the configuration web page and go down to the "Advanced Configuration" section Select the "Tag Type" drop-down and select "Programmer" and press "Save". The Led Tag will start blinking fast and continuously.
_________________________________________________________www.btwtag.com Programmer Mode How to select the "Programmer" mode: • • • • • • Connect the btwTAG to your power supply Open a PC with Wi-Fi and connect to the btwTAGXXXXX network Open a browser with 192.168.0.1/config Go to the "Advanced Setup" section Select the type "Programmer" in the "Tag Type" field Press "Save" Live Configuration How to change the configuration when the btwTAG is operating: • • Ver. 2.
_________________________________________________________www.btwtag.com • • • Ver. 2.0 Press the "Config" button of the Tag you want to Configure (use slide tool to find button at right on screen) Find the device by searching the HW ID in the Configuration page.
_________________________________________________________www.btwtag.com Contact 1730 Park Street Naperville, IL. 60563 USA info@btwtag.com Ver. 2.
_________________________________________________________www.btwtag.com Appendix I: APIs For OEM Platforms This documentation (Version: Draft V1.4) allows developers to build a server for exchanging data with OEM-based btwTAGs. Defining the Structure btwTAGs communicate with the server using 2 Rest API calls of type Post. The device inside it is configured with a standard endpoint. btwTAG cloud: to take advantage of the device in the btwTAG version OEM will need to change this parameter.
_________________________________________________________www.btwtag.com As described in the introduction, the btwTAG will perform a first recording call. In this call, you will expose all your data and configuration parameters and will wait for a response confirm that contains a security token.
_________________________________________________________www.btwtag.com Tokens The btwTAGs Firmware contains a token-primitive, this token will be placed in the header of the /add call, it will be the job of the server return an object (JSON) in the response within which to insert the key new_token and as a value a new alphanumeric token of 8 figures that the btwTAG will encapsulate in the header of subsequent calls to /date type.
_________________________________________________________www.btwtag.
_________________________________________________________www.btwtag.com param:'ch': channel (min:0,max:9,def:0) Sub-G Frequency Communication Channel note: All communication devices must coexist on the same frequency and on the same channel param:'fr': 0 -868Mhz, 1 th 915Mhz (def:0) Frequency at which the Tag should operate note: 915Mhz is only for the US, 868Mhz for EU param:'fw': realease fw ...
_________________________________________________________www.btwtag.com cfg:[], mtc:[] } The config array can contain objects equal to those used in the registration phase: ... ...config:[{p:string,v: new_value}] where p corresponds to the parameter (ex: ar,at,wr,wt ect) where v corresponds to the value (ex: int,string,[int,int], etc.) The match array can contain objects by following the following schema: ...
_________________________________________________________www.btwtag.com The Tag to type /data call waits for a constructed response according to the schema of the snippet. 1. At the key received_configs, it will expect "true" if you have sent in the request for manually obtained configurations Wi-Fi, if it is returned "false" it will try to send parameters back to the server. 2.
_________________________________________________________www.btwtag.com Appendix II: Device Specifications Dimensions Rechargeable battery Charging Material Operating Temperature Led RF RF RF Certifications Ver. 2.0 48.6x93x15 mm Lithium 1000mAh Micro-USB port ABS (UL94HB) and Silicone -10 °C / +60 °C X1 BLE (4.2) 2.4Ghz Wi-Fi 2.4Ghz 802.11a/b/g/n Sub-G 915 MHz 802.15.