config.json

{
    "global_info": {
        "name": {
            "label": "Device Name",
            "description": "a user-settable string for assigning the name of the Cato device",
            "note": "Name defaults to 'Cato_<HW_UID>' at boot, but is not set if name is defined here",
            "access": "rw",
            "value": ""
        },
        "HW_UID": {
            "label": "Hardware Unique Identity",
            "description": "Unique hex code for identifying different devices",
            "access": "r",
            "value": ""
        },
        "sleep": {
            "label": "Sleep",
            "description": "Controls for Entering Sleep",
            "access": "rw",
            "value": {
                "timeout": {
                    "label": "Timeout",
                    "description": "Number of consecutive low-movement seconds before Cato sleeps",
                    "access": "rw",
                    "value": 600,
                    "range": {
                        "min": 10,
                        "max": 1200
                    }
                },
                "threshold": {
                    "label": "Sleep Threshold",
                    "description": "Movement level below which Cato starts counting towards sleep",
                    "access": "rw",
                    "value": 5.0,
                    "range": {
                        "min": 2.0,
                        "max": 10.0
                    }
                }
            }
        },
        "orientation": {
            "label": "Orientation",
            "description": "parameters describing usage orientation for Cato",
            "access": "rw",
            "note": "default orientation is on the right side of the glasses, with the circular battery compartment facing OUT (and usb port forward)",
            "value": {
                "front": {
                    "label": "front",
                    "description": "",
                    "access": "rw",
                    "value": "-y",
                    "options": [
                        "+x",
                        "-x",
                        "+y",
                        "-y",
                        "+z",
                        "-z"
                    ]
                },
                "bottom": {
                    "label": "bottom",
                    "description": "",
                    "access": "rw",
                    "value": "+x",
                    "options": [
                        "+x",
                        "-x",
                        "+y",
                        "-y",
                        "+z",
                        "-z"
                    ]
                },
                "left": {
                    "label": "left",
                    "description": "",
                    "access": "rw",
                    "value": "+z",
                    "options": [
                        "+x",
                        "-x",
                        "+y",
                        "-y",
                        "+z",
                        "-z"
                    ]
                }
            }
        },
        "calibration": {
            "label": "Calibration (including automatic) Parameters",
            "description": "structure containing both current calibration (trim) values and preferences for auto calibration",
            "access": "rw",
            "value": {
                "drift": {
                    "label": "drift",
                    "description": "x, y, z gyroscope drift per-cycle - used as trim adjustments",
                    "access": "r",
                    "value": [
                        0,
                        0,
                        0
                    ]
                },
                "auto_threshold": {
                    "label": "Auto-Calibration Threshold",
                    "description": "movement required (as a scale of mouse>idle_threshold) to fail automatic calibration for gyro drift",
                    "access": "rw",
                    "value": 3.0,
                    "range": {
                        "min": 0.6,
                        "max": 5.0
                    }
                },
                "auto_samples": {
                    "label": "Auto-Calibration Samples Taken",
                    "description": "number of samples to wait (at below auto_threshold) required to trigger auto recalibratoion",
                    "access": "rw",
                    "value": 100
                }
            }
        },
        "battery": {
            "label": "Battery",
            "description": "DEV TOOL: analog pin values of high and low battery charge [low, high]",
            "access": "r",
            "value": {
                "low": {
                    "label": "Low",
                    "description": "Value of analog pin indicating discharged battery. Typ. ~23000",
                    "access": "r",
                    "value": 22800
                },
                "high": {
                    "label": "High",
                    "description": "Value of analog pin indicating charged battery. Typ. ~30000",
                    "access": "r",
                    "value": 27500
                }
            }
        }
    },
    "connections": [
        {
            "connection_name": {
                "label": "Connection Name",
                "description": "Nickname for this connection",
                "access": "rw",
                "value": "Default Connection"
            },
            "screen_size": {
                "label": "Screen Size",
                "description": "structure containing screen height and width in pixels",
                "access": "rw",
                "value": {
                    "height": {
                        "description": "height in pixels",
                        "access": "rw",
                        "value": 1080,
                        "range": {
                            "min": 600,
                            "max": 4320
                        }
                    },
                    "width": {
                        "description": "width in pixels",
                        "access": "rw",
                        "value": 1920,
                        "range": {
                            "min": 800,
                            "max": 8192
                        }
                    }
                }
            },
            "operation_mode": {
                "value": "practice",
                "label": "Mode",
                "access": "rw",
                "description": "a name defining the operation mode of Cato",
                "options": [
                    "gesture_mouse",
                    "tv_remote",
                    "pointer",
                    "clicker",
                    "practice"
                ]
            },
            "gesture": {
                "label": "Gesture Parameters",
                "description": "Settings for gesture collection and recognition cutoff tools",
                "access": "rw",
                "value": {
                    "key": {
                        "label": "Gesture Key",
                        "description": "Human-readable field describing Gesture model's names of gestures",
                        "note": "This determines text output of practice mode",
                        "access": "r",
                        "value": [
                            "None",
                            "Nod Up",
                            "Nod Down",
                            "Nod Right",
                            "Nod Left",
                            "Tilt Right",
                            "Tilt Left"
                        ]
                    },
                    "confidence_threshold": {
                        "label": "Confidence threshold",
                        "description": "Threshold of gesture confidence probability [0, 1], for Cato to accept gesture and execute command",
                        "note": "Low value -> few dry-fires, more frequent misinterpretation. High value -> frequent dry-fires, rare misinterpretation",
                        "access": "rw",
                        "value": 0.62,
                        "range": {
                            "min": 0.55,
                            "max": 0.90
                        }
                    },
                    "length": {
                        "label": "Length",
                        "description": "Number of samples (max) in a gesture to be fed to Neuton",
                        "access": "r",
                        "value": 200
                    },
                    "idle_cutoff": {
                        "label": "Idle Cutoff",
                        "description": "Number of consecutive idle samples leading to gesture cutoff",
                        "access": "r",
                        "value": 20
                    },
                    "start_threshold": {
                        "label": "Movement threshold",
                        "description": "movement required to start capturing gesture. Startup threshold",
                        "access": "r",
                        "value": 22.36
                    },
                    "idle_threshold": {
                        "label": "Idle threshold",
                        "description": "Value of move speed below which is considered idle - leading to mouse exit. Low number = more stillness to idle out of gesture recognition",
                        "access": "r",
                        "value": 30
                    },
                    "timeout": {
                        "label": "Timeout",
                        "description": "Maximum Time (seconds) to Wait for Gesture Start before exiting recognition window",
                        "access": "rw",
                        "value": 1.0,
                        "range": {
                            "min": 0.1,
                            "max": 3.0
                        }
                    },
                    "gc_timeout": {
                        "label": "Gesture Collection Timeout",
                        "description": "Time to wait before beginning gesture collection over bluetooth",
                        "access": "rw",
                        "value": 10,
                        "range": {
                            "min": 5,
                            "max": 60
                        }
                    },
                    "turbo_rate": {
                        "label": "Turbo Options",
                        "description": "Options for 'Turbo' (repeated, accelerating button presses until cancelled)",
                        "note": "TODO: not yet implemented with current button acctions",
                        "access": "rw",
                        "value": {
                            "initial": {
                                "label": "Initial Spacing",
                                "description": "Initial button-press spacing",
                                "access": "rw",
                                "value": 1
                            },
                            "minimum": {
                                "label": "Minimum Spacing",
                                "description": "Minimum (fastest) button press spacings",
                                "access": "rw",
                                "value": 0.2
                            },
                            "decay_rate": {
                                "label": "Decay Rate",
                                "description": "Rate (geometric) of time-between-press decay",
                                "access": "rw",
                                "value": 0.9,
                                "range": {
                                    "min": 0.65,
                                    "max": 0.95
                                }
                            }
                        }
                    }
                }
            },
            "practice": {
                "label": "Practice Mode",
                "description": "Settings for practice mode",
                "access": "rw",
                "value": {
                    "dense": {
                        "label": "Format Condensed",
                        "description": "true: type outputs in a single line; false: type outputs as a table",
                        "access": "rw",
                        "value": true,
                        "options": [true, false]
                    },
                    "num_infers": {
                        "label": "Maximum number of Displayed Inferences",
                        "description": "Number of relevant inferences displayed per gesture",
                        "access": "rw",
                        "value": 6,
                        "range" : {
                            "min" : 1,
                            "max" : 6
                        }
                    },
                    "cutoff": {
                        "label": "Certainty Cutoff",
                        "description": "Level of certainty below which gesture will not be displayed",
                        "access": "rw",
                        "value": 0.5,
                        "range" : {
                            "min" : 0.0,
                            "max" : 1.0
                        }
                    }
                }
            }
        }
    ]
}