soc.h 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498
  1. /*
  2. * OMAP cpu type detection
  3. *
  4. * Copyright (C) 2004, 2008 Nokia Corporation
  5. *
  6. * Copyright (C) 2009-11 Texas Instruments.
  7. *
  8. * Written by Tony Lindgren <tony.lindgren@nokia.com>
  9. *
  10. * Added OMAP4/5 specific defines - Santosh Shilimkar<santosh.shilimkar@ti.com>
  11. * Added DRA7xxx specific defines - Sricharan R<r.sricharan@ti.com>
  12. *
  13. * This program is free software; you can redistribute it and/or modify
  14. * it under the terms of the GNU General Public License as published by
  15. * the Free Software Foundation; either version 2 of the License, or
  16. * (at your option) any later version.
  17. *
  18. * This program is distributed in the hope that it will be useful,
  19. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  20. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  21. * GNU General Public License for more details.
  22. *
  23. * You should have received a copy of the GNU General Public License
  24. * along with this program; if not, write to the Free Software
  25. * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  26. *
  27. */
  28. #include "omap24xx.h"
  29. #include "omap34xx.h"
  30. #include "omap44xx.h"
  31. #include "ti81xx.h"
  32. #include "am33xx.h"
  33. #include "omap54xx.h"
  34. #ifndef __ASSEMBLY__
  35. #include <linux/bitops.h>
  36. #include <linux/of.h>
  37. /*
  38. * OMAP2+ is always defined as ARCH_MULTIPLATFORM in Kconfig
  39. */
  40. #undef MULTI_OMAP2
  41. #define MULTI_OMAP2
  42. /*
  43. * Omap device type i.e. EMU/HS/TST/GP/BAD
  44. */
  45. #define OMAP2_DEVICE_TYPE_TEST 0
  46. #define OMAP2_DEVICE_TYPE_EMU 1
  47. #define OMAP2_DEVICE_TYPE_SEC 2
  48. #define OMAP2_DEVICE_TYPE_GP 3
  49. #define OMAP2_DEVICE_TYPE_BAD 4
  50. int omap_type(void);
  51. /*
  52. * omap_rev bits:
  53. * SoC id bits (0730, 1510, 1710, 2422...) [31:16]
  54. * SoC revision (See _REV_ defined in cpu.h) [15:08]
  55. * SoC class bits (15xx, 16xx, 24xx, 34xx...) [07:00]
  56. */
  57. unsigned int omap_rev(void);
  58. static inline int soc_is_omap(void)
  59. {
  60. return omap_rev() != 0;
  61. }
  62. /*
  63. * Get the SoC revision for OMAP devices
  64. */
  65. #define GET_OMAP_REVISION() ((omap_rev() >> 8) & 0xff)
  66. /*
  67. * Macros to group OMAP into cpu classes.
  68. * These can be used in most places.
  69. * soc_is_omap24xx(): True for OMAP2420, OMAP2422, OMAP2423, OMAP2430
  70. * soc_is_omap242x(): True for OMAP2420, OMAP2422, OMAP2423
  71. * soc_is_omap243x(): True for OMAP2430
  72. * soc_is_omap343x(): True for OMAP3430
  73. * soc_is_omap443x(): True for OMAP4430
  74. * soc_is_omap446x(): True for OMAP4460
  75. * soc_is_omap447x(): True for OMAP4470
  76. * soc_is_omap543x(): True for OMAP5430, OMAP5432
  77. */
  78. #define GET_OMAP_CLASS (omap_rev() & 0xff)
  79. #define IS_OMAP_CLASS(class, id) \
  80. static inline int is_omap ##class (void) \
  81. { \
  82. return (GET_OMAP_CLASS == (id)) ? 1 : 0; \
  83. }
  84. #define GET_AM_CLASS ((omap_rev() >> 24) & 0xff)
  85. #define IS_AM_CLASS(class, id) \
  86. static inline int is_am ##class (void) \
  87. { \
  88. return (GET_AM_CLASS == (id)) ? 1 : 0; \
  89. }
  90. #define GET_TI_CLASS ((omap_rev() >> 24) & 0xff)
  91. #define IS_TI_CLASS(class, id) \
  92. static inline int is_ti ##class (void) \
  93. { \
  94. return (GET_TI_CLASS == (id)) ? 1 : 0; \
  95. }
  96. #define GET_DRA_CLASS ((omap_rev() >> 24) & 0xff)
  97. #define IS_DRA_CLASS(class, id) \
  98. static inline int is_dra ##class (void) \
  99. { \
  100. return (GET_DRA_CLASS == (id)) ? 1 : 0; \
  101. }
  102. #define GET_OMAP_SUBCLASS ((omap_rev() >> 20) & 0x0fff)
  103. #define IS_OMAP_SUBCLASS(subclass, id) \
  104. static inline int is_omap ##subclass (void) \
  105. { \
  106. return (GET_OMAP_SUBCLASS == (id)) ? 1 : 0; \
  107. }
  108. #define IS_TI_SUBCLASS(subclass, id) \
  109. static inline int is_ti ##subclass (void) \
  110. { \
  111. return (GET_OMAP_SUBCLASS == (id)) ? 1 : 0; \
  112. }
  113. #define IS_AM_SUBCLASS(subclass, id) \
  114. static inline int is_am ##subclass (void) \
  115. { \
  116. return (GET_OMAP_SUBCLASS == (id)) ? 1 : 0; \
  117. }
  118. #define IS_DRA_SUBCLASS(subclass, id) \
  119. static inline int is_dra ##subclass (void) \
  120. { \
  121. return (GET_OMAP_SUBCLASS == (id)) ? 1 : 0; \
  122. }
  123. IS_OMAP_CLASS(24xx, 0x24)
  124. IS_OMAP_CLASS(34xx, 0x34)
  125. IS_OMAP_CLASS(44xx, 0x44)
  126. IS_AM_CLASS(35xx, 0x35)
  127. IS_OMAP_CLASS(54xx, 0x54)
  128. IS_AM_CLASS(33xx, 0x33)
  129. IS_AM_CLASS(43xx, 0x43)
  130. IS_TI_CLASS(81xx, 0x81)
  131. IS_DRA_CLASS(7xx, 0x7)
  132. IS_OMAP_SUBCLASS(242x, 0x242)
  133. IS_OMAP_SUBCLASS(243x, 0x243)
  134. IS_OMAP_SUBCLASS(343x, 0x343)
  135. IS_OMAP_SUBCLASS(363x, 0x363)
  136. IS_OMAP_SUBCLASS(443x, 0x443)
  137. IS_OMAP_SUBCLASS(446x, 0x446)
  138. IS_OMAP_SUBCLASS(447x, 0x447)
  139. IS_OMAP_SUBCLASS(543x, 0x543)
  140. IS_TI_SUBCLASS(816x, 0x816)
  141. IS_TI_SUBCLASS(814x, 0x814)
  142. IS_AM_SUBCLASS(335x, 0x335)
  143. IS_AM_SUBCLASS(437x, 0x437)
  144. IS_DRA_SUBCLASS(75x, 0x75)
  145. IS_DRA_SUBCLASS(72x, 0x72)
  146. #define soc_is_ti81xx() 0
  147. #define soc_is_ti816x() 0
  148. #define soc_is_ti814x() 0
  149. #define soc_is_am35xx() 0
  150. #define soc_is_am33xx() 0
  151. #define soc_is_am335x() 0
  152. #define soc_is_am43xx() 0
  153. #define soc_is_am437x() 0
  154. #define soc_is_omap44xx() 0
  155. #define soc_is_omap443x() 0
  156. #define soc_is_omap446x() 0
  157. #define soc_is_omap447x() 0
  158. #define soc_is_omap54xx() 0
  159. #define soc_is_omap543x() 0
  160. #define soc_is_dra7xx() 0
  161. #define soc_is_dra74x() 0
  162. #define soc_is_dra72x() 0
  163. #if defined(CONFIG_ARCH_OMAP2)
  164. # define soc_is_omap24xx() is_omap24xx()
  165. #else
  166. # define soc_is_omap24xx() 0
  167. #endif
  168. #if defined(CONFIG_SOC_OMAP2420)
  169. # define soc_is_omap242x() is_omap242x()
  170. #else
  171. # define soc_is_omap242x() 0
  172. #endif
  173. #if defined(CONFIG_SOC_OMAP2430)
  174. # define soc_is_omap243x() is_omap243x()
  175. #else
  176. # define soc_is_omap243x() 0
  177. #endif
  178. #if defined(CONFIG_ARCH_OMAP3)
  179. # define soc_is_omap34xx() is_omap34xx()
  180. # define soc_is_omap343x() is_omap343x()
  181. #else
  182. # define soc_is_omap34xx() 0
  183. # define soc_is_omap343x() 0
  184. #endif
  185. /*
  186. * Macros to detect individual cpu types.
  187. * These are only rarely needed.
  188. * soc_is_omap2420(): True for OMAP2420
  189. * soc_is_omap2422(): True for OMAP2422
  190. * soc_is_omap2423(): True for OMAP2423
  191. * soc_is_omap2430(): True for OMAP2430
  192. * soc_is_omap3430(): True for OMAP3430
  193. */
  194. #define GET_OMAP_TYPE ((omap_rev() >> 16) & 0xffff)
  195. #define IS_OMAP_TYPE(type, id) \
  196. static inline int is_omap ##type (void) \
  197. { \
  198. return (GET_OMAP_TYPE == (id)) ? 1 : 0; \
  199. }
  200. IS_OMAP_TYPE(2420, 0x2420)
  201. IS_OMAP_TYPE(2422, 0x2422)
  202. IS_OMAP_TYPE(2423, 0x2423)
  203. IS_OMAP_TYPE(2430, 0x2430)
  204. IS_OMAP_TYPE(3430, 0x3430)
  205. #define soc_is_omap2420() 0
  206. #define soc_is_omap2422() 0
  207. #define soc_is_omap2423() 0
  208. #define soc_is_omap2430() 0
  209. #define soc_is_omap3430() 0
  210. #define soc_is_omap3630() 0
  211. #define soc_is_omap5430() 0
  212. /* These are needed for the common code */
  213. #define soc_is_omap7xx() 0
  214. #define soc_is_omap15xx() 0
  215. #define soc_is_omap16xx() 0
  216. #define soc_is_omap1510() 0
  217. #define soc_is_omap1610() 0
  218. #define soc_is_omap1611() 0
  219. #define soc_is_omap1621() 0
  220. #define soc_is_omap1710() 0
  221. #define cpu_class_is_omap1() 0
  222. #define cpu_class_is_omap2() 1
  223. #if defined(CONFIG_ARCH_OMAP2)
  224. # undef soc_is_omap2420
  225. # undef soc_is_omap2422
  226. # undef soc_is_omap2423
  227. # undef soc_is_omap2430
  228. # define soc_is_omap2420() is_omap2420()
  229. # define soc_is_omap2422() is_omap2422()
  230. # define soc_is_omap2423() is_omap2423()
  231. # define soc_is_omap2430() is_omap2430()
  232. #endif
  233. #if defined(CONFIG_ARCH_OMAP3)
  234. # undef soc_is_omap3430
  235. # undef soc_is_ti81xx
  236. # undef soc_is_ti816x
  237. # undef soc_is_ti814x
  238. # undef soc_is_am35xx
  239. # define soc_is_omap3430() is_omap3430()
  240. # undef soc_is_omap3630
  241. # define soc_is_omap3630() is_omap363x()
  242. # define soc_is_ti81xx() is_ti81xx()
  243. # define soc_is_ti816x() is_ti816x()
  244. # define soc_is_ti814x() is_ti814x()
  245. # define soc_is_am35xx() is_am35xx()
  246. #endif
  247. # if defined(CONFIG_SOC_AM33XX)
  248. # undef soc_is_am33xx
  249. # undef soc_is_am335x
  250. # define soc_is_am33xx() is_am33xx()
  251. # define soc_is_am335x() is_am335x()
  252. #endif
  253. #ifdef CONFIG_SOC_AM43XX
  254. # undef soc_is_am43xx
  255. # undef soc_is_am437x
  256. # define soc_is_am43xx() is_am43xx()
  257. # define soc_is_am437x() is_am437x()
  258. #endif
  259. # if defined(CONFIG_ARCH_OMAP4)
  260. # undef soc_is_omap44xx
  261. # undef soc_is_omap443x
  262. # undef soc_is_omap446x
  263. # undef soc_is_omap447x
  264. # define soc_is_omap44xx() is_omap44xx()
  265. # define soc_is_omap443x() is_omap443x()
  266. # define soc_is_omap446x() is_omap446x()
  267. # define soc_is_omap447x() is_omap447x()
  268. # endif
  269. # if defined(CONFIG_SOC_OMAP5)
  270. # undef soc_is_omap54xx
  271. # undef soc_is_omap543x
  272. # define soc_is_omap54xx() is_omap54xx()
  273. # define soc_is_omap543x() is_omap543x()
  274. #endif
  275. #if defined(CONFIG_SOC_DRA7XX)
  276. #undef soc_is_dra7xx
  277. #undef soc_is_dra74x
  278. #undef soc_is_dra72x
  279. #define soc_is_dra7xx() is_dra7xx()
  280. #define soc_is_dra74x() is_dra75x()
  281. #define soc_is_dra72x() is_dra72x()
  282. #endif
  283. /* Various silicon revisions for omap2 */
  284. #define OMAP242X_CLASS 0x24200024
  285. #define OMAP2420_REV_ES1_0 OMAP242X_CLASS
  286. #define OMAP2420_REV_ES2_0 (OMAP242X_CLASS | (0x1 << 8))
  287. #define OMAP243X_CLASS 0x24300024
  288. #define OMAP2430_REV_ES1_0 OMAP243X_CLASS
  289. #define OMAP343X_CLASS 0x34300034
  290. #define OMAP3430_REV_ES1_0 OMAP343X_CLASS
  291. #define OMAP3430_REV_ES2_0 (OMAP343X_CLASS | (0x1 << 8))
  292. #define OMAP3430_REV_ES2_1 (OMAP343X_CLASS | (0x2 << 8))
  293. #define OMAP3430_REV_ES3_0 (OMAP343X_CLASS | (0x3 << 8))
  294. #define OMAP3430_REV_ES3_1 (OMAP343X_CLASS | (0x4 << 8))
  295. #define OMAP3430_REV_ES3_1_2 (OMAP343X_CLASS | (0x5 << 8))
  296. #define OMAP363X_CLASS 0x36300034
  297. #define OMAP3630_REV_ES1_0 OMAP363X_CLASS
  298. #define OMAP3630_REV_ES1_1 (OMAP363X_CLASS | (0x1 << 8))
  299. #define OMAP3630_REV_ES1_2 (OMAP363X_CLASS | (0x2 << 8))
  300. #define TI816X_CLASS 0x81600081
  301. #define TI8168_REV_ES1_0 TI816X_CLASS
  302. #define TI8168_REV_ES1_1 (TI816X_CLASS | (0x1 << 8))
  303. #define TI8168_REV_ES2_0 (TI816X_CLASS | (0x2 << 8))
  304. #define TI8168_REV_ES2_1 (TI816X_CLASS | (0x3 << 8))
  305. #define TI814X_CLASS 0x81400081
  306. #define TI8148_REV_ES1_0 TI814X_CLASS
  307. #define TI8148_REV_ES2_0 (TI814X_CLASS | (0x1 << 8))
  308. #define TI8148_REV_ES2_1 (TI814X_CLASS | (0x2 << 8))
  309. #define AM35XX_CLASS 0x35170034
  310. #define AM35XX_REV_ES1_0 AM35XX_CLASS
  311. #define AM35XX_REV_ES1_1 (AM35XX_CLASS | (0x1 << 8))
  312. #define AM335X_CLASS 0x33500033
  313. #define AM335X_REV_ES1_0 AM335X_CLASS
  314. #define AM335X_REV_ES2_0 (AM335X_CLASS | (0x1 << 8))
  315. #define AM335X_REV_ES2_1 (AM335X_CLASS | (0x2 << 8))
  316. #define AM437X_CLASS 0x43700000
  317. #define AM437X_REV_ES1_0 (AM437X_CLASS | (0x10 << 8))
  318. #define AM437X_REV_ES1_1 (AM437X_CLASS | (0x11 << 8))
  319. #define AM437X_REV_ES1_2 (AM437X_CLASS | (0x12 << 8))
  320. #define OMAP443X_CLASS 0x44300044
  321. #define OMAP4430_REV_ES1_0 (OMAP443X_CLASS | (0x10 << 8))
  322. #define OMAP4430_REV_ES2_0 (OMAP443X_CLASS | (0x20 << 8))
  323. #define OMAP4430_REV_ES2_1 (OMAP443X_CLASS | (0x21 << 8))
  324. #define OMAP4430_REV_ES2_2 (OMAP443X_CLASS | (0x22 << 8))
  325. #define OMAP4430_REV_ES2_3 (OMAP443X_CLASS | (0x23 << 8))
  326. #define OMAP446X_CLASS 0x44600044
  327. #define OMAP4460_REV_ES1_0 (OMAP446X_CLASS | (0x10 << 8))
  328. #define OMAP4460_REV_ES1_1 (OMAP446X_CLASS | (0x11 << 8))
  329. #define OMAP447X_CLASS 0x44700044
  330. #define OMAP4470_REV_ES1_0 (OMAP447X_CLASS | (0x10 << 8))
  331. #define OMAP54XX_CLASS 0x54000054
  332. #define OMAP5430_REV_ES2_0 (OMAP54XX_CLASS | (0x30 << 16) | (0x20 << 8))
  333. #define OMAP5432_REV_ES2_0 (OMAP54XX_CLASS | (0x32 << 16) | (0x20 << 8))
  334. #define DRA7XX_CLASS 0x07000000
  335. #define DRA752_REV_ES1_0 (DRA7XX_CLASS | (0x52 << 16) | (0x10 << 8))
  336. #define DRA752_REV_ES1_1 (DRA7XX_CLASS | (0x52 << 16) | (0x11 << 8))
  337. #define DRA752_REV_ES2_0 (DRA7XX_CLASS | (0x52 << 16) | (0x20 << 8))
  338. #define DRA722_REV_ES1_0 (DRA7XX_CLASS | (0x22 << 16) | (0x10 << 8))
  339. #define DRA722_REV_ES1_0 (DRA7XX_CLASS | (0x22 << 16) | (0x10 << 8))
  340. #define DRA722_REV_ES2_0 (DRA7XX_CLASS | (0x22 << 16) | (0x20 << 8))
  341. void omap2xxx_check_revision(void);
  342. void omap3xxx_check_revision(void);
  343. void omap4xxx_check_revision(void);
  344. void omap5xxx_check_revision(void);
  345. void dra7xxx_check_revision(void);
  346. void omap3xxx_check_features(void);
  347. void ti81xx_check_features(void);
  348. void am33xx_check_features(void);
  349. void omap4xxx_check_features(void);
  350. /*
  351. * Runtime detection of OMAP3 features
  352. *
  353. * OMAP3_HAS_IO_CHAIN_CTRL: Some later members of the OMAP3 chip
  354. * family have OS-level control over the I/O chain clock. This is
  355. * to avoid a window during which wakeups could potentially be lost
  356. * during powerdomain transitions. If this bit is set, it
  357. * indicates that the chip does support OS-level control of this
  358. * feature.
  359. */
  360. extern u32 omap_features;
  361. #define OMAP3_HAS_L2CACHE BIT(0)
  362. #define OMAP3_HAS_IVA BIT(1)
  363. #define OMAP3_HAS_SGX BIT(2)
  364. #define OMAP3_HAS_NEON BIT(3)
  365. #define OMAP3_HAS_ISP BIT(4)
  366. #define OMAP3_HAS_192MHZ_CLK BIT(5)
  367. #define OMAP3_HAS_IO_WAKEUP BIT(6)
  368. #define OMAP3_HAS_SDRC BIT(7)
  369. #define OMAP3_HAS_IO_CHAIN_CTRL BIT(8)
  370. #define OMAP4_HAS_PERF_SILICON BIT(9)
  371. #define OMAP3_HAS_FEATURE(feat,flag) \
  372. static inline unsigned int omap3_has_ ##feat(void) \
  373. { \
  374. return omap_features & OMAP3_HAS_ ##flag; \
  375. } \
  376. OMAP3_HAS_FEATURE(l2cache, L2CACHE)
  377. OMAP3_HAS_FEATURE(sgx, SGX)
  378. OMAP3_HAS_FEATURE(iva, IVA)
  379. OMAP3_HAS_FEATURE(neon, NEON)
  380. OMAP3_HAS_FEATURE(isp, ISP)
  381. OMAP3_HAS_FEATURE(192mhz_clk, 192MHZ_CLK)
  382. OMAP3_HAS_FEATURE(io_wakeup, IO_WAKEUP)
  383. OMAP3_HAS_FEATURE(sdrc, SDRC)
  384. OMAP3_HAS_FEATURE(io_chain_ctrl, IO_CHAIN_CTRL)
  385. /*
  386. * Runtime detection of OMAP4 features
  387. */
  388. #define OMAP4_HAS_FEATURE(feat, flag) \
  389. static inline unsigned int omap4_has_ ##feat(void) \
  390. { \
  391. return omap_features & OMAP4_HAS_ ##flag; \
  392. } \
  393. OMAP4_HAS_FEATURE(perf_silicon, PERF_SILICON)
  394. /*
  395. * We need to make sure omap initcalls don't run when
  396. * multiplatform kernels are booted on other SoCs.
  397. */
  398. #define omap_initcall(level, fn) \
  399. static int __init __used __##fn(void) \
  400. { \
  401. if (!soc_is_omap()) \
  402. return 0; \
  403. return fn(); \
  404. } \
  405. level(__##fn);
  406. #define omap_early_initcall(fn) omap_initcall(early_initcall, fn)
  407. #define omap_core_initcall(fn) omap_initcall(core_initcall, fn)
  408. #define omap_postcore_initcall(fn) omap_initcall(postcore_initcall, fn)
  409. #define omap_arch_initcall(fn) omap_initcall(arch_initcall, fn)
  410. #define omap_subsys_initcall(fn) omap_initcall(subsys_initcall, fn)
  411. #define omap_device_initcall(fn) omap_initcall(device_initcall, fn)
  412. #define omap_late_initcall(fn) omap_initcall(late_initcall, fn)
  413. #define omap_late_initcall_sync(fn) omap_initcall(late_initcall_sync, fn)
  414. /* Legacy defines, these can be removed when users are removed */
  415. #define cpu_is_omap2420() soc_is_omap2420()
  416. #define cpu_is_omap2422() soc_is_omap2422()
  417. #define cpu_is_omap242x() soc_is_omap242x()
  418. #define cpu_is_omap2430() soc_is_omap2430()
  419. #define cpu_is_omap243x() soc_is_omap243x()
  420. #define cpu_is_omap24xx() soc_is_omap24xx()
  421. #define cpu_is_omap3430() soc_is_omap3430()
  422. #define cpu_is_omap343x() soc_is_omap343x()
  423. #define cpu_is_omap34xx() soc_is_omap34xx()
  424. #define cpu_is_omap3630() soc_is_omap3630()
  425. #define cpu_is_omap443x() soc_is_omap443x()
  426. #define cpu_is_omap446x() soc_is_omap446x()
  427. #define cpu_is_omap44xx() soc_is_omap44xx()
  428. #define cpu_is_ti814x() soc_is_ti814x()
  429. #define cpu_is_ti816x() soc_is_ti816x()
  430. #define cpu_is_ti81xx() soc_is_ti81xx()
  431. #endif /* __ASSEMBLY__ */