Add files via upload

Author: maxgerhardt

libraries/OPAMP/README.md

@@ -0,0 +1,56 @@
+# OPAMP Libray for Uno R4 Minima & WiFi
+
+## Description
+
+The Arduino Uno R4 Minima and WiFi boards, both a featuring a Renesas R7FA4M1AB3CFM#AA0 microcontroller, do have a built-in OPAMP peripheral.
+
+OMAMPs are very versatile. They can:
+* mirror an input voltage to its output ("voltage follower") 
+* amplify a small analog voltage to its output pin, output voltage range from 0 to ~4.7V ("non-inverting amplifier")
+* compare two input voltages and give a binary "higher" or "lower" output ("comparator")
+* integrate and differentiate signals ("integrator", "differentiator")
+* many more
+
+Electrical characteristics:
+* Input from 0.2V (low speed) / 0.3V (highspeed) to AVCC0 - 0.5V (lowspeed) to AVCC0 - 0.6V (high-speed) 
+* Output from 0.1V to AVCC0 - 0.1V
+* Open gain: 120dB typical
+* Input offset voltage: -10 to 10mV
+* Gain-bandwidth product: 0.04MHz (low-speed) / 1.7 MHz (high-speed)
+* Load current: -100 to 100µA max.
+
+## Usage
+
+To startup the opamp, simply include the library and call `OPAMP.begin()`. You can optionally chose to use a low-speed (=lower power) or high-speed (default) mode.
+
+```cpp
+#include <OPAMP.h>
+
+void setup () {
+    OPAMP.begin(OPAMP_SPEED_HIGHSPEED);
+}
+
+void loop() {}
+```
+
+## Pinout
+
+Both the Uno R4 Minima and WiFi feature their OPAMP channel 0 output on the same pins:
+* Analog A1: Plus
+* Analog A2: Minus
+* Analog A3: Output
+
+![symbol](amp_symbol.png)
+
+(Vs+ is fixed to about 5V, Vs- is fixed to GND.)
+## Testing
+
+To test the OPAMP in the simplest possible "voltage follower" configuration, connect A2 to A3.
+Then, any voltage applied at A1 should be mirrored onto A3. For example, if you connect A1 to GND, the OPAMP output should be GND.
+Connect A1 to 3.3V, the output should be 3.3V.
+
+For an amplifier circuit, see https://www.electronics-tutorials.ws/opamp/opamp_3.html. A simple 2x amplifier can be built by using e.g. two 10K resistors: Connect one resistor between "Minus" and GND. Then use the second resistor to connect the output and "Minus" together. Any signal input at the "Plus" will now appear with double the amplitude at the output pin. Of course, the input signal and the Arduino Uno R4 should share the same GND and the amplified output signal should not go above ~4.7V, otherwise clipping will appear.
+
+Below is a capture of an oscilloscope in which a circa 2V square-wave (green, channel 2) is amplified to 4V square-wave (yellow, channel 1) with the aforementioned circuit.
+
+![amp](amp_screenshot.png)

libraries/OPAMP/amp_screenshot.png

@@ -0,0 +1,21 @@
+#include <Arduino.h>
+#include <OPAMP.h>
+
+void setup () {
+    Serial.begin(9600);
+    delay(2000); // serial monitor delay
+    // activate OPAMP
+    if(!OPAMP.begin(OPAMP_SPEED_HIGHSPEED)) {
+        Serial.println("Failed to start OPAMP!");
+    }
+    uint8_t status = OPAMP.getStatus();
+    if(status & (1u << 0u)) {
+        Serial.println("OPAMP running on channel 0!");
+    } else {
+        Serial.println("OPAMP channel 0 is not running!");
+    }
+}
+
+void loop() {
+    delay(1000); // do nothing
+}

libraries/OPAMP/amp_symbol.png

@@ -0,0 +1,10 @@
+name=OPAMP
+version=1.0.0
+author=Maximilian Gerhardt
+maintainer=Maximilian Gerhardt <maximilian.gerhardt@rub.de>
+sentence=Library for using the OPAMP on Arduino Uno R4 boards.
+paragraph=Supports OPAMP on Arduino Uno R4 (Minima, WiFI).
+category=Signal Input/Output
+url=https://github.com/arduino/ArduinoCore-renesas/tree/master/libraries/OPAMP
+architectures=renesas
+includes=OPAMP.h

libraries/OPAMP/examples/start_opamp/start_opamp.ino

@@ -0,0 +1,69 @@
+#include "OPAMP.h"
+#include <Arduino.h>
+
+/* pin mode needed to activate OPAMP functionality */
+#define OPAMP_IN_PINCFG (IOPORT_CFG_PORT_DIRECTION_INPUT | IOPORT_CFG_PERIPHERAL_PIN | IOPORT_CFG_ANALOG_ENABLE)
+#define OPAMP_OUT_PINCFG (IOPORT_CFG_PORT_DIRECTION_OUTPUT | IOPORT_CFG_PERIPHERAL_PIN | IOPORT_CFG_ANALOG_ENABLE)
+#define FSP_CHECK(err) do { if( (err) != FSP_SUCCESS) return false; } while(0)
+
+bool OpampClass::initPins() {
+    fsp_err_t err;
+    ioport_instance_ctrl_t ioport_ctrl {};
+#if defined(ARDUINO_UNOWIFIR4) || defined(ARDUINO_MINIMA)
+    /* channel 0 pins. Only accessible ones. */
+    err = R_IOPORT_PinCfg(&ioport_ctrl, BSP_IO_PORT_00_PIN_00, OPAMP_IN_PINCFG);
+    FSP_CHECK(err);
+    err = R_IOPORT_PinCfg(&ioport_ctrl, BSP_IO_PORT_00_PIN_01, OPAMP_IN_PINCFG);
+    FSP_CHECK(err);
+    err = R_IOPORT_PinCfg(&ioport_ctrl, BSP_IO_PORT_00_PIN_02, OPAMP_OUT_PINCFG);
+    FSP_CHECK(err);
+#else
+#error "Unsupported board."
+#endif
+    // if we got here, none of the checks triggered an early return.
+    return true;
+}
+
+void OpampClass::initOpamp(OpampSpeedMode speed, uint8_t channel_mask) {
+    uint8_t ampmc_val  = 0U;
+    /* setup amplifier speed mode within amplifier mode control */
+    /* for all boards, this is at bit position 7 with either 0 (lowspeed) or 1 (highspeed) */
+    ampmc_val = (uint8_t) ((uint8_t) speed << R_OPAMP_AMPMC_AMPSP_Pos) & R_OPAMP_AMPMC_AMPSP_Msk;
+    /* reset opamp */
+    R_OPAMP->AMPC = 0U;
+    /* write prepared mode control value */
+    R_OPAMP->AMPMC  = ampmc_val;
+    /* setup activation trigger select register */
+    /* we only support "Software start & stop" for now, value 0. */
+    R_OPAMP->AMPTRS = 0;
+    R_OPAMP->AMPTRM = 0;
+    /* set the bits for the activated channels */
+    R_OPAMP->AMPC |= channel_mask;
+    /* note: we don't have to activate the charge pump (AMPCPC) because here AVCC0 > 2.7V */
+    /* delay for the wanted init time in microseconds */
+    if (speed == OPAMP_SPEED_LOWSPEED) {
+        delayMicroseconds(BSP_FEATURE_OPAMP_MIN_WAIT_TIME_LP_US);
+    } else if (speed == OPAMP_SPEED_HIGHSPEED) {
+        delayMicroseconds(BSP_FEATURE_OPAMP_MIN_WAIT_TIME_HS_US);
+    }
+}
+
+bool OpampClass::begin(OpampSpeedMode speed) {
+    if(!initPins()) {
+        return false;
+    }
+    initOpamp(speed, (1u << ARDUINO_USED_OPAMP_CHANNEL));
+    return true;
+}
+
+uint8_t OpampClass::getStatus() {
+    return R_OPAMP->AMPMON;
+}
+
+void OpampClass::end() {
+    // clear the bit for the used channel
+    R_OPAMP->AMPC &= (uint8_t) ~(1u << ARDUINO_USED_OPAMP_CHANNEL);
+}
+
+/* global instance */
+OpampClass OPAMP;

libraries/OPAMP/library.properties

@@ -0,0 +1,48 @@
+#ifndef _OPAMP_H_
+#define _OPAMP_H_
+
+#include <stdint.h>
+
+/* Available speed modes */
+/* Note: No middle speed mode on the Uno R4 boards */
+enum OpampSpeedMode {
+    OPAMP_SPEED_LOWSPEED = 0,
+    OPAMP_SPEED_HIGHSPEED = 1,
+};
+
+/* The supported boards have 4 OPAMP channels, however, only channel 0 is accessible. */
+/* All other channels are connected to the LED matrix or not exposed. */
+#define ARDUINO_USED_OPAMP_CHANNEL 0
+
+/**
+ * Pin Mapping for OPAMP
+ * Uno R4 (Minima, WiFi):
+ * ~Channel 0~
+ *  Plus: Analog A1 (Renesas P0.00)
+ *  Minus: Analog A2 (Renesas P0.01) 
+ *  Output: Analog A3 (Renesas P0.02)
+ * ~Channel 1~ (Inaccessible)
+ *  +: P0.13, -: Renesas P0.12, Out: Renesas P0.03
+ * ~Channel 2~ (Inaccessible)
+ *  +: P0.11, -: Renesas P0.10, Out: Renesas P0.04
+ * ~Channel 3~ (Inaccessible)
+ *  +: P0.05, -: Renesas P0.06, Out: Renesas P0.07
+*/
+class OpampClass {
+public:
+    /* startup the OPAMP on channel 0 */
+    bool begin(OpampSpeedMode speed = OPAMP_SPEED_HIGHSPEED);
+    /* stop the OPAMP on channel 0 */
+    void end();
+    /* i-th Bit: 0 if OPAMP channel is stopped, 1 if OPAMP channel is operating */
+    uint8_t getStatus();
+private:
+    /* initializes OPAMP pins */
+    bool initPins();
+    /* activates OPAMP for given speed and channel(s) */
+    void initOpamp(OpampSpeedMode speed, uint8_t channel_mask);
+};
+
+extern OpampClass OPAMP;
+
+#endif /* _OPAMP_H_ */