manualshive.com logo in svg

Microtronics myDatalogEASY IoTmini, User Manual, Page: 79 / 210

Share
Download
Microtronics myDatalogEASY IoTmini User Manual Download Page 79

Chapter 10 rapidM2M Studio

Note:

The web-based development environment rapidM2M Studio is being developed continuously which can

lead to slight changes to the appearance of the program compared to the screenshots used in this manual.

10.1 General

Access to the web-based development environment rapidM2M Studio is included in the Microtronics Partner
Program, for which you can register free of charge at the following address:

https://partner.microtronics.com

It is a web-based IDE that is designed to support customers with the creation of IoT applications for the
myDatalogEASY IoTmini . This covers the entire development process - from editing the source code, to
testing as part of the creation process to publishing the finished IoT application in the rapidM2M Store . All
elements which make up an IoT application are summarised in a single project. The elements are:

l

Device logic:

intelligence installed locally on the myDatalogEASY IoTmini

l

Backend logic:

intelligence installed on the myDatanet server

l

Data descriptor:

describes the structure of the data (measurement data, configurations, etc.), that is

exchanged between myDatalogEASY IoTmini , myDatanet server and external systems (e.g. front
ends connected via REST API).

l

Portal view:

Simple front end that is supplied by the myDatanet server (e.g. for fast prototype

development and/or provision of administrative data)

In addition to the dashboard for managing the projects, the rapidM2M Studio consists of two main interfaces:

l

CODEbed:

Editing and compiling the source codes

l

TESTbed:

Testing the IoT application in conjunction with a locally connected device and the

associated back end i.e. the myDatanet server

The sharing function implemented in the rapidM2M Studio enables developers from different disciplines
(firmware programmers, cloud developers, web designers, etc. ) to create an IoT application together as well
as to share projects and libraries with colleagues and the community. The integrated version management
also ensures controlled distribution of updates of an IoT application across the entire chain from the
rapidM2M Studio to the rapidM2M Store to the sites (that were created based on the IoT application) to the
myDatalogEASY IoTmini .

Rev. 01

79

Summary of Contents for myDatalogEASY IoTmini

Page 1: ...301115 Rev 01 Cover Valid from l Firmware version 01v015 l Server version 47 10 l Hardware version 1 0 User manual myDatalogEASY IoTmini ...

Page 2: ......

Page 3: ...4 3 1 Safety and precautionary measures for the wireless module installation 19 4 4 3 2 Safety measures for installing the antenna 19 4 5 Overview 20 4 5 1 Block diagram 21 4 6 Intended use 22 4 7 General product information 22 4 8 Device labelling 23 4 9 Installation of spare and wear parts 24 4 10 Storage of the product 24 4 11 Warranty 24 4 12 Disclaimer 25 4 13 Obligation of the operator 25 4 ...

Page 4: ...s for the cabling 49 7 4 1 Information on preventing electrostatic discharges ESD 50 7 5 Electrical installation 50 7 5 1 Connecting the sensors actuators and power supply 50 7 5 1 1 Connection examples 54 7 5 2 Connecting the LoRa antenna 54 7 5 3 Technical details about the universal inputs 55 7 5 3 1 0 4 to 20mA mode 55 7 5 3 2 0 to 2V mode 55 7 5 3 3 0 to 10V mode 55 7 5 3 4 Standard digital m...

Page 5: ...8 65 7 5 11 Technical details about the system time 65 Chapter 8 Initial Start Up 67 8 1 User information 67 8 2 Applicable documents 67 8 3 General principles 67 8 4 Commissioning the system 67 8 5 Testing communication with the device 69 Chapter 9 User interfaces 71 9 1 User interface on the myDatalogEASY IoTmini 71 9 1 1 Operating elements 71 9 1 1 1 Solenoid switch 71 9 1 1 2 Two colour LED 71...

Page 6: ... 83 12 1 3 Using the CODEbed of the web based development environment rapidM2M Studio 83 12 2 Compiler options 84 12 3 rapidM2M Device API 84 12 3 1 Constants 84 12 3 2 Timer date time 85 12 3 2 1 Arrays with symbolic indices 85 12 3 2 2 Constants 85 12 3 2 3 Functions 85 12 3 3 Uplink 90 12 3 3 1 Constants 90 12 3 3 2 Callback functions 90 12 3 3 3 Functions 91 12 3 4 System 95 12 3 4 1 Arrays wi...

Page 7: ...rays with symbolic indices 122 12 3 9 2 Constants 122 12 3 9 3 Functions 124 12 3 10 Math 128 12 3 11 Char String 131 12 3 12 CRC hash 136 12 3 12 1 Arrays with symbolic indices 136 12 3 12 2 Functions 136 12 3 13 Various 137 12 3 13 1 Arrays with symbolic indices 137 12 3 13 2 Constants 138 12 3 13 3 Functions 138 12 3 14 Console 144 12 3 15 Universal inputs 145 12 3 15 1 Constants 145 12 3 15 2 ...

Page 8: ...ns 164 12 5 1 3 Comments 164 12 5 1 4 Identifier 164 12 5 1 5 Reserved keywords 164 12 5 1 6 Numerical constants 165 12 5 1 6 1 Numerical integer constants 165 12 5 1 6 2 Numerical floating point constants 165 12 5 2 Variables 165 12 5 2 1 Declaration 165 12 5 2 2 Local declaration 165 12 5 2 3 Global declaration 165 12 5 2 4 Static local declaration 166 12 5 2 5 Static global declaration 166 12 5...

Page 9: ... Expression statement 174 12 5 6 4 Empty statement 174 12 5 6 5 Assert expression 174 12 5 6 6 Break 175 12 5 6 7 Continue 175 12 5 6 8 Do statement while expression 176 12 5 6 9 Exit expression 176 12 5 6 10 For expression 1 expression 2 expression 3 statement 176 12 5 6 11 Goto label 177 12 5 6 12 If expression statement 1 else statement 2 177 12 5 6 13 Return expression 177 12 5 6 14 switch exp...

Page 10: ...roubleshooting and repair 197 17 1 General problems 197 17 2 Log entries and error codes 199 17 3 Evaluating the device log 201 17 3 1 Evaluating the device log on the myDatanet server 201 17 3 2 Evaluating the device log using DeviceConfig 201 Chapter 18 Spare parts and accessories 203 18 1 Chargeable features 203 18 2 Assembly sets 203 18 3 Antennas 203 18 4 Power supply units 204 18 5 Charging ...

Page 11: ...Chapter 2 Declaration of conformity Chapter 2 Declaration of conformity Rev 01 11 ...

Page 12: ......

Page 13: ...ly on page 62 Supply or charging voltage 12 32VDC max 12W Housing Material Weight Degree of protection Dimensions WHD ABS PC housing cover 330g without power supply unit IP66 86 x 175 x 64mm without antenna Operating temperature 20 60 C Air humidity 15 90 rH non condensing Storage temperature 30 85 C Display Two colour LED with selectable function l Signalling the operating state controlled by the...

Page 14: ...on is provided in Technical details about the system time on page 65 Internal sensors Internal housing temperature l Measurement range 20 60 C l Resolution 0 1 C Humidity in the housing l Measurement range 0 100 rH l Resolution 0 1 rH External temperature sensor 2 1 x PT100 1000 including auto detection Additional information is provided in Technical details about the PT100 1000 interface on page ...

Page 15: ...face 1 x mini B USB 2 0 slave for the connection to a PC The DeviceConfig configuration program must be installed on the PC or the web based development environment rapidM2M Studio must be used to enable communication with the myDatalogEASY IoTmini Additional information is provided in Technical details about the USB interface on page 58 Data memory 3MB internal flash memory The size of the data r...

Page 16: ...2 is required 3 In order for the RS232 interface to be used the chargeable feature Activation code RS232 300541 must be unlocked or order option Feature activation RS232 300731 is required 4 In order for the RS485 interface to be used the chargeable feature Activation code RS485 300540 must be unlocked or order option Feature activation RS485 300730 is required 5 The RS485 interface is only availa...

Page 17: ...inal manual German must be referenced or the manufacturer contacted for clarification 4 2 Copyright The copying and distribution of this document as well as the utilisation and communication of its contents to others without express authorisation is prohibited Contraventions are liable to compensation All rights reserved 4 3 General descriptive names The use of general descriptive names trade name...

Page 18: ...articularly emphasised Note Indicates a situation that does not result in any injury to persons Note Information that supplements the specifications in the main text 4 4 2 General safety instructions WARNING Hazardous electric voltage can cause electric shock or burns Always switch off all of the used power supplies for the device before installing it completing any maintenance work or resolving a...

Page 19: ...erated in hospitals and or in the vicinity of medical equipment such as heart pacemakers or hearing aids l The device must not be operated in highly flammable areas such as petrol filling stations fuel storage sites chemical factories and explosion sites l The device must not be operated in the vicinity of flammable gases vapours or dusts l The device must not be subjected to strong vibrations or ...

Page 20: ... before use see Assembling the myDatalogEASY IoTmini on page 39 Front of the myDatalogEASY IoTmini view of a device after assembly Rear of the myDatalogEASY IoTmini view of a device after assembly 1 Antenna connector 3 Cable screw connection cable diameter of 5 10 mm 2 Housing cover 4 Pressure compensation 20 Rev 01 ...

Page 21: ... diagram Block diagram of the myDatalogEASY IoTmini 1 It is a DC DC converter with controllable output current A power supply unit e g PSU413D AP that is equipped with a rechargeable battery can thus be charged via the V Batt in output Rev 01 21 ...

Page 22: ...al modes 1 l An interface for connecting a PT100 or PT1000 including automatic detection of which type is being used 2 l One RS232 interface 3 l One RS485 interface 1 4 The myDatalogEASY IoTmini is also equipped with internal sensors internal housing temperature and air humidity in the housing 3 switchable voltage outputs to supply the sensors and an isolated switch contact to directly control an ...

Page 23: ...rgeable feature Activation code RS232 300541 must be unlocked or order option Feature activation RS232 300731 is required 4 In order for the RS485 interface to be used the chargeable feature Activation code RS485 300540 must be unlocked or order option Feature activation RS485 300730 is required 5 In order to transfer the data via LoRaWANthe order option Feature activation LoRa 300971 is required ...

Page 24: ...ment data you may have to wait until the next scheduled data transmission for all of the data to be sent to the myDatanet server Remove the power supply unit before disconnecting the cables and antenna If possible switch off the supply or charging voltage before disconnecting the cables from the V IN and GND clamps see Connecting the sensors actuators and power supply on page 50 Store the myDatalo...

Page 25: ...ruments not in accordance with the requirements l for damages to persons or objects resulting from failure to comply with safety information contained within this instruction manual l for missing or incorrect measurement values or resulting consequential damages due to improper installation 4 13 Obligation of the operator WARNING In the EEA European Economic Area the national implementation of the...

Page 26: ...itself individuals responsible for the setup installation commissioning and operation of the product must have gained relevant qualifications relating to their activities including for example l Training instruction and authorisation to activate deactivate ground and label electric circuits and devices systems in accordance with the standards of safety engineering l Training or instruction on the ...

Page 27: ...a the web browser 4 Customer specific server that provides clients with their own interface The customer specific server receives the data by means of a LoRaWAN connection from the myDatalogEASY IoTmini 5 myDatalogEASY IoTmini with integrated managed service SIM chip including data transmission 6 Application created by the customer device logic that collects and records the data see Device Logic P...

Page 28: ...c server only one option is available l Directly via LoRaWAN Functions and components provided by myDatanet l myDatalogEASY IoTmini Programmable see Device Logic Pawn on page 83 portable device with integrated memory and standardised industrial interfaces UI1 4 PT100 1000 RS232 RS485 isolated switch contact to connect sensors and actuators to the myDatanet server LoRaWAN or customer specific serve...

Page 29: ...myDatalogEASY IoTmini 5 1 Recommended procedure 5 1 1 Development of M2M IoT application It is recommended to start with the definition of the Data Descriptor see Data Descriptor on page 185 when developing a M2M IoT application It specifies the various data structures measurement data configurations etc that are valid for the Device Logic as well as the myDatanet server The definitions of the Dat...

Page 30: ... data record and that the first 8 Byte of each sector are reserved for the internal memory management The 10 Byte overhead already includes the timestamp so it does not have to be taken into account when calculating the size of the entire record If there is not enough free space in a sector to save the entire data record the data record is written to the next sector This means that a data record i...

Page 31: ...r instruction pragma amxcompress 0 3 The PAWN binary 256kB 10 configuration blocks 4000 Byte each 4 registration memory blocks 1kB each and measurement data 3MB are stored in the flash memory of the myDatalogEASY IoTmini To execute via the PAWN script engine the data area of the PAWN binary is decompressed if necessary and copied to the RAM The maximum size for the decompressed data area of the PA...

Page 32: ...REG_SYS_OTP 1 readable Device Logic myDatanet server FLASH System information that is written once as part of the production process REG_SYS_FLASH 1 readable Device Logic myDatanet server FLASH System information that must be able to be changed during operation Application specific data REG_APP_OTP readable Device Logic myDatanet server writeable Device Logic FLASH Application specific information...

Page 33: ...0 characters pipAppId Application ID of the application template from which the site should be created max 50 characters pipAppVer optional Version of the Device Logic currently installed on the device e g 01v005 6 characters pipCtxAutocreate optional Indicates whether the site if it does not exist yet should be created 0 or 1 must be saved as the string l 0 creation of a new site is not permissib...

Page 34: ......

Page 35: ...for operation see Power supply units on page 204 and the antenna see Antennas on page 203 are not part of the standard scope of delivery and must be ordered separately The standard scope of delivery of the myDatalogEASY IoTmini 301050 includes l myDatalogEASY IoTmini base unit l 2x cable screw connections cable diameter of 5 10 mm l 2x blind plugs l 2x 2 pin connector plug l 2x 3 pin connector plu...

Page 36: ...ortant note Remove the power supply unit from the myDatalogEASY IoTmini prior to storage Store the measurement technology so that it is protected against corrosive or organic solvent vapours radioactive emissions as well as strong electromagnetic radiation 6 4 Transport Protect the myDatalogEASY IoTmini against heavy shocks bumps impacts or vibrations The original packaging must always be used for...

Page 37: ...fore be observed in conjunction with transporting lithium batteries l Type of lithium battery l Lithium ion battery l Lithium metal battery l Battery energy content l If the energy content is within the exempt level this will make the transportation process easier l If the energy content is above the exempt level the battery is classed as a complete hazardous material in accordance with the releva...

Page 38: ...300558 Lithium ions 3 33Wh UN3480 PSU DC 300798 Lithium ions 3 33Wh UN3480 6 5 Return Every return must be accompanied by a fully field out return form This return form is available in the service area of the myDatanet server An RMA number is mandatory for any returns and can be obtained from the Support Service Centre see Contact information on page 209 The return shipment of the myDatalogEASY Io...

Page 39: ...g the myDatalogEASY IoTmini Important note l All wiring work must be performed in the de energised state l Ensure installation is completed correctly l Improper handling can cause injuries and or damage to the instruments l The myDatalogEASY IoTmini must not be operated in the field with the lid open l To ensure the housing is properly sealed each of the cable screw connections must only hold a si...

Page 40: ...1 Connector plug 2x 2 pin 2x 3 pin 1x 6 pin 4 myDatalogEASY IoTmini base unit 2 Power supply unit not included in scope of delivery 5 4x Delta PT M3 5x25 Torx 15 3 2x cable screw connections cable diameter of 5 10 mm 6 Housing cover 40 Rev 01 ...

Page 41: ...he locking nut and engagement hook and thus make it easier to insert the cable screw connection into the hole in the myDatalogEASY IoTmini base unit The engagement hook is not symmetrical One of the lugs on the engagement hook is longer Fig 1 preparing the cable screw connection Fig 2 preparing the cable screw connection 1 Engagement hook 3 Longer lug on the engagement hook 2 Locking nut Rev 01 41...

Page 42: ...y a single cable must be threaded through the cable screw connections to ensure the seal of the housing is not jeopardised Threading the connection cables in 1 Cable screw connection cable diameter of 5 10 mm 3 Connector plug 2x 2 pin 2x 3 pin 1x 6 pin 2 Connection cable of a sensor actuator or the supply or charging voltage 4 In accordance with the following figures thread the engagement hook wit...

Page 43: ...tenna see Connecting the LoRa antenna on page 54 The antenna is not included in the scope of delivery and must be ordered separately 8 Insert the power supply unit The power supply unit is designed in such a way that it cannot be inserted incorrectly Note Note that all power supply units with an integrated and rechargeable energy store are delivered with a maximum charge of 30 in accordance with a...

Page 44: ...base unit 3 Housing cover 2 Delta PT M3 5x25 Torx 15 11 Check that the housing cover is positioned correctly on all sides and that no foreign materials have been trapped between the housing and housing cover Important note The manufacturer is not liable for any damage that is caused by housing covers that are not closed correctly The following step is only necessary if you are using an external su...

Page 45: ...ing to specific criteria The following conditions must be avoided in any case l Direct sunlight l Direct weather exposure rain snow etc l Objects that radiate intense heat maximum ambient temperature 20 60 C l Objects with a strong electromagnetic field frequency converter or similar l Corrosive chemicals or gases l Mechanical impacts l Direct installation on paths or roads l Vibrations l Radioact...

Page 46: ...wall drill four 6 mm holes in the wall using the drill template as a guide in accordance with the dimensions in the diagram Step 2 of the wall mounting on page 46 If you want to use your own fastening screws you can use the drill guide provided in the equipment set to determine the position of the holes The diameters are then determined by the screws that are being used and any wall plugs that may...

Page 47: ...ncluded in the scope of delivery of 206 634 1 First attach the assembly loop 3 using the screws 2 included in the DIN rail mounting set for myDatanet housing 86x126 206 634 equipment set to the myDatalogEASY IoTmini see Step 1 of the top hat rail assembly on page 47 2 Place the assembly loop 3 onto the top edge of the top hat rail When turned slightly around the horizontal axis of the myDatalogEAS...

Page 48: ...the scope of delivery of 206 660 4 Cable binder included in the scope of delivery of 206 660 1 First attach the assembly loop 3 using the screws 2 included in the Pipe mounting kit for myDatanet housing 86x126 206 660 equipment set to the myDatalogEASY IoTmini see Step 1 of the pipe assembly on page 48 2 Position the myDatalogEASY IoTmini with the attached assembly loop 3 on the pipe and use the s...

Page 49: ...e following warnings and information must be observed in addition to the warnings and information found in the individual chapters on the installation Further safety information is included in Safety instructions on page 17 Remove the power supply unit from the device before completing any wiring work Removing the power supply unit 1 Delta PT M3 5x25 Torx 15 3 Housing cover 2 Power supply unit 4 S...

Page 50: ... that are sensitive to static l Wear an antistatic wristband that is grounded via a cable to discharge your body and keep it free of static electricity l Only touch components that are sensitive to electric charges in an antistatic working area If possible use antistatic mats and work pads 7 5 Electrical installation Important note Only qualified personnel should undertake the installation describ...

Page 51: ...n 2x 3 pin 1x 6 pin 2 RS232 interface 7 pin JST connector 4 Cable screw connection cable diameter of 5 10 mm 1 SHIELD Cable shielding 2 GND Ground 3 RTS RTS line of the RS232 interface 4 CTS CTS line of the RS232 interface 5 RXD RXD line of the RS232 interface 6 TXD TXD line of the RS232 interface 7 VEXTRS232 Switchable sensor supply 3 3V Assignment of the RS232 interface Rev 01 51 ...

Page 52: ...device from penetrating moisture when the housing cover is open 2 Remove the power supply unit from the myDatalogEASY IoTmini Use the strap provided to remove the power supply unit 3 Then connect your sensors and actuators with the universal inputs and outputs You will require a cable with a 7 pin JST connector to connect the sensors and actuators to the RS232 interfaces Ensure that no current is ...

Page 53: ...ave to be shaped into the base part first so that the housing cover is positioned evenly Important note Ensure that the seals are clean and intact before closing the housing cover Remove any impurities and or dirt The manufacturer shall not be liable for any damage to the device caused by leaky or faulty seals Closing the housing cover 1 myDatalogEASY IoTmini base unit 3 Housing cover 2 Delta PT M...

Page 54: ...sors One of the two switchable sensor supplies must be permanently active for this purpose The use of VEXT is recommended for this purpose see sensor 1 in the connection example above The power consumption per input when the switch contact is closed can be up to 384µA due to the load of 10k086 7 5 2 Connecting the LoRa antenna Important note To ensure the correct functionality only use antennas th...

Page 55: ...hether the connection to the myDatanet server has worked correctly see Testing communication with the device on page 69 7 5 3 Technical details about the universal inputs Note The universal inputs 3 and 4 are only available if the RS485 interface is not used Note The universal inputs are not electrically isolated 7 5 3 1 0 4 to 20mA mode Note Above 23 96mA the relevant input becomes highly resisti...

Page 56: ...additional link is required on two wire sensors see PT100 PT1000 2 wire on page 56 PT100 PT1000 3 wire PT100 PT1000 2 wire 7 5 5 Technical details about the RS485 interface Note The RS485 interface corresponds to standard EIA 485 The RS485 interface of the myDatalogEASY IoTmini includes an input common mode range that covers the full area specified for RS485 7V 12V Higher voltages damage the inter...

Page 57: ...ary overvoltages ESD EFT and surge are however absorbed by protective circuits Note The common mode input voltage range of 7V 12V specified for the RS485 is determined from the max permissible GND potential difference 7V and the max permissible output voltage range of 0 5 V for RS485 7 5 6 Technical details about the RS232 interface Note The RS232 interface of the myDatalogEASY IoTmini is compatib...

Page 58: ...n program is provided in the manual for the DeviceConfig myDatanetDeviceConfig Manual 805004 Access to the web based development environment rapidM2M Studio is included in the Microtronics Partner Program for which you can register free of charge at the following address https partner microtronics com The DeviceConfig configuration program can be downloaded free of charge from the following websit...

Page 59: ...ote The switchable sensor supply output is short circuit proof The output voltage can be varied in the range of 5 24V using the Device Logic see Vsens_On Output voltage characteristics subject to the load current for VOUT 5V Output voltage characteristics subject to the load current for VOUT 12V Rev 01 59 ...

Page 60: ...ject to the load current for VOUT 24V 7 5 8 2 Switchable sensor supply VEXT Note The switchable sensor supply output is short circuit proof The switchable sensor supply VEXT is applied to the main terminal block see Connecting the sensors actuators and power supply on page 50 Uout 3 3V Imax 180mA 60 Rev 01 ...

Page 61: ...c execution is only stopped if the internal supply voltage falls below 2 9V and the myDatalogEASY IoTmini switches to energy saving mode in which only the charge control is active In this case the charge control tries to charge the rechargeable battery up to 3 8V The UV_LOCKOUT log entry is also entered in the device log when activating energy saving mode The rechargeable battery of the power supp...

Page 62: ...battery is charged to the maximum voltage if the state of charge of the rechargeable battery for the power supply unit falls below 50 The charge control is then deactivated again This is designed to optimise the service life of the rechargeable battery l PM_CHARGING_SOLAR The rechargeable battery of the power supply unit is charged to the maximum voltage if the supply or charging voltage V IN exce...

Page 63: ...ective circuit PSU DC A list of compatible PSUs is included in the chapter Power supply units on page 204 An external supply or charging voltage is not required if the power supply unit is equipped with a battery 7 5 10 1 PSU413D AP 300524 V IN Optional Protective circuit V IN Overvoltage protection Capacity 13 6Ah 50 32Wh Type Li Ion Rechargeable Yes Nominal voltage of the rechargeable battery 3 ...

Page 64: ...ed Protective circuit V IN DC Protection circuit Capacity Type Rechargeable no Nominal voltage Operating temperature 20 60 C Charging temperature Storage temperature 0 35 C Block diagram of the PSU DC 7 5 10 5 PSU AC 300558 V IN Not required Protective circuit V IN AC supply voltage 230VAC Capacity 900mAh 3 33Wh Type Li Po Rechargeable Yes Nominal voltage 3 7V Operating temperature 20 60 C Chargin...

Page 65: ...cal details about the system time The myDatalogEASY IoTmini is equipped with a hardware real time clock that has its own buffer battery with an expected service life of 10 years The system time continues to run even if the power supply unit is removed This means that following recommissioning valid time stamps for the measurement and log data can be generated immediately Additionally the system ti...

Page 66: ......

Page 67: ...ly be placed into operation after completion and inspection of the installation Study the manual thoroughly before placing into operation to prevent faulty or incorrect configuration Utilise the manual to familiarise yourself with the operation of the myDatalogEASY IoTmini and the input screens of the myDatanet server before you begin with the configuration 8 4 Commissioning the system Note It is ...

Page 68: ...it as described in the chapter Assembling the myDatalogEASY IoTmini on page 39 If a Device Logic has already been loaded in the device execute the operations provided in the Device Logic to trigger the establishment of a connection Note Note that all power supply units with an integrated and rechargeable energy store are delivered with a maximum charge of 30 in accordance with applicable transport...

Page 69: ...necting the LoRa antenna on page 54 The antenna is not included in the scope of delivery and must be ordered separately 4 Establish a connection If no script has been loaded in the device yet this can be achieved by inserting the power supply unit as described in the chapter Assembling the myDatalogEASY IoTmini on page 39 If a Device Logic has already been loaded in the device execute the operatio...

Page 70: ...on 6 Complete all of the steps detailed in the chapter Assembling the myDatalogEASY IoTmini on page 39 This includes connecting the sensors Important note All wiring work must be performed in the de energised state 7 You can use the Reports of the myDatanet server to check the data transmission see myDatanet Server Manual 805002 The configuration of the Data Descriptor see Data Descriptor on page ...

Page 71: ... Magnet 206 803 included in the scope of supply The Switch_Init function can be used to determine whether the solenoid switch is evaluated by the firmware or Device Logic Report Operation by the user Operation Firmware Press and hold for at least 3 sec and then release Initiation of the transmission Device Logic Press Call up of the public function for which the index is transferred to the Switch_...

Page 72: ...erver Click on the name of the site in the list of sites to open the input screen for configuring the site see myDatanet Server Manual 805002 9 2 1 1 Site Customer Specifies to which customer the site is assigned symbol Assign site to another customer Name Site designation not relevant for the device or data assignment 2 50 characters Device S N Serial number of the device that is linked to the si...

Page 73: ... the next connection The file path is only displayed as long as the input screen for configuring the site has not been closed Data descriptor Input window for configuring the Data Descriptor see Data Descriptor on page 185 9 2 1 4 Configuration 0 Configuration 9 Note These configuration sections are only visible if the logical structure of the corresponding configuration data block was defined usi...

Page 74: ...aken from the global server settings off The transfer volume alarm is deactivated individual The level at which the transfer volume alarm should be triggered can be entered in the adjacent field in KiB Offline alarm after alarm in the event that the device does not report for longer than the set time 00 00 alarm deactivated Title user alarm 1 Freely selectable title for user defined alarm 1 If the...

Page 75: ...ed are displayed in the dropdown list not assigned The default graphic is used to display the measurement data Name of a report template Name of the report template used to display the measurement data Change log configuration Selection of which changes to the configurations should be logged web api Changes that were implemented via the server interface or REST API are logged web device api Change...

Page 76: ...r of the instrument Instrument class The instrument class of the site and instrument must match for an instrument to be able to be connected to a site Once the instrument has been created via the server interface the instrument class can only be changed up until the first connection of the instrument to the server If an instrument class that does not match the actual class of the instrument is sel...

Page 77: ...irmware version than the one on the device NOT RECOMMENDED Once Performs a single firmware update If no new firmware is available or the firmware was installed successfully the firmware update is automatically switched to OFF Ignore The firmware update is deactivated and no information is provided about available firmware updates Firmware type Released Only firmware versions that have successfully...

Page 78: ......

Page 79: ...l Data descriptor describes the structure of the data measurement data configurations etc that is exchanged between myDatalogEASY IoTmini myDatanet server and external systems e g front ends connected via REST API l Portal view Simple front end that is supplied by the myDatanet server e g for fast prototype development and or provision of administrative data In addition to the dashboard for managi...

Page 80: ...USB Operating system Windows 7 Windows 10 recommended MacOS 10 12 or higher Linux Fedora 32 Ubuntu 20 04 Archlinux 2020 06 01 Internet connection Required Required disk space No installation required Browser Google Chrome only 80 Rev 01 ...

Page 81: ...sion 47 10 of the myDatanet server using the standard colour scheme Newer versions may include minor changes to the appearance of the server 11 1 Recommended procedure 11 1 1 Creating the site Detailed instructions on creating a new site are provided in myDatanet Server Manual 805002 Rev 01 81 ...

Page 82: ......

Page 83: ... binary file If the Upload a compiled device logic entry was selected via the Device logic source list selection in the Control configuration section see Control on page 73 of the input screen for configuring the site a binary file that was for example previously created via the web based development environment rapidM2M Studio see rapidM2M Studio on page 79 can be uploaded to the myDatanet server...

Page 84: ...ription maximum capacity is reached ERROR_DONE 11 The required iterative process is now terminated ERROR_OVERFLOW 12 The required operation has exceeded the function capabilities ERROR_NOT_SUPPORTED 13 An option required by the function is not enabled on the CPU the function is not supported in this configuration ERROR_NO_MORE_TIMERS 14 The function requires a timer subscription but no more timer ...

Page 85: ...ME 0b00000001 transferred time in local time 12 3 2 3 Functions native rM2M_GetTime hour 0 minute 0 second 0 timestamp 0 If no time stamp was transferred timestamp 0 the current system time in UTC is converted to hours minutes seconds Alternatively the transferred time stamp is converted to hours minutes seconds Parameter Explanation hour Variable to store the hours OPTIONAL minute Variable to sto...

Page 86: ...h the date should be determined 0 The date for the current system time in UTC is determined 0 The date for the transferred time stamp is determined The time stamp must be specified in seconds since 31 12 1999 Explanation Return value l timestamp 0 Seconds since 31 12 1999 current system time in UTC l timestamp 0 The transferred time stamp is returned native rM2M_GetDateTime datetime TrM2M_DateTime...

Page 87: ... 0 if the difference between the current time and time to be set is less than 5 sec l ERROR if invalid parameters were transferred l ERROR 1 if the time to be set is more than one day ahead of the current system time native rM2M_GetTimezoneOffset Returns the difference in seconds between the system time UTC and local time configured for the site on the myDatanet server This can be used to determin...

Page 88: ...can be created maximum number reached l OK if another error occurs see Return codes for general purposes in chapter Constants on page 84 native rM2M_TimerRemove funcidx Removes a 1s timer Parameter Explanation funcidx Index of the public function of the timer that should be removed Type of function public func Explanation Return value l OK if successful l ERROR if no valid index was transferred or...

Page 89: ... stopped upon expiry of an interval with an interval of 0ms may be initialised Explanation Return value l OK if successful l ERROR if one of the following errors occurs l No valid index was transferred l An interval of 0ms was specified and the timer should be restarted automatically upon expiry of the timeout i e cyclical 0ms timer l Internal error l No additional timers can be created maximum nu...

Page 90: ...ReadData function from the internal flash memory Parameter Explanation data Array that contains the data of the read data record len Length of the data area of the read data record in bytes max 1024 Byte timestamp Time stamp of the data record in UTC public func cfg Function to be provided by the script developer that is called if one of the configuration memory blocks has changed Parameter Explan...

Page 91: ...the internal flash memory Use the rM2M_Pack rM2M_SetPacked or rM2M_SetPackedB functions to generate the data area Parameter Explanation timestamp Time stamp that should be used for the recording 0 The current system time is used as the time stamp 0 The transferred time stamp is used The time stamp must be specified in seconds since 31 12 1999 data Array that contains the data to be saved len Numbe...

Page 92: ...irst memory block The device comprises 10 independent memory blocks flags Configuration flags to be set deleted Bit0 Type of storage 0 default stored in FLASH in non volatile manner RM2M_CFG_VOLATILE saved in RAM in volatile manner Explanation Return value l OK if successful l OK if an error occurs see Return codes for general purposes in chapter Constants on page 84 Note Additional explanation on...

Page 93: ... to determine the position where the data should be written data Array that contains the data that should be written in the configuration memory block size Number of bytes that should be written in the configuration memory block Explanation Return value l OK if successful l ERROR_MEM if enough temporary memory RAM is not currently available can occur if RAM in a volatile manner is selected as the ...

Page 94: ... l Size of the memory used in the configuration memory block l ERROR_MEM if enough temporary memory RAM is not currently available can occur if RAM in a volatile manner is selected as the type of storage for several configuration memory blocks l OK if another error occurs see Return codes for general purposes in chapter Constants on page 84 native rM2M_CfgDelete cfg Deletes all of the data of the ...

Page 95: ...des for general purposes in chapter Constants on page 84 12 3 4 System Note You require the following include file to be able to use the functions in this chapter include easyV3 12 3 4 1 Arrays with symbolic indices TEasyV3_SysValue Internal measurement values Temp Internal housing temperature in 0 1 C RH Humidity in the housing in 0 1 rH define TEasyV3_SysValue Temp RH 12 3 4 2 Constants Numbers ...

Page 96: ...perature measurement PT100 1000 Configuration options for the Temp_Init function TEMP_MODE_SINGLE_CONV 0 single conversion mode TEMP_MODE_CONT_CONV 1 continuous conversion mode Identifications of the modules implemented in the myDatalogEASY IoTmini These are used by the functions for updating the firmware of the modules define MODFW_LORA CMWX1ZZABZ LoRa module define MODFW_BLE NINA B11X Bluetooth ...

Page 97: ...20ms intervals after the Temp_Init function is called Explanation Return value l Time in ms required to measure the temperature l ERROR_FEATURE_LOCKED if the specified interface on the device is not released l ERROR if an invalid parameter was transferred Note The energy consumption in continuous conversion mode is significantly higher than in single conversion mode The lowest level of energy cons...

Page 98: ...chapter Constants on page 84 native EasyV3_GetSysValues values TEasyV3_SysValue len sizeof values Reads the last valid values for the Internal housing temperature and Air humidity in the housing from the system The interval for determining these values is 10sec and cannot be changed Parameter Explanation values Structure for storing the measurement values see TEasyV3_SysValue in chapter Arrays wit...

Page 99: ... be read get packed RM2M_PACK_BE 0b00000010 Use Big endian format RM2M_PACK_U8 0b00010000 8 bit unsigned RM2M_PACK_S8 0b10010000 8 bit signed RM2M_PACK_U16 0b00100000 16 bit unsigned RM2M_PACK_S16 0b10100000 16 bit signed RM2M_PACK_U32 0b01000000 32 bit unsigned RM2M_PACK_S32 0b11000000 32 bit signed RM2M_PACK_F32 0b01000000 32 bit float Rev 01 99 ...

Page 100: ...lue should be written value Value that should be written in the array size Number of bytes that should be used for the value to be written bigendian Settings for the byte sequence that should be used when writing the value true Big endian is used false Little endian is used Explanation Return value l OK if successful l OK if an error occurs see Return codes for general purposes in chapter Constant...

Page 101: ...rea for a data record or a configuration pos Byte offset within the array to determine the position where the data block should be written block Data block that should be written in the array size Number of bytes that should be written in the array by the data block Explanation Return value l OK if successful l OK if an error occurs see Return codes for general purposes in chapter Constants on pag...

Page 102: ...should be read value Variable to store the data to be read size Number of bytes that should be read bigendian Specifies how the packed data must be interpreted true The data is saved in Big endian format in the array false The data is saved in Little endian format in the array Explanation Return value l OK if successful l OK if an error occurs see Return codes for general purposes in chapter Const...

Page 103: ...should be used as a data area for a data record or a configuration pos Byte offset within the array to determine the position from which the data should be read block Array to store the data to be read size Number of bytes that should be read Explanation Return value l OK if successful l OK if an error occurs see Return codes for general purposes in chapter Constants on page 84 Rev 01 103 ...

Page 104: ...uld be read value Set packed Value that should be written in the array Get packed Value that should be read from the array type Configuration flags for the function Bit0 Select Set packed Get packed 0 value should be written 1 value should be read Bit1 Byte order 0 Little endian format 1 Big endian format Bit2 3 reserved for extensions Bit4 7 Data type 1 8 bit unsigned 2 16 bit unsigned 4 32 bit u...

Page 105: ...the RS485_Init function RS485_1_STOPBIT 0b0000000000000001 1 stop bit RS485_2_STOPBIT 0b0000000000000010 2 stop bit RS485_PARITY_NONE 0b0000000000000000 no parity RS485_PARITY_ODD 0b0000000000000100 odd parity RS485_PARITY_EVEN 0b0000000000001000 even parity RS485_7_DATABIT 0b0000000000000000 7 data bits RS485_8_DATABIT 0b0000000000010000 8 data bits RS485_FLOW_NONE 0b0000000000000000 no flow cont...

Page 106: ...len Function to be provided by the script developer that is called when characters are received via the RS485 interface Parameter Explanation data Array that contains the received data len Number of received bytes 106 Rev 01 ...

Page 107: ... uneven parity 2 even parity Bit 4 5 0 7 data bits 1 8 data bits Bit 6 7 0 no flow control 1 RTS CTS handshake Bit 8 0 full duplex mode 1 half duplex mode Note You can also use the predefined constants for this parameter see Configuration of the RS232 interface in the chapter Constants on page 105 The constants can also be combined using the or conjunction funcidx Index of the public function for ...

Page 108: ...er Explanation rs232 Number of the RS232 interface is always 0 on the myDatalogEASY IoTmini Note You can also use the predefined constant RS232_ITF1 for this parameter data Array that contains the data to be sent len Number of bytes to be sent Explanation Return value l Number of processed bytes if successful Note If the number of processed bytes deviates from the passed number of bytes to be sent...

Page 109: ...ter rxbuf Static byte array that should be used as a buffer to receive characters via the RS232 interface rxlen Size of the receiving buffer in byte Note If the function is called up again and the size is set to 0 during the process then the system switches back to the integrated buffer 256 bytes The transferred static byte array can then be used by the script again txbuf Static byte array that sh...

Page 110: ...s 1 8 data bits Bit 6 7 0 no flow control 1 RTS CTS handshake Bit 8 0 half duplex mode 1 full duplex mode Bit 9 0 no load resistance 1 120Ω load resistance Note You can also use the predefined constants for this parameter see Configuration of the RS485 interface in the chapter Constants on page 105 The constants can also be combined using the or conjunction funcidx Index of the public function for...

Page 111: ...Parameter Explanation rs485 Number of the RS485 interface is always 0 for the myDatalogEASY IoTmini Note You can also use the predefined constant RS485_ITF1 for this parameter data Array that contains the data to be sent len Number of bytes to be sent Explanation Return value l Number of processed bytes if successful Note If the number of processed bytes deviates from the transferred number of byt...

Page 112: ...ic byte array that should be used as a buffer to receive characters via the R485 interface rxlen Size of the receiving buffer in byte Note If the function is called up again and the size is set to 0 during the process then the system switches back to the integrated buffer 256 bytes The transferred static byte array can then be used by the script again txbuf Static byte array that should be used as...

Page 113: ...y LORA_7_DATABIT 0b0000000000000000 7 Data bits LORA_8_DATABIT 0b0000000000010000 8 Data bits LORA_FLOW_NONE 0b0000000000000000 no flow control LORA_FLOW_RTSCTS 0b0000000001000000 RTS CTS hand shake LORA_FULL_DUPLEX 0b0000000000000000 full duplex mode LORA_HALF_DUPLEX 0b0000000100000000 half duplex mode 12 3 7 2 Callback functions public func const data len Function to be provided by the script de...

Page 114: ...ull duplex mode 1 half duplex mode Note You can also use the predefined constants for this parameter see Configuration of the UART interface that is connected to the LoRa module in chapter Constants on page 113 The constants can also be combined using the or conjunction funcidx Index of the public function for receiving characters on the UART interface that is connected to the LoRa module Type of ...

Page 115: ...ed UART interface Parameter Explanation LoRa Number of the UART interface that is connected to the LoRa module for the myDatalogEASY IoTmini always 0 data Array that contains the data to be sent len Number of bytes to be sent Explanation Return value l Number of processed bytes if successful Note If the number of processed bytes deviates from the transferred number of bytes to be sent then the LoR...

Page 116: ... that should be used as a buffer to receive characters via the UART interface rxlen Size of the receiving buffer in byte Note If the function is called up again and the size is set to 0 during the process then the system switches back to the integrated buffer 128 bytes The transferred static byte array can then be used by the script again txbuf Static byte array that should be used as a buffer to ...

Page 117: ...umber of registration memory blocks RM2M_REG_NUM_REGS 5 Error codes for the registration memory block access operations RM2M_REG_ERROR_TOKENMEM 101 Not enough tokens were provided RM2M_REG_ERROR_INVAL 102 Invalid character inside JSON string RM2M_REG_ERROR_PART 103 The string is not a full JSON packet more bytes expected RM2M_REG_ERROR_NOMEM 200 memory allocation failed RM2M_REG_ERROR_NUMTOKENS 20...

Page 118: ...stration memory blocks is provided in chapter Registration memory blocks on page 32 Parameter Explanation reg Registration memory block index The following registration memory blocks require an initialisation l RM2M_REG_APP_STATE Application specific volatile data e g current device status flags Configuration flags to be set deleted Bit0 Type of storage 0 invalid currently not supported RM2M_REG_V...

Page 119: ...see Error codes for the registration memory block access operations in chapter Constants on page 117 native rM2M_RegGetValue reg const name Float Fixed _ value tag tagof value reads a value from a registration memory block Detailed information on the registration memory blocks is provided in chapter Registration memory blocks on page 32 Parameter Explanation reg Index of the registration memory bl...

Page 120: ... memory block access operations in chapter Constants on page 117 native rM2M_RegSetValue reg const name Float Fixed _ value tag tagof value Writes a value into a registration memory block Detailed information on the registration memory blocks is provided in chapter Registration memory blocks on page 32 Parameter Explanation reg Index of the registration memory block see Indices of the registration...

Page 121: ...her error occurs see Error codes for the registration memory block access operations in chapter Constants on page 117 native rM2M_RegDelKey reg const name Searches for an entry based on its name and deletes the entry from the registration memory block Detailed information on the registration memory blocks is provided in chapter Registration memory blocks on page 32 Parameter Explanation reg Index ...

Page 122: ... 0 000001 90 000 000 South pole 90 S 0 Equator 90 000 000 North pole 90 N Long geographical longitude in degrees resolution 0 000001 180 000 000 180 West 0 Zero meridian 180 000 000 180 East Alt Height above sea level in meters Qual NMEA Quality indicator see Constants on page 122 SatUsed Number of satellites used for the positioning HDOP relative accuracy of the horizontal position 0 01 define TN...

Page 123: ...ted fix dead reckoning coupled navigation RM2M_NMEA_FIX_MAN 7 Manual input mode RM2M_NMEA_FIX_SIM 8 Simulation mode List of supported GNSS device IDs Designed to identify the source of the NMEA data record in accordance with the Talker ID used with the NMEA 0183 standard RM2M_NMEA_DEVICE_GP 0x244750 GP GPS RM2M_NMEA_DEVICE_GL 0x24474C GL GLONASS RM2M_NMEA_DEVICE_GA 0x244741 GA GALILEO RM2M_NMEA_DE...

Page 124: ...o meridian Greenwich 180 000 000 180 east Elev Height above sea level in meters Valid range 999 9999 Qual Quality indicator GPS quality indicator RM2M_NMEA_FIX_NOK invalid no fix RM2M_NMEA_FIX_GPS non differential GPS fix RM2M_NMEA_FIX_DGPS differential GPS fix RM2M_NMEA_FIX_PPS Precise positioning service PPS RM2M_NMEA_FIX_RTK Real time kinematic RTK RM2M_NMEA_FIX_FLOATRTK Float real time kinemat...

Page 125: ...chapter Constants on page 122 1 Contains the type of decoded NMEA data record see List of supported NMEA data records in chapter Constants on page 122 2 n Dependent on type of decoded NMEA data record For a type RM2M_NMEA_RECORD_GGA data record the remaining structure is the same as the TNMEA_GGA structure 2 Lat 3 Long 4 Alt 5 Qual 6 SatUsed 7 HDOP len Size in cells of the buffer to record the dec...

Page 126: ...ed to the myDatanet server and can for example be read out via the API see API on page 187 Parameter Explanation Sentence NMEA data record from a GPS receiver starting with the character The following data records are currently supported l GPGGA location specification fix information Important note The strings must be terminated 0 immediately after the checksum Explanation Return value l OK if suc...

Page 127: ...Qual Variable to store the quality indicator GPS quality indicator OPTIONAL RM2M_NMEA_FIX_NOK invalid no fix RM2M_NMEA_FIX_GPS non differential GPS fix RM2M_NMEA_FIX_DGPS differential GPS fix RM2M_NMEA_FIX_PPS Precise positioning service PPS RM2M_NMEA_FIX_RTK Real time kinematic RTK RM2M_NMEA_FIX_FLOATRTK Float real time kinematic RM2M_NMEA_FIX_EST Estimated fix dead reckoning coupled navigation R...

Page 128: ...34308 2 π M_2_SQRTPI 1 12837916709551257390 2 sqrt π M_SQRT2 1 41421356237309504880 sqrt 2 M_SQRT1_2 0 70710678118654752440 1 sqrt 2 Helpful constants native fround Float x Commercially rounds the transferred float Parameter Explanation x Float that should be rounded Explanation Return value Commercially rounded integral value native min value1 value2 Supplies the smaller of the two transferred va...

Page 129: ...it max Upper limit Explanation Return value l value if the value is between min and max l min is the value is less than min l max if the value is greater than max native swapchars c Swaps the order of the bytes Parameter Explanation c Value for which the bytes should be swapped over Explanation Return value Value for which the bytes in parameter c are swapped over the lowest byte becomes the highe...

Page 130: ...r native Float sqrt Float x Root x x 0 native Float ceil Float x Smallest whole number that is not smaller than x native Float floor Float x Largest whole number that is not larger than x native Float fabs Float x Absolute value x native Float ldexp Float x n x 2n native Float frexp Float x n Breaks down x into a normalised mantissa in the range 1 2 1 that is supplied as the result and a potency o...

Page 131: ... of the snprintf function of the standard ANSI C implementation Parameter Explanation dest Array to store the formatted result maxlength Maximum number of characters that the array dest can store format The format character string to be used Explanation Return value l 1 in the event of a fault l Number of characters that would have been written if the array dest had been long enough without 0 The ...

Page 132: ...r Explanation string1 The two character strings that are to be compared string2 length The maximum number of characters that should be taken into consideration during the comparison OPTIONAL Explanation Return value l 1 string1 string 2 l 0 both of the character strings are the same at least the length that is taken into account l 1 string1 string 2 native strchr const string char Searches for a c...

Page 133: ...ng1 Character string that should be searched string2 Character string of permitted characters Explanation Return value l Length of string1 if no permitted characters are found l Position of the first character in the character string that should be searched that is not included in the character string of permitted characters native strcspn const string1 const string2 Searches for the position of t...

Page 134: ...racter string2 in character string1 Parameter Explanation string1 Character string that should be searched string2 Character string that the search should be for Explanation Return value l 1 if character string2 that is being searched for is not included in string1 l Array index where character string2 that is being searched for starts in string1 native strtol const string base Converts a characte...

Page 135: ...Character that should be converted to lower case Explanation Return value The lower case variant of the transferred character if available or the unchanged character code of c if the letter c does not have a lower case equivalent native toupper c Converts a character into upper case Parameter Explanation c Character that should be converted to upper case Explanation Return value The upper case var...

Page 136: ...RC16 of the transferred data Parameter Explanation data Array that contains the data for which the CRC16 should be calculated len Number of bytes that must be taken into consideration during the calculation initial Initial value for calculating the CRC16 OPTIONAL Explanation Return value Calculated CRC16 native CRC32 data len initial 0 Returns the calculated Ethernet CRC32 of the transferred data ...

Page 137: ...xt structure Parameter Explanation data Array that contains the data for which the MD5 hash should be calculated len Number of bytes that must be taken into consideration during the calculation hash Array to store the calculated 128 bit hash value ctx Context structure for the MD5 calculation OPTIONAL Explanation Return value 12 3 13 Various 12 3 13 1 Arrays with symbolic indices TablePoint Two co...

Page 138: ...2M_Id string 50 module 10 hwmajor hwminor sn 8 fwmajor fwminor ctx 50 TRTM_Data Information regarding the runtime measurement runtime Determined runtime in ms instructions Number of executed pawn instructions tmp For internal use no write access permitted define TRTM_Data runtime instructions tmp 3 12 3 13 2 Constants Error codes for the CalcTable and CalcTableF functions const TAB_ERR_FLOOR 1 sea...

Page 139: ...tly in comparison to the implementation in pawn A script module can contain several native functions After calling up this function the native functions contained in the script module can be used in the same way as the standard functions available in the pawn engine Parameter Explanation mod Byte array that contains the script module to be loaded Explanation Return value l OK if successful l ERROR...

Page 140: ...ten in the runtime and instructions elements of the transferred structure to record the information regarding a runtime measurement Parameter Explanation measurement Structure for recording the information regarding a runtime measurement Important note This structure must be persistent from calling up rtm_ start to calling up rtm_stop Explanation Return value l OK if successful l ERROR if an error...

Page 141: ...ble Explanation Return value l OK if the relevant value was found l TAB_ERR_FLOOR if the searched value is lower than the first table entry value contains the first table entry l TAB_ERR_CEIL if the searched value is higher than the last table entry value contains the last table entry l OK if another error occurs see Return codes for general purposes in chapter Constants on page 84 Note Additional...

Page 142: ...ly has one transfer parameter older include file is being used and for compatibility reasons therefore returns OK instead of the size of the structure for storing the information native heapspace Supplies the free memory capacity to the heap Explanation Return value The free memory capacity to the heap The stack and the heap have a joint memory area so that this value specifies the number of bytes...

Page 143: ...Parameter Explanation arg The sequence number of the argument Use 0 for the first argument index Index if arg refers to an array value Value to which the argument should be set Explanation Return value l true if the value could be set l false if the argument or index are invalid This function sets an argument in a variable argument list If the argument is an array the index specifies the index of ...

Page 144: ... l ERROR if not successful native setbuf buf size Provides the firmware with a buffer from the RAM area reserved for the script that is used to output strings via the printf function When this function is called up the system switches from the 256 byte buffer integrated in the firmware to the transferred buffer Parameter Explanation buf Static byte array that should be used as a buffer to output s...

Page 145: ...I_NONE 0 Deactivated UI_CHT_SI_DIGITAL 1 Digital UI_CHT_SI_DCTR 2 Counter UI_CHT_SI_DFREQ 3 Frequency UI_CHT_SI_DPWM 4 PWM UI_CHT_SI_A020MA 5 0 4 20mA UI_CHT_SI_A002V 6 0 2V UI_CHT_SI_A010V 7 0 10V UI_CHT_SI_DIRECT 8 Direct corresponds to 0 2V mode on the myDatalogEASY IoTmini Sample rate in Hz for the measurement UI_SAMPLE_RATE_2 2 UI_SAMPLE_RATE_4 4 UI_SAMPLE_RATE_8 8 UI_SAMPLE_RATE_16 16 UI_SAM...

Page 146: ...eactivated UI_CHT_SI_DIGITAL Digital max 32V low 0 99V high 2 31V load 10k086 UI_CHT_SI_DCTR Counter min pulse length 1ms load 10k086 UI_CHT_SI_DFREQ Frequency 1 1000Hz 10k086 UI_CHT_SI_DPWM PWM 1 99 max 100Hz min pulse length 1ms load 10k086 UI_CHT_SI_A020MA 0 4 20mA Resolution 6 3µA max 23 96mA load 96Ω UI_CHT_SI_A002V 0 2V Resolution 610µV max 2 5V load 10k086 UI_CHT_SI_A010V 0 10V Resolution 7...

Page 147: ... input from the system Detailed information on the universal inputs is provided in chapter Technical details about the universal inputs on page 55 Parameter Explanation temp Number of the universal input starting with 0 for UI 1 Note You can also use the predefined constants for this parameter see Numbers of the universal inputs in the chapter System on page 95 value Variable to store the measurem...

Page 148: ...lue l OK if successful l ERROR if an invalid parameter was transferred Note The sample rate for the universal inputs operated in Counter Frequency or PWM modes is not relevant You can use the lowest possible value for the sample rate if you operate all of the universal inputs in these modes and do not operate the isolated switch contact in pulse min mode native UI_ResetCounter channel Resets the c...

Page 149: ...F 0 deactivated DIGOUT_DIG 1 digital output DIGOUT_FREQ 2 frequency output DIGOUT_PWM 3 PWM output DIGOUT_IMPULSE_PER_MINUTE 4 pulse min DIGOUT_IMPULSE_ONCE 5 single output of x pulses 12 3 16 2 Functions native Vsens_On mode Activates the switchable sensor supply VOUT The output voltage 14 7V or 23 4V can be selected via the Mode parameter Detailed information on the switchable sensor supply is p...

Page 150: ... information on the switchable 3 3V supply voltage is provided in chapter Switchable sensor supply VEXT on page 60 Explanation Return value l OK if successful l OK if an error occurs see Return codes for general purposes in chapter Constants on page 84 native Ext3V3_Off Deactivates the switchable 3 3V supply voltage VEXT Detailed information on the switchable 3 3V supply voltage is provided in cha...

Page 151: ...d DIGOUT_DIG Digital output DIGOUT_FREQ Frequency output DIGOUT_PWM PWM output DIGOUT_IMPULSE_PER_ MINUTE Pulse min DIGOUT_IMPULSE_ONCE Single output of x pulses cfg1 DIGOUT_OFF Not used DIGOUT_DIG Not used DIGOUT_FREQ Pulse duty factor 1 100 default 50 DIGOUT_PWM Frequency 0 1000Hz default 100Hz DIGOUT_IMPULSE_PER_ MINUTE Pulse duration Dependent on the sample rate of the universal inputs1 defaul...

Page 152: ...ntact NO CC Detailed information on the isolated switch contact is provided in chapter Isolated switch contact NO CC on page 61 Parameter Explanation digout Number of the digital output isolated switch contact is always 0 for the myDatalogEASY IoTmini Explanation Return value l OK if successful l OK if an error occurs see Return codes for general purposes in chapter Constants on page 84 152 Rev 01...

Page 153: ...E Number of pulses that should be issued per minute DIGOUT_IMPULSE_ONCE Number of pulses that should be issued Explanation Return value l OK if successful l OK if an error occurs see Return codes for general purposes in chapter Constants on page 84 Note Additional explanation on Pulse min mode DIGOUT_IMPULSE_PER_MINUTE Note that the maximum number of pulses that can be issued per minute is depende...

Page 154: ...tailed information on the switchable 3 3V supply voltage VEXTRS232 is provided in chapter Switchable sensor supply VEXTRS232 on page 61 Explanation Return value l OK if successful l OK if an error occurs see Return codes for general purposes in chapter Constants on page 84 12 3 17 LED Note You require the following include file to be able to use the functions in this chapter include led 12 3 17 1 ...

Page 155: ...n value l OK if successful l ERROR if an invalid parameter was transferred native Led_Close Deactivates the two colour LED The two colour LED cannot be controlled by the firmware or the script functions Explanation Return value OK if successful native Led_On bool red bool green The two colour LED consists of a red and a green LED that can be switched on separately by this function If both LEDs are...

Page 156: ...f 0 The green LED flashes until it is deliberately switched off 0 Number of times the green LED should flash Explanation Return value l OK if successful l ERROR if an invalid parameter was transferred native Led_Flash red green Enables the two colour LED to briefly flash every 500ms The two colour LED consists of a red and a green LED If both LEDs are used the two colour LED briefly flashes orange...

Page 157: ...itched off 0 Number of times the green LED should flicker Explanation Return value l OK if successful l ERROR if an invalid parameter was transferred 12 3 18 Solenoid switch 12 3 18 1 Constants Selection of whether the solenoid switch is evaluated by the firmware or script Configuration options for the Switch_Init function SWITCH_MODE_INTERNAL 0 evaluation by the FW SWITCH_MODE_SCRIPT 1 evaluation...

Page 158: ...ex was transferred to the Switch_Init function is called funcidx Index of the public function that should be executed in the event of a state change of the button only necessary if mode SWITCH_MODE_SCRIPT Type of function public func key Explanation Return value l OK if successful l OK if an error occurs see Return codes for general purposes in chapter Constants on page 84 native Switch_Close Deac...

Page 159: ...gnation of the power supply unit define TPM_Info BatteryType Flags VIn VBatt SOC PIn ChargingMode Description 16 12 3 19 2 Constants Charging mode PM_CHARGING_OFF 0 Charge control deactivated PM_CHARGING_NORMAL 1 charge if state of charge 50 PM_CHARGING_SOLAR 2 always charge when possible and sufficient input voltage V IN 16V is available Type of power supply unit PM_BATT_TYPE_NONE 0 No battery or...

Page 160: ... Charge control deactivated PM_CHARGING_NORMAL Charge if the state of charge of the rechargeable battery is 50 PM_CHARGING_SOLAR Charge continuously if possible and the supply or charging voltage V IN is above 16V Explanation Return value l OK if successful l ERROR if an invalid parameter was transferred native PM_BackupInit funcidx Activates malfunction monitoring for the supply or charging volta...

Page 161: ...nation flags Configuration flags to be set deleted OPTIONAL Bit0 Resetting the Coulomb counter that can be used for the application 0 no action PM_CC_RESET Counter reset Explanation Return value Depleted electric charge mAs since the last reset of the Coulomb counter that can be used for the application 12 4 Device Logic error codes If an error occurs while executing the Device Logic the correspon...

Page 162: ...ic was restarted 5 SCRIPT SOFT ERROR 3 Third time a runtime error has occurred within 24 hours Device Logic was restarted The Device Logic is deactivated and error handling is activated if another runtime error should occur within 24 hours see Error handling on page 32 6 SCRIPT UPDATE ERROR Connection abort during the Device Logic download As the existing Device Logic is located in the RAM it can ...

Page 163: ... file format is invalid not supported 3018 AMX_ERR_ VERSION File is for a newer version of AMX 3019 AMX_ERR_ NOTFOUND File or function not found 3020 AMX_ERR_INDEX Invalid index parameter invalid entry point 3021 AMX_ERR_DEBUG Debugger cannot be executed 3022 AMX_ERR_INIT AMX not initialised or initialised twice 3023 AMX_ERR_ USERDATA User data field cannot be set table full 3024 AMX_ERR_INIT_ JIT...

Page 164: ...rts with two stars and space after the second star and ends with A comment that starts with three forward slashes and a space after the third slash is also a documentation comment The parser can support the documentation comment in different ways for example by using it to generate online help 12 5 1 4 Identifier Names of variables functions and constants Identifier comprises the characters a z A ...

Page 165: ...declarations the keyword new is replaced with static see Static local declaration on page 166 The value of the new variable is zero provided that is not initialised explicitly A variable declaration can appear l At every position at which an expression is valid local variable l At every position at which a function declaration or the implementation of the function is valid global variables l In th...

Page 166: ... create a variable that is initialised once and is then not meant to be changed again Such a variable acts in a similar way to a symbolic constant although it is still a variable To declare a constant variable place the keyword const between the keyword that starts the variable declaration new static and the name of the variables Example new const address 4 192 0 168 66 static const status initial...

Page 167: ...n array Array initialisers must be constants 12 5 4 3 Progressive initialisation for arrays The point operator continues the initialisation of the arrays based on the last two initialised values The point operator three points initialises the array up to the array limit Example List array initialisers new a 10 1 new b 10 1 2 new c 8 1 2 40 50 new d 10 10 9 sets all of the elements to 1 b 1 2 3 4 5...

Page 168: ...ty The code section below would therefore issue 5 as the array comprises four characters and the zero terminator new msg Help printf d sizeof msg The sizeof operator always returns the number of entries even for a packed array The code section below also issues 5 as the variable comprises five entries even though it requires less memory space new msg Help printf d sizeof msg For multi dimensional ...

Page 169: ...e1 e2 Result of adding e1 and e2 e1 e2 Result of subtracting e2 from e1 e Result of the arithmetic negation of e two s complement e1 e2 Result of multiplying e1 with e2 e1 e2 Result of dividing e1 by e2 The result is truncated to the closest whole number that is less or equal to the quotient Positive and negative values are rounded down negative infinity e1 e2 Result is the remainder of the divisi...

Page 170: ... is the value of the operand following the assignment Operator Example Explanation v e Assigns the value of e to the variable v v a Assigns the array a to variable v v must be an array of the same size and with the same dimensions as a a can be a character string or an array Note The following operators combine an assignment with an arithmetic or bitwise operation The result of the expression is t...

Page 171: ...lanation e1 e2 The result is a logical true if e1 is less than e2 e1 e2 The result is a logical true if e1 is less or equal to e2 e1 e2 The result is a logical true if e1 is greater than e2 e1 e2 The result is a logical true if e1 is greater or equal to e2 12 5 5 7 Boolean A logical false is represented by an integer value of 0 a logical true is represented by a value that is not 0 Results of a co...

Page 172: ...able An element is an entry for simple variables and for one dimensional arrays For multi dimensional arrays the result is the number of elements sub arrays in the highest dimension Add to the name of the array to specify a lower dimension The result is 0 if the size of the variable is not known If this operator is used in a default value of a function the expression is executed at the time that t...

Page 173: ...ft to the left left to right bitwise and left to right bitwise exclusive or left to right bitwise or left to right less than less or equal to greater than greater or equal to left to right equal unequal left to right logical and left to right logical or left to right conditional execution right to left Assignment right to left comma left to right 12 5 6 Statements A statement can comprise one or s...

Page 174: ... only followed by blank spaces to the end of the line and the expression is not continued in the next line 12 5 6 4 Empty statement An empty statement does not execute any statements and consists of a block statement without statements i e it consists of the symbol Empty statements are implemented in control flow statements without actions e g while iskey or if a label is defined exactly before th...

Page 175: ...m flow to the next statement outside the loop Example example n new a 0 for new i 0 i n i a i if i 10 break a 1 return a 12 5 6 7 Continue Terminates the current iteration of the smallest encircling do for or while statement and moves the program control to the conditional part of the loop Example example n new a 0 for new i 0 i n i a i if i 10 continue a 1 return a Rev 01 175 ...

Page 176: ... once before entering the loop This expression can be used to initiate a variable This expression also includes the variable declaration by means of the new syntax A variable that is declared at this stage is only valid in the loop It is not possible to combine an expression with existing variables and a declaration of new variables in this field All of the variables must either already exist in t...

Page 177: ...he current function and moves the program control to the next statement following the function call The expression value is returned as the function result The expression can be an array or a character string The expression is optional however if present it must start on the same line as the return statement Zero is returned if no expression is specified 12 5 6 14 switch expression case list Trans...

Page 178: ... control to the default clause if none of the case clauses comply with the switch expression Example example n new a 0 switch n case 0 3 a 0 case 4 6 8 10 a 1 case 5 7 a 2 case 9 a 3 default a 1 return a 12 5 6 15 While expression statement Evaluates the expression and executes the statement if the result of the expression is logical true The program control returns to the expression again once th...

Page 179: ...t indicates true or false for the relevant year leapyear y return y 4 0 y 100 0 y 400 0 Details of the statements used in this example are provided in the chapter Operators and expressions on page 169 Generally functions include local variable declarations and consist of a block statement Note In the next example the assert statement prevents negative values for the exponent power x y returns xy a...

Page 180: ...by reference A function argument that is to be transferred as a reference must have the prefix preceding the name The arguments are transferred to the function as a value by default Example swap a b new temp b b a a temp To transfer an array to a function add a pair of brackets to the name of the argument The number of entries can also be specified This improves the error detection of the compiler...

Page 181: ...tive way of transferring parameters to a function by using named parameters These are illustrated in the next example the function was declared in the same way as the previous example new wkday1 weekday month 12 day 31 year 1999 new wkday2 weekday day 31 month 12 year 1999 new wkday3 weekday year 1999 month 12 day 31 In named parameters a dot precedes the name of the argument The argument of the f...

Page 182: ...next example adds the value of an array to another one The values of the array are increased by one if only one parameter is specified addvector a const b 1 1 1 size 3 for new i 0 i size i a i b i 12 6 Differences to C l The pawn is missing the input mechanism of C and is an integer only variant of C There are no structures or unions Floating point support must be implemented with user defined ope...

Page 183: ...5 where a is an array variable with six elements l defined is an operator and not a preprocessor directive The defined operator in the pawn works with constants declared with const global variables local variables and functions l The sizeof operator returns the size of the variables in elements and not in bytes An element is an entry or sub array Further details are provided in the chapter Other o...

Page 184: ...efinition of the function The parameter names in the prototypes and the definitions of the functions must be identical The pawn attends to the parameter name in the prototype due to the named parameter function The pawn uses prototypes to call up the forward declared functions To use these with the named parameters during this process the compiler must already know the names of the parameters and ...

Page 185: ...lected freely There are1024 Byte available per data record that can be used as required There are also another 10 independent memory blocks each with 4000 Byte for the configuration data that can be used as required The content of the data block or configuration block must be described on the server so that the data and configurations received from the myDatalogEASY IoTmini can also be used within...

Page 186: ......

Page 187: ...but includes all of the data provided by myDatanet server e g configurations It is therefore possible for the customer to completely dispense with the interface of the myDatanet server and to create his own user interface A specially developed PC program or web interface can for example be used for this purpose 14 2 rapidM2M Playground The rapidM2M Playground enables you to familiarise yourself wi...

Page 188: ...in dialogue of the myDatanet server linked to the rapidM2M Playground 8 Opens the quick guide for the API 9 Button to change the colour scheme of the rapidM2M Playground 10 Window displaying the selected HTTP command 11 Response code sent by the myDatanet server as an answer to the HTTP command 12 Copies the JSON object generated as a response to the HTTP command on to the clipboard 13 Window disp...

Page 189: ...als l Clean the myDatalogEASY IoTmini with a soft moist cloth Use a mild cleaning agent if necessary 15 2 Replacing the power supply unit Important note A dry location must be used to replace the power supply unit If this is not possible protect the opened device against penetrating moisture using suitable means Opening the myDatalogEASY IoTmini 1 Delta PT M3 5x25 Torx 15 3 Housing cover 2 Power s...

Page 190: ... battery or battery can be returned to the manufacturer or handed in at suitable collection points Removing the power supply unit 1 Power supply unit 2 myDatalogEASY IoTmini base unit The following step is not mandatory 5 Check whether the connection to the myDatanet functions correctly see Testing communication with the device on page 69 6 Close the housing cover The best option is to tighten the...

Page 191: ...ed 15 2 1 Charging the power supply unit All power supply units with an integrated and rechargeable energy store are delivered with a maximum charge of 30 in accordance with applicable transport regulations If you use an external charging voltage V IN during operation the power supply unit is constantly charged by the charge controller integrated in the myDatalogEASY IoTmini If no external chargin...

Page 192: ...ply unit e g PSU413D AP 300524 The charging process starts as soon as the power supply unit is inserted in the charger If the status LED on the charger flashes red once every 5 seconds the power supply unit inserted in the charger does not contain a rechargeable energy store If the status LED flashes red three times every 5 seconds the supply voltage of the charger is too low In this case check th...

Page 193: ...e disposed of in line with environmental requirements Power supply units with depleted rechargeable battery or battery can be returned to the manufacturer or handed in at suitable collection points 15 3 Power supply units with integrated energy store While power supply units with integrated batteries e g PSU713 BP are intended for single use and must be disposed of accordingly after depletion powe...

Page 194: ......

Page 195: ...f waste from electric and electronic equipment must be observed Microtronics Engineering GmbHsupports and promotes recycling and environmentally friendly separate collection disposal of waste from electric and electronic equipment in order to protect the environment and human health Observe the local laws and regulations on disposal of electronic waste at all times Microtronics Engineering GmbHrel...

Page 196: ......

Page 197: ...k the cable connections see Connecting the sensors actuators and power supply on page 50 l Check whether the output signal from the sensor that you are using is compatible with the electrical characteristics of the universal inputs see Technical details about the universal inputs on page 55 l Check whether the universal input configuration matches the sensor output signal see UI_Init l Check the f...

Page 198: ... conducted via the relays The Device Logic is not being executed correctly l Check that the correct Device Logic type was selected during the configuration of the control see Control on page 73 l Load the device log from the myDatalogEASY IoTmini using the DeviceConfig see myDatanetDeviceConfig Manual 805004 A list of all the possible Device Logic error codes is included in the chapter Pawn script...

Page 199: ...esent remains active 1031 UV RECOVER The rechargeable battery or battery voltage once again suffices to guarantee reliable operation This is either achieved by replacing the rechargeable battery or battery pack or by ensuring that the charge controller has charged the battery sufficiently The device resumes normal operation in accordance with the configuration 1034 CONTROLLER UPDATE Controller fir...

Page 200: ...device log includes this error several times see Contact information on page 209 1300 USB CONNECTED USB connection to a PC established 1310 USB DISCONNECTED USB connection was terminated 2000 2199 MODULE ERR Area for customer specific critical error codes that can be written in the device log by means of the rM2M_WriteLog pawn script function 2200 2399 MODULE WARNING Area for customer specific non...

Page 201: ...nnection are available The manual for the server myDatanet Server Manual 805002 includes a detailed description of the evaluation of the device log on the myDatanet server 17 3 2 Evaluating the device log using DeviceConfig The DeviceConfig program can be used to read all of the stored log entries including those that have not yet been transferred to the myDatanet server directly from the myDatalo...

Page 202: ......

Page 203: ...n LoRa 1 300971 Feature activationg BLE 1 300972 Activation code for later activation by the customer Activation code RS485 1 300540 Activation code RS232 1 300541 Activation code temperature input 1 300542 Activation code BLE 1 300968 18 2 Assembly sets Description Quantity Order no Universal bracket for housing myDatanet 86x126 1 206 640 DIN rail mounting set for myDatanet housing 86x126 1 206 6...

Page 204: ...g temperature 1 300558 PSU DC Li Po 900mAh 20 60 C operating 0 40 C charging temperature 1 300798 18 5 Charging devices and power supply units Description Quantity Order number Power supply 24V 1A 1 213 814 Power supply 12V 1 25A 1 206 623 Power supply 24V 2 5A for top hat rail mounting 1 206 667 Snap on primary plug EU for chargers power supplies 1 300027 Snap on primary plug UK for chargers powe...

Page 205: ...Chapter 19 Document history Chapter 19 Document history Rev Date Changes 01 28 08 2020 First version Rev 01 205 ...

Page 206: ......

Page 207: ...example By setting a measurement value to NaN it is clearly marked as invalid and is thus not used for any further calculations In the measurement value graphs a measurement value that has been set to NaN is indicated by an interruption in the graph When downloading the data a measurement value set to NaN is indicated by an empty data field Rev 01 207 ...

Page 208: ......

Page 209: ... Hauptstrasse 7 3244 Ruprechtshofen Austria Europe Tel 43 0 2756 7718023 support microtronics com www microtronics com Microtronics Engineering GmbH Headquarters Hauptstrasse 7 3244 Ruprechtshofen Austria Europe Tel 43 0 2756 77180 Fax 43 0 2756 7718033 office microtronics com www microtronics com Rev 01 209 ...

Page 210: ...01 2011 for myDatanet TÜV SÜD ATEX Directive 2014 34 EU Microtronics Engineering GmbH All rights reserved Photos Microtronics 301115 Rev 01 Microtronics Engineering GmbH www microtronics com Hauptstrasse 7 3244 Ruprechtshofen Austria 43 2756 77180 office microtronics com ...

Reviews:

No comments