Index | Fejlesztés Development | CPU | Számítógép Computer | Assembler | Monitor | Függvények Library

Parancsok: Commands: help | ver | mem | dump | load | go | reg | rX,sp,lr,pc,f

Melléklet Appendix

Lang: Nyelv: HU EN

PMon monitor program

A monitor program egy egyszerű firmware, amely lehetővé teszi az alkalmazói programnak a betöltését a számítógép memóriájába. Mivel a PMon a p2223 CPU utasításait felhasználva íródott, és a felhasználóval az UART periférián keresztül tartja a kapcsolatot, ezért csak a p2223 típusú CPU-t tartalmazó, v2 típusú számítógépen használható. The monitor program is a simple firmware that allows the application program to be loaded into the computer's memory. Since PMon is written using the instructions of the p2223 CPU and communicates with the user via the UART peripheral, it can only be used on v2 type computer with p2223 type CPU.

Felhasználói felület User interface

A számítógép UART perifériájához az FPGA kártyán egy USB-UART átalakító van kapcsolva, amelynek az USB portját összeköthetjük egy PC-vel. Az átalakító a PC operációs rendszere számára egy VCP (Virtual COM Port) eszközként látszik, amely aszinkron soros perifériaként használható. A PC-n indítsunk el egy terminál emulátor programot (pl. TeraTerm, putty, stb.) és nyissuk meg az FPGA kártya csatlakoztatásakor létrejövő COM portot. Állítsuk be a 115200,N,8,1 paramétereket. A USB-UART converter is connected to the UART peripheral of the FPGA board, whose USB port can be connected to a PC. The converter appears to the PC operating system as a VCP (Virtual COM Port) device, which can be used as an asynchronous serial peripheral. On the PC, start a terminal emulator program (e.g. TeraTerm, putty, etc.) and open the COM port created when the FPGA board is connected. Set the parameters to 115200,N,8,1.

A PMon egy parancssoros program, amely a prompt kiírása után egy parancs begépelését várja. Az ENTER lenyomása után értelmezi a beírt utasítást és végrehajtja a megfelelő műveletet. PMon is a command-line program that waits for a command to be typed after displaying a prompt. After pressing ENTER, it interprets the entered command and performs the appropriate action.

A parancsok egy szóból állnak, amelyet szóközzel elválasztva paraméter(ek) követhet(nek). A paramétereket szóközzel kell elválasztani. Commands consist of a single word, followed by parameter(s), separated by a space. Parameters must be separated by a space.

A parancsok a legtöbb esetben rövidíthetőek a szó első betűjével. A paraméterek általában számok, amelyeket hexadecimális számrendszerben kell beírni, 0x, H, $ és egyéb jelek nélkül. Tagolásként a beírt hexadecimális számokba írhatunk . vagy _ jeleket, ezeket a monitor figyelmen kívül hagyja. Az A..F értékű jegyeket kis és nagybetűvel is beírhatjuk. Commands can be abbreviated in most cases with the first letter of the word. Parameters are usually numbers that should be entered in hexadecimal, without 0x, H, $, and other symbols. As a separator, you can enter . or _ in the entered hexadecimal numbers, which are ignored by the monitor. The characters A..F can be entered in both upper and lower case letters.

A monitor által kiírt adatok mindig hexadecimális számrendszerben, nagybetűvel íródnak ki. A könnyebb olvashatóság érdekében a monitor által kiírt 32 bites értékek hexadecimális alakjában négy jegyenként egy _ jel van. The data displayed by the monitor is always in hexadecimal, in uppercase. For easier readability, the 32-bit values ​​displayed by the monitor have a _ sign every four digits in hexadecimal format.

Parancsok Commands

Kiírja a használható parancsok listáját és a szükséges, illetve lehetséges paramétereket. Lists the available commands and the required and possible parameters.

Kiírja a monitor program és a CPU verzióját, valamint a CPU feature regisztereinek az értékét: Lists the monitor program and CPU version, and the values ​​of the CPU feature registers:

Memória egy adott című rekeszének vizsgálata, vagy módosítása. Az első paraméter a vizsgált rekesz címe (hexadecimálisan). Ha a második paramétert nem adjuk meg, akkor a parancs a megadott című szót írja ki (a címmel együtt), ha megadjuk a második paramétert, akkor először az érték a memóriába kerül, majd ezután íródik ki (a már módosított) memória tartalom. Examine or modify a memory location with a given address. The first parameter is the address of the location to be examined (in hexadecimal). If the second parameter is not specified, the command prints the specified address (including the address), if the second parameter is specified, the value is first placed in memory, and then the (already modified) memory content is printed.

Egy adott memóriaterület tartalmát listázza ki. A kezdőcímet kötelező megadni. Ha a vég címet nem adjuk meg, akkor 17 egymás utáni szó értéke íródik ki. Lists the contents of a given memory area. The starting address is required. If the ending address is not specified, then the values ​​of 17 consecutive words are printed.

Lefordított alkalmazói program betöltése a memóriába. A parancsnak nincs paramétere, a betöltéshez szükséges adatok a lefordított fájlban vannak. A parancs p2h formátumú fájl tartalmát várja, ezt az assembler segítségével állíthatjuk elő. Loading a compiled application program into memory. The command has no parameters, the data required for loading is in the compiled file. The command expects the contents of a file in p2h format, which can be generated using the assembler.

A parancs kiadása után várakozik, a fájl tartalmát a terminálon kell elküldeni. Erre használjuk a terminál emulátor megfelelő funkcióját. TeraTerm esetén pl. a File menü Send file pontja használható: After issuing the command, it waits, the contents of the file must be sent to the terminal. For this, we use the appropriate function of the terminal emulator. In the case of TeraTerm, for example, the File menu item Send file can be used:

Válasszuk ki a lefordított programból készült .p2h kiterjesztésű fájlt: Select the file with the .p2h extension made from the compiled program:

A program a soros vonalon elküldi a fájl tartalmát. A load parancs értelmezi a fájlban lévő rekordokat, ezeknek a típusát kiírja a terminálra. A memória tartalmat meghatározó rekordoknak megfelelően módosítja a memóriát. A fájl végét jelző rekord után kilép, és újra megjelenik a monitor promptja: The program sends the contents of the file on the serial line. The load command interprets the records in the file, and prints their types to the terminal. It modifies the memory according to the records that define the memory contents. After the record indicating the end of the file, it exits, and the monitor prompt reappears:

Ez a parancs a felhasználói programot indítja el a megadott címtől. Ha a program visszalép a monitorhoz a megfelelő szubrutin meghívásával, akkor ettől a ponttól a programot lehet folytatni. Ehhez nem kell megadni a go parancsnak paramétert. Ez a módszer nem működik, ha még nem volt átlépés a programról a monitorra. This command starts the user program from the specified address. If the program returns to the monitor by calling the appropriate subroutine, the program can be continued from that point. You do not need to specify a parameter to the go command for this. This method does not work if there has not been a transition from the user program to the monitor yet.

Kiírja azokat a regiszter értékeket, amelyeket a program betölt a go parancs hatására a felhasználói program indítása előtt. Ezeket az értékeket akkor menti el a monitor program, amikor a felhasználó program visszatér a monitorhoz a megfelelő szubrutin hívással. Az első sor arról tájékoztat, hogy ilyen mentés történt-e már, vagy még nem: Lists the register values ​​that the program loads in response to the go command before the user program starts. These values ​​are saved by the monitor program when the user program returns to the monitor with the appropriate subroutine call. The first line informs whether such a save has already occurred or not:

Az utolsó sorban az egyes flag bitek értéke egyenként is látható. A monitor hívása után: The last line shows the value of each flag bit individually. After calling the monitor:

A PC és az LR a hívás helyét követő utasításra mutat, ahonnan a felhasználói program folytatható. Ettől a címtől a programot a paraméter nélküli go parancs kiadásával folytathatjuk. PC and LR point to the instruction following the call, from where the user program can be continued. From this address, the program can be continued by issuing the go command without parameters.

Az egyes regiszterek elmentett értékeit megjelenítő, illetve megváltoztató parancsok. A regiszter névben (rX) 0 és 15 közötti számokat használhatunk, az r13 helyett írhatunk sp nevet, az r14 helyett lr-t, míg az r15 helyett a pc név is használható. A f név a Flag regiszter elmentett értékének kezelésére szolgál. Commands that display and change the saved values of individual registers. In the register name (rX) we can use numbers between 0 and 15, instead of r13 we can write the name sp, instead of r14 we can write lr, while instead of r15 we can use the name pc. The name f is used to manage the saved value of the Flag register.

Monitor szolgáltatások Monitor services

A monitor programban található egyes szubrutinok a felhasználói programok fejlesztése során is hasznosak lehetnek, a megfelelő CALL utasításokkal meghívhatók. Az alábbiakban megadjuk a meghívható szubrutinok címeit és a funkciókat. Some subroutines in the monitor program may also be useful during the development of user programs, and can be called with the appropriate CALL instruction. Below, we provide the addresses and functions of the subroutines that can be called.

Az egyes szubrutinok a bemenő és kimenő paraméterek átadására használt regisztereken, és a Flag regiszteren kívül egyéb regisztereket nem módosítanak, az esetleges ettől eltérő eseteket külön jelezzük. The individual subroutines do not modify the registers used to pass input and output parameters, and other registers except the Flag register, any cases that differ from this are indicated separately.

Végleges kilépés az alkalmazói programból a monitor újraindításával. Kezdeti értékre állítja a monitor állapotát, így a felhasználói program a paraméterek nélküli go paranccsal nem folytatható. Ezt a funkciót szubrutinhívás mellett ugró utasításokkal is meghívhatjuk. A funkciónak nincsenek paraméterei. Final exit from the application program by restarting the monitor. Sets the monitor state to its initial value, so the user program cannot be continued with the go command without parameters. This function can be called with jump instructions in addition to subroutine calls. The function has no parameters.

Visszatérés a monitor programba a felhasználó program állapotának az elmentésével. Ezután a program folytatható a paraméter nélküli go paranccsal. A funkciónak nincsenek paraméterei. Return to the monitor program by saving the user program state. The program can then be continued with the command go without parameters. The function has no parameters.

Feltételes visszatérés a monitor programhoz. A szubrutin ellenőrzi, hogy van-e olvasható vett karakter az UART áramkörben. Ha igen, kiüríti az UART-ot és meghívja a _pm_callin funkciót, vagyis visszatér a monitorhoz. Olyan program esetében használhatjuk, amely nem végez adat beolvasást a terminálról az UART-on keresztül. A funkciónak nincsenek paraméterei. Conditional return to the monitor program. The subroutine checks whether there is a readable character received in the UART circuit. If so, it clears the UART and calls the _pm_callin function, i.e. returns to the monitor. It can be used in a program that does not read data from the terminal via the UART. The function has no parameters.

A monitor program verziószámának lekérdezése. A függvény az R0 regiszter 1. bájtjában helyezi el a fő verziószámot, a 0. bájtban pedig az al verziószámot. Querying the version number of the monitor program. The function places the major version number in the 1st byte of the R0 register, and the minor version number in the 0th byte.

Normál vagy pakolt sztring átalakítása normál formátumra. A megfelelő méretű kimeneti bufferről a hívás előtt kell gondoskodni. Convert a normal or packed string to normal format. An output buffer of the appropriate size must be provided before the call.

Bemenő paraméterekInput parameters:

• R0 bemeneti sztring címe R0 input string address
• R1 kimeneti buffer címe R1 output buffer address

EredményResult:

Az átalakított sztring az R1-ben megadott memóriacímtől kezdeve. The converted string starts at the memory address specified in R1.

Normál vagy pakolt sztring átalakítása pakolt formátumra. A megfelelő méretű kimeneti bufferről a hívás előtt kell gondoskodni. Convert a normal or packed string to packed format. An output buffer of the appropriate size must be provided before the call.

Bemenő paraméterekInput parameters:

• R0 bemeneti sztring címe R0 address of input string
• R1 kimeneti buffer címe R1 address of output buffer

EredményResult:

Az átalakított sztring az R1-ben megadott memóriacímtől kezdeve. The converted string starts at the memory address specified in R1.

Normál, vagy pakolt formátumú, 0 végződésű sztring karaktereinek számát adja. Returns the number of characters in a string in normal or packed format, terminated by 0.

Bemenő paraméterekInput parameters:

• R0 bemeneti sztring címe R0 address of input string

EredményResult:

• R4 karakterek száma R4 number of characters

Karakter első előfordulásának keresése egy szövegben. Find the first occurrence of a character in a string.

Bemenő paraméterekInput parameters:

• R0 keresett karakter R0 character to search for
• R1 sztring kezdőcíme R1 address of string

EredményResult:

• R1 a megtalált karakter címe, ha nincs a szövegben, akkor 0. R1 is the address of the found character, if it is not in the string, then 0.
• R2 a megtalált karakter indexe a memóriaszón belül (pakolt szöveg esetén), vagy 0, ha nincs találat. R2 is the index of the found character within the memory word (in case of packed text), or 0 if no match is found.
• F.C találat esetén 1, egyébként 0 F.C 1 if character is found, 0 otherwise

Sztringek összehasonlítása, a kis- és nagybetűk különbözőnek számítanak. Compare strings, uppercase and lowercase are considered different.

Bemenő paraméterekInput parameters:

• R0, R1 az összehasonlítandó sztringek címei R0, R1 are the addresses of the strings to be compared

EredményResult:

• F.C értéke 1, ha a sztringek megegyeznek, egyébként 0. F.C is 1 if the strings match, otherwise 0.

Sztringek összehasonlítása, a kis- és nagybetűk egyezőnek számítanak. Compare strings, case-sensitive.

Bemenő paraméterekInput parameters:

• R0, R1 az összehasonlítandó sztringek címei R0, R1 are the addresses of the strings to be compared

EredményResult:

• F.C értéke 1, ha a sztringek megegyeznek, egyébként 0. F.C is 1 if the strings match, otherwise 0.

Egy hexadecimális számjegy karakter kódjának szám értékre való átalakítása. Converting the character code of a hexadecimal digit to a numeric value.

BemenetInput:

• R0 karakter ASCII kódja R0 ASCII code of character

EredményResult:

• R0 számérték R0 numerical value
• F.C értéke 1, ha a karakter hexa karakter volt, egyébként 0 F.C value is 1 if the character was a hexadecimal character, otherwise 0

Egy 0-15 közötti számérték átalakítása a megfelelő hexadecimális számjegy ASCII kódjára. Convert a numeric value between 0-15 to the ASCII code of the corresponding hexadecimal digit.

BemenetInput:

• R0 átalakítandó számérték. A szubrutin a regiszter 31:4 bitjeit nullázza. R0 is the numerical value to be converted. The subroutine sets bits 31:4 of register to zero.

EredményResult:

• R0 hexadecimális számjegy. A szubrutin a 10-15 közötti értékeket kisbetűre (a-f) alakítja. R0 is a hexadecimal digit. The subroutine converts values ​​between 10-15 to lowercase (a-f).

Hexadecimális szám jegyeit tartalmazó sztring átalakítása számértékké. A szövegben kis- és nagybetűk is használhatók (a-f, A-F), a tagolásra használt . (pont) vagy _ (aláhúzás) karakterek figyelmen kívül maradnak. Érvénytelen karakter esetén a feldolgozás megáll, az eredmény az addig feldolgozott sztring részletnek megfelelő lesz. Convert a string containing hexadecimal digits into a numeric value. The string can be case-sensitive (a-f, A-F), and the. (period) or _ (underscore) characters used for segmentation are ignored. In case of an invalid character, the processing stops, and the result will correspond to the string fragment processed so far.

BemenetInput:

• R0 a sztring kezdőcíme R0 address of string

EredményResult:

• R1 a sztringnek megfelelő számérték. R1 is the numeric value corresponding to the string.
• F.C értéke 1 lesz, ha a feldolgozás nem talált hibás karaktert, egyébként 0. F.C will be 1 if the processing did not find any incorrect characters, otherwise it will be 0.

Az UART vevő állapotának vizsgálata. Azt mutatja meg, hogy van-e az UART-ban beolvasható vett karakter. A funkciónak nincs bemeneti paramétere. Checks the UART receiver status. It shows whether there are any characters received in the UART that can be read. The function has no input parameters.

EredményResult:

• F.C értéke 1, ha van vett karakter, egyébként 0. F.C value is 1 if there is a received character, otherwise 0.

Az UART vevő áramkörének kiolvasása. A szubrutin nem vár új karakterre, a vevő állapotát előzőleg a _pm_check_uart funkcióval kell vizsgálni. Nincs bemenő paramétere. Reading the UART receiver circuit. The subroutine does not wait for a new character, the receiver status must be checked beforehand with the _pm_check_uart function. It has no input parameters.

EredményResult:

• R0 a legrégebben vett karakter értéke. R0 is the value of the oldest character received.

Várakozás egy karakter vételére, majd a karakter kiolvasása az UART áramkörből. Waiting for a character to be received, then reading the character from the UART circuit.

EredményResult:

• F.C értéke 1 lesz, jelezve, hogy volt vett karakter. F.C will be 1, indicating that a character was received.
• R0 a beérkezett karakter kódja. R0 is the code of the received character.

Egy karakter kiírása a terminálra (küldése UART-on). A szubrutin először megvárja, hogy az UART küldő áramköre szabad legyen, tehát az előző karakter küldése befejeződjön. Ezután átadja a küldendő karaktert az UART-nak. Write a character to the terminal (send it via UART). The subroutine first waits for the UART's send circuit to be free, so that the previous character is completed. Then it passes the character to be sent to the UART.

BemenetInput:

• R0 a küldendő karakter értéke (8 bites adat) R0 is the value of the character to be sent (8-bit data)

Egy 0 végződésű karaktertömb (sztring) kiírása a terminálra. A szubrutin a sztring tartalmát nem értelmezi, így abban ú.n. escape szekvenciák nem használhatók. Write a 0-terminated character array (string) to the terminal. The subroutine does not interpret the contents of the string, so so-called escape sequences cannot be used in it.

BemenetInput:

• R0 sztring címe. R0 address of string.

Egy 0 végződésű karaktertömb, majd egy újsor karakter (\n) kiírása a terminálra. Escape szekvenciák nem használhatók. Writes a 0-terminated character array followed by a newline character (\n) to the terminal. Escape sequences cannot be used.

BemenetInput:

• R0 sztring címe. R0 address of string.

Egy 32 bites érték kiírása a terminálon hexadecimális számrendszerben, 8 jegyen, bevezető nullákkal. A szubrutin a számjegyek között _ (aláhúzás) karaktert használ tagolásra. Az a-f értékek nagybetűvel íródnak ki. Print a 32-bit value to the terminal in hexadecimal, 8 digits, with leading zeros. The subroutine uses _ (underscore) characters between digits for delimitation. Values ​​a-f are printed in uppercase.

BemenetInput:

• R0 számérték R0 value
• R1 két tagolás jel között kiíródó jegyek száma R1 number of characters to be printed between two punctuation marks

Egy 32 bites, előjel nélküli (bináris) szám kiírása a terminálra tízes számrendszerben, az értéktől függő számú számjeggyel, bevezető nullák nélkül. Print a 32-bit, unsigned (binary) number to the terminal in decimal, with a number of digits depending on the value and without leading zeros.

BemenetInput:

• R0 számérték R0 value

Beágyazott, 0 végződésű karaktertömb kiírása a terminálra. A sztringnek a program kódjában közvetlenül a szubrutint meghívó CALL utasítás után kell lennie. A szubrutin a sztring záró nullája utáni címre fog visszatérni. A funkciónak sem bemeneti, sem kimeneti paraméterei nincsenek. Helyes használatára egy példa: Writes a nested, 0-terminated character array to the terminal. The string must be in the program code immediately after the CALL instruction that calls the subroutine. The subroutine will return to the address after the trailing zero of the string. The function has neither input nor output parameters. Here is an example of its correct usage:

CALL helyett célszerű a CES utasítást használni, amely a CALL-al megegyező módon működik, azonban lehetővé teszi a szimulátor számára a visszatérési cím meghatározását, így a next utasítás használható lesz a lépésenkénti futtatásra. Instead of CALL it is advisable to use the CES instruction, which works in the same way as CALL, but allows the simulator to specify the return address, so the next command can be used to step execution.

A sztringet a CALL/CES-t követő DB direktívával kell létrehozni, kettős idézőjelek között, ami biztosítja a záró 0 érték elhelyezését. The string must be created with the DB directive following the CALL/CES, enclosed in double quotes, which ensures the placement of the trailing 0 value.

Formázott szöveg kiírása a terminálra. A szövegben elhelyezhetők formázó utasítások (% jellel kezdve), amelyek egy adat megfelelő formátumban való kiírását eredményezik. Az adatokat az R1..R12 regiszterekben adhatjuk át, amelyekből sorban annyit használ fel a szubrutin, amennyi formázó utasítás van a szövegben. Print formatted text to the terminal. Formatting instructions (starting with the % sign) can be placed in the string, which result in the printing of a data in the appropriate format. The data can be transferred in the registers R1..R12, of which the subroutine uses as many of the formatting instructions are in the text.

BemenetekInputs:

• R0 a formátum szöveg címe. R0 address of the format string.
• R1-R12 a formázó utasításokhoz szükséges adatok értékei R1-R12 are the values ​​of the data required for formatting instructions

A szubrutin által kezelt formázó utasítások és paraméterek ismertetését lásd a printf könyvtári függvény leírásánál. For a description of the formatting instructions and parameters handled by the subroutine, see the description of the printf library function.

Beágyazott, 0 végződésű formázó szöveg kiírása a terminálra. A formázó szövegnek közvetlenül a CALL/CES utasítás után kell lennie, a további paraméterek a printf szubrutinéval egyeznek (ez a funkció az R0 regiszterben nem vár bemenő adatot). Prints embedded, 0-terminated formatting string to the terminal. The formatting string must be immediately after the CALL/CES instruction, the additional parameters are the same as those of the printf subroutine (this function does not expect input data in the R0 register).

Előjel nélküli bináris kódolású szám átalakítása BCD kódolásúra. Az R0 regiszterben megadott bemeneti adat maximum 99999999 lehet, az eredmény az R0 regiszterben keletkezik. Converting an unsigned binary number to BCD. The input data specified in the R0 register can be a maximum of 99999999, the result is generated in the R0 register .

BemenetInput:

• R0 bináris számérték R0 binary coded value

KimenetOutput:

• R0 bcd kód R0 bcd coded value

ASCII kód átalakítása hét szegmenses kódra, amelyet a megadott karakter kijelzőn való megjelenítéséhez használhatunk. Convert ASCII code to seven-segment code, which can be used to display the specified character on the display.

BemenetInput:

• R0 ASCII kód R0 ASCII code

EredményResult:

• R4 hét szegmenses kód R4 seven-segment code

Megjegyezzük, hogy a kijelzőn nem minden karakter jeleníthető meg, ezek esetében a kimenet 0 lesz. Néhány esetben a kis- és a nagybetűkhöz ugyanazt az eredményt kapjuk (pl e, E), ha csak a karakter egyik formája jeleníthető meg, lásd a dsp_ascii2seg függvény leírását. Note that not all characters can be displayed on the display, in which case the output will be 0. In some cases, we get the same result for both lowercase and uppercase letters (e.g. e, E), if only one form of the character can be displayed, see the dsp_ascii2seg function description.

Monitor szubrutinok abc sorrendben Monitor subroutines in alphabetical order

Monitor szubrutinok cím szerinti sorrendben Monitor subroutines in order of address