From 341fb86b22ffa1902480db52a221589a6bd4526a Mon Sep 17 00:00:00 2001
From: Wayne Venables <wayne@codaris.com>
Date: Sat, 25 Feb 2023 20:18:58 -0800
Subject: [PATCH] Refactoring library files to remove dependency on include.h.

---
 examples/vga_hello/Makefile      |  65 -------
 examples/vga_hello/src/include.h |  15 --
 examples/vga_hello/src/main.cpp  |   3 +-
 examples/vga_hello/src/main.h    |  11 --
 global.h                         | 281 -------------------------------
 picovga.cmake                    |   2 +-
 src/font/RaspPicoImg.exe         | Bin 77824 -> 0 bytes
 src/font/font_boldB_8x14.cpp     |   2 +-
 src/font/font_boldB_8x16.cpp     |   2 +-
 src/font/font_bold_8x14.cpp      |   2 +-
 src/font/font_bold_8x16.cpp      |   2 +-
 src/font/font_bold_8x8.cpp       |   2 +-
 src/font/font_game_8x8.cpp       |   2 +-
 src/font/font_ibm_8x14.cpp       |   2 +-
 src/font/font_ibm_8x16.cpp       |   2 +-
 src/font/font_ibm_8x8.cpp        |   2 +-
 src/font/font_ibmtiny_8x8.cpp    |   2 +-
 src/font/font_italic_8x8.cpp     |   2 +-
 src/font/font_thin_8x8.cpp       |   2 +-
 src/picovga.h                    | 136 +++++++++++++++
 src/util/canvas.cpp              |   6 +-
 src/util/mat2d.cpp               |   2 +-
 src/util/mat2d.h                 |   3 +
 src/util/overclock.cpp           |   5 +-
 src/util/overclock.h             |   2 +
 src/util/print.cpp               |   2 +-
 src/util/pwmsnd.cpp              |   5 +-
 src/util/rand.cpp                |   3 +-
 src/vga.cpp                      |  10 +-
 src/vga_layer.cpp                |   5 +-
 src/vga_pal.cpp                  |   3 +-
 src/vga_screen.cpp               |   4 +-
 src/vga_util.cpp                 |   5 +-
 src/vga_vmode.cpp                |   6 +-
 34 files changed, 200 insertions(+), 398 deletions(-)
 delete mode 100644 examples/vga_hello/Makefile
 delete mode 100644 examples/vga_hello/src/include.h
 delete mode 100644 examples/vga_hello/src/main.h
 delete mode 100644 global.h
 delete mode 100644 src/font/RaspPicoImg.exe
 create mode 100644 src/picovga.h

diff --git a/examples/vga_hello/Makefile b/examples/vga_hello/Makefile
deleted file mode 100644
index 87b6ac1..0000000
--- a/examples/vga_hello/Makefile
+++ /dev/null
@@ -1,65 +0,0 @@
-#   make clean ... clean
-#   make all ... compile
-
-##############################################################################
-# Input files
-
-# ASM source files
-ASRC +=
-
-# C source files
-CSRC +=
-
-# C++ source files
-SRC += src/main.cpp
-
-##############################################################################
-# Configuration
-
-# defines
-DEFINE += -DCFG_TUSB_DEBUG=0
-DEFINE += -DCFG_TUSB_MCU=OPT_MCU_RP2040
-DEFINE += -DCFG_TUSB_OS=OPT_OS_PICO
-DEFINE += -DPICO_BIT_OPS_PICO=1
-DEFINE += -DPICO_BOARD=\"pico\"
-DEFINE += -DPICO_BUILD=1
-DEFINE += -DPICO_CMAKE_BUILD_TYPE=\"Release\"
-DEFINE += -DPICO_COPY_TO_RAM=0
-DEFINE += -DPICO_CXX_ENABLE_EXCEPTIONS=0
-DEFINE += -DPICO_DIVIDER_HARDWARE=1
-DEFINE += -DPICO_DOUBLE_PICO=1
-DEFINE += -DPICO_FLOAT_PICO=1
-DEFINE += -DPICO_INT64_OPS_PICO=1
-DEFINE += -DPICO_MEM_OPS_PICO=1
-DEFINE += -DPICO_NO_FLASH=0
-DEFINE += -DPICO_NO_HARDWARE=0
-DEFINE += -DPICO_ON_DEVICE=1
-DEFINE += -DPICO_PRINTF_PICO=1
-DEFINE += -DPICO_PROGRAM_URL=\"https://github.com/raspberrypi/pico-examples\"
-DEFINE += -DPICO_TARGET_NAME=\"pico\"
-DEFINE += -DPICO_USE_BLOCKED_RAM=0
-DEFINE += -DNDEBUG
-
-# stdio output (select one option)
-#DEFINE += -DPICO_STDIO_UART=1
-#DEFINE += -DPICO_STDIO_SEMIHOSTING=1
-#DEFINE += -DPICO_STDIO_USB=1
-
-# How to connect UART to Pico:
-#                  +---USB---+
-# <-- UART0_TX GP0 |.1    40.|VBUS --- +5V power output to USB device
-# --> UART0_RX GP1 |.2    39.|VSYS ---|<|--- +5V power input
-# ---          GND |.3    38.| GND  K diode A
-#              GP2 |.4    37.| 3V3_EN
-#              GP3 |.5    36.| 3V3_OUT
-#                    ......
-#
-# USB/UART adaptor PL2303TA:
-#    red ......... +5V VSYS (39)
-#    black ....... GND (3)
-#    white RxD ... UART0_TX GP0 (1)
-#    green TxD ... UART0_RX GP1 (2)
-
-# Setup: 115200 Baud
-
-include ../Makefile.inc
diff --git a/examples/vga_hello/src/include.h b/examples/vga_hello/src/include.h
deleted file mode 100644
index 32642b8..0000000
--- a/examples/vga_hello/src/include.h
+++ /dev/null
@@ -1,15 +0,0 @@
-
-// ****************************************************************************
-//                                 
-//                              Common definitions
-//
-// ****************************************************************************
-
-// ----------------------------------------------------------------------------
-//                                   Includes
-// ----------------------------------------------------------------------------
-
-#include "../../../global.h"	// global common definitions
-
-// main
-#include "main.h"		// main code
diff --git a/examples/vga_hello/src/main.cpp b/examples/vga_hello/src/main.cpp
index 995cf56..a155163 100644
--- a/examples/vga_hello/src/main.cpp
+++ b/examples/vga_hello/src/main.cpp
@@ -5,7 +5,8 @@
 //
 // ****************************************************************************
 
-#include "include.h"
+
+#include "picovga.h"
 
 // Draw box
 ALIGNED u8 Box[512*400];
diff --git a/examples/vga_hello/src/main.h b/examples/vga_hello/src/main.h
deleted file mode 100644
index 557c014..0000000
--- a/examples/vga_hello/src/main.h
+++ /dev/null
@@ -1,11 +0,0 @@
-
-// ****************************************************************************
-//
-//                                 Main code
-//
-// ****************************************************************************
-
-#ifndef _MAIN_H
-#define _MAIN_H
-
-#endif // _MAIN_H
diff --git a/global.h b/global.h
deleted file mode 100644
index 15517a1..0000000
--- a/global.h
+++ /dev/null
@@ -1,281 +0,0 @@
-
-// ****************************************************************************
-//                                 
-//                           Global common definitions
-//
-// ****************************************************************************
-
-// ----------------------------------------------------------------------------
-//                              Base data types
-// ----------------------------------------------------------------------------
-
-typedef signed char s8;
-typedef unsigned char u8;
-typedef signed short s16;
-typedef unsigned short u16;
-typedef signed long int s32;
-typedef unsigned long int u32;
-typedef signed long long int s64;
-typedef unsigned long long int u64;
-
-typedef unsigned int uint;
-
-typedef unsigned char Bool;
-#define True 1
-#define False 0
-
-// NULL
-#ifndef NULL
-#ifdef __cplusplus
-#define NULL 0
-#else
-#define NULL ((void*)0)
-#endif
-#endif
-
-// I/O port prefix
-#define __IO	volatile
-
-// request to use inline
-#define INLINE __attribute__((always_inline)) inline
-
-// avoid to use inline
-#define NOINLINE __attribute__((noinline))
-
-// weak function
-#define WEAK __attribute__((weak))
-
-// align array to 4-bytes
-#define ALIGNED __attribute__((aligned(4)))
-
-#define LED_PIN 25
-
-// ----------------------------------------------------------------------------
-//                               Constants
-// ----------------------------------------------------------------------------
-
-#define	B0 (1<<0)
-#define	B1 (1<<1)
-#define	B2 (1<<2)
-#define	B3 (1<<3)
-#define	B4 (1<<4)
-#define	B5 (1<<5)
-#define	B6 (1<<6)
-#define	B7 (1<<7)
-#define	B8 (1U<<8)
-#define	B9 (1U<<9)
-#define	B10 (1U<<10)
-#define	B11 (1U<<11)
-#define	B12 (1U<<12)
-#define	B13 (1U<<13)
-#define	B14 (1U<<14)
-#define	B15 (1U<<15)
-#define B16 (1UL<<16)
-#define B17 (1UL<<17)
-#define B18 (1UL<<18)
-#define	B19 (1UL<<19)
-#define B20 (1UL<<20)
-#define B21 (1UL<<21)
-#define B22 (1UL<<22)
-#define B23 (1UL<<23)
-#define B24 (1UL<<24)
-#define B25 (1UL<<25)
-#define B26 (1UL<<26)
-#define B27 (1UL<<27)
-#define B28 (1UL<<28)
-#define B29 (1UL<<29)
-#define B30 (1UL<<30)
-#define B31 (1UL<<31)
-
-#define BIT(pos) (1UL<<(pos))
-
-#define	BIGINT	0x40000000 // big int value
-
-#define _T(a) a
-
-#define PI 3.14159265358979324
-#define PI2 (3.14159265358979324*2)
-
-// ----------------------------------------------------------------------------
-//                                   Includes
-// ----------------------------------------------------------------------------
-
-// fonts
-extern const ALIGNED u8 FontBold8x8[2048];
-extern const ALIGNED u8 FontBold8x14[3584];
-extern const ALIGNED u8 FontBold8x16[4096];
-extern const ALIGNED u8 FontBoldB8x14[3584];
-extern const ALIGNED u8 FontBoldB8x16[4096];
-extern const ALIGNED u8 FontGame8x8[2048];
-extern const ALIGNED u8 FontIbm8x8[2048];
-extern const ALIGNED u8 FontIbm8x14[3584];
-extern const ALIGNED u8 FontIbm8x16[4096];
-extern const ALIGNED u8 FontIbmTiny8x8[2048];
-extern const ALIGNED u8 FontItalic8x8[2048];
-extern const ALIGNED u8 FontThin8x8[2048];
-
-// system includes
-#include <string.h>
-
-// SDK includes
-#include "boards/pico.h"
-
-#include "hardware/regs/addressmap.h"
-#include "hardware/regs/adc.h"
-#include "hardware/regs/busctrl.h"
-#include "hardware/regs/clocks.h"
-#include "hardware/regs/dma.h"
-#include "hardware/regs/dreq.h"
-#include "hardware/regs/i2c.h"
-#include "hardware/regs/intctrl.h"
-#include "hardware/regs/io_bank0.h"
-#include "hardware/regs/io_qspi.h"
-#include "hardware/regs/m0plus.h"
-#include "hardware/regs/pads_bank0.h"
-#include "hardware/regs/pads_qspi.h"
-#include "hardware/regs/pio.h"
-#include "hardware/regs/pll.h"
-#include "hardware/regs/psm.h"
-#include "hardware/regs/pwm.h"
-#include "hardware/regs/resets.h"
-#include "hardware/regs/rosc.h"
-#include "hardware/regs/rtc.h"
-#include "hardware/regs/sio.h"
-#include "hardware/regs/spi.h"
-#include "hardware/regs/ssi.h"
-#include "hardware/regs/syscfg.h"
-#include "hardware/regs/sysinfo.h"
-#include "hardware/regs/tbman.h"
-#include "hardware/regs/timer.h"
-#include "hardware/regs/uart.h"
-#include "hardware/regs/usb.h"
-#include "hardware/regs/vreg_and_chip_reset.h"
-#include "hardware/regs/watchdog.h"
-#include "hardware/regs/xip.h"
-#include "hardware/regs/xosc.h"
-
-#include "hardware/structs/adc.h"
-#include "hardware/structs/bus_ctrl.h"
-#include "hardware/structs/clocks.h"
-#include "hardware/structs/dma.h"
-#include "hardware/structs/i2c.h"
-#include "hardware/structs/interp.h"
-#include "hardware/structs/iobank0.h"
-#include "hardware/structs/ioqspi.h"
-#include "hardware/structs/mpu.h"
-#include "hardware/structs/padsbank0.h"
-#include "hardware/structs/pads_qspi.h"
-#include "hardware/structs/pio.h"
-#include "hardware/structs/pll.h"
-#include "hardware/structs/psm.h"
-#include "hardware/structs/pwm.h"
-#include "hardware/structs/resets.h"
-#include "hardware/structs/rosc.h"
-#include "hardware/structs/rtc.h"
-#include "hardware/structs/scb.h"
-#include "hardware/structs/sio.h"
-#include "hardware/structs/spi.h"
-#include "hardware/structs/ssi.h"
-#include "hardware/structs/syscfg.h"
-#include "hardware/structs/systick.h"
-#include "hardware/structs/timer.h"
-#include "hardware/structs/uart.h"
-#include "hardware/structs/usb.h"
-#include "hardware/structs/vreg_and_chip_reset.h"
-#include "hardware/structs/watchdog.h"
-#include "hardware/structs/xip_ctrl.h"
-#include "hardware/structs/xosc.h"
-
-//#include "hardware/adc.h"
-#include "hardware/address_mapped.h"
-#include "hardware/claim.h"
-#include "hardware/clocks.h"
-#include "hardware/divider.h"
-#include "hardware/dma.h"
-//#include "hardware/flash.h"
-#include "hardware/gpio.h"
-//#include "hardware/i2c.h"
-#include "hardware/interp.h"
-#include "hardware/irq.h"
-#include "hardware/pio.h"
-#include "hardware/pio_instructions.h"
-#include "hardware/platform_defs.h"
-#include "hardware/pll.h"
-#include "hardware/pwm.h"
-#include "hardware/resets.h"
-//#include "hardware/rtc.h"
-//#include "hardware/spi.h"
-#include "hardware/sync.h"
-#include "hardware/timer.h"
-#include "hardware/uart.h"
-#include "hardware/vreg.h"
-#include "hardware/watchdog.h"
-#include "hardware/xosc.h"
-
-//#include "boot/picoboot.h"
-//#include "boot/uf2.h"
-
-//#include "pico.h"
-//#include "tusb_config.h"
-
-#include "pico/assert.h"
-#include "pico/binary_info.h"
-#include "pico/bit_ops.h"
-#include "pico/bootrom.h"
-#include "pico/config.h"
-#include "pico/config_autogen.h"
-#include "pico/critical_section.h"
-#include "pico/divider.h"
-#include "pico/double.h"
-#include "pico/error.h"
-#include "pico/float.h"
-#include "pico/int64_ops.h"
-#include "pico/lock_core.h"
-#include "pico/malloc.h"
-//#include "pico/mem_ops.h"
-#include "pico/multicore.h"
-#include "pico/mutex.h"
-#include "pico/platform.h"
-#include "pico/printf.h"
-#include "pico/runtime.h"
-#include "pico/sem.h"
-#include "pico/stdio.h"
-//#include "pico/stdio_semihosting.h"
-//#include "pico/stdio_uart.h"
-//#include "pico/stdio_usb.h"
-#include "pico/stdlib.h"
-#include "pico/sync.h"
-#include "pico/time.h"
-#include "pico/timeout_helper.h"
-#include "pico/types.h"
-//#include "pico/unique_id.h"
-#include "pico/version.h"
-
-#include "pico/binary_info/code.h"
-#include "pico/binary_info/defs.h"
-#include "pico/binary_info/structure.h"
-
-#include "pico/bootrom/sf_table.h"
-
-//#include "pico/fix/rp2040_usb_device_enumeration.h"
-
-#include "pico/stdio/driver.h"
-
-#include "pico/util/datetime.h"
-#include "pico/util/pheap.h"
-#include "pico/util/queue.h"
-
-// PicoVGA includes
-#include "src/define.h"	// common definitions of C and ASM
-#include "src/util/canvas.h" // canvas
-#include "src/util/overclock.h" // overclock
-#include "src/util/print.h" // print to attribute text buffer
-#include "src/util/rand.h"	// random number generator
-#include "src/util/mat2d.h" // 2D transformation matrix
-#include "src/util/pwmsnd.h" // PWM sound output
-#include "src/vga_pal.h"	// VGA colors and palettes
-#include "src/vga_vmode.h"	// VGA videomodes
-#include "src/vga_layer.h"	// VGA layers
-#include "src/vga_screen.h" // VGA screen layout
-#include "src/vga_util.h"	// VGA utilities
-#include "src/vga.h"	 // VGA output
diff --git a/picovga.cmake b/picovga.cmake
index 1ef24b0..710253e 100644
--- a/picovga.cmake
+++ b/picovga.cmake
@@ -69,5 +69,5 @@ macro(add_picovga project)
 
     target_link_libraries(${project} pico_stdlib hardware_pio hardware_dma pico_multicore hardware_interp hardware_pwm)
 
-    include_directories(${project} ${CMAKE_CURRENT_BINARY_DIR})
+    include_directories(${project} ${CMAKE_CURRENT_BINARY_DIR} ${PICOVGA_PATH}/src)
 endmacro()
diff --git a/src/font/RaspPicoImg.exe b/src/font/RaspPicoImg.exe
deleted file mode 100644
index eed34d73018976a9f5d15001f85468dc12b36680..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 77824
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

diff --git a/src/font/font_boldB_8x14.cpp b/src/font/font_boldB_8x14.cpp
index 5c3a7ef..313a474 100644
--- a/src/font/font_boldB_8x14.cpp
+++ b/src/font/font_boldB_8x14.cpp
@@ -1,4 +1,4 @@
-#include "include.h"
+#include "picovga.h"
 
 // format: 1-bit pixel graphics
 // image width: 2048 pixels
diff --git a/src/font/font_boldB_8x16.cpp b/src/font/font_boldB_8x16.cpp
index a50aeaf..4da82d0 100644
--- a/src/font/font_boldB_8x16.cpp
+++ b/src/font/font_boldB_8x16.cpp
@@ -1,4 +1,4 @@
-#include "include.h"
+#include "picovga.h"
 
 // format: 1-bit pixel graphics
 // image width: 2048 pixels
diff --git a/src/font/font_bold_8x14.cpp b/src/font/font_bold_8x14.cpp
index e9bd347..670b8b0 100644
--- a/src/font/font_bold_8x14.cpp
+++ b/src/font/font_bold_8x14.cpp
@@ -1,4 +1,4 @@
-#include "include.h"
+#include "picovga.h"
 
 // format: 1-bit pixel graphics
 // image width: 2048 pixels
diff --git a/src/font/font_bold_8x16.cpp b/src/font/font_bold_8x16.cpp
index 4312cac..14967c3 100644
--- a/src/font/font_bold_8x16.cpp
+++ b/src/font/font_bold_8x16.cpp
@@ -1,4 +1,4 @@
-#include "include.h"
+#include "picovga.h"
 
 // format: 1-bit pixel graphics
 // image width: 2048 pixels
diff --git a/src/font/font_bold_8x8.cpp b/src/font/font_bold_8x8.cpp
index f828944..1e2f871 100644
--- a/src/font/font_bold_8x8.cpp
+++ b/src/font/font_bold_8x8.cpp
@@ -1,4 +1,4 @@
-#include "include.h"
+#include "picovga.h"
 
 // format: 1-bit pixel graphics
 // image width: 2048 pixels
diff --git a/src/font/font_game_8x8.cpp b/src/font/font_game_8x8.cpp
index 85aca5f..0fe4eb7 100644
--- a/src/font/font_game_8x8.cpp
+++ b/src/font/font_game_8x8.cpp
@@ -1,4 +1,4 @@
-#include "include.h"
+#include "picovga.h"
 
 // format: 1-bit pixel graphics
 // image width: 2048 pixels
diff --git a/src/font/font_ibm_8x14.cpp b/src/font/font_ibm_8x14.cpp
index be59712..2326b4c 100644
--- a/src/font/font_ibm_8x14.cpp
+++ b/src/font/font_ibm_8x14.cpp
@@ -1,4 +1,4 @@
-#include "include.h"
+#include "picovga.h"
 
 // format: 1-bit pixel graphics
 // image width: 2048 pixels
diff --git a/src/font/font_ibm_8x16.cpp b/src/font/font_ibm_8x16.cpp
index fac1835..2c057d5 100644
--- a/src/font/font_ibm_8x16.cpp
+++ b/src/font/font_ibm_8x16.cpp
@@ -1,4 +1,4 @@
-#include "include.h"
+#include "picovga.h"
 
 // format: 1-bit pixel graphics
 // image width: 2048 pixels
diff --git a/src/font/font_ibm_8x8.cpp b/src/font/font_ibm_8x8.cpp
index 4935a8a..51564d8 100644
--- a/src/font/font_ibm_8x8.cpp
+++ b/src/font/font_ibm_8x8.cpp
@@ -1,4 +1,4 @@
-#include "include.h"
+#include "picovga.h"
 
 // format: 1-bit pixel graphics
 // image width: 2048 pixels
diff --git a/src/font/font_ibmtiny_8x8.cpp b/src/font/font_ibmtiny_8x8.cpp
index 1885d58..146f037 100644
--- a/src/font/font_ibmtiny_8x8.cpp
+++ b/src/font/font_ibmtiny_8x8.cpp
@@ -1,4 +1,4 @@
-#include "include.h"
+#include "picovga.h"
 
 // format: 1-bit pixel graphics
 // image width: 2048 pixels
diff --git a/src/font/font_italic_8x8.cpp b/src/font/font_italic_8x8.cpp
index 569c924..94a5cf0 100644
--- a/src/font/font_italic_8x8.cpp
+++ b/src/font/font_italic_8x8.cpp
@@ -1,4 +1,4 @@
-#include "include.h"
+#include "picovga.h"
 
 // format: 1-bit pixel graphics
 // image width: 2048 pixels
diff --git a/src/font/font_thin_8x8.cpp b/src/font/font_thin_8x8.cpp
index 00438f9..7b6ed4d 100644
--- a/src/font/font_thin_8x8.cpp
+++ b/src/font/font_thin_8x8.cpp
@@ -1,4 +1,4 @@
-#include "include.h"
+#include "picovga.h"
 
 // format: 1-bit pixel graphics
 // image width: 2048 pixels
diff --git a/src/picovga.h b/src/picovga.h
new file mode 100644
index 0000000..7b79a72
--- /dev/null
+++ b/src/picovga.h
@@ -0,0 +1,136 @@
+
+// ****************************************************************************
+//                                 
+//                           Global common definitions
+//
+// ****************************************************************************
+
+// ----------------------------------------------------------------------------
+//                              Base data types
+// ----------------------------------------------------------------------------
+
+#ifndef _PICOVGA_H
+#define _PICOVGA_H
+
+
+typedef signed char s8;
+typedef unsigned char u8;
+typedef signed short s16;
+typedef unsigned short u16;
+typedef signed long int s32;
+typedef unsigned long int u32;
+typedef signed long long int s64;
+typedef unsigned long long int u64;
+
+typedef unsigned int uint;
+
+typedef unsigned char Bool;
+#define True 1
+#define False 0
+
+// NULL
+#ifndef NULL
+#ifdef __cplusplus
+#define NULL 0
+#else
+#define NULL ((void*)0)
+#endif
+#endif
+
+// I/O port prefix
+#define __IO	volatile
+
+// request to use inline
+#define INLINE __attribute__((always_inline)) inline
+
+// avoid to use inline
+#define NOINLINE __attribute__((noinline))
+
+// weak function
+#define WEAK __attribute__((weak))
+
+// align array to 4-bytes
+#define ALIGNED __attribute__((aligned(4)))
+
+#define LED_PIN 25
+
+// ----------------------------------------------------------------------------
+//                               Constants
+// ----------------------------------------------------------------------------
+
+#define	B0 (1<<0)
+#define	B1 (1<<1)
+#define	B2 (1<<2)
+#define	B3 (1<<3)
+#define	B4 (1<<4)
+#define	B5 (1<<5)
+#define	B6 (1<<6)
+#define	B7 (1<<7)
+#define	B8 (1U<<8)
+#define	B9 (1U<<9)
+#define	B10 (1U<<10)
+#define	B11 (1U<<11)
+#define	B12 (1U<<12)
+#define	B13 (1U<<13)
+#define	B14 (1U<<14)
+#define	B15 (1U<<15)
+#define B16 (1UL<<16)
+#define B17 (1UL<<17)
+#define B18 (1UL<<18)
+#define	B19 (1UL<<19)
+#define B20 (1UL<<20)
+#define B21 (1UL<<21)
+#define B22 (1UL<<22)
+#define B23 (1UL<<23)
+#define B24 (1UL<<24)
+#define B25 (1UL<<25)
+#define B26 (1UL<<26)
+#define B27 (1UL<<27)
+#define B28 (1UL<<28)
+#define B29 (1UL<<29)
+#define B30 (1UL<<30)
+#define B31 (1UL<<31)
+
+#define BIT(pos) (1UL<<(pos))
+
+#define	BIGINT	0x40000000 // big int value
+
+#define _T(a) a
+
+#define PI 3.14159265358979324
+#define PI2 (3.14159265358979324*2)
+
+// ----------------------------------------------------------------------------
+//                                   Includes
+// ----------------------------------------------------------------------------
+
+// fonts
+extern const ALIGNED u8 FontBold8x8[2048];
+extern const ALIGNED u8 FontBold8x14[3584];
+extern const ALIGNED u8 FontBold8x16[4096];
+extern const ALIGNED u8 FontBoldB8x14[3584];
+extern const ALIGNED u8 FontBoldB8x16[4096];
+extern const ALIGNED u8 FontGame8x8[2048];
+extern const ALIGNED u8 FontIbm8x8[2048];
+extern const ALIGNED u8 FontIbm8x14[3584];
+extern const ALIGNED u8 FontIbm8x16[4096];
+extern const ALIGNED u8 FontIbmTiny8x8[2048];
+extern const ALIGNED u8 FontItalic8x8[2048];
+extern const ALIGNED u8 FontThin8x8[2048];
+
+// PicoVGA includes
+#include "define.h"	// common definitions of C and ASM
+#include "util/canvas.h" // canvas
+#include "util/overclock.h" // overclock
+#include "util/print.h" // print to attribute text buffer
+#include "util/rand.h"	// random number generator
+#include "util/mat2d.h" // 2D transformation matrix
+#include "util/pwmsnd.h" // PWM sound output
+#include "vga_pal.h"	// VGA colors and palettes
+#include "vga_vmode.h"	// VGA videomodes
+#include "vga_layer.h"	// VGA layers
+#include "vga_screen.h" // VGA screen layout
+#include "vga_util.h"	// VGA utilities
+#include "vga.h"	 // VGA output
+
+#endif
diff --git a/src/util/canvas.cpp b/src/util/canvas.cpp
index aba4c9a..47a422c 100644
--- a/src/util/canvas.cpp
+++ b/src/util/canvas.cpp
@@ -5,7 +5,11 @@
 //
 // ****************************************************************************
 
-#include "include.h"
+#include "pico/stdlib.h"
+#include "picovga.h"
+#include <string.h>
+
+#include "hardware/interp.h"
 
 // Draw rectangle
 //  col with CANVAS_ATTRIB8 format: bit 0..3 = draw color, bit 4 = draw color is background color
diff --git a/src/util/mat2d.cpp b/src/util/mat2d.cpp
index 962c810..1d1257c 100644
--- a/src/util/mat2d.cpp
+++ b/src/util/mat2d.cpp
@@ -5,7 +5,7 @@
 //
 // ****************************************************************************
 
-#include "include.h"
+#include "mat2d.h"
 
 // prepare transformation matrix (for DrawImgMat function)
 //  ws ... source image width
diff --git a/src/util/mat2d.h b/src/util/mat2d.h
index 2f922d6..c241743 100644
--- a/src/util/mat2d.h
+++ b/src/util/mat2d.h
@@ -8,6 +8,9 @@
 #ifndef _MAT2D_H
 #define _MAT2D_H
 
+#include "pico/double.h"
+#include "define.h"
+
 // transformation matrix
 template <typename m2type> class cMat2D 
 {
diff --git a/src/util/overclock.cpp b/src/util/overclock.cpp
index ad3194f..890fbc9 100644
--- a/src/util/overclock.cpp
+++ b/src/util/overclock.cpp
@@ -5,7 +5,10 @@
 //
 // ****************************************************************************
 
-#include "include.h"
+#include "picovga.h"
+#include "overclock.h"
+#include "hardware/clocks.h"
+#include "hardware/structs/ssi.h"
 
 // Search PLL setup
 //  reqkhz ... required output frequency in kHz
diff --git a/src/util/overclock.h b/src/util/overclock.h
index 8779d5b..8e87dbe 100644
--- a/src/util/overclock.h
+++ b/src/util/overclock.h
@@ -8,6 +8,8 @@
 #ifndef _OVERCLOCK_H
 #define _OVERCLOCK_H
 
+#include "pico/stdlib.h"
+
 // Search PLL setup
 //  reqkhz ... required output frequency in kHz
 //  input ... PLL input frequency in kHz (default 12000, or use clock_get_hz(clk_ref)/1000)
diff --git a/src/util/print.cpp b/src/util/print.cpp
index 585313e..890debe 100644
--- a/src/util/print.cpp
+++ b/src/util/print.cpp
@@ -5,7 +5,7 @@
 //
 // ****************************************************************************
 
-#include "include.h"
+#include "picovga.h"
 
 // current print buffer
 u8* PrintBuf;
diff --git a/src/util/pwmsnd.cpp b/src/util/pwmsnd.cpp
index 17a464a..c0f0088 100644
--- a/src/util/pwmsnd.cpp
+++ b/src/util/pwmsnd.cpp
@@ -6,7 +6,10 @@
 // ****************************************************************************
 // Note: Cannot use DMA, because sample is 8-bit, but CC port requires 16-bit write.
 
-#include "include.h"
+#include "picovga.h"
+#include "hardware/pwm.h"
+#include "hardware/clocks.h"
+#include "hardware/sync.h"
 
 // current sound
 const u8* CurSound = NULL; // current playing sound
diff --git a/src/util/rand.cpp b/src/util/rand.cpp
index 67c5f69..02f8e4c 100644
--- a/src/util/rand.cpp
+++ b/src/util/rand.cpp
@@ -5,7 +5,8 @@
 //
 // ****************************************************************************
 
-#include "include.h"
+#include "picovga.h"
+#include "hardware/structs/rosc.h"
 
 // global random generator
 cRandom Rand;
diff --git a/src/vga.cpp b/src/vga.cpp
index 7f52bd5..4064391 100644
--- a/src/vga.cpp
+++ b/src/vga.cpp
@@ -5,9 +5,17 @@
 //
 // ****************************************************************************
 
-#include "include.h"
+#include "pico/stdlib.h"
+#include "pico/printf.h"
+
+#include "picovga.h"
 #include "vga.pio.h"
 
+#include <string.h>
+#include "hardware/divider.h"
+#include "hardware/dma.h"
+#include "hardware/sync.h"
+
 // scanline type
 u8 ScanlineType[MAXLINE];
 
diff --git a/src/vga_layer.cpp b/src/vga_layer.cpp
index b9c17db..19331ea 100644
--- a/src/vga_layer.cpp
+++ b/src/vga_layer.cpp
@@ -5,9 +5,12 @@
 //
 // ****************************************************************************
 
-#include "include.h"
+#include "pico/stdlib.h"
+#include "picovga.h"
+#include "hardware/sync.h"
 #include "vga.pio.h"
 
+
 // layer program descriptors
 const sLayerProg LayerProg[LAYERPROG_NUM] = {
 
diff --git a/src/vga_pal.cpp b/src/vga_pal.cpp
index 5d71fa1..2a44a46 100644
--- a/src/vga_pal.cpp
+++ b/src/vga_pal.cpp
@@ -5,7 +5,8 @@
 //
 // ****************************************************************************
 
-#include "include.h"
+#include "pico/stdlib.h"
+#include "picovga.h"
 
 // default 16-color palettes (EGA colors)
 // - do not set "const", to stay in faster RAM
diff --git a/src/vga_screen.cpp b/src/vga_screen.cpp
index 0cd92e8..c350e15 100644
--- a/src/vga_screen.cpp
+++ b/src/vga_screen.cpp
@@ -5,7 +5,9 @@
 //
 // ****************************************************************************
 
-#include "include.h"
+#include "pico/stdlib.h"
+#include "picovga.h"
+#include "hardware/sync.h"
 
 // current video screen
 sScreen Screen = { .num = 0 };	// default video screen
diff --git a/src/vga_util.cpp b/src/vga_util.cpp
index 600db69..499a8b6 100644
--- a/src/vga_util.cpp
+++ b/src/vga_util.cpp
@@ -5,7 +5,10 @@
 //
 // ****************************************************************************
 
-#include "include.h"
+#include "pico/stdlib.h"
+
+#include "picovga.h"
+#include <string.h>
 
 // convert image from 16-color to 8x8 attribute format
 void Attr8Conv(u8* dst, u8* attr, const u8* src, int w, int h, const u8* pal)
diff --git a/src/vga_vmode.cpp b/src/vga_vmode.cpp
index 28ed4e8..efe3e4b 100644
--- a/src/vga_vmode.cpp
+++ b/src/vga_vmode.cpp
@@ -5,7 +5,11 @@
 //
 // ****************************************************************************
 
-#include "include.h"
+#include "pico/stdlib.h"
+#include "pico/printf.h"
+#include "pico/multicore.h"
+#include "picovga.h"
+
 
 sVmode Vmode;	// videomode setup
 sVgaCfg Cfg;	// required configuration