aboutsummaryrefslogtreecommitdiff
path: root/02-usart/include
diff options
context:
space:
mode:
Diffstat (limited to '02-usart/include')
-rw-r--r--02-usart/include/arch/arm/arch.h20
-rw-r--r--02-usart/include/arch/x86_64/arch.h19
-rw-r--r--02-usart/include/common.h6
-rw-r--r--02-usart/include/dma.h167
-rw-r--r--02-usart/include/usart.h84
5 files changed, 285 insertions, 11 deletions
diff --git a/02-usart/include/arch/arm/arch.h b/02-usart/include/arch/arm/arch.h
new file mode 100644
index 0000000..904cbdb
--- /dev/null
+++ b/02-usart/include/arch/arm/arch.h
@@ -0,0 +1,20 @@
+#ifndef ARCH_H_
+#define ARCH_H_
+
+
+#define ARCH_STM32L4
+
+#define enable_interrupts() \
+ asm volatile(" cpsie i ")
+
+#define DMA1_BASE (0x40020000)
+#define DMA2_BASE (0x40020400)
+
+#define USART1_BASE (0x40013800)
+#define USART2_BASE (0x40004400)
+
+#define GPIOA_BASE (0x48000000)
+#define GPIOB_BASE (0x48000400)
+#define GPIOC_BASE (0x48000800)
+
+#endif /* ARCH_H_ */
diff --git a/02-usart/include/arch/x86_64/arch.h b/02-usart/include/arch/x86_64/arch.h
new file mode 100644
index 0000000..43f6077
--- /dev/null
+++ b/02-usart/include/arch/x86_64/arch.h
@@ -0,0 +1,19 @@
+#ifndef ARCH_H_
+#define ARCH_H_
+
+#include "fake_env.h"
+
+#define ARCH_PC
+#define enable_interrupts() do {} while(0)
+
+#define DMA1_BASE (load_fake_ahb1__() + 0x0)
+#define DMA2_BASE (load_fake_ahb1__() + 0x400)
+
+#define USART1_BASE (load_fake_apb2__() + 0x3800)
+#define USART2_BASE (load_fake_apb1__() + 0x4400)
+
+#define GPIOA_BASE (load_fake_ahb2__() + 0x0)
+#define GPIOB_BASE (load_fake_ahb2__() + 0x400)
+#define GPIOC_BASE (load_fake_ahb2__() + 0x800)
+
+#endif /* ARCH_H_ */
diff --git a/02-usart/include/common.h b/02-usart/include/common.h
index 9d5c7cd..01b6a47 100644
--- a/02-usart/include/common.h
+++ b/02-usart/include/common.h
@@ -2,6 +2,12 @@
#define COMMON__H
#include <stdint.h>
+#include <stddef.h>
+#include <assert.h>
+
+#ifndef static_assert
+#define static_assert(a, b)
+#endif
/* Define __IO to be volatile if it's not already. */
#ifndef __IO
diff --git a/02-usart/include/dma.h b/02-usart/include/dma.h
new file mode 100644
index 0000000..57462f9
--- /dev/null
+++ b/02-usart/include/dma.h
@@ -0,0 +1,167 @@
+#ifndef DMA_H_
+#define DMA_H_
+
+/*
+ * Header file for definining the DMA (Direct Memory Access).
+ *
+ * A DMA is used to perform data transfers between segments of memory
+ * or between memory and peripherals.
+ *
+ * There are 2 DMA's on the chip. Each with 7 channels.
+ */
+
+#include "common.h"
+#include <arch.h>
+#include <stdint.h>
+
+#define DMA1 (* (dma_t*) DMA1_BASE)
+#define DMA2 (* (dma_t*) DMA2_BASE)
+
+typedef enum {
+ DMA_SIZE_8_BITS = 0,
+ DMA_SIZE_16_BITS = 1,
+ DMA_SIZE_32_BITS = 2,
+} dma_size_t;
+
+typedef enum {
+ DMA_PRIORITY_LEVEL_LOW = 0,
+ DMA_PRIORITY_LEVEL_MEDIUM = 1,
+ DMA_PRIORITY_LEVEL_HIGH = 2,
+ DMA_PRIORITY_LEVEL_VERY_HIGH = 3
+} dma_priority_level;
+
+typedef struct {
+ union {
+ uint32_t cc_r;
+ struct {
+ bits_t en:1; // channel enable
+ bits_t tcie:1; // transfer complete interrupt enable
+ bits_t htie:1; // half transfer interrupt enable
+ bits_t teie:1; // transfer error interrupt enable
+ bits_t dir:1; // data transfer direction
+ bits_t circ:1; // circular mode
+ bits_t pinc:1; // peripheral increment mode
+ bits_t minc:1; // memory increment mode
+ bits_t psize:2; // Peripheral size
+ bits_t msize:2; // Memory size
+ bits_t pl:2; // Priority level
+ bits_t mem2mem:1; // Memory to memory mode
+ bits_t reserved:17;
+ } PACKED cc_bf;
+ };
+
+ /* Number of data to transfer. */
+ union {
+ uint32_t cndt_r;
+ struct {
+ uint16_t ndt; // Number of data to transfer.
+ uint16_t reserved;
+ } cndt_bf;
+ };
+
+ /* DMA channel peripheral address register.
+ * Defines a memory address if mem2mem is set. */
+ uint32_t cpa_r;
+
+ /* DMA channel memory address register.
+ * Defines another perpipheral address if peripheral-periphal mode is set. */
+ uint32_t cma_r;
+
+ uint32_t reserved;
+} dma_channel_config_t;
+
+typedef struct {
+ // DMA Interrupt status register.
+ union {
+ uint32_t is_r;
+ struct {
+ bits_t gif1:1; // global interrupt flag for channel 1
+ bits_t tcif1:1; // transfer complete (TC) flag for channel 1
+ bits_t htif1:1; // half transfer (HT) flag for channel 1
+ bits_t teif1:1; // transfer error (TE) flag for channel 1
+ bits_t gif2:1; // global interrupt flag for channel 2
+ bits_t tcif2:1; // transfer complete (TC) flag for channel 2
+ bits_t htif2:1; // half transfer (HT) flag for channel 2
+ bits_t teif2:1; // transfer error (TE) flag for channel 2
+ bits_t gif3:1; // global interrupt flag for channel 3
+ bits_t tcif3:1; // transfer complete (TC) flag for channel 3
+ bits_t htif3:1; // half transfer (HT) flag for channel 3
+ bits_t teif3:1; // transfer error (TE) flag for channel 3
+ bits_t gif4:1; // global interrupt flag for channel 4
+ bits_t tcif4:1; // transfer complete (TC) flag for channel 4
+ bits_t htif4:1; // half transfer (HT) flag for channel 4
+ bits_t teif4:1; // transfer error (TE) flag for channel 4
+ bits_t gif5:1; // global interrupt flag for channel 5
+ bits_t tcif5:1; // transfer complete (TC) flag for channel 5
+ bits_t htif5:1; // half transfer (HT) flag for channel 5
+ bits_t teif5:1; // transfer error (TE) flag for channel 5
+ bits_t gif6:1; // global interrupt flag for channel 6
+ bits_t tcif6:1; // transfer complete (TC) flag for channel 6
+ bits_t htif6:1; // half transfer (HT) flag for channel 6
+ bits_t teif6:1; // transfer error (TE) flag for channel 6
+ bits_t gif7:1; // global interrupt flag for channel 7
+ bits_t tcif7:1; // transfer complete (TC) flag for channel 7
+ bits_t htif7:1; // half transfer (HT) flag for channel 7
+ bits_t teif7:1; // transfer error (TE) flag for channel 7
+ bits_t reserved:4;
+ } PACKED is_bf;
+ };
+
+ // DMA Interrupt flag clear register
+ union {
+ uint32_t ifc_r;
+ struct {
+ bits_t cgif1:1; // global interrupt flag clear for channel 1
+ bits_t ctcif1:1; // transfer complete flag clear for channel 1
+ bits_t chtif1:1; // half transfer flag clear for channel 1
+ bits_t cteif1:1; // transfer error flag clear for channel 1
+ bits_t cgif2:1; // global interrupt flag clear for channel 2
+ bits_t ctcif2:1; // transfer complete flag clear for channel 2
+ bits_t chtif2:1; // half transfer flag clear for channel 2
+ bits_t cteif2:1; // transfer error flag clear for channel 2
+ bits_t cgif3:1; // global interrupt flag clear for channel 3
+ bits_t ctcif3:1; // transfer complete flag clear for channel 3
+ bits_t chtif3:1; // half transfer flag clear for channel 3
+ bits_t cteif3:1; // transfer error flag clear for channel 3
+ bits_t cgif4:1; // global interrupt flag clear for channel 4
+ bits_t ctcif4:1; // transfer complete flag clear for channel 4
+ bits_t chtif4:1; // half transfer flag clear for channel 4
+ bits_t cteif4:1; // transfer error flag clear for channel 4
+ bits_t cgif5:1; // global interrupt flag clear for channel 5
+ bits_t ctcif5:1; // transfer complete flag clear for channel 5
+ bits_t chtif5:1; // half transfer flag clear for channel 5
+ bits_t cteif5:1; // transfer error flag clear for channel 5
+ bits_t cgif6:1; // global interrupt flag clear for channel 6
+ bits_t ctcif6:1; // transfer complete flag clear for channel 6
+ bits_t chtif6:1; // half transfer flag clear for channel 6
+ bits_t cteif6:1; // transfer error flag clear for channel 6
+ bits_t cgif7:1; // global interrupt flag clear for channel 7
+ bits_t ctcif7:1; // transfer complete flag clear for channel 7
+ bits_t chtif7:1; // half transfer flag clear for channel 7
+ bits_t cteif7:1; // transfer error flag clear for channel 7
+ } PACKED ifc_bf;
+ };
+
+ dma_channel_config_t channel_config[7];
+
+ uint32_t reserved[5];
+
+ /* DMA channel selection register. */
+ union {
+ uint32_t csel_r;
+ struct {
+ bits_t c1s:4; // DMA channel 1 selection.
+ bits_t c2s:4; // DMA channel 2 selection.
+ bits_t c3s:4; // DMA channel 3 selection.
+ bits_t c4s:4; // DMA channel 4 selection.
+ bits_t c5s:4; // DMA channel 5 selection.
+ bits_t c6s:4; // DMA channel 6 selection.
+ bits_t c7s:4; // DMA channel 7 selection.
+ bits_t reserved:4;
+ } PACKED csel_bf;
+ };
+} dma_t;
+
+static_assert(offsetof(dma_t, csel_r) == 0xA8, "Offset check failed.");
+
+#endif /* DMA_H_ */
diff --git a/02-usart/include/usart.h b/02-usart/include/usart.h
index 257aab6..d806397 100644
--- a/02-usart/include/usart.h
+++ b/02-usart/include/usart.h
@@ -1,13 +1,17 @@
#ifndef H__USART_
#define H__USART_
+#include <arch.h>
+#include <stdint.h>
+
#include "common.h"
#include "rcc.h"
-#include <stdint.h>
+#define USART1 (* (__IO usart_t*) USART1_BASE)
+#define USART2 (* (__IO usart_t*) USART2_BASE)
/*
- * Possibel USART clock sources.
+ * Possible USART clock sources.
*/
typedef enum {
USART_CLK_SRC_PLK = 0, /* Clock derived from the SysClk. */
@@ -43,24 +47,82 @@ typedef struct {
bits_t eobie:1;
bits_t m1:1;
bits_t reserved:3;
- } PACKED c1_bf;
- };
+ } PACKED c1_bf; /* c1_bf = c1 bit field */
+ }; /* USART Control Register 1. */
uint32_t c_r2;
- uint32_t c_r3;
+
+ union {
+ uint32_t c_r3;
+ struct {
+ bits_t eie:1; // Error interrupt enable.
+ bits_t iren:1; // IrDA mode enabled
+ bits_t irlp:1; // IrDA low power
+ bits_t hdsel:1; // Half duplex selection
+ bits_t nack:1; // Smartcard NACK enable
+ bits_t scen:1; // Smartocard mode enable
+ bits_t dmar:1; // DMA enable reciever
+ bits_t dmat:1; // DMA enable transmitter
+ bits_t rtse:1; // RTS enable
+ bits_t ctse:1; // CTS enable
+ bits_t ctsie:1; // CTS interrupt enable
+ bits_t onebit:1; // One sample bit method enable
+ bits_t ovrdis:1; // Overrun disable
+ bits_t ddre:1; // DMA Disable on reception error
+ bits_t dem:1; // Driver enable mode
+ bits_t dep:1; // Driver enable polarity selection
+ bits_t reserved0:1;
+ bits_t scarcnt:3; // Smartcard auto-retry count.
+ bits_t wus:2; // Wakeup from STOP mode interrept flag selection
+ bits_t wufie:1; // Wakeup from STOP mode interrup enable
+ bits_t ucesm:1; // USART clock enable in STOP mode.
+ bits_t tcbgtie:1; // Transmission complete before guard time interrupt
+ bits_t reserved1:7;
+ } PACKED c3_bf;
+ };
/* USART baud rate register. */
uint32_t br_r;
uint32_t gtp_r;
uint32_t rto_r;
uint32_t rq_r;
- uint32_t is_r;
+
+ /* USART ISR register. Offset = 0x1c*/
+ union {
+ uint32_t is_r; /* Interrupt service register. */
+ struct {
+ bits_t pe:1; // Parity error
+ bits_t fe:1; // Framing error
+ bits_t nf:1; // START bit noise detection flag.
+ bits_t ore:1; // Overrun error
+ bits_t dlie:1; // Idle line detected
+ bits_t rxne:1; // Read data register not empty
+ bits_t tc:1; // Transmission complete
+ bits_t txe:1; // Transmit data register empty
+ bits_t lbdf:1; // LIN break detection flag
+ bits_t ctsif:1; // CTS interrupt flag
+ bits_t cts:1; // CTS flag.
+ bits_t rtof:1; // Receiever timeout
+ bits_t eobf:1; // End of block flag
+ bits_t reserved0:1;
+ bits_t abre:1; // Auto baud rate error
+ bits_t abrf:1; // Auto baud rate flag
+ bits_t busy:1; // Busy flag
+ bits_t cmf:1; // Character match flag
+ bits_t sbkf:1; // send break flag
+ bits_t rwu:1; // receiver wakeup frlom mute mode.
+ bits_t wuf:1; // Wakeup from stop mode flag
+ bits_t teack:1; // Transmit enable acknowledge flag.
+ bits_t reack:1; // Receieve enable acknowledge flag.
+ bits_t reserved1:2;
+ bits_t tcbgt:1; // Transmission completer before guard time completion.
+ bits_t reserved2:6;
+ } PACKED is_bf; /* Interrupt servite bit field. */
+ };
uint32_t ic_r;
uint32_t rd_r;
uint32_t td_r;
} usart_t;
-#define USART1 (* (__IO usart_t*) 0x40013800)
-#define USART2 (* (__IO usart_t*) 0x40004400)
typedef enum {
OVERSAMPLE_8,
OVERSAMPLE_16
@@ -112,7 +174,7 @@ void usart_set_enabled(__IO usart_t* usart, usart_enable_t enabled);
* Send a byte on the usart, This command blocks until the data
* is fully sent.
*/
-void usart_transmit_byte(__IO usart_t* usart, uint8_t byte);
+void usart_transmit_byte_sync(__IO usart_t* usart, uint8_t byte);
void set_usart1_clock_src(__IO rcc_t* rcc, usart_clk_src_t usart_clk_src);
@@ -122,10 +184,10 @@ void set_usart2_clock_src(__IO rcc_t* rcc, usart_clk_src_t usart_clk_src);
void set_usart2_clock_enabled(__IO rcc_t* rcc, bool enable);
-void usart_transmit_bytes(
+void usart_transmit_bytes_sync(
__IO usart_t* usart, const uint8_t* bytes, uint32_t n);
-void usart_transmit_str(__IO usart_t* usart, const char* str);
+void usart_transmit_str_sync(__IO usart_t* usart, const char* str);
#endif /* H__USART_ */