> Français
> English
> Deutsch

add_data_file

This function is intended to be used by external software or hardware (other than TRMC datalogger for example) to transmit new data files to the server.

Parameters

  • dossier_id : TDS dossier
  • username : TDS username
  • challenge : challenge, see TDS Challenge/password documentation
  • challenge_password
  • source : source identifier
  • utc_datetime ( for example "20150124081722")
  • content : file

note: The user must have manage rights in the specified dossier.

get_equipment_communication_information

This function is intended to be used by external software or hardware that fetch data from devices (meters, dataloggers,...). This function will return a list of devices matching several criterion that must be interrogated.

Parameters

  • dossier_id : TDS dossier
  • username : TDS username
  • challenge : challenge, see TDS Challenge/password documentation
  • challenge_password
  • select_interface : Usually "tcp_pull". Selects only specific "equipements" with this type of interface
  • select_interface_config. More specific filter on the "interface config" parameter. (MySQL LIKE %%). Empty if not used
  • t0 : 32-bit integer. UNIX timestamp.
  • t1 : 32-bit integer. UNIX timestamp. (t1=0 => t0, t1 not used)

note: The user must have manage rights in the specified dossier.

This function selects all the "equipments" that match the selected "interface" and "interface config". t0 and t1 define a time range. Only the devices that are within this time range will be displayed. Next communication time must be >=t0 and <t1. If t1=0, then t0 and t1 are not used

Only "active" devices are returned.

Answer

The function will return a list of elements. Each element has fields.

  • snr: equipment serial number
  • model :equipment model
  • manufacturer : equipment manufacturer
  • interface_option : parameters configured (see TDS)
  • next_com : UNIX timestamp of the next planned communication

interface_config

"Interface config" is a convenient way to configure the communication. You can create your own software for example and specify "protocol=MY_OWN_SOFTWARE". Call then get_equipment_communication_information() and specify select_interface_config "protocol=MY_OWN_SOFTWARE" to get the device that you must interrogate

Example:

protocol=agent_elec;ip_address=localhost;port=1001;tds_page=/gprs/default.php




Tetraedre Sarl Company, Copyright ©1999-2015