MuVisionSensor

The MU Vision Sensor is a sensor module that supports Arduino, Microbit, and other haredware platform that supports UART or I2C communication protocols.

You can use these libraries to read data or set properties of the MU Vision Sensor.

Simple example

How quickly can you get up and running with the library? Here's a simple program:

#include <MuVisionSensor.h>
#include <Wire.h>
#define VISION_TYPE VISION_BALL_DETECT
#define MU_ADDRESS    0x60
MuVisionSensor Mu(MU_ADDRESS);
void setup() { 
  Wire.begin();                                           // I2C or Serial must initialize before MU vision sensor
  Mu.begin(&Wire);                                        // MU begin
  Mu.VisionBegin(VISION_TYPE);                            // vision begin
}
void loop() {
  if (Mu.GetValue(VISION_TYPE, kStatus)) {                // get vision status value
    int x = Mu.GetValue(VISION_TYPE, kXValue);            // get vision X axes value
    int y = Mu.GetValue(VISION_TYPE, kYValue);            // get vision Y axes value
    int width = Mu.GetValue(VISION_TYPE, kWidthValue);    // get vision width value
    int height = Mu.GetValue(VISION_TYPE, kHeightValue);  // get vision height value
    int label = Mu.GetValue(VISION_TYPE, kLabel);         // get vision label value
  }
}

Supported platforms

Right now the library is supported on a variety of arduino compatable platforms. If you want to use the library on other plantforms which supported on C/C++, please follow the steps below:

Uart

1.Edit file mu_uart_interface.h in path MuVisionSensor/src/

2.Modify typedef hw_port_t in line 15 to the UART Class supported by the platform

3.Save and close file mu_uart_interface.h

4.Edit file mu_uart_interface.cpp in path MuVisionSensor/src/

5.Override the functions below:

/**
  * @brief  Uart read characters from stream into buffer.
  * @param  buf: uart buffer.
  * @param  length: the number of characters you want to read.
  * @retval returns the number of characters placed in the buffer, terminates if length characters have been read, or timeout.
  */
size_t MuUart::read(uint8_t* buf, uint8_t length);

/**
  * @brief  Uart write characters from buffer into stream.
  * @param  buf: uart buffer.
  * @param  length: the number of characters you want to write.
  * @retval returns the number of characters placed in the stream, terminates if length characters have been write, or timeout.
  */
size_t MuUart::write(uint8_t* buf, uint8_t length);

6.Save and close file mu_uart_interface.cpp

I2C

1.Edit file mu_vision_sensor_i2c_hw_interface.h in path MuVisionSensor/src/

2.Modify typedef MuVsI2C in line 24 to the I2C Class supported by the platform

3.Save and close file mu_vision_sensor_i2c_hw_interface.h

4.Edit file mu_vision_sensor_i2c_hw_interface.cpp in path MuVisionSensor/src/

5.Override the functions below:

/**
  * @brief  I2C read byte.
  * @param  reg_address: register address.
  * @param  temp: register value.
  * @retval 0: read success
  *         not 0: error
  */
uint32_t MuVisionSensorI2C::I2CRead(uint8_t reg_address, uint8_t* temp);

/**
  * @brief  I2C write byte.
  * @param  reg_address: register address.
  * @param  value: the value write to register.
  * @retval 0: write success
  *         not 0: error
  */
uint32_t MuVisionSensorI2C::I2CWrite(uint8_t reg_address, uint8_t value);

6.Save and close file mu_vision_sensor_i2c_hw_interface.cpp

What about other library for MuVisionSensor?

• Mixly https://github.com/mu-opensource/MuVisionSensor3-Mixly
• Micro:Bit https://github.com/mu-opensource/pxt-MuVisionSensor3

For more information

Check out the official site http://www.morpx.com/zn.index.html for links to documentation, issues, and news