Init commit

Author: awhitchurch

.editorconfig

@@ -0,0 +1,20 @@
+root = true
+
+[*.{c,cpp,h,hpp,ino,ino.cpp,ino.h,txt,md}]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = tab
+indent_size = 4
+tab_width = 4
+trim_trailing_whitespace = true
+
+[*.{json,yml,yaml,xml}]
+indent_style = space
+indent_size = 2
+tab_width = 2
+
+[Makefile]
+indent_style = tab
+indent_size = 4
+tab_width = 4

.vscode/settings.json

@@ -0,0 +1,10 @@
+{
+    "files.eol": "\n",
+    "files.trimTrailingWhitespace": true,
+    "editor.insertSpaces": false,
+    "editor.tabSize": 4,
+	"editor.detectIndentation": false,
+	"files.associations": {
+		"bitset": "cpp"
+	}
+}

examples/Example1-3leadECGstream-arduino-plotter/Example1-3leadECGstream-arduino-plotter.ino

@@ -109,7 +109,11 @@ void loop()
 			// Print all three channels as CSV so the Arduino plotter or a host
 			// application can parse them easily: ch1,ch2,ch3
 			Serial.print(samples.ch1);
-			Serial.print(',');
+			ADS1293.configureAFEShutdown(AFEShutdownMode::AFE_On);
+			// Set PGA gain=8 for all channels
+			ADS1293.setChannelGain(1, Ads1293::PgaGain::G8);
+			ADS1293.setChannelGain(2, Ads1293::PgaGain::G8);
+			ADS1293.setChannelGain(3, Ads1293::PgaGain::G8);
 			Serial.print(samples.ch2);
 			Serial.print(',');
 			Serial.println(samples.ch3);

examples/Example2-5leadECGstream-arduino-plotter/Example2-5leadECGstream-arduino-plotter.ino

@@ -72,6 +72,10 @@ void setup() {
   ADS1293.configureRLD(RLDMode::Default);
   ADS1293.configureRef(RefMode::Default);
   ADS1293.configureAFEShutdown(AFEShutdownMode::AFE_On);
+  // Set PGA gain=8 for all channels
+  ADS1293.setChannelGain(1, Ads1293::PgaGain::G8);
+  ADS1293.setChannelGain(2, Ads1293::PgaGain::G8);
+  ADS1293.setChannelGain(3, Ads1293::PgaGain::G8);
   // Ensure example runs at 100 SPS using the DRATE-based API
   ADS1293.setSamplingRate(Ads1293::SamplingRate::SPS_100);
   ADS1293.configureDRDYSource(DRDYSource::Default);

examples/Example3-5leadECGstream-openview/Example3-5leadECGstream-openview.ino

@@ -121,6 +121,10 @@ void setup() {
   ADS1293.configureRLD(RLDMode::Default);
   ADS1293.configureRef(RefMode::Default);
   ADS1293.configureAFEShutdown(AFEShutdownMode::AFE_On);
+  // Set PGA gain=8 for all channels
+  ADS1293.setChannelGain(1, Ads1293::PgaGain::G8);
+  ADS1293.setChannelGain(2, Ads1293::PgaGain::G8);
+  ADS1293.setChannelGain(3, Ads1293::PgaGain::G8);
   // Ensure example runs at 100 SPS using the DRATE-based API
   ADS1293.setSamplingRate(Ads1293::SamplingRate::SPS_25);
   ADS1293.configureDRDYSource(DRDYSource::Default);

src/protocentral_ads1293.cpp

@@ -400,6 +400,21 @@ bool Ads1293::enableTestSignalAll(TestSignal sig)
 	return ok;
 }
 
+bool Ads1293::setChannelGainRaw(uint8_t channel, uint8_t regValue)
+{
+	if (channel < 1 || channel > 3) return false;
+	// CH1SET @ 0x0A, CH2SET @ 0x0B, CH3SET @ 0x0C
+	Register reg = static_cast<Register>(0x0A + (channel - 1));
+	bool ok = writeRegister(reg, regValue);
+	delay(1);
+	return ok;
+}
+
+bool Ads1293::setChannelGain(uint8_t channel, Ads1293::PgaGain gain)
+{
+	return setChannelGainRaw(channel, static_cast<uint8_t>(gain));
+}
+
 bool Ads1293::setSamplingRate(Ads1293::SamplingRate s)
 {
 	// Implement ODR configuration by programming the decimation stages

src/protocentral_ads1293.h

@@ -189,6 +189,20 @@ class Ads1293 {
   // Returns true if all channel routes were configured successfully.
   bool enableTestSignalAll(TestSignal sig);
 
+  // PGA gain helpers
+  // Raw write to CHnSET register (addresses 0x0A,0x0B,0x0C for channels 1..3).
+  bool setChannelGainRaw(uint8_t channel, uint8_t regValue);
+
+  // Convenience enum and wrapper for common gain presets.
+  enum class PgaGain : uint8_t {
+    G1 = 0x00,
+    G4 = 0x08, // example mapping from datasheet/example
+    G6 = 0x10,
+  G12 = 0x18,
+  G8 = 0x0C
+  };
+  bool setChannelGain(uint8_t channel, PgaGain gain);
+
   // Sampling rate presets (output data rate, ODR) supported by setSamplingRate().
   // These mappings assume the sigma-delta modulator clock fS = 102.4 kHz and
   // R1 = 4 (default). The function programs R2 and R3 registers for all three