pcs3616 / laboratorio-06

PCS3616 - Laboratório 6 - MVN 4

Hoje é a última aula com linguagem de máquina, portanto vai ser a mais interessante delas, vamos implementar um dumper e/ou um loader.

Nesta aula, você deverá trabalhar em dupla para desenvolver um dos seguintes programas: dumper ou loader (basta fazer um apenas).

O corretor automático do github sempre testará o dumper e o loader, com isso caso a dupla faça apenas um dos programas, o github indicará que algum teste falhou. Mas não se preocupe, caso a sua dupla resolva um deles de forma completa, a nota da dupla será 10.

Ferramentas recomendadas

Um editor de texto normal (como vim) não foi desenvolvido para a edição de arquivos não-texto. Assim, é recomendado utilizar outro editor, como o bless, que pode ser instalado executando

sudo apt-get update
sudo apt-get install -y bless

O bless é um programa com interface gráfica, então pode não funcionar em versões antigas do WSL ou em outros ambientes sem interface gráfica. Caso não consiga executar, é possível codificar textos em hexadecimal com 2 bytes por linha usando a seguinte função em Python 3

def string_to_two_byte_hex(string: str):
    string_bytes = string.encode('ascii')
    string_hex = string_bytes.hex('\n', 2)  # \n every 2 bytes
    print(string_hex)

e é possível visualizar um arquivo em binário usando o utilirário do Linux hexdump, executando

hexdump -C ARQUIVO

Um exemplo de arquivo binário .dat - seguindo os padrões de dump da MVN - foi disponibilizado nesse repositório com o nome ex.dat. Este arquivo serve tanto como exemplo de output do dumper, como de input para o loader.

Instruções

• Vamos usar a seguinte convenção: os dois programas (dumper e loader) devem ler/escrever do dispositivo 300. Ou seja, no seu arquivo disp.lst, use a seguinte linha:

  • 3 0 dump.dat e/l (e para escrita e l para leitura)

• É obrigatório iniciar o loader no endereço 0xB00 (endereço máximo: 0xCFF).

• É obrigatório iniciar o dumper no endereço 0x700 (endereço máximo: 0xAFF).

  • 0x704: Parâmetro "endereço inicial"

  • 0x706: Parâmetro "qtd. de palavras"

• Quantidade máxima de bytes de dados por bloco: 256 (128 palavras).

• Ambas as funções devem ser codificadas como subrotinas.

Entrega

• Arquivo dumper.mvn com o dumper
• Arquivo loader.mvn com o loader

laboratorio-06's Issues

Remove note on inconsistency between slide and lab max words per block

The slide has already been fixed to match the 128 words per block mention in the lab, though the note is necessary since the students may have already taken this class in 2023.

It should be removed for the 2024 offering.

laboratorio-06/README.md

Lines 64 to 65 in 730ec31

	- Os slides anteriormente mencionavam 64 palavras por bloco, mas
	sua implementação deve usar 128.

Add missing MVN submodule

Self-explanatory.

Autogradle didn't work with disp.lst

Multiple test compare with zeros in the end

A implementação do miguel está correta mas não passa na correção

O teste_dumper_multiple espera 6 bytes zero no final do arquivo, quando não deveria.

Loader test overwrites `0x704` and `0x706` when it shouldn't

laboratorio-06/autogradle/main_test.py

Lines 155 to 156 in bc24312

	f"0704 {base_addres:04X}\n", # endereço inicial
	f"0706 {n_words:04X}\n", # qtd. de palavras

As per the instructions, memory addresses 0x704 and 0x706 should only be employed in the dumper. Overwriting them leads to failure in the automated test suite but not in local execution of the program if the submission employs (albeit wrongly) these addresses.

It also introduces the possibility of incorrect implementations using the values in these addresses to pass.