Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/eagrahamjr/kobots

Kotlin, Raspberry Pi, and Robots: what could possibly go worng.
https://github.com/eagrahamjr/kobots

java kotlin raspberry-pi robotics

Last synced: 3 days ago
JSON representation

Kotlin, Raspberry Pi, and Robots: what could possibly go worng.

Host: GitHub
URL: https://github.com/eagrahamjr/kobots
Owner: EAGrahamJr
License: apache-2.0
Created: 2022-11-10T00:21:43.000Z (almost 2 years ago)
Default Branch: main
Last Pushed: 2024-10-27T17:38:27.000Z (11 days ago)
Last Synced: 2024-10-27T20:55:48.567Z (10 days ago)
Topics: java, kotlin, raspberry-pi, robotics
Language: Kotlin
Homepage:
Size: 95 MB
Stars: 1
Watchers: 3
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# KOBOTS

Kotlin, Raspberry Pi, and Robots: what could possibly go worng.

Experiments in electronics, robotics, and interacting with the "real world" with functional languages^**1**. The "base" implementations are projected to be based on the plethora of microcomputing platforms, specifically the Raspberry Pi.

This is a _learning_ experience for me, but it **might** produce something useful (I'll re-write this README if that actually happens :smiley:).

![Just Build](https://github.com/EAGrahamJr/kobots/actions/workflows/full-build.yaml/badge.svg) ![Kotlin](https://badgen.net/badge/Kotlin/1.8.22/purple) ![Java](https://badgen.net/badge/Java/17/orange) ![Apache License](https://badgen.net/github/license/EAGrahamJr/kobots)

Parts of this project have been either archived or spun off into library-like projects:

- [Kobots Devices](https://github.com/EAGrahamJr/kobots-devices)
- [Kobots Parts](https://github.com/EAGrahamJr/kobots-parts)

## In Memorium: 5/2006 - 2/23/2023 (Illy), 11/6/2023 (Tully)

Goodbye, my little coffee friends.

## WHY????

A **long, long** time ago, I attended a [WorldCon](https://en.wikipedia.org/wiki/36th_World_Science_Fiction_Convention) and went to a panel on robotics. I was captivated. However, at the time, I was attending college -- it seemed that acid-etching PCBs in a dorm room was probably not going to be a thing.

... time passes ...

Today, it's stupid easy to "build" electronics on bread-boards, not to mention HATs, shims, extenders, etc., and there's stupidly powerful microprocessors that you can build with. Like running a JVM. That's a helluva step up from hand-held DTMF-based remote controls.

So, yeah - I have a hobby now.

## Usage on the Raspberry Pi

This stuff is being done on Pi's because that's what I have. Plus they're at least multi-core and can run Java without too much problem.

:bangbang: Make sure the `i2c` controller is enabled on the Raspberry Pi and that your user is in the appropriate _group_ to access said devices:

```shell
$ ls -l /dev/i2c*
crw-rw---- 1 root i2c 89, 1 Nov 23 12:24 /dev/i2c-1
crw-rw---- 1 root i2c 89, 2 Nov 23 12:24 /dev/i2c-2
```

:bangbang: **WARNING** The I2C "baudrate" should also be adjusted to 400K - the default value will **not** be sufficient to handle everything on the I2C bus :smiling_imp:

This [pinout reference](https://pinout.xyz/) is also invaluable...

## Libraries in Use

- [diozero](https://www.diozero.com/) - a thorough and straight-forward implementation of GPIO interface, with a **wide** range of standard devices to boot.^**2**
- [kobots-devices](https://github.com/EAGrahamJr/kobots-devices) - extensions and new devices added onto `diozero`, but in **Kotlin**.
- [kobots-parts](https://github.com/EAGrahamJr/kobots-parts) - application level stuff using the devices -- :bangbang: **HIGHLY OPINIONATED** :smiiling_imp:

# Building

This project uses [Gradle](https://gradle.org), so the only thing you need is a compatible JDK^**3**. Additionally, because the project is [Kotlin](https://kotlinlang.org) and uses the _Kotlin Gradle plugin_, a Kotlin installation is also not necessary.

# Physical Pieces

Because I have no idea what direction any of this will take, the physical construction pieces have started with standard LEGO^TM pieces, transitioning to Technic^TM. Various partial contraptions and explorations are detailed in the [adhoc](adhoc) subproject.

Potentially useful constructs can be found in the [diagrams](diagrams) directory. CAD drawings were produced using [LeoCAD](https://www.leocad.org).

There's also a [Google Album](https://photos.app.goo.gl/kWWJ8uUjWdHnsVDY6) with more photos and videos.

---

^**1** All of the tutorials, lessons, kits, and existing libraries are predicated on C (at some level), due to the hardware interaction. I just don't want to go there anymore.

^**2** [MIT License](https://github.com/mattjlewis/diozero/blob/main/LICENSE.txt)

^**3** Java 17 is currently the only one used