Advantech TREK-120 Series User Manual
Advantech TREK-120 Series User Manual

Advantech TREK-120 Series User Manual

Cold chain sensor, gateway & nfc reader
Hide thumbs Also See for TREK-120 Series:

Advertisement

User Manual
TREK-120
Cold Chain Sensor, Gateway
& NFC reader

Advertisement

Table of Contents
loading

Summary of Contents for Advantech TREK-120 Series

  • Page 1 User Manual TREK-120 Cold Chain Sensor, Gateway & NFC reader...
  • Page 2: Product Warranty (2 Years)

    No part of this manual may be reproduced, copied, translated or transmitted in any form or by any means without the prior written permission of Advantech Co., Ltd. Information provided in this manual is intended to be accurate and reliable. How- ever, Advantech Co., Ltd.
  • Page 3: Declaration Of Conformity

    Declaration of Conformity This product has passed the CE test for environmental specifications. Test conditions for passing included the equipment being operated within an industrial enclosure. In order to protect the product from being damaged by ESD (Electrostatic Discharge) and EMI leakage, we strongly recommend the use of CE-compliant industrial enclo- sure products.
  • Page 4: Technical Support And Assistance

    Technical Support and Assistance Visit the Advantech web site at http://support.advantech.com where you can find the latest information about the product. Contact your distributor, sales representative, or Advantech's customer service center for technical support if you need additional assistance. Please have the following information ready before you call: –...
  • Page 5: Warnings, Cautions, And Notes

    Warnings, Cautions and Notes Warning! Warnings indicate conditions, which if not observed, can cause personal injury! Caution! Cautions are included to help you avoid damaging hardware or losing data. e.g. There is a danger of a new battery exploding if it is incorrectly installed. Do not attempt to recharge, force open, or heat the battery.
  • Page 6: Ordering Information

    Ordering Information Part Number Description TREK-120-ANF000A00 Temperature/humidity/G sensor by NFC TREK-120-ANLNA0A00 Temperature/humidity/G sensor by NFC+LoRa NA902/TW922 TREK-120-ANLEU0A00 Temperature/humidity/G sensor by NFC+LoRa EU868 TREK-120-ANLCN0A00 Temperature/humidity/G sensor by NFC+LoRa CN470 TREK-120-ANR000A00 Cold Chain NFC reader TREK-120-ALG000A00 LoRa gateway dongle 525MHz ~ 928MHz TREK-120-ALG000B00 LoRa gateway dongle 433MHz ~ 510MHz Safety Instructions...
  • Page 7 This product is intended to be supplied by an AA wide temperature battery, if need further assistance with purchasing the battery, please contact Advantech for further information.
  • Page 8 Chapter General Information This chapter gives background information on the TREK-120 Cold chain Sensor Sections include: „ Introduction „ General Specifications „ Dimensions...
  • Page 9: General Specifications

    In response to industry demands for rugged cold chain fleet management solutions, Advantech developed its TREK-120 wireless temperature and humidity sensors that can be integrated with an NFC reader and LoRa gateway for wireless data collection and transmissions. Functioning like a data logger, TREK-120 sensors are designed to collect and log all temperature and humidity data accurately and precisely without data losses.
  • Page 10 LED Indicators 1 x Power status 1 x Alarm Buttons 1x Start button Battery 3.6V/2000mAh wide temperature battery ( - 30 ~ 70 °C) Data NFC only and NFC + LoRa Transmissions Mechanical Mount Options 2x Screw holes for mounting. Back sticker 2x Magnet Dimensions (W x D x H)
  • Page 11 1.3 Dimensions TREK-120 Cold Chain Sensor LoRa gateway dongle NFC reader Figure 1.1 TREK-120 dimensions...
  • Page 12 Chapter System Setup This chapter details system setup on TREK-120 Sections include:  A Quick Tour of TREK-120  Installation Procedures...
  • Page 13 2.1 A Quick Tour of TREK-120 Before starting to set up TREK-120, take a moment to become familiar with the locations and functions of the buttons and indicators, which are illustrated in the figures below. 2.1.1 Outlook Replaceable battery Start/Status Button Power/Status LED Alarm LED Figure 2.1 Front view of TREK-120...
  • Page 14 2.1.3 Mounting Way Figure 2.3 Mounting way of TREK-120 2.1.4 Replace Battery The procedure of replacing battery Release 2 screws on battery cover Open battery cover Take off the battery Press “Start“ button. The sensor Power LED shows “Red” Install the new battery Press “Start“...
  • Page 15 2.1.5 Mounting of LoRa gateway dongle There`s a mounting kit on the LoRa gateway dongle. Suggest using 4pcs M3 or M2.5 self-tapping screw or machine screw to fix the gateway dongle. [鍵入文字]...
  • Page 16: Installation Procedures

    2.2 Installation Procedures 2.2.1 Setup TREK-120 NFC reader a. Connect NFC reader to a PC or notebook USB port. b. Download Cold Chain SDK from the website : c. Unzip SDK file (Password is the same as the file name) and Launch coldchain_demo.exe. d.
  • Page 17 b. Go to “ Configure” to setup TREK-120. When you finish all the setting. Please press “Configure Loggers”. All the setting will be written into TREK-120. Press “ Start logger” , then the TREK-120 will start record temperature/humidity. Press “ Stop logger”, then the TREK-120 will be stopped record.
  • Page 18 d. Go to “Download” to download all data in the TREK-120. When you press “ Download data”, all data will be shown on the screen. You also can export to .CSV file to save in other disk. 2.2.3 Setup TREK-120 LoRa gateway ( Windows Platform) a.
  • Page 19 d. Go to “LoRa data” then will show all the data. e. Go to “Filter”. You can select UID to show which TREK-120 you want to see the data. [鍵入文字]...
  • Page 20 [鍵入文字]...
  • Page 21 Chapter Cold Chain API This chapter explains the software API for TREK-120...
  • Page 22: System Requirement

    3.1 Introductions SDK Overview The SDK is divided into three parts Sample code DLL provides logic to communicate with the Logger module, most of the developers do not need to know the details, only need to corresponding process after the interest event trigger or Read/Write logger sensor.
  • Page 23: Application Programming Interface(Api)

    When the instance is created, the user needs to call the coldchain_init(COM_Port) or coldchain_gateway_init(COM_Port) method to open the corresponding Serial Port. When the module is turned on, the system will be initialized in the background. When the initialization is complete, the user should be able to get the firmware version through coldchain_get_version() or coldchain_gateway_get_version().
  • Page 24 Description: Get the version of firmware. Members: lib_version Point to coldchain_lib Version. device_firmware_version Point to NFC Reader OR LoRa Gateway Version. driver_api_version Point to Jogtek RFID.DLL API Version. Setting_Logger Structure Syntax: Windows: Description: Configure logger sensor internal information. Members: record_interval_minutes Set Logger sensor record interval (minutes).
  • Page 25 Set logger sensor temperature alarm lower. temperature_alarm_frequency Set logger sensor temperature alarm frequency. temperature_alarm_mode Temperature according to alarm frequency select type. Please refer to AlarmMode Enum. button_activate Press button to start logger sensor. Please refer to ButtonActivate Enum. button_datafull_restart Press button to restart logger sensor when record data full. Please refer to ButtonActivate Enum.
  • Page 26 Description: Get logger sensor internal information. Members: The logger sensor UID number. button_activate Button start or restart logger sensor. Please refer to ButtonActivate Enum. first_record_datetime Logger sensor the first record time stamp. record_index Logger sensor record count. record_interval_minutes Logger sensor record interval (minutes). temperature_alarm_upper_bound Logger sensor temperature alarm upper.
  • Page 27 Please refer to AlarmMode Enum. sensor_status logger sensor status. Please refer to SensorState Enum. internal_battery_voltage Internal battery voltage. external_battery_voltage External battery voltage. sensor_firmware_version Logger sensor firmware version. humidity_alarm_upper_bound Logger sensor humidity alarm upper. humidity_alarm_lower_bound Logger sensor humidity alarm lower. humidity_alarm_frequency Logger sensor humidity alarm frequency.
  • Page 28 Sensor_Internal_data Structure Syntax: Windows: public struct Sensor_Internal_data public string uid; public int record_index; public DateTime[] record_datetime; public double[] temperature; public int temperature_alarm_upper_bound; public int temperature_alarm_lower_bound; public WarningType[] temperature_Warning; public double[] humidity; public int humidity_alarm_upper_bound; public int humidity_alarm_lower_bound; public WarningType[] humidity_Warning; public double internal_battery_voltage;...
  • Page 29 Description: Get logger sensor record temperature and humidity information. Members: The logger sensor UID number. record_index Logger sensor record count. record_datetime[] One array. Record each data timestamp. temperature[] One array. Record each data temperature. temperature_alarm_upper_bound logger sensor temperature alarm upper. temperature_alarm_lower_bound logger sensor temperature alarm lower.
  • Page 30 Record each data humidity. humidity_alarm_upper_bound logger sensor humidity alarm upper. humidity_alarm_lower_bound logger sensor humidity alarm lower. humidity_Warning Judgment humidity alarm status. Please refer to WarningType Enum. internal_battery_voltage Internal battery voltage. external_battery_voltage External battery voltage. falling_record_index Logger sensor falling count. falling_datetime[] One array.
  • Page 31 Sensor_LoRa_data Structure Windows: public struct Sensor_LoRa_data public string uid; public int record_index; public string record_datetime; public double temperature; public double humidity; public double internal_battery_voltage; public double external_battery_voltage; public int falling_record_index; public string falling_datetime; public int rssi; public int snr; public int crc; public string external_battery_life;...
  • Page 32 Members: The loRa sensor UID number. record_index LoRa sensor record count. record_datetime Receive data timestamp. temperature Receive data temperature. humidity Receive data humidity. internal_battery_voltage Internal battery voltage. external_battery_voltage External battery voltage. falling_record_index LoRa sensor falling count. falling_datetime Receive falling data timestamp. rssi The received signal strength indication.
  • Page 33 The signal to noise ratio. The cyclic redundancy check. external_battery_life Shows the percentage of external voltage. firmware_version LoRa sensor version. over_alert The LoRA sensor overflow flag. Please refer to Overflow_Flag Structure.
  • Page 34 Overflow_Flag Structure Windows: public struct Overflow_Flag public bool temperature_overflow; public bool humidity_overflow; public bool falling_overflow; public bool record_index_overflow; public bool falling_record_index_overflow; public bool lora_transmission_stop; public bool internal_battery_low; public bool external_battery_low;; Description: Save the LoRA sensor overflow flag. Members: temperature_overflow The temperature has exceeded the limit. humidity_overflow The humidity is above the limit.
  • Page 35 record_index_overflow The number of temperature and humidity pens has reached 2000. falling_record_index_overflow The number of falling pens has reached 30. lora_transmission_stop The external battery voltage is lower than the voltage configuration value before wireless transmission. internal_battery_low The internal battery voltage has been lower than 2.4v in front of the wireless transmission external_battery_low Set the external voltage limit, stop LoRa transmission.
  • Page 36 StartTime Structure Windows: public struct StartTime public bool auto_startup; public int date; public int hour; public int minute; public int second; Description: Save the LoRA sensor overflow flag. Members: auto_startup Enable / Disable Appointment Time Function. date Setting Date time. hour Setting Hour time.
  • Page 37 second Setting Second time.
  • Page 38 APIs NFC Reader coldchain_init Syntax: Windows public int coldchain_init(string COM_Port) Description: Open the NFC Reader through the serial port. Parameters: COM_Port [in] Specifies which Serial Port Path to connect firmware. For example "COM1" Returns: ADVCC_ERR_SUCCESS - On success. Otherwise see the error code list.
  • Page 39 coldchain_deinit Syntax: Windows public int coldchain_deinit() Description: Close NFC Reader the serial port. Parameters: None Returns: ADVCC_ERR_SUCCESS - On success. Otherwise see the error code list.
  • Page 40 coldchain_get_version Syntax: Windows public int coldchain_get_version(ref Version FirmwareVer) Description: Get the version of firmware. Parameters: FirmwareVer [out] Please refer to Version Structure. Returns: MRM_ERR_NO_ERROR - On success. Otherwise see the error code list. Remark: None...
  • Page 41 coldchain_set_logger Syntax: Windows public int coldchain_set_logger(Setting_Logger Logger) Description: Configure logger sensor internal information. Parameters: Logger [in] Please refer to Setting_Logger Structure. Returns: MRM_ERR_NO_ERROR - On success. Otherwise see the error code list. Remark: The lora_channel and lora_data_rate must be the same as the Gateway setting to receive.
  • Page 42 coldchain_start_logger Syntax: Windows public int coldchain_start_logger() Description: Start logger sensor to record data. Parameters: None Returns: MRM_ERR_NO_ERROR - On success. Otherwise see the error code list. Remark: None...
  • Page 43 coldchain_stop_logger Syntax: Windows public int coldchain_stop_logger() Description: Stop logger sensor. Parameters: None Returns: MRM_ERR_NO_ERROR - On success. Otherwise see the error code list. Remark: None...
  • Page 44 coldchain_get_sensor_info Syntax: Windows public int coldchain_get_sensor_info(ref Sensor_Info information) Description: Get logger sensor internal information. Parameters: information [out] Please refer to Sensor_Internal_Information Structure. Returns: MRM_ERR_NO_ERROR - On success. Otherwise see the error code list. Remark: None...
  • Page 45 coldchain_get_sensor_data Syntax: Windows public int coldchain_get_sensor_data(ref Sensor_data OD_data) Description: Get logger sensor record temperature and humidity information. Parameters: OD_data [out] Please refer to Sensor_Internal_data Structure. Returns: MRM_ERR_NO_ERROR - On success. Otherwise see the error code list. Remark: None...
  • Page 46 coldchain_get_temperature_avg Syntax: public int coldchain_get_temperature_avg(Sensor_data OD_data, ref Windows double temperature_avg) Description: Get temperature average. Parameters: OD_data [in] Pointer to the node object handle that is the returned by coldchain_get_sensor_data(). temperature_avg [out] Calculation total temperature average. Returns: MRM_ERR_NO_ERROR - On success. Otherwise see the error code list.
  • Page 47 coldchain_get_humidity_avg Syntax: public int coldchain_get_humidity_avg(Sensor_data OD_data, ref double Windows humidity_avg) Description: Get humidity average. Parameters: OD_data [in] Pointer to the node object handle that is the returned by coldchain_get_sensor_data(). humidity_avg [out] Calculation total humidity average. Returns: MRM_ERR_NO_ERROR - On success. Otherwise see the error code list.
  • Page 48 coldchain_export_humiture_data Syntax: public int coldchain_export_humiture_data(Sensor_data OD_data, string Windows FilePath) Description: Export temperature and humidity data to csv. Parameters: OD_data [in] Pointer to the node object handle that is the returned by coldchain_get_sensor_data(). FilePath [in] Save file location. Returns: MRM_ERR_NO_ERROR - On success. Otherwise see the error code list.
  • Page 49 coldchain_export_falling_data Syntax: public int coldchain_export_falling_data(Sensor_data OD_data, string Windows FilePath) Description: Export falling data to csv. Parameters: OD_data [in] Pointer to the node object handle that is the returned by coldchain_get_sensor_data(). FilePath [in] Save file location. Returns: MRM_ERR_NO_ERROR - On success. Otherwise see the error code list.
  • Page 50 coldchain_export_alarm_data Syntax: public int coldchain_export_alarm_data(Sensor_data OD_data, string Windows FilePath) Description: Export temperature and humidity alarm data to csv. Parameters: OD_data [in] Pointer to the node object handle that is the returned by coldchain_get_sensor_data(). FilePath [in] Save file location. Returns: MRM_ERR_NO_ERROR - On success. Otherwise see the error code list.
  • Page 51 LoRa Gateway coldchain_gateway_init Syntax: public int coldchain_gateway_init(string COM_Port, int lora_channel, int Windows lora_data_rate) Description: Open the LoRa Gateway through the serial port. Parameters: COM_Port [in] Specifies which Serial Port Path to connect firmware. For example "COM1" lora_channel [in] Set LoRa frequency channel, Value 1 to 5. lora_data_rate [in] Set Data Rate.
  • Page 52 coldchain_gateway_deinit Syntax: Windows public int coldchain_gateway_deinit() Description: Close LoRa Gateway the serial port. Parameters: None Returns: ADVCC_ERR_SUCCESS - On success. Otherwise see the error code list.
  • Page 53 coldchain_gateway_get_version Syntax: Windows public int coldchain_gateway_get_version(ref Version FirmwareVer) Description: Get the Gateway version of firmware. Parameters: FirmwareVer [out] Please refer to Version Structure. Returns: MRM_ERR_NO_ERROR - On success. Otherwise see the error code list. Remark: None...
  • Page 54 coldchain_gateway_start_receive_lora_data Syntax: CallBack Function public delegate void ReceiveLoRaCallBack(Sensor_LoRa_data data); public int Windows coldchain_gateway_start_receive_lora_data(ReceiveLoRaCallBack cb) Description: When the event is triggered, the ReceiveLoRaCallBack() callback of registered handler instance will be triggered. Parameters: cb [in] Pointer to a user defined callback function. data[out] Please refer to Sensor_LoRa_data Structure.
  • Page 55 coldchain_gateway_stop_receive_lora_data Syntax: Windows public int coldchain_gateway_stop_receive_lora_data() Description: Clear the callback registration of the ReceiveLoRaCallBack. Parameters: None Returns: MRM_ERR_NO_ERROR - On success. Otherwise see the error code list. Remark: None...
  • Page 56 coldchain_gateway_added_filter Syntax: Windows public int coldchain_gateway_added_filter(string uid) Description: Designate LoRa uid add whitelist for filter, Only added uid will receive. Parameters: uid[in] Receive LoRa uid. Returns: MRM_ERR_NO_ERROR - On success. Otherwise see the error code list. Remark: None...
  • Page 57 coldchain_gateway_remove_filter Syntax: Windows public int coldchain_gateway_remove_filter(string uid) Description: Designate LoRa uid remove whitelist. Parameters: uid[in] Receive LoRa uid. Returns: MRM_ERR_NO_ERROR - On success. Otherwise see the error code list. Remark: None...
  • Page 58 coldchain_gateway_reset_filter Syntax: Windows public int coldchain_gateway_reset_filter() Description: Reset whitelist. Parameters: None Returns: MRM_ERR_NO_ERROR - On success. Otherwise see the error code list. Remark: None...
  • Page 59 coldchain_gateway_get_filter Syntax: Windows public int coldchain_gateway_get_filter(ref string[] uid) Description: Get all the uid values in the whitelist. Parameters: uid [out] Get setting uid list.. Returns: MRM_ERR_NO_ERROR - On success. Otherwise see the error code list. Remark: None...
  • Page 60 Error Code List • (0) ADVCC_ERR_SUCCESS - On success. • (1) ADVCC_ERR_GET_VERSION_FAILED • (2) ADVCC_ERR_OPERATION_FAILED • (3) ADVCC_ERR_EXPORT_DATA_FAILED • (7) ADVCC_ERR_COM_IS_OPEN • (8) ADVCC_ERR_COM_NOT_OPEN • (9) ADVCC_ERR_COM_PORT_ERROR • • (20000000) ADVCC_ERR_SET_SENSOR_FAILED • (20000001) ADVCC_ERR_SET_INTERVAL_ERROR • (20000002) ADVCC_ERR_SET_TEMP_UPPER_ERROR • (20000003) ADVCC_ERR_SET_TEMP_LOWER_ERROR •...
  • Page 61 • (40000003) ADVCC_ERR_GATEWAY_RECEIVE_NOT_ACTIVE • (40000004) ADVCC_ERR_GATEWAY_FILTER_ALREADY_SETTING • (40000005) ADVCC_ERR_GATEWAY_FILTER_NOT_SETTING...
  • Page 62 No part of this publication may be reproduced in any form or by any means, electronic, photocopying, recording or otherwise, without prior written permis- sion of the publisher. All brand and product names are trademarks or registered trademarks of their respective companies. © Advantech Co., Ltd. 2010...

Table of Contents