Skip to content

Commit

Permalink
Release V1.0.0
Browse files Browse the repository at this point in the history
  • Loading branch information
DjordjeMandic committed Dec 23, 2024
1 parent 855cc30 commit 41d5d67
Show file tree
Hide file tree
Showing 4 changed files with 19 additions and 16 deletions.
29 changes: 16 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,24 +24,22 @@ To use UIRBcore, ensure you have the following:

### Using PlatformIO Library Manager

1. Open your PlatformIO project.
2. Add UIRBcore to your `platformio.ini` file using one of the following approaches:
Add UIRBcore to your `platformio.ini` file using one of the following approaches:

```ini
lib_deps =
DjordjeMandic/UIRBcorelib @ ^1.0.0 ; Depend on the latest 1.x stable version
DjordjeMandic/UIRBcorelib @ ^1.0.0 ; Depend on the latest 1.x stable version
```

```ini
lib_deps =
DjordjeMandic/UIRBcorelib @ 1.0.0 ; Depend on the exact 1.0.0 version
```
> **Tip:** Learn more about semantic versioning at [devhints.io/semver](https://devhints.io/semver) and [semver.org](https://semver.org/).
```ini
lib_deps =
https://github.com/DjordjeMandic/UIRBcorelib.git#v1.0.0 ; Depend on a specific Git tag
https://github.com/DjordjeMandic/UIRBcorelib.git#dev ; Depend on the development Git branch
```

> **Tip:** Discover more about specifying packages in PlatformIO by visiting the [official documentation on package specifications](https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_install.html#package-specifications).
### Manually

1. Download the latest release from the [UIRBcore GitHub repository](https://github.com/DjordjeMandic/UIRBcorelib).
Expand Down Expand Up @@ -81,13 +79,18 @@ void loop()
}
```

**Important:** The ATMEGA328P EEPROM must store a valid hardware version for the UIRB constructor to initialize correctly. If the EEPROM does not contain valid data, the constructor will cause the system to hang and reboot.
> **Important:** The ATMEGA328P EEPROM must store a valid hardware version for the UIRB constructor to initialize correctly. If the EEPROM does not contain valid data, the constructor will cause the system to hang and reboot.
**Note:** For IR signal transmission and reception, use compatible external libraries.
> **Note:** For IR signal transmission and reception, use compatible external libraries.
## Examples

Check the provided example sketches ([`Basic`](./examples/Basic) and [`Calibration`](./examples/Calibration)) in the library, located within examples folder, to better understand how to use UIRBcore in your projects.
Explore the provided example sketches:

- [`Basic`](./examples/Basic): A basic implementation of the UIRBcore library.
- [`Calibration`](./examples/Calibration): Demonstrates how to calibrate and configure the system.

These examples are located within the [`examples`](./examples) folder of the library.

## Configuration

Expand All @@ -107,9 +110,9 @@ The script [`update_version.py`](./scripts/update_version.py) updates [`UIRBcore
python ./scripts/update_version.py
```

**Note:** All scripts should be executed from the root of the repository.
> **Note:** All scripts should be executed from the root of the repository.
**Note:** Simulation using simavr in PlatformIO is not supported because there is currently no method to pre-load EEPROM data before the simulation.
> **Limitation:** Simulation using simavr in PlatformIO is not supported because there is currently no method to pre-load EEPROM data before the simulation.
## Contribution

Expand Down
2 changes: 1 addition & 1 deletion examples/Basic/platformio.ini
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ platform = atmelavr
board = uirb-v02-atmega328p ; Custom UIRB-v02 board definition must be installed
framework = arduino
lib_deps =
https://github.com/DjordjeMandic/UIRBcorelib.git ; UIRBcore library
DjordjeMandic/UIRBcorelib @ ^1.0.0 ; Depend on the latest 1.x stable version
upload_speed = 1000000 ; High upload speed for faster programming
monitor_speed = 1000000 ; Serial monitor baud rate
monitor_filters = time ; Adds timestamps to serial monitor output
2 changes: 1 addition & 1 deletion examples/Calibration/platformio.ini
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,6 @@ platform = atmelavr
board = uirb-v02-atmega328p ; Custom UIRB-v02 board definition must be installed
framework = arduino
lib_deps =
https://github.com/DjordjeMandic/UIRBcorelib.git ; UIRBcore library
DjordjeMandic/UIRBcorelib @ ^1.0.0 ; Depend on the latest 1.x stable version
upload_speed = 1000000 ; High upload speed for faster programming
monitor_speed = 1000000 ; Serial monitor baud rate
2 changes: 1 addition & 1 deletion library.json
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@
"license": "MIT",
"frameworks": "arduino",
"platforms": "atmelavr",
"headers": "UIRBcore.h",
"headers": "UIRBcore.hpp",
"build":{
"flags": [
"-DUIRB_CORE_LIB"
Expand Down

0 comments on commit 41d5d67

Please sign in to comment.