refactored One Shot Mode functionality and added CANCTRL_REQOP_OSM as a CANCTRL_REQOP_MODE

Author: arduinoenigma

README.md

@@ -58,9 +58,10 @@ To create connection with MCP2515 provide pin number where SPI CS is connected (
 
 The available modes are listed as follows:
 ```C++
-mcp2515.setNormalMode();
-mcp2515.setLoopbackMode();
-mcp2515.setListenOnlyMode();
+mcp2515.setNormalMode(); // sends and receives data normally, sends acknowledgments to other nodes, when sending data, requires an acknowledgment from another node that the message was received or else, the 2515 will autonomously keep sending the same data
+mcp2515.setNormalOneShotMode(); // sends and receives data normally, sends acknoledgements to other nodes that their message was received, when sending data, does not require an acknowledgement from another node that the message was received.
+mcp2515.setLoopbackMode(); // data sent is immediately received and is not written to the bus, does not send acknowledgements
+mcp2515.setListenOnlyMode(); // does not send data, only receives data, does not send acknowledgements
 ```
 The available baudrates are listed as follows:
 ```C++

library.properties

@@ -1,5 +1,5 @@
 name=autowp-mcp2515
-version=1.2.1
+version=1.3.1
 author=autowp <[email protected]>
 maintainer=autowp <[email protected]>
 sentence=Arduino MCP2515 CAN interface library

mcp2515.cpp

@@ -177,9 +177,14 @@ MCP2515::ERROR MCP2515::setNormalMode()
     return setMode(CANCTRL_REQOP_NORMAL);
 }
 
+MCP2515::ERROR MCP2515::setNormalOneShotMode()
+{
+    return setMode(CANCTRL_REQOP_OSM);
+}
+
 MCP2515::ERROR MCP2515::setMode(const CANCTRL_REQOP_MODE mode)
 {
-    modifyRegister(MCP_CANCTRL, CANCTRL_REQOP, mode);
+    modifyRegister(MCP_CANCTRL, CANCTRL_REQOP | CANCTRL_OSM, mode);
 
     unsigned long endTime = millis() + 10;
     bool modeMatch = false;
@@ -776,4 +781,4 @@ uint8_t MCP2515::errorCountRX(void)
 uint8_t MCP2515::errorCountTX(void)                             
 {
     return readRegister(MCP_TEC);
-}
+}

mcp2515.h

@@ -274,6 +274,7 @@ class MCP2515
 
         enum /*class*/ CANCTRL_REQOP_MODE : uint8_t {
             CANCTRL_REQOP_NORMAL     = 0x00,
+            CANCTRL_REQOP_OSM        = 0x08,
             CANCTRL_REQOP_SLEEP      = 0x20,
             CANCTRL_REQOP_LOOPBACK   = 0x40,
             CANCTRL_REQOP_LISTENONLY = 0x60,
@@ -473,6 +474,7 @@ class MCP2515
         ERROR setSleepMode();
         ERROR setLoopbackMode();
         ERROR setNormalMode();
+        ERROR setNormalOneShotMode();
         ERROR setClkOut(const CAN_CLKOUT divisor);
         ERROR setBitrate(const CAN_SPEED canSpeed);
         ERROR setBitrate(const CAN_SPEED canSpeed, const CAN_CLOCK canClock);
@@ -498,4 +500,4 @@ class MCP2515
         uint8_t errorCountTX(void);
 };
 
-#endif
+#endif