Chessboard-Nano

Arduino Nano firmware for a magnetic-piece-tracking digital chessboard! WIP

This repository contains the PlatformIO project for the firmware that goes on the Arduino Nano.

Commands

All these commands are available over serial with the default baud rate of 9600.

Prints the values of the linear hall sensors or the calibration values.

Gets or sets the calibration value or margins for squares.

[type] is the type of calibration to get or set and should be one of the following:
- present for squares with a piece present.
- empty for squares with no piece present.
- presentMargin for squares with a piece present. (to account for noise)
- emptyMargin for squares with no piece present. (to account for noise)
[action] is the action to perform and should be one of the following:
- get to get the calibration value.
- set to set the calibration value.
[position] is the position of the square and should be one of the following formats:
- row,col for the row and column of the square. (0-indexed) Use 255 to change the entire row/column.
- global to get or set all at the same time.
[value?] is the value to set the calibration value to. (optional) This is only used if [action] is set. If not provided, the value will be set to the current value of the square.

Saves the calibration values to EEPROM.

Loads the calibration values from EEPROM.

Gets or sets the settings values. These changes are automatically loaded and written to EEPROM and take effect immediately.

[action] is the action to perform and should be one of the following:
- get to get the settings value.
- set to set the settings value.
[key] is the key of the setting to get or set and should be one of the following:
- AUTO_LOAD_CALIBRATION
  - 0: Don't automatically load calibration from EEPROM on startup.
  - 1: Automatically load calibration from EEPROM on startup.
- DETECTION_METHOD
  - 0: Check for both the square to be not empty and present.
  - 1: Check for the square to be not empty.
  - 2: Check for the square to be present.
  - 3: Check for either the square to be not empty or present.
- PRINT_ON_BOARD_CHANGE
  - 0: Don't automatically print the board state when it changes.
  - 1: Automatically print the board state when it changes.
[value?] is the value to set the settings value to. (optional) This is only required if [action] is set.