Skip to content

Conversation

feeph
Copy link
Owner

@feeph feeph commented Aug 25, 2024

The initial implementation tried to separate the low-level interface to
the EMC2101's functionality from the high-level interfaces (PWM & DAC).
This lead to significant code duplication between EMC2101_Core and
EMC2101_PWM. This duplication would only get worse once EMC2101_DAC is
added.

The redesigned interface scraps that distinction and instead leverages
inheritance to remove code duplication. This is expected to result in a
cleaner and easier to manage code base.

notable changes:

  • remove code duplication between EMC2101_Core and EMC2101_PWM
  • rework the initialization logic for the low-level implementation
  • rename 'chip' and 'external' sensore to 'its' and 'ets'
    (the external temperature sensor had many different names - these
    have been cleaned up)
  • redesign lookup table into a low-level and an extended implementation
    (The low-level implementation exclusively supports steps and has no
    concept of a percentage or RPM. PWM and DAC implementation need to
    provide the required logic to convert Percentage and RPM into steps.)
  • eliminate no longer required intermediate functionality

The initial implementation tried to separate the low-level interface to
the EMC2101's functionality from the high-level interface (PWM & DAC)
control. This lead to a lot of code duplication between EMC2101_Core and
EMC2101_PWM. This would only get worse once EMC2101_DAC will be added.

The redesigned interface scraps that distinction and instead leverages
inheritance to remove code duplication. This should result in a cleaner
and easier to manage code base.

notable changes:
 - remove code duplication between EMC2101_Core and EMC2101_PWM
 - rework the initialization logic for the low-level implementation
 - rename 'chip' and 'external' sensore to 'its' and 'ets'
   (the external temperature sensor had many different names - these
   have been cleaned up)
 - redesign lookup table into a low-level and an extended implementation
   (The low-level implementation exclusively supports steps and has no
   concept of a percentage or RPM. PWM and DAC implementation need to
   provide the required logic to convert Percentage and RPM into steps.)
 - eliminate no longer required intermediate functionality
@feeph feeph self-assigned this Aug 25, 2024
@feeph feeph merged commit 5ae941d into master Aug 25, 2024
7 of 8 checks passed
@feeph feeph deleted the fb-rework-interface branch August 25, 2024 20:44
feeph pushed a commit that referenced this pull request Aug 25, 2024
##
[0.3.0](v0.2.2...v0.3.0)
(2024-08-25)


### Features

* cleanup interface and leverage inheritance
([#51](#51))
([5ae941d](5ae941d))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant