Makefile 59 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278
  1. # NebOS top-level build.
  2. #
  3. # Source tree:
  4. # boot/ real-mode boot sector, MBR, VESA stage, UEFI loader (boot/efi)
  5. # kernel/ the 32-bit kernel (kernel.ld, drivers, services)
  6. # common/ freestanding code linked into both the kernel and userland
  7. # include/ ABI headers shared by boot, kernel, userland and host tools
  8. # user/apps/<n>/ one directory per ring-3 program (ucmd_<n>.c + its modules)
  9. # user/lib/<l>/ ring-3 libraries (libc, ngui, ufont, img, tls, uhttp, ...)
  10. # tools/ host-side tools (mkpack, mkrootfs, kexec_send, ...)
  11. # host/ Linux SDL3 browser harness
  12. #
  13. # Intermediate objects go to build/ (mirroring the source paths). The images
  14. # and the artifacts the dev workflow uses (kernel.elf, kernel.bin, floppy.img,
  15. # usb.img, usb-efi.img, BOOTX64.EFI, cmds.pack, browser.elf, ...) stay at the
  16. # top level, so every make target and command line works as before.
  17. CC = gcc
  18. AS = as
  19. LD = ld
  20. OBJCOPY = objcopy
  21. B = build
  22. # -march=i586: first-gen Pentium (P5); avoids CMOV etc. (P6+)
  23. CFLAGS = -ffreestanding -fno-pie -m32 -march=i586 -nostdlib -fno-stack-protector \
  24. -fno-asynchronous-unwind-tables -mno-sse -mno-sse2 -mno-mmx \
  25. -Wall -Wextra -O2 -c
  26. # Ring-3 objects are compiled with function sections so the browser link can
  27. # drop code it never reaches; the legacy rootfs pack is close to its cap.
  28. SECTION_CFLAGS = -ffunction-sections -fdata-sections
  29. # Header dependencies are generated by the compiler (build/**/*.d).
  30. DEPFLAGS = -MMD -MP
  31. ASFLAGS = --32
  32. # NOWM=1 builds a diagnostic kernel that boots to the console without the
  33. # window manager (make nowm).
  34. NOWM ?= 0
  35. ifeq ($(NOWM),1)
  36. CFLAGS += -DNOWM
  37. endif
  38. # Include paths. The kernel sees only its own headers plus the shared ABI and
  39. # common code; ring-3 code sees the user libraries. Quoted includes of a
  40. # file's own directory need no -I (e.g. an app's private headers).
  41. USER_LIB_DIRS = $(sort $(dir $(wildcard user/lib/*/)))
  42. USER_LIB_DIRS := $(filter-out user/lib/libc/,$(USER_LIB_DIRS))
  43. KERNEL_INC = -Iinclude -Icommon -Ikernel
  44. USER_INC = -Iinclude -Icommon -Iuser $(patsubst %/,-I%,$(USER_LIB_DIRS))
  45. LIBC_INC = -Iuser/lib/libc/include
  46. # QuickJS (third_party/quickjs, see its VENDOR file) is the browser's
  47. # JavaScript engine. -nostdinc keeps host headers from leaking into the
  48. # freestanding build; __nebos__ selects the local patches.
  49. QJS_DIR = third_party/quickjs
  50. QJS_CFLAGS = $(CFLAGS) -O1 $(SECTION_CFLAGS) -nostdinc $(LIBC_INC) \
  51. -I$(QJS_DIR) -fno-builtin -w -D__nebos__ -U__linux__ \
  52. -U__gnu_linux__ -U__unix__ -U__GLIBC__ -DNDEBUG \
  53. -DCONFIG_VERSION='"2026-06-04"'
  54. QJS_OBJS = $(addprefix $(B)/$(QJS_DIR)/,quickjs.o cutils.o dtoa.o \
  55. libregexp.o libunicode.o)
  56. # UEFI loader: a PE32+ x86-64 EFI application built with the mingw toolchain.
  57. # The kernel itself stays 32-bit; the loader leaves long mode before jumping.
  58. EFI_CC ?= x86_64-w64-mingw32-gcc
  59. EFI_AS ?= x86_64-w64-mingw32-as
  60. EFI_CFLAGS = -ffreestanding -fno-stack-protector -mno-red-zone -fno-builtin \
  61. -fno-asynchronous-unwind-tables -fno-unwind-tables -O2 \
  62. -Wall -Wextra -Iinclude -Ikernel -Iboot/efi -I$(B)/boot/efi
  63. EFI_LDFLAGS = -nostdlib -Wl,--subsystem,10 -Wl,-e,efi_main \
  64. -Wl,--image-base,0x0 -Wl,--dynamicbase \
  65. -Wl,--enable-reloc-section -Wl,--no-insert-timestamp
  66. .PHONY: all clean run run-smp run-floppy run-usb run-uhci run-ehci run-ehci-asix run-xhci run-xhci-asix run-net run-rndis run-e1000 run-ahci run-amd test-amd test-usb test-install run-serial floppy usb uefi run-uefi test-uefi flash dev net-dev net-install cmds-dev net-cmds browser-dev gallery-dev compat-serve netmon monitor test-crypto test-wpa test-ccmp test-images test-images-asan test-libc test-js test-font test-font-asan test-svg test-touchpad test-chat test-chat-e2e test-wifi-store test-cursors fonts kernel-dev kernel-net-dev rootfs nowm
  67. all: floppy.img usb.img final.bin root.img image.bin
  68. # ---- Generic compile rules -------------------------------------------------
  69. #
  70. # Per-object variations are target-specific variables on the .o:
  71. # OPT optimisation override appended after CFLAGS' -O2 (-Os, -Oz)
  72. # XFLAGS extra flags (function sections, libc headers, -fwrapv, ...)
  73. $(B)/kernel/%.o: kernel/%.c
  74. @mkdir -p $(@D)
  75. $(CC) $(CFLAGS) $(OPT) $(XFLAGS) $(KERNEL_INC) $(DEPFLAGS) -o $@ $<
  76. $(B)/common/%.o: common/%.c
  77. @mkdir -p $(@D)
  78. $(CC) $(CFLAGS) $(SECTION_CFLAGS) -Icommon $(DEPFLAGS) -o $@ $<
  79. # Ring-3 C: by default the libc headers are visible (the old ucmd_%.o rule);
  80. # objects that were always built freestanding clear XFLAGS below.
  81. $(B)/user/%.o: XFLAGS = $(LIBC_INC)
  82. $(B)/user/%.o: user/%.c
  83. @mkdir -p $(@D)
  84. $(CC) $(CFLAGS) $(OPT) $(XFLAGS) $(USER_INC) $(DEPFLAGS) -o $@ $<
  85. $(B)/%.o: %.S
  86. @mkdir -p $(@D)
  87. $(AS) $(ASFLAGS) -I$(<D) -o $@ $<
  88. $(B)/$(QJS_DIR)/%.o: $(QJS_DIR)/%.c
  89. @mkdir -p $(@D)
  90. $(CC) $(QJS_CFLAGS) $(DEPFLAGS) -o $@ $<
  91. # ---- Kernel ----------------------------------------------------------------
  92. # Link order is part of the image layout: keep it stable. vesa_stage comes
  93. # from boot/ (it is the 0x7E00 entry), font_8x16/inflate from common/.
  94. KERNEL_LINK_ORDER = vesa_stage entry kernel timer switch sched process mm \
  95. kmalloc paging elf tss syscall sys_wm syscall_stub screen io tty rtc \
  96. terminal wm reboot poweroff disk fat serial serial_ring_buf serial_loop \
  97. vga blit cpu thermal it87 tpec ec cros_ec power_src power vga_copy \
  98. gfxbench gpu backlight ati cirrus intel nvidia nv50 radeon mtrr \
  99. font_8x8 font_8x16 fbtext gfx display cursor mouse i2c touchpad \
  100. touchpad_gesture uhci ohci ehci xhci asix rndis iwl_trans iwl_mvm \
  101. iwl_dvm wifi_fw rtl8821au wifi ccmp usb usbmsc usbhid lsusb panic \
  102. bootcon blkdev sdhci ata ahci fatdetect fatformat format install vfs \
  103. sys_fs sys_info sys_mem sys_net idle kexec kexec_tramp dbg lspci peek \
  104. ne2000 r8168 e1000e netdev net netcore netkexec netlog dhcp dns ntp tcp \
  105. acpi ioapic lapic smp ap_tramp_embed inflate ramfs share payload
  106. kobj = $(if $(filter vesa_stage,$(1)),$(B)/boot/$(1).o,$(if $(filter \
  107. font_8x16 inflate,$(1)),$(B)/common/$(1).o,$(B)/kernel/$(1).o))
  108. KERNEL_OBJS = $(foreach n,$(KERNEL_LINK_ORDER),$(call kobj,$(n)))
  109. KERNEL_OS = terminal disk fat nvidia nv50 uhci ohci ehci xhci asix rndis \
  110. iwl_trans iwl_mvm iwl_dvm wifi_fw rtl8821au wifi ccmp usb lsusb lspci \
  111. peek ne2000 r8168 blkdev fatdetect fatformat format install usbmsc dbg vfs
  112. $(addprefix $(B)/kernel/,$(addsuffix .o,$(KERNEL_OS))): OPT = -Os
  113. $(B)/kernel/e1000e.o: OPT = -Oz
  114. # The AP trampoline is linked at 0x6000 and embedded as a binary blob; ld
  115. # names its symbols after the input path, so run it inside the build dir
  116. # (smp.c expects _binary_ap_tramp_bin_start).
  117. $(B)/kernel/ap_tramp.elf: $(B)/kernel/ap_tramp.o kernel/ap_tramp.ld
  118. $(LD) -T kernel/ap_tramp.ld -nostdlib -m elf_i386 -o $@ $<
  119. $(B)/kernel/ap_tramp.bin: $(B)/kernel/ap_tramp.elf
  120. $(OBJCOPY) -O binary $< $@
  121. $(B)/kernel/ap_tramp_embed.o: $(B)/kernel/ap_tramp.bin
  122. cd $(B)/kernel && $(LD) -m elf_i386 -r -b binary -o ap_tramp_embed.o ap_tramp.bin
  123. kernel.elf: kernel/kernel.ld $(KERNEL_OBJS)
  124. $(LD) -T kernel/kernel.ld -nostdlib -m elf_i386 -o $@ $(KERNEL_OBJS)
  125. kernel.bin: kernel.elf
  126. $(OBJCOPY) -O binary $< $@
  127. # ---- Boot sector and MBR ---------------------------------------------------
  128. $(B)/boot/boot.elf: $(B)/boot/boot.o boot/linker.ld
  129. $(LD) -T boot/linker.ld -nostdlib -m elf_i386 -o $@ $<
  130. $(B)/boot/mbr.elf: $(B)/boot/mbr.o boot/mbr.ld
  131. $(LD) -T boot/mbr.ld -nostdlib -m elf_i386 -o $@ $<
  132. mbr.bin: $(B)/boot/mbr.elf
  133. $(OBJCOPY) -O binary $< $@
  134. boot.bin: $(B)/boot/boot.elf
  135. $(OBJCOPY) -O binary --only-section=.boot $< $@.tmp
  136. dd if=$@.tmp of=$@ bs=1 count=510 2>/dev/null
  137. printf '\x55\xaa' >> $@
  138. rm -f $@.tmp
  139. # Byte offsets inside boot.bin (see boot.S). Keep decimal: dd's seek= does not
  140. # parse 0x… literals (it silently treats them as 0) and the error is hidden by
  141. # the 2>/dev/null below.
  142. # 62 = kernel_sectors field (0x3E)
  143. # 64 = kernel_lba field (0x40, word; LBA 64 fits in the low byte)
  144. # 66 = pack_lba field (0x42, dword; rootfs image LBA)
  145. KERNEL_SECTORS_OFFSET = 62
  146. BOOT_SECTOR_START_OFFSET = 64
  147. PACK_LBA_OFFSET = 66
  148. # USB rootfs partition (type 0x7F) and UEFI ESP (type 0xEF). Partition 1
  149. # has room for a 512 KB kernel; the rootfs starts after it at LBA 1088.
  150. # The header and the 242 KB gzip pack are still inside the first 1.44 MB.
  151. ROOTFS_LBA = 1088
  152. ROOTFS_SECTORS = 16384
  153. ESP_LBA = 18432
  154. # Patch a little-endian 16/32-bit value into a boot-sector copy. Usage:
  155. # $(call patch16,file,offset,value)
  156. # (shell snippets are inlined below because make functions cannot easily
  157. # expand `$$(...)` arithmetic; the helpers keep the rules readable.)
  158. patch32 = printf "$$(printf '\\x%02x\\x%02x\\x%02x\\x%02x' \
  159. $$(( ( ($(2)) >> 0) & 0xFF )) $$(( ( ($(2)) >> 8) & 0xFF )) \
  160. $$(( ( ($(2)) >> 16) & 0xFF )) $$(( ( ($(2)) >> 24) & 0xFF )))" | \
  161. dd of=$(1) bs=1 seek=$(3) conv=notrunc 2>/dev/null
  162. patch16 = printf "$$(printf '\\x%02x\\x%02x' \
  163. $$(( ( ($(2)) >> 0) & 0xFF )) $$(( ( ($(2)) >> 8) & 0xFF )))" | \
  164. dd of=$(1) bs=1 seek=$(3) conv=notrunc 2>/dev/null
  165. floppy.img: boot.bin kernel.bin rootfs.bin
  166. SECTORS=$$(( ($$(stat -c%s kernel.bin) + 511) / 512 )); \
  167. cp boot.bin $@.boot.tmp; \
  168. $(call patch16,$@.boot.tmp,$$SECTORS,$(KERNEL_SECTORS_OFFSET)); \
  169. $(call patch32,$@.boot.tmp,1 + SECTORS,$(PACK_LBA_OFFSET)); \
  170. cat $@.boot.tmp kernel.bin > $@; \
  171. PAD=$$(( SECTORS * 512 - $$(stat -c%s kernel.bin) )); \
  172. dd if=/dev/zero bs=1 count=$$PAD 2>/dev/null >> $@; \
  173. cat rootfs.bin >> $@; \
  174. SIZE=$$(stat -c%s $@); \
  175. if [ $$SIZE -gt 1474560 ]; then \
  176. echo "error: floppy.img is $$SIZE bytes; max is 1474560"; \
  177. rm -f $@; exit 1; \
  178. fi; \
  179. truncate -s 1474560 $@; \
  180. rm -f $@.boot.tmp
  181. usb.img: mbr.bin boot.bin kernel.bin cmds.img
  182. SECTORS=$$(( ($$(stat -c%s kernel.bin) + 511) / 512 )); \
  183. cp boot.bin $@.boot.tmp; \
  184. $(call patch16,$@.boot.tmp,$$SECTORS,$(KERNEL_SECTORS_OFFSET)); \
  185. printf '\x40' | dd of=$@.boot.tmp bs=1 seek=$(BOOT_SECTOR_START_OFFSET) conv=notrunc 2>/dev/null; \
  186. $(call patch32,$@.boot.tmp,$(ROOTFS_LBA),$(PACK_LBA_OFFSET)); \
  187. cat mbr.bin > $@; \
  188. dd if=/dev/zero bs=512 count=62 2>/dev/null >> $@; \
  189. cat $@.boot.tmp kernel.bin >> $@; \
  190. truncate -s 9M $@; \
  191. dd if=cmds.img of=$@ bs=512 seek=$(ROOTFS_LBA) conv=notrunc 2>/dev/null; \
  192. printf '\x00\x11\x12\x00\x7f\x16\x15\x01\x40\x04\x00\x00\x00\x40\x00\x00' | \
  193. dd of=$@ bs=1 seek=462 conv=notrunc 2>/dev/null; \
  194. rm -f $@.boot.tmp
  195. image.bin: floppy.img
  196. cp floppy.img image.bin
  197. final.bin: boot.bin kernel.bin rootfs.bin
  198. SECTORS=$$(( ($$(stat -c%s kernel.bin) + 511) / 512 )); \
  199. cp boot.bin $@.boot.tmp; \
  200. $(call patch16,$@.boot.tmp,$$SECTORS,$(KERNEL_SECTORS_OFFSET)); \
  201. $(call patch32,$@.boot.tmp,1 + SECTORS,$(PACK_LBA_OFFSET)); \
  202. cat $@.boot.tmp kernel.bin > $@; \
  203. PAD=$$(( SECTORS * 512 - $$(stat -c%s kernel.bin) )); \
  204. dd if=/dev/zero bs=1 count=$$PAD 2>/dev/null >> $@; \
  205. cat rootfs.bin >> $@; \
  206. rm -f $@.boot.tmp
  207. # ---- UEFI loader and dual-boot USB image -------------------------------
  208. #
  209. # The legacy image (usb.img) is left byte-for-byte alone. usb-efi.img copies
  210. # it, adds a third MBR partition (type 0xEF, starting at the old 64 MB end)
  211. # and writes a small FAT16 ESP there. BIOS booting still uses the active
  212. # partition 1 at LBA 63; UEFI finds BOOTX64.EFI in the ESP.
  213. $(B)/boot/efi/efi_entry.h: kernel.elf
  214. @mkdir -p $(@D)
  215. @entry=$$(nm kernel.elf | awk '/ T kernel_entry$$/{print $$1}'); \
  216. if [ -z "$$entry" ]; then echo "efi: kernel_entry not found" >&2; exit 1; fi; \
  217. printf '#define KERNEL_ENTRY 0x%s\n' "$$entry" > $@
  218. $(B)/boot/efi/main.o: boot/efi/main.c $(B)/boot/efi/efi_entry.h
  219. @mkdir -p $(@D)
  220. $(EFI_CC) $(EFI_CFLAGS) $(DEPFLAGS) -c -o $@ $<
  221. # payload.S embeds kernel.bin and cmds_pack_gz.bin (top level) and tramp.bin.
  222. $(B)/boot/efi/payload.o: boot/efi/payload.S kernel.bin cmds_pack_gz.bin $(B)/boot/efi/tramp.bin
  223. $(EFI_AS) --64 -I$(B)/boot/efi -o $@ $<
  224. $(B)/boot/efi/tramp.o: boot/efi/tramp.S
  225. @mkdir -p $(@D)
  226. $(AS) --64 -o $@ $<
  227. $(B)/boot/efi/tramp.elf: $(B)/boot/efi/tramp.o boot/efi/tramp.ld
  228. $(LD) -T boot/efi/tramp.ld -nostdlib -m elf_x86_64 -o $@ $<
  229. $(B)/boot/efi/tramp.bin: $(B)/boot/efi/tramp.elf
  230. $(OBJCOPY) -O binary $< $@
  231. BOOTX64.EFI: $(B)/boot/efi/main.o $(B)/boot/efi/payload.o
  232. $(EFI_CC) $(EFI_LDFLAGS) -o $@ $^
  233. ESP_SECTORS = 16384
  234. esp.img: BOOTX64.EFI
  235. truncate -s $$(( $(ESP_SECTORS) * 512 )) $@
  236. mkfs.fat -F 16 -s 2 -n NEBOSESP $@
  237. mmd -i $@ ::/EFI
  238. mmd -i $@ ::/EFI/BOOT
  239. mcopy -i $@ BOOTX64.EFI ::/EFI/BOOT/BOOTX64.EFI
  240. usb-efi.img: usb.img esp.img
  241. cp usb.img $@
  242. # The legacy partition is a raw kernel blob with a deliberately empty
  243. # BPB (boot.S), so neither UEFI firmware nor VFS mistakes it for FAT.
  244. # Partition 3: ESP at LBA 18432, type 0xEF, 8 MB (partition 2 is the
  245. # rootfs at LBA 1088 written by usb.img).
  246. printf '\x00\xfe\xff\xff\xef\xfe\xff\xff\x00\x48\x00\x00\x00\x40\x00\x00' | \
  247. dd of=$@ bs=1 seek=478 conv=notrunc 2>/dev/null
  248. dd if=esp.img of=$@ bs=512 seek=$(ESP_LBA) conv=notrunc 2>/dev/null
  249. truncate -s $$(( ($(ESP_LBA) + $(ESP_SECTORS)) * 512 )) $@
  250. uefi: usb-efi.img
  251. # ---- Ring-3 libraries ------------------------------------------------------
  252. U = $(B)/user
  253. UL = $(B)/user/lib
  254. # libc: a static archive linked only into commands that use it. The archive
  255. # means apps that never reference malloc/string keep paying nothing, and
  256. # --gc-sections drops unused functions from the members that are pulled.
  257. LIBC_OBJS = $(addprefix $(UL)/libc/,malloc.o string.o strdup.o stdlib.o \
  258. ucmd_mem.o setjmp.o errno.o div64.o dtoa.o stdio.o \
  259. stdio_file.o math.o time.o)
  260. LIBC_A = $(UL)/libc/libc.a
  261. $(filter-out %/setjmp.o,$(LIBC_OBJS)): OPT = -Os
  262. $(filter-out %/setjmp.o,$(LIBC_OBJS)): XFLAGS = $(SECTION_CFLAGS) -fno-builtin $(LIBC_INC)
  263. $(LIBC_A): $(LIBC_OBJS)
  264. rm -f $@
  265. ar rcs $@ $^
  266. # 8x16 bitmap font and DEFLATE: shared with the kernel (common/).
  267. FONT16 = $(B)/common/font_8x16.o
  268. INFLATE = $(B)/common/inflate.o
  269. # Fixed-point TrueType text engine, linked only into GUI commands.
  270. UFONT_OBJS = $(addprefix $(UL)/ufont/,ufont.o ufont_ttf.o ufont_draw.o ufont_file.o)
  271. $(UFONT_OBJS): OPT = -Os
  272. $(UFONT_OBJS): XFLAGS = $(SECTION_CFLAGS) $(LIBC_INC)
  273. $(UL)/ufont/ufont_ttf.o: OPT = -O2
  274. # WOFF 1.0 unwrapping needs inflate, so only the browser links it.
  275. UFONT_WOFF = $(UL)/ufont/ufont_woff.o
  276. $(UFONT_WOFF): OPT = -Os
  277. $(UFONT_WOFF): XFLAGS = $(SECTION_CFLAGS) $(LIBC_INC)
  278. # ngui: the userland immediate-mode GUI toolkit. -Os: every GUI app links
  279. # the whole toolkit, and the rootfs pack has a cap.
  280. NGUI = $(UL)/ngui/ngui.o
  281. $(NGUI): OPT = -Os
  282. $(NGUI): XFLAGS = $(SECTION_CFLAGS) $(LIBC_INC)
  283. NGUI_APP = $(NGUI) $(FONT16) $(UFONT_OBJS)
  284. # Window-manager/terminal drawing helpers (wm and term).
  285. UWM = $(UL)/uwm/uwm_lib.o
  286. $(UWM): OPT = -Os
  287. $(UWM): XFLAGS = $(SECTION_CFLAGS) $(LIBC_INC)
  288. # Image library: pure freestanding decoders + RGB565 compositing.
  289. IMGLIB_OBJS = $(addprefix $(UL)/img/,img.o img_mem.o img_blit.o img_png.o \
  290. img_bmp.o img_gif.o img_jpeg.o img_tga.o img_pnm.o img_ico.o \
  291. img_pam.o img_gif_anim.o img_file.o)
  292. IMG_DECODE_OBJS = $(addprefix $(UL)/img/,img.o img_mem.o img_blit.o img_png.o \
  293. img_bmp.o img_gif.o img_jpeg.o img_tga.o img_pnm.o img_ico.o \
  294. img_pam.o)
  295. $(IMGLIB_OBJS): XFLAGS = $(SECTION_CFLAGS)
  296. # The integer IDCT deliberately relies on 32-bit wrap-around.
  297. $(UL)/img/img_jpeg.o: XFLAGS = $(SECTION_CFLAGS) -fwrapv
  298. # TLS 1.3/1.2 client library (curl, chat and the browser; see tls.h). The
  299. # crypto files are pure freestanding C, so tls_test exercises them on the
  300. # host (make test-crypto). TLS 1.2 adds AES-128-GCM (on wpa_crypto.c's AES)
  301. # and P-256 ECDH.
  302. TLSLIB_OBJS = $(addprefix $(UL)/tls/,tls_sha256.o tls_chacha20.o tls_x25519.o \
  303. tls_gcm.o tls_p256.o wpa_crypto.o tls_rng.o tls.o)
  304. $(TLSLIB_OBJS): XFLAGS = $(SECTION_CFLAGS)
  305. $(UL)/tls/wpa_crypto.o: OPT = -O2
  306. # Shared HTTP/TLS client (curl, the browser and chat), its cookie jar and the
  307. # JSON parser. The jar and the parser have host tests (make test-chat).
  308. UHTTP_OBJS = $(UL)/uhttp/uhttp.o $(UL)/uhttp/uhttp_cookie.o
  309. UJSON = $(UL)/ujson/ujson.o
  310. $(UHTTP_OBJS) $(UJSON): XFLAGS = $(SECTION_CFLAGS)
  311. $(UL)/uhttp/uhttp_cookie.o $(UJSON): OPT = -Os
  312. # WiFi saved-network list (wifi, netmenu) and the WPA2-PSK supplicant.
  313. WIFI_STORE = $(UL)/wifi/wifi_store.o
  314. WPA_OBJS = $(UL)/wifi/wpa.o $(UL)/tls/wpa_crypto.o
  315. $(UL)/wifi/wpa.o: OPT = -Os
  316. $(UL)/wifi/wpa.o: XFLAGS = $(SECTION_CFLAGS)
  317. # ---- Ring-3 programs -------------------------------------------------------
  318. #
  319. # Every program lives in user/apps/<name>/ with its entry file ucmd_<name>.c
  320. # and is packed as bin/<name>. New command: create user/apps/<name>/
  321. # ucmd_<name>.c and add <name> to UCMDS (the order is the pack order). A
  322. # single-file command needs nothing else; one that links libraries gets an
  323. # explicit .elf rule below.
  324. UCMDS = cpuinfo ls cat save rm mkdir rmdir \
  325. meminfo mouseinfo storage top process bootscan \
  326. clock colors edit wm term spin \
  327. netinfo netip netdns host dhcp \
  328. netsend netrecv ping pong netlog \
  329. netconsole netregs netloop netreset net100 netmac curl \
  330. files view sensors powerinfo mines solitaire \
  331. settime date gallery websrv browser chat \
  332. wifi netmenu disks membench
  333. app = $(U)/apps/$(1)/ucmd_$(1)
  334. UCMD_ELFS = $(foreach a,$(UCMDS),$(call app,$(a)).elf)
  335. .PRECIOUS: $(UCMD_ELFS)
  336. UCMD_LD = user/ucmd.ld
  337. # Link a ring-3 ELF at USER_BASE, dropping unreferenced sections.
  338. ULINK = $(LD) -T $(UCMD_LD) -z max-page-size=0x100 --gc-sections -nostdlib \
  339. -m elf_i386 -o $@ $(filter-out $(UCMD_LD),$^) && \
  340. $(OBJCOPY) --strip-all $@ $@
  341. # Single-file commands: no libc, no section GC.
  342. $(U)/apps/%.elf: $(U)/apps/%.o $(UCMD_LD)
  343. $(LD) -T $(UCMD_LD) -z max-page-size=0x100 -nostdlib -m elf_i386 -o $@ $<
  344. $(OBJCOPY) --strip-all $@ $@
  345. # Objects that were always compiled without the libc headers.
  346. $(call app,edit).o $(call app,wm).o $(call app,files).o $(call app,mines).o \
  347. $(call app,settime).o $(call app,solitaire).o $(U)/apps/gallery/gallery.o \
  348. $(U)/apps/hello/hello.o: XFLAGS =
  349. $(call app,settime).o $(call app,solitaire).o: OPT = -Os
  350. # Both link with --gc-sections; the section-per-function build lets the pack
  351. # drop their unreachable helpers (the rootfs cap is tight).
  352. $(call app,wm).o: XFLAGS = $(SECTION_CFLAGS)
  353. $(call app,view).o: XFLAGS = $(SECTION_CFLAGS) $(LIBC_INC)
  354. $(call app,wm).o $(call app,view).o: OPT = -Os
  355. # membench times memcpy/memset over a libc heap buffer.
  356. $(call app,membench).elf: $(call app,membench).o $(UCMD_LD) $(LIBC_A)
  357. $(ULINK)
  358. # websrv buffers its whole PUT/GET body on the libc heap.
  359. $(call app,websrv).elf: $(call app,websrv).o $(UCMD_LD) $(LIBC_A)
  360. $(ULINK)
  361. # edit draws text itself, so it links the 8x16 font into its ELF.
  362. $(call app,edit).elf: $(call app,edit).o $(FONT16) $(UCMD_LD)
  363. $(LD) -T $(UCMD_LD) -z max-page-size=0x100 -nostdlib -m elf_i386 -o $@ $(filter %.o,$^)
  364. $(OBJCOPY) --strip-all $@ $@
  365. # The ring-3 WM draws its own chrome; term renders its own cells. term also
  366. # reads the kernel's key codes (io.h) and VFS_PATH_MAX (vfs.h).
  367. $(call app,term).o: XFLAGS = $(LIBC_INC) -Ikernel
  368. $(call app,wm).elf: $(call app,wm).o $(UWM) $(FONT16) $(UFONT_OBJS) $(UCMD_LD) $(LIBC_A)
  369. $(ULINK)
  370. $(call app,term).elf: $(call app,term).o $(UWM) $(FONT16) $(UFONT_OBJS) $(UCMD_LD) $(LIBC_A)
  371. $(ULINK)
  372. # ngui canvas apps.
  373. $(call app,files).elf: $(call app,files).o $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  374. $(ULINK)
  375. # Task manager: process table with CPU, memory and network history graphs.
  376. $(call app,process).elf: $(call app,process).o $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  377. $(ULINK)
  378. # Boot scan window: live tail of the bootscan kernel thread's serial output.
  379. $(call app,bootscan).elf: $(call app,bootscan).o $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  380. $(ULINK)
  381. $(call app,bootscan).o: OPT = -Os
  382. $(call app,mines).elf: $(call app,mines).o $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  383. $(ULINK)
  384. $(call app,settime).elf: $(call app,settime).o $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  385. $(ULINK)
  386. $(call app,solitaire).elf: $(call app,solitaire).o $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  387. $(ULINK)
  388. $(call app,view).elf: $(call app,view).o $(IMGLIB_OBJS) $(INFLATE) $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  389. $(ULINK)
  390. $(call app,curl).elf: $(call app,curl).o $(UHTTP_OBJS) $(IMG_DECODE_OBJS) $(INFLATE) $(TLSLIB_OBJS) $(UCMD_LD) $(LIBC_A)
  391. $(ULINK)
  392. $(call app,wifi).elf: $(call app,wifi).o $(WIFI_STORE) $(WPA_OBJS) $(UL)/tls/tls_rng.o $(UL)/tls/tls_sha256.o $(UCMD_LD) $(LIBC_A)
  393. $(ULINK)
  394. # Control panel: NIC list, WiFi scan, saved networks, power and date/time.
  395. $(call app,netmenu).elf: $(call app,netmenu).o $(WIFI_STORE) $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  396. $(ULINK)
  397. # Storage manager: devices, partitions, mount policies, format/install.
  398. $(call app,disks).elf: $(call app,disks).o $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  399. $(ULINK)
  400. # chat: native Cloudron Chat client (ngui + uhttp/TLS + cookie jar + JSON +
  401. # the native OIDC login driver).
  402. CHAT_LOGIN = $(U)/apps/chat/chat_login.o
  403. $(CHAT_LOGIN): OPT = -Os
  404. $(CHAT_LOGIN): XFLAGS = $(SECTION_CFLAGS)
  405. $(call app,chat).o: OPT = -Os
  406. $(call app,chat).o: XFLAGS = $(SECTION_CFLAGS) $(LIBC_INC)
  407. $(call app,chat).elf: $(call app,chat).o $(CHAT_LOGIN) $(UJSON) $(UHTTP_OBJS) $(NGUI_APP) $(IMG_DECODE_OBJS) $(INFLATE) $(TLSLIB_OBJS) $(UCMD_LD) $(LIBC_A)
  408. $(ULINK)
  409. # gallery: a live showcase of every ngui widget and primitive. The real ELF
  410. # ships in the rootfs pack as bin/gallery.app; ucmd_gallery.c (in UCMDS) is
  411. # the tiny PATH launcher (which also accepts /share/GALLERY).
  412. gallery.elf: $(U)/apps/gallery/gallery.o $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  413. $(ULINK)
  414. # browser: the real app ships as bin/browser.app in the full pack (and
  415. # BROWSER on root.img, which floppy boots use)
  416. # because it links ngui, the image library, TLS, uhttp and QuickJS;
  417. # ucmd_browser.c is the tiny PATH launcher. Compiled with function sections
  418. # and linked with --gc-sections: unreachable image, TLS and UI paths are
  419. # dropped.
  420. BR = $(U)/apps/browser
  421. BROWSER_OBJS = $(BR)/browser.o $(BR)/browser_html.o $(BR)/svg_raster.o \
  422. $(BR)/js_browser.o $(BR)/js_mu.o
  423. $(BROWSER_OBJS): OPT = -Os
  424. $(BROWSER_OBJS): XFLAGS = $(SECTION_CFLAGS) $(LIBC_INC)
  425. $(BR)/browser_html.o: XFLAGS = $(SECTION_CFLAGS)
  426. $(BR)/js_mu.o: XFLAGS = $(SECTION_CFLAGS) -Wno-unused-parameter $(LIBC_INC) -I$(QJS_DIR)
  427. browser.elf: $(BR)/browser.o $(BR)/browser_html.o $(BR)/svg_raster.o $(BR)/js_browser.o $(BR)/js_prelude.o $(UHTTP_OBJS) $(NGUI_APP) $(UFONT_WOFF) $(IMGLIB_OBJS) $(INFLATE) $(TLSLIB_OBJS) $(BR)/js_mu.o $(QJS_OBJS) $(UCMD_LD) $(LIBC_A)
  428. $(ULINK)
  429. # hello: the first ring-3 test program (its own linker script).
  430. $(U)/apps/hello/hello.elf: $(U)/apps/hello/hello.o user/apps/hello/hello.ld
  431. $(LD) -T user/apps/hello/hello.ld -nostdlib -m elf_i386 -o $@ $<
  432. $(OBJCOPY) --strip-all $@ $@
  433. # ---- Linux host browser harness (browser-host / host-curl) -------------------
  434. #
  435. # The browser talks to the same small SYS_* ABI as on NebOS; host/syscall.c
  436. # implements it with Linux files, BSD sockets, fork/exec and an SDL3 window.
  437. # The target images and browser.elf are not involved. Build 32-bit so the
  438. # pointer-through-int syscall ABI and the ring-3 allocator behave like the
  439. # board. SDL3 is only a development dependency for the window backend.
  440. HOST_CC ?= gcc
  441. HOST_BUILD = host/build
  442. HOST_CFLAGS = -m32 -O1 -g -Wall -Wextra -Wno-unused-parameter \
  443. -Wno-sign-compare -Wno-unused-function -Wno-format-truncation \
  444. -fno-strict-aliasing -fno-omit-frame-pointer $(USER_INC) \
  445. -Ihost/include -Ithird_party/quickjs -I/usr/include/SDL3 \
  446. -DUCMD_HOST -DJS_MU_HOST -D__nebos__ -D_GNU_SOURCE \
  447. -DCONFIG_VERSION='"2026-06-04"'
  448. # The ring-3 allocator is reused on the host: rename its entry points so
  449. # glibc and SDL keep their own malloc. libc/malloc.c and every app object
  450. # must use the same set.
  451. HOST_APP_MALLOC_DEFS = -Dmalloc=libc_malloc -Dfree=libc_free \
  452. -Dcalloc=libc_calloc -Drealloc=libc_realloc \
  453. -Dmalloc_usable_size=libc_malloc_usable_size \
  454. -Dheap_reset=libc_heap_reset
  455. HOST_APP_CFLAGS = $(HOST_CFLAGS) $(HOST_APP_MALLOC_DEFS)
  456. HOST_LDFLAGS = -m32 -no-pie -L/usr/lib32
  457. HOST_LDLIBS = -lSDL3 -lm -lpthread -ldl
  458. HOST_IMGLIB_SRCS = $(addprefix user/lib/img/,img.c img_mem.c img_blit.c \
  459. img_png.c img_bmp.c img_gif.c img_jpeg.c img_tga.c img_pnm.c \
  460. img_ico.c img_pam.c img_gif_anim.c img_file.c)
  461. HOST_TLS_SRCS = $(addprefix user/lib/tls/,tls_sha256.c tls_chacha20.c \
  462. tls_x25519.c tls_gcm.c tls_p256.c wpa_crypto.c tls_rng.c tls.c)
  463. HOST_QUERY_SRCS = $(addprefix $(QJS_DIR)/,quickjs.c cutils.c dtoa.c \
  464. libregexp.c libunicode.c)
  465. HOST_UHTTP_SRCS = user/lib/uhttp/uhttp.c user/lib/uhttp/uhttp_cookie.c
  466. HOST_BROWSER_APP_SRCS = $(addprefix user/apps/browser/,browser.c \
  467. browser_html.c svg_raster.c js_browser.c) \
  468. $(HOST_UHTTP_SRCS) user/lib/ngui/ngui.c \
  469. common/font_8x16.c \
  470. $(addprefix user/lib/ufont/,ufont.c ufont_ttf.c \
  471. ufont_draw.c ufont_file.c ufont_woff.c) \
  472. $(HOST_IMGLIB_SRCS) common/inflate.c $(HOST_TLS_SRCS) \
  473. user/apps/browser/js_mu.c user/lib/libc/malloc.c \
  474. $(HOST_QUERY_SRCS)
  475. HOST_CURL_APP_SRCS = user/apps/curl/ucmd_curl.c $(HOST_UHTTP_SRCS) \
  476. $(HOST_IMGLIB_SRCS) common/inflate.c $(HOST_TLS_SRCS) \
  477. user/lib/libc/malloc.c
  478. HOST_COMMON_SRCS = host/host.c host/syscall.c host/fs.c host/net.c \
  479. host/proc.c host/heap.c host/window.c \
  480. host/window_sdl3.c host/window_headless.c
  481. HOST_COMMON_OBJS = $(addprefix $(HOST_BUILD)/,$(HOST_COMMON_SRCS:.c=.o))
  482. HOST_BROWSER_APP_OBJS = $(addprefix $(HOST_BUILD)/,$(HOST_BROWSER_APP_SRCS:.c=.o))
  483. HOST_CURL_APP_OBJS = $(addprefix $(HOST_BUILD)/,$(HOST_CURL_APP_SRCS:.c=.o))
  484. HOST_BROWSER_OBJS = $(HOST_BUILD)/host/main.o $(HOST_COMMON_OBJS) \
  485. $(HOST_BROWSER_APP_OBJS) $(HOST_BUILD)/js_prelude.o
  486. HOST_CURL_OBJS = $(HOST_BUILD)/host/curl_main.o $(HOST_COMMON_OBJS) \
  487. $(HOST_CURL_APP_OBJS)
  488. $(HOST_BUILD)/%.o: %.c
  489. @mkdir -p $(dir $@)
  490. $(HOST_CC) $(HOST_APP_CFLAGS) $(HOST_EXTRA) $(DEPFLAGS) -c -o $@ $<
  491. # Host support files use glibc malloc directly, never the renamed arena.
  492. $(HOST_BUILD)/host/%.o: host/%.c
  493. @mkdir -p $(dir $@)
  494. $(HOST_CC) $(HOST_CFLAGS) $(DEPFLAGS) -c -o $@ $<
  495. $(HOST_BUILD)/js_prelude.o: user/apps/browser/js_prelude.S $(BR)/js_prelude.min.js
  496. @mkdir -p $(dir $@)
  497. $(HOST_CC) -m32 -Wa,-I$(BR) -c -o $@ $<
  498. $(HOST_BUILD)/user/apps/browser/browser.o: HOST_EXTRA = -D_start=browser_start
  499. $(HOST_BUILD)/user/apps/curl/ucmd_curl.o: HOST_EXTRA = -D_start=curl_start
  500. browser-host: host-curl $(HOST_BROWSER_OBJS) | icons/adwaita16.icn
  501. $(HOST_CC) $(HOST_LDFLAGS) -o $@ $(filter-out host-curl,$^) $(HOST_LDLIBS)
  502. host-curl: $(HOST_CURL_OBJS)
  503. $(HOST_CC) $(HOST_LDFLAGS) -o $@ $^ $(HOST_LDLIBS)
  504. # ---- Host tests (no kernel needed) -----------------------------------------
  505. UFONT_TEST_SRCS = $(addprefix user/lib/ufont/,ufont_test.c ufont.c ufont_ttf.c ufont_draw.c ufont_woff.c) common/inflate.c
  506. ufont_test: $(UFONT_TEST_SRCS) user/lib/ufont/ufont.h user/lib/ufont/ufont_internal.h fonts/emoji.ttf testdata/fonts/sans.woff
  507. gcc -O2 -Wall -Wextra -Iinclude -Icommon -o $@ $(UFONT_TEST_SRCS)
  508. test-font: ufont_test
  509. ./ufont_test
  510. test-font-asan: $(UFONT_TEST_SRCS) user/lib/ufont/ufont.h user/lib/ufont/ufont_internal.h fonts/emoji.ttf testdata/fonts/sans.woff
  511. gcc -O1 -g -fsanitize=address,undefined -Iinclude -Icommon -o ufont_test_asan $(UFONT_TEST_SRCS)
  512. ./ufont_test_asan
  513. fonts:
  514. tools/subset_fonts.sh
  515. SVG_SRCS = user/apps/browser/svg_test.c user/apps/browser/svg_raster.c
  516. svg_test: $(SVG_SRCS) user/apps/browser/svg_raster.h
  517. gcc -O1 -g -Wall -Wextra -fsanitize=address,undefined -o $@ $(SVG_SRCS) -lm
  518. test-svg: svg_test
  519. ./svg_test
  520. touchpad_gesture_test: kernel/touchpad_gesture_test.c kernel/touchpad_gesture.c kernel/touchpad_gesture.h
  521. gcc -O2 -Wall -Wextra -o $@ kernel/touchpad_gesture_test.c kernel/touchpad_gesture.c
  522. test-touchpad: touchpad_gesture_test
  523. ./touchpad_gesture_test
  524. # Host tests for the chat client's pure modules: JSON, cookie jar and the
  525. # login page/reply/config parsers.
  526. CHAT_TEST_CFLAGS = -O1 -g -Wall -Wextra -fsanitize=address,undefined $(USER_INC)
  527. ujson_test: user/lib/ujson/ujson_test.c user/lib/ujson/ujson.c user/lib/ujson/ujson.h
  528. gcc $(CHAT_TEST_CFLAGS) -o $@ user/lib/ujson/ujson_test.c user/lib/ujson/ujson.c
  529. uhttp_cookie_test: user/lib/uhttp/uhttp_cookie_test.c user/lib/uhttp/uhttp_cookie.c user/lib/uhttp/uhttp_cookie.h
  530. gcc $(CHAT_TEST_CFLAGS) -o $@ user/lib/uhttp/uhttp_cookie_test.c user/lib/uhttp/uhttp_cookie.c
  531. chat_login_test: user/apps/chat/chat_login_test.c user/apps/chat/chat_login.c user/apps/chat/chat_login.h user/lib/ujson/ujson.c
  532. gcc $(CHAT_TEST_CFLAGS) -DCHAT_LOGIN_PURE -o $@ user/apps/chat/chat_login_test.c user/apps/chat/chat_login.c user/lib/ujson/ujson.c
  533. test-chat: ujson_test uhttp_cookie_test chat_login_test
  534. ./ujson_test
  535. ./uhttp_cookie_test
  536. ./chat_login_test
  537. # QEMU end-to-end chat test against tools/mock_chat.py (ports 18080/18081 on
  538. # the host, 10.0.2.2 in the guest). CHAT_E2E=--totp|--consent|--passkey|
  539. # --wrong selects a login variant; screenshots land in chat-test-out/.
  540. CHAT_E2E ?=
  541. test-chat-e2e: floppy.img root.img
  542. python3 tools/qmp_chat_test.py $(CHAT_E2E)
  543. TLS_TEST_SRCS = $(addprefix user/lib/tls/,tls_test.c tls_sha256.c tls_chacha20.c \
  544. tls_x25519.c tls_gcm.c tls_p256.c wpa_crypto.c)
  545. tls_test: $(TLS_TEST_SRCS) $(wildcard user/lib/tls/*.h)
  546. gcc -O2 -o $@ $(TLS_TEST_SRCS)
  547. test-crypto: tls_test
  548. ./tls_test
  549. wpa_test: user/lib/wifi/wpa_test.c user/lib/wifi/wpa.c user/lib/tls/wpa_crypto.c user/lib/wifi/wpa.h user/lib/tls/wpa_crypto.h
  550. gcc -O2 -Wall -Wextra -Iuser/lib/tls -o $@ user/lib/wifi/wpa_test.c user/lib/wifi/wpa.c user/lib/tls/wpa_crypto.c
  551. test-wpa: wpa_test
  552. ./wpa_test
  553. wifi_store_test: user/lib/wifi/wifi_store_test.c user/lib/wifi/wifi_store.c user/lib/wifi/wifi_store.h include/wifi_cfg.h include/syscall.h
  554. gcc -m32 -O2 -Wall -Wextra -Iinclude -Iuser -o $@ user/lib/wifi/wifi_store_test.c
  555. test-wifi-store: wifi_store_test
  556. ./wifi_store_test
  557. ccmp_test: kernel/ccmp_test.c kernel/ccmp.c kernel/ccmp.h
  558. gcc -O2 -Wall -Wextra -o $@ kernel/ccmp_test.c
  559. test-ccmp: ccmp_test
  560. ./ccmp_test
  561. # Host image-library tests. The corpus and expected hashes are committed;
  562. # tools/gen_img_tests.py regenerates them.
  563. IMGTEST_SRCS = $(addprefix user/lib/img/,img_test.c img.c img_mem.c img_blit.c \
  564. img_png.c img_bmp.c img_gif.c img_gif_anim.c img_jpeg.c img_tga.c \
  565. img_pnm.c img_ico.c img_pam.c) common/inflate.c
  566. IMGTEST_DEPS = $(wildcard user/lib/img/*.h) common/inflate.h testdata/images/expected.h
  567. IMGTEST_INC = -I. -Icommon -Iinclude -Iuser
  568. img_test: $(IMGTEST_SRCS) $(IMGTEST_DEPS)
  569. gcc -O2 -fwrapv -Wall -Wextra $(IMGTEST_INC) -o $@ $(IMGTEST_SRCS)
  570. test-images: img_test
  571. ./img_test
  572. test-images-asan: $(IMGTEST_SRCS) $(IMGTEST_DEPS)
  573. # -fwrapv: the integer IDCT deliberately relies on 32-bit wrap-around.
  574. gcc -O1 -g -fwrapv -fsanitize=address,undefined $(IMGTEST_INC) -o img_test_asan $(IMGTEST_SRCS)
  575. ./img_test_asan
  576. # Host tests for the ring-3 libc. The malloc/free names are renamed so the
  577. # host libc (printf, rand, write) keeps working normally.
  578. HOST_MALLOC_DEFS = -Dmalloc=libc_malloc -Dfree=libc_free \
  579. -Dcalloc=libc_calloc -Drealloc=libc_realloc \
  580. -Dheap_reset=libc_heap_reset
  581. LT = $(B)/host-test/libc
  582. LSRC = user/lib/libc
  583. $(LT)/malloc_host.o: $(LSRC)/malloc.c
  584. @mkdir -p $(@D)
  585. gcc -O2 -Wall -Wextra $(LIBC_INC) -fno-builtin $(HOST_MALLOC_DEFS) $(DEPFLAGS) -c -o $@ $<
  586. $(LT)/test_host_mem.o: $(LSRC)/test_host_mem.c
  587. @mkdir -p $(@D)
  588. gcc -O2 -Wall -Wextra $(DEPFLAGS) -c -o $@ $<
  589. malloc_test: $(LSRC)/test_malloc.c $(LT)/malloc_host.o $(LT)/test_host_mem.o
  590. gcc -O2 -Wall -Wextra -o $@ $^
  591. $(LT)/stdio_host.o: $(LSRC)/stdio.c
  592. @mkdir -p $(@D)
  593. gcc -O2 -Wall -Wextra $(LIBC_INC) -fno-builtin $(DEPFLAGS) -c -o $@ $<
  594. $(LT)/dtoa_host.o: $(LSRC)/dtoa.c
  595. @mkdir -p $(@D)
  596. gcc -O2 -Wall -Wextra $(LIBC_INC) -fno-builtin $(DEPFLAGS) -c -o $@ $<
  597. $(LT)/math_host.o: $(LSRC)/math.c
  598. @mkdir -p $(@D)
  599. gcc -O2 -Wall -Wextra $(LIBC_INC) -fno-builtin $(DEPFLAGS) -c -o $@ $<
  600. $(LT)/div64_host.o: $(LSRC)/div64.c
  601. @mkdir -p $(@D)
  602. gcc -O2 -Wall -Wextra $(DEPFLAGS) -c -o $@ $<
  603. format_test: $(LSRC)/test_format.c $(LT)/stdio_host.o $(LT)/dtoa_host.o
  604. gcc -O2 -Wall -Wextra -Wno-format-truncation $(LIBC_INC) -o $@ $^
  605. math_test: $(LSRC)/test_math.c $(LT)/math_host.o
  606. gcc -O2 -Wall -Wextra -o $@ $^ -lm
  607. div64_test: $(LSRC)/test_div64.c $(LT)/div64_host.o
  608. gcc -O2 -Wall -Wextra -o $@ $^
  609. setjmp_test: $(LSRC)/test_setjmp.c $(UL)/libc/setjmp.o
  610. gcc -m32 -O2 -Wall -Wextra $(LIBC_INC) -o $@ $^
  611. test-libc: malloc_test format_test math_test div64_test setjmp_test
  612. ./malloc_test
  613. ./format_test
  614. ./math_test
  615. ./div64_test
  616. ./setjmp_test
  617. QJS_HOST_SRCS = $(addprefix $(QJS_DIR)/,quickjs.c cutils.c dtoa.c libregexp.c libunicode.c)
  618. JS_TEST_SRCS = user/apps/browser/js_test.c user/apps/browser/js_mu.c
  619. js_test: $(JS_TEST_SRCS) user/apps/browser/js_mu.h $(QJS_HOST_SRCS) $(wildcard $(QJS_DIR)/*.h)
  620. gcc -O1 -g -w -fsanitize=address,undefined -fno-sanitize=shift -Iinclude -Iuser -I$(QJS_DIR) -D__nebos__ -DJS_MU_HOST \
  621. -DCONFIG_VERSION='"2026-06-04"' -o $@ $(JS_TEST_SRCS) $(QJS_HOST_SRCS) -lm
  622. test-js: js_test
  623. ./js_test
  624. # ---- Host tools ------------------------------------------------------------
  625. mkpack: tools/mkpack.c
  626. gcc -O2 -o $@ $<
  627. mkrootfs: tools/mkrootfs.c include/rootfs.h
  628. gcc -O2 -Iinclude -o $@ $<
  629. mkrtwtbl: tools/mkrtwtbl.c include/rtl8821a_tbl.h third_party/rtw88/rtw8821a_table.inc
  630. gcc -O2 -Wall -Wextra -I. -Iinclude -o $@ $<
  631. kexec_send: tools/kexec_send.c
  632. gcc -O2 -o $@ $<
  633. netkexec_send: tools/netkexec_send.c
  634. gcc -O2 -o $@ $<
  635. netmonitor: tools/netmonitor.c
  636. gcc -O2 -o $@ $<
  637. mkicons: tools/mkicons.c include/icon_abi.h user/apps/browser/svg_raster.c user/apps/browser/svg_raster.h
  638. gcc -O2 -Wall -Wextra -Iinclude -o $@ tools/mkicons.c user/apps/browser/svg_raster.c -lm
  639. jsstrip: tools/jsstrip.c
  640. gcc -O2 -Wall -Wextra -o $@ $<
  641. # The browser prelude is embedded without its comments and indentation
  642. # (tools/jsstrip.c): ~3.5 KB of gzip in the rootfs pack.
  643. $(BR)/js_prelude.min.js: user/apps/browser/js_prelude.js jsstrip
  644. @mkdir -p $(@D)
  645. ./jsstrip $< $@
  646. $(BR)/js_prelude.o: user/apps/browser/js_prelude.S $(BR)/js_prelude.min.js
  647. @mkdir -p $(@D)
  648. $(AS) $(ASFLAGS) -I$(BR) -o $@ $<
  649. mkcursors: tools/mkcursors.c include/cursor_abi.h
  650. gcc -O2 -Wall -Wextra -Iinclude -o $@ $<
  651. cursor_test: tools/cursor_test.c include/cursor_abi.h
  652. gcc -O1 -g -Wall -Wextra -fsanitize=address,undefined -Iinclude -o $@ $<
  653. # ---- Command pack (the system rootfs) ---------------------------------------
  654. #
  655. # The ring-3 command ELFs plus hello and the browser/gallery apps, packed
  656. # into bin/<name>. See tools/mkpack.c, include/rootfs.h and kernel/ramfs.h.
  657. FONT_FILES = fonts/sans.ttf fonts/sans-b.ttf fonts/sans-i.ttf \
  658. fonts/sans-bi.ttf fonts/mono.ttf fonts/emoji.ttf
  659. # Mouse cursors: the Adwaita theme's 24 px images (assets/cursors/adwaita/,
  660. # LGPL-3 / CC-BY-SA-3.0) converted to one NBCUR1 bundle (include/cursor_abi.h)
  661. # that kernel/cursor.c loads from /ramfs/cursors/adwaita24.cur. Full pack
  662. # only (~18 KB gzip): the floppy lite pack has no room, and its kernel keeps
  663. # the built-in 16x16 arrow.
  664. CURSOR_THEME = assets/cursors/adwaita
  665. CURSOR_FILE = cursors/adwaita24.cur
  666. $(CURSOR_FILE): mkcursors $(filter-out %/README %/COPYING%,$(wildcard $(CURSOR_THEME)/*))
  667. @mkdir -p cursors
  668. ./mkcursors $(CURSOR_THEME) 24 $@
  669. # Defined after CURSOR_FILE: make expands a rule's prerequisites at once.
  670. test-cursors: cursor_test $(CURSOR_FILE)
  671. ./cursor_test $(CURSOR_FILE)
  672. # UI icons: the Adwaita symbolic SVGs (assets/icons/adwaita/, LGPL-3 /
  673. # CC-BY-SA-3.0) rasterized by mkicons (with the browser's svg_raster.c) into
  674. # one NBICO1 bundle of 16 px coverage masks (include/icon_abi.h) that ngui
  675. # loads from /ramfs/icons/adwaita16.icn and tints. ~3.3 KB (~0.8 KB gzip),
  676. # so the floppy lite pack carries it as well.
  677. ICON_THEME = assets/icons/adwaita
  678. ICON_FILE = icons/adwaita16.icn
  679. $(ICON_FILE): mkicons $(wildcard $(ICON_THEME)/*.svg)
  680. @mkdir -p icons
  681. ./mkicons $(ICON_THEME) 16 $@
  682. HELLO_ELF = $(U)/apps/hello/hello.elf
  683. PACK_FILES = $(foreach a,$(UCMDS),bin/$(a)=$(call app,$(a)).elf) \
  684. bin/hello=$(HELLO_ELF) \
  685. bin/gallery.app=gallery.elf \
  686. $(foreach f,$(FONT_FILES),$(f)=$(f)) \
  687. $(ICON_FILE)=$(ICON_FILE)
  688. PACK_DEPS = $(UCMD_ELFS) $(HELLO_ELF) browser.elf gallery.elf $(FONT_FILES) \
  689. $(ICON_FILE) mkpack
  690. PACK_CURSOR_FILES = $(CURSOR_FILE)=$(CURSOR_FILE)
  691. # The browser (~500 KB gzip) is in the full pack only: a floppy boot runs it
  692. # from BROWSER on root.img, which the bin/browser launcher already tries.
  693. PACK_BROWSER_FILES = bin/browser.app=browser.elf
  694. # `install self` reads the flat kernel from the full pack. The lite/floppy
  695. # pack deliberately omits it (no room on a 1.44 MB disk).
  696. PACK_INSTALL_FILES = install/kernel.bin=kernel.bin
  697. # WiFi firmware (kernel/iwl_trans.c): the Intel 7265D/3165 (Chromebook, MVM)
  698. # and the 6200/6300 (ThinkPad X201, DVM). Taken from the host's
  699. # linux-firmware (`.zst` or plain); WIFI_FW_7265D / WIFI_FW_6000 override the
  700. # search. A machine without one still builds: the pack then has no
  701. # firmware/ entry for that card and `wifi` reports it missing.
  702. fw_search = $(firstword $(wildcard \
  703. /usr/lib/firmware/intel/iwlwifi/$(1).zst /usr/lib/firmware/$(1).zst \
  704. /usr/lib/firmware/intel/iwlwifi/$(1) /usr/lib/firmware/$(1) \
  705. /lib/firmware/$(1)))
  706. WIFI_FW_7265D ?= $(call fw_search,iwlwifi-7265D-29.ucode)
  707. WIFI_FW_6000 ?= $(call fw_search,iwlwifi-6000-4.ucode)
  708. WIFI_FW_FILE =
  709. PACK_FW_FILES =
  710. # $(1) = file name in the pack, $(2) = host source.
  711. define wifi_fw_rule
  712. ifneq ($(2),)
  713. WIFI_FW_FILE += firmware/$(1)
  714. PACK_FW_FILES += firmware/$(1)=firmware/$(1)
  715. firmware/$(1): $(2)
  716. @mkdir -p firmware
  717. case "$$<" in *.zst) zstd -q -d -c "$$<" > $$@ ;; *) cp "$$<" $$@ ;; esac
  718. else
  719. $$(info note: $(1) not found; building the pack without it)
  720. endif
  721. endef
  722. $(eval $(call wifi_fw_rule,iwlwifi-7265D-29.ucode,$(WIFI_FW_7265D)))
  723. $(eval $(call wifi_fw_rule,iwlwifi-6000-4.ucode,$(WIFI_FW_6000)))
  724. # Realtek RTL8821AU USB sticks (kernel/rtl8821au.c): the rtw88 8051 firmware
  725. # from linux-firmware (WIFI_FW_8821A overrides the search) and the register
  726. # tables, generated from third_party/rtw88 by the host tool mkrtwtbl. Both
  727. # are only in the full pack, like the Intel firmware.
  728. WIFI_FW_8821A ?= $(firstword $(wildcard \
  729. /usr/lib/firmware/rtw88/rtw8821a_fw.bin.zst \
  730. /usr/lib/firmware/rtw88/rtw8821a_fw.bin \
  731. /lib/firmware/rtw88/rtw8821a_fw.bin))
  732. $(eval $(call wifi_fw_rule,rtw8821a_fw.bin,$(WIFI_FW_8821A)))
  733. WIFI_FW_FILE += firmware/rtl8821a.tbl
  734. PACK_FW_FILES += firmware/rtl8821a.tbl=firmware/rtl8821a.tbl
  735. firmware/rtl8821a.tbl: mkrtwtbl
  736. @mkdir -p firmware
  737. ./mkrtwtbl $@
  738. cmds.pack: $(PACK_DEPS) $(WIFI_FW_FILE) $(CURSOR_FILE) kernel.bin
  739. ./mkpack $@ $(PACK_FILES) $(PACK_BROWSER_FILES) $(PACK_CURSOR_FILES) \
  740. $(PACK_INSTALL_FILES) \
  741. $(PACK_FW_FILES)
  742. # The floppy images cannot hold the ~1 MB firmware: they get the same pack
  743. # without firmware/* (and without the cursor bundle or bin/browser.app).
  744. cmds-lite.pack: $(PACK_DEPS)
  745. ./mkpack $@ $(PACK_FILES)
  746. # The boot-time rootfs is gzip-compressed; the raw cmds.pack is still what
  747. # cmds-dev/net-cmds send for a runtime replacement. Prefer libdeflate's
  748. # level 12 when it is installed: it saves about 8 KB over gzip -9 on the
  749. # current pack. The high-memory rootfs loader supports up to 2 MB; the
  750. # floppy images use the firmware-less lite pack (rootfs.bin).
  751. CMDS_GZ = $(shell command -v libdeflate-gzip >/dev/null 2>&1 && \
  752. echo "libdeflate-gzip -12 -c" || echo "gzip -9 -n -c")
  753. CMDS_GZ_MAX = 2097152
  754. cmds_lite_gz.bin: cmds-lite.pack
  755. $(CMDS_GZ) $< > $@
  756. cmds_pack_gz.bin: cmds.pack
  757. $(CMDS_GZ) $< > $@
  758. @sz=$$(stat -c%s $@); \
  759. if [ $$sz -gt $(CMDS_GZ_MAX) ]; then \
  760. echo "error: cmds_pack_gz.bin is $$sz bytes; the legacy rootfs cap is $(CMDS_GZ_MAX)"; \
  761. rm -f $@; exit 1; \
  762. fi
  763. # Rootfs image: one NBROOT1 header sector + the gzip pack (rootfs.h).
  764. # rootfs.bin (the lite pack, no firmware) is appended to the floppy images;
  765. # cmds.img is the 8 MB image flashed into the USB rootfs partition.
  766. rootfs.bin: cmds_lite_gz.bin mkrootfs
  767. ./mkrootfs $@ cmds_lite_gz.bin
  768. # Full NBROOT1 image (header + gzip pack, no partition padding) for the
  769. # network install path. `install self` uses the retained boot image instead.
  770. rootfs-full.bin: cmds_pack_gz.bin mkrootfs
  771. ./mkrootfs $@ cmds_pack_gz.bin
  772. rootfs: cmds.img
  773. cmds.img: cmds_pack_gz.bin mkrootfs
  774. ./mkrootfs $@ cmds_pack_gz.bin $$(( $(ROOTFS_SECTORS) * 512 ))
  775. # Diagnostic: no WM, boot console stays visible. Rebuild normally with
  776. # `make -B ...` afterwards (the objects carry -DNOWM).
  777. nowm:
  778. $(MAKE) NOWM=1 -B kernel.elf kernel.bin floppy.img usb.img usb-efi.img final.bin
  779. @echo "nowm: WM disabled; flash usb.img or usb-efi.img."
  780. root.img: browser.elf gallery.elf testdata/browser/demo.html testdata/browser/js.html testdata/browser/jsext.js testdata/images/rgb.bmp
  781. dd if=/dev/zero of=$@ bs=512 count=2880 2>/dev/null
  782. mkfs.fat -F 12 -n "ROOTDISK" $@
  783. echo "Hello from the second floppy!" | mcopy -i $@ - ::HELLO.TXT
  784. echo "This is a test file on drive 1." | mcopy -i $@ - ::TEST.TXT
  785. mcopy -i $@ browser.elf ::BROWSER
  786. mcopy -i $@ gallery.elf ::GALLERY
  787. mcopy -i $@ testdata/browser/demo.html ::DEMO.HTM
  788. mcopy -i $@ testdata/browser/js.html ::JS.HTM
  789. mcopy -i $@ testdata/browser/jsext.js ::JSEXT.JS
  790. mcopy -i $@ testdata/images/rgb.bmp ::PIC.BMP
  791. OVMF ?= $(firstword $(wildcard /usr/share/ovmf/x64/OVMF.4m.fd /usr/share/OVMF/OVMF.4m.fd))
  792. # Guest RAM for the QEMU targets, matching the 1 GB kernel ceiling (phys.h);
  793. # override with e.g. `make run QEMU_MEM=512M` (RAM above 1 GB is ignored).
  794. QEMU_MEM ?= 1G
  795. # root.img is deliberately not attached: a running QEMU may hold its write
  796. # lock, and the UEFI boot test does not need a second filesystem.
  797. run-uefi: usb-efi.img
  798. @test -n "$(OVMF)" || { echo "OVMF not found; set OVMF=/path/to/OVMF.4m.fd" >&2; exit 1; }
  799. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -smp 4 -bios $(OVMF) -snapshot \
  800. -drive file=usb-efi.img,format=raw,if=ide \
  801. -device pci-ohci -device usb-mouse \
  802. -device ne2k_pci,netdev=n0 -netdev user,id=n0 \
  803. -serial file:/tmp/opencode/nebos-uefi-serial.log
  804. test-uefi: usb-efi.img
  805. @test -n "$(OVMF)" || { echo "OVMF not found; set OVMF=/path/to/OVMF.4m.fd" >&2; exit 1; }
  806. @rm -f /tmp/opencode/nebos-uefi-serial.log
  807. timeout 40 qemu-system-x86_64 -M pc -m $(QEMU_MEM) -smp 4 -bios $(OVMF) -snapshot \
  808. -drive file=usb-efi.img,format=raw,if=ide \
  809. -device pci-ohci -device usb-mouse \
  810. -device ne2k_pci,netdev=n0 -netdev user,id=n0 \
  811. -display none -serial file:/tmp/opencode/nebos-uefi-serial.log \
  812. -no-reboot >/dev/null 2>&1 || true
  813. @grep -q "booted" /tmp/opencode/nebos-uefi-serial.log && \
  814. echo "UEFI boot: OK (/tmp/opencode/nebos-uefi-serial.log)" || \
  815. { echo "UEFI boot: FAILED"; tail -c 4000 /tmp/opencode/nebos-uefi-serial.log; exit 1; }
  816. run: image.bin root.img
  817. $(MAKE) run-floppy
  818. # Four logical CPUs (the Atom 330 topology). UP is still the default so a
  819. # machine without ACPI/MADT boots exactly as before.
  820. run-smp: floppy.img root.img
  821. qemu-system-i386 -M pc -m $(QEMU_MEM) -smp 4 -device pci-ohci -device usb-mouse -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy 2>/dev/null || \
  822. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -smp 4 -device pci-ohci -device usb-mouse -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy
  823. floppy: floppy.img
  824. usb: usb.img
  825. # Write the dual-boot USB image (legacy BIOS + UEFI) to a stick; prompts
  826. # before destroying anything.
  827. # make flash USB=/dev/sdX FORCE=1 skips the removable-device check.
  828. # make flash FLASH_IMG=usb.img legacy-only image
  829. # The UEFI half needs the mingw toolchain (EFI_CC); the legacy half does not.
  830. FLASH_IMG ?= usb-efi.img
  831. flash: $(FLASH_IMG)
  832. @tools/flash.sh "$(USB)" "$(FORCE)" "$(FLASH_IMG)"
  833. run-floppy: floppy.img root.img
  834. qemu-system-i386 -M pc -m $(QEMU_MEM) -device pci-ohci -device usb-mouse -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy 2>/dev/null || \
  835. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -device pci-ohci -device usb-mouse -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy
  836. run-usb: usb.img root.img
  837. qemu-system-i386 -M pc -m $(QEMU_MEM) -boot c -device pci-ohci -device usb-mouse -drive file=usb.img,format=raw,if=ide -drive file=root.img,format=raw,if=floppy 2>/dev/null || \
  838. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -boot c -device pci-ohci -device usb-mouse -drive file=usb.img,format=raw,if=ide -drive file=root.img,format=raw,if=floppy
  839. # UHCI variant (machines with an Intel/VIA-style controller, and the
  840. # regression test for the UHCI backend of the USB core).
  841. run-uhci: floppy.img root.img
  842. qemu-system-i386 -M pc -m $(QEMU_MEM) -device piix3-usb-uhci -device usb-mouse -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy 2>/dev/null || \
  843. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -device piix3-usb-uhci -device usb-mouse -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy
  844. # xHCI variant (Braswell/Intel PCH and other USB 3.0-only machines).
  845. run-xhci: floppy.img root.img
  846. qemu-system-i386 -M pc -m $(QEMU_MEM) -device qemu-xhci -device usb-mouse -device usb-kbd -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy 2>/dev/null || \
  847. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -device qemu-xhci -device usb-mouse -device usb-kbd -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy
  848. # RNDIS variant: QEMU's usb-net is a full-speed RNDIS function. It sits on
  849. # xHCI (QEMU's USB2 root ports), and `-nic none` keeps the PCI e1000 out of
  850. # the way so the phone/tethering link is the active NIC.
  851. run-rndis: floppy.img root.img
  852. qemu-system-i386 -M pc -m $(QEMU_MEM) -nic none -device qemu-xhci -device usb-mouse -device usb-kbd -device usb-net,netdev=n1 -netdev user,id=n1 -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy 2>/dev/null || \
  853. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -nic none -device qemu-xhci -device usb-mouse -device usb-kbd -device usb-net,netdev=n1 -netdev user,id=n1 -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy
  854. # EHCI variant (USB 2.0 high-speed root ports). usb-storage is high-speed
  855. # and lands on EHCI; the mouse/keyboard are full-speed and use the UHCI
  856. # companion, exercising the multi-controller USB core.
  857. run-ehci: floppy.img root.img
  858. qemu-system-i386 -M pc -m $(QEMU_MEM) -boot a -device usb-ehci,id=ehci0 -device piix3-usb-uhci,id=uhci0 \
  859. -device usb-storage,bus=ehci0.0,drive=usbstick \
  860. -drive if=none,id=usbstick,file=root.img,format=raw \
  861. -device usb-mouse,bus=uhci0.0 -device usb-kbd,bus=uhci0.0 \
  862. -drive file=floppy.img,format=raw,if=floppy 2>/dev/null || \
  863. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -boot a -device usb-ehci,id=ehci0 -device piix3-usb-uhci,id=uhci0 \
  864. -device usb-storage,bus=ehci0.0,drive=usbstick \
  865. -drive if=none,id=usbstick,file=root.img,format=raw \
  866. -device usb-mouse,bus=uhci0.0 -device usb-kbd,bus=uhci0.0 \
  867. -drive file=floppy.img,format=raw,if=floppy
  868. # Passthrough of the real ASIX AX88772 dongle (requires the host's asix
  869. # driver to be unbound and permission on /dev/bus/usb/...; typically run with
  870. # sudo). `-nic none` keeps the QEMU e1000 out of the way so the USB NIC is
  871. # the only netdev.
  872. ASIX_HOST ?= vendorid=0x0b95,productid=0x7720
  873. run-ehci-asix: floppy.img root.img
  874. qemu-system-i386 -M pc -m $(QEMU_MEM) -nic none -device usb-ehci -device usb-host,$(ASIX_HOST) -serial file:/tmp/opencode/serial-asix.log -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy 2>/dev/null || \
  875. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -nic none -device usb-ehci -device usb-host,$(ASIX_HOST) -serial file:/tmp/opencode/serial-asix.log -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy
  876. run-xhci-asix: floppy.img root.img
  877. qemu-system-i386 -M pc -m $(QEMU_MEM) -nic none -device qemu-xhci -device usb-host,$(ASIX_HOST) -serial file:/tmp/opencode/serial-asix.log -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy 2>/dev/null || \
  878. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -nic none -device qemu-xhci -device usb-host,$(ASIX_HOST) -serial file:/tmp/opencode/serial-asix.log -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy
  879. # Network variant: a PCI NE2000 (RTL8029, the driver's QEMU match) on QEMU's
  880. # user-mode network (slirp). DHCP/DNS come from slirp, the host is 10.0.2.2
  881. # (e.g. `python3 -m http.server` + `curl http://10.0.2.2:8000/` in a window).
  882. run-net: floppy.img root.img
  883. qemu-system-i386 -M pc -m $(QEMU_MEM) -device pci-ohci -device usb-mouse -device ne2k_pci,netdev=n0 -netdev user,id=n0,hostfwd=tcp::8080-:8080 -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy 2>/dev/null || \
  884. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -device pci-ohci -device usb-mouse -device ne2k_pci,netdev=n0 -netdev user,id=n0,hostfwd=tcp::8080-:8080 -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy
  885. # Intel e1000 variant: QEMU's 82540EM exercises the e1000e driver's MAC/DMA
  886. # path. (The X201's 82577LM uses the same registers; only its PCH PHY is
  887. # different.) usb-kbd is there for headless QMP `send-key` typing.
  888. run-e1000: floppy.img root.img
  889. qemu-system-i386 -M pc -m $(QEMU_MEM) -device pci-ohci -device usb-mouse -device usb-kbd \
  890. -device e1000,netdev=n0 -netdev user,id=n0,hostfwd=tcp::8080-:8080 \
  891. -drive file=floppy.img,format=raw,if=floppy \
  892. -drive file=root.img,format=raw,if=floppy 2>/dev/null || \
  893. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -device pci-ohci -device usb-mouse -device usb-kbd \
  894. -device e1000,netdev=n0 -netdev user,id=n0,hostfwd=tcp::8080-:8080 \
  895. -drive file=floppy.img,format=raw,if=floppy \
  896. -drive file=root.img,format=raw,if=floppy
  897. # SATA/AHCI variant: an ICH9 AHCI controller with a test disk on port 0.
  898. # The disk image lives outside the repo and is created on first use; boot
  899. # stays on the floppy (order=a), the SATA disk shows up as sata0.
  900. SATA_IMG ?= /tmp/opencode/nebos-sata.img
  901. run-ahci: floppy.img root.img
  902. @test -f $(SATA_IMG) || truncate -s 512M $(SATA_IMG)
  903. qemu-system-i386 -M pc -m $(QEMU_MEM) -boot order=a -device pci-ohci -device usb-mouse \
  904. -drive file=floppy.img,format=raw,if=floppy \
  905. -drive file=root.img,format=raw,if=floppy \
  906. -device ich9-ahci,id=sata \
  907. -drive file=$(SATA_IMG),format=raw,if=none,id=satadisk \
  908. -device ide-hd,drive=satadisk,bus=sata.0 2>/dev/null || \
  909. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -boot order=a -device pci-ohci -device usb-mouse \
  910. -drive file=floppy.img,format=raw,if=floppy \
  911. -drive file=root.img,format=raw,if=floppy \
  912. -device ich9-ahci,id=sata \
  913. -drive file=$(SATA_IMG),format=raw,if=none,id=satadisk \
  914. -device ide-hd,drive=satadisk,bus=sata.0
  915. # AMD Piledriver regression: QEMU's Opteron_G5 is the FX-6350's family 15h
  916. # model 2 CPU. Exercises the AMD CPUID/MTRR/xAPIC paths, the AMD thermal
  917. # probe, the IOAPIC mask and six-core ACPI SMP. QEMU has no SB950 or
  918. # RTL8111E, so the e1000/OHCI devices cover the rest of the boot path.
  919. run-amd: floppy.img root.img
  920. qemu-system-x86_64 -M pc -cpu Opteron_G5 -smp 6 -m $(QEMU_MEM) \
  921. -device pci-ohci -device usb-mouse -device usb-kbd \
  922. -device e1000,netdev=n0 -netdev user,id=n0 \
  923. -drive file=floppy.img,format=raw,if=floppy \
  924. -drive file=root.img,format=raw,if=floppy
  925. test-amd: floppy.img root.img
  926. @rm -f /tmp/opencode/nebos-amd-serial.log
  927. timeout 40 qemu-system-x86_64 -M pc -cpu Opteron_G5 -smp 6 -m $(QEMU_MEM) \
  928. -device pci-ohci -device usb-mouse -device usb-kbd \
  929. -device e1000,netdev=n0 -netdev user,id=n0 \
  930. -drive file=floppy.img,format=raw,if=floppy \
  931. -drive file=root.img,format=raw,if=floppy \
  932. -display none -serial file:/tmp/opencode/nebos-amd-serial.log \
  933. -no-reboot >/dev/null 2>&1 || true
  934. @grep -q "booted" /tmp/opencode/nebos-amd-serial.log && \
  935. grep -q "smp cpus: 6" /tmp/opencode/nebos-amd-serial.log && \
  936. grep -q "ioapic: masked" /tmp/opencode/nebos-amd-serial.log && \
  937. grep -q "thermal: AMD family 15h" /tmp/opencode/nebos-amd-serial.log && \
  938. ! grep -q "PIT NOT TICKING" /tmp/opencode/nebos-amd-serial.log && \
  939. echo "AMD boot: OK (/tmp/opencode/nebos-amd-serial.log)" || \
  940. { echo "AMD boot: FAILED"; tail -c 4000 /tmp/opencode/nebos-amd-serial.log; exit 1; }
  941. # Headless USB HID regression tests (QEMU + python3): cursor movement via
  942. # injected USB mouse reports and keyboard input via injected key events,
  943. # including hotplug. See tools/*.py.
  944. test-usb: floppy.img root.img
  945. python3 tools/qmp_cursor_test.py
  946. python3 tools/qmp_cursor_test.py --uhci
  947. python3 tools/qmp_cursor_test.py --uhci72
  948. python3 tools/qmp_cursor_test.py --hotplug
  949. python3 tools/qmp_cursor_test.py --xhci
  950. python3 tools/qmp_cursor_test.py --ehci
  951. python3 tools/qmp_keyboard_test.py
  952. python3 tools/qmp_keyboard_test.py --hotplug
  953. python3 tools/qmp_keyboard_test.py --xhci
  954. python3 tools/qmp_keyboard_test.py --ehci
  955. # End-to-end installer test: boot the dual-boot USB image as an IDE disk,
  956. # attach the same image as a USB mass-storage source, type `install ide1`
  957. # on the terminal and verify + boot the cloned target.
  958. test-install: usb-efi.img
  959. python3 tools/qmp_install_test.py
  960. scp-final: final.bin
  961. scp final.bin root@192.168.0.136:
  962. ssh root@192.168.0.136 dd if=final.bin of=/dev/fd0 bs=512
  963. scp-root: root.img
  964. scp root.img root@192.168.0.136:
  965. ssh root@192.168.0.136 dd if=root.img of=/dev/fd0 bs=512
  966. SERIAL_DEV ?= /dev/ttyUSB0
  967. SERIAL_BAUD ?= 115200
  968. run-serial:
  969. @echo "Starting serial monitor on $(SERIAL_DEV) at $(SERIAL_BAUD) baud..."
  970. @echo "Type 'serial test' in the nebos terminal."
  971. @echo "Press Ctrl-A Ctrl-X to exit picocom."
  972. picocom $(SERIAL_DEV) --baud $(SERIAL_BAUD)
  973. monitor:
  974. @echo "Watching $(SERIAL_DEV) @ $(SERIAL_BAUD) baud (Ctrl-A Ctrl-X to exit)."
  975. @echo "Each 'make dev' reload prints: NebOS v<version> booted"
  976. picocom $(SERIAL_DEV) --baud $(SERIAL_BAUD)
  977. dev: kernel.bin cmds_pack_gz.bin kexec_send
  978. @entry=$$(nm kernel.elf | awk '/ T kernel_entry$$/{print $$1}'); \
  979. if [ -z "$$entry" ]; then echo "error: kernel_entry symbol not found"; exit 1; fi; \
  980. echo "Sending kernel.bin + cmds_pack_gz.bin (entry 0x$$entry) via $(SERIAL_DEV) @ $(SERIAL_BAUD)..."; \
  981. ./kexec_send $(SERIAL_DEV) $(SERIAL_BAUD) $$entry kernel.bin cmds_pack_gz.bin
  982. # Kernel-only fast path: the board keeps its running rootfs.
  983. kernel-dev: kernel.bin kexec_send
  984. @entry=$$(nm kernel.elf | awk '/ T kernel_entry$$/{print $$1}'); \
  985. if [ -z "$$entry" ]; then echo "error: kernel_entry symbol not found"; exit 1; fi; \
  986. echo "Sending kernel.bin only (entry 0x$$entry) via $(SERIAL_DEV) @ $(SERIAL_BAUD)..."; \
  987. ./kexec_send $(SERIAL_DEV) $(SERIAL_BAUD) $$entry kernel.bin
  988. # Push just the command pack (cmds.pack) to a running board: no kernel
  989. # reload, the /ramfs contents are replaced in place. The board must be idle
  990. # at a prompt (the WM loop auto-detects the transfer).
  991. cmds-dev: cmds.pack kexec_send
  992. @echo "Sending cmds.pack via $(SERIAL_DEV) @ $(SERIAL_BAUD)..."
  993. ./kexec_send --payload $(SERIAL_DEV) $(SERIAL_BAUD) cmds.pack
  994. net-cmds: cmds.pack netkexec_send
  995. @echo "Sending cmds.pack to $(BOARD_IP):$(NETKEXEC_PORT)..."
  996. ./netkexec_send --payload $(BOARD_IP) $(NETKEXEC_PORT) cmds.pack
  997. # Development override: upload the real browser to the board's writable
  998. # /share; the bin/browser launcher prefers it over the pack copy. The board
  999. # must be running `websrv`; stop it before browsing HTTP, since the WebDAV
  1000. # server owns the NIC.
  1001. browser-dev: browser.elf
  1002. @echo "Uploading browser.elf to http://$(BOARD_IP):8080/share/BROWSER..."
  1003. curl -f -T browser.elf http://$(BOARD_IP):8080/share/BROWSER
  1004. # gallery follows the same development-override model.
  1005. gallery-dev: gallery.elf
  1006. @echo "Uploading gallery.elf to http://$(BOARD_IP):8080/share/GALLERY..."
  1007. curl -f -T gallery.elf http://$(BOARD_IP):8080/share/GALLERY
  1008. # Browser compatibility ladder: serve testdata/browser/compat so the board
  1009. # or a QEMU guest can open http://<host>:$(COMPAT_PORT)/.
  1010. COMPAT_PORT ?= 8000
  1011. compat-serve:
  1012. @echo "Serving the browser compatibility ladder on port $(COMPAT_PORT)"
  1013. python3 -m http.server -d testdata/browser/compat $(COMPAT_PORT)
  1014. # Show the board's netlog stream (kernel debug + terminal text) like `make
  1015. # monitor` does over serial.
  1016. netmon: netmonitor
  1017. @echo "Listening for netlog on UDP $(NETLOG_PORT) (Ctrl-C to exit)."
  1018. ./netmonitor $(NETLOG_PORT)
  1019. # Push a fresh kernel over Ethernet (the board auto-detects it from its idle
  1020. # loop; no serial and no USB stick involved).
  1021. BOARD_IP ?= 192.168.178.240
  1022. NETLOG_PORT ?= 19290
  1023. NETKEXEC_PORT ?= 19288
  1024. net-dev: kernel.bin cmds_pack_gz.bin netkexec_send
  1025. @entry=$$(nm kernel.elf | awk '/ T kernel_entry$$/{print $$1}'); \
  1026. if [ -z "$$entry" ]; then echo "error: kernel_entry symbol not found"; exit 1; fi; \
  1027. echo "Sending kernel.bin + cmds_pack_gz.bin (entry 0x$$entry) to $(BOARD_IP):$(NETKEXEC_PORT)..."; \
  1028. ./netkexec_send $(BOARD_IP) $(NETKEXEC_PORT) 0x$$entry kernel.bin cmds_pack_gz.bin
  1029. # Kernel-only fast path: the board keeps its running rootfs.
  1030. kernel-net-dev: kernel.bin netkexec_send
  1031. @entry=$$(nm kernel.elf | awk '/ T kernel_entry$$/{print $$1}'); \
  1032. if [ -z "$$entry" ]; then echo "error: kernel_entry symbol not found"; exit 1; fi; \
  1033. echo "Sending kernel.bin only (entry 0x$$entry) to $(BOARD_IP):$(NETKEXEC_PORT)..."; \
  1034. ./netkexec_send $(BOARD_IP) $(NETKEXEC_PORT) 0x$$entry kernel.bin
  1035. # Persistent update: write P1/P2 on the target disk (P4/data is untouched),
  1036. # then jump into the new kernel. TARGET=auto picks the only non-USB NebOS
  1037. # disk; use NETINSTALL_TARGET=mmc0/sata0/... to override.
  1038. NETINSTALL_TARGET ?= auto
  1039. net-install: kernel.bin rootfs-full.bin netkexec_send
  1040. @entry=$$(nm kernel.elf | awk '/ T kernel_entry$$/{print $$1}'); \
  1041. if [ -z "$$entry" ]; then echo "error: kernel_entry symbol not found"; exit 1; fi; \
  1042. echo "Persisting kernel.bin + rootfs-full.bin to $(NETINSTALL_TARGET) on $(BOARD_IP):$(NETKEXEC_PORT)..."; \
  1043. ./netkexec_send --install $(NETINSTALL_TARGET) $(BOARD_IP) $(NETKEXEC_PORT) 0x$$entry kernel.bin rootfs-full.bin
  1044. clean:
  1045. rm -rf $(B) host/build
  1046. rm -f kernel.elf kernel.bin boot.bin mbr.bin boot.bin.tmp image.bin \
  1047. floppy.img usb.img usb-efi.img esp.img final.bin root.img \
  1048. BOOTX64.EFI browser.elf gallery.elf *.boot.tmp \
  1049. cmds.pack cmds-lite.pack cmds_pack_gz.bin cmds_lite_gz.bin \
  1050. rootfs.bin rootfs-full.bin cmds.img \
  1051. firmware/*.ucode firmware/*.tbl firmware/*.bin cursors/*.cur icons/*.icn \
  1052. mkpack mkrootfs mkrtwtbl mkcursors mkicons jsstrip cursor_test kexec_send netkexec_send netmonitor \
  1053. browser-host host-curl \
  1054. ufont_test ufont_test_asan svg_test touchpad_gesture_test \
  1055. ujson_test uhttp_cookie_test chat_login_test tls_test wpa_test \
  1056. wifi_store_test ccmp_test img_test img_test_asan malloc_test \
  1057. format_test math_test div64_test setjmp_test js_test
  1058. # Compiler-generated header dependencies.
  1059. -include $(shell find $(B) host/build -name '*.d' 2>/dev/null)