background image

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

User Manual

 

 

 

 

 

 

TREK-120

 

 

 

 

 

 

Cold Chain Sensor, Gateway  
& NFC reader

 

Summary of Contents for TREK-120 Series

Page 1: ...User Manual TREK 120 Cold Chain Sensor Gateway NFC reader ...

Page 2: ...iability under the terms of this warranty as a consequence of such events Because of Advantech s high quality control standards and rigorous testing most of our customers never need to use our repair service If an Advantech product is defec tive it will be repaired or replaced at no charge during the warranty period For out of warranty repairs you will be billed according to the cost of replacemen...

Page 3: ...or relocate the receiving antenna Increase the separation between the equipment and receiver Connect the equipment into an outlet on a circuit different from that to which the receiver is connected Consult the dealer or an experienced radio TV technician for help This device complies with Part 15 FCC Rules Operation is subject to the following two conditions 1 This device may not cause harmful int...

Page 4: ...ales representative or Advantech s customer service center for technical support if you need additional assistance Please have the following information ready before you call Product name and serial number Description of your peripheral attachments Description of your software operating system version application software etc A complete description of the problem The exact wording of any error mes...

Page 5: ...e or equivalent type recommended by the man ufacturer Discard used batteries according to the manufacturer s instructions Note Notes provide optional additional information Document Feedback To assist us in making improvements to this manual we would welcome comments and constructive criticism Please send all such in writing to support advan tech com Packing List Before setting up the system check...

Page 6: ...en the equipment For safety reasons the equipment should be opened only by qualified service personnel 15 If one of the following situations arises get the equipment checked by service personnel The power cord or plug is damaged Liquid has penetrated into the equipment The equipment has been exposed to moisture The equipment does not work well or you cannot get it to work according to the user s m...

Page 7: ...cessory box Safety Precaution Static Electricity Follow these simple precautions to protect yourself from harm and the products from damage To avoid electrical shock always disconnect the power from your PC chassis before you work on it Don t touch any components on the mainboard or other cards while the system is on Disconnect power before making any configuration changes The sudden rush of power...

Page 8: ...Chapter 1 1 General Information This chapter gives background information on the TREK 120 Cold chain Sensor Sections include Introduction General Specifications Dimensions ...

Page 9: ...mpact lightweight 108 g and cableless and can be easily installed using magnets or an adhesive backing eliminating the need for additional cables and invasive vehicle modifications The TREK 120 sensors are also equipped with a drop detection sensor that facilitates product tracking and traceability monitoring Furthermore in terms of development potential Advantech also provides specific software A...

Page 10: ...Drop Tolerance 4 ft drop onto concrete Certifications CE FCC NCC LoRa Gateway Dongle Low power middle range receiver operating from 433MHz to 928MHzfrequency Bands Host interface USB Enhanced noise filtering for better RF performance Easy connection to Flex antenna Dimension 82x62x20 mm weight 100g NFC Reader RF Operating Frequency 13 56MHz 7kHz nominal RF Output Power 200 mW RF Output Impendence ...

Page 11: ...Chapter 1 General Information 1 3 Dimensions TREK 120 Cold Chain Sensor LoRa gateway dongle NFC reader Figure 1 1 TREK 120 dimensions ...

Page 12: ...Chapter 2 2 System Setup This chapter details system setup on TREK 120 Sections include A Quick Tour of TREK 120 Installation Procedures ...

Page 13: ...ecome familiar with the locations and functions of the buttons and indicators which are illustrated in the figures below 2 1 1 Outlook Figure 2 1 Front view of TREK 120 2 1 2 LED behavior Figure 2 2 LED behavior of TREK 120 Replaceable battery Start Status Button Power Status LED Alarm LED ...

Page 14: ...ttery 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 button The sensor Power LED shows Green Figure 2 4 Replace battery of TREK 120 ...

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: ... the website c Unzip SDK file Password is the same as the file name and Launch coldchain_demo exe d Go to Setting and then select COM port which NFC reader connected then press Open 2 2 2 Setup TREK 120 Temperature humidity sensor a Put TREK 120 on the NFC reader Note Please check NFC logo on TREK 120 close to NFC reader 4 LED area to ensure better transmission quality ...

Page 17: ...ing 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 c Go to Check to check the configuration of the TREK 120 ...

Page 18: ...o CSV file to save in other disk 2 2 3 Setup TREK 120 LoRa gateway Windows Platform a Connect TREK 120 LoRa gateway USB cable to the PC or any windows platform USB port b Go to Setting c Select COM port which LoRa gateway connected and channel Data rate Note The channel and data rate must be the same as the TREK 120 sensor setting Then press Open ...

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 3 6 Cold Chain API This chapter explains the software API for TREK 120 ...

Page 22: ...nguage C only SDK Package Structure You can get the following contents by extracting the SDK package Directory Description bin DLL Demo Program doc Document and Release Note include RFID Driver sample The SDK sample source codes Using Cold Chain Library Start Cold Chain First Step user need to add a reference in Visual C 1 In Solution Explorer right click the project node and click Add Reference 2...

Page 23: ...r is on 3 2 Application Programming Interface API Enumeration AlarmMode Enum 0 CONTINUOUS Alarm trigger mode to continuous 1 CUMULATIVE Alarm trigger mode to cumulative ButtonActivate Enum 0 NOT_SUPPORT The not support button function 1 SUPPORT The support button function SensorState Enum 0 CLOSE_NOT_SETTING The Logger sensor not setting and not start 1 CLOSE_ALREADY_SETTING The Logger sensor alre...

Page 24: ...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 temperature_alarm_upper_bound Set logger sensor temperature alarm upper temperature_alarm_lower_bound ...

Page 25: ...alarm_frequency Set logger sensor humidity alarm frequency humidity_alarm_mode humidity according to alarm frequency select type Please refer to AlarmMode Enum falling_alarm_bound Logger sensor falling alarm bound external_battery_stop_logger The external battery voltage is lower than the set value to stop LoRa activate_lora_transmission Enable Disable lora transmission function activate_falling_r...

Page 26: ...sor 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 temperature_alarm_lower_bound Logger sensor temperature alarm lower temperature_alarm_frequency Logger sensor temperature alarm frequency temperature_alarm_mode Temperature according to alarm freque...

Page 27: ...ling_record_index Logger sensor falling count falling_alarm_bound Logger sensor falling alarm bound over_alert The LoRA sensor overflow flag Please refer to Overflow_Flag Structure lora_channel Get LoRa frequency channel lora_data_rate Get Data Rate Value 0 is Low 1 is High loop_recording LoRa Extend to 60K message and overwrite external_battery_stop_logger The external battery voltage is lower th...

Page 28: ..._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 public double external_battery_voltage public int falling_record_index public DateTime falling_datetime public int total_alarm_...

Page 29: ...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 temperature_Warning Judgment temperature alarm status Please refer to WarningType Enum humidity One array ...

Page 30: ...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 Record each falling data timestamp total_alarm_count Temperature and Humidity total alarm count ...

Page 31: ... 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 public string firmware_version public Overflow_Flag over_alert Description Receive LoRa gateway information Structure ...

Page 32: ...mp 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 snr ...

Page 33: ...e ratio crc 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: ...low 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 falling_overflow The number of falling exceeds or equals the upper limit ...

Page 35: ... 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: ...l 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 minute Setting Minute time ...

Page 37: ...second Setting Second time ...

Page 38: ...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: ...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: ...gger 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: ...in_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: ...in_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: ...et_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: ...ref 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 Remark None ...

Page 47: ...ta ref double 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 Remark None ...

Page 48: ...string 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 Remark Save file to csv format ...

Page 49: ...OD_data string 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 Remark Save file to csv format ...

Page 50: ... 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 Remark Save file to csv format ...

Page 51: ... 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 Value 0 is Low 1 is High Returns ADVCC_ERR_SUCCESS On success Otherwise see the error code list Remarks The lora_channel and lora_data_rate must be the same as the logger setting to receive ...

Page 52: ...chain_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: ...ic 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: ...ay_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 Returns MRM_ERR_NO_ERROR On success Otherwise see the error code list Remark None ...

Page 55: ...ata 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: ...lic 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: ...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: ...ain_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: ... 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: ...NCY_ERROR 20000005 ADVCC_ERR_SET_HUMIDITY_UPPER_ERROR 20000006 ADVCC_ERR_SET_HUMIDITY_LOWER_ERROR 20000007 ADVCC_ERR_SET_HUMIDITY_FREQUENCY_ERROR 20000008 ADVCC_ERR_SET_FALLING_BOUND_ERROR 20000009 ADVCC_ERR_SET_EXTERNAL_BATTERY_STOP_LOGGER_ERROR 20000010 ADVCC_ERR_SET_APPOINTMENT_TIME_ERROR 20000011 ADVCC_ERR_SET_LORA_CHANNEL_ERROR 30000000 ADVCC_ERR_GET_SENSOR_FAILED 30000001 ADVCC_ERR_GET_DATA_...

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: ...ations are subject to change without notice 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 ...

Reviews: