SPI - Kaluma

Search…
SPI
The spi module supports communication with devices using SPI (Serial Peripheral Interface) bus as the master device. Use require('spi') to access this module. A chip select pin of slave device need to be controlled by GPIO output pin.
Class: SPI
An instances of SPI represents a SPI bus.
SPI.MODE_0
<number> = 0
'SPI MODE0: CPOL = 0, CPHA = 0
SPI.MODE_1
<number> = 1
'SPI MODE0: CPOL = 0, CPHA = 1
SPI.MODE_2
<number> = 2
'SPI MODE0: CPOL = 1, CPHA = 0
SPI.MODE_3
<number> = 3
'SPI MODE0: CPOL = 1, CPHA = 1
SPI.MSB
<number> = 0
SPI bitorder, MSB is the first bit.
SPI.LSB
<number> = 1
SPI bitorder, LSB is the first bit.
new SPI(bus[, options])
bus <number> SPI bus number.
options <object> The object of SPI options. Default values are depends on board (Check in a board page).
mode <number> SPI.MODE_0 (CPOL=0/CPHA=0), SPI.MODE_1 (CPOL=0/CPHA=1), SPI.MODE_2 (CPOL=1/CPHA=0), or SPI.MODE_3 (CPOL=1/CPHA=1). Default: SPI.MODE_0.
baudrate <number> Baud rate. Default: 3000000, 3 Mbit/s
bitorder <number> SPI.MSB (0) or SPI.LSB (1)  Default: SPI.MSB (0).
sck <number> SPI SCK pin number.
mosi <number> SPI MOSI (TX) pin number.
miso <number> SPI MISO (RX) pin number.
Returns: <object> An initialized SPI instance corresponds to the bus number. Once initialized, the same object will be returned.
Instances of the SPI class can be created using the new keyword or by calling spi.SPI() as a function. A RangeError will be thrown if bus is not less than max bus number. Please see here for more about SPI modes.
1
// Create the SPI instance with master mode 
2
const {GPIO} = require('gpio');
3
const {SPI} = require('spi');
4
​
5
var spi0cs = new GPIO(9, OUTPUT); // Set chip select to pin 9.
6
var spiOptions = { // SPI options
7
  mode: SPI.MODE_0,
8
  baudrate: 800000,
9
  bitorder: SPI.MSB,
10
};
11
var spi0 = new SPI(0, spiOptions);
12
// ChipSelect LOW
13
spi0cs.write(LOW);
14
// transfer data...
15
spi0.close();  // Close SPI bus 0
Copied!
spi.transfer(data[, timeout])
data <Uint8Array|string> Data to write.
timeout <number> Timeout in milliseconds. Default: 5000.
Returns: <Uint8Array> Received data or null if failed to transfer or timeout.
Send and receive data simultaneously via SPI bus.
1
const {GPIO} = require('gpio');
2
const {SPI} = require('spi');
3
​
4
var spi0cs = new GPIO(9, OUTPUT); // Set chip select to pin 9.
5
var spiOptions = { // SPI options
6
  mode: SPI.MODE_0,
7
  baudrate: 800000,
8
  bitorder: SPI.MSB,
9
};
10
var spi0 = new SPI(0, spiOptions);
11
// ChipSelect LOW
12
spi0cs.write(LOW);
13
// Send two bytes and receive two bytes
14
var buf = spi0.transfer(new Uint8Array([0x88, 0x24])); // send and receive two byte data.
15
if (buf) {
16
  console.log(data.length); // == 2
17
  console.log(data[0]); // first byte
18
  console.log(data[1]); // second byte
19
}
Copied!
spi.send(data[, timeout[, count]])
data <Uint8Array|string> Data to write.
timeout <number> Timeout in milliseconds. Default: 5000.
count <number> Indicates how many times to send data. Default: 1.
Returns: <number> The number of bytes written, -1 if it failed to write or timeout.
Send data via SPI bus
1
const {GPIO} = require('gpio');
2
const {SPI} = require('spi');
3
​
4
var spi0cs = new GPIO(9, OUTPUT); // Set chip select to pin 9.
5
var spiOptions = { // SPI options
6
  mode: SPI.MODE_0,
7
  baudrate: 800000,
8
  bitorder: SPI.MSB,
9
};
10
var spi0 = new SPI(0, spiOptions);
11
// ChipSelect LOW
12
spi0cs.write(LOW);
13
​
14
// Send 2 bytes with an array of numbers
15
var array = new Uint8Array([0x6b, 0x00]);
16
spi0.send(array);
Copied!
spi.recv(length[, timeout])
length <number> Data length to read.
timeout <number> Timeout in milliseconds. Default: 5000.
Returns: <Uint8Array> Received data or null if failed to transfer or timeout.
Receive data via SPI bus.
1
const {GPIO} = require('gpio');
2
const {SPI} = require('spi');
3
​
4
var spi0cs = new GPIO(9, OUTPUT); // Set chip select to pin 9.
5
var spiOptions = { // SPI options
6
  mode: SPI.MODE_0,
7
  baudrate: 800000,
8
  bitorder: SPI.MSB,
9
};
10
var spi0 = new SPI(0, spiOptions);
11
// ChipSelect LOW
12
spi0cs.write(LOW);
13
​
14
// Receive 10 bytes
15
var buf = spi0.recv(10);
16
if (buf) {
17
  console.log(data.length); // == 10
18
  console.log(data[0]); // first byte
19
  console.log(data[1]); // second byte
20
  // ...
21
}
22
​
23
spi0.close();
Copied!
spi.close()
Closes the SPI bus.
1
const {GPIO} = require('gpio');
2
const {SPI} = require('spi');
3
​
4
var spi0cs = new GPIO(9, OUTPUT); // Set chip select to pin 9.
5
var spiOptions = { // SPI options
6
  mode: SPI.MODE_0,
7
  baudrate: 800000,
8
  bitorder: SPI.MSB,
9
};
10
var spi0 = new SPI(0, spiOptions);
11
// transfer data...
12
spi0.close(); // Close SPI bus 0
Copied!
​
API Reference - Previous
RTC
Next - API Reference
Storage
Last modified 2mo ago
Copy link
Contents
new SPI(bus[, options])
spi.transfer(data[, timeout])
spi.send(data[, timeout[, count]])
spi.recv(length[, timeout])
spi.close()