AIPTEK(4)

📦 version 1.4.1, in debian bookworm, debian trixie

💖 AIPTEK 💖

okay bestie, buckle up, we're reading the AIPTEK(4) page from the Kernel Interfaces Manual together and it's genuinely iconic. it's about the Aiptek USB Digital Tablet Input Driver for Linux, and yes i will be holding your hand through every single option, no skips, no shortcuts. 🫶

✨ NAME ✨

aiptek — the Aiptek USB Digital Tablet Input Driver for Linux. that's the whole vibe. that's the name. 💅

🌸 SYNOPSIS 🌸

so this is what it looks like when you actually write it out, bestie:

Section "InputDevice"
  Identifier "idevname"
  Driver "aiptek"
  Option "Device"   "devpath"
  ...
EndSection

like, that's the shape of it. the ... is doing a lot of heavy lifting but we love her for it. 💜

🦋 DESCRIPTION 🦋

aiptek is an Xorg input driver for Aiptek HyperPen USB-based tablet devices. and here's the tea: this driver only supports the USB protocol, and only under Linux. if you're out here with an RS-232C-based HyperPen, this is not your driver, girlie — go look at the "hyperpen" driver instead. no hard feelings. 🎀

the aiptek driver functions as a pointer input device, and it may be used as the X server's core pointer. main character energy fr fr. ✨

👑 SUPPORTED HARDWARE 👑

this driver supports the Aiptek HyperPen 4000U, 5000U, 6000U, 8000U and 12000U USB-based input tablet on some Linux platforms. the "some" is doing a little bit of gatekeeping but that's just how it is, ngl. 💀

💅 CONFIGURATION DETAILS 💅

okay so first things first: please refer to xorg.conf(5) for general configuration details and for options that can be used with all input drivers. this section only covers the configuration details that are specific to this driver. don't come for me about the general stuff. 🌈

Multiple instances of the Aiptek devices can cohabit. it can be useful to define multiple devices with different active zones. each device supports the following entries:

  • Option "Type" "stylus"|"eraser"|"cursor" — sets the type of tool the device represent. this option is mandatory. no Type, no service, periodt. 💖
  • Option "Device" "path" — sets the path to the special file which represents serial line where the tablet is plugged. you have to specify it for each subsection with the same value if you want to have multiple devices with the same tablet. this option is mandatory. 🫶
  • Option "USB" "on" — specifies that you are using the USB bus to communicate with your tablet. this setting is mandatory, as USB is the only protocol supported by this driver. it's giving "there is no plan B". 😭
  • Option "DeviceName" "name" — sets the name of the X device.
  • Option "Mode" "Relative"|"Absolute" — sets the mode of the device.
  • Option "HistorySize" "number" — sets the motion history size. by default the value is zero. ⭐
  • Option "AlwaysCore" "on" — enables the sharing of the core pointer. when this feature is enabled, the device will take control of the core pointer (and thus will emit core events) and at the same time will be able, when asked so, to report extended events. you can use the last available integer feedback to control this feature. when the value of the feedback is zero, the feature is disabled. the feature is enabled for any other value. 🔥
  • Option "XTop" "number" — first of three sets of parameters to set the active zone. this sets the X coordinate of the top corner of the active zone. "TopX" is a synonym.
  • Option "YTop" "number" — first of three sets of parameters to set the active zone. this sets the Y coordinate of the top corner of the active zone. "TopY" is a synonym.
  • Option "XBottom" "Inumber" — first of three sets of parameters to set the active zone. this sets the X coordinate of the bottom corner of the active zone. "BottomX" is a synonym.
  • Option "YBottom" "number" — first of three sets of parameters to set the active zone. this sets the Y coordinate of the bottom corner of the active zone. "BottomY" is a synonym.
  • Option "XMax" "number" — second of three sets of parameters to set the active zone. this sets the the X coordinate of the bottom corner of the active zone. the Top X corner's coordinate is fixed at 0. "MaxX" is a synonym. (yes, the original really says "the the". we respect her.) 💀
  • Option "YMax" "number" — second of three sets of parameters to set the active zone. this sets the the Y coordinate of the bottom corner of the active zone. the Top Y corner's coordinate is fixed at 0. "MaxY" is a synonym.
  • Option "XOffset" "number" — third of three sets of parameters to set the active zone. this sets the X coordinate of the top corner of the active zone. "OffsetX" is a synonym.
  • Option "YOffset" "number" — third of three sets of parameters to set the active zone. this sets the Y coordinate of the top corner of the active zone. "OffsetY" is a synonym.
  • Option "XSize" "number" — third of three sets of parameters to set the active zone. this sets the X coordinate of the bottom corner of the active zone. unlike others, this parameter is expressed in relative coordinates from the "XOffset" parameter. "XSize" is a synonym. 🎀
  • Option "YSize" "number" — third of three sets of parameters to set the active zone. this sets the Y coordinate of the bottom corner of the active zone. unlike others, this parameter is expressed in relative coordinates from the "YOffset" parameter. "YSize" is a synonym.
  • Option "ZMin" "number" — minimum pressure reading that will be accepted from the Stylus tool. "MinZ" is a synonym.
  • Option "ZMax" "number" — maximum pressure reading that will be accepted from the Stylus tool. "MaxZ" is a synonym.
  • Option "XThreshold" "number" — minimal change in X coordinate position that will be accepted as data input. "ThresholdX" is a synonym.
  • Option "YThreshold" "number" — minimal change in Y coordinate position that will be accepted as data input. "ThresholdY" is a synonym.
  • Option "ZThreshold" "number" — minimal change in pressure reading that will be accepted as data input. "ThresholdZ" is a synonym.
  • Option "InvX" "on" — inverts X coordinate reports. "XInv" is a synonym.
  • Option "InvY" "on" — inverts Y coordinate reports. "YInv" is a synonym.
  • Option "Pressure" "soft"|"hard"|"linear" — pressure reports either delivered in linearly incremental values (default), or perturbed by one of two log-linear algorithms ("soft" or "hard".) 🍓
  • Option "KeepShape" "on" — when this option is enabled, the active zone begins according to TopX and TopY. the bottom corner is adjusted to keep the ratio width/height of the active zone the same as the screen while maximizing the area described by the active area set of parameters, XTop/YTop/XBottom/YBottom, XMax/YMax, or XOffset/YOffset/XSize/YSize. 🌸
  • Option "DebugLevel" number — sets the level of debugging info reported.
this driver is currently Linux specific. 🐧

🌈 SEE ALSO 🌈

Xorg(1), xorg.conf(5), Xserver(1), X(7), hyperpen(4).

🧚 AUTHORS 🧚

Bryan W. Headley <bheadley@earthlink.net> — legend behaviour, honestly. 👑

⭐ PROJECT PAGE ⭐

http://aiptektablet.sourceforge.net tracks ongoing development of this driver, the Linux kernel driver, and a GUI front-end application that works in concert with the above. go be nosy, bestie, it's encouraged. 💖

and that's the whole page!! 💜 this was X Version 11, xf86-input-aiptek 1.4.1, and the page you just read is AIPTEK(4) — iykyk. thanks for reading with me, you ate that. mwah. 💅✨

📦 where this page comes from