Tutorial measuring data

Contributors

  • Romain Delpoux, 2021.11.04
  • Loic Queval, 2021.11.05
  • Adrien Prévost, 2021.11.05
  • Luiz Villa, 2021.11.07
  • Antoine Boche, 2021.11.08

Tutorial Communication

The goal of this tutorial is to explore how to define the O2 power converter hardware from software. You will define a measurement, acquire it and show it on the serial monitor. We will start from the Communication Tutorial project.

The blocks used in this tutorial are shown in the figure below.

Tutorial_measurement_v1

Required hardware

  • O2 v_1_1_2
  • STLinkV3
  • PC (windows or linux)
  • power supply (40 V, 2 A)

Create the project

  1. We will create the project by copying the communication project in a new branch, that will be called measurements. In the terminal,
  1. On the bottom menu, check that you are now in the measurements branch.

measurement_branch_view_1

  1. Check the libraries

In src/main.cpp, check that we load the owntech.ini libraries and the OS drivers:

  1. Define the hardware by software !

In src/main.cpp, you will find the setup_hardware() function add the following code to initialize the Analog-to-Digital-Converter with

  1. Define the communication task and the communication menu

In src/main.cpp, the functions setup_communication_task(), loop_communication_task() and menu()remain unchanged.

  1. Define the application task

In src/main.cpp, add the following code to define the variables that will be used by the application task to print the Vhigh measurement value:

In src/main.cpp, in the function setup_application_task(), do not modify anything. This task will link your application task to a thread which will be executed automatically.

In src/main.cpp, in the function loop_application_task(), add the following code to define the application task. In this example, it will turn the LED on and off depending on the mode chosen by the user. When the led is ON the O2 converter will print the value of Vhigh on the Serial Monitor.

  1. Define the control task

In src/main.cpp, in the function setup_control_task(), add the following code to setup a control task. These lines initialize the loop_control_task, define its duration and setup some parameters we will look into later and that we will simply set at 1 for now. The last line activates the timer, launching the control task.

In src/main.cpp, in the function loop_control_task(), add the following code to define the control task loop. This loop will acquire the data we want to display, convert it from raw bit values into Volts and store it into a variable that can be accessed by the application task.

  1. Connect hardware

Now we will connect OwnTech’s O2 to the power supply and to the PC.

  • Connect the pins Vhigh and GND of the O2 to the 40 V power supply (set the current limitation at 1 A).
  • Connect the micro-JTAG connector of the O2 to the PC thanks to the STLinkV3. The leds PWR and COM should be ON.
  • Switch on the power supply. The led2 of the O2 should be ON.

step6

  1. In the bottom menu, click on the Build icon build_icon. This will launch the compilation of the code. When the compilation is completed, you should see [SUCCESS] in the terminal.

  2. On the bottom menu, click on the Upload icon flash_icon. This will flash the compiled code on the microcontroller of the O2. When the process is completed, you should see [SUCCESS] in the terminal.

  3. On the bottom menu, click on the Serial Monitor icon serial_icon. Should print you a menu for you at first. When you press the p button on your keyboard, the LED will turn ON and the Vhigh data will show on the termina. Hit the i button to turn it the LED OFF and stop the data display.

Expected outputs

  • The led1 of the O2 should start as off.
  • The led1 of the O2 should turn on when you press the p button.
  • The led1 of the O2 should turn off when you press the i button.

That’s it!