Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/d2r2/go-vl53l0x
Golang library to interact with ST VL53L0X time-of-flight ranging sensor via I2C-bus from Raspberry PI.
https://github.com/d2r2/go-vl53l0x
embedded-linux golang gpio i2c i2c-sensors ranging-sensor raspberry-pi vl53l0x
Last synced: about 18 hours ago
JSON representation
Golang library to interact with ST VL53L0X time-of-flight ranging sensor via I2C-bus from Raspberry PI.
- Host: GitHub
- URL: https://github.com/d2r2/go-vl53l0x
- Owner: d2r2
- License: mit
- Created: 2018-11-03T09:31:24.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2018-12-22T17:11:12.000Z (almost 6 years ago)
- Last Synced: 2024-06-20T14:18:14.906Z (5 months ago)
- Topics: embedded-linux, golang, gpio, i2c, i2c-sensors, ranging-sensor, raspberry-pi, vl53l0x
- Language: Go
- Homepage:
- Size: 1.49 MB
- Stars: 11
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
VL53L0X time-of-flight ranging sensor
=====================================
[](https://travis-ci.org/d2r2/go-vl53l0x)
[](https://goreportcard.com/report/github.com/d2r2/go-vl53l0x)
[](https://godoc.org/github.com/d2r2/go-vl53l0x)
[](./LICENSE)
VL53L0X ([general specification](https://raw.github.com/d2r2/go-vl53l0x/master/docs/vl53l0x.pdf), [native C code API specification](https://raw.github.com/d2r2/go-vl53l0x/master/docs/en.DM00279088.pdf)) is a world’s smallest time-of-flight ranging and gesture detection sensor from STMicroelectronics. Easily integrated with Arduino and Raspberry PI via i2c communication interface:
Sensor functionality is based on laser diode emission with following photodetector signal registration. Average time duration between emission and registration is a "time-of-flight", which translates to range distance.
Here is a library written in [Go programming language](https://golang.org/) for Raspberry PI and counterparts, which gives you in the output measured range value (making all necessary i2c-bus interacting and values computing).
This library is an adaptation and translation of well-formed C++ code written by www.pololu.com to Golang, taken from https://github.com/pololu/vl53l0x-arduino.
Golang usage
------------
```go
func main() {
// Create new connection to i2c-bus on 0 line with address 0x29.
// Use i2cdetect utility to find device address over the i2c-bus
i2c, err := i2c.NewI2C(0x29, 0)
if err != nil {
log.Fatal(err)
}
defer i2c.Close()
sensor := vl53l0x.NewVl53l0x()
// It's highly recommended to reset sensor each time before repeated initialization.
err = sensor.Reset(i2c)
if err != nil {
log.Fatal(err)
}
// By default, sensor initialized with "RegularRange" and "RegularAccuracy" parameters.
err = sensor.Init(i2c)
if err != nil {
log.Fatal(err)
}
rng, err := sensor.ReadRangeSingleMillimeters(i2c)
if err != nil {
log.Fatal(err)
}
log.Printf("Measured range = %v mm", rng)
```
Getting help
------------
GoDoc [documentation](http://godoc.org/github.com/d2r2/go-vl53l0x)
Installation
------------
```bash
$ go get -u github.com/d2r2/go-vl53l0x
```
Troubleshooting
---------------
- *How to obtain fresh Golang installation to RPi device (either any RPi clone):*
If your RaspberryPI golang installation taken by default from repository is outdated, you may consider
to install actual golang manually from official Golang [site](https://golang.org/dl/). Download
tar.gz file containing armv6l in the name. Follow installation instructions.
- *How to enable I2C bus on RPi device:*
If you employ RaspberryPI, use raspi-config utility to activate i2c-bus on the OS level.
Go to "Interfacing Options" menu, to active I2C bus.
Probably you will need to reboot to load i2c kernel module.
Finally you should have device like /dev/i2c-1 present in the system.
- *How to find I2C bus allocation and device address:*
Use i2cdetect utility in format "i2cdetect -y X", where X may vary from 0 to 5 or more,
to discover address occupied by peripheral device. To install utility you should run
`apt install i2c-tools` on debian-kind system. `i2cdetect -y 1` sample output:
```
0 1 2 3 4 5 6 7 8 9 a b c d e f
00: -- -- -- -- -- -- -- -- -- -- -- -- --
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
70: -- -- -- -- -- -- 76 --
```
Contact
-------
Please use [Github issue tracker](https://github.com/d2r2/go-vl53l0x/issues) for filing bugs or feature requests.
License
-------
Go-vl53l0x is licensed under MIT License.