BLE KEYFOB™ Hardware and Installation Guide Version 1.0.0 SEPTEMBER 1, 2015...
Page 2
Watcher Service and/or other software products licensed by CalAmp for use in computer applications development or integration including the computer programs, libraries and related materials either contained on the media provided to you by or from CalAmp, or which you have received or downloaded electronically. “Application” means a compiled or executable software program created by Developer that uses some or all of the functionality of the Software.
Page 4
(5%) between the number of Use Licenses granted and the number paid for, Customer shall pay all costs related to performing the audit in addition to remitting payment for those licenses granted in excess of those paid for as evidenced by a CalAmp License Certificate.
Page 5
Documentation or Related Material(s) shall be replacement of the media, Documentation or Related Material(s) by CalAmp. Each defective item, along with proof of license purchase and date, must be sent in a traceable manner to: CalAmp DataCom Inc., 1401 North Rice Ave. Oxnard, CA 93030.
Manufacture: CalAmp Corp. Warning (Part 15.21) Changes or modifications not expressly approved by CalAmp could void the user’s authority to operate the equipment. Manufacturer is not responsible for any radio or TV interference caused by unauthorized modifications to this equipment.
Short press showing de-bouncing other buttons not pressed............. 12 LMU-FOB comms ..........................13 Advertisement packet contents ....................13 Calamp Fob data contents ......................13 Version letter encoding ......................... 14 txpw contents ..........................14 Scan response packet contents ....................15 Overview of Bluetooth Automatic Driver ID process ................
Build Process ..........................27 Keyfob ............................27 BTCS .............................. 27 LMU ............................... 27 Key Fob button pushes Button state machine ignoring debouncing Warning: Any key press event with time interval shorter than 1s is not going to be reliably received by LMU FOB module when LMU BT driver is operating in Scan advert mode.
Configuration for each button configuration units / bit size (bytes) default Event Generation mask (see below) 00111100 Generate events on releasing button from short press & when long pressed & keep generating long press events until button is released. Event generation mask for each button coded as 1 byte description mask (top 2 bits are reserved) generate message on min short press timeout...
OTP (factory set configuration) Description size (bytes) default Cal Id 0xca1a (** to be confirmed by SIG) tx power calibration 4 (1 for each available power measured during ATE level) Keyfob button timing diagrams for common scenarios. Short press showing de-bouncing other buttons not pressed. Button 1 0) Button is pushed at time zero.
The advertisement consists of at least 2 parts from GAP specification, Manufacturer Specific Data called ‘calamp fob data’; and Tx Power Level called txpw. Calamp Fob data contents L F cal v cid p fv c crc s r b a note: now using the MAC address as the fob ID.
version of this message 0x01 Set by customer/provisioning to 0x0000 allow a single customer to differentiate their devices from the mass. App id;for the keyfob this is 0x01 0x01 Version of keyfob firmware 0xnnbb (big endian) running on the keyfob. nn coded as packed binary coded decimal bb is version letter...
advertisement (db) Scan response packet contents May contain uuids of services, name and any other static data. Overview of Bluetooth Automatic Driver ID process State Machine for driver ID discovery PEG Action Idle Finding Driver Fob Not Found PEG Trigger Out of Range or Fob Found PEG Action...
Page 16
• BT middleware starts discovery • BT middleware populates discovered devices list including FOB ID and RSSI and TxPwr for all calamp keyfobs that match the BT_KEYFOB_CID (configurable 0-FFFE standard CID, FFFF is special case). • BT middleware stops discovery after BT_KEYFOB_DISCOVER_TIME timeout •...
Page 17
o while connected PEG actions ACT_KEYFOB_LED (config TBD) cause BT-middleware to connect to the led service(TBD) and sound the buzzer according to the modifier (TBD) o While connected BT-middleware connects to config service(config TBD) and ota management service(config TBD) and constructs a PULS ID report with the fob id as the unique identifier and the LMU id as an agent(TBD).
Bluetooth LE services Service Name Attribute Name size (bytes) notes New custom primary service pattern Characteristic that defines the blink pattern 1 byte on time; 2 byte off time; 3 byte blink pattern least significant bit first is shifted to the LED;...
New PEG actions Action Modifier Description ACT_BT_KEYFOB 0 – DISCOVER/CONNECT Start discovery for a period of time 1 – HUP ACT_BT _LISTSEND 0NONE send list of discovered keyfobs to server in an app message ACT_KEYFOB_OUTPUT B7-b6: beep buzzer count (up to 4) times Output Dest 0 –...
Driver’s FOB Out-of-Range ‘Disconnect’ from BTCS is used to signal to LMU that driver’s ID is no longer valid. option 1) New/existing Peg trigger to allow peg to decide to rescan () and send a logoff message to server. option 2) If Ignition is still on, rescan automatically and follow driver ID discovery process. option 3) Both of the above Over the Air Update Note that it is possible that a different fob could be connected after an OTA upgrade, and so the next...
LMU->Server: Fob OTA ID Report note right of Server: Checks fob's version against any queued\nupdates and determines if one is available Server->LMU: OTA Download available (App 107) note right of LMU: Check if have file already in OTA\n flash storage. LMU<->Server: HTTP download of A&B image (if required) note right of Fob: FOB new version is captured LMU<->Fob: OAD update of A/B image...
Page 25
Name JSON Contents type “extensions” object "OTA":”<protocols>|<device type>;<supported file types>”, "OTASTAT":”<OTA ID>,<device type>,<file type>,<state code>,<diagnostic code>,<additional status>” “which” array The number of this message (starting from 1), the number of messages in the report The OTA ID field in the OTASTAT value is initialised to 00000000 and updated when any App 107 message is received.
Work Breakdown Build Process Firmware Version Make sure that the build process automatically names the final binaries correctly and that there is exactly one place in the project that sets the version information. Keyfob Keyfob Over the air service we are currently working on this. Keyfob Advertisement packet Fully populate with at least static data Keyfob Button push advertisement...
Page 28
LMU Modified ‘file’ Handling to allow LMU to ‘cache’ file. LMU Keyfob config ??? Puls or params? LMU passive scan for strongest keyfob Includes creating a list of ‘seen’ keyfobs; adding parameters BT_KEYFOB_CID, BT_KEYFOB_DISCOVER_TIME; adding PEG action ACT_BT_KEYFOB_DISCOVER. LMU report of ‘seen keyfobs’ Includes PEG action ACT_BT_KEYFOB_LISTSEND to generate the report and pretty documentation of the report contents.
Need help?
Do you have a question about the FOB10-BL and is the answer not in the manual?
Questions and answers