#include "pin_manager.h" #include "wled.h" #ifdef WLED_DEBUG static void DebugPrintOwnerTag(PinOwner tag) { uint32_t q = static_cast(tag); if (q) { DEBUG_PRINTF("0x%02x (%d)", q, q); } else { DEBUG_PRINT(F("(no owner)")); } } #endif /// Actual allocation/deallocation routines bool PinManagerClass::deallocatePin(byte gpio, PinOwner tag) { if (gpio == 0xFF) return true; // explicitly allow clients to free -1 as a no-op if (!isPinOk(gpio, false)) return false; // but return false for any other invalid pin // if a non-zero ownerTag, only allow de-allocation if the owner's tag is provided if ((ownerTag[gpio] != PinOwner::None) && (ownerTag[gpio] != tag)) { #ifdef WLED_DEBUG DEBUG_PRINT(F("PIN DEALLOC: IO ")); DEBUG_PRINT(gpio); DEBUG_PRINT(F(" allocated by ")); DebugPrintOwnerTag(ownerTag[gpio]); DEBUG_PRINT(F(", but attempted de-allocation by ")); DebugPrintOwnerTag(tag); #endif return false; } byte by = gpio >> 3; byte bi = gpio - 8*by; bitWrite(pinAlloc[by], bi, false); ownerTag[gpio] = PinOwner::None; return true; } // support function for deallocating multiple pins bool PinManagerClass::deallocateMultiplePins(const uint8_t *pinArray, byte arrayElementCount, PinOwner tag) { bool shouldFail = false; DEBUG_PRINTLN(F("MULTIPIN DEALLOC")); // first verify the pins are OK and allocated by selected owner for (int i = 0; i < arrayElementCount; i++) { byte gpio = pinArray[i]; if (gpio == 0xFF) { // explicit support for io -1 as a no-op (no allocation of pin), // as this can greatly simplify configuration arrays continue; } if (isPinAllocated(gpio, tag)) { // if the current pin is allocated by selected owner it is possible to release it continue; } #ifdef WLED_DEBUG DEBUG_PRINT(F("PIN DEALLOC: IO ")); DEBUG_PRINT(gpio); DEBUG_PRINT(F(" allocated by ")); DebugPrintOwnerTag(ownerTag[gpio]); DEBUG_PRINT(F(", but attempted de-allocation by ")); DebugPrintOwnerTag(tag); #endif shouldFail = true; } if (shouldFail) { return false; // no pins deallocated } if (tag==PinOwner::HW_I2C) { if (i2cAllocCount && --i2cAllocCount>0) { // no deallocation done until last owner releases pins return true; } } for (int i = 0; i < arrayElementCount; i++) { deallocatePin(pinArray[i], tag); } return true; } bool PinManagerClass::allocateMultiplePins(const managed_pin_type * mptArray, byte arrayElementCount, PinOwner tag) { bool shouldFail = false; // first verify the pins are OK and not already allocated for (int i = 0; i < arrayElementCount; i++) { byte gpio = mptArray[i].pin; if (gpio == 0xFF) { // explicit support for io -1 as a no-op (no allocation of pin), // as this can greatly simplify configuration arrays continue; } if (!isPinOk(gpio, mptArray[i].isOutput)) { #ifdef WLED_DEBUG DEBUG_PRINT(F("PIN ALLOC: Invalid pin attempted to be allocated: ")); DEBUG_PRINT(gpio); DEBUG_PRINTLN(F("")); #endif shouldFail = true; } if (tag==PinOwner::HW_I2C && isPinAllocated(gpio, tag)) { // allow multiple "allocations" of HW I2C bus pins continue; } else if (isPinAllocated(gpio)) { #ifdef WLED_DEBUG DEBUG_PRINT(F("PIN ALLOC: FAIL: IO ")); DEBUG_PRINT(gpio); DEBUG_PRINT(F(" already allocated by ")); DebugPrintOwnerTag(ownerTag[gpio]); DEBUG_PRINTLN(F("")); #endif shouldFail = true; } } if (shouldFail) { return false; } if (tag==PinOwner::HW_I2C) i2cAllocCount++; // all pins are available .. track each one for (int i = 0; i < arrayElementCount; i++) { byte gpio = mptArray[i].pin; if (gpio == 0xFF) { // allow callers to include -1 value as non-requested pin // as this can greatly simplify configuration arrays continue; } byte by = gpio >> 3; byte bi = gpio - 8*by; bitWrite(pinAlloc[by], bi, true); ownerTag[gpio] = tag; #ifdef WLED_DEBUG DEBUG_PRINT(F("PIN ALLOC: Pin ")); DEBUG_PRINT(gpio); DEBUG_PRINT(F(" allocated by ")); DebugPrintOwnerTag(tag); DEBUG_PRINTLN(F("")); #endif } return true; } bool PinManagerClass::allocatePin(byte gpio, bool output, PinOwner tag) { // HW I2C pins have to be allocated using allocateMultiplePins variant since there is always SCL/SDA pair if (!isPinOk(gpio, output) || tag==PinOwner::HW_I2C) return false; if (isPinAllocated(gpio)) { #ifdef WLED_DEBUG DEBUG_PRINT(F("PIN ALLOC: Pin ")); DEBUG_PRINT(gpio); DEBUG_PRINT(F(" already allocated by ")); DebugPrintOwnerTag(ownerTag[gpio]); DEBUG_PRINTLN(F("")); #endif return false; } byte by = gpio >> 3; byte bi = gpio - 8*by; bitWrite(pinAlloc[by], bi, true); ownerTag[gpio] = tag; #ifdef WLED_DEBUG DEBUG_PRINT(F("PIN ALLOC: Pin ")); DEBUG_PRINT(gpio); DEBUG_PRINT(F(" allocated by ")); DebugPrintOwnerTag(tag); DEBUG_PRINTLN(F("")); #endif return true; } // if tag is set to PinOwner::None, checks for ANY owner of the pin. // if tag is set to any other value, checks if that tag is the current owner of the pin. bool PinManagerClass::isPinAllocated(byte gpio, PinOwner tag) { if (!isPinOk(gpio, false)) return true; if ((tag != PinOwner::None) && (ownerTag[gpio] != tag)) return false; byte by = gpio >> 3; byte bi = gpio - (by<<3); return bitRead(pinAlloc[by], bi); } bool PinManagerClass::isPinOk(byte gpio, bool output) { if (gpio < 6) return true; if (gpio < 12) return false; //SPI flash pins #ifdef ESP8266 if (gpio < 17) return true; #else //ESP32 if (gpio < 34) return true; if (gpio < 40 && !output) return true; //34-39 input only #endif return false; } PinOwner PinManagerClass::getPinOwner(byte gpio) { if (!isPinOk(gpio, false)) return PinOwner::None; return ownerTag[gpio]; } #ifdef ARDUINO_ARCH_ESP32 byte PinManagerClass::allocateLedc(byte channels) { if (channels > 16 || channels == 0) return 255; byte ca = 0; for (byte i = 0; i < 16; i++) { byte by = i >> 3; byte bi = i - 8*by; if (bitRead(ledcAlloc[by], bi)) { //found occupied pin ca = 0; } else { ca++; } if (ca >= channels) { //enough free channels byte in = (i + 1) - ca; for (byte j = 0; j < ca; j++) { byte b = in + j; byte by = b >> 3; byte bi = b - 8*by; bitWrite(ledcAlloc[by], bi, true); } return in; } } return 255; //not enough consecutive free LEDC channels } void PinManagerClass::deallocateLedc(byte pos, byte channels) { for (byte j = pos; j < pos + channels; j++) { if (j > 16) return; byte by = j >> 3; byte bi = j - 8*by; bitWrite(ledcAlloc[by], bi, false); } } #endif PinManagerClass pinManager = PinManagerClass();