مقاومت SIP-9 Array (9 پایه):
پایه 1: پین مشترک (COM)
پایه 2: مقاومت 1 (10KΩ)
پایه 3: مقاومت 2 (10KΩ)
پایه 4: مقاومت 3 (10KΩ)
پایه 5: مقاومت 4 (10KΩ)
پایه 6: مقاومت 5 (10KΩ)
پایه 7: مقاومت 6 (10KΩ)
پایه 8: مقاومت 7 (10KΩ)
پایه 9: مقاومت 8 (10KΩ)

هر مقاومت مستقل اما در یک پکیج فشرده

**J1 (PU/PD Select):**
- موقعیت UP: Pull-up (مقاومت به VCC)
- موقعیت DOWN: Pull-down (مقاومت به GND)

**J2 (Active Mode):**
- موقعیت LEFT: Active-High (فعال = HIGH)
- موقعیت RIGHT: Active-Low (فعال = LOW)

**J3 (LED Enable):**
- وصل: LED‌ها فعال
- قطع: LED‌ها غیرفعال

**J4 (Voltage Select):**
- 3V3: تغذیه 3.3V
- 5V0: تغذیه 5V

پین‌های ورودی/خروجی:
VCC  → تغذیه مثبت (با J4 انتخاب می‌شود)
GND  → زمین
SW1  → خروجی کلید 1
SW2  → خروجی کلید 2
SW3  → خروجی کلید 3
SW4  → خروجی کلید 4
SW5  → خروجی کلید 5
SW6  → خروجی کلید 6
SW7  → خروجی کلید 7
SW8  → خروجی کلید 8

پین‌های کمکی:
LED_COM → کاتد مشترک LED‌ها
TEST   → پین تست مدار

مدار برای یک کلید:
VCC → مقاومت 10KΩ → خروجی SW → میکروکنترلر
                   ↓
                 کلید → GND

عملکرد:
- کلید باز: خروجی HIGH (از طریق مقاومت به VCC)
- کلید بسته: خروجی LOW (مستقیم به GND)
- فعال = HIGH (آزاد)، غیرفعال = LOW (فشار)

مدار:
VCC → مقاومت 10KΩ → خروجی SW → میکروکنترلر
                   ↓
                 کلید → GND

عملکرد:
- کلید باز: خروجی HIGH
- کلید بسته: خروجی LOW
- اما منطق معکوس در برنامه

مدار:
خروجی SW → میکروکنترلر
         ↓
مقاومت 10KΩ → GND
         ↓
       کلید → VCC

عملکرد:
- کلید باز: خروجی LOW (از طریق مقاومت به GND)
- کلید بسته: خروجی HIGH (مستقیم به VCC)

همان مدار Pull-down اما منطق معکوس

1. **انتخاب ولتاژ (J4):**
   - برای آردوینو 5V: جامپر روی 5V0
   - برای ESP32/3.3V: جامپر روی 3V3

2. **انتخاب Pull-up/Pull-down (J1):**
   - Pull-up: جامپر به سمت UP
   - Pull-down: جامپر به سمت DOWN

3. **انتخاب تحریک (J2):**
   - Active-High: جامپر به سمت LEFT
   - Active-Low: جامپر به سمت RIGHT

4. **تنظیم LED (J3):**
   - فعال: جامپر وصل
   - غیرفعال: جامپر قطع (صرفه‌جویی انرژی)

5. **اتصال به میکروکنترلر:**
   - SW1-SW8 → پین‌های دیجیتال میکرو
   - VCC → تغذیه منطبق با J4
   - GND → زمین مشترک

// تنظیم جامپرها: J1=UP, J2=LEFT, J4=5V
// در این حالت، کلید باز = HIGH، کلید بسته = LOW

void setup() {
  Serial.begin(9600);
  
  // پین‌ها را به عنوان ورودی معمولی تنظیم می‌کنیم
  // چون Pull-up سخت‌افزاری داریم
  for(int i=2; i<=9; i++) {
    pinMode(i, INPUT); // NOT INPUT_PULLUP
  }
  
  Serial.println("حالت: Pull-up + Active-High");
}

void loop() {
  for(int i=2; i<=9; i++) {
    int state = digitalRead(i);
    
    if(state == LOW) { // کلید فشار داده شده
      Serial.print("کلید ");
      Serial.print(i-1);
      Serial.println(" فعال (LOW)");
    }
  }
  delay(100);
}

// تنظیم جامپرها: J1=UP, J2=RIGHT
// در این حالت نیاز به معکوس کردن منطق داریم

void setup() {
  Serial.begin(9600);
  
  for(int i=2; i<=9; i++) {
    pinMode(i, INPUT);
  }
  
  Serial.println("حالت: Pull-up + Active-Low");
}

void loop() {
  for(int i=2; i<=9; i++) {
    int rawState = digitalRead(i);
    int activeState = !rawState; // معکوس کردن
    
    if(activeState == HIGH) {
      Serial.print("کلید ");
      Serial.print(i-1);
      Serial.println(" فعال (پس از معکوس)");
    }
  }
  delay(100);
}

// تنظیم جامپرها: J1=DOWN, J2=LEFT
// کلید باز = LOW، کلید بسته = HIGH

void setup() {
  Serial.begin(9600);
  
  for(int i=2; i<=9; i++) {
    pinMode(i, INPUT);
  }
  
  Serial.println("حالت: Pull-down + Active-High");
}

void loop() {
  for(int i=2; i<=9; i++) {
    int state = digitalRead(i);
    
    if(state == HIGH) { // کلید فشار داده شده
      Serial.print("کلید ");
      Serial.print(i-1);
      Serial.println(" فعال (HIGH)");
    }
  }
  delay(100);
}

class SmartButtonPanel {
  private:
    int pins[8];
    bool isPullUp;      // true = Pull-up, false = Pull-down
    bool isActiveHigh;  // true = Active-High, false = Active-Low
    bool lastStates[8];
    
  public:
    // سازنده با تشخیص خودکار
    SmartButtonPanel(int pinArray[8]) {
      for(int i=0; i<8; i++) {
        pins[i] = pinArray[i];
        pinMode(pins[i], INPUT);
        lastStates[i] = readRaw(i);
      }
      
      // تشخیص خودکار Pull-up/Pull-down
      detectConfiguration();
    }
    
    void detectConfiguration() {
      // تست اولیه: خواندن وضعیت بدون فشار کلید
      int readings[8];
      for(int i=0; i<8; i++) {
        readings[i] = digitalRead(pins[i]);
      }
      
      // اگر بیشتر خوانده‌ها HIGH باشند، احتمالاً Pull-up
      int highCount = 0;
      for(int i=0; i<8; i++) {
        if(readings[i] == HIGH) highCount++;
      }
      
      isPullUp = (highCount >= 4); // اگر نصف یا بیشتر HIGH باشند
      
      Serial.print("تشخیص: حالت ");
      Serial.println(isPullUp ? "Pull-up" : "Pull-down");
      
      // کاربر باید Active-High/Low را مشخص کند
      isActiveHigh = true; // پیش‌فرض
    }
    
    int readRaw(int buttonIndex) {
      return digitalRead(pins[buttonIndex]);
    }
    
    bool isPressed(int buttonIndex) {
      int raw = readRaw(buttonIndex);
      bool pressed;
      
      if(isPullUp) {
        pressed = (raw == LOW); // در Pull-up، فشار = LOW
      } else {
        pressed = (raw == HIGH); // در Pull-down، فشار = HIGH
      }
      
      // اعمال Active-High/Low
      if(!isActiveHigh) {
        pressed = !pressed;
      }
      
      // دبنانس ساده
      if(pressed != lastStates[buttonIndex]) {
        delay(50); // تأخیر دبنانس
        int confirm = readRaw(buttonIndex);
        
        if(isPullUp) {
          pressed = (confirm == LOW);
        } else {
          pressed = (confirm == HIGH);
        }
        
        if(!isActiveHigh) pressed = !pressed;
      }
      
      lastStates[buttonIndex] = pressed;
      return pressed;
    }
    
    // تغییر تنظیمات دستی
    void setPullUp(bool pullUp) {
      isPullUp = pullUp;
      Serial.print("تنظیم دستی: ");
      Serial.println(isPullUp ? "Pull-up" : "Pull-down");
    }
    
    void setActiveHigh(bool activeHigh) {
      isActiveHigh = activeHigh;
      Serial.print("تنظیم دستی: Active-");
      Serial.println(isActiveHigh ? "High" : "Low");
    }
    
    // خواندن تمام کلیدها
    byte readAll() {
      byte result = 0;
      for(int i=0; i<8; i++) {
        if(isPressed(i)) {
          result |= (1 << i);
        }
      }
      return result;
    }
};

// استفاده
int buttonPins[8] = {2,3,4,5,6,7,8,9};
SmartButtonPanel panel(buttonPins);

void setup() {
  Serial.begin(9600);
  
  // اگر جامپر J2 روی RIGHT است (Active-Low)
  // panel.setActiveHigh(false);
}

void loop() {
  byte allButtons = panel.readAll();
  
  if(allButtons != 0) {
    Serial.print("کلیدهای فعال: ");
    Serial.println(allButtons, BIN);
  }
  
  delay(50);
}

// سیستم قابل تنظیم با کلیدهای فیزیکی
class ConfigurableButtonSystem {
  private:
    struct ButtonConfig {
      bool pullUp;
      bool activeHigh;
      int debounceMs;
    } config;
    
    int pins[8];
    unsigned long lastPressTime[8];
    
  public:
    ConfigurableButtonSystem(int pinArray[8]) {
      for(int i=0; i<8; i++) {
        pins[i] = pinArray[i];
        pinMode(pins[i], INPUT);
        lastPressTime[i] = 0;
      }
      
      // تنظیمات پیش‌فرض
      config.pullUp = true;
      config.activeHigh = true;
      config.debounceMs = 50;
    }
    
    void setFromJumpers(bool j1, bool j2) {
      // j1: true = Pull-up, false = Pull-down
      // j2: true = Active-High, false = Active-Low
      
      config.pullUp = j1;
      config.activeHigh = j2;
      
      Serial.print("تنظیم از جامپر: ");
      Serial.print(config.pullUp ? "Pull-up" : "Pull-down");
      Serial.print(" + ");
      Serial.println(config.activeHigh ? "Active-High" : "Active-Low");
    }
    
    bool readButton(int index) {
      unsigned long now = millis();
      
      // بررسی زمان دبنانس
      if(now - lastPressTime[index] < config.debounceMs) {
        return false;
      }
      
      int raw = digitalRead(pins[index]);
      bool pressed;
      
      if(config.pullUp) {
        pressed = (raw == LOW);
      } else {
        pressed = (raw == HIGH);
      }
      
      if(!config.activeHigh) {
        pressed = !pressed;
      }
      
      if(pressed) {
        lastPressTime[index] = now;
      }
      
      return pressed;
    }
};

1. **تست مقاومت‌های آرایه:**
   - مولتی‌متر در حالت مقاومت‌سنج
   - اندازه‌گیری بین پایه 1 و هر پایه 2-9
   - باید حدود 10KΩ باشد

2. **تست Pull-up:**
   - J1 روی UP
   - بدون فشار کلید، خروجی باید HIGH باشد
   - با فشار کلید، خروجی باید LOW شود

3. **تست Pull-down:**
   - J1 روی DOWN
   - بدون فشار کلید، خروجی باید LOW باشد
   - با فشار کلید، خروجی باید HIGH شود

4. **تست Active-Low:**
   - J2 روی RIGHT
   - منطق باید معکوس شود

void comprehensiveTest() {
  Serial.println("=== تست جامع صفحه کلید ===");
  
  // تست Pull-up
  Serial.println("تست حالت Pull-up:");
  // کدهای تست
  
  // تست Pull-down
  Serial.println("تست حالت Pull-down:");
  // کدهای تست
  
  Serial.println("تست کامل شد");
}

// خواندن تنظیمات جامپر و اعمال خودکار
void readHardwareConfig() {
  // می‌توانید پین‌های اضافی برای خواندن جامپرها اختصاص دهید
  bool j1_state = digitalRead(J1_PIN);
  bool j2_state = digitalRead(J2_PIN);
  
  Serial.print("J1: ");
  Serial.println(j1_state ? "Pull-up" : "Pull-down");
  Serial.print("J2: ");
  Serial.println(j2_state ? "Active-High" : "Active-Low");
  
  // اعمال تنظیمات روی سیستم
  applyConfiguration(j1_state, j2_state);
}

enum ButtonMode {
  MODE_PULLUP_ACTIVEHIGH,
  MODE_PULLUP_ACTIVELOW,
  MODE_PULLDOWN_ACTIVEHIGH,
  MODE_PULLDOWN_ACTIVELOW
};

ButtonMode currentMode;

void setupModeFromJumpers() {
  // شبیه‌سازی خواندن جامپرها
  bool pu_pd = digitalRead(PUPD_PIN);
  bool ah_al = digitalRead(AHAL_PIN);
  
  if(pu_pd && ah_al) currentMode = MODE_PULLUP_ACTIVEHIGH;
  if(pu_pd && !ah_al) currentMode = MODE_PULLUP_ACTIVELOW;
  if(!pu_pd && ah_al) currentMode = MODE_PULLDOWN_ACTIVEHIGH;
  if(!pu_pd && !ah_al) currentMode = MODE_PULLDOWN_ACTIVELOW;
}