Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xseignard/corpore-sano
https://github.com/xseignard/corpore-sano
Last synced: 24 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/xseignard/corpore-sano
- Owner: xseignard
- Created: 2020-04-01T09:55:41.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-08-31T12:20:01.000Z (over 4 years ago)
- Last Synced: 2024-10-15T08:30:59.235Z (2 months ago)
- Language: C++
- Homepage:
- Size: 3.72 MB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Corpore Sano
## Node.js API
Please refer to `misc/Bumper.js` file. An example usage is available in `misc/demo.js`.
### Constructor:
```js
const bumper = new Bumper(boardId, bumperId, udpClient, holdTime)
```
- `boardId` will be used to compute board IP and bumper id
- `bumperId` is the id of the bumper on the board
- `udpClient` is the client to send/receive messages
- `holdTime` is the time (in ms) after a long press will trigger a 'hold' event (defaults to 3000ms, hence not mandatory)
The bumper id is computed with the following : `id = boardId * 10 + bumperId`. So the bumper 4 of the board 3 have an id of 34.
### Methods:
#### `buzz`
```js
bumper.buzz(true) // turns on the buzzer
setTimeout(() => {
bumper.buzz(false) // turns off the buzzer
}, 1000)
```
#### `rgb`
```js
bumper.rgb(r, g, b) // will turn the rgb led to the given r, g, b
```
Note: colors channels are 16bit encoded, so from 0 (0%) to 65535 (100%)
#### color aliases
```js
bumper.red() // 100% r, 0% g, 0% b
bumper.green() // 0% r, 100% g, 0% b
bumper.blue() // 0% r, 0% g, 100% b
bumper.white() // 100% r, 100% g, 100% b
bumper.black() // 0% r, 0% g, 0% b, rgb led is off
```
#### `setHoldTime`
```js
bumper.setHoldTime(500) // 'hold' event will now be fired after a press of at least 500ms
```
### Events:
#### `press`
```js
bumper.on('press', () => {
// do what you want
})
```
#### `hold`
```js
bumper.on('hold', () => {
// do what you want
})
```
#### `relesase`
```js
bumper.on('relesase', () => {
// do what you want
})
```
#### `error`
```js
bumper.on('error', err => {
// do what you want
})
```
## Various notes
### SERCOM2 SPI
#### Variant
| SAMD21 pin | Arduino pin | SERCOM PAD | ALT or NOT |
| ---------- | ----------- | -------------- | -------------- |
| PA14 | 2 | SERCOM2/PAD[2] | PIO_SERCOM |
| PA09 | 3 | SERCOM2/PAD[1] | PIO_SERCOM_ALT |
| PA08 | 4 | SERCOM2/PAD[0] | PIO_SERCOM_ALT |
| PA15 | 5 | SERCOM2/PAD[3] | PIO_SERCOM |
#### Pads selection
##### MISO
```cpp
typedef enum
{
SERCOM_RX_PAD_0 = 0,
SERCOM_RX_PAD_1,
SERCOM_RX_PAD_2,
SERCOM_RX_PAD_3
} SercomRXPad;
```
##### MOSI/SCK
```cpp
typedef enum
{
SPI_PAD_0_SCK_1 = 0,
SPI_PAD_2_SCK_3,
SPI_PAD_3_SCK_1,
SPI_PAD_0_SCK_3
} SercomSpiTXPad;
```
- I need SCK on PA15 (pin 5, pad 3), MOSI on PA08 (pin 4, pad 0)
- It gives me : SPI_PAD_0_SCK_3
- It then restricts MISO on pad 1 (PA09, pin 3) or 2 (PA14, pin 2)
- I choose pad 2 for no particular reason
So my SPIClass would be :
```cpp
// SPIClass SPI (&PERIPH_SPI, PIN_SPI_MISO, PIN_SPI_SCK, PIN_SPI_MOSI, PAD_SPI_TX, PAD_SPI_RX);
SPIClass SPI2(&sercom2, 2, 5, 4, SPI_PAD_0_SCK_3, SERCOM_RX_PAD_2);
```