xref: /DragonOS/kernel/src/driver/input/ps2_mouse/ps_mouse_device.rs (revision 2b7818e80e00fcfe4d03533f587cc125ea5e4bec)
1 use core::hint::spin_loop;
2 
3 use alloc::{
4     string::ToString,
5     sync::{Arc, Weak},
6     vec::Vec,
7 };
8 use kdepends::ringbuffer::{AllocRingBuffer, RingBuffer};
9 use log::{debug, error};
10 use system_error::SystemError;
11 
12 use crate::{
13     arch::{io::PortIOArch, CurrentIrqArch, CurrentPortIOArch},
14     driver::{
15         base::{
16             class::Class,
17             device::{
18                 bus::Bus, device_manager, device_number::DeviceNumber, driver::Driver, Device,
19                 DeviceType, IdTable,
20             },
21             kobject::{KObjType, KObject, KObjectState, LockedKObjectState},
22             kset::KSet,
23         },
24         input::{
25             ps2_dev::ps2_device::Ps2Device,
26             serio::serio_device::{serio_device_manager, SerioDevice},
27         },
28     },
29     exception::InterruptArch,
30     filesystem::{
31         devfs::{devfs_register, DevFS, DeviceINode},
32         kernfs::KernFSInode,
33         vfs::{
34             core::generate_inode_id, syscall::ModeType, utils::DName, FilePrivateData, FileSystem,
35             FileType, IndexNode, Metadata,
36         },
37     },
38     libs::{
39         rwlock::{RwLockReadGuard, RwLockWriteGuard},
40         spinlock::{SpinLock, SpinLockGuard},
41     },
42     time::PosixTimeSpec,
43 };
44 
45 static mut PS2_MOUSE_DEVICE: Option<Arc<Ps2MouseDevice>> = None;
46 
47 pub fn ps2_mouse_device() -> Option<Arc<Ps2MouseDevice>> {
48     unsafe { PS2_MOUSE_DEVICE.clone() }
49 }
50 
51 const ADDRESS_PORT_ADDRESS: u16 = 0x64;
52 const DATA_PORT_ADDRESS: u16 = 0x60;
53 
54 const KEYBOARD_COMMAND_ENABLE_PS2_MOUSE_PORT: u8 = 0xa8;
55 const KEYBOARD_COMMAND_SEND_TO_PS2_MOUSE: u8 = 0xd4;
56 
57 const MOUSE_BUFFER_CAPACITY: usize = 15;
58 
59 bitflags! {
60     /// Represents the flags currently set for the mouse.
61     #[derive(Default)]
62     pub struct MouseFlags: u8 {
63         /// Whether or not the left mouse button is pressed.
64         const LEFT_BUTTON = 0b0000_0001;
65 
66         /// Whether or not the right mouse button is pressed.
67         const RIGHT_BUTTON = 0b0000_0010;
68 
69         /// Whether or not the middle mouse button is pressed.
70         const MIDDLE_BUTTON = 0b0000_0100;
71 
72         /// Whether or not the packet is valid or not.
73         const ALWAYS_ONE = 0b0000_1000;
74 
75         /// Whether or not the x delta is negative.
76         const X_SIGN = 0b0001_0000;
77 
78         /// Whether or not the y delta is negative.
79         const Y_SIGN = 0b0010_0000;
80 
81         /// Whether or not the x delta overflowed.
82         const X_OVERFLOW = 0b0100_0000;
83 
84         /// Whether or not the y delta overflowed.
85         const Y_OVERFLOW = 0b1000_0000;
86     }
87 }
88 
89 #[derive(Debug)]
90 enum PsMouseCommand {
91     SampleRate(u8),
92     EnablePacketStreaming,
93     // SetDefaults = 0xF6,
94     InitKeyboard,
95     GetMouseId,
96     SetSampleRate,
97 }
98 
99 impl From<PsMouseCommand> for u8 {
100     fn from(val: PsMouseCommand) -> Self {
101         match val {
102             PsMouseCommand::SampleRate(x) => x,
103             PsMouseCommand::EnablePacketStreaming => 0xf4,
104             PsMouseCommand::InitKeyboard => 0x47,
105             PsMouseCommand::GetMouseId => 0xf2,
106             PsMouseCommand::SetSampleRate => 0xf3,
107         }
108     }
109 }
110 
111 #[derive(Debug)]
112 pub struct MouseState {
113     flags: MouseFlags,
114     x: i16,
115     y: i16,
116 }
117 
118 #[allow(dead_code)]
119 impl MouseState {
120     /// Returns a new `MouseState`.
121     pub const fn new() -> MouseState {
122         MouseState {
123             flags: MouseFlags::empty(),
124             x: 0,
125             y: 0,
126         }
127     }
128 
129     /// Returns true if the left mouse button is currently down.
130     pub fn left_button_down(&self) -> bool {
131         self.flags.contains(MouseFlags::LEFT_BUTTON)
132     }
133 
134     /// Returns true if the left mouse button is currently up.
135     pub fn left_button_up(&self) -> bool {
136         !self.flags.contains(MouseFlags::LEFT_BUTTON)
137     }
138 
139     /// Returns true if the right mouse button is currently down.
140     pub fn right_button_down(&self) -> bool {
141         self.flags.contains(MouseFlags::RIGHT_BUTTON)
142     }
143 
144     /// Returns true if the right mouse button is currently up.
145     pub fn right_button_up(&self) -> bool {
146         !self.flags.contains(MouseFlags::RIGHT_BUTTON)
147     }
148 
149     /// Returns true if the x axis has moved.
150     pub fn x_moved(&self) -> bool {
151         self.x != 0
152     }
153 
154     /// Returns true if the y axis has moved.
155     pub fn y_moved(&self) -> bool {
156         self.y != 0
157     }
158 
159     /// Returns true if the x or y axis has moved.
160     pub fn moved(&self) -> bool {
161         self.x_moved() || self.y_moved()
162     }
163 
164     /// Returns the x delta of the mouse state.
165     pub fn get_x(&self) -> i16 {
166         self.x
167     }
168 
169     /// Returns the y delta of the mouse state.
170     pub fn get_y(&self) -> i16 {
171         self.y
172     }
173 }
174 
175 #[derive(Debug)]
176 #[cast_to([sync] Device, SerioDevice)]
177 pub struct Ps2MouseDevice {
178     inner: SpinLock<InnerPs2MouseDevice>,
179     kobj_state: LockedKObjectState,
180 }
181 
182 impl Ps2MouseDevice {
183     pub const NAME: &'static str = "psmouse";
184     pub fn new() -> Self {
185         let r = Self {
186             inner: SpinLock::new(InnerPs2MouseDevice {
187                 bus: None,
188                 class: None,
189                 driver: None,
190                 kern_inode: None,
191                 parent: None,
192                 kset: None,
193                 kobj_type: None,
194                 current_packet: 0,
195                 current_state: MouseState::new(),
196                 buf: AllocRingBuffer::new(MOUSE_BUFFER_CAPACITY),
197                 devfs_metadata: Metadata {
198                     dev_id: 1,
199                     inode_id: generate_inode_id(),
200                     size: 4096,
201                     blk_size: 0,
202                     blocks: 0,
203                     atime: PosixTimeSpec::default(),
204                     mtime: PosixTimeSpec::default(),
205                     ctime: PosixTimeSpec::default(),
206                     file_type: FileType::CharDevice, // 文件夹,block设备,char设备
207                     mode: ModeType::from_bits_truncate(0o644),
208                     nlinks: 1,
209                     uid: 0,
210                     gid: 0,
211                     raw_dev: DeviceNumber::default(), // 这里用来作为device number
212                 },
213                 device_inode_fs: None,
214             }),
215             kobj_state: LockedKObjectState::new(None),
216         };
217         return r;
218     }
219 
220     pub fn init(&self) -> Result<(), SystemError> {
221         let _irq_guard = unsafe { CurrentIrqArch::save_and_disable_irq() };
222 
223         self.write_control_port(KEYBOARD_COMMAND_ENABLE_PS2_MOUSE_PORT)?;
224         for _i in 0..1000 {
225             for _j in 0..1000 {
226                 spin_loop();
227             }
228         }
229         self.read_data_port().ok();
230 
231         self.send_command_to_ps2mouse(PsMouseCommand::EnablePacketStreaming)
232             .map_err(|e| {
233                 error!("ps2 mouse init error: {:?}", e);
234                 e
235             })?;
236         self.read_data_port().ok();
237         for _i in 0..1000 {
238             for _j in 0..1000 {
239                 spin_loop();
240             }
241         }
242 
243         // self.send_command_to_ps2mouse(PsMouseCommand::InitKeyboard)?;
244         self.do_send_command(DATA_PORT_ADDRESS as u8, PsMouseCommand::InitKeyboard.into())?;
245         self.read_data_port().ok();
246         for _i in 0..1000 {
247             for _j in 0..1000 {
248                 spin_loop();
249             }
250         }
251 
252         self.set_sample_rate(20)?;
253         // self.get_mouse_id()?;
254         Ok(())
255     }
256 
257     #[allow(dead_code)]
258     pub fn get_mouse_id(&self) -> Result<(), SystemError> {
259         self.send_command_to_ps2mouse(PsMouseCommand::GetMouseId)?;
260         let _mouse_id = self.read_data_port()?;
261         Ok(())
262     }
263 
264     /// 设置鼠标采样率
265     ///
266     /// `hz` 合法值为 10,20,40,60,80,100,200
267     pub fn set_sample_rate(&self, hz: u8) -> Result<(), SystemError> {
268         const SAMPLE_RATE: [u8; 7] = [10, 20, 40, 60, 80, 100, 200];
269         if !SAMPLE_RATE.contains(&hz) {
270             return Err(SystemError::EINVAL);
271         }
272 
273         self.send_command_to_ps2mouse(PsMouseCommand::SetSampleRate)?;
274         self.read_data_port().ok();
275         for _i in 0..1000 {
276             for _j in 0..1000 {
277                 spin_loop();
278             }
279         }
280 
281         self.send_command_to_ps2mouse(PsMouseCommand::SampleRate(hz))?;
282         for _i in 0..1000 {
283             for _j in 0..1000 {
284                 spin_loop();
285             }
286         }
287         self.read_data_port().ok();
288         Ok(())
289     }
290 
291     /// # 函数的功能
292     /// 鼠标设备处理数据包
293     pub fn process_packet(&self) -> Result<(), SystemError> {
294         let packet = self.read_data_port()?;
295         let mut guard = self.inner.lock();
296         guard.buf.push(packet); // 更新缓冲区
297         match guard.current_packet {
298             0 => {
299                 let flags: MouseFlags = MouseFlags::from_bits_truncate(packet);
300                 if !flags.contains(MouseFlags::ALWAYS_ONE) {
301                     return Ok(());
302                 }
303                 guard.current_state.flags = flags;
304             }
305             1 => {
306                 let flags = guard.current_state.flags;
307                 if !flags.contains(MouseFlags::X_OVERFLOW) {
308                     guard.current_state.x = self.get_x_movement(packet, flags);
309                 }
310             }
311             2 => {
312                 let flags = guard.current_state.flags;
313                 if !flags.contains(MouseFlags::Y_OVERFLOW) {
314                     guard.current_state.y = self.get_y_movement(packet, flags);
315                 }
316 
317                 // debug!(
318                 //     "Ps2MouseDevice packet : flags:{}, x:{}, y:{}\n",
319                 //     guard.current_state.flags.bits,
320                 //     guard.current_state.x,
321                 //     guard.current_state.y
322                 // );
323             }
324             _ => unreachable!(),
325         }
326         guard.current_packet = (guard.current_packet + 1) % 3;
327         Ok(())
328     }
329 
330     fn get_x_movement(&self, packet: u8, flags: MouseFlags) -> i16 {
331         if flags.contains(MouseFlags::X_SIGN) {
332             return self.sign_extend(packet);
333         } else {
334             return packet as i16;
335         }
336     }
337 
338     fn get_y_movement(&self, packet: u8, flags: MouseFlags) -> i16 {
339         if flags.contains(MouseFlags::Y_SIGN) {
340             return self.sign_extend(packet);
341         } else {
342             return packet as i16;
343         }
344     }
345 
346     fn sign_extend(&self, packet: u8) -> i16 {
347         ((packet as u16) | 0xFF00) as i16
348     }
349 
350     fn read_data_port(&self) -> Result<u8, SystemError> {
351         self.wait_for_write()?;
352         let cmd = unsafe { CurrentPortIOArch::in8(ADDRESS_PORT_ADDRESS) };
353         if (cmd & 0x21) == 0x21 {
354             let data = unsafe { CurrentPortIOArch::in8(DATA_PORT_ADDRESS) };
355             return Ok(data);
356         } else {
357             return Err(SystemError::ENODATA);
358         }
359     }
360 
361     #[inline(never)]
362     fn send_command_to_ps2mouse(&self, command: PsMouseCommand) -> Result<(), SystemError> {
363         self.do_send_command(KEYBOARD_COMMAND_SEND_TO_PS2_MOUSE, command.into())?;
364         Ok(())
365     }
366 
367     #[inline(never)]
368     fn do_send_command(&self, ctrl: u8, command: u8) -> Result<(), SystemError> {
369         self.write_control_port(ctrl)?;
370         self.write_data_port(command)?;
371         return Ok(());
372     }
373 
374     fn write_data_port(&self, data: u8) -> Result<(), SystemError> {
375         self.wait_for_write()?;
376         unsafe {
377             CurrentPortIOArch::out8(DATA_PORT_ADDRESS, data);
378         }
379         Ok(())
380     }
381 
382     fn write_control_port(&self, command: u8) -> Result<(), SystemError> {
383         self.wait_for_write()?;
384         unsafe {
385             CurrentPortIOArch::out8(ADDRESS_PORT_ADDRESS, command);
386         }
387         Ok(())
388     }
389 
390     #[allow(dead_code)]
391     fn wait_for_read(&self) -> Result<(), SystemError> {
392         let timeout = 100_000;
393         for _ in 0..timeout {
394             let value = unsafe { CurrentPortIOArch::in8(ADDRESS_PORT_ADDRESS) };
395             if (value & 0x1) == 0x1 {
396                 return Ok(());
397             }
398         }
399         Err(SystemError::ETIMEDOUT)
400     }
401 
402     fn wait_for_write(&self) -> Result<(), SystemError> {
403         let timeout = 100_000;
404         for _ in 0..timeout {
405             let value = unsafe { CurrentPortIOArch::in8(ADDRESS_PORT_ADDRESS) };
406             if (value & 0x2) == 0 {
407                 return Ok(());
408             }
409         }
410         Err(SystemError::ETIMEDOUT)
411     }
412 }
413 
414 #[derive(Debug)]
415 struct InnerPs2MouseDevice {
416     bus: Option<Weak<dyn Bus>>,
417     class: Option<Weak<dyn Class>>,
418     driver: Option<Weak<dyn Driver>>,
419     kern_inode: Option<Arc<KernFSInode>>,
420     parent: Option<Weak<dyn KObject>>,
421     kset: Option<Arc<KSet>>,
422     kobj_type: Option<&'static dyn KObjType>,
423 
424     /// 鼠标数据
425     current_state: MouseState,
426     current_packet: u8,
427     /// 鼠标数据环形缓冲区
428     buf: AllocRingBuffer<u8>,
429 
430     /// device inode要求的字段
431     device_inode_fs: Option<Weak<DevFS>>,
432     devfs_metadata: Metadata,
433 }
434 
435 impl Device for Ps2MouseDevice {
436     fn is_dead(&self) -> bool {
437         false
438     }
439 
440     fn dev_type(&self) -> DeviceType {
441         DeviceType::Char
442     }
443 
444     fn id_table(&self) -> IdTable {
445         IdTable::new(self.name().to_string(), None)
446     }
447 
448     fn set_bus(&self, bus: Option<alloc::sync::Weak<dyn Bus>>) {
449         self.inner.lock_irqsave().bus = bus;
450     }
451 
452     fn set_class(&self, class: Option<alloc::sync::Weak<dyn Class>>) {
453         self.inner.lock_irqsave().class = class;
454     }
455 
456     fn driver(&self) -> Option<alloc::sync::Arc<dyn Driver>> {
457         self.inner.lock_irqsave().driver.clone()?.upgrade()
458     }
459 
460     fn set_driver(&self, driver: Option<alloc::sync::Weak<dyn Driver>>) {
461         self.inner.lock_irqsave().driver = driver;
462     }
463 
464     fn can_match(&self) -> bool {
465         true
466     }
467 
468     fn set_can_match(&self, _can_match: bool) {}
469 
470     fn state_synced(&self) -> bool {
471         true
472     }
473 
474     fn bus(&self) -> Option<alloc::sync::Weak<dyn Bus>> {
475         self.inner.lock_irqsave().bus.clone()
476     }
477 
478     fn class(&self) -> Option<Arc<dyn Class>> {
479         let mut guard = self.inner.lock_irqsave();
480         let r = guard.class.clone()?.upgrade();
481         if r.is_none() {
482             guard.class = None;
483         }
484 
485         return r;
486     }
487 }
488 
489 impl SerioDevice for Ps2MouseDevice {
490     fn write(
491         &self,
492         _device: &alloc::sync::Arc<dyn SerioDevice>,
493         _data: u8,
494     ) -> Result<(), system_error::SystemError> {
495         todo!()
496     }
497 
498     fn open(
499         &self,
500         _device: &alloc::sync::Arc<dyn SerioDevice>,
501     ) -> Result<(), system_error::SystemError> {
502         todo!()
503     }
504 
505     fn close(
506         &self,
507         _device: &alloc::sync::Arc<dyn SerioDevice>,
508     ) -> Result<(), system_error::SystemError> {
509         todo!()
510     }
511 
512     fn start(
513         &self,
514         _device: &alloc::sync::Arc<dyn SerioDevice>,
515     ) -> Result<(), system_error::SystemError> {
516         todo!()
517     }
518 
519     fn stop(
520         &self,
521         _device: &alloc::sync::Arc<dyn SerioDevice>,
522     ) -> Result<(), system_error::SystemError> {
523         todo!()
524     }
525 }
526 
527 impl KObject for Ps2MouseDevice {
528     fn as_any_ref(&self) -> &dyn core::any::Any {
529         self
530     }
531 
532     fn set_inode(&self, inode: Option<alloc::sync::Arc<KernFSInode>>) {
533         self.inner.lock_irqsave().kern_inode = inode;
534     }
535 
536     fn inode(&self) -> Option<alloc::sync::Arc<KernFSInode>> {
537         self.inner.lock_irqsave().kern_inode.clone()
538     }
539 
540     fn parent(&self) -> Option<alloc::sync::Weak<dyn KObject>> {
541         self.inner.lock_irqsave().parent.clone()
542     }
543 
544     fn set_parent(&self, parent: Option<alloc::sync::Weak<dyn KObject>>) {
545         self.inner.lock_irqsave().parent = parent
546     }
547 
548     fn kset(&self) -> Option<alloc::sync::Arc<KSet>> {
549         self.inner.lock_irqsave().kset.clone()
550     }
551 
552     fn set_kset(&self, kset: Option<alloc::sync::Arc<KSet>>) {
553         self.inner.lock_irqsave().kset = kset;
554     }
555 
556     fn kobj_type(&self) -> Option<&'static dyn KObjType> {
557         self.inner.lock_irqsave().kobj_type
558     }
559 
560     fn set_kobj_type(&self, ktype: Option<&'static dyn KObjType>) {
561         self.inner.lock_irqsave().kobj_type = ktype;
562     }
563 
564     fn name(&self) -> alloc::string::String {
565         Self::NAME.to_string()
566     }
567 
568     fn set_name(&self, _name: alloc::string::String) {}
569 
570     fn kobj_state(&self) -> RwLockReadGuard<KObjectState> {
571         self.kobj_state.read()
572     }
573 
574     fn kobj_state_mut(&self) -> RwLockWriteGuard<KObjectState> {
575         self.kobj_state.write()
576     }
577 
578     fn set_kobj_state(&self, state: KObjectState) {
579         *self.kobj_state.write() = state;
580     }
581 }
582 
583 impl DeviceINode for Ps2MouseDevice {
584     fn set_fs(&self, fs: Weak<DevFS>) {
585         self.inner.lock_irqsave().device_inode_fs = Some(fs);
586     }
587 }
588 
589 impl IndexNode for Ps2MouseDevice {
590     fn open(
591         &self,
592         _data: SpinLockGuard<FilePrivateData>,
593         _mode: &crate::filesystem::vfs::file::FileMode,
594     ) -> Result<(), SystemError> {
595         let mut guard = self.inner.lock_irqsave();
596         guard.buf.clear();
597         Ok(())
598     }
599 
600     fn close(&self, _data: SpinLockGuard<FilePrivateData>) -> Result<(), SystemError> {
601         let mut guard = self.inner.lock_irqsave();
602         guard.buf.clear();
603         Ok(())
604     }
605 
606     fn read_at(
607         &self,
608         _offset: usize,
609         _len: usize,
610         buf: &mut [u8],
611         _data: SpinLockGuard<FilePrivateData>,
612     ) -> Result<usize, SystemError> {
613         let mut guard = self.inner.lock_irqsave();
614 
615         if guard.buf.len() >= 3 {
616             for item in buf.iter_mut().take(3) {
617                 *item = guard.buf.dequeue().unwrap();
618             }
619             return Ok(3);
620         } else {
621             return Ok(0);
622         }
623     }
624 
625     fn write_at(
626         &self,
627         _offset: usize,
628         _len: usize,
629         _buf: &[u8],
630         _data: SpinLockGuard<FilePrivateData>,
631     ) -> Result<usize, SystemError> {
632         return Err(SystemError::ENOSYS);
633     }
634 
635     fn fs(&self) -> Arc<dyn FileSystem> {
636         self.inner
637             .lock_irqsave()
638             .device_inode_fs
639             .as_ref()
640             .unwrap()
641             .upgrade()
642             .unwrap()
643     }
644 
645     fn as_any_ref(&self) -> &dyn core::any::Any {
646         self
647     }
648 
649     fn list(&self) -> Result<Vec<alloc::string::String>, SystemError> {
650         todo!()
651     }
652 
653     fn metadata(&self) -> Result<Metadata, SystemError> {
654         Ok(self.inner.lock_irqsave().devfs_metadata.clone())
655     }
656 
657     fn resize(&self, _len: usize) -> Result<(), SystemError> {
658         Ok(())
659     }
660 
661     fn dname(&self) -> Result<DName, SystemError> {
662         Ok(DName::from(self.name()))
663     }
664 }
665 
666 impl Ps2Device for Ps2MouseDevice {}
667 
668 pub fn rs_ps2_mouse_device_init(parent: Arc<dyn KObject>) -> Result<(), SystemError> {
669     debug!("ps2_mouse_device initializing...");
670     let psmouse = Arc::new(Ps2MouseDevice::new());
671 
672     device_manager().device_default_initialize(&(psmouse.clone() as Arc<dyn Device>));
673     psmouse.set_parent(Some(Arc::downgrade(&parent)));
674     serio_device_manager().register_port(psmouse.clone() as Arc<dyn SerioDevice>)?;
675 
676     devfs_register(&psmouse.name(), psmouse.clone()).map_err(|e| {
677         error!(
678             "register psmouse device '{}' to devfs failed: {:?}",
679             psmouse.name(),
680             e
681         );
682         device_manager().remove(&(psmouse.clone() as Arc<dyn Device>));
683         e
684     })?;
685 
686     unsafe { PS2_MOUSE_DEVICE = Some(psmouse) };
687     return Ok(());
688 }
689