{{ :en:multiasm:curriculum:logo_400.png?200 | Multiasm Project Logo}}
=== Project Information ===
This content was implemented under the following project:
* Cooperation Partnerships in higher education, 2023, MultiASM: A novel approach for energy-efficient, high performance and compact programming for next-generation EU software engineers: 2023-1-PL01-KA220-HED-000152401.
**Consortium Partners**\\
* Silesian University of Technology, Gliwice, Poland (Coordinator),
* Riga Technical University, Riga, Latvia,
* Western Norway University, Forde, Norway,
* ITT Group, Tallinn, Estonia.
{{ :en:multiasm:curriculum:pasek_z_logami_1000px.jpg?400 | Consortium Partner's Logos}}
**Erasmus+ Disclaimer**\\
This project has been co-funded by the European Union.\\
Views and opinions expressed are, however, those of the author or authors only and do not necessarily reflect those of the European Union or the Foundation for the Development of the Education System. Neither the European Union nor the entity providing the grant can be held responsible for them.
**Copyright Notice**\\
This content was created by the MultiASM Consortium 2023–2026.\\
The content is copyrighted and distributed under CC BY-NC [[https://en.wikipedia.org/wiki/Creative_Commons_license|Creative Commons Licence]] and is free for non-commercial use.
{{ en:iot-open:ccbync.png?100 |CC BY-NC}}
In case of commercial use, please get in touch with MultiASM Consortium representative.
====== Introduction ======
This manual is intended to help students bootstrap into assembler programming across a variety of applications. It presents practical exercises in a hands-on lab format, often also covering toolchain configuration. Some sections present details for hardware, such as remote IoT and remote ARM laboratories. Others assume the student owns or has access to the PC and can install software.
====== ARM and Mobiles ======
ARM processors are omnipresent, ranging from simple IoT devices to laptops, notebooks, and workstations.\\
For this reason, we had to select one technology to use for a practical introduction and experimentation.\\
To present both hardware interfacing and programming, the obvious choice is the Raspberry Pi. The following chapters present laboratory details and scenarios.\\
Follow the links below to the lab descriptions and scenarios:
* [[en:multiasm:exercisesbook:arm:sut]]
* [[en:multiasm:exercisesbook:arm:rtu]]
===== SUT's ARM laboratory =====
===== RTU's ARM laboratory =====
====== Programming in Assembler for Embedded Systems ======
Assembler programming for embedded systems uses an integrated solution for IoT laboratories, namely VREL NextGen Software. \\
Users connect to the system using a web browser and develop software in the browser, compile it and inject it into the microcontroller, all remotely. Next, they use a web camera to observe the results.\\
The following chapters present more data on how to use the VREL NextGen remote labs system.
[[en:iot-open:practical:software]]
* [[en:iot-open:practical:software:users]]
* [[en:iot-open:practical:software:admins]]
===== Introduction to the Arduino Uno programming in Assembler =====
The following chapter assumes that you are familiar with basic assembler operations for AVR microcontrollers. Below, we explain the most important construction elements and assembler instructions for manipulating the Arduino Uno's (figure {{ref>arduinouno}}) GPIOs, based on the ATmega328P microcontroller.
{{:en:iot-open:getting_familiar_with_your_hardware_rtu_itmo_sut:arduino_and_arduino_101_intel_curie:programming_fundamentals_rtu:arduino_uno_top_c.jpg?400|}}
Arduino Uno development board
==== GPIO and Ports ====
The Arduino Uno exposes a number of GPIOs that can serve as binary inputs and outputs, analogue inputs, and many of them provide advanced, hardware-accelerated functions, such as UART, SPI, I2C, PWM, and ADC. In fact, not all of the pins on the development board are such "general-purpose": some of them provide specific features, while others do not: there is no internal multiplexer, so functions such as UART, I2C, SPI, PWM and ADC are bound to particular GPIOs and cannot be changed.
On the programming level, GPIO ports are grouped into 3 "ports" (figure {{ref>arduinoports}}), and it is how you can access them:
* PortB, with GPIOs from D8 to D13,
* PortC, with GPIOs from port A0 to A5,
* PortD, with GPIOs from D0 to D7.
A bit in the port corresponds to a single GPIO pin, e.g. bit 5 (6th, zero-ordered) of PortB corresponds to GPIO D13 and is connected to the built-in LED.
{{:en:multiasm:exercisesbook:assembler_arduino_uni.drawio.png?600|}}
Arduino ports
==== IO Registers ====
Each Port has assigned three 8-bit registers:
* DDRx (Data Direction Register): there are 3 of those registers, one per Port (B, C, D): DDRB, DDRC and DDRD. This registers configures GPIO as Input (0) or Output (1). Configuration is done "per bit", so it is equivalent to controlling each GPIO individually.
* PORTx (Port Data Register): there are also 3 of those registers: PORTB, PORTC and PORTD. The operation depends on the value of the specific bit in the corresponding DDR register; either pin is configured as input or output:
* If a specific GPIO pin (represented as a bit in the related DDRx register) is set as output, then PORTx bit directly affects the GPIO output: 1 is HIGH (+5V), while 0 is LOW (0V).
* If a specific GPIO pin is set to input, PORTx value controls the internal pull-up resistor: 1 enables pull-up, 0 disables it.
* PINx (Pin Value Register) represents the current input state of the GPIO.
=== Instructions ===
There is a set of assembler instructions that operate on Ports (I/O registers), as shown in table {{ref>assemblergpioinstructions}}.
Assembler-level operations using ports are much faster than ''DigitalRead'', ''DigitalWrite'', and other instructions in C++, roughly 50 times faster.
Common GPIO-related, I/O instructions
^ Instruction ^ Description ^
| ''SBI'' | Set bit in register |
| ''CBI'' | Clear bit in register |
| ''SBIS'' | Skif if bit in register is set (1) |
| ''SBIC'' | Skip if bit in register is clear (0) |
| ''IN'' | Read hardware register to the general-purpose register (R0-R31) |
| ''OUT'' | Write the general-purpose register to the hardware register. |
| ''ANDI'' | Masks a bit |
| ''ORI'' | Sets a bit |
A common scenario is to first set either the GPIO is input or output (using the correct DDRx register), then either set (''SBI''), reset (''CBI''), check (''SBIS'', ''SBIC''), read the whole register (''IN'') or write the whole register (''OUT'').
''IN'' and ''OUT'' instructions operate on whole, 8-bit registers rather than on single bits. Those are general-purpose instructions, covering the whole range of IO registers (0-63), beyond aforementioned DDRx, PORTx and PINx registers.
=== Examples ===
** Template for the assembler code **\\
Using plain assembler (not C++ + assembler) requires a specific construction of the application where the program is located (loaded) into memory exactly at 0x0000.
.org 0x0000
rjmp start
start:
...
It is common practice to use ``rjmp`` (relative jump), which makes is easier to place data before the start of the code. And it is a good "embedded" practice to keep it even, if it does not really jump, as in this example. Forgetting to put it may impact your programming experience later, when you decide to declare some data.
** Core I/O registers and their IDs **\\
To operate on I/O registers, the developer must either include a library with definitions or (when programming in pure assembler) declare them on their own.\\
Below there is a table {{ref>ioregisterids}} with a list of I/O registers used to control GPIO (Ports B, C and D) and their addresses:
I/O registers and their addresses (IDs)
^ Name ^ Address (I/O) ^ Description ^
| PINB | 0x03 | Input pins register (Port B) |
| DDRB | 0x04 | Data direction register (Port B) |
| PORTB | 0x05 | Output register/pull-up enable (Port B) |
| PINC | 0x06 | Input pins register (Port C) |
| DDRC | 0x07 | Data direction register (Port C) |
| PORTC | 0x08 | Output register/pull-up enable (Port C) |
| PIND | 0x09 | Input pins register (Port D) |
| DDRD | 0x0A | Data direction register (Port D) |
| PORTD | 0x0B | Output register/pull-up enable (Port D) |
The easiest is to declare constants (converted to values at compile time) and insert them before the code starts (note that they do not exist in memory, so do not disturb code placement and proper execution):
; I/O registers
.equ PINB, 0x03
.equ DDRB, 0x04
.equ PORTB, 0x05
.equ PINC, 0x06
.equ DDRC, 0x07
.equ PORTC, 0x08
.equ PIND, 0x09
.equ DDRD, 0x0A
.equ PORTD, 0x0B
; your code starts here
.org 0x0000
rjmp start
start:
...
''.equ'' is converted into a value and substituted in the code during compile: thus it does not exist in the final, compiled binary code.Depending on the compiler you use, there are two standards of syntax. You can find the correct ''__.equ PINB, 0x03__'' or ''__.equ PINB = 0x03__''
Below are sections representing common usage scenarios for GPIO management:
**USE GPIO as output**\\
In this scenario, we use GPIO as an output. The simplest is to use the built-in LED to get instantly observable results.\\
The built-in LED is connected to GPIO13 (D13) and is controlled via PortB (5th bit, zero-based indexing; see figure {{ref>arduinoports}}). The built-in LED is enabled in the LOW (0) state and off in the HIGH (1) state on GPIO13.
It is also convenient to declare a bit number representing the built-in LED position in PortB, so instead of using a number, we can use an identifier:
.equ
**Use GPIO as input**\\
**Use GPIO as input with pull-up**\\
=== Reading analogue values ===
Reading of the analogue values is not so straightforward as in the case of binary ones.
Built-in ADC converter uses 10-bit resolution, has 6 channels (A0-A5, respectively). It also uses a reference voltage (configurable), typically 5V.\\
The low-level ADC register-based operations use the following formula to obtain an ADC value (figure {{ref>avreq1}}, based on the input value ''Vgpio'' and the reference value ''Vref'').
{{:en:multiasm:exercisesbook:screenshot_from_2026-03-26_22-41-59.png?200|}}
ADC value calculation based on the input voltage and reference voltage
Analogue reading uses a complex setup of ADC-related registers as presented in table {{ref>tabadcregisters}}:
ADC-related registers used for reading the analogue values of GPIOs
===== SUT AVR Assembler Laboratory Node Hardware Reference =====
==== Introduction ====
Each laboratory node is equipped with an Arduino Uno R3 development board, based on the ATmega328P MCU. It also has two extension boards:
* external, analogue and digital communication board,
* user interface board presented on the image {{ref>sutavrlabimage1}}.
There are 10 laboratory nodes. They can be used independently, but for collaboration, nodes are interconnected symmetrically, with GPIOs described in the hardware reference section below.
==== Hardware reference ====
The table {{ref>sutavrlabtable1}} lists all hardware components and details. Note that some elements are accessible, but their use is not supported via the remote lab, e.g., buttons and a buzzer.\\ The node is depicted in the figure {{ref>sutavrlabimage1}} and its interface visual schematic is presented in the figure {{ref>sutavrlabimage1_2}}. The schematic presents only components used in scenarios and accessible via the VREL NextGen environment (controllable and observable via video stream), omitting unused components such as buttons, a buzzer, and a potentiometer.
{{ :en:multiasm:exercisesbook:avr:sut_avr_lab_node.png?600 |}}
^ Component ID ^ Component ^ Hardware Details (controller) ^ Control method ^ GPIOs (as mapped to the Arduno Uno) ^ Remarks ^
| D1 | LED (red) | direct via GPIO | binary (0->on, 1->off) | GPIO13 | |
| D2 | LED (red) | direct via GPIO | binary (0->on, 1->off) | GPIO12 | |
| D3 | LED (red) | direct via GPIO | binary (0->on, 1->off) | GPIO11 | |
| D4 | LED (red) | direct via GPIO | binary (0->on, 1->off) | GPIO10 | shared with interconnection with another module |
| LED4 | 4x 7-segment display | indirect, via two 74HC575 registers | serial load to 2 registers, daisy-chained | GPIO8 - serial input of the controller\\ GPIO7 - shift data internally, raising edge (write next bit and shift data in serial)\\ GPIO4 - reset display buffer | |
==== Communication ====
Devices (laboratory nodes) are interconnected in pairs, so it is possible to work in groups and implement scenarios involving more than one device:
* node 1 with node 2,
* node 3 with node 4,
* node 5 with node 6,
* node 7 with node 8,
* node 9 with node 10.
Interconnections are symmetrical, so that device 1 can send data to device 2 and vice versa (similar to serial communication). Note that analogue inputs are also involved in the interconnection interface.
See image {{ref>sutavrlabimage2}} for details.
{{ :en:multiasm:exercisesbook:avr:sutavrconnections.png?600 |}}
SUT AVR nodes interconnection diagram
The in-series resistors protect the Arduino boards' outputs from excessive current when both pins are configured as outputs with opposite logic states.
The capacitors on the analogue lines filter the PWM signal, providing a stable voltage for the analogue-to-digital converter to measure.
Such a connection makes it possible to implement a variety of scenarios:
* Connection of OC0A to ADC5 allows you to generate a voltage for measuring on input 5 of the analogue-to-digital converter.
* Connection of OC1A to INT0 allows you to generate a digital periodic signal that can trigger hardware interrupts.
* Connection of OC1B to T1 allows you to generate a digital periodic signal, the pulse count of which can be counted using timer T1.
Nodes are interconnected in pairs: 1-2, 3-4, 5-6, 7-8, 9-10. Scenarios for data transmission between MCUs require booking and the use of correct nodes for sending and receiving messages.