map_to_7segment.h 6.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179
  1. /* SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note */
  2. /*
  3. * Copyright (c) 2005 Henk Vergonet <[email protected]>
  4. */
  5. #ifndef MAP_TO_7SEGMENT_H
  6. #define MAP_TO_7SEGMENT_H
  7. /* This file provides translation primitives and tables for the conversion
  8. * of (ASCII) characters to a 7-segments notation.
  9. *
  10. * The 7 segment's wikipedia notation below is used as standard.
  11. * See: https://en.wikipedia.org/wiki/Seven_segment_display
  12. *
  13. * Notation: +-a-+
  14. * f b
  15. * +-g-+
  16. * e c
  17. * +-d-+
  18. *
  19. * Usage:
  20. *
  21. * Register a map variable, and fill it with a character set:
  22. * static SEG7_DEFAULT_MAP(map_seg7);
  23. *
  24. *
  25. * Then use for conversion:
  26. * seg7 = map_to_seg7(&map_seg7, some_char);
  27. * ...
  28. *
  29. * In device drivers it is recommended, if required, to make the char map
  30. * accessible via the sysfs interface using the following scheme:
  31. *
  32. * static ssize_t map_seg7_show(struct device *dev,
  33. * struct device_attribute *attr, char *buf)
  34. * {
  35. * memcpy(buf, &map_seg7, sizeof(map_seg7));
  36. * return sizeof(map_seg7);
  37. * }
  38. * static ssize_t map_seg7_store(struct device *dev,
  39. * struct device_attribute *attr, const char *buf,
  40. * size_t cnt)
  41. * {
  42. * if(cnt != sizeof(map_seg7))
  43. * return -EINVAL;
  44. * memcpy(&map_seg7, buf, cnt);
  45. * return cnt;
  46. * }
  47. * static DEVICE_ATTR_RW(map_seg7);
  48. *
  49. * History:
  50. * 2005-05-31 RFC [email protected]
  51. */
  52. #include <linux/errno.h>
  53. #define BIT_SEG7_A 0
  54. #define BIT_SEG7_B 1
  55. #define BIT_SEG7_C 2
  56. #define BIT_SEG7_D 3
  57. #define BIT_SEG7_E 4
  58. #define BIT_SEG7_F 5
  59. #define BIT_SEG7_G 6
  60. #define BIT_SEG7_RESERVED 7
  61. struct seg7_conversion_map {
  62. unsigned char table[128];
  63. };
  64. static __inline__ int map_to_seg7(struct seg7_conversion_map *map, int c)
  65. {
  66. return c >= 0 && c < sizeof(map->table) ? map->table[c] : -EINVAL;
  67. }
  68. #define SEG7_CONVERSION_MAP(_name, _map) \
  69. struct seg7_conversion_map _name = { .table = { _map } }
  70. /*
  71. * It is recommended to use a facility that allows user space to redefine
  72. * custom character sets for LCD devices. Please use a sysfs interface
  73. * as described above.
  74. */
  75. #define MAP_TO_SEG7_SYSFS_FILE "map_seg7"
  76. /*******************************************************************************
  77. * ASCII conversion table
  78. ******************************************************************************/
  79. #define _SEG7(l,a,b,c,d,e,f,g) \
  80. ( a<<BIT_SEG7_A | b<<BIT_SEG7_B | c<<BIT_SEG7_C | d<<BIT_SEG7_D | \
  81. e<<BIT_SEG7_E | f<<BIT_SEG7_F | g<<BIT_SEG7_G )
  82. #define _MAP_0_32_ASCII_SEG7_NON_PRINTABLE \
  83. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  84. #define _MAP_33_47_ASCII_SEG7_SYMBOL \
  85. _SEG7('!',0,0,0,0,1,1,0), _SEG7('"',0,1,0,0,0,1,0), _SEG7('#',0,1,1,0,1,1,0),\
  86. _SEG7('$',1,0,1,1,0,1,1), _SEG7('%',0,0,1,0,0,1,0), _SEG7('&',1,0,1,1,1,1,1),\
  87. _SEG7('\'',0,0,0,0,0,1,0),_SEG7('(',1,0,0,1,1,1,0), _SEG7(')',1,1,1,1,0,0,0),\
  88. _SEG7('*',0,1,1,0,1,1,1), _SEG7('+',0,1,1,0,0,0,1), _SEG7(',',0,0,0,0,1,0,0),\
  89. _SEG7('-',0,0,0,0,0,0,1), _SEG7('.',0,0,0,0,1,0,0), _SEG7('/',0,1,0,0,1,0,1),
  90. #define _MAP_48_57_ASCII_SEG7_NUMERIC \
  91. _SEG7('0',1,1,1,1,1,1,0), _SEG7('1',0,1,1,0,0,0,0), _SEG7('2',1,1,0,1,1,0,1),\
  92. _SEG7('3',1,1,1,1,0,0,1), _SEG7('4',0,1,1,0,0,1,1), _SEG7('5',1,0,1,1,0,1,1),\
  93. _SEG7('6',1,0,1,1,1,1,1), _SEG7('7',1,1,1,0,0,0,0), _SEG7('8',1,1,1,1,1,1,1),\
  94. _SEG7('9',1,1,1,1,0,1,1),
  95. #define _MAP_58_64_ASCII_SEG7_SYMBOL \
  96. _SEG7(':',0,0,0,1,0,0,1), _SEG7(';',0,0,0,1,0,0,1), _SEG7('<',1,0,0,0,0,1,1),\
  97. _SEG7('=',0,0,0,1,0,0,1), _SEG7('>',1,1,0,0,0,0,1), _SEG7('?',1,1,1,0,0,1,0),\
  98. _SEG7('@',1,1,0,1,1,1,1),
  99. #define _MAP_65_90_ASCII_SEG7_ALPHA_UPPR \
  100. _SEG7('A',1,1,1,0,1,1,1), _SEG7('B',1,1,1,1,1,1,1), _SEG7('C',1,0,0,1,1,1,0),\
  101. _SEG7('D',1,1,1,1,1,1,0), _SEG7('E',1,0,0,1,1,1,1), _SEG7('F',1,0,0,0,1,1,1),\
  102. _SEG7('G',1,1,1,1,0,1,1), _SEG7('H',0,1,1,0,1,1,1), _SEG7('I',0,1,1,0,0,0,0),\
  103. _SEG7('J',0,1,1,1,0,0,0), _SEG7('K',0,1,1,0,1,1,1), _SEG7('L',0,0,0,1,1,1,0),\
  104. _SEG7('M',1,1,1,0,1,1,0), _SEG7('N',1,1,1,0,1,1,0), _SEG7('O',1,1,1,1,1,1,0),\
  105. _SEG7('P',1,1,0,0,1,1,1), _SEG7('Q',1,1,1,1,1,1,0), _SEG7('R',1,1,1,0,1,1,1),\
  106. _SEG7('S',1,0,1,1,0,1,1), _SEG7('T',0,0,0,1,1,1,1), _SEG7('U',0,1,1,1,1,1,0),\
  107. _SEG7('V',0,1,1,1,1,1,0), _SEG7('W',0,1,1,1,1,1,1), _SEG7('X',0,1,1,0,1,1,1),\
  108. _SEG7('Y',0,1,1,0,0,1,1), _SEG7('Z',1,1,0,1,1,0,1),
  109. #define _MAP_91_96_ASCII_SEG7_SYMBOL \
  110. _SEG7('[',1,0,0,1,1,1,0), _SEG7('\\',0,0,1,0,0,1,1),_SEG7(']',1,1,1,1,0,0,0),\
  111. _SEG7('^',1,1,0,0,0,1,0), _SEG7('_',0,0,0,1,0,0,0), _SEG7('`',0,1,0,0,0,0,0),
  112. #define _MAP_97_122_ASCII_SEG7_ALPHA_LOWER \
  113. _SEG7('A',1,1,1,0,1,1,1), _SEG7('b',0,0,1,1,1,1,1), _SEG7('c',0,0,0,1,1,0,1),\
  114. _SEG7('d',0,1,1,1,1,0,1), _SEG7('E',1,0,0,1,1,1,1), _SEG7('F',1,0,0,0,1,1,1),\
  115. _SEG7('G',1,1,1,1,0,1,1), _SEG7('h',0,0,1,0,1,1,1), _SEG7('i',0,0,1,0,0,0,0),\
  116. _SEG7('j',0,0,1,1,0,0,0), _SEG7('k',0,0,1,0,1,1,1), _SEG7('L',0,0,0,1,1,1,0),\
  117. _SEG7('M',1,1,1,0,1,1,0), _SEG7('n',0,0,1,0,1,0,1), _SEG7('o',0,0,1,1,1,0,1),\
  118. _SEG7('P',1,1,0,0,1,1,1), _SEG7('q',1,1,1,0,0,1,1), _SEG7('r',0,0,0,0,1,0,1),\
  119. _SEG7('S',1,0,1,1,0,1,1), _SEG7('T',0,0,0,1,1,1,1), _SEG7('u',0,0,1,1,1,0,0),\
  120. _SEG7('v',0,0,1,1,1,0,0), _SEG7('W',0,1,1,1,1,1,1), _SEG7('X',0,1,1,0,1,1,1),\
  121. _SEG7('y',0,1,1,1,0,1,1), _SEG7('Z',1,1,0,1,1,0,1),
  122. #define _MAP_123_126_ASCII_SEG7_SYMBOL \
  123. _SEG7('{',1,0,0,1,1,1,0), _SEG7('|',0,0,0,0,1,1,0), _SEG7('}',1,1,1,1,0,0,0),\
  124. _SEG7('~',1,0,0,0,0,0,0),
  125. /* Maps */
  126. /* This set tries to map as close as possible to the visible characteristics
  127. * of the ASCII symbol, lowercase and uppercase letters may differ in
  128. * presentation on the display.
  129. */
  130. #define MAP_ASCII7SEG_ALPHANUM \
  131. _MAP_0_32_ASCII_SEG7_NON_PRINTABLE \
  132. _MAP_33_47_ASCII_SEG7_SYMBOL \
  133. _MAP_48_57_ASCII_SEG7_NUMERIC \
  134. _MAP_58_64_ASCII_SEG7_SYMBOL \
  135. _MAP_65_90_ASCII_SEG7_ALPHA_UPPR \
  136. _MAP_91_96_ASCII_SEG7_SYMBOL \
  137. _MAP_97_122_ASCII_SEG7_ALPHA_LOWER \
  138. _MAP_123_126_ASCII_SEG7_SYMBOL
  139. /* This set tries to map as close as possible to the symbolic characteristics
  140. * of the ASCII character for maximum discrimination.
  141. * For now this means all alpha chars are in lower case representations.
  142. * (This for example facilitates the use of hex numbers with uppercase input.)
  143. */
  144. #define MAP_ASCII7SEG_ALPHANUM_LC \
  145. _MAP_0_32_ASCII_SEG7_NON_PRINTABLE \
  146. _MAP_33_47_ASCII_SEG7_SYMBOL \
  147. _MAP_48_57_ASCII_SEG7_NUMERIC \
  148. _MAP_58_64_ASCII_SEG7_SYMBOL \
  149. _MAP_97_122_ASCII_SEG7_ALPHA_LOWER \
  150. _MAP_91_96_ASCII_SEG7_SYMBOL \
  151. _MAP_97_122_ASCII_SEG7_ALPHA_LOWER \
  152. _MAP_123_126_ASCII_SEG7_SYMBOL
  153. #define SEG7_DEFAULT_MAP(_name) \
  154. SEG7_CONVERSION_MAP(_name,MAP_ASCII7SEG_ALPHANUM)
  155. #endif /* MAP_TO_7SEGMENT_H */