Merge pull request #14 from Advanced-Crypto-Services/ACSOS-RELEASE-v0.1

ACSOS v0.1 Initial release

- Adding CRC Functions for Bitaxe Touch
- ACSOS WebUI
- Autotune framework directly in ACS-ESP-MINER
- Better theme syncing
- Better Model Management for Bitaxe Touch

Author: ACSBEN

.DS_Store

@@ -5,10 +5,6 @@ dependencies.lock
 
 # Visual Studio Code
 .vscode/*
-!.vscode/settings.json
-!.vscode/tasks.json
-!.vscode/launch.json
-!.vscode/extensions.json
 .history/*
 
 # Production folder

.github/.DS_Store

@@ -0,0 +1,268 @@
+# Autotune and Presets Documentation
+
+## Overview
+
+The ESP miner implements two complementary systems for power management optimization:
+
+1. **Presets System**: Pre-configured settings for different performance profiles
+2. **Autotuning Logic**: Dynamic adjustment of mining parameters based on real-time conditions
+
+## Presets System
+
+### Device Model Support
+
+The presets system supports four device models, each with tailored configurations:
+
+- **DEVICE_MAX**: 1x BM1397 Asic from the S17 series
+- **DEVICE_ULTRA**: 1x BM1366 Asic from S19XP 
+- **DEVICE_SUPRA**: 1x BM1368 Asic from S21
+- **DEVICE_GAMMA**: 1x BM1370 Asic from S21 Pro
+
+### Preset Profiles
+
+Each device model supports three preset profiles:
+
+#### Quiet Mode
+- **Purpose**: Low power consumption and noise
+- **Characteristics**: Conservative voltage and frequency settings
+- **Use Case**: Home mining, noise-sensitive environments
+
+#### Balanced Mode  
+- **Purpose**: Optimal performance-to-efficiency ratio
+- **Characteristics**: Moderate voltage and frequency settings
+- **Use Case**: General purpose mining
+
+#### Turbo Mode
+- **Purpose**: Maximum performance
+- **Characteristics**: High voltage and frequency settings
+- **Use Case**: Maximum hashrate scenarios
+
+### Preset Configuration Examples
+
+| Device Model | Profile | Voltage (mV) | Frequency (MHz) | Fan Speed (%) |
+|--------------|---------|--------------|-----------------|---------------|
+| DEVICE_MAX   | quiet   | 1100         | 450             | 50            |
+| DEVICE_MAX   | balanced| 1200         | 550             | 65            |
+| DEVICE_MAX   | turbo   | 1400         | 750             | 100           |
+| DEVICE_ULTRA | quiet   | 1130         | 420             | 25            |
+| DEVICE_ULTRA | balanced| 1190         | 490             | 35            |
+| DEVICE_ULTRA | turbo   | 1250         | 625             | 95            |
+
+### Preset Application Process
+
+When a preset is applied:
+
+1. **Safety First**: Fan speed is temporarily set to 100% for safety
+2. **Parameter Setting**: Voltage, frequency, and fan speed are configured
+3. **NVS Storage**: Settings are persisted to non-volatile storage
+4. **Autotune Enable**: Autotune flag is activated
+5. **Logging**: Configuration change is logged to database
+
+### NVS Configuration Keys
+
+- `NVS_CONFIG_ASIC_VOLTAGE`: Core voltage in millivolts
+- `NVS_CONFIG_ASIC_FREQ`: ASIC frequency in MHz
+- `NVS_CONFIG_FAN_SPEED`: Fan speed percentage
+- `NVS_CONFIG_AUTOTUNE_PRESET`: Applied preset name
+- `NVS_CONFIG_AUTOTUNE_FLAG`: Autotune enable/disable flag
+- `NVS_CONFIG_AUTO_FAN_SPEED`: Automatic fan control flag
+
+## Autotuning Logic
+
+### Purpose
+
+The autotuning system dynamically adjusts mining parameters to:
+- Maintain optimal operating temperature (60°C target)
+- Maximize hashrate within power and thermal limits
+- Prevent overheating and hardware damage
+- Optimize performance-per-watt efficiency
+
+### Key Parameters
+
+#### Target Values
+- **Target Temperature**: 60°C (optimal ASIC operating temperature)
+- **Temperature Tolerance**: ±2°C around target
+- **Hashrate Target**: Calculated based on frequency and core count
+
+#### Safety Limits
+- **Maximum Power**: Device-specific power limit
+- **Maximum Voltage**: Device-specific voltage limit  
+- **Maximum Frequency**: Device-specific frequency limit
+- **Thermal Limits**: 75°C throttle, 90°C emergency shutdown
+
+### Timing Mechanism
+
+#### Warmup Period
+- **Duration**: 15 minutes (900 seconds) from startup
+- **Purpose**: Allow system to reach thermal equilibrium
+- **Behavior**: No adjustments during warmup if temperature < target
+
+#### Adjustment Intervals
+- **Normal Operation**: 5 minutes (300 seconds) when temp ≤ 68°C
+- **High Temperature**: 5 seconds when temp > 68°C
+- **Purpose**: Faster response during thermal stress
+
+### Temperature-Based Adjustments
+
+#### Temperature Within Target Range (-2°C to +2°C)
+**Condition**: Temperature is 58°C - 62°C
+
+**Action**: Hashrate optimization
+- If hashrate < 80% of target: Increase voltage by 10mV
+- If hashrate ≥ 80% of target: No adjustment needed
+
+#### Temperature Below Target (< -2°C)
+**Condition**: Temperature < 58°C
+
+**Actions**: Performance increase
+- Increase frequency by 2% (if within limits)
+- Increase voltage by 0.2% (if within limits)
+- Check power consumption limits before adjustment
+
+**Safety Checks**:
+- Frequency must be below maximum frequency limit
+- Power consumption must be below maximum power limit
+- Voltage must be below maximum voltage limit
+
+#### Temperature Above Target (> +2°C)  
+**Condition**: Temperature > 62°C
+
+**Actions**: Performance reduction
+- Decrease frequency by 2%
+- Decrease voltage by 0.2%
+
+**Purpose**: Reduce heat generation to bring temperature back to target
+
+### Safety and Monitoring
+
+#### Prerequisites for Autotune Operation
+- Temperature sensor must be initialized (temp ≠ 255)
+- Hashrate must be > 0 (system actively mining)
+- Autotune flag must be enabled in NVS configuration
+
+#### Overheat Protection
+- **Throttle Temperature**: 75°C - Triggers Overheat Mode
+- **VR Temperature Limit**: 105°C throttle, 145°C maximum
+- **Actions**: Fan to 100%, voltage/frequency reduction, system shutdown if needed
+
+#### Data Logging
+All autotune adjustments are logged to the database with:
+- Timestamp and event type
+- Current and target values
+- Adjustment reasons and amounts
+- System state information
+
+### Algorithm Flow
+
+```
+1. Check Prerequisites
+   ├── Autotune enabled?
+   ├── Valid temperature reading?
+   ├── Hashrate > 0?
+   └── Outside warmup period?
+
+2. Timing Check
+   ├── Sufficient time elapsed since last adjustment?
+   └── Use appropriate interval (normal vs high temp)
+
+3. Temperature Analysis
+   ├── Calculate temperature difference from target (60°C)
+   └── Determine adjustment strategy
+
+4. Parameter Adjustment
+   ├── Within target range → Optimize hashrate
+   ├── Below target → Increase performance  
+   └── Above target → Decrease performance
+
+5. Safety Validation
+   ├── Check power limits
+   ├── Check voltage limits
+   ├── Check frequency limits
+   └── Apply changes if safe
+
+6. Logging and Monitoring
+   ├── Log adjustment to database
+   ├── Update NVS configuration
+   └── Monitor for next cycle
+```
+
+### Integration with Hardware Control
+
+#### Voltage Control
+- **Module**: VCORE (TPS546 voltage regulator)
+- **Range**: Device-specific minimum to maximum voltage
+- **Precision**: 1mV increments
+- **Response Time**: Immediate
+
+#### Frequency Control  
+- **Module**: BM1397 ASIC frequency control
+- **Range**: 50 MHz to device maximum
+- **Precision**: 1 MHz increments  
+- **Response Time**: Requires frequency transition process
+
+#### Temperature Monitoring
+- **Sensor**: EMC2101 temperature controller
+- **ASIC Temperature**: External sensor reading
+- **VR Temperature**: TPS546 internal temperature
+- **Update Rate**: Every 2 seconds (POLL_RATE)
+
+### Performance Optimization Features
+
+#### Adaptive Learning
+- System learns optimal settings through operation
+- Adjustments become more refined over time
+- Historical performance data influences decisions
+
+#### Power Efficiency
+- Monitors power consumption vs hashrate
+- Optimizes for maximum GH/s per watt
+- Prevents power limit violations
+
+#### Thermal Management
+- Proactive temperature control
+- Coordinated fan speed adjustment
+- Prevents thermal damage to components
+
+## Configuration and Usage
+
+### Enabling Autotune
+```c
+nvs_config_set_u16(NVS_CONFIG_AUTOTUNE_FLAG, 1);  // Enable
+nvs_config_set_u16(NVS_CONFIG_AUTOTUNE_FLAG, 0);  // Disable
+```
+
+### Applying Presets
+```c
+// Apply preset by name
+apply_preset(DEVICE_MAX, "balanced");
+apply_preset(DEVICE_ULTRA, "turbo");
+apply_preset(DEVICE_SUPRA, "quiet");
+```
+
+### Manual Override
+Individual parameters can be manually set to override autotune:
+```c
+nvs_config_set_u16(NVS_CONFIG_ASIC_VOLTAGE, 1200);  // Set voltage
+nvs_config_set_u16(NVS_CONFIG_ASIC_FREQ, 600);      // Set frequency
+nvs_config_set_u16(NVS_CONFIG_AUTO_FAN_SPEED, 0);   // Disable auto fan
+```
+
+## Best Practices
+
+### Recommended Usage
+1. **Initial Setup**: Start with "balanced" preset for your device model
+2. **Break-in Period**: Allow 24-48 hours for thermal stabilization
+3. **Environment Consideration**: Adjust for ambient temperature and ventilation
+4. **Monitoring**: Watch logs for adjustment patterns and stability
+
+### Troubleshooting
+- **Frequent Adjustments**: Check ambient temperature and cooling
+- **Poor Hashrate**: Verify power supply capacity and connections
+- **Overheating**: Improve ventilation or reduce ambient temperature
+- **Instability**: Consider using "quiet" preset for more conservative operation
+
+### Safety Considerations
+- Never disable overheat protection
+- Ensure adequate power supply capacity
+- Monitor system logs regularly
+- Maintain proper ventilation and cooling 

.gitignore

@@ -13,7 +13,7 @@ esp_err_t SERIAL_set_baud(int baud);
 
 esp_err_t SERIAL_init_BAP(void);
 int SERIAL_send_BAP(uint8_t *, int, bool);
-int16_t SERIAL_rx_BAP(uint8_t *, uint16_t, uint16_t);
+//int16_t SERIAL_rx_BAP(uint8_t *, uint16_t, uint16_t);
 void SERIAL_clear_buffer_BAP(void);
 void SERIAL_set_baud_BAP(int baud);
 

autotune.md

@@ -1,4 +1,3 @@
-
 #include "esp_event.h"
 #include "esp_log.h"
 #include "esp_system.h"

components/.DS_Store

@@ -1,24 +1,28 @@
 key,type,encoding,value
 main,namespace,,
-hostname,data,string,bitaxe
-wifissid,data,string,myssid
-wifipass,data,string,password
+hostname,data,string,acsbitaxe
+wifissid,data,string,Bitaxe
+wifipass,data,string,satoshi256
 stratumurl,data,string,public-pool.io
 stratumport,data,u16,21496
-stratumuser,data,string,bc1qnp980s5fpp8l94p5cvttmtdqy8rvrq74qly2yrfmzkdsntqzlc5qkc4rkq.bitaxe
+stratumuser,data,string,bc1qa2500jc3cwjnklv4tdme4e6ascvvl5w8jezxlh.bitaxe
 stratumpass,data,string,x
 fbstratumurl,data,string,solo.ckpool.org
 fbstratumport,data,u16,3333
-fbstratumuser,data,string,bc1qnp980s5fpp8l94p5cvttmtdqy8rvrq74qly2yrfmzkdsntqzlc5qkc4rkq.bitaxe
+fbstratumuser,data,string,bc1qa2500jc3cwjnklv4tdme4e6ascvvl5w8jezxlh.bitaxe
 fbstratumpass,data,string,x
-asicfrequency,data,u16,490
-asicvoltage,data,u16,1166
+asicfrequency,data,u16,575
+asicvoltage,data,u16,1200
 asicmodel,data,string,BM1368
 devicemodel,data,string,supra
 boardversion,data,string,403
 flipscreen,data,u16,1
 invertfanpol,data,u16,1
-autofanspeed,data,u16,1
-fanspeed,data,u16,100
+autofanspeed,data,u16,0
+fanspeed,data,u16,30
 selftest,data,u16,1
-overheat_mode,data,u16,0
+overheat_mode,data,u16,0
+serialnumber,data,string,MAC123451370
+builddate,data,string,06052025
+autotune,data,u16,1
+preset,data,string,balanced

components/asic/include/serial.h

@@ -1,24 +1,28 @@
 key,type,encoding,value
 main,namespace,,
-hostname,data,string,bitaxe
-wifissid,data,string,myssid
-wifipass,data,string,password
+hostname,data,string,acsbitaxe
+wifissid,data,string,Bitaxe
+wifipass,data,string,satoshi256
 stratumurl,data,string,public-pool.io
 stratumport,data,u16,21496
-stratumuser,data,string,bc1qnp980s5fpp8l94p5cvttmtdqy8rvrq74qly2yrfmzkdsntqzlc5qkc4rkq.bitaxe
+stratumuser,data,string,bc1qa2500jc3cwjnklv4tdme4e6ascvvl5w8jezxlh.bitaxe
 stratumpass,data,string,x
 fbstratumurl,data,string,solo.ckpool.org
 fbstratumport,data,u16,3333
-fbstratumuser,data,string,bc1qnp980s5fpp8l94p5cvttmtdqy8rvrq74qly2yrfmzkdsntqzlc5qkc4rkq.bitaxe
+fbstratumuser,data,string,bc1qa2500jc3cwjnklv4tdme4e6ascvvl5w8jezxlh.bitaxe
 fbstratumpass,data,string,x
-asicfrequency,data,u16,525
-asicvoltage,data,u16,1150
+asicfrequency,data,u16,490
+asicvoltage,data,u16,1090
 asicmodel,data,string,BM1370
 devicemodel,data,string,gamma
 boardversion,data,string,601
 flipscreen,data,u16,1
 invertfanpol,data,u16,1
-autofanspeed,data,u16,1
-fanspeed,data,u16,100
+autofanspeed,data,u16,0
+fanspeed,data,u16,35
 selftest,data,u16,1
-overheat_mode,data,u16,0
+overheat_mode,data,u16,0
+serialnumber,data,string,MAC123451370
+builddate,data,string,06052025
+autotune,data,u16,1
+preset,data,string,balanced

components/connect/connect.c

@@ -17,4 +17,8 @@ invertfanpol,data,u16,1
 autofanspeed,data,u16,1
 fanspeed,data,u16,100
 selftest,data,u16,1
-overheat_mode,data,u16,0
+overheat_mode,data,u16,0
+serialnumber,data,string,ACSBAT_BM1368_11232
+builddate,data,string,05262025
+autotune,data,u16,1
+preset,data,string,balanced