Add example

libraries/Examples/examples/Advanced/Differential_ADC/Differential_ADC.ino

@@ -0,0 +1,53 @@
+/*
+ Using the differential ADC
+ By: Nathan Seidle
+ SparkFun Electronics
+ Date: July 17th, 2020
+ License: This code is public domain. Based on deepsleep.c from Ambiq SDK v2.2.0.
+
+ There are two differential ADC ports on the Artemis. These are located
+ on pads 12/13 (DIFF0N/DIFF0P) and 14/15 (DIFF1P/DIFF10).
+
+ A differential ADC port measures -1.0V to 1.0V with
+ 0 = -1.0V, 8192 = 0V, and 16383 = 1.0V when the ADC is in 14-bit mode.
+
+ SparkFun labored with love to create this code. Feel like supporting open source hardware?
+ Buy a board from SparkFun! https://www.sparkfun.com/products/15376
+*/
+
+#define ANALOG_RESOLUTION 14 //Artemis has 14 bit ADC but can range from 8 to 14 bit
+
+int maxADCValue = pow(2, ANALOG_RESOLUTION);
+
+void setup()
+{
+ Serial.begin(115200);
+ Serial.println("Differential analog conversion example");
+
+ pinMode(LED_BUILTIN, OUTPUT);
+
+ analogReadResolution(ANALOG_RESOLUTION); //Default is 10 bit. Increase to 14 bit.
+}
+
+void loop()
+{
+ int myAnalog0 = analogRead(ADIFF0); //Pads 12/13. Pins 9/10 on RedBoard Artemis.
+ //int myAnalog0 = analogRead(ADIFF1); //Pads 14/15
+ float myVoltage0 = mapfloat(myAnalog0, 0, maxADCValue, -1.0, 1.0);
+ Serial.print("Diff0 voltage: ");
+ Serial.print(myVoltage0, 3);
+ Serial.println();
+
+ digitalWrite(LED_BUILTIN, HIGH);
+ delay(25);
+ digitalWrite(LED_BUILTIN, LOW);
+ delay(25);
+}
+
+float mapfloat(float x, float in_min, float in_max, float out_min, float out_max)
+{
+ if (x > in_max)
+ x = in_max;
+
+ return (x - in_min) * (out_max - out_min) / (in_max - in_min) + out_min;
+}