Why do I need Tap Manager ?
Iotize Tap Manager is a free app that eliminates the challenges of developing a smartphone based app to get started using your Tap devices. Tap Manager supports you with:
- Device auto-scan and manual connection controls.
- Monitoring Tap connected systems.
- Tap configuration explorer.
- Relay connection between Taps and Iotize Studio for configuration and testing.
- Data logging to 'Iotize Cloud Platform'.
- Command shell and more.
Iotize Tap Manager for iPhone compatibility concerns
- IoTize Tap Manager for iOS is compatible with iOS version 12 or above.
- For using NFC features of IoTize Tap Manager, you need an iPhone 7 or newer.
- For using the background Tag reading feature, you need an iPhone XS, XS Max or XR model.
- IoTize Tap Manager is compatible with WebApps built with @iotize/device-client.js version 0.0.1-alpha.78 or newer and Iotize Studio version 1.24 or newer.
- TapNLink Primers older than the ones distributed in July 2018 are not compatible with Iotize Tap Manager for iOS. If you are planning to use these older version of Primers with an iPhone contact us at firstname.lastname@example.org for an upgrade.
What is ICS (IoTize Communication services) ?
- ICS is the former version of Tap Manager.
- TapNLink Primers older than the ones distributed in July 2018 will try to launch this app upon an NFC tap.
- If your TapNLink Primer requires ICS contact us at email@example.com and we will give you the appropriate support (with either a complentary documentation set, or an upgrade of your TapNLink Primer).
How do TapNLink Primer & Standard differ ?
The Primer has to be considered as an evaluation version of the Standard version. Thus, the Primer presents a few limitations. The most important differences are qualitative: - only the 'Standard' version can be firmware updated. - only the Primers are preprovisioned on the iotize server. It means that: - the serial number of a Standard TapNLink cannot be specified for an automatic "Publish" process. - the data collected by a Standard TapNLink (datalogging) is not transferable to the IoTize server (you need to specify your own MQTT broker).
Then, a few limitations have also to considered. The max number of IoTize "added elements" (Bundles + Variables + Profiles + Users) is:
- Primer: Limited to 15 "elements"
Standard: Limited only by the Tap memory
Typically, the Tap memory (NVM) allows to store
- up to ~500 Variables and Bundles
- up to ~100 Profiles and Users
The memory usage can be seen in IoTize Studio:
- IoTized Application** > Tap > Tap Memory usage
The minimum data logging interval is:
- Primer: 60 seconds
- Standard: 1 second
The Standard version has better security than the Primer:
- Passwords hashed with PBKDF2.
- IoTize firmware update encrypted with AES128.
- Reinforced hash and encryption mechanisms
- Encrypted smartphone <--> cloud <--> IoTize Studio communications.
- Encrypted logged and saved data.
How can I locate the NFC antennas of my smartphone and my Tap ?
To “tap” successully, your Tap and smartphone NFC antennas must be aligned, so you must know their location.
Location of the NFC antenna of your Tap
- The NFC is located all around the PCB
- It has a rectangular form (about 25 mm * 35 mm)
Location of iPhone NFC antennas is at the top, on the rear side of the iPhone right near the camera.
Location of your Android smartphone’s NFC antenna
- The NFC antenna may be anywhere on the back of your smartphone
- Note that this antenna is generally slightly bigger that the NFC antenna on the Tap
You must slowly slide the phone around over the Tap until you find the spot that gives the most consistent pairing success.
How do I “tap” my Android NFC smartphone on the Tap ?
- Put your smartphone and Tap NFC antennas close together (< 2-3 cm max).
- Keep them in this position for about 5 seconds, until NFC communication is established, and the application displays the “Welcome page “(with the IoTize logo), then the monitoring page.
- Move your phone at least 20 cm away from your Tap to avoid unexpected pairings, which could alter subsequent operations.
How do I pair TapNLink / smartphone using BLE ?
If your smartphone does not have the background Tag reading feature (iPhone other than XS, XS Max or XR or and Android device without NFC capabilities)):
- Make sure your TapNLink Primer is powered on and your smartphone is in the BLE detection area (typically less than 10 m for indoor locations).
- Launch the Tap Manager app manually.
Use the scan function to search for accessible BLE devices: your TapNLink Primer appears in the list of detected devices, with the following naming structure:
The "BLE name" of a TapNLink module is AppName_nnnnn where
- AppName is the name of the your "iotized" application, defined in IoTize Studio
- nnnnn are the last 5 digits of the serial number of your TapNLink
For the Primer, the displayed BLE name is this Sensor Demo_nnnnn.
Select your Tap to display the monitoring page.
What should I do if the BLE connection is unresponsive ?
- Switch on and off the BLE connection in the general settings of your smartphone.
- Unpair the IoTize BLE appliances and relaunch a scan of the BLE devices.
- Make sure your smartphone is charged. Using the gateway from your smartphone significantly increases power consumption, especially if you are logging high volumes of data.
- If none of the above actions work, switch off your smartphone and restart it.
What should I do if Tap Manager has problems creating a Socket relay connection ?
Try Forcing off Tap Manager and setting up the relay again, or click on the Socket and change the port number.
What should I do if I get the message "Unable to upload pages..."
If you get the message "Unable to upload pages on a proprietary web site: use your ftp utility" after publishing the monitoring application from IoTize Studio, you can either:
change IoTized Application > SmartPhone > Application storage / type to HTML on Web development folder which stores the application on an IoTize server. Use the button Publish to publish automatically.
publish the application (HTML pages) manually to the destination of your choice using any FTP client software (such as FileZilla).