Table of Contents

Advertisement

User Guide
SenseCAP Tracker T1000-A/B
User Guide
Version: V1.2
1 / 60
Seeed Technology Co., Ltd. All rights reserved.
www.seeedstudio.com

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the SENSECAP T1000-A and is the answer not in the manual?

Questions and answers

Summary of Contents for seeed studio SENSECAP T1000-A

  • Page 1 User Guide SenseCAP Tracker T1000-A/B User Guide Version: V1.2 1 / 60 Seeed Technology Co., Ltd. All rights reserved. www.seeedstudio.com...
  • Page 2: Table Of Contents

    User Guide Contents Introduction ..........................4 Features ............................. 6 Hardware Specifications ....................6 Model Selection ....................... 7 How to Get the Location....................9 2.3.1 Get the GNSS Location ..................9 2.3.2 Get the Wi-Fi Location ..................10 2.3.3 Get the Bluetooth Location................... 10 2.3.4 How to use the LoRaWAN Network ..............
  • Page 3 User Guide 6.2.9 Bluetooth Location Only Packet-0x0B ..............47 6.2.10 Positioning Timeout and Error Code Packet-0x0D ..........49 Downlink Packet, FPort=5 ....................49 6.3.1 Setting the SOS Mode -0x80 ................50 6.3.2 Setting the Uplink Interval -0x81 ................50 6.3.3 Open the buzzer -0x82 ..................
  • Page 4: Introduction

    User Guide 1. Introduction SenseCAP T1000 is a credit card-sized tracker designed for asset and personal tracking. It utilizes GNSS/Wi-Fi/Bluetooth to provide high accuracy positioning in both outdoor and indoor scenarios. 4 / 60 Seeed Technology Co., Ltd. All rights reserved. www.seeedstudio.com...
  • Page 5 User Guide 5 / 60 Seeed Technology Co., Ltd. All rights reserved. www.seeedstudio.com...
  • Page 6: Features

    User Guide 2. Features 2.1 Hardware Specifications General Parameters Product Model T1000-A/T1000-B/T1000-C/T1000-D Backhaul LoRaWAN® (v1.0.4 Class A) Bluetooth Bluetooth v5.1, setting via App LoRaWAN Channel Plan IN865/EU868/US915/AU915/AS923/KR920/RU864 Range: -20 to 60℃; Accuracy: ± 1℃ (min ±0.5℃, max ±1℃) Temperature Resolution: 0.1℃ Light 0 to 100% (0% is dark, 100% is brightest) 3-Axis Accelerometer...
  • Page 7: Model Selection

    User Guide Power Input Voltage 4.7 to 5.5V DC 0 to +45℃ (Beyond the temperature range, the charge will be Charging Temperature Limit limited, and the LED will blink quickly) *Battery life depends on temperature, installation, location interval, network coverage and sensor settings. 2.2 Model Selection Architecture: We offer two different solutions:...
  • Page 8 User Guide As depicted in the above figure, the entire network comprises multiple components ranging from hardware to software. 8 / 60 Seeed Technology Co., Ltd. All rights reserved. www.seeedstudio.com...
  • Page 9: How To Get The Location

    User Guide 2.3 How to Get the Location 2.3.1 Get the GNSS Location The tracker will get location outdoor via satellite system (GPS/BeiDou/more), then uploads the data to server by LoRa wireless. 9 / 60 Seeed Technology Co., Ltd. All rights reserved. www.seeedstudio.com...
  • Page 10: Get The Wi-Fi Location

    User Guide 2.3.2 Get the Wi-Fi Location Tracker uses the passive Wi-Fi AP MAC address scanner to obtain the MAC address and RSSI of nearby Wi-Fi and upload it through LoRaWAN. The application server resolves the location according to the global Wi-Fi location service (such as Google Geolocation API) to obtain the final location.
  • Page 11: Application

    User Guide (Helium Network) 2.3.5 Application SenseCAP provides the SenseCAP Mate App SenseCAP Portal, which are mainly used as device settings and basic functions for users to quickly experience the basic functions of the Tracker. We also provide App and platform customization services. Please refer to the last chapter and contact our team.
  • Page 12: Main Function

    User Guide 2.4 Main Function 2.4.1 Work Mode The Tracker can run different modes in different scenarios. Work Mode Description Scene If you need to locate the device for a Only heartbeat packets are long time and the device can run for a uploaded, just includes battery info.
  • Page 13: Data Cache

    User Guide light from dark to amount. Mainly can be used for anti-demolition monitoring and some light sensitive monitoring. Range: 0 to 100%, (0% is dark, 100% is brightest) 3-Axis By setting the value of acceleration, motion event and shock event are triggered. Accelerometer 2.4.3 Data Cache The device can cache data, which can be enabled through Bluetooth configuration by opening...
  • Page 14: How To Operate The Button

    User Guide 3. How to Operate the Button Actions Description LED Status Buzzer If the tracker is powered off, press and hold the button for 3 seconds to turn it on. The Bluetooth pairing will The LED flashes Melody of rise be activated automatically, and the once a second.
  • Page 15 User Guide Double-click twice to exit SOS None None mode Note: 1. Power off is recommended when not deployed. 2. When first turned on, it is recommended to go to outdoors, and the GPS needs to update the time via satellite. 2.
  • Page 16: How To Configure Via Bluetooth

    User Guide 4. How to Configure via Bluetooth 4.1 Download SenseCAP Mate App As a tool, SenseCAP Mate App is used to config LoRa parameters, interval, bind devices to your account and check device basic information. You can download App from https://install.appcenter.ms/orgs/seeed/apps/sensecap-mate/distribution_groups/public 1) For iOS, please search for “SenseCAP Mate”...
  • Page 17: Setting The Tracker Parameters Through The App

    User Guide 2) Press the tracker’s button for 3 seconds, and select device by SN. For quick start, you can select quick config the basic parameters, if you want to set more parameters, please select “Advanced Configuration”. 3) Select the frequency, it is same to your gateway. Set the Uplink interval, work mode default is “Periodic Mode”, you can set other mode via “Device Bluetooth Configuration”...
  • Page 18: Test The Sensor

    User Guide 4.3.2 Test the Sensor Click the “Measure”, it will read the sensor value: Range: -20 to 60℃; Accuracy: ± 1℃(min 0.5℃, max 1℃); Temperature Resolution: 0.1℃ Light 0 to 100%, (0% is dark, 100% is brightest) 18 / 60 Seeed Technology Co., Ltd.
  • Page 19: Set The Lora Parameters

    User Guide 4.3.3 Set the LoRa Parameters Trackers are manufactured to support universal frequency plan from 863MHz ~928MHz in one SKU. Every single device can support 7 frequency plans. Parameters Description Default platform. It must be used with SenseCAP Gateway. SenseCAP builds a proprietary TTN server that enables SenseCAP for The Things Network sensors to be used out of the box...
  • Page 20: Explanation Of Frequency Plan And Eui

    User Guide need to be restored. 4.3.4 Explanation of Frequency Plan and EUI The sensor supports two network access modes, OTAA by default. Parameter Description Over The Air Activation, it joins the network through Device EUI, OTAA (default) App EUI, and App Key. Activation By Personalization, it joins the network through DevAddr, NwkSkey, and AppSkey.
  • Page 21 User Guide Frequency Common Sub-band Name EU863-870 EU868 -------- US902-928 US915 Sub band from 1 to 8 (default sub-band 2) AU915-928 AU915 Sub band from 1 to 8 (default sub-band 2) KR920-923 KR920 -------- IN865-867 IN865 -------- AS923-1-TTN Frequency plan for TTN AS923-2-TTN Frequency plan for TTN AS923-1...
  • Page 22: Setting The Work Mode

    User Guide 4.3.5 Setting the Work Mode Parameters Description When no data is uploaded by the device within the heartbeat interval, a heartbeat Heartbeat Interval Default 720 minutes. packet will be triggered. This packet only contains battery information. If this switch is turned on, temperature Enable and light will be collected and uploaded, Off by default.
  • Page 23 User Guide Settings Mode and Geolocation. Event Mode Description Default 60 minutes. Uplink Interval – This is the upload interval when no events Non-event (min) are triggered. Range: 1~10080 min. When the shock event is enabled, the Shock Event Off by default. shock of the tracker will trigger a data 23 / 60 Seeed Technology Co., Ltd.
  • Page 24 User Guide report, including the vibration event, location, and sensor data. Default 300. When 3-Axis Motion Threshold (mg) acceleration exceeds 300mg, the shock event is triggered. When the acceleration exceeds the set value, the device starts to move, and when there is no movement for 2 minutes, Off by default.
  • Page 25: Configuring Geolocation Settings

    User Guide Value ≥ 30, if the temperature is upload interval based temperature. higher than 30 %, device will upload the location at 10 minutes interval. When light exceeds threshold, the location and sensor Uplink Interval (min) data are uploaded according to this interval.
  • Page 26: Sending And Exiting Bluetooth Pairing

    User Guide one geolocation cycle. Use Bluetooth, Wi-Fi and GNSS for positioning in turn (switch to the next Bluetooth + Wi-Fi + GNSS type of positioning after one type of positioning fails) Default is 60s. The maximum time to spend waiting for It is not recommended to modify, the GNSS Timeout longer of the time, the bigger of...
  • Page 27: Binding The Device And Checking The Data

    User Guide 5. Binding the Device and Checking the Data 5.1 Check Data via App 1) When exiting the Bluetooth configuration, the device will begin to join the LoRaWAN network. The LED will breathe flash while attempting to join the network. If the network is joined successfully, the LED will flash quickly, and the buzzer will emit a cheerful melody.
  • Page 28: Create Account And Query Data

    User Guide  Data Management: Manage data, including Data Table and Graph section, providing methods to search for data.  Subaccount System: Register subaccounts with different permissions.  Access Key Management: Manage Access Key (to access API service), including Key Create, Key Update, and Key Check.
  • Page 29: Api Instruction

    User Guide 5.2.2 API Instruction SenseCAP API is for users to manage IoT devices and data. It includes 3 types of API methods: HTTP protocol, MQTT protocol, and Websocket protocol. With HTTP API, users can manage LoRa devices, to get raw data or historical data. With MQTT API, users can subscribe to the sensor's real-time measurement data through the MQTT protocol.
  • Page 30: Payload Decoder And Format

    User Guide 6. Payload Decoder and Format 6.1 Decoder Code – GitHub Link Please visit: https://github.com/Seeed-Solution/SenseCAP-Decoder/tree/main/T1000 The Things Network (TTN/TTS) payload decoding script: https://github.com/Seeed-Solution/SenseCAP- Decoder/blob/main/T1000/TTN/SenseCAP_T1000_TTN_Decoder.js Helium decoder: https://github.com/Seeed-Solution/SenseCAP- Decoder/blob/main/T1000/Helium/SenseCAP_T1000_Helium_Decoder.js AWS decoder: https://github.com/Seeed-Solution/SenseCAP- Decoder/blob/main/T1000/AWS/SenseCAP_T1000_AWS_Decoder.js Chirpstack V3 decoder (Chirpstack V4 use TTN decoder): https://github.com/Seeed-Solution/SenseCAP- Decoder/blob/main/T1000/ChirpStack/SenseCAP_T1000_ChirpStackV3_Decoder.js 6.2 Uplink Packet Parsing...
  • Page 31: Device Status Packet -Event Mode 0X01

    User Guide 6.2.1 Device Status Packet -Event Mode 0x01 The Device Status Packet is uploaded when join LoRaWAN network. The Device Status packet has two packet formats in different working modes: 1) Event Mode, ID=0x01 2) Periodic Mode, ID= 0x02 Device Status Packet -Event Mode: 0x01 0x01 Byte2 Byte3~4...
  • Page 32 User Guide Byte Value Type Raw Data Description Frame ID uint8 is the packet ID. is 0x53 = 83(DEC) Battery level uint8 The battery level is 83% 0105 is 0x0105 == v1.5 Software uint16 0105 version The software version is v1.5 0105 is 0x0105 == v1.5 Hardware...
  • Page 33 User Guide means use SOS single mode. SOS mode uint8 00: use SOS single mode. 01: use SOS continuous mode. means disable Event mode. Enable motion uint8 00: disable Event mode. event 01: enable Event mode. 001e is 0x001E=30(DEC) mg When the acceleration exceeds 30mg, 3-Axis motion...
  • Page 34 User Guide upload location and sensor data. 0258 is 0x0258 = 600(DEC), Temperature 33~34 int16 0258 threshold max Maximum threshold =600/10=60.0 ℃ 0000 is 0x0000 = 0(DEC), Temperature 35~36 int16 0000 threshold min Minimum threshold=0/10=0.0 ℃ means when temperature ≤ threshold, device will upload location and temperature event.
  • Page 35: Device Status Packet -Periodic Mode 0X02

    User Guide 6.2.2 Device Status Packet -Periodic Mode 0x02 The Device Status package is uploaded when join LoRaWAN network. The Device Status packet has two packet formats in different working modes: 1) Event Mode, ID=0x01 2) Periodic Mode, ID= 0x02 Device Status Packet -Periodic Mode: 0x02 0x02 Byte2 Byte3~4...
  • Page 36: Heartbeat Packet -0X05

    User Guide only” positioning strategy. strategy 00: Only GNSS 01: Only Wi-Fi 02: Wi-Fi+GNSS 03: GNSS + Wi-Fi 04: Only Bluetooth 05: Bluetooth + Wi-Fi 06: Bluetooth + GNSS 07: Bluetooth + Wi-Fi + GNSS Heartbeat 02d0 is 0x02D0 = 720(DEC) minutes, the 9~10 uint16 02d0...
  • Page 37: Gnss Location And Sensor Packet-0X06

    User Guide Byte Value Type Raw Data Description Frame ID uint8 05 is the packet ID. 64 is 0x64 = 100(DEC) Battery level uint8 The battery level is 100% 01 is 0x01, means the device use “Periodic mode”. 00: Standby mode Work mode uint8 01: Periodic mode...
  • Page 38 User Guide Temperature Light battery level The raw payload: 06000008006462248d06ca502801587ec600fe000057 Byte Value Type Raw Data Description Frame ID uint8 06 is the packet ID. 000008 is 0x000008, 0x0000XX is reserved and 0x08 is the event status. This byte has 8 bits, each representing an event.
  • Page 39: Wi-Fi Location And Sensor Packet-0X07

    User Guide 20:24:45 06ca5028 0x06CA5028 10~13 Longitude int32 06ca5028 113922088(DEC), longitude= 113922088/1000000=113.922088 01587ec6 is 0x01587EC6 = 22576838(DEC), 14~17 Latitude int32 01587ec6 the Latitude = 22576838/1000000=22.576838 00fe is 0x00FE = 254(DEC), 18~19 Temperature int16 00fe temperature=254/10=25.4℃ 0000 is 0x0000 = 0(DEC) minutes, the 20~21 Light uint16...
  • Page 40 User Guide 000008 is 0x000008, 0x0000XX is reserved and 0x08 is the event status. This byte has 8 bits, each representing an event. Bit1: Start moving event. Bit2: End movement event. Bit3: Motionless event. Bit4: Shock event. Bit5: Temperature event. Bit6: Light event.
  • Page 41: Bluetooth Location And Sensor Packet-0X08

    User Guide 3C:CD:57:98:FD:2E bc is 0xBC = -68(DEC), the type is int8 RSSI int8 MAC address 2 the RSSI = -68 74cf002f3ad0 24~29 MAC address 3 ---- 74cf002f3ad0 address (HEX)= 74:CF:00:2F:3A:D0 a9 is 0xA9 = -87(DEC), the type is int8 RSSI int8 MAC address 3...
  • Page 42 User Guide The raw payload: 0800000800646225bb5162d2c1b9d3ca1b5bd2afeae5c0d0e2d70529e8c900fa000057 Byte Value Type Raw Data Description Frame ID uint8 08 is the packet ID. 000008 is 0x000008, 0x0000XX is reserved and 0x08 is the event status. This byte has 8 bits, each representing an event. Bit1: Start moving event.
  • Page 43: Gnss Location Only Packet-0X09

    User Guide c0 is 0xC0 = -64(DEC), the type is int8 RSSI int8 MAC address 1 the RSSI = -64 1b5bd2afeae5 17~22 MAC address 2 ----- 1b5bd2afeae5 address (HEX)= 1B:5B:D2:AF:EA:E5 bc is 0xBC = -68(DEC), the type is int8 RSSI int8 MAC address 2 the RSSI = -68...
  • Page 44 User Guide 000000 is 0x000008, 0x0000XX is reserved and 0x08 is the event status. This byte has 8 bits, each representing an event. Bit1: Start moving event. Bit2: End movement event. Bit3: Motionless event. Bit4: Shock event. Bit5: Temperature event. Bit6: Light event.
  • Page 45: Wi-Fi Location Only Packet-0X0A

    User Guide 6.2.8 Wi-Fi Location Only Packet-0x0A 0x0A Byte2~4 Byte5 Byte6~9 Byte10~15 Byte16 event motion segment MAC address The RSSI of MAC address 1, status number time int8 Byte17~22 Byte23 Byte24~29 Byte30 Byte31~36 Byte37 Byte38 The RSSI of The RSSI of The RSSI of battery MAC address...
  • Page 46 User Guide 0x000002: End movement event. 0x000004: Motionless event. 0x000008: Shock event. 0x000010: Temperature event. 0x000020: Light event. 0x000040: SOS event. Press once event. 0x000080: 00 is 0x00 == 0. Motion When the motion begins, the count segment uint8 increases by 1. Record that this is a number movement.
  • Page 47: Bluetooth Location Only Packet-0X0B

    User Guide 4, int8 the RSSI = -71 57 is 0x57 = 87(DEC) battery level uint8 The battery level is 87% 6.2.9 Bluetooth Location Only Packet-0x0B 0x0B Byte2~4 Byte5 Byte6~9 Byte10~15 Byte16 event motion segment MAC address The RSSI of MAC address 1, status number time...
  • Page 48 User Guide Convert to hexadecimal: 0x000000: no event 0x000001: Start moving event. 0x000002: End movement event. 0x000004: Motionless event. 0x000008: Shock event. 0x000010: Temperature event. 0x000020: Light event. 0x000040: SOS event. Press once event. 0x000080: 00 is 0x00 == 0. Motion segment uint8...
  • Page 49: Positioning Timeout And Error Code Packet-0X0D

    User Guide 6.2.10 Positioning Timeout and Error Code Packet-0x0D When the device cannot locate due to poor GNSS/ Wi-Fi/Bluetooth signal, the positioning timeout packet is uploaded. The raw payload: 0D00000000 Byte Value Type Raw Data Description Frame ID uint8 0D is the packet ID. 00000000 is 0x00000000 0x00000000: The GNSS scan timed out and failed to obtain the location.
  • Page 50: Setting The Sos Mode -0X80

    User Guide 6.3.1 Setting the SOS Mode -0x80 0x80 Byte2 SOS mode 0: single mode 1: continuous mode 8001: set SOS to single mode. 8002: set SOS to continuous mode. 6.3.2 Setting the Uplink Interval -0x81 0x81 Byte2~3 Byte4~5 Byte6~7 Heartbeat uplink interval Periodic mode uplink interval Event mode uplink interval...
  • Page 51: Setting The Work Mode -0X83

    User Guide 6.3.4 Setting the Work Mode -0x83 0x83 Byte2 Open the buzzer. 00: standby mode 01: periodic mode 02: event mode 8300: set work mode to standby mode 8301: set work mode to periodic mode 8302: set work mode to event mode 6.3.5 Setting the Work Mode -0x84 0x84 Byte2 Byte3~4...
  • Page 52 User Guide Byte Value Type Raw Data Description Frame ID uint8 is the packet ID. means disable Event mode. Enable motion uint8 00: disable Event mode. event 01: enable Event mode. 001e is 0x001E=30(DEC) mg When the acceleration exceeds 30mg, 3-Axis motion uint16...
  • Page 53 User Guide 0258 is 0x0258 = 600(DEC), Temperature 18~19 int16 0258 threshold max Maximum threshold =600/10=60.0 ℃ 0000 is 0x0000 = 0(DEC), Temperature 20~21 int16 0000 threshold min Minimum threshold=0/10=0.0 ℃ means when temperature ≤ threshold, device will upload location and temperature event.
  • Page 54: Request Location -0X85

    User Guide 6.3.6 Request Location -0x85 The request tracker initiates location and uploads based on the current configuration. It is usually used in standby mode. 0x85 Example: 85: request location. 6.3.7 Setting Positioning strategy -0x86 0x86 Byte2 Positioning strategy 00: Only GNSS 01: Only Wi-Fi 02: Wi-Fi+GNSS 03: GNSS + Wi-Fi...
  • Page 55: Request Device Status Packet -0X88

    User Guide 6.3.9 Request Device Status Packet -0x88 0x88 Example: 88: request Device Status packet(0x01 or 0x02). 6.3.10 Reboot Device -0x89 0x89 Example: 89: After the command is sent, the device reboots and join the network again. Please use this command with caution.
  • Page 56 User Guide Turn off SOS by closing the command or by double clicking the key. 0x8D Byte2 Open the SOS. 00: Close. 01: Open. Example: 8D00: Close the SOS alarm. 8D01: Open the SOS alarm. 56 / 60 Seeed Technology Co., Ltd. All rights reserved. www.seeedstudio.com...
  • Page 57: Faq

    User Guide 7. FAQ 7.1 Location Issues 7.1.1 Why is there no GPS location data The tracker is indoor. Check whether the device is indoors. If the device is indoors, the GPS location times out. In this case, the location transmission status is uploaded, and the location cannot be obtained.
  • Page 58 User Guide Bluetooth beacons work by transmitting packets of data that are picked up by the tracker via radio waves. The tracker periodically scans around up to 8 Bluetooth beacons and sorts according to RSSI, uploading the UUID and RSSI of the 3 Bluetooth beacons with the best signal strength via LoRa.
  • Page 59: Battery Issues

    User Guide 7.3 Battery Issues 7.3.1 Battery Life Battery life depends on a variety of factors such as uplink interval, whether the sensor is turned on and used, LoRa transmission distance, operating temperature, etc. Therefore, we use the typical working environment(25℃) to predict the battery life, for reference only, and the final life is subject to the actual test.
  • Page 60: Document Version

    User Guide 8. Document Version Version Date Description Editor V1.0 5/18/2023 First edition Jenkin Lu V1.1 6/30/2023 Modify some description. Jenkin Lu V1.1 6/30/2023 Add FAQ and feature description. Jenkin Lu 60 / 60 Seeed Technology Co., Ltd. All rights reserved. www.seeedstudio.com...

Table of Contents