IoT Field Gadget Snaps

This repository is maintained by the IoT Devices Field team to store and test gadget snaps we create.

If you are looking for Canonical reference gadget snaps, please see this repository.

Note that the contents of these gadget snaps are all public information and are generally created for testing or interest in particular hardware. No promises are made for stability or long term support.

Gadget snaps are generally verboten from the Global Store, so you will not find these published anywhere. They are intended as implementation examples and inspiration, for use on dangerous-grade model Ubuntu Core images.

• You can find IoT Field's kernel snaps at this sister repository
• You can find IoT Field's example snaps at this cousin repository

Repository structure

Each gadget snap is confined to its own branch. The naming convention is:

<Core release>-<architecture>-<platform>

• The main branch is for hosting workflows, a project description (this README), and an example skeleton of a gadget snap.
• If you wish to add a new gadget to this repository, choose either a board with similar architecture or create a branch using --orphan.
• If you wish to update a gadget snap from one base to another, please create a new branch with the same name changing the <Core release> prefix.
• If the gadget snap is one for Classic systems, please add a -classic suffix to the branch name.

Branches

Please ensure that your branch includes the following:

1. a README describing
   • the board,
   • how the gadget snap functions (in broad, general terms; no need to be too technical),
   • including references to documentation if you prefer,
2. license information in the snapcraft.yaml
   • Any general text file should be CC-BY-SA
   • Any code should be GPLv3

Workflows

The expectation is that any new branch should have an accompanying new workflow added. That workflow should follow the general style of the other workflows, and ideally there are two:

1. One workflow testing builds using some version-specific snapcraft (i.e. {7,8}.x/edge)
2. One workflow testing builds using snapcraft from latest/edge

This ensures continuous testing of our work to spot any potential regressions or breaking changes.

The workflows should only exist on the main branch.

Contributing

This repository is open to contributions so long as:

1. You have signed the Canonical Contributor License Agreement
2. You have signed the Ubuntu Code of Conduct

Commits should follow the below style:

• The entire message should read as:

    <path/to/file>: <imperative present tense short description of change>

    <longer explanation of change if required>

    Signed-off-by: <author name> <author email>

• Keep first line summaries to under 60 characters, body summaries under 80

• Include a signoff for each commit using git commit -s

  • To amend prior commits with a signoff, do git rebase --signoff HEAD~<number of commits>

• Signing commits with git commit -S (GPG or SSH) is preferred but not required

• If you are modifying the README.md, LICENSE, .gitignore, .github, etc., please use README, LICENSE, github, gitignore, etc as the filename in the message

• Commits should be atomic

• PRs should contain logically related commits

• Try to follow prior art and style wherever possible

Even if you have write permissions to this repository, unless it is trivial please create a PR for your change and attempt to get a +1 from someone on the FE IoT team.