KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #claude-code #codex #developer-tools #ai #dsh-plugin #ai-agent #mcp #deepseek-harness #windows

macmini

★ 30 Open GitHub ↗

Mac(intosh) mini

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Mac(intosh) mini

## Build Instruction
- Print the outer shell.
  - PLA, 0.2 mm, 180 ℃ (See also [./openscad/README.md](./openscad/README.md))
  - `macintosh-mini-part-a.stl` ([stl](./openscad/macintosh-mini-part-a.stl))
  - `macintosh-mini-part-b.stl` ([stl](./openscad/macintosh-mini-part-b.stl))

- Setup your Orange Pi Zero Plus 2 (H3)
  - Install Armbian Bionic. https://www.armbian.com/orange-pi-zero-plus-2-h3/
  - Then SSH into the device.
```bash
$ sudo apt install -y git tightvncserver

# Install Node.js
$ git clone https://github.com/tj/n /tmp/n && cd /tmp/n && sudo make install
$ sudo n v10

# Install https://github.com/xpertsavenue/WiringOP-Zero
$ cd ~/
$ git clone https://github.com/xpertsavenue/WiringOP-Zero
## Please refer to https://github.com/xpertsavenue/WiringOP-Zero

# Enable SPI1 interface
$ sudo vi /boot/armbianEnv.txt # or use armbian-config
! overlays=spi-spidev analog-codec usbhost2 usbhost3
+ param_spidev_spi_bus=1

# Setup vncserver
$ mkdir ~/.vnc
$ vncpasswd ~/.vnc/passwd

# Install the dependencies & config files
$ git clone https://github.com/likeablob/macmini ~/macmini
$ cd ~/macmini
$ sudo ./install.sh

# Copy your assets
$ cp /path/to/vmac.rom ~/macmini/minivmac/vMac.ROM # Mini vMac ROM file
$ cp /path/to/vmac.dsk ~/macmini/minivmac/system.dsk # Mini vMac disk file
$ cp /path/to/.basilisk_ii_prefs ~/.basilisk_ii_prefs # Basilisk II config file
$ cp /path/to/macboot.wav ~/macmini/macboot.wav # Boot sound (optional)

# Reboot to apply the settings
$ sudo reboot now

# Select LineOut as the default sink
$ pacmd list-sinks | grep -e 'name:' -e 'index:'
  index: 0
	  name: <alsa_output.platform-1c22c00.codec.analog-mono> # LineOut
* index: 1
	  name: <alsa_output.platform-soc_sound.stereo-fallback> # HDMI
$ pactl set-default-sink 0 # or use `DISPLAY=:1 pavucontrol` and `alsamixer` to adjust volume
```
- [Tips]: Here is my working [.basilisk_ii_prefs](basilisk_ii_prefs.md).
  
- Wire the display & USB boards to the OPi

| OPi            | Peripherals                |
| -------------- | -------------------------- |
| PA15/SPI1_MOSI | LCD MOSI                   |
| PA16/SPI1_MISO | LCD MISO                   |
| PA14/SPI1_CLK  | LCD CLK                    |
| PA13/SPI1_CS   | LCD CS                     |
| PS12           | LCD RESET                  |
| PA11           | LCD DC                     |
| PA06           | Push Switch                |
| GND            | Push Switch                |
| USB-DP2        | USB (Front) Data+          |
| USB-DM2        | USB (Front) Data-          |
| 5V             | USB (Front/Rear) 5V        |
| GND            | USB (Front/Rear) GND       |
| LINEOUTL       | (Optional) Amplifier Input |

- [Tips]: Pinout can be found below.
  - OPiZero
    - https://linux-sunxi.org/Xunlong_Orange_Pi_Zero_Plus
    - http://www.orangepi.org/orangepibbsen/forum.php?mod=viewthread&tid=2236
  - LCD (Note that there might be some variants.)
    - [link1](https://www.solidrop.net/product/free-ship-5pc-lot-2-4inch-spi-tft-lcd-screen-18pin-240-320-color-lcd-drive-ic-ili9341-4io-only-for-stm32-mcu-raspberry-pi.html) [link2](https://github.com/myelin/tiny-tft/blob/master/TJC-024-9341-18-pin-SPI-240x320-ili9341-2.4-inch-touch/chinese-driver/TJC-024-9341.pdf)
    - [backup](./images/lcd-ili9341-pinout.jpg)

## Basic Concepts
1. At system boot, [`fbtft_device`](./config/fbtft.conf) kernel module is loaded and it initializes the LCD as `/dev/fb0`.
2. `nodm` starts an X session and `~/.xinitrc` get executed.
3. `~/.xinitrc` launchs `matchbox-window-manager` and `~/macmini/switcher/*js`.
4. `~/macmini/switcher/index.js` reads the scripts [`~/macmini/switcher/sh.d/*sh`](./switcher/sh.d/) and spawns them one by one when there is a HTTP GET request at `localhost:5501/`.
5. `~/macmini/switcher/gpio-reader.js` watchs the push SW at GPIO7(PA06) and send a request to `localhost:5501/`.

### How does the low-res LCD(320x240) handle 512x384 resolution?
Internally `tightvncserver` and `ssvncviewer` are used to scale the display.
- e.g. [`1_large_minimac.sh`](./switcher/sh.d/1_large_minimac.sh) launches: 
  -  `tightvncserver` to create a virtual display (512x384) at `DISPLAY=:1` (`:5901`)
  -  `minivmac` in `DISPLAY:1`
  -  `ssvncviewer -scale 0.625` in `DISPLAY:0` (By the `-scale` option, low-res LED get upscaled)

## Gallery
| <img align="center" width="auto" height="200px" src="./images/mm_s_5.jpg">  | <img align="center" width="auto" height="200px" src="./images/mm_s_7.jpg">  |
| :-------------------------------------------------------------------------: | :-------------------------------------------------------------------------: |
| <img align="center" width="auto" height="200px" src="./images/mm_s_20.jpg"> | <img align="center" width="auto" height="200px" src="./images/mm_s_14.jpg"> |
| <img align="center" width="auto" height="200px" src="./images/mm_s_10.jpg"> | <img align="center" width="auto" height="200px" src="./images/mm_s_23.jpg"> |
| <img align="center" width="auto" height="200px" src="./images/mm_s_9.jpg">  | <img align="center" width="auto" height="200px" src="./images/mm3_sd.gif">  |

## BOM
| Name                                                    | Quantity | Descriptions            |
| ------------------------------------------------------- | :------: | ----------------------- |
| OrangePi Zero Plus 2 (H3)                               |    1     | H5 ver. might work too. |
| 2.4inch SPI Display (ili9341, 320x240, with flat cable) |    1     |                         |
| Generic micro-USB Breakout Board                        |    2     |                         |
| M2 x 6 mm Self Tapping Screw                            |    16    |                         |
| D10mm Rounding Magnet                                   |    2     |                         |
| 7x7 mm Push Switch                                      |    1     |                         |
| 2W Small Speaker                                        |    1     | (Optional)              |
| ClassD Audio Amplifier Board                            |    1     | (Optional) PAM8403      |

## Acknowledgments
- Mini vMac https://www.gryphel.com/c/minivmac/
- Basilisk II https://basilisk.cebix.net/
- Kudos to all the devs!

macmini

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README