Determining your platform

iPhone dev: Determining your platform

By Erica Sadun |  Last updated March 2, 2009 4:51 PM

There are real differences between the first and second generation iPod touch. The second generation iPod presents built-in speakers, a faster processor, and other hardware that your application may need to know about. When you want to check the capabilities for the platform you're running on, you turn to the UIDevice class, right? Not so fast.

The UIDevice class can tell you which platform you're running on, be it the iPhone or iPod touch, but it won't tell you much more than that. At this time, there's no way to check if that iPod touch or iPhone is the first generation or second.

To help you out, we've expanded the UIDevice class. The following code returns a string that tells you exactly which platform your application is running on. This works by calling sysctlbyname. Sysctlbyname retrieves information made available to the running operating system and can return those values to your program.

As far as determining which platform you're running on, you recover that information by querying the hw.machine value. The hw.machine key returns one of four strings:

• iPhone1,1 (for the first gen iPhone)
• iPhone1,2 (for the 3G model)
• iPod1,1 (first gen iPod touch)
• iPod2,1 (second gen iPod touch)

These return strings show you exactly which hardware your program is using and let you adjust your application options accordingly.

I have created a new repository at github that contains the following class extension code. You can freely download it and use it in your program. Although I've included a skeleton testbed at the repository, all you need to use in general are the two UIDevice-hardware files.

These files declare two new methods (platform and platformString) which return the raw sysctl values and more user-readable strings. These latter constants are defined in the header file and can be used in your application.

UIDevice-hardware.h

view plain print ?

1. #import <UIKit/UIKit.h>
3. #define IPHONE_1G_NAMESTRING @"iPhone 1G"
4. #define IPHONE_3G_NAMESTRING @"iPhone 3G"
5. #define IPOD_1G_NAMESTRING @"iPod touch 1G"
6. #define IPOD_2G_NAMESTRING @"iPod touch 2G"
8. @interface UIDevice (Hardware)
9. - (NSString *) platform;
10. - (NSString *) platformString;
11. @end

UIDevice-hardware.m

view plain print ?

1. #import "UIDevice-hardware.h"
2. #include <sys/types.h>
3. #include <sys/sysctl.h>
5. @implementation UIDevice (Hardware)
7. /*
8. Platforms
9. iPhone1,1 -> iPhone 1G
10. iPhone1,2 -> iPhone 3G
11. iPod1,1 -> iPod touch 1G
12. iPod2,1 -> iPod touch 2G
13. */
15. - (NSString *) platform
16. {
17. size_t size;
18. sysctlbyname("hw.machine", NULL, &size, NULL, 0);
19. char *machine = malloc(size);
20. sysctlbyname("hw.machine", machine, &size, NULL, 0);
21. NSString *platform = [NSString stringWithCString:machine];
22. free(machine);
23. return platform;
24. }
26. - (NSString *) platformString
27. {
28. NSString *platform = [self platform];
29. if ([platform isEqualToString:@"iPhone1,1"]) return IPHONE_1G_NAMESTRING;
30. if ([platform isEqualToString:@"iPhone1,2"]) return IPHONE_3G_NAMESTRING;
31. if ([platform isEqualToString:@"iPod1,1"]) return IPOD_1G_NAMESTRING;
32. if ([platform isEqualToString:@"iPod2,1"]) return IPOD_2G_NAMESTRING;
33. return NULL;
34. }
35. @end

Thanks to Emanuele Vulcano