{"id":538,"date":"2019-07-07T00:49:26","date_gmt":"2019-07-06T21:49:26","guid":{"rendered":"http:\/\/allchina.a-lisa.org\/?p=538"},"modified":"2019-07-08T17:28:06","modified_gmt":"2019-07-08T14:28:06","slug":"7-july-2019-0049","status":"publish","type":"post","link":"https:\/\/allchina.a-lisa.org\/?p=538","title":{"rendered":"RGB \u043f\u0430\u043d\u0435\u043b\u0438"},"content":{"rendered":"

Test Example Code<\/h1>\n

by Phillip Burgess<\/a><\/p>\n

We have example code ready to go for these displays. It’s compatible with the Arduino Uno or Mega\u2026but not<\/strong><\/em> other boards like the Leonardo, nor \u201cArduino-like\u201d boards such as Netduino\u2026programming gurus might<\/em> be able to port it to other microcontrollers by adapting the C++ source, but as written it does some pretty low-level, non-portable things.<\/p>\n

<\/p>\n

The library works with a LIMITED NUMBER of boards: Arduino Uno, Mega, Zero, Adafruit Metro M0 and Metro M4. Other boards (such as the Arduino Leonardo) ARE NOT SUPPORTED.<\/p>\n

Two<\/em> libraries need to be downloaded and installed: first is the RGB Matrix Panel library<\/a> (this contains the low-level code specific to this device), and second is the Adafruit GFX Library<\/a> (which handles graphics operations common to many displays we carry).<\/p>\n\n\n\n
\nBoth libraries can be found and installed using the Arduino Library Manager (Sketch\u2192Include Library\u2192Manage Libraries\u2026<\/strong>). Search for \u201cgfx\u201d and \u201crgb matrix panel\u201d and install the corresponding Adafruit libraries.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Now you are ready to test! Open up the IDE and load File\u2192Examples\u2192RGBmatrixPanel\u2192testcolors_16x32<\/strong> (for the 16×32 panel) or File\u2192Examples\u2192RGBmatrixPanel\u2192colorwheel_32x32<\/strong> (for the 32×32 panel).<\/p>\n

If using an Arduino Mega 2560,<\/strong> in addition to wiring changes previously mentioned, you’ll need to make a small change to each of the example sketches. This line:<\/p>\n

Download: file<\/a><\/p>\n

Copy Code<\/a><\/p>\n

    \n
  1. #define CLK 8 \/\/ MUST be on PORTB! (Use pin 11 on Mega)<\/li>\n<\/ol>\n

    Should be changed to:
    \nDownload:     file<\/a><\/p>\n

    Copy Code<\/a><\/p>\n

      \n
    1. #define CLK 11<\/li>\n<\/ol>\n

      (Any of digital pins 10-13 and 50-53 can be used for this function on the Mega, with the corresponding wiring change. The examples all reference pin 11.)<\/em><\/p>\n

      If using an Adafruit Metro M4<\/strong> (not<\/em> M0 or 328), the CLK change would instead be:<\/p>\n

      Download: file<\/a><\/p>\n

      Copy Code<\/a><\/p>\n

        \n
      1. #define CLK A4<\/li>\n<\/ol>\n

        After uploading, with the 16×32 panel you should see the following:
        \n        \"led_matrix_allcolors.jpg\"<\/a>
        \nThis is a test pattern that shows 512 colors (out of 4096) on the 512 pixels. Since there’s no really elegant way to show a 3-dimensional color space (R\/G\/B) in two dimensions, there’s just repeating grids of red\/green with increasing blue. Anyways, this shows you the range of colors you can achieve!<\/p>\n

        or, with the 32×32 panel:
        \n        \"led_matrix_rgbmatrix3232wheel_lrg.jpg\"<\/a>
        \nNow that you’ve got it working here are a few things to look for:<\/p>\n

        The most useful line to look at is:
        \nDownload:         file<\/a><\/p>\n

        Copy Code<\/a><\/p>\n

          \n
        1. matrix.drawPixel(x, y, matrix.Color333(r, g, b));<\/li>\n<\/ol>\n

          which is where we actually draw to the display. This code only draws one pixel at a time. The x<\/strong> and y<\/strong>coordinates are the individual pixels of the display. (0,0)<\/strong> is in the top left corner, (31, 15)<\/strong> is in the bottom right (remember that we start counting at 0 here!). To create a color, you will want to use the helper funciton Color333<\/strong> which will take three 3-bit numbers and combine them into a single packed integer. So for example, the first argument, r<\/strong> can range from 0 to 7. Likewise for g<\/strong>and b<\/strong>. To make a pixel that is pure red, r<\/strong> would be 7 and g, b<\/strong> would be 0. To make a white pixel, set all to 7. To make a black (off) pixel, set the colors to 0. A similar function, Color444<\/strong>, accepts three 4-bit numbers for up to 4096 colors.<\/p>\n

          Now we can open up the next example, which shows the rest of the library capabilities.<\/p>\n","protected":false},"excerpt":{"rendered":"

          Test Example Code by Phillip Burgess We have example code ready to go for these displays. It’s compatible with the<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[98],"tags":[],"class_list":["post-538","post","type-post","status-publish","format-standard","hentry","category-arduino"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/p7OYvE-8G","_links":{"self":[{"href":"https:\/\/allchina.a-lisa.org\/index.php?rest_route=\/wp\/v2\/posts\/538","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/allchina.a-lisa.org\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/allchina.a-lisa.org\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/allchina.a-lisa.org\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/allchina.a-lisa.org\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=538"}],"version-history":[{"count":1,"href":"https:\/\/allchina.a-lisa.org\/index.php?rest_route=\/wp\/v2\/posts\/538\/revisions"}],"predecessor-version":[{"id":541,"href":"https:\/\/allchina.a-lisa.org\/index.php?rest_route=\/wp\/v2\/posts\/538\/revisions\/541"}],"wp:attachment":[{"href":"https:\/\/allchina.a-lisa.org\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=538"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/allchina.a-lisa.org\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=538"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/allchina.a-lisa.org\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=538"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}