RAMPS compatible LCD controller module (HC3DPR0005)

[admin]

All items shown above picture are included.

RAMPS shield and Mega not included


Description:
This controller is designed to be used with a RepRap RAMPS interface board such as our RAMPS compatible shield (HC3DPR0002). Using this module allows you to print your designs without requiring a computer be connected to your printer. The module contains and 20 x 4 line backlit LCD display, buzzer, SD card reader, and control inputs. The module also includes cables and adapter board for solder-less connection to a RAMPS shield. Power is taken directly from the RAMPS shield so no additional cabling is required.

Although this module is designed to be used with a RAMPS shield and 3D printer, it can of course be used for any project where a panel mounted display and control input is required. An Arduino test sketch is available which will demonstrate how to use the module in your own projects.

Schematics:

RAMPS_LCD_Controller_Schematic.pdf

RAMPS_LCD_Controller_Adapter_Schematic.pdf

Arduino test sketch:

Code: [Select all] [Expand/Collapse]

1. /* FILE:    ARD_RAMPS_LCD_Panel_Test.pde
2.    DATE:    09/01/14
3.    VERSION: 0.1
4.  
5. This sketch will test all of the components of the RAMPS compatible LCD panel.
6. It assumes that the panel will be connected to an Arduino Mega and RAMPS shield.
7. However this sketch is useful if you are not intending to use it with a 3D printer
8. as an example of how to access the various components.
9.  
10. To run this test you will need to insert and SD card with a text file named
11. 'test.txt'. The test will display on the LCD the first 20 characters contained
12. within this file. You will also be prompted, via the LCD screen, to adjust the
13. controls of the panel.
14.  
15. The sketch will perform the following tests:
16.  
17. Buzzer test: The buzzer will beep twice
18. SD Card test: Will attempt to read the contents of the test.txt file on the SD card
19. Dial button check: Will prompt you to press the panels dial
20. Reset button test: Will prompt you to press the button labelled reset on the panel
21. Dial CW rotate test: Will prompt you to turn the dial clockwise until count = 10
22. Dial CCW rotate test: Will prompt you to turn the dial counter-clockwise until count = 0
23.  
24. There will be a 4 second delay between each test.
25.  
26.  
27. You may copy, alter and reuse this code in any way you like but please leave
28. reference to hobbycomponents.com in your comments if you redistribute this code.
29. This software may not be used by other sellers.
30.  
31. THIS SOFTWARE IS PROVIDED "AS IS". HOBBY COMPONENTS LTD MAKES NO WARRANTIES, WHETHER
32. EXPRESS, IMPLIED OR STATUTORY, INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF
33. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ACCURACY OR LACK OF NEGLIGENCE.
34. HOBBY COMPONENTS LTD SHALL NOT, IN ANY CIRCUMSTANCES, BE LIABLE FOR ANY DAMAGES,
35. INCLUDING, BUT NOT LIMITED TO, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES FOR ANY
36. REASON WHATSOEVER.
37. */
38.  
39. /* Include the LCD Library */
40. #include <LiquidCrystal.h>
41.  
42. /* Include the SD card library */
43. #include <SD.h>
44.  
45. /* DIO pin used to control the SD card readers CS pin */
46. #define SD_CARD_CD_DIO 53
47.  
48. /* Rotary encoder (dial) pins */
49. #define ROT_EN_A 31
50. #define ROT_EN_B 33
51.  
52. /* Rotary encoder button pin */
53. #define BUTTON_DIO 35
54. #define BUZZER_DIO 37
55.  
56. /* Reset button pin */
57. #define RESET_DIO 41
58.  
59. /* LCD display pins */
60. #define LCD_RS 16
61. #define LCD_EN 17
62. #define LCD_D4 23
63. #define LCD_D5 25
64. #define LCD_D6 27
65. #define LCD_D7 29
66.  
67.  
68. /* Create an instance of the LCD library. */
69. LiquidCrystal lcd(LCD_RS, LCD_EN, LCD_D4, LCD_D5, LCD_D6, LCD_D7);
70.  
71. /* Create an instance of the SD card library */
72. File SDFileData;
73.  
74.  
75. void setup()
76. {
77.   /* Initialise the LCD */
78.   lcd.begin(20, 4);
79.  
80.   /* Configure the pins used to read the status of the panel dial
81.      and buttons */
82.   pinMode(BUZZER_DIO, OUTPUT);    
83.   pinMode(BUTTON_DIO, INPUT);  
84.   digitalWrite(BUTTON_DIO, HIGH);
85.   pinMode(RESET_DIO, INPUT);  
86.   digitalWrite(RESET_DIO, HIGH);
87.   pinMode(ROT_EN_A,INPUT);
88.   pinMode(ROT_EN_B,INPUT);
89.   digitalWrite(ROT_EN_A, HIGH);
90.   digitalWrite(ROT_EN_B, HIGH);
91. }
92.  
93.  
94. /* Main program loop */
95. void loop()
96. {
97.   /* Output the test message to the LCD */
98.   lcd.setCursor(2,0);
99.   lcd.print("HOBBY COMPONENTS");
100.   lcd.setCursor(2,1);
101.   lcd.print("RAMPS LCD PANEL");
102.   lcd.setCursor(4,2);
103.   lcd.print("HC3DPR0005");
104.   lcd.setCursor(8,3);
105.   lcd.print("TEST");
106.  
107.   /* Wait 4 seconds */
108.   delay(4000);
109.  
110.   /* Buzzer test */
111.   BuzzerCheck();
112.  
113.   /* SD card read test */
114.   SDCardCheck();
115.   delay(4000);
116.  
117.   /* Control check */
118.   ControlCheck();
119.   delay(4000);
120.  
121.   /* All done! */
122.   lcd.clear();
123.   lcd.setCursor(3,1);
124.   lcd.print("TEST COMPLETE");
125.  
126.   while(1);
127. }
128.  
129. /* Test the buzzer by beeping twice */
130. void BuzzerCheck(void)
131. {
132.   lcd.clear();
133.   lcd.setCursor(4,1);
134.   lcd.print("BUZZER CHECK");
135.  
136.   digitalWrite(BUZZER_DIO, HIGH);
137.   delay(300);
138.   digitalWrite(BUZZER_DIO, LOW);
139.   delay(300);
140.   digitalWrite(BUZZER_DIO, HIGH);
141.   delay(300);
142.   digitalWrite(BUZZER_DIO, LOW);
143. }
144.  
145. /* Test the SD card by reading the contents of a file named test.txt */
146. void SDCardCheck(void)
147. {
148.   byte index;
149.   char SDCardText[]= "                    ";
150.  
151.   /* Display new test */
152.   lcd.clear();
153.   lcd.setCursor(3,0);
154.   lcd.print("SD CARD CHECK");
155.   lcd.setCursor(0,1);
156.   lcd.print("Initiliasing..");
157.  
158.   /* Initialise the SD card */
159.   if (!SD.begin(SD_CARD_CD_DIO))
160.   {
161.     /* If there was an error output this to the LCD */
162.     lcd.setCursor(14,1);
163.     lcd.print("ERROR!");
164.     lcd.setCursor(0,3);
165.     lcd.print("SD Card not detected");
166.   }else
167.   {
168.     lcd.setCursor(14,1);
169.     lcd.print("OK! ");
170.   }
171.  
172.  
173.    /* Check if the text file exists */
174.    if(SD.exists("test.txt"))
175.    {
176.      lcd.setCursor(0,2);
177.      lcd.print("test.txt contents:");
178.  
179.      /* The file exists so open it */
180.      SDFileData = SD.open("test.txt");
181.      
182.      /* Sequentially read the data from the file and store the first 20 characters */
183.      for (index = 0; index < 20; index++)
184.      {
185.        if (SDFileData.available())
186.          SDCardText[index] = SDFileData.read();
187.      }
188.      
189.      /* Display the contents on the LCD */
190.      lcd.setCursor(0,3);
191.      lcd.print(SDCardText);
192.  
193.    }else
194.    {
195.      lcd.setCursor(0,2);
196.      lcd.print("test.txt missing");  
197.    }
198.    
199.    /* Close the file */
200.    SDFileData.close();  
201. }
202.  
203. /* Check the dial and push buttons */
204. void ControlCheck(void)
205. {
206.   byte DialPos = 0;
207.   byte Last_DialPos = 0;
208.   byte DialCount = 0;
209.  
210.   /* Display new test */
211.   lcd.clear();
212.   lcd.setCursor(3,0);
213.   lcd.print("CONTROL CHECK");
214.  
215.   /* Prompt the user to press the dial */
216.   lcd.setCursor(0,2);
217.   lcd.print("Press dial:");
218.  
219.   /* Wait for the dial to be pressed */
220.   while(digitalRead(BUTTON_DIO));
221.  
222.   lcd.setCursor(12,2);
223.   lcd.print("PASS");
224.  
225.   delay(4000);
226.  
227.   /* Prompt the user to press the button marked reset */  
228.   lcd.setCursor(0,2);
229.   lcd.print("Press reset btn:    ");
230.  
231.   /* Wait for button to be pressed */
232.   while(digitalRead(RESET_DIO));
233.  
234.   lcd.setCursor(16,2);
235.   lcd.print("PASS");
236.  
237.   delay(4000);
238.  
239.   /* Prompt the user to turn the dial clockwise by 10 positions */
240.   lcd.setCursor(0,2);
241.   lcd.print("Rotate Dial CW:     ");
242.  
243.   /* Run this loop until the dial is turned 10 positions */
244.   while(DialCount <= 9)
245.   {
246.     /* Read the status of the dial */
247.     DialPos = (digitalRead(ROT_EN_B) << 1) | digitalRead(ROT_EN_A);
248.  
249.     /* Is the dial being turned clockwise ? */
250.     if (DialPos == 3 && Last_DialPos == 1)
251.     {
252.       /* If so increase the dial counter and display it */
253.       DialCount++;
254.       lcd.setCursor(16,2);
255.       lcd.print(DialCount);
256.     }
257.  
258.     /* If the dial counter reaches a value of 10 then the test has passed */
259.     if (DialCount >= 10)
260.     {
261.       lcd.setCursor(16,2);
262.       lcd.print("PASS");
263.     }
264.     /* Remember the last position of the dial so we know when it has changed */
265.     Last_DialPos = DialPos;
266.   }
267.  
268.   delay(4000);
269.   DialCount = 10;
270.   lcd.setCursor(0,2);
271.  
272.   /* Now instruct the user to rotate the dial counter-clockwise */
273.   lcd.print("Rotate Dial CCW:    ");
274.  
275.   /* Run this loop until the dial is turned 10 positions */
276.   while(DialCount)
277.   {
278.     /* Read the status of the dial */
279.     DialPos = (digitalRead(ROT_EN_B) << 1) | digitalRead(ROT_EN_A);
280.  
281.     /* Is the dial being turned counter-clockwise ? */
282.     if (DialPos == 3 && Last_DialPos == 2)
283.     {
284.       /* If so decrease the dial counter and display it */
285.       DialCount--;
286.       lcd.setCursor(17,2);
287.       lcd.print(DialCount);
288.     }
289.  
290.     /* If the dial counter reaches a value of 0 then the test has passed */
291.     if (DialCount == 0)
292.     {
293.       lcd.setCursor(16,2);
294.       lcd.print("PASS");
295.     }
296.  
297.     /* Remember the last position of the dial so we know when it has changed */
298.     Last_DialPos = DialPos;
299.   }
300. }

GeSHi © Codebox Plus Extension

FAQ:

How do I configure the Marlin firmware to use this panel?
In the Configuration.h file find the following line:

Code: Select all

//LCD and SD support
//#define ULTRA_LCD

and change to:

Code: Select all

//LCD and SD support
#define ULTRA_LCD

Then find the following lines:

Code: Select all

  #ifdef ULTRA_LCD
  #ifdef DOGLCD // Change number of lines to match the 128x64 graphics display
    #define LCD_WIDTH 20
    #define LCD_HEIGHT 5
  #else
    #define LCD_WIDTH 16
    #define LCD_HEIGHT 2

and change the last two lines to:

Code: Select all

    #define LCD_WIDTH 20
    #define LCD_HEIGHT 4

Remember to select the correct motherboard also in this file otherwise you won't see anything on the display! E.g. if using with a mega and our RAMPS 1.4 shield find the following line:

Code: Select all

#define MOTHERBOARD 7

and change it to:

Code: Select all

#define MOTHERBOARD 33

[jonnblanchard]

I've got the display working but I can't seem to get the encoder working in Marlin - i've defined the board as a NEWPANEL and set the following up in Pins.h:

#define BTN_EN1 31
#define BTN_EN2 33
#define BTN_ENC 35

When the board first boots I can use the encoder to change the flow rate, however, if I then push the encoder button to enter the menu the encoder no longer works, although I can still switch in and out of the menu with the button

[andrew]

I've taken a closer look at the Marlin firmware and it looks to me like the RepRap discount smart controller has the correct settings. With a default copy of the firmware can you uncomment the following line in the Configuaration.h file:

#define REPRAP_DISCOUNT_SMART_CONTROLLER

I can't confirm this fully works right now because we don't currently have one hooked up to a Marlin printer but I can navigate the menu's OK. If you can let me know if it has solved your problem I'll update the FAQ.

[ThierryM]

Hi,
I use this module for my Reprap Prusa under Marlin. All is working well except the SD card reader. The card is detected physicaly (card detected) but it can't be read.
I've tried 2 different SD Cards (2 Go Transcend and 16 Go Sandisk) but both aren't working. I think it's not these cards because I can read them with my other LCD controller (Full Graphic Smart Controller).
When I use your Arduino Sketch, I've the same problem (no test.txt file found).
I've found this forum topic : http://forums.reprap.org/read.php?146,238858 where the same problem is described but the solutions haven't worked for me.
Thanks for your help,
Regards,

Thierry

[andrew]

If the example sketch in the first post isn't working then its likely that its either a problem with the panel or a connection issue. Do you have this connected via a RAMPS shield?

[ThierryM]

Hi,
Thanks for your reply.
Yes it's a connected to a Ramps 1.4 shield with a Taurino Power from RepRapDiscount working under 24V.
I'll install your module with my other Ramps 1.4 and Taurino Classic (currently it's a configuration with a Full Graphic Smart LED Controller and its SD Card reader working) and I'll give you a feedback.
Regards,

Thierry

[ThierryM]

Hi, I've tested this module with an other Ramps 1.4 under 12V and the problem is the same : the card is physically detected but the reading is impossible.
Regards,

Thierry

[andrew]

Ok, I believe on this panel the software detects the card using a separate pin (D53) to the SPI interface and so the problem must relate to the a connection issue with one of the MOSI, MISO, SCK or 5V/GND connections. If you have a test meter you could try checking the continuity of these connections (especially the ribbon cable). It is a bit awkward to do on this however because each connection has to pass through several different boards and connections. One other thing may be worth doing is reformatting your cards just in case there is something odd about the way they are formatted although this is grasping at straws. Failing this I think we will be looking at returning it I'm afraid.

[ThierryM]

Hi,
I've reformatted the card in differents formats (Fat16 & Fat32) but the problem is always present. Besides my other LCD controller can read it.
I've an other ribbon câble (working with my Full Graphic LCD controller) and I'll test with it to see if the connections are correct.
Regards,

Thierry

[ThierryM]

Hi,
No problem with the ribbon cables. I can't test with my other jonction board with the Ramps (no same pluggin directions) but with my multimeter I didn't detect any anomaly on it.
Regards,

Thierry