minicast/libswirl/build.h at main · pepasjc/minicast

Repository navigation

History

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

225

226

227

228

229

230

231

232

233

234

235

236

237

238

239

240

241

242

243

244

245

246

247

248

249

250

251

252

253

254

255

256

257

258

259

260

261

262

263

264

265

266

267

268

269

270

271

272

273

274

275

276

277

278

279

280

281

282

283

284

285

286

287

288

289

290

291

292

293

294

295

296

297

298

299

300

301

302

303

304

305

306

307

308

309

310

311

312

313

314

315

316

317

318

319

320

321

322

323

324

325

326

327

328

329

330

331

332

333

334

335

336

337

338

339

340

341

342

343

344

345

346

347

348

349

350

351

352

353

354

355

356

357

358

359

360

361

362

363

364

365

366

367

368

369

370

371

372

373

374

375

376

377

378

379

380

381

382

383

384

385

386

387

388

389

390

391

392

393

394

395

396

397

398

399

400

401

402

403

404

405

406

407

408

409

410

411

412

413

414

415

416

417

418

419

420

421

422

423

424

425

426

427

428

429

430

431

432

433

434

435

436

437

438

439

440

441

442

443

444

445

446

447

448

449

450

451

452

453

454

455

456

457

458

459

460

461

462

463

464

465

466

467

468

469

470

This file is part of libswirl

#include "license/bsd"

reicast build options

Reicast can support a lot of stuff, and this is an attempt

to organize the build time options

Option categories

BUILD_* - BUILD_COMPILER, etc...

definitions about the build machine

HOST_*

definitions about the host machine

FEAT_*

definitions about the features that this build targets

This is higly related to HOST_*, but it's for options that might

or might not be avaiable depending on the target host, or that

features that are irrelevant of the host

Eg, Alsa, Pulse Audio and OSS might sense as HOST dedinitions

but it usually makes more sense to detect them as runtime. In

that context, HOST_ALSA makes no sense because the host might

or might not have alsa installed/ running

MMU makes no sense as a HOST definition at all, so it should

be FEAT_HAS_MMU

TARGET_*

A preconfigured default. Eg TARGET_WIN86.

Naming of options, option values, and how to use them

for options that makes sense to have a list of values

{CATEGORY}_{OPTION}

{OPTION}_{VALUE}

eg.

BUILD_COMPILER == COMPILER_GCC, HOST_CPU != CPU_X64, ...

for options that are boolean

{CATEGORY}_IS_{OPTION} or {CATEGORY}_HAS_{OPTION}

Evaluates to 0 or 1

If an configuration cannot be neatly split into a set of

of orthogonal options, then it makes sense to break things

to "sets" or have a hierarchy of options.

Example

-------

In the beggining it made sense to have an audio backend

per operating system. It made sense to have it depend

on HOST_OS and seleect DirectSound or alsa.

// no option needed

Then, as android was introduced, which also uses OS_LINUX

atm, the audio could have been made an option. It could be

a HOST_* option, or FEAT_* one. I'd prefer FEAT_*.

FEAT_* makes more sense as future wise we might want

to support multiple backends.

FEAT_AUDIO_BACKEND

AUDIO_BACKEND_NONE

AUDIO_BACKEND_DS

AUDIO_BACKEND_ALSA

AUDIO_BACKEND_ANDROID

Used like

#if FEAT_AUDIO_BACKEND == AUDIO_BACKEND_DS ....

At some point, we might have multiple audio backends that

can be compiled in and autodetected/selected at runtime.

In that case, it might make sense to have the options like

FEAT_HAS_ALSA

FEAT_HAS_DIRECTSOUND

FEAT_HAS_ANDROID_AUDIO

FEAT_HAS_AUDIO_ALSA

FEAT_HAS_AUDIO_DS

FEAT_HAS_AUDIO_ANDROID

The none option might or might not make sense. In this

case it can be removed, as it should always be avaiable.

Guidelines

----------

General rule of thumb, don't overcomplicate things. Start

with a simple option, and then make it more complicated

as new uses apply (see the example above)

Don't use too long names, don't use too cryptic names.

Most team developers should be able to understand or

figure out most of the acronyms used.

Try to be consistent on the acronyms across all definitions

Code shouldn't depend on build level options whenever possible

Generally, the file should compile even if the option/module is

disabled. This makes makefiles etc much easier to write

TARGET_* options should generally only be used in this file

The current source is *not* good example of these guidelines

We'll try to be smart and figure out some options/defaults on this file

but this shouldn't get too complicated

#define NO_MMU

#define DC_PLATFORM_MASK 7

#define DC_PLATFORM_DREAMCAST 0 /* Works, for the most part */

#define DC_PLATFORM_DEV_UNIT 1 /* This is missing hardware */

#define DC_PLATFORM_NAOMI 2 /* Works, for the most part */

#define DC_PLATFORM_NAOMI2 3 /* Needs to be done, 2xsh4 + 2xpvr + custom TNL */

#define DC_PLATFORM_ATOMISWAVE 4 /* Needs to be done, DC-like hardware with possibly more ram */

#define DC_PLATFORM_HIKARU 5 /* Needs to be done, 2xsh4, 2x aica , custom vpu */

#define DC_PLATFORM_AURORA 6 /* Needs to be done, Uses newer 300 mhz sh4 + 150 mhz pvr mbx SoC */

//HOST_OS

#define OS_WINDOWS 0x10000001

#define OS_LINUX 0x10000002

#define OS_DARWIN 0x10000003

#define OS_IOS 0x10000004

#define OS_ANDROID 0x10000005

#define OS_XIL_BARE 0x10000006

#define OS_UWP 0x10000011

#define OS_NSW_HOS 0x80000001

#define OS_PS4_BSD 0x80000002

//HOST_CPU

#define CPU_X86 0x20000001

#define CPU_ARM 0x20000002

#define CPU_MIPS 0x20000003

#define CPU_X64 0x20000004

#define CPU_GENERIC 0x20000005 //used for pnacl, emscripten, etc

#define CPU_PPC 0x20000006

#define CPU_PPC64 0x20000007

#define CPU_ARM64 0x20000008

#define CPU_MIPS64 0x20000009

//BUILD_COMPILER

#define COMPILER_VC 0x30000001

#define COMPILER_GCC 0x30000002

#define COMPILER_CLANG 0x30000003

#define COMPILER_INTEL 0x30000004

//FEAT_SHREC, FEAT_AREC, FEAT_DSPREC

#define DYNAREC_NONE 0x40000001

#define DYNAREC_JIT 0x40000002

#define DYNAREC_CPP 0x40000003

//TARGET_LICENSE

#define LICENSE_BSD 0x50000001

#define LICENSE_LGPL 0x50000002

#define LICENSE_GPL 0x50000003

//FEAT_TA

#define TA_HLE 0x60000001

#define TA_LLE 0x60000002

//automatic

#if !defined(TARGET_LICENSE)

#define TARGET_LICENSE LICENSE_GPL

#endif

#if !defined(FEAT_TA)

#define FEAT_TA TA_LLE // default to LLE TA

#endif

#ifndef CMAKE_BUILD

#if defined(_WIN32) && !defined(TARGET_WIN86) && !defined(TARGET_WIN64)

#if !defined(_M_AMD64) && !defined(__x86_64__)

#define TARGET_WIN86

#else

#define TARGET_WIN64

#endif

#if defined(__clang__)

#define BUILD_COMPILER COMPILER_CLANG

#elif __GNUC__

#define BUILD_COMPILER COMPILER_GCC

#else

#define BUILD_COMPILER COMPILER_VC

#endif

//Targets

#if defined(TARGET_WIN86)

#define HOST_OS OS_WINDOWS

#define HOST_CPU CPU_X86

#elif defined(TARGET_WIN64)

#define HOST_OS OS_WINDOWS

#define HOST_CPU CPU_X64

#elif defined(TARGET_PANDORA)

#define HOST_OS OS_LINUX

#define HOST_CPU CPU_ARM

#elif defined(TARGET_LINUX_ARMELv7)

#define HOST_OS OS_LINUX

#define HOST_CPU CPU_ARM

#elif defined(TARGET_LINUX_ARMv8)

#define HOST_OS OS_LINUX

#define HOST_CPU CPU_ARM64

#elif defined(TARGET_LINUX_x86)

#define HOST_OS OS_LINUX

#define HOST_CPU CPU_X86

#elif defined(TARGET_LINUX_x64)

#define HOST_OS OS_LINUX

#define HOST_CPU CPU_X64

#elif defined(TARGET_LINUX_MIPS)

#define HOST_OS OS_LINUX

#define HOST_CPU CPU_MIPS

#elif defined(TARGET_GCW0)

#define HOST_OS OS_LINUX

#define HOST_CPU CPU_MIPS

#elif defined(TARGET_NACL32) || defined(TARGET_EMSCRIPTEN)

#define HOST_OS OS_LINUX

#define HOST_CPU CPU_GENERIC

#elif defined(TARGET_IPHONE)

#define HOST_OS OS_DARWIN

#define HOST_CPU CPU_ARM

#elif defined(TARGET_OSX)

#define HOST_OS OS_DARWIN

#define HOST_CPU CPU_X86

#elif defined(TARGET_OSX_X64)

#define HOST_OS OS_DARWIN

#define HOST_CPU CPU_X64

#elif defined(TARGET_ULTRA96)

#define HOST_OS OS_XIL_BARE

#define HOST_CPU CPU_ARM64

#elif defined(TARGET_MISTER)

#define HOST_OS OS_LINUX

#define HOST_CPU CPU_ARM

#else

#error Invalid Target: TARGET_* not defined

#endif

#if defined(TARGET_NAOMI)

#define DC_PLATFORM DC_PLATFORM_NAOMI

#undef TARGET_NAOMI

#endif

#if defined(TARGET_NO_REC)

#define FEAT_SHREC DYNAREC_NONE

#define FEAT_AREC DYNAREC_NONE

#define FEAT_DSPREC DYNAREC_NONE

#endif

#if defined(TARGET_NO_AREC)

#define FEAT_SHREC DYNAREC_JIT

#define FEAT_AREC DYNAREC_NONE

#define FEAT_DSPREC DYNAREC_NONE

#endif

#if defined(TARGET_NO_JIT)

#define FEAT_SHREC DYNAREC_CPP

#define FEAT_AREC DYNAREC_NONE

#define FEAT_DSPREC DYNAREC_NONE

#endif

#endif // !CMAKE_BUILD

#if defined(TARGET_NO_NIXPROF)

#define FEAT_HAS_NIXPROF 0

#endif

#if defined(TARGET_NO_COREIO_HTTP)

#define FEAT_HAS_COREIO_HTTP 0

#endif

#if defined(TARGET_SOFTREND)

#define FEAT_HAS_SOFTREND 1

#endif

//defaults

#ifndef DC_PLATFORM

#define DC_PLATFORM DC_PLATFORM_DREAMCAST

#endif

#ifndef FEAT_SHREC

#define FEAT_SHREC DYNAREC_JIT

#endif

#ifndef FEAT_AREC

#if HOST_CPU == CPU_ARM || HOST_CPU == CPU_ARM64

#define FEAT_AREC DYNAREC_JIT

#else

#define FEAT_AREC DYNAREC_NONE

#endif

#ifndef FEAT_DSPREC

#if HOST_CPU == CPU_X86 || HOST_CPU == CPU_ARM64

#define FEAT_DSPREC DYNAREC_JIT

#else

#define FEAT_DSPREC DYNAREC_NONE

#endif

#ifndef FEAT_HAS_NIXPROF

#if HOST_OS != OS_WINDOWS

#define FEAT_HAS_NIXPROF 1

#endif

#ifndef FEAT_HAS_COREIO_HTTP

#define FEAT_HAS_COREIO_HTTP 1

#endif

#ifndef FEAT_HAS_SOFTREND

// TODO: Test with Clang on other platforms, currently enabled for macOS only or it breaks the Android build, but may work fine on desktop Linux

//GCC wants us to enable sse4 globaly to enable intrins

#define FEAT_HAS_SOFTREND (BUILD_COMPILER == COMPILER_VC) || (BUILD_COMPILER == COMPILER_CLANG && HOST_OS == OS_DARWIN)

#endif

#ifndef FEAT_HAS_SERIAL_TTY

#if (HOST_OS == OS_LINUX && !defined(_ANDROID)) || (HOST_OS == OS_DARWIN && !TARGET_OS_IPHONE && !TARGET_IPHONE_SIMULATOR)

#define FEAT_HAS_SERIAL_TTY 1

#else

#define FEAT_HAS_SERIAL_TTY 0

#endif

//Depricated build configs

#ifdef HOST_NO_REC

#error Dont use HOST_NO_REC

#endif

#ifdef HOST_NO_AREC

#error Dont use HOST_NO_AREC

#endif

// Compiler Related

#define COMPILER_VC_OR_CLANG_WIN32 ((BUILD_COMPILER == COMPILER_VC) || (BUILD_COMPILER == COMPILER_CLANG) && (HOST_OS == OS_WINDOWS))

#if BUILD_COMPILER!=COMPILER_VC

#define ATTR_USED __attribute__((used))

#define ATTR_UNUSED __attribute__((used))

#else

#define ATTR_USED

#define ATTR_UNUSED

#endif

// TARGET PLATFORM

#define RAM_SIZE_MAX (32*1024*1024)

#define VRAM_SIZE_MAX (16*1024*1024)

#define ARAM_SIZE_MAX (8*1024*1024)

#if (DC_PLATFORM==DC_PLATFORM_DREAMCAST)

#define BUILD_DREAMCAST 1

//DC : 16 mb ram, 8 mb vram, 2 mb aram, 2 mb bios, 128k flash

#define RAM_SIZE (16*1024*1024)

#define VRAM_SIZE (8*1024*1024)

#define INTERNAL_ARAM_SIZE (2*1024*1024)

#define BIOS_SIZE (2*1024*1024)

#define FLASH_SIZE (128*1024)

#define ROM_PREFIX "dc_"

#define ROM_NAMES

#define NVR_OPTIONAL 0

#elif (DC_PLATFORM==DC_PLATFORM_DEV_UNIT)

#define BUILD_DEV_UNIT 1

//Devkit : 32 mb ram, 8? mb vram, 2? mb aram, 2? mb bios, ? flash

#define RAM_SIZE (32*1024*1024)

#define VRAM_SIZE (8*1024*1024)

#define INTERNAL_ARAM_SIZE (2*1024*1024)

#define BIOS_SIZE (2*1024*1024)

#define FLASH_SIZE (128*1024)

#define ROM_PREFIX "hkt_"

#define ROM_NAMES

#define NVR_OPTIONAL 0

#elif (DC_PLATFORM==DC_PLATFORM_NAOMI)

//Naomi : 32 mb ram, 16 mb vram, 8 mb aram, 2 mb bios, ? flash

#define RAM_SIZE (32*1024*1024)

#define VRAM_SIZE (16*1024*1024)

#define INTERNAL_ARAM_SIZE (8*1024*1024)

#define BIOS_SIZE (2*1024*1024)

#define BBSRAM_SIZE (32*1024)

#define ROM_PREFIX "naomi_"

#define ROM_NAMES ";epr-21576d.bin"

#define NVR_OPTIONAL 1

#elif (DC_PLATFORM==DC_PLATFORM_NAOMI2)

//Naomi2 : 32 mb ram, 16 mb vram, 8 mb aram, 2 mb bios, ? flash

#define RAM_SIZE (32*1024*1024)

#define VRAM_SIZE (16*1024*1024)

#define INTERNAL_ARAM_SIZE (8*1024*1024)

#define BIOS_SIZE (2*1024*1024)

#define BBSRAM_SIZE (32*1024)

#define ROM_PREFIX "n2_"

#define ROM_NAMES

#define NVR_OPTIONAL 1

#elif (DC_PLATFORM==DC_PLATFORM_ATOMISWAVE)

#define BUILD_ATOMISWAVE 1

//Atomiswave : 16 mb ram, 8 mb vram, 8 mb aram, 128kb bios on flash, 128kb battery-backed ram

#define RAM_SIZE (16*1024*1024)

#define VRAM_SIZE (8*1024*1024)

#define INTERNAL_ARAM_SIZE (8*1024*1024)

#define BIOS_SIZE (128*1024)

#define BBSRAM_SIZE (128*1024)

#define ROM_PREFIX "aw_"

#define ROM_NAMES ";bios.ic23_l"

#define NVR_OPTIONAL 1

#else

#error invalid build config

#endif

#define RAM_MASK (RAM_SIZE-1)

#define VRAM_MASK (VRAM_SIZE-1)

#define BIOS_MASK (BIOS_SIZE-1)

#ifdef FLASH_SIZE

#define FLASH_MASK (FLASH_SIZE-1)

#endif

#ifdef BBSRAM_SIZE

#define BBSRAM_MASK (BBSRAM_SIZE-1)

#endif

#define GD_CLOCK 33868800 //GDROM XTAL -- 768fs

#define AICA_CORE_CLOCK (GD_CLOCK*4/3) //[45158400] GD->PLL 3:4 -> AICA CORE -- 1024fs

#define ADAC_CLOCK (AICA_CORE_CLOCK/2) //[11289600] 44100*256, AICA CORE -> PLL 4:1 -> ADAC -- 256fs

#define AICA_ARM_CLOCK (AICA_CORE_CLOCK/2) //[22579200] AICA CORE -> PLL 2:1 -> ARM

#define AICA_SDRAM_CLOCK (GD_CLOCK*2) //[67737600] GD-> PLL 2 -> SDRAM

#define SH4_MAIN_CLOCK (200*1000*1000) //[200000000] XTal(13.5) -> PLL (33.3) -> PLL 1:6 (200)

#define SH4_RAM_CLOCK (100*1000*1000) //[100000000] XTal(13.5) -> PLL (33.3) -> PLL 1:3 (100) , also suplied to HOLLY chip

#define G2_BUS_CLOCK (25*1000*1000) //[25000000] from Holly, from SH4_RAM_CLOCK w/ 2 2:1 plls

FilesExpand file tree

build.h

Latest commit

History

build.h

File metadata and controls