Fix #32, improve SPI dependency (#33)

- Fix #32, improve handling SPI dependency.
- update examples

Author: RobTillaart

CHANGELOG.md

@@ -6,6 +6,12 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
 
+## [0.5.0] - 2024-01-20
+- Fix #32, improve handling SPI dependency.
+- update examples
+
+----
+
 ## [0.4.0] - 2023-12-24
 - Fix #30, support for Arduino ESP32 S3 - breaking change
 - update readme.md

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021-2023 Rob Tillaart
+Copyright (c) 2021-2024 Rob Tillaart
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

MCP23S17.cpp

@@ -1,7 +1,7 @@
 //
 //    FILE: MCP23S17.cpp
 //  AUTHOR: Rob Tillaart
-// VERSION: 0.4.0
+// VERSION: 0.5.0
 // PURPOSE: Arduino library for SPI MCP23S17 16 channel port expander
 //    DATE: 2021-12-30
 //     URL: https://github.com/RobTillaart/MCP23S17
@@ -50,8 +50,8 @@ bool MCP23S17::begin()
 
   if (_hwSPI)
   {
-    _mySPI->end();
-    _mySPI->begin();
+    //  _mySPI->end();
+    //  _mySPI->begin();
   }
   else
   {

MCP23S17.h

@@ -2,7 +2,7 @@
 //
 //    FILE: MCP23S17.h
 //  AUTHOR: Rob Tillaart
-// VERSION: 0.4.0
+// VERSION: 0.5.0
 // PURPOSE: Arduino library for SPI MCP23S17 16 channel port expander
 //    DATE: 2021-12-30
 //     URL: https://github.com/RobTillaart/MCP23S17
@@ -13,7 +13,7 @@
 #include "MCP23S17_registers.h"
 
 
-#define MCP23S17_LIB_VERSION              (F("0.4.0"))
+#define MCP23S17_LIB_VERSION              (F("0.5.0"))
 
 //  ERROR CODES
 #define MCP23S17_OK                       0x00

README.md

@@ -22,6 +22,13 @@ This IC is strongly related to the MCP23017 I2C port expander - https://github.c
 Programming Interface is kept the same as much as possible.
 
 
+#### 0.5.0 Breaking change
+
+Version 0.5.0 introduced a breaking change to improve handling the SPI dependency.
+The user has to call **SPI.begin()** or equivalent before calling **MCP.begin()**.
+Optionally the user can provide parameters to the **SPI.begin(...)**
+
+
 #### 0.4.0 Breaking change
 
 The version 0.4.0 has breaking changes in the interface. 

examples/MCP23S17_digitalRead/MCP23S17_digitalRead.ino

@@ -6,7 +6,6 @@
 
 
 #include "MCP23S17.h"
-#include "SPI.h"
 
 
 MCP23S17 MCP(10);
@@ -22,6 +21,7 @@ void setup()
   delay(100);
 
   SPI.begin();
+
   rv = MCP.begin();
   Serial.println(rv ? "true" : "false");
 

examples/MCP23S17_digitalWrite/MCP23S17_digitalWrite.ino

@@ -6,7 +6,7 @@
 
 
 #include "MCP23S17.h"
-#include "SPI.h"
+
 
 MCP23S17 MCP(10, 5, 6, 7);   //  SW SPI   address 0x00
 
@@ -20,6 +20,7 @@ void setup()
   delay(100);
 
   SPI.begin();
+
   bool b = MCP.begin();
   Serial.println(b ? "true" : "false");
   delay(100);

examples/MCP23S17_four_ADDRESS_array/MCP23S17_four_ADDRESS_array.ino

@@ -8,7 +8,6 @@
 
 
 #include "MCP23S17.h"
-#include "SPI.h"
 
 
 MCP23S17 MCP_A(10, 12, 11, 13, 0);   //  SW SPI, address 0
@@ -34,6 +33,7 @@ void setup()
   delay(100);
 
   SPI.begin();
+
   for (int addr = 0; addr < 4; addr++)
   {
     MCP[addr].begin();

examples/MCP23S17_performance/MCP23S17_performance.ino

@@ -6,7 +6,7 @@
 
 
 #include "MCP23S17.h"
-#include "SPI.h"
+
 
 // MCP23S17 MCP(10, 12, 11, 13);  //  SW SPI address 0x00
 MCP23S17 MCP(10);           //  HW SPI address 0x00
@@ -28,6 +28,7 @@ void setup()
   delay(100);
 
   SPI.begin();
+
   bool b = MCP.begin();
   Serial.println(b ? "true" : "false");
 

examples/MCP23S17_test/MCP23S17_test.ino

@@ -6,7 +6,6 @@
 
 
 #include "MCP23S17.h"
-#include "SPI.h"
 
 
 // MCP23S17 MCP(10, 12, 11, 13);  //  SW SPI address 0x00
@@ -23,6 +22,7 @@ void setup()
   delay(100);
 
   SPI.begin();
+
   bool b = MCP.begin();
   Serial.println(b ? "true" : "false");