-
Notifications
You must be signed in to change notification settings - Fork 26
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
updating README to include standard information and badges
- Loading branch information
1 parent
04c22b7
commit 402a851
Showing
4 changed files
with
201 additions
and
11 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,18 +1,54 @@ | ||
Adafruit LSM9DS1 Library | ||
======================== | ||
# Adafruit LSM9DS1 [![Build Status](https://github.com/adafruit/Adafruit_LSM9DS1/workflows/Arduino%20Library%20CI/badge.svg)](https://github.com/adafruit/Adafruit_LSM9DS1/actions)[![Documentation](https://github.com/adafruit/ci-arduino/blob/master/assets/doxygen_badge.svg)](http://adafruit.github.io/Adafruit_LSM9DS1/html/index.html) | ||
|
||
|
||
This is a library for the Adafruit triple-axis accelerometer/magnetometer/gyroscope LSM9DS1 breakouts | ||
|
||
Designed specifically to work with the Adafruit LSM9DS1 Breakout | ||
|
||
These sensors use I2C to communicate, 2 pins are required to interface | ||
|
||
* https://www.adafruit.com/products/3387 | ||
|
||
These sensors use I2C to communicate, 2 pins are required to interface | ||
Adafruit invests time and resources providing this open source code, | ||
please support Adafruit and open-source hardware by purchasing | ||
products from Adafruit! | ||
Adafruit invests time and resources providing this open source code, please support Adafruit and open-source hardware by purchasing products from Adafruit! | ||
|
||
# Installation | ||
To install, use the Arduino Library Manager and search for "Adafruit LSM9DS1" and install the library. | ||
|
||
## Dependencies | ||
* [Adafruit LIS3MDL](https://github.com/adafruit/Adafruit_LIS3MDL) | ||
* [Adafruit Unified Sensor Driver](https://github.com/adafruit/Adafruit_Sensor) | ||
|
||
# Contributing | ||
|
||
Contributions are welcome! Please read our [Code of Conduct](https://github.com/adafruit/Adafruit_LSM9DS1/blob/master/CODE_OF_CONDUCT.md>) | ||
before contributing to help this project stay welcoming. | ||
|
||
## Documentation and doxygen | ||
Documentation is produced by doxygen. Contributions should include documentation for any new code added. | ||
|
||
Some examples of how to use doxygen can be found in these guide pages: | ||
|
||
https://learn.adafruit.com/the-well-automated-arduino-library/doxygen | ||
|
||
https://learn.adafruit.com/the-well-automated-arduino-library/doxygen-tips | ||
|
||
## Formatting and clang-format | ||
This library uses [`clang-format`](https://releases.llvm.org/download.html) to standardize the formatting of `.cpp` and `.h` files. | ||
Contributions should be formatted using `clang-format`: | ||
|
||
The `-i` flag will make the changes to the file. | ||
```bash | ||
clang-format -i *.cpp *.h | ||
``` | ||
If you prefer to make the changes yourself, running `clang-format` without the `-i` flag will print out a formatted version of the file. You can save this to a file and diff it against the original to see the changes. | ||
|
||
Note that the formatting output by `clang-format` is what the automated formatting checker will expect. Any diffs from this formatting will result in a failed build until they are addressed. Using the `-i` flag is highly recommended. | ||
|
||
Check out the links above for our tutorials and wiring diagrams | ||
### clang-format resources | ||
* [Binary builds and source available on the LLVM downloads page](https://releases.llvm.org/download.html) | ||
* [Documentation and IDE integration](https://clang.llvm.org/docs/ClangFormat.html) | ||
|
||
Written by Kevin Townsend for Adafruit Industries. | ||
BSD license, all text above must be included in any redistribution | ||
## About this Driver | ||
Written by Kevin (KTOWN) Townsend for Adafruit Industries. | ||
BSD license, check license.txt for more information | ||
All text above must be included in any redistribution |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,127 @@ | ||
# Adafruit Community Code of Conduct | ||
|
||
## Our Pledge | ||
|
||
In the interest of fostering an open and welcoming environment, we as | ||
contributors and leaders pledge to making participation in our project and | ||
our community a harassment-free experience for everyone, regardless of age, body | ||
size, disability, ethnicity, gender identity and expression, level or type of | ||
experience, education, socio-economic status, nationality, personal appearance, | ||
race, religion, or sexual identity and orientation. | ||
|
||
## Our Standards | ||
|
||
We are committed to providing a friendly, safe and welcoming environment for | ||
all. | ||
|
||
Examples of behavior that contributes to creating a positive environment | ||
include: | ||
|
||
* Be kind and courteous to others | ||
* Using welcoming and inclusive language | ||
* Being respectful of differing viewpoints and experiences | ||
* Collaborating with other community members | ||
* Gracefully accepting constructive criticism | ||
* Focusing on what is best for the community | ||
* Showing empathy towards other community members | ||
|
||
Examples of unacceptable behavior by participants include: | ||
|
||
* The use of sexualized language or imagery and sexual attention or advances | ||
* The use of inappropriate images, including in a community member's avatar | ||
* The use of inappropriate language, including in a community member's nickname | ||
* Any spamming, flaming, baiting or other attention-stealing behavior | ||
* Excessive or unwelcome helping; answering outside the scope of the question | ||
asked | ||
* Trolling, insulting/derogatory comments, and personal or political attacks | ||
* Public or private harassment | ||
* Publishing others' private information, such as a physical or electronic | ||
address, without explicit permission | ||
* Other conduct which could reasonably be considered inappropriate | ||
|
||
The goal of the standards and moderation guidelines outlined here is to build | ||
and maintain a respectful community. We ask that you don’t just aim to be | ||
"technically unimpeachable", but rather try to be your best self. | ||
|
||
We value many things beyond technical expertise, including collaboration and | ||
supporting others within our community. Providing a positive experience for | ||
other community members can have a much more significant impact than simply | ||
providing the correct answer. | ||
|
||
## Our Responsibilities | ||
|
||
Project leaders are responsible for clarifying the standards of acceptable | ||
behavior and are expected to take appropriate and fair corrective action in | ||
response to any instances of unacceptable behavior. | ||
|
||
Project leaders have the right and responsibility to remove, edit, or | ||
reject messages, comments, commits, code, issues, and other contributions | ||
that are not aligned to this Code of Conduct, or to ban temporarily or | ||
permanently any community member for other behaviors that they deem | ||
inappropriate, threatening, offensive, or harmful. | ||
|
||
## Moderation | ||
|
||
Instances of behaviors that violate the Adafruit Community Code of Conduct | ||
may be reported by any member of the community. Community members are | ||
encouraged to report these situations, including situations they witness | ||
involving other community members. | ||
|
||
You may report in the following ways: | ||
|
||
In any situation, you may send an email to <[email protected]>. | ||
|
||
On the Adafruit Discord, you may send an open message from any channel | ||
to all Community Helpers by tagging @community helpers. You may also send an | ||
open message from any channel, or a direct message to @kattni#1507, | ||
@tannewt#4653, @Dan Halbert#1614, @cater#2442, @sommersoft#0222, or | ||
@Andon#8175. | ||
|
||
Email and direct message reports will be kept confidential. | ||
|
||
In situations on Discord where the issue is particularly egregious, possibly | ||
illegal, requires immediate action, or violates the Discord terms of service, | ||
you should also report the message directly to Discord. | ||
|
||
These are the steps for upholding our community’s standards of conduct. | ||
|
||
1. Any member of the community may report any situation that violates the | ||
Adafruit Community Code of Conduct. All reports will be reviewed and | ||
investigated. | ||
2. If the behavior is an egregious violation, the community member who | ||
committed the violation may be banned immediately, without warning. | ||
3. Otherwise, moderators will first respond to such behavior with a warning. | ||
4. Moderators follow a soft "three strikes" policy - the community member may | ||
be given another chance, if they are receptive to the warning and change their | ||
behavior. | ||
5. If the community member is unreceptive or unreasonable when warned by a | ||
moderator, or the warning goes unheeded, they may be banned for a first or | ||
second offense. Repeated offenses will result in the community member being | ||
banned. | ||
|
||
## Scope | ||
|
||
This Code of Conduct and the enforcement policies listed above apply to all | ||
Adafruit Community venues. This includes but is not limited to any community | ||
spaces (both public and private), the entire Adafruit Discord server, and | ||
Adafruit GitHub repositories. Examples of Adafruit Community spaces include | ||
but are not limited to meet-ups, audio chats on the Adafruit Discord, or | ||
interaction at a conference. | ||
|
||
This Code of Conduct applies both within project spaces and in public spaces | ||
when an individual is representing the project or its community. As a community | ||
member, you are representing our community, and are expected to behave | ||
accordingly. | ||
|
||
## Attribution | ||
|
||
This Code of Conduct is adapted from the [Contributor Covenant][homepage], | ||
version 1.4, available at | ||
<https://www.contributor-covenant.org/version/1/4/code-of-conduct.html>, | ||
and the [Rust Code of Conduct](https://www.rust-lang.org/en-US/conduct.html). | ||
|
||
For other projects adopting the Adafruit Community Code of | ||
Conduct, please contact the maintainers of those projects for enforcement. | ||
If you wish to use this code of conduct for your own project, consider | ||
explicitly mentioning your moderation policy or making a copy with your | ||
own moderation policy so as to avoid confusion. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,10 +1,11 @@ | ||
name=Adafruit LSM9DS1 Library | ||
version=2.0.0 | ||
version=2.0.1 | ||
author=Adafruit | ||
maintainer=Adafruit <[email protected]> | ||
sentence=Arduino library for LSM9DS1 9-DOF sensor board. | ||
paragraph=Arduino library for LSM9DS1 9-DOF sensor board. | ||
category=Sensors | ||
url=https://github.com/adafruit/Adafruit_LSM9DS1 | ||
architectures=* | ||
depends=Adafruit Unified Sensor, Adafruit LIS3MDL | ||
depends=Adafruit Unified Sensor, Adafruit LIS3MDL | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,26 @@ | ||
Software License Agreement (BSD License) | ||
|
||
Copyright (c) 2020 Kevin (KTOWN) Townsend for Adafruit Industries | ||
All rights reserved. | ||
|
||
Redistribution and use in source and binary forms, with or without | ||
modification, are permitted provided that the following conditions are met: | ||
1. Redistributions of source code must retain the above copyright | ||
notice, this list of conditions and the following disclaimer. | ||
2. Redistributions in binary form must reproduce the above copyright | ||
notice, this list of conditions and the following disclaimer in the | ||
documentation and/or other materials provided with the distribution. | ||
3. Neither the name of the copyright holders nor the | ||
names of its contributors may be used to endorse or promote products | ||
derived from this software without specific prior written permission. | ||
|
||
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ''AS IS'' AND ANY | ||
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED | ||
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE | ||
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY | ||
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | ||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | ||
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | ||
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | ||
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | ||
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |