xboxdev / a56 Goto Github PK

Modernized fork of a56, a DSP56001 assembler

Makefile 2.36% C 44.34% Yacc 53.02% Awk 0.29%

a56 assembler dsp dsp56001 dsp56300 motorola

a56's Introduction

XboxDev

XboxDev is the place for all original Xbox projects to come together.

XboxDev is an effort to provide tools and documentation for the original Microsoft Xbox and Xbox-based SEGA Chihiro. We not only care about technical details about those platforms, but also how to develop homebrew and emulate them.

We are not interested in documenting the Xbox 360, Xbox One or any other console at this point.

You can create an issue to contact XboxDev maintainers.

Ecosystem

We currently provide the following services:

Discord for communication
XboxDevWiki to document research
GitHub organization to host tools and files

Want to help? Contact us!

Please come chat with us:

XboxDev on Discord

and for closely related projects:

XQEMU: #xqemu on Freenode IRC (Webchat)
Cxbx-Reloaded: Discord

You'll also get the details for XboxDevWiki account creation on any of these channels.

Coding style

The usual rule is: follow the existing code / commit style of whatever you are working on. If the previous commits use prefix style: use prefix style. If the surrounding code respects 80 column limit: respect it. If the surrounding code uses an unusual C style: mimic it.

Disclaimer

XboxDev is not affiliated with, endorsed by, or sponsored by Microsoft Corporation, Nvidia Corporation, licensed Xbox developers, publishers, manufacturers or any of their affiliates or subsidiaries. All product and company names are trademarks™ or registered® trademarks of their respective holders. Use of them does not imply any affiliation with or endorsement by them.

Reverse engineering of the original software and hardware is done to achieve interoperability with other computing platforms. In the process, excerpts of the reverse engineered source code will be shown for educational purposes.

No copyright infringement is intended at any stage during creation of XboxDev software, hardware or documentation.

a56's People

Stargazers

Watchers

Forkers

jayfoxrox strikerx3 discostarslayer photondreams libbers tiretrak

a56's Issues

Add CI badge to README

The CI from #12 is currently well-hidden, we should add the badge to the README.

The CI is at https://ci.appveyor.com/project/xboxdev-bot/a56

Improve release distribution

a56 does have CI artifacts since #12, but they are not stored permanently.

We should set-up GitHub releases, because updates for a56 will likely be months apart, so artifacts might not survive.

Improve CI artifacts

Some minor issues with #12:

keybld should not be included
torom should be included
Should include the examples

Missing instruction: "LSL #ii,D" and "LSL S,D"

Non-parallel LSL (and other shifts) are missing.

Add original website to README

http://www.zdomain.com/a56.html should be added to the README.

I'd like to avoid it as the repository URL because it's outdated.

Move to C11

The current code is very K&R C heavy and hard to read with a modern mindset.

I'm not sure if clang-format or something could do this job for us.

Review changes in rkujawa/a56

Apparently @rkujawa had done similar work: https://github.com/rkujawa/a56
There's probably still some useful information in that, although I had a56 working as-is in this repo about a year ago (without drastic changes such as removing getopt.c).

Missing instruction: "INC D" and "DEC D"

These appear to be missing.

Switch to CMake build system

Most of XboxDev runs on CMake now.

I have an old prototype here: JayFoxRox#2
I currently have no interest in completing it.

test

This is a test issue for webhooks. Please ignore.

`MOVE` to a control reg generates bogus code

From the original README:

always use MOVEC, MOVEM, and MOVEP

Fix broken examples

We had reports, that most example code does not work (crashes a56 if I remember correctly). It is not known what causes this.

[examples]$ make
cpp -Uicon caltone.a56 > tmp.a56
../a56 -o caltone.out tmp.a56 > caltone.lis
/bin/sh: line 1: 13393 Segmentation fault      (core dumped) ../a56 -o caltone.out tmp.a56 > caltone.lis
make: *** [Makefile:21: caltone.omf] Error 139

a56 should always provide meaningful output instead of just crashing.

We should identify those cases, fix the examples and fix a56.
Because this could be a lengthy task, it would already be good if someone reviewed all examples and created an issue for each broken one, unless a common issue can be identified (which can be discussed here).

Get rid of `gets`

My linker keeps warning me about this:

toomf.c:(.text+0x9e): warning: the `gets' function is dangerous and should not be used.

It's easy enough to replace with fgets(buf, sizeof(buf), stdin)