Wiki

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
resources:eval:user-guides:circuits-from-the-lab:cn0548 [22 Sep 2021 03:36]
erbe reyta [Simplified Block Diagram]
resources:eval:user-guides:circuits-from-the-lab:cn0548 [19 Oct 2021 11:59]
Harvey John De Chavez [Running the Example]
Line 17: Line 17:
  
  
- ​1. Follow the figure below for the position of shunt jumpers for headers P1, P3, P10, P8, P9, and P11. Make sure that is set at 16V max input for the voltage sensing, follow jumper settings stated in the table below encircled in red for 16V maximum input.+  
 +1. Place the shunt jumpers connected to P15 as the default position for the Chip Select. 
 +{{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​chip_select_default_settings.png?​400 |}} 
 +2. Follow the figure below for the position of shunt jumpers for headers P1, P3, P10, P8, P9, and P11. Make sure that is set at 16V max input for the voltage sensing, follow jumper settings stated in the table below encircled in red for 16V maximum input.
  
 {{:​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​limit_table_vsense.png?​600|}} {{:​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​limit_table_vsense.png?​600|}}
Line 23: Line 26:
 {{:​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​cn0548_header_placement_images2.png?​600|}} {{:​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​cn0548_header_placement_images2.png?​600|}}
  
-2. Place all the shunt jumpers connected to GND, headers P12, P13, P14 and P7 as default position for measurements in unipolar mode. Refer to the figure below for correct jumper settings.+3. Place all the shunt jumpers connected to GND, headers P12, P13, P14 and P7 as default position for measurements in unipolar mode. Refer to the figure below for correct jumper settings.
 {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​cn0548_vref_shunt_setup.png?​600 |}} {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​cn0548_vref_shunt_setup.png?​600 |}}
  
-3. Place the shunt jumpers connected to P15 as the default position for the Chip Select.+4. Place the shunt jumpers connected to P15 as the default position for the Chip Select.
 {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​chip_select_default_settings.png?​400 |}} {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​chip_select_default_settings.png?​400 |}}
  
-4. Referring to step 1, where you uploaded the .hex file firmware to ADICUP3029. Now run the executable GUI “ad7799_py_new.exe” located inside “ad7799_app” folder. It will take for about a minute before the CN0548 app will show up on your PC display. Please see figure 6 for CN0548 GUI upon start. Once the application is running, determine the comport at your device manager window and type it in the “COMPort “ number. See figure below for device manager comport number. Then input the correct comport number then press “connect” button see figure 8 for successful connection.+5. Referring to step 1, where you uploaded the .hex file firmware to ADICUP3029. Now run the executable GUI “ad7799_py_new.exe” located inside “ad7799_app” folder. It will take for about a minute before the CN0548 app will show up on your PC display. Please see figure 6 for CN0548 GUI upon start. Once the application is running, determine the comport at your device manager window and type it in the “COMPort “ number. See figure below for device manager comport number. Then input the correct comport number then press “connect” button see figure 8 for successful connection.
  
 \\ \\ \\ \\
Line 92: Line 95:
  
 ===Starting a new session === ===Starting a new session ===
-  - Download the given python script into the //​examples//​ folder of the pyadi-iio directory. Using a terminal, navigate to the said folder and invoke the script. <​code>​ python CN0548_simple_plot.py </​code>​ <WRAP round 80% download>​ Below is a copy of the python script: \\ {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​cn0548_simple_plot.zip |CN0548_simple_plot.py}} ​\\ to be updated</​WRAP>​+  - Download the given python script into the //​examples//​ folder of the pyadi-iio directory. Using a terminal, navigate to the said folder and invoke the script. <​code>​ python CN0548_simple_plot.py </​code>​ <WRAP round 80% download>​ Below is a copy of the python script: \\ {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​cn0548_simple_plot.zip |CN0548_simple_plot.py}} </​WRAP>​
   - Upon running the script, some general reminders regarding the board usage will be displayed. Make sure to read these reminders before proceeding. Press the //Enter// key to proceed. {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​reminder.png?​600 |}}\\   - Upon running the script, some general reminders regarding the board usage will be displayed. Make sure to read these reminders before proceeding. Press the //Enter// key to proceed. {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​reminder.png?​600 |}}\\
   - As mentioned earlier, the board has a memory feature that allows the user to quickly configure the sample code using the configuration from the last session. The user can decide whether to reuse the previous setting or set up a new configuration. The next items will discuss the program flow given that no session record file is found i.e. first run of the sample code. {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​new_overview.png?​600 |}}  \\ \\   - As mentioned earlier, the board has a memory feature that allows the user to quickly configure the sample code using the configuration from the last session. The user can decide whether to reuse the previous setting or set up a new configuration. The next items will discuss the program flow given that no session record file is found i.e. first run of the sample code. {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​new_overview.png?​600 |}}  \\ \\
-  - In a separate window, ​the program will first create ​simple ​jumper map that corresponds ​to the jumpers on the board --- this might take a few seconds depending on the user's machine. The program will then prompt the user for the voltage and current ​modes to be used. {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​board_jumper.jpg?​600 |}} The user will be asked to specify whether the voltage measurements would be unipolar or bipolar as well as the expected range of values to be sensed. On the other hand, the user only needs to specify whether the current measurements would be unidirectional or bidirectional. The jumper map will be updated as the user answers the configuration queries. ​{{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​sample_configuration.png?​800 |}}Configure ​the board jumpers ​as shown in the jumper map and press the //Enter// key to proceed. In this example, the jumper map shows a 16V unipolar 20A unidirectional configuration.\\ \\+  - The user will be asked to specify the expected voltage and current inputs i.e. whether unipolar or bipolar for the voltage and unidirectional or bidirectional for the current. ​In a separate window, a jumper map will be created corresponding ​to the voltage and current ​setting specified by the user {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​board_jumper.jpg?​600 |}} {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​sample_configuration.png?​800 |}} \\ You may close the jumper window upon configuring ​the board jumpers.\\ \\
   - After the board jumper configuration guide, the program will now begin its software configuration related queries. The table below shows the aspects that the user must configure. {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​table_config.png?​600 |}} \\   - After the board jumper configuration guide, the program will now begin its software configuration related queries. The table below shows the aspects that the user must configure. {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​table_config.png?​600 |}} \\
   - Lastly, the sample code will ask the user for the port where the ADICUP3029 is connected. If the port is found, the sample code is now ready to parse readings from the board. Press //Enter// key to start board operation. \\ {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​software_config.png?​600 |}}\\ Regardless of whether the plot window is enabled or not, the board readings will be continuously displayed in the terminal. \\ {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​readings.png?​600 |}} \\ In the next two figures, the CN0548 was used to monitor the performance of a 5V regulator. The first figure shows a plot in tracking mode where all data points are displayed. The second figure on the other hand is in non-tracking mode where the last 50 samples are being displayed. \\ \\ **Tracking Mode:** {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​tracking.png?​600 | }} \\ **Non-tracking Mode:​** ​ {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​non-tracking_a.png?​600 | }} \\ Tracking mode allows the user to observe the overall characteristic of the signal being measured. However, it should be noted that the plot will continue to compress as more data points are added. Non-tracking mode on the other hand allows a more refined view as it only shows the most recent measurements as desired by the user. \\   - Lastly, the sample code will ask the user for the port where the ADICUP3029 is connected. If the port is found, the sample code is now ready to parse readings from the board. Press //Enter// key to start board operation. \\ {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​software_config.png?​600 |}}\\ Regardless of whether the plot window is enabled or not, the board readings will be continuously displayed in the terminal. \\ {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​readings.png?​600 |}} \\ In the next two figures, the CN0548 was used to monitor the performance of a 5V regulator. The first figure shows a plot in tracking mode where all data points are displayed. The second figure on the other hand is in non-tracking mode where the last 50 samples are being displayed. \\ \\ **Tracking Mode:** {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​tracking.png?​600 | }} \\ **Non-tracking Mode:​** ​ {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​non-tracking_a.png?​600 | }} \\ Tracking mode allows the user to observe the overall characteristic of the signal being measured. However, it should be noted that the plot will continue to compress as more data points are added. Non-tracking mode on the other hand allows a more refined view as it only shows the most recent measurements as desired by the user. \\
Line 102: Line 105:
 </​note>​ </​note>​
 ===Data Logging=== ===Data Logging===
-The data logging feature allows the user to log all measurements into a csv file. If enabled, the csv file will be created in the same folder where the sample code is located and will follow the naming scheme //​CN0548_[timestamp]//​. ​However, the saving of data is slightly different when the plot window is enabled{{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​csv_file.png?​600 |}}\\ \\ +The data logging feature allows the user to log all measurements into a csv file. If enabled, the csv file will be created in the same folder where the sample code is located and will follow the naming scheme //​CN0548_[timestamp]//​. ​Data is automatically written upon parsingHence, even if the program ​is prematurely terminatedall parsed ​data are recorded. {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​csv_file.png?600 |}}\\ \\
-When the plot window ​is not utilizednew data measurements ​are immediately saved into the csv file as new data points are read from the boardOn the other hand, when the plot window is active, data points will only be saved upon closing the plot window. This is done in order to facilitate a smoother environment. Note that premature termination of the program by directly closing the terminal will result to loss of data. This reminder is also displayed in the plot window whenever data logging is enabled.  ​{{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​non-tracking.png?600 |}} \\+
  
 ===Memory Feature=== ===Memory Feature===
-{{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​old_overview.png?​600 |}}The memory feature of the board allows the user to quickly configure the sample code using the setup from the previous session in order to begin sensing data immediately. This is done by saving all user input and creating a //​session_record//​ text file in the same directory where the sample code is located. {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​session_record.png?​600 |}}Note that the contents of the session record file is not encrypted and is easily understandable. Each line begins with a number which corresponds to a certain setting. For instance, 1 corresponds to the Unipolar voltage setting and 2 will correspond to the Bipolar voltage setting. Hence, if the user just wants to reconfigure a minor aspect of the setup (use tracking mode instead non-tracking,​ adjust the sampling rate, enable or disable data logging, etc.), the user can quickly reconfigure the sample code by editing the //​session_record//​ file. The program is able to detect whether the set of specifications in the session record is valid or not. If the configuration set by the user is not valid, the program will still proceed as usual and will assume no session record file was detected. \\ \\ {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​session_record_detected.png?​600 |}} If the user chooses to use the configuration loaded from the session record, the only query left to be answered is the port where the ADICUP3029 is attached. The program does not save the previous port used since the device might be connected in a different port of the machine.+{{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​old_overview.png?​600 |}}The memory feature of the board allows the user to quickly configure the sample code using the setup from the previous session in order to begin sensing data immediately. This is done by saving all user input and creating a //​session_record//​ text file in the same directory where the sample code is located. {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​session_record.png?​600 |}} Note that the contents of the session record file is not encrypted and is easily understandable. Each line begins with a number which corresponds to a certain setting. For instance, 1 corresponds to the Unipolar voltage setting and 2 will correspond to the Bipolar voltage setting. Hence, if the user just wants to reconfigure a minor aspect of the setup (use tracking mode instead non-tracking,​ adjust the sampling rate, enable or disable data logging, etc.), the user can quickly reconfigure the sample code by editing the //​session_record//​ file. The program is able to detect whether the set of specifications in the session record is valid or not. If the configuration set by the user is not valid, the program will still proceed as usual and will assume no session record file was detected. \\ \\ {{ :​resources:​eval:​user-guides:​circuits-from-the-lab:​cn0548:​session_record_detected.png?​600 |}} 
resources/eval/user-guides/circuits-from-the-lab/cn0548.txt · Last modified: 28 Jan 2022 13:31 by Harvey John De Chavez