zedide

Introduction

zedide is an in-development Integrated Development Environment (IDE) for writing Z80 assembler. It combines an editor, assembler, simulator and debugger in a single user interface, with server-side and browser-side storage for projects.

It is intended as an easy-to-use tool to introduce developers to assembly language without having to install large IDEs just to use a small part of them for assembly language. It also provides an alternative to more lightweight commandline tooling by being both instantly accessible and lightweight.

Why Z80?

The Zilog Z80 CPU is a clone of the Intel 8080, which Intel encapsulated as a subset of the 8086 instruction set. The Z80 has notable improvements over the 8080, but the intention is that the smaller subset of instructions is better suited to learning rather than a larger CPU architecture such as x86 or amd64: in essence, it is intended as a foothold in the assembly language arena before moving onto more complex architectures.

Running

A prebuilt live environment can be found at https://zedide.herokuapp.com/. However, to run your own server in a production environment, the following process must be followed for the first execution:

$ npm install
$ NODE_ENV=production npm run build
$ NODE_ENV=production npm run start

To run the server after this, simply run:

$ NODE_ENV=production npm run start

Please remember that you must set a MONGODB_URI environment variable containing the connection URI of your MongoDB instance (including authentication parameters).

Gratitude

zedide is based upon several opensource projects and uses a lot of libraries and owes immense gratitude to all of them.

Foremost, the opcode tables were borrowed from Philip Kendall's FUSE emulator (a fantastic ZX Spectrum emulator); the perl-based z80.c generator helped explain some of the more arcane behaviours of flag handling, as well as the sign/zero/parity/even flag tables and a good number of the opcodes which I was unfamiliar with.

JavaScript * CSS libraries:

babel
angularjs
asm80
codemirror
express
ejs
webpack
bootstrap (which in turn uses jquery and popper.js)
bootstrap-dark
mongoose

Were also used, and though they are not directly mentioned, their dependencies without which they would not work. And not forgetting the amazing node.js and MongoDB. My most heartfelt thanks for everyone's hard work.

Making changes to the code

To make changes to the code, you can start the webpack dev server to track frontend changes and nodemon to track the backend API server changes. Start two terminals and run the following:

$ npm run start:dev-fe

$ npm run start:dev-be

When you make changes to the source files, they are automatically tracked by the servers and any frontend/backend services are restarted.

License

Please read the license for more details: zedide is licensed under the Creative Commons CC BY-NC-SA 4.0 license.

Author

rob andrews <rob@aphlor.org>

rsenna/zedide