Wiki

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
resources:eval:user-guides:eval-adicup360:reference_designs:demo_cn0398 [20 Jun 2017 20:03] – added all about circuits video Brandon Busheyresources:eval:user-guides:eval-adicup360:reference_designs:demo_cn0398 [12 Dec 2017 21:45] Brandon Bushey
Line 3: Line 3:
 The **ADuCM360_demo_cn0398** is a pH and moisture measurements demo project, for the EVAL-ADICUP360 base board with additional EVAL-CN0398-ARDZ shield, created using the  GNU ARM Eclipse Plug-ins in Eclipse environment.  The **ADuCM360_demo_cn0398** is a pH and moisture measurements demo project, for the EVAL-ADICUP360 base board with additional EVAL-CN0398-ARDZ shield, created using the  GNU ARM Eclipse Plug-ins in Eclipse environment. 
  
-\\ 
 ===== General description ===== ===== General description =====
  
Line 79: Line 78:
 </code> </code>
  
-\\+===== Demo Requirements ===== 
 + 
 +The following is a list of items needed in order to replicate this demo. 
 +  * Hardware 
 +    * EVAL-ADICUP360 
 +    * EVAL-CN0398-ARDZ 
 +    * pH probe with BNC connector 
 +    * Analog Moisture sensor 
 +    * PT100 RTD Probe 
 +    * 7V to 12V DC Power Supply 
 +    * Mirco USB to USB cable 
 +    * PC or Laptop with a USB port 
 +  * Software 
 +    * ADuCM360_demo_cn0398 software 
 +    * CrossCore Embedded Studio (2.7.0 or higher) 
 +    * ADuCM36x DFP (1.0.2 or higher) 
 +    * CMSIS ARM Pack (4.3.0 or higher) 
 +    * Serial Terminal Program  
 +      * Such as Putty or Tera Term
  
 ===== Video ===== ===== Video =====
Line 102: Line 119:
 ===== Setting up the hardware ===== ===== Setting up the hardware =====
  
-Plug the **EVAL-CN0398-ARDZ** shield into the **EVAL-ADICUP360** board. In order to program the base board you need to use the **DEBUG USB**. After you program the board you can switch to **USER USB** and you are set to use the applicationThe important jumpers and switches configuration are highlighted in red.+  - To program the base board, set the jumpers/switches as shown in the next figure. The important jumpers/switches are highlighted in red.{{ :resources:eval:user-guides:eval-adicup360:reference_designs:cn0398:adicup360_hardware.jpg?650 |}} 
 +  - Connect the **EVAL-CN0398-ARDZ** to the Arduino connectors **P2, P5, P6, P7, P8** of the **EVAL-ADICUP360** board. 
 +  - Connect the pH sensor to the **J1** connector of the EVAL-CN0398-ARDZ. 
 +  - Connect the RTD sensor to the **P1** connector of the EVAL-CN0398-ARDZ.[[https://wiki.analog.com/resources/eval/user-guides/eval-adicup360/hardware/cn0398#rtd_connector_p1|(see connection details)]] 
 +  - Connect the moisture sensor to the **P2** connector of the EVAL-CN0398-ARDZ.[[https://wiki.analog.com/resources/eval/user-guides/eval-adicup360/hardware/cn0398#moisture_sensor_connector_p2|(see connection details)]] 
 +<note important>Extremely important to plug in an acceptable power supply to the barrel jack **P11** of the EVAL-ADICUP360 if you are using a moisture sensor that requires voltage excitation greater than 5V on the **EVAL-CN0398-ARDZ** Only moisture sensors using  less than 3.3V can run off the USB power option.</note> 
 +  - Set the jumpers on the **EVAL-CN0398-ARDZ** to the position shown below.  FIXME (need picture) 
 +  - Plug in the USB cable from the PC to the EVAL-ADICUP360 base board via the Debug USB.(P14)
  
-{{:resources:eval:user-guides:eval-adicup360:reference_designs:cn0398:adicup360_hardware.jpg?650|}} 
-\\ 
- 
-The ADuCM360_demo_cn0398 uses **UART** connection via **P0.6/P0.7** of the ADuCM360 to communicate with EVAL-CN0398-ARDZ board and **SPI** communication via SPI1, with **CS** selection on **P0.3**. 
-\\ 
-\\ 
 ===== Obtaining the source code ===== ===== Obtaining the source code =====
  
-We recommend not opening the project directly, but rather import it into Eclipse and make a local copy in your Eclipse workspace. +We recommend not opening the project directly, but rather import it into CCES and make a local copy in your workspace. 
  
 The source code and include files of the **ADuCM360_demo_cn0398** can be found on Github: The source code and include files of the **ADuCM360_demo_cn0398** can be found on Github:
  
-<WRAP round 40% download> +<WRAP round 80% download> 
 +\\  
 +CrossCore Embedded Studio Application Source Code: 
 +\\  
 +\\ 
 [[https://github.com/analogdevicesinc/EVAL-ADICUP360/tree/master/projects/ADuCM360_demo_cn0398| AduCM360_demo_cn0398 at Github]] [[https://github.com/analogdevicesinc/EVAL-ADICUP360/tree/master/projects/ADuCM360_demo_cn0398| AduCM360_demo_cn0398 at Github]]
-  
 </WRAP> </WRAP>
  
 +<WRAP center round info 80%>
 +For more information on importing, debugging, or other tools related questions, please see the [[https://wiki.analog.com/resources/eval/user-guides/eval-adicup360/tools/cces_user_guide |tools user guide.]] 
 +</WRAP>
  
-\\ +===== Configuring the Software Parameters =====
-===== Importing the ADuCM360_demo_cn0398 project =====+
  
-The necessary instructions on how to import the **ADuCM360_demo_cn0398** project form the projects examples in the Git repository, can be found in [[resources:eval:user-guides:eval-adicup360:quickstart:eclipse_user_guide#how_to_import_existing_projects_from_the_git_repository|How to import existing projects from the GIT Repository]] page.+  * **Zero point tolerance** - //ZERO_POINT_TOLERANCE// parameter - used in Nerst equation - input voltage value in [V] (//CN0398.h//). 
 +  * **Terminal refresh** //DISPLAY_REFRESH// parameter how often to refresh the output data - input time value in [msec(//CN0398.h//). 
 +  * **Moisture calculation formula** - //USE_MANUFACTURER_MOISTURE_EQ// parameter - which formula to use in order to calculate the moisture value - commented -> transfer function, uncommented -> manufacturer formulas(//CN0398.h//).
  
 +===== Outputting Data =====
 +
 +==== Serial Terminal Output ====
 +
 +  - In order to view the data, you must flash the program to the EVAL-ADICUP360.  
 +  - Once complete you will need to switch the USB cable from the DEBUG USB (P14) to the USER USB (P13).  
 +  - Then follow the UART settings below with the serial terminal program.
 +\\ 
 +
 +Following is the UART configuration.
 +    Select COM Port
 +    Baud rate: 115200
 +    Data: 8 bit
 +    Parity: none
 +    Stop: 1 bit
 +    Flow Control: none
 \\ \\
  
-===== Debugging the ADuCM360_demo_cn0398 project =====+  * The software will ask if you want to do a calibration, so type in [**n**] or [**y**]. 
 +  * If [n] is selected, the software will ask if you would like to load the default configuration, or use the Nernst equations.  Select one option. 
 +  * The data output refreshes in the console window at the rate of the "display_refresh" parameter with the following results.
  
- * A debug configuration must be set up for this project in order to have the possibility to program and to debug the **ADuCM360_demo_cn0398** project. To do this, follow the instructions from [[resources:eval:user-guides:eval-adicup360:quickstart:eclipse_user_guide#setting_up_a_debug_configuration_for_the_project|Setting up a Debug Configuration Page.]]+{{ :resources:eval:user-guides:eval-adicup360:reference_designs:cn0398:cn0398_demo_3.png?800 |}}
  
-        * Make sure the target board is connected to the computer (via **DEBUG USB**) and using the tool bar, navigate to the small Debug icon {{:resources:eval:user-guides:eval-adicup360:reference_designs:cn0398:bug.png |}}and select the debugging session you created. The application will programmed and the program execution will stop at the beginning of the main() function.{{ :resources:eval:user-guides:eval-adicup360:reference_designs:cn0398:debug_cn0398.png |}}+===== How to use the Tools =====
  
-        * Use step-by-step execution or directly run the program+The official tool we promote for use with the EVAL-ADICUP360 is CrossCore Embedded Studio.  For more information on downloading the tools and a quick start guide on how to use the tool basics, please check out the [[resources:eval:user-guides:eval-adicup360:tools|Tools Overview page.]] 
-  + 
-After completion of the steps above the program will remain written into the system flash and it will run by default every time the board is powered up.+==== Importing ==== 
 + 
 +For more detailed instructions on importing this application/demo example into the CrossCore Embedded Studios tools, please view our [[resources:eval:user-guides:eval-adicup360:tools:cces_user_guide#how_to_import_existing_projects_into_your_workspace|How to import existing projects into your workspace]] section. 
 + 
 +==== Debugging ==== 
 + 
 +For more detailed instructions on importing this application/demo example into the CrossCore Embedded Studios tools, please view our [[resources:eval:user-guides:eval-adicup360:tools:cces_user_guide#how_to_configure_the_debug_session_for_an_aducm360_application|How to configure the debug session]] section.
  
-\\ 
 ===== Project Structure ===== ===== Project Structure =====
  
Line 154: Line 201:
  
 \\ \\
-In the appropriate header files you can **configure** next **parameters**: +The **RTE** folder contains device and system related files
-            * **Zero point tolerance** - //ZERO_POINT_TOLERANCE// parameter - used in Nerst equation - input voltage value in [V] (//CN0398.h//). +            * **Device Folder** – contains low levels drivers for ADuCM360 microcontroller.(try not to edit these files
-            * **Terminal refresh** - //DISPLAY_REFRESH// parameter - how often to refresh the output data - input time value in [msec] (//CN0398.h//). +            * **system.rteconfig** - Allows the user to select the peripherial components they needalong with the startup and ARM cmsis files needed for the project. 
-           * **Moisture calculation formula** - //USE_MANUFACTURER_MOISTURE_EQ// parameter - which formula to use in order to calculate the moisture value - commented -> transfer functionuncommented -> manufacturer formulas(//CN0398.h//).+\\  
 +\\
  
- +// End of Document //
-\\ +
-The **system** folder contains system related files (try not to change these files): +
-            * **aducm360** – contains low levels drivers for ADuCM360 microcontroller. +
-            * **cmsis** – contains files related to ADuCM360 platform, such as: //ADuCM360.h// (registers definitions), //system_ADuCM360.c/h// (system clock), //vectors_ADuCM360.c// (interrupt vector table). +
-            * **cortexm** – contains files for system management (start-up, reset, exception handler). +
-\\ +
-\\ +
-\\ +
-  +
-//End of Document//+
resources/eval/user-guides/eval-adicup360/reference_designs/demo_cn0398.txt · Last modified: 14 Mar 2021 10:07 by Zuedmar Arceo