Skip to content

Update documentation for installing the template app #17

@cavac

Description

@cavac

The docu is currently still saying "The BadgeLink tools are not yet available but will be released soon. This page will be updated when the tools have been made available."

The process, according to discussion on Discord is:
make badgelink

make install

The process can fail in two ways:

  1. "python not found" or something similar. Depending on how the system is installed (i use an Ubuntu 24.04 that may have some non-standard stuff, since it's a developer machine), python might only show up as python3.

Fix, which basically makes python3 the default python:
sudo apt install python-is-python3

  1. usb.core.USBError: [Errno 13] Access denied (insufficient permissions)

First, make sure the user has dialout permissions (pretty much standard for anyone who works with serial/arduinos/microcontrollers). You can give that user that additional group by:
sudo usermod -a -G dialout exampleusername

(You might have to reboot or logout/login for this to take effect).

Now you have to make sure the /dev/bus/usb/* devices (for libusb access) also have the "dialout" group, same as the /dev/ttyACM* devices. For this, create a file /etc/udev/rules.d/55-tanmatsu.rules (as root) with the following 3 lines:
SUBSYSTEM=="usb", ATTR{idVendor}=="1a86", ATTR{idProduct}=="8091", MODE="0660", GROUP="dialout"
SUBSYSTEM=="usb", ATTR{idVendor}=="303a", ATTR{idProduct}=="1001", MODE="0660", GROUP="dialout"
SUBSYSTEM=="usb", ATTR{idVendor}=="16d0", ATTR{idProduct}=="0f9a", MODE="0660", GROUP="dialout"

Then, reload the udev rules:
sudo udevadm control --reload-rules

Disconnect/reconnect your Tanmatsu

You only should have to do those fixes once.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    Status

    Suggestion

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions