diff --git a/content/hardware/05.nicla/boards/nicla-vision/tutorials/getting-started/content.md b/content/hardware/05.nicla/boards/nicla-vision/tutorials/getting-started/content.md index 1e5bc0105a..f902b1a80e 100644 --- a/content/hardware/05.nicla/boards/nicla-vision/tutorials/getting-started/content.md +++ b/content/hardware/05.nicla/boards/nicla-vision/tutorials/getting-started/content.md @@ -16,7 +16,7 @@ software: --- ## Overview -The OpenMV IDE is meant to provide an Arduino like experience for simple machine vision tasks using a camera sensor. In this tutorial, you will learn about some of the basic features of the OpenMV IDE and how to create a simple MicroPython script. The Nicla Vision board has OpenMV firmware on the board by default, making it easy to connect to the OpenMV IDE. +The OpenMV IDE is meant to provide an Arduino like experience for simple machine vision tasks using a camera sensor. In this tutorial, you will learn about some of the basic features of the OpenMV IDE and how to create a simple MicroPython script. The Nicla Vision has OpenMV firmware on the board by default, making it easy to connect to the OpenMV IDE. ## Goals @@ -33,19 +33,19 @@ The OpenMV IDE is meant to provide an Arduino like experience for simple machine ## Instructions -Using the OpenMV IDE you can run [MicroPython](http://docs.MicroPython.org/en/latest/) scripts on the Nicla Vision board. MicroPython provides a lot of classes and modules that make it easy to quickly explore the features of the Nicla Vision. In this tutorial you will first download the OpenMV IDE and set up the development environment. [Here](https://openmv.io/) you can read more about the OpenMV IDE. OpenMV comes with its own firmware that is built on MicroPython. You will then learn to write a simple script that will blink the on-board RGB LED using some basic MicroPython commands. +Using the OpenMV IDE you can run [MicroPython](http://docs.MicroPython.org/en/latest/) scripts on Nicla Vision. MicroPython provides a lot of classes and modules that make it easy to quickly explore the features of the Nicla Vision. In this tutorial you will first download the OpenMV IDE and set up the development environment. [Here](https://openmv.io/) you can read more about the OpenMV IDE. OpenMV comes with its own firmware that is built on MicroPython. You will then learn to write a simple script that will blink the on-board RGB LED using some basic MicroPython commands. -***Before proceeding with the tutorial please update the board's bootloader. You can do this by first downloading the latest version of the "Mbed OS Nicla core" in the Arduino IDE. Then go to "File > Examples > STM32H747_System > STM32H747_manageBootloader" and upload this sketch to your board. After the sketch is uploaded follow the instructions in the serial monitor.*** +***Before proceeding with the tutorial, please update the board's bootloader. You can do this by first downloading the latest version of the "Mbed OS Nicla core" in the Arduino IDE. Then go to "File > Examples > STM32H747_System > STM32H747_manageBootloader" and upload this sketch to your board. After the sketch is uploaded, follow the instructions in the Serial Monitor.*** ### 1. Downloading the OpenMV IDE -Before you can start programming OpenMV scripts for the Nicla Vision you need to download and install the OpenMV IDE. +Before you can start programming OpenMV scripts for the Nicla Vision, you need to download and install the OpenMV IDE. Open the [OpenMV download](https://openmv.io/pages/download) page in your browser, download the version that you need for your operating system and follow the instructions of the installer. ### 2. Connecting to the OpenMV IDE -Connect the Nicla Vision to your computer via the USB cable if you haven't done so yet. +Connect the Nicla Vision to your computer via the USB cable if you have not done so yet. ![The OpenMV IDE after starting it](assets/openmv_open_ide.png) @@ -57,11 +57,11 @@ A pop-up will ask you how you would like to proceed. Select "Reset Firmware to R ![Install the latest version of the OpenMV firmware](assets/openmv_reset_firmware.png) -Nicla Vision's green LED will start flashing while the OpenMV firmware is being uploaded to the board. A terminal window will open which shows you the flashing progress. Wait until the green LED stops flashing and fading. You will see a message saying "DFU firmware update complete!" when the process is done. +Nicla Vision's green LED will start flashing while the OpenMV firmware is being uploaded to the board. A terminal window will open showing you the flashing progress. Wait until the green LED stops flashing and fading. You will see a message saying "DFU firmware update complete!" when the process is done. ![Installing firmware on Nicla Vision board in OpenMV](assets/openmv_firmware_updater.png) -The board will start flashing its blue LED when it's ready to be connected. After confirming the completion dialog the Nicla Vision should already be connected to the OpenMV IDE, otherwise click the "connect" button (plug symbol) once again. +The board will start flashing its blue LED when it is ready to be connected. After confirming the completion dialog, the Nicla Vision should already be connected to the OpenMV IDE, otherwise click the "connect" button (plug symbol) once again. ![When the Nicla Vision is successfully connected a green play button appears](assets/openmv_board_connected.png) @@ -73,9 +73,9 @@ Create a new script by clicking the "New File" button in the toolbar on the left import pyb # Import module for board related functions ``` -A module in Python is a confined bundle of functionality. By importing it into the script it gets made available. For this example we only need `pyb`, which is a module that contains board related functionality such as PIN handling. You can read more about its functions [here](https://docs.micropython.org/en/latest/library/pyb.html). +A module in Python is a confined bundle of functionality. By importing it into the script, it becomes available. For this example you will only need `pyb`, which is a module that contains board related functionality such as PIN handling. You can read more about its functions [here](https://docs.micropython.org/en/latest/library/pyb.html). -Now we can create the variables that will control our built-in RGB LED. With `pyb` we can easily control each color. +Now you can create the variables that will control our built-in RGB LED. With `pyb` you can easily control each color. ```python redLED = pyb.LED(1) # built-in red LED @@ -83,11 +83,11 @@ greenLED = pyb.LED(2) # built-in green LED blueLED = pyb.LED(3) # built-in blue LED ``` -Now we can easily distinguish between which color we control in the script. +At this point, you can easily distinguish between which color you control in the script. ### 4. Creating the Main Loop in the Script -Putting our code inside a while loop will make the code run continuously. In the loop we turn on an LED with `on`, then we use the `delay` function to create a delay. This function will wait with execution of the next instruction in the script. The duration of the delay can be controlled by changing the value inside the parentheses. The number defines how many milliseconds the board will wait. After the specified time has passed, we turn off the LED with the `off` function. We repeat that for each color. +Putting our code inside a while loop will make the code run continuously. In the loop you can turn on an LED with `on`, then you can use the `delay` function to create a delay. This function will start executing with the next instruction in the script. The duration of the delay can be controlled by changing the value inside the parentheses. The number defines how many milliseconds the board will wait. After the specified time has passed, you can turn off the LED with the `off` function. You can repeat that for each color. ```python while True: @@ -142,7 +142,7 @@ Connect your board to the OpenMV IDE and upload the above script by pressing the ![Press the green play button to upload the script](assets/openmv_board_connected.png) -Now the built-in LED on your Nicla Vision board should be blinking red, green and then blue repeatedly. +Now, the built-in LED on your Nicla Vision board should be blinking red, green and then blue repeatedly. ## Using the Nicla Vision Camera @@ -175,28 +175,28 @@ blueLED.off() print("Done! Reset the camera to see the saved image.") ``` -The camera that comes with the Nicla Vision supports RGB 565 images. That's why we use `sensor.set_pixformat(sensor.RGB565)`, enabling the camera to take an image with color. Then we need to set the resolution of the camera. Here we will use `sensor.set_framesize(sensor.QVGA)`. +The camera that comes with the Nicla Vision supports RGB 565 images. That is why you have to use `sensor.set_pixformat(sensor.RGB565)`, enabling the camera to take an image with color. Then you need to set the resolution of the camera. Here we will use `sensor.set_framesize(sensor.QVGA)`. -Using `sensor.set_vflip` and `sensor.set_hmirror` will help us set the correct orientation of the image. If you hold the board with the USB cable facing down you want to call `sensor.set_vflip(True)`. The image will be mirrored, if you want the image to be displayed as you see it from your perspective, you want to call `sensor.set_hmirror(True)`. +Using `sensor.set_vflip` and `sensor.set_hmirror` will help you set the correct orientation of the image. If you hold the board with the USB cable facing down, you should call `sensor.set_vflip(True)`. The image will be mirrored, if you want the image to be displayed as you see it from your perspective, you should call `sensor.set_hmirror(True)`. -Running this script in OpenMV will show the image that the camera is currently capturing in the top right corner, inside the frame buffer. The onboard red LED will be on for a couple of seconds, then the blue LED will turn on, this indicates when the picture is about to be taken. A message will be printed in the serial terminal when the image is taken. +Running this script in OpenMV will show the image that the camera is currently capturing in the top right corner, inside the frame buffer. The onboard red LED will be on for a couple of seconds, then the blue LED will turn on to indicate when the picture is about to be taken. A message will be printed in the serial terminal when the image is taken. ![Where to see the captured image in OpenMV](assets/openmv-nicla-vision-camera.png) -The image will be saved as "example.jpg" in the boards directory. It is also possible to save the image in a ".bmp" format. If you reset the camera by pressing the reset button the image file will appear in the boards directory. +The image will be saved as "example.jpg" in the boards directory. It is also possible to save the image in a ".bmp" format. If you reset the camera by pressing the reset button, the image file will appear in the boards directory. ## Using the Nicla Vision with Arduino IDE -As mentioned before, the Nicla Vision comes with OpenMV firmware pre installed. This makes it easier to use the board with OpenMV out of the box. It is possible to use the Nicla Vision with the Arduino IDE. First make sure that you have the latest core installed. To install the core navigate into **Tools > Board > Boards Manager...**, in the Boards Manager window search for **Nicla Vision MBED** and install it. When this core is installed and you have your board connected to your computer, select the port that the board is connected to and the boards core. You should now be able to upload an Arduino sketch to the board. +As mentioned before, the Nicla Vision comes with OpenMV firmware pre-installed. This makes it easier to use the board with OpenMV out of the box. However, it is possible to use the Nicla Vision with the Arduino IDE. First make sure that you have the latest core installed. To install the core navigate to **Tools > Board > Boards Manager...**, in the Boards Manager window search for **Nicla Vision MBED** and install it. When this core is installed and you have your board connected to your computer, select the port that the board is connected to and the board core. You should now be able to upload an Arduino sketch to the board. -If you wish to use the board with OpenMV after it has been used with the Arduino IDE, you have to put the board into bootloader mode and install OpenMV firmware. You do this by double pressing the reset button, located next to the LED. When the board is in bootloader mode and connected to your computer, follow the steps above in the **2. Connecting to the OpenMV IDE** section to connect the board to the OpenMV IDE again. +If you wish to use the board with OpenMV after it has been used with the Arduino IDE, you have to put the board into bootloader mode and install OpenMV firmware. You can do this by double pressing the reset button, located next to the LED. When the board is in bootloader mode and connected to your computer, follow the steps above in the **2. Connecting to the OpenMV IDE** section to connect the board to the OpenMV IDE again. ## Conclusion In this tutorial you learned how to use the OpenMV IDE with your Nicla Vision board. You also learned how to control the Nicla Vision's RGB LED with MicroPython functions and to upload the script to your board using the OpenMV IDE. ### Next Steps -- Experiment with MicroPythons capabilities. If you want some examples of what to do, take a look at the examples included in the OpenMV IDE. Go to: **File > Examples > Arduino > ** in the OpenMV IDE. +- Experiment with MicroPythons capabilities. If you want some suggestion on what to do, take a look at the examples included in the OpenMV IDE. Go to: **File > Examples > Arduino > ** in the OpenMV IDE. - It is possible to use the board for more advanced image processing tasks. Be sure to take a look at our other tutorials if you want to learn more. - Take a look at our other Nicla Vision tutorials which showcase its many uses. You can find them [here](https://docs.arduino.cc/hardware/nicla-vision#tutorials). @@ -205,5 +205,5 @@ In this tutorial you learned how to use the OpenMV IDE with your Nicla Vision bo ### OpenMV Firmware Flashing Issues - If the upload of the OpenMV firmware fails during the download, put the board back in bootloader mode and try again. Repeat until the firmware gets successfully uploaded. -- If the OpenMV IDE still can't connect after flashing the firmware, try uploading the latest firmware using the "Load Specific Firmware File" option. You can find the latest firmware in the [OpenMV Github repository](https://github.com/openmv/openmv/releases). Look for a file named **firmware.bin**. +- If the OpenMV IDE still cannot connect after flashing the firmware, try uploading the latest firmware using the "Load Specific Firmware File" option. You can find the latest firmware in the [OpenMV Github repository](https://github.com/openmv/openmv/releases). Look for a file named **firmware.bin**. - If you see a "OSError: Reset Failed" message, reset the board by pressing the reset button. Wait until you see the blue LED flashing, connect the board to the OpenMV IDE and try running the script again. diff --git a/content/hardware/05.nicla/boards/nicla-vision/tutorials/microphone-sensor/content.md b/content/hardware/05.nicla/boards/nicla-vision/tutorials/microphone-sensor/content.md index 30381ce712..120ecc058a 100644 --- a/content/hardware/05.nicla/boards/nicla-vision/tutorials/microphone-sensor/content.md +++ b/content/hardware/05.nicla/boards/nicla-vision/tutorials/microphone-sensor/content.md @@ -29,10 +29,10 @@ In this tutorial you will use the **Arduino Nicla Vision** board to get the micr ## Goals -- Get the microphone data. -- Use the PDM(Pulse-density modulation) library. -- Print the microphone values in the Serial Monitor. -- Change RGB blinking speed with the last microphone reading. (Arduino IDE) +- Get the microphone data +- Use the PDM(Pulse-density modulation) library +- Print the microphone values in the Serial Monitor +- Change RGB blinking speed with the last microphone reading (Arduino IDE) - Show the values on a spectrum analyzer (only with openMV) ### Required Hardware and Software @@ -43,7 +43,7 @@ In this tutorial you will use the **Arduino Nicla Vision** board to get the micr ## Set Up -To check that you correctly set up the board please visit our [Getting Started Guide](https://docs.arduino.cc/tutorials/nicla-vision/getting-started) for both **OpenMV** and **Arduino** instructions. +To check that you correctly set up the board, please visit our [Getting Started Guide](https://docs.arduino.cc/tutorials/nicla-vision/getting-started) for both **OpenMV** and **Arduino** instructions. ## Instructions @@ -53,9 +53,9 @@ Open the script by going to **Examples > Arduino > NanoRP2040 > Audio > Audio_ff ***Using the same sketch as the NanoRP2040, because both boards access the microphone in the same way*** -Make sure the board is connected, if the board is connected to OpenMV you should see a green play button in the bottom left corner of the window. If you do not see this icon, try pressing the connect button in the bottom left corner. If there still is some issue to connect the board take another look at the getting started guide. +Make sure the board is connected, if the board is connected to OpenMV you should see a green play button in the bottom left corner of the window. If you do not see this icon, try pressing the connect button in the bottom left corner. If there still is some issue to connect the board, take another look at the getting started guide. -When the script is running, you will see an spectrum analyzer in the top right panel that reflects the audio readings input. Try making some noise and see how it reacts. +When the script is running, you will see a spectrum analyzer in the top right panel that reflects the audio readings input. Try making some noise and see how it reacts. ![OpenMV IDE - Spectrum analyzer](assets/OpenMV_spectrumAnalyzer.png) @@ -63,13 +63,13 @@ When the script is running, you will see an spectrum analyzer in the top right p #### Setting Up the Sketch -We will edit the example from the mbed Core, go to **Examples > PDM > PDMSerialPlotter** and save it into your sketchbook. +You will edit the example from the mbed Core, go to **Examples > PDM > PDMSerialPlotter** and save it into your sketchbook. You can run the sketch to see the result, it will show the data that the microphone is getting on the **Serial Plotter**. #### Controlling the Blinking LED -Now that you can get the microphone data, let's control the built-in RGB LED and change the speed of its blinking depending on the values by changing the blinking time to the last reading of the microphone, the blink will be slow if the sound is loud, and fast if it is quiet. +Now that you can get the microphone data, let's control the built-in RGB LED and change the speed of its blinking depending on the values, by changing the blinking time to the last reading of the microphone; the blink will be slow if the sound is loud, and fast if it is quiet. You can access the example sketch at **Examples > PDM > PDMSerialPlotter** and then edit as shown in this tutorial. Or find the full edited sketch in our **Arduino_Pro_Tutorials** library. @@ -184,9 +184,9 @@ If you want to test it, the only thing you need to do is to speak or play some s ### Troubleshoot -- In case the Serial Monitor freezes, unplug and then plug the board into your computer again, now try to upload the sketch +- In case the Serial Monitor freezes, unplug and then plug the board into your computer again. Now try to upload the sketch. - If the sketch is not working, try to double tap the reset button and upload the sketch once again. ## Conclusion -You have learned how to use the Arduino IDE and OpenMV to get data from the microphone and then use it to change the RGB LED on the board. This can for example be used as an alarm system to wake the board up and take a screenshot with the Camera. \ No newline at end of file +You have learned how to use the Arduino IDE and OpenMV to get data from the microphone and then use it to change the RGB LED on the board. This can for example be used as an alarm system to wake the board up and take a screenshot with the Camera. diff --git a/content/hardware/05.nicla/boards/nicla-vision/tutorials/nicla-vision-imu/content.md b/content/hardware/05.nicla/boards/nicla-vision/tutorials/nicla-vision-imu/content.md index 654a9422bc..11fc21c195 100644 --- a/content/hardware/05.nicla/boards/nicla-vision/tutorials/nicla-vision-imu/content.md +++ b/content/hardware/05.nicla/boards/nicla-vision/tutorials/nicla-vision-imu/content.md @@ -20,15 +20,15 @@ software: ## Overview -In this tutorial, we will learn how to access the gyroscope and accelerometer that is on the Nicla Vision board. For this, we will be using the [Arduino_LSMDS63](https://www.arduino.cc/en/Reference/ArduinoLSM6DSOX) library and the Arduino IDE. Printing the values in the serial monitor of the Arduino IDE. +In this tutorial, you will learn how to access the gyroscope and accelerometer that are placed on the Nicla Vision board. For this, you will be using the [Arduino_LSMDS63](https://www.arduino.cc/en/Reference/ArduinoLSM6DSOX) library and the Arduino IDE, printing the values in the Serial Monitor of the Arduino IDE. ## Goals The goals of this project are: -- Read accelerometer data. -- Read gyroscope data. -- Print the data in the Serial Monitor. +- Read accelerometer data +- Read gyroscope data +- Print the data in the Serial Monitor ### Hardware & Software Needed @@ -38,33 +38,33 @@ The goals of this project are: ## IMU (Inertial Measurement Unit) -An IMU is a component that exists of different sensors that records data such as specific force, angular rate, orientation. The Nicla Visions IMU has a **gyroscope** and a **accelerometer.** On the image below you can see exactly where on the board the IMU is located. +An IMU is a component that consists of different sensors and can record data such as specific force, angular rate, orientation. The Nicla Visions IMU has a **gyroscope** and a **accelerometer.** On the image below you can see exactly where the IMU is located on the board. ![Placement of IMU on the Nicla Vision](assets/nicla-vision-imu.png) ### Accelerometer & Gyroscope -An accelerometer is an electromechanical device used to measure acceleration forces. Such forces may be static, like the continuous force of gravity or, as is the case with many mobile devices, dynamic to sense movement or vibrations. +An accelerometer is an electromechanical device used to measure acceleration forces. Such forces may be static, like the continuous force of gravity, or, as in the case of many mobile devices, dynamic to sense movement or vibrations. ![Illustration of Nicla Vision accelerometer axis.](assets/nicla_vision_acceleration.png) -A gyroscope sensor is a device that can measure and maintain the orientation and angular velocity of an object. Gyroscopes are more advanced than accelerometers, as they can measure the tilt and lateral orientation of an object, whereas an accelerometer can only measure its linear motion. Gyroscope sensors are also called "Angular Rate Sensors" or "Angular Velocity Sensors". Measured in degrees per second, angular velocity is the change in the rotational angle of the object per unit of time. +A gyroscope sensor is a device that can measure and maintain the orientation and angular velocity of an object. Gyroscopes are more advanced than accelerometers, since they can measure the tilt and lateral orientation of an object, whereas an accelerometer can only measure its linear motion. Gyroscope sensors are also called "Angular Rate Sensors" or "Angular Velocity Sensors". Measured in degrees per second, angular velocity is the change in the rotational angle of the object per unit of time. ![Illustration of Nicla Vision gyroscope axis.](assets/nicla_vision_gyroscope.png) -In this tutorial, we will use the gyroscope as an indicator for the direction of the force that is applied to the board. We will also use the accelerometer as a "level" that will provide information about the position of the board. With this application we will be able to read what the relative position of the board is, as well as the degrees by tilting the board up, down, left or right. The results will be visible through the Serial Monitor. +In this tutorial, you will use the gyroscope as an indicator for the direction of the force that is applied to the board. You will also use the accelerometer as a "level" that will provide information about the position of the board. With this application you will be able to read what the relative position of the board is as well as its orientation, by tilting the board up, down, left or right. The results will be visible through the Serial Monitor. ## Instructions ### Setting up the Arduino IDE -Make sure the latest Nicla Core is installed in the Arduino IDE. **Tools > Board > Board Manager...**. Here we need to look for the **Arduino Mbed OS Nicla Boards** and install it. Now we need to install the library needed for the IMU. Go to **Tools > Manage libraries..**, and search for **Arduino_LSM6DS3** and install it. +Make sure the latest Nicla Core is installed in the Arduino IDE. **Tools > Board > Board Manager...**. Here you need to look for the **Arduino Mbed OS Nicla Boards** and install it. Now you have to install the library needed for the IMU. Go to **Tools > Manage libraries..**, search for **Arduino_LSM6DS3** and install it. ### IMU Sketch The full sketch can be found at the end of the **Instructions** section. Upload the sketch to the board. -To use the IMU we first include the library. To make it easier with the values from the IMU, we create a variable for each axis. +To use the IMU you first need to include the library. To simplify the values coming from the IMU, you can create a variable for each axis. ```arduino #include @@ -74,7 +74,7 @@ float Gx, Gy, Gz; ``` -To initializes the library we need to call `IMU.begin()`. When the IMU is initialized, we can quickly check the sample rates of the sensors. Calling `IMU.accelerationSampleRate()` and `IMU.gyroscopeSampleRate()` will read the sampling rate of the respective sensor in Hz. +To initializes the library you need to call `IMU.begin()`. When the IMU is initialized, you can quickly check the sample rates of the sensors. Calling `IMU.accelerationSampleRate()` and `IMU.gyroscopeSampleRate()` will read the sampling rate of the respective sensor in Hz. ```arduino void setup() { @@ -100,7 +100,7 @@ void setup() { } ``` -In the loop of the sketch we can check the sensors to see if there is data available on the IMU sensors, using `IMU.accelerationAvailable()` and `IMU.gyroscopeAvailable()`. Then we can call `IMU.readAcceleration(Ax, Ay, Az)` to read the accelerometer. It will return the value of the **x**, **y** and **z** axis and update the variables `Ax`, `Ay` and `Az`. We do the same for the gyroscope, formatting it in the serial monitor so it will be a bit easier to read the data. The data is being printed with an interval of 500 milliseconds. This can be adjusted by changing the line `delay(500)` at the bottom of the sketch. +In the loop of the sketch you can check the sensors to see if there is data available on the IMU sensors, using `IMU.accelerationAvailable()` and `IMU.gyroscopeAvailable()`. Then you can call `IMU.readAcceleration(Ax, Ay, Az)` to read the accelerometer. It will return the value of the **x**, **y** and **z** axis and update the variables `Ax`, `Ay` and `Az`. You can do the same for the gyroscope, formatting it in the Serial Monitor so it will be a bit easier to read the data. The data is being printed with an interval of 500 milliseconds. This can be adjusted by changing the line `delay(500)` at the bottom of the sketch. ```arduino void loop() { @@ -136,7 +136,7 @@ delay(500); ### Testing It Out -After successfully uploading the code to the board, we will need to open the Serial Monitor to initialize the program. Once we open it, data will start printing. +After successfully uploading the code to the board, you will need to open the Serial Monitor to initialize the program. Once you open it, data will start printing. ### Complete Sketch @@ -201,4 +201,4 @@ delay(500); ## Conclusion -In this tutorial we have learned how to use the **Arduino_LSM6DSOX** library to access the IMU on the Nicla Vision. With this we learned how to print the gyroscope and accelerometer data in the Arduino IDE serial monitor. \ No newline at end of file +In this tutorial you have learned how to use the **Arduino_LSM6DSOX** library to access the IMU on the Nicla Vision. With this you learned how to print the gyroscope and accelerometer data in the Arduino IDE Serial Monitor. diff --git a/content/hardware/05.nicla/boards/nicla-vision/tutorials/proximity/content.md b/content/hardware/05.nicla/boards/nicla-vision/tutorials/proximity/content.md index e0c5211643..ee2116e647 100644 --- a/content/hardware/05.nicla/boards/nicla-vision/tutorials/proximity/content.md +++ b/content/hardware/05.nicla/boards/nicla-vision/tutorials/proximity/content.md @@ -20,7 +20,7 @@ software: In this tutorial you will use the Nicla Vision to detect proximity, thanks to the Time of Flight (ToF) sensor **VL53L1X**. -This tutorial goes through how to create a sketch that will blink the built-in RGB LED and control the speed of its blink with the proximity values. It can be useful for future projects where there is a need to control the camera only when something is detected in front of the sensor. +This tutorial teaches you how to create a sketch that will blink the built-in RGB LED and control the speed of its blink with the proximity values. It can be useful for future projects where there is the need to control the camera only when something is detected in front of the sensor. ***The Arduino sketch shown is available inside the `Arduino_Pro_Tutorials` library by going to Examples > Nicla Vision > Proximity_Blink*** @@ -56,7 +56,7 @@ If you are using version 1.6.2 or later of the Arduino software (IDE), you can u ### Include the Needed Libraries and Objects Declaration -First of all declare the sensor's class so you can access it later on in your sketch. We use variables to control the time elements in the sketch. This will make sure that the readings stay accurate over time. +First of all, declare the sensor's class so you can access it later on in your sketch. You can use variables to control the time elements in the sketch. This will make sure that the readings stay accurate over time. ```cpp #include "VL53L1X.h" @@ -70,7 +70,7 @@ int blinkTime = 2000; ### Initialize the Proximity Sensor and the LED -Inside the setup you need to initialize and configure the proximity sensor. Also the RGB LED needs to be set as an output to make it light up and enable us to change its behavior. +Inside the setup you need to initialize and configure the proximity sensor. Also the RGB LED needs to be set as an output to make it light up and enable you to change its behavior. ***The LEDs are accessed in the same way as on the Portenta H7: LEDR, LEDG and LEDB.*** @@ -95,7 +95,7 @@ Inside the setup you need to initialize and configure the proximity sensor. Also } ``` -***Make sure you initialize `Wire1`, set the clock speed to 400 kHz and set the bus pointer to `Wire1`, it won't work if you don't add these setting.*** +***Make sure you initialize `Wire1`, set the clock speed to 400 kHz and set the bus pointer to `Wire1`. It will not work if you do not add these setting.*** ### Control the Speed of the Blink @@ -181,4 +181,4 @@ void loop() { ## Conclusion -In this tutorial we went through how to get readings from the ToF sensor. And how use these readings to change how the built-in LED behaves. At the end of the tutorial you can also find a reference list for the ToF library. +In this tutorial we went through how to get readings from the ToF sensor and how use these readings to change how the built-in LED behaves. At the end of the tutorial you can also find a reference list for the ToF library.