Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Use hardware.inc 5.0 constants

Đang mở
#125 2 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
42/100
Loại issue
Tài liệu
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Đình trệ
Lĩnh vực
documentation, game-dev

Hướng nghiên cứu

Xác định các phần hướng dẫn Hello World và Unbricked, rồi so sánh các hằng số của chúng với hardware.inc 5.0. Thay thế các tên đã lỗi thời và các số lượng phần cứng được hard-code được nêu trong issue, sau đó xác minh rằng các ví dụ đã cập nhật sử dụng nhất quán quy ước đặt tên mới và các hằng số mới.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Right from the very beginning with Hello World, the tutorial uses constants from hardware.inc. Version 5.0, released 2025-06-22, changed the naming convention for bit number and mask constants, and also added a number of new constants for more hardware-related quantities that are currently hard-coded in the tutorial.

A few of the examples in Hello World:

  • ld a, LCDCF_ON | LCDCF_BGON would now be ld a, LCDC_ON | LCDC_BG_ON ... and could explicitly specify more of the flag bits, like LCDC_BG_9800
  • WaitVBlank: ld a, [rLY] :: cp 144 :: jp c, WaitVBlank can use LY_VBLANK for 144
  • ld hl, $9800 can be ld hl, TILEMAP0

And some of the ones in Unbricked:

  • ld b, 160 :: ld hl, _OAMRAM would now be ld b, OAM_SIZE :: ld hl, STARTOF(OAM)
  • ld a, 128 + 16 and ld a, 16 + 8 would now be ld a, 128 + OAM_Y_OFS and ld a, 16 + OAM_X_OFS
  • ld a, P1F_GET_BTN would now be ld a, JOYP_GET_BUTTONS (and [rP1] would be [rJOYP])
  • [_OAMRAM + 5] could be [STARTOF(OAM) + 1 * OBJ_SIZE + OAMA_X] (i.e. the X coord of OBJ 1)
  • etc
Ngôn ngữ chính
Assembly
Star
179
Fork
64
Merge trung bình
7 ngày 22 giờ
Pull request đã merge (30 ngày)
1

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của gbdev/gb-asm-tutorial

Tất cả issue của gbdev/gb-asm-tutorial

Issue tương tự

Thêm issue về Documentation

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.