More complicated problems and their solutions can be found in the Troubleshooting section.
Why do I need Tap Manager ?
IoTize Tap Manager free app eliminates the challenges of developing a smartphone based app for Tap devices. Tap Manager supports you with:
- Device auto-scan and manual connection controls.
- Monitoring Tap connected systems.
- Tap configuration.
- Relay connections between Taps and IoTize Studio for configuration and testing.
- Data logging to 'IoTize Cloud Platform'.
- Command shell and more.
Is IoTize Tap Manager compatible with iPhone?
- IoTize Tap Manager for iOS is compatible with iOS version 12 or above.
- To use NFC features of IoTize Tap Manager, you need an iPhone 7 or newer.
- To use 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 an old Primer 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 complementary documentation set, or an upgrade of your TapNLink Primer).
How do TapNLink Primer & Standard differ ?
The Primer is an evaluation version of the Standard version. Thus, the Primer presents a few limitations.
- 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).
the max number of IoTize "added elements" (Bundles + Variables + Profiles + Users) is:
- Primer: Limited to 15 "elements".
- Standard: Limited only by Tap memory. Typically, Tap memory (NVM) can store ~500 Variables and Bundles & ~100 Profiles and Users. 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
Primer security features:
- Passwords hashed with PBKDF2.
- IoTize firmware update encrypted with AES128.
Standard security features (better than Primer):
- 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 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, rear side of the iPhone, right of the camera.
Location of your Android smartphone’s NFC antenna:
- May be anywhere on the back of your smartphone
- 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 your "iotized" application, defined in IoTize Studio.
- nnnnn are the last 5 digits of your TapNLink's serial number.
The Primer's BLE name is 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 smartphone general settings.
- Unpair the IoTize BLE appliances and rescan for 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 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).