USER MANUAL
1 CHAPTER I: INTRODUCTION 1.1 OVERVIEW. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.2 KEY CONCEPTS . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 1.3 BROWSER REQUIREMENTS. . . . . . . . . . . . . . . . . 6 1.4 MOBILE REQUIREMENTS. . . . . . . . . . . . . . . . . . . . 6 2 CHAPTER II: BASICS 2.1 QUICK START . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 2.1.1 ACCESSING THE STARFLEX WEB INTERFACE. . 7 2.1.2 “PHONE-HOME” REGISTRATION. . . . . . . . . . . . .
5 CHAPTER V: NETWORK SETTINGS 5.1 NETWORK SETTINGS. . . . . . . . . . . . . . . . . . . . . . . 72 6 CHAPTER VI: CONTROL 6.1 CONTROL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 6.1.1 DEFAULT RFID SETTINGS . . . . . . . . . . . . . . . . . . 6.1.2 REBOOT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.1.3 FACTORY RESTORE. . . . . . . . . . . . . . . . . . . . . . . 6.1.4 FIRMWARE UPDATE . . . . . . . . . . . . . . . . . . . . . . . 76 77 77 78 6.
1 CHAPTER I: INTRODUCTION 1.1 OVERVIEW The STARflex reader combines the high performance and real-time location capabilities of the STAR distributed excitation architecture with highly flexible new options for antenna topology and software integration.
The STARflex software architecture is optimized for simplicity and resilience in order to enable fast deployment of robust distributed systems. For tag data, STARflex features native support for the lightweight MQTT device protocol. To simplify and speed integration, STARflex provides a RESTful API for control and status. Users can implement business logic software directly on the reader using this RESTful interface, or by using the modern and ubiquitous node. js web framework.
1.2 KEY CONCEPTS There are some key concepts mentioned throughout this manual that will be useful to understand. The following glossary of acronyms are used in many of the sections.
2 CHAPTER II: BASICS 2.1 QUICK START 2.1.1 ACCESSING THE STARFLEX WEB INTERFACE After the STARflex has been connected to a network and powered on, the next step is to access the STARflex’s Web interface to perform the configuration tasks and verify the STARflex is reading RFID tags. To access the Web interface, specify the following URL in your Web browser: http://169.254.y.z In case that no DHCP service is available, a temporary static IP address is assigned for a period of ten minutes.
2.1.2 “PHONE-HOME” REGISTRATION The STARflex is preconfigured to self-register with the Mojix Vizix cloud application if the unit is able to connect to the Internet. The purpose of this registration is to enable users to have a simplified, cloud managed solution for managing STARflex readers. Vizix provides the capability to bring up a STARflex reader and process RFID tag read data in a matter of minutes.
Claim STARflex The wizard first verifies that the device is registered in the ViZix platform. If the serial of the device entered is not registered in ViZix or the serial is incorrect, the first step will show a message indicating that ViZix has not seen the STARflex (it means that is not registered in the ViZix platform). Enter the correct serial code and click on Retry to verify once again that the STARflex is registered in ViZix.
If the entered serial is correct, then the following window will be shown in the first step of the wizard: CHAPTER II: BASICS QUICK START “Phone-Home“ Registration 10 STARflex MANUAL
Register with ViZix To claim the device it is necessary to have a user registered in the ViZix platform. In the second step of the registration there are two options to connect to ViZix; the first one is using an already registered user in ViZix and the second is to register to ViZix by creating a new account. If using an existing account in ViZix then, enter the corresponding credentials in the Login to your ViZix Account section at the left side and click on Login to claim the device with that user.
If the account exists in ViZix, the information of the ViZix user, his/her name, last name, username, email and the company name will be shown.
Click on Finish to go to the final step.
On the other hand, to create a new account in ViZix, fill in the form at the right side in the Register a New ViZix Account panel and click on Sign up for ViZix to register the new account View Flextags The last step shows the tags associated to the STARflex as a test that the connection is valid. The information of the device is shown in the right panel and the information of the tags associated to the device is shown in the left panel.
Click on More Info to open the window with the message indicating that the ViZix account and STARflex configured successfully. This window has two options to continue to the ViZix console (at the left) or go to the micro stack console of STARflex (at the right).
Close this window by clicking on the X icon at the top right corner of the window or by clicking on any space out of the window. To finish the registration process, click on the Logout button and the login page will be shown again. If the ID/serial number of an already claimed device is entered in the platform, a message indicating that the STARflex as already been claimed will be shown.
2.1.3 HOME PAGE Once you access to the STARflex Web Interface, the home page is displayed. At the top of the page the default hostname of the corresponding STARflex is located, the bell icon showing the number of new notifications and the button to login to the application are displayed. Clicking on the bell icon displays a list with the available notifications (exceptional conditions like low flash memory warnings, etc). It is possible to clear the list of messages one by one or all at once.
In the main menu, there is the information related to the STARflex explained below: a. System Operational This shows the current status of STARflex along with information related to the server.
At the top of the System Operational information, an icon showing the current status of the STARflex. There are 6 possibilities: 1. System Operational, (Green with a check mark) is indicated when the system is running correctly but no RFID program is running. 2. Lost connectivity, (Red) is indicated when there is no connectivity with the STARflex. 3. Reboot in progress (Blue) indicated when rebooting 4. System Upgrading (Blue) indicated when the system is Upgrading 5.
When the cursor is hovering the status icon the following message will appear: Go to Network Settings to change the configuration to DHCP or static IP address This only appears when the Status is Temporary IP Address. Additionally, further information can be presented: • • • • • • • • Current Status: It has two possible values: “Running”, when a RFID program is running and “Idle” if no RFID programs are running. The number of clients is also displayed. Current Date.
c. Peers List The details section displays a list of other STARflex’s discovered on the network. API Status LED On the top of the STARflex is a LED indicator and a switch named “Status LED”. There are four possible LED indications reported from the API (GET config/ led): on, off, blink or keep alive. The behavior of all combinations of the LED are described in the table below.
3 buttons to switch between HOSTNAME, MAC and NAME have been added. Next to Total Peers there is a refresh button CHAPTER II: BASICS QUICK START Home Page . The refresh button sends a broadcast and returns information about all STARflexes that respond.
2.1.4 LOGGING INTO STARFLEX There are two modes to log in to STARflex: Basic Mode and Advanced Mode. Basic Mode: Perform the following procedures to log into the STARflex user interface in basic mode: 1. Click on the login button on the top right side. 2. Enter the username in the Username field. 3. Enter the password in the Password field and click on the Login button or press enter.
Advanced Mode: Perform the following procedures to log into the STARflex user interface in advanced mode: 1. Once logged in basic mode click on the User Icon on the top right side and then click on the Advanced Mode button. 2. Enter the password in the Password field and click on the Continue button or press enter. Note: The Advanced Mode password is disclosed only to professional installers.
The default credentials for the STARflex UI are provided below: Username Password Security Level edison m0j1xInc Intermediate Under the User Icon the following options are available: These options are detailed below: CHAPTER II: BASICS QUICK START Logging into STARflex 25 STARflex MANUAL
2.1.5 ABOUT The “About” section is displayed for user logged on at the top right side of the page, clicking on the “user” icon and then in About.
This section shows information about the Firmware version, Version, Build Number, UI version and the Configured Owner of the STARflex.
Click on the Open Source Licenses link to get the list of available licenses. View the content of the different licenses used for the STARflex by clicking on the View License Details link: Some of the font licenses includes a Homepage link such as roboto and droid-sans-mono. Click on the Homepage link and it will redirect to the web page of the font license.
In addition, view the content of the different licenses used for the STARflex by clicking on the View License Details link: Click on Hide License Details to hide the information and return to the License main list.
2.1.6 SETTINGS The “Settings” option provides the possibility to associate a meaningful name to the STARflex device and to change the landing page background images.
Reader Profile: Associate a meaningful name to the STARflex device.
In the landing page above System Operational section: Under the Reader Profile Section: CHAPTER II: BASICS Quick Start Settings 32 STARflex MANUAL
Personalization: Select the background image the instance will use. The following three options can be selected: Default images: Select this option to use the default images: Custom Images: Upload two type of images, one for the upper background and the other one for the lower background.
A preview of the image will appear in the upper background area. Disable images: Select this option if no images are required to be displayed as upper and lower background. A preview of how the background will look like will display: Click on the Save button in order to save changes or click on the Cancel button to discard changes.
2.1.7 CLIENT LIST The client list page displays the information of every client that is connected to the STARflex. The number of available clients will be displayed inside the user profile menu: The client list page displays the information of every client who is connected to the STARflex. It includes the IP address, the length of time and the Process ID of each client. STARflex has a maximum number of five clients (4 http and 1 MQTT).
The number of clients can also be checked in the Landing Page under the System Operational section: CHAPTER II: BASICS Quick Start Client List 36 STARflex MANUAL
2.1.8 LOGGING OUT OF STARFLEX Logging out allows you to exit the current STARflex session. Perform the following procedures to log out of the STARflex user interface: 1. Click on the Logout link displayed once the User Icon is clicked on the top right side.
2.1.9 BASIC MODE RFID Settings The RFID settings section allows the user to view and configure different Antennas that are associated to the STARflex. These selections include antenna, port, eNode antennas, receive antenna mode, physical layer settings and patterns. For detailed information please refer to Chapter III RFID Settings.
Tag Viewer The tag viewer section allows the user to quickly select and turn on antennas in order to find and read tags, displaying all the found tags in a list. In addition, it is possible to filter while live reading the EPCs, TxID (transmit antenna) and export the list in a CSV file. For detailed information please refer to Chapter IV Tag Viewer.
Network Settings The network settings section describes a set of fields to configure the network that the STARflex will use. In this menu the DHCP values can be assigned to the STARflex. For detailed information please refer to Chapter V Network Settings.
2.1.
Advanced Settings The Advanced Settings tab includes the following configuration options: At the right side of the screen options are grouped by color depending on their functionality: While at the left side, 3 filters for each one of the groups are displayed: Configuration: CHAPTER II: BASICS QUICK START Advanced Mode Advanced Settings, Configuration 42 STARflex MANUAL
Test: Monitoring: CHAPTER II: BASICS QUICK START Advanced Mode Test, Monitoring 43 STARflex MANUAL
- Mouse over to highlight the option: - Search for specific options by using the search option.
Introduce some text inside the text field and it will automatically highlight the text found among the different options: If no text is introduced in the text field, by default all options will be listed.
Control The Control section describes four available options, Default RFID Settings (reset all RFID settings), Reboot, Factory Restore (restore to the original configuration) and Firmware Update. For detailed information please refer to Chapter VI - Control.
Antenna Test The “Antenna Deployment Test” page allows the user to step through the configured antennas in the basic settings page (refer to Chapter III - RFID Settings) in order to test them one by one and make sure they each can read tags. This process ensures proper continuity of cables and antennas. For detailed information please refer to Chapter VI - Antenna Test.
GPIO Test The “GPIO Test” page allows the user to validate the state of connected input devices and to test output devices by triggering the respective output through the interface. For detailed information please refer to Chapter VI - GPIO Test.
MQTT Configuration The “MQTT Configuration” page allows the user to set up the hostname/IP address, port to connect and test to the MQTT broker. For detailed information please refer to Chapter VI - MQTT Configuration.
Frequency Channel STARflex automatically detects its “Jurisdiction” on boot up and disables this control for all models except EU models. The “Jurisdiction/model” of STARflex can not be changed in the field. Only low band channels are all selected by default.