Repository navigation
🎉 MAX7219_CH32 v1.0.0 - Initial Release
A lightweight, memory-optimized Arduino library for controlling MAX7219 7-segment displays
✨ What's New
This is the initial production release of MAX7219_CH32, a comprehensive library designed specifically for memory-constrained microcontrollers like the CH32V003, while maintaining full compatibility with standard Arduino boards.
🎯 Key Features
Dual Display Modes
- BCD Decode Mode: Hardware-accelerated display for numbers (0-9)
- No-Decode Mode: Software-controlled display for text, letters, and custom patterns
Flexible Display Options
- 📐 Alignment Control: Left, right, and center alignment
- 🔢 Multiple Formats: Integers, floats, text, time (HH:MM, HH:MM:SS), hex, binary
- 🎛️ Brightness Control: 16-level brightness adjustment (0-15)
- ⚡ Power Management: Programmatic display on/off control
Rich Animation Support
- 💫 Blink animations
- 🌊 Fade in/out effects
- 📜 Text scrolling
- ✨ Chase animations
- 🔢 Count up/down animations
Memory Optimized
- 💾 Flash Usage: ~6-8 KB
- 💾 RAM Usage: ~200-300 bytes
- 🎯 Optimized for: CH32V003 and other resource-constrained microcontrollers
📦 Platform Support
- ✅ CH32V003 (primary target, tested and optimized)
- ✅ Arduino Uno/Nano
- ✅ Arduino Mega
- ✅ ESP32
- ✅ ESP8266
- ✅ Other Arduino-compatible boards
📚 Documentation
- 📖 Comprehensive API Documentation
- 💡 Example sketches included
- 📝 Full README with wiring diagrams and troubleshooting
🚀 Quick Start
#include <MAX7219_CH32.h>
MAX7219 display(12, 11, 10, 8); // DIN, CLK, CS, digits
void setup() {
display.begin(MAX7219_MODE_DECODE);
display.setBrightness(8);
display.display(12345);
}## 📋 Installation
Arduino Library Manager (Recommended)
- Open Arduino IDE
- Go to Tools → Manage Libraries
- Search for "MAX7219_CH32"
- Click Install
Manual Installation
Download the ZIP and extract to your Arduino libraries folder.
🔗 Links
- 📖 Documentation
- 💬 Issues
- 📝 Repository
📄 License
MIT License - See LICENSE file for details.
Made with ❤️ for the Arduino community