Skip to content

Commit

Permalink
reorganise docs
Browse files Browse the repository at this point in the history
  • Loading branch information
carlossless committed May 26, 2024
1 parent dfc166c commit 2104e7e
Show file tree
Hide file tree
Showing 5 changed files with 87 additions and 23 deletions.
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,8 +18,8 @@ You can very easily end up with a bricked device if the written firmware can't j

| Keyboard | MCU | ISP | USB | Wireless | Details |
| -------- | --- | --- | --- | -------- | ------- |
| [NuPhy Air60 v1](https://nuphy.com/products/air60) | SH68F90A / BYK916 | ✅ | ✅ | TBD | [Details](docs/nuphy-air60.md) |
| E-YOOSO Z11 | SH68F90A / BYK901 | ✅ | ✅ | N/A | TBD |
| [NuPhy Air60 v1](https://nuphy.com/products/air60) | SH68F90A / BYK916 | ✅ | ✅ | TBD | [Details](docs/keyboards/nuphy-air60.md) |
| E-YOOSO Z11 | SH68F90A / BYK901 | ✅ | ✅ | N/A | [Details](docs/keyboards/nuphy-air60.md) |

## Acknowledgements

Expand Down
55 changes: 55 additions & 0 deletions docs/keyboards/eyooso-z11.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
# E-YOOSO Z11 Support

## Keyboard

- [x] ISP (jump)
- [x] Key Scan
- [x] LED Matrix

## Code Options

This firmware requires the following (stock) code options that are programmed on the BYK901 (SH68F90A) in the E-YOOSO Z11

```
Code Option String: A4E063C00F000088
Code Option Number: 0x8800000fc063e0a4

Byte 0 - A4
OP_OSCDRIVE 2 - 4MHz crystal or 8~12MHz crystal with external capacitance(C1=C2)<20pF
OP_RST 1 - P0.2 used as IO pin
OP_WMT 0 - longest warm up time
OP_SCMEN 1 - Disable SCM
OP_OSCRFB 0 - 150K

Byte 1 - E0
OP_LVREN 1 - Enable LVR function
OP_LVRLEVEL 3 - 2.1V LVR level4
OP_SCM 0 - SCM is invalid in warm up period
OP_OSC2SEL 0 - OSC2 select 12M RC
OP_IOV1 0 - P7.1/P7.2/P7.3/P7.4 input/output level is VUSB(5V)
OP_IOV0 0 - P5.5/P5.6 input/output level is VUSB(5V)

Byte 2 - 63
OP_SCMSEL 3 - 8MHz
OP_OSC 3 - Oscillator1 is internal 128KHz RC, oscillator2 is internal 24MHz RC

Byte 3 - C0
OP_ISP 1 - Disable ISP function
OP_ISPPIN 1 - Enter ISP mode only when P6.3 and P6.4 are connected to GND, simultaneously
OP_WDT 0 - Enable WDT function
OP_WDTPD 0 - Disable WDT function in Power-Down mode

Byte 4 - 0F
OP_SINK1 3 - Port6[5:0] sink ability largest mode(380mA)
OP_SINK0 3 - P4.7/Port7[7:5] sink ability largest mode(50mA)

Byte 5 - 00
OP_BOPTP 0 - (1+21%)tr min
OP_BOPTN 0 - (1+21%)tf min

Byte 6 - 00
Unused

Byte 7 - 88
OP_ISPSIZE 8 - 0Bytes
```
22 changes: 1 addition & 21 deletions docs/nuphy-air60.md → docs/keyboards/nuphy-air60.md
Original file line number Diff line number Diff line change
@@ -1,35 +1,15 @@
# NuPhy Air60 Support

## MCU

- [x] 3.3V LDO
- [x] CPU Clock (use 24Mhz as SYSCLK)
- [x] GPIO
- [x] UART
- [x] Transmit
- [ ] Receive
- [x] PWM
- [x] USB
- [ ] SPI

## Keyboard

- [x] ISP (jump)
- [x] Key Scan
- [x] RGB Matrix
- [ ] Debouncing
- [x] USB HID
- [x] USB Keyboard
- [ ] Status LEDs
- [ ] Extra Keys (System / Consumer)
- [ ] NKRO
- [~] QMK Compatibility
- [~] Layouts
- [ ] Wireless

## Code Options

This firmware requires the following (stock) code options for SH68F90A
This firmware requires the following (stock) code options that are programmed on the BYK916 (SH68F90A) in the E-YOOSO Z11

```
Code Option String: A4E063C00F000088
Expand Down
14 changes: 14 additions & 0 deletions docs/platforms/sh68f90a.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
# SH68F90A (BYK901 / BYK916) Support

## MCU

- [x] 3.3V LDO
- [x] CPU Clock (use 24Mhz as SYSCLK)
- [x] GPIO
- [x] UART
- [x] Transmit
- [x] Receive
- [x] PWM
- [x] USB
- [ ] SPI
- [x] ISP (jump)
15 changes: 15 additions & 0 deletions docs/smk.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# SMK Supported Features

- [x] ISP (jump)
- [x] Debug printf (via UART)
- [x] Key Scan
- [ ] Debouncing
- [x] Indicators (Backlight)
- [x] USB HID
- [x] USB Keyboard
- [x] Status LEDs
- [ ] Extra Keys (System / Consumer)
- [ ] NKRO
- [~] QMK Compatibility
- [~] Layouts
- [ ] Wireless

0 comments on commit 2104e7e

Please sign in to comment.