chore: remove monolithic src/ copy, firmware/ is now canonical
src/clock_ntp_ota_v1.9.ino was a duplicate of firmware/clock_ntp_ota_v1.9/ that had already drifted out of sync. Removing it eliminates the need to patch both copies on every PR. Updated CONTRIBUTING.md build path to point to firmware/clock_ntp_ota_v1.9. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Sonnet 4.6
parent
98b40ff0cf
commit
29d7c7f8ad
+10
-2
@@ -7,6 +7,7 @@ Thank you for your interest in contributing! This project welcomes improvements,
|
|||||||
### Reporting Bugs
|
### Reporting Bugs
|
||||||
|
|
||||||
If you find a bug, please open an issue with:
|
If you find a bug, please open an issue with:
|
||||||
|
|
||||||
- Clear description of the problem
|
- Clear description of the problem
|
||||||
- Steps to reproduce
|
- Steps to reproduce
|
||||||
- Expected vs actual behavior
|
- Expected vs actual behavior
|
||||||
@@ -16,6 +17,7 @@ If you find a bug, please open an issue with:
|
|||||||
### Suggesting Features
|
### Suggesting Features
|
||||||
|
|
||||||
Feature requests are welcome! Please include:
|
Feature requests are welcome! Please include:
|
||||||
|
|
||||||
- Use case description
|
- Use case description
|
||||||
- Why this would be useful
|
- Why this would be useful
|
||||||
- Any implementation ideas
|
- Any implementation ideas
|
||||||
@@ -38,16 +40,19 @@ Feature requests are welcome! Please include:
|
|||||||
### Code Guidelines
|
### Code Guidelines
|
||||||
|
|
||||||
**Memory Safety:**
|
**Memory Safety:**
|
||||||
|
|
||||||
- Check IRAM usage after adding code
|
- Check IRAM usage after adding code
|
||||||
- Use fixed-size buffers instead of dynamic allocation where possible
|
- Use fixed-size buffers instead of dynamic allocation where possible
|
||||||
- Prefer `snprintf` over String concatenation
|
- Prefer `snprintf` over String concatenation
|
||||||
|
|
||||||
**Async Architecture:**
|
**Async Architecture:**
|
||||||
|
|
||||||
- Keep loop() non-blocking (no delay() calls)
|
- Keep loop() non-blocking (no delay() calls)
|
||||||
- Use state machines for multi-step operations
|
- Use state machines for multi-step operations
|
||||||
- Add exponential backoff to network operations
|
- Add exponential backoff to network operations
|
||||||
|
|
||||||
**Testing:**
|
**Testing:**
|
||||||
|
|
||||||
- Test on ESP-01S hardware (1MB flash, 80KB RAM)
|
- Test on ESP-01S hardware (1MB flash, 80KB RAM)
|
||||||
- Verify OTA updates work
|
- Verify OTA updates work
|
||||||
- Check 24h stability
|
- Check 24h stability
|
||||||
@@ -55,18 +60,21 @@ Feature requests are welcome! Please include:
|
|||||||
## Development Setup
|
## Development Setup
|
||||||
|
|
||||||
### Requirements
|
### Requirements
|
||||||
|
|
||||||
- Arduino IDE 1.8.x or 2.x
|
- Arduino IDE 1.8.x or 2.x
|
||||||
- ESP8266 board support (v3.0.0+)
|
- ESP8266 board support (v3.0.0+)
|
||||||
- Libraries (see README)
|
- Libraries (see README)
|
||||||
|
|
||||||
### Building
|
### Building
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Arduino IDE: Sketch → Verify/Compile
|
# Arduino IDE: Sketch → Verify/Compile
|
||||||
# Or use arduino-cli:
|
# Or use arduino-cli:
|
||||||
arduino-cli compile --fqbn esp8266:esp8266:generic src/clock_ntp_ota_v1.9.ino
|
arduino-cli compile --fqbn esp8266:esp8266:generic firmware/clock_ntp_ota_v1.9
|
||||||
```
|
```
|
||||||
|
|
||||||
### Testing
|
### Testing
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Upload via FTDI (first time)
|
# Upload via FTDI (first time)
|
||||||
arduino-cli upload -p /dev/cu.usbserial* --fqbn esp8266:esp8266:generic
|
arduino-cli upload -p /dev/cu.usbserial* --fqbn esp8266:esp8266:generic
|
||||||
@@ -79,7 +87,7 @@ curl -u admin:admin -F "file=@build/*.bin" http://192.168.x.x/update
|
|||||||
|
|
||||||
```
|
```
|
||||||
esp8266-weather-clock-opensource/
|
esp8266-weather-clock-opensource/
|
||||||
├── src/ # Main firmware source
|
├── firmware/ # Main firmware source (clock_ntp_ota_v1.9/)
|
||||||
├── docs/ # Documentation
|
├── docs/ # Documentation
|
||||||
├── images/ # Photos and screenshots
|
├── images/ # Photos and screenshots
|
||||||
├── README.md # Main documentation
|
├── README.md # Main documentation
|
||||||
|
|||||||
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user