Update library version to 1.3.0 and add new I/O plugin headers for enhanced functionality.

Other features:
* Hide the 2nd debug COM port
* Access directly I/O variables in sketch
* Read/write RTC clock
* Watchdog (NB: VEDI SOTTO)
* New partitioning scheme
* Support NTP
* Support update over Modbus TCP

Author: manchoz

library.properties

@@ -1,5 +1,5 @@
 name=AlPlc_Opta
-version=1.2.0
+version=1.3.0
 author=Arduino
 maintainer=Arduino <[email protected]>
 sentence=Arduino IDE PLC runtime library for Arduino Opta

src/AlPlc_Opta.h

@@ -12,6 +12,8 @@
 #include <ArduinoRS485.h>
 #include <PortentaEthernet.h>
 #include <OptaBlue.h>
+#include <STM32H747_System.h>
+#include <Arduino_Portenta_OTA.h>
 
 extern "C" void sysMbMRtu_SetPostDelay(uint16_t delay);
 
@@ -22,10 +24,11 @@ extern uint8_t m_PLCSharedVarsInputBuf[];
 class AlPlc
 {
 public:
-	AlPlc(int32_t sketchCrc);
+	AlPlc(int32_t sketchCrc, bool debugMode = false);
 	void Run();
 	void ListFiles(bool resetPlc);
 	void InitFileSystem();
+	void MbTCP_EnablePLCRuntimeConn();
 };
 
 #endif

src/IOPlugin.h

@@ -0,0 +1,69 @@
+#ifndef IOPLUGIN_H
+#define IOPLUGIN_H
+
+/* local I/O */
+
+#if defined( ARDUINO_PORTENTA_H7_M7 )
+
+#include "ArduinoSpec/IODriver.h"
+
+extern bool_t sysDigitalInputs[NUM_DIGITAL_INPUTS];
+extern bool_t sysDigitalOutputs[NUM_DIGITAL_OUTPUTS];
+
+extern int32_t sysAnalogInputs[NUM_ANALOG_INPUTS];
+extern float sysAnalogOutputs[NUM_ANALOG_OUTPUTS];
+extern bool_t sysProgrammableDigitalIO[NUM_PROG_DIGITAL_IO];
+
+extern SYS_TEMPPROBE_TYPE sysTempProbes[NUM_SYS_TEMP_PROBES];
+
+extern sysEncoderInputType sysEncoders[NUM_SYS_ENCODERS];
+
+#elif defined( ARDUINO_OPTA )
+
+#include "IOPluginDefs.h"
+
+extern uint16_t sysProgrammableInputs[NUM_PROG_INPUTS];
+extern bool_t sysRelayOutputs[NUM_RELAY_OUTPUTS];
+extern bool_t sysLEDOutputs[NUM_LED_OUTPUTS];
+extern bool_t sysButtonInputs[NUM_BUTTON_INPUTS];
+
+typedef union
+{
+	struct
+	{
+		uint16_t programmableInputs[OPTA_DIGITAL_IN_NUM];  // bool_t / uint16_t
+	} digital; // 32 bytes
+	
+	struct
+	{
+		ProgChannel_t analogInputs[OPTA_ANALOG_IN_NUM];  // float / uint16_t / bool_t
+	} analog;  // 32 bytes
+} ExpInput_t;
+
+typedef union
+{
+	struct
+	{
+		bool_t relayOutputs[OPTA_DIGITAL_OUT_NUM];
+	} digital; // 8 bytes
+
+	struct
+	{
+		ProgChannel_t analogOutputs[OPTA_ANALOG_OUT_NUM]; // float / uint16_t
+		PWM_t pwmOutputs[OPTA_PWM_OUT_NUM];
+		bool_t ledOutputs[OPTA_LED_OUT_NUM];
+	} analog; // 72 bytes
+} ExpOutput_t;
+
+extern ExpInput_t  sysExpInputs [MAX_OPTA_IOEXP];
+extern ExpOutput_t sysExpOutputs[MAX_OPTA_IOEXP];
+#endif
+
+bool_t IOPlugin_GetDigitalInput(uint8_t id);
+bool_t IOPlugin_GetDigitalOutput(uint8_t id);
+bool_t IOPlugin_SetDigitalOutput(uint8_t id, bool_t value);
+int32_t IOPlugin_GetAnalogInput(uint8_t id);
+int32_t IOPlugin_GetAnalogOutput(uint8_t id);
+bool_t IOPlugin_SetAnalogOutput(uint8_t id, int32_t value);
+
+#endif 	//	IOPLUGIN_H

src/IOPluginDefs.h

@@ -0,0 +1,96 @@
+#pragma once
+
+// also defined in AlPlcMisrac.h ; howevere required here to let include this .h directly in the sketch
+typedef uint8_t bool_t;
+
+#if defined( ARDUINO_PORTENTA_H7_M7 )
+
+	#define NUM_DIGITAL_INPUTS		8
+	#define NUM_DIGITAL_OUTPUTS		8
+	#define NUM_ANALOG_INPUTS		3		// DINT
+	#define NUM_ANALOG_OUTPUTS		4		// REAL
+	#define NUM_PROG_DIGITAL_IO     12
+	#define NUM_SYS_TEMP_PROBES     3		// REAL
+	#define NUM_SYS_ENCODERS        2		// DINT*3
+
+	#define IO_TOT_DIGITAL_OUTPUTS		(NUM_DIGITAL_OUTPUTS + NUM_PROG_DIGITAL_IO)
+	#define IO_TOT_DIGITAL_INPUTS		NUM_DIGITAL_INPUTS
+	#define IO_TOT_ANALOG_OUTPUTS		NUM_ANALOG_OUTPUTS
+	#define IO_TOT_ANALOG_INPUTS		(NUM_ANALOG_INPUTS + NUM_SYS_TEMP_PROBES)
+
+	typedef struct _sysEncoderInputType
+	{
+		int currentState;
+		int pulsesCount;
+		int revolutionsCount;
+	} sysEncoderInputType;
+
+#elif defined( ARDUINO_OPTA )
+
+	// da Arduino_Opta_Blueprint\src
+	// invece di includere OptaBlue.h che è la "radice" che tirerebbe dentro c++ include qui questo solo per numero i/o
+	#include <DigitalCommonCfg.h>
+	#include <AnalogCommonCfg.h>
+
+	// diciture "simili" a quelle di DigitalCommonCfg.h
+	#define OPTA_ANALOG_IN_NUM		OA_AN_CHANNELS_NUM			// programmabile, fino a max 8
+	#define OPTA_ANALOG_OUT_NUM		OA_AN_CHANNELS_NUM			// programmabile, fino a max 8
+	#define OPTA_PWM_OUT_NUM		OA_PWM_CHANNELS_NUM			// 4 pwm
+	#define OPTA_LED_OUT_NUM		OA_LED_NUM
+
+	typedef struct
+	{
+		uint32_t period;
+		uint32_t pulse;
+	} PWM_t;
+	
+	typedef union
+	{
+		float rtd;
+		uint16_t an;
+		bool_t dig;
+		int32_t raw;
+	} ProgChannel_t;
+
+	#define NUM_PROG_INPUTS			8
+	#define NUM_RELAY_OUTPUTS		4
+	#define NUM_LED_OUTPUTS			7
+	#define NUM_BUTTON_INPUTS		1
+
+	// al momento minore di quello effettivamente supportato dalla libreria (OPTA_CONTROLLER_MAX_EXPANSION_NUM=10), concordato con Arduino
+	#define MAX_OPTA_IOEXP 5
+	typedef uint16_t ExpType_t;
+
+	#define IO_TOT_ANEXP_OUT			(OPTA_ANALOG_OUT_NUM + OPTA_PWM_OUT_NUM * 2)   // 16 out per exp
+
+	#define IO_TOT_DIGITAL_INPUTS		(NUM_PROG_INPUTS + NUM_BUTTON_INPUTS + MAX_OPTA_IOEXP*OPTA_DIGITAL_IN_NUM)
+	#define IO_TOT_DIGITAL_OUTPUTS		(NUM_RELAY_OUTPUTS + NUM_LED_OUTPUTS + MAX_OPTA_IOEXP*OPTA_DIGITAL_OUT_NUM)
+	// poichè su exp digitale i prog inputs si possono usare anche come analog e sono di più degli input della exp analogica, usa quelli
+	#define IO_TOT_ANALOG_INPUTS		(NUM_PROG_INPUTS + MAX_OPTA_IOEXP*OPTA_DIGITAL_IN_NUM)
+	#define IO_TOT_ANALOG_OUTPUTS		(MAX_OPTA_IOEXP*IO_TOT_ANEXP_OUT)
+
+#endif
+
+//  GetDigitalInput
+#define IOPLUGIN_GETDIGITALINPUT_FN		"IOPlugin_GetDigitalInput"
+typedef bool_t (* IOPlugin_GetDigitalInput_func)( uint8_t id );
+
+//  GetDigitalOutput
+#define IOPLUGIN_GETDIGITALOUTPUT_FN	"IOPlugin_GetDigitalOutput"
+typedef bool_t (* IOPlugin_GetDigitalOutput_func)( uint8_t id );
+
+//  SetDigitalOutput
+#define IOPLUGIN_SETDIGITALOUTPUT_FN	"IOPlugin_SetDigitalOutput"
+typedef bool_t (* IOPlugin_SetDigitalOutput_func)( uint8_t id, bool_t value );
+
+//  GetAnalogInput
+#define IOPLUGIN_GETANALOGINPUT_FN		"IOPlugin_GetAnalogInput"
+typedef int32_t (* IOPlugin_GetAnalogInput_func)( uint8_t id );
+
+//  GetAnalogOutput
+#define IOPLUGIN_GETANALOGOUTPUT_FN		"IOPlugin_GetAnalogOutput"
+typedef int32_t (* IOPlugin_GetAnalogOutput_func)( uint8_t id );
+
+//  SetAnalogOutput
+#define IOPLUGIN_SETANALOGOUTPUT_FN		"IOPlugin_SetAnalogOutput"
+typedef bool_t (* IOPlugin_SetAnalogOutput_func)( uint8_t id, int32_t value );