Author Topic: Updated PCE development information page?  (Read 999 times)

Arkhan

  • Hero Member
  • *****
  • Posts: 14142
  • Fuck Elmer.
    • Incessant Negativity Software
Updated PCE development information page?
« on: February 20, 2017, 05:14:49 AM »
We don't have a "nesdev.com" , or any centralized source of information. 

We have the mostly defunct Archaic Pixels, info floating around ChrlyMac's site, and stuff on Tom, or Magic Engine's places.

since I highly doubt anyone wants to maintain a site+wiki, I fired up a Wikia.

http://pcedev.wikia.com/?wiki-welcome=1

Should we use this instead, and centralize crap?  Enterprising individuals with copious amounts of free time could sit and migrate stuff, or add new stuff.   Maybe centralizing crap would be a good idea.

Assuming people like the idea, should we basically mimic the categories of NesDev?

on the topic of mirroring documents, does anyone have a place they can do that from? 

I can make a new dropbox as one point of linkage. 



I think this would work better than relying on one of us to maintain a site.   I can't even find time (or motivation) to finish PCFXTOO because it turns out doing webpage stuff is kind of tedious and boring.

Everyone else is busy or gets sidetracked easily...

so this takes most of the effort away.   

What do we think?


EDIT: Also, assuming this is good to go, we should migrate the forum topics here where we can, because these stickied threads are only visible to registered members.   Not everyone does that.
[Fri 19:34]<nectarsis> been wanting to try that one for awhile now Ope
[Fri 19:33]<Opethian> l;ol huge dong

I'm a max level Forum Warrior.  I'm immortal.
If you're not ready to defend your claims, don't post em.

Gredler

  • Guest
Re: Updated PCE development information page?
« Reply #1 on: February 20, 2017, 06:31:51 AM »


This is great, thanks for starting this. If nothing else a fat dump of info anywhere in text form is great for a base to manicure and display elsewhere.

I've never contributed to a public wiki, but I'd love to document whatever I can from an art standpoint.

Arkhan

  • Hero Member
  • *****
  • Posts: 14142
  • Fuck Elmer.
    • Incessant Negativity Software
Re: Updated PCE development information page?
« Reply #2 on: February 20, 2017, 06:36:17 AM »
Ideally, a non-service-place-hosted Wiki would be better, but...

I personally don't want to be the one responsible for the hosting/etc.    We're already doing Aetherbyte and PCFXTOO (lol kinda), and Paul does Sunteam/PCESB, so it's not like either of us is going to want to get down on f*cking with a Wiki to.

If everyone seems OK, later tonight or something I can lay out the basic things, and figure out how to make it so not just any random dingus can show up and be like

THIS THING HAS TWO 8 BIT CPUS, LOL.

[Fri 19:34]<nectarsis> been wanting to try that one for awhile now Ope
[Fri 19:33]<Opethian> l;ol huge dong

I'm a max level Forum Warrior.  I'm immortal.
If you're not ready to defend your claims, don't post em.

elmer

  • Hero Member
  • *****
  • Posts: 2148
Re: Updated PCE development information page?
« Reply #3 on: February 20, 2017, 07:52:37 AM »
since I highly doubt anyone wants to maintain a site+wiki, I fired up a Wikia.

http://pcedev.wikia.com/?wiki-welcome=1

Should we use this instead, and centralize crap?  Enterprising individuals with copious amounts of free time could sit and migrate stuff, or add new stuff.   Maybe centralizing crap would be a good idea.

Excellent idea!  :clap:


Quote
on the topic of mirroring documents, does anyone have a place they can do that from? 

I can make a new dropbox as one point of linkage.

I'm still hoping to get the PCE Developer docs up on esteban's tg-16.com, but really, they can go anywhere (except, probably, wikia itself).


Quote
I think this would work better than relying on one of us to maintain a site.   I can't even find time (or motivation) to finish PCFXTOO because it turns out doing webpage stuff is kind of tedious and boring.

Everyone else is busy or gets sidetracked easily...

so this takes most of the effort away.   

What do we think?

I think that you're spot-on, and have a good solution.  :D

I do not want to run a website ... but wouldn't mind occasionally rarely editing a page-or-two, here-or-there.


THIS THING HAS TWO 8 BIT CPUS, LOL.

A "Myths" page might not be inappropriate.  :wink:

Arkhan

  • Hero Member
  • *****
  • Posts: 14142
  • Fuck Elmer.
    • Incessant Negativity Software
Re: Updated PCE development information page?
« Reply #4 on: February 20, 2017, 07:54:21 AM »
I think as everyone's developed, especially back in the day, we all just shared around the various docs to each other either on here, magicengine forum, or on IRC,

but now, some of that has gone a bit tits up so it doesn't work as well anymore.

[Fri 19:34]<nectarsis> been wanting to try that one for awhile now Ope
[Fri 19:33]<Opethian> l;ol huge dong

I'm a max level Forum Warrior.  I'm immortal.
If you're not ready to defend your claims, don't post em.

nodtveidt

  • Guest
Re: Updated PCE development information page?
« Reply #5 on: February 20, 2017, 08:37:32 AM »
This is exactly what I was talking about. Count me in.

Punch

  • Hero Member
  • *****
  • Posts: 3278
Re: Updated PCE development information page?
« Reply #6 on: February 20, 2017, 08:40:15 AM »
This is excellent.

fragmare

  • Hero Member
  • *****
  • Posts: 676
Re: Updated PCE development information page?
« Reply #7 on: February 20, 2017, 09:26:48 AM »
Centralization of informational resources is NEVER a bad thing.  Do it.

Arkhan

  • Hero Member
  • *****
  • Posts: 14142
  • Fuck Elmer.
    • Incessant Negativity Software
Re: Updated PCE development information page?
« Reply #8 on: February 20, 2017, 04:31:37 PM »
Update:

Wikia's editor and crap is pretty terrible.   Is this normal?   I feel like GeoCities/AOL Hometown was less goony.

Going to fiddle around and/or try a different one.

EDIT: Nevermind, I got it. 

I need to find out how to lock this bitch down so Sega16 members don't find it and add stupid information like "can't even blast process" or "can't even does what Nintendon't"

this should work fine to centralize everything. 

post your user names at Wikia here if you plan on contributing.   I think I can add you directly and let you touch stuff.

« Last Edit: February 20, 2017, 04:46:58 PM by Arkhan »
[Fri 19:34]<nectarsis> been wanting to try that one for awhile now Ope
[Fri 19:33]<Opethian> l;ol huge dong

I'm a max level Forum Warrior.  I'm immortal.
If you're not ready to defend your claims, don't post em.

Arkhan

  • Hero Member
  • *****
  • Posts: 14142
  • Fuck Elmer.
    • Incessant Negativity Software
Re: Updated PCE development information page?
« Reply #9 on: February 20, 2017, 05:20:17 PM »
OK:

Lets talk about migration strategies for Archaic Pixels.   I don't know what software it was made with.  I think Gravis (?) and maybe Tom have rights to that place.   

There *is* useful information there.... but...

1) "Archaic Pixels" is ambiguous and nobody ever finds it unless they're told to go there
2) Nobody can edit/add/update, so that is kind of goofy.

I think we can migrate that stuff over, including all of the relevant pieces parts of the other pages.

The wiki now has a "starting" layout that I've skeleton'd in there.

Once more people are registered and willing to contribute, we can do that "collaborating" thing.

Wikia seems to use this jazzed up navigation bar at the top for going to various pages instead of a box.   I've not sorted out completely how to deal with that yet, since I am waiting to see what everyone thinks, and what everyone might want to do.

I think each section in the "reference" area for example should have a brief "wtf is this", followed by a link to the relevant page.   Meaning, we make a HuC6280 page, and essentially mimic the Wikipedia Entry:

https://en.wikipedia.org/wiki/Hudson_Soft_HuC6280

and then we do the same for all of the other sections, including listing the instruction set.

These pages can then be barfed into the nav-panel at the top.


It would be nice if we could somehow magically copy-pasta the source from AP's wiki to this one, but I don't know that they are compatible markup languages.
[Fri 19:34]<nectarsis> been wanting to try that one for awhile now Ope
[Fri 19:33]<Opethian> l;ol huge dong

I'm a max level Forum Warrior.  I'm immortal.
If you're not ready to defend your claims, don't post em.

nodtveidt

  • Guest
Re: Updated PCE development information page?
« Reply #10 on: February 20, 2017, 11:53:59 PM »
I'll jump on board this evening. Got a full day of chaos ahead. Never a dull moment 'round these parts.

Pokun

  • Full Member
  • ***
  • Posts: 153
Re: Updated PCE development information page?
« Reply #11 on: February 21, 2017, 12:13:11 AM »
Wow this happened a lot faster than I dreamed of! :D
A wiki is the way to go. That way we can add newly discovered things or fix mistakes easily.

I need to find out how to lock this bitch down so Sega16 members don't find it and add stupid information like "can't even blast process" or "can't even does what Nintendon't"
lol

Quote
Lets talk about migration strategies for Archaic Pixels.   I don't know what software it was made with.  I think Gravis (?) and maybe Tom have rights to that place.   

There *is* useful information there.... but...

1) "Archaic Pixels" is ambiguous and nobody ever finds it unless they're told to go there
2) Nobody can edit/add/update, so that is kind of goofy.

I think we can migrate that stuff over, including all of the relevant pieces parts of the other pages.
Yeah it has good info about some of the hardware, and I guess for HuC. It's not much about assembly though. Also a lot of broken pages.


A few things I'd suggest the wiki should eventually explain (not sure in what sections everything would go though):

* Explain all registers for the built-in hardware and add-on hardware in the appropriate sections. Preferibly using official names and terms of things, like both Archaic Pixels and Charles McDonald already partly do.
* Explain all known differences between the original and revisioned HuC6280 (and HuC6260). Only thing I could find is that HuC6280A fixes some volume centering issues in the PSG.
* A list of the reset state of the PC Engine (a list is in the dev docs CPU hardware manual).
* A list of things that needs to be initialized after reset and example init code. I just initialize about all registers, except the DMA ones (since one of them triggers DMA) and some of the PSG registers, just in case.
* An explanation on how to set display resolution as well as showing what commercial games usually set it to.
* How to setup a banking system to map in necessary banks as needed.
* How to upload Background Characters to VRAM.
* How to upload Sprites to VRAM and setup VRAM-SATB DMA to update Sprites.
* How to scroll.
* How to make sound. A simple sound routine that can play sound effects or notes at a specified tempo using the TIMER interrupt or something is fine I guess. Not even Nesdev wiki has this though.
* General program structuring. How the main program loop and interrupts are setup.
* Backup RAM section. Explain the save file format and example code how to read and write to it. The only info about BRAM I've found is in the Magickit library.
* Input devices hardware info and how to read them (with example code). Pad, Mouse, Tsuushin Keyboard etc.
* Whatever we know about Memory Base 128 and Save-kun.
* Everdrive section
* HuCard ROM sizes and mapping (including how emulators handles the 384 kB ROM, and Street Fighter II' mapper).
* CD image format.
* PC Engine GT Com Cable pinout and protocol. I've found zero info about this (other than that it has standard 3.5 mm TRS stereo cable plugs).
* A Super Grafx section. I guess each section could have a Super Grafx paragraph added to it, that explains how things work for the SGX case.

Some of these are maybe more newbie turorial things than reference material I guess. Also these are mostly from a PC Engine developer's view. I guess an emulator developer would want more hardware quirk details.

TailChao

  • Full Member
  • ***
  • Posts: 156
Re: Updated PCE development information page?
« Reply #12 on: February 21, 2017, 01:47:52 AM »
* PC Engine GT Com Cable pinout and protocol. I've found zero info about this (other than that it has standard 3.5 mm TRS stereo cable plugs).

It's better not to know.
In short, it's all bitbanged through CLR and SEL unless there's some piece of hardware I don't know about. Kinda lazy.
« Last Edit: February 21, 2017, 11:38:09 AM by TailChao »

Pokun

  • Full Member
  • ***
  • Posts: 153
Re: Updated PCE development information page?
« Reply #13 on: February 21, 2017, 11:11:21 AM »
Oh well thanks for sharing this information. So the COM port seems to be basically a stripped-down controller port with only pins 6, 7 and 8 (unless there are some more hardware involved).

I guess it would be easy to make a Com Link adapter for any PC Engine.

nodtveidt

  • Guest
Re: Updated PCE development information page?
« Reply #14 on: February 21, 2017, 11:56:43 AM »
I set up a wikia account under the username TheOldRover.