Merge pull request adafruit#2 from ladyada-eagleclaw/add-library-ci

Add Arduino library CI

Author: ladyada

.clang-format

@@ -0,0 +1,13 @@
+Language: Cpp
+BasedOnStyle: Google
+IndentWidth: 2
+ColumnLimit: 80
+AllowShortFunctionsOnASingleLine: Empty
+AllowShortIfStatementsOnASingleLine: false
+AllowShortLoopsOnASingleLine: false
+BinPackArguments: true
+BinPackParameters: true
+BreakBeforeBraces: Attach
+DerivePointerAlignment: false
+PointerAlignment: Left
+SpacesBeforeTrailingComments: 1

.github/workflows/githubci.yml

@@ -0,0 +1,32 @@
+name: Arduino Library CI
+
+on: [pull_request, push, repository_dispatch]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+    - uses: actions/setup-python@v4
+      with:
+        python-version: '3.x'
+    - uses: actions/checkout@v4
+      with:
+         repository: adafruit/ci-arduino
+         path: ci
+
+    - name: pre-install
+      run: bash ci/actions_install.sh
+
+    - name: clang
+      run: python3 ci/run-clang-format.py -e "ci/*" -e "bin/*" -r .
+
+    - name: test platforms
+      run: python3 ci/build_platform.py main_platforms
+
+    - name: doxy
+      env:
+        GH_REPO_TOKEN: ${{ secrets.GH_REPO_TOKEN }}
+        PRETTYNAME : "Adafruit GP8403 Arduino Library"
+      run: bash ci/doxy_gen_and_deploy.sh

.gitignore

@@ -1 +1,13 @@
 hw_tests/results/
+
+# Local agent configuration
+AGENTS.md
+CLAUDE.md
+GEMINI.md
+.codex/
+.claude/
+.gemini/
+
+# Local reference documents
+datasheet*.pdf
+datasheet*.txt

Adafruit_GP8403.cpp

@@ -15,6 +15,7 @@
  */
 
 #include "Adafruit_GP8403.h"
+
 #include <Adafruit_BusIO_Register.h>
 
 /**
@@ -45,7 +46,7 @@ Adafruit_GP8403::~Adafruit_GP8403() {
  * @param wire I2C interface to use.
  * @return true if the probe and all initialization writes succeeded.
  */
-bool Adafruit_GP8403::begin(uint8_t address, TwoWire *wire) {
+bool Adafruit_GP8403::begin(uint8_t address, TwoWire* wire) {
   delete _i2c_dev;
   _i2c_dev = new Adafruit_I2CDevice(address, wire);
 
@@ -102,8 +103,7 @@ bool Adafruit_GP8403::setRaw(uint8_t channel, uint16_t value) {
  * @return true if both values were valid and the I2C write succeeded.
  */
 bool Adafruit_GP8403::setRawValues(uint16_t channel0, uint16_t channel1) {
-  if (channel0 > GP8403_MAX_RAW_VALUE ||
-      channel1 > GP8403_MAX_RAW_VALUE) {
+  if (channel0 > GP8403_MAX_RAW_VALUE || channel1 > GP8403_MAX_RAW_VALUE) {
     return false;
   }
 
@@ -234,8 +234,8 @@ bool Adafruit_GP8403::writeRawValues(uint16_t channel0, uint16_t channel1) {
   uint16_t wireChannel0 = channel0 << 4;
   uint16_t wireChannel1 = channel1 << 4;
   uint32_t wireValues = ((uint32_t)wireChannel1 << 16) | wireChannel0;
-  Adafruit_BusIO_Register channelRegister(
-      _i2c_dev, GP8403_COMMAND_CHANNEL_0, 4, LSBFIRST);
+  Adafruit_BusIO_Register channelRegister(_i2c_dev, GP8403_COMMAND_CHANNEL_0, 4,
+                                          LSBFIRST);
   if (!channelRegister.write(wireValues)) {
     return false;
   }
@@ -252,7 +252,7 @@ bool Adafruit_GP8403::writeRawValues(uint16_t channel0, uint16_t channel1) {
  * @param value Destination for the converted value.
  * @return true if the voltage is finite and within the selected range.
  */
-bool Adafruit_GP8403::voltageToRaw(float volts, uint16_t &value) {
+bool Adafruit_GP8403::voltageToRaw(float volts, uint16_t& value) {
   float fullScale = fullScaleVoltage();
   if (!isfinite(volts) || volts < 0.0 || volts > fullScale) {
     return false;
@@ -279,7 +279,7 @@ namespace {
 constexpr uint8_t GP8403_NVM_HALF_PERIOD_US = 5;
 
 class GP8403NVMWriter {
-public:
+ public:
   GP8403NVMWriter(uint16_t sdaPin, uint16_t sclPin) {
     _sdaPin = sdaPin;
     _sclPin = sclPin;
@@ -346,8 +346,8 @@ class GP8403NVMWriter {
     delayMicroseconds(GP8403_NVM_HALF_PERIOD_US);
     release(_sclPin);
     delayMicroseconds(GP8403_NVM_HALF_PERIOD_US);
-    bool acknowledged = digitalRead(_sclPin) == HIGH &&
-                        digitalRead(_sdaPin) == LOW;
+    bool acknowledged =
+        digitalRead(_sclPin) == HIGH && digitalRead(_sdaPin) == LOW;
     driveLow(_sclPin);
     delayMicroseconds(GP8403_NVM_HALF_PERIOD_US);
     return clocksHigh && acknowledged;
@@ -363,7 +363,7 @@ class GP8403NVMWriter {
     return stop() && waveformOK;
   }
 
-private:
+ private:
   static void driveLow(uint16_t pin) {
     digitalWrite(pin, LOW);
     pinMode(pin, OUTPUT);
@@ -449,8 +449,8 @@ bool Adafruit_GP8403::saveToNVM(uint16_t sdaPin, uint16_t sclPin) {
       exitStopOK = writer.stop();
     }
   }
-  bool exited = exitPreambleOK && exitStartOK && exitCommandACK && exitDataACK &&
-                exitStopOK;
+  bool exited = exitPreambleOK && exitStartOK && exitCommandACK &&
+                exitDataACK && exitStopOK;
   writer.releaseBus();
   return entered && dataWaveformOK && exited;
 }

Adafruit_GP8403.h

@@ -32,12 +32,11 @@ enum gp8403_output_range_t {
 
 /** @brief Driver for the GP8403 dual-channel 12-bit DAC. */
 class Adafruit_GP8403 {
-public:
+ public:
   Adafruit_GP8403();
   ~Adafruit_GP8403();
 
-  bool begin(uint8_t address = GP8403_DEFAULT_ADDRESS,
-             TwoWire *wire = &Wire);
+  bool begin(uint8_t address = GP8403_DEFAULT_ADDRESS, TwoWire* wire = &Wire);
 
   bool setOutputRange(gp8403_output_range_t range);
   gp8403_output_range_t getOutputRange();
@@ -52,14 +51,14 @@ class Adafruit_GP8403 {
 
   bool saveToNVM(uint16_t sdaPin, uint16_t sclPin);
 
-private:
+ private:
   bool writeOutputRange(gp8403_output_range_t range);
   bool writeRaw(uint8_t channel, uint16_t value);
   bool writeRawValues(uint16_t channel0, uint16_t channel1);
-  bool voltageToRaw(float volts, uint16_t &value);
+  bool voltageToRaw(float volts, uint16_t& value);
   float fullScaleVoltage();
 
-  Adafruit_I2CDevice *_i2c_dev; ///< BusIO I2C device
+  Adafruit_I2CDevice* _i2c_dev; ///< BusIO I2C device
   gp8403_output_range_t _range; ///< Cached output range
   uint16_t _raw[2];             ///< Cached channel DAC values
 };

LICENSE

@@ -1,4 +1,4 @@
-MIT License
+The MIT License (MIT)
 
 Copyright (c) 2026 Adafruit Industries
 

library.properties

@@ -1,4 +1,4 @@
-name=Adafruit GP8403 Library
+name=Adafruit GP8403
 version=1.0.0
 author=Adafruit
 maintainer=Adafruit <info@adafruit.com>