#bluetooth #rubik #cubing #rubiks #speedcubing

twisted

A speedcubing and smart-cube library

3 releases

0.1.3 Apr 10, 2022
0.1.2 Apr 10, 2022
0.1.1 Apr 9, 2022
0.1.0 Apr 8, 2022

#647 in Graphics APIs

GPL-3.0-only

75KB
2K SLoC

A library for smart speedcubing.

twisted models many of the common speedcubing concepts in addition to supplying abstractions for interacting with smartcubes and an optional module that can draw cube states using sdl2.

Goals

Currently, twisted has three main goals:

  • Supply connection abstractions for working with smartcubes.
  • Facilitate the development of FOSS speedcubing software like simulators and training tools by making it easy to record and break down solves.
  • Facilitate method development by supplying abstractions for methods and substeps.

In the future, we would like to support optimising solves and searching for algorithms using IDA-Star, but this will require performance-optimised models of substeps, and heuristic tables for many different substeps and methods.

Additionally, we would like to support more smartcubes and more of each smartcube's additional functionality, such as gyroscopes and retrieving things like battery level.

Smartcubes

`twisted' supports the following smartcubes:

  • Moyu Weilong AI

The following functionality exists for every cube:

  • Dumping raw turn data to file.
  • Loading raw turn data from file.
  • Live recording and reconstruction of turns.
  • Reconstructing moves from turn data.

The following functionality is planned for each cube:

  • Implementation of the Stream trait.
  • Dumping data from recorded buffer(s) to file(s).

Supported Methods

'twisted' contains models for the methods listed below, in addition to models of their substeps. These are implementations of the Method and Substep traits respectively.

Getting Started

To add twisted to your project, simply add the library to the dependencies section of your Cargo.toml.

[dependencies]
...
twisted =  "0.1.3"

Remember to enable the bluetooth or `sdl2' modules if you need any of the smartcube or gui functionality.

[dependencies]
...
twisted = { version = "0.1.3", features = ["bluetooth", "sdl2"] }

Dependencies

~0.5–12MB
~133K SLoC