background image

R36US0002EU0100 Rev 1.00

 Page 4

Aug 26, 2021

RTD120D-EVK Evaluation Kit Software Manual

Note

: Terminal mode uses a “stateless” command line interface model, meaning, all commands are available at all 

times. This is in contrast to a multi-level, menu-driven command line interface, where the available commands 

depend on commands that have already been executed. The stateless model was chosen as it is more 

convenient for applications created by the end user, or simple extensions to data processing systems such as 

MatLab, where a program running on the host computer must be able to access all commands without the 

complexity of keeping track of the state of the interface. As a basic example, a python script that needs to access 

various bits of data from the EVK can simply call an interrogation function to read a parameter or sensor reading 

whenever it needs to. 
Commands are not case-sensitive, so “

start ppm

” is equivalent to “

START PPM

” and to “

Start PPM

”, etc. 

The available commands include interrogation commands, starting with “

=

” (such as “

=PPM

”), parameter setting 

commands starting with “

set

“ (such as “

set S1_RAW 1234.56

“ and “

set FILTER_ADC

”), and “FORCE_COIL” 

commands starting with “

!

”. FORCE_COIL commands are simple commands with low communications overhead, 

using the ModBus FORCE_COIL primitive. 
For a list of supported commands, see 

Appendix B: Terminal Mode Commands

2.  ModBus Example: DAQFactory

The 

Thermopile CO

2

 Detector Software

 consists of data acquisition software (DAQFactory Express, available 

from AzeoTech) and “control” files that configure DAQFactory to be used with the Thermopile CO

2

 Detector EVK. 

The control files are available for download from the 

RTD120D-EVK

 product page

.

 When opened by DAQFactory, 

these control files provide useful functionality without modification but they can also be customized by the user to 

change and add functionality. New control files can also be created from scratch; however, for the beginner user, it 

is easier to use one of the provided control files and just modify it instead of creating one from scratch. To do this, 

save one of the provided control files under a new name and then modify the file in order as not to lose the original 

capability. 
DAQFactory

 

is a data acquisition and processing platform that can communicate using the ModBus RTU protocol, 

over a USB serial connection transport. It provides a GUI that can be used to monitor and process real-time data 

streaming from the evaluation board. Actions can also be initiated from the GUI to cause operations on the EVK to 

be carried out, such as adjusting filter settings and saving calibration data points.
The free version, “DAQFactory Express”, has all the functionality needed to access basic features of the EVK, 

including monitoring readings of CO

2

, viewing intermediate variables, calibrating the CO

2

 detection algorithm, and 

monitoring the temperature, relative humidity, and barometric pressure from the other sensors on the EVK.
The DAQFactory “control” files (with extension .ctl) contain GUI screen definitions, application-specific 

communication settings, and scripts for various purposes. The control files for use with the EVK can be 

downloaded from the 

RTD120D-EVK

 product page. Opening a control file in DAQFactory is all that is needed to 

start using the GUI with the EVK for control, monitoring and calibrating.

2.1  Installing DAQFactory Express

To install DAQFactory Express, go to the 

AzeoTech

 website and download version 18.1 or later of DAQFactory 

Express. This will install an “Evaluation” version of the full DAQFactory application, as well as the “Express” 

version, which has no time limit but some functionality is limited. 
For basic monitoring and visualization (plotting) of on-board sensors and system parameters, as well as 

calibration of the CO

2

 algorithm and miscellaneous control of the EVK, the “Express” version of DAQFactory has 

all the necessary functionality. Other applications that can act as a 

ModBus RTU

 master over USB can also be 

used. This is supported by the EVK’s firmware, but additional configuration is required that is specific to the 

desired 

ModBus

 application. 

Note

: After installing DAQFactory, either version can be run from the Start menu; however, Renesas recommends 

running the Express version because it does not have a time limit. If you require more capability beyond the needs 

Summary of Contents for RTD120D-EVK

Page 1: ...ings of other sensors on the board that is barometric pressure relative humidity and ambient temperature In addition to the stand alone operation described above the EVK can provide advanced functionality when connected to a host computer This document explains how to use the EVK with application software running on a host PC in order to provide additional capability including 1 Remote monitoring ...

Page 2: ...e next re start Acting as a ModBus agent that byte and all subsequent received bytes are separated into packets and interpreted as ModBus requests If the first byte is anything other than binary 0 1 2 3 4 5 6 or 7 it is assumed to be part of a text command The remaining bytes are interpreted as characters of a text command and the EVK operates in terminal mode until the next re start Regardless of...

Page 3: ... characters to be pasted into such a terminal program without any data loss Renesas recommends to configure a 5 millisecond delay between sent characters in the terminal program s settings For example in Tera Term the following setup works reliably when pasting text into the terminal window MENU Setup Serial Port Terminal mode does not echo characters as they are received This is to make it easier...

Page 4: ...ave one of the provided control files under a new name and then modify the file in order as not to lose the original capability DAQFactory is a data acquisition and processing platform that can communicate using the ModBus RTU protocol over a USB serial connection transport It provides a GUI that can be used to monitor and process real time data streaming from the evaluation board Actions can also...

Page 5: ...e EVK and a programming debug interface using two different connector options The programming debug interface can be used to support developing custom firmware to run on the EVK using Renesas Flexible Software Package FSP and the Renesas e2studio Eclipse based IDE For more information contact Renesas Technical Support 2 3 Establishing a Connection with the EVK After installing DAQFactory Express c...

Page 6: ...necting the USB cable between the kit and your PC This port number is remembered whenever you save the control file so it will most likely already be correct if you recently connected to the same EVK on this port 3 Click Save then click OK Communication between DAQFactory and the EVK will start automatically If you subsequently disconnect and re connect the EVK from your PC then you must complete ...

Page 7: ...g the LCD and push button user interface on the EVK itself With a GUI using a connected PC for a more interactive and visual experience This section describes the GUI based method of CO2 calibration To calibrate the kit without using a connected host computer instead using the LCD and pushbutton UI see the RTD120D EVK CO2 EVK User Manual 2 5 1 General Calibration Principles The EVK continuously re...

Page 8: ...ided by the GUI is to allow the calibration procedure to be performed in a more interactive visual manner For this a control file must be loaded by DAQFactory which defines user interface elements such as live graphs and buttons to aid in performing calibration From DAQFactory open the control file calibrate ctl This file is included in the GUI download from the RTD120D EVK product page The initia...

Page 9: ...tc containing the respective concentration of CO2 gas Connect a supply hose from a calibration gas canister flowing at approximately 3 liters per minute to a fitting that guides the flow of gas into one of the holes at the top edge of the kit s aluminum gas chamber Place the kit in a location where the ambient gas is the gas with the known CO2 such as outdoor air 2 Connect to the EVK see Establish...

Page 10: ...int or three point calibration 4 The plot on the top left passively shows the current calibration points visually raw value versus concentration in ppm Pressing the green refresh r132 button refreshes this image at any time during the calibration process If you do 3 point calibration instead of 4 point the right most point will show a value of 1 which is OK It will be ignored in that case and the ...

Page 11: ...the raw value change you can use them to save some time in this part of the procedure The filter buttons can be used to change the number of samples used in the two digital filter stages in order to speed up the convergence of the raw value and also the calculated CO2 concentration value to a steady reading If you use these buttons be sure to restore the filter settings to the default values shown...

Page 12: ...but it is a good idea to save after each one The EVK is now calibrated and the kit will immediately begin computing and reporting the CO2 concentration of gas in the aluminum gas chamber While DAQFactory is still connected to the kit the CO2 Concentration plot will continuously display the CO2 values over time It may take a minute or two for the calibration gas especially 1000 or 2000 ppm in the c...

Page 13: ...neously measure the infrared light intensity of both the sensitive wavelength of CO2 and of the reference wavelength The reference light is not affected by CO2 MCU RA4W1 3 3V GPIO BLE Thermopile to PC bridge Format conversion Basic UI System control Communications Integrated Data Flash for calibration parameter etc HS3001 Temp Humidity Sensor GPIO pushbutton switches Linear Regulator with soft sta...

Page 14: ...orts in parts per million PPM once per cycle stop ppm Stop streaming CO2 concentration reports set param value set a parameter to a value set s1_raw value Set calibration raw 1 point set s1_raw 1234 56 set s2_raw value set s3_raw value set s4_raw value set s1_ppm value Set calibration ppm 1 point set s2_ppm value set s3_ppm value set s4_ppm value set serial_number value Set serial_number 123 set f...

Page 15: ...rs2 Report variables group 2 CO2_ppm dC BP_mbar HS3001_RH_percent HS3001_dC THERM_R THERM_dC UNUSED_volts sn Get serial number sw_rev Get software revision s1_ppm Get calibration ppm 1 point s2_ppm s3_ppm s4_ppm s1_raw Get calibration raw 1 point s2_raw s3_raw s4_raw thermistor Get thermistor temperature degrees C ppm Get CO2 concentration in PPM bp Get barometric pressure reading millibars rh Get...

Page 16: ...ith lamp OFF 65 Set Defaults 66 Load Defaults 67 Turn lamp ON 68 Turn lamp OFF 69 Set calibration raw 1 point 70 Set calibration raw 2 point 71 unused 72 unused 73 filter 2 74 filter 4 75 filter 8 76 filter 12 77 filter 20 78 filter 30 79 filter 40 80 clear warm up flag 81 compute slope 82 filter 1 83 Set calibration raw 3 point 84 flash read 85 flash write 86 flash init 87 filter_adc 1 88 filter_...

Page 17: ...ftware Manual 5 Revision History 93 unused 94 compute droop 95 unused 96 Set calibration raw 4 point save_to_flash Save parameters to flash memory Revision Date Description 1 00 Aug 26 2021 Initial release Table 2 Terminal Commands Cont Command Parameters Description Example ...

Page 18: ...re intended for developers skilled in the art designing with Renesas products You are solely responsible for 1 selecting the appropriate products for your application 2 designing validating and testing your application and 3 ensuring your application meets applicable standards and any other safety security or other requirements These resources are subject to change without notice Renesas grants yo...

Reviews: