paul@15 | 1 | /* |
paul@15 | 2 | * PIC32 peripheral configuration and initialisation. |
paul@15 | 3 | * |
paul@15 | 4 | * Copyright (C) 2017, 2018 Paul Boddie <paul@boddie.org.uk> |
paul@15 | 5 | * |
paul@15 | 6 | * This program is free software: you can redistribute it and/or modify |
paul@15 | 7 | * it under the terms of the GNU General Public License as published by |
paul@15 | 8 | * the Free Software Foundation, either version 3 of the License, or |
paul@15 | 9 | * (at your option) any later version. |
paul@15 | 10 | * |
paul@15 | 11 | * This program is distributed in the hope that it will be useful, |
paul@15 | 12 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
paul@15 | 13 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
paul@15 | 14 | * GNU General Public License for more details. |
paul@15 | 15 | * |
paul@15 | 16 | * You should have received a copy of the GNU General Public License |
paul@15 | 17 | * along with this program. If not, see <http://www.gnu.org/licenses/>. |
paul@15 | 18 | */ |
paul@15 | 19 | |
paul@0 | 20 | #include "cpu.h" |
paul@0 | 21 | #include "pic32_c.h" |
paul@3 | 22 | #include "init.h" |
paul@0 | 23 | |
paul@0 | 24 | |
paul@0 | 25 | |
paul@0 | 26 | /* Basic memory and pin initialisation. */ |
paul@0 | 27 | |
paul@0 | 28 | void init_memory(void) |
paul@0 | 29 | { |
paul@0 | 30 | /* |
paul@0 | 31 | Configure RAM. |
paul@0 | 32 | See: http://microchipdeveloper.com/32bit:mx-arch-exceptions-processor-initialization |
paul@0 | 33 | */ |
paul@0 | 34 | |
paul@0 | 35 | uint32_t config = REG(BMXCON); |
paul@0 | 36 | |
paul@0 | 37 | /* Set zero wait states for address setup. */ |
paul@0 | 38 | |
paul@0 | 39 | config &= ~(1 << 6); /* BMXCON<6> = BMXWSDRM = 0 */ |
paul@0 | 40 | |
paul@0 | 41 | /* Set bus arbitration mode. */ |
paul@0 | 42 | |
paul@0 | 43 | config &= ~0b111; |
paul@0 | 44 | config |= 0b010; /* BMXCON<2:0> = BMXARB<2:0> = 2 */ |
paul@0 | 45 | |
paul@0 | 46 | REG(BMXCON) = config; |
paul@0 | 47 | } |
paul@0 | 48 | |
paul@0 | 49 | void init_pins(void) |
paul@0 | 50 | { |
paul@0 | 51 | /* DEVCFG0<2> also needs setting to 0 before the program is run. */ |
paul@0 | 52 | |
paul@0 | 53 | CLR_REG(CFGCON, 1 << 3); /* CFGCON<3> = JTAGEN = 0 */ |
paul@0 | 54 | } |
paul@0 | 55 | |
paul@0 | 56 | void init_outputs(void) |
paul@0 | 57 | { |
paul@0 | 58 | /* Remove analogue features from pins. */ |
paul@0 | 59 | |
paul@0 | 60 | REG(ANSELA) = 0; |
paul@0 | 61 | REG(ANSELB) = 0; |
paul@0 | 62 | |
paul@3 | 63 | /* Set pins as outputs. */ |
paul@3 | 64 | |
paul@0 | 65 | REG(TRISA) = 0; |
paul@0 | 66 | REG(TRISB) = 0; |
paul@0 | 67 | |
paul@3 | 68 | /* Clear outputs. */ |
paul@3 | 69 | |
paul@0 | 70 | REG(PORTA) = 0; |
paul@0 | 71 | REG(PORTB) = 0; |
paul@0 | 72 | } |
paul@0 | 73 | |
paul@0 | 74 | |
paul@0 | 75 | |
paul@0 | 76 | /* Peripheral pin configuration. */ |
paul@0 | 77 | |
paul@0 | 78 | void lock_config(void) |
paul@0 | 79 | { |
paul@0 | 80 | SET_REG(CFGCON, 1 << 13); /* IOLOCK = 1 */ |
paul@0 | 81 | |
paul@0 | 82 | /* Lock the configuration again. */ |
paul@0 | 83 | |
paul@0 | 84 | REG(SYSKEY) = 0x33333333; |
paul@0 | 85 | } |
paul@0 | 86 | |
paul@0 | 87 | void unlock_config(void) |
paul@0 | 88 | { |
paul@0 | 89 | /* Unlock the configuration register bits. */ |
paul@0 | 90 | |
paul@0 | 91 | REG(SYSKEY) = 0; |
paul@0 | 92 | REG(SYSKEY) = 0xAA996655; |
paul@0 | 93 | REG(SYSKEY) = 0x556699AA; |
paul@0 | 94 | |
paul@0 | 95 | CLR_REG(CFGCON, 1 << 13); /* IOLOCK = 0 */ |
paul@0 | 96 | } |
paul@0 | 97 | |
paul@0 | 98 | |
paul@0 | 99 | |
paul@0 | 100 | /* Convenience operations. */ |
paul@0 | 101 | |
paul@0 | 102 | void interrupts_on(void) |
paul@0 | 103 | { |
paul@0 | 104 | init_interrupts(); |
paul@0 | 105 | enable_interrupts(); |
paul@0 | 106 | handle_error_level(); |
paul@0 | 107 | } |
paul@0 | 108 | |
paul@0 | 109 | |
paul@0 | 110 | |
paul@3 | 111 | /* DMA configuration. */ |
paul@3 | 112 | |
paul@3 | 113 | void init_dma(void) |
paul@3 | 114 | { |
paul@3 | 115 | /* Disable DMA interrupts. */ |
paul@3 | 116 | |
paul@3 | 117 | CLR_REG(DMAIEC, 0b1111 << DMAINTBASE); /* DMA3IE...DMA0IE = 0 */ |
paul@3 | 118 | |
paul@3 | 119 | /* Clear DMA interrupt flags. */ |
paul@3 | 120 | |
paul@3 | 121 | CLR_REG(DMAIFS, 0b1111 << DMAINTBASE); /* DMA3IF...DMA0IF = 0 */ |
paul@3 | 122 | |
paul@3 | 123 | /* Enable DMA. */ |
paul@3 | 124 | |
paul@3 | 125 | SET_REG(DMACON, 1 << 15); |
paul@3 | 126 | } |
paul@3 | 127 | |
paul@3 | 128 | /* Initialise the given channel. */ |
paul@0 | 129 | |
paul@10 | 130 | void dma_init(int channel, uint8_t pri) |
paul@0 | 131 | { |
paul@7 | 132 | if ((channel < DCHMIN) || (channel > DCHMAX)) |
paul@3 | 133 | return; |
paul@3 | 134 | |
paul@3 | 135 | /* Initialise a channel. */ |
paul@3 | 136 | |
paul@10 | 137 | REG(DMA_REG(channel, DCHxCON)) = pri & 0b11; |
paul@3 | 138 | REG(DMA_REG(channel, DCHxECON)) = 0; |
paul@3 | 139 | REG(DMA_REG(channel, DCHxINT)) = 0; |
paul@3 | 140 | } |
paul@3 | 141 | |
paul@23 | 142 | /* Set the channel repeated enable mode, enabling it again when a block transfer |
paul@23 | 143 | completes. The documentation describes this as auto-enable. */ |
paul@10 | 144 | |
paul@23 | 145 | void dma_set_auto_enable(int channel, int enable) |
paul@10 | 146 | { |
paul@23 | 147 | (enable ? SET_REG : CLR_REG)(DMA_REG(channel, DCHxCON), 1 << 4); |
paul@10 | 148 | } |
paul@10 | 149 | |
paul@10 | 150 | /* Set the channel chaining mode. */ |
paul@10 | 151 | |
paul@10 | 152 | void dma_set_chaining(int channel, enum dma_chain chain) |
paul@10 | 153 | { |
paul@10 | 154 | (chain != dma_chain_none ? |
paul@10 | 155 | SET_REG : CLR_REG)(DMA_REG(channel, DCHxCON), 1 << 5); |
paul@10 | 156 | |
paul@10 | 157 | (chain == dma_chain_next ? |
paul@10 | 158 | SET_REG : CLR_REG)(DMA_REG(channel, DCHxCON), 1 << 8); |
paul@10 | 159 | } |
paul@10 | 160 | |
paul@3 | 161 | /* Configure a channel's initiation interrupt. */ |
paul@3 | 162 | |
paul@3 | 163 | void dma_set_interrupt(int channel, uint8_t int_num, int enable) |
paul@3 | 164 | { |
paul@7 | 165 | if ((channel < DCHMIN) || (channel > DCHMAX)) |
paul@3 | 166 | return; |
paul@0 | 167 | |
paul@3 | 168 | /* Allow an interrupt to trigger the transfer. */ |
paul@3 | 169 | |
paul@3 | 170 | REG(DMA_REG(channel, DCHxECON)) = (int_num << 8) | |
paul@3 | 171 | ((enable ? 1 : 0) << 4); |
paul@3 | 172 | } |
paul@3 | 173 | |
paul@23 | 174 | /* Configure only the channel's initiation interrupt status. */ |
paul@23 | 175 | |
paul@23 | 176 | void dma_set_interrupt_enable(int channel, int enable) |
paul@23 | 177 | { |
paul@23 | 178 | if ((channel < DCHMIN) || (channel > DCHMAX)) |
paul@23 | 179 | return; |
paul@23 | 180 | |
paul@23 | 181 | (enable ? SET_REG : CLR_REG)(DMA_REG(channel, DCHxECON), 1 << 4); |
paul@23 | 182 | } |
paul@23 | 183 | |
paul@23 | 184 | /* Permit the channel to register events while disabled or suspended. A |
paul@23 | 185 | suspended channel is one that is enabled but where the DMA peripheral |
paul@23 | 186 | has been suspended. */ |
paul@23 | 187 | |
paul@23 | 188 | void dma_set_receive_events(int channel, int enable) |
paul@23 | 189 | { |
paul@23 | 190 | (enable ? SET_REG : CLR_REG)(DMA_REG(channel, DCHxCON), 1 << 6); |
paul@23 | 191 | } |
paul@23 | 192 | |
paul@3 | 193 | /* Set a channel's transfer parameters. */ |
paul@3 | 194 | |
paul@3 | 195 | void dma_set_transfer(int channel, |
paul@3 | 196 | uint32_t source_start_address, uint16_t source_size, |
paul@3 | 197 | uint32_t destination_start_address, uint16_t destination_size, |
paul@3 | 198 | uint16_t cell_size) |
paul@3 | 199 | { |
paul@7 | 200 | if ((channel < DCHMIN) || (channel > DCHMAX)) |
paul@3 | 201 | return; |
paul@0 | 202 | |
paul@3 | 203 | REG(DMA_REG(channel, DCHxSSIZ)) = source_size; |
paul@3 | 204 | REG(DMA_REG(channel, DCHxSSA)) = source_start_address; |
paul@3 | 205 | REG(DMA_REG(channel, DCHxDSIZ)) = destination_size; |
paul@3 | 206 | REG(DMA_REG(channel, DCHxDSA)) = destination_start_address; |
paul@3 | 207 | REG(DMA_REG(channel, DCHxCSIZ)) = cell_size; |
paul@3 | 208 | } |
paul@3 | 209 | |
paul@3 | 210 | /* Configure interrupts caused by the channel. */ |
paul@0 | 211 | |
paul@3 | 212 | void dma_init_interrupt(int channel, uint8_t conditions, |
paul@7 | 213 | uint8_t pri, uint8_t sub) |
paul@3 | 214 | { |
paul@7 | 215 | if ((channel < DCHMIN) || (channel > DCHMAX)) |
paul@3 | 216 | return; |
paul@0 | 217 | |
paul@10 | 218 | /* Disable channel interrupt and clear interrupt flag. */ |
paul@10 | 219 | |
paul@10 | 220 | CLR_REG(DMAIEC, DMA_INT_FLAGS(channel, 1)); |
paul@10 | 221 | CLR_REG(DMAIFS, DMA_INT_FLAGS(channel, 1)); |
paul@10 | 222 | |
paul@3 | 223 | /* Produce an interrupt for the provided conditions. */ |
paul@3 | 224 | |
paul@3 | 225 | REG(DMA_REG(channel, DCHxINT)) = conditions << 16; |
paul@3 | 226 | |
paul@3 | 227 | /* Set interrupt priorities. */ |
paul@3 | 228 | |
paul@14 | 229 | REG(DMAIPC) = (REG(DMAIPC) & |
paul@14 | 230 | ~(DMA_IPC_PRI(channel, 7, 3))) | |
paul@7 | 231 | DMA_IPC_PRI(channel, pri, sub); |
paul@0 | 232 | |
paul@0 | 233 | /* Enable interrupt. */ |
paul@0 | 234 | |
paul@10 | 235 | SET_REG(DMAIEC, DMA_INT_FLAGS(channel, 1)); |
paul@3 | 236 | } |
paul@3 | 237 | |
paul@23 | 238 | /* Enable or disable the channel. */ |
paul@23 | 239 | |
paul@23 | 240 | void dma_set_enable(int channel, int enable) |
paul@23 | 241 | { |
paul@23 | 242 | if ((channel < DCHMIN) || (channel > DCHMAX)) |
paul@23 | 243 | return; |
paul@23 | 244 | |
paul@23 | 245 | (enable ? SET_REG : CLR_REG)(DMA_REG(channel, DCHxCON), 1 << 7); |
paul@23 | 246 | } |
paul@23 | 247 | |
paul@23 | 248 | /* Disable a DMA channel. */ |
paul@23 | 249 | |
paul@23 | 250 | void dma_off(int channel) |
paul@23 | 251 | { |
paul@23 | 252 | dma_set_enable(channel, 0); |
paul@23 | 253 | } |
paul@23 | 254 | |
paul@3 | 255 | /* Enable a DMA channel. */ |
paul@3 | 256 | |
paul@3 | 257 | void dma_on(int channel) |
paul@3 | 258 | { |
paul@23 | 259 | dma_set_enable(channel, 1); |
paul@3 | 260 | } |
paul@3 | 261 | |
paul@7 | 262 | |
paul@7 | 263 | |
paul@29 | 264 | /* External interrupt initialisation. */ |
paul@29 | 265 | |
paul@29 | 266 | void int_init_interrupt(int int_num, uint8_t pri, uint8_t sub) |
paul@29 | 267 | { |
paul@29 | 268 | if ((int_num < INTMIN) || (int_num > INTMAX)) |
paul@29 | 269 | return; |
paul@29 | 270 | |
paul@29 | 271 | /* Disable interrupt and clear interrupt flag. */ |
paul@29 | 272 | |
paul@29 | 273 | CLR_REG(INTIEC, INT_INT_FLAGS(int_num, INTxIE)); |
paul@29 | 274 | CLR_REG(INTIFS, INT_INT_FLAGS(int_num, INTxIF)); |
paul@29 | 275 | |
paul@29 | 276 | /* Set interrupt priorities. */ |
paul@29 | 277 | |
paul@29 | 278 | REG(INT_IPC_REG(int_num)) = (REG(INT_IPC_REG(int_num)) & |
paul@29 | 279 | ~(INT_IPC_PRI(int_num, 7, 3))) | |
paul@29 | 280 | INT_IPC_PRI(int_num, pri, sub); |
paul@29 | 281 | |
paul@29 | 282 | /* Enable interrupt. */ |
paul@29 | 283 | |
paul@29 | 284 | SET_REG(INTIEC, INT_INT_FLAGS(int_num, INTxIE)); |
paul@29 | 285 | } |
paul@29 | 286 | |
paul@29 | 287 | |
paul@29 | 288 | |
paul@14 | 289 | /* Output compare configuration. */ |
paul@14 | 290 | |
paul@14 | 291 | void oc_init(int unit, uint8_t mode, int timer) |
paul@14 | 292 | { |
paul@14 | 293 | if ((unit < OCMIN) || (unit > OCMAX)) |
paul@14 | 294 | return; |
paul@14 | 295 | |
paul@14 | 296 | REG(OC_REG(unit, OCxCON)) = (timer == 3 ? (1 << 3) : 0) | (mode & 0b111); |
paul@14 | 297 | } |
paul@14 | 298 | |
paul@14 | 299 | /* Set the start value for the pulse. */ |
paul@14 | 300 | |
paul@14 | 301 | void oc_set_pulse(int unit, uint32_t start) |
paul@14 | 302 | { |
paul@14 | 303 | if ((unit < OCMIN) || (unit > OCMAX)) |
paul@14 | 304 | return; |
paul@14 | 305 | |
paul@14 | 306 | REG(OC_REG(unit, OCxR)) = start; |
paul@14 | 307 | } |
paul@14 | 308 | |
paul@14 | 309 | /* Set the end value for the pulse. */ |
paul@14 | 310 | |
paul@14 | 311 | void oc_set_pulse_end(int unit, uint32_t end) |
paul@14 | 312 | { |
paul@14 | 313 | if ((unit < OCMIN) || (unit > OCMAX)) |
paul@14 | 314 | return; |
paul@14 | 315 | |
paul@14 | 316 | REG(OC_REG(unit, OCxRS)) = end; |
paul@14 | 317 | } |
paul@14 | 318 | |
paul@14 | 319 | /* Configure interrupts caused by the unit. */ |
paul@14 | 320 | |
paul@14 | 321 | void oc_init_interrupt(int unit, uint8_t pri, uint8_t sub) |
paul@14 | 322 | { |
paul@14 | 323 | if ((unit < OCMIN) || (unit > OCMAX)) |
paul@14 | 324 | return; |
paul@14 | 325 | |
paul@14 | 326 | /* Disable interrupt and clear interrupt flag. */ |
paul@14 | 327 | |
paul@14 | 328 | CLR_REG(OCIEC, OC_INT_FLAGS(unit, OCxIE)); |
paul@14 | 329 | CLR_REG(OCIFS, OC_INT_FLAGS(unit, OCxIF)); |
paul@14 | 330 | |
paul@14 | 331 | /* Set interrupt priorities. */ |
paul@14 | 332 | |
paul@14 | 333 | REG(OC_IPC_REG(unit)) = (REG(OC_IPC_REG(unit)) & |
paul@14 | 334 | ~(OC_IPC_PRI(unit, 7, 3))) | |
paul@14 | 335 | OC_IPC_PRI(unit, pri, sub); |
paul@14 | 336 | |
paul@14 | 337 | /* Enable interrupt. */ |
paul@14 | 338 | |
paul@14 | 339 | SET_REG(OCIEC, OC_INT_FLAGS(unit, OCxIE)); |
paul@14 | 340 | } |
paul@14 | 341 | |
paul@14 | 342 | /* Enable a unit. */ |
paul@14 | 343 | |
paul@14 | 344 | void oc_on(int unit) |
paul@14 | 345 | { |
paul@14 | 346 | if ((unit < OCMIN) || (unit > OCMAX)) |
paul@14 | 347 | return; |
paul@14 | 348 | |
paul@14 | 349 | SET_REG(OC_REG(unit, OCxCON), 1 << 15); |
paul@14 | 350 | } |
paul@14 | 351 | |
paul@14 | 352 | |
paul@14 | 353 | |
paul@7 | 354 | /* Timer configuration. */ |
paul@7 | 355 | |
paul@7 | 356 | void timer_init(int timer, uint8_t prescale, uint16_t limit) |
paul@7 | 357 | { |
paul@7 | 358 | /* NOTE: Should convert from the real prescale value. */ |
paul@7 | 359 | |
paul@7 | 360 | REG(TIMER_REG(timer, TxCON)) = (prescale & 0b111) << 4; |
paul@7 | 361 | REG(TIMER_REG(timer, TMRx)) = 0; |
paul@7 | 362 | REG(TIMER_REG(timer, PRx)) = limit; |
paul@7 | 363 | } |
paul@7 | 364 | |
paul@7 | 365 | /* Configure interrupts caused by the timer. */ |
paul@7 | 366 | |
paul@7 | 367 | void timer_init_interrupt(int timer, uint8_t pri, uint8_t sub) |
paul@7 | 368 | { |
paul@7 | 369 | if ((timer < TIMERMIN) || (timer > TIMERMAX)) |
paul@7 | 370 | return; |
paul@7 | 371 | |
paul@14 | 372 | /* Disable interrupt and clear interrupt flag. */ |
paul@14 | 373 | |
paul@14 | 374 | CLR_REG(TIMERIEC, TIMER_INT_FLAGS(timer, TxIE)); |
paul@14 | 375 | CLR_REG(TIMERIFS, TIMER_INT_FLAGS(timer, TxIF)); |
paul@14 | 376 | |
paul@7 | 377 | /* Set interrupt priorities. */ |
paul@7 | 378 | |
paul@7 | 379 | REG(TIMER_IPC_REG(timer)) = (REG(TIMER_IPC_REG(timer)) & |
paul@7 | 380 | ~(TIMER_IPC_PRI(timer, 7, 3))) | |
paul@7 | 381 | TIMER_IPC_PRI(timer, pri, sub); |
paul@7 | 382 | |
paul@7 | 383 | /* Enable interrupt. */ |
paul@7 | 384 | |
paul@7 | 385 | SET_REG(TIMERIEC, TIMER_INT_FLAGS(timer, TxIE)); |
paul@7 | 386 | } |
paul@7 | 387 | |
paul@7 | 388 | /* Enable a timer. */ |
paul@7 | 389 | |
paul@7 | 390 | void timer_on(int timer) |
paul@7 | 391 | { |
paul@7 | 392 | if ((timer < TIMERMIN) || (timer > TIMERMAX)) |
paul@7 | 393 | return; |
paul@7 | 394 | |
paul@7 | 395 | SET_REG(TIMER_REG(timer, TxCON), 1 << 15); |
paul@7 | 396 | } |
paul@7 | 397 | |
paul@7 | 398 | |
paul@7 | 399 | |
paul@3 | 400 | /* UART configuration. */ |
paul@3 | 401 | |
paul@7 | 402 | void uart_init(int uart, uint32_t baudrate) |
paul@3 | 403 | { |
paul@3 | 404 | /* NOTE: Configured in the initial payload. */ |
paul@3 | 405 | |
paul@3 | 406 | uint32_t FPB = 24000000; |
paul@3 | 407 | |
paul@7 | 408 | if ((uart < UARTMIN) || (uart > UARTMAX)) |
paul@3 | 409 | return; |
paul@3 | 410 | |
paul@3 | 411 | /* Disable the UART (ON). */ |
paul@3 | 412 | |
paul@7 | 413 | CLR_REG(UART_REG(uart, UxMODE), 1 << 15); |
paul@3 | 414 | |
paul@3 | 415 | /* Set the baud rate. For example: |
paul@3 | 416 | |
paul@3 | 417 | UxBRG<15:0> = BRG |
paul@3 | 418 | = (FPB / (16 * baudrate)) - 1 |
paul@3 | 419 | = (24000000 / (16 * 115200)) - 1 |
paul@3 | 420 | = 12 |
paul@3 | 421 | */ |
paul@3 | 422 | |
paul@7 | 423 | REG(UART_REG(uart, UxBRG)) = (FPB / (16 * baudrate)) - 1; |
paul@3 | 424 | } |
paul@3 | 425 | |
paul@3 | 426 | /* Configure interrupts caused by the UART. */ |
paul@3 | 427 | |
paul@7 | 428 | void uart_init_interrupt(int uart, uint8_t conditions, |
paul@7 | 429 | uint8_t pri, uint8_t sub) |
paul@3 | 430 | { |
paul@7 | 431 | if ((uart < UARTMIN) || (uart > UARTMAX)) |
paul@3 | 432 | return; |
paul@3 | 433 | |
paul@14 | 434 | /* Disable interrupts and clear interrupt flags. */ |
paul@14 | 435 | |
paul@14 | 436 | CLR_REG(UARTIEC, UART_INT_FLAGS(uart, UxTIE | UxRIE | UxEIE)); |
paul@14 | 437 | CLR_REG(UARTIFS, UART_INT_FLAGS(uart, UxTIF | UxRIF | UxEIF)); |
paul@14 | 438 | |
paul@3 | 439 | /* Set priorities: UxIP = pri; UxIS = sub */ |
paul@3 | 440 | |
paul@14 | 441 | REG(UART_IPC_REG(uart)) = (REG(UART_IPC_REG(uart)) & |
paul@14 | 442 | ~UART_IPC_PRI(uart, 7, 3)) | |
paul@14 | 443 | UART_IPC_PRI(uart, pri, sub); |
paul@3 | 444 | |
paul@7 | 445 | /* Enable interrupts. */ |
paul@3 | 446 | |
paul@7 | 447 | SET_REG(UARTIEC, UART_INT_FLAGS(uart, conditions)); |
paul@3 | 448 | } |
paul@3 | 449 | |
paul@3 | 450 | /* Enable a UART. */ |
paul@3 | 451 | |
paul@7 | 452 | void uart_on(int uart) |
paul@3 | 453 | { |
paul@7 | 454 | if ((uart < UARTMIN) || (uart > UARTMAX)) |
paul@3 | 455 | return; |
paul@3 | 456 | |
paul@3 | 457 | /* Enable receive (URXEN) and transmit (UTXEN). */ |
paul@3 | 458 | |
paul@7 | 459 | SET_REG(UART_REG(uart, UxSTA), (1 << 12) | (1 << 10)); |
paul@0 | 460 | |
paul@0 | 461 | /* Start UART. */ |
paul@0 | 462 | |
paul@7 | 463 | SET_REG(UART_REG(uart, UxMODE), 1 << 15); |
paul@3 | 464 | } |
paul@3 | 465 | |
paul@3 | 466 | |
paul@3 | 467 | |
paul@3 | 468 | /* Utility functions. */ |
paul@3 | 469 | |
paul@3 | 470 | /* Return encoded interrupt priorities. */ |
paul@3 | 471 | |
paul@3 | 472 | static uint8_t PRI(uint8_t pri, uint8_t sub) |
paul@3 | 473 | { |
paul@3 | 474 | return ((pri & 0b111) << 2) | (sub & 0b11); |
paul@3 | 475 | } |
paul@3 | 476 | |
paul@10 | 477 | /* Return the DMA interrupt flags for combining with a register. */ |
paul@10 | 478 | |
paul@10 | 479 | int DMA_INT_FLAGS(int channel, uint8_t flags) |
paul@10 | 480 | { |
paul@10 | 481 | return (flags & 0b1) << (DMAINTBASE + (channel - DCHMIN)); |
paul@10 | 482 | } |
paul@10 | 483 | |
paul@3 | 484 | /* Return encoded DMA interrupt priorities for combining with a register. */ |
paul@3 | 485 | |
paul@3 | 486 | uint32_t DMA_IPC_PRI(int channel, uint8_t pri, uint8_t sub) |
paul@3 | 487 | { |
paul@3 | 488 | return PRI(pri, sub) << (DCHIPCBASE + (channel - DCHMIN) * DCHIPCSTEP); |
paul@0 | 489 | } |
paul@3 | 490 | |
paul@29 | 491 | /* Return encoded external interrupt priorities for combining with a register. */ |
paul@29 | 492 | |
paul@29 | 493 | uint32_t INT_IPC_PRI(int int_num, uint8_t pri, uint8_t sub) |
paul@29 | 494 | { |
paul@29 | 495 | (void) int_num; |
paul@29 | 496 | return PRI(pri, sub) << INTIPCBASE; |
paul@29 | 497 | } |
paul@29 | 498 | |
paul@29 | 499 | /* Return the external interrupt priorities register. */ |
paul@29 | 500 | |
paul@29 | 501 | uint32_t INT_IPC_REG(int int_num) |
paul@29 | 502 | { |
paul@29 | 503 | switch (int_num) |
paul@29 | 504 | { |
paul@29 | 505 | case 0: return INT0IPC; |
paul@29 | 506 | case 1: return INT1IPC; |
paul@29 | 507 | case 2: return INT2IPC; |
paul@29 | 508 | case 3: return INT3IPC; |
paul@29 | 509 | case 4: return INT4IPC; |
paul@29 | 510 | default: return 0; /* should not occur */ |
paul@29 | 511 | } |
paul@29 | 512 | } |
paul@29 | 513 | |
paul@29 | 514 | /* Return the external interrupt flags for combining with a register. */ |
paul@29 | 515 | |
paul@29 | 516 | int INT_INT_FLAGS(int int_num, uint8_t flags) |
paul@29 | 517 | { |
paul@29 | 518 | return (flags & 0b1) << (INTINTBASE + (int_num - INTMIN) * INTINTSTEP); |
paul@29 | 519 | } |
paul@29 | 520 | |
paul@14 | 521 | /* Return encoded output compare interrupt priorities for combining with a register. */ |
paul@14 | 522 | |
paul@14 | 523 | uint32_t OC_IPC_PRI(int unit, uint8_t pri, uint8_t sub) |
paul@14 | 524 | { |
paul@14 | 525 | (void) unit; |
paul@14 | 526 | return PRI(pri, sub) << OCIPCBASE; |
paul@14 | 527 | } |
paul@14 | 528 | |
paul@14 | 529 | /* Return the output compare interrupt priorities register. */ |
paul@14 | 530 | |
paul@14 | 531 | uint32_t OC_IPC_REG(int unit) |
paul@14 | 532 | { |
paul@14 | 533 | switch (unit) |
paul@14 | 534 | { |
paul@14 | 535 | case 1: return OC1IPC; |
paul@14 | 536 | case 2: return OC2IPC; |
paul@14 | 537 | case 3: return OC3IPC; |
paul@14 | 538 | case 4: return OC4IPC; |
paul@14 | 539 | case 5: return OC5IPC; |
paul@14 | 540 | default: return 0; /* should not occur */ |
paul@14 | 541 | } |
paul@14 | 542 | } |
paul@14 | 543 | |
paul@14 | 544 | /* Return the output compare interrupt flags for combining with a register. */ |
paul@14 | 545 | |
paul@14 | 546 | int OC_INT_FLAGS(int unit, uint8_t flags) |
paul@14 | 547 | { |
paul@14 | 548 | return (flags & 0b1) << (OCINTBASE + (unit - OCMIN) * OCINTSTEP); |
paul@14 | 549 | } |
paul@14 | 550 | |
paul@7 | 551 | /* Return encoded timer interrupt priorities for combining with a register. */ |
paul@7 | 552 | |
paul@7 | 553 | uint32_t TIMER_IPC_PRI(int timer, uint8_t pri, uint8_t sub) |
paul@7 | 554 | { |
paul@7 | 555 | (void) timer; |
paul@7 | 556 | return PRI(pri, sub) << TIMERIPCBASE; |
paul@7 | 557 | } |
paul@7 | 558 | |
paul@7 | 559 | /* Return the timer interrupt priorities register. */ |
paul@7 | 560 | |
paul@7 | 561 | uint32_t TIMER_IPC_REG(int timer) |
paul@7 | 562 | { |
paul@7 | 563 | switch (timer) |
paul@7 | 564 | { |
paul@7 | 565 | case 1: return TIMER1IPC; |
paul@7 | 566 | case 2: return TIMER2IPC; |
paul@7 | 567 | case 3: return TIMER3IPC; |
paul@7 | 568 | case 4: return TIMER4IPC; |
paul@7 | 569 | case 5: return TIMER5IPC; |
paul@7 | 570 | default: return 0; /* should not occur */ |
paul@7 | 571 | } |
paul@7 | 572 | } |
paul@7 | 573 | |
paul@7 | 574 | /* Return the timer interrupt flags for combining with a register. */ |
paul@7 | 575 | |
paul@7 | 576 | int TIMER_INT_FLAGS(int timer, uint8_t flags) |
paul@7 | 577 | { |
paul@7 | 578 | return (flags & 0b1) << (TIMERINTBASE + (timer - TIMERMIN) * TIMERINTSTEP); |
paul@7 | 579 | } |
paul@7 | 580 | |
paul@3 | 581 | /* Return encoded UART interrupt priorities for combining with a register. */ |
paul@3 | 582 | |
paul@7 | 583 | uint32_t UART_IPC_PRI(int uart, uint8_t pri, uint8_t sub) |
paul@3 | 584 | { |
paul@7 | 585 | return PRI(pri, sub) << (uart == 1 ? UART1IPCBASE : UART2IPCBASE); |
paul@3 | 586 | } |
paul@3 | 587 | |
paul@3 | 588 | /* Return the UART interrupt priorities register. */ |
paul@3 | 589 | |
paul@7 | 590 | uint32_t UART_IPC_REG(int uart) |
paul@3 | 591 | { |
paul@7 | 592 | return uart == 1 ? UART1IPC : UART2IPC; |
paul@3 | 593 | } |
paul@3 | 594 | |
paul@7 | 595 | /* Return the UART interrupt flags for combining with a register. */ |
paul@3 | 596 | |
paul@7 | 597 | int UART_INT_FLAGS(int uart, uint8_t flags) |
paul@3 | 598 | { |
paul@7 | 599 | return (flags & 0b111) << (UARTINTBASE + (uart - UARTMIN) * UARTINTSTEP); |
paul@3 | 600 | } |