GitHub - yikerman/tamron-lens-control: Linux-only CLI for viewing and changing settings on compatible Tamron lenses.
Pangram verdict · v3.3
We believe that this text is a mix of AI and human-written content.
AI likelihood · overall
MixedArticle text · 613 words · 2 segments analyzed
tlc is a Linux-only command-line utility for viewing and changing settings on compatible Tamron lenses. It aims to reproduce what the official Tamron Lens Utility has to offer on Linux. Disclaimer No affiliation tamron-lens-control is an independent, community-driven project and is not affiliated with, endorsed by, or sponsored by Tamron Co., Ltd. "Tamron" is a trademark of its respective owner, used here only to identify compatible products. No warranty tamron-lens-control is licensed under GNU GPL v3 or later and comes with absolute zero warranty. While I do hope it provides help, on using this software, you accept that your lens may brick, bounce away, shoot around the room like a frightened sparrow or leave the Earth and the Solar System. See LICENSE. Install Build and install from this repository with a recent Rust toolchain: cargo install --path . Connect the lens directly over USB, then confirm that tlc can see it: tlc devices tlc info When several lenses are connected, select one by the serial number or port shown by tlc devices: tlc --device SERIAL info tlc --device /dev/ttyUSB0 info Use ## Each command connects to the lens, performs one action, and disconnects. ## Note that a lens may support only a subset of them. # View focus ring settings tlc ring get # Reverse the focus ring direction tlc ring set direction reverse # View Focus Set Button and Custom Switch assignments tlc button get # Assign Focus Preset to the Focus Set Button tlc button set focus function focus-preset ## some more.. see tlc --help # Fine-tune autofocus accuracy tlc focus-calibration set 2 Run tlc --help or add --help after any command for available settings, accepted values, and lens-specific requirements. Place -v before the command to show each operation sent to the lens, and -vv to also print all raw transmitted and received bytes in hexadecimal. Backups Back up all current settings before making extensive changes: tlc settings save my-lens.tlc tlc settings load my-lens.tlc Backup files can be restored only to the same lens model. Linux Driver Setup If the lens appears in lsusb but not in tlc devices, Linux may need to be told to use the cp210x USB serial driver for it.
One-Time Setup Use these commands to test the driver setup immediately: sudo modprobe cp210x echo 2cd1 0002 | sudo tee /sys/bus/usb-serial/drivers/cp210x/new_id echo 2cd1 0005 | sudo tee /sys/bus/usb-serial/drivers/cp210x/new_id Reconnect the lens and check for its serial port: tlc devices If /dev/ttyUSB0 exists but cannot be opened, grant your current user temporary access: sudo setfacl -m u:"$USER":rw /dev/ttyUSB0 Persistent Setup Create one udev rule that registers the Tamron USB IDs and grants the active desktop user access whenever a compatible lens is connected: sudoedit /etc/udev/rules.d/70-tamron-lens.rules Add these lines: ACTION=="add", SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_interface", DRIVER=="", ATTRS{idVendor}=="2cd1", ATTRS{idProduct}=="0002", RUN+="/bin/sh -c '/sbin/modprobe cp210x && echo 2cd1 0002 > /sys/bus/usb-serial/drivers/cp210x/new_id'" ACTION=="add", SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_interface", DRIVER=="", ATTRS{idVendor}=="2cd1", ATTRS{idProduct}=="0005", RUN+="/bin/sh -c '/sbin/modprobe cp210x && echo 2cd1 0005 > /sys/bus/usb-serial/drivers/cp210x/new_id'" SUBSYSTEM=="tty", ATTRS{idVendor}=="2cd1", ATTRS{idProduct}=="0002", TAG+="uaccess" SUBSYSTEM=="tty", ATTRS{idVendor}=="2cd1", ATTRS{idProduct}=="0005", TAG+="uaccess" Reload the rules, then unplug and reconnect the lens: sudo udevadm control --reload-rules # reconnect tlc devices && tlc info getfacl /dev/ttyUSB0 For SSH or a headless system, uaccess may not apply. Check the device group: stat -c '%G' /dev/ttyUSB0 If it reports dialout, add your user to that group and log out completely: sudo usermod -aG dialout "$USER" Note that group membership grants access to every device owned by dialout, not only the lens. Safety and Scope Keep the lens connected until a command finishes. Review a setting with its get command before changing it. Use settings save before loading another backup or performing a reset. Lens firmware updates and online firmware checks are not supported yet (see TODO.md).