UHSO(4)

📦
version 15.1 · 2 versions
, in freebsd 14.5, freebsd 15.1, nixpkgs unstable

✨ NAME ✨

uhso — support for several HSxPA devices from Option N.V. This is the UHSO(4) page from the Kernel Interfaces Manual, bestie, and we're gonna make it make sense 💅🦋

🌸 SYNOPSIS 🌸

okay so the module can be loaded at boot time by placing the following line in loader.conf(5):

uhso_load="YES"

🦋 DESCRIPTION 🦋

The uhso driver provides support for several HSxPA devices from Option N.V. that are based on their packet interface. Each device has a set of serial ports and a raw IP packet interface. The serial ports of the device are accessed through the ucom(4) driver, which makes them behave like tty(4) devices. The packet interface is exposed as a network interface. Literally main character energy for a USB driver ✨

Establishing a connection on the packet interface is achieved by using the proprietary AT commands AT_OWANCALL and AT_OWANDATA on any of the available serial ports. No cap.

The network interface must be configured manually using the data from these calls. You heard me — manual config, bestie 🫶

Each device usually has at least two or more serial ports, and their individual purpose can be identified through sysctl(8). Ports identified as “Modem” have a normal modem interface that can be used with PPP. Ports identified as “Diagnostic” use a proprietary binary interface used for firmware upgrades; this port does not have an AT command interface and cannot be used to control the device. Other ports feature an AT command interface that can be used for normal device control. slay 💅

🎀 HARDWARE 🎀

The uhso driver should work with most devices from Option. The following devices have been verified to work:

  • Option GlobeSurfer iCON 7.2 (new firmware)
  • Option GlobeTrotter Max 7.2 (new firmware)
  • Option iCON 225
  • Option iCON 452
  • Option iCON 505

The device features a mass storage device referred to as “Zero-CD” which contains drivers for Microsoft Windows; this is the default mode for the device. The uhso driver automatically switches the device from “Zero-CD” mode to modem mode. This behavior can be disabled by setting hw.usb.uhso.auto_switch to 0 using sysctl(8). So yes, you can turn off the auto-switch vibe ✨

🍓 FILES 🍓

  • /dev/cuaU?.?

🌈 EXAMPLES 🌈

Establishing a packet interface connection using the AT command interface available at one of the serial ports:

AT+CGDCONT=1,,"apn.provider"
AT_OWANCALL=1,1,1
OK
_OWANCALL=1,1

AT_OWANDATA=1
_OWANDATA: 1, 10.11.12.13, 0.0.0.0, 10.2.3.4, 10.2.3.5, \
        0.0.0.0, 0.0.0.0, 72000

Configuring the interface:

ifconfig uhso0 10.11.12.13 up
route add default -interface uhso0
echo "nameserver 10.2.3.4" > /etc/resolv.conf
echo "nameserver 10.2.3.5" >> /etc/resolv.conf

The connection can be terminated with:

AT_OWANCALL=1,0,1

💖 SEE ALSO 💖

👑 AUTHORS 👑

The uhso driver was written by Fredrik Lindberg <fli@shapeshifter.se>. Periodt. 👑

xoxo, this page came from Debian and is dated July 20, 2010 — mwah 💋

📦 where this page comes from