18. Yealink USB-P1K 電話的驅動程式文件¶

18.1. 狀態¶

P1K 是一款相對便宜的 USB 1.1 電話，具有以下特點：

鍵盤完全支援，yealink.ko / 輸入事件 API

LCD 完全支援，yealink.ko / sysfs API

LED 完全支援，yealink.ko / sysfs API

撥號音完全支援，yealink.ko / sysfs API

鈴聲完全支援，yealink.ko / sysfs API

音訊播放完全支援，snd_usb_audio.ko / alsa API

音訊錄製完全支援，snd_usb_audio.ko / alsa API

有關供應商文件，請參閱 http://www.yealink.com

18.2. 鍵盤功能¶

核心中的當前對映由 map_p1k_to_key 函式提供

Physical USB-P1K button layout       input events


           up                             up
     IN           OUT                left,   right
          down                           down

   pickup   C    hangup              enter, backspace, escape
     1      2      3                 1, 2, 3
     4      5      6                 4, 5, 6,
     7      8      9                 7, 8, 9,
     *      0      #                 *, 0, #,

“向上”和“向下”鍵在按鈕上用箭頭表示。“拿起”和“結束通話”鍵在按鈕上用綠色和紅色電話表示。

18.3. LCD 功能¶

LCD 被劃分為 3 行顯示

  |[]   [][]   [][]   [][]   in   |[][]
  |[] M [][] D [][] : [][]   out  |[][]
                            store

  NEW REP         SU MO TU WE TH FR SA

  [] [] [] [] [] [] [] [] [] [] [] []
  [] [] [] [] [] [] [] [] [] [] [] []


Line 1  Format (see below)    : 18.e8.M8.88...188
        Icon names            :   M  D  :  IN OUT STORE
Line 2  Format                : .........
        Icon name             : NEW REP SU MO TU WE TH FR SA
Line 3  Format                : 888888888888

格式描述

從使用者空間的角度來看，世界被分為“數字”和“圖示”。一個數字可以有一個字元集，一個圖示只能是 ON 或 OFF。

格式說明符

'8' :  Generic 7 segment digit with individual addressable segments

Reduced capability 7 segment digit, when segments are hard wired together.
'1' : 2 segments digit only able to produce a 1.
'e' : Most significant day of the month digit,
      able to produce at least 1 2 3.
'M' : Most significant minute digit,
      able to produce at least 0 1 2 3 4 5.

Icons or pictograms:
'.' : For example like AM, PM, SU, a 'dot' .. or other single segment
      elements.

18.4. 驅動程式用法¶

對於使用者層，可以使用 sysfs 介面使用以下介面

/sys/.../
         line1        Read/Write, lcd line1
         line2        Read/Write, lcd line2
         line3        Read/Write, lcd line3

         get_icons    Read, returns a set of available icons.
         hide_icon    Write, hide the element by writing the icon name.
         show_icon    Write, display the element by writing the icon name.

         map_seg7     Read/Write, the 7 segments char set, common for all
                      yealink phones. (see map_to_7segment.h)

         ringtone     Write, upload binary representation of a ringtone,
                      see yealink.c. status EXPERIMENTAL due to potential
                      races between async. and sync usb calls.

18.4.1. lineX¶

讀取 /sys/../lineX 將返回帶有其當前值的格式字串。

示例

cat ./line3
888888888888
Linux Rocks!

寫入 /sys/../lineX 將設定相應的 LCD 行。

多餘的字元將被忽略。

如果寫入的字元少於允許的字元，則剩餘的數字不會更改。

製表符 't' 和 'n' 字元不會覆蓋原始內容。

將空格寫入圖示將始終隱藏其內容。
示例
date +"%m.%e.%k:%M"  | sed 's/^0/ /' > ./line1
將使用當前日期和時間更新 LCD。

18.4.2. get_icons¶

讀取將返回所有可用圖示名稱及其當前設定

cat ./get_icons
on M
on D
on :
   IN
   OUT
   STORE
   NEW
   REP
   SU
   MO
   TU
   WE
   TH
   FR
   SA
   LED
   DIALTONE
   RINGTONE

18.4.3. 顯示/隱藏圖示¶

寫入這些檔案將更新圖示的狀態。一次只能更新一個圖示。

如果一個圖示也在 ./lineX 上，則相應的值將更新為圖示的第一個字母。

示例 - 點亮儲存圖示

echo -n "STORE" > ./show_icon

cat ./line1
18.e8.M8.88...188
              S

示例 - 響鈴 10 秒

echo -n RINGTONE > /sys/..../show_icon
sleep 10
echo -n RINGTONE > /sys/..../hide_icon

18.5. 聲音功能¶

聲音由 ALSA 驅動程式支援：snd_usb_audio

一個 16 位通道，取樣和播放速率為 8000 Hz 是該裝置的實際限制。

示例 - 錄音測試
arecord -v -d 10 -r 8000 -f S16_LE -t wav  foobar.wav
示例 - 播放測試
aplay foobar.wav

18.6. 故障排除¶

問:: 模組 yealink 編譯並安裝沒有任何問題，但電話未初始化並且對任何操作都沒有反應。
答:: 如果您看到類似以下內容：hiddev0: USB HID v1.00 Device [Yealink Network Technology Ltd. VOIP USB Phone 在 dmesg 中，這意味著 hid 驅動程式首先獲取了該裝置。嘗試在任何其他 usb hid 驅動程式之前載入模組 yealink。請參閱您的發行版提供的模組配置說明。
問:: 電話現在可以工作（顯示版本並接受鍵盤輸入），但我找不到 sysfs 檔案。
答:: sysfs 檔案位於特定的 usb 端點上。在大多數發行版上，您可以執行：“find /sys/ -name get_icons” 以獲得提示。

18.7. 致謝¶

Olivier Vandorpe，用於啟動 usbb2k-api 專案，進行大量的逆向工程。

Martin Diehl，用於指出如何處理 USB 記憶體分配。

Dmitry Torokhov，用於無數的程式碼審查和建議。

Linux 核心

目錄

本頁