Remove obsolete audio and buzzer control documentation files, including detailed guides and HTML interfaces, to streamline the repository and eliminate redundancy. This cleanup enhances maintainability and focuses on essential resources for the reTerminal DM4 audio and buzzer functionalities.
This commit is contained in:
nearxos
210
archive/chromium-setup-legacy/KDE-INSTALLATION-SUMMARY.md
Normal file
210
archive/chromium-setup-legacy/KDE-INSTALLATION-SUMMARY.md
Normal file
@@ -0,0 +1,210 @@
|
||||
# KDE Plasma Installation Summary
|
||||
|
||||
## Installation Status: ✅ COMPLETE
|
||||
|
||||
**Date**: 2026-01-09
|
||||
**Device**: Raspberry Pi Compute Module 4 (8GB RAM)
|
||||
**Previous Desktop**: LXDE with Openbox
|
||||
**New Desktop**: KDE Plasma (X11)
|
||||
|
||||
---
|
||||
|
||||
## What Was Installed
|
||||
|
||||
### Core Packages
|
||||
- ✅ `kde-plasma-desktop` - KDE Plasma desktop environment
|
||||
- ✅ `maliit-keyboard` - On-screen keyboard for touchscreen
|
||||
- ✅ Additional KDE components and dependencies
|
||||
|
||||
### Available Sessions
|
||||
- ✅ **Plasma (X11)** - `/usr/share/xsessions/plasmax11.desktop`
|
||||
- ✅ **LXDE/Openbox** - Still available for revert
|
||||
- ✅ **RPD-X** - Original Raspberry Pi desktop
|
||||
|
||||
---
|
||||
|
||||
## Current System State
|
||||
|
||||
### Session Manager Status
|
||||
- **Current Default**: `/usr/bin/startx-rpd` (LXDE - unchanged)
|
||||
- **KDE Available**: `/usr/bin/startplasma-x11` (priority 40)
|
||||
- **LXDE Available**: `/usr/bin/lxsession` (priority 49)
|
||||
|
||||
### Backup Created
|
||||
- ✅ Desktop configuration backed up to: `~/desktop-backup/`
|
||||
- ✅ Session manager configuration saved
|
||||
|
||||
---
|
||||
|
||||
## How to Use KDE Plasma
|
||||
|
||||
### First Time Setup
|
||||
|
||||
1. **Log out of current session**
|
||||
```bash
|
||||
# Or simply reboot
|
||||
sudo reboot
|
||||
```
|
||||
|
||||
2. **At login screen:**
|
||||
- Look for session/desktop selector (usually top-right corner)
|
||||
- Click and select **"Plasma (X11)"** or **"plasmax11"**
|
||||
- Enter credentials and log in
|
||||
|
||||
3. **First boot into KDE:**
|
||||
- KDE will initialize (may take 30-60 seconds first time)
|
||||
- You may see a welcome screen - you can skip it
|
||||
- Desktop will appear with KDE panel
|
||||
|
||||
4. **Configure for Touchscreen:**
|
||||
- System Settings > Input Devices > Virtual Keyboard
|
||||
- Enable "Show on-screen keyboard when needed"
|
||||
- System Settings > Display and Monitor
|
||||
- Set scale to 125% or 150% for better touch targets
|
||||
- System Settings > Workspace Behavior > Desktop Effects
|
||||
- Disable heavy effects for better performance
|
||||
|
||||
---
|
||||
|
||||
## Chromium Autostart
|
||||
|
||||
Your existing Chromium autostart configuration will work with KDE:
|
||||
- ✅ File: `~/.config/autostart/chromium-kiosk.desktop`
|
||||
- ✅ Script: `~/start-chromium.sh`
|
||||
|
||||
Chromium will start automatically when KDE desktop loads.
|
||||
|
||||
---
|
||||
|
||||
## Reverting to LXDE
|
||||
|
||||
### Quick Method (Recommended)
|
||||
1. Log out
|
||||
2. At login screen, select "Openbox" or "RPD-X" session
|
||||
3. Log in
|
||||
|
||||
### Using Revert Script
|
||||
```bash
|
||||
# Copy revert-to-lxde.sh to device
|
||||
scp revert-to-lxde.sh pi@10.130.60.253:~/
|
||||
ssh pi@10.130.60.253 "chmod +x ~/revert-to-lxde.sh && ~/revert-to-lxde.sh"
|
||||
```
|
||||
|
||||
### Manual Revert
|
||||
```bash
|
||||
sudo update-alternatives --config x-session-manager
|
||||
# Select: /usr/bin/startx-rpd or /usr/bin/lxsession
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Performance Expectations
|
||||
|
||||
### RAM Usage
|
||||
- **LXDE**: ~200-300MB
|
||||
- **KDE Plasma**: ~400-800MB
|
||||
- **Available**: ~6.7GB (plenty of headroom)
|
||||
|
||||
### CPU Usage
|
||||
- **Idle**: Low (< 5%)
|
||||
- **Active**: Moderate (10-30%)
|
||||
- **Heavy tasks**: May see some lag on Cortex-A72
|
||||
|
||||
### Boot Time
|
||||
- **LXDE**: ~20-30 seconds
|
||||
- **KDE Plasma**: ~30-45 seconds (first boot may be longer)
|
||||
|
||||
---
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### KDE Won't Start
|
||||
```bash
|
||||
# Check if installed
|
||||
dpkg -l | grep kde-plasma
|
||||
|
||||
# Check available sessions
|
||||
ls /usr/share/xsessions/
|
||||
|
||||
# Try manual start (if logged in via SSH)
|
||||
DISPLAY=:0 startplasma-x11
|
||||
```
|
||||
|
||||
### Performance Issues
|
||||
- Disable desktop effects: System Settings > Workspace Behavior > Desktop Effects
|
||||
- Reduce animations: System Settings > Workspace Behavior > General Behavior
|
||||
- Use X11 (already configured) instead of Wayland
|
||||
|
||||
### Touchscreen Issues
|
||||
```bash
|
||||
# Check touchscreen device
|
||||
xinput list
|
||||
|
||||
# Calibrate if needed
|
||||
sudo apt-get install xinput-calibrator
|
||||
xinput_calibrator
|
||||
```
|
||||
|
||||
### Chromium Not Starting
|
||||
- Check autostart file: `cat ~/.config/autostart/chromium-kiosk.desktop`
|
||||
- Check script: `cat ~/start-chromium.sh`
|
||||
- Manual test: `DISPLAY=:0 ~/start-chromium.sh`
|
||||
|
||||
---
|
||||
|
||||
## Files and Locations
|
||||
|
||||
### Configuration Files
|
||||
- KDE config: `~/.config/plasma*`
|
||||
- KDE panel: `~/.config/plasma-org.kde.plasma.desktop-appletsrc`
|
||||
- Window manager: `~/.config/kwinrc`
|
||||
- Session: `/usr/share/xsessions/plasmax11.desktop`
|
||||
|
||||
### Backup Location
|
||||
- `~/desktop-backup/` - Original LXDE configuration
|
||||
|
||||
### Documentation
|
||||
- `KDE-INSTALLATION-GUIDE.md` - Full installation and revert guide
|
||||
- `revert-to-lxde.sh` - Automated revert script
|
||||
- `TOUCHSCREEN-DESKTOP-OPTIONS.md` - Desktop environment comparison
|
||||
|
||||
---
|
||||
|
||||
## Next Steps
|
||||
|
||||
1. ✅ **Reboot the device**
|
||||
```bash
|
||||
ssh pi@10.130.60.253 "sudo reboot"
|
||||
```
|
||||
|
||||
2. ✅ **Select KDE at login**
|
||||
- Choose "Plasma (X11)" from session selector
|
||||
|
||||
3. ✅ **Configure touchscreen settings**
|
||||
- Enable on-screen keyboard
|
||||
- Adjust UI scaling
|
||||
- Disable heavy effects
|
||||
|
||||
4. ✅ **Test Chromium autostart**
|
||||
- Verify Chromium starts in fullscreen
|
||||
- Check if it properly fills the screen
|
||||
|
||||
---
|
||||
|
||||
## Support
|
||||
|
||||
If you encounter issues:
|
||||
1. Check logs: `journalctl -xe`
|
||||
2. Check X session: `~/.xsession-errors`
|
||||
3. Verify packages: `dpkg -l | grep kde`
|
||||
4. Review documentation: `KDE-INSTALLATION-GUIDE.md`
|
||||
|
||||
---
|
||||
|
||||
## Notes
|
||||
|
||||
- KDE Plasma is installed but **not set as default** - you choose at login
|
||||
- LXDE is still available and can be selected at any time
|
||||
- All original configurations are backed up
|
||||
- Chromium autostart will work with both desktops
|
||||
- Performance should be acceptable on Pi 4 with 8GB RAM
|
||||
Reference in New Issue
Block a user