Contents

1. Introduction
2. Notes
3. Confirmed Operating Environment
4. Known Bugs
5. File List
6. Start Method
7. Verification Procedure
8. Revision History

1. Introduction

CTR_NotificationTextChecker is a tool for checking StreetPass and SpotPass notifications.
It provides an easy way to use the computer to check how notifications display, and to register notifications on PARTNER-CTR so they can be checked from the actual Notifications.
In addition, the tool can be used to check whether titles fit within a restricted number of characters, and whether they contain unusable characters.

2. Notes

You can run the Windows application ctr_NotificationTextChecker.exe to simply view what is shown to check the names of notification titles and to check whether StreetPass notifications fit within specifications, but this provides no guarantee that they will be properly displayed.
There is also a problem with readability when the display size is reduced. Ultimately, you should check the display using the PARTNER-CTR application NewsDataChecker.cci.
This tool is not a part of the CTR SDK.
There is a file with the same name in the package in the Tools folder of the SDK. Do not overwrite that file.

3. Confirmed Operating Environment

4. Known Bugs

Currently there are no known bugs.
For the latest information, including information about bugs identified after the release, see the Technical Information section of the Software Development Support Group website at http://www.warioworld.com/.

5. File List

6. Start Method

1. Start PARTNER-CTR and the PARTNER-CTR debugger software. Also start the HOST IO daemon (PARTNER-CTR HIO-Daemon).
2. Run ctr_NotificationTextChecker.exe on Windows.

7. Verification Procedure

1. Load NewsDataChecker.cci to PARTNER-CTR.
   On PARTNER-CTR, select File > Load Binary to Emulation Memory to load NewsDataChecker.cci, and then reset by selecting OS > Initialize Target.
   If successful, it loads an application with the banner News Data Checker in the HOME Menu.
   Note: You can perform the same process by running the included batch file loadcci.bat. However, to run this file you must install the CTR-SDK and set the correct environment variable.
2. Run News data checker from the HOME Menu.
3. Enter the StreetPass and SpotPass notification text that you want to check with ctr_NotificationTextChecker.exe on the PC.
4. From the HOME Menu, check Notifications.

Figure 1. Starting News Data Checker

Operations on the PC (ctr_NotificationTextChecker.exe)

StreetPass

1. Run ctr_NotificationTextChecker.exe and then select StreetPass from the radio buttons in the upper-right part of the window.
2. Select the Region you want to check for.
3. Type the title of the notification in StreetPass notification subject.
4. Type the body of the notification in StreetPass notification text.
5. Confirm there are no entry mistakes, and then click send. Sending is successful if the message Finished sending to the debugger is displayed.

Figure 2. The StreetPass Data-entry Screen of ctr_NotificationTextChecker.exe

• With StreetPass, if the StreetPass ID is the same you can exchange data between different regions, so you can check how StreetPass messages display in different regions.


• The lines at the bottom of the window show the display size (in dots) for each region.
  With the 3rd NUP (corresponding to System Updater 0.17.6) and beyond, the display size is reduced if it would display sticking out given the same magnification.
  A check is performed for all regions, but you do not need to worry about regions to which you do not intend to distribute notifications.


• When notifications are displayed in different regions, the alternate character is used when glyph data does not exist in a particular font. This tool does not treat this as an error.
  The reason is because it is almost impossible to fix this in way that is independent of the region and language.

SpotPass

1. Run ctr_NotificationTextChecker.exe and then select SpotPass from the radio buttons in the upper-right part of the window.
2. Select the Region you want to check for.
3. Type the subject of the notification in SpotPass subject.
4. Type the body of the notification in SpotPass text.
5. If the end of the notification has a link to a website, type the link in SpotPass url.
6. If there is something to display in the upper screen for the notification, drag the image file (.mpo or .jpeg) to SpotPass image.
7. Confirm there are no entry mistakes, and then click send. Sending is successful if the message Finished sending to the debugger is displayed.

Figure 3. The SpotPass Data-entry Screen of ctr_NotificationTextChecker.exe

• With SpotPass, an image can also be transferred for display in the upper screen.
  If you drag an image file (.mpo or .jpeg) to the SpotPass image field in the lower part of the window, that image is displayed (providing it is a correct image). If you click send with an image placed here, that image is applied to the notification.
  
　　

• The actual SpotPass notification displays a button at the end that can be selected to opt out from receiving notifications from the application. That button is not displayed with this tool because notifications are set by the application. However, when the notifications are received from the actual network, this opt-out button is displayed.
　　

• For the URL tag, type the URL to go to from the notification. To actually go to the URL, you must preface the link with http:// or https://.

Errors and Warnings

Errors and Warnings Displayed for the Subject Field

These errors and warnings can result from checking StreetPass and SpotPass notification titles, and include any actions to take.
Errors are shown in red text. Warnings are in blue.
Characters that cannot be displayed in the selected region are shown in red. Fix these characters.



Type	Displayed String	Solution
Error	width over	The display width is not wide enough even when the notification is reduced to 80% of its smallest font scale. The characters that stick out are not displayed, so shorten the text.
Warning	width over bug (fixed 3rd NUP)	This error concerns only developers of applications that conduct StreetPass and deliver notifications to systems with the 2nd NUP (corresponding to System Updater 0.16.24) or before. Ignore this warning if you are developing applications for systems with the 3rd NUP (corresponding to System Updater 0.17.6) or later. Because of a notifications bug in the 2nd NUP (corresponding to System Updater 0.16.24), the reduced display size is calculated incorrectly and sometimes the last character does not display. This warning is generated if a message that results in this problem has been entered. You might be able to avoid the problem by changing the wording or entering a space at the end of the text.
Error	too many chars	SpotPass and StreetPass titles can have up to 31 characters, and that number has been exceeded. Shorten the text.

Errors and Warnings Displayed for the Notification Text Field

If errors and warnings appear, check the following:



Type	Displayed String	Solution
Error	line over	There are more than two lines of text. Shorten the text length to no more than two lines.
Warning	**% scaled	This error concerns only developers of applications that conduct StreetPass to systems with the 2nd NUP (corresponding to System Updater 0.16.24) or before. Text sticks out for notifications with the 2nd NUP (corresponding to System Updater 0.16.24). Shorten the text. This warning is not a problem for notifications with the 3rd NUP (corresponding to System Updater 0.17.6) and later because the display size is reduced. However, there is no limit to how much the display size is reduced to fit within the screen, so there are readability problems if the text is too long.

Warnings and Errors Displayed in Dialog Box

Sometimes warnings and errors may be displayed in a dialog box while you are operating the tool.
The following warnings and errors can appear in a dialog box, together with the measures to take.



Type	Displayed Dialog Box String	Solution
Error	The image file size is greater than 51,200 bytes. Use an image file that is 51,200 bytes or less.	Reduce the file size to no more than 51,200 bytes, such as by lowering the quality of the attached image.
Error	The image is too big. Use an image size that is 400 x 240 pixels.	Adjust the width and height of the attached image so it is 400 x 240 pixels.
Error	Please enter a subject.	Nothing has been entered for StreetPass notification subject or SpotPass subject. Enter one or more characters in the field.
Error	Please enter text.	Nothing has been entered for StreetPass notification text or SpotPass text. Enter one or more characters in the field.
Error	There are too many characters in the subject.	Too many characters have been entered for StreetPass notification subject or SpotPass subject. Reduce the number of characters.
Error	The width of the subject string exceeds the guidelines.	The string entered for StreetPass notification subject or SpotPass subject is too wide. Reduce the number of characters or substitute with a narrower font width.
Error	There are lines in the text whose width exceeds the guidelines.	The string entered for SpotPass text is too wide. Reduce the number of characters or substitute with a narrower font width.
Error	There are too many characters in the URL.	Too many characters have been entered for SpotPass url. Reduce the number of characters.
Error	Failed to send to the debugger. Restart NewsChecker.cci and ctr_NotificationTextChecker.exe and then restart this tool.	In this state you cannot connect to the debugger. First start NewsChecker.cci on the debugger, and then start ctr_NotificationTextChecker.exe.
Warning	The width of the image is less than 400 pixels. When displayed on the upper screen, the image will be expanded to fit 400 pixels in width.	Fix the image width to 400 pixels. You can display the image as is, but it will stretch out horizontally and may not display as intended.
Warning	The height of the image is less than 240 pixels. When displayed on the upper screen, the image will be expanded to fit 240 pixels in height.	Fix the image height to 240 pixels. You can display the image as is, but it will stretch out vertically and may not display as intended.
Warning	The width of the image is less than 400 pixels; the height of the image is less than 240 pixels. When displayed on the upper screen, the image will be expanded to fit 400 x 240 pixels.	Fix the image width to 400 pixels and the height to 240 pixels. You can display the image as is, but it will stretch out and may not display as intended.

Operations on CTR (To Check Notifications)

1. If the notification has been sent successfully from the computer, the PARTNER-CTR displays Received...Added to News.
2. Press HOME on the PARTNER-CTR to display the HOME Menu.
3. Check the sent notifications from Notifications.

Figure 4. The Procedure for Checking Withthe News Data Checker After Receiving the Notification

• With NewsDataChecker.cci running you can use the X Button on the controller to delete the StreetPass message boxes created with this tool.


• NewsDataChecker.cci runs in the background even while the HOME Menu is running.
  That means you can receive notifications from the computer without returning to NewsDataChecker.cci each time.
  However, if you are in Notifications you must return to the HOME Menu.

Other Operations

• The dialog box messages shown by ctr_NotificationTextChecker.exe can be switched between Japanese and English from the menu.
  To do this, select Setting > Language.

8. Revision History

● Version 1.0.0　[2012/12/26]

• Initial version.

CONFIDENTIAL