https://github.com/jkeresman01/6502_ls
Language server for 6502 assembly
https://github.com/jkeresman01/6502_ls
6502 6502-assembly 6502-processor assembly cpp emacs langauge-server linux lsp neovim vim
Last synced: about 2 months ago
JSON representation
Language server for 6502 assembly
- Host: GitHub
- URL: https://github.com/jkeresman01/6502_ls
- Owner: jkeresman01
- License: gpl-3.0
- Created: 2025-02-09T16:21:20.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-04-04T15:42:28.000Z (about 2 months ago)
- Last Synced: 2025-04-04T16:34:22.224Z (about 2 months ago)
- Topics: 6502, 6502-assembly, 6502-processor, assembly, cpp, emacs, langauge-server, linux, lsp, neovim, vim
- Language: C++
- Homepage:
- Size: 450 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
6502 assembly language server
---> Langauge server for 6502 assembly <---
## Langauge server for 6502 assembly ---> Not baked yet
## Table of Contents ##
- [6502 Langauge server](#)
- [Completions](#)
- [Hover](#)
- [Diagnostics](#)
- [CodeActions](#)
- [6502 processor](#)
- [Overivew](#)
- [Instruction Set](#)
- [Clients](#)
- [Neovim](#)
- [Emacs](#)
- [VSCode](#)
- [Build](#)
## 6502 lanage server ##
This is fairly simple implementation of language server protocol for 6502 assembly.
A language server is a tool that provides language-specific features like auto-completion, go-to-definition, and find-all-references to an editor or integrated development environment (IDE) through the Language Server Protocol (LSP).
For more information visit official microsofts documentation.
### Completions ###
[](https://asciinema.org/a/Vpxr4wl0QqZ83fRqBJO7xGunM)
### Hover ###
[](https://asciinema.org/a/syKCKR74Qze1xiQ46AxoEDiyv)
### Diagnostics ###
/// TODO
### Code actions ###
/// TODO
## 6502 processor ##
/// TODO: short desc
## Overview ##
/// TODO: short desc
Registers:
* PC program counter (16 bit)
* AC accumulator (8 bit)
* X register (8 bit)
* Y register (8 bit)
* SR status register [NV-BDIZC] (8 bit)
* SP stack pointer (8 bit)
## Instruction set ##
| Mnemonic | Description |
|----------|------------|
| **ADC** | Add with carry |
| **AND** | And (with accumulator) |
| **ASL** | Arithmetic shift left |
| **BCC** | Branch on carry clear |
| **BCS** | Branch on carry set |
| **BEQ** | Branch on equal (zero set) |
| **BIT** | Bit test |
| **BMI** | Branch on minus (negative set) |
| **BNE** | Branch on not equal (zero clear) |
| **BPL** | Branch on plus (negative clear) |
| **BRK** | Break / interrupt |
| **BVC** | Branch on overflow clear |
| **BVS** | Branch on overflow set |
| **CLC** | Clear carry |
| **CLD** | Clear decimal |
| **CLI** | Clear interrupt disable |
| **CLV** | Clear overflow |
| **CMP** | Compare (with accumulator) |
| **CPX** | Compare with X |
| **CPY** | Compare with Y |
| **DEC** | Decrement |
| **DEX** | Decrement X |
| **DEY** | Decrement Y |
| **EOR** | Exclusive OR (with accumulator) |
| **INC** | Increment |
| **INX** | Increment X |
| **INY** | Increment Y |
| **JMP** | Jump |
| **JSR** | Jump subroutine |
| **LDA** | Load accumulator |
| **LDX** | Load X |
| **LDY** | Load Y |
| **LSR** | Logical shift right |
| **NOP** | No operation |
| **ORA** | OR with accumulator |
| **PHA** | Push accumulator |
| **PHP** | Push processor status (SR) |
| **PLA** | Pull accumulator |
| **PLP** | Pull processor status (SR) |
| **ROL** | Rotate left |
| **ROR** | Rotate right |
| **RTI** | Return from interrupt |
| **RTS** | Return from subroutine |
| **SBC** | Subtract with carry |
| **SEC** | Set carry |
| **SED** | Set decimal |
| **SEI** | Set interrupt disable |
| **STA** | Store accumulator |
| **STX** | Store X |
| **STY** | Store Y |
| **TAX** | Transfer accumulator to X |
| **TAY** | Transfer accumulator to Y |
| **TSX** | Transfer stack pointer to X |
| **TXA** | Transfer X to accumulator |
| **TXS** | Transfer X to stack pointer |
| **TYA** | Transfer Y to accumulator |
## Clients ##
Instructions on how to setup clients are provided for following editors: Neovim, Emacs, VSCode(don't use this one).
### Neovim ###
Neovim supports the Language Server Protocol (LSP), which means it acts as a client to LSP servers and includes a Lua framework `vim.lsp`.
To configure the LSP client, you can use this example:
```Lua
vim.api.nvim_create_autocmd("FileType", {
pattern = "txt",
callback = function()
local client = vim.lsp.start({
name = "6502LS",
cmd = {"/path/to/6502LS/binary"}
})
if not client then
vim.notify "No can do for 6502 ASM language server!"
else
vim.lsp.buf_attach_client(0, client)
end
end
})
```
### Emacs ###
/// TODO
### VSCode ###
/// TODO
## Build ##
``` shell
cd 6502_LS
mkdir build && cd build
cmake ..
make -j$(nproc)
```