paul@1 | 1 | /* |
paul@1 | 2 | * Ben NanoNote and EM027AS012 E-Paper Display Adapter Board communication. |
paul@1 | 3 | * |
paul@1 | 4 | * Copyright (C) 2013 Paul Boddie |
paul@1 | 5 | * |
paul@1 | 6 | * SPI functions derived from those in lib/atben.c by Werner Almesberger: |
paul@1 | 7 | * |
paul@1 | 8 | * Copyright (C) 2010-2011 Werner Almesberger |
paul@1 | 9 | * |
paul@1 | 10 | * This program is free software; you can redistribute it and/or modify |
paul@1 | 11 | * it under the terms of the GNU General Public License as published by |
paul@1 | 12 | * the Free Software Foundation; either version 2 of the License, or |
paul@1 | 13 | * (at your option) any later version. |
paul@1 | 14 | * |
paul@1 | 15 | * Driver-related code originally provided under the following terms: |
paul@1 | 16 | * |
paul@1 | 17 | * Copyright 2013 Pervasive Displays, Inc. |
paul@1 | 18 | * |
paul@1 | 19 | * Licensed under the Apache License, Version 2.0 (the "License"); |
paul@1 | 20 | * you may not use this file except in compliance with the License. |
paul@1 | 21 | * You may obtain a copy of the License at: |
paul@1 | 22 | * |
paul@1 | 23 | * http://www.apache.org/licenses/LICENSE-2.0 |
paul@1 | 24 | * |
paul@1 | 25 | * Unless required by applicable law or agreed to in writing, |
paul@1 | 26 | * software distributed under the License is distributed on an |
paul@1 | 27 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either |
paul@1 | 28 | * express or implied. See the License for the specific language |
paul@1 | 29 | * governing permissions and limitations under the License. |
paul@1 | 30 | */ |
paul@1 | 31 | |
paul@1 | 32 | #include <ubb/ubb.h> |
paul@1 | 33 | #include <unistd.h> |
paul@1 | 34 | #include <sys/time.h> |
paul@1 | 35 | #include <time.h> |
paul@1 | 36 | #include <stdio.h> |
paul@1 | 37 | #include "bsp.h" |
paul@1 | 38 | #include "Display_Hardware_Driver.h" |
paul@1 | 39 | |
paul@1 | 40 | void bsp_init() |
paul@1 | 41 | { |
paul@1 | 42 | OUT(UBB_DAT2); |
paul@1 | 43 | OUT(UBB_DAT3); |
paul@1 | 44 | OUT(UBB_CMD); |
paul@1 | 45 | OUT(UBB_CLK); |
paul@1 | 46 | OUT(UBB_DAT0); |
paul@1 | 47 | OUT(UBB_DAT1); |
paul@1 | 48 | } |
paul@1 | 49 | |
paul@1 | 50 | /* NanoNote-specific functions. */ |
paul@1 | 51 | |
paul@1 | 52 | void shift_select() |
paul@1 | 53 | { |
paul@1 | 54 | CLR(MUX_S0); |
paul@1 | 55 | } |
paul@1 | 56 | |
paul@1 | 57 | void shift_update() |
paul@1 | 58 | { |
paul@1 | 59 | SET(SHIFT_RCK); |
paul@1 | 60 | CLR(SHIFT_RCK); |
paul@1 | 61 | } |
paul@1 | 62 | |
paul@1 | 63 | void shift_init() |
paul@1 | 64 | { |
paul@1 | 65 | /* Initiate a clear operation. */ |
paul@1 | 66 | |
paul@1 | 67 | CLR(SHIFT_SCLR); |
paul@1 | 68 | |
paul@1 | 69 | /* Set clocks to known state. */ |
paul@1 | 70 | |
paul@1 | 71 | CLR(SHIFT_SCK); |
paul@1 | 72 | CLR(SHIFT_RCK); |
paul@1 | 73 | |
paul@1 | 74 | /* Propagate the clear operation. */ |
paul@1 | 75 | |
paul@1 | 76 | shift_update(); |
paul@1 | 77 | |
paul@1 | 78 | /* Finalise the initialisation. */ |
paul@1 | 79 | |
paul@1 | 80 | SET(SHIFT_SCLR); |
paul@1 | 81 | } |
paul@1 | 82 | |
paul@1 | 83 | void shift_reinit() |
paul@1 | 84 | { |
paul@1 | 85 | /* Set clocks to known state. */ |
paul@1 | 86 | |
paul@1 | 87 | CLR(SHIFT_SCK); |
paul@1 | 88 | CLR(SHIFT_RCK); |
paul@1 | 89 | |
paul@1 | 90 | /* Avoid clear operation. */ |
paul@1 | 91 | |
paul@1 | 92 | SET(SHIFT_SCLR); |
paul@1 | 93 | } |
paul@1 | 94 | |
paul@1 | 95 | void shift_in(uint8_t v) |
paul@1 | 96 | { |
paul@1 | 97 | if (v) |
paul@1 | 98 | SET(SHIFT_SI); |
paul@1 | 99 | else |
paul@1 | 100 | CLR(SHIFT_SI); |
paul@1 | 101 | |
paul@1 | 102 | SET(SHIFT_SCK); |
paul@1 | 103 | CLR(SHIFT_SCK); |
paul@1 | 104 | } |
paul@1 | 105 | |
paul@1 | 106 | void epd_select() |
paul@1 | 107 | { |
paul@1 | 108 | SET(MUX_S0); |
paul@1 | 109 | } |
paul@1 | 110 | |
paul@1 | 111 | /* Callback functions. */ |
paul@1 | 112 | |
paul@1 | 113 | void bsp_InitDisplayHardware() |
paul@1 | 114 | { |
paul@1 | 115 | /* This should do the following: |
paul@1 | 116 | |
paul@1 | 117 | PANEL = 0 |
paul@1 | 118 | CS/SSEL = 0 |
paul@1 | 119 | PWM = 0 |
paul@1 | 120 | RESET = 0 |
paul@1 | 121 | DIS = 0 |
paul@1 | 122 | |
paul@1 | 123 | (Could shift 0, 0 -> PANEL, DIS |
paul@1 | 124 | or 0, 0, 0 -> PANEL, BORDER, DIS.) |
paul@1 | 125 | */ |
paul@1 | 126 | |
paul@1 | 127 | shift_select(); |
paul@1 | 128 | shift_init(); /* PANEL = DIS = 0 */ |
paul@1 | 129 | |
paul@1 | 130 | epd_select(); |
paul@1 | 131 | CLR(EPD_SSEL); |
paul@1 | 132 | CLR(EPD_PWM); |
paul@1 | 133 | CLR(EPD_RESET); |
paul@1 | 134 | CLR(EPD_MOSI); |
paul@1 | 135 | |
paul@1 | 136 | printf("Hardware initialised.\n"); |
paul@1 | 137 | } |
paul@1 | 138 | |
paul@1 | 139 | void bsp_PowerOn() |
paul@1 | 140 | { |
paul@1 | 141 | /* This should do the following: |
paul@1 | 142 | |
paul@1 | 143 | RESET = 0 |
paul@1 | 144 | DIS = 0 |
paul@1 | 145 | CS/SSEL = 0 |
paul@1 | 146 | */ |
paul@1 | 147 | |
paul@1 | 148 | epd_select(); |
paul@1 | 149 | epd_rst_low(); |
paul@1 | 150 | |
paul@1 | 151 | shift_select(); |
paul@1 | 152 | shift_init(); /* PANEL = DIS = 0 */ |
paul@1 | 153 | |
paul@1 | 154 | printf("RESET = PANEL = DIS = 0\n"); |
paul@1 | 155 | |
paul@1 | 156 | /* Then, the following: |
paul@1 | 157 | |
paul@1 | 158 | PWM = 1/0 (5ms) |
paul@1 | 159 | PANEL = 1 |
paul@1 | 160 | PWM = 1/0 (10ms) |
paul@1 | 161 | BORDER = 1? |
paul@1 | 162 | RESET = 1 |
paul@1 | 163 | PWM = 1/0 (5ms) |
paul@1 | 164 | RESET = 0 |
paul@1 | 165 | PWM = 1/0 (5ms) |
paul@1 | 166 | RESET = 1 |
paul@1 | 167 | PWM = 1/0 (5ms) |
paul@1 | 168 | |
paul@1 | 169 | (Could shift 1 -> PANEL => PANEL=1, DIS=0 |
paul@1 | 170 | or 1, 1 -> PANEL, BORDER => PANEL=1, BORDER=1, DIS=0) |
paul@1 | 171 | */ |
paul@1 | 172 | |
paul@1 | 173 | epd_select(); |
paul@1 | 174 | epd_spi_init(); |
paul@1 | 175 | printf("PWM at 5ms starting: %u\n", bsp_getMsTicks()); |
paul@1 | 176 | epd_pwm_active(5); |
paul@1 | 177 | printf("PWM at 5ms done: %u\n", bsp_getMsTicks()); |
paul@1 | 178 | |
paul@1 | 179 | shift_select(); |
paul@1 | 180 | shift_init(); /* PANEL = DIS = 0 (still) */ |
paul@1 | 181 | shift_in(1); /* PANEL = 1 */ |
paul@1 | 182 | shift_update(); |
paul@1 | 183 | printf("PANEL = 1\n"); |
paul@1 | 184 | |
paul@1 | 185 | epd_select(); |
paul@1 | 186 | printf("PWM at 10ms starting: %u\n", bsp_getMsTicks()); |
paul@1 | 187 | epd_pwm_active(10); |
paul@1 | 188 | printf("PWM at 10ms done: %u\n", bsp_getMsTicks()); |
paul@1 | 189 | epd_cs_high(); |
paul@1 | 190 | epd_rst_high(); |
paul@1 | 191 | printf("PWM at 5ms starting: %u\n", bsp_getMsTicks()); |
paul@1 | 192 | epd_pwm_active(5); |
paul@1 | 193 | printf("PWM at 5ms done: %u\n", bsp_getMsTicks()); |
paul@1 | 194 | epd_rst_low(); |
paul@1 | 195 | printf("PWM at 5ms starting: %u\n", bsp_getMsTicks()); |
paul@1 | 196 | epd_pwm_active(5); |
paul@1 | 197 | printf("PWM at 5ms done: %u\n", bsp_getMsTicks()); |
paul@1 | 198 | epd_rst_high(); |
paul@1 | 199 | printf("PWM at 5ms starting: %u\n", bsp_getMsTicks()); |
paul@1 | 200 | epd_pwm_active(5); |
paul@1 | 201 | printf("PWM at 5ms done: %u\n", bsp_getMsTicks()); |
paul@1 | 202 | |
paul@1 | 203 | printf("Hardware powered.\n"); |
paul@1 | 204 | } |
paul@1 | 205 | |
paul@1 | 206 | void bsp_pwm_active(uint16_t delayInMs) |
paul@1 | 207 | { |
paul@1 | 208 | uint16_t numOfIterations; |
paul@1 | 209 | |
paul@1 | 210 | numOfIterations = delayInMs * 100; |
paul@1 | 211 | for (; numOfIterations > 0; numOfIterations--) |
paul@1 | 212 | { |
paul@1 | 213 | // PWM_SET_HIGH; |
paul@1 | 214 | SET(EPD_PWM); |
paul@1 | 215 | bsp_delayUs(5); //100kHz (96kHz ideal) |
paul@1 | 216 | // PWM_SET_LOW; |
paul@1 | 217 | CLR(EPD_PWM); |
paul@1 | 218 | bsp_delayUs(5); |
paul@1 | 219 | } |
paul@1 | 220 | } |
paul@1 | 221 | |
paul@1 | 222 | void bsp_Shutdown() |
paul@1 | 223 | { |
paul@1 | 224 | /* This should complete the power off operation as follows: |
paul@1 | 225 | |
paul@1 | 226 | RESET = 0 |
paul@1 | 227 | CS/SSEL = 0 |
paul@1 | 228 | PANEL = 0 |
paul@1 | 229 | BORDER = 0? |
paul@1 | 230 | DIS = 1 |
paul@1 | 231 | DIS = 0 (after 150ms) |
paul@1 | 232 | |
paul@1 | 233 | (Could shift 0 -> PANEL => PANEL=0, DIS=1 |
paul@1 | 234 | or 0, 0 -> PANEL, BORDER => PANEL=0, BORDER=0, DIS=1) |
paul@1 | 235 | */ |
paul@1 | 236 | |
paul@1 | 237 | epd_select(); |
paul@1 | 238 | epd_rst_low(); |
paul@1 | 239 | epd_cs_low(); |
paul@1 | 240 | epd_spi_detach(); |
paul@1 | 241 | |
paul@1 | 242 | shift_reinit(); |
paul@1 | 243 | shift_select(); |
paul@1 | 244 | shift_in(0); /* PANEL = 0; DIS = 1 */ |
paul@1 | 245 | shift_update(); |
paul@1 | 246 | printf("Wait for 150ms, starting: %u\n", bsp_getMsTicks()); |
paul@1 | 247 | epd_delay_ms(150); |
paul@1 | 248 | printf("Wait for 150ms, done: %u\n", bsp_getMsTicks()); |
paul@1 | 249 | shift_in(0); /* PANEL = 0; DIS = 0 */ |
paul@1 | 250 | shift_update(); |
paul@1 | 251 | |
paul@1 | 252 | printf("Hardware shut down.\n"); |
paul@1 | 253 | } |
paul@1 | 254 | |
paul@1 | 255 | void bsp_spiInit() |
paul@1 | 256 | { |
paul@1 | 257 | CLR(EPD_SCK); |
paul@1 | 258 | } |
paul@1 | 259 | |
paul@1 | 260 | /** |
paul@1 | 261 | * Send the given value via MOSI. |
paul@1 | 262 | */ |
paul@1 | 263 | void bsp_writeToDisplay(uint8_t *data, uint16_t len) |
paul@1 | 264 | { |
paul@1 | 265 | uint8_t mask, *ptr, *limit = data + len; |
paul@1 | 266 | |
paul@1 | 267 | for (ptr = data; ptr < limit; ptr++) |
paul@1 | 268 | { |
paul@1 | 269 | for (mask = 0x80; mask; mask >>= 1) |
paul@1 | 270 | { |
paul@1 | 271 | if (*ptr & mask) |
paul@1 | 272 | { |
paul@1 | 273 | SET(EPD_MOSI); |
paul@1 | 274 | } |
paul@1 | 275 | else |
paul@1 | 276 | { |
paul@1 | 277 | CLR(EPD_MOSI); |
paul@1 | 278 | } |
paul@1 | 279 | |
paul@1 | 280 | SET(EPD_SCK); |
paul@1 | 281 | CLR(EPD_SCK); |
paul@1 | 282 | } |
paul@1 | 283 | } |
paul@1 | 284 | } |
paul@1 | 285 | |
paul@1 | 286 | void bsp_delayMs(uint32_t ms) |
paul@1 | 287 | { |
paul@1 | 288 | bsp_delayUs(ms * 1000); |
paul@1 | 289 | } |
paul@1 | 290 | |
paul@1 | 291 | void bsp_delayUs(uint32_t us) |
paul@1 | 292 | { |
paul@1 | 293 | #ifndef NANONOTE |
paul@1 | 294 | struct timespec tv; |
paul@1 | 295 | tv.tv_sec = 0; |
paul@1 | 296 | tv.tv_nsec = us * 100; |
paul@1 | 297 | nanosleep(&tv, NULL); |
paul@1 | 298 | #else |
paul@1 | 299 | uint64_t i = us * 16; |
paul@1 | 300 | while (i-- > 0); |
paul@1 | 301 | #endif |
paul@1 | 302 | } |
paul@1 | 303 | |
paul@1 | 304 | uint32_t bsp_getMsTicks() |
paul@1 | 305 | { |
paul@1 | 306 | struct timeval tv; |
paul@1 | 307 | gettimeofday(&tv, NULL); |
paul@1 | 308 | return tv.tv_sec * 1000 + tv.tv_usec / 1000; |
paul@1 | 309 | } |
paul@1 | 310 | |
paul@1 | 311 | /* Unsupported. */ |
paul@1 | 312 | |
paul@1 | 313 | int16_t bsp_getTemp() |
paul@1 | 314 | { |
paul@1 | 315 | return 20; |
paul@1 | 316 | } |