Adding modified OV767X library

Author: plancherb1

LICENSE.txt

@@ -1 +1,15 @@
-# arduino-library
+# Harvard_TinyMLx Arduino Library
+
+Source code and examples for using and testing your Tiny Machine Learning Kit and Shield.
+
+This library also includes a modified verison of the OV767X Library for Arduino (Copyright (c) 2020 Arduino SA) which is based on https://www.kernel.org[Linux Kernel's] V4L2 driver for OmniVision OV7670 cameras - which was created by Jonathan Corbet.
+
+== License ==
+
+Copyright (c) 2021 TinyMLx. All rights reserved.
+
+This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 2.
+
+This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

README.md

@@ -3,10 +3,8 @@
   Harvard University 
   tinyMLx - OV7675 Camera Test
 
-  Requires the the Arduino_OV767X library
 */
 
-#include <Arduino_OV767X.h>
 #include <TinyMLShield.h>
 
 bool commandRecv = false; // flag used for indicating receipt of commands from serial port

examples/test_camera/test_camera.ino

@@ -0,0 +1,92 @@
+/*
+  OV767X - Camera Test Pattern
+
+  This sketch waits for the letter 'c' on the Serial Monitor,
+  it then reads a frame from the OmniVision OV7670 camera and 
+  prints the data to the Serial Monitor as a hex string.
+
+  The website https://rawpixels.net - can be used the visualize the data:
+    width: 176
+    height: 144
+    RGB565
+    Little Endian
+
+  Circuit:
+    - Arduino Nano 33 BLE board
+    - OV7670 camera module:
+      - 3.3 connected to 3.3
+      - GND connected GND
+      - SIOC connected to A5
+      - SIOD connected to A4
+      - VSYNC connected to 8
+      - HREF connected to A1
+      - PCLK connected to A0
+      - XCLK connected to 9
+      - D7 connected to 4
+      - D6 connected to 6
+      - D5 connected to 5
+      - D4 connected to 3
+      - D3 connected to 2
+      - D2 connected to 0 / RX
+      - D1 connected to 1 / TX
+      - D0 connected to 10
+
+  This example code is in the public domain.
+*/
+
+#include <Arduino_OV767X.h>
+
+unsigned short pixels[176 * 144]; // QCIF: 176x144 X 2 bytes per pixel (RGB565)
+
+void setup() {
+  Serial.begin(9600);
+  while (!Serial);
+
+  Serial.println("OV767X Camera Capture");
+  Serial.println();
+
+  if (!Camera.begin(QCIF, RGB565, 1)) {
+    Serial.println("Failed to initialize camera!");
+    while (1);
+  }
+
+  Serial.println("Camera settings:");
+  Serial.print("\twidth = ");
+  Serial.println(Camera.width());
+  Serial.print("\theight = ");
+  Serial.println(Camera.height());
+  Serial.print("\tbits per pixel = ");
+  Serial.println(Camera.bitsPerPixel());
+  Serial.println();
+
+  Serial.println("Send the 'c' character to read a frame ...");
+  Serial.println();
+}
+
+void loop() {
+  if (Serial.read() == 'c') {
+    Serial.println("Reading frame");
+    Serial.println();
+    Camera.readFrame(pixels);
+
+    int numPixels = Camera.width() * Camera.height();
+
+    for (int i = 0; i < numPixels; i++) {
+      unsigned short p = pixels[i];
+
+      if (p < 0x1000) {
+        Serial.print('0');
+      }
+
+      if (p < 0x0100) {
+        Serial.print('0');
+      }
+
+      if (p < 0x0010) {
+        Serial.print('0');
+      }
+
+      Serial.print(p, HEX);
+    }
+  }
+}

extras/CameraCapture/CameraCapture.ino

@@ -0,0 +1,56 @@
+/*
+  OV767X - Camera Capture Raw Bytes
+
+  This sketch reads a frame from the OmniVision OV7670 camera
+  and writes the bytes to the Serial port. Use the Procesing
+  sketch in the extras folder to visualize the camera output.
+
+  Circuit:
+    - Arduino Nano 33 BLE board
+    - OV7670 camera module:
+      - 3.3 connected to 3.3
+      - GND connected GND
+      - SIOC connected to A5
+      - SIOD connected to A4
+      - VSYNC connected to 8
+      - HREF connected to A1
+      - PCLK connected to A0
+      - XCLK connected to 9
+      - D7 connected to 4
+      - D6 connected to 6
+      - D5 connected to 5
+      - D4 connected to 3
+      - D3 connected to 2
+      - D2 connected to 0 / RX
+      - D1 connected to 1 / TX
+      - D0 connected to 10
+
+  This example code is in the public domain.
+*/
+
+#include <Arduino_OV767X.h>
+
+int bytesPerFrame;
+
+byte data[320 * 240 * 2]; // QVGA: 320x240 X 2 bytes per pixel (RGB565)
+
+void setup() {
+  Serial.begin(9600);
+  while (!Serial);
+
+  if (!Camera.begin(QVGA, RGB565, 1)) {
+    Serial.println("Failed to initialize camera!");
+    while (1);
+  }
+
+  bytesPerFrame = Camera.width() * Camera.height() * Camera.bytesPerPixel();
+
+  // Optionally, enable the test pattern for testing
+  // Camera.testPattern();
+}
+
+void loop() {
+  Camera.readFrame(data);
+
+  Serial.write(data, bytesPerFrame);
+}

extras/CameraCaptureRawBytes/CameraCaptureRawBytes.ino

@@ -0,0 +1,95 @@
+/*
+  OV767X - Camera Test Pattern
+
+  This sketch enables the test pattern mode, then reads a frame from
+  the OmniVision OV7670 camera and prints the data to the 
+  Serial Monitor as a hex string.
+
+  The website https://rawpixels.net - can be used the visualize the data:
+    width: 176
+    height: 144
+    RGB565
+    Little Endian
+
+  Circuit:
+    - Arduino Nano 33 BLE board
+    - OV7670 camera module:
+      - 3.3 connected to 3.3
+      - GND connected GND
+      - SIOC connected to A5
+      - SIOD connected to A4
+      - VSYNC connected to 8
+      - HREF connected to A1
+      - PCLK connected to A0
+      - XCLK connected to 9
+      - D7 connected to 4
+      - D6 connected to 6
+      - D5 connected to 5
+      - D4 connected to 3
+      - D3 connected to 2
+      - D2 connected to 0 / RX
+      - D1 connected to 1 / TX
+      - D0 connected to 10
+
+  This example code is in the public domain.
+*/
+
+#include <Arduino_OV767X.h>
+
+unsigned short pixels[176 * 144]; // QCIF: 176x144 X 2 bytes per pixel (RGB565)
+
+void setup() {
+  Serial.begin(9600);
+  while (!Serial);
+
+  Serial.println("OV767X Test Pattern");
+  Serial.println();
+
+  if (!Camera.begin(QCIF, RGB565, 1)) {
+    Serial.println("Failed to initialize camera!");
+    while (1);
+  }
+
+  Serial.println("Camera settings:");
+  Serial.print("\twidth = ");
+  Serial.println(Camera.width());
+  Serial.print("\theight = ");
+  Serial.println(Camera.height());
+  Serial.print("\tbits per pixel = ");
+  Serial.println(Camera.bitsPerPixel());
+  Serial.println();
+
+  Serial.println("Enabling test pattern mode");
+  Serial.println();
+  Camera.testPattern();
+
+  Serial.println("Reading frame");
+  Serial.println();
+  Camera.readFrame(pixels);
+
+  int numPixels = Camera.width() * Camera.height();
+
+  for (int i = 0; i < numPixels; i++) {
+    unsigned short p = pixels[i];
+
+    if (p < 0x1000) {
+      Serial.print('0');
+    }
+
+    if (p < 0x0100) {
+      Serial.print('0');
+    }
+
+    if (p < 0x0010) {
+      Serial.print('0');
+    }
+
+    Serial.print(p, HEX);
+  }
+
+  Serial.println();
+}
+
+void loop() {
+  // do nothing
+}

extras/CameraTestPattern/CameraTestPattern.ino

@@ -0,0 +1,82 @@
+/*
+  This sketch reads a raw Stream of RGB565 pixels
+  from the Serial port and displays the frame on
+  the window.
+
+  Use with the Examples -> CameraCaptureRawBytes Arduino sketch.
+
+  This example code is in the public domain.
+*/
+
+import processing.serial.*;
+import java.nio.ByteBuffer;
+import java.nio.ByteOrder;
+
+Serial myPort;
+
+// must match resolution used in the sketch
+final int cameraWidth = 176;
+final int cameraHeight = 144;
+
+final int cameraBytesPerPixel = 2;
+
+final int bytesPerFrame = cameraWidth * cameraHeight * cameraBytesPerPixel;
+
+PImage myImage;
+
+void setup()
+{
+  size(176, 144);
+
+  // if you have only ONE serial port active
+  //myPort = new Serial(this, Serial.list()[0], 9600); // if you have only ONE serial port active
+
+  // if you know the serial port name
+  myPort = new Serial(this, "COM3", 9600);                    // Windows
+  //myPort = new Serial(this, "/dev/ttyACM0", 9600);             // Linux
+  //myPort = new Serial(this, "/dev/cu.usbmodem14101", 9600);  // Mac
+
+  // wait for full frame of bytes
+  myPort.buffer(bytesPerFrame);  
+
+  myImage = createImage(cameraWidth, cameraHeight, RGB);
+}
+
+void draw()
+{
+  image(myImage, 0, 0);
+}
+
+void serialEvent(Serial myPort) {
+  byte[] frameBuffer = new byte[bytesPerFrame];
+
+  // read the saw bytes in
+  myPort.readBytes(frameBuffer);
+
+  // create image to set byte values
+  PImage img = createImage(cameraWidth, cameraHeight, RGB);
+
+  // access raw bytes via byte buffer
+  ByteBuffer bb = ByteBuffer.wrap(frameBuffer);
+  bb.order(ByteOrder.BIG_ENDIAN);
+
+  int i = 0;
+
+  img.loadPixels();
+  while (bb.hasRemaining()) {
+    // read 16-bit pixel
+    short p = bb.getShort();
+
+    // convert RGB565 to RGB 24-bit
+    int r = ((p >> 11) & 0x1f) << 3;
+    int g = ((p >> 5) & 0x3f) << 2;
+    int b = ((p >> 0) & 0x1f) << 3;
+
+    // set pixel color
+    img.pixels[i++] = color(r, g, b);
+  }
+  img.updatePixels();
+
+  // assign image for next draw
+  myImage = img;
+}