Skip to content

HAL (hardware abstraction layer) components for Espressif chips

License

Notifications You must be signed in to change notification settings

espressif/esp-hal-components

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

esp-hal-components

HAL (Hardware Abstraction Layer) components for Espressif chips.

Currently the branches are all synchronized from IDF by scripts under given rules.

Except from the scripts, no manual development will happen here.

Branch naming convention

sync-[name]-[branch]

Where:

  • sync means this is a branch maintained by the script. Will not be able to be merged with each other.
  • [name]: either a number (whose file list will be described somewhere), or a single component (in case someone need it...)
  • [branch]: the IDF branch to sync from, e.g. master, v4.4

Existing branches

  • sync-3-master:
    • Based on IDF master branch.
    • Includes components: soc, hal, esp_common, esp_rom, riscv, xtensa, esp_hw_support, esp_system, efuse, log.

Depreacated branches

The following branches are deprecated (not updated any more), because they bring the Gitlab/Github links in the commit message into esp-hal-components repo, creating annoying autolink. (issue fixed from sync-3-master)

  • sync-1-master:

    • Based on IDF master branch.
    • Includes components: soc, hal, esp_hw_support, esp_system, efuse, log.
  • sync-2-master:

    • Based on IDF master branch.
    • Includes components: soc, hal, esp_common, esp_rom, riscv, xtensa, esp_hw_support, esp_system, efuse, log.

Restrictions

  1. Sync branches don't have common ancestors

    This may cause some problem when you merge or pick from these branches

  2. Can't easily modify the file list of a existing branch

    The tool used by the sync script converts commits of IDF into new ones on the given branch. The history is kept while the files are filterd according to the given file list.

    The generated commits will have the same SHA as long as the commit author, date, message and change list are the same.

    Any modification to the script strategy of a sync branch (including modifying the file list) will change the SHA of the commits, forbidding the generated branch being merged (pushed) to the existing one.

    When we need to modify the file list or any other part of the commit, it's suggested to create a new branch.

About

HAL (hardware abstraction layer) components for Espressif chips

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages